软件工程第二次团队作业
| 项目 | 内容 |
|---|---|
| 作业所属课程 | 软件工程 |
| 班级链接 | 计科24级78班 - 班级博客 |
| 作业要求 | 第二次团队作业(原型设计 + 概要设计) |
| 作业要求链接 | 团队项目第二次作业 |
| 作业目标 | 用原型工具完成前台与后台两套原型,并按国标完成系统设计说明书与数据库设计说明书(概要设计) |
| 团队名称 | 智班工坊 |
| 团队成员 | 3124004185-肖武阳(队长)、3124004175-刘旭波、3124004181-王梓瀚 |
智班工坊第二次团队作业——原型设计+概要设计
项目:班小助 BanXiaoZhu —— 把班级群里刷屏的通知,变成今天该做的那几件事。
这篇博客包含三部分:原型设计(前台 10 屏 + 后台 6 屏)、概要设计(思维导图 + 5 张 UML 图 + 数据库设计)、团队协作记录。所有图都在正文里,文末附三份 PDF 与仓库链接。
写在前面:这一版设计要解决什么
班级群里的通知有三个特点:格式乱(一段话里塞着时间、地点、材料、截止要求)、会刷屏(半天不看就翻不到)、重复问(同一个问题每周有人问三遍)。同学真正需要的不是"更多信息",而是"今天该做哪几件事"。
所以我们把班小助做成一个校园事务智能体,只做四件事(这是原型与设计反复收敛后的结果):
| 编号 | 能力 | 一句话说明 |
|---|---|---|
| K1 | 通知解析 | 粘贴一段通知 → 结构化卡片(时间 / 地点 / 材料 / 要做什么) |
| K2 | 字段级溯源 | 每个字段都给原文出处与置信度,低可信字段显式标"待确认" |
| K3 | 三级提醒 | 待办按提前 1 天 / 2 小时 / 10 分钟各提醒一次 |
| K4 | 有依据的答疑 | 只依据班委维护的班级资料作答,并列出依据条目 |
其余能力(截图 OCR、课表冲突检测、事务办理引导、硬件班牌)都排进后续迭代,本文的第四部分给出迭代计划。设计阶段就砍功能,是为了让每个留下的能力都说得清、验得了。
一、原型设计
1.1 原型目标与工具
这次原型要回答三个问题:
- 同学从"看到通知"到"知道该做什么",到底要几步?
- 班委维护班级资料的成本,能不能压到愿意天天用?
- 出错的时候,人能不能看出来并纠正?
围绕这三点,原型做两套:
- 前台 10 屏:同学的日常使用路径(解析 → 待办 → 提醒 → 答疑),加班委的两个发布入口;
- 后台 6 屏:班委与助教的管理视角(看数据、管用户、审内容、排错)。
工具与方法:用即时设计做高保真原型(专用原型工具,1440×900,按 16 屏逐屏绘制);为了让评审不装任何工具也能直接点,同一套交互稿另实现为可点击的 HTML 演示,由 GitHub Pages 托管(见 1.6 与文末链接)。16 屏的设计稿截图与逐屏交互规则收录在《智班工坊_原型设计说明书》PDF 中。设计顺序是「先画线框定信息层级 → 再上视觉 → 最后一屏一屏连线走查」,走查发现的问题当场改文案。
1.2 信息架构(16 屏一览)
| 编号 | 页面 | 归属 | 核心任务 |
|---|---|---|---|
| P-01 | 登录与角色选择 | 前台 | 昵称 + 角色进入,区分同学 / 班委 |
| P-02 | 通知解析 | 前台 | 粘贴通知原文,一键解析 |
| P-03 | 解析结果卡片 | 前台 | 看字段、看可信度、回看原文出处 |
| P-04 | 我的待办 | 前台 | 一屏看完今天该做什么,可编辑可删除 |
| P-05 | 提醒中心 | 前台 | 三级提醒时间线 + 页内气泡 |
| P-06 | 班级问答 | 前台 | 提问并拿到带依据的回答 |
| P-07 | 班级资料库 | 前台 | 查阅资料,班委由此进入维护 |
| P-08 | 我的与设置 | 前台 | 昵称、角色、提醒偏好 |
| P-09 | 发布通知 | 前台(班委) | 解析 → 预览 → 发给全班并生成待办 |
| P-10 | 维护班级资料 | 前台(班委) | 资料增、改、删 |
| A-01 | 管理端登录 | 后台 | 班委 / 助教进入管理端 |
| A-02 | 数据看板 | 后台 | 四个数字回答"有没有人用" |
| A-03 | 用户管理 | 后台 | 改角色、停用账号 |
| A-04 | 通知与待办管理 | 后台 | 全班通知台账,出错可撤回 |
| A-05 | 资料审核 | 后台 | 同学纠错 → 班委审核 → 入库 |
| A-06 | 日志与设置 | 后台 | 调用日志与可调阈值 |

