graph TB
    subgraph "Frontend (Nuxt 3 + Vue 3)"
        UI[User Interface]
        Camera[Camera System]
        Upload[File Upload]
    end
    
    subgraph "Backend (Flask API)"
        API[API Gateway]
        ItemDetect[Item Detection]
        DeepfakeCheck[Deepfake Detection]
        Criteria[Criteria Generation]
        Analysis[Counterfeit Analysis]
        FactCheck[Fact Checking]
        PersonResearch[Person Research]
    end
    
    subgraph "AI Services"
        Gemini[Google Gemini 2.5 Pro]
        GeminiFlash[Gemini Flash]
        PyTorch[PyTorch ResNet50]
        Groq[Groq LLaMA]
    end
    
    subgraph "External APIs"
        SerpAPI[SerpAPI / Google Lens]
        GoogleSearch[Google Search]
        Supabase[Supabase Storage]
    end
    
    UI --> Camera
    UI --> Upload
    Camera --> API
    Upload --> API
    
    API --> ItemDetect
    ItemDetect --> DeepfakeCheck
    DeepfakeCheck --> Criteria
    Criteria --> Analysis
    API --> FactCheck
    API --> PersonResearch
    
    ItemDetect --> Gemini
    DeepfakeCheck --> PyTorch
    Criteria --> Gemini
    Criteria --> GoogleSearch
    Analysis --> GeminiFlash
    FactCheck --> Gemini
    FactCheck --> GoogleSearch
    PersonResearch --> GeminiFlash
    PersonResearch --> GoogleSearch
    
    ItemDetect --> Groq
    ItemDetect --> SerpAPI
    API --> Supabase
    
    style UI fill:#00DC82
    style API fill:#3178C6
    style Gemini fill:#4285F4
    style PyTorch fill:#EE4C2C

graph LR
    subgraph "API Layer"
        Flask[Flask Server]
    end
    
    subgraph "Detection Modules"
        Item[item_detection.py]
        AIDetect[ai_detection/]
        Counterfeit[counterfeit.py]
        FactC[fact_check.py]
        Person[person.py]
    end
    
    subgraph "Support Modules"
        Criteria[criteria.py]
        ReverseSearch[generate_real_images/]
        Similarity[image_similarity_scores/]
        Prompts[prompts/]
        Parser[llm_parser.py]
    end
    
    subgraph "Data Layer"
        Cache[(SQLite Cache)]
        Uploads[(/uploads)]
    end
    
    Flask --> Item
    Flask --> AIDetect
    Flask --> Counterfeit
    Flask --> FactC
    Flask --> Person
    
    Item --> Criteria
    Item --> ReverseSearch
    Counterfeit --> Criteria
    Counterfeit --> Similarity
    
    Item --> Prompts
    Counterfeit --> Prompts
    FactC --> Prompts
    Person --> Prompts
    
    Item --> Parser
    Counterfeit --> Parser
    
    Criteria --> Cache
    Flask --> Uploads

sequenceDiagram
    participant U as User
    participant FE as Frontend
    participant API as Flask API
    participant DF as Deepfake Detector
    participant ID as Item Detection
    participant RS as Reverse Search
    participant CG as Criteria Generator
    participant CA as Counterfeit Analyzer
    participant SS as Similarity Scorer
    
    U->>FE: Upload/Capture Image
    FE->>API: POST /detect
    
    API->>DF: Check if AI-generated
    alt Is Deepfake (≥60%)
        DF-->>API: Deepfake Detected
        API-->>FE: Return Deepfake Warning
        FE-->>U: Show AI Detection Alert
    else Not Deepfake
        DF-->>API: Authentic Image
        API->>ID: Analyze Image
        ID->>RS: Reverse Image Search
        RS-->>ID: Reference Images + Trust Scores
        ID->>ID: Extract Product Name
        ID-->>API: Product Detected + References
        API-->>FE: Detection Result + Product Info
        FE-->>U: Show Product Modal
        
        U->>FE: Confirm & Specify Brand (optional)
        FE->>API: POST /criteria/:id
        API->>CG: Generate Criteria
        CG->>CG: Search Web for Auth Markers
        CG-->>API: Criteria + Locations
        API-->>FE: Guided Photo Instructions
        FE-->>U: Show Step-by-Step Guide
        
        loop For Each Criterion
            U->>FE: Capture Angle Photo
            FE->>FE: Store Image
        end
        
        FE->>API: POST /analyze/:id (all images)
        API->>SS: Calculate Similarity Scores
        SS-->>API: Similarity Results
        
        par Parallel Analysis
            API->>CA: Analyze Criterion 1
            API->>CA: Analyze Criterion 2
            API->>CA: Analyze Criterion N
        end
        
        CA-->>API: Aggregated Results
        API->>API: Calculate Overall Score
        API-->>FE: Authentication Report
        FE-->>U: Show Results (Authentic/Counterfeit)
    end

