Alerts - maar35/film-festival-planner GitHub Wiki
Warnings
On this page the warning system in the web app is described.
The old C# alert system, which is being decommissioned, is documented here.
Summary
Warnings in the web app are visible in:
- The screenings in the daily schema to which warnings apply
- The Warnings view
- The floating Warning Statistics mini-view
The next chapter gives an overview of the different warnings.
Warning types
Here, the different warning types are explained. They fall into three categories, indicated by symbols as displayed in the table below.
Warning categories
Below, the warning categories that have been defined are listed.
Warnings can be fixed in the Screening Details view or in the Warnings view.
| Warning category | Symbol | Wording example in category color | Remarks |
|---|---|---|---|
| Attendance warning | ⛔ | $\color{rgb(255, 38, 0)} {\textsf{John attends overlapping}}$ | Important to fix because they mostly indicate impossible situations |
| Ticket buy sell warning | $\color{rgb(255, 127, 0)} {\textsf{!}}$ | $\color{rgb(255, 127, 0)} {\textsf{Paul needs a ticket}}$ | The film fan needs actively fix these situations: attending a screening but having no ticket, or having a ticket but not attending |
| Ticket confirmation warning | $\color{rgb(255, 219, 0)} {\textsf{?}}$ | $\color{rgb(255, 219, 0)} {\textsf{Janis awaits confirmation}}$ | A bit more passive for the fan since only waiting till a ticket is confirmed is required |
Warnings
These warning types are currently recognized:
| Warning type | Warning category | Description |
|---|---|---|
| Attends same film | ⛔ | One fan attends the same film more than once |
| Attends overlapping | ⛔ | A fan attends overlapping screenings |
| Attends while unavailable | ⛔ | A fan attends a screening while not being available during the time span |
| Needs ticket | $\color{rgb(255, 127, 0)} {\textsf{!}}$ | A fan attends a screening but has no ticket |
| Awaits confirmation | $\color{rgb(255, 219, 0)} {\textsf{?}}$ | A fan attends a screening, has a ticket but awaits confirmation |
| Should sell ticket | $\color{rgb(255, 127, 0)} {\textsf{!}}$ | A fan has a ticket for a screening that he (mf+) doesn't attend |
Warnings on screenings in the Day Schema
In the Day Schema, screenings are being visualized.
If warnings apply to a screening, the warning categories are displayed on the second line of the screening representation. Clicking on the warning part will open the Warnings view.
Also, on the left of the top line of the screening representation, a warning triangle ⚠︎ appears. When hovering over the triangle, a ticker displays all warnings concerning this screening.
Warnings view
The Warnings view displays a table with as rows all warnings and the screenings and fans concerned.
The columns are as follows:
- Film title
- Screening, as link to the Day Schema
- Link to the Screening Details page
- Fan, can be filtered as to display all screenings that have warnings for the selected fan
- Warning, can be filtered as to display all screenings that have the warning type selected
- Symbol, see warning categories
- Fixes dropdown menu, offers a few possibilities to fix the warning, or related warnings
Fixes dropdown menu
Per warning type, the Fixes dropdown menu offers the following solutions.
For the attends same film warning:
- Delete attendance of this fan to this screening
- For each other screening of the same film: Delete attendance to the other screening
- Filter the warnings as to keep the screenings of the film and this fan
For the attends overlapping warning:
- Delete attendance of this fan to this screening
- For each other overlapping screenings: Delete attendance to the other screening
- Filter the warnings as to keep the overlapping screenings and this fan
For the Attends while unavailable warning:
- Delete attendance to this screening
- A link to the Availability view
- In the header area of the Availability view, a reminder displays the fan and the period of required availability.
For other warnings, i.e. those concerning tickets:
- To fix (e.g. create ticket) the warning for this fan and this screening
- To fix the warning for all attendants of this screening
- To fix the warning for all screenings this fan attends
Floating warning statistics mini-view
In some views, esp. the Day Schema view, on the top-right of the screen, a floating mini-view is displayed.
It shows:
- The total number of warnings in the festival
- An extra line with the number of warnings per warning category
Clicking on the total number of warning opens the Warnings view.