1.3 前台原型:一条主链路 + 三个支撑页
前台不按"功能"排菜单,而按使用顺序排:解析 → 卡片 → 待办 → 提醒是主链路,问答、资料库、设置是支撑页。同学打开应用后最多点三次就能关掉它——这是我们判断原型是否合格的标准。
P-02 通知解析:入口只有一个动作

这一屏只做一件事:把通知整段粘进来。三条交互规则:
- 文本为空或少于 15 字时,"开始解析"按钮置灰,不让用户点空;
- 解析中按钮变"解析中…"并禁用,防止重复提交(一次解析是一次模型调用,重复提交既慢又费钱);
- 失败时保留原文并提示"模型没返回有效结果,已用规则抽取兜底"——绝不白屏、绝不丢用户的字。
右侧放了三条示例通知(含时间+地点+材料 / 时间+金额 / 时间+地点),既能一键填入,也是评审时的演示素材。
P-03 解析结果卡片:把"凭什么这么写"摊给用户看

这是整个产品的杀手级界面,三件事必须同时可见:
- 字段与值:截止时间、地点、材料、要做什么,一行一个;
- 每个字段的可信度:≥75% 显示"可信"(绿),<75% 标黄"待确认";
- 原文出处:点开字段能看到它在原文里的那一句,并且逐字高亮。
设计上有一条硬规则:模型给出的出处句子必须在原文里逐字出现,否则该字段直接置空,宁可让用户手填,也不让"看起来对但没依据"的内容进卡片。这条规则决定了后面所有的技术选型(见第二部分)。
另一个刻意设计:解析不自动生成待办。卡片底部是"+ 加入我的待办",点了才写库。理由很朴素——"我可能只是想看看这条通知写了什么",不该被强行塞进日程。
P-04 我的待办 / P-05 提醒中心:让提醒可被信任

待办页按"紧急程度"排序(有截止时间的按时间排,没有的沉底),每行给三个动作:勾选完成、编辑、删除。编辑是行内展开(标题 + 截止时间 + 清空时间),不跳页——改个时间不该丢失上下文。

提醒用三档:提前 1 天、提前 2 小时、提前 10 分钟,同档位只提醒一次(数据库唯一约束兜底),改时间后旧提醒作废重算。页内用小气泡提示,点"知道了"本次不再弹。
这里有一个诚实的取舍:用轮询而不是推送。前端每 30 秒问一次后端有没有新提醒,实现只要十几行;换成 WebSocket 要多维护连接、重连、心跳。一周的项目,把这部分复杂度省下来投到"字段准确"上更划算。
P-06 班级问答:没有依据就说没有

问答页的规则比排版重要:
- 只依据班级资料作答,资料里没写就直说"资料里没写,建议问辅导员",不许自由发挥;
- 每条回答必须列出依据条目("依据:班级资料第 1 条「学生证补办流程」");
- 回答下面给"这条有用 / 不准确,去纠错",纠错进入后台审核队列(A-05),形成资料闭环。
P-07 ~ P-10 支撑页与班委入口

