# counterflower/capstone architecture

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

- Interactive diagram: https://gitdiagram.com/counterflower/capstone
- Repository: https://github.com/counterflower/capstone

## Overview

Barangay Bagumbayan’s Laravel application supports public services and staff operations: residents can request documents, report incidents and register for events; officials manage resident records, issue documents, review cases and schedule activities. Requests enter through web routes and are dispatched to controllers, with resident and event services/repositories handling selected domain operations and database-backed records. The README describes QR verification and broader case workflows; unsampled implementation details are represented only where documented, not as inferred call chains.

Main entry points: [`routes/web.php`](https://github.com/counterflower/capstone/blob/main/routes/web.php) (Web routes), [`app/Services/ResidentService.php`](https://github.com/counterflower/capstone/blob/main/app/Services/ResidentService.php) (Resident services), [`app/Http/Controllers/DashboardController.php`](https://github.com/counterflower/capstone/blob/main/app/Http/Controllers/DashboardController.php) (Admin dashboard), [`app/Http/Controllers/DocumentRequestController.php`](https://github.com/counterflower/capstone/blob/main/app/Http/Controllers/DocumentRequestController.php) (Document administration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Web access"]
  node_web_routes["Web routes<br/>[web.php]"]
  node_dashboard["Admin dashboard"]
  node_admin_auth["Staff authentication"]
  node_inactivity["Session timeout"]
end

subgraph group_people["Resident services"]
  node_resident_profile["Resident profiles"]
  node_resident_service["Resident services"]
  node_resident_repository["Resident data access"]
  node_resident_model[("Resident records<br/>[Resident.php]")]
end

subgraph group_governance["Documents and cases"]
  node_document_public["Public document requests"]
  node_document_admin["Document administration"]
  node_document_record[("Document requests")]
  node_verification_view["QR verification portal"]
  node_incident_public["Incident reporting"]
  node_incident_admin["Incident review"]
  node_incident_record[("Blotter cases")]
end

subgraph group_community["Community events"]
  node_event_admin["Event scheduling"]
  node_event_registration["Event enlistment"]
  node_event_service["Event operations"]
  node_event_record[("Event records<br/>[Event.php]")]
  node_event_signup_record[("RSVP records")]
end

node_public_actor(("Public resident"))
node_staff_actor(("Barangay staff"))

node_public_actor -->|"submits requests"| node_web_routes
node_staff_actor -->|"opens staff routes"| node_web_routes
node_web_routes -->|"dispatches auth"| node_admin_auth
node_web_routes -->|"dispatches dashboard"| node_dashboard
node_web_routes -->|"dispatches profile"| node_resident_profile
node_web_routes -->|"dispatches public pages"| node_document_public
node_web_routes -->|"dispatches document actions"| node_document_admin
node_web_routes -->|"dispatches case review"| node_incident_admin
node_web_routes -->|"dispatches event actions"| node_event_admin
node_web_routes -->|"dispatches RSVP"| node_event_registration
node_dashboard -->|"requests dashboard data"| node_resident_service
node_dashboard -->|"reads resident data"| node_resident_repository
node_dashboard -->|"loads event data"| node_event_service
node_resident_profile -->|"delegates updates"| node_resident_service
node_resident_service -->|"delegates persistence"| node_resident_repository
node_resident_repository -.->|"queries residents"| node_resident_model
node_document_public -->|"submits requests"| node_resident_service
node_document_admin -->|"approves requests"| node_resident_service
node_document_admin -->|"updates request status"| node_document_record
node_document_admin -->|"renders verification"| node_verification_view
node_incident_public -->|"submits report"| node_resident_service
node_incident_admin -->|"loads case data"| node_resident_service
node_incident_admin -.->|"manages cases"| node_incident_record
node_event_admin -->|"writes event data"| node_event_record
node_event_registration -->|"checks event"| node_event_record
node_event_registration -->|"matches residents"| node_resident_repository
node_event_service -->|"reads events"| node_event_record
node_event_registration -.->|"records RSVP"| node_event_signup_record
node_web_routes -->|"configures middleware"| node_inactivity

click node_web_routes "https://github.com/counterflower/capstone/blob/main/routes/web.php"
click node_dashboard "https://github.com/counterflower/capstone/blob/main/app/Http/Controllers/DashboardController.php"
click node_admin_auth "https://github.com/counterflower/capstone/blob/main/app/Http/Controllers/AdminAuthController.php"
click node_inactivity "https://github.com/counterflower/capstone/blob/main/app/Http/Middleware/CheckAdminInactivity.php"
click node_resident_profile "https://github.com/counterflower/capstone/blob/main/app/Http/Controllers/ResidentProfileController.php"
click node_resident_service "https://github.com/counterflower/capstone/blob/main/app/Services/ResidentService.php"
click node_resident_repository "https://github.com/counterflower/capstone/blob/main/app/Repositories/ResidentRepository.php"
click node_resident_model "https://github.com/counterflower/capstone/blob/main/app/Models/Resident.php"
click node_document_public "https://github.com/counterflower/capstone/blob/main/app/Http/Controllers/PublicPageController.php"
click node_document_admin "https://github.com/counterflower/capstone/blob/main/app/Http/Controllers/DocumentRequestController.php"
click node_document_record "https://github.com/counterflower/capstone/blob/main/app/Models/DocumentRequest.php"
click node_verification_view "https://github.com/counterflower/capstone/blob/main/resources/views/public/document_verification.blade.php"
click node_incident_public "https://github.com/counterflower/capstone/blob/main/app/Http/Controllers/PublicPageController.php"
click node_incident_admin "https://github.com/counterflower/capstone/blob/main/app/Http/Controllers/IncidentBlotterController.php"
click node_incident_record "https://github.com/counterflower/capstone/blob/main/app/Models/IncidentBlotter.php"
click node_event_admin "https://github.com/counterflower/capstone/blob/main/app/Http/Controllers/EventController.php"
click node_event_registration "https://github.com/counterflower/capstone/blob/main/app/Http/Controllers/EventRegistrationController.php"
click node_event_service "https://github.com/counterflower/capstone/blob/main/app/Services/PrototypeEventService.php"
click node_event_record "https://github.com/counterflower/capstone/blob/main/app/Models/Event.php"
click node_event_signup_record "https://github.com/counterflower/capstone/blob/main/app/Models/EventRegistration.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_web_routes,node_dashboard,node_admin_auth,node_inactivity toneBlue
class node_resident_profile,node_resident_service,node_resident_repository,node_resident_model toneAmber
class node_document_public,node_document_admin,node_document_record,node_verification_view,node_incident_public,node_incident_admin,node_incident_record toneMint
class node_event_admin,node_event_registration,node_event_service,node_event_record,node_event_signup_record toneRose
class node_public_actor,node_staff_actor toneIndigo
```

## Components

### Web access

- [Web routes](https://github.com/counterflower/capstone/blob/main/routes/web.php): `routes/web.php`
- [Admin dashboard](https://github.com/counterflower/capstone/blob/main/app/Http/Controllers/DashboardController.php): `app/Http/Controllers/DashboardController.php`
- [Staff authentication](https://github.com/counterflower/capstone/blob/main/app/Http/Controllers/AdminAuthController.php): `app/Http/Controllers/AdminAuthController.php`
- [Session timeout](https://github.com/counterflower/capstone/blob/main/app/Http/Middleware/CheckAdminInactivity.php): `app/Http/Middleware/CheckAdminInactivity.php`

### Resident services

- [Resident profiles](https://github.com/counterflower/capstone/blob/main/app/Http/Controllers/ResidentProfileController.php): `app/Http/Controllers/ResidentProfileController.php`
- [Resident services](https://github.com/counterflower/capstone/blob/main/app/Services/ResidentService.php): `app/Services/ResidentService.php`
- [Resident data access](https://github.com/counterflower/capstone/blob/main/app/Repositories/ResidentRepository.php): `app/Repositories/ResidentRepository.php`
- [Resident records](https://github.com/counterflower/capstone/blob/main/app/Models/Resident.php): `app/Models/Resident.php`

### Documents and cases

- [Public document requests](https://github.com/counterflower/capstone/blob/main/app/Http/Controllers/PublicPageController.php): `app/Http/Controllers/PublicPageController.php`
- [Document administration](https://github.com/counterflower/capstone/blob/main/app/Http/Controllers/DocumentRequestController.php): `app/Http/Controllers/DocumentRequestController.php`
- [Document requests](https://github.com/counterflower/capstone/blob/main/app/Models/DocumentRequest.php): `app/Models/DocumentRequest.php`
- [QR verification portal](https://github.com/counterflower/capstone/blob/main/resources/views/public/document_verification.blade.php): `resources/views/public/document_verification.blade.php`
- [Incident reporting](https://github.com/counterflower/capstone/blob/main/app/Http/Controllers/PublicPageController.php): `app/Http/Controllers/PublicPageController.php`
- [Incident review](https://github.com/counterflower/capstone/blob/main/app/Http/Controllers/IncidentBlotterController.php): `app/Http/Controllers/IncidentBlotterController.php`
- [Blotter cases](https://github.com/counterflower/capstone/blob/main/app/Models/IncidentBlotter.php): `app/Models/IncidentBlotter.php`

### Community events

- [Event scheduling](https://github.com/counterflower/capstone/blob/main/app/Http/Controllers/EventController.php): `app/Http/Controllers/EventController.php`
- [Event enlistment](https://github.com/counterflower/capstone/blob/main/app/Http/Controllers/EventRegistrationController.php): `app/Http/Controllers/EventRegistrationController.php`
- [Event operations](https://github.com/counterflower/capstone/blob/main/app/Services/PrototypeEventService.php): `app/Services/PrototypeEventService.php`
- [Event records](https://github.com/counterflower/capstone/blob/main/app/Models/Event.php): `app/Models/Event.php`
- [RSVP records](https://github.com/counterflower/capstone/blob/main/app/Models/EventRegistration.php): `app/Models/EventRegistration.php`

### Other components

- **Public resident**
- **Barangay staff**

## Connections

- Public resident → Web routes: submits requests (evidence: `routes/web.php`)
- Barangay staff → Web routes: opens staff routes (evidence: `routes/web.php`)
- Web routes → Staff authentication: dispatches auth (evidence: `routes/web.php`)
- Web routes → Admin dashboard: dispatches dashboard (evidence: `routes/web.php`)
- Web routes → Resident profiles: dispatches profile (evidence: `routes/web.php`)
- Web routes → Public document requests: dispatches public pages (evidence: `routes/web.php`)
- Web routes → Document administration: dispatches document actions (evidence: `routes/web.php`)
- Web routes → Incident review: dispatches case review (evidence: `routes/web.php`)
- Web routes → Event scheduling: dispatches event actions (evidence: `routes/web.php`)
- Web routes → Event enlistment: dispatches RSVP (evidence: `routes/web.php`)
- Admin dashboard → Resident services: requests dashboard data (evidence: `app/Http/Controllers/DashboardController.php`)
- Admin dashboard → Resident data access: reads resident data (evidence: `app/Http/Controllers/DashboardController.php`)
- Admin dashboard → Event operations: loads event data (evidence: `app/Http/Controllers/DashboardController.php`)
- Resident profiles → Resident services: delegates updates (evidence: `app/Http/Controllers/ResidentProfileController.php`)
- Resident services → Resident data access: delegates persistence (evidence: `app/Services/ResidentService.php`)
- Resident data access → Resident records: queries residents
- Public document requests → Resident services: submits requests (evidence: `app/Http/Controllers/PublicPageController.php`)
- Document administration → Resident services: approves requests (evidence: `app/Http/Controllers/DocumentRequestController.php`)
- Document administration → Document requests: updates request status (evidence: `app/Http/Controllers/DocumentRequestController.php`)
- Document administration → QR verification portal: renders verification (evidence: `app/Http/Controllers/DocumentRequestController.php`)
- Incident reporting → Resident services: submits report (evidence: `app/Http/Controllers/PublicPageController.php`)
- Incident review → Resident services: loads case data (evidence: `app/Http/Controllers/IncidentBlotterController.php`)
- Incident review → Blotter cases: manages cases
- Event scheduling → Event records: writes event data (evidence: `app/Http/Controllers/EventController.php`)
- Event enlistment → Event records: checks event (evidence: `app/Http/Controllers/EventRegistrationController.php`)
- Event enlistment → Resident data access: matches residents (evidence: `app/Http/Controllers/EventRegistrationController.php`)
- Event operations → Event records: reads events (evidence: `app/Services/PrototypeEventService.php`)
- Event enlistment → RSVP records: records RSVP
- Web routes → Session timeout: configures middleware
