# kal51411/metroverify architecture

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

- Interactive diagram: https://gitdiagram.com/kal51411/metroverify
- Repository: https://github.com/kal51411/metroverify

## Overview

MetroVerify is a legal-metrology verification API. Its visible workflow covers instrument records, application review and inspection scheduling, inspection results, certificate generation, and public certificate verification; certificate endpoints also provide QR codes and PDFs. The excerpts show a SQLAlchemy-backed SQLite store and seed-on-startup behavior. The README is empty, and the instrument excerpt is truncated; the graph therefore omits unshown application-submission behavior and limits links to relationships evidenced in the excerpts.

Main entry points: [`main.py`](https://github.com/kal51411/metroverify/blob/Main/main.py) (FastAPI App), [`database.py`](https://github.com/kal51411/metroverify/blob/Main/database.py) (DB Sessions), [`certificates.py`](https://github.com/kal51411/metroverify/blob/Main/certificates.py) (Certificate Management), [`schemas.py`](https://github.com/kal51411/metroverify/blob/Main/schemas.py) (API Schemas)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and Records"]
  node_api["FastAPI App<br/>[main.py]"]
  node_inst["Instrument Records<br/>[instruments.py]"]
end

subgraph group_workflow["Verification Workflow"]
  node_apps["Application Review<br/>[applications.py]"]
  node_inspect["Inspection Results<br/>[inspections.py]"]
end

subgraph group_certs["Certificates"]
  node_cert["Certificate Management<br/>[certificates.py]"]
  node_verify["Public Verification<br/>[verify.py]"]
  node_pdf["PDF Generation<br/>[pdf_services.py]"]
  node_qr["QR Generation<br/>[qr_services.py]"]
end

subgraph group_foundation["Data Foundation"]
  node_schemas["API Schemas<br/>[schemas.py]"]
  node_models["Domain Models<br/>[models.py]"]
  node_dbsession["DB Sessions<br/>[database.py]"]
  node_store[("SQLite Store<br/>[database.py]")]
  node_seed["Demo Data Seeding<br/>[seed.py]"]
end

node_user(("API Client"))

node_user -->|"sends requests"| node_api
node_api -->|"registers router"| node_inst
node_api -->|"registers router"| node_apps
node_api -->|"registers router"| node_inspect
node_api -->|"registers router"| node_cert
node_api -->|"registers router"| node_verify
node_api -->|"creates tables"| node_models
node_api -->|"runs seed"| node_seed
node_api -->|"opens session"| node_dbsession
node_inst -->|"queries records"| node_dbsession
node_apps -->|"queries and updates"| node_dbsession
node_inspect -->|"records results"| node_dbsession
node_cert -->|"reads and writes"| node_dbsession
node_verify -->|"looks up certificates"| node_dbsession
node_seed -->|"seeds records"| node_dbsession
node_models -->|"uses Base"| node_dbsession
node_dbsession -->|"connects"| node_store
node_apps -->|"uses request and response types"| node_schemas
node_inspect -->|"uses request and response types"| node_schemas
node_cert -->|"uses response type"| node_schemas
node_verify -->|"returns response type"| node_schemas
node_cert -->|"generates PDF"| node_pdf
node_cert -->|"generates QR code"| node_qr

click node_api "https://github.com/kal51411/metroverify/blob/Main/main.py"
click node_inst "https://github.com/kal51411/metroverify/blob/Main/instruments.py"
click node_apps "https://github.com/kal51411/metroverify/blob/Main/applications.py"
click node_inspect "https://github.com/kal51411/metroverify/blob/Main/inspections.py"
click node_cert "https://github.com/kal51411/metroverify/blob/Main/certificates.py"
click node_verify "https://github.com/kal51411/metroverify/blob/Main/verify.py"
click node_pdf "https://github.com/kal51411/metroverify/blob/Main/pdf_services.py"
click node_qr "https://github.com/kal51411/metroverify/blob/Main/qr_services.py"
click node_schemas "https://github.com/kal51411/metroverify/blob/Main/schemas.py"
click node_models "https://github.com/kal51411/metroverify/blob/Main/models.py"
click node_dbsession "https://github.com/kal51411/metroverify/blob/Main/database.py"
click node_store "https://github.com/kal51411/metroverify/blob/Main/database.py"
click node_seed "https://github.com/kal51411/metroverify/blob/Main/seed.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_api,node_inst,node_user toneBlue
class node_apps,node_inspect toneAmber
class node_cert,node_verify,node_pdf,node_qr toneMint
class node_schemas,node_models,node_dbsession,node_store,node_seed toneRose
```

## Components

### API and Records

- [FastAPI App](https://github.com/kal51411/metroverify/blob/Main/main.py): `main.py`
- [Instrument Records](https://github.com/kal51411/metroverify/blob/Main/instruments.py): `instruments.py`

### Verification Workflow

- [Application Review](https://github.com/kal51411/metroverify/blob/Main/applications.py): `applications.py`
- [Inspection Results](https://github.com/kal51411/metroverify/blob/Main/inspections.py): `inspections.py`

### Certificates

- [Certificate Management](https://github.com/kal51411/metroverify/blob/Main/certificates.py): `certificates.py`
- [Public Verification](https://github.com/kal51411/metroverify/blob/Main/verify.py): `verify.py`
- [PDF Generation](https://github.com/kal51411/metroverify/blob/Main/pdf_services.py): `pdf_services.py`
- [QR Generation](https://github.com/kal51411/metroverify/blob/Main/qr_services.py): `qr_services.py`

### Data Foundation

- [API Schemas](https://github.com/kal51411/metroverify/blob/Main/schemas.py): `schemas.py`
- [Domain Models](https://github.com/kal51411/metroverify/blob/Main/models.py): `models.py`
- [DB Sessions](https://github.com/kal51411/metroverify/blob/Main/database.py): `database.py`
- [SQLite Store](https://github.com/kal51411/metroverify/blob/Main/database.py): `database.py`
- [Demo Data Seeding](https://github.com/kal51411/metroverify/blob/Main/seed.py): `seed.py`

### Other components

- **API Client**

## Connections

- API Client → FastAPI App: sends requests
- FastAPI App → Instrument Records: registers router (evidence: `main.py`)
- FastAPI App → Application Review: registers router (evidence: `main.py`)
- FastAPI App → Inspection Results: registers router (evidence: `main.py`)
- FastAPI App → Certificate Management: registers router (evidence: `main.py`)
- FastAPI App → Public Verification: registers router (evidence: `main.py`)
- FastAPI App → Domain Models: creates tables (evidence: `main.py`)
- FastAPI App → Demo Data Seeding: runs seed (evidence: `main.py`)
- FastAPI App → DB Sessions: opens session (evidence: `main.py`)
- Instrument Records → DB Sessions: queries records (evidence: `instruments.py`)
- Application Review → DB Sessions: queries and updates (evidence: `applications.py`)
- Inspection Results → DB Sessions: records results (evidence: `inspections.py`)
- Certificate Management → DB Sessions: reads and writes (evidence: `certificates.py`)
- Public Verification → DB Sessions: looks up certificates (evidence: `verify.py`)
- Demo Data Seeding → DB Sessions: seeds records (evidence: `seed.py`)
- Domain Models → DB Sessions: uses Base (evidence: `models.py`)
- DB Sessions → SQLite Store: connects (evidence: `database.py`)
- Application Review → API Schemas: uses request and response types (evidence: `applications.py`)
- Inspection Results → API Schemas: uses request and response types (evidence: `inspections.py`)
- Certificate Management → API Schemas: uses response type (evidence: `certificates.py`)
- Public Verification → API Schemas: returns response type (evidence: `verify.py`)
- Certificate Management → PDF Generation: generates PDF (evidence: `certificates.py`)
- Certificate Management → QR Generation: generates QR code (evidence: `certificates.py`)
