How pateldhvani20/continuitybridge works
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: main.py API and controls · producer.py Kafka producer · reconciliation.py Merge engine · downtime_capture.py Downtime capture
Components 19
Capture and durability
- Downtime capture
app/downtime_capture.py - Primary system
app/primary.py - Delayed upstream
app/upstream_delayed.py - Local event store
app/event_store.py - Write queue
app/write_queue.py - Event models
app/models.py
Kafka transport
- Kafka producer
app/kafka/producer.py - Topic definitions
app/kafka/topics.py - Kafka configuration
app/kafka/config.py - Reconciliation consumer
app/kafka/consumer.py
Reconciliation
- Merge engine
app/reconciliation.py - Audit and review
app/reconciliation.py
Operations and security
- API and controls
app/main.py - Failure scenarios
app/scenario.py - Payload encryption
app/security/encryption.py - Role checks
app/security/roles.py - Kafka TLS
app/security/tls_config.py
Other components
- Clinical operator
- Kafka broker
Connections 21
- Clinical operator → API and controls: submits controls
README.md - API and controls → Downtime capture: routes capture
app/main.py - API and controls → Primary system: controls state
app/main.py - API and controls → Delayed upstream: manages arrivals
app/main.py - Downtime capture → Local event store: persists first
README.md - Local event store → Write queue: buffers pending
README.md - Write queue → Kafka producer: drains backlog
README.md - Kafka producer → Kafka broker: publishes events
README.md - Kafka producer → Kafka configuration: uses settings
app/kafka/producer.py - Kafka producer → Topic definitions: publishes to
- Kafka broker → Reconciliation consumer: streams events
README.md - Reconciliation consumer → Merge engine: processes events
README.md - Merge engine → Primary system: applies winners
README.md - Merge engine → Audit and review: records outcomes
README.md - Merge engine → Event models: uses event data
app/reconciliation.py - API and controls → Failure scenarios: triggers scenarios
app/main.py - Failure scenarios → API and controls: drives demo
app/main.py - API and controls → Role checks: checks access
README.md - Downtime capture → Payload encryption: protects payloads
- Kafka producer → Kafka TLS: may configure TLS
- API and controls → Merge engine: triggers reconciliation
README.md