# satwikchitrans/vesper architecture

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

- Interactive diagram: https://gitdiagram.com/satwikchitrans/vesper
- Repository: https://github.com/satwikchitrans/vesper

## Overview

VESPER is a browser-based command-center prototype for multi-camera ANPR surveillance, vehicle trajectory reconstruction, tactical response, and municipal traffic analytics. An operator opens the command center, follows vehicle sightings across fixed and mobile feeds, inspects the route on a tactical map, and can request an evidentiary dossier or operational response. The README also describes environmental and road-condition sensing, dashboard analytics, and visual editing. The excerpts confirm the main app engine and server endpoints; several internal feature boundaries and their wiring are documented but not fully sampled.

Main entry points: [`app.js`](https://github.com/satwikchitrans/vesper/blob/main/app.js) (Simulation Engine), [`server.js`](https://github.com/satwikchitrans/vesper/blob/main/server.js) (Layout Persistence), [`index.html`](https://github.com/satwikchitrans/vesper/blob/main/index.html) (Command Center UI), [`admin.js`](https://github.com/satwikchitrans/vesper/blob/main/admin.js) (Admin Editor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_command["Command Interface"]
  node_web["Command Center UI<br/>[index.html]"]
  node_layout[("Layout Persistence<br/>[server.js]")]
  node_staticserver["HTTP Static Server<br/>[server.js]"]
end

subgraph group_tracking["Surveillance And Tracking"]
  node_engine["Simulation Engine<br/>[app.js]"]
  node_feeds["Dual Surveillance Feeds<br/>[app.js]"]
  node_trajectory["Trajectory Reconstruction<br/>[app.js]"]
  node_tacticalmap["Tactical GIS<br/>[app.js]"]
  node_roadgeometry["Road Geometry<br/>[real_roads.js]"]
  node_intercept["Interception Dispatch<br/>[app.js]"]
end

subgraph group_evidence["Evidence And Services"]
  node_dossier["Sightings Dossier<br/>[app.js]"]
  node_forensic["Forensic Verification API<br/>[server.js]"]
  node_lookup["Vehicle And Toll APIs<br/>[server.js]"]
end

subgraph group_municipal["Municipal Analytics"]
  node_traffic["Traffic Analytics<br/>[app.js]"]
  node_sensing["Mobile Road And Air Sensing<br/>[app.js]"]
end

subgraph group_editing["Visual Editing"]
  node_admin["Admin Editor<br/>[admin.js]"]
  node_studio["Visual Studio<br/>[editor.js]"]
  node_liveedit["Direct Live Editing<br/>[live-edit.js]"]
end

node_operator(("Operator"))

node_operator -->|"opens"| node_web
node_web -.->|"runs"| node_engine
node_engine -->|"drives"| node_feeds
node_engine -->|"reconstructs"| node_trajectory
node_engine -->|"updates"| node_tacticalmap
node_tacticalmap -.->|"uses routes"| node_roadgeometry
node_engine -->|"dispatches"| node_intercept
node_operator -->|"searches plate"| node_trajectory
node_trajectory -->|"documents sightings"| node_dossier
node_operator -->|"requests verification"| node_forensic
node_operator -->|"requests records"| node_lookup
node_operator -->|"views analytics"| node_traffic
node_operator -->|"monitors sensing"| node_sensing
node_web -->|"served by"| node_staticserver
node_admin -->|"saves layout"| node_layout
node_studio -->|"saves HTML"| node_layout
node_liveedit -.->|"persists edits"| node_layout
node_staticserver -->|"stores layout"| node_layout

click node_web "https://github.com/satwikchitrans/vesper/blob/main/index.html"
click node_engine "https://github.com/satwikchitrans/vesper/blob/main/app.js"
click node_feeds "https://github.com/satwikchitrans/vesper/blob/main/app.js"
click node_trajectory "https://github.com/satwikchitrans/vesper/blob/main/app.js"
click node_tacticalmap "https://github.com/satwikchitrans/vesper/blob/main/app.js"
click node_roadgeometry "https://github.com/satwikchitrans/vesper/blob/main/real_roads.js"
click node_intercept "https://github.com/satwikchitrans/vesper/blob/main/app.js"
click node_dossier "https://github.com/satwikchitrans/vesper/blob/main/app.js"
click node_forensic "https://github.com/satwikchitrans/vesper/blob/main/server.js"
click node_lookup "https://github.com/satwikchitrans/vesper/blob/main/server.js"
click node_layout "https://github.com/satwikchitrans/vesper/blob/main/server.js"
click node_traffic "https://github.com/satwikchitrans/vesper/blob/main/app.js"
click node_sensing "https://github.com/satwikchitrans/vesper/blob/main/app.js"
click node_admin "https://github.com/satwikchitrans/vesper/blob/main/admin.js"
click node_studio "https://github.com/satwikchitrans/vesper/blob/main/editor.js"
click node_liveedit "https://github.com/satwikchitrans/vesper/blob/main/live-edit.js"
click node_staticserver "https://github.com/satwikchitrans/vesper/blob/main/server.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_web,node_layout,node_staticserver toneBlue
class node_engine,node_feeds,node_trajectory,node_tacticalmap,node_roadgeometry,node_intercept toneAmber
class node_dossier,node_forensic,node_lookup toneMint
class node_traffic,node_sensing toneRose
class node_admin,node_studio,node_liveedit,node_operator toneIndigo
```

## Components

### Command Interface

- [Command Center UI](https://github.com/satwikchitrans/vesper/blob/main/index.html): `index.html`
- [Layout Persistence](https://github.com/satwikchitrans/vesper/blob/main/server.js): `server.js`
- [HTTP Static Server](https://github.com/satwikchitrans/vesper/blob/main/server.js): `server.js`

### Surveillance And Tracking

- [Simulation Engine](https://github.com/satwikchitrans/vesper/blob/main/app.js): `app.js`
- [Dual Surveillance Feeds](https://github.com/satwikchitrans/vesper/blob/main/app.js): `app.js`
- [Trajectory Reconstruction](https://github.com/satwikchitrans/vesper/blob/main/app.js): `app.js`
- [Tactical GIS](https://github.com/satwikchitrans/vesper/blob/main/app.js): `app.js`
- [Road Geometry](https://github.com/satwikchitrans/vesper/blob/main/real_roads.js): `real_roads.js`
- [Interception Dispatch](https://github.com/satwikchitrans/vesper/blob/main/app.js): `app.js`

### Evidence And Services

- [Sightings Dossier](https://github.com/satwikchitrans/vesper/blob/main/app.js): `app.js`
- [Forensic Verification API](https://github.com/satwikchitrans/vesper/blob/main/server.js): `server.js`
- [Vehicle And Toll APIs](https://github.com/satwikchitrans/vesper/blob/main/server.js): `server.js`

### Municipal Analytics

- [Traffic Analytics](https://github.com/satwikchitrans/vesper/blob/main/app.js): `app.js`
- [Mobile Road And Air Sensing](https://github.com/satwikchitrans/vesper/blob/main/app.js): `app.js`

### Visual Editing

- [Admin Editor](https://github.com/satwikchitrans/vesper/blob/main/admin.js): `admin.js`
- [Visual Studio](https://github.com/satwikchitrans/vesper/blob/main/editor.js): `editor.js`
- [Direct Live Editing](https://github.com/satwikchitrans/vesper/blob/main/live-edit.js): `live-edit.js`

### Other components

- **Operator**

## Connections

- Operator → Command Center UI: opens (evidence: `README.md`)
- Command Center UI → Simulation Engine: runs
- Simulation Engine → Dual Surveillance Feeds: drives (evidence: `README.md`)
- Simulation Engine → Trajectory Reconstruction: reconstructs (evidence: `README.md`)
- Simulation Engine → Tactical GIS: updates (evidence: `app.js`)
- Tactical GIS → Road Geometry: uses routes
- Simulation Engine → Interception Dispatch: dispatches (evidence: `app.js`)
- Operator → Trajectory Reconstruction: searches plate (evidence: `app.js`)
- Trajectory Reconstruction → Sightings Dossier: documents sightings (evidence: `README.md`)
- Operator → Forensic Verification API: requests verification (evidence: `server.js`)
- Operator → Vehicle And Toll APIs: requests records (evidence: `server.js`)
- Operator → Traffic Analytics: views analytics (evidence: `README.md`)
- Operator → Mobile Road And Air Sensing: monitors sensing (evidence: `README.md`)
- Command Center UI → HTTP Static Server: served by (evidence: `README.md`)
- Admin Editor → Layout Persistence: saves layout (evidence: `admin.js`)
- Visual Studio → Layout Persistence: saves HTML (evidence: `editor.js`)
- Direct Live Editing → Layout Persistence: persists edits
- HTTP Static Server → Layout Persistence: stores layout (evidence: `server.js`)
