We need to add reporting features for teachers to assess their classrooms. Users need to be able to access this from the classroom and behavior dashboards.
User Stories:
As a user, I want to understand how many positive and negative occurrences have been reported for the students in my class, so I can see if interventions are improving behavior over time
Acceptance Criteria:
Given I am a user viewing the Behavior Area and I have permission to Behavior Support → Edit Reports, I will have access to the Record Incident button
Given I am a user viewing the Behavior Area and I DO NOT have permission to Behavior Support → Edit Reports, I will NOT have access to the Record Incident button
DESIGN: https://www.figma.com/file/gdwMnbpudJxuzVrORrOGvd/Ed-Member-Site-UX?node-id=15758%3A169166
Classroom/Group Report
Design
From the classroom, the user will click on reports
.png?version=1&modificationDate=1643070454443&cacheVersion=1&api=v2)
From here, the user will click on Points under the Behavior tab.
.png?version=1&modificationDate=1643071246090&cacheVersion=1&api=v2)
Business Rules
Users with permission to View Reports (Behavior Support) will have access to this area.
If accessing this report from a classroom dashboard, we will report on all behaviors recorded for all students in the classroom when this classroom was selected on the report.
Date Range
Design
The user may click the date range (i.e. Past 30 Days)
This will open up a filter for the user to select a different date range. The options will be:
Today
Yesterday
Past 7 days
Past 30 days
Past 90 Days
Past year
Users may also select two dates on the calendar as a start and end date to enter a custom date range
Business Rules
The default date range will be the past 30 days
The date range will dictate the data displayed
Data displayed will be based on the date the user entered when recording the data (not necessarily the date the user physically entered the data).
For example, if the user entered data on 11/19 and changed the date to 9/1, a report from 11/1-11/30 will not reflect that data point.
Circle Graph
Design
The user will see a circle graph showing the ratio of positive behaviors to negative behaviors. The default will be to show the positive behaviors highlighted.
.png?version=2&modificationDate=1643091142789&cacheVersion=1&api=v2)
When the user clicks Negative, they will see the negative section of the graph highlighted
.png?version=1&modificationDate=1643086869248&cacheVersion=1&api=v2)
Positive behavior section will be green
Negative behaviors will be red
We will show percentage labels and total number of occurrences
Business Rules
Data will be dependent on the date range
Positive Behavior section will include the percentage of positive behaviors (out of total behaviors) and total number of positive behaviors recorded for all active students within the classroom within the date range.
Negative Behavior section will include the percentage of negative behaviors (out of total behaviors) and the total number of negative behaviors recorded for all active students within the classroom or group within the date range.
If a student was active on 11/1 and marked inactive on 11/3, any data recorded for the student between 11/1-11/3 will show on a report from 11/1-11/30.
If a student belonged to a classroom or group on 11/1 and was removed from the classroom or group on 11/3, any data recorded for the student between 11/1-11/3 will show on a report from 11/1-11/30.
The data will be counted under the classroom or group it was collected for. Meaning, if Artie is a student who belongs to both Classroom A and Classroom B, and I recorded data on Artie and selected Classroom A, Artie’s data will be counted under Classroom A and not Classroom B.
Positive Behaviors
Design
We will show the total number of students for whom a positive behavior was recorded, number of instances of all positive behaviors, and points awarded for all positive behaviors within the date range selected
.png?version=1&modificationDate=1643087106606&cacheVersion=1&api=v2)
Below the Totals, the user will see a chart showing the list of positive behaviors and the number of students, occurrences, and points that were awarded
.png?version=1&modificationDate=1643087260010&cacheVersion=1&api=v2)
If a user clicks on the down arrow, they may expand the positive behaviors to view a list of all behaviors. Clicking the up arrow will hide the behavior list.
.png?version=1&modificationDate=1643087437956&cacheVersion=1&api=v2)
For each behavior we will show the number of students for whom that behavior was recorded, number of occurrences for that behavior, and points awarded for that behavior
.png?version=1&modificationDate=1643087540976&cacheVersion=1&api=v2)
If a user clicks on the behavior, it will expand to show the students for whom the behavior was recorded, the number of occurrences of that behavior for each student, and the number of points each student was awarded for that behavior
The note symbol will show if the teacher saved an observation when tracking points
.png?version=1&modificationDate=1643087609653&cacheVersion=1&api=v2)
If the user hovers or clicks on a given note, the observation note modal will appear and can be closed by clicking the X
.png?version=1&modificationDate=1643087858260&cacheVersion=1&api=v2)
If the user clicks on a student’s name, they will visit the student behavior point report
.png?version=1&modificationDate=1643088972869&cacheVersion=1&api=v2)
Business Rules
We will only show behaviors for which data has been recording. Meaning, we will not show a line for a behavior if 0 occurrences were recorded within the date range.
We will only list students for whom data was recorded. Meaning, if Child A did not engage in helping others, we will not list Child A under helping others. We will only list those students who engaged in helping others during the date range selected.
We will account for all students who belonged to the classroom within the date range.
If Child A belongs to the classroom in August but not in September, we will still count Child A’s data under the classroom for the month of August. We will also list Child A’s name in the report for any behavior he engaged in during our date range. HOWEVER, users will not be able to click on Child A’s name unless they are assigned to Child A or Child A’s new classroom.
Negative Behaviors
Design
The user will see a line heading called Negative Behaviors
Here, we will show the total number of students for whom a negative behavior was recorded and number of occurrences for all negative behaviors
If a user clicks on the down arrow, they may expand the negative behaviors to view a list of all behaviors. Clicking the up arrow will hide the behavior list.
For each behavior we will show the number of students for whom that behavior was recorded and the number of occurrences for that behavior
If a user clicks on the down arrow for the behavior, it will expand to show the students for whom the behavior was recorded and the number of instances of that behavior for each student
If the user clicks on a student’s name, the student’s points report modal will show (see student report modal section)
Business Rules
We will only show behaviors for which data has been recording. Meaning, we will not show a line for a behavior if 0 occurrences were recorded within the date range.
We will only list students for whom data was recorded. Meaning, if Child A did not engage in hitting, we will not list Child A under hitting. We will only list those students who engaged in hitting during the date range selected.
We will account for all students who belonged to the classroom within the date range.
If Child A belongs to the classroom in August but not in September, we will still count Child A’s data under the classroom for the month of August. We will also list Child A’s name in the report for any behavior he engaged in during our date range. HOWEVER, users will not be able to click on Child A’s name unless they are assigned to Child A or Child A’s new classroom.
Design
If the user clicks on the print button, they will be prompted to open a printable PDF.
The report will show the rethink ed logo in the upper left corner and a heading of CLASSROOM NAME’S Behavior Report
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 behaviors expanded (showing all details)
We will not print the print/export buttons and we will not print the edit/delete buttons
Export
Design
If the user clicks the export button, they will be prompted to download an excel file
The excel file will have a tab for positive behaviors and a tab for negative behaviors
Positive Behaviors tab
We will show a header in cell B1 called Students
We will show a header in cell C1 called Occurrences
We will show a header in cell D1 called Points
Starting in cell A2, we will list each behavior name
For each behavior name, we will list the number of students for whom the behavior was recorded, the number of occurrences for the behavior, and the number of points awarded for the behavior
Starting in cell B3, we will list each student first name and last initial
For each student, we will list the number of occurrences of the behavior and the number of points awarded to the student for that behavior
In the last row, we will show totals for students, occurrences, and points
Negative Behaviors tab
We will show a header in cell B1 called Students
We will show a header in cell C1 called Occurrences
Starting in cell A2, we will list each behavior name
For each behavior name, we will list the number of students for whom the behavior was recorded, the number of occurrences for the behavior, and the number of points awarded for the behavior
Starting in cell B3, we will list each student first name and last initial
For each student, we will list the number of occurrences of the behavior
In the last row, we will show totals for students and occurrences
Business Rules
We will export the report based on the date range selected
Student Report Modal
Design
When a student’s name is clicked on from the classroom/group report, we will see the number of points earned, number of positive behaviors recorded, and number of negative behaviors recorded for that student within the selected date range
We will show a note stating "Please note this report includes behaviors recorded for all classrooms and groups the student belonged to during the selected date range."
We will also see the date range selected on the classroom/group report, but we will not be able to change this date range
Below, we will see a report detailing all positive and negative behaviors
Positive Behaviors
We will show the name of each positive behavior recorded for the student within the date range, the number of instances of this behavior for the student within the date range, the point value of each behavior, and the total points the student earned for the behavior
Below each behavior, we will see each recording of the behavior for the student.
For each recording, we will show the date and time the behavior was recorded, the frequency (instances) of the behavior for the student, the point value for the behavior, and the total points the student earned for the behavior within the date range
If the user clicks the X, they will see a confirmation message asking them if they are sure they want to delete the data. If the user clicks delete, the data will be deleted and the frequency and points will update accordingly. If the user clicks cancel, the data will not be deleted
If the user clicks the pen icon, they will be able to edit the date, time, and frequency of the behavior. When the user clicks the check mark, the edit will be saved. If the frequency was edited, the points earned will be updated accordingly.
We will also show the total number of positive behaviors and total points earned by the student within the date range
Negative behaviors
We will show the name of each negative behavior recorded for the student within the date range and the number of instances of this behavior for the student within the date range
Below each behavior, we will see each recording of the behavior for the student.
For each recording, we will show the date and time the behavior was recorded and the frequency (instances) of the behavior for the student within the date range
If the user clicks the X, they will see a confirmation message asking them if they are sure they want to delete the data
If the user clicks the pen icon, they will be able to edit the date, time, and frequency of the behavior. When the user clicks the check mark, the edit will be saved.
We will also show the total number of negative behaviors recorded for the student within the date range
NEED UPDATED DESIGN TO SHOW EXPANDED REPORT
The user will click the X to close the modal
The user may click the print button to print the report as it shows on the screen (SPEC OUT)
The user may click the export button to export the data as it shows on the screen. (SPEC OUT)
Business Rules
The date range for this report will be the same as the date range on the classroom/group report
This report will show all behaviors recorded for the student within the date range, regardless of which classroom/group was selected.
Users with permission to Manage Data/Points will be able to edit/delete
From Behavior Dashboard
Design
From any tier tab in the Behavior section, the user will click View behaviors (points box).
From here, the user will select a classroom and then hit the select button.
They will then see the classroom points report (same as above).
Business Rules
Any user with permission to View Reports (under Behavior Support) will have access to view behaviors 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.