How samiksha267/automated-lab-allocation-system works
This is a React/Spring Boot college lab-allocation system backed by PostgreSQL. Users work through role-specific interfaces to maintain academic, faculty, subject, and lab data; schedules are generated against hard constraints, scored, explained, versioned, and exposed as timetables. Other documented capabilities include PDF timetable import, CR extra-lab booking, audit history, and analytics. The README supports the overall REST/database architecture; source excerpts establish routing, audit persistence, lab mutations, and recommendation internals. Several domain links are documented only at product level or were not sampled, so those edges are marked unverified.
Main entry points: api REST clients · CandidateGenerator.java Candidate generation · TimetableController.java Published timetable · LabService.java Lab capabilities
Components 20
Web application
- Role-based routes
frontend/src/routes/AppRoutes.tsx - Role workflows
frontend/src/features - REST clients
frontend/src/api
Academic operations
- Academic structure
backend/src/main/java/com/college/laballocation/academic - Faculty availability
backend/src/main/java/com/college/laballocation/faculty - Subject requirements
backend/src/main/java/com/college/laballocation/subject - Lab capabilities
backend/src/main/java/com/college/laballocation/lab/LabService.java - Timetable import
backend/src/main/java/com/college/laballocation/timetableimport - Extra-lab booking
backend/src/main/java/com/college/laballocation/scheduling/extra/ExtraLabService.java
Scheduling engine
- Candidate generation
backend/src/main/java/com/college/laballocation/scheduling/generation/CandidateGenerator.java - Hard constraints
backend/src/main/java/com/college/laballocation/scheduling/constraint/ConstraintEngine.java - Candidate scoring
backend/src/main/java/com/college/laballocation/scheduling/scoring/ScoringEngine.java - Recommendations
backend/src/main/java/com/college/laballocation/scheduling/explanation/ExplainableAllocationService.java - Schedule versions
backend/src/main/java/com/college/laballocation/scheduling/ScheduleVersionService.java - Published timetable
backend/src/main/java/com/college/laballocation/scheduling/TimetableController.java
Operations insight
- Scheduling analytics
backend/src/main/java/com/college/laballocation/analytics/AnalyticsService.java - Audit history
backend/src/main/java/com/college/laballocation/audit/AuditLogService.java
Backend platform
- Authentication
backend/src/main/java/com/college/laballocation/auth/AuthService.java - PostgreSQL
Other components
- College users
Connections 29
- College users → Role-based routes: uses
frontend/src/routes/AppRoutes.tsx - Role-based routes → Role workflows: routes to
frontend/src/routes/AppRoutes.tsx - Role workflows → REST clients: requests data
frontend/src/features/auth/RequireRouteRole.tsx - REST clients → Authentication: REST/JSON
README.md - Authentication → PostgreSQL: reads accounts
- REST clients → Academic structure: REST/JSON
README.md - REST clients → Faculty availability: REST/JSON
README.md - REST clients → Subject requirements: REST/JSON
README.md - REST clients → Lab capabilities: REST/JSON
README.md - REST clients → Timetable import: REST/JSON
README.md - REST clients → Extra-lab booking: REST/JSON
README.md - REST clients → Published timetable: REST/JSON
README.md - Candidate generation → Hard constraints: evaluates candidates
- Candidate generation → Candidate scoring: scores candidates
- Recommendations → Candidate generation: uses results
backend/src/main/java/com/college/laballocation/scheduling/explanation/ExplainableAllocationService.java - Recommendations → Candidate scoring: uses scores
backend/src/main/java/com/college/laballocation/scheduling/explanation/ExplainableAllocationService.java - Published timetable → Candidate generation: schedules
- Schedule versions → Published timetable: publishes versions
- Timetable import → Published timetable: imports schedule data
- Extra-lab booking → Audit history: records actions
backend/src/main/java/com/college/laballocation/scheduling/extra/ExtraLabService.java - Scheduling analytics → PostgreSQL: queries metrics
- Audit history → PostgreSQL: persists events
backend/src/main/java/com/college/laballocation/audit/AuditLogService.java - Lab capabilities → Audit history: records mutations
backend/src/main/java/com/college/laballocation/lab/LabService.java - Academic structure → PostgreSQL: stores records
- Faculty availability → PostgreSQL: stores availability
- Subject requirements → PostgreSQL: stores requirements
- Lab capabilities → PostgreSQL: stores lab data
- Candidate generation → PostgreSQL: loads scheduling data
- Schedule versions → PostgreSQL: stores versions