railwaysystem/docs/handbook/09-current-status.md

# 09. RailwaySystem 当前系统状态全貌

> **文档定位**：面向全员的项目交付状态与版本基线综合看板，透明展示当前工程指标、未决事项与后续演进路线。
> **当前基线**：Final Candidate `5a49b2e2988bf23ca2a70568264c05b24dfda1b6` (`origin/feat/cicd-pipeline`)

---

## 1. 核心状态综合看板 (Status Dashboard)

| 审计维度 | 状态指标 | 当前权威事实 | 阶段状态 |
| :--- | :--- | :--- | :---: |
| **Git 代码基线** | Round 4 QA HEAD | `qa/integrated-acceptance-20260916` | ✅ **已核准** |
| **后端单元/集成测试**| Maven 测试套件用例 | **331 / 331 PASS (0 Failures / 0 Errors)** | ✅ **全通过** |
| **三角色浏览器 E2E**| Admin / Teacher / Student 三端交互 | **0 阻断 / 0 个 500 / 0 控制台报错** | ✅ **全通过** |
| **RBAC 与防越权** | IDOR 穿透测试与最小权限 | **IDOR_LEAK_COUNT = 0, FINAL_RBAC_SMOKE = PASS** | ✅ **全通过** |
| **DMS 平台认证与契约**| 文档示例凭据对应的可访问DMS环境 | **AUTH=PASS, TTL=7200, Cookie token, Read-only & Empty-response Contract=PASS** | ✅ **契约通过** |
| **DMS 真实资源与映射**| 空间与门锁真实数据行级映射 | **NOT_RUNTIME_VERIFIED_DUE_TO_NO_RESOURCE_DATA (环境资源为0)** | ⏳ **待真实资源** |
| **DMS 变更与物理硬件**| 真实设备写操作与实体门锁硬件 | **BLOCKED_EXTERNAL (缺乏真实测试房间/门锁与实体硬件)** | ⏳ **待外部就绪** |
| **数据库完整性断言**| 孤儿/调宿重复/幂等/绑定完整性 | **6 大核心指标全部为 0 (CheckDatabaseIntegrity)** | ✅ **全通过** |
| **敏感凭证安全审计**| 全量 git ls-files 扫描 | **REAL_SECRET_COMMITTED_COUNT = 0** | ✅ **无泄露** |
| **甲方试用就绪度** | 核心教务业务综合验收试用评估 | **READY_WITH_EXTERNAL_BLOCKERS (核心闭环已就绪)** | 🚀 **具备试用条件** |
| **一期正式需求完成度** | 全量一期需求正式完成评审 | **PENDING_C03_C05_SCOPE_CONFIRMATION_OR_COMPLETION** | ⏳ **内部缺口推进中** |

---

## 2. 业务功能完备性矩阵速览

根据当前代码与测试验证，14 大业务模块实现覆盖情况如下：
* **全面闭环实现 (IMPLEMENTED & VERIFIED PASS)**：
  - 基础资源：教师管理 (Teacher PASS)、学员主档 (Student PASS)、标准课程库 (Course PASS)、理论教室 (Classroom PASS)、实训场地 (Site PASS)、宿舍房间 (Dormitory PASS)
  - 教务管理：开班计划 (Plan PASS)、本期课程 (PlanCourse PASS)、参训名单 (Enrollment PASS)、排课与冲突预检 (Scheduling PASS)
  - 现场执行：开班现场报到 (Report Confirm PASS)、课次考勤打卡与调整 (Attendance)、自主学习时长 (Duration PASS)
  - 角色门户：管理员控制台 (Admin PASS)、教师专属工作台 (Teacher PASS)、学员专属培训中心 (Student PASS)
  - 系统运维与审计：操作日志 (OperLog PASS)、系统工具与 API 接口正常
* **DMS 智能门锁集成状态 (DMS INTEGRATION)**：
  - 验证环境与范围：基于“文档示例凭据对应的可访问DMS环境”验证，AUTH=PASS、TOKEN TTL=7200、Cookie token 运行时校验通过、4 个只读接口网络连通与空响应外层契约通过；
  - 资源与硬件说明：因该环境下空间与门锁资源数量均为 0，具体资源属性（如 `room.id`, `placeId`, `lock.id`, `hardwareId`）的真实行级字段映射**尚未在运行时通过真实数据验证**（NOT_RUNTIME_VERIFIED_DUE_TO_NO_RESOURCE_DATA）；真实密码变更与物理硬件环境处于客观外部依赖状态（BLOCKED_EXTERNAL）；
  - 业务策略：请假保留权限、调宿先授新后销旧等暂行策略 (Provisional) 已在系统内闭环实现。
* **统计分析与学情画像现状 (内部 Known Gaps)**：
  - 统计分析 (Analytics)：`/analysis/checkin` 真实 77 条考勤打卡流水与报到统计可用 (AVAILABLE_FUNCTION)；
  - 学员画像 (Portrait)：`/portrait` 基础档案与学时检索可用，高阶多维雷达图待考评数据积累 (PARTIAL_FUNCTION)；
  - 成绩管理 (Score)：新成绩体系基础模型已就绪，一期全业务流程闭环推进中 (IN_PROGRESS / EXPECTED_GAP)。

---

## 3. 下一阶段演进路线图 (Next Steps)

1. **生成本地发布候选分支 (Release Candidate)**：基于当前终检 HEAD 生成 `rc/phase1-20260917` 本地发布分支，禁止直接部署生产。
2. **组织局域网教务教学试用**：在局域网内组织核心教务及教师展开教学排课与考勤试运行。
3. **外部硬件资源对接**：待门锁厂商划拨真实测试房间及门锁硬件通电后，闭环真实下发联调与甲方盖章确认。

---

## 4. 技术参考链接 (Technical References)

* 视觉化展示门户：[docs/visual/index.html](../visual/index.html)
* 最终测试综合报告：[docs/reports/archive/20260915/final-test-report.md](../reports/archive/20260915/final-test-report.md)
* 发版说明：[docs/reports/archive/20260915/release-notes.md](../reports/archive/20260915/release-notes.md)
* 架构白皮书：[03-system-architecture.md](03-system-architecture.md)