# tknushi/capstone-katokkalinis architecture

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

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

## Overview

Katokkalinis is a municipal waste-management platform with resident, vendor, driver, inspector, and administrative workflows. Users enter through role-specific mobile screens; authentication services communicate with the Laravel API, whose routes dispatch requests to domain controllers. The backend covers vendor management, inspections, collection scheduling, attendance, incident reporting, and administration. The tree also contains separate resident/vendor and driver/inspector frontends. No README or frontend workflow excerpts were provided, so screen-to-service links and several domain details remain unverified.

Main entry points: [`backend/app/Models`](https://github.com/tknushi/capstone-katokkalinis/tree/main/backend/app/Models) (Domain records), [`backend/routes/api.php`](https://github.com/tknushi/capstone-katokkalinis/blob/main/backend/routes/api.php) (API route dispatch), [`Katokkalinis_mobile/app`](https://github.com/tknushi/capstone-katokkalinis/tree/main/Katokkalinis_mobile/app) (Mobile role screens), [`Katokkalinis_mobile/services/auth.ts`](https://github.com/tknushi/capstone-katokkalinis/blob/main/Katokkalinis_mobile/services/auth.ts) (Mobile authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Client apps"]
  node_mobile_routes["Mobile role screens"]
  node_mobile_auth["Mobile authentication<br/>[auth.ts]"]
  node_mobile_api["Mobile API client<br/>[api.ts]"]
  node_resident_frontend["Resident/vendor app"]
  node_field_frontend["Driver/inspector app"]
end

subgraph group_backend["API backend"]
  node_api_routes["API route dispatch<br/>[api.php]"]
  node_auth_controller["Authentication<br/>[AuthController.php]"]
end

subgraph group_operations["Field operations"]
  node_vendor_controller["Vendor management"]
  node_inspection_controller["Market inspections"]
  node_schedule_controller["Collection schedules"]
  node_attendance_controller["Staff attendance"]
  node_pileup_controller["Pile-up incidents"]
  node_analytics_controller["Operational analytics"]
end

subgraph group_domain["Domain data"]
  node_domain_models["Domain records"]
  node_database[("Application database")]
end

node_users(("Residents and staff"))
node_api_service["API service"]

node_users -.->|"use role screens"| node_mobile_routes
node_mobile_routes -.->|"authenticate"| node_mobile_auth
node_mobile_auth -->|"calls"| node_mobile_api
node_mobile_api -.->|"sends requests"| node_api_service
node_resident_frontend -.->|"uses API"| node_api_service
node_field_frontend -.->|"uses API"| node_api_service
node_api_service -.->|"routes requests"| node_api_routes
node_api_routes -->|"dispatches auth"| node_auth_controller
node_api_routes -->|"dispatches vendor routes"| node_vendor_controller
node_api_routes -->|"dispatches inspection routes"| node_inspection_controller
node_api_routes -->|"dispatches attendance routes"| node_attendance_controller
node_auth_controller -->|"reads and updates"| node_domain_models
node_vendor_controller -->|"reads and updates"| node_domain_models
node_attendance_controller -->|"reads and updates"| node_domain_models
node_pileup_controller -->|"queries incidents"| node_domain_models
node_analytics_controller -->|"aggregates records"| node_domain_models
node_domain_models -.->|"persist records"| node_database

click node_mobile_routes "https://github.com/tknushi/capstone-katokkalinis/tree/main/Katokkalinis_mobile/app"
click node_mobile_auth "https://github.com/tknushi/capstone-katokkalinis/blob/main/Katokkalinis_mobile/services/auth.ts"
click node_mobile_api "https://github.com/tknushi/capstone-katokkalinis/blob/main/Katokkalinis_mobile/services/api.ts"
click node_resident_frontend "https://github.com/tknushi/capstone-katokkalinis/tree/main/frontend/resident-vendor/app"
click node_field_frontend "https://github.com/tknushi/capstone-katokkalinis/tree/main/frontend/driver-inspector/app"
click node_api_routes "https://github.com/tknushi/capstone-katokkalinis/blob/main/backend/routes/api.php"
click node_auth_controller "https://github.com/tknushi/capstone-katokkalinis/blob/main/backend/app/Http/Controllers/Api/AuthController.php"
click node_vendor_controller "https://github.com/tknushi/capstone-katokkalinis/blob/main/backend/app/Http/Controllers/Api/VendorController.php"
click node_inspection_controller "https://github.com/tknushi/capstone-katokkalinis/blob/main/backend/app/Http/Controllers/Api/InspectionController.php"
click node_schedule_controller "https://github.com/tknushi/capstone-katokkalinis/blob/main/backend/app/Http/Controllers/Api/ScheduleController.php"
click node_attendance_controller "https://github.com/tknushi/capstone-katokkalinis/blob/main/backend/app/Http/Controllers/Api/AttendanceController.php"
click node_pileup_controller "https://github.com/tknushi/capstone-katokkalinis/blob/main/backend/app/Http/Controllers/Api/ClenroPileupReportController.php"
click node_analytics_controller "https://github.com/tknushi/capstone-katokkalinis/blob/main/backend/app/Http/Controllers/Api/AnalyticsController.php"
click node_domain_models "https://github.com/tknushi/capstone-katokkalinis/tree/main/backend/app/Models"

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_mobile_routes,node_mobile_auth,node_mobile_api,node_resident_frontend,node_field_frontend toneBlue
class node_api_routes,node_auth_controller toneAmber
class node_vendor_controller,node_inspection_controller,node_schedule_controller,node_attendance_controller,node_pileup_controller,node_analytics_controller,node_api_service toneMint
class node_domain_models,node_database toneRose
class node_users toneIndigo
```

## Components

### Client apps

- [Mobile role screens](https://github.com/tknushi/capstone-katokkalinis/tree/main/Katokkalinis_mobile/app): `Katokkalinis_mobile/app`
- [Mobile authentication](https://github.com/tknushi/capstone-katokkalinis/blob/main/Katokkalinis_mobile/services/auth.ts): `Katokkalinis_mobile/services/auth.ts`
- [Mobile API client](https://github.com/tknushi/capstone-katokkalinis/blob/main/Katokkalinis_mobile/services/api.ts): `Katokkalinis_mobile/services/api.ts`
- [Resident/vendor app](https://github.com/tknushi/capstone-katokkalinis/tree/main/frontend/resident-vendor/app): `frontend/resident-vendor/app`
- [Driver/inspector app](https://github.com/tknushi/capstone-katokkalinis/tree/main/frontend/driver-inspector/app): `frontend/driver-inspector/app`

### API backend

- [API route dispatch](https://github.com/tknushi/capstone-katokkalinis/blob/main/backend/routes/api.php): `backend/routes/api.php`
- [Authentication](https://github.com/tknushi/capstone-katokkalinis/blob/main/backend/app/Http/Controllers/Api/AuthController.php): `backend/app/Http/Controllers/Api/AuthController.php`

### Field operations

- [Vendor management](https://github.com/tknushi/capstone-katokkalinis/blob/main/backend/app/Http/Controllers/Api/VendorController.php): `backend/app/Http/Controllers/Api/VendorController.php`
- [Market inspections](https://github.com/tknushi/capstone-katokkalinis/blob/main/backend/app/Http/Controllers/Api/InspectionController.php): `backend/app/Http/Controllers/Api/InspectionController.php`
- [Collection schedules](https://github.com/tknushi/capstone-katokkalinis/blob/main/backend/app/Http/Controllers/Api/ScheduleController.php): `backend/app/Http/Controllers/Api/ScheduleController.php`
- [Staff attendance](https://github.com/tknushi/capstone-katokkalinis/blob/main/backend/app/Http/Controllers/Api/AttendanceController.php): `backend/app/Http/Controllers/Api/AttendanceController.php`
- [Pile-up incidents](https://github.com/tknushi/capstone-katokkalinis/blob/main/backend/app/Http/Controllers/Api/ClenroPileupReportController.php): `backend/app/Http/Controllers/Api/ClenroPileupReportController.php`
- [Operational analytics](https://github.com/tknushi/capstone-katokkalinis/blob/main/backend/app/Http/Controllers/Api/AnalyticsController.php): `backend/app/Http/Controllers/Api/AnalyticsController.php`

### Domain data

- [Domain records](https://github.com/tknushi/capstone-katokkalinis/tree/main/backend/app/Models): `backend/app/Models`
- **Application database**

### Other components

- **Residents and staff**
- **API service**

## Connections

- Residents and staff → Mobile role screens: use role screens
- Mobile role screens → Mobile authentication: authenticate
- Mobile authentication → Mobile API client: calls (evidence: `Katokkalinis_mobile/services/auth.ts`)
- Mobile API client → API service: sends requests
- Resident/vendor app → API service: uses API
- Driver/inspector app → API service: uses API
- API service → API route dispatch: routes requests
- API route dispatch → Authentication: dispatches auth (evidence: `backend/routes/api.php`)
- API route dispatch → Vendor management: dispatches vendor routes (evidence: `backend/routes/api.php`)
- API route dispatch → Market inspections: dispatches inspection routes (evidence: `backend/routes/api.php`)
- API route dispatch → Staff attendance: dispatches attendance routes (evidence: `backend/routes/api.php`)
- Authentication → Domain records: reads and updates (evidence: `backend/app/Http/Controllers/Api/AuthController.php`)
- Vendor management → Domain records: reads and updates (evidence: `backend/app/Http/Controllers/Api/VendorController.php`)
- Staff attendance → Domain records: reads and updates (evidence: `backend/app/Http/Controllers/Api/AttendanceController.php`)
- Pile-up incidents → Domain records: queries incidents (evidence: `backend/app/Http/Controllers/Api/ClenroPileupReportController.php`)
- Operational analytics → Domain records: aggregates records (evidence: `backend/app/Http/Controllers/Api/AnalyticsController.php`)
- Domain records → Application database: persist records
