海底小纵队第二次团队作业——原型设计+概要设计
https://github.com/LS-XH/TeamProject/blob/main/docs/design/blog.md
海底小纵队第二次团队作业——原型设计+概要设计
| 作业所属课程 | 计科24级56班 |
|---|---|
| 作业要求 | https://edu.cnblogs.com/campus/gdgy/Class56-Grade2024-CS/homework/16784 |
| 作业的目标 | 基于课题搭子第一阶段需求,明确前后台交互、系统结构和数据约束,为分工实现与验收提供设计基线 |
| 团队名称 | 海底小纵队 |
| 团队成员学号-名字 | 3124004171-李文争、3124004162-邓子豪、3124004169-黄琪 |
一、原型设计
课题搭子面向有课程交付任务的小组。当前可运行版本支持浏览器本机保存、计划生成和交付体检,这次原型补充了计划确认、共享版本和后台归档的交互。使用 draw.io 的交互页面与跳转链接制作了八个设计画板。前台演示组长的交付流程,后台演示管理员的归档流程。团队成员和项目内容均使用示例数据。
1. 前台工作台
| 画板 | 用户操作与反馈 | 实现时遵循的规则 |
|---|---|---|
| 项目总览 | 粘贴作业要求,选择分析方式,点击「生成预览」 | 校验正文长度。规则模式可直接使用,智能体模式需提供密钥并提示正文将转发给模型服务 |
| 需求核对 | 查看需求 R001 的原文和验收条件,点击「保存并安排任务」 | 生成先进入预览,经人工确认才保存。引用无法在原文定位时提示错误,保留原计划 |
| 任务安排 | 查看 T001 关联的需求编号、负责人、任务状态和证据,点击「运行交付体检」 | 每项任务关联当前版本中的一条需求。负责人只能来自当前项目。完成状态允许先保存,缺证据由体检提示 |
| 交付体检 | 定位「缺少交付证据」提示,点击「填写示例证据」 | 提醒附带任务编号,便于回到任务处理。删除某需求唯一关联任务后,应提示该需求无任务 |
| 证据已补齐 | 查看完成率变化,核对证据,可返回总览 | 有证据的完成率依赖任务状态和证据字段。验收人还需打开链接确认交付物 |
演示选用「应用须公开上线」作为主线。T001 已安排且标为完成,证据为空时,任务覆盖率为100%,有证据的完成率为0%。补齐示例链接后,后者升至100%。两个指标分别回答「要求是否有任务」和「完成的任务是否留下证据」。
2. 后台管理
| 画板 | 用户操作与反馈 | 实现时遵循的规则 |
|---|---|---|
| 项目管理 | 查看项目名称、成员数和当前状态,点击「查看归档确认」 | 平台管理员可访问;列表只显示管理所需的项目元数据 |
| 归档确认 | 阅读只读影响,确认归档或取消返回 | 取消时不改变项目状态。确认时服务端再次检查权限、状态与修订号 |
| 操作日志 | 查看归档成功状态、操作人和事件,点击「模拟恢复」 | 归档保留历史及导出权限,禁止生成和编辑。恢复后解除只读,两种成功操作均记录审计事件 |
左栏可切换前后台,主体区按「页面标题、当前对象、状态提示、主操作」组织。强调色标记下一步,归档确认独立成页。八个画板使用示例数据模拟界面状态和按钮跳转。共享数据库、后台权限和日志写入属于系统设计。
二、系统概要设计
设计参照 GB/T 8567—2006 第7.13节与第7.14节。以下用统一建模语言(UML)描述角色、流程、对象和调用关系。现有工作台支持本机计划与体检,共享项目管理和归档是本阶段确定的实现方案。
1. 分层架构与模块职责
| 层次 | 组件 | 责任与交接 |
|---|---|---|
| 表示层 | 学生工作台、管理控制台 | 提交参数、展示预览与错误、确认写入和归档,向应用层传递当前修订号 |
| 应用层 | 计划、任务、管理接口 | 校验输入、成员身份、项目状态和操作权限。将生成、保存、编辑和归档交给对应服务 |
| 领域层 | 需求提取、计划、体检、归档服务 | 统一处理规则和模型输出,核对逐字引用,计算体检指标并约束状态迁移 |
| 数据层 | 项目、计划与审计仓储 | 按项目与版本读取对象,在事务内完成写入,维护关系约束与审计记录 |
权限分为项目成员权限与平台管理权限。组长生成计划和安排任务,编辑者维护任务与交付证据,查看者可浏览和导出。归档和恢复由平台管理员执行。项目归档后,无论是前台交互还是直接请求服务端接口,都应拒绝新增版本和修改任务。
2. 关键流程与异常处理
- 生成预览。 工作台发送原文和分析方式。规则模式拆分条目,智能体模式由服务端向固定模型服务请求结构化条目。应用检查字段、优先级和逐字引用,生成需求编号和初始任务。超时或结果无效时返回原因,保留已有计划。
- 保存与编辑。 用户确认预览后提交预期修订号。共享版本服务在同一事务中检查权限、归档状态和修订号,再写入原文、需求和关联任务。若有人先一步保存,服务端返回冲突,客户端重新读取后再提交。任务编辑也遵循相同的修订规则。
- 运行体检。 读取同一项目同一版本的需求与任务。对缺任务、未分配负责人、晚于项目截止日期、完成无证据分别提示。必做需求有任务即计入覆盖率;只有其关联任务全部完成并填写证据,才计入有证据的完成率。
- 归档恢复。 管理接口验证平台权限后更新项目状态,并在同一事务追加审计记录。写入失败一起回滚。重复或冲突的归档请求不应重复产生成功记录。
3. UML 图与验收切入点
| 图 | 设计要点 |
|---|---|
| 用例图 | 区分组长、编辑者、查看者和平台管理员 |
| 活动图 | 输入无效或引用错误时保留原计划,生成成功后须人工确认 |
| 类图 | 以项目管理原文版本,需求连接任务,审查服务负责计算指标 |
| 时序图 | 模型请求与计划持久化分离,保存时核验修订号并处理冲突 |
| 协作图 | 归档服务先核验权限,归档与审计在同一事务内完成 |

