202601福大-软件工程实践-W班
耍起最队——凡事预则立博客
墨衍会员 · AI 创作全网分发 墨衍智能分发 通过墨衍一键同步至各平台 可同步平台 CSDN微信公众号微博知乎掘金百家号博客园抖音小红书 你的文章也可以这样分发 墨衍会员 ¥399起/年，写一次发全网
我也要 关注 + 加入社区耍起最队｜StudyDay Beta 冲刺「凡事预则立」随笔
| 项目 | 内容 |
|---|---|
| 这个作业属于哪个课程 | 202601福大—软件工程实践—W班 |
| 这个作业要求在哪里 | Beta 阶段团队作业 |
| 这个作业的目标 | 根据 Alpha 阶段问题复盘，确定 Beta 的功能范围、成员分工、工具流程及七天交付计划 |
| 团队名称 | 耍起最队 |
| 项目名称 | StudyDay 智能学习日用 App |
| 项目仓库 | StudyDay 代码仓库 |
| 参考材料 | 本组 Alpha 阶段问题总结、Alpha 冲刺总结、测试随笔、团队代码规范 |
Alpha 已经演示过两条操作流程，一条从课表进入任务与专注，另一条把已保存的 AI 回答整理成笔记。但直到第六天，我们还在处理表单数据格式和问答返回协议。单元测试和本地演示验证了一部分规则，真实数据库并发、华为云运行和独立试用仍需要补做。Beta 计划在前两次联调中接上真实服务，把回归和试用安排在交付前，并新增一个能用已有数据验收的学习统计页面。
目录
- 耍起最队｜StudyDay Beta 冲刺「凡事预则立」随笔
- 一、完善什么，新增什么
- 1. 优先完善 Alpha 已有功能
- 2. 新增学习统计页
- 二、8 人分工及验收搭档
- 三、工具和工作流程
- 四、七天冲刺时间安排
- 每天由谁推进
- 五、随笔与交付材料安排
一、完善什么，新增什么
1. 优先完善 Alpha 已有功能
| 编号 | Alpha 暴露的问题 | Beta 要做的事 | 验收方式 |
|---|---|---|---|
| B01 课表与任务 | 前几天的课表截图使用模拟数据。实际联调还调整了表单字段、任务筛选与课程分页。 | 用真实测试账号串通登录、课表、课程详情、两类任务和任务列表。统一空列表、请求失败和登录失效的反馈。 | 创建课程及任务后刷新仍可读取。学习任务可关联本人课程，也可不选课程。生活任务带课程、学习任务引用他人课程时，接口拒绝且不写入。筛选和分页返回与预置数据一致。 |
| B02 专注与历史 | Alpha 有一次提前结束的演示和规则单测，双请求开始和重试仍需在真实库验证。 | 核对刷新恢复、提前结束、重复结束及历史快照。根据真实库测试结果修复异常。 | 同账号两次并行开始后，库中最多一条运行记录。刷新恢复同一个 focusId。重复结束返回首次结果，任务状态仍由用户另行确认。修改任务标题后，历史保留开始时的标题。 |
| B03 AI 问答与笔记 | JSON/SSE 的差异曾阻断转笔记。生成失败、保存失败、取消预览和重复确认需要分开验证。 | 保留 saved 后才开放转笔记的规则，完善失败提示、输入保留及重试。核对笔记、初始版本和来源摘录。 | 真实模型至少验证一条问答与转笔记流程。用可控故障分别检查生成失败和保存失败。取消预览无新增，重复确认只生成一份笔记。初始版本写入失败时，检查正式笔记是否一同回滚。 |
| B04 部署与试用 | Alpha 的交付环境主要是本地 Compose，缺少华为云验收和组外试用记录。 | 开工时准备云主机、入口配置和测试数据，用同一候选版本做浏览器回归和独立试用。 | 从另一设备通过 HTTPS 登录并跑通两条流程。核对 /api、SSE 和数据卷，重启后查询先前保存的记录。邀请未参与开发的同学按场景独立操作，记录阻塞和反馈。 |
2. 新增学习统计页
B05 学习统计计划复用 Alpha 后端已有的 GET /api/stats/overview，在前端增加「今日 / 本周」切换。页面展示本期创建的任务数及其中已完成的数量、已结束专注的总时长和新建笔记数，并提供加载、无记录和读取失败提示。统计范围在页面上明确标出，专注时长由接口的秒数换算展示。
验收使用两套测试账号和固定数据，手算一份今日与本周的预期值，再与接口及页面核对。测试包含无数据、跨午夜或周一边界，以及切换账号后只显示本人的统计。任务数按本期创建时间计入，专注按结束时间计入。 Alpha 冲刺总结
B06 任务编辑与软删除入口列为备选，复用已有后端接口。Day 4 评估时，两条主流程和统计需先通过首轮联调，并且当天还留得出接入和复测的时间。验收检查旧版本更新冲突、运行专注时无法删除任务，以及软删除后专注历史仍可查询。完整笔记编辑与版本恢复、提醒、Redis 和跨会话记忆放入后续清单。
二、8 人分工及验收搭档
沿用 Alpha 的模块分工，两条流程各设一位联调负责人。杨伟烨负责组织「登录 → 课表 → 任务 → 专注 → 历史」联调，赵子龙负责组织「AI 问答 → 保存 → 预览 → 笔记」联调。联调负责人汇总跨模块问题和复测结果，具体实现由各模块成员完成。郑宇澄从接口样例评审开始参与，并在同一候选版本上执行验收。
| 成员 | Beta 职责 | 主要对接与交付 |
|---|---|---|
| 柯镇海 | 项目负责人。维护范围、优先级、工作项、合并及发布，组织试用与答辩。 | 与各模块负责人确认计划。每天更新剩余任务，维护集合随笔，交付候选版本和验收记录。 |
| 胡加乘 | 后端负责人。维护认证、课表及公共接口，负责 Compose 和华为云部署。 | 与黄思杨核对认证、课表和代理。与范敬翔、郑宇澄检查测试库、启动脚本及重启恢复。 |
| 杨伟烨 | 前端负责人。牵头任务与专注流程，完善分类、计时恢复、重试和历史反馈。 | 与范敬翔核对同一专注记录及结算规则。与黄思杨确认课程进入任务的入口。 |
| 赵子龙 | AI 与笔记前端。牵头问答转笔记流程，完善生成、保存、预览及异常提示。 | 与黄思哲确认 SSE 样例和失败状态。与郑宇澄核对取消、确认及重复操作。 |
| 黄思杨 | 公共前端、登录与课表，负责学习统计页及生产构建。 | 与胡加乘核对登录和代理，与范敬翔核对统计口径。负责窄屏页面与另一设备访问检查。 |
| 范敬翔 | 数据库、任务与专注后端，维护测试数据及统计口径。 | 与杨伟烨处理任务和专注问题。与郑宇澄在 MySQL 测试库验证并发、重试及数据隔离。 |
| 黄思哲 | AI 与会话后端，维护模型调用、SSE 及笔记来源校验。 | 与赵子龙处理状态衔接。与郑宇澄分别验证真实模型调用、故障注入和笔记写入结果。 |
| 郑宇澄 | 测试与质量记录，负责回归、试用记录和缺陷复核。 | 与各模块确认预期，保留版本、环境、请求、页面及数据结果，整理用户调查报告。 |
站会优先说清楚阻塞的是哪条流程、需要谁配合、何时再测。比如 AI 接口改动后，由黄思哲提供真实响应或测试样例，赵子龙核对按钮状态，郑宇澄执行失败和重试用例。验收结果统一回填原工作项。
三、工具和工作流程
| 环节 | Beta 的执行方式 | 留存记录 |
|---|---|---|
| CodeArts 工作项与站会 | 开工前给 B01–B05 拆出可验收的工作项，登记负责人、对接人、依赖和预期结果。每日站会后更新待处理、进行中、待验收、已验收或阻塞状态。 | 工作项链接、当日验收结果、阻塞说明、后续安排。 |
| Git 与 MR | 继续用 main 保留稳定版本，develop 做日常集成，功能和修复分支关联工作项。MR 写清影响、验证方式和前置合并依赖，由至少一名非作者复核。公共接口邀请调用方共同复核。 | Issue、提交 SHA、MR、候选和最终标签。合并冲突由相关作者共同处理并复跑受影响场景。 |
| 接口契约与代码规范 | 维护 Apifox 或仓库中的请求响应样例。对 multipart 字段、taskType、分页和 SSE 保留现成回归。改字段时同步修改调用方、文档和用例。 | 请求格式、事件顺序、错误码、文档差异及检查输出。后端执行 gofmt、go vet 和相关 Go 测试，前端执行测试和生产构建。 |
| 自动化与真实环境测试 | 用 Go testing、httptest 和前端 node:test 检查规则与协议，复用 regression.sh 做接口回归。给两条主流程各补一条浏览器冒烟脚本。用独立 MySQL 测试库跑并发、重试及事务用例。 | 标明是单元、夹具、真实库还是浏览器结果。每次记录版本、环境、测试数据、预期、实际和未执行项。保留后端 make test、前端 pnpm test 与 pnpm build 的相关输出。 |
| AI 辅助测试 | 给 AI 脱敏的接口约定和业务规则，请它整理边界组合、构造样例或草拟脚本。开发和测试共同核对预期，实际运行后保留可重跑用例。 | 记录采用的建议、对应工作项和实际结果。使用合成账号及数据，密钥和个人内容留在受控环境。 |
| 部署与回滚 | 复用 demo-preflight.sh 和 Compose。华为云先检查服务器、访问入口、配置挂载和数据库卷，再部署固定标签。变更前保留上一个可用版本及必要的数据备份。 | 部署版本、配置说明、HTTPS 和跨设备运行结果、重启验证、回滚步骤。 |
燃尽图按未验收的冲刺工作项计数。 D1 由柯镇海和成员确认基线。已提交或已合并的工作项在验收前继续计入剩余量。每日登记新增、重开、移出和通过验收的数量，说明变更原因。每日剩余量按「前一日剩余 + 新增 + 重开 − 移出 − 当日验收」计算。理想线按开工基线绘制，实际线用每日记录更新。
四、七天冲刺时间安排
按实际开工日起连续七天记录。Day 1 至 Day 3 处理共用准备和两条流程的首轮联调。Day 4 核对剩余量并冻结新增范围。Day 5 至 Day 7 主要做候选版本验收、试用、修复和交付。现有 Alpha 归档以 999098fe 和前端 0.5.2 为回顾基线，开工时以团队实际选定的仓库版本为准，并在工作项里记下完整提交号。
| 天数 | 工作重点 | 当天要留下的验收结果 |
|---|---|---|
| Day 1 | 固定 Alpha 基线和 Beta 分支，拆工作项，确定接口样例、两套测试账号及云端依赖，约好试用时间。 | 至少一名非搭建者能按说明启动服务。两条流程的验收清单、测试数据与工作项基线可查。 |
| Day 2 | 用真实 MySQL 首轮联调课表、任务和专注。准备统计接口的固定响应和边界数据。 | 创建并刷新读取任务，走一次专注结算。记录两类任务和课程归属的合法与非法结果。 |
| Day 3 | 联调 AI 问答到笔记，接学习统计页，开始并发与去重检查。 | 留一条问答保存后确认笔记的记录，检查一次可控故障。统计首版可读取实际接口。 |
| Day 4 | 集中修复数据与协议问题，补回归和云端预检。评估备选需求并冻结范围。 | 核对并发开始、重复结束、重复转笔记及统计口径。记录仍阻塞的项和复测时间。 |
| Day 5 | 固定候选版本，在华为云和另一设备跑两条流程，开始独立用户试用。 | 留下部署与重启结果、页面截图和候选标签。试用者卡住的步骤转为缺陷工作项。 |
| Day 6 | 优先修阻断试用的问题，复跑浏览器冒烟和统计检查，整理用户调查。 | 每条已修问题有复测记录。保留试用任务的完成情况、问题分类与采纳决定。 |
| Day 7 | 最终验收、打标签和交接。整理运行入口、七天证据、总结及答辩材料。 | 最终版按范围逐项标注完成、部分完成或未完成，附可复现的运行说明和验收依据。 |
每天由谁推进
| 天数 | 柯镇海 | 胡加乘 | 范敬翔 | 黄思哲 |
|---|---|---|---|---|
| D1 | 确认范围、建工作项和基线 | 复现 Compose，确认云主机和域名条件 | 初始化测试库和两账号数据 | 确认模型配置、SSE 与故障样例 |
| D2 | 跟进任务流程阻塞和依赖 | 联调认证、课表及 multipart | 验证课程归属和专注正常结算 | 用现有会话接口核对真实模型最小调用 |
| D3 | 主持问答流程验收 | 协助排查公共响应及环境 | 跑同账号并发开始，核对统计样例 | 联调生成、保存、重试及笔记来源 |
| D4 | 冻结新增范围，安排未过用例 | 做云端预检与部署准备 | 复核重复结算及历史快照 | 核对重复转存和版本写入失败回滚 |
| D5 | 固定候选版本、组织试用 | 部署云端并检查重启恢复 | 对比重启前后记录和统计 | 核对云上模型调用及 SSE 事件 |
| D6 | 依据试用结果排序缺陷 | 修复部署或公共接口阻塞 | 修复数据一致性问题并复测 | 修复问答或笔记保存异常 |
| D7 | 确认最终标签、汇总交付 | 更新部署和回滚说明 | 归档测试库结果、清理说明 | 归档模型配置及故障验证说明 |
| 天数 | 杨伟烨 | 赵子龙 | 黄思杨 | 郑宇澄 |
|---|---|---|---|---|
| D1 | 拆任务、专注页面状态用例 | 核对问答与笔记的页面状态 | 核对生产构建及统计入口 | 整理验收清单、试用场景和冒烟脚本骨架 |
| D2 | 联调两类任务、刷新及历史 | 检查保存前按钮和输入保留 | 联调登录、课表及课程带入 | 执行任务流程冒烟，保留操作与断言 |
| D3 | 检查计时恢复及重复操作 | 联调 saved、预览、取消和确认 | 接统计接口及今日、本周切换 | 执行问答冒烟，与后端核对并发和故障结果 |
| D4 | 修复专注状态问题，确认备选是否接入 | 补生成与保存失败提示、确认防重 | 补统计空态、错误态及窄屏检查 | 用两条浏览器冒烟脚本复测修复版 |
| D5 | 验云端任务专注并收集操作障碍 | 验云端转笔记、刷新与提示 | 核对代理、统计及另一设备访问 | 记录试用任务及候选回归结果 |
| D6 | 修复任务专注试用问题 | 修复聊天和笔记试用问题 | 修复课表、统计与布局问题 | 汇总调查结果、复测已修问题 |
| D7 | 交任务与专注演示材料 | 交问答转笔记演示材料 | 交统计、构建和访问入口材料 | 归档最终验收报告及未通过项 |
若云主机、域名或模型额度影响试用，当天登记阻塞和负责跟进的成员，并用同一候选版本的本地 Compose 继续回归与演示。真实模型和云端项目保留实际状态。Day 4 若主流程仍有阻塞，预留工时先用于修复和复测，备选功能顺延。
Day 7 发布前，用同一候选版本核对两条主流程及学习统计。无法登录、主流程中断、跨账号读取数据、重复写入和数据丢失列为阻塞。工作项关闭时附上操作步骤、接口响应或数据结果。当天仍未解决的问题在交付说明中记录影响、复现条件和后续负责人，并据此确定可发布范围。
五、随笔与交付材料安排
| 随笔 | 计划整理时点 | 主要内容与负责方式 |
|---|---|---|
| Beta 置顶集合随笔 | 开工前建立，发布一篇更新一条 | 柯镇海维护索引，按阶段收录已发布链接。 |
| 换组交接随笔 | 冲刺前整理 | 柯镇海协调，胡加乘和模块成员补仓库、启动、数据、测试与未结事项，按实际交接情况记录。 |
| Alpha 阶段问题总结随笔 | 冲刺前归档 | 收录本组已编写的 Alpha 复盘，Beta 总结时逐项对照复盘提出的改进。 |
| 「凡事预则立」随笔 | 冲刺前发布 | 确认本篇的功能范围、八人职责、七天安排和验收标准，加入集合随笔。 |
| Beta 代码规范 | 开工前确认，过程中补修订 | 胡加乘、杨伟烨、郑宇澄分别核对后端、前端及测试部分，记录对既有规范的调整。 |
| Day 1–Day 7 冲刺随笔（七篇） | 每天站会后整理 | 站会部分由八名成员填进展、投入与剩余、阻塞和次日安排。开发附 Issue 与提交或 MR，测试和文档工作附实际产物。项目进度部分记录预期、已验收、剩余工作量及范围变化，并附当天会议照片、最新运行截图和实际燃尽图。 |
| 用户使用调查报告 | D1 定场景，D5 试用，D6 汇总 | 郑宇澄主笔，计划邀请 3–5 名未参与开发的同学，独立完成「建任务并留下一次专注」「把回答转成笔记」两项操作。报告按实际人数、完成情况、卡点和采纳结果撰写。 |
| Beta 冲刺总结随笔 | D7 验收后整理 | 柯镇海统稿，各成员补实际贡献和心得。对照 B01–B06 列完成情况，附运行入口、演示证据和延期原因。 |
