wangzhibiao
8ad0f5172e
docs: bootstrap canonical current truth portal (00-START-HERE through 08-NEXT-ACTIONS)
75 lines
5.1 KiB
Markdown
75 lines
5.1 KiB
Markdown
# 01. 系统当前真实状态速览 (Current Status)
|
||
|
||
> **系统正式名称**：`SYFJGYD学员管理系统`（内部工程代号：RailwaySystem）
|
||
> **共享试用分支**：`feat/cicd-pipeline`
|
||
> **共享试用地址**：[http://192.168.139.230:8082/](http://192.168.139.230:8082/)
|
||
> **共享试用数据库**：`training`（国产人大金仓 KingbaseES V9 实例）
|
||
> **当前试用就绪度**：`READY_WITH_EXTERNAL_BLOCKERS`（具备教务与教学现场试用条件）
|
||
|
||
---
|
||
|
||
## 1. 核心质量与验证状态表
|
||
|
||
系统在完全隔离的真实局域网与 KingbaseES 数据库环境下完成了全量自动化验收与真实浏览器端到端交互，核心能力验证状态如下：
|
||
|
||
| 验证维度 | 验证项 / 指标 | 状态结论 | 事实说明 |
|
||
| :--- | :--- | :---: | :--- |
|
||
| **核心教务主闭环** | 计划→课程→名单→排课→报到→考勤→结训 | **`PASS`** | 业务主链路 6 大正向场景全线打通，数据流转完整合规。 |
|
||
| **管理员端交互** | Admin 控制台全生命周期管理 | **`PASS`** | 覆盖师资、学员、教室、场地、计划、考勤报表等无阻断操作。 |
|
||
| **教师端工作台** | Teacher 个人课表、应到名单、代签打卡 | **`PASS`** | 真实无头 Chrome 浏览器 E2E 验证通过，课表与名单精准过滤。 |
|
||
| **学员端培训中心** | Student 个人日程、考勤明细、住宿查询 | **`PASS`** | 仅展示本人培训与出勤数据，界面交互流畅。 |
|
||
| **RBAC 与防越权** | 角色最小权限与防 IDOR 水平越权 | **`PASS`** | `IDOR_LEAK_COUNT = 0`，跨工号/跨学员数据篡改请求全部被 403 拦截。 |
|
||
| **后端测试套件** | Maven 离线测试门禁 | **`331 / 331 PASS`** | 全量单元测试与契约测试 0 Failures / 0 Errors。 |
|
||
| **数据库完整性** | 数据孤儿、重复调宿、外键断言 | **`PASS (0 孤儿)`** | 6 项完整性断言全部为 0，数据底座纯净。 |
|
||
| **凭证合规审计** | 全量源码与配置文件 Secret 扫描 | **`PASS`** | `REAL_SECRET_COMMITTED_COUNT = 0`，无硬编码生产密码。 |
|
||
| **成绩管理 (C03)** | 新成绩科目权重与录入计算 | **`IN_PROGRESS`** | 基础数据表已就绪，一期业务全闭环与交互正在推进中。 |
|
||
| **学员画像 (C05)** | 学员画像能力 | **`PARTIAL_FUNCTION`** | 当前具备基础画像能力，完整业务范围与后续增强内容仍需继续完善或确认。 |
|
||
| **智能门禁 (DMS)** | 真实环境连通与门锁联动 | **`PARTIALLY_VERIFIED`** | 鉴权/TTL/只读连通验证通过；真实设备与物理硬件因无资源外部阻塞。 |
|
||
|
||
---
|
||
|
||
## 2. 共享试用发布基线数据（2026-09-17）
|
||
|
||
共享试用数据库 `training` 当前承载的数据来源于全量验证后的综合验收数据集，真实业务规模如下：
|
||
|
||
```text
|
||
========================================================================
|
||
共享试用发布基线数据（2026-09-17）
|
||
========================================================================
|
||
- 培训开班计划 (Plans) : 13 期 (覆盖多专业、不同生命周期阶段)
|
||
- 授课教师档案 (Teachers) : 20 名 (涵盖各专业骨干教员)
|
||
- 参训学员档案 (Students) : 200 名 (全量完成身份证密文存储与脱敏)
|
||
- 标准培训课程 (Courses) : 24 门 (理论与实作多门类)
|
||
- 排课课次日程 (Lessons) : 118 次 (含四维冲突校验通过数据)
|
||
- 学员参训关系 (Enrollments) : 242 条
|
||
- 宿舍分配台账 (Accommodations): 57 条 (防混住与单在用约束生效)
|
||
- 真实考勤流水 (Attendance) : 77 条流水 (含签到、签退与请假修正)
|
||
========================================================================
|
||
```
|
||
|
||
---
|
||
|
||
## 3. DMS 智能门禁当前精确状态
|
||
|
||
针对 DMS 智能门禁系统，团队已完成详尽技术探测与隔离验证，客观界定如下：
|
||
|
||
1. **已验证通过部分 (Contract Verified)**：
|
||
- 针对文档示例凭据对应的可访问 DMS 环境，已在局域网下打通 HTTP 通信；
|
||
- 登录鉴权（AUTH=PASS）、Token TTL 机制（7200秒有效）、以及 Cookie Token 存储机制正常运行；
|
||
- 4 个只读接口连通性正常，外层响应结构符合空列表契约。
|
||
2. **客观外部阻塞部分 (BLOCKED_EXTERNAL)**：
|
||
- 该可访问环境下目前**挂载的测试空间与实体门锁数量均为 0**；
|
||
- 真实空间与门锁行级字段映射尚未在运行时通过真实数据验证；
|
||
- 真实密码下发变更操作（Mutation）与实体通电门锁硬件属于客观外部依赖，待甲方划拨指定真实测试房间与硬件通电后方可闭环。
|
||
|
||
---
|
||
|
||
## 4. 结论与指引
|
||
|
||
- **系统定性**：当前系统核心业务链路稳定，三角色体验完善，已具备交付沈阳房建公寓段业务老师进行**局域网教务教学试运行**的全部条件；
|
||
- **后续阅读**：
|
||
- 需求完成度与待确认项：[02-phase1-status.md](02-phase1-status.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)
|