School Cleaning Management System

A comprehensive management system designed for high school cleaning days, providing students with announcement queries, class monitors for area assignment, inspectors for verification, and administrators with backend management capabilities.

• View the latest announcements and notifications
• Browse cleaning area information
• Real-time status updates

• Assign cleaning areas to classes
• Record cleaning staff lists
• Manage area responsibilities

• Review cleaning area completion status
• Record verification results
• Provide feedback for improvements

• Publish and manage announcements
• Configure cleaning areas
• Manage user roles and permissions
• Export sign-out reports

• Frontend Framework: HTML5 + Vanilla JavaScript
• Styling: Tailwind CSS
• Backend Service: Supabase (PostgreSQL + Real-time Database)
• Authentication: Password-based authentication system

• Modern web browser (Chrome, Firefox, Safari, Edge)
• Internet connection

1. Open the Application

   • Open index.html directly in a browser, or serve it via an HTTP server

2. Access Different User Roles

   • Regular Student: Default role, can view announcements and area information
   • Class Monitor: Login with class number and password
   • Inspector: Login with inspection password
   • Administrator: Login with admin email and password

returntoschool/
├── index.html          # Main application page
├── scripts.js          # Core logic and feature modules
├── style.css           # Custom styling
├── README.md           # This file
└── LICENSE.md          # GPLv3 Open Source License

1. Open the application homepage
2. Check the "Announcements" section for the latest information
3. Browse the area list in "Area Management"

1. Click "Class Monitor Login"
2. Enter class number and password for verification
3. Assign cleaning areas to the class
4. Record the list of cleaning staff

1. Click "Inspector Login"
2. Enter inspection password
3. Verify each cleaning area's completion status
4. Record verification results

1. Login with administrator email and password
2. Publish new announcements
3. Add or edit cleaning area information
4. Manage user roles
5. Export various reports

This system uses Supabase as the backend service with data stored in PostgreSQL. Key tables include:

• announcements - Announcement information
• areas - Cleaning area information
• assignments - Class area assignments
• inspections - Verification records
• users - User role management

• Password-based authentication
• Role-based access control for different user types
• Data encrypted via HTTPS
• Additional verification for sensitive operations

Q: How do I reset my password? A: Please contact the system administrator to reset your password.

Q: How often are announcements updated? A: Announcements are published in real-time by administrators, usually immediately after decisions are made.

Q: How do I export cleaning records? A: Administrators can click the "Download Absent Sign-out List" button in the backend to export records.

This project is licensed under GPLv3. See LICENSE for details.

For questions or suggestions, please contact the system administrator. Email: cpsd6th@gmail.com

• @chupei-software-development-club - Owner
• @422August - Developer/Maintainer
• @294Ryan - Maintainer
• @cpyc234-sketch - Operator

Last Updated: July 2026