How hamza2024-code/sig works
SIG/SGFEP is a national vocational-training management platform. Users enter through web or API routes, authenticate, and use scoped management screens or APIs to manage training, staff, finance, and related records; dashboards and reports expose operational results. The README also documents HFSQL synchronization and MFA/security capabilities. Sampled code confirms route registration, database adaptation, and authorization behavior; several feature links below reflect README descriptions because their implementations were not sampled.
Main entry points: api.php API routes · DashboardController.php Executive dashboard · RouteServiceProvider.php Route registration · LoginController.php Authentication
Components 20
Access and security
- Route registration
app/Providers/RouteServiceProvider.php - Web routes
routes/web.php - API routes
routes/api.php - Authentication
app/Http/Controllers/Auth/LoginController.php - Authorization
app/Security/AuthorizationService.php
Training operations
- Academic management
app/Domains/Academic/Controllers/GradesController.php - Trainee enrollment
app/Domains/Academic/Services/ApprenantService.php
Management services
- Director portal
app/Http/Controllers/PortalController.php - Employee services
app/Services/Employee/EmployeeQueryService.php - Finance operations
app/Domains/Finance/Services/BudgetService.php - Dynamic API engine
app/Services/DynamicApiEngineService.php
Analytics and reports
- Executive dashboard
app/Http/Controllers/DashboardController.php - KPI and statistics
app/Services/StatsService.php - Report generation
app/Domains/Reporting/Services/ReportingService.php
Data and synchronization
- HFSQL synchronization
app/Domains/Sync/Services/SyncService.php - Sync queue worker
storage/workers/queue_worker.php - Database adapter
app/Core/LaravelDbAdapter.php - Application database
app/Core/Database.php - Reference data cache
app/Services/ReferenceCache.php
Other components
- Platform users
Connections 20
- Platform users → Web routes: use web
- Platform users → API routes: call API
- Route registration → Web routes: registers
app/Providers/RouteServiceProvider.php - Route registration → API routes: registers
app/Providers/RouteServiceProvider.php - Platform users → Authentication: authenticate
- Authentication → Authorization: enforce access
- Platform users → Executive dashboard: view KPIs
- Executive dashboard → KPI and statistics: uses statistics
app/Http/Controllers/DashboardController.php - Executive dashboard → Reference data cache: reads references
app/Http/Controllers/DashboardController.php - Platform users → Academic management: manage training
- Academic management → Trainee enrollment: uses trainee service
app/Domains/Academic/Controllers/GradesController.php - Platform users → Director portal: manage sector
- Platform users → Employee services: manage staff
- Platform users → Finance operations: manage budgets
- Platform users → Report generation: request reports
- Report generation → API routes: streams responses
- API routes → Dynamic API engine: dispatches requests
- Sync queue worker → HFSQL synchronization: invokes sync
storage/workers/queue_worker.php - HFSQL synchronization → Application database: syncs records
- Application database → Database adapter: creates adapter
app/Core/Database.php