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 步标准流。
77 lines
4.1 KiB
Markdown
77 lines
4.1 KiB
Markdown
# 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 预警排行榜（当前系统支持通过开关集中控制）。
|