59 lines
4.5 KiB
Markdown
59 lines
4.5 KiB
Markdown
# 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 智能门锁平台**| 官方平台登录认证与 Token TTL | **Real Auth PASS / Token TTL: 7200s (Runtime Verified)** | ✅ **契约通过** |
|
||
| **DMS 只读契约与接口**| 楼栋/楼层/房间/门锁只读查询 | **DMS_REAL_READ_ONLY_CONTRACT = PASS** | ✅ **契约通过** |
|
||
| **DMS 外部设备与资源**| 厂商租户真实资源与现场硬件 | **BLOCKED_EXTERNAL (租户资源为0，现场硬件组网中)** | ⏳ **待外部就绪** |
|
||
| **数据库完整性断言**| 孤儿/调宿重复/幂等/绑定完整性 | **6 大核心指标全部为 0 (CheckDatabaseIntegrity)** | ✅ **全通过** |
|
||
| **敏感凭证安全审计**| 全量 git ls-files 扫描 | **REAL_SECRET_COMMITTED_COUNT = 0** | ✅ **无泄露** |
|
||
| **正式发布就绪度** | 综合验收试用就绪评估 | **READY_WITH_EXTERNAL_BLOCKERS** | 🚀 **具备试用条件** |
|
||
|
||
---
|
||
|
||
## 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 官方认证通过 (Real Auth PASS)、Token TTL 7200s、只读接口契约与实体映射已通过运行时校验 (Real Read-only verified)；
|
||
- 外部依赖说明：外部 Demo 租户账号无真实房间与门锁资源 (Demo tenant has no real resources)，现场实体门锁硬件组网施工中，写操作/物理硬件处于外部等待状态 (Mutation/hardware pending external)；
|
||
- 业务策略：请假保留权限、调宿先授新后销旧等暂行策略 (Provisional) 已在系统内闭环实现。
|
||
* **统计分析与学情画像现状**：
|
||
- 统计分析 (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/final-test-report.md](../reports/final-test-report.md)
|
||
* 发版说明：[docs/reports/release-notes.md](../reports/release-notes.md)
|
||
* 架构白皮书：[03-system-architecture.md](03-system-architecture.md)
|