鹦伟达——Alpha冲刺总结
鹦伟达-冲刺总结
| 这个作业属于哪个课程 | 202601 软件工程与软件工程实践 |
|---|---|
| 这个作业要求在哪里 | 团队第三次作业:Alpha 冲刺 |
| 团队名称 | 鹦伟达 |
| 团队成员-学号 | 102401608-魏之皓(组长)、162404103-蔡信坡、102401312-刘谦益 102401318-陈常群、042402115-张锦昊、102401215-李义东 102401137-佘博海、102401310-庄凯堃、102401609-王智钦 162404109-杜玉鹤、102401135-何慧渊 |
| 这个作业的目标 | 对照冲刺计划总结 OfferPilot 推免事项核心流程的实现与验收进展,记录项目亮点、待改进项、成员体会和工作量。 |
OfferPilot · Alpha 冲刺第 6 天
计划周期为 2026 年 11 月 16 日至 29 日,本文记录截至 11 月 21 日的进展。
上一阶段,我们用原型走了一遍推免申请流程。到了 Alpha,团队选定一份真实的学院通知,试着回答三个问题:学生能否找到每条要求的原文?信息缺失时,页面能否说清楚该补什么?学生确认之后,候选计划能否变成重新打开页面也能看到的任务?
阶段结论 冲刺改进已部分实现。建项、通知读取、出处核对和候选计划审阅已可运行,正式任务页与真实模型的完整浏览器流程仍在验收。
目录
一、交付与验收
对照冲刺目标
| 冲刺计划中的改进 | 阶段结果 |
|---|---|
| 新建事项与个人工作区 | 已合入。 事项列表、新建表单、工作区概览和导航已接通,创建后可读回同一事项。PR #43 |
| 读取通知与审阅候选计划 | 已合入。 支持公开 HTML 通知读取、来源快照、Agent 自查和候选计划审阅。一次真实模型联调写入了 22 条自查结果、13 条候选计划条目,刷新和重启后可读回。PR #37 · PR #47 · 联调记录 |
| 补录排名并重新自查 | 修复已合入,完整流程待复验。 重新自查请求已能返回,刷新后可读回运行结果。候选计划保存和补录后的新结论仍需验证。PR #51 · 浏览器复测 |
| 确认或拒绝候选计划 | 后端已验证,任务页待审。 确认后生成任务,拒绝后保留原任务列表,重复确认时防重。未来期限的测试样例已验证任务生成和刷新读回。PR #41 · Issue #34 · PR #53 |
验收结果
在主分支 3ea5fd9 上,已通过 6/6 项 Alpha 后端验收、110/110 项后端测试、14/14 项数据库结构测试。真实模型下的完整浏览器流程待复验。验收记录
项目亮点
- 政策依据能回看原文。 以福州大学数学与统计学院的推免通知为例,用户可以核对材料要求来自哪份通知、适用于谁,以及原文在哪一段。校内预报名和教育部系统正式报名也分别核对。规则与评估样例
- 缺少信息时告诉用户补什么。 如果当前信息不足以判断某项条件,自查结果会同时展示缺项、判断原因和依据,帮助用户决定下一步要补录排名,还是去核对通知。来源与自查界面
- 候选计划经用户确认后才生成任务。 系统保留候选计划的来源和版本。如果确认前依据已经更新,旧候选会失效,用户需要重新核对。候选决定接口
目前不足
- 真实模型的候选计划保存仍有阻塞。 前端等待时限修复后,新一次请求约 129 秒成功返回,刷新后可读回运行结果。复测也发现,同一候选条目引用两次同一处原文会导致候选计划保存失败。重复引用的修复已提交审查。下一轮要在同一版本中复跑排名补录、重新自查、审阅候选、确认生成任务和刷新读回。复测记录 · 修复 PR #54
- Alpha 的场景覆盖有限。 当前验证集中在一个校内推免示例和约定的公开 HTML 通知。复杂附件解析、多院校多批次规则覆盖,以及完整账户体系,仍需后续开发和验证。Alpha 范围与验收基线
二、冲刺计划
冲刺前,我们已有需求说明和可操作原型,事项上下文、排名状态和通知更新后的处理仍需接到真实数据上。
- 前半程 对齐接口,做出首批模块并跑通第一次联调。
- 后半程 补齐任务状态,核对异常场景,集中完成端到端验收与缺陷回归。
冲刺计划博客 《鹦伟达-冲刺计划》
三、团队协作与复盘
启动站会 应到 11 人,实到 11 人。
排名补录联调
- 复现。 验收同学发现「排名保存成功,页面还是没有新结果」。对照浏览器请求和后端日志后,团队定位到保存状态拦住了重新自查。排名补录复现记录
- 修复。 后续联调发现浏览器会在模型返回前结束请求。前端调整等待时限后,运行结果能在页面显示,刷新后也可读回。等待时限定位 · 新一轮复测
- 继续验收。 检查候选计划时,团队又发现重复来源引用会导致保存失败,并单独提交修复。修复 PR #54
下一轮怎么改 联调前对齐前端、后端和数据库版本,约定同一份通知和排名样例。每次修复后沿同一路径复测,依次检查排名保存、自查请求、新结论、候选确认和正式任务读回。
四、成员过程体会
项目协调与交互设计
魏之皓
合理划分任务范围、协调组员协作很有挑战。流程卡住,或组员对当前阶段的任务不明确时,PM 需要及时了解情况,协调处理。我体会到,除了持续跟进项目进度,用好 GitHub 的协作功能也很重要。
刘谦益
梳理候选计划时,我发现原型里的「待确认」关系到任务何时创建。用户回到工作区时,待确认的计划应保留,任务列表保持原样。确认并写入成功后,页面才显示新任务。和开发交接时,我要把状态的触发条件、数据变化和页面反馈一起说清楚。
Agent、模型与来源
王智钦
这次团队协作让我最深的体会是,接口契约要在编码前对齐。开发 Agent 时,我们通过状态机、幂等处理和引用校验约束运行行为,再用代码评审和自动化测试检验这些约束。我也体会到如何把「能跑的 Demo」打磨成可控、可信的工程系统。
庄凯堃
我负责模型服务适配、环境配置读取和请求响应校验,完成了真实模型调用及异常场景验证。和 Agent 编排模块对齐调用方式时,我体会到,接口可用还需要清晰的错误分类、稳定的数据结构和完整的配置说明。下次我会更早确认接口契约和异常场景。
杜玉鹤
验证「来源换版后禁止确认」时,我在测试库登记了新版快照,再用旧候选发起确认。请求被拒绝,旧候选变为已失效,正式任务新增 0 条。这次验证让我意识到,写验收样例时要同时明确预期的接口响应和数据库最终状态。
蔡信坡
保留通知快照和原文位置,队友才能复核引用。代码评审也让我学会把改动集中在自己负责的模块,把联调字段交接清楚。
前后端开发与验收
陈常群
我负责事项工作区和前端集成。对照 Figma 核对页面时,我发现用户能否看懂当前状态、知道下一步做什么,和页面布局同样重要。联调时,我们用独立的 PostgreSQL 测试库验证了创建、列表、概览和刷新都能读回同一事项。
断网时,提交结果可能不明确,页面应保留输入,让用户先到列表核对,避免重复创建。下次我会更早与队友确认原型版本、接口字段、异常状态和验收用例。
张锦昊
做来源与条件页面、候选计划审阅时,我体会到,前端需要和后端、Agent 提前对齐接口与业务规则,才能减少返工。页面接通后,还要通过实际联调核对数据能否保存、结果能否在刷新后恢复。
李义东
这次开发最费力的是协调模块之间的交互。在和其他负责人对接时,我们逐步发现原有设计的不足,再一起明确各模块提供的功能和边界。比如 facts/ 下的 fact_type,就是在多轮沟通中逐步对齐的。
佘博海
契约补充候选计划项、计划决定和来源关联后,我在未合并的分支上重写了 0005、新增了 0008。8 个迁移在空库跑了两遍,第二遍全部跳过。刻意修改已执行的文件后,程序因校验和不一致退出。
测试行级安全策略(RLS)时,我也换成了非表所有者角色,因为表所有者会绕过策略。这让我把换环境、换角色和重复执行都纳入迁移验收。
何慧渊
这次验收让我体会到,测试要从需求、契约和环境准备时就介入。即使 CI 已通过,仍要用真实数据库和真实接口跑一遍,才能发现集成问题。记录结果时,我会逐项写清哪些通过、哪些失败、哪些尚未测试。
五、成员完成内容与工作量
工作量比例按 11 月 16 日至 21 日的阶段交付估算,综合提交数、活跃天数和代码改动量,并给设计、协调和人工验收等工作保留基础份额。
| 成员 | 本阶段完成的内容 | 工作量比例 |
|---|---|---|
| 魏之皓 | 明确 Alpha 的功能范围和数据契约,整理 14 条验收场景并跟进联调。PR #36 | 5% |
| 刘谦益 | 完成 Alpha 核心流程的原型与状态说明,补充来源展示、确认、拒绝和过期反馈。PR #40 | 5% |
| 王智钦 | 实现 Agent 来源分析、条件自查与候选计划生成,补充原文定位校验并修复任务依赖引用。PR #23 · PR #49 · PR #52 | 13% |
| 庄凯堃 | 验证 DeepSeek 结构化调用、超时和异常响应,参与模型接入联调。基础适配器随业务后端合入。PR #38 · PR #41 | 7% |
| 杜玉鹤 | 整理 3 份公开通知和 2 个附件,提交 11 条推免规则、39 个领域用例和 6 组候选决定用例。PR #24 | 7% |
| 陈常群 | 搭建个人事项工作区,完成新建、列表和概览。提交正式任务页及其与 Agent 结果的联调改动。PR #43 · PR #53 | 10% |
| 张锦昊 | 实现来源、条件和候选计划审阅页面,接入排名补录与模型传输授权,修复重新自查触发与等待超时。PR #47 · PR #51 | 11% |
| 李义东 | 实现事项、来源快照、候选计划确认或拒绝、任务读取等业务接口,处理重复确认和依据过期。PR #41 | 16% |
| 佘博海 | 完成首版数据库表结构、8 个版本化迁移、种子数据和数据库集成测试。PR #39 | 9% |
| 何慧渊 | 编写 6 项 API 验收测试,维护验收记录,跟进真实模型联调和浏览器复测。PR #42 · Issue #34 | 8% |
| 蔡信坡 | 实现公开 HTML 通知读取、出处定位和结构化错误反馈,接通来源登记与 Agent 输入的数据转换。PR #37 | 9% |
| 合计 | 100% |
六、项目仓库与展示材料
| 材料 | 查看入口 |
|---|---|
| 团队项目仓库 | LotteryCamp/OfferPilot |
| Alpha 版本 | GitHub Release v0.1.0 |
| 冲刺 Vlog | 鹦伟达vlog.mp4(百度网盘) · 提取码 n73j |

浙公网安备 33010602011771号