# shawnabaco/phil_sys architecture

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

- Interactive diagram: https://gitdiagram.com/shawnabaco/phil_sys
- Repository: https://github.com/shawnabaco/phil_sys

## Overview

This Laravel application appears to manage public-service appointments and queues across client, operator, screener, and administrator roles. The main workflow is appointment intake and queue display, followed by staff serving and status updates, with reporting and exports for operational review. Administration also covers accounts, approvals, settings, service windows, and logs; registration and verification include email. The README describes Laravel rather than these product features, so the domain map is based on the tree and SOURCE INDEX references; several controller implementations were not sampled.

Main entry points: [`routes/web.php`](https://github.com/shawnabaco/phil_sys/blob/main/routes/web.php) (Web routes), [`app/Models/TblAppointment.php`](https://github.com/shawnabaco/phil_sys/blob/main/app/Models/TblAppointment.php) (Appointment records), [`app/Models/User.php`](https://github.com/shawnabaco/phil_sys/blob/main/app/Models/User.php) (User records), [`app/Http/Controllers/Auth/RegistrationController.php`](https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Auth/RegistrationController.php) (Registration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Web entry"]
  node_routes["Web routes<br/>[web.php]"]
end

subgraph group_queue["Queue operations"]
  node_client["Client queue view"]
  node_operator["Operator serving"]
  node_screener["Screener appointments"]
  node_screener_dash["Screener dashboard"]
  node_screener_transactions["Screener transactions"]
end

subgraph group_admin["Administration"]
  node_admin_dashboard["Admin dashboard"]
  node_admin_appointments["Appointment administration"]
  node_admin_users["User administration<br/>[UserController.php]"]
  node_approvals["Account approvals"]
  node_logs["Activity logs<br/>[LogController.php]"]
  node_settings["Settings and windows"]
  node_window_admin["Service windows"]
end

subgraph group_identity["Accounts and mail"]
  node_registration["Registration"]
  node_verification["Email verification"]
  node_login["Login"]
  node_profile["Profile settings"]
  node_mail_helper["Mail helper<br/>[MailHelper.php]"]
  node_mailer["SMTP mail service"]
end

subgraph group_data["Data and exports"]
  node_screener_reports["Screener reports"]
  node_operator_reports["Operator reports"]
  node_admin_reports["Admin reports"]
  node_admin_exports["Export actions"]
  node_appointments[("Appointment records<br/>[TblAppointment.php]")]
  node_users[("User records<br/>[User.php]")]
  node_activity_log[("Activity log records<br/>[ActivityLog.php]")]
  node_appointment_export["Appointment export"]
  node_admin_report_export["Admin report export<br/>[ReportExport.php]"]
  node_operator_report_export["Operator report export"]
  node_screener_report_export["Screener report export"]
end

node_visitors(("Visitors and staff"))

node_visitors -.->|"send requests"| node_routes
node_routes -->|"routes to"| node_client
node_routes -->|"routes to"| node_operator
node_routes -->|"routes to"| node_screener
node_routes -->|"routes to"| node_screener_dash
node_routes -->|"routes to"| node_screener_transactions
node_routes -->|"routes to"| node_screener_reports
node_routes -->|"routes to"| node_operator_reports
node_routes -->|"routes to"| node_admin_dashboard
node_routes -->|"routes to"| node_admin_appointments
node_routes -->|"routes to"| node_admin_users
node_routes -->|"routes to"| node_approvals
node_routes -->|"routes to"| node_admin_reports
node_routes -->|"routes to"| node_admin_exports
node_routes -->|"routes to"| node_logs
node_routes -->|"routes to"| node_settings
node_routes -->|"routes to"| node_window_admin
node_routes -->|"routes to"| node_registration
node_routes -->|"routes to"| node_verification
node_routes -->|"routes to"| node_login
node_routes -->|"routes to"| node_profile
node_client -->|"reads queue"| node_appointments
node_operator -->|"reads and updates"| node_appointments
node_screener -->|"uses records"| node_appointments
node_screener_dash -->|"reads records"| node_appointments
node_screener_reports -->|"queries records"| node_appointments
node_operator_reports -->|"queries records"| node_appointments
node_admin_reports -->|"queries records"| node_appointments
node_admin_appointments -->|"uses records"| node_appointments
node_admin_dashboard -->|"queries records"| node_appointments
node_admin_users -->|"manages accounts"| node_users
node_approvals -->|"updates accounts"| node_users
node_admin_reports -->|"queries accounts"| node_users
node_admin_dashboard -->|"queries accounts"| node_users
node_registration -->|"creates accounts"| node_users
node_profile -->|"updates account"| node_users
node_logs -->|"uses log records"| node_activity_log
node_admin_exports -->|"creates export"| node_appointment_export
node_admin_exports -->|"creates export"| node_admin_report_export
node_operator_reports -->|"creates export"| node_operator_report_export
node_screener_reports -->|"creates export"| node_screener_report_export
node_screener -->|"uses export"| node_appointment_export
node_screener_dash -->|"uses export"| node_appointment_export
node_registration -->|"uses helper"| node_mail_helper
node_mail_helper -->|"calls service"| node_mailer
node_registration -->|"sends approval email"| node_mailer
node_verification -->|"sends email"| node_mailer
node_appointments -->|"belongs to"| node_users

click node_routes "https://github.com/shawnabaco/phil_sys/blob/main/routes/web.php"
click node_client "https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Client/ClientController.php"
click node_operator "https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Operator/OperatorController.php"
click node_screener "https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Screener/AAppointmentController.php"
click node_screener_dash "https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Screener/ADashboardController.php"
click node_screener_transactions "https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Screener/ATransactionsController.php"
click node_screener_reports "https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Screener/AReportController.php"
click node_operator_reports "https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Operator/OReportController.php"
click node_admin_dashboard "https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Admin/DashboardController.php"
click node_admin_appointments "https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Admin/AppointmentsController.php"
click node_admin_users "https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Admin/UserController.php"
click node_approvals "https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Admin/ApprovalController.php"
click node_admin_reports "https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Admin/ReportController.php"
click node_admin_exports "https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Admin/ExportController.php"
click node_logs "https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Admin/LogController.php"
click node_settings "https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Admin/SettingController.php"
click node_window_admin "https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Admin/WindowController.php"
click node_registration "https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Auth/RegistrationController.php"
click node_verification "https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Auth/VerificationController.php"
click node_login "https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Auth/LoginController.php"
click node_profile "https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Profile/ProfileController.php"
click node_appointments "https://github.com/shawnabaco/phil_sys/blob/main/app/Models/TblAppointment.php"
click node_users "https://github.com/shawnabaco/phil_sys/blob/main/app/Models/User.php"
click node_activity_log "https://github.com/shawnabaco/phil_sys/blob/main/app/Models/ActivityLog.php"
click node_mail_helper "https://github.com/shawnabaco/phil_sys/blob/main/app/Traits/MailHelper.php"
click node_mailer "https://github.com/shawnabaco/phil_sys/blob/main/app/Services/PHPMailerService.php"
click node_appointment_export "https://github.com/shawnabaco/phil_sys/blob/main/app/Exports/AppointmentsExport.php"
click node_admin_report_export "https://github.com/shawnabaco/phil_sys/blob/main/app/Exports/Admin/ReportExport.php"
click node_operator_report_export "https://github.com/shawnabaco/phil_sys/blob/main/app/Exports/OperatorReportExport.php"
click node_screener_report_export "https://github.com/shawnabaco/phil_sys/blob/main/app/Exports/ScreenerReportExport.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_routes toneBlue
class node_client,node_operator,node_screener,node_screener_dash,node_screener_transactions toneAmber
class node_admin_dashboard,node_admin_appointments,node_admin_users,node_approvals,node_logs,node_settings,node_window_admin toneMint
class node_registration,node_verification,node_login,node_profile,node_mail_helper,node_mailer toneRose
class node_screener_reports,node_operator_reports,node_admin_reports,node_admin_exports,node_appointments,node_users,node_activity_log,node_appointment_export,node_admin_report_export,node_operator_report_export,node_screener_report_export,node_visitors toneIndigo
```

## Components

### Web entry

- [Web routes](https://github.com/shawnabaco/phil_sys/blob/main/routes/web.php): `routes/web.php`

### Queue operations

- [Client queue view](https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Client/ClientController.php): `app/Http/Controllers/Client/ClientController.php`
- [Operator serving](https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Operator/OperatorController.php): `app/Http/Controllers/Operator/OperatorController.php`
- [Screener appointments](https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Screener/AAppointmentController.php): `app/Http/Controllers/Screener/AAppointmentController.php`
- [Screener dashboard](https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Screener/ADashboardController.php): `app/Http/Controllers/Screener/ADashboardController.php`
- [Screener transactions](https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Screener/ATransactionsController.php): `app/Http/Controllers/Screener/ATransactionsController.php`

### Administration

- [Admin dashboard](https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Admin/DashboardController.php): `app/Http/Controllers/Admin/DashboardController.php`
- [Appointment administration](https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Admin/AppointmentsController.php): `app/Http/Controllers/Admin/AppointmentsController.php`
- [User administration](https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Admin/UserController.php): `app/Http/Controllers/Admin/UserController.php`
- [Account approvals](https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Admin/ApprovalController.php): `app/Http/Controllers/Admin/ApprovalController.php`
- [Activity logs](https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Admin/LogController.php): `app/Http/Controllers/Admin/LogController.php`
- [Settings and windows](https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Admin/SettingController.php): `app/Http/Controllers/Admin/SettingController.php`
- [Service windows](https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Admin/WindowController.php): `app/Http/Controllers/Admin/WindowController.php`

### Accounts and mail

- [Registration](https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Auth/RegistrationController.php): `app/Http/Controllers/Auth/RegistrationController.php`
- [Email verification](https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Auth/VerificationController.php): `app/Http/Controllers/Auth/VerificationController.php`
- [Login](https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Auth/LoginController.php): `app/Http/Controllers/Auth/LoginController.php`
- [Profile settings](https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Profile/ProfileController.php): `app/Http/Controllers/Profile/ProfileController.php`
- [Mail helper](https://github.com/shawnabaco/phil_sys/blob/main/app/Traits/MailHelper.php): `app/Traits/MailHelper.php`
- [SMTP mail service](https://github.com/shawnabaco/phil_sys/blob/main/app/Services/PHPMailerService.php): `app/Services/PHPMailerService.php`

### Data and exports

- [Screener reports](https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Screener/AReportController.php): `app/Http/Controllers/Screener/AReportController.php`
- [Operator reports](https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Operator/OReportController.php): `app/Http/Controllers/Operator/OReportController.php`
- [Admin reports](https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Admin/ReportController.php): `app/Http/Controllers/Admin/ReportController.php`
- [Export actions](https://github.com/shawnabaco/phil_sys/blob/main/app/Http/Controllers/Admin/ExportController.php): `app/Http/Controllers/Admin/ExportController.php`
- [Appointment records](https://github.com/shawnabaco/phil_sys/blob/main/app/Models/TblAppointment.php): `app/Models/TblAppointment.php`
- [User records](https://github.com/shawnabaco/phil_sys/blob/main/app/Models/User.php): `app/Models/User.php`
- [Activity log records](https://github.com/shawnabaco/phil_sys/blob/main/app/Models/ActivityLog.php): `app/Models/ActivityLog.php`
- [Appointment export](https://github.com/shawnabaco/phil_sys/blob/main/app/Exports/AppointmentsExport.php): `app/Exports/AppointmentsExport.php`
- [Admin report export](https://github.com/shawnabaco/phil_sys/blob/main/app/Exports/Admin/ReportExport.php): `app/Exports/Admin/ReportExport.php`
- [Operator report export](https://github.com/shawnabaco/phil_sys/blob/main/app/Exports/OperatorReportExport.php): `app/Exports/OperatorReportExport.php`
- [Screener report export](https://github.com/shawnabaco/phil_sys/blob/main/app/Exports/ScreenerReportExport.php): `app/Exports/ScreenerReportExport.php`

### Other components

- **Visitors and staff**

## Connections

- Visitors and staff → Web routes: send requests
- Web routes → Client queue view: routes to (evidence: `routes/web.php`)
- Web routes → Operator serving: routes to (evidence: `routes/web.php`)
- Web routes → Screener appointments: routes to (evidence: `routes/web.php`)
- Web routes → Screener dashboard: routes to (evidence: `routes/web.php`)
- Web routes → Screener transactions: routes to (evidence: `routes/web.php`)
- Web routes → Screener reports: routes to (evidence: `routes/web.php`)
- Web routes → Operator reports: routes to (evidence: `routes/web.php`)
- Web routes → Admin dashboard: routes to (evidence: `routes/web.php`)
- Web routes → Appointment administration: routes to (evidence: `routes/web.php`)
- Web routes → User administration: routes to (evidence: `routes/web.php`)
- Web routes → Account approvals: routes to (evidence: `routes/web.php`)
- Web routes → Admin reports: routes to (evidence: `routes/web.php`)
- Web routes → Export actions: routes to (evidence: `routes/web.php`)
- Web routes → Activity logs: routes to (evidence: `routes/web.php`)
- Web routes → Settings and windows: routes to (evidence: `routes/web.php`)
- Web routes → Service windows: routes to (evidence: `routes/web.php`)
- Web routes → Registration: routes to (evidence: `routes/web.php`)
- Web routes → Email verification: routes to (evidence: `routes/web.php`)
- Web routes → Login: routes to (evidence: `routes/web.php`)
- Web routes → Profile settings: routes to (evidence: `routes/web.php`)
- Client queue view → Appointment records: reads queue (evidence: `app/Http/Controllers/Client/ClientController.php`)
- Operator serving → Appointment records: reads and updates (evidence: `app/Http/Controllers/Operator/OperatorController.php`)
- Screener appointments → Appointment records: uses records (evidence: `app/Http/Controllers/Screener/AAppointmentController.php`)
- Screener dashboard → Appointment records: reads records (evidence: `app/Http/Controllers/Screener/ADashboardController.php`)
- Screener reports → Appointment records: queries records (evidence: `app/Http/Controllers/Screener/AReportController.php`)
- Operator reports → Appointment records: queries records (evidence: `app/Http/Controllers/Operator/OReportController.php`)
- Admin reports → Appointment records: queries records (evidence: `app/Http/Controllers/Admin/ReportController.php`)
- Appointment administration → Appointment records: uses records (evidence: `app/Http/Controllers/Admin/AppointmentsController.php`)
- Admin dashboard → Appointment records: queries records (evidence: `app/Http/Controllers/Admin/DashboardController.php`)
- User administration → User records: manages accounts (evidence: `app/Http/Controllers/Admin/UserController.php`)
- Account approvals → User records: updates accounts (evidence: `app/Http/Controllers/Admin/ApprovalController.php`)
- Admin reports → User records: queries accounts (evidence: `app/Http/Controllers/Admin/ReportController.php`)
- Admin dashboard → User records: queries accounts (evidence: `app/Http/Controllers/Admin/DashboardController.php`)
- Registration → User records: creates accounts (evidence: `app/Http/Controllers/Auth/RegistrationController.php`)
- Profile settings → User records: updates account (evidence: `app/Http/Controllers/Profile/ProfileController.php`)
- Activity logs → Activity log records: uses log records (evidence: `app/Http/Controllers/Admin/LogController.php`)
- Export actions → Appointment export: creates export (evidence: `app/Http/Controllers/Admin/ExportController.php`)
- Export actions → Admin report export: creates export (evidence: `app/Http/Controllers/Admin/ExportController.php`)
- Operator reports → Operator report export: creates export (evidence: `app/Http/Controllers/Operator/OReportController.php`)
- Screener reports → Screener report export: creates export (evidence: `app/Http/Controllers/Screener/AReportController.php`)
- Screener appointments → Appointment export: uses export (evidence: `app/Http/Controllers/Screener/AAppointmentController.php`)
- Screener dashboard → Appointment export: uses export (evidence: `app/Http/Controllers/Screener/ADashboardController.php`)
- Registration → Mail helper: uses helper (evidence: `app/Http/Controllers/Auth/RegistrationController.php`)
- Mail helper → SMTP mail service: calls service (evidence: `app/Traits/MailHelper.php`)
- Registration → SMTP mail service: sends approval email (evidence: `app/Http/Controllers/Auth/RegistrationController.php`)
- Email verification → SMTP mail service: sends email (evidence: `app/Http/Controllers/Auth/VerificationController.php`)
- Appointment records → User records: belongs to (evidence: `app/Models/TblAppointment.php`)
