# sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v architecture

> Architecture diagram of the GitHub repository sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v
- Repository: https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v

## Overview

Victoria Crime Mapping System is a Laravel application for public incident reporting and viewing approved crime data. The main workflow is report submission: visitors choose an incident and map location, the server validates and saves it as pending, and staff must approve it directly in the database before it appears in public map and analytics views. Separate map and analytics routes query approved incidents. The README documents filtering, risk-colored markers, and OpenStreetMap tiles. The excerpts show route/controller/model/view interactions; staff review has no in-app screen.

Main entry points: [`app/Http/Controllers/CrimeDashboardController.php`](https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/app/Http/Controllers/CrimeDashboardController.php) (Map handler), [`app/Http/Controllers/CrimeReportController.php`](https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/app/Http/Controllers/CrimeReportController.php) (Report handler), [`routes/web.php`](https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/routes/web.php) (Web routes), [`app/Models/Crime.php`](https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/app/Models/Crime.php) (Crime records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Application runtime"]
  node_routes["Web routes<br/>[web.php]"]
  node_bootstrap["Laravel bootstrap<br/>[app.php]"]
  node_base_controller["Base controller<br/>[Controller.php]"]
  node_provider["App service provider"]
  node_frontend_entry["Frontend entry<br/>[app.js]"]
  node_mobile_menu["Mobile menu<br/>[mobile-menu.js]"]
end

subgraph group_reporting["Incident reporting"]
  node_report_controller["Report handler"]
  node_report_form["Report form<br/>[create.blade.php]"]
  node_report_script["Report interactions<br/>[crime-report.js]"]
end

subgraph group_mapping["Public crime map"]
  node_map_controller["Map handler"]
  node_map_view["Crime map page"]
  node_map_script["Map interactions<br/>[crime-map.js]"]
  node_home_view["Home page<br/>[home.blade.php]"]
end

subgraph group_analytics["Crime analytics"]
  node_analytics_view["Analytics page"]
end

subgraph group_domain["Crime data"]
  node_crime[("Crime records<br/>[Crime.php]")]
  node_barangay[("Barangay records<br/>[Barangay.php]")]
  node_user["User model<br/>[User.php]"]
  node_user_factory["User factory<br/>[UserFactory.php]"]
end

node_visitor(("Public visitor"))
node_osm["OpenStreetMap tiles"]

node_bootstrap -->|"loads routes"| node_routes
node_routes -->|"routes requests"| node_report_controller
node_routes -->|"routes requests"| node_map_controller
node_visitor -.->|"requests pages"| node_routes
node_report_controller -->|"renders form"| node_report_form
node_report_controller -->|"loads choices"| node_barangay
node_report_controller -->|"creates pending report"| node_crime
node_report_form -.->|"uses interactions"| node_report_script
node_map_controller -->|"queries approved"| node_crime
node_map_controller -->|"renders map"| node_map_view
node_map_controller -->|"renders analytics"| node_analytics_view
node_map_script -.->|"loads map tiles"| node_osm
node_visitor -.->|"opens home"| node_home_view
node_visitor -.->|"opens map and analytics"| node_map_controller
node_crime -->|"belongs to"| node_barangay
node_barangay -->|"has many"| node_crime
node_user_factory -->|"builds users"| node_user
node_frontend_entry -->|"imports"| node_mobile_menu
node_frontend_entry -->|"imports"| node_map_script

click node_routes "https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/routes/web.php"
click node_bootstrap "https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/bootstrap/app.php"
click node_base_controller "https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/app/Http/Controllers/Controller.php"
click node_provider "https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/app/Providers/AppServiceProvider.php"
click node_frontend_entry "https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/resources/js/app.js"
click node_mobile_menu "https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/resources/js/components/mobile-menu.js"
click node_report_controller "https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/app/Http/Controllers/CrimeReportController.php"
click node_report_form "https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/resources/views/crime-reports/create.blade.php"
click node_report_script "https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/resources/js/pages/crime-report.js"
click node_map_controller "https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/app/Http/Controllers/CrimeDashboardController.php"
click node_map_view "https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/resources/views/crime-map.blade.php"
click node_map_script "https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/resources/js/pages/crime-map.js"
click node_home_view "https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/resources/views/home.blade.php"
click node_analytics_view "https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/resources/views/analytics-dashboard.blade.php"
click node_crime "https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/app/Models/Crime.php"
click node_barangay "https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/app/Models/Barangay.php"
click node_user "https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/app/Models/User.php"
click node_user_factory "https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/database/factories/UserFactory.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,node_bootstrap,node_base_controller,node_provider,node_frontend_entry,node_mobile_menu toneBlue
class node_report_controller,node_report_form,node_report_script toneAmber
class node_map_controller,node_map_view,node_map_script,node_home_view toneMint
class node_analytics_view toneRose
class node_crime,node_barangay,node_user,node_user_factory,node_visitor,node_osm toneIndigo
```

## Components

### Application runtime

- [Web routes](https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/routes/web.php): `routes/web.php`
- [Laravel bootstrap](https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/bootstrap/app.php): `bootstrap/app.php`
- [Base controller](https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/app/Http/Controllers/Controller.php): `app/Http/Controllers/Controller.php`
- [App service provider](https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/app/Providers/AppServiceProvider.php): `app/Providers/AppServiceProvider.php`
- [Frontend entry](https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/resources/js/app.js): `resources/js/app.js`
- [Mobile menu](https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/resources/js/components/mobile-menu.js): `resources/js/components/mobile-menu.js`

### Incident reporting

- [Report handler](https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/app/Http/Controllers/CrimeReportController.php): `app/Http/Controllers/CrimeReportController.php`
- [Report form](https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/resources/views/crime-reports/create.blade.php): `resources/views/crime-reports/create.blade.php`
- [Report interactions](https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/resources/js/pages/crime-report.js): `resources/js/pages/crime-report.js`

### Public crime map

- [Map handler](https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/app/Http/Controllers/CrimeDashboardController.php): `app/Http/Controllers/CrimeDashboardController.php`
- [Crime map page](https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/resources/views/crime-map.blade.php): `resources/views/crime-map.blade.php`
- [Map interactions](https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/resources/js/pages/crime-map.js): `resources/js/pages/crime-map.js`
- [Home page](https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/resources/views/home.blade.php): `resources/views/home.blade.php`

### Crime analytics

- [Analytics page](https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/resources/views/analytics-dashboard.blade.php): `resources/views/analytics-dashboard.blade.php`

### Crime data

- [Crime records](https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/app/Models/Crime.php): `app/Models/Crime.php`
- [Barangay records](https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/app/Models/Barangay.php): `app/Models/Barangay.php`
- [User model](https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/app/Models/User.php): `app/Models/User.php`
- [User factory](https://github.com/sivenceako/ite311_final-project_bsit3-f2_mariano_vencent_v/blob/main/database/factories/UserFactory.php): `database/factories/UserFactory.php`

### Other components

- **Public visitor**
- **OpenStreetMap tiles**

## Connections

- Laravel bootstrap → Web routes: loads routes (evidence: `bootstrap/app.php`)
- Web routes → Report handler: routes requests (evidence: `routes/web.php`)
- Web routes → Map handler: routes requests (evidence: `routes/web.php`)
- Public visitor → Web routes: requests pages (evidence: `README.md`)
- Report handler → Report form: renders form (evidence: `app/Http/Controllers/CrimeReportController.php`)
- Report handler → Barangay records: loads choices (evidence: `app/Http/Controllers/CrimeReportController.php`)
- Report handler → Crime records: creates pending report (evidence: `app/Http/Controllers/CrimeReportController.php`)
- Report form → Report interactions: uses interactions
- Map handler → Crime records: queries approved (evidence: `app/Http/Controllers/CrimeDashboardController.php`)
- Map handler → Crime map page: renders map (evidence: `app/Http/Controllers/CrimeDashboardController.php`)
- Map handler → Analytics page: renders analytics (evidence: `app/Http/Controllers/CrimeDashboardController.php`)
- Map interactions → OpenStreetMap tiles: loads map tiles (evidence: `README.md`)
- Public visitor → Home page: opens home (evidence: `README.md`)
- Public visitor → Map handler: opens map and analytics (evidence: `README.md`)
- Crime records → Barangay records: belongs to (evidence: `app/Models/Crime.php`)
- Barangay records → Crime records: has many (evidence: `app/Models/Barangay.php`)
- User factory → User model: builds users (evidence: `database/factories/UserFactory.php`)
- Frontend entry → Mobile menu: imports (evidence: `resources/js/app.js`)
- Frontend entry → Map interactions: imports (evidence: `resources/js/app.js`)
