Integration Architecture

graph TB
    WDT[Wellness Digital Twin<br/>Core System]
    
    subgraph "Biometric Integrations"
        Oura[⌚ Oura Ring API<br/>Biometric Data]
        Dexcom[💉 Dexcom CGM<br/>Glucose Monitoring]
        AW[🍎 Apple Watch<br/>HealthKit Data]
    end
    
    subgraph "Productivity Integrations"
        GCal[📅 Google Calendar<br/>Event Sync]
        Email[📧 Email Services<br/>Optional]
    end
    
    subgraph "Environmental Data"
        Weather[🌤️ OpenWeatherMap<br/>Weather & Air Quality]
        Location[📍 Location Services<br/>Optional]
    end
    
    subgraph "AI/ML Services"
        Gemini[🧠 Google Gemini<br/>Primary LLM]
        Vision[👁️ Gemini Vision<br/>Image Analysis]
        OpenAI[💭 OpenAI<br/>Fallback LLM]
        Claude[🤖 Anthropic Claude<br/>Alternative LLM]
    end
    
    subgraph "Cloud Services"
        GCS[☁️ Cloud Storage<br/>Files & Avatars]
        SM[🔐 Secret Manager<br/>API Keys]
        Logging[📊 Cloud Logging<br/>Monitoring]
    end
    
    subgraph "Data Storage"
        Turso[(🗄️ Turso Database<br/>Primary DB)]
        Redis[(⚡ Redis Cache<br/>In-Memory)]
    end

    WDT <-->|OAuth 2.0<br/>Real-time Sync| Oura
    WDT <-->|OAuth 2.0<br/>5-min intervals| Dexcom
    WDT <-->|HealthKit<br/>iOS Integration| AW
    
    WDT <-->|OAuth 2.0<br/>Bi-directional| GCal
    WDT -.->|Optional<br/>Notifications| Email
    
    WDT -->|REST API<br/>Conditions & Forecast| Weather
    WDT -.->|Optional<br/>Context| Location
    
    WDT <-->|Primary<br/>Inference| Gemini
    WDT <-->|Multimodal<br/>Analysis| Vision
    WDT -.->|Fallback<br/>GPT-4| OpenAI
    WDT -.->|Alternative<br/>Claude| Claude
    
    WDT <-->|Signed URLs<br/>Object Storage| GCS
    WDT -->|Secrets<br/>Retrieval| SM
    WDT -->|Events<br/>Logs| Logging
    
    WDT <-->|SQL<br/>Primary Data| Turso
    WDT <-->|Key-Value<br/>Cache| Redis

    style WDT fill:#ffebee
    style Oura fill:#c8e6c9
    style Dexcom fill:#c8e6c9
    style AW fill:#c8e6c9
    style GCal fill:#fff3e0
    style Weather fill:#e1f5fe
    style Gemini fill:#e3f2fd
    style GCS fill:#f3e5f5
    style Turso fill:#fce4ec
    style Redis fill:#f0f4c3