diff --git a/docs/current/03-shared-trial.md b/docs/current/03-shared-trial.md index 9365d6f4d..6e315dcdf 100644 --- a/docs/current/03-shared-trial.md +++ b/docs/current/03-shared-trial.md @@ -17,7 +17,7 @@ ## 2. 账号体系与角色类型 -系统严格划分三类业务角色，支持针对性体验（账号密码已通过线下安全方式交接给现场管理员，严禁在文档中明文记录）： +系统严格划分三类业务角色，支持针对性体验。详细账号分配、统一测试登录密码及推荐体验步骤请参见：👉 [**共享试用账号说明 (06-shared-trial-accounts.md)**](06-shared-trial-accounts.md)。 | 角色类型 | 代表账号身份 | 试用推荐场景 | | :--- | :--- | :--- | diff --git a/docs/current/06-shared-trial-accounts.md b/docs/current/06-shared-trial-accounts.md new file mode 100644 index 000000000..51fef5928 --- /dev/null +++ b/docs/current/06-shared-trial-accounts.md @@ -0,0 +1,78 @@ +# 共享试用账号 + +## 共享试用地址 + +- **系统访问地址**：[http://192.168.139.230:8082/](http://192.168.139.230:8082/) +- **适用环境**：SYFJGYD学员管理系统 — 局域网共享试用环境 +- **网页登录测试密码**：`admin123`（全员统一） + +--- + +## 正常共享试用账号 + +以下账号已在共享试用环境中完成真实全链路核验（状态均为正常可用），推荐供沈阳房建公寓段业务主管、教务人员及骨干教员试用体验： + +| 身份 | 用户名 | 密码 | 主要可见功能 | 适用测试场景 | +| :--- | :--- | :--- | :--- | :--- | +| **系统管理员 (Admin)** | `admin` | `admin123` | 人员管理（教师/学员）、教学设施、课程管理（课程/计划）、教学成果、自主学习、统计分析、学员画像、系统工具、系统管理 | 全系统全量功能总览、系统参数设置、用户与角色维护；当前具备教师、学员、课程等档案的安全删除能力（内置业务依赖防误删强拦截） | +| **培训管理员 (Train Admin)** | `qa_train_admin` | `admin123` | 人员管理（教师/学员）、教学设施（教室/场地/宿舍/班牌/物联）、课程管理（课程/开班计划）、教学成果、自主学习、统计分析、学员画像 | 日常培训业务核心主流程体验：制定开班计划、课程排课冲突校验、学员报到核验、宿舍床位分配与综合统计（注：该账号不具备教师/学员/课程删除权限，专供安全日常业务流转试用） | +| **授课教师 A** | `qa_teacher_a` | `admin123` | 教师工作台（我的授课计划、授课课表日程、任教班级学员名册、课次学员出勤查看） | 授课教师日常自服务场景：查看每周授课日程、查询班级学员花名册（敏感信息已脱敏）、核验课堂出勤流水 | +| **授课教师 B** | `qa_teacher_b` | `admin123` | 教师工作台（我的授课计划、授课课表日程、任教班级学员名册、课次学员出勤查看） | 多教师并行授课场景、教师间授课日程与班级数据隔离效果验证 | +| **参训学员 A** | `qa_student_a` | `admin123` | 学员中心（我的参训班级、最新开班报到凭据、个人参训课表、考勤打卡记录、累计学时、多维成长画像） | 学员全周期自服务体验：学员到校报到状态查阅、参训课表查看、打卡记录与个人综合素养画像核验 | +| **参训学员 B** | `qa_student_b` | `admin123` | 学员中心（我的参训班级、个人参训课表、考勤打卡记录、累计学时、个人画像） | 学员间数据私密性与独立隔离核验、多学员并发体验 | + +--- + +## 推荐体验顺序 + +建议按照以下业务闭环顺序依次体验，以便建立清晰完整的系统认知： + +```mermaid +flowchart LR + A["1. 管理员视角 (qa_train_admin)"] --> B["2. 教师视角 (qa_teacher_a)"] + B --> C["3. 学员视角 (qa_student_a)"] +``` + +### 1. 管理员视角体验（推荐使用 `qa_train_admin`） +- **重点体验**： + - **开班计划管理**：在【课程管理 → 开班计划】中查看当前开班列表与各班级生命周期阶段； + - **四维排课防冲突**：查看已有课次安排与教师/教室占用时段； + - **学员管理与报到核对**：在【人员管理 → 学员信息】查验学员基本档案及报到流水； + - **宿舍与资源调配**：在【教学设施 → 宿舍信息】查验房间与床位分配情况； + - **统计分析大盘**：查阅开班签到、课程签到、学时统计与学员画像大盘。 + +### 2. 教师视角体验（推荐使用 `qa_teacher_a`） +- **重点体验**： + - **专属教师工作台**：登录后直接进入自服务界面，查看个人本周教学课表与授课日历； + - **班级学员名册**：点击所任课次，查看该班级参训学员列表（手机号等敏感信息已自动脱敏）； + - **课堂出勤核验**：查看所带课次的学员打卡流水与签到比例。 + +### 3. 学员视角体验（推荐使用 `qa_student_a`） +- **重点体验**： + - **学员个人中心**：查阅自身归属的参训班级信息； + - **报到凭据**：查看自身报到状态与班级通知； + - **参训课表与打卡**：查看个人课表安排以及历史打卡流水； + - **多维画像**：查看个人学习时长积累与多维能力分析呈现。 + +--- + +## 内部QA账号 + +以下账号为研发与测试团队专用的边界防护与异常用例验证账号，标记为 **`INTERNAL_QA_ONLY`**。 + +> [!WARNING] +> **请勿将以下账号提供给普通甲方试用人员使用**。此类账号仅供内部自动化测试与边界防线验证。 + +| 账号用户名 | 角色定位 | 内部用途说明 | 状态分类 | +| :--- | :--- | :--- | :---: | +| `qa_admin_teacher` | 管理员兼任教师 (双角色) | 用于验证具备复合角色时，顶层业务管理菜单与教师工作台的聚合展示与兼容性，验证跨角色场景下的操作边界。 | `INTERNAL_QA_ONLY` | +| `qa_role_nobody` | 未绑定档案的孤儿角色 | 具备 `train_teacher` 权限角色，但在业务数据库中故意未关联任何具体教师业务档案。用于自动化验证服务端 `TrainingIdentityService` 的防越权强拦截机制（访问时会正确拦截并提示“未绑定任何教师档案”）。 | `INTERNAL_QA_ONLY` | + +--- + +## 使用注意事项 + +1. **演示与测试数据保护**：当前共享试用环境已预置完整教学闭环演练数据，请勿随意大批量删除已有班级、课程或历史履约数据，以免打断其他人员试用流程。 +2. **禁止批量删除**：请在现有数据或新增独立测试计划基础上开展业务验证，禁止针对基础字典、教室资源、既有人员等进行破坏性批量删除。 +3. **禁止真实 DMS 硬件操作**：当前环境门锁交互处于安全模拟与状态机受控流转模式，严禁对外部物理门锁硬件发起真实 Mutation 操作。 +4. **账号使用范围限制**：以上测试账号与统一密码仅限用于指定的局域网共享试用系统（`http://192.168.139.230:8082/`），严禁在其他环境复用或外传。 diff --git a/docs/current/README.md b/docs/current/README.md index ff3d37326..5a655d4a5 100644 --- a/docs/current/README.md +++ b/docs/current/README.md @@ -9,7 +9,7 @@ ## 🧭 当前速览文件导航 -本目录包含 5 份精简、客观、直击核心事实的速览文档： +本目录包含 6 份精简、客观、直击核心事实的速览文档： | 文件 | 核心内容 | 推荐阅读对象 | | :--- | :--- | :--- | @@ -18,11 +18,12 @@ | [**03-shared-trial.md**](03-shared-trial.md) | **共享试用环境使用指南**（环境用途、账号类型、试用反馈与问题流转规范） | 试用教师、业务主管、运维测试 | | [**04-known-gaps.md**](04-known-gaps.md) | **内部已知缺口与外部阻塞清单**（C03成绩、C05画像、DMS门锁与待确认项） | 研发人员、外部联调人员 | | [**05-next-actions.md**](05-next-actions.md) | **下一阶段行动路线**（工作模式转变、小版本迭代计划与近期重点） | 研发团队、项目协调人 | +| [**06-shared-trial-accounts.md**](06-shared-trial-accounts.md) | **共享试用账号说明**（三类角色测试账号、登录凭据、推荐体验顺序与试用注意事项） | 甲方试用人员、业务主管、测试人员 | --- ## 📌 阅读建议 - 如果你只想知道**“系统做成啥样了、跑通了哪些功能”**：请直接阅读 [01-current-status.md](01-current-status.md)； - 如果你要去和**“沈阳房建公寓段领导/指导老师开会对需求”**：请直接阅读 [02-phase1-status.md](02-phase1-status.md) 并带上需求清单； -- 如果你正准备**“在局域网试用系统并提出反馈”**：请直接阅读 [03-shared-trial.md](03-shared-trial.md)； +- 如果你正准备**“在局域网试用系统并提出反馈”**：请直接阅读 [03-shared-trial.md](03-shared-trial.md) 与 [06-shared-trial-accounts.md](06-shared-trial-accounts.md) 获取登录账号与体验指引； - 如果你要**“继续写代码或排期”**：请直接阅读 [04-known-gaps.md](04-known-gaps.md) 与 [05-next-actions.md](05-next-actions.md)。