Application Architecture

graph TB
    subgraph "Presentation Layer"
        Web[Next.js 15 Web App]
        Mobile[React Native Mobile]
        Native[iOS/Android Native]
    end

    subgraph "API Gateway Layer"
        FastAPI[FastAPI Server<br/>Port 8000]
        WS[WebSocket Handler]
        Middleware[Middleware Stack]
    end

    subgraph "Orchestration Layer"
        HM[Host Manager]
        AC[Agent Coordinator]
        WM[Workflow Manager]
        DD[Domain Detector]
        CR[Capability Router]
        CM[Context Manager]
        PL[Preference Learner]
        GM[Goal Manager]
    end

    subgraph "Agent Layer"
        NA[Nutrition Agent]
        EA[Exercise Agent]
        SA[Sleep Agent]
        AA[Anxiety Agent]
        MA[Meditation Agent]
        HA[Hydration Agent]
        CA[Calendar Agent]
        SH[Shopping Agent]
        OA[Oura Agent]
        GA[General Agent]
        FA[Fast Conversational]
    end

    subgraph "Intelligence Layer"
        MO[Memory Orchestrator]
        IS[Intelligence System]
        EP[Energy Predictor]
        MP[Meal Predictor]
        PE[Pattern Engine]
    end

    subgraph "Service Layer"
        AS[Avatar Service]
        MS[Multimodal Processor]
        OS[Oura Insights]
        CS[Calendar Service]
        PS[Protocol Service]
    end

    subgraph "Data Access Layer"
        Repo[Repository Pattern]
        TursoRepo[Turso Repository]
        Cache[Redis Cache]
    end

    subgraph "Integration Layer"
        PM[Plugin Manager]
        OP[Oura Plugin]
        DP[Dexcom Plugin]
        AP[Apple Watch Plugin]
    end

    Web --> FastAPI
    Mobile --> FastAPI
    Native --> FastAPI
    Web --> WS

    FastAPI --> Middleware
    Middleware --> HM

    HM --> AC
    HM --> WM
    HM --> DD
    HM --> CR
    HM --> CM
    HM --> PL
    HM --> GM

    DD --> CR
    CR --> NA
    CR --> EA
    CR --> SA
    CR --> AA
    CR --> MA
    CR --> HA
    CR --> CA
    CR --> SH
    CR --> OA
    CR --> GA
    CR --> FA

    NA --> MO
    EA --> MO
    SA --> MO
    AA --> MO
    MA --> MO

    NA --> IS
    EA --> IS
    SA --> IS

    IS --> EP
    IS --> MP
    IS --> PE

    NA --> AS
    EA --> MS
    SA --> OS
    CA --> CS
    NA --> PS

    NA --> Repo
    EA --> Repo
    SA --> Repo
    Repo --> TursoRepo
    Repo --> Cache

    OA --> PM
    PM --> OP
    PM --> DP
    PM --> AP

    style Web fill:#e3f2fd
    style Mobile fill:#e3f2fd
    style Native fill:#e3f2fd
    style FastAPI fill:#fff3e0
    style HM fill:#f3e5f5
    style NA fill:#e8f5e9
    style MO fill:#e1f5fe
    style AS fill:#fce4ec
    style Repo fill:#ffebee
    style PM fill:#f0f4c3

sequenceDiagram
    participant User
    participant Web as Next.js Frontend
    participant API as FastAPI Gateway
    participant MW as Middleware
    participant DD as Domain Detector
    participant CR as Capability Router
    participant CM as Context Manager
    participant Agent as Domain Agent
    participant Mem as Memory System
    participant LLM as Gemini AI
    participant DB as Turso DB
    participant Cache as Redis

    User->>Web: Type query
    Web->>API: POST /wellness/chat
    API->>MW: Request validation
    MW->>DD: Classify query domain
    DD-->>CR: Domain(s) identified

    CR->>CM: Get user context
    CM->>Cache: Check cache
    alt Cache Hit
        Cache-->>CM: Cached context
    else Cache Miss
        CM->>DB: Fetch user data
        DB-->>CM: User profile
        CM->>Cache: Store context
    end
    CM-->>CR: Rich context

    CR->>Agent: Route to agent(s)
    Agent->>Mem: Retrieve memories
    Mem->>DB: Query memory tables
    DB-->>Mem: Memory data
    Mem-->>Agent: Contextual memories

    Agent->>Cache: Check LLM cache
    alt Cache Miss
        Agent->>LLM: Generate response
        LLM-->>Agent: AI response
        Agent->>Cache: Cache response
    end

    Agent->>Mem: Store interaction
    Mem->>DB: Save episode

    Agent-->>API: Response
    API-->>Web: JSON/Stream
    Web-->>User: Display response