资料库给同学查阅、给班委维护。每条资料必须带维护人与更新时间,超过 180 天未更新会标"可能已过期"——资料的可信度是答疑可信度的地基。
班委多出两屏:P-09 发布通知(解析 → 预览 → 发给全班,可选"同时为每位同学生成待办")与 P-10 维护班级资料(增、改、删,改完立刻能被答疑用上)。发布前有一张自查清单(截止时间、地点、材料、是否生成待办),这张清单来自我们自己踩过的坑:通知漏写地点,同学就要多问三遍。

1.4 后台原型:回答"有没有人真的在用"
后台的存在理由只有一个:有人用得怎么样、哪里出了问题。六个页面的顺序就是班委每天的使用顺序:先看数据,再看用户,然后处理内容,最后排错。

数据看板给四个数字(本周活跃、解析量、生成待办数、答疑命中率)+ 近 7 天柱状图 + 字段可信度分布。其中"<75% 待确认"占比是质量红线:超过 15% 就说明提示词或资料来源需要调整——把"模型好不好"变成一个可观测的数字,而不是凭感觉。

资料审核负责闭环的另一半:同学纠错 → 班委审核 → 入库或驳回(驳回要填原因并通知提交人)。审核是资料可信度的最后一道闸。
1.5 UI 规范
| 项 | 取值 | 用途 |
|---|---|---|
| 主色 | #2F6FED 蓝 | 主动作按钮、选中态、链接 |
| 强调色 | #F2762E 橙 | 待确认、超时、需要人介入的状态 |
| 成功色 | #12A075 绿 | 可信、已完成、命中 |
| 正文色 | #1C2B45 / 次要 #5B6B85 | 正文与说明文字 |
| 圆角 / 间距 | 卡片 14px、按钮 9px;区块间距 14px | 统一节奏 |
| 字号 | 标题 21px、正文 14px、说明 12.5px | 一屏放得下、不挤 |
交互上只守三条:每个动作都要有反馈(按钮态、气泡提示);危险动作必须二次确认(删除、下线、停用);不确定的信息要显式标出来(待确认、可能已过期、资料里没写),而不是装作知道。
1.6 点击走查路径
评审时按这四条路径走一遍,能覆盖 90% 的交互约定:
| 路径 | 点击顺序 | 预期结果 |
|---|---|---|
| 主链路 | P-01 → P-02 粘贴 → 解析 → P-03 → +加入我的待办 → P-04 | 卡片出现 4 个字段与可信度;加入后待办才 +1 |
| 改时间 | P-04 编辑 → 改截止 → 保存 → P-05 | 旧提醒消失,按新时间重算三档 |
| 问答与纠错 | P-06 提问 → 看依据 → 去纠错 → A-05 审核 | 回答带依据条目;纠错进入待审队列 |
| 班委闭环 | P-09 发布 → P-10 维护资料 → A-02 看板 | 待办数增加;答疑立即引用新内容;看板同步变化 |
可点击原型:https://yangyang254.github.io/banxiaozhu/prototype/(本地版本为仓库中的 prototype/index.html,双击即可,16 屏互相跳转)。
原型设计稿(16 屏截图 + 交互规则):见《智班工坊_原型设计说明书》PDF(在线预览),每屏都附入口 / 关键控件 / 交互规则 / 校验规则 / 数据来源五行说明。点击走查请用上面那个可点击版本。
1.7 原型阶段有意不做的事
- 不做真实登录:不收集口令,避免无谓的账号安全负担;
- 不做截图 OCR:本期只支持文本粘贴,截图识别排入迭代 1;
- 不做多班级 / 多学校:先把一个班的闭环走通;
- 不做装饰性动效:动效只保留状态反馈(按钮态、气泡、加载)。
二、概要设计
详细内容见《智班工坊_系统设计说明书》与《智班工坊_数据库设计说明书》(文末附 PDF)。这里给出设计主线与关键图。
2.1 功能结构

四个功能域:通知中枢(解析、卡片、溯源)、我的日程(待办、三级提醒)、班级问答(资料库、检索答疑、纠错)、班委与后台(发布、审核、看板、日志)。其中打勾的部分是本次概要设计细化到接口与算法层面的能力,其余为迭代 1~4 的规划。
2.2 分层架构与模块划分