时序图用于联调生成和保存:先获得预览,用户再确认写入。用例图和协作图用于验证普通成员无法执行归档。活动图与类图可用于检查失败后原计划是否仍可读,以及体检是否混用了不同版本的任务。
三、数据库设计
拟采用 SQLite 兼容关系模式。项目与账户通过成员表关联。每份原文和提取后的需求都归属特定版本,任务通过项目、版本和需求编号的组合外键联系需求,防止串项目。负责人必须属于同项目。覆盖率实时计算,模型密钥不保存。实体类与库表映射、数据字典、索引、备份与恢复策略见数据库说明书。

四、开发计划与团队协作
本次设计阶段已交付八屏交互原型、两份说明书、五类系统设计图、实体联系图和建表脚本。原型已验证前后台主要跳转,建表脚本已在 SQLite 环境执行。下一阶段从11月23日开始,按周验收和交接。
| 周期 | 里程碑 | 可检查产出 |
|---|---|---|
| 11月23日—11月29日 | 冻结设计与接口口径 | 前后台原型评审意见、关系模型和接口样例 |
| 11月30日—12月6日 | 打通共享版本流程 | 项目成员权限、计划保存接口、原文及任务版本联调记录 |
| 12月7日—12月13日 | 验证功能和管理流程 | 缺任务与缺证据演示、归档恢复和操作记录、并发冲突用例 |
| 12月14日—12月20日 | 完成联调与演练 | 访问权限和数据恢复测试、演示网址、最终验收清单 |
| 成员 | 角色 | 负责开发及交接 |
|---|---|---|
| 李文争 | 智能体与接口 | 需求结构化提取、引用校验、保存接口契约、失败场景联调 |
| 邓子豪 | 前端开发 | 计划确认、任务与体检页面、后台列表与归档交互、移动端适配 |
| 黄琪 | 数据与测试 | 数据库迁移和测试数据、权限与并发验收、文档和发布联查 |
第一周由李文争整理接口样例,邓子豪核对页面与交互状态,黄琪核对表结构和验收用例。第二周由李文争主责保存接口,邓子豪接入计划确认页,黄琪提供迁移脚本和联调数据。第三周由邓子豪接入任务体检和归档界面,李文争对接权限及错误响应,黄琪检查并发冲突和审计记录。第四周由黄琪汇总验收结果,李文争处理接口问题,邓子豪完成浏览器演示检查。
对应修改提交到团队仓库,以代码、用例与审查意见作为协作记录。设计阶段的交付件在文末集中索引。
浙公网安备 33010602011771号