第二次团队作业 (原型设计+概要设计)

作业所属课程 https://edu.cnblogs.com/campus/gdgy/Class78-Grade2024-CS
作业要求 https://edu.cnblogs.com/campus/gdgy/Class78-Grade2024-CS/homework/16785
作业的目标 在第一次作业需求分析基础上,完成AI校园学习陪伴助手的原型设计、概要设计与数据库设计,为编码打基础
团队名称 无言以队
团队成员学号-名字 3124004503陈明凯,3124004505邓文炜

一句话回顾:我们小组的项目为AI 校园学习陪伴助手,是智能体开发课程作业,是一套浏览器可直接访问的 Web 应用,聚焦学生复习备考真实痛点。区别于通用大模型聊天工具,系统将课程作为一等核心对象,实现课件总结、习题引导辅导、自动生成复习计划、课程记忆上下文隔离、AI 错题本闭环、学习资源包生成、番茄专注计时、ESP32 硬件联动等完整能力。

一、原型设计

1.1 原型工具与在线预览

项 内容
原型工具 墨刀在线 Web 版。单一源为 gen_modao_v150.py(页面 / 字段 / 需求数据)与 gen_modao_interactive.py(信息架构 / 交互 / 走查版),产物为 modao_v150/*.html 共 16 页及导入载荷
工程名 校园AI陪伴助手(在线分享备注名:「校园AI陪伴助手-分享」)
页面范围 P00 信息架构 + P01 – P10 前台 10 页 + M01 – M05 后台管理 5 页;前台页与 static/index.html 的 data-tab 一一对应
在线预览 / 分享链接 https://modao.cc/proto/zhsPz0tourxb68EcNCVE/sharing?view_mode=read_only&screen=llmVbc4XXaOMwo2Ij (备注:「校园AI陪伴助手-分享」;只读分享,无需分享密码);16 页已写入并复核,含 16 个画布、16 个代码组件与 100 个原生跳页热区
原型形态 P00 给出页面层级、六步核心场景与跳转关系;其余 15 页各有应用界面、状态切换分镜和「交互动作 → 状态反馈 → 跳转页」表,共 63 条动作。页号 / 页面名已绑定原生热区,点击可跳页
可交互走查版 modao_v150/交互走查版.html:浏览器可直接点击的本地单文件,含 15 个页面视图、课程切换与记忆隔离、忙碌态、回答卡、错题掌握、设置自检及「一键走查核心流程」;不调用真实接口,不写真实数据库
可运行系统 https://ai-campus-companion.app.workbuddy.host/?sharecode=CEUN7FBTFJ ,浏览器直接打开,无需安装和 API Key
截图来源 assets/界面_*.png 10 张真实运行界面;assets/原型_*.png 6 张同源原型页渲染图;均为真实渲染
访问密码 无需分享密码(只读分享链接,公开可访问)

1.2 前台应用原型:10 个页面模块

单页应用 static/index.html 顶栏含品牌、当前智能体徽标与主题切换,左侧 10 个导航按钮对应右侧 10 个 section.panel;课程选择条全局生效,支持 /#study 等 hash 直达。语音输入 F25 / A28 由 P02 / P04 / P05 / P07 / P08 五处输入框承载。

# 页面 / data-tab 原型关键元素 主要交互 对应需求 截图
1 学习概览 dashboard 6 项统计卡片、待复习任务、番茄钟、最近专注 卡片可键盘激活;无误题显示「暂无」 F12、F26、F29 image
2 智能问答 chat 演示模式提示条、对话区、输入框与语音按钮 选课即切换上下文;请求期间按钮禁用 F01、F06、F28、F34 assets/界面_智能问答.png
3 学习资源包 study 教材 / 章节 / 题量 / 难度、7 个动作按钮、五区结果 生成按钮统一忙碌态;一键五件套与导出 F13 – F19、F35 image
4 课件总结 summarize 大文本框 + 语音、生成按钮、结果区 输出知识点与考点提纲,安全 Markdown 排版 F02、F27 image
5 习题辅导 tutor 大文本框 + 语音、辅导按钮、结果区 返回分步思路,不直接给答案 F03、F27 image
6 复习计划 plan 科目、天数、生成按钮、结果区 生成逐日安排 F04、F27 image
7 课程记忆 memory 资料标题 / 正文、上传区、资料列表 查看全文 / 收起、下载 .md、类型与大小白名单 F05、F07、F08 image
8 错题本 wrong 录入表单、筛选、导出、错题列表 录入 → 分析 → 掌握 → 筛选 → 导出 F09 – F11、F36 image
9 硬件联动 hardware 任务创建、测试提醒、专注灯、清单表、看板 未配置端点返回 sent: false 与原因 F37(可选) image
10 设置 settings 主题、模型接入表单、Provider 状态卡、参数速查 密钥即时生效、只回掩码;清除后回退 demo F20 – F24 image

1.2.1 典型页面截图

以下截图取自 V1.5.0 本地服务的真实运行页面;其余 4 张(课件总结、复习计划、错题本、设置)见上表「截图」列。

image

截图 1 学习概览:6 项统计卡片、待复习任务快捷区与番茄钟;无误题时显示「暂无」。

image

截图 2 课程内智能问答:顶部课程切换即切换课程记忆,回答按安全 Markdown 排版,请求期间按钮禁用。

image

截图 3 学习资源包:参数区与 7 个生成动作,结果分题目、总结、文章、资料、思维导图五区展示。

image

截图 4 习题辅导:大文本框 + 语音输入、「辅导一下」按钮与结果区;返回分步思路,不直接给出答案。

image

截图 5 课程记忆:资料标题 / 正文、上传区与资料列表;可见「第 3 章 树与二叉树」及「查看全文 / 下载 .md」。

image

截图 6 硬件联动:任务创建、测试提醒、专注灯、6 点清单表与状态看板。图中只表达接口与状态,ESP32 未实机联调。

1.2.2 墨刀原型:页面、流程、状态与组件

原型按 V1.5.0 建立,共 16 页。后台 5 页只重组真实存在的管理操作,不虚构登录、权限或多租户。作业要求「前台应用与后台管理原型」,两部分同处一套原型、共用预览链接。

原型图 1 P00 信息架构与核心流程

原型图 1 P00 信息架构:前台 / 后台页面层级、六步核心场景、跳转关系汇总与 F / A 编号索引。

页号 分组 页面名(标识) 功能编号 验收编号 关键交互状态
P00 信息架构 原型总览与需求索引 F01 – F37 / A01 – A39 — 页面层级 / 六步场景 / 跳转汇总,非功能页
P01 前台 学习概览 dashboard F12 · F26 · F29 A15 · A29 · A32 默认 / 空 / 键盘焦点 / 异常降级
P02 前台 智能问答 chat F01 · F06 · F25 · F27 · F28 · F33 · F34 A05 · A06 · A28 · A30 · A31 · A36 · A37 默认 / 忙碌 / 回退 / 切课程
P03 前台 学习资源包 study F13 – F19 · F27 · F35 A16 – A22 · A30 · A38 默认 / 忙碌 / 部分失败 / 直达
P04 前台 课件总结 summarize F02 · F25 · F27 · F30 A07 · A28 · A30 · A33 默认 / 忙碌 / 空值拦截 / 异常降级
P05 前台 习题辅导 tutor F03 · F25 · F27 · F30 A08 · A28 · A30 · A33 默认 / 忙碌 / 结果 / 异常降级
P06 前台 复习计划 plan F04 · F12 · F27 A09 · A15 · A30 默认 / 忙碌 / 结果 / 异常降级
P07 前台 课程记忆 memory F05 · F07 · F08 · F25 · F32 · F33 A10 · A11 · A12 · A28 · A35 · A36 默认 / 空 / 上传中 / 展开 / 校验失败
P08 前台 错题本 wrong F09 – F11 · F25 · F31 · F36 A13 · A14 · A28 · A34 · A39 默认 / 空 / 忙碌 / 校验失败
P09 前台 硬件联动 hardware F37(可选,不列入验收) 不列入验收 默认 / 未配置 / 边界声明
P10 前台 设置 settings F20 – F24 · F30 · F31 A23 – A27 · A33 · A34 默认 / 配置生效 / 自检 / 回退 / 掩码
M01 后台管理 课程与资料管理 m01 F05 · F07 · F08 · F32 · F33 A04 · A10 · A11 · A12 · A35 · A36 默认 / 空 / 校验失败 / 上传中
M02 后台管理 智能体运行配置 m02 F20 – F24 · F30 · F31 A23 – A27 · A33 · A34 默认 / 配置生效 / 自检 / 回退 / 掩码
M03 后台管理 运行状态与硬件看板 m03 F26 · F29 · F37(可选) A01 · A29 · A32 默认 / 未配置 / 边界声明
M04 后台管理 复习任务与专注管理 m04 F04 · F12 · F26 · F29 A09 · A15 · A29 · A32 默认 / 空 / 忙碌 / 异常降级
M05 后台管理 错题与归档管理 m05 F09 – F11 · F25 · F31 · F36 A13 · A14 · A28 · A34 · A39 默认 / 空 / 忙碌 / 校验失败

原型图 2 习题辅导页

原型图 2 P05 习题辅导:界面、字段与组件、交互状态、流程及需求核对卡(F03 · F25 · F27 · F30)。

原型图 3 课程记忆页

原型图 3 P07 课程记忆:资料字段、上传白名单、全文查看 / 下载与上下文预算(F05 · F07 · F08 · F32 · F33)。

原型图 4 硬件联动页

原型图 4 P09 硬件联动:接口清单、未配置态与「不代表物理联调」的边界声明(F37)。

核心使用场景:进入应用(P01)→ 在课程记忆保存「数据结构」资料(P07)→ 切到「高等数学」确认资料不跟随(P07 / P02)→ 回到「数据结构」提问,资料全文拼入上下文(P02)→ 观察忙碌态、回答卡与无密钥回退(P02 / P10)→ 错题分析、标记掌握并加入复习任务(P08 / P06)。

业务流程

  1. 课程记忆:选课程 → 粘贴 / 上传资料 → 保存到该课程 → build_course_context(course_id) 拼入问答上下文 → 切课即切记忆。单份 4000 字、总量 12000 字,超出按序保留并提示;为全文拼接,不是检索增强。
  2. 智能生成:选参数 → 单动作或一键五件套 → 五区渲染 → 可回写课程记忆 → 导出 Markdown。/?autopack=1#study 为直达态。
  3. 复习闭环:录入错题 → 错因与变式题 → 标记掌握 → 按状态筛选 → 导出;复习计划与提醒由后台线程每 30 秒扫描。
  4. 运行配置:选 Provider → 填密钥 / 模型 / 地址 → 保存或自检 → 运行时写入 SQLite → 异常自动回退 demo。
  5. 后台管理:M01 课程与资料 → M02 运行配置 → M03 状态看板 → M04 任务与专注 → M05 错题归档,对应真实 REST 路由。

交互状态字典

状态 界面表现 触发与恢复 需求
默认态 数据区有值、控件可用 页面加载完成 —
忙碌态 按钮禁用 + 状态文案,finally 恢复 请求期间;5 个资源包按钮统一控制 F28 / A31
空态 「暂无」提示,不显示 0.0% 无资料、无误题、筛选无结果 F26 / A29
结果态 结果区安全 Markdown 渲染 生成 / 辅导 / 计划成功 F27 / A30
异常降级态 逐模块错误提示,页面仍可切换 单个接口失败 F30 / A33
回退态 演示模式提示条 + fallback 标记 无密钥或厂商异常 F23 / A26
校验失败态 逐项错误文案,课程不存在返回 400 类型 / 大小 / 必填项不合规 F32 / A35
未配置态 sent: false 与原因 未设置 ESP32_ENDPOINT F37
掩码态 只回密钥掩码 读取 Provider 配置 F31 / A34
键盘焦点态 :focus-visible 焦点框 Tab / Enter / Space F29 / A32

关键文案与字段(取自 static/index.html)

位置 字段 文案
P02 chatInput 输入课程问题,或点右侧 🎤 语音输入(Chrome / Edge)…
P03 studySubject 默认 高等数学上册;placeholder 如:数学 / 高等数学上册
P04 sumText 在此粘贴课件或笔记文字…
P05 tutorText 在此粘贴题目…;按钮 辅导一下
P06 planSubject 考试科目,如:数据结构
P07 matTitle / matContent 资料标题(可选) / 粘贴本课程课件、笔记、重点…
P08 wqQuestion / wqUser / wqCorrect 错题题目 / 我的答案(可选) / 正确答案(可选)
P09 hwTask 复习任务名,如:复习第3章
P10 agentKey / agentSecret / agentModel / agentBaseUrl / agentTokenUrl 必填,如 sk-… / 千帆 API Key;仅文心旧版 WenxinWorkshop 需要;留空用默认:ernie-3.5-8k / moonshot-v1-8k;可选;千帆 v2 或自定义端点必填;仅文心旧版需要,可留空
全局 校验与限制 课程不存在,请先选择或新建课程;资料白名单 .txt/.md/.markdown/.docx、≤ 2 MB、≤ 2 万字

组件命名:统一 v15- 前缀,包括 v15-input、v15-big-textarea、v15-mic-btn(覆盖 5 处输入)、v15-action-btn、v15-result、v15-course-bar、v15-material-list、v15-stat-card × 6、v15-pomodoro、v15-provider-card × 6、v15-status-board。

1.3 后台管理原型

原型含 M01 – M05 共 5 个后台管理页,与前台同处一套原型、共用预览链接。V1.5.0 为单机单用户课程作业,暂无登录与权限体系;管理页只重组真实存在的操作,所有对象与路由可在 static/index.html 与 server.py 中核对。

页号 管理页 真实承载位置 可管理对象 关键规则
M01 课程与资料管理 顶栏课程条、#memory 课程新建 / 切换、资料粘贴 / 上传 / 查看 / 下载 /api/courses、/api/courses/{id}/materials、.../upload;课程名唯一非空;资料白名单与大小限制;课程不存在返回 400
M02 智能体运行配置 #settings 6 个 Provider 的密钥 / 模型 / 地址、激活项、自检 /api/agent/providers、/credentials、/test;优先级 运行时 SQLite > .env > demo;只回掩码
M03 运行状态与硬件看板 #hardware、#dashboard 版本指纹、Provider 状态、复习 / 专注状态、手动提醒 /api/status、/api/providers、/api/hardware/*、/api/focus/state;未配置返回 sent: false
M04 复习任务与专注管理 学习概览待复习区、#plan 任务增删与完成、逐日计划、专注记录 /api/review-tasks、/api/focus/sessions、/api/focus/state;每 30 秒扫描
M05 错题与归档管理 #wrong 错题录入、错因与变式题、掌握状态、筛选、导出 /api/wrong-questions、/analyze、/master、/export;写入前校验课程存在;无 DELETE 路由

原型图 5 后台管理 · 课程与资料管理

原型图 5 M01 课程与资料管理:界面、真实承载位置、字段 / 组件、状态、流程与需求核对卡。

原型图 6 后台管理 · 智能体运行配置

原型图 6 M02 智能体运行配置:6 个 Provider 状态卡、密钥掩码与自动回退演示模式。

1.4 关键交互与规则

机制 原型可见表现 规则
课程记忆绑定 顶栏课程选择条;问答页提示条 提问时把该课程资料拼入 system prompt;切课即切上下文,两门课互不串上下文(A05、A06)
上下文预算 资料较多时回答仍可用 单份截取前 4000 字,总预算 12000 字;超预算提示已展示份数(A36)
安全 Markdown 问答 / 总结 / 计划 / 资源包富文本 escape-first:先转义再替换标记;注入串输出为文本(A30、A34)
忙碌态 请求期间按钮置灰并显示状态文案 5 个资源包按钮统一禁用 / finally 恢复(A31)
接口异常降级 故障后端下页面仍可切换标签 事件绑定先于请求,逐模块 safe() 降级(A33)
资料校验 非法类型 / 超限给出明确文案 .txt/.md/.markdown/.docx、2 MB、2 万字;课程不存在返回 400
导出健壮性 下载失败只提示 fetch + blob + URL.createObjectURL,失败不替换当前页面(A39)
键盘可达 卡片与上传区有焦点框 tabindex、role、aria-label、Enter / Space 与 :focus-visible(A32)

错误码:200 成功;400 参数校验失败;404 未知路径;厂商异常转降级文案,不抛 5xx。请求 / 响应为 JSON,上传为 multipart/form-data,下载带 Content-Disposition。

1.5 UI 美观与一致性

主色 #2F6FED(CSS 变量 --primary),与项目标志及图表配色一致。主题含跟随系统 / 浅色 / 深色三档与 6 套预设色,写入 localStorage,首屏内联脚本在样式加载前确定主题。卡片统一圆角、留白与 1 px 边框;表格、代码块、引用、列表有独立 .md 排版样式;SVG 思维导图跟随主题变量。

1.6 硬件原型连接图

图 7 硬件原型连接图

图 7 硬件连接图:前端「硬件联动」页 ↔ server.py 的 /api/hardware/* ↔ Wi-Fi / HTTP Webhook ↔ ESP32 固件 ↔ LED / 蜂鸣器;6 个交互点为到点提醒、测试提醒、番茄钟提醒、专注状态灯、学习状态看板和通用消息预留。

作业原文为「硬件原型照片或连接图」,图 7 已满足该项。图中接口与固件齐备,但 ESP32 未实机联调,物理声光效果未验证;连接图不冒充实物照片。

1.7 重要特点

  1. 课程记忆绑定与隔离(F06 / F33):课程为一等对象,资料全文由 build_course_context(course_id) 拼入 system prompt 后交给 AgentProvider;切课即切记忆。这是智能体嵌入自研系统的代码证据,演示模式即可复现。
  2. 无密钥自动回退(F23 / C05):Provider 未配置或异常时回退 DemoProvider,响应带 fallback 标记,流程不中断。
  3. 单一零依赖后端(C01 / C02):只有 server.py 一个 HTTP 入口,仅用 Python 标准库,python server.py 启动,无需安装依赖。
  4. escape-first 安全 Markdown(F27 / F31 / C07):进入 innerHTML 的内容先转义,SQL 全部参数化;故障注入与无头浏览器对照确认载荷不再执行。

二、概要设计(权重 40%)

2.1 功能模块与系统结构

图 9 功能思维导图

图 9 V1.5.0 功能思维导图:中心为 AI 校园学习陪伴助手,六个分支为核心学习功能(F01 – F04)、杀手级功能(F05 – F11)、学习资源包(F13 – F19)、可插拔智能体(F20 – F23)、体验与健壮性(F24 – F36)、硬件联动(F37,未实机)。

图 10 类图

图 10 类图:AgentProvider 抽象与 6 个实现、ProviderFactory 与配置中心、8 个业务服务模块、单一 HTTP 入口、8 张数据实体及前端 10 个模块的关系。

2.2 UML 图

图 视角 回答的问题
图 1 用例图 需求分析 谁用系统、各自能做什么
图 2 活动图 业务流程 课程复习从资料到归档如何流转、失败如何回退
图 3 时序图 重要算法模块 课程记忆问答对象间消息的时间顺序
图 4 协作图 对象协作 一键生成资源包时对象间链接与消息传递

图 1 用例图

图 1 用例图:在校学生、教师 / 助教、开发者 / 维护者三类参与者与系统边界内的用例;「课程内智能问答」包含「课程与资料管理」,「模型接入与运行时配置」扩展「课程内智能问答」。

图 2 活动图

图 2 活动图:选择课程 → 上传或粘贴资料 → 校验判定(不通过则提示并重新上传)→ 生成课程记忆上下文 → 智能问答 / 总结与资源包 / 错题分析并行 → 生成复习计划 → 30 秒扫描提醒 → 标记掌握与导出。

图 3 时序图

图 3 时序图:学生 → 前端 → Handler → services/tasks.py → services/course.py → db.py → AgentProvider → 厂商 / DemoProvider,共 14 条消息;«alt» 区分有密钥与无密钥 / 异常回退。

图 4 协作图

图 4 协作图:以「一键生成学习资源包」为例,8 个对象间的链接与 8 条编号消息;模型不可用或超时时回退内置结构化知识库。

2.3 数据库概要

图 5 ER 图

图 5 ER 图:Course 与 CourseMaterial、Conversation、WrongQuestion、ReviewTask、FocusSession 为 1 : N;Setting 与 ProviderCredential 为独立全局实体。SQLite 默认未启用外键,资料与错题由业务层校验课程存在性,拒绝孤儿数据(F32 / A35)。

关系数据模型(主键、外键与可空性以 DDL 为准):

courses(id PK, name UK NOT NULL, created_at NOT NULL)
course_materials(id PK, course_id FK NOT NULL, title, content NOT NULL, created_at NOT NULL)
conversations(id PK, course_id FK NOT NULL, role NOT NULL, content NOT NULL, created_at NOT NULL)
wrong_questions(id PK, course_id FK NOT NULL, question NOT NULL, user_answer, correct_answer,
                error_reason, mastered NOT NULL DEFAULT 0, created_at NOT NULL)
review_tasks(id PK, course_id FK NULL, task_name NOT NULL, due_time NOT NULL,
             notified NOT NULL DEFAULT 0, created_at NOT NULL)
settings(key PK, value)
focus_sessions(id PK, course_id FK NULL, minutes NOT NULL, note, started_at, ended_at, created_at NOT NULL)
provider_credentials(provider PK, data NOT NULL, updated_at NOT NULL)
实体类 库表 主要服务模块 说明
Course courses services/course.py 课程记忆的隔离单元,课程名唯一且非空
CourseMaterial course_materials course.py、files.py 资料全文,上传后进入该课程上下文
Conversation conversations tasks.py 课程内对话历史
WrongQuestion wrong_questions wrong_questions.py 错题、错因、变式题与掌握状态
ReviewTask review_tasks focus.py、hardware/esp32.py 复习任务与提醒状态,course_id 可空
Setting settings config.py、agents/credentials.py 全局键值,含激活 Provider 与专注状态
FocusSession focus_sessions focus.py 一次专注记录
ProviderCredential provider_credentials agents/credentials.py 运行时密钥与地址,只回掩码

数据规模定位为单机单库原型,不承诺多用户、分库分表或海量数据性能。

2.4 后端设计

图 6 后端分层与请求分发设计图

图 6 后端分层与请求分发(L1 层次视图):客户端经 server.py 的 Handler 按 ROUTES 分发到 8 个业务服务模块,按需调用智能体层,业务数据落到 SQLite 8 张表;后台线程每 30 秒扫描到期任务。

图 8 系统架构图

图 8 系统架构(L0 整体视图):浏览器经 REST 访问单一入口,服务层、智能体层、数据层与可选硬件层在同一进程内协同。

  • 接入层:ThreadingHTTPServer + Handler;ROUTES 为「方法 / 正则路径 / 处理函数」三元组;返回普通 dict(JSON)、Download 或 Raw。
  • 业务服务层(8 模块):course、tasks、wrong_questions、files、focus、subject_knowledge、study、mindmap。
  • 智能体层:AgentProvider 定义 is_available()、complete()、_call()、probe();factory._PROVIDERS 注册 6 项;厂商 HTTP 走标准库 urllib。
  • 数据层与调度:db.py 的 SCHEMA 定义 8 张表,get_conn() 设超时与 busy_timeout;后台线程每 30 秒调用 check_due_tasks()。

三、团队协作记录

3.1 按周计划表

W1 – W4 为阶段编号,不是教学周次。已完成日期取自 git log,课程校历未提供,不推测教学周次。

阶段 真实日期 里程碑 主要产出 状态
W1 2026-11-05 选题与需求落地;原型与核心流程尽早打通;V1.0 上线 选题报告、SRS 初版、可运行系统、demo_check.py、答辩 PPT 已完成
W1 2026-11-06 架构收敛为单一零依赖后端;V1.5.0 验收基线 移除 Flask app.py、四套回归、SRS 按国标重写、技术复盘长文 已完成
W2 2026-11-08 答辩材料与文档口径统一 28 页答辩 PPT,README / 自检报告 / SRS 同步 已完成
W4 2026-11-14 ~ 2026-11-21【重点 · R07】 第二次团队作业:原型设计与概要设计定稿 本文、两份说明书 PDF、原型预览、提交清单、合规检查表、界面与原型图 已定稿
W3 2026-11-09 ~ 2026-11-13【重点 · R07】 杀手级功能深化:长文档记忆与多用户方向(计划,非 V1.5.0 已实现能力) 计划产出:上下文预算方案与压力用例、多用户数据模型草案、对应回归脚本(均为计划) 计划

【重点 · R07】需补:课程校历或周次对照表与可判定验收指标;日期已明确:W3(杀手级功能深化)11-09~11-13、W4(第二次团队作业)11-14~11-21。

3.2 团队分工书面说明

分工延续第一次团队作业的队内角色约定,按「后端与质量保障 / 前端与交互体验」两条线推进,以 SRS 第 6 章的 40 条 REST 接口全表为共同契约。

陈明凯(3124004503)负责后端与质量保障。 承担 server.py 的 40 条路由、multipart 上传、Download / Raw 响应与到期任务扫描;db.py 的 8 张表;config.py、version.py、launch.py;agents/ 的 6 类 Provider 抽象与工厂;services/ 的 8 个服务模块;hardware/ 的 ESP32 接口与固件。交付包括 REST 接口全表、上下文预算(单份 4000 字、总量 12000 字)、可插拔智能体与自动回退、参数化 SQL 与孤儿数据拦截、四套回归脚本及 JSON 结果,并撰写 SRS 第 5、6、9、10 章。证据为 docs/*_results.json 及 _线上 副本、SRS 10.5 实测表。

邓文炜(3124004505)负责前端与交互体验。 承担 static/index.html 的 10 个页面、static/css/style.css 的主题与 Markdown 排版,以及 static/js/app.js 的 API 封装、渲染器、上传下载、主题、语音、番茄钟、思维导图与导出。交付包括 10 个可操作页面、深浅色与 6 套主题色、escape-first 安全 Markdown、忙碌态与异常降级、键盘可达性、界面截图与 28 页答辩 PPT。证据为 docs/ui/*.png、docs/pptx/team_v15/、node --check 结果及 SRS 第 8 章。

共同职责。 两人共同承担需求讨论、回归复验与文档一致性核对:需求变更只修改 SRS 单一源再重生成 .docx;每次版本升级后分别复跑四套回归并交叉核对界面、接口与说明书。本次原型同样由后端线核对路由、字段与边界,前端线核对控件、状态与交互动作。GitHub 账号见 3.4。

3.3 协作过程记录

  • 按双线并行推进,接口以 SRS 第 6 章 40 条 REST 全表为契约;需求变更只改 SRS 单一源后重生成 .docx。
  • 过程留痕:Git 提交历史、SRS 0.2 迭代记录表、四套回归结果 JSON 与 _线上 副本、docs/自我检查报告.md 第十 / 十一节。计数随提交递增,以提交前实测为准。
  • 分工记录:见 3.2 书面分工说明与上述过程留痕,内容可核验,无缺口。

四、交付地址与下载 / 预览链接

项 地址
GitHub 团队仓库 https://github.com/kecit33/ai-agent-study
原型在线预览 / 分享链接 https://modao.cc/proto/zhsPz0tourxb68EcNCVE/sharing?view_mode=read_only&screen=llmVbc4XXaOMwo2Ij (备注:「校园AI陪伴助手-分享」;只读分享,无需分享密码;16 页:P00 信息架构 + P01 – P10 前台 + M01 – M05 后台管理)
本地可交互走查版 modao_v150/交互走查版.html(浏览器直接打开,不依赖网络与后端)
可运行系统在线试用 https://ai-campus-companion.app.workbuddy.host/?sharecode=CEUN7FBTFJ (可运行系统入口,非在线原型预览)
系统设计说明书 点击下载系统设计说明书
数据库设计说明书 点击下载数据库设计说明书
posted @ 2026-11-22 01:44  邓文炜  阅读(5)  评论(0)    收藏  举报