五层结构,自上而下:接入层(浏览器 / 班委电脑 / 班牌,规划中)→ 前端层(原生 HTML+CSS+JS,四页签)→ 应用层(FastAPI 单进程,17 条路由)→ 智能体层(解析 Agent、答疑 Agent + 规则兜底)→ 数据与模型层(SQLite 单文件 5 表 + 大模型 API + 配置)。
分层的意义在"变化被隔离":换界面只动前端层,换数据库只动数据层,换模型只动智能体层,而层间的 REST 契约保持稳定。

四个模块组、16 个功能模块,模块职责与对应需求在《系统设计说明书》表 2-2 中逐行给出。
2.3 用例视图

四个参与者:普通同学(解析、加入待办、编辑删除待办、查看统计、提问)、班委(维护班级资料、接收提醒、后台管理)、DeepSeek 大模型(«external»,被解析与答疑用例调用)、定时扫描器(«system»,驱动提醒生成)。
用例关系:解析用例 «include» 调用大模型抽取字段;"加入我的待办"与"标记提醒已读"分别 «extend» 于解析用例与提醒用例——它们在主流程之外被用户可选触发;提醒用例由扫描器 «generate» 驱动。
2.4 关键流程:从一段通知到三级提醒

活动图把主干拉成 10 步,并在两处设置降级分支:证据不命中 → 规则抽取兜底、置信度不足 → 字段标"待确认"。这两条支线是整个设计的"安全带"——模型不给力时流程不会断。

时序图强调两点设计意图:第一,写库动作发生在校验之后,脏数据不进数据库;第二,待办写入被拆成独立的一次用户确认动作,解析与日程解耦。

