We need a way to view a log of all incidents and actions at the classroom and group levels. Users also need to be able to navigate to this area from Behavior dashboard.
User Stories:
As a user, I want to understand how many incidents have been reported for the students in my class, so I will know if our incidents are high or low
As a user, I want to view a list of the incident and action types recorded for students in my class, so I can understand any trends
As a user, I want to view the formal incident reports for the students in my class, so I can be fully informed about what happened
DESIGN: https://www.figma.com/file/gdwMnbpudJxuzVrORrOGvd/Ed-Member-Site-UX?LCepufVnaXwGPAdNX0VFJp/Incidents?type=design&node-id=12676%3A140766 https://www.figma.com/file/gdwMnbpudJxuzVrORrOGvd/Ed-Member-Site-UX?node-id=24519%3A213396 0%3A1&t=XjI4SflsoHiV0bWo-1
Acceptance Criteria:
Given I am a user with access to skills, behavior, SEL, or MTSS Interventions and permission to View reports, I will be able to view the classroom reports
Given I am a user with access to skills, behavior, SEL, or MTSS Interventions and I do not have permission to View reports, I will not be able to view classroom reports
Given I am a user with access to the old incidents product, I will see my notes section carry over into the new product within the type and actions tabs.
From Classroom/Group Dashboard
Design
From the classroom, the user will scroll to the reports area (below Parents) or click on View results.
.png?version=1&modificationDate=1642529375815&cacheVersion=1&api=v2)
From here, the user will click on Incidents under the Behavior tab.
We will show a report for Incidents and one for Actions
Skills and SEL only accounts will not see the tabs
-20230522-124952.png?version=1&modificationDate=1684759802888&cacheVersion=1&api=v2)
Business Rules
Users with permission to View Reports will have access to this area.
We will default to Incidents.
The user can view report as long as they have access to the students in the building where the incident occurred to View Report. If a student has moved, they will see (inactive) next to the name of the student on the report.
Any user with permission to View Report (under Incident Reports) will be able to view the report upon clicking the button
Location filter should be All, then default and custom locations logged for students from classroom in abc order
The default is unchecked for the Show All checkbox, which will to show only incidents logged by /created by the specific team member for their classroomthe given Team Member(s) for the specific class they are viewing.
Given the Show All checkbox is unchecked and the user is the only educator assigned to the class, then they will only see their own name in the Created By column.
Given the Show All checkbox is unchecked and there are two educators assigned to the class, then they will see incidents logged by both team members in the Created By column.
If the admin enters the classroom section and the Show All is not selected, they will only see incidents logged by team members in the given class.
Given the admin user wants to view all incidents logged for students in that class by all team members, they will click to select Show All.
Given the user checks the Show All checkbox, then they will see both all incidents logged by/created by themselves and also all incidents logged by/created by other team members for students assigned to the classroom.
From Behavior Dashboard
Design
From any tier tab in the Behavior section, the user will click View incidents.
From here, the user will select a classroom and then hit the select button.
They will then see the classroom incident report (same as above).
Business Rules
Any user with permission to View Reports (under Behavior Support) will have access to View incidents button.
All non-admin users will see classrooms they are currently assigned to
Classrooms will be listed alphabetically
Admins will see a search bar instead of the classrooms list. Admins will need to search for a classroom by name.
The user can view report as long as they have access to the students in the building where the incident occurred to View Report. If a student has moved, they will see (inactive) next to the name of the student on the report.
Any user with permission to View Report (under Incident Reports) will be able to view the report upon clicking the button
Adjust the Date
Design
The user may click on Past 30 days to change the date range.
They will see the pre-set options of:
Today
Yesterday
Past 7 Days
Past 30 Days
Past 90 Days
Past Year
Alternatively they may enter a custom date range by clicking two dates as a start and end date on the calendar.
Once the date range has been changed, we will see this reflected on the report (in place of the text Past 30 Days).
.png?version=1&modificationDate=1652991647213&cacheVersion=1&api=v2)
Business Rules
Date range cannot be in the future.
The default date range will be Past 30 Days.
Stats Bar
Design
The user will see the number of incidents that occurred within the selected date range
The stats bar will reflect the percent of students with an incident within the selected date range. The status bar will be colored based on the business rules.
Below the stats bar, we will show the percent of students with an incident report and the number of students with an incident report.
We will show a red bar for a high percentage of students with an incident within the date range
We will show a gold bar if there was a low percentage of students with an incident within the date range
If no incidents were reported within the date range, the user will see a congratulatory message.
Business Rules
We will show the number of incidents that occurred for students in the classroom/group where this classroom was selected on the report within the date range.
We will show the gold bar if incidents occurred for 79% of students or less.
We will show the red bar if incidents occurred for 80% of students or more.
Incidents Tab
Design
Below the stats section, the user will see the name of each incident type reported within the date range, the number of occurrences for each incident type, and the number of students with each incident type reported.
-20230522-125108.png?version=1&modificationDate=1684759895071&cacheVersion=1&api=v2)
If the user clicks on the down arrow next to an incident, it will expand to show the date and time (if available) of each incident, the action taken, and the names of the students involved.
Next to View Report, we will show the approval status of Approved, Pending Approval, or Denied
If the user clicks “View report,” the Incident Report for that occurrence will show in a modal.
If the user clicks the up arrow next to an incident, the details will collapse/hide.
Business Rules
By default, all incidents will be collapsed & no details will show.
When the details are expanded, we will show the names of the students involved in the incident, even if that student is no longer active or has moved to a new classroom/group.
Any incident recorded prior to the launch of incident report templates will use the Rethink default incident report template.
The user can view report as long as they have access to the students in the building where the incident occurred to View Report. If a student has moved, they will see (inactive) next to the name of the student on the report.
Any user with permission to View Report (under Incident Reports) will be able to view the report upon clicking the button
Location filter should be All, then default and custom locations logged for students from classroom in abc order
The default is unchecked for the Show All checkbox, which will to show only incidents logged by /created by the specific team member for their classroomthe given Team Member(s) for the specific class they are viewing.
Given the Show All checkbox is unchecked and the user is the only educator assigned to the class, then they will only see their own name in the Created By column.
Given the Show All checkbox is unchecked and there are two educators assigned to the class, then they will see incidents logged by both team members in the Created By column.
If the admin enters the classroom section and the Show All is not selected, they will only see incidents logged by team members in the given class.
Given the admin user wants to view all incidents logged for students in that class by all team members, they will click to select Show All.
Given the user checks the Show All checkbox, then they will see both all incidents logged by/created by themselves and also all incidents logged by/created by other team members for students assigned to the classroom.
Actions Tab
Design
When the user clicks the Actions button, the user will be taken to the actions report.
.png?version=1&modificationDate=1652991967430&cacheVersion=1&api=v2)
Below the stats bar, they will see the name of each action reported within the date range, the number of occurrences for each action, and the number of students with each action reported.
If the user clicks on the down arrow next to an action, it will expand to show the date and time (if available) of each action, the incident type the action was reported for, and the names of the students involved.
Next to View Report, we will show the approval status of Approved, Pending Approval, or Denied
If the user clicks “View report,” the Incident Report for that occurrence will show in a modal.
If the user clicks the up arrow next to an action, the details will collapse/hide.
Business Rules
By default, all actions will be collapsed & no details will show.
When the details are expanded, we will show the names of the students the action was reported for, even if that student is no longer active or has moved to a new classroom/group.
Any incident recorded prior to the launch of incident report templates will use the Rethink default incident report template.
The user can view report as long as they have access to the students in the building where the incident occurred to View Report. If a student has moved, they will see (inactive) next to the name of the student on the report.
Any user with permission to View Report (under Incident Reports) will be able to view the report upon clicking the button
Location filter should be All, then default and custom locations logged for students from classroom in abc order
The default is unchecked for the Show All checkbox, which will show only incidents logged by/created by the specific team member for their classroom.
Given the user checks the Show All checkbox, then they will see both all incidents logged by/created by themselves and also all incidents logged by/created by other team members for students assigned to the classroom.
Design
If the user clicks the print button, a PDF of the report will show
The report will show the rethink ed logo in the upper left corner and a heading of CLASSROOM NAME’S Incident Report Log
We will show a sub-heading with the date range
Business Rules
We will print the report based on the date range selected
We will print the report with all incidents/actions expanded (showing all details)
We will not print the print/export buttons and we will not print the edit/delete buttons
We will print the report we are currently viewing. Meaning, if we are viewing the incidents tab, this is the report we will print.
If we are printing a group report, we will display the name of the group instead of the classroom name
Export
Design
If the user clicks the export button, they will be prompted to download an excel file
Incidents
show a column for:
Incident Type
Date
Time
Action Taken
Students Involved
Actions
show a column for
Action Taken
Date
Time
Incident Type
Students Involved
Business Rules
We will export the report based on the date range and tab (actions or incidents) selected
We will sort the list by date, with the most recent incident/action at the top
Old Incidents Needs Notes
UI:
User clicks on type tab to show incident type.
-20220728-173958.png?version=2&modificationDate=1659029846096&cacheVersion=1&api=v2&width=442)
User clicks on Actions tab to show actions taken.
-20230522-125444.png?version=1&modificationDate=1684760092960&cacheVersion=1&api=v2&width=564)
-20230522-125444.png?version=1&modificationDate=1684760092960&cacheVersion=1&api=v2&width=550)
Business Rules:
Notes section from old incident reports will carry over into new incidents product for the incident type tab.
Notes section from old incident reports will carry over into new incidents product for the actions type tab.