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

5.0 KiB
Raw Blame History

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)