[T.13] 团队项目：Alpha 阶段项目展示

这个作业属于哪个课程	北航2026年春季软件工程
这个作业的要求在哪里	[T.13] 团队项目：Alpha 阶段项目展示
我在这个课程的目标是	完成软件开发，感受软件工程流程
这个作业在哪个具体方面帮助我实现目标	完成alpha阶段开发展示

团队成员与分工

团队分工

组员	角色	Alpha 已完成工作
袁子轩	PM	项目规划、接口联调、产品部署
罗浩宇	后端	用户模块
李昊霖	后端	知识问答基本框架
李昊宸	后端/RAG	知识向量库构建，训练本地分词/重排模型
赵志勇	后端	题库模块往年题部分
王赫	前端	首页、导航栏、用户模块
刘诗怡	前端	论坛模块、题库模块

项目管理做法：

我们采用前后端分离的开发模式

• Frontend：Vue3 ，负责交互与页面体验；
• Backend：FastAPI + MySQL + Redis，负责业务 API、鉴权、会话与论坛/题库服务；
• RAG：独立 HTTP 服务，负责检索增强生成、流式问答与知识库能力。

• 拆分 32 个 alpha-xx 子任务；

  

• 每周例会同步进度与风险，飞书记录工作进度；

• release 分支触发部署工作流，保证演示环境与主干环境分离。

  

---

典型用户场景

目标用户：北航计算机学院的本科生。
典型场景：期中/期末前，学生需要快速完成“查知识点 -> 做题 -> 讨论 -> 整理笔记”闭环。

• 知识问答：按课程上下文进行问答，支持流式回复与历史会话管理；

  

• 题库学习：支持往年题浏览、模拟考试、错题本等学习路径；

• 学习论坛：按课程分区发帖、回复、点赞、举报；

---

杀手级功能

我们定义的创新功能是：课程感知的 RAG 对话 + 笔记结构化沉淀。

相对通用聊天工具的差异：

• 问答并非“全网泛回答”，而是绑定课程知识库检索结果；
• 可返回来源片段（source/snippet/score），增强可解释性；
• 同一链路支持流式问答与笔记生成，减少“答完再手动整理”的二次劳动。

---

团队努力

发布侧努力：

• 三仓均配置 CI（提交/PR 自动校验）；
• 三仓均配置 release 分支部署工作流（Backend/RAG 镜像部署 + Frontend 构建分发）；
• 后端支持灰度开关 USE_REMOTE_RAG，出现问题可快速回滚到本地链路。

软件工程质量

可量化工程事实：

• 后端 app/api/v1/endpoints 路由定义约 77 个（含论坛/题库/鉴权/知识问答等）；
• 前端 src/router/index.ts 已定义命名路由 24 个；
• 前端已有页面视图 22 个、组件 30 个（模块化结构）；
• 后端 Alembic 迁移脚本 14 个（数据库演进可追溯）；
• 三仓 CI/CD 工作流共 6 个（3 个 CI + 3 个 Deploy）。

质量机制：

• 后端统一 ApiResponse 响应与分层（endpoint/service）规范；
• 前端使用 TypeScript + vue-tsc + ESLint + Prettier；
• RAG 独立服务化，支持健康检查、超时/错误契约、流式协议。