How mas0uu/dtr-system works
DTR Web App is a session-authenticated employee time-recording and payroll application. Employees record daily attendance, review monthly totals, and submit leave/absence requests; administrators manage employees and holidays, review attendance anomalies and audit activity, and generate, review, and finalize payroll. The Laravel controllers connect the Inertia pages to domain models, with dedicated payroll and leave-balance services. The README establishes the main capabilities; unsampled controllers are represented by their exact paths, with only documented or clearly owned relationships shown.
Main entry points: web.php Web routes · AdminPayrollController.php Payroll workflow · DtrRow.php DTR records · DtrMonthController.php Monthly DTR
Components 28
Access and UI
- Web routes
routes/web.php - Session authentication
app/Http/Controllers/Auth/AuthenticatedSessionController.php - Inertia application
resources/js/app.tsx
Attendance and leave
- DTR pages
resources/js/Pages/Dtr/Index.tsx - Monthly DTR
app/Http/Controllers/DtrMonthController.php - DTR row operations
app/Http/Controllers/DtrRowController.php - DTR API
app/Http/Controllers/Api/DtrRowController.php - Leave requests
app/Http/Controllers/EmployeeLeaveController.php - Leave balances
app/Services/LeaveBalanceService.php - Holiday views
app/Http/Controllers/EmployeeHolidayController.php
Administration
- Attendance review
app/Http/Controllers/AdminAttendanceController.php - Anomaly review
app/Http/Controllers/AdminAnomalyController.php - Employee management
app/Http/Controllers/AdminEmployeeController.php - Leave administration
app/Http/Controllers/AdminLeaveController.php - Holiday management
app/Http/Controllers/AdminHolidayController.php - Audit activity
app/Services/AuditLogger.php
Payroll
- Payroll workflow
app/Http/Controllers/AdminPayrollController.php - Payroll calculation
app/Services/PayrollCalculator.php - Payroll locking
app/Services/PayrollLockService.php - Payroll pages
resources/js/Pages/Admin/Payroll/Index.tsx
Domain and persistence
- Users
app/Models/User.php - DTR records
app/Models/DtrRow.php - Leave records
app/Models/LeaveRequest.php - Holiday records
app/Models/Holiday.php - Payroll records
app/Models/PayrollRecord.php - Audit records
app/Models/AuditLog.php
Other components
- Employee
- Administrator
Connections 38
- Employee → Web routes: requests
- Administrator → Web routes: requests
- Web routes → Session authentication: dispatches
- Session authentication → Users: authenticates
- Web routes → Monthly DTR: dispatches
- Web routes → DTR row operations: dispatches
- Web routes → DTR API: dispatches
- Web routes → Leave requests: dispatches
- Web routes → Holiday views: dispatches
- Web routes → Attendance review: dispatches
- Web routes → Anomaly review: dispatches
- Web routes → Employee management: dispatches
- Web routes → Leave administration: dispatches
- Web routes → Holiday management: dispatches
- Web routes → Payroll workflow: dispatches
- Monthly DTR → DTR records: reads
- Monthly DTR → Holiday records: reads
- Monthly DTR → Payroll records: reads
- DTR row operations → DTR records: updates
- DTR API → DTR records: creates and updates
- Employee management → Users: manages
- Holiday views → Holiday records: reads
- Holiday management → Holiday records: manages
- Leave requests → Leave records: manages
- Leave requests → Leave balances: uses
- Leave administration → Leave records: manages
- Attendance review → DTR records: reads
- Anomaly review → DTR records: reviews
- Payroll workflow → Payroll calculation: calculates
- Payroll workflow → Payroll records: creates and updates
- Payroll workflow → Audit activity: logs changes
- Payroll workflow → Payroll locking: uses
- Payroll calculation → DTR records: reads attendance
- Payroll workflow → Users: reads employees
- Payroll workflow → Payroll pages: renders
- Audit activity → Audit records: writes
- Web routes → Inertia application: serves Inertia
- Inertia application → DTR pages: resolves pages