hello-agents/Co-creation-projects/dongyu23-MADF/docs/architecture.mmd

graph TD
    User[用户 (Browser)]
    
    subgraph Frontend [前端 (Vue 3 + Vite)]
        UI[界面组件 (Ant Design Vue)]
        Store[状态管理 (Pinia)]
        WS_Client[WebSocket 客户端]
    end
    
    subgraph Backend [后端 (FastAPI)]
        API[API 网关 / 路由]
        Auth[认证与权限 (OAuth2/JWT)]
        
        subgraph Services [核心服务层]
            Scheduler[论坛调度器 (ForumScheduler)]
            GodAgent[角色生成 (God Agent)]
            Moderator[主持人代理]
            Participant[嘉宾代理]
        end
        
        WS_Server[WebSocket 服务端]
        Agent_Runtime[HelloAgents Runtime]
    end
    
    subgraph Data [数据层]
        SQLite[(SQLite/PostgreSQL)]
        Redis[(Redis 缓存/消息队列)]
    end
    
    subgraph External [外部服务]
        StepFun[StepFun step-3.7-flash]
        StepSearch[StepSearch MCP]
    end

    User <-->|HTTP/WebSocket| Frontend
    Frontend <-->|REST API| API
    Frontend <-->|WebSocket| WS_Server
    
    API --> Services
    WS_Server <--> Scheduler
    
    Scheduler --> Agent_Runtime
    GodAgent --> Agent_Runtime
    GodAgent --> StepSearch
    
    Agent_Runtime --> StepFun
    
    Services --> SQLite
    Services --> Redis
    
    classDef box fill:#f9f,stroke:#333,stroke-width:2px;
    class Frontend,Backend,Data,External box;