# pateldhvani20/continuitybridge architecture

> Architecture diagram of the GitHub repository pateldhvani20/continuitybridge, 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/pateldhvani20/continuitybridge
- Repository: https://github.com/pateldhvani20/continuitybridge

## Overview

ContinuityBridge is a local-first clinical event continuity and reconciliation service for EHR outages and delayed recovery. The primary workflow captures clinical events, persists them locally before Kafka transport, consumes the stream, and reconciles events into authoritative primary state, escalating unresolved dependencies or conflicts for human review. It also exposes outage controls, deterministic scenarios, audit and metrics functions, and role-based security. The README documents a dashboard, but its files are absent from the supplied tree. Relationships below rely on README workflow statements and the sampled main-module reference index; unsampled module internals are not assumed.

Main entry points: [`app/main.py`](https://github.com/pateldhvani20/continuitybridge/blob/main/app/main.py) (API and controls), [`app/kafka/producer.py`](https://github.com/pateldhvani20/continuitybridge/blob/main/app/kafka/producer.py) (Kafka producer), [`app/reconciliation.py`](https://github.com/pateldhvani20/continuitybridge/blob/main/app/reconciliation.py) (Merge engine), [`app/downtime_capture.py`](https://github.com/pateldhvani20/continuitybridge/blob/main/app/downtime_capture.py) (Downtime capture)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Capture and durability"]
  node_capture["Downtime capture"]
  node_primary["Primary system<br/>[primary.py]"]
  node_upstream["Delayed upstream"]
  node_store[("Local event store<br/>[event_store.py]")]
  node_writequeue["Write queue<br/>[write_queue.py]"]
  node_models["Event models<br/>[models.py]"]
end

subgraph group_stream["Kafka transport"]
  node_producer["Kafka producer<br/>[producer.py]"]
  node_topics["Topic definitions<br/>[topics.py]"]
  node_config["Kafka configuration<br/>[config.py]"]
  node_consumer["Reconciliation consumer<br/>[consumer.py]"]
end

subgraph group_reconcile["Reconciliation"]
  node_engine["Merge engine<br/>[reconciliation.py]"]
  node_audit["Audit and review<br/>[reconciliation.py]"]
end

subgraph group_operations["Operations and security"]
  node_api["API and controls<br/>[main.py]"]
  node_scenario["Failure scenarios<br/>[scenario.py]"]
  node_encryption["Payload encryption<br/>[encryption.py]"]
  node_roles["Role checks<br/>[roles.py]"]
  node_tls["Kafka TLS<br/>[tls_config.py]"]
end

node_user(("Clinical operator"))
node_broker[("Kafka broker")]

node_user -->|"submits controls"| node_api
node_api -->|"routes capture"| node_capture
node_api -->|"controls state"| node_primary
node_api -->|"manages arrivals"| node_upstream
node_capture -->|"persists first"| node_store
node_store -->|"buffers pending"| node_writequeue
node_writequeue -->|"drains backlog"| node_producer
node_producer -->|"publishes events"| node_broker
node_producer -.->|"uses settings"| node_config
node_producer -.->|"publishes to"| node_topics
node_broker -->|"streams events"| node_consumer
node_consumer -->|"processes events"| node_engine
node_engine -->|"applies winners"| node_primary
node_engine -->|"records outcomes"| node_audit
node_engine -.->|"uses event data"| node_models
node_api -->|"triggers scenarios"| node_scenario
node_scenario -.->|"drives demo"| node_api
node_api -->|"checks access"| node_roles
node_capture -.->|"protects payloads"| node_encryption
node_producer -.->|"may configure TLS"| node_tls
node_api -->|"triggers reconciliation"| node_engine

click node_api "https://github.com/pateldhvani20/continuitybridge/blob/main/app/main.py"
click node_capture "https://github.com/pateldhvani20/continuitybridge/blob/main/app/downtime_capture.py"
click node_primary "https://github.com/pateldhvani20/continuitybridge/blob/main/app/primary.py"
click node_upstream "https://github.com/pateldhvani20/continuitybridge/blob/main/app/upstream_delayed.py"
click node_store "https://github.com/pateldhvani20/continuitybridge/blob/main/app/event_store.py"
click node_writequeue "https://github.com/pateldhvani20/continuitybridge/blob/main/app/write_queue.py"
click node_models "https://github.com/pateldhvani20/continuitybridge/blob/main/app/models.py"
click node_producer "https://github.com/pateldhvani20/continuitybridge/blob/main/app/kafka/producer.py"
click node_topics "https://github.com/pateldhvani20/continuitybridge/blob/main/app/kafka/topics.py"
click node_config "https://github.com/pateldhvani20/continuitybridge/blob/main/app/kafka/config.py"
click node_consumer "https://github.com/pateldhvani20/continuitybridge/blob/main/app/kafka/consumer.py"
click node_engine "https://github.com/pateldhvani20/continuitybridge/blob/main/app/reconciliation.py"
click node_scenario "https://github.com/pateldhvani20/continuitybridge/blob/main/app/scenario.py"
click node_encryption "https://github.com/pateldhvani20/continuitybridge/blob/main/app/security/encryption.py"
click node_roles "https://github.com/pateldhvani20/continuitybridge/blob/main/app/security/roles.py"
click node_tls "https://github.com/pateldhvani20/continuitybridge/blob/main/app/security/tls_config.py"
click node_audit "https://github.com/pateldhvani20/continuitybridge/blob/main/app/reconciliation.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_capture,node_primary,node_upstream,node_store,node_writequeue,node_models toneBlue
class node_producer,node_topics,node_config,node_consumer,node_broker toneAmber
class node_engine,node_audit toneMint
class node_api,node_scenario,node_encryption,node_roles,node_tls toneRose
class node_user toneIndigo
```

## Components

### Capture and durability

- [Downtime capture](https://github.com/pateldhvani20/continuitybridge/blob/main/app/downtime_capture.py): `app/downtime_capture.py`
- [Primary system](https://github.com/pateldhvani20/continuitybridge/blob/main/app/primary.py): `app/primary.py`
- [Delayed upstream](https://github.com/pateldhvani20/continuitybridge/blob/main/app/upstream_delayed.py): `app/upstream_delayed.py`
- [Local event store](https://github.com/pateldhvani20/continuitybridge/blob/main/app/event_store.py): `app/event_store.py`
- [Write queue](https://github.com/pateldhvani20/continuitybridge/blob/main/app/write_queue.py): `app/write_queue.py`
- [Event models](https://github.com/pateldhvani20/continuitybridge/blob/main/app/models.py): `app/models.py`

### Kafka transport

- [Kafka producer](https://github.com/pateldhvani20/continuitybridge/blob/main/app/kafka/producer.py): `app/kafka/producer.py`
- [Topic definitions](https://github.com/pateldhvani20/continuitybridge/blob/main/app/kafka/topics.py): `app/kafka/topics.py`
- [Kafka configuration](https://github.com/pateldhvani20/continuitybridge/blob/main/app/kafka/config.py): `app/kafka/config.py`
- [Reconciliation consumer](https://github.com/pateldhvani20/continuitybridge/blob/main/app/kafka/consumer.py): `app/kafka/consumer.py`

### Reconciliation

- [Merge engine](https://github.com/pateldhvani20/continuitybridge/blob/main/app/reconciliation.py): `app/reconciliation.py`
- [Audit and review](https://github.com/pateldhvani20/continuitybridge/blob/main/app/reconciliation.py): `app/reconciliation.py`

### Operations and security

- [API and controls](https://github.com/pateldhvani20/continuitybridge/blob/main/app/main.py): `app/main.py`
- [Failure scenarios](https://github.com/pateldhvani20/continuitybridge/blob/main/app/scenario.py): `app/scenario.py`
- [Payload encryption](https://github.com/pateldhvani20/continuitybridge/blob/main/app/security/encryption.py): `app/security/encryption.py`
- [Role checks](https://github.com/pateldhvani20/continuitybridge/blob/main/app/security/roles.py): `app/security/roles.py`
- [Kafka TLS](https://github.com/pateldhvani20/continuitybridge/blob/main/app/security/tls_config.py): `app/security/tls_config.py`

### Other components

- **Clinical operator**
- **Kafka broker**

## Connections

- Clinical operator → API and controls: submits controls (evidence: `README.md`)
- API and controls → Downtime capture: routes capture (evidence: `app/main.py`)
- API and controls → Primary system: controls state (evidence: `app/main.py`)
- API and controls → Delayed upstream: manages arrivals (evidence: `app/main.py`)
- Downtime capture → Local event store: persists first (evidence: `README.md`)
- Local event store → Write queue: buffers pending (evidence: `README.md`)
- Write queue → Kafka producer: drains backlog (evidence: `README.md`)
- Kafka producer → Kafka broker: publishes events (evidence: `README.md`)
- Kafka producer → Kafka configuration: uses settings (evidence: `app/kafka/producer.py`)
- Kafka producer → Topic definitions: publishes to
- Kafka broker → Reconciliation consumer: streams events (evidence: `README.md`)
- Reconciliation consumer → Merge engine: processes events (evidence: `README.md`)
- Merge engine → Primary system: applies winners (evidence: `README.md`)
- Merge engine → Audit and review: records outcomes (evidence: `README.md`)
- Merge engine → Event models: uses event data (evidence: `app/reconciliation.py`)
- API and controls → Failure scenarios: triggers scenarios (evidence: `app/main.py`)
- Failure scenarios → API and controls: drives demo (evidence: `app/main.py`)
- API and controls → Role checks: checks access (evidence: `README.md`)
- Downtime capture → Payload encryption: protects payloads
- Kafka producer → Kafka TLS: may configure TLS
- API and controls → Merge engine: triggers reconciliation (evidence: `README.md`)
