# rxguno/caintaroadclearingrequestsystem architecture

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

- Interactive diagram: https://gitdiagram.com/rxguno/caintaroadclearingrequestsystem
- Repository: https://github.com/rxguno/caintaroadclearingrequestsystem

## Overview

This Flask application appears to support public service-request submission and tracking alongside front-desk and administrator workflows. The sampled code shows request lookup, staff authentication, admin account management, and profile access, while the file tree indicates dashboard and user-facing pages. The model layer stores admins, guest requests, and notifications. Some routes and template wiring were not sampled, so the graph limits connections to relationships visible in the excerpts; the two substantial JavaScript assets are included without inferred links.

Main entry points: [`models.py`](https://github.com/rxguno/caintaroadclearingrequestsystem/blob/main/models.py) (Request and account models), [`app.py`](https://github.com/rxguno/caintaroadclearingrequestsystem/blob/main/app.py) (Request tracking)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Request workflows"]
  node_submission["Request intake<br/>[app.py]"]
  node_tracking["Request tracking<br/>[app.py]"]
  node_qrscan["QR scan upload<br/>[app.py]"]
end

subgraph group_staff["Staff administration"]
  node_frontlogin["Front-desk login<br/>[app.py]"]
  node_adminlogin["Admin login<br/>[app.py]"]
  node_dashboard["Admin dashboard<br/>[app.py]"]
  node_accounts["Admin accounts<br/>[app.py]"]
  node_profile["Admin profile<br/>[app.py]"]
end

subgraph group_data["Data and interface"]
  node_models["Request and account models<br/>[models.py]"]
  node_database[("SQL database")]
  node_donut["Status chart<br/>[donut.js]"]
  node_mobilenet["MobileNet client<br/>[mobilenet.js]"]
end

node_reporter(("Reporter"))
node_frontdesk(("Front-desk staff"))
node_administrator(("Administrator"))

node_reporter -->|"submits request"| node_submission
node_reporter -->|"checks status"| node_tracking
node_reporter -->|"uploads scan"| node_qrscan
node_frontdesk -->|"signs in"| node_frontlogin
node_administrator -->|"signs in"| node_adminlogin
node_administrator -.->|"views metrics"| node_dashboard
node_administrator -->|"manages accounts"| node_accounts
node_administrator -->|"edits profile"| node_profile
node_tracking -->|"looks up request"| node_models
node_frontlogin -->|"checks account"| node_models
node_dashboard -->|"loads admin"| node_models
node_accounts -->|"loads accounts"| node_models
node_profile -->|"loads profile"| node_models
node_models -.->|"persists records"| node_database

click node_submission "https://github.com/rxguno/caintaroadclearingrequestsystem/blob/main/app.py"
click node_tracking "https://github.com/rxguno/caintaroadclearingrequestsystem/blob/main/app.py"
click node_qrscan "https://github.com/rxguno/caintaroadclearingrequestsystem/blob/main/app.py"
click node_frontlogin "https://github.com/rxguno/caintaroadclearingrequestsystem/blob/main/app.py"
click node_adminlogin "https://github.com/rxguno/caintaroadclearingrequestsystem/blob/main/app.py"
click node_dashboard "https://github.com/rxguno/caintaroadclearingrequestsystem/blob/main/app.py"
click node_accounts "https://github.com/rxguno/caintaroadclearingrequestsystem/blob/main/app.py"
click node_profile "https://github.com/rxguno/caintaroadclearingrequestsystem/blob/main/app.py"
click node_models "https://github.com/rxguno/caintaroadclearingrequestsystem/blob/main/models.py"
click node_donut "https://github.com/rxguno/caintaroadclearingrequestsystem/blob/main/static/donut.js"
click node_mobilenet "https://github.com/rxguno/caintaroadclearingrequestsystem/blob/main/static/js/mobilenet.js"

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_submission,node_tracking,node_qrscan toneBlue
class node_frontlogin,node_adminlogin,node_dashboard,node_accounts,node_profile toneAmber
class node_models,node_database,node_donut,node_mobilenet toneMint
class node_reporter,node_frontdesk,node_administrator toneIndigo
```

## Components

### Request workflows

- [Request intake](https://github.com/rxguno/caintaroadclearingrequestsystem/blob/main/app.py): `app.py`
- [Request tracking](https://github.com/rxguno/caintaroadclearingrequestsystem/blob/main/app.py): `app.py`
- [QR scan upload](https://github.com/rxguno/caintaroadclearingrequestsystem/blob/main/app.py): `app.py`

### Staff administration

- [Front-desk login](https://github.com/rxguno/caintaroadclearingrequestsystem/blob/main/app.py): `app.py`
- [Admin login](https://github.com/rxguno/caintaroadclearingrequestsystem/blob/main/app.py): `app.py`
- [Admin dashboard](https://github.com/rxguno/caintaroadclearingrequestsystem/blob/main/app.py): `app.py`
- [Admin accounts](https://github.com/rxguno/caintaroadclearingrequestsystem/blob/main/app.py): `app.py`
- [Admin profile](https://github.com/rxguno/caintaroadclearingrequestsystem/blob/main/app.py): `app.py`

### Data and interface

- [Request and account models](https://github.com/rxguno/caintaroadclearingrequestsystem/blob/main/models.py): `models.py`
- **SQL database**
- [Status chart](https://github.com/rxguno/caintaroadclearingrequestsystem/blob/main/static/donut.js): `static/donut.js`
- [MobileNet client](https://github.com/rxguno/caintaroadclearingrequestsystem/blob/main/static/js/mobilenet.js): `static/js/mobilenet.js`

### Other components

- **Reporter**
- **Front-desk staff**
- **Administrator**

## Connections

- Reporter → Request intake: submits request (evidence: `app.py`)
- Reporter → Request tracking: checks status (evidence: `app.py`)
- Reporter → QR scan upload: uploads scan (evidence: `app.py`)
- Front-desk staff → Front-desk login: signs in (evidence: `app.py`)
- Administrator → Admin login: signs in (evidence: `app.py`)
- Administrator → Admin dashboard: views metrics
- Administrator → Admin accounts: manages accounts (evidence: `app.py`)
- Administrator → Admin profile: edits profile (evidence: `app.py`)
- Request tracking → Request and account models: looks up request (evidence: `app.py`)
- Front-desk login → Request and account models: checks account (evidence: `app.py`)
- Admin dashboard → Request and account models: loads admin (evidence: `app.py`)
- Admin accounts → Request and account models: loads accounts (evidence: `app.py`)
- Admin profile → Request and account models: loads profile (evidence: `app.py`)
- Request and account models → SQL database: persists records
