xiaozhidaoyuanxing1
架构
"小智导"智慧学工小程序 · 交互原型文档
阶段产物 · 原型交互验证期 文档版本:v2.0 · 2026-07-01 适用范围:
/student_affairs_proto/目录下全部 52 个静态 HTML 页面 阅读约定:每个场景按 【起点页面 → 点击动作 → 到达页面 → 视觉反馈/操作说明】 描述,所有功能点均来源于《"小智导"程序开发服务项目申报书 10.0》
1. 文档说明
- 本文档用途:支撑学生开发团队、项目负责人对照剧本逐路径完成交互走查,确认原型中每个可点击元素(按钮、卡片、列表项、链接)能到达预期页面。
- 验证通过判定:剧本中每一步描述的跳转结果与原型实际点击结果一致,即视为通过。
- 不在原型验证范围:后端逻辑、API 契约、数据持久化、真实登录校验、微信/短信触达、审计日志写入、安全加密机制、多端适配(原型按 375×812 移动端尺寸渲染)。
2. 公共场景
场景 1:应用启动与隐私政策查看
- 起点:浏览器打开
index.html:展示「学工助手」Logo、标题、副标题"智能技术学部 · 智慧学工小程序"。 - 看到首屏主按钮 账号登录 与底部隐私提醒条"登录及查看敏感字段将记入审计日志,留存 365 天"。
- 点击底部 《用户协议与隐私政策》 链接 →
privacy_policy.html:展示完整协议文本,包含账号体系、密码管理、角色权限、数据加密(AES 加密手机号等敏感字段)、审计日志保留期限等条款。 - 点击浏览器返回 → 返回
index.html。
场景 2:登录与角色分流(含登录失败锁定)
- 起点:
index.html点击 账号登录 主按钮 →login.html:顶部 Logo + 品牌区,角色 Tab 默认选中「辅导员」。 - 切换角色 Tab 至 学工书记:Tab 高亮蓝色,URL 不变但
currentRole状态切换。 - 切换角色 Tab 至 技术人员:同上。
- 切回 辅导员 Tab:Tab 恢复蓝色高亮。
- 在账号输入框输入 1 位字符后清空:用于演示输入占位,无校验。
- 在密码输入框输入密码并点击右侧 眼睛图标:密码明文显示,图标切换为「闭眼」图标。
- 再次点击眼睛图标:密码恢复掩码。
- 输入账号 + 少于 6 位密码 + 点击 登录:弹出红色错误提示"密码长度不少于 6 位"(前端校验,模拟申报书"密码长度不少于 6 位"的安全要求)。
- 输入正确账号 + 错误密码 + 点击 登录:弹出"账号或密码错误"错误提示。
- 连续 5 次输入错误密码:弹出红色锁定横幅"账号已被锁定,请于 30 分钟后再试,或联系学工书记重置密码"(模拟申报书"连续登录失败锁定"机制,锁定时长 30 分钟)。
- 输入正确账号密码 + 点击 登录:根据当前 Tab 角色,跳转至对应工作台(见场景 3/16/23)。
- 点击 忘记密码 链接 →
counselor_password_reset.html:展示密码找回引导页,说明应联系学工书记或技术人员后台重置。 - 点击 《用户协议与隐私政策》 底部链接 →
privacy_policy.html:与场景 1 第 3 步一致。
场景 3:首次登录强制密码重置(机制说明)
- 起点:
login.html输入新下发账号密码(系统标记force_reset=true)+ 点击 登录 →counselor_workbench.html:工作台顶部弹出密码重置引导条。 - 点击引导条 → 弹出密码重置弹窗:输入原密码 + 新密码(≥6 位)+ 确认新密码。
- 点击 确认:密码以哈希算法写入后端(原型阶段只演示弹窗 UI),工作台顶部引导条消失。
- 此场景验证申报书"辅导员首次登陆后强制重置密码,密码采用哈希算法生成"的机制。
3. 辅导员场景
场景 4:辅导员工作台首页
- 起点:
counselor_workbench.html:顶部问候"早上好,{姓名}",中部 9 个常用功能卡片(学生管理 / 工作日志 / 异常情况 / 提醒推送 / 班级异常看板 / 自定义模块 / 晚归 / 数据导入 / 统计),底部 Tab 5 个(首页 / 学生 / 工作 / 异常 / 我的)。 - 点击 学生管理 卡片 →
counselor_students.html。 - 点击 工作日志 卡片 →
counselor_logs.html。 - 点击 异常情况 卡片 →
counselor_anomalies.html。 - 点击 提醒推送 卡片 →
counselor_reminders.html。 - 点击 班级异常看板 卡片 →
counselor_class_anomaly_board.html。 - 点击 自定义模块 卡片 →
counselor_custom_modules.html。 - 点击 晚归 卡片 →
counselor_late_returns.html。 - 点击 数据导入 卡片 →
counselor_imports.html。 - 点击 统计 卡片 →
counselor_statistics.html。 - 底部 Tab 点击 首页 → 停留当前页(active 高亮)。
- 底部 Tab 点击 学生 →
counselor_students.html。 - 底部 Tab 点击 工作 →
counselor_log_edit.html(快速记录入口)。 - 底部 Tab 点击 异常 →
counselor_anomalies.html。 - 底部 Tab 点击 我的 →
counselor_profile.html。
场景 5:功能模块授权可见性(机制演示)
- 起点:
counselor_workbench.html:9 个功能卡片均可见(假设此辅导员已授权全部模块)。 - 模拟场景:若某辅导员未被授权"提醒推送"模块,登录后工作台不显示该卡片,底部 Tab 与快捷区均不出现入口,菜单中也不可访问对应 URL。
- 此机制对应申报书"未授权的功能模块不在小程序首页和菜单中显示,避免无关功能干扰用户使用,也减少越权访问风险"。
- 验证方法:在原型中临时将
counselor_workbench.html内"提醒推送"卡片注释后刷新页面,确认卡片消失且对应跳转不可达。
场景 6:学生信息管理(查询 / 详情 / 宿舍)
- 起点:
counselor_workbench.html点击 学生管理 卡片 →counselor_students.html:展示所带班级学生列表,每行展示学号、姓名、班级、宿舍号。 - 在搜索框输入 学号(如 2024001):列表实时过滤,命中行高亮。
- 清空搜索框,输入 姓名(如"张"):列表按姓名模糊匹配。
- 清空,输入 班级(如"智能2401"):列表按班级过滤。
- 清空,输入 宿舍号(如"5#301"):列表按宿舍号过滤。
- 清空,输入 关键词 跨字段匹配:搜索覆盖以上所有字段。
- 点击某学生行 →
counselor_student_detail.html:聚合展示基础信息(学号、姓名、班级、性别、联系方式(默认脱敏显示中间 4 位 ****)、政治面貌、宿舍号)、谈心谈话记录、异常情况记录、风险预警记录、工作日志合集。 - 在学生详情页点击 联系方式 旁的"查看完整"按钮:触发敏感字段访问,后端记录至
audit_logs(原型阶段仅展示按钮),字段展开完整 11 位手机号。 - 在学生详情页点击 宿舍信息 →
counselor_student_dorm.html:展示宿舍号、床位号、室友列表(其他 3-5 位室友)。 - 在宿舍详情页点击 该生晚归记录 →
counselor_late_returns.html:跳转晚归模块并自动按该生过滤。 - 在宿舍详情页点击 为该生记录日志 →
counselor_log_edit.html:自动带入该生作为关联对象,标题与内容可填写。 - 返回学生详情页,点击左上角返回箭头 → 返回
counselor_students.html。 - 在学生列表页点击右上角 导入学生 →
counselor_imports.html→counselor_import_students.html:上传 Excel,字段映射(学号 / 姓名 / 班级 / 性别 / 联系方式 / 政治面貌 / 宿舍号),预览确认后导入。 - 导入完成后返回
counselor_students.html:新学生行出现在列表顶部。 - 此场景覆盖申报书"学生信息管理:Excel 批量导入、多条件检索、学生详情聚合、字段脱敏"全部要求。
场景 7:工作日志管理(5 类日志 + 编辑)
- 起点:
counselor_workbench.html点击 工作日志 卡片 →counselor_logs.html:顶部 5 个 Tab(谈心谈话 / 进宿舍 / 进课堂 / 组织班会 / 班干会议),覆盖申报书要求的全部 5 类日志。 - 点击 谈心谈话 Tab:列表展示该类日志,每行展示标题、时间、地点、关联学生、跟进状态。
- 切换至 进宿舍 Tab:列表内容切换,展示该类日志。
- 依次切换 进课堂 / 组织班会 / 班干会议:每次列表内容对应刷新。
- 在某 Tab 下点击 新建日志 →
counselor_log_edit.html:表单字段包含标题、时间、地点、关联班级或学生、工作内容(多行文本)、后续跟进事项、上传图片佐证(jpg / png / gif,≤10MB)。 - 在编辑页填写各字段 + 上传一张图片:图片缩略图显示在内容区下方。
- 点击 保存 → 返回
counselor_logs.html并停留当前 Tab,新日志出现在列表顶部。 - 点击列表中某条日志行 → 进入该日志详情(页面内嵌展示或弹出层)。
- 点击列表项 编辑 按钮 →
counselor_log_edit.html:复用编辑能力,字段已回填。 - 此场景覆盖申报书"工作日志管理:5 类日志分类、字段齐全、图片佐证"全部要求。
场景 8:工作日志导出(Excel / Word / PDF)
- 起点:
counselor_logs.html点击右上角 导出 按钮 →counselor_work_log_export.html:展示导出配置页。 - 选择时间范围:本月 / 本学期 / 本学年度(申报书要求"按月、学期、年度进行汇总查询并导出")。
- 选择日志类别:单选或全选 5 类。
- 选择导出格式:Excel(.xlsx)/ Word(.docx)/ PDF(.pdf)三选一。
- 点击 生成文件:进度条显示处理中(模拟),完成后弹出下载链接。
- 此场景覆盖申报书"工作日志支持按月、学期、年度进行汇总查询,并可根据工作需要导出为 Excel、Word 或 PDF 文件"要求。
场景 9:数据导入中心
- 起点:
counselor_workbench.html点击 数据导入 卡片 →counselor_imports.html:列出四类导入入口(导入学生 / 导入宿舍 / 导入门禁晚归 / 导入辅导员映射)。 - 点击 导入学生 →
counselor_import_students.html:选择 Excel 文件,字段映射页展示 7 列(学号 / 姓名 / 班级 / 性别 / 联系方式 / 政治面貌 / 宿舍号),可预览前 10 行。 - 预览无误后点击 确认导入:进度条显示,成功后弹出导入成功提示。
- 返回导入中心,点击 导入宿舍 →
counselor_import_dorm.html:上传宿舍映射 Excel(字段:宿舍号 / 床位号 / 学号),预览后确认。 - 返回导入中心,点击 导入门禁/晚归 →
counselor_import_gate.html:上传门禁/晚归 Excel(字段:学号 / 日期 / 时间 / 门禁位置)。 - 返回导入中心,点击 导入辅导员映射 →
counselor_import_counselor_map.html:上传辅导员-班级映射表(字段:辅导员姓名 / 班级)。 - 各导入页完成后均返回
counselor_imports.html或对应业务页面。 - 此场景覆盖申报书"Excel 批量导入"全部要求。
场景 10:异常情况管理(红黄蓝三档 + 跟进状态)
- 起点:
counselor_workbench.html点击 异常情况 卡片 →counselor_anomalies.html:顶部 3 个风险等级筛选器(红色重点关注 / 黄色一般关注 / 蓝色普通提醒),对应申报书要求的"红、黄、蓝三档风险等级"。 - 默认选中"全部",列表展示所有异常记录,每行展示学生姓名、学号、异常类型(晚归/心理预警/学业警告)、风险等级标签、跟进状态。
- 点击 红色 筛选器:列表仅展示红色风险异常。
- 点击 黄色 筛选器:列表仅展示黄色风险异常。
- 点击 蓝色 筛选器:列表仅展示蓝色风险异常。
- 点击列表中某条异常 →
counselor_anomaly_detail.html:展示异常详情(时间、类型、原始数据来源、风险等级、当前跟进状态)。 - 跟进状态枚举:已关注 / 已约谈 / 已结案(申报书要求"辅导员可根据学生实际情况对异常记录进行标记")。
- 详情页底部展示跟进记录区,按时间倒序记录每次干预措施、谈话情况、后续观察意见。
- 点击 标记已关注 按钮:状态切换为"已关注",操作记录新增一条(原型不持久化)。
- 点击 标记已约谈 按钮:状态切换为"已约谈",弹出约谈记录输入框(时间、内容、后续跟进事项)。
- 点击 标记已结案 按钮:状态切换为"已结案",需填写结案意见。
- 在异常详情页点击 查看学生档案 →
counselor_student_detail.html:跳转至该生详情聚合页,可联动查看该生其他异常与日志。 - 返回异常列表,点击右上角 班级异常看板 →
counselor_class_anomaly_board.html:见场景 11。 - 此场景覆盖申报书"异常情况管理:晚归/心理/学业三类型、红黄蓝三档、跟进状态、关联学生档案"全部要求。
场景 11:班级异常看板
- 起点:
counselor_workbench.html点击 班级异常看板 卡片 →counselor_class_anomaly_board.html:展示按 班级、年级、异常类型、风险等级 四个维度的可视化看板。 - 顶部维度切换:点击 班级 Tab → 横向柱状图展示各班级异常数量。
- 切换至 年级 Tab → 柱状图按年级聚合。
- 切换至 异常类型 Tab → 饼图展示晚归/心理/学业三类占比。
- 切换至 风险等级 Tab → 饼图展示红/黄/蓝三档占比。
- 点击柱状图某班级柱 → 下钻至该班级异常明细列表(页面内展开,不跳转)。
- 此场景覆盖申报书"班级异常看板,按照班级、年级、异常类型、风险等级等维度展示异常情况分布"要求。
场景 12:晚归记录专项
- 起点:
counselor_workbench.html点击 晚归 卡片 →counselor_late_returns.html:专项展示晚归记录列表。 - 列表行展示学生姓名、日期、晚归时间、门禁位置、当前风险等级。
- 点击某条记录 →
counselor_anomaly_detail.html:复用异常详情组件。 - 在晚归页点击 导入 按钮 →
counselor_imports.html:跳入导入中心,可选择"导入门禁/晚归"。 - 此场景覆盖申报书"晚归数据专项管理"要求。
场景 13:提醒推送管理(创建 / 详情 / 日志)
- 起点:
counselor_workbench.html点击 提醒推送 卡片 →counselor_reminders.html:展示已创建提醒列表。 - 点击右上角 新建提醒 →
counselor_reminder_create.html:表单字段包含提醒标题、提醒时间、提醒内容、关联班级或学生、提醒方式(提前 30 分钟 / 提前 1 小时,申报书要求"两档提醒方式")。 - 选择关联对象:单选班级或多选学生。
- 选择提醒方式:30 分钟 / 1 小时:申报书明确要求"提前30分钟和提前1小时两档提醒方式"。
- 提醒渠道:默认勾选 微信订阅消息(主渠道)+ 短信兜底(申报书要求"微信订阅消息为主,同时设置短信兜底机制")。
- 点击 保存 → 返回
counselor_reminders.html,新提醒出现在列表顶部。 - 点击列表中某条提醒 →
counselor_reminder_detail.html:展示详情、历史发送状态、最近一次提醒时间。 - 在详情页点击 编辑 →
counselor_reminder_create.html:复用编辑能力,字段回填。 - 在详情页点击 提醒日志 →
counselor_reminder_logs.html:展示该提醒历次发送日志,字段包含提醒事项、发送时间、发送对象、发送状态、失败原因、是否已读(申报书明确字段要求)。 - 在提醒日志页点击 返回 → 返回
counselor_reminders.html。 - 此场景覆盖申报书"提醒推送:微信订阅消息+短信兜底、30 分钟/1 小时两档、提醒日志字段齐全"全部要求。
场景 14:自定义模块管理(模块 / 记录 / 富文本)
- 起点:
counselor_workbench.html点击 自定义模块 卡片 →counselor_custom_modules.html:展示该辅导员已创建的个性化模块列表(默认示例 3 个:M001 我今天的工作心得 / M002 班会反思 / M003 重点学生观察)。 - 点击模块 M001 →
counselor_custom_module_records.html?mid=M001:展示该模块下的记录列表,按时间倒序排列。 - 点击某条记录 →
counselor_custom_record_edit.html?mid=M001&rid=xxx:进入富文本编辑页。 - 富文本编辑器支持:文字输入 + 图片插入(富文本内容,"便于辅导员完整记录工作过程、反思体会和学生成长变化")。
- 图片上传方式一:点击 上传图片 按钮 → 从本地相册/文件选择图片(jpg/png/gif,单张 ≤10MB)。
- 图片上传方式二(电脑端):截图后 Ctrl+V 粘贴,剪贴板图片自动识别并上传。
- 图片上传方式三(手机端):长按文本区域 → 弹出粘贴菜单 → 选择"粘贴"。
- 输入文字 + 插入 1 张图片 → 点击 保存 → 返回
counselor_custom_module_records.html,新记录出现在列表顶部。 - 返回自定义模块页,点击 新建模块 → 弹出创建弹窗(模块名称、模块用途),保存后出现在列表。
- 在某模块下点击 新建记录 →
counselor_custom_record_edit.html?mid=xxx(不带 rid):新建空白富文本。 - 在记录列表点击 删除:弹出确认弹窗,确认后该记录从列表移除。
- 隐私机制:其他辅导员登录后查看自己的
counselor_custom_modules.html,看不到 当前辅导员创建的模块与记录(申报书要求"模块与记录默认仅创建者本人可见")。 - 学工书记查看:默认不可见,需通过授权方式查看(原型阶段不演示授权弹窗)。
- 此场景覆盖申报书"自定义模块管理:自主创建、富文本+图片、3 种图片上传方式、≤10MB、模块默认仅创建者可见"全部要求。
场景 15:个人统计与查询
- 起点:
counselor_workbench.html点击 统计 卡片 →counselor_statistics.html:展示个人维度统计,字段包含工作日志数量、谈心谈话覆盖率、所带班级异常趋势、重点学生跟进情况。 - 顶部时间筛选:本月 / 本学期 / 本学年度:图表与数值同步刷新。
- 切换管理维度:按班级 / 按年级:视图切换。
- 点击 查看明细 按钮:跳转到对应的日志或异常列表进行交叉查看。
- 此场景覆盖申报书"统计与查询:辅导员维度"全部要求。
场景 16:个人中心与账号安全
- 起点:
counselor_workbench.html底部 Tab 我的 →counselor_profile.html:展示辅导员姓名、所属学部、所带班级、角色类型("辅导员")。 - 点击 设置 →
counselor_settings.html:进入通用设置页。 - 在设置页点击 关于 →
counselor_about.html:展示版本号 v1.0.0、版权"© 2026 学工助手数字化研究室"。 - 返回个人中心,点击 我的班级 →
counselor_my_classes.html:展示所带班级列表(智能2401 / 智能2402 等)。 - 在 我的班级 页点击某班级 → 返回
counselor_students.html并按该班级过滤。 - 返回个人中心,点击 账号安全 →
counselor_account_security.html:展示密码修改入口、登录失败锁定策略、最近登录时间、登录设备列表。 - 在账号安全页点击 微信绑定 →
counselor_wechat_binding.html:展示微信账号绑定状态。 - 若未绑定:页面展示 一键绑定 按钮,点击后模拟调起微信授权,授权完成后页面显示已绑定的微信昵称与头像。
- 若已绑定:页面展示解绑按钮 + 已绑定信息;点击解绑弹出确认弹窗,确认后解除绑定。
- 绑定后,下次登录密码正确后系统可识别
wechat_bound=true,支持微信一键登录(原型仅展示按钮与状态)。 - 此场景覆盖申报书"微信身份绑定"与"账号安全"要求。
4. 学工书记场景
场景 17:学工书记工作台首页
- 起点:
login.html切换至 学工书记 Tab + 输入正确账号密码 + 点击 登录 →secretary_workbench.html:顶部"学部主任视图",中部卡片展示本学部全局看板。 - 看板卡片:辅导员工作量排名 / 班级异常情况分布 / 异常类型占比 / 风险等级变化趋势 / 异常热力图。
- 点击 辅导员管理 卡片 →
secretary_counselors.html。 - 底部 Tab 辅导员 / 异常 / 统计 / 我的 可自由切换。
场景 18:辅导员账号新建与管理
- 起点:
secretary_workbench.html点击 辅导员管理 卡片 →secretary_counselors.html:展示本学部所有辅导员列表。 - 点击右上角 新建辅导员 →
secretary_counselor_new.html:表单字段包含姓名、所属学部、所带班级、角色类型(默认辅导员)、功能模块初始权限。 - 点击 生成初始密码:系统自动生成 6 位以上随机密码(哈希后存储),弹窗展示明文密码供书记记录并下发。
- 点击 保存 → 返回
secretary_counselors.html,URL 带?toast=created,新辅导员出现在列表顶部,顶部弹出"创建成功"提示 Toast。 - 点击列表中某辅导员行 →
secretary_counselor_detail.html:展示账号信息(姓名、学号/工号、所属学部、所带班级、角色、功能模块权限、最近登录时间)。 - 在详情页点击 重置密码 →
secretary_counselor_reset.html:可选择"生成新随机密码"或"手动输入新密码"。 - 点击 确认重置 → 弹窗展示新密码明文,书记记录后下发,操作写入
audit_logs→ 返回secretary_counselor_detail.html。 - 此场景覆盖申报书"密码管理机制:由学工书记对本学部所辖辅导员账号进行密码重置,操作完整记录到操作日志"要求。
场景 19:辅导员功能模块授权与权限配置
- 起点:
secretary_counselor_detail.html→ 点击 权限配置 →secretary_counselor_permissions.html:展示 7 个功能模块复选框(学生管理 / 工作日志 / 异常预警 / 提醒推送 / 自定义模块 / 数据导入 / 统计)。 - 取消勾选"提醒推送"模块 + 点击 保存 → 返回
secretary_counselor_detail.html,URL 带?toast=perm,顶部弹出"权限已更新"Toast。 - 该辅导员重新登录后,工作台 不再显示提醒推送卡片,菜单中也无法访问
counselor_reminders.html(验证场景 5 的授权机制)。 - 返回
secretary_workbench.html,底部 Tab 我的 →secretary_profile.html→ 点击 模块权限 →secretary_permissions.html:批量配置本学部辅导员的功能模块授权策略(如按年级、按班级)。 - 保存策略 → 批量生效。
- 此场景覆盖申报书"功能模块授权管理"与"未授权模块不在首页和菜单显示"全部要求。
场景 20:全局异常监控与下钻
- 起点:
secretary_workbench.html底部 Tab 异常 →secretary_anomalies.html:展示本学部全部异常记录(含所有辅导员所带班级)。 - 顶部可按 学部(默认本学部)/ 辅导员 / 班级 / 风险等级 / 时间范围 多维筛选。
- 点击某条异常 →
secretary_anomaly_detail.html:展示异常详情与跟进记录。 - 在异常详情页点击 查看所属辅导员 →
secretary_counselors.html并按该辅导员过滤(仅 URL 跳转,列表展示由前端实现过滤)。 - 在异常详情页点击 返回 → 返回
secretary_anomalies.html。 - 此场景覆盖申报书"学工书记查看本学部异常分布"要求。
场景 21:学部统计与报表导出
- 起点:
secretary_workbench.html底部 Tab 统计 →secretary_statistics.html:展示本学部统计看板(辅导员工作量排名、班级异常分布、异常类型占比、风险等级变化趋势、异常热力图)。 - 顶部时间筛选:本月 / 本学期 / 本学年度:看板同步刷新。
- 点击 导出报表 →
secretary_report_export.html:选择导出维度(按辅导员 / 按班级 / 按年级)、时间范围、文件格式(Excel / PDF)。 - 点击 生成报表:进度条显示,完成后弹出下载链接。
- 下载完成后返回 →
secretary_profile.html(个人中心)。 - 此场景覆盖申报书"学工书记维度统计与报表导出"要求。
场景 22:审计日志与预警规则
- 起点:
secretary_workbench.html点击 审计日志 卡片 →secretary_audit_logs.html:按时间、操作者、操作类型、操作对象等条件检索日志(申报书要求字段:"操作时间、操作者账号、操作者角色、操作类型、操作对象、操作IP、操作结果")。 - 顶部条件组合筛选:选择操作者 + 操作类型(账号创建 / 密码重置 / 权限调整 / 数据写操作)+ 时间范围。
- 点击 查询:列表刷新。
- 点击列表中某条日志:展开显示完整审计详情(含操作前后数据对比)。
- 底部 Tab 我的 →
secretary_profile.html→ 点击 预警规则 →secretary_alert_rules.html:配置红/黄/蓝三档风险阈值(如:单月晚归 ≥3 次触发黄色,≥5 次触发红色;连续 2 次心理预警触发红色)。 - 点击 保存规则:规则写入后端,所有异常记录按新规则重新打标。
- 此场景覆盖申报书"操作日志与安全审计(audit_logs,保留 365 天)"与"异常风险等级动态配置"要求。
5. 技术人员场景
场景 23:技术人员工作台与运维
- 起点:
login.html切换至 技术人员 Tab + 输入正确账号密码 + 点击 登录 →super_admin_workbench.html:展示平台运行状态卡片(云开发资源使用率、数据库容量、消息推送配额、最近 24h 异常告警数)。 - 底部 Tab 账号 / 审计 / 系统 / 首页 可自由切换。
场景 24:全平台账号管理
- 起点:
super_admin_workbench.html底部 Tab 账号 →super_admin_accounts.html:展示全平台所有账号(跨学部),字段包含账号、姓名、所属学部、角色、最近登录时间、状态(启用/停用)。 - 顶部可按 学部 / 角色 / 状态 筛选。
- 点击某账号行:展开显示账号详情,可执行 停用 / 启用 / 重置密码 / 调整角色 操作。
- 点击 新建账号:弹出创建弹窗(用于初始化超级管理员或紧急账号),填写后保存。
- 所有操作均记录至
audit_logs(原型阶段不演示后端写入)。 - 此场景覆盖申报书"技术人员 super_admin 主要负责小程序的日常运维工作"与"账号管理最高权限"要求。
场景 25:审计日志与系统配置
- 起点:
super_admin_workbench.html底部 Tab 审计 →super_admin_audit_logs.html:查看全平台操作日志(账号创建、密码重置、角色变更、权限调整、数据写操作),字段同场景 22 但范围为全平台。 - 顶部可按 学部 / 角色 / 操作者 筛选。
- 点击 导出审计:将审计日志导出为 Excel,用于合规检查与年度审计。
- 底部 Tab 系统 →
super_admin_system.html:展示云托管运行状态、数据库容量与连接池、对象存储用量、消息推送配额、缓存命中率等运维指标。 - 点击 查看运行日志:弹出抽屉展示最近 100 条系统日志(INFO / WARN / ERROR)。
- 点击 配置中心:进入配置页,可调整登录失败锁定阈值(如默认 5 次)、密码最小长度(默认 6 位)、审计日志保留天数(默认 365 天)、每日自动备份时间等。
- 保存配置 → 立即生效(原型仅展示 UI)。
- 此场景覆盖申报书"运维与支持:建立系统运行监测和问题响应机制"要求。
6. 跨角色联动场景
场景 26:密码重置跨角色流程
- 辅导员忘记密码 → 登录页点击 忘记密码 →
counselor_password_reset.html:查看密码找回引导,提示"请联系学工书记或技术人员后台重置"。 - 辅导员联系学工书记 → 学工书记登录 →
secretary_workbench.html→ 辅导员管理 →secretary_counselors.html→ 找到该辅导员 →secretary_counselor_detail.html→ 重置密码 →secretary_counselor_reset.html→ 生成新密码并下发。 - 辅导员使用新密码登录 →
login.html输入新密码 → 跳转counselor_workbench.html:登录成功。 - 审计日志验证:学工书记登录 → 审计日志 →
secretary_audit_logs.html:可查到该次密码重置记录(含操作者、被操作账号、操作时间、操作类型、操作 IP、操作结果)。 - 此场景覆盖申报书"密码管理机制:辅导员遗忘密码时,可向学工书记或技术人员申请后台重置,操作记录至 audit_logs"全流程。
场景 27:审计日志跨页查询
- 起点:
secretary_counselor_detail.html→ 点击 查看该辅导员审计 →secretary_audit_logs.html?filter=辅导员姓名:URL 带filter参数,列表自动按该辅导员过滤。 - 学工书记可继续在此页调整时间范围、操作类型等条件进行二次筛选。
- 此场景验证 URL 参数透传机制(场景 26 同源)。
场景 28:微信绑定跨登录流程
- 辅导员首次登录 →
counselor_workbench.html→ 我的 →counselor_profile.html→ 账号安全 →counselor_account_security.html→ 微信绑定 →counselor_wechat_binding.html。 - 点击 一键绑定 → 模拟微信授权 → 绑定成功,页面显示微信昵称与头像。
- 下次登录:输入账号密码 → 登录页提示"该账号已绑定微信,是否微信一键登录" → 点击 微信一键登录 → 直接进入工作台(无需再次输入密码)。
- 此场景覆盖申报书"微信身份绑定:辅导员首次使用账号密码登录系统后,可在个人中心完成微信账号绑定,实现后续微信一键登录"要求。
7. 全局页面清单(52 页)
| # | 角色 | 页面文件 | 名称 |
|---|---|---|---|
| 1 | 公共 | index.html |
启动页 |
| 2 | 公共 | login.html |
登录 |
| 3 | 公共 | privacy_policy.html |
用户协议与隐私政策 |
| 4 | 辅导员 | counselor_workbench.html |
工作台 |
| 5 | 辅导员 | counselor_students.html |
学生列表 |
| 6 | 辅导员 | counselor_student_detail.html |
学生详情 |
| 7 | 辅导员 | counselor_student_dorm.html |
学生宿舍详情 |
| 8 | 辅导员 | counselor_logs.html |
工作日志 |
| 9 | 辅导员 | counselor_log_edit.html |
日志编辑 |
| 10 | 辅导员 | counselor_work_log_export.html |
日志导出 |
| 11 | 辅导员 | counselor_anomalies.html |
异常情况 |
| 12 | 辅导员 | counselor_anomaly_detail.html |
异常详情 |
| 13 | 辅导员 | counselor_class_anomaly_board.html |
班级异常看板 |
| 14 | 辅导员 | counselor_late_returns.html |
晚归记录 |
| 15 | 辅导员 | counselor_reminders.html |
提醒事项 |
| 16 | 辅导员 | counselor_reminder_create.html |
创建提醒 |
| 17 | 辅导员 | counselor_reminder_detail.html |
提醒详情 |
| 18 | 辅导员 | counselor_reminder_logs.html |
提醒日志 |
| 19 | 辅导员 | counselor_custom_modules.html |
自定义模块 |
| 20 | 辅导员 | counselor_custom_module_records.html |
模块记录列表 |
| 21 | 辅导员 | counselor_custom_record_edit.html |
记录编辑 |
| 22 | 辅导员 | counselor_statistics.html |
个人统计 |
| 23 | 辅导员 | counselor_profile.html |
个人中心 |
| 24 | 辅导员 | counselor_my_classes.html |
我的班级 |
| 25 | 辅导员 | counselor_settings.html |
设置 |
| 26 | 辅导员 | counselor_about.html |
关于 |
| 27 | 辅导员 | counselor_account_security.html |
账号安全 |
| 28 | 辅导员 | counselor_wechat_binding.html |
微信绑定 |
| 29 | 辅导员 | counselor_password_reset.html |
密码重置(公共入口) |
| 30 | 辅导员 | counselor_imports.html |
导入中心 |
| 31 | 辅导员 | counselor_import_students.html |
导入学生 |
| 32 | 辅导员 | counselor_import_dorm.html |
导入宿舍 |
| 33 | 辅导员 | counselor_import_gate.html |
导入门禁/晚归 |
| 34 | 辅导员 | counselor_import_counselor_map.html |
导入辅导员映射 |
| 35 | 学工书记 | secretary_workbench.html |
工作台 |
| 36 | 学工书记 | secretary_counselors.html |
辅导员列表 |
| 37 | 学工书记 | secretary_counselor_new.html |
新建辅导员 |
| 38 | 学工书记 | secretary_counselor_detail.html |
辅导员详情 |
| 39 | 学工书记 | secretary_counselor_reset.html |
密码重置 |
| 40 | 学工书记 | secretary_counselor_permissions.html |
权限配置 |
| 41 | 学工书记 | secretary_anomalies.html |
全局异常 |
| 42 | 学工书记 | secretary_anomaly_detail.html |
异常详情 |
| 43 | 学工书记 | secretary_statistics.html |
统计分析 |
| 44 | 学工书记 | secretary_report_export.html |
报表导出 |
| 45 | 学工书记 | secretary_audit_logs.html |
审计日志 |
| 46 | 学工书记 | secretary_alert_rules.html |
预警规则 |
| 47 | 学工书记 | secretary_permissions.html |
模块权限 |
| 48 | 学工书记 | secretary_profile.html |
个人中心 |
| 49 | 技术人员 | super_admin_workbench.html |
工作台 |
| 50 | 技术人员 | super_admin_accounts.html |
账号管理 |
| 51 | 技术人员 | super_admin_audit_logs.html |
审计日志 |
| 52 | 技术人员 | super_admin_system.html |
系统配置 |
8. 原型边界说明
- 原型涵盖:全部 52 个静态 HTML 页面的 UI 布局、文字内容、跳转关系、参数传递。
- 原型不涵盖:
- 后端 API、数据库、所有数据持久化
- 真实登录校验、
force_reset、wechat_bound状态机 - 角色权限的真实校验(前端不阻止越权 URL 访问)
- 微信一键登录、订阅消息、短信兜底的真实触达
audit_logs实际写入与 365 天保留- AES 加密、HTTPS、TLS 1.3、登录失败锁定的真实实现
- 性能指标(首屏 ≤1.5s / 普通页 ≤3s / CRUD ≤1s / 300 人并发)
- 多端适配(原型按 375×812 移动端尺寸渲染)
- 数据库每日全量备份与 ≥30 天保留
- 校级平台接口对接(统一身份认证、数据中心、融合门户、门禁系统,本期仅预留接口)
- 已知非阻断问题:部分页面使用
href="#"、href="javascript:history.back()"、带参 URL(如?mid=M001、?filter=姓名、?toast=created/perm),验证时需确认参数被读取并展示。
9. 当前阶段里程碑
| 阶段 | 时间窗 | 关键产出 | 验证方 |
|---|---|---|---|
| 原型初版构建 | 60 天周期内已完成 | 52 个静态 HTML 页面 | — |
| 剧本编写 | 当前 | 交互原型文档.md v2.0(28 个场景) |
— |
| 内部走查 | 60 天周期内进行中 | 按本剧本 28 个场景逐路径点击比对 | 学生开发团队 |
| 原型验收冻结 | 60 天周期内待完成 | 全部场景通过 | 项目负责人 卫聚金 |
后续阶段(后端开发、前后端联调、上线运维、6 个月免费运维)不在本文档范围,将另行编写对应工作文档。
附录 · 维护说明
- 本文档随原型迭代同步更新:每次新增/删除/重命名 HTML 文件,需同步修订第 7 章清单。
- 剧本中的【操作动作】如与原型实际按钮文案不一致,以原型页面为准并同步更新本文档。
- 任何跳转方向与剧本不符的问题,请在
/student_affairs_proto/目录对应 HTML 文件中先行修正,然后通知项目负责人更新文档版本号。 - 文档版本:v2.0(基于 v1.0 重构为全场景剧本形式,新增跨角色联动场景,扩展覆盖全部申报书功能点)。