How tech4ward2027/registrar-information-system works
This repository is a Registrar Information System: a React frontend and Laravel API for document-request filing and processing, account access, and registrar operations. The clearest user journey is a student entering the request experience, with the frontend routing to the request form and the API exposing document-request endpoints; the supplied excerpts do not show the form’s API calls or the request service’s internal flow. Other visible capabilities include SSO, AI analytics, audit logging, and undergraduate-requestor enrollment checks. Some major modules are listed but unsampled, so uncertain links are omitted.
Main entry points: SsoAuthService.php SSO authentication · App.jsx Application routes · AuditLogger.php Audit logging · AuthProvider.jsx Auth provider
Components 19
Web client
- Application routes
registrar-frontend/src/App.jsx - Request form
registrar-frontend/src/layouts - Auth provider
registrar-frontend/src/context/AuthProvider.jsx - API client
registrar-frontend/src/services
Request operations
- API routes
registrar-backend/routes/api.php - Document requests
registrar-backend/app/Http/Controllers/DocumentRequestController.php - Request processing
registrar-backend/app/Services/DocumentRequestService.php - Request records
registrar-backend/app/Models/DocumentRequest.php
Identity and access
- SSO authentication
registrar-backend/app/Services/Sso/SsoAuthService.php - User accounts
registrar-backend/app/Models/SystemUser.php - Access policies
registrar-backend/app/Models/Policy.php
Analytics and audit
- Analytics service
registrar-backend/app/Services/AnalyticsService.php - AI query endpoint
registrar-backend/app/Http/Controllers/AiQueryController.php - Audit logging
registrar-backend/app/Services/AuditLogger.php - Audit records
registrar-backend/app/Models/AuditLog.php
External systems
- Identity provider
- Enrollment check
registrar-backend/app/Services/Ogos/OgosEnrollmentLookupClient.php - OGOS system
Other components
- Registrar user
Connections 10
- Registrar user → Application routes: uses
- Application routes → Request form: routes to
registrar-frontend/src/App.jsx - API routes → Document requests: routes to
registrar-backend/routes/api.php - SSO authentication → Identity provider: exchanges credentials
registrar-backend/app/Services/Sso/SsoAuthService.php - SSO authentication → User accounts: provisions account
registrar-backend/app/Services/Sso/SsoAuthService.php - SSO authentication → Audit logging: records login
registrar-backend/app/Services/Sso/SsoAuthService.php - Audit logging → Audit records: writes entries
registrar-backend/app/Services/AuditLogger.php - Enrollment check → OGOS system: looks up enrollment
registrar-backend/app/Services/Ogos/OgosEnrollmentLookupClient.php - AI query endpoint → Analytics service: injects dependency
registrar-backend/app/Http/Controllers/AiQueryController.php - Auth provider → API client: calls API
registrar-frontend/src/services/authService.js