How jaba24827/st-dwp-mvp works
SL-DWP is a Laravel digital workplace with Blade screens and a parallel React presentation tier. The main workflow is sign-in, MFA verification, then permission-scoped access to dashboards, documents, directory, announcements, audit, and administration features. Controllers handle resource operations; shared services provide MFA, document handling, and auditing, while Eloquent models represent the domain and persist state. The React session hook obtains permissions from the API. Some branches are documented but their source was not sampled, so their links are limited to documented or indexed relationships.
Main entry points: web.php Web routes · AuditLogger.php Audit logging · LoginController.php Password login · database.php MySQL database
Components 31
Application entry
- Laravel entry
public/index.php - Application setup
bootstrap/app.php - Web routes
routes/web.php - API routes
routes/api.php
Identity and access
- Password login
app/Http/Controllers/Auth/LoginController.php - MFA verification
app/Http/Controllers/Auth/MfaController.php - MFA service
app/Services/MfaService.php - MFA delivery
app/Notifications/MfaCodeNotification.php - Permission checks
app/Http/Middleware/EnsurePermission.php
Workplace features
- Dashboard
app/Http/Controllers/DashboardController.php - Staff directory
app/Http/Controllers/DirectoryController.php - Document access
app/Http/Controllers/DocumentController.php - Document handling
app/Services/DocumentService.php - Announcements
app/Http/Controllers/AnnouncementController.php - Audit review
app/Http/Controllers/AuditController.php - Role administration
app/Http/Controllers/RoleController.php - User administration
app/Http/Controllers/UserController.php
Domain and persistence
- Users and roles
app/Models/User.php - Role permissions
app/Models/Role.php - Permission records
app/Models/Permission.php - Audit logging
app/Services/AuditLogger.php - Audit records
app/Models/AuditLog.php - Document records
app/Models/Document.php - Sector records
app/Models/Sector.php - Announcement records
app/Models/Announcement.php - MySQL database
config/database.php
Presentation tiers
- React application
resources/js/app.jsx - Session and permissions
resources/js/hooks/useSession.jsx - React shell
resources/js/components/AppShell.jsx - Blade screens
resources/views
Other components
- Workplace user
Connections 41
- Workplace user → Laravel entry: requests
README.md - Laravel entry → Application setup: boots
public/index.php - Application setup → Web routes: registers
bootstrap/app.php - Workplace user → Password login: signs in
README.md - Web routes → Password login: routes to
routes/web.php - Password login → Users and roles: loads user
app/Http/Controllers/Auth/LoginController.php - Password login → MFA service: issues challenge
app/Http/Controllers/Auth/LoginController.php - Password login → Audit logging: records outcome
app/Http/Controllers/Auth/LoginController.php - MFA verification → MFA service: verifies code
app/Http/Controllers/Auth/MfaController.php - MFA service → MFA delivery: sends code
app/Services/MfaService.php - Permission checks → Audit logging: logs denial
app/Http/Middleware/EnsurePermission.php - Users and roles → Role permissions: checks permission
app/Models/User.php - Role permissions → Permission records: has permissions
app/Models/Role.php - Web routes → Dashboard: routes to
routes/web.php - Web routes → Staff directory: routes to
routes/web.php - Web routes → Document access: routes to
routes/web.php - Web routes → Announcements: routes to
routes/web.php - Web routes → Audit review: routes to
routes/web.php - Web routes → Role administration: routes to
routes/web.php - Web routes → User administration: routes to
routes/web.php - Document access → Document handling: stores and streams
app/Http/Controllers/DocumentController.php - Document access → Document records: queries records
app/Http/Controllers/DocumentController.php - Document access → Audit logging: records actions
app/Http/Controllers/DocumentController.php - Announcements → Announcement records: queries records
app/Http/Controllers/AnnouncementController.php - Announcements → Audit logging: records actions
app/Http/Controllers/AnnouncementController.php - Audit review → Audit records: reads records
app/Http/Controllers/AuditController.php - Audit logging → Audit records: writes records
app/Services/AuditLogger.php - Role administration → Role permissions: updates roles
app/Http/Controllers/RoleController.php - Role administration → Permission records: loads permissions
app/Http/Controllers/RoleController.php - User administration → Users and roles: manages users
app/Http/Controllers/UserController.php - User administration → Audit logging: records changes
app/Http/Controllers/UserController.php - React application → Session and permissions: provides session
resources/js/app.jsx - React application → React shell: renders routes
resources/js/app.jsx - Session and permissions → API routes: fetches session
resources/js/hooks/useSession.jsx - React application → API routes: calls API
resources/js/app.jsx - Workplace user → Blade screens: uses screens
README.md - Document records → MySQL database: persists
- Users and roles → MySQL database: persists
- Sector records → MySQL database: persists
- Announcement records → MySQL database: persists
- Audit records → MySQL database: persists