ai-api-testing / SYSTEM_ARCHITECTURE.md
Amitkasar's picture
Remove binary files from tracking
8085285
|
Raw History Blame Contribute Delete
1.91 kB
graph TB
    subgraph CLIENT["🖥️ Frontend — React + Vite SPA"]
        PAGES["Pages\nSpecs · Workflow · Chat · History\nAssets · Settings · Usage"]
        CTX["AppContext\nGlobal State"]
        CTX -.-> PAGES
    end

    subgraph BACKEND["⚙️ Backend — FastAPI"]
        MW["Middleware\nCORS · JWT Auth · Rate Limiter · Logger"]

        subgraph ROUTES["REST API  /api/v1"]
            PUB["/auth\n🔓 Public"]
            PROT["/specs · /sessions · /execution\n/history · /chat · /assets\n/usage · /settings\n🔐 JWT Protected"]
        end

        subgraph SERVICES["Service Layer"]
            PARSERS["Spec Parsers\nPostman · Swagger"]
            CORE["Core Services\nLLM Planner · API Executor\nResponse Analyzer · Chat Assistant\nAsset Service · Usage Service"]
        end

        subgraph LLM_INT["🔗 LLM Integration — LangChain"]
            FAC["LLMClientFactory\nRegistry · Task Resolver"]
            CLIENTS["Provider Clients\nMistral · OpenAI · Anthropic\nGemini · Groq"]
            FAC --> CLIENTS
        end

        MW --> ROUTES
        PROT --> PARSERS
        PROT --> CORE
        CORE --> FAC
    end

    subgraph DATA["🗄️ Data Layer"]
        PG[("PostgreSQL\nspec_documents · sessions\nexecution_history · chat_sessions\nassets · collections\nllm_providers · llm_task_config · llm_usage")]
        FS["File Storage\nLocal / Supabase\naudio · video · images · docs · specs"]
        ALB["Alembic Migrations"]
        ALB -.->|schema upgrades| PG
    end

    LLM_EXT["🤖 LLM APIs\nMistral · OpenAI · Anthropic\nGoogle Gemini · Groq"]

    TARGET["🌐 Target REST APIs\nUser-specified Base URL"]

    %% Global connections
    CLIENT -->|"HTTPS · Bearer JWT"| MW
    CORE -->|"SQLAlchemy ORM"| PG
    CORE -->|"File I/O"| FS
    CLIENTS -->|"API calls"| LLM_EXT
    CORE -->|"HTTP Requests"| TARGET