flowchart TB
    subgraph Frontend["🖥️ Frontend (Next.js 16)"]
        LP[Landing Page]
        DB[Dashboard]
        PD[Project Detail]
        SC[Shot Cards]
        
        LP --> DB
        DB --> PD
        PD --> SC
    end
    
    subgraph Backend["⚙️ Backend (FastAPI)"]
        API[REST API]
        
        subgraph Agents["🤖 Multi-Agent Pipeline"]
            BA[Brand Analyst]
            VS[Visual Strategist]
            SP[Shot Planner]
            QR[Quality Reviewer]
            
            BA --> VS --> SP --> QR
        end
        
        subgraph Services["🔧 Services"]
            FS[FIBO Service]
            PS[Project Service]
        end
        
        API --> Agents
        API --> Services
        Agents --> FS
    end
    
    subgraph External["☁️ External APIs"]
        FIBO[Bria FIBO API]
        LLM[OpenRouter LLM]
    end
    
    Frontend <--> API
    FS <--> FIBO
    Agents <--> LLM
    
    style Frontend fill:#1a1a2e,stroke:#0ea5e9,color:#fff
    style Backend fill:#1a1a2e,stroke:#10b981,color:#fff
    style External fill:#1a1a2e,stroke:#f59e0b,color:#fff
    style Agents fill:#2d2d44,stroke:#8b5cf6,color:#fff
    style Services fill:#2d2d44,stroke:#06b6d4,color:#fff

sequenceDiagram
    autonumber
    participant U as 👤 User
    participant F as 🖥️ Frontend
    participant API as ⚙️ FastAPI
    participant MA as 🤖 Multi-Agent
    participant FIBO as 🎨 FIBO API
    
    U->>F: Enter creative brief
    F->>API: POST /api/projects
    
    rect rgb(45, 45, 68)
        Note over MA: Multi-Agent Pipeline
        API->>MA: Process brief
        MA->>MA: 1️⃣ Brand Analyst<br/>Extract brand essence
        MA->>MA: 2️⃣ Visual Strategist<br/>Define visual style
        MA->>MA: 3️⃣ Shot Planner<br/>Create shot list
        MA->>MA: 4️⃣ Quality Reviewer<br/>Validate consistency
    end
    
    MA-->>API: Shot definitions + brand guidelines
    API-->>F: Project created
    F-->>U: Show project with shots
    
    U->>F: Click "Generate All"
    F->>API: POST /api/projects/{id}/generate
    
    loop For each shot
        rect rgb(40, 60, 60)
            API->>FIBO: Generate structured prompt
            FIBO-->>API: JSON prompt
            API->>FIBO: Generate image
            FIBO-->>API: Image URL + seed
        end
    end
    
    API-->>F: All shots generated
    F-->>U: Display generated images

sequenceDiagram
    autonumber
    participant U as 👤 User
    participant F as 🖥️ Frontend
    participant API as ⚙️ FastAPI
    participant FIBO as 🎨 FIBO API
    
    U->>F: Click "Refine" on shot
    U->>F: Enter: "make lighting more dramatic"
    F->>API: POST /api/projects/{id}/shots/{shot_id}/refine
    
    rect rgb(45, 45, 68)
        Note over API,FIBO: Disentangled Refinement
        API->>FIBO: Refine structured prompt<br/>(only lighting changes)
        FIBO-->>API: Updated JSON prompt
        API->>FIBO: Generate with same seed
        FIBO-->>API: New image<br/>(composition preserved)
    end
    
    API-->>F: Refined shot
    F-->>U: Display updated image
    
    Note over U,FIBO: ✨ Only lighting changed<br/>Everything else preserved

sequenceDiagram
    autonumber
    participant U as 👤 User
    participant F as 🖥️ Frontend
    participant API as ⚙️ FastAPI
    participant FIBO as 🎨 FIBO API
    
    alt Seed Variations
        U->>F: Click "Variations"
        F->>API: POST /shots/{id}/variations?num=4
        loop 4 times (parallel)
            API->>FIBO: Generate with seed+i
            FIBO-->>API: Variation image
        end
        API-->>F: 4 variations
        F-->>U: Display variation grid
    end
    
    alt HDR Generation
        U->>F: Click "HDR"
        F->>API: POST /shots/{id}/hdr?mode=professional
        API->>FIBO: Generate 16-bit Adobe RGB
        FIBO-->>API: HDR image + metadata
        API-->>F: HDR result
        F-->>U: Display with HDR badge
    end
    
    alt ControlNet
        U->>F: Upload control image
        F->>API: POST /shots/{id}/controlnet
        API->>FIBO: Generate with depth/canny guide
        FIBO-->>API: Guided image
        API-->>F: ControlNet result
        F-->>U: Display guided output
    end
    
    alt Style Reference
        U->>F: Click "Set as Style Ref"
        F->>API: POST /style-reference?shot_id=X
        API-->>F: Style locked
        Note over F: Future shots use<br/>this style + seed
    end