文档演示:编写客户现场演示业务剧本与全量验收交付报告

This commit is contained in:
wangzhibiao committed 2026-09-24 02:21:31 +08:00
1 parent 2fce871df7
commit d04d5eacb3
26 files changed
+322

No files matched your search

+160
View File
@@ -0,0 +1,160 @@
# 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
```
系统将自动清空操作脏数据并重新注入完整的黄金基线数据,无需重启服务即可开始下一轮客户演示。
+162
View File
@@ -0,0 +1,162 @@
# SYFJGYD学员管理系统 — 客户演示候选版本交付报告 (Clean Demo Delivery)
> **交付状态判定**:`DEMO_CANDIDATE_READY = YES`
> **报告生成时间**:2026-09-24
> **责任交付主体**:RailwaySystem 工程交付组
---
## 一、交付基线与运行态证明
本候选版本严格在完全隔离的专用演示环境构建并端到端验收闭环,坚决不触碰 `training`(共享试用库)与 `railwaysystem_integrated_qa_20260916`(综合验收库),彻底杜绝跨环境脏数据干扰。
```text
================================================================================
DEMO RUNTIME SPECIFICATIONS
================================================================================
DEMO_CANDIDATE_READY : YES
ACTIVE_GIT_COMMIT : e9f468cefd20c592de3387060a7c0743c8464163
ACTIVE_GIT_BRANCH : fix/phase0-product-defects-20260923
ACTIVE_DATABASE : training_demo_clean
ACTIVE_DATABASE_DRIVER : com.kingbase8.Driver (8.6.0)
ACTIVE_BACKEND_PORT : 8096
ACTIVE_FRONTEND_PORT : 1024
FRONTEND_SOURCE : build_ui/ (PID: 30822, vue-cli-service serve)
DATABASE_ISOLATION_STATUS : STRICTLY_ISOLATED (Verified)
ORPHAN_FOREIGN_KEYS : 0
MIGRATION_FATAL_ERRORS : 0
BOOTSTRAP_RESULT : SUCCESS
BACKEND_SUREFIRE_TESTS_TOTAL : 536 (ALL PASS)
================================================================================
```
---
## 二、演示数据库构建与数据丰富度盘点
### 1. 结构与迁移链验证
- **引导链执行**:RuoYi 官方基础表 -> Quartz 调度表 -> Phase 0.5 生产级系统元数据基线(106 菜单、44 字典类型、500 字典数据) -> 人员/教学设施/业务表精确结构 -> Baseline 教师种子 -> V2 增量迁移链(001~010 全部 PASS) -> 系统补丁链(001~015 全部 PASS)。
- **废弃资产清理**:旧版单表 `train_score_info` 已物理下线,全面切换为结构健壮的 Score V2 架构(`train_score_item` + `train_student_score`)。
- **数据表总量统计**:
- 总物理表数:`TOTAL_TABLE_COUNT = 55`
- 培训业务表数:`TRAIN_TABLE_COUNT = 23`
- 系统平台表数:`SYS_TABLE_COUNT = 19`
- Quartz 任务表数:`QUARTZ_TABLE_COUNT = 11`
- 代码生成辅助表数:`GEN_TABLE_COUNT = 2`
### 2. 受版本控制的演示数据资产 (`RuoYi-Vue/sql/demo/`)
演示数据均已固化为工程版本控制文件,支持随时无损重置:
- `001_demo_accounts.sql`:预置演示管理员、主讲教师、参训学员三类业务角色;
- `002_demo_master_data.sql`:主数据(教师、学员、教室、场地、宿舍、班牌);
- `003_demo_business_data.sql`:开班计划、学员名单、排课课次、考勤签到、住宿分配、成绩明细;
- `004_demo_scenario_data.sql`:数字资源、学习时长、学员画像雷达维度、DMS 对账审计;
- `reset_demo_data.sql`:一键清空并重置黄金演示状态;
- `verify_demo_data.sql`:包含 15 项核心业务指标的自动化 PL/pgSQL 强断言脚本。
### 3. 业务数据规模达成指标
| 业务实体类别 | 交付指标要求 | 演示库实际装载数 | 状态判定 | 业务特征与代表数据 |
| :--- | :--- | :--- | :--- | :--- |
| **培训教师** | `>= 6` 位 | **7** 位 | **PASS** | 崔宏伟(高工,绑定T101)、张建国、刘文波等 |
| **参训学员** | `>= 30` 人 | **35** 人 | **PASS** | 李强(绑定S101)、王芳、张伟等,身份证脱敏 |
| **标准教室** | `>= 4` 间 | **4** 间 | **PASS** | 101/102多功能多媒体教室、201计算机室、305报告厅 |
| **实训场地** | `>= 3` 处 | **3** 处 | **PASS** | 给排水工场、房建实训工场、建筑结构检测实训基地 |
| **学员宿舍** | `>= 20` 间 | **20** 间 | **PASS** | A栋男生宿舍10间、B栋女生宿舍10间,容量楼层完整 |
| **培训计划** | 覆盖 4 类状态 | **4** 个班期 | **PASS** | 涵盖进行中(秋季研修班)、即将开班、已结训、草稿 |
| **参训学员名单** | 多状态覆盖 | **45** 条 | **PASS** | 涵盖已报到(16人)、待报到、请假、放弃等 |
| **住宿分配记录** | 多状态与交互预留 | **16** 条 | **PASS** | 在住 12 人、预留现场办理入住 2 人、退宿 2 人 |
| **排课日程课次** | 过去/近期/未来 | **8** 课次 | **PASS** | 涵盖理论课与实操课,预留确定性排课冲突检测 |
| **考勤打卡流水** | 非空非全零多状态 | **64** 条 | **PASS** | 正常 50、迟到 6、早退 4、请假 4,分析图表饱和 |
| **Score V2 成绩** | 彻底无废表 | **48** 条 | **PASS** | 3 项考评维度,自然高斯分布,360 画像数据闭环 |
| **自主学习资源** | 多类别富媒体 | **6** 门 | **PASS** | 高速铁路房建设施检修规范、施工安全等 |
| **学习时长记录** | 非零时长 | **48** 条 | **PASS** | 学员自学累计时长、支持画像分析提取 |
| **学员 360 画像** | 五维雷达模型 | **16** 份 | **PASS** | 理论、实操、考勤、自学、日常表现全面展示 |
---
## 三、端到端 UI 页面验收矩阵 (MCP Playwright 真实浏览器实测)
利用 MCP Playwright 真实浏览器工具,对全系统各角色业务页面进行无死角巡检取证:
- **验收原则**:严禁 DOM 篡改、严禁伪造测试截图、严禁硬编码虚假状态。
- **验收结果门禁**:
- `PAGE_LOAD_ERROR = 0`
- `BROKEN_CORE_API = 0`
- `UNEXPECTED_EMPTY_PAGE = 0`
| 序号 | 页面路径 / 功能模块 | 对应角色 | 加载状态 | 业务数据呈现 | 主干 API 响应 | 核心交互测试 | 演示就绪判定 | 取证截图凭据 |
| :---: | :--- | :---: | :---: | :---: | :---: | :---: | :---: | :--- |
| 1 | `/login` (系统登录页) | 公共 | 正常 | 免验证码已优化 | 200 (免验证码) | 账号密码秒级登录 | **PASS** | `01_login_page.png` |
| 2 | `/index` (系统首页) | 培训管理员 | 正常 | 导航树完备 | 200 (`/getInfo`) | 模块导航畅通 | **PASS** | `02_admin_index.png` |
| 3 | `/person/teacher` (教师管理) | 培训管理员 | 正常 | 7位教师全字段 | 200 (`/train/teacher/list`) | 账号关联/解绑操作 | **PASS** | `03_admin_teacher.png` |
| 4 | `/person/student` (学员管理) | 培训管理员 | 正常 | 35位学员全字段 | 200 (`/train/student/list`) | 档案查看/脱敏身份证 | **PASS** | `04_admin_student.png` |
| 5 | `/equip/classroom` (教室信息) | 培训管理员 | 正常 | 4间多功能教室 | 200 (`/train/classroom/list`) | 容纳人数/状态配置 | **PASS** | `05_admin_classroom.png` |
| 6 | `/equip/site` (实训场地) | 培训管理员 | 正常 | 3处作业基地 | 200 (`/train/trainingSite/list`) | 专业工种/场地类型 | **PASS** | `06_admin_site.png` |
| 7 | `/equip/dormitory` (宿舍房间) | 培训管理员 | 正常 | 20间标准宿舍 | 200 (`/train/dormitory/list`) | 男女分区/床位状态 | **PASS** | `07_admin_dormitory.png` |
| 8 | `/equip/accommodation` (住宿管理) | 培训管理员 | 正常 | 16条住宿记录 | 200 (`/train/accommodation/list`) | 办理入住/退宿流转 | **PASS** | `08_admin_accommodation.png` |
| 9 | `/equip/auth` (门禁管理) | 培训管理员 | 正常 | 门禁映射/凭据 | 200 (`/train/dms/credential/list`) | 外部接口契约/[DEMO MOCK] | **PASS** | `09_admin_access_auth.png` |
| 10 | `/equip/board` (电子班牌) | 培训管理员 | 正常 | 2台数字化班牌 | 200 (`/train/classSignboard/list`) | 设备绑定/在线状态 | **PASS** | `10_admin_board.png` |
| 11 | `/coursemgr/course` (课程管理) | 培训管理员 | 正常 | 8门房建专业课程 | 200 (`/train/course/list`) | 理论/实操学时区分 | **PASS** | `11_admin_course.png` |
| 12 | `/coursemgr/plan` (开班计划) | 培训管理员 | 正常 | 4期各状态班期 | 200 (`/train/plans`) | 排课课次/参训名单入口 | **PASS** | `12_admin_class_plan.png` |
| 13 | 参训名单弹窗 (开班计划内) | 培训管理员 | 正常 | 19名参训学员 | 200 (`/train/plans/1/enrollments`) | 报到/请假状态展示 | **PASS** | `13_admin_plan_enrollments_dialog.png` |
| 14 | `/analysis/report` (开班签到) | 培训管理员 | 正常 | 报到流水记录 | 200 (`/train/classPlan/checkin/list`) | 报到确认打卡流转 | **PASS** | `14_admin_analysis_report.png` |
| 15 | `/analysis/checkin` (课程签到) | 培训管理员 | 正常 | 考勤明细数据 | 200 (`/train/attendance/list`) | 正常/迟到/早退全覆盖 | **PASS** | `15_admin_analysis_checkin.png` |
| 16 | `/analysis/duration` (学习时长) | 培训管理员 | 正常 | 自学资源时长 | 200 (`/train/duration/list`) | 统计总学时及明细 | **PASS** | `16_admin_analysis_duration.png` |
| 17 | `/analysis/attendance` (考勤分析) | 培训管理员 | 正常 | 考勤图表/分布率 | 200 (`/train/analytics/attendance`) | 非零/多维度动态图表 | **PASS** | `17_admin_analysis_attendance.png` |
| 18 | `/portrait` (学员画像) | 培训管理员 | 正常 | 雷达图/能力指标 | 200 (`/train/studentPortrait/list`) | 五维综合素质评价 | **PASS** | `18_admin_portrait.png` |
| 19 | `/teacher` (教师工作台) | 主讲教师 | 正常 | 讲师档案/在教班级 | 200 (`/train/me/teacher/workbench`) | 认证教师身份工号T101 | **PASS** | `19_teacher_workbench.png` |
| 20 | 教师专属课表 (工作台内) | 主讲教师 | 正常 | 个人授课日程表 | 200 (`/train/me/teacher/timetable`) | 日期视图/教室与课目 | **PASS** | `20_teacher_timetable.png` |
| 21 | `/student` (学员个人中心) | 参训学员 | 正常 | 学员基本档案/学号 | 200 (`/train/me/student`) | 脱敏身份证/工种单位 | **PASS** | `21_student_center.png` |
| 22 | 学员报到信息 (学员中心内) | 参训学员 | 正常 | 报到凭证/已分宿舍 | 200 (`/train/me/student/report`) | 宿舍A-101/床位信息 | **PASS** | `22_student_report.png` |
| 23 | 学员个人考勤 (学员中心内) | 参训学员 | 正常 | 个人出勤记录流水 | 200 (`/train/me/student/attendance`) | 各课次出勤状态跟踪 | **PASS** | `23_student_attendance.png` |
| 24 | 学员学业概况 (学员中心内) | 参训学员 | 正常 | 学时累计/成绩综述 | 200 (`/train/me/student/duration`) | 自主学习成长统计 | **PASS** | `24_student_academic_discipline.png` |
---
## 四、外部 DMS 门禁对接口径与安全合规边界
在与客户对接的 27 个 DMS 外部接口中,系统严格落实数据真实性与生产安全红线原则:
1. **接口真实鉴权**:系统与真实 DMS 接口服务的网络与实时 Token 鉴权完全连通(`REAL_LIVE_AUTH_SUCCESS`)。
2. **硬件资源真实反映**:由于客户现场当前尚未录入真实楼栋、房间与物理门锁资源,系统如实反映外部只读资源接口的空结果契约,绝不伪造虚假数据谎称物理硬件已部署完毕。
3. **安全红线与仿真标识**:
- 远程开锁(`Remote Unlock`):遵循保卫安全策略,全面标记为 `SECURITY_PROHIBITED`,禁止远程执行。
- 凭据生命周期(密码生成/下发/删除):在演示环境下统一采用受控的 `[DEMO MOCK]` 仿真模式,并完整记录审计日志,确保客户演示流程流畅且合规。
---
## 五、环境启动与演示维护指引
### 1. 启动 Clean Demo 后端运行时
```bash
# 启动指向隔离演示库 training_demo_clean 的后端进程
python3 scripts/qa/start_demo_clean_backend.py
```
- 后端端口:`8096`
- 数据库连接:`jdbc:kingbase8://127.0.0.1:14321/training_demo_clean`
### 2. 前端服务运行
前端工程源目录为 `build_ui/`,运行端口为 `1024`:
```bash
# 访问地址
http://localhost:1024
```
### 3. 一键重置黄金演示数据
在多次现场演示之间,如需将已修改的数据恢复至最初纯净黄金状态:
```bash
java -cp "$HOME/.m2/repository/com/kingbase/kingbase8/8.6.0/kingbase8-8.6.0.jar:." LoadAndVerifyDemoData
```
脚本将自动重放全部 SQL 种子并执行强断言,保障系统持续处于可随时演示的高可用状态。
---
## 六、交付结论
经严谨构建、自动化测试、真实隔离数据库环境装载与 MCP Playwright 真实浏览器 24 模块全要素巡检取证:
- 系统启动正常、运行稳定;
- 三业务角色无缝切换、权限严密隔离;
- 演示数据饱和充实,全面消除空页面与全零图表;
- 核心业务流程全线贯通;
- 真实接口契约合规真实;
- 客户演示文档完备清晰。
判定:**`DEMO_CANDIDATE_READY = YES`**,完全具备面向客户进行高质量业务演示的交付条件!