# krishnabalajikothapalli5308/appliance-service-tracker architecture

> Architecture diagram of the GitHub repository krishnabalajikothapalli5308/appliance-service-tracker, 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/krishnabalajikothapalli5308/appliance-service-tracker
- Repository: https://github.com/krishnabalajikothapalli5308/appliance-service-tracker

## Overview

ServiceTrack manages appliance inventory and maintenance requests through an admin dashboard and a technician portal. Admins review dashboard statistics, manage appliances and technicians, create requests, and assign technicians; technicians view assigned work and save status and notes. Flask routes handle page and REST requests, SQLAlchemy models represent the domain, and the app configures a SQLite database. The README documents the major portal and API capabilities; template contents were not sampled, so their detailed behavior is not inferred.

Main entry points: [`static/js/main.js`](https://github.com/krishnabalajikothapalli5308/appliance-service-tracker/blob/main/static/js/main.js) (Admin interface), [`app.py`](https://github.com/krishnabalajikothapalli5308/appliance-service-tracker/blob/main/app.py) (SQLite database), [`database.py`](https://github.com/krishnabalajikothapalli5308/appliance-service-tracker/blob/main/database.py) (SQLAlchemy models), [`static/js/technician.js`](https://github.com/krishnabalajikothapalli5308/appliance-service-tracker/blob/main/static/js/technician.js) (Technician interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_admin["Admin dashboard"]
  node_admin_ui["Admin interface<br/>[main.js]"]
  node_admin_page["Admin dashboard page<br/>[index.html]"]
end

subgraph group_technician["Technician portal"]
  node_tech_ui["Technician interface<br/>[technician.js]"]
  node_tech_page["Technician page<br/>[technician.html]"]
end

subgraph group_backend["Flask API"]
  node_page_routes["Portal routes<br/>[app.py]"]
  node_appliance_api["Appliance API<br/>[app.py]"]
  node_request_api["Service request API<br/>[app.py]"]
  node_technician_api["Technician API<br/>[app.py]"]
  node_stats_api["Dashboard statistics<br/>[app.py]"]
end

subgraph group_data["Domain and storage"]
  node_orm["SQLAlchemy models<br/>[database.py]"]
  node_db_store[("SQLite database<br/>[app.py]")]
end

node_admin_user(("Admin"))
node_technician_user(("Technician"))

node_admin_user -->|"opens"| node_admin_page
node_admin_page -->|"loads"| node_admin_ui
node_admin_ui -->|"fetches stats"| node_stats_api
node_admin_ui -->|"manages inventory"| node_appliance_api
node_admin_ui -->|"manages requests"| node_request_api
node_admin_ui -->|"manages technicians"| node_technician_api
node_technician_user -->|"opens"| node_tech_page
node_tech_page -->|"loads"| node_tech_ui
node_tech_ui -->|"loads technicians"| node_technician_api
node_tech_ui -->|"loads and updates jobs"| node_request_api
node_page_routes -->|"renders"| node_admin_page
node_page_routes -->|"renders"| node_tech_page
node_appliance_api -->|"queries and updates"| node_orm
node_request_api -->|"queries and updates"| node_orm
node_technician_api -->|"queries and updates"| node_orm
node_stats_api -->|"counts records"| node_orm
node_page_routes -->|"initializes"| node_db_store
node_appliance_api -->|"persists changes"| node_db_store
node_request_api -->|"persists changes"| node_db_store
node_technician_api -->|"persists changes"| node_db_store
node_stats_api -->|"reads counts"| node_db_store

click node_admin_ui "https://github.com/krishnabalajikothapalli5308/appliance-service-tracker/blob/main/static/js/main.js"
click node_admin_page "https://github.com/krishnabalajikothapalli5308/appliance-service-tracker/blob/main/templates/index.html"
click node_tech_ui "https://github.com/krishnabalajikothapalli5308/appliance-service-tracker/blob/main/static/js/technician.js"
click node_tech_page "https://github.com/krishnabalajikothapalli5308/appliance-service-tracker/blob/main/templates/technician.html"
click node_page_routes "https://github.com/krishnabalajikothapalli5308/appliance-service-tracker/blob/main/app.py"
click node_appliance_api "https://github.com/krishnabalajikothapalli5308/appliance-service-tracker/blob/main/app.py"
click node_request_api "https://github.com/krishnabalajikothapalli5308/appliance-service-tracker/blob/main/app.py"
click node_technician_api "https://github.com/krishnabalajikothapalli5308/appliance-service-tracker/blob/main/app.py"
click node_stats_api "https://github.com/krishnabalajikothapalli5308/appliance-service-tracker/blob/main/app.py"
click node_orm "https://github.com/krishnabalajikothapalli5308/appliance-service-tracker/blob/main/database.py"
click node_db_store "https://github.com/krishnabalajikothapalli5308/appliance-service-tracker/blob/main/app.py"

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_admin_ui,node_admin_page toneBlue
class node_tech_ui,node_tech_page toneAmber
class node_page_routes,node_appliance_api,node_request_api,node_technician_api,node_stats_api toneMint
class node_orm,node_db_store toneRose
class node_admin_user,node_technician_user toneIndigo
```

## Components

### Admin dashboard

- [Admin interface](https://github.com/krishnabalajikothapalli5308/appliance-service-tracker/blob/main/static/js/main.js): `static/js/main.js`
- [Admin dashboard page](https://github.com/krishnabalajikothapalli5308/appliance-service-tracker/blob/main/templates/index.html): `templates/index.html`

### Technician portal

- [Technician interface](https://github.com/krishnabalajikothapalli5308/appliance-service-tracker/blob/main/static/js/technician.js): `static/js/technician.js`
- [Technician page](https://github.com/krishnabalajikothapalli5308/appliance-service-tracker/blob/main/templates/technician.html): `templates/technician.html`

### Flask API

- [Portal routes](https://github.com/krishnabalajikothapalli5308/appliance-service-tracker/blob/main/app.py): `app.py`
- [Appliance API](https://github.com/krishnabalajikothapalli5308/appliance-service-tracker/blob/main/app.py): `app.py`
- [Service request API](https://github.com/krishnabalajikothapalli5308/appliance-service-tracker/blob/main/app.py): `app.py`
- [Technician API](https://github.com/krishnabalajikothapalli5308/appliance-service-tracker/blob/main/app.py): `app.py`
- [Dashboard statistics](https://github.com/krishnabalajikothapalli5308/appliance-service-tracker/blob/main/app.py): `app.py`

### Domain and storage

- [SQLAlchemy models](https://github.com/krishnabalajikothapalli5308/appliance-service-tracker/blob/main/database.py): `database.py`
- [SQLite database](https://github.com/krishnabalajikothapalli5308/appliance-service-tracker/blob/main/app.py): `app.py`

### Other components

- **Admin**
- **Technician**

## Connections

- Admin → Admin dashboard page: opens (evidence: `README.md`)
- Admin dashboard page → Admin interface: loads (evidence: `README.md`)
- Admin interface → Dashboard statistics: fetches stats (evidence: `static/js/main.js`)
- Admin interface → Appliance API: manages inventory (evidence: `static/js/main.js`)
- Admin interface → Service request API: manages requests (evidence: `static/js/main.js`)
- Admin interface → Technician API: manages technicians (evidence: `static/js/main.js`)
- Technician → Technician page: opens (evidence: `README.md`)
- Technician page → Technician interface: loads (evidence: `README.md`)
- Technician interface → Technician API: loads technicians (evidence: `static/js/technician.js`)
- Technician interface → Service request API: loads and updates jobs (evidence: `static/js/technician.js`)
- Portal routes → Admin dashboard page: renders (evidence: `app.py`)
- Portal routes → Technician page: renders (evidence: `app.py`)
- Appliance API → SQLAlchemy models: queries and updates (evidence: `app.py`)
- Service request API → SQLAlchemy models: queries and updates (evidence: `app.py`)
- Technician API → SQLAlchemy models: queries and updates (evidence: `app.py`)
- Dashboard statistics → SQLAlchemy models: counts records (evidence: `app.py`)
- Portal routes → SQLite database: initializes (evidence: `app.py`)
- Appliance API → SQLite database: persists changes (evidence: `app.py`)
- Service request API → SQLite database: persists changes (evidence: `app.py`)
- Technician API → SQLite database: persists changes (evidence: `app.py`)
- Dashboard statistics → SQLite database: reads counts (evidence: `app.py`)
