Files
railwaysystem/docs/current/07-KNOWN-GAPS.md
T
wangzhibiao 122a242dd0 文档维护:纠偏现行真理中心构建源与已闭环事实
1. 明确 build_ui/ 为前端唯一构建与部署真源,RuoYi-Vue/ruoyi-ui 标记为历史归档备份;
2. 标记 ACCOM-PERM-01 为 RESOLVED_2026-09-23 已彻底闭环,内部 P0 阻断项清零;
3. 对全量 104 项内部 API 端点完成源码级表追踪 (VERIFIED_FROM_SOURCE) 与 build_ui 视图引用验证;
4. 外部 Client API 矩阵全面引入最后验证时间、验证方式、证据源与实时响应四项证据字段;
5. 更新下一阶段标准化行动路线图为严格 16 步标准流。
2026-09-24 00:03:47 +08:00

4.1 KiB
Raw Blame History

07 - 内部已知缺口与外部阻塞清单 (Known Gaps)

最高准则:

  1. 本清单仅记录经过当前真实代码、测试断言或运行时验证确认的客观事实;
  2. 严禁自动修复:本轮任务为 Current Truth Correction Pass,严禁擅自修改业务代码或数据库尝试修复这些问题;
  3. 历史已解决的问题必须移至“已闭环列表”,严禁继续将已解决事项当作未决阻断项。

1. 历史已解决阻断项闭环记录 (Resolved Issues)

✅ RESOLVED_2026-09-23: ACCOM-PERM-01 — 住宿生命周期操作权限缺失已闭环

  • 缺陷标识:ACCOM-PERM-01
  • 原严重等级:BLOCKER (曾阻断 6 个端到端场景)
  • 闭环时间:2026-09-23
  • 闭环事实与验证证据:
    • ACCOM_PERM_FIX = RESOLVED
    • SOURCE_MIGRATION_FIXED = YES:015_dms_package_a_hardening.sql 中明确将 menu_id=2263 (train:accommodation:edit) 授予 role_id=3 (培训管理员 train_admin),并加入后置断言校验;
    • QA_DB_PERMISSION_FIXED = YES:Kingbase 数据库已完成权限脚本执行;
    • TRAIN_ADMIN_UI_VERIFIED = YES:真实 qa_train_admin 角色在浏览器实测验证:
      • 预分配状态行 (status 0):“入住”按钮 Visible,“删除”按钮 Hidden(符合最小权限原则);
      • 在住状态行 (status 1):“调房”按钮 Visible,“退宿”按钮 Visible;
    • 11 个相关权限契约自动化测试全部 PASS;
  • 结论:ACCOM-PERM-01 已彻底解决,不再构成系统阻断项。

2. 当前内部 P0 阻断项总账

CURRENT_OPEN_P0_BLOCKER_COUNT = 0
CURRENT_OPEN_P0_BLOCKERS      = NONE

当前核心代码与数据库层面无任何未解决的内部 P0 级业务阻断项。


3. 外部客观环境阻塞项 (External Environmental Blockers)

🟡 GAP-01: DMS 外部物理房间与通电门锁硬件缺失

  • 缺陷标识:DMS-HARDWARE-01
  • 严重等级:BLOCKED_EXTERNAL (外部客观阻塞)
  • 客观事实:
    • 局域网内 DMS 厂商测试环境网络畅通,官方账号鉴权与 Token 获取通过(7200秒有效);
    • 只读 API(建筑、楼层、房间、门锁)接口响应结构解析通过;
    • 但该测试环境当前挂载的物理建筑、房间与门锁数量均为 0;
    • 现场缺少实体通电门锁设备与物理沙箱,无法验证实际刷卡或密码开锁。
  • 安全红线:
    • 严禁在无客户明确指定真实测试门锁前向未知外部设备发起 Mutation 写操作 (REAL_DMS_MUTATION_COUNT = 0);
    • 生产环境严禁集成远程开锁 (Remote Unlock)。
  • 解除阻塞条件:沈阳房建公寓段在现场为系统划分具体的实体测试房间,并完成智能门锁通电上云。

4. 研发推进中与待确认功能缺口 (In-Progress & Pending Gaps)

🔵 GAP-02: 成绩管理动态权重与评定交互闭环 (C03)

  • 状态:PARTIAL (推进中)
  • 现状:物理表 train_score_info 已建立,支持基础成绩录入;
  • 缺口:
    • 理论与实作多科目加权汇总计算算法的前端交互尚未收敛;
    • 教师工作台专属打分视图与成绩单导出功能尚在研发收尾阶段。

🔵 GAP-03: 学员 360 度成长画像多维雷达模型 (C05)

  • 状态:PARTIAL (部分能力具备)
  • 现状:基础档案卡、考勤出勤统计、学习时长累计等数据展现已打通;
  • 缺口:五维能力评价模型指标权重、评语自动生成算法尚未获得甲方正式确认,当前维持基础视图呈现。

🔵 GAP-04: 考勤统计指标口径待确认项 (PENDING-01 ~ PENDING-04)

  • 状态:PENDING_CLIENT_CONFIRMATION
  • 待确认业务规则:
    1. PENDING-01:未报到参训学员开班后是否从第一节课起计入应到出勤分母;
    2. PENDING-02:经审批合规的请假人次是否从出勤率分母中扣除;
    3. PENDING-03:放弃参训学员在放弃时间节点前后的历史课次有效性切分;
    4. PENDING-04:请假是否计入考勤异常 Top 10 预警排行榜(当前系统支持通过开关集中控制)。