How eyzen08/sti-vio-log works
STI Vio-Log is a role-scoped student discipline and incident-management portal. Users sign in and work through student and violation records; required community service is assigned to departments, recorded through QR time-in/time-out, reviewed for credit, and reflected in clearance and certificates. The graph also preserves the documented student, communication, reporting, and administrative capabilities. README workflow documentation supports the domain-stage links; sampled excerpts confirm selected routing, database, and service calls, so uncertain controller wiring is omitted.
Main entry points: server.js HTTP API server · App.jsx Role-based portal · database.js PostgreSQL database · communityServiceSessionService.js Session processing
Components 22
User portal
- Role-based portal
frontend/src/App.jsx - Role route map
frontend/src/lib/routes.js - API client
frontend/src/lib/api.js - Login and onboarding
frontend/src/components/LoginPage.jsx - Student views
frontend/src/components/StudentDashboard.jsx - Administration views
frontend/src/components/AdminDashboard.jsx - Department views
frontend/src/components/DepartmentDashboard.jsx
Identity and administration
- HTTP API server
backend/src/server.js - Authentication and access
backend/src/middleware/authMiddleware.js - Authentication routes
backend/src/routes/authRoutes.js - Student records
backend/src/controllers/studentController.js
Discipline workflow
- Violation workflow
backend/src/services/violationWorkflowService.js - Service assignment
backend/src/controllers/communityServiceController.js
Service and attendance
- QR attendance
backend/src/controllers/qrController.js - Session processing
backend/src/services/communityServiceSessionService.js - Service result review
frontend/src/components/ServiceResultReview.jsx
Clearance and oversight
- Clearance processing
backend/src/controllers/clearanceController.js - Clearance certificates
backend/src/controllers/clearanceCertificateController.js - Reports, messages, audit
backend/src/controllers/reportController.js
Other components
- Students and staff
- PostgreSQL database
backend/src/config/database.js - Email delivery
Connections 36
- Students and staff → Role-based portal: use portal
- Role-based portal → Role route map: resolve role routes
- Role-based portal → API client: request data
- Role-based portal → Login and onboarding: show sign-in
- Role-based portal → Student views: show student views
- Role-based portal → Administration views: show admin views
- Role-based portal → Department views: show department views
- API client → HTTP API server: HTTP requests
- HTTP API server → Authentication and access: authenticate and authorize
- HTTP API server → Authentication routes: dispatch auth routes
- Authentication routes → PostgreSQL database: read and write
- HTTP API server → Student records: dispatch student routes
- Student records → PostgreSQL database: read and write
- HTTP API server → Violation workflow: dispatch violation operations
- Violation workflow → PostgreSQL database: read and write
- HTTP API server → Service assignment: dispatch service routes
- Service assignment → PostgreSQL database: read and write
- HTTP API server → QR attendance: dispatch QR routes
- QR attendance → Session processing: process attendance
- Session processing → PostgreSQL database: record sessions and progress
- Session processing → Violation workflow: transition violation
- Session processing → Reports, messages, audit: notify attendance staff
- Service result review → HTTP API server: submit review request
- HTTP API server → Clearance processing: dispatch clearance routes
- Clearance processing → PostgreSQL database: check eligibility and update
- Clearance processing → Clearance certificates: evaluate certificate eligibility
- HTTP API server → Clearance certificates: dispatch certificate routes
- Clearance certificates → PostgreSQL database: read and write
- Clearance certificates → Email delivery: send certificate
- HTTP API server → Reports, messages, audit: dispatch reporting routes
- Reports, messages, audit → PostgreSQL database: read and write
- Violation workflow → Service assignment: require service
- Service assignment → QR attendance: assigned service attendance
- Session processing → Service result review: pending result for review
- Service result review → Clearance processing: approved credit informs standing
- Clearance processing → Clearance certificates: eligible for certificate