How usrr961/mpsd_awards works
This is a Community Service Awards manager for tracking student service hours and awards. Staff use the desktop dashboard to import rosters and form responses, review calculated awards, manage Owl nominations and overrides, and prepare communications and exports. A LAN portal supports shared review and award overrides. The database is the shared state layer. Edges reflect sampled imports, calls, and documented module references; several dashboard and portal internals were only partially excerpted, so their detailed routes are not expanded.
Main entry points: pyqt_dashboard.py Desktop Dashboard · database.py Awards Database · email_dispatcher.py Email Dispatch · importer.py Hours and Forms Import
Components 15
Staff Workflow
- Desktop Dashboard
pyqt_dashboard.py - Roster Import
importer.py - Hours and Forms Import
importer.py - Reports and Exports
pyqt_dashboard.py
Awards and Portal
- Award Calculation
award_engine.py - Owl Selection
web_server.py - LAN Portal
web_server.py
Data Layer
- Awards Database
database.py - Application Settings
config.py
Communications
- Email Dispatch
email_dispatcher.py
Other components
- Staff
- Counselors
- Google Forms
- SMTP Service
- Import Files
Connections 22
- Staff → Desktop Dashboard: uses
- Desktop Dashboard → Roster Import: imports roster
pyqt_dashboard.py - Desktop Dashboard → Hours and Forms Import: imports responses
pyqt_dashboard.py - Import Files → Roster Import: provides roster
- Import Files → Hours and Forms Import: provides responses
- Roster Import → Awards Database: writes students
importer.py - Hours and Forms Import → Awards Database: writes submissions
importer.py - Desktop Dashboard → Award Calculation: calculates awards
pyqt_dashboard.py - Award Calculation → Awards Database: reads and updates
award_engine.py - Desktop Dashboard → Awards Database: manages records
pyqt_dashboard.py - Desktop Dashboard → LAN Portal: starts portal
pyqt_dashboard.py - LAN Portal → Awards Database: updates overrides
web_server.py - LAN Portal → Owl Selection: selects Owl awards
web_server.py - Desktop Dashboard → Owl Selection: manages nominations
pyqt_dashboard.py - Desktop Dashboard → Reports and Exports: creates exports
pyqt_dashboard.py - Desktop Dashboard → Email Dispatch: prepares messages
pyqt_dashboard.py - Email Dispatch → Application Settings: reads settings
email_dispatcher.py - Email Dispatch → SMTP Service: sends mail
email_dispatcher.py - Email Dispatch → Counselors: requests writeup
email_dispatcher.py - Email Dispatch → Google Forms: links form
email_dispatcher.py - Google Forms → Hours and Forms Import: returns responses
- Awards Database → Application Settings: uses database URL
database.py