railwaysystem/docs/current/07-KNOWN-GAPS.md

# 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 阻断项总账

```text
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 预警排行榜（当前系统支持通过开关集中控制）。