border-red-post-nalati/docs/TEAM_WORKPLAN.md

三人团队工作计划

项目：边疆红驿那拉提文旅智能问答系统 V1.0
周期：2026 年 10 月 16 日—11 月 14 日
本计划明确主责与交付边界；主责人对任务关闭负责，配合人对自身交付物负责。

一、成员职责与边界

成员	角色	主责范围	主要交付物	边界
范涵宇	后端、数据库与检索负责人	FastAPI、PostgreSQL/pgvector、数据模型、检索、RAG、部署与后端测试	数据库表、API、检索服务、RAG 服务、运行/部署说明	数据库结构和 API 字段由其主责；变更前须通知吉海燕。不得将真实密钥提交到仓库。
吉海燕	前端与系统集成负责人	Vue 页面、接口调用、交互体验、异常状态、浏览器验收、演示截图	问答、知识管理、来源更新、实验评估页面；接口联调记录	前端只能通过 /api 访问服务，不得直连数据库或保存服务端密钥。接口字段变化须先与范涵宇确认。
杨星萱	知识库、实验与文档负责人	资料收集/核验、来源登记、测试问题集、人工评分、项目与软著文档	可核验资料清单、审核规范、实验记录、使用说明、软著材料初稿	未审核资料不得进入正式检索。不得虚构来源、实验数据或结论；不直接修改数据库结构。

二、协作约定

1. main 只放稳定可演示版本；dev 是团队集成分支；每人从 dev 创建 feat/<模块>-<描述> 分支。
2. 每项工作先建 Gitea Issue，写明负责人、验收标准、分支名和预计完成日期；完成后提交合并请求。
3. 数据库结构、Pydantic Schema、/api 接口字段、Embedding 模型和实验口径属于公共边界，修改前须在 Issue 中说明并通知相关成员。
4. 合并请求至少由一名非作者审查。页面改动附截图；后端改动附测试命令和结果；数据库改动附迁移/初始化说明。
5. 知识条目必须保留标题、分类、正文、来源链接、采集日期、核验状态和核验说明。杨星萱审核后，范涵宇才可纳入正式检索索引。

三、阶段工作与验收

阶段与时间	范涵宇：后端/数据库	吉海燕：前端/集成	杨星萱：知识库/实验/文档	阶段验收
阶段 1：环境联调（10/16—10/18）	处理 Docker、WSL、PostgreSQL；验证建表、/api/health、知识新增/读取	启动 Vue，验证 API 连接和“新增知识—列表刷新”流程，补浏览器截图	建立资料登记模板、审核状态定义和验收记录模板	浏览器端可新增知识，刷新后数据仍存在；团队成员可按 README 启动
阶段 2：知识管理（10/19—10/23）	设计并实现来源、文档、知识条目和审核相关表/API	完成知识新增、列表、编辑、来源和审核状态页面	收集并登记首批 30—50 条可核验资料，完成初步分类与来源核验	可管理、查询并追溯首批知识；未审核条目有明确状态
阶段 3：关键词、向量与混合检索（10/24—10/29）	实现关键词检索、Embedding Provider、pgvector 检索和 RRF 融合；记录排序与耗时	增加检索模式选择、检索结果/来源/耗时展示	编写 20—30 个测试问题，标注问题类别、期望证据与答案要点	同一问题能比较关键词、向量、混合三种模式，结果可复现
阶段 4：RAG 问答与来源追溯（10/30—11/3）	接入 LLM API，完成上下文组装、提示词、知识不足提示、问答与检索日志	完成问答历史、引用来源卡片、加载和错误状态	审核回答是否受来源支持，整理正反例与失败案例	系统回答带来源；资料不足时不作确定性编造
阶段 5：前端完善与系统集成（11/4—11/7）	修复接口问题，补基础自动化测试，整理配置和启动说明	完成四个页面的主要流程、空态、错误提示和演示路径	编写用户操作说明、接口验收清单和知识维护说明	可在浏览器完成“录入—审核—检索—问答—查看来源”主流程
阶段 6：实验与系统测试（11/8—11/11）	固定模型/检索配置，导出检索、耗时与调用日志，修复重大缺陷	支持实验结果导入/展示，完成跨浏览器回归测试	主导 A/B/C 对照实验、人工评分、统计和案例分析	真实记录 LLM-only、关键词 RAG、混合检索 RAG 的正确性、可追溯性、响应时间和成本
阶段 7：软著材料与 V1.0 发布（11/12—11/14）	清理源码、依赖、配置与部署脚本；准备发布版本	整理页面截图、演示流程和前端构建产物说明	完成用户手册、软著材料初稿、实验与资料归档	代码、文档、截图和实际功能一致；经全员核验后创建 v1.0.0 标签

四、各成员持续工作清单

范涵宇

• 维护后端代码质量、数据库连接和接口文档。
• 每次 API 或数据库变更后，在 Issue 中给出请求示例、响应示例和启动/迁移方式。
• 保证关键词、向量、混合检索可独立调用，并保留检索日志。
• 管理服务端环境变量，绝不提交 .env、API Key 或数据库真实密码。

吉海燕

• 所有前端请求集中在 frontend/src/api.ts，不在页面中散落重复请求逻辑。
• 每个后端功能完成后进行浏览器联调，记录成功、异常和空数据状态。
• 为知识管理、问答来源、实验页面保留可用于软著的清晰截图。
• 每次页面改动在合并请求中说明访问路径、测试步骤和截图。

杨星萱

• 建立资料来源台账，至少记录来源名称、URL、获取日期、类别、真实性判断和核验人。
• 制定“可入库/待核验/不采用”的审核规则；不确定的资料保持待核验。
• 建立测试问题集和人工评分表，实验结果必须能回溯到测试问题、检索日志和评分记录。
• 维护项目说明、用户手册、软著材料和论文实验素材，确保表述不超出系统实际功能。

五、完成判定

一个任务只有同时满足以下条件才能标记完成：

1. 代码或资料已进入相应分支，并有可追溯的提交和 Issue。
2. 有明确的验收步骤、测试结果或可核验资料。
3. 公共接口、文档和任务状态已同步更新。
4. 无真实密钥、个人隐私数据和未经授权的材料。
5. 合并请求通过非作者审查并合入 dev；阶段验收后再合入 main。