软件工程第二次团队作业

项目 内容
作业所属课程 软件工程
班级链接 计科24级78班 - 班级博客
作业要求 第二次团队作业(原型设计 + 概要设计)
作业要求链接 团队项目第二次作业
作业目标 用原型工具完成前台与后台两套原型,并按国标完成系统设计说明书与数据库设计说明书(概要设计)
团队名称 智班工坊
团队成员 3124004185-肖武阳(队长)、3124004175-刘旭波、3124004181-王梓瀚

智班工坊第二次团队作业——原型设计+概要设计

项目:班小助 BanXiaoZhu —— 把班级群里刷屏的通知,变成今天该做的那几件事。

这篇博客包含三部分:原型设计(前台 10 屏 + 后台 6 屏)、概要设计(思维导图 + 5 张 UML 图 + 数据库设计)、团队协作记录。所有图都在正文里,文末附三份 PDF 与仓库链接。


写在前面:这一版设计要解决什么

班级群里的通知有三个特点:格式乱(一段话里塞着时间、地点、材料、截止要求)、会刷屏(半天不看就翻不到)、重复问(同一个问题每周有人问三遍)。同学真正需要的不是"更多信息",而是"今天该做哪几件事"。

所以我们把班小助做成一个校园事务智能体,只做四件事(这是原型与设计反复收敛后的结果):

编号 能力 一句话说明
K1 通知解析 粘贴一段通知 → 结构化卡片(时间 / 地点 / 材料 / 要做什么)
K2 字段级溯源 每个字段都给原文出处与置信度,低可信字段显式标"待确认"
K3 三级提醒 待办按提前 1 天 / 2 小时 / 10 分钟各提醒一次
K4 有依据的答疑 只依据班委维护的班级资料作答,并列出依据条目

其余能力(截图 OCR、课表冲突检测、事务办理引导、硬件班牌)都排进后续迭代,本文的第四部分给出迭代计划。设计阶段就砍功能,是为了让每个留下的能力都说得清、验得了。


一、原型设计

1.1 原型目标与工具

这次原型要回答三个问题:

  1. 同学从"看到通知"到"知道该做什么",到底要几步?
  2. 班委维护班级资料的成本,能不能压到愿意天天用?
  3. 出错的时候,人能不能看出来并纠正?

围绕这三点,原型做两套:

  • 前台 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 通知解析:入口只有一个动作

P-02 通知解析

这一屏只做一件事:把通知整段粘进来。三条交互规则:

  • 文本为空或少于 15 字时,"开始解析"按钮置灰,不让用户点空;
  • 解析中按钮变"解析中…"并禁用,防止重复提交(一次解析是一次模型调用,重复提交既慢又费钱);
  • 失败时保留原文并提示"模型没返回有效结果,已用规则抽取兜底"——绝不白屏、绝不丢用户的字。

右侧放了三条示例通知(含时间+地点+材料 / 时间+金额 / 时间+地点),既能一键填入,也是评审时的演示素材。

P-03 解析结果卡片:把"凭什么这么写"摊给用户看

P-03 解析结果卡片

这是整个产品的杀手级界面,三件事必须同时可见:

  1. 字段与值:截止时间、地点、材料、要做什么,一行一个;
  2. 每个字段的可信度:≥75% 显示"可信"(绿),<75% 标黄"待确认";
  3. 原文出处:点开字段能看到它在原文里的那一句,并且逐字高亮。

设计上有一条硬规则:模型给出的出处句子必须在原文里逐字出现,否则该字段直接置空,宁可让用户手填,也不让"看起来对但没依据"的内容进卡片。这条规则决定了后面所有的技术选型(见第二部分)。

另一个刻意设计:解析不自动生成待办。卡片底部是"+ 加入我的待办",点了才写库。理由很朴素——"我可能只是想看看这条通知写了什么",不该被强行塞进日程。

P-04 我的待办 / P-05 提醒中心:让提醒可被信任

P-04 我的待办

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

P-05 提醒中心

提醒用三档:提前 1 天、提前 2 小时、提前 10 分钟,同档位只提醒一次(数据库唯一约束兜底),改时间后旧提醒作废重算。页内用小气泡提示,点"知道了"本次不再弹。

这里有一个诚实的取舍:用轮询而不是推送。前端每 30 秒问一次后端有没有新提醒,实现只要十几行;换成 WebSocket 要多维护连接、重连、心跳。一周的项目,把这部分复杂度省下来投到"字段准确"上更划算。

P-06 班级问答:没有依据就说没有

P-06 班级问答

问答页的规则比排版重要:

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

P-07 ~ P-10 支撑页与班委入口

P-07 班级资料库

资料库给同学查阅、给班委维护。每条资料必须带维护人与更新时间,超过 180 天未更新会标"可能已过期"——资料的可信度是答疑可信度的地基。

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

P-10 维护班级资料

1.4 后台原型:回答"有没有人真的在用"

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

A-02 数据看板

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

A-05 资料审核

资料审核负责闭环的另一半:同学纠错 → 班委审核 → 入库或驳回(驳回要填原因并通知提交人)。审核是资料可信度的最后一道闸。

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 数据库设计

数据库 ER 图

五个实体(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 与原型逐项核对 全员 最终提交包

团队协作记录:2026-11-22 提交前线上例会(腾讯会议,全员到齐,时长 40 分钟)

图 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 图)

小结

这次我们把"想做的很多"砍到了"做得到的四个":解析、溯源、提醒、答疑。所有设计动作都围绕一句话——让用户能验证系统说的话:字段有出处、回答有依据、提醒只提醒一次、待办由用户自己确认。

设计文档里没有"预计""大概""未来将支持"这类话术,写不到的功能我们就不承诺。

posted @ 2026-11-22 20:36  肖武阳  阅读(9)  评论(0)    收藏  举报