耍起最队——项目系统设计与数据库设计

目录

一、华为云仓库与文档链接

华为云团队仓库： BestplayTeam_Third_Teamwork

文档入口统一使用团队仓库，下表列出配套材料文件名，文件名均以团队名开头。系统和数据库说明书采用本次联审后的 V1.1 版本，答辩 PPT 同时准备可阅读的 PDF。

本次交付重点是设计文档、原型及答辩材料。下文的架构、接口和部署安排属于开发依据；原型模拟交互与数据库兼容性检查分别说明其验证范围。

二、系统与数据库设计

1. 体系结构与功能模块层次

StudyDay 首版采用单体分层应用，计划部署在华为云 ECS，使用 Docker Compose 组织 Nginx、app、MySQL、Redis 四个容器。前端通过后端接口访问个人资料，AI 服务由后端统一调用。

我们把强关联的业务放在同一数据源内处理。例如，父任务改类要同步子项和相关学习记录，计划确认要同时创建任务、提醒及成功结果，使用本地事务便于明确提交与回滚边界。各模块经 Service 协作，公共校验集中维护。模型建议转成正式任务、笔记或显式记忆前，需要用户确认；普通问答在完整生成、来源复核和持久化成功后自动保存。

功能划分为以下 8 个模块。F4 同时涉及 AI 学习助手和显式记忆，一个页面也可能组合多个模块的服务。

2. ER 分析与表结构

数据库按学习安排与执行、会话与笔记、显式记忆与成功请求分成三个关系视图，共用同一物理库 studyday。当前模型有 16 张表、164 个字段、77 项 CHECK、27 个外键。

表结构围绕以下规则确定：

关键表结构： 以下选取任务、专注、笔记和会话消息四张核心表，以“字段名—数据类型—约束—说明”展示关键字段，类型、可空性、默认值及主外键以数据库设计 V1.1 和配套 SQL 为准。完整字段字典与索引见数据库说明书。

图中 PK 表示主键，FK 表示外键，UK 表示唯一键。专注通过 (user_id,task_id) 联合外键引用任务；同用户引用、父子层级及资料资格等跨对象规则，还需由业务事务校验。

我们保留了三类有业务依据的冗余：专注快照保存当时的事实，笔记来源摘录便于原会话删除后核对，正文版本支持回看与恢复。课程或来源删除时，独立资料仍按各自生命周期保留。

配套 DDL 已在 MySQL 8.0.45 隔离库完成 46 项建表与约束兼容性验证，包括非法类别、重复运行计时、快照保留、幂等键、中文检索和固定统计样例。目标 MySQL 8.4 环境、应用层权限、跨模块事务、性能及恢复流程仍需在开发部署后验收。

3. 接口设计与关键流程

接口统一 /api 前缀、UTF-8 JSON、字符串形式的大整数 ID，以及带 +08:00 的 ISO 8601 时间。通用响应为 Result{code, message, data, requestId}；个人数据操作从认证上下文取得用户，不接受客户端指定归属。

前端在服务端提交成功后显示“已保存”。网络中断时先恢复原请求结果，再决定是否重试；已确认的业务结果不能因响应丢失而重复创建。

三、设计类图与系统安全、权限设计

1. 设计类图

设计类图在领域对象上补充运行职责、关键方法及依赖方向。任务部分将 Task 的共性与两类业务约束分开，专注保留独立标识和快照；实现中仍用一张 task 表和类型字段承接。

TaskService 维护父子、类别、状态和提醒；FocusService 经任务模块提供的只读接口读取任务，并负责开始和结束。Task 到 FocusSession 的共享聚合对应任务逻辑删除后保留专注历史，计划秒数与实际秒数属于专注属性。

AI 部分由 ChatService 组织上下文、摘要、提示词和模型调用。具体协议适配器实现 AiClient，ContextAssembler 只读取本次有效资料，PromptBuilder 控制输入预算。

普通问答默认当前会话和所选课程；生成学习计划时预选当天课表、相关学习待办和近 7 天学习专注摘要。跨会话自动取用长期资料受默认关闭的记忆开关控制，用户仍可为本次问答主动选择笔记等资料。旧消息、派生回答和摘要也要检查来源版本及本次选择，不能只在查询新资料时过滤。

2. 安全与权限

外键保证目标存在，授权还需验证用户归属及业务状态。模型生成放在数据库事务外，完整回答落库前在同一用户锁下重新检查会话、生成令牌和资料资格，再提交成功结果，避免资料已经撤回却仍写入有效回答。

