How anushkabadakh/timetable-management-system works
This is the FastAPI backend for a college timetable management system. Its visible workflow is authenticated administration of academic resources, creation of a timetable, and management of its scheduled slots; dashboard APIs provide a reporting branch. The source also contains token authentication, database models, and slot-validation logic. The README describes conflict suggestions, alerts, PDF downloads, and utilization reports, but their implementations are not evident in the supplied excerpts, so those capabilities are represented only where the tree or documentation supports them. Edges are limited to wiring or dependencies shown in the excerpts and source index.
Main entry points: main.py FastAPI app · database.py Database session · models Academic models · timetable.py Timetable routes
Components 21
API and access
- FastAPI app
backend/app/main.py - Authentication routes
backend/app/routers/auth.py - User credentials
backend/app/crud/user.py - Token functions
backend/app/crud/jwt.py - Current-user auth
backend/app/crud/deps.py - Timing middleware
backend/app/middleware.py
Academic resources
- College routes
backend/app/routers/college.py - Department routes
backend/app/routers/department.py - Faculty routes
backend/app/routers/faculty.py - Classroom routes
backend/app/routers/classroom.py - Subject routes
backend/app/routers/subject.py - Academic models
backend/app/models
Timetable scheduling
- Timetable routes
backend/app/routers/timetable.py - Slot routes
backend/app/routers/timetable_slots.py - Slot validation
backend/app/utils/slot_validation.py - Schedule models
backend/app/models/timetable.py - Timetable slot model
backend/app/models/timetable_slots.py
Persistence and reporting
- Dashboard APIs
backend/app/routers/dashboard.py - Database session
backend/app/database.py - Application settings
backend/app/config.py
Other components
- API client
Connections 39
- API client → FastAPI app: sends requests
- FastAPI app → Authentication routes: registers routes
backend/app/main.py - FastAPI app → College routes: registers routes
backend/app/main.py - FastAPI app → Department routes: registers routes
backend/app/main.py - FastAPI app → Faculty routes: registers routes
backend/app/main.py - FastAPI app → Classroom routes: registers routes
backend/app/main.py - FastAPI app → Subject routes: registers routes
backend/app/main.py - FastAPI app → Timetable routes: registers routes
backend/app/main.py - FastAPI app → Slot routes: registers routes
backend/app/main.py - FastAPI app → Dashboard APIs: registers routes
backend/app/main.py - FastAPI app → Timing middleware: adds middleware
backend/app/main.py - Authentication routes → Database session: gets session
backend/app/routers/auth.py - Authentication routes → User credentials: checks credentials
backend/app/routers/auth.py - Authentication routes → Token functions: creates token
backend/app/routers/auth.py - Current-user auth → Token functions: decodes token
backend/app/crud/deps.py - Current-user auth → User credentials: loads user
backend/app/crud/deps.py - Current-user auth → Database session: gets session
backend/app/crud/deps.py - College routes → Database session: queries data
backend/app/routers/college.py - Department routes → Database session: queries data
backend/app/routers/department.py - Faculty routes → Database session: queries data
backend/app/routers/faculty.py - Classroom routes → Database session: queries data
backend/app/routers/classroom.py - Subject routes → Database session: queries data
backend/app/routers/subject.py - College routes → Academic models: uses models
backend/app/routers/college.py - Department routes → Academic models: uses models
backend/app/routers/department.py - Faculty routes → Academic models: uses models
backend/app/routers/faculty.py - Classroom routes → Academic models: uses models
backend/app/routers/classroom.py - Subject routes → Academic models: uses models
backend/app/routers/subject.py - Timetable routes → Database session: queries data
backend/app/routers/timetable.py - Timetable routes → Current-user auth: requires user
backend/app/routers/timetable.py - Timetable routes → Schedule models: reads and writes
backend/app/routers/timetable.py - Timetable routes → Academic models: validates references
backend/app/routers/timetable.py - Slot routes → Database session: queries data
backend/app/routers/timetable_slots.py - Slot routes → Current-user auth: requires user
backend/app/routers/timetable_slots.py - Slot routes → Timetable slot model: reads and writes
backend/app/routers/timetable_slots.py - Slot routes → Slot validation: validates slots
backend/app/routers/timetable_slots.py - Timetable slot model → Schedule models: references timetable
backend/app/models/timetable_slots.py - Schedule models → Timetable slot model: owns slots
backend/app/models/timetable.py - Dashboard APIs → Database session: queries data
backend/app/routers/dashboard.py - Database session → Application settings: uses settings
backend/app/database.py