# bansitanna88/veil-mesh- architecture

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

- Interactive diagram: https://gitdiagram.com/bansitanna88/veil-mesh-
- Repository: https://github.com/bansitanna88/veil-mesh-

## Overview

VEIL-MESH is a prototype secure sensor-alert mesh with a central operator console. Sensors detect visual or telemetry anomalies; sensor-role nodes wrap, sign, encrypt, and broadcast alerts; mesh nodes verify, deduplicate, and relay them; the bridge validates incoming traffic and exposes alert, messaging, and action interfaces to the console. The UI also presents command, topology, reports, and operational sections. Relationships for sampled runtime code are cited; broader product links and unsampled capabilities rely on the README, so the graph avoids assuming details beyond those statements.

Main entry points: [`veil-mesh-frontend/src/App.jsx`](https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh-frontend/src/App.jsx) (Console application), [`veil-mesh/bridge/app.py`](https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh/bridge/app.py) (Bridge API and relay), [`veil-mesh/core/node.py`](https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh/core/node.py) (Mesh node), [`veil-mesh/core/crypto.py`](https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh/core/crypto.py) (Encryption and signing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_sensing["Sensor detection"]
  node_vision["Vision detection<br/>[vision.py]"]
  node_telemetry["Telemetry anomaly<br/>[telemetry.py]"]
end

subgraph group_mesh["Secure mesh"]
  node_meshnode["Mesh node<br/>[node.py]"]
  node_protocol["Envelope and dedup<br/>[protocol.py]"]
  node_crypto["Encryption and signing<br/>[crypto.py]"]
end

subgraph group_bridge["Bridge services"]
  node_bridge["Bridge API and relay<br/>[app.py]"]
  node_alertstate[("Alert store<br/>[app.py]")]
  node_teamstate[("Messages and actions<br/>[app.py]")]
end

subgraph group_console["Operator console"]
  node_app["Console application<br/>[App.jsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_sections["Operational sections<br/>[SectionPages.jsx]"]
  node_reports["Reports<br/>[Reports.jsx]"]
  node_tasks["Tasks and actions<br/>[Tasks.jsx]"]
  node_topology["Mesh topology<br/>[Topology.jsx]"]
  node_login["Sign-in screen<br/>[Login.jsx]"]
  node_sidebar["Navigation<br/>[Sidebar.jsx]"]
  node_topnav["Status and search<br/>[TopNav.jsx]"]
end

node_operator(("Operator"))
node_udp(("UDP mesh"))

node_vision -->|"detects for"| node_meshnode
node_telemetry -->|"detects for"| node_meshnode
node_meshnode -->|"creates envelopes"| node_protocol
node_meshnode -->|"signs and encrypts"| node_crypto
node_meshnode -->|"decrypts and verifies"| node_crypto
node_meshnode -->|"sends and receives"| node_udp
node_udp -->|"delivers datagrams"| node_bridge
node_bridge -->|"decrypts and verifies"| node_crypto
node_bridge -->|"deduplicates alerts"| node_protocol
node_bridge -->|"stores alerts"| node_alertstate
node_bridge -->|"updates records"| node_teamstate
node_app -->|"fetches and posts"| node_bridge
node_bridge -->|"streams chat"| node_app
node_bridge -->|"streams alerts"| node_app
node_app -->|"renders"| node_dashboard
node_app -->|"renders"| node_sections
node_app -->|"renders"| node_sidebar
node_app -->|"renders"| node_topnav
node_app -->|"renders"| node_reports
node_app -.->|"renders"| node_tasks
node_app -.->|"renders"| node_topology
node_app -.->|"renders"| node_login
node_operator -->|"uses console"| node_app
node_operator -->|"issues commands"| node_teamstate

click node_vision "https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh/sensors/vision.py"
click node_telemetry "https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh/sensors/telemetry.py"
click node_meshnode "https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh/core/node.py"
click node_protocol "https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh/core/protocol.py"
click node_crypto "https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh/core/crypto.py"
click node_bridge "https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh/bridge/app.py"
click node_alertstate "https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh/bridge/app.py"
click node_teamstate "https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh/bridge/app.py"
click node_app "https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh-frontend/src/App.jsx"
click node_dashboard "https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh-frontend/src/pages/Dashboard.jsx"
click node_sections "https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh-frontend/src/pages/SectionPages.jsx"
click node_reports "https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh-frontend/src/pages/Reports.jsx"
click node_tasks "https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh-frontend/src/pages/Tasks.jsx"
click node_topology "https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh-frontend/src/pages/Topology.jsx"
click node_login "https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh-frontend/src/pages/auth/Login.jsx"
click node_sidebar "https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh-frontend/src/components/layout/Sidebar.jsx"
click node_topnav "https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh-frontend/src/components/layout/TopNav.jsx"

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_vision,node_telemetry toneBlue
class node_meshnode,node_protocol,node_crypto toneAmber
class node_bridge,node_alertstate,node_teamstate toneMint
class node_app,node_dashboard,node_sections,node_reports,node_tasks,node_topology,node_login,node_sidebar,node_topnav toneRose
class node_operator,node_udp toneIndigo
```

## Components

### Sensor detection

- [Vision detection](https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh/sensors/vision.py): `veil-mesh/sensors/vision.py`
- [Telemetry anomaly](https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh/sensors/telemetry.py): `veil-mesh/sensors/telemetry.py`

### Secure mesh

- [Mesh node](https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh/core/node.py): `veil-mesh/core/node.py`
- [Envelope and dedup](https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh/core/protocol.py): `veil-mesh/core/protocol.py`
- [Encryption and signing](https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh/core/crypto.py): `veil-mesh/core/crypto.py`

### Bridge services

- [Bridge API and relay](https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh/bridge/app.py): `veil-mesh/bridge/app.py`
- [Alert store](https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh/bridge/app.py): `veil-mesh/bridge/app.py`
- [Messages and actions](https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh/bridge/app.py): `veil-mesh/bridge/app.py`

### Operator console

- [Console application](https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh-frontend/src/App.jsx): `veil-mesh-frontend/src/App.jsx`
- [Dashboard](https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh-frontend/src/pages/Dashboard.jsx): `veil-mesh-frontend/src/pages/Dashboard.jsx`
- [Operational sections](https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh-frontend/src/pages/SectionPages.jsx): `veil-mesh-frontend/src/pages/SectionPages.jsx`
- [Reports](https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh-frontend/src/pages/Reports.jsx): `veil-mesh-frontend/src/pages/Reports.jsx`
- [Tasks and actions](https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh-frontend/src/pages/Tasks.jsx): `veil-mesh-frontend/src/pages/Tasks.jsx`
- [Mesh topology](https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh-frontend/src/pages/Topology.jsx): `veil-mesh-frontend/src/pages/Topology.jsx`
- [Sign-in screen](https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh-frontend/src/pages/auth/Login.jsx): `veil-mesh-frontend/src/pages/auth/Login.jsx`
- [Navigation](https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh-frontend/src/components/layout/Sidebar.jsx): `veil-mesh-frontend/src/components/layout/Sidebar.jsx`
- [Status and search](https://github.com/bansitanna88/veil-mesh-/blob/main/veil-mesh-frontend/src/components/layout/TopNav.jsx): `veil-mesh-frontend/src/components/layout/TopNav.jsx`

### Other components

- **Operator**
- **UDP mesh**

## Connections

- Vision detection → Mesh node: detects for (evidence: `veil-mesh/core/node.py`)
- Telemetry anomaly → Mesh node: detects for (evidence: `veil-mesh/core/node.py`)
- Mesh node → Envelope and dedup: creates envelopes (evidence: `veil-mesh/core/node.py`)
- Mesh node → Encryption and signing: signs and encrypts (evidence: `veil-mesh/core/node.py`)
- Mesh node → Encryption and signing: decrypts and verifies (evidence: `veil-mesh/core/node.py`)
- Mesh node → UDP mesh: sends and receives (evidence: `veil-mesh/core/node.py`)
- UDP mesh → Bridge API and relay: delivers datagrams (evidence: `veil-mesh/bridge/app.py`)
- Bridge API and relay → Encryption and signing: decrypts and verifies (evidence: `veil-mesh/bridge/app.py`)
- Bridge API and relay → Envelope and dedup: deduplicates alerts (evidence: `veil-mesh/bridge/app.py`)
- Bridge API and relay → Alert store: stores alerts (evidence: `veil-mesh/bridge/app.py`)
- Bridge API and relay → Messages and actions: updates records (evidence: `veil-mesh/bridge/app.py`)
- Console application → Bridge API and relay: fetches and posts (evidence: `veil-mesh-frontend/src/App.jsx`)
- Bridge API and relay → Console application: streams chat (evidence: `veil-mesh-frontend/src/App.jsx`)
- Bridge API and relay → Console application: streams alerts (evidence: `README.md`)
- Console application → Dashboard: renders (evidence: `veil-mesh-frontend/src/App.jsx`)
- Console application → Operational sections: renders (evidence: `veil-mesh-frontend/src/App.jsx`)
- Console application → Navigation: renders (evidence: `veil-mesh-frontend/src/App.jsx`)
- Console application → Status and search: renders (evidence: `veil-mesh-frontend/src/App.jsx`)
- Console application → Reports: renders (evidence: `veil-mesh-frontend/src/App.jsx`)
- Console application → Tasks and actions: renders
- Console application → Mesh topology: renders
- Console application → Sign-in screen: renders
- Operator → Console application: uses console (evidence: `README.md`)
- Operator → Messages and actions: issues commands (evidence: `README.md`)