四、改进分析

1. 上次需求分析作业的评审问题与改进

上次答辩后，我们围绕老师提出的三个问题重新核对需求、模型和原型，用 SRS V0.4 用例图扩充版统一规则。以下按评审记录整理问题原意，并说明修改内容、过程及仍需核验的部分。

（1）学习、生活任务创建后，是否只有两个分类选项？

我们把类别差异落实到后续操作和资料使用中：

例如，“复习高数定积分”可以关联高数课程，“预约校医院体检”不关联课程。两者分别专注 25 分钟和 10 分钟，总体投入为 35 分钟，AI 学习摘要只取 STUDY 快照的 25 分钟。结束专注不会自动完成任务。

父项改类别时，子项同步继承。学习改生活还要确认清空父子课程、解除知识点记录的任务引用，保留知识内容和原专注历史；操作对象或受影响子项正在计时时，整次变更拒绝。这些约束已同步到需求、类图、接口和数据库设计，后续按 A23—A28 场景验证。

（2）任务和专注是否绑定？是否需要任务特殊类，类图是否过于简单？

旧核心图使用具体 Task 和普通关联。新版将 Task 抽象为共性，StudyTask 与 LifeTask 互斥且完整地覆盖两类任务，只允许学习类关联课程；Task 端空心菱形表示共享聚合，多重性为 Task 1 对 FocusSession 0..*。

需要准确区分已有规则和本轮细化：旧需求已经规定每次专注必须选任务、任务逻辑删除保留历史、重复结束返回原结算。本轮重点补齐特化、共享聚合、开始快照和跨图约束。

专注拥有独立 focusId、userId、taskId、起止时间和结算状态，开始时固定任务标题和类别；任务后续改名改类不回写历史。计划时长与实际时长属于专注属性。任务累计只汇总自身已保存的 FINISHED 记录，不重复加子项。

下面两张数据流图采用分区视图：一级图分别展示各模块与存储的读写，以及模块间资料交换；二级图分别展开 P3.1—P3.4。重复出现的同编号节点仍是同一对象，便于在博客正文宽度内读清关系。

二级图分别表达 D3 任务与 D4 专注的读写，输入输出与一级 P3 保持平衡；AI 学习摘要和总体统计使用各自筛选口径。联审时逐项核对了请求和返回数据流，并同步检查图源与导出图，避免分解后出现遗漏。

为便于读图，P3 分解涉及的边界编号沿用需求书数据字典，含义如下。数据流箭头表示资料流向，执行时序另由泳道图说明。

我们用“计时 10 分钟后提前结束、保存失败、5 分钟后重试”走查设计：请求仍使用同一 focusId 和首次 endedAt，预期应结算 600 秒，等待保存时间不计入，记录只结算一次。这项检查同时约束页面提示、服务职责和数据库条件更新，真实接口效果在开发后验证。

（3）AI 快捷按钮应移到输入框下方

2026 年 10 月 21 日留存的在线原型截图中，“生成学习计划、查看记忆、我的笔记、待办”四个全局入口已位于输入框下方，发送按钮与输入框同排。单条回答旁的转笔记、计划和记忆动作继续指向对应回答，便于识别操作来源。

窄屏快捷行仍需横向滚动，后续会继续检查入口可发现性、输入法弹出和消息底部遮挡。上图说明留存时的布局状态，真实保存和 AI 调用仍由开发验收验证。

（4）改进过程和进一步补正

我们的处理顺序是：记录评审问题及场景 → 确认业务规则 → 同步模型、修订本地原型文案并列出待同步项 → 对照接口、数据设计和验收条件复查。

联审还发现，10 月 21 日留存的线上改类确认框仍把“知识点学习记录”写成“学习专注记录”，容易让人理解为改类会解除历史专注关联。以下本地修订示意明确了保留规则：解除的是 LearningRecord 的可选任务引用，历史专注继续关联原任务，名称、类别和实际秒数保持不变。

普通问答的资料范围卡也应只显示实际使用的当前会话、所选课程及本次勾选资料。该卡片和上图改类文案在既有材料中属于本地修订示意，仍需向线上原型同步，不能据此写成全部线上页面已修好。

本轮已经完成规则、模型及留存证据的对应整理。固定数据和模拟“已保存”只能展示交互；真实鉴权、事务、断网重试、统计和模型调用，继续按需求 A1—A28 验收。

2. 驱动 LLM 协助设计的三个示例

