woo-hoo

graph TB
    subgraph client["Client"]
        gpp["GPP-app<br/><i>C# / .NET</i>"]
        cli["CLI<br/><i>Typer</i>"]
        curl["cURL / HTTP"]
    end

    subgraph woohoo["woo-hoo (FastAPI)"]
        api["API Router<br/><code>/api/v1/metadata/*</code>"]
        gen["MetadataGenerator<br/><i>Prompt building, response parsing</i>"]
        xml["XML Parser<br/><i>DIWOO XSD validation</i>"]
        prompts["Prompt Templates<br/><i>Dutch system + user prompts</i>"]
    end

    subgraph providers["LLM Provider"]
        direction TB
        or["OpenRouter API<br/><i>openrouter.ai</i>"]
        anthropic["Anthropic API<br/><i>Direct Messages API</i>"]
        local["Lokale LLM<br/><i>Ollama / vLLM / LocalAI</i>"]
    end

    subgraph models["LLM Models"]
        eu["EU-Based<br/><b>Mistral Large</b> (default)<br/>Mistral Medium / Small / Nemo"]
        claude["Claude<br/><i>Sonnet, Opus, Haiku</i>"]
        non_eu["Non-EU<br/><i>GPT, Gemini</i>"]
        local_model["Self-hosted<br/><i>Mistral, Llama, etc.</i>"]
    end

    subgraph gpp_stack["GPP Publicatiebank"]
        pub["Django API<br/><i>Document opslag</i>"]
    end

    gpp --> api
    cli --> api
    curl --> api

    api --> gen
    gen --> prompts
    gen --> xml

    gen -->|"OpenRouter SDK<br/>(HTTPS, via internet)"| or
    gen -->|"httpx POST<br/>(Messages API)"| anthropic
    gen -.->|"httpx POST<br/>(intern netwerk)"| local

    or --> eu
    or --> non_eu
    anthropic --> claude
    local --> local_model

    api -->|"Document ophalen<br/>via UUID"| pub

    style or fill:#f5a623,stroke:#d4831f,color:#000
    style anthropic fill:#d4a574,stroke:#b8860b,color:#000
    style local fill:#4caf50,stroke:#388e3c,color:#fff
    style eu fill:#2196f3,stroke:#1976d2,color:#fff
    style claude fill:#d4a574,stroke:#b8860b,color:#000
    style local_model fill:#4caf50,stroke:#388e3c,color:#fff
    style non_eu fill:#ff5722,stroke:#d84315,color:#fff

graph LR
    subgraph gemeente["Gemeente Netwerk"]
        app["woo-hoo"]
        ollama["Ollama / vLLM<br/><b>Lokale LLM</b>"]
    end

    subgraph internet["Internet"]
        openrouter["OpenRouter<br/><i>openrouter.ai</i>"]
        anthropic_api["Anthropic API<br/><i>Direct, no middleman</i>"]
    end

    subgraph cloud["Cloud"]
        mistral["Mistral AI<br/><i>EU 🇪🇺</i>"]
        openai["OpenAI<br/><i>VS 🇺🇸</i>"]
        claude_cloud["Claude<br/><i>VS 🇺🇸</i>"]
    end

    app -->|"Optie A: OpenRouter<br/>────────────────<br/>✅ 30+ modellen<br/>✅ Geen GPU nodig<br/>⚠️ Via OpenRouter infra<br/>⚠️ Data verlaat netwerk"| openrouter
    openrouter --> mistral
    openrouter --> openai

    app -->|"Optie B: Anthropic direct<br/>────────────────<br/>✅ Geen middleman<br/>✅ Direct naar Anthropic<br/>⚠️ Data verlaat netwerk<br/>⚠️ Alleen Claude modellen"| anthropic_api
    anthropic_api --> claude_cloud

    app -->|"Optie C: Lokale LLM<br/>────────────────<br/>✅ Data blijft intern<br/>✅ Volledige controle<br/>⚠️ GPU hardware nodig<br/>⚠️ Zelf model beheren"| ollama

    style ollama fill:#4caf50,stroke:#388e3c,color:#fff
    style openrouter fill:#f5a623,stroke:#d4831f,color:#000
    style anthropic_api fill:#d4a574,stroke:#b8860b,color:#000
    style mistral fill:#2196f3,stroke:#1976d2,color:#fff
    style openai fill:#ff5722,stroke:#d84315,color:#fff
    style claude_cloud fill:#d4a574,stroke:#b8860b,color:#000
    style gemeente fill:#e8f5e9,stroke:#4caf50

graph TB
    subgraph "woo-hoo API"
        A[MetadataRouter] --> B[MetadataGenerator]
        B --> C[OpenRouterClient]
    end

    subgraph "Provider Detection"
        C --> D{LLM_PROVIDER?}
        D -->|"openrouter"| E[_openrouter_chat_completion]
        D -->|"anthropic"| F[_anthropic_chat_completion]
        D -->|"custom"| G[_custom_chat_completion]
        D -->|"per-request override"| G
    end

    subgraph "Configuration"
        H[LLM_API_KEY] --> E
        H --> F
        J[CUSTOM_LLM_BASE_URL] --> G
        H -.-> G
        K["Per-request: api_key,<br/>custom_base_url"] --> C
    end

    subgraph "External Services"
        E -->|"OpenRouter SDK"| L[OpenRouter API]
        F -->|"httpx POST<br/>Messages API"| M[Anthropic API]
        G -->|"httpx POST<br/>OpenAI-compatible"| N[Local LLM Server]
    end

    style A fill:#e1f5fe
    style B fill:#f3e5f5
    style C fill:#fff3e0
    style E fill:#e8f5e8
    style F fill:#e8f5e8
    style G fill:#e8f5e8
    style L fill:#fff3e0
    style M fill:#e1f5fe
    style N fill:#e8f5e8