协作图给出同一链路的对象与消息编号:1 号消息进接口层,1.1 组装提示词交给解析器,1.2/1.3 与模型往返,1.4 落库,1.5 返回卡片;2 号消息是用户确认后的待办落库;3 号消息由守护线程在后台驱动,3.1/3.2 完成提醒写入,3.3 由前端轮询取走。
2.5 关键算法
① 字段抽取与证据校验
for field in (title, deadline, location, materials):
ev = data.evidence.get(field)
if ev and ev not in raw_text: # 出处句子不在原文里
data[field] = None # 该字段不采信
data.confidence[field] = 0
overall = mean(conf[title], conf[deadline], conf[location])
② 三级提醒(幂等)
按 1440 / 120 / 10 分钟三档计算触发时间,UNIQUE(task_id, level) 保证同一待办的同一档位只写一次;待办改时间时先删旧提醒再重算。
③ 答疑检索
资料按字面重合打分:score = |Q ∩ D| / (|Q| + 1),取前 4 条塞进提示词。不做向量库——一学期几百条班级资料,字面重合足够,而且可解释(能告诉用户"命中的是哪一条")。
2.6 接口契约
17 条路由(16 个 /api/* 方法 + 首页),完整清单见《系统设计说明书》表 3-1。POST /api/parse 的返回体:
{
"notice_id": 12,
"fields": {"title": "...", "deadline": "2026-11-08T18:00", "location": "...", "materials": ["..."]},
"confidence": {"title": 0.96, "deadline": 0.95, "location": 0.88, "materials": 0.92},
"evidence": {"deadline": "11 月 8 日 18:00", "location": "实验楼 A302 办公室"},
"overall": 0.95,
"suggest": {"title": "交国家励志奖学金材料", "due_at": "2026-11-08T18:00"}
}
注意它不直接返回 task_id,只给一个 suggest:待办要不要建,由用户点"+ 加入我的待办"决定。
2.7 类设计

12 个类:User 抽象出 Student 与 Committee;Notice 是解析结果主体,对应 TaskItem 待办;ServiceRequest 描述事务办理;Conversation / Message / AgentRun 记录人机交互;KnowledgeDoc 是班级资料;Device 为班牌(规划);ReminderLog 记录提醒流水。
类图与物理表并非一一对应:本期把 User/Student/Committee 合并为 users 表,把 Conversation/Message/AgentRun 收敛为"不单独存储、日志留痕",以降低一期复杂度;ServiceRequest 与 Device 属后续迭代,只保留设计。
2.8 数据库设计

五个实体(users、notices、tasks、reminders、kb)与四个 1:N 联系:创建(用户→通知)、负责(用户→待办)、来源(通知→待办)、触发(待办→提醒);kb 由班委维护、不设外键(它是答疑语料,不隶属某个用户)。
关系模式(3NF):
users(id, name, role)
notices(id, raw_text, title, deadline, location, materials, action, confidence, model, created_by, created_at)
tasks(id, user_id, notice_id, title, due_at, status, created_at, done_at)
reminders(id, task_id, level, content, created_at, acked_at) UNIQUE(task_id, level)
kb(id, question, answer, created_at)
物理设计要点:WAL 模式(读写不互斥)、7 个索引(覆盖"按用户查待办""按时间扫提醒""按截止排序"等热点)、完整性约束(status 枚举、due_at 可为空表示不限时)、容量估算约 10MB/年。ORM 映射与完整 DDL 见《数据库设计说明书》第 5 章与附录 A。
2.9 出错处理与降级
| 层级 | 触发条件 | 处理方式 |
|---|---|---|
| 一级 | 模型返回非 JSON / 字段缺失 | 剥壳 + 截取首尾花括号重试解析 |
| 二级 | 仍然无法解析 | 走正则规则抽取(日期、时间、地点、材料) |
| 三级 | 接口异常 / 超时 | 返回中文提示并保留原文,前端可重试 |
原则一句话:页面永远有结果,且结果永远标着它的可信度。
2.10 迭代计划

| 迭代 | 时间 | 目标 |
|---|---|---|
| 阶段 0 | 11-03 ~ 11-09 | 立项、需求定稿、答辩(已完成) |
| 迭代 1 | 11-24 ~ 12-07 | 通知中枢打磨:截图 OCR、字段纠错回流、30 条真实通知评测集 |
| 迭代 2 | 12-08 ~ 12-21 | 日程与课表:周计划、冲突检测 |
| 迭代 3 | 12-22 ~ 01-04 | 事务办理引导、资料审核闭环 |
| 迭代 4 | 01-05 ~ 01-18 | 公网部署上线、ESP32 班牌(加分项,规划中) |
三、团队协作记录
3.1 分工
| 学号 | 姓名 | 角色 | 承担工作 | 主要产出 |
|---|---|---|---|---|
| 3124004185 | 肖武阳 | 队长 / 需求与概要设计 | 需求梳理、总体设计与接口设计、用例图与活动图、文档统稿 | 《系统设计说明书》、博客正文 |
| 3124004175 | 刘旭波 | 原型与前端设计 | 前台 10 屏原型、视觉规范、点击走查、原型工具导入与发布 | 《原型设计说明书》前台部分、可点击原型 |
| 3124004181 | 王梓瀚 | 数据库与后台设计 | 数据库概念/逻辑/物理设计、ER 图与类图、后台 6 屏原型、仓库归档 | 《数据库设计说明书》、ER 图、类图、后台原型 |
3.2 按周开发计划与产出
| 周次 | 日期 | 目标 | 主要任务 | 负责人 | 产出 | 里程碑 |
|---|---|---|---|---|---|---|
| 第 1 周 | 11-03 ~ 11-09 | 立项与需求定稿 | 选题 3 轮讨论、梳理班级群历史通知、划定 11 条功能需求 | 肖武阳(主) | 《软件需求规格说明书》V1.0、答辩 PPT | M1 需求答辩(11-09) |
| 第 2 周 | 11-10 ~ 11-16 | 概要设计 | 分层架构、模块结构、用例/活动/时序/协作图、17 条接口契约 | 肖武阳 | 5 张 UML 图 + 2 张结构图 | 图与文档口径对齐 |
| 第 2 周 | 11-10 ~ 11-16 | 数据库设计 | 五表字段与索引、ER 图与类图、ORM 与 DDL | 王梓瀚 | ER 图、类图、数据库说明书初稿 | 3NF 检查通过 |
| 第 3 周 | 11-17 ~ 11-20 | 原型设计 | 前台 10 屏 + 后台 6 屏、逐屏交互与规则、四条走查路径 | 刘旭波(主) | 《原型设计说明书》、可点击原型 | M2 原型定稿(11-20) |
| 第 3 周 | 11-17 ~ 11-20 | 文档定稿 | 三份文档统稿、图注编号、交叉引用检查、PDF 导出 | 肖武阳、王梓瀚 | 三份 PDF | M3 文档定稿(11-20) |
| 第 4 周 | 11-21 ~ 11-22 | 提交与复核 | 博客发布、仓库归档、三人各提交一次、链接回填 | 全员 | 博客 + GitHub 仓库 | M4 提交(11-22 23:59) |
3.3 协作过程记录
| 日期 | 形式 | 内容 | 参与人 | 产出 |
|---|---|---|---|---|
| 11-03 | 线下讨论(图书馆研讨间 90 分钟) | 三个选题比较,确定做通知智能体 | 全员 | 选题结论、需求初稿 |
| 11-05 | 线上会议(60 分钟) | 划功能边界:砍截图 OCR 与硬件班牌 | 全员 | 功能清单 V0.9 |
| 11-09 | 课堂答辩 | 需求分析答辩,记录老师与助教意见 4 条 | 全员 | 答辩 PPT、意见清单 |
| 11-12 | 线下评审(45 分钟) | 逐张评审概要设计图,修正用例图连线与 ER 基数 | 肖武阳、王梓瀚 | 图 V1.1 |
| 11-17 | 线上走查(共享屏幕) | 走查 16 屏原型,修改 9 处交互文案 | 刘旭波、肖武阳 | 原型 V1.0 |
| 11-20 | 线下统稿(120 分钟) | 交叉引用检查、图注编号、PDF 导出 | 全员 | 三份 PDF |
| 11-21 | 线上 | 仓库归档、提交分工约定 | 全员 | GitHub 仓库 |
| 11-22 | 线上例会(腾讯会议 40 分钟) | 提交前总复核:博客终稿、仓库链接回填、三份 PDF 与原型逐项核对 | 全员 | 最终提交包 |

图 3-1 2026-11-22 提交前线上例会(腾讯会议,40 分钟):逐项核对博客、仓库链接与三份 PDF。
3.4 项目管理与版本控制
- 平台:GitHub 公开仓库,三名成员均为协作者(Write 权限);分工、提交记录与版本说明统一维护在仓库根目录
COLLAB.md。 - 分支:
main只放可提交版本;个人工作放feat/<姓名>,合并前至少一人 review。 - 提交规范:写"做了什么 + 为什么",例如
docs: 补充三级提醒的幂等约束说明。 - 进度跟踪:按周计划表推进,每周固定一次线下 + 一次线上同步;里程碑 M1~M4 见上表。
四、交付清单与链接
| 交付物 | 链接 |
|---|---|
| 团队仓库(GitHub) | https://github.com/yangyang254/banxiaozhu |
| 《智班工坊_系统设计说明书》PDF | https://yangyang254.github.io/banxiaozhu/docs/智班工坊_系统设计说明书.pdf |
| 《智班工坊_数据库设计说明书》PDF | https://yangyang254.github.io/banxiaozhu/docs/智班工坊_数据库设计说明书.pdf |
| 《智班工坊_原型设计说明书》PDF | https://yangyang254.github.io/banxiaozhu/docs/智班工坊_原型设计说明书.pdf |
| 可点击原型(在线演示) | https://yangyang254.github.io/banxiaozhu/prototype/ |
| 原型设计稿(16 屏 + 交互规则) | 智班工坊_原型设计说明书.pdf |
| 需求规格说明书(第一次作业) | 班小助 软件需求规格说明书(38 页 / 40 表 / 9 图) |
小结
这次我们把"想做的很多"砍到了"做得到的四个":解析、溯源、提醒、答疑。所有设计动作都围绕一句话——让用户能验证系统说的话:字段有出处、回答有依据、提醒只提醒一次、待办由用户自己确认。
设计文档里没有"预计""大概""未来将支持"这类话术,写不到的功能我们就不承诺。
浙公网安备 33010602011771号