flowchart TD
    Start([User Uploads Image]) --> Upload[Save Image to /uploads]
    Upload --> DeepfakeCheck{Run Deepfake<br/>Detection Model}
    
    DeepfakeCheck -->|Probability ≥ 0.6| Flagged[Flag as AI-Generated]
    DeepfakeCheck -->|Probability < 0.6| Continue[Continue to<br/>Item Detection]
    
    Flagged --> CalcConfidence[Calculate Confidence Level]
    CalcConfidence --> ShowWarning[Return Deepfake Warning]
    ShowWarning --> End1([End: Show Alert to User])
    
    Continue --> ItemDetect[Detect Item Type]
    ItemDetect --> TypeCheck{Item Type?}
    
    TypeCheck -->|Product| ProductFlow[Product Authentication Flow]
    TypeCheck -->|Person| PersonFlow[Person Research Flow]
    TypeCheck -->|Text| FactCheckFlow[Fact-Check Flow]
    TypeCheck -->|Other| GeminiAnalysis[General AI Analysis]
    
    ProductFlow --> End2([Continue Product Auth])
    PersonFlow --> End3([Research Person])
    FactCheckFlow --> End4([Verify Claims])
    GeminiAnalysis --> End5([Return Analysis])
    
    style Flagged fill:#ff6b6b
    style ShowWarning fill:#ff6b6b
    style Continue fill:#51cf66
    style DeepfakeCheck fill:#ffd43b

flowchart LR
    A[Image with Text] --> B[Extract Claims via OCR + AI]
    B --> C{Contains<br/>Factual Claims?}
    
    C -->|No| D[Return: No Claims Found]
    C -->|Yes| E[For Each Claim]
    
    E --> F[Search Web for Evidence]
    F --> G[Evaluate Sources]
    G --> H[Cross-Reference Multiple Sources]
    
    H --> I{Verdict}
    I -->|Supported| J[TRUE]
    I -->|Contradicted| K[FALSE]
    I -->|Mixed| L[PARTIALLY TRUE]
    I -->|Insufficient| M[UNVERIFIABLE]
    
    J --> N[Compile Report]
    K --> N
    L --> N
    M --> N
    
    N --> O[Calculate Confidence Score]
    O --> P[Return Results]
    
    style J fill:#51cf66
    style K fill:#ff6b6b
    style L fill:#ffd43b
    style M fill:#868e96

graph TD
    URL[URL/Domain] --> Extract[Extract Domain]
    Extract --> Known{Known Brand?}
    
    Known -->|Yes| Official[Official Brand Site]
    Known -->|No| Dynamic[Dynamic Scoring]
    
    Official --> Score10[Trust Score: 1.0]
    
    Dynamic --> HTTPS{HTTPS?}
    HTTPS -->|Yes| Base1[Base: 0.4]
    HTTPS -->|No| Base2[Base: 0.3]
    
    Base1 --> Indicators
    Base2 --> Indicators
    
    Indicators[Check Indicators] --> Official2{Has 'official'<br/>'authorized'<br/>'certified'?}
    Official2 -->|Yes| Plus1[+0.15]
    Official2 -->|No| Plus2[+0.0]
    
    Plus1 --> Platform
    Plus2 --> Platform
    
    Platform{E-commerce<br/>Platform?} -->|Yes| MinTrust[Min Trust: 0.5]
    Platform -->|No| RedFlags
    
    MinTrust --> RedFlags
    RedFlags{Red Flags?<br/>'replica'<br/>'fake'<br/>'cheap'} -->|Yes| Penalty[-0.3]
    RedFlags -->|No| Boost
    
    Penalty --> Final
    Boost[Frequency Boost] --> Final[Final Trust Score]
    
    Final --> Clamp[Clamp to 0.0-1.0]
    
    style Score10 fill:#51cf66
    style Official fill:#51cf66
    style Penalty fill:#ff6b6b
    style RedFlags fill:#ffd43b