How mark920-hub/ltnhs works
STNHS QR Attendance & Scheduling is a role-based school administration web app. Users authenticate, then manage attendance, schedules, enrollments and notifications through a React client backed by Express APIs and PostgreSQL; attendance reporting and live updates round out the workflow. The graph preserves README capabilities even where route or page implementation was not sampled. Client-to-route links reflect documented API domains, but detailed request wiring and storage behavior for unsampled modules are not inferred.
Main entry points: App.tsx Application router · schedules.ts Schedule API · attendance.ts Attendance API · db.ts Database access
Components 23
Web client
- Application router
client/src/App.tsx - Login and registration
client/src/pages/AuthPage.tsx - Dashboard reports
client/src/pages/DashboardPage.tsx - Attendance views
client/src/pages/AttendancePage.tsx - QR scan station
client/src/pages/ScanStationPage.tsx - Schedule workflows
client/src/pages/ScheduleSubmissionsPage.tsx - Teacher schedule tools
client/src/components/teacher/ScheduleSubmissionSection.tsx - Enrollment approvals
client/src/pages/EnrollmentSubmissionsPage.tsx - Student subjects
client/src/pages/StudentSubjectsPage.tsx - User administration
client/src/pages/UserManagementPage.tsx - Notifications
client/src/pages/NotificationsPage.tsx - Realtime client
client/src/lib/socket.ts
Identity and users
- Authentication API
server/src/auth.ts - User API
server/src/routes/users.ts
School operations
- Schedule API
server/src/routes/schedules.ts - Attendance API
server/src/routes/attendance.ts - Notification API
server/src/routes/notifications.ts
Server platform
- HTTP API server
server/src/index.ts - Authentication middleware
server/src/middleware.ts - Realtime events
server/src/socket.ts - Database access
server/src/db.ts - PostgreSQL
Other components
- School users
Connections 38
- School users → Application router: use
- Application router → Login and registration: routes to
- Application router → Dashboard reports: routes to
- Application router → Attendance views: routes to
- Application router → QR scan station: routes to
- Application router → Schedule workflows: routes to
- Application router → Enrollment approvals: routes to
- Application router → Student subjects: routes to
- Application router → User administration: routes to
- Application router → Notifications: routes to
- Teacher schedule tools → Schedule API: submits templates
- Login and registration → Authentication API: authenticates
- Dashboard reports → Attendance API: requests reports
- Attendance views → Attendance API: requests attendance
- QR scan station → Attendance API: logs scans
- Schedule workflows → Schedule API: manages schedules
- Enrollment approvals → Schedule API: reviews enrollments
- Student subjects → Schedule API: submits subjects
- User administration → User API: manages accounts
- Notifications → Notification API: loads notifications
- Notifications → Realtime client: receives events
- Realtime client → Realtime events: connects
- HTTP API server → Authentication API: mounts route
- HTTP API server → Schedule API: mounts route
- HTTP API server → Attendance API: mounts route
- HTTP API server → Notification API: mounts route
- HTTP API server → User API: mounts route
- Authentication API → Database access: queries
- User API → Authentication middleware: protects routes
- Schedule API → Authentication middleware: protects routes
- Attendance API → Authentication middleware: protects routes
- Notification API → Authentication middleware: protects routes
- User API → Database access: queries
- Schedule API → Database access: queries
- Attendance API → Database access: queries
- Notification API → Database access: queries
- Schedule API → Realtime events: emits updates
- Database access → PostgreSQL: reads and writes