01. 校园课程智能助手项目介绍与成品演示

flowchart LR
    STU["学生<br/>提问 · 查看"]
    ADM["管理员<br/>维护 · 入库"]

    subgraph SYS[系统边界 · 校园课程智能助手]
        FE["前端 Vue 3<br/>对话页 · SSE"]
        API["FastAPI 服务<br/>业务 API · Agent"]
        MCP["MCP 服务<br/>课表 · 检索 · 计划"]
        DB[("MySQL<br/>课表 · 计划")]
        VDB[("Chroma<br/>向量知识库")]
    end

    LLM["大模型 API<br/>第三方"]
    EMB["Embedding API<br/>第三方"]

    STU --> FE
    ADM --> FE
    FE --> API --> MCP
    MCP --> DB
    MCP --> VDB
    API --> LLM
    MCP --> EMB

    classDef base fill:#F1EFE8,stroke:#5F5E5A,color:#444441
    classDef biz fill:#E1F5EE,stroke:#0F6E56,color:#085041
    classDef ext fill:#EEEDFE,stroke:#534AB7,color:#3C3489
    class STU,ADM base
    class FE,API,MCP,DB,VDB biz
    class LLM,EMB ext
    style SYS fill:none,stroke:#888780,stroke-dasharray:6 4

flowchart LR
    A["管理员 admin<br/>上传文档并入库"] --> B["学生 aaa<br/>登录"]
    B --> C["问：明天有什么课？<br/>调用 查询我的课表"]
    C --> D["问：实验要预习吗？<br/>调用 检索课程资料"]
    D --> E["说：生成计划并保存<br/>调用 保存学习计划"]
    E --> F["切换学生 bbb<br/>验证数据隔离"]

    classDef base fill:#F1EFE8,stroke:#5F5E5A,color:#444441
    classDef ai fill:#EEEDFE,stroke:#534AB7,color:#3C3489
    class A,B,F base
    class C,D,E ai

flowchart LR
    STU["学生"] --> S1["我的课表<br/>只读列表"]
    STU --> S2["问资料<br/>助手检索知识库"]
    STU --> S3["学习计划<br/>手动填写或助手生成"]
    S1 --> DB[("MySQL<br/>课表 · 学习计划")]
    S3 --> DB
    S2 --> VDB[("Chroma<br/>向量知识库")]

    classDef base fill:#F1EFE8,stroke:#5F5E5A,color:#444441
    classDef biz fill:#E1F5EE,stroke:#0F6E56,color:#085041
    classDef ai fill:#EEEDFE,stroke:#534AB7,color:#3C3489
    class STU base
    class S1,S3,DB biz
    class S2,VDB ai

flowchart LR
    AG["ReAct Agent"] --> CLI["FastAPI<br/>MCP 客户端 · 携带 JWT"]
    CLI -->|MCP 协议| SRV["FastMCP 服务<br/>解析 JWT 得到 user_id"]
    SRV --> T1["get_my_schedule"]
    SRV --> T2["search_course_docs"]
    SRV --> T3["save_study_plan"]
    T1 --> DB[("MySQL")]
    T3 --> DB
    T2 --> VDB[("Chroma")]

    classDef biz fill:#E1F5EE,stroke:#0F6E56,color:#085041
    classDef ai fill:#EEEDFE,stroke:#534AB7,color:#3C3489
    class CLI,DB biz
    class AG,SRV,T1,T2,T3,VDB ai

flowchart TB
    Q["用户提问"] --> R["模型推理<br/>结合系统提示词"]
    R --> J{"需要调用工具？"}
    J -->|是| T["通过 MCP 调用工具"]
    T --> O["工具结果返回模型"]
    O --> R
    J -->|否| A["生成最终回答<br/>SSE 逐字推送"]

    classDef base fill:#F1EFE8,stroke:#5F5E5A,color:#444441
    classDef ai fill:#EEEDFE,stroke:#534AB7,color:#3C3489
    class Q,A base
    class R,J,T,O ai

flowchart LR
    subgraph W[写入：上传文档时执行]
        W1["上传文档"] --> W2["抽取纯文本"] --> W3["分块"] --> W4["Embedding<br/>向量化"]
    end
    subgraph R[读取：用户提问时执行]
        R1["用户提问"] --> R2["问题向量化"] --> R3["检索相似片段"] --> R4["模型组织回答"]
    end
    W4 --> VDB[("Chroma<br/>向量库")]
    VDB --> R3

    classDef biz fill:#E1F5EE,stroke:#0F6E56,color:#085041
    classDef ai fill:#EEEDFE,stroke:#534AB7,color:#3C3489
    class W1,W2,W3,W4 biz
    class R1,R2,R3,R4,VDB ai
    style W fill:none,stroke:#B4B2A9,stroke-dasharray:4 4
    style R fill:none,stroke:#B4B2A9,stroke-dasharray:4 4

flowchart LR
    FE["Vue 3<br/>SSE 流式"] --> API["FastAPI<br/>转发 JWT"] --> AG["ReAct Agent<br/>create_agent"]
    AG <--> LLM["大模型<br/>推理 · 决策"]
    AG --> MCP["MCP 服务<br/>3 个工具"]
    MCP --> DB[("MySQL<br/>课表 · 计划")]
    MCP --> VDB[("Chroma<br/>向量库")]
    ADM["管理员<br/>上传文档"] --> ING["文档入库<br/>分块 · 向量化"] --> VDB

    classDef base fill:#F1EFE8,stroke:#5F5E5A,color:#444441
    classDef biz fill:#E1F5EE,stroke:#0F6E56,color:#085041
    classDef ai fill:#EEEDFE,stroke:#534AB7,color:#3C3489
    class FE,ADM base
    class API,DB,ING biz
    class AG,LLM,MCP,VDB ai