# hamza2024-code/sig architecture

> Architecture diagram of the GitHub repository hamza2024-code/sig, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hamza2024-code/sig
- Repository: https://github.com/hamza2024-code/sig

## Overview

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: [`routes/api.php`](https://github.com/hamza2024-code/sig/blob/main/routes/api.php) (API routes), [`app/Http/Controllers/DashboardController.php`](https://github.com/hamza2024-code/sig/blob/main/app/Http/Controllers/DashboardController.php) (Executive dashboard), [`app/Providers/RouteServiceProvider.php`](https://github.com/hamza2024-code/sig/blob/main/app/Providers/RouteServiceProvider.php) (Route registration), [`app/Http/Controllers/Auth/LoginController.php`](https://github.com/hamza2024-code/sig/blob/main/app/Http/Controllers/Auth/LoginController.php) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and security"]
  node_route_provider["Route registration"]
  node_web_routes["Web routes<br/>[web.php]"]
  node_api_routes["API routes<br/>[api.php]"]
  node_login["Authentication"]
  node_authorization["Authorization"]
end

subgraph group_training["Training operations"]
  node_academic["Academic management"]
  node_enrollment["Trainee enrollment"]
end

subgraph group_management["Management services"]
  node_director_portal["Director portal"]
  node_employee["Employee services"]
  node_finance["Finance operations<br/>[BudgetService.php]"]
  node_dynamic_api["Dynamic API engine"]
end

subgraph group_insight["Analytics and reports"]
  node_dashboard["Executive dashboard"]
  node_analytics["KPI and statistics<br/>[StatsService.php]"]
  node_reporting["Report generation"]
end

subgraph group_platform["Data and synchronization"]
  node_sync["HFSQL synchronization<br/>[SyncService.php]"]
  node_sync_queue["Sync queue worker<br/>[queue_worker.php]"]
  node_db_adapter["Database adapter"]
  node_database[("Application database<br/>[Database.php]")]
  node_reference_cache["Reference data cache<br/>[ReferenceCache.php]"]
end

node_users(("Platform users"))

node_users -->|"use web"| node_web_routes
node_users -->|"call API"| node_api_routes
node_route_provider -->|"registers"| node_web_routes
node_route_provider -->|"registers"| node_api_routes
node_users -->|"authenticate"| node_login
node_login -.->|"enforce access"| node_authorization
node_users -->|"view KPIs"| node_dashboard
node_dashboard -->|"uses statistics"| node_analytics
node_dashboard -->|"reads references"| node_reference_cache
node_users -->|"manage training"| node_academic
node_academic -->|"uses trainee service"| node_enrollment
node_users -->|"manage sector"| node_director_portal
node_users -.->|"manage staff"| node_employee
node_users -.->|"manage budgets"| node_finance
node_users -.->|"request reports"| node_reporting
node_reporting -.->|"streams responses"| node_api_routes
node_api_routes -.->|"dispatches requests"| node_dynamic_api
node_sync_queue -->|"invokes sync"| node_sync
node_sync -.->|"syncs records"| node_database
node_database -->|"creates adapter"| node_db_adapter

click node_route_provider "https://github.com/hamza2024-code/sig/blob/main/app/Providers/RouteServiceProvider.php"
click node_web_routes "https://github.com/hamza2024-code/sig/blob/main/routes/web.php"
click node_api_routes "https://github.com/hamza2024-code/sig/blob/main/routes/api.php"
click node_login "https://github.com/hamza2024-code/sig/blob/main/app/Http/Controllers/Auth/LoginController.php"
click node_authorization "https://github.com/hamza2024-code/sig/blob/main/app/Security/AuthorizationService.php"
click node_dashboard "https://github.com/hamza2024-code/sig/blob/main/app/Http/Controllers/DashboardController.php"
click node_analytics "https://github.com/hamza2024-code/sig/blob/main/app/Services/StatsService.php"
click node_reporting "https://github.com/hamza2024-code/sig/blob/main/app/Domains/Reporting/Services/ReportingService.php"
click node_academic "https://github.com/hamza2024-code/sig/blob/main/app/Domains/Academic/Controllers/GradesController.php"
click node_enrollment "https://github.com/hamza2024-code/sig/blob/main/app/Domains/Academic/Services/ApprenantService.php"
click node_director_portal "https://github.com/hamza2024-code/sig/blob/main/app/Http/Controllers/PortalController.php"
click node_employee "https://github.com/hamza2024-code/sig/blob/main/app/Services/Employee/EmployeeQueryService.php"
click node_finance "https://github.com/hamza2024-code/sig/blob/main/app/Domains/Finance/Services/BudgetService.php"
click node_dynamic_api "https://github.com/hamza2024-code/sig/blob/main/app/Services/DynamicApiEngineService.php"
click node_sync "https://github.com/hamza2024-code/sig/blob/main/app/Domains/Sync/Services/SyncService.php"
click node_sync_queue "https://github.com/hamza2024-code/sig/blob/main/storage/workers/queue_worker.php"
click node_db_adapter "https://github.com/hamza2024-code/sig/blob/main/app/Core/LaravelDbAdapter.php"
click node_database "https://github.com/hamza2024-code/sig/blob/main/app/Core/Database.php"
click node_reference_cache "https://github.com/hamza2024-code/sig/blob/main/app/Services/ReferenceCache.php"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_route_provider,node_web_routes,node_api_routes,node_login,node_authorization,node_users toneBlue
class node_academic,node_enrollment toneAmber
class node_director_portal,node_employee,node_finance,node_dynamic_api toneMint
class node_dashboard,node_analytics,node_reporting toneRose
class node_sync,node_sync_queue,node_db_adapter,node_database,node_reference_cache toneIndigo
```

## Components

### Access and security

- [Route registration](https://github.com/hamza2024-code/sig/blob/main/app/Providers/RouteServiceProvider.php): `app/Providers/RouteServiceProvider.php`
- [Web routes](https://github.com/hamza2024-code/sig/blob/main/routes/web.php): `routes/web.php`
- [API routes](https://github.com/hamza2024-code/sig/blob/main/routes/api.php): `routes/api.php`
- [Authentication](https://github.com/hamza2024-code/sig/blob/main/app/Http/Controllers/Auth/LoginController.php): `app/Http/Controllers/Auth/LoginController.php`
- [Authorization](https://github.com/hamza2024-code/sig/blob/main/app/Security/AuthorizationService.php): `app/Security/AuthorizationService.php`

### Training operations

- [Academic management](https://github.com/hamza2024-code/sig/blob/main/app/Domains/Academic/Controllers/GradesController.php): `app/Domains/Academic/Controllers/GradesController.php`
- [Trainee enrollment](https://github.com/hamza2024-code/sig/blob/main/app/Domains/Academic/Services/ApprenantService.php): `app/Domains/Academic/Services/ApprenantService.php`

### Management services

- [Director portal](https://github.com/hamza2024-code/sig/blob/main/app/Http/Controllers/PortalController.php): `app/Http/Controllers/PortalController.php`
- [Employee services](https://github.com/hamza2024-code/sig/blob/main/app/Services/Employee/EmployeeQueryService.php): `app/Services/Employee/EmployeeQueryService.php`
- [Finance operations](https://github.com/hamza2024-code/sig/blob/main/app/Domains/Finance/Services/BudgetService.php): `app/Domains/Finance/Services/BudgetService.php`
- [Dynamic API engine](https://github.com/hamza2024-code/sig/blob/main/app/Services/DynamicApiEngineService.php): `app/Services/DynamicApiEngineService.php`

### Analytics and reports

- [Executive dashboard](https://github.com/hamza2024-code/sig/blob/main/app/Http/Controllers/DashboardController.php): `app/Http/Controllers/DashboardController.php`
- [KPI and statistics](https://github.com/hamza2024-code/sig/blob/main/app/Services/StatsService.php): `app/Services/StatsService.php`
- [Report generation](https://github.com/hamza2024-code/sig/blob/main/app/Domains/Reporting/Services/ReportingService.php): `app/Domains/Reporting/Services/ReportingService.php`

### Data and synchronization

- [HFSQL synchronization](https://github.com/hamza2024-code/sig/blob/main/app/Domains/Sync/Services/SyncService.php): `app/Domains/Sync/Services/SyncService.php`
- [Sync queue worker](https://github.com/hamza2024-code/sig/blob/main/storage/workers/queue_worker.php): `storage/workers/queue_worker.php`
- [Database adapter](https://github.com/hamza2024-code/sig/blob/main/app/Core/LaravelDbAdapter.php): `app/Core/LaravelDbAdapter.php`
- [Application database](https://github.com/hamza2024-code/sig/blob/main/app/Core/Database.php): `app/Core/Database.php`
- [Reference data cache](https://github.com/hamza2024-code/sig/blob/main/app/Services/ReferenceCache.php): `app/Services/ReferenceCache.php`

### Other components

- **Platform users**

## Connections

- Platform users → Web routes: use web
- Platform users → API routes: call API
- Route registration → Web routes: registers (evidence: `app/Providers/RouteServiceProvider.php`)
- Route registration → API routes: registers (evidence: `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 (evidence: `app/Http/Controllers/DashboardController.php`)
- Executive dashboard → Reference data cache: reads references (evidence: `app/Http/Controllers/DashboardController.php`)
- Platform users → Academic management: manage training
- Academic management → Trainee enrollment: uses trainee service (evidence: `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 (evidence: `storage/workers/queue_worker.php`)
- HFSQL synchronization → Application database: syncs records
- Application database → Database adapter: creates adapter (evidence: `app/Core/Database.php`)
