# alouakhalid/trustline architecture

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

- Interactive diagram: https://gitdiagram.com/alouakhalid/trustline
- Repository: https://github.com/alouakhalid/trustline

## Overview

TRUSTLINE is an offline-resilient space-health decision-support system and astronaut digital-twin platform. Its principal workflow runs from simulated or wearable telemetry through sensor-quality screening and specialized health/risk assessment, then presents assessments and telemetry to crew or medical users; mission data can sync when connectivity allows. The graph also includes document ingestion, hybrid model routing, the frontend, and persistence. Relationships for unsampled subsystems are included only where the README or source index supports them; several internal agent and UI details are not shown in the excerpts.

Main entry points: [`ai-engine/agents/personal_health/agent/agent.py`](https://github.com/alouakhalid/trustline/blob/main/ai-engine/agents/personal_health/agent/agent.py) (Personal Health), [`backend/sync/worker.py`](https://github.com/alouakhalid/trustline/blob/main/backend/sync/worker.py) (Sync Worker), [`ai-engine/agents/supervisor/workflow`](https://github.com/alouakhalid/trustline/tree/main/ai-engine/agents/supervisor/workflow) (Supervisor Workflow), [`backend/api/app.py`](https://github.com/alouakhalid/trustline/blob/main/backend/api/app.py) (Backend API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Telemetry and Documents"]
  node_sim["Telemetry Simulator<br/>[engine.py]"]
  node_bridge["Telemetry Bridge"]
  node_documents["Document Ingestion"]
  node_ocr["Medical OCR<br/>[extractor.py]"]
end

subgraph group_clinical["Medical Intelligence"]
  node_quality["Signal Quality<br/>[quality_engine.py]"]
  node_quality_validation["Quality Validation"]
  node_quality_schemas["Signal Schemas<br/>[signal_schema.py]"]
  node_supervisor["Supervisor Workflow"]
  node_health["Personal Health<br/>[agent.py]"]
  node_baseline["Health Baselines"]
  node_risk["Risk Assessment<br/>[risk_engine.py]"]
  node_risk_schemas["Risk Evidence and Rules<br/>[evidence.py]"]
  node_rag["Medical RAG<br/>[service.py]"]
end

subgraph group_ai["Hybrid AI"]
  node_hybrid["AI Router<br/>[router.py]"]
end

subgraph group_app["Application and Storage"]
  node_sim_api["Simulator API"]
  node_backend_api["Backend API<br/>[app.py]"]
  node_store[("Local Application Store<br/>[store.py]")]
  node_telemetry_service["Telemetry Service<br/>[telemetry.py]"]
  node_sync_worker["Sync Worker<br/>[worker.py]"]
  node_sync_queue["Sync Queue<br/>[queue.py]"]
  node_sync_transport["Sync Transport<br/>[transport.py]"]
end

subgraph group_interfaces["Crew and Mission Interfaces"]
  node_frontend["Crew and Medical UI"]
  node_digital_twin["3D Digital Twin<br/>[DigitalTwin.tsx]"]
end

node_crew(("Crew / Sensors"))
node_mission_control(("Mission Control"))
node_supabase[("Supabase")]

node_crew -.->|"generates telemetry"| node_sim
node_sim -->|"serves simulator data"| node_sim_api
node_sim -.->|"feeds packets"| node_bridge
node_bridge -->|"runs assessment"| node_quality_validation
node_quality -->|"inspects streams"| node_quality_schemas
node_supervisor -->|"dispatches to"| node_quality
node_supervisor -->|"dispatches to"| node_health
node_supervisor -->|"dispatches to"| node_risk
node_health -.->|"tracks against"| node_baseline
node_risk -->|"evaluates evidence"| node_risk_schemas
node_documents -->|"extracts with"| node_ocr
node_documents -.->|"feeds knowledge store"| node_rag
node_health -.->|"retrieves evidence"| node_rag
node_health -.->|"requests model routing"| node_hybrid
node_risk -.->|"requests model routing"| node_hybrid
node_backend_api -->|"reads and writes"| node_store
node_backend_api -->|"routes telemetry"| node_telemetry_service
node_sim_api -->|"ingests packets"| node_telemetry_service
node_telemetry_service -->|"persists telemetry"| node_store
node_backend_api -.->|"requests assessment"| node_supervisor
node_frontend -.->|"uses API"| node_backend_api
node_frontend -.->|"renders twin"| node_digital_twin
node_mission_control -.->|"exchanges mission data"| node_sync_worker
node_sync_worker -->|"claims and updates"| node_sync_queue
node_sync_worker -->|"delivers events"| node_sync_transport
node_sync_worker -->|"records checkpoints"| node_store
node_store -.->|"optional cloud persistence"| node_supabase

click node_sim "https://github.com/alouakhalid/trustline/blob/main/data-engineering/simulator/scenarios/engine.py"
click node_sim_api "https://github.com/alouakhalid/trustline/blob/main/backend/api/simulator_router.py"
click node_bridge "https://github.com/alouakhalid/trustline/blob/main/data-engineering/simulator/ingestion_bridge.py"
click node_quality "https://github.com/alouakhalid/trustline/blob/main/ai-engine/agents/sensor_quality/core/quality_engine.py"
click node_quality_validation "https://github.com/alouakhalid/trustline/blob/main/ai-engine/agents/sensor_quality/validation/validator_engine.py"
click node_quality_schemas "https://github.com/alouakhalid/trustline/blob/main/ai-engine/agents/sensor_quality/schemas/signal_schema.py"
click node_supervisor "https://github.com/alouakhalid/trustline/tree/main/ai-engine/agents/supervisor/workflow"
click node_health "https://github.com/alouakhalid/trustline/blob/main/ai-engine/agents/personal_health/agent/agent.py"
click node_baseline "https://github.com/alouakhalid/trustline/tree/main/ai-engine/agents/personal_health/baseline"
click node_risk "https://github.com/alouakhalid/trustline/blob/main/ai-engine/agents/risk_assessment/services/risk_engine.py"
click node_risk_schemas "https://github.com/alouakhalid/trustline/blob/main/ai-engine/agents/risk_assessment/schemas/evidence.py"
click node_documents "https://github.com/alouakhalid/trustline/blob/main/ai-engine/agents/personal_health/services/document_ingestion_service.py"
click node_ocr "https://github.com/alouakhalid/trustline/blob/main/ai-engine/ocr/extractor.py"
click node_rag "https://github.com/alouakhalid/trustline/blob/main/ai-engine/agents/personal_health/rag/service.py"
click node_hybrid "https://github.com/alouakhalid/trustline/blob/main/ai-engine/hybrid_ai/router.py"
click node_backend_api "https://github.com/alouakhalid/trustline/blob/main/backend/api/app.py"
click node_store "https://github.com/alouakhalid/trustline/blob/main/backend/database/store.py"
click node_telemetry_service "https://github.com/alouakhalid/trustline/blob/main/backend/services/telemetry.py"
click node_sync_worker "https://github.com/alouakhalid/trustline/blob/main/backend/sync/worker.py"
click node_sync_queue "https://github.com/alouakhalid/trustline/blob/main/backend/sync/queue.py"
click node_sync_transport "https://github.com/alouakhalid/trustline/blob/main/backend/sync/transport.py"
click node_frontend "https://github.com/alouakhalid/trustline/tree/main/frontend/trustline-ui/src/app/routes"
click node_digital_twin "https://github.com/alouakhalid/trustline/blob/main/frontend/trustline-ui/src/features/twin3d/components/DigitalTwin.tsx"

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_sim,node_bridge,node_documents,node_ocr toneBlue
class node_quality,node_quality_validation,node_quality_schemas,node_supervisor,node_health,node_baseline,node_risk,node_risk_schemas,node_rag,node_supabase toneAmber
class node_hybrid toneMint
class node_sim_api,node_backend_api,node_store,node_telemetry_service,node_sync_worker,node_sync_queue,node_sync_transport toneRose
class node_frontend,node_digital_twin,node_crew,node_mission_control toneIndigo
```

## Components

### Telemetry and Documents

- [Telemetry Simulator](https://github.com/alouakhalid/trustline/blob/main/data-engineering/simulator/scenarios/engine.py): `data-engineering/simulator/scenarios/engine.py`
- [Telemetry Bridge](https://github.com/alouakhalid/trustline/blob/main/data-engineering/simulator/ingestion_bridge.py): `data-engineering/simulator/ingestion_bridge.py`
- [Document Ingestion](https://github.com/alouakhalid/trustline/blob/main/ai-engine/agents/personal_health/services/document_ingestion_service.py): `ai-engine/agents/personal_health/services/document_ingestion_service.py`
- [Medical OCR](https://github.com/alouakhalid/trustline/blob/main/ai-engine/ocr/extractor.py): `ai-engine/ocr/extractor.py`

### Medical Intelligence

- [Signal Quality](https://github.com/alouakhalid/trustline/blob/main/ai-engine/agents/sensor_quality/core/quality_engine.py): `ai-engine/agents/sensor_quality/core/quality_engine.py`
- [Quality Validation](https://github.com/alouakhalid/trustline/blob/main/ai-engine/agents/sensor_quality/validation/validator_engine.py): `ai-engine/agents/sensor_quality/validation/validator_engine.py`
- [Signal Schemas](https://github.com/alouakhalid/trustline/blob/main/ai-engine/agents/sensor_quality/schemas/signal_schema.py): `ai-engine/agents/sensor_quality/schemas/signal_schema.py`
- [Supervisor Workflow](https://github.com/alouakhalid/trustline/tree/main/ai-engine/agents/supervisor/workflow): `ai-engine/agents/supervisor/workflow`
- [Personal Health](https://github.com/alouakhalid/trustline/blob/main/ai-engine/agents/personal_health/agent/agent.py): `ai-engine/agents/personal_health/agent/agent.py`
- [Health Baselines](https://github.com/alouakhalid/trustline/tree/main/ai-engine/agents/personal_health/baseline): `ai-engine/agents/personal_health/baseline`
- [Risk Assessment](https://github.com/alouakhalid/trustline/blob/main/ai-engine/agents/risk_assessment/services/risk_engine.py): `ai-engine/agents/risk_assessment/services/risk_engine.py`
- [Risk Evidence and Rules](https://github.com/alouakhalid/trustline/blob/main/ai-engine/agents/risk_assessment/schemas/evidence.py): `ai-engine/agents/risk_assessment/schemas/evidence.py`
- [Medical RAG](https://github.com/alouakhalid/trustline/blob/main/ai-engine/agents/personal_health/rag/service.py): `ai-engine/agents/personal_health/rag/service.py`

### Hybrid AI

- [AI Router](https://github.com/alouakhalid/trustline/blob/main/ai-engine/hybrid_ai/router.py): `ai-engine/hybrid_ai/router.py`

### Application and Storage

- [Simulator API](https://github.com/alouakhalid/trustline/blob/main/backend/api/simulator_router.py): `backend/api/simulator_router.py`
- [Backend API](https://github.com/alouakhalid/trustline/blob/main/backend/api/app.py): `backend/api/app.py`
- [Local Application Store](https://github.com/alouakhalid/trustline/blob/main/backend/database/store.py): `backend/database/store.py`
- [Telemetry Service](https://github.com/alouakhalid/trustline/blob/main/backend/services/telemetry.py): `backend/services/telemetry.py`
- [Sync Worker](https://github.com/alouakhalid/trustline/blob/main/backend/sync/worker.py): `backend/sync/worker.py`
- [Sync Queue](https://github.com/alouakhalid/trustline/blob/main/backend/sync/queue.py): `backend/sync/queue.py`
- [Sync Transport](https://github.com/alouakhalid/trustline/blob/main/backend/sync/transport.py): `backend/sync/transport.py`

### Crew and Mission Interfaces

- [Crew and Medical UI](https://github.com/alouakhalid/trustline/tree/main/frontend/trustline-ui/src/app/routes): `frontend/trustline-ui/src/app/routes`
- [3D Digital Twin](https://github.com/alouakhalid/trustline/blob/main/frontend/trustline-ui/src/features/twin3d/components/DigitalTwin.tsx): `frontend/trustline-ui/src/features/twin3d/components/DigitalTwin.tsx`

### Other components

- **Crew / Sensors**
- **Mission Control**
- **Supabase**

## Connections

- Crew / Sensors → Telemetry Simulator: generates telemetry (evidence: `README.md`)
- Telemetry Simulator → Simulator API: serves simulator data (evidence: `backend/api/simulator_router.py`)
- Telemetry Simulator → Telemetry Bridge: feeds packets
- Telemetry Bridge → Quality Validation: runs assessment (evidence: `data-engineering/simulator/ingestion_bridge.py`)
- Signal Quality → Signal Schemas: inspects streams (evidence: `ai-engine/agents/sensor_quality/core/quality_engine.py`)
- Supervisor Workflow → Signal Quality: dispatches to (evidence: `README.md`)
- Supervisor Workflow → Personal Health: dispatches to (evidence: `README.md`)
- Supervisor Workflow → Risk Assessment: dispatches to (evidence: `README.md`)
- Personal Health → Health Baselines: tracks against (evidence: `README.md`)
- Risk Assessment → Risk Evidence and Rules: evaluates evidence (evidence: `ai-engine/agents/risk_assessment/services/risk_engine.py`)
- Document Ingestion → Medical OCR: extracts with (evidence: `ai-engine/agents/personal_health/services/document_ingestion_service.py`)
- Document Ingestion → Medical RAG: feeds knowledge store (evidence: `README.md`)
- Personal Health → Medical RAG: retrieves evidence
- Personal Health → AI Router: requests model routing (evidence: `README.md`)
- Risk Assessment → AI Router: requests model routing (evidence: `README.md`)
- Backend API → Local Application Store: reads and writes (evidence: `backend/api/app.py`)
- Backend API → Telemetry Service: routes telemetry (evidence: `backend/api/app.py`)
- Simulator API → Telemetry Service: ingests packets (evidence: `backend/api/simulator_router.py`)
- Telemetry Service → Local Application Store: persists telemetry (evidence: `backend/services/telemetry.py`)
- Backend API → Supervisor Workflow: requests assessment (evidence: `README.md`)
- Crew and Medical UI → Backend API: uses API (evidence: `README.md`)
- Crew and Medical UI → 3D Digital Twin: renders twin (evidence: `README.md`)
- Mission Control → Sync Worker: exchanges mission data (evidence: `README.md`)
- Sync Worker → Sync Queue: claims and updates (evidence: `backend/sync/worker.py`)
- Sync Worker → Sync Transport: delivers events (evidence: `backend/sync/worker.py`)
- Sync Worker → Local Application Store: records checkpoints (evidence: `backend/sync/worker.py`)
- Local Application Store → Supabase: optional cloud persistence
