How imatomic7407/timetable-studio works
Timetable Studio builds a school-wide weekly schedule, lets a registrar edit and publish it, then supports daily teacher attendance, leave, and class cover. The graph follows that user journey through the app, API, shared timetable model, and solver, with separate branches for teacher access and administration. Several implementation files were not sampled; documented capabilities are retained, while edges relying only on unsampled wiring are omitted or marked unverified.
Main entry points: server.ts HTTP server · service.ts Timetable lifecycle · apiClient.ts API client · App.tsx App entry
Components 25
Web app
- App entry
app/src/App.tsx - App state
app/src/store/store.tsx - Timetable editor
app/src/features/editor/EditorPage.tsx - Rule manager
app/src/features/rules/RulesPage.tsx - Teacher portal
app/src/features/teacherApp/TeacherApp.tsx - API client
app/src/data/api/apiClient.ts - Administration
app/src/features/admin/UsersPage.tsx
API and services
- HTTP server
backend/src/http/server.ts - Timetable routes
backend/src/http/routes/timetables.ts - Timetable lifecycle
backend/src/services/timetables/service.ts - Timetable persistence
backend/src/services/timetables/repository.ts
Timetable engine
- Shared timetable model
shared/timetable-core/src/types.ts - Grid and rule checks
shared/timetable-core/src/grid.ts - Solver input
shared/timetable-core/src/solverInput.ts - Schedule solver
solver/solver/engine.py - Solver v2
solver/solver/v2/build.py
Daily operations
- QR attendance
backend/src/services/attendance.ts - Leave and cover
backend/src/services/cover.ts - Daily operations UI
app/src/features/ops/AttendancePage.tsx
Access and administration
- Authentication
backend/src/services/auth.ts - Permission gates
backend/src/http/middleware/auth.ts - Audit trail
backend/src/services/audit.ts - Application database
backend/src/db/client.ts
Other components
- Registrar
- Teacher
Connections 33
- Registrar → App entry: uses
README.md - Teacher → App entry: uses
README.md - App entry → App state: reads state
app/src/App.tsx - App entry → Teacher portal: routes teachers
app/src/App.tsx - Registrar → Timetable editor: edits schedule
README.md - Registrar → Rule manager: manages rules
README.md - Teacher → Teacher portal: views week
README.md - Timetable editor → API client: requests data
- Rule manager → API client: requests rules
- Teacher portal → API client: requests data
- API client → HTTP server: sends requests
README.md - HTTP server → Timetable routes: mounts routes
backend/src/http/server.ts - Timetable routes → Timetable lifecycle: dispatches
- Timetable lifecycle → Timetable persistence: maps records
backend/src/services/timetables/service.ts - Timetable lifecycle → Shared timetable model: loads school config
backend/src/services/timetables/service.ts - Registrar → Timetable lifecycle: publishes schedule
README.md - Shared timetable model → Grid and rule checks: defines timetable rules
shared/timetable-core/src/rules.ts - Shared timetable model → Solver input: builds solver input
- Solver input → Schedule solver: provides constraints
- Solver input → Solver v2: provides model data
- Registrar → Schedule solver: generates timetable
README.md - Registrar → Solver v2: generates timetable
- Teacher → Daily operations UI: marks attendance
README.md - Daily operations UI → API client: requests operations
- HTTP server → QR attendance: routes attendance
backend/src/http/server.ts - HTTP server → Leave and cover: routes daily cover
backend/src/http/server.ts - Teacher → Leave and cover: requests leave
README.md - HTTP server → Permission gates: authenticates requests
backend/src/http/server.ts - Permission gates → Authentication: resolves session
backend/src/http/middleware/auth.ts - Authentication → Application database: reads and writes
backend/src/services/auth.ts - Registrar → Administration: administers accounts
- Authentication → Audit trail: records events
backend/src/services/auth.ts - Timetable lifecycle → Audit trail: records changes
backend/src/services/timetables/service.ts