How dleungdl/eduops-system works
EduOps is a single-organization education-operations backend for student–tutor pairings, groups, monthly roster approval, lessons, attendance, billing, and staff pay. The main workflow is manager enrollment and matching, roster preparation and tutor/manager approval, then lesson generation and operational recording. The graph also includes authentication, organization settings, groups, and staff enrollment/payroll as distinct capabilities. Router registration and selected calls are evidenced by the excerpts and SOURCE INDEX; unsampled router internals are represented without inferred call chains.
Main entry points: main.py FastAPI application · models.py Education records · database.py Database sessions · auth.py Login and identity
Components 25
User interface and API
- Browser UI
backend/static/index.html - FastAPI application
backend/app/main.py
Identity and settings
- Login and identity
backend/app/routers/auth.py - Token access control
backend/app/deps.py - JWT and passwords
backend/app/security.py - Organization settings
backend/app/routers/meta.py - Labels and defaults
backend/app/org.py
Enrollment and scheduling
- Student and tutor records
backend/app/routers/crud.py - Enrollment matching
backend/app/routers/enroll.py - Staff enrollment
backend/app/routers/staff_enroll.py - Group management
backend/app/routers/groups.py - Monthly roster approval
backend/app/routers/rosters.py - Conflict and capacity rules
backend/app/scheduling.py
Lessons and finance
- Lesson generation and changes
backend/app/routers/lessons.py - Attendance tracking
backend/app/routers/attendance.py - Student payments
backend/app/routers/payments.py - Staff salary
backend/app/routers/salary.py
Data layer
- Education records
backend/app/models.py - Salary records
backend/app/models_salary.py - Student preferences
backend/app/models_student_pref.py - Tutor subjects
backend/app/models_tutor_subjects.py - API schemas
backend/app/schemas.py - Database sessions
backend/app/database.py - PostgreSQL
Other components
- Operations staff
Connections 39
- Operations staff → Browser UI: uses
README.md - Browser UI → FastAPI application: calls API
README.md - FastAPI application → Login and identity: registers route
backend/app/main.py - FastAPI application → Organization settings: registers route
backend/app/main.py - FastAPI application → Student and tutor records: registers route
backend/app/main.py - FastAPI application → Enrollment matching: registers route
backend/app/main.py - FastAPI application → Staff enrollment: registers route
backend/app/main.py - FastAPI application → Group management: registers route
backend/app/main.py - FastAPI application → Monthly roster approval: registers route
backend/app/main.py - FastAPI application → Lesson generation and changes: registers route
backend/app/main.py - FastAPI application → Attendance tracking: registers route
backend/app/main.py - FastAPI application → Student payments: registers route
backend/app/main.py - FastAPI application → Staff salary: registers route
backend/app/main.py - Login and identity → JWT and passwords: verifies password
backend/app/routers/auth.py - Login and identity → Token access control: loads current user
backend/app/routers/auth.py - Token access control → JWT and passwords: decodes token
backend/app/deps.py - Organization settings → Labels and defaults: uses defaults
backend/app/routers/meta.py - Enrollment matching → Conflict and capacity rules: checks availability
backend/app/routers/enroll.py - Monthly roster approval → Conflict and capacity rules: checks conflicts
backend/app/routers/rosters.py - Lesson generation and changes → Conflict and capacity rules: checks schedules
backend/app/routers/lessons.py - Enrollment matching → Student preferences: stores preferences
backend/app/routers/enroll.py - Student and tutor records → Tutor subjects: manages subjects
backend/app/routers/crud.py - Monthly roster approval → API schemas: validates responses
backend/app/routers/rosters.py - Lesson generation and changes → API schemas: validates responses
backend/app/routers/lessons.py - Student and tutor records → Education records: queries records
backend/app/routers/crud.py - Enrollment matching → Education records: creates pairings
backend/app/routers/enroll.py - Staff enrollment → Salary records: uses salary records
backend/app/routers/staff_enroll.py - Staff salary → Salary records: queries salaries
backend/app/routers/salary.py - Attendance tracking → Education records: records attendance
backend/app/routers/attendance.py - Student payments → Education records: records payments
backend/app/routers/payments.py - Group management → Education records: manages groups
backend/app/routers/groups.py - Monthly roster approval → Education records: stores rosters
backend/app/routers/rosters.py - Lesson generation and changes → Education records: stores lessons
backend/app/routers/lessons.py - Login and identity → Education records: queries users
backend/app/routers/auth.py - Education records → Database sessions: uses base
backend/app/models.py - Salary records → Database sessions: uses base
backend/app/models_salary.py - Student preferences → Database sessions: uses base
backend/app/models_student_pref.py - Tutor subjects → Database sessions: uses base
backend/app/models_tutor_subjects.py - Database sessions → PostgreSQL: connects
backend/app/database.py