# ezekiellazaro/tropadev-it architecture

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

- Interactive diagram: https://gitdiagram.com/ezekiellazaro/tropadev-it
- Repository: https://github.com/ezekiellazaro/tropadev-it

## Overview

Barangay FixTrack lets residents submit facility-damage reports and officials review, filter, update, and monitor them. The principal flow runs from browser forms through the Java HTTP API into report handling and configured storage; dashboards and user-account management are additional capabilities. The README documents photo uploads, search/filtering, status updates, and dashboards, though several corresponding backend classes are not in the supplied tree. Arrows are limited to relationships shown in excerpts or the README; unsampled domain links are omitted.

Main entry points: [`backend/src/barangaydamagereporter/web/WebServer.java`](https://github.com/ezekiellazaro/tropadev-it/blob/main/backend/src/barangaydamagereporter/web/WebServer.java) (HTTP API and Static Server), [`backend/src/barangaydamagereporter/web/Main.java`](https://github.com/ezekiellazaro/tropadev-it/blob/main/backend/src/barangaydamagereporter/web/Main.java) (Application Startup), [`backend/src/barangaydamagereporter/service`](https://github.com/ezekiellazaro/tropadev-it/tree/main/backend/src/barangaydamagereporter/service) (Report Handling), [`backend/src/barangaydamagereporter/service/LoginManager.java`](https://github.com/ezekiellazaro/tropadev-it/blob/main/backend/src/barangaydamagereporter/service/LoginManager.java) (Authentication and Accounts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Resident and Official UI"]
  node_frontend["Web Interface<br/>[app.js]"]
  node_reportform["Report Submission<br/>[app.js]"]
  node_reportviews["Dashboards and Search<br/>[app.js]"]
end

subgraph group_http["HTTP Application"]
  node_entry["Application Startup<br/>[Main.java]"]
  node_server["HTTP API and Static Server<br/>[WebServer.java]"]
  node_paths["Project Paths<br/>[AppPaths.java]"]
  node_json["JSON Encoding<br/>[Json.java]"]
end

subgraph group_identity["Identity and Access"]
  node_login["Authentication and Accounts<br/>[LoginManager.java]"]
  node_user["User Roles<br/>[User.java]"]
end

subgraph group_reports["Report Domain"]
  node_actions["Report Operations Contract<br/>[ReportActions.java]"]
  node_reportdomain["Report Handling"]
end

subgraph group_storage["Report Storage"]
  node_sqlite[("SQLite Report Store")]
  node_filestore[("Text File Report Store")]
  node_reportdata["Report Data"]
  node_photos[("Uploaded Photos<br/>[WebServer.java]")]
end

node_resident(("Resident"))
node_browser(("Browser"))

node_resident -->|"uses"| node_browser
node_browser -->|"loads"| node_frontend
node_frontend -->|"renders"| node_reportform
node_frontend -->|"renders"| node_reportviews
node_reportform -->|"submits JSON"| node_server
node_reportviews -->|"requests data"| node_server
node_entry -->|"starts"| node_server
node_entry -->|"creates"| node_login
node_entry -->|"configures"| node_reportdomain
node_entry -->|"selects if available"| node_sqlite
node_entry -->|"selects fallback"| node_filestore
node_server -->|"authenticates"| node_login
node_server -->|"lists and adds accounts"| node_login
node_login -->|"checks credentials"| node_user
node_server -->|"handles report requests"| node_reportdomain
node_server -->|"builds report data"| node_reportdomain
node_server -->|"saves uploads"| node_photos
node_server -->|"encodes responses"| node_json
node_entry -->|"locates project files"| node_paths
node_actions -->|"implemented by"| node_reportdomain
node_reportdomain -.->|"manages"| node_reportdata
node_sqlite -.->|"persists"| node_reportdata
node_filestore -.->|"persists"| node_reportdata

click node_frontend "https://github.com/ezekiellazaro/tropadev-it/blob/main/frontend/app.js"
click node_reportform "https://github.com/ezekiellazaro/tropadev-it/blob/main/frontend/app.js"
click node_reportviews "https://github.com/ezekiellazaro/tropadev-it/blob/main/frontend/app.js"
click node_entry "https://github.com/ezekiellazaro/tropadev-it/blob/main/backend/src/barangaydamagereporter/web/Main.java"
click node_server "https://github.com/ezekiellazaro/tropadev-it/blob/main/backend/src/barangaydamagereporter/web/WebServer.java"
click node_paths "https://github.com/ezekiellazaro/tropadev-it/blob/main/backend/src/barangaydamagereporter/web/AppPaths.java"
click node_json "https://github.com/ezekiellazaro/tropadev-it/blob/main/backend/src/barangaydamagereporter/web/Json.java"
click node_login "https://github.com/ezekiellazaro/tropadev-it/blob/main/backend/src/barangaydamagereporter/service/LoginManager.java"
click node_user "https://github.com/ezekiellazaro/tropadev-it/blob/main/backend/src/barangaydamagereporter/model/User.java"
click node_actions "https://github.com/ezekiellazaro/tropadev-it/blob/main/backend/src/barangaydamagereporter/interfaces/ReportActions.java"
click node_reportdomain "https://github.com/ezekiellazaro/tropadev-it/tree/main/backend/src/barangaydamagereporter/service"
click node_sqlite "https://github.com/ezekiellazaro/tropadev-it/tree/main/backend/src/barangaydamagereporter/service"
click node_filestore "https://github.com/ezekiellazaro/tropadev-it/tree/main/backend/src/barangaydamagereporter/service"
click node_reportdata "https://github.com/ezekiellazaro/tropadev-it/tree/main/backend/src/barangaydamagereporter/service"
click node_photos "https://github.com/ezekiellazaro/tropadev-it/blob/main/backend/src/barangaydamagereporter/web/WebServer.java"

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_frontend,node_reportform,node_reportviews,node_browser toneBlue
class node_entry,node_server,node_paths,node_json toneAmber
class node_login,node_user toneMint
class node_actions,node_reportdomain toneRose
class node_sqlite,node_filestore,node_reportdata,node_photos,node_resident toneIndigo
```

## Components

### Resident and Official UI

- [Web Interface](https://github.com/ezekiellazaro/tropadev-it/blob/main/frontend/app.js): `frontend/app.js`
- [Report Submission](https://github.com/ezekiellazaro/tropadev-it/blob/main/frontend/app.js): `frontend/app.js`
- [Dashboards and Search](https://github.com/ezekiellazaro/tropadev-it/blob/main/frontend/app.js): `frontend/app.js`

### HTTP Application

- [Application Startup](https://github.com/ezekiellazaro/tropadev-it/blob/main/backend/src/barangaydamagereporter/web/Main.java): `backend/src/barangaydamagereporter/web/Main.java`
- [HTTP API and Static Server](https://github.com/ezekiellazaro/tropadev-it/blob/main/backend/src/barangaydamagereporter/web/WebServer.java): `backend/src/barangaydamagereporter/web/WebServer.java`
- [Project Paths](https://github.com/ezekiellazaro/tropadev-it/blob/main/backend/src/barangaydamagereporter/web/AppPaths.java): `backend/src/barangaydamagereporter/web/AppPaths.java`
- [JSON Encoding](https://github.com/ezekiellazaro/tropadev-it/blob/main/backend/src/barangaydamagereporter/web/Json.java): `backend/src/barangaydamagereporter/web/Json.java`

### Identity and Access

- [Authentication and Accounts](https://github.com/ezekiellazaro/tropadev-it/blob/main/backend/src/barangaydamagereporter/service/LoginManager.java): `backend/src/barangaydamagereporter/service/LoginManager.java`
- [User Roles](https://github.com/ezekiellazaro/tropadev-it/blob/main/backend/src/barangaydamagereporter/model/User.java): `backend/src/barangaydamagereporter/model/User.java`

### Report Domain

- [Report Operations Contract](https://github.com/ezekiellazaro/tropadev-it/blob/main/backend/src/barangaydamagereporter/interfaces/ReportActions.java): `backend/src/barangaydamagereporter/interfaces/ReportActions.java`
- [Report Handling](https://github.com/ezekiellazaro/tropadev-it/tree/main/backend/src/barangaydamagereporter/service): `backend/src/barangaydamagereporter/service`

### Report Storage

- [SQLite Report Store](https://github.com/ezekiellazaro/tropadev-it/tree/main/backend/src/barangaydamagereporter/service): `backend/src/barangaydamagereporter/service`
- [Text File Report Store](https://github.com/ezekiellazaro/tropadev-it/tree/main/backend/src/barangaydamagereporter/service): `backend/src/barangaydamagereporter/service`
- [Report Data](https://github.com/ezekiellazaro/tropadev-it/tree/main/backend/src/barangaydamagereporter/service): `backend/src/barangaydamagereporter/service`
- [Uploaded Photos](https://github.com/ezekiellazaro/tropadev-it/blob/main/backend/src/barangaydamagereporter/web/WebServer.java): `backend/src/barangaydamagereporter/web/WebServer.java`

### Other components

- **Resident**
- **Browser**

## Connections

- Resident → Browser: uses (evidence: `README.md`)
- Browser → Web Interface: loads (evidence: `README.md`)
- Web Interface → Report Submission: renders (evidence: `frontend/app.js`)
- Web Interface → Dashboards and Search: renders (evidence: `frontend/app.js`)
- Report Submission → HTTP API and Static Server: submits JSON (evidence: `frontend/app.js`)
- Dashboards and Search → HTTP API and Static Server: requests data (evidence: `frontend/app.js`)
- Application Startup → HTTP API and Static Server: starts (evidence: `backend/src/barangaydamagereporter/web/Main.java`)
- Application Startup → Authentication and Accounts: creates (evidence: `backend/src/barangaydamagereporter/web/Main.java`)
- Application Startup → Report Handling: configures (evidence: `backend/src/barangaydamagereporter/web/Main.java`)
- Application Startup → SQLite Report Store: selects if available (evidence: `backend/src/barangaydamagereporter/web/Main.java`)
- Application Startup → Text File Report Store: selects fallback (evidence: `backend/src/barangaydamagereporter/web/Main.java`)
- HTTP API and Static Server → Authentication and Accounts: authenticates (evidence: `backend/src/barangaydamagereporter/web/WebServer.java`)
- HTTP API and Static Server → Authentication and Accounts: lists and adds accounts (evidence: `backend/src/barangaydamagereporter/web/WebServer.java`)
- Authentication and Accounts → User Roles: checks credentials (evidence: `backend/src/barangaydamagereporter/service/LoginManager.java`)
- HTTP API and Static Server → Report Handling: handles report requests (evidence: `backend/src/barangaydamagereporter/web/WebServer.java`)
- HTTP API and Static Server → Report Handling: builds report data (evidence: `backend/src/barangaydamagereporter/web/WebServer.java`)
- HTTP API and Static Server → Uploaded Photos: saves uploads (evidence: `backend/src/barangaydamagereporter/web/WebServer.java`)
- HTTP API and Static Server → JSON Encoding: encodes responses (evidence: `backend/src/barangaydamagereporter/web/WebServer.java`)
- Application Startup → Project Paths: locates project files (evidence: `backend/src/barangaydamagereporter/web/Main.java`)
- Report Operations Contract → Report Handling: implemented by (evidence: `backend/src/barangaydamagereporter/interfaces/ReportActions.java`)
- Report Handling → Report Data: manages
- SQLite Report Store → Report Data: persists
- Text File Report Store → Report Data: persists
