作业所属课程 202601 软件工程
作业要求 第二次团队作业
作业目标 把第一次的需求收敛为可交互原型，并明确系统结构、数据设计和后续开发分工
团队名称 啊对对队
团队成员 李嘉星、林诗航、张炜鑫、谢玲洁、李莹莹、王清源

帮新手做好 H2D 开打前检查

第一次交流中，协会管理人员和初学使用者提到了打印机使用不规范、不会操作和需要现场指导等问题。答辩之后，我们把目标收窄到创客中心的一台拓竹 H2D。首版只回答两个问题：这个人有没有通过培训？开打前还有哪一步没确认？ 首版流程从身份核验开始，到保存开打前检查记录结束。

原型怎么走

拿一位刚通过培训的同学举例。他在设备前完成身份核验，打开 H2D 的开打前清单。看到「平台边缘疑似有物品」的模拟提醒后，他到设备前确认打印区，再勾选检查项。页面显示设备空闲且必要项目齐全时，他提交检查结果，然后按协会的现场流程上机。

  • 未培训：身份核验后仍保持 LabMate 使用入口锁定，页面给出学习和联系管理员的入口。
  • 已培训的新手：在关键检查项看到模拟视觉提示，例如提醒现场确认平台边缘的疑似物品。
  • 熟练用户：走相同的准入和必要检查，默认不主动弹出视觉提示。
  • 摄像头不可用：提示无法判断并给出人工确认路径；设备状态未知或过期时，页面提示刷新。
  • 协会管理端：看检查记录和阻塞原因，必要时记录现场复核。

Web 原型演示（模拟）

墨刀原型（只读演示）

下面三张图来自 Web 原型，均使用模拟数据。

图 1：身份核验通过后，页面继续检查培训资格，并给出学习指引。

图 2：新手看到疑点后，在现场确认打印区，再勾选检查项。

图 3：协会管理人员可以查看该次检查的结果和记录原因。

系统和数据怎么设计

准入和检查。 页面把身份和设备信息交给后端。后端查询当前培训资格，检查提交前再核对资格、人工确认项和设备状态。设备忙碌或状态过期时，页面给出原因和刷新入口；协会管理人员可以查看对应记录。

Agent 怎么给建议。 在新手的关键检查项，系统通过模型上下文协议（MCP）获取设备区域画面，并给视觉模型提供当前检查项和协会审核过的资料。模型返回画面中的疑点、依据和一条可以现场核对的建议。摄像头不可用时，页面引导用户找管理员现场复核。H2D 的具体可读字段、访问授权和真机联调安排在开发阶段核对。

一条记录怎么存。 一次上机检查对应一个检查会话，关联使用者、设备、各项确认结果和设备状态快照。管理人员从会话详情回看当时的状态及复核理由。业务库保存核验结果、提示摘要和资料出处，原始画面在对应流程中临时处理。

系统说明书包含用例图、活动图、类图、时序图和协作图。看主流程可以先翻时序图，对照「核验 → 检查 → 提交」。数据库说明书用实体关系（ER）图、关系模型和对象映射说明数据如何落表。两份 PDF 的链接见文末。

后续开发计划（拟定）

周次 里程碑 产出
11/09–11/15 确认培训、准入和一项关键检查 协会规程核对、接口字段清单、交互冻结
11/16–11/22 打通身份与资格、开打前检查 数据库迁移、服务接口、用户端流程
11/23–11/29 联接状态适配与视觉指导 只读状态、模拟回退、单个检查点的视觉建议
11/30–12/06 完成后台和端到端验证 管理端、权限检查、部署与复核记录
12/07–12/13 汇总验收材料 通用问答对比、演示说明、使用反馈与修订
成员 本次拟交付
李嘉星 定首版范围；编写统一提示词与 Agent 设计；整合两份说明书和博客 Markdown；核对原型与文档一致。
林诗航 设计身份核验、培训资格与软件入口锁定／放行规则；绘制主流程时序图。
张炜鑫 制作用户端和管理端专用工具原型，覆盖四条交互分支；提供可匿名访问的分享链接。
谢玲洁 设计 ER 图、关系模型及实体与库表映射；核对与后台流程一致。
李莹莹 整理原型走查清单、按周开发计划与协作记录；用未登录窗口核对公开链接。
王清源 设计 H2D 状态读取、MCP 取帧与视觉输入边界；定义不可用处理，标明已确认与待核对的接口。

本次协作记录

我们在 GitHub 上按分工提交并合并了五位组员的材料。李嘉星定首版范围，整理 Agent 设计，并将评审结果汇总到博客和两份说明书。

成员 评审与产出
林诗航 准入规则与时序图，核对身份、培训和检查入口的状态。
张炜鑫 原型和墨刀交接，补齐分享入口。
谢玲洁 数据库校核，补齐培训结果与检查会话、用户与审计事件两条关系。
李莹莹 原型与计划核对，记录源码检查、公开链接请求和五周计划。
王清源 设备接入设计，整理状态读取和设备区取帧的接口约定。

提交材料

  • GitHub 团队仓库
  • 啊对对队_系统设计说明书.pdf
  • 啊对对队_数据库设计说明书.pdf