示例一：用数据库设计检查清单复核具体结构

输入任务： 说明课程、任务、专注、笔记和 AI 资料范围后，提问“对我们这种项目进行数据库设计，应该注意什么”。

输出与采用： LLM 提醒区分当前状态和历史事实，分别设计删除规则，并为并发、版本和重试提供存储支持。我们将这些建议落实为 focus 的独立归属和任务快照、运行唯一约束、note 对象版本与正文版本分开，以及操作级幂等键。

人工复核： 对照需求和系统设计确定保留范围；跨表、同用户及父子规则明确交给业务事务，未伪装成数据库 CHECK。配套 SQL 的 46 项隔离兼容性验证见第二部分，目标版本和业务验收另行执行。

示例二：用真实业务流程检查系统设计

输入任务： 提供项目背景后，提问“对我们这种项目进行系统设计，应该注意什么”。

输出与采用： LLM 建议检查任务类别差异、模块职责、生命周期、失败分支和关键一致性。我们选“任务改类”“专注结算”“AI 确认转存”三条流程，逐层核对需求、类关系、顺序或泳道、接口和事务。

人工复核： 保留普通回答自动保存与模型建议确认转存的区别；检查全部关联目标归属；开始专注与关键任务变更共用用户锁。设计图和文字同步修订，避免只加类名而没有对应行为。

示例三：成员使用 Claude Code 辅助系统设计初稿

初稿协作记录： 成员提供当时的 SRS V0.3、数据库与原型材料，让工具先整理大纲，再分章生成总体设计、模块、类、接口、安全和健壮性内容，人工逐章检查后统一格式。这里的 V0.3 和原稿章节划分属于初稿阶段；当前交付已按 SRS V0.4 修订为系统设计 V1.1。

LLM 用于提出候选方案、整理和查漏，是否采纳由需求及验收条件决定。本文不将生成出的设计描述当作已完成代码，也不以工具给出的“已通过”替代实际验证记录。仓库中的提交与合并情况以实际版本记录为准。

五、团队绩效

1. 工作流程与协作方式

本次材料围绕“需求基线 → 分项设计 → 交叉复核 → 联合修订 → 固定交付版本 → 答辩准备”整理。以下为团队协作流程和后续执行约定，实际认领、提交和复核情况以共享记录及仓库为准。

后续日常讨论拟使用 QQ 群，任务看板、会议结论和问题记录使用腾讯文档，版本资料统一放入华为云仓库。群内确认的接口或规则变更写回共享记录，再同步设计图和文档，避免只在聊天中口头确认。

版本管理拟按任务建立功能、修复或文档分支，通过合并请求复核后进入集成版本。每名成员使用本人账号提交实际负责的成果，保留任务编号、修改说明和验证结果；合并冲突由相关作者共同核对，涉及规则分歧时以已确认需求和验收为依据，由组长组织确定处理方式。

开发期间每周组会检查里程碑并演示成果，成员在看板同步“已完成、下一步、阻塞”。发现影响联调或交付的问题，当天说明影响及所需协助；任务通过复核后再标记完成。提交、复核和成果记录共同作为后续工作核对依据。

2. 组员分工与贡献度

本轮贡献比例如下。

六、开发计划安排

1. 预期开发时间与里程碑

以下为团队内部预期排期，覆盖 11 月中下旬冲刺。按公开作业帖安排，10 月 23 日进行本次课堂答辩；后续周计划和结束日期为团队安排，课程通知变化时同步调整。

开发沿两条主线并行推进：“课程 → 学习生活任务 → 专注 → 统计”和“问答 → 确认转笔记或计划 → 再次检索与管理”。AI 接口与云端最小部署在第一周先验证，减少后期集中联调风险。

阶段检查： M3 前若第一条主线仍未跑通，集中解决阻塞，不增加范围外功能；M4 后以完整流程和异常结果验收，页面模拟状态不作为真实功能完成依据。每周由负责人演示、非作者复核，延期时同步调整依赖和支援安排。

2. 预期开发分工

下表是开发阶段的预期安排，兼顾前后端、AI、测试和集成；它不代表第五部分尚未填写的本次实际工作。每人承担主责模块，并参与关联模块复核。

数据库与公共接口变更先由受影响成员核对，确认后同时更新实现、图源、接口说明和测试。涉及两类任务、快照、确认写入或删除规则的改动须做联合回归。图片语音、自动教务导入、社区和多设备实时合并继续保留为后续需求，不挤占本期主线。