Skip to content

System overview

flowchart LR
  subgraph "Client tier"
    PH[📱 Mobile app<br/>Next.js + React]
    WB[🖥 Web dashboard<br/>vanilla ES modules]
    SMS[📨 SMS<br/>Twilio]
    WR[⌚ Wearable<br/>HealthKit / Health Connect]
  end
  subgraph "Agent tier (FastAPI)"
    IN[Intake] --> GE[Geo] --> VAL[Validation]
    VAL --> TR[Triage] --> ENR[Enrichment] --> NOT[Notification]
    ENR --> CL[Cluster]
    NOT --> KGW[KG update]
  end
  subgraph "MCP tier"
    M1[vectorsurv]
    M2[knowledge-graph]
    M3[nws-heatrisk]
    M4[mag-hrn]
    M5[adhs]
    M6[211-az]
    M7[whispers]
    M8[inaturalist]
    M9[great-az-tick-check]
    M10[sms-entry]
    M11[wearable]
  end
  subgraph "Storage tier"
    MGO[(MongoDB<br/>mobile writes)]
    DL[(DuckLake<br/>web + analytics)]
    PG[(Postgres<br/>DuckLake catalog)]
  end
  PH -->|X-Client-Channel: mobile| IN
  WB -->|X-Client-Channel: web| IN
  SMS --> IN
  WR --> ENR
  ENR --> M1 & M3 & M4 & M5 & M6 & M7 & M8 & M9 & M11
  KGW --> M2
  KGW --> MGO
  KGW --> DL
  DL --> PG
  MGO -. 5-min timer .-> DL

See the eight-agent topology, the privacy contract, and the four worked data flows (A/B/C/D) for the details behind each box.