Files
railwaysystem/docs/current/CLIENT_DEMO_SCENARIOS_V1.md
T

160 lines
10 KiB
Markdown
Raw Normal View History

# SYFJGYD学员管理系统 — 客户现场演示业务剧本 (V1.0)
> **文档状态**:正式交付基线
> **适用演示版本**:Clean Demo Candidate (Git Commit: `e9f468ce` 及后续统一交付提交)
> **运行环境**:隔离演示数据库 `training_demo_clean` | 前端源 `build_ui/` (端口: 1024) | 后端 (端口: 8096)
> **演示账号口径**:为保障演示安全,所有演示口令统一使用演示基线初始口令,并已优化关闭登录验证码。
---
## 目录
1. [演示准备与角色清单](#一演示准备与角色清单)
2. [主线业务场景:培训管理员端全流程](#二主线业务场景培训管理员端全流程)
3. [支线场景一:主讲教师专属工作台](#三支线场景一主讲教师专属工作台)
4. [支线场景二:学员自服务个人中心](#四支线场景二学员自服务个人中心)
5. [特色亮点场景:排课冲突智能防错与考勤画像](#五特色亮点场景排课冲突智能防错与考勤画像)
6. [外部门禁对接政策与演示口径 (DMS)](#六外部门禁对接政策与演示口径-dms)
7. [演示环境一键重置说明](#七演示环境一键重置说明)
---
## 一、演示准备与角色清单
系统预置三类典型业务角色账号,覆盖铁路培训管理、教师授课与学员参训完整业务链:
| 角色类型 | 登录账号 | 用户姓名 | 业务身份绑定 | 核心展示能力 |
| :--- | :--- | :--- | :--- | :--- |
| **培训管理员** | `demo_admin` | 演示培训管理员 | 全局一期管理权限 (Role 3) | 基础资源维护、开班计划、学员名单、排课、考勤、住宿分配、门禁凭据、统计画像 |
| **主讲教师** | `demo_teacher` | 崔宏伟(教师) | 教师工号 T101 (高级工程师) | 认证讲师工作台、在教培训班级名册、专属授课日程课表 |
| **参训学员** | `demo_student` | 李强(学员) | 学员学号 S101 (沈阳车间) | 学员个人中心、培训进度、课程表、开班报到确认、个人考勤流水、成长雷达画像 |
> **提示**:演示系统已开启免验证码快速登录模式,进入登录页直接输入账号和密码即可秒级进入。
---
## 二、主线业务场景:培训管理员端全流程
**演示角色**:`demo_admin`
**业务主线**:从基础教学资源配置、班级开设,到学员报到、住宿安排、考勤打卡与综合画像的完整闭环。
### 场景 1:教学与生活保障资源矩阵展示
- **操作步骤**:
1. 登录系统后,点击左侧菜单 **【人员管理】 -> 【教师信息】**:
- 展示 7 位覆盖房建、安全、供电各领域的专业讲师名册。
- 重点展示“崔宏伟”与“张建国”已与系统账号无缝关联,具备业务与权限联动。
2. 点击 **【人员管理】 -> 【学员信息】**:
- 展示来自全段 35 位一线职工作为培训学员的基础档案,包含车间、工种及脱敏身份证件。
3. 点击 **【教学设施】 -> 【教室信息】 / 【实训场地】 / 【宿舍信息】**:
- 4 间标准多媒体智慧教室;
- 3 处专业实训作业场地(高铁给排水工场、房建实训工场、建筑结构检测实训基地);
- 20 间标准化学员宿舍(男/女分区,容量与楼层清晰标定)。
### 场景 2:培训计划全生命周期与学员名单
- **操作步骤**:
1. 点击 **【课程管理】 -> 【开班计划】**:
- 界面直观呈现 4 个不同生命周期的班级:
- `PLAN-2026-01`:2026年秋季高铁房建设施高级研修班(**进行中**,4门课程,19名学员);
- `PLAN-2026-02`:2026年铁路营业线安全施工与应急处置实训班(**未开始/即将开班**,3门课程,10名学员);
- `PLAN-2026-03`:2026年夏季铁路给排水设备技术比武集训班(**已结束/结训**,2门课程,15名学员);
- `PLAN-2026-04`:2026年房建段新入职青工业务技能强化班(**草稿**)。
2. 点击 `PLAN-2026-01` 行的 **【19】**(参训学员按钮):
- 弹出学员名册弹窗,展示 19 名已参训学员详细清单及报到状态(已报到 16 人、请假 1 人、未报到 2 人)。
### 场景 3:学员住宿精细化分配与入住办理(预留现场交互)
- **操作步骤**:
1. 点击 **【教学设施】 -> 【住宿管理】**:
- 界面展示当前全段住宿分布态势(在住 12 人、预分配 2 人、已退宿 2 人)。
2. **现场交互操作演示**:
- 筛选状态为“预分配”的学员记录(预留学员:`S105` 钱七,分配在 A103-1 床位)。
- 点击操作列的 **【办理入住】** 按钮,系统即时更新为“已入住”,并记录入住时间。
- 此处展示完整的房态流转,无需刷新自动更新。
### 场景 4:门禁凭据与设备物联(对接规范合规说明)
- **操作步骤**:
1. 点击 **【教学设施】 -> 【门禁管理】**:
- 展示学员入住后自动派发的门禁物理凭据(工卡、二维码、动态密码)。
- 查看外部资源映射列表:界面醒目标注 `[DEMO MOCK]` 仿真凭据标识,清晰表明对客户门禁接口的契约连通,并对敏感物理执行(如远程开锁)进行安全限制拦截。
### 场景 5:考勤明细与多维图表分析
- **操作步骤**:
1. 点击 **【统计分析】 -> 【开班签到】 / 【课程签到】**:
- 展示学员面部/刷卡打卡明细流水,状态涵盖“正常”、“迟到”、“早退”、“请假”与“旷课”,杜绝单调数据。
2. 点击 **【统计分析】 -> 【考勤分析】**:
- 动态展示学员出勤率分布图、各班级签到对比环形图,数据丰富,拒绝全零空图。
### 场景 6:学员 360 度成长画像
- **操作步骤**:
1. 点击主菜单 **【学员画像】**:
- 选择学员“李强 (S101)”或“张伟 (S102)”。
- 页面呈现雷达图:涵盖“理论成绩”、“实操技能”、“考勤纪律”、“自主学习时长”与“日常表现”五维能力模型。
- 下方列出数字化资源学习轨迹与学分达成进度。
---
## 三、支线场景一:主讲教师专属工作台
**演示角色**:`demo_teacher`(崔宏伟老师,绑定工号 T101)
**业务亮点**:讲师专属空间,授课班级即时掌握,日程与名册一目了然。
- **操作步骤**:
1. 使用 `demo_teacher` 账号登录。
2. 系统直接进入专属路由 **【教师工作台】**:
- 顶部横幅展示:“认证讲师:崔宏伟(高级工程师 / 沈阳房建公寓段安全培训科)”,档案编号 T101。
- **【我的培训班】** 标签页:清晰展示崔老师当前主讲的“2026年秋季高铁房建设施高级研修班”。点击 **【学员名册】** 可直接查看班内所有学员,方便课堂点名与答疑。
- **【我的课表】** 标签页:按周/天切换视图,直观展示崔老师近期的授课时间、授课教室(综合实训基地)与对应课目。
---
## 四、支线场景二:学员自服务个人中心
**演示角色**:`demo_student`(李强学员,绑定学号 S101)
**业务亮点**:学员自主服务闭环,信息安全脱敏,全周期透明可见。
- **操作步骤**:
1. 使用 `demo_student` 账号登录。
2. 系统直接进入专属路由 **【学员中心】**:
- **学员基本档案**:姓名李强,单位“沈阳车间”,身份证号严格脱敏显示(`**************1000`),符合铁路数据安全规范。
- **【我的培训】** 标签页:显示本人当前正在参加的研修班,进度清晰。
- **【我的课表】** 标签页:查看本人需要上的理论与实作课程安排,包含教室地点与讲师信息。
- **【我的报到】** 标签页:展示开班报到凭证与已分配的宿舍房间(A栋101号房01床位)。
- **【我的考勤】** 标签页:查询本人在各节课的实际签到记录与考勤状态。
- **【学业与纪律概况】** 标签页:查看本人自主学习时长累计与成绩达成情况。
---
## 五、特色亮点场景:排课冲突智能防错与考勤画像
系统在核心业务中内置了工业级防错与智能化能力,可向客户重点展示:
1. **场地与教师互斥防错(确定性演示点)**:
- 演示在开班计划中为同一时间段安排同一教室(如“101多媒体教室”)或同一位讲师(如“崔宏伟”)给不同班级授课。
- 系统将直接弹窗拦截并提示:“该时间段场地/讲师已被占用,存在日程冲突”,展示系统强大的调度校验能力。
2. **Score V2 架构演进成果**:
- 彻底下线遗留老旧单表设计,全面切换为结构清晰、支持动态权重考评的 Score V2 新架构,确保学业评价的多维度支持。
---
## 六、外部门禁对接政策与演示口径 (DMS)
面对客户关心的与公寓楼栋门禁、门锁硬件对接问题,演示人员请严格按照以下口径向客户沟通:
1. **只读连通性**:
- 系统与客户现场 DMS 接口服务网络已全链路打通,鉴权认证实时有效。
- 演示界面真实反映与外部服务交互现状,规范遵从客户硬件资源实际配置。
2. **凭据派发与状态流转**:
- 在未挂接指定物理测试锁的受控环境下,所有动态密码、卡片写入采用带有 `[DEMO MOCK]` 标识的安全仿真机制,确保演示流程端到端顺畅闭环。
3. **安全红线声明**:
- 遵循铁路安全保卫规范,生产级物理远程解锁功能默认采取 `SECURITY_PROHIBITED` 安全策略限制,严禁在无物理确认情况下远程下发硬件开锁指令。
---
## 七、演示环境一键重置说明
如客户演示完毕或在多次演示之间需要将系统数据恢复至初始黄金状态,只需执行受版本控制的重置脚本:
```bash
# 执行重置脚本(安全隔离演示库)
java -cp "$HOME/.m2/repository/com/kingbase/kingbase8/8.6.0/kingbase8-8.6.0.jar:." LoadAndVerifyDemoData
```
系统将自动清空操作脏数据并重新注入完整的黄金基线数据,无需重启服务即可开始下一轮客户演示。