|
1
|
4
|
756
|
0
|
1787817232
|
## 需求摘要
在「数据报表 > 设备分析」下新增报表，按月筛选展示各省份新激活上线设备数量 ## 需求摘要
在「数据报表 > 设备分析」下新增报表，按月筛选展示各省份新激活上线设备数量柱状图排行，支持下钻到城市维度。
## 核心决策
- 统计口径：当月**新激活**上线设备（首次上线，取 ）
- 地区归属：取设备绑定**门店地址**的省/市字段
- 交互方式：点击省份**下钻**到城市排行（非 Tab 切换）
- 权限：跟随现有 角色体系，超管看全国，运营商看自己区域
## 不在范围内
- 不做 Excel 导出
- 不做地图热力图
- 不做区/县级别
- 不做跨月趋势
## 产物文件
[intent/device-online-stats-by-region.md](intent/device-online-stats-by-region.md)
## PM 审核要点
- [ ] 需求理解是否准确？
- [ ] 本次是否接受排期进入 Design 阶段？
...
|
1
|
0
|
Edit
Delete
|
|
2
|
4
|
756
|
0
|
1787817722
|
## 需求摘要
在「数据报表 > 设备分析」下新增报表，按月筛选展示各省份新激活上线设备数量 ## 需求摘要
在「数据报表 > 设备分析」下新增报表，按月筛选展示各省份新激活上线设备数量柱状图排行，支持下钻到城市维度。
## 核心决策
- 统计口径：当月**新激活**上线设备（首次上线，取 ahead_authenticate_log 表的 create_time 字段）
- 地区归属：取设备绑定**门店地址**的省/市字段
- 交互方式：点击省份**下钻**到城市排行（非 Tab 切换）
- 权限：跟随现有 agent_id 角色体系，超管看全国，运营商看自己区域
## 不在范围内
- 不做 Excel 导出
- 不做地图热力图
- 不做区/县级别
- 不做跨月趋势
## 产物文件
[intent/device-online-stats-by-region.md](https://gitea.g-hi.com/laiqiaojie/jh-project/src/branch/intent/device-online-stats-by-region/intent/device-online-stats-by-region.md)
## PM 审核要点
- [ ] 需求理解是否准确？
- [ ] 本次是否接受排期进入 Design 阶段？
...
|
0
|
0
|
Edit
Delete
|
|
3
|
4
|
756
|
0
|
1787818973
|
## 需求摘要
在「数据报表 > 设备分析」下新增报表，按月筛选展示各省份新激活上线设备 ## 需求摘要
在「数据报表 > 设备分析」下新增报表，按月筛选展示各省份新激活上线设备数量柱状图排行，支持下钻到城市维度。
## 核心决策
- 统计口径：当月**新激活**上线设备（首次上线，取 ahead_authenticate_log 表的 create_time 字段）
- 地区归属：取设备绑定**门店地址**的省/市字段
- 交互方式：点击省份**下钻**到城市排行（非 Tab 切换）
- 权限：跟随现有 agent_id 角色体系，超管看全国，运营商看自己区域
## 不在范围内
- 不做 Excel 导出
- 不做地图热力图
- 不做区/县级别
- 不做跨月趋势
## 产物文件
[intent/device-online-stats-by-region.md](https://gitea.g-hi.com/laiqiaojie/jh-project/src/branch/intent/device-online-stats-by-region/intent/device-online-stats-by-region.md)
## PM 审核要点
- [x] 需求理解是否准确？
- [ ] 本次是否接受排期进入 Design 阶段？
...
|
0
|
0
|
Edit
Delete
|
|
4
|
4
|
756
|
0
|
1787818974
|
## 需求摘要
在「数据报表 > 设备分析」下新增报表，按月筛选展示各省份新激活上线设备 ## 需求摘要
在「数据报表 > 设备分析」下新增报表，按月筛选展示各省份新激活上线设备数量柱状图排行，支持下钻到城市维度。
## 核心决策
- 统计口径：当月**新激活**上线设备（首次上线，取 ahead_authenticate_log 表的 create_time 字段）
- 地区归属：取设备绑定**门店地址**的省/市字段
- 交互方式：点击省份**下钻**到城市排行（非 Tab 切换）
- 权限：跟随现有 agent_id 角色体系，超管看全国，运营商看自己区域
## 不在范围内
- 不做 Excel 导出
- 不做地图热力图
- 不做区/县级别
- 不做跨月趋势
## 产物文件
[intent/device-online-stats-by-region.md](https://gitea.g-hi.com/laiqiaojie/jh-project/src/branch/intent/device-online-stats-by-region/intent/device-online-stats-by-region.md)
## PM 审核要点
- [ ] 需求理解是否准确？
- [ ] 本次是否接受排期进入 Design 阶段？
...
|
0
|
0
|
Edit
Delete
|
|
5
|
4
|
756
|
0
|
1787822699
|
## 需求摘要
在「数据报表 > 设备分析」下新增报表，按月筛选展示各省份新激活上线设备数量 ## 需求摘要
在「数据报表 > 设备分析」下新增报表，按月筛选展示各省份新激活上线设备数量柱状图排行，支持下钻到城市维度。
## 核心决策
- 统计口径：当月**新激活**上线设备（首次上线，取 ahead_authenticate_log 表的 create_time 字段）
- 地区归属：取设备绑定**门店地址**的省/市字段
- 交互方式：点击省份**下钻**到城市排行（非 Tab 切换）
- 权限：跟随现有 agent_id 角色体系，超管看全国，运营商看自己区域
## 不在范围内
- 不做 Excel 导出
- 不做地图热力图
- 不做区/县级别
- 不做跨月趋势
## 产物文件
[intent/device-online-stats-by-region.md](https://gitea.g-hi.com/laiqiaojie/jh-project/src/branch/intent/device-online-stats-by-region/intent/device-online-stats-by-region.md)
## PM 审核清单（参考 REVIEW.md）
- [ ] 需求背景和问题描述是否准确反映了原始诉求？
- [ ] 期望结果是否可验证？
- [ ] 不在范围内的排除项是否合理？
- [ ] 受影响系统判断是否正确（admin / ahead_authenticate_log）？
- [ ] 本次是否接受排期，进入 Design 阶段？
...
|
0
|
0
|
Edit
Delete
|
|
6
|
4
|
757
|
0
|
1787824027
|
## 关联 Intent
PR #1 — 按省市统计设备月度新增上线数量报表
## 技术方案摘要 ## 关联 Intent
PR #1 — 按省市统计设备月度新增上线数量报表
## 技术方案摘要
**数据链路：** ahead_authenticate_log → ahead_family_servers → ahead_yc_shop（取省市字段）
**新增接口（DeviceOnlineReport 控制器）：**
- POST /DeviceOnlineReport/getStats — 省份排行 + 当月总数
- POST /DeviceOnlineReport/getCityStats — 城市下钻
**前端：** Vue 页面 + ECharts 柱状图，点击省份下钻到城市
**权限：** 复用 PcServer agent_id 过滤，无需新增权限规则
## 产物文件
[spec/device-online-stats-by-region.md](https://gitea.g-hi.com/laiqiaojie/jh-project/src/branch/spec/device-online-stats-by-region/spec/device-online-stats-by-region.md)
## Tech Lead 审核清单
- [ ] 数据链路是否正确（ahead_family_servers._shop_id 关联的表待确认）？
- [ ] 接口设计是否合理？参数/响应格式是否符合项目规范？
- [ ] ECharts 引入方式是否认可（按需引入）？
- [ ] 权限处理方式是否正确？
- [ ] 待确认项是否需要在 Build 前解决？
...
|
1
|
0
|
Edit
Delete
|
|
7
|
4
|
757
|
0
|
1787827290
|
## 关联 Intent
[PR #1 — 按省市统计设备月度新增上线数量报表](https:// ## 关联 Intent
[PR #1 — 按省市统计设备月度新增上线数量报表](https://gitea.g-hi.com/laiqiaojie/jh-project/pulls/1)
---
## UI 原型（Design 阶段产物）
**原型链接：** https://claude.ai/code/artifact/f78c807a-ae4c-4261-bd42-fb73da2336a9
包含两个页面状态：
- ① 全国省份视图 — 月份筛选器 + 当月总数卡片 + 各省份横向柱状图排行
- ② 广东省城市下钻 — 面包屑「全国 › 广东省」+ 城市排行 + 返回全国按钮
**交互流程：**
- 点击省份柱子 → 进入该省城市下钻视图
- 点击面包屑「全国」或「返回全国」按钮 → 返回省份视图
> PM 审核要点：布局、交互路径、数据说明是否符合预期，确认后在本 PR approve。
---
## 技术规格（Tech Lead 确认）
**数据链路：**
> 待确认：ahead_family_servers._shop_id 是否关联 ahead_yc_shop._id，Build 阶段查库验证。
**新增接口（新建控制器 DeviceOnlineReport.php）：**
- — 省份排行 + 当月总数
- — 城市下钻
**前端：** Vue 页面组件 + ECharts 横向柱状图，点击省份下钻到城市视图
**权限：** agent_id 从 session 取，agent_id=0 为超管不过滤
**安全要点：**
- month 参数正则校验 /^\d{4}-\d{2}$/
- province_id 强制 intval()
- agent_id 从 session 取，不信任前端传参
**各端影响：** 仅 admin 端
---
## 审核清单
### PM 审核（原型）
- [ ] 页面布局符合预期？
- [ ] 省份下钻 / 返回交互路径正确？
- [ ] 数据定义（新增上线 = 首次激活，归属 = 门店地址）理解一致？
### Tech Lead 审核（技术规格）
- [ ] 数据链路正确？表关联关系有无误判？
- [ ] 接口设计合理？参数和响应格式符合规范？
- [ ] 权限处理方式正确？
- [ ] 安全检查要点覆盖？
- [ ] 前端方案可行（ECharts 按需引入）？
**通过后：** PM + Tech Lead 均 Approve → Merge → 召开评审会议 → 进入 Plan 阶段...
|
0
|
0
|
Edit
Delete
|
|
8
|
4
|
757
|
0
|
1787827677
|
## 关联 Intent
[PR #1 — 按省市统计设备月度新增上线数量报表](https:// ## 关联 Intent
[PR #1 — 按省市统计设备月度新增上线数量报表](https://gitea.g-hi.com/laiqiaojie/jh-project/pulls/1)
---
## 审核顺序：PM 先确认原型，再由 Tech Lead Approve Spec
---
## 第一步：PM 确认原型
**原型链接：** https://claude.ai/code/artifact/f78c807a-ae4c-4261-bd42-fb73da2336a9
页面状态：
- ① 全国省份视图 — 月份筛选器 + 当月总数卡片 + 各省份横向柱状图排行
- ② 广东省城市下钻 — 面包屑「全国 › 广东省」+ 城市排行 + 返回全国
交互流程：点击省份柱子进入城市视图，点击面包屑「全国」或「返回全国」按钮返回省份视图。
**PM 审核 checklist：**
- [ ] 页面布局和组件符合预期？
- [ ] 交互路径（下钻、返回）正确？
- [ ] 数据定义（新增上线 = 首次激活，归属 = 门店地址）理解一致？
✅ **PM 确认方式：在本 PR 评论「原型确认 ✅」即可，无需 Approve**
---
## 第二步：Tech Lead 审核 Spec（PM 确认后进行）
**数据链路：**
> 待确认：ahead_family_servers._shop_id 是否关联 ahead_yc_shop._id，Build 阶段查库验证。
**新增接口（新建控制器 DeviceOnlineReport.php）：**
- POST /DeviceOnlineReport/getStats — 省份排行 + 当月总数
- POST /DeviceOnlineReport/getCityStats — 城市下钻
**前端：** Vue 页面组件 + ECharts 横向柱状图，点击省份下钻到城市视图
**权限：** agent_id 从 session 取，agent_id=0 为超管不过滤
**安全要点：**
- month 参数正则校验 /^\d{4}-\d{2}$/
- province_id 强制 intval()
- agent_id 从 session 取，不信任前端传参
**Tech Lead 审核 checklist：**
- [ ] 数据链路正确？表关联关系有无误判？
- [ ] 接口设计合理？参数和响应格式符合规范？
- [ ] 权限处理方式正确？
- [ ] 安全检查要点覆盖？
- [ ] 前端方案可行（ECharts 按需引入）？
✅ **Tech Lead 直接 Approve → Merge → 召开评审会议 → 进入 Plan 阶段**...
|
0
|
0
|
Edit
Delete
|
|
9
|
4
|
757
|
0
|
1787829219
|
## 关联 Intent
[PR #1 — 按省市统计设备月度新增上线数量报表](https:// ## 关联 Intent
[PR #1 — 按省市统计设备月度新增上线数量报表](https://gitea.g-hi.com/laiqiaojie/jh-project/pulls/1)
---
## 审核顺序：PM 先确认原型，再由 Tech Lead Approve
---
## 第一步：PM 确认原型
**原型文件：**
（从仓库拉取后浏览器直接双击打开，可点击交互）
页面状态：
- 全国省份视图 — 月份筛选器 + 当月总数卡片 + 各省份横向柱状图
- 城市下钻视图 — 点击省份柱子进入，面包屑「全国 › 广东省」+ 城市排行
交互流程：点击省份柱子进入城市视图，点击面包屑「全国」或「返回全国」按钮返回。
**PM 审核 checklist：**
- [ ] 页面布局和组件符合预期？
- [ ] 交互路径（下钻、返回）正确？
- [ ] 数据定义（新增上线 = 首次激活，归属 = 门店地址）理解一致？
- [ ] 权限范围（超管看全国，运营商看自己区域）正确？
**PM 确认方式：在本 PR 评论「原型确认 ✅」即可，无需 Approve**
---
## 第二步：Tech Lead 审核（PM 确认后进行）
**数据链路：**
> 待确认：ahead_family_servers._shop_id 是否关联 ahead_yc_shop._id，Build 阶段查库验证。
**新增接口（新建控制器 DeviceOnlineReport.php）：**
- POST /DeviceOnlineReport/getStats — 省份排行 + 当月总数
- POST /DeviceOnlineReport/getCityStats — 城市下钻
**权限：** agent_id 从 session 取，= 0 为超管不过滤
**安全：** month 正则校验、province_id intval()、agent_id 不信任前端
**Tech Lead 审核 checklist：**
- [ ] 数据链路正确？表关联关系有无误判？
- [ ] 接口设计合理？参数和响应格式符合规范？
- [ ] 权限处理方式正确？
- [ ] 安全检查要点覆盖？
- [ ] 前端方案可行（ECharts 按需引入）？
**Tech Lead Approve → Merge → 评审会议（里程碑内所有需求一起）→ Plan 阶段**...
|
0
|
0
|
Edit
Delete
|
|
10
|
4
|
758
|
0
|
1787829439
|
## 关联 Intent
[PR #1 — 按省市统计设备月度新增上线数量报表](https:// ## 关联 Intent
[PR #1 — 按省市统计设备月度新增上线数量报表](https://gitea.g-hi.com/laiqiaojie/jh-project/pulls/1)
---
## 审核顺序：PM 先确认原型，再由 Tech Lead Approve
---
## 第一步：PM 确认原型
**原型文件：**
（从仓库拉取后浏览器直接双击打开，可点击交互）
页面状态：
- 全国省份视图 — 月份筛选器 + 当月总数卡片 + 各省份横向柱状图
- 城市下钻视图 — 点击省份柱子进入，面包屑「全国 › 广东省」+ 城市排行
交互流程：点击省份柱子进入城市视图，点击面包屑「全国」或「返回全国」按钮返回。
**PM 审核 checklist：**
- [ ] 页面布局和组件符合预期？
- [ ] 交互路径（下钻、返回）正确？
- [ ] 数据定义（新增上线 = 首次激活，归属 = 门店地址）理解一致？
- [ ] 权限范围（超管看全国，运营商看自己区域）正确？
**PM 确认方式：在本 PR 评论「原型确认 ✅」即可，无需 Approve**
---
## 第二步：Tech Lead 审核（PM 确认后进行）
数据链路、接口设计、权限和安全要点见 。
**Tech Lead 审核 checklist：**
- [ ] 数据链路正确？表关联关系有无误判？
- [ ] 接口设计合理？参数和响应格式符合规范？
- [ ] 权限处理方式正确？
- [ ] 安全检查要点覆盖？
- [ ] 前端方案可行（ECharts 按需引入）？
**Tech Lead Approve → Merge → 评审会议（里程碑内所有需求一起）→ Plan 阶段**...
|
1
|
0
|
Edit
Delete
|
|
11
|
4
|
758
|
0
|
1787884622
|
## 关联 Intent
[PR #1 — 按省市统计设备月度新增上线数量报表](https:// ## 关联 Intent
[PR #1 — 按省市统计设备月度新增上线数量报表](https://gitea.g-hi.com/laiqiaojie/jh-project/pulls/1)
---
## PM 确认原型
**原型文件：** `design/assets/device-online-stats-by-region/prototype.html`
（从仓库拉取后浏览器直接双击打开，可点击交互）
页面状态：
- 全国省份视图 — 月份筛选器 + 当月总数卡片 + 各省份横向柱状图
- 城市下钻视图 — 点击省份柱子进入，面包屑「全国 › 广东省」+ 城市排行
交互流程：点击省份柱子进入城市视图，点击面包屑「全国」或「返回全国」按钮返回。
**审核 checklist：**
- [ ] 页面布局和组件符合预期？
- [ ] 交互路径（下钻、返回）正确？
- [ ] 数据定义（新增上线 = 首次上线，归属 = 门店注册地址）理解一致？
- [ ] 权限范围（超管看全国，运营商看自己区域）正确？
**确认方式：在本 PR 评论「原型确认 ✅」，然后 Approve + Merge**...
|
0
|
0
|
Edit
Delete
|
|
12
|
4
|
758
|
0
|
1787884914
|
## 关联 Intent
[PR #1 — 按省市统计设备月度新增上线数量报表](https:// ## 关联 Intent
[PR #1 — 按省市统计设备月度新增上线数量报表](https://gitea.g-hi.com/laiqiaojie/jh-project/pulls/1)
---
## PM 确认原型
**在线原型（可直接点击交互）：**
https://claude.ai/code/artifact/b50eaa98-689b-4742-8024-cdf74f95d5c8
> 无需下载，浏览器直接打开即可交互。
**页面状态：**
- 全国省份视图 — 月份筛选器 + 当月总数卡片 + 各省份横向柱状图
- 城市下钻视图 — 点击省份柱子进入，面包屑「全国 › 广东省」+ 城市排行
**交互流程：** 点击省份柱子进入城市视图，点击面包屑「全国」或「返回全国」按钮返回。
**审核 checklist：**
- [ ] 页面布局和组件符合预期？
- [ ] 交互路径（下钻、返回）正确？
- [ ] 数据定义（新增上线 = 首次上线，归属 = 门店注册地址）理解一致？
- [ ] 权限范围（超管看全国，运营商看自己区域）正确？
**确认方式：在本 PR 评论「原型确认 ✅」，然后 Approve + Merge**...
|
0
|
0
|
Edit
Delete
|
|
13
|
4
|
758
|
0
|
1787887148
|
## 关联 Intent
[PR #1 — 按省市统计设备月度新增上线数量报表](https:// ## 关联 Intent
[PR #1 — 按省市统计设备月度新增上线数量报表](https://gitea.g-hi.com/laiqiaojie/jh-project/pulls/1)
---
## PM 确认原型
**原型文件（点击直接打开，可交互）：**
[设备上线分布 — 原型.html](https://gitea.g-hi.com/laiqiaojie/jh-project/raw/branch/design/device-online-stats-by-region/design/assets/device-online-stats-by-region/prototype.html)
> 浏览器直接打开可交互，无需任何工具。
**页面状态：**
- 全国省份视图 — 月份筛选器 + 当月总数卡片 + 各省份横向柱状图
- 城市下钻视图 — 点击省份柱子进入，面包屑「全国 › 广东省」+ 城市排行
**交互流程：** 点击省份柱子进入城市视图，点击面包屑「全国」或「返回全国」按钮返回。
**审核 checklist：**
- [ ] 页面布局和组件符合预期？
- [ ] 交互路径（下钻、返回）正确？
- [ ] 数据定义（新增上线 = 首次上线，归属 = 门店注册地址）理解一致？
- [ ] 权限范围（超管看全国，运营商看自己区域）正确？
**确认方式：在本 PR 评论「原型确认 ✅」，然后 Approve + Merge**...
|
0
|
0
|
Edit
Delete
|
|
14
|
4
|
758
|
0
|
1787891110
|
## 关联 Intent
[PR #1 — 按省市统计设备月度新增上线数量报表](https:// ## 关联 Intent
[PR #1 — 按省市统计设备月度新增上线数量报表](https://gitea.g-hi.com/laiqiaojie/jh-project/pulls/1)
---
## PM 确认原型
**原型文件下载：**
[设备上线分布 prototype.html](https://gitea.g-hi.com/laiqiaojie/jh-project/src/branch/design/device-online-stats-by-region/design/assets/device-online-stats-by-region/prototype.html)
> 打开链接后点击页面右上角「原始文件」→ 右键另存为 → 本地双击打开，可交互。
**页面状态：**
- 全国省份视图 — 月份筛选器 + 当月总数卡片 + 各省份横向柱状图
- 城市下钻视图 — 点击省份柱子进入，面包屑「全国 › 广东省」+ 城市排行
**交互流程：** 点击省份柱子进入城市视图，点击面包屑「全国」或「返回全国」按钮返回。
**审核 checklist：**
- [ ] 页面布局和组件符合预期？
- [ ] 交互路径（下钻、返回）正确？
- [ ] 数据定义（新增上线 = 首次上线，归属 = 门店注册地址）理解一致？
- [ ] 权限范围（超管看全国，运营商看自己区域）正确？
**确认方式：在本 PR 评论「原型确认 ✅」，然后 Approve + Merge**...
|
0
|
0
|
Edit
Delete
|
|
15
|
4
|
758
|
0
|
1787891481
|
## 关联 Intent
[PR #1 — 按省市统计设备月度新增上线数量报表](https:// ## 关联 Intent
[PR #1 — 按省市统计设备月度新增上线数量报表](https://gitea.g-hi.com/laiqiaojie/jh-project/pulls/1)
---
## PM 确认原型
**在线原型（点击直接打开，可交互，无需登录）：**
https://claude.ai/code/artifact/b50eaa98-689b-4742-8024-cdf74f95d5c8
**页面状态：**
- 全国省份视图 — 月份筛选器 + 当月总数卡片 + 各省份横向柱状图
- 城市下钻视图 — 点击省份柱子进入，面包屑「全国 › 广东省」+ 城市排行
**交互流程：** 点击省份柱子进入城市视图，点击面包屑「全国」或「返回全国」按钮返回。
**审核 checklist：**
- [ ] 页面布局和组件符合预期？
- [ ] 交互路径（下钻、返回）正确？
- [ ] 数据定义（新增上线 = 首次上线，归属 = 门店注册地址）理解一致？
- [ ] 权限范围（超管看全国，运营商看自己区域）正确？
**确认方式：在本 PR 评论「原型确认 ✅」，然后 Approve + Merge**...
|
0
|
0
|
Edit
Delete
|
|
16
|
4
|
758
|
0
|
1787906875
|
## 关联 Intent
[PR #1 — 按省市统计设备月度新增上线数量报表](https:// ## 关联 Intent
[PR #1 — 按省市统计设备月度新增上线数量报表](https://gitea.g-hi.com/laiqiaojie/jh-project/pulls/1)
---
## PM 确认原型
**需求说明文档：**
[design/device-online-stats-by-region.md](https://gitea.g-hi.com/laiqiaojie/jh-project/src/branch/design/device-online-stats-by-region/design/device-online-stats-by-region.md)
**在线原型（点击直接打开，可交互，无需登录）：**
https://claude.ai/code/artifact/b50eaa98-689b-4742-8024-cdf74f95d5c8
**页面状态：**
- 全国省份视图 — 月份筛选器 + 当月总数卡片 + 各省份横向柱状图
- 城市下钻视图 — 点击省份柱子进入，面包屑「全国 › 广东省」+ 城市排行
**交互流程：** 点击省份柱子进入城市视图，点击面包屑「全国」或「返回全国」按钮返回。
**审核 checklist：**
- [ ] 页面布局和组件符合预期？
- [ ] 交互路径（下钻、返回）正确？
- [ ] 数据定义（新增上线 = 首次上线，归属 = 门店注册地址）理解一致？
- [ ] 权限范围（超管看全国，运营商看自己区域）正确？
**确认方式：在本 PR 评论「原型确认 ✅」，然后 Approve + Merge**...
|
0
|
0
|
Edit
Delete
|
|
17
|
4
|
769
|
0
|
1788247154
|
## 关联 Issue
Close laiqiaojie/jh-project#5 — 按省市统计 ## 关联 Issue
Close laiqiaojie/jh-project#5 — 按省市统计设备月度新增上线数量报表（Web 前端）
## 变更说明
- 新增 `src/views/data_report/device_online_stats.vue` 页面组件
- 省份视图：横向柱状图展示各省份当月新增上线设备数，点击下钻城市
- 城市视图：横向柱状图展示选定省份各城市分布，面包屑返回全国
- 使用 CSS 自定义 bar（不引入 ECharts），保持项目依赖不变
- 更新 `src/router/pages.js`：注册 device_online_stats 组件
- 更新 `src/router/index.js`：新增 `/data_report/device_online_stats` 路由规则
## 测试说明
- 月份切换后图表重新加载
- 点击省份柱子进入城市视图，面包屑显示「全国 › XX省」
- 点击「全国」/「返回全国」返回省份视图
- 无数据月份显示空状态
## 产物归档
- Plan：`plan/device-online-stats-by-region-web.md`（在 jh-project 仓库）
- 设计文档：`design/device-online-stats-by-region.md`
...
|
1
|
0
|
Edit
Delete
|
|
18
|
4
|
769
|
0
|
1789377127
|
## 关联 Issue
Close laiqiaojie/jh-project#5 — 按省市统计 ## 关联 Issue
Close laiqiaojie/jh-project#5 — 按省市统计设备月度新增上线数量报表（Web 前端）
## 变更说明
- 新增 页面组件
- 省份视图：横向柱状图展示各省份当月新增上线设备数，点击下钻城市
- 城市视图：横向柱状图展示选定省份各城市分布，面包屑返回全国
- 使用 CSS 自定义 bar（不引入 ECharts），保持项目依赖不变
- 更新 ：注册 device_online_stats 组件
- 更新 ：新增 路由规则
- **修复** ： 在父菜单 为空时拼出 双斜杠，导致路由匹配失败
- **修复** ： 同一根因的双斜杠问题
## 测试说明
- 月份切换后图表重新加载
- 点击省份柱子进入城市视图，面包屑显示「全国 › XX省」
- 点击「全国」/「返回全国」返回省份视图
- 无数据月份显示空状态
- 点击「数据」顶部菜单 → 侧栏「设备上线分布」→ 组件正常渲染（已端到端验证）
## DB 变更（需手动执行）
## 产物归档
- Plan：（在 jh-project 仓库）
- 设计文档：
🤖 Generated with [Claude Code](https://claude.com/claude-code)...
|
0
|
0
|
Edit
Delete
|
|
19
|
4
|
769
|
0
|
1789379033
|
## 关联 Issue
Related to laiqiaojie/jh-project#5 — ## 关联 Issue
Related to laiqiaojie/jh-project#5 — 按省市统计设备月度新增上线数量报表（Web 前端）
## 变更说明
- 新增 页面组件
- 省份视图：横向柱状图展示各省份当月新增上线设备数，点击下钻城市
- 城市视图：横向柱状图展示选定省份各城市分布，面包屑返回全国
- 使用 CSS 自定义 bar（不引入 ECharts），保持项目依赖不变
- 更新 ：注册 device_online_stats 组件
- 更新 ：新增 路由规则
- **修复** ： 在父菜单 为空时拼出 双斜杠，导致路由匹配失败
- **修复** ： 同一根因的双斜杠问题
## 测试说明
- 月份切换后图表重新加载
- 点击省份柱子进入城市视图，面包屑显示「全国 › XX省」
- 点击「全国」/「返回全国」返回省份视图
- 无数据月份显示空状态
- 点击「数据」顶部菜单 → 侧栏「设备上线分布」→ 组件正常渲染（已端到端验证）
## DB 变更（需手动执行）
## 产物归档
- Plan：（在 jh-project 仓库）
- 设计文档：
🤖 Generated with [Claude Code](https://claude.com/claude-code)...
|
0
|
0
|
Edit
Delete
|
|
20
|
4
|
756
|
0
|
1789379898
|
Related to #8
## 需求摘要
在「数据报表 > 设备分析」下新增报表，按月筛 Related to #8
## 需求摘要
在「数据报表 > 设备分析」下新增报表，按月筛选展示各省份新激活上线设备数量柱状图排行，支持下钻到城市维度。
## 核心决策
- 统计口径：当月**新激活**上线设备（首次上线，取 ahead_authenticate_log 表的 create_time 字段）
- 地区归属：取设备绑定**门店地址**的省/市字段
- 交互方式：点击省份**下钻**到城市排行（非 Tab 切换）
- 权限：跟随现有 agent_id 角色体系，超管看全国，运营商看自己区域
## 不在范围内
- 不做 Excel 导出
- 不做地图热力图
- 不做区/县级别
- 不做跨月趋势
## 产物文件
[intent/device-online-stats-by-region.md](https://gitea.g-hi.com/laiqiaojie/jh-project/src/branch/intent/device-online-stats-by-region/intent/device-online-stats-by-region.md)
## PM 审核清单（参考 REVIEW.md）
- [ ] 需求背景和问题描述是否准确反映了原始诉求？
- [ ] 期望结果是否可验证？
- [ ] 不在范围内的排除项是否合理？
- [ ] 受影响系统判断是否正确（admin / ahead_authenticate_log）？
- [ ] 本次是否接受排期，进入 Design 阶段？...
|
0
|
0
|
Edit
Delete
|
|
21
|
4
|
758
|
0
|
1789379899
|
Related to #8
## 关联 Intent
[PR #1 — 按省市统计设备月度新增上 Related to #8
## 关联 Intent
[PR #1 — 按省市统计设备月度新增上线数量报表](https://gitea.g-hi.com/laiqiaojie/jh-project/pulls/1)
---
## PM 确认原型
**需求说明文档：**
[design/device-online-stats-by-region.md](https://gitea.g-hi.com/laiqiaojie/jh-project/src/branch/design/device-online-stats-by-region/design/device-online-stats-by-region.md)
**在线原型（点击直接打开，可交互，无需登录）：**
https://claude.ai/code/artifact/b50eaa98-689b-4742-8024-cdf74f95d5c8
**页面状态：**
- 全国省份视图 — 月份筛选器 + 当月总数卡片 + 各省份横向柱状图
- 城市下钻视图 — 点击省份柱子进入，面包屑「全国 › 广东省」+ 城市排行
**交互流程：** 点击省份柱子进入城市视图，点击面包屑「全国」或「返回全国」按钮返回。
**审核 checklist：**
- [ ] 页面布局和组件符合预期？
- [ ] 交互路径（下钻、返回）正确？
- [ ] 数据定义（新增上线 = 首次上线，归属 = 门店注册地址）理解一致？
- [ ] 权限范围（超管看全国，运营商看自己区域）正确？
**确认方式：在本 PR 评论「原型确认 ✅」，然后 Approve + Merge**...
|
0
|
0
|
Edit
Delete
|
|
22
|
4
|
768
|
0
|
1788245555
|
## 关联 Issue
[#4 — [后台] 按省市统计设备月度新增上线数量报表](https:/ ## 关联 Issue
[#4 — [后台] 按省市统计设备月度新增上线数量报表](https://gitea.g-hi.com/laiqiaojie/jh-project/issues/4)
## 说明
补交 Plan 阶段产物（此前误提交到已合并关闭的 design 分支，未能进入 main，见此 PR 重新提交）。
代码已实现并提交：[laiqiaojie/admin#1](https://gitea.g-hi.com/laiqiaojie/admin/pulls/1)
按 REVIEW.md「跳过评审的路径」，`plan/` 产物文件不需要 Tech Lead 单独审核，随此 PR 直接入库。
...
|
1
|
0
|
Edit
Delete
|
|
23
|
4
|
768
|
0
|
1789379899
|
Related to #8
## 关联 Issue
[#4 — [后台] 按省市统计设备月度新增 Related to #8
## 关联 Issue
[#4 — [后台] 按省市统计设备月度新增上线数量报表](https://gitea.g-hi.com/laiqiaojie/jh-project/issues/4)
## 说明
补交 Plan 阶段产物（此前误提交到已合并关闭的 design 分支，未能进入 main，见此 PR 重新提交）。
代码已实现并提交：[laiqiaojie/admin#1](https://gitea.g-hi.com/laiqiaojie/admin/pulls/1)
按 REVIEW.md「跳过评审的路径」，`plan/` 产物文件不需要 Tech Lead 单独审核，随此 PR 直接入库。...
|
0
|
0
|
Edit
Delete
|
|
24
|
4
|
770
|
0
|
1788247386
|
## 说明
在 `build-complete` skill 里新增一步：Plan 阶段确定接口设 ## 说明
在 `build-complete` skill 里新增一步：Plan 阶段确定接口设计后、代码开发完成时，如涉及新增/修改接口，需要生成并归档接口文档：
- Apifox（规范化 OpenAPI 文档，Claude 通过 API 增量导入）
- `docs/frontend-specs/<功能名>.md`（面向其他端的对接说明文档，固定五章结构）
背景：issue #4 实现完成后发现接口文档一直没有归档，靠事后补做；这次把它固化成流程里的正式一步，插在"提交 plan.md"和"开代码 PR"之间。
同时补充了代码仓库与 jh-project 分离时的注意事项（milestone/label 可能不存在、Close #N 跨仓库不生效）。
...
|
1
|
0
|
Edit
Delete
|
|
25
|
4
|
770
|
0
|
1789379900
|
Related to #8
## 说明
在 `build-complete` skill 里新增 Related to #8
## 说明
在 `build-complete` skill 里新增一步：Plan 阶段确定接口设计后、代码开发完成时，如涉及新增/修改接口，需要生成并归档接口文档：
- Apifox（规范化 OpenAPI 文档，Claude 通过 API 增量导入）
- `docs/frontend-specs/<功能名>.md`（面向其他端的对接说明文档，固定五章结构）
背景：issue #4 实现完成后发现接口文档一直没有归档，靠事后补做；这次把它固化成流程里的正式一步，插在"提交 plan.md"和"开代码 PR"之间。
同时补充了代码仓库与 jh-project 分离时的注意事项（milestone/label 可能不存在、Close #N 跨仓库不生效）。...
|
0
|
0
|
Edit
Delete
|
|
26
|
4
|
759
|
0
|
1787909526
|
## 关联 Design PR
[PR #3 — Design: 按省市统计设备月度新增上线数量报 ## 关联 Design PR
[PR #3 — Design: 按省市统计设备月度新增上线数量报表](https://gitea.g-hi.com/laiqiaojie/jh-project/pulls/3)
## 工作范围
负责后台接口实现：
- 新增查询接口，按月份统计各省份新增上线设备数量
- 支持下钻查询：指定省份，返回城市级别数据
- 按权限过滤：超管返回全国数据，运营商返回自己区域
## 产物
- （实现前提交，Tech Lead 审核后开始 Build）
## 参考
- 需求说明：[design/device-online-stats-by-region.md](https://gitea.g-hi.com/laiqiaojie/jh-project/src/branch/design/device-online-stats-by-region/design/device-online-stats-by-region.md)
- 在线原型：https://claude.ai/code/artifact/b50eaa98-689b-4742-8024-cdf74f95d5c8...
|
1
|
0
|
Edit
Delete
|
|
27
|
4
|
759
|
0
|
1789379913
|
> 子任务，属于主 Issue #8「按省市统计设备月度新增上线数量报表」
## 关联 De > 子任务，属于主 Issue #8「按省市统计设备月度新增上线数量报表」
## 关联 Design PR
[PR #3 — Design: 按省市统计设备月度新增上线数量报表](https://gitea.g-hi.com/laiqiaojie/jh-project/pulls/3)
## 工作范围
负责后台接口实现：
- 新增查询接口，按月份统计各省份新增上线设备数量
- 支持下钻查询：指定省份，返回城市级别数据
- 按权限过滤：超管返回全国数据，运营商返回自己区域
## 产物
- （实现前提交，Tech Lead 审核后开始 Build）
## 参考
- 需求说明：[design/device-online-stats-by-region.md](https://gitea.g-hi.com/laiqiaojie/jh-project/src/branch/design/device-online-stats-by-region/design/device-online-stats-by-region.md)
- 在线原型：https://claude.ai/code/artifact/b50eaa98-689b-4742-8024-cdf74f95d5c8...
|
0
|
0
|
Edit
Delete
|
|
28
|
4
|
760
|
0
|
1787909556
|
## 关联 Design PR
[PR #3 — Design: 按省市统计设备月度新增上线数量报 ## 关联 Design PR
[PR #3 — Design: 按省市统计设备月度新增上线数量报表](https://gitea.g-hi.com/laiqiaojie/jh-project/pulls/3)
## 工作范围
负责 Web 前端页面实现：
- 数据报表 → 设备上线分布 页面
- 月份筛选器 + 当月总数卡片 + 省份横向柱状图
- 点击省份下钻到城市视图，支持面包屑返回
## 产物
- plan/device-online-stats-by-region-web.md（实现前提交，Tech Lead 审核后开始 Build）
## 参考
- 需求说明：[design/device-online-stats-by-region.md](https://gitea.g-hi.com/laiqiaojie/jh-project/src/branch/design/device-online-stats-by-region/design/device-online-stats-by-region.md)
- 在线原型：https://claude.ai/code/artifact/b50eaa98-689b-4742-8024-cdf74f95d5c8...
|
1
|
0
|
Edit
Delete
|
|
29
|
4
|
760
|
0
|
1789379913
|
> 子任务，属于主 Issue #8「按省市统计设备月度新增上线数量报表」
## 关联 De > 子任务，属于主 Issue #8「按省市统计设备月度新增上线数量报表」
## 关联 Design PR
[PR #3 — Design: 按省市统计设备月度新增上线数量报表](https://gitea.g-hi.com/laiqiaojie/jh-project/pulls/3)
## 工作范围
负责 Web 前端页面实现：
- 数据报表 → 设备上线分布 页面
- 月份筛选器 + 当月总数卡片 + 省份横向柱状图
- 点击省份下钻到城市视图，支持面包屑返回
## 产物
- plan/device-online-stats-by-region-web.md（实现前提交，Tech Lead 审核后开始 Build）
## 参考
- 需求说明：[design/device-online-stats-by-region.md](https://gitea.g-hi.com/laiqiaojie/jh-project/src/branch/design/device-online-stats-by-region/design/device-online-stats-by-region.md)
- 在线原型：https://claude.ai/code/artifact/b50eaa98-689b-4742-8024-cdf74f95d5c8...
|
0
|
0
|
Edit
Delete
|
|
30
|
4
|
769
|
0
|
1789379914
|
## 关联 Issue
Related to laiqiaojie/jh-project#5
Re ## 关联 Issue
Related to laiqiaojie/jh-project#5
Related to laiqiaojie/jh-project#8 — 按省市统计设备月度新增上线数量报表（Web 前端）
## 变更说明
- 新增 页面组件
- 省份视图：横向柱状图展示各省份当月新增上线设备数，点击下钻城市
- 城市视图：横向柱状图展示选定省份各城市分布，面包屑返回全国
- 使用 CSS 自定义 bar（不引入 ECharts），保持项目依赖不变
- 更新 ：注册 device_online_stats 组件
- 更新 ：新增 路由规则
- **修复** ： 在父菜单 为空时拼出 双斜杠，导致路由匹配失败
- **修复** ： 同一根因的双斜杠问题
## 测试说明
- 月份切换后图表重新加载
- 点击省份柱子进入城市视图，面包屑显示「全国 › XX省」
- 点击「全国」/「返回全国」返回省份视图
- 无数据月份显示空状态
- 点击「数据」顶部菜单 → 侧栏「设备上线分布」→ 组件正常渲染（已端到端验证）
## DB 变更（需手动执行）
## 产物归档
- Plan：（在 jh-project 仓库）
- 设计文档：
🤖 Generated with [Claude Code](https://claude.com/claude-code)...
|
0
|
0
|
Edit
Delete
|
|
31
|
4
|
773
|
0
|
1789379887
|
## 功能概述
在 PC 管理后台「数据报表」模块，按省市统计各 KTV 设备每月新增上线数量，支 ## 功能概述
在 PC 管理后台「数据报表」模块，按省市统计各 KTV 设备每月新增上线数量，支持全国省份分布视图 + 城市下钻。
## 完整产物链路
| 阶段 | 产物 | 链接 | 状态 |
|------|------|------|------|
| 需求意图 | Intent 文档 | PR #1 | ✅ 已合并 |
| 设计原型 | Design 文档 | PR #3 | ✅ 已合并 |
| 技术方案（后台） | Plan 文档 | PR #6 | ✅ 已合并 |
| 开发实现（后台） | admin 仓库代码 | admin PR #1 | ✅ 已合并 |
| 开发实现（Web前端） | admin 仓库代码 | admin PR #2 | 🔄 待审核 |
| 测试验收（后台） | — | Issue #4 | 🧪 待测试 |
| 测试验收（Web前端） | — | Issue #5 | 🧪 待测试 |
## 测试工程师入口
- 后台接口测试 → Issue #4
- Web 前端测试 → Issue #5
## 验收标准
- 后台 API 返回省份/城市维度的月度新增上线设备数，分页正确
- PC 管理后台菜单「数据报表 > 设备上线分布」可正常点击进入
- 省份视图正常渲染（横向柱状图），点击下钻到城市视图
- 城市视图面包屑可返回全国
- 月份切换后数据刷新正确
- 无数据月份显示空状态，不报错...
|
1
|
0
|
Edit
Delete
|
|
32
|
4
|
773
|
0
|
1789380098
|
## 功能概述
在 PC 管理后台「数据报表」模块，按省市统计各 KTV 设备每月新增上线数量，支 ## 功能概述
在 PC 管理后台「数据报表」模块，按省市统计各 KTV 设备每月新增上线数量，支持全国省份分布视图 + 城市下钻。
## 完整产物链路
| 阶段 | 产物 | 链接 | 状态 |
|------|------|------|------|
| 需求意图 | Intent 文档 | PR #1 | ✅ 已合并 |
| 设计原型 | Design 文档 | PR #3 | ✅ 已合并 |
| 技术方案（后台） | Plan 文档 | PR #6 | ✅ 已合并 |
| 开发实现（后台） | admin 仓库代码 | admin PR #1 | ✅ 已合并 |
| 开发实现（Web前端） | admin 仓库代码 | admin PR #2 | ✅ 已合并 |
| 测试验收（后台） | — | Issue #4 | 🧪 待测试 |
| 测试验收（Web前端） | — | Issue #5 | 🧪 待测试 |
## 测试工程师入口
- 后台接口测试 → Issue #4
- Web 前端测试 → Issue #5
## 验收标准
- 后台 API 返回省份/城市维度的月度新增上线设备数，分页正确
- PC 管理后台菜单「数据报表 > 设备上线分布」可正常点击进入
- 省份视图正常渲染（横向柱状图），点击下钻到城市视图
- 城市视图面包屑可返回全国
- 月份切换后数据刷新正确
- 无数据月份显示空状态，不报错...
|
0
|
0
|
Edit
Delete
|
|
33
|
4
|
773
|
0
|
1789380277
|
## 功能概述
在 PC 管理后台「数据报表」模块，按省市统计各 KTV 设备每月新增上线数量，支 ## 功能概述
在 PC 管理后台「数据报表」模块，按省市统计各 KTV 设备每月新增上线数量，支持全国省份分布视图 + 城市下钻。
## 完整产物链路
| 阶段 | 产物 | 链接 | 状态 |
|------|------|------|------|
| 需求意图 | Intent 文档 | PR #1 | ✅ 已合并 |
| 设计原型 | Design 文档 | PR #3 | ✅ 已合并 |
| 技术方案（后台） | Plan 文档 | PR #6 | ✅ 已合并 |
| 开发实现（后台） | admin 仓库代码 | admin PR #1 | ✅ 已合并 |
| 开发实现（Web前端） | admin 仓库代码 | admin PR #2 | ✅ 已合并 |
| 测试验收 | — | 本 Issue | 🧪 待测试 |
## 验收标准
- 后台 API 返回省份/城市维度的月度新增上线设备数，分页正确
- PC 管理后台菜单「数据报表 > 设备上线分布」可正常点击进入
- 省份视图正常渲染（横向柱状图），点击下钻到城市视图
- 城市视图面包屑可返回全国
- 月份切换后数据刷新正确
- 无数据月份显示空状态，不报错...
|
0
|
0
|
Edit
Delete
|
|
34
|
5
|
852
|
0
|
1793111729
|
<!--
PR 治理模板。提交前请逐项确认，确保符合 docs/standards 下的 <!--
PR 治理模板。提交前请逐项确认，确保符合 docs/standards 下的工程规范。
CI 会执行：pnpm check（命名 + 单源漂移 + 治理棘轮 + lint + typecheck）；
有测试 DB 的流水线另执行 DATABASE_URL=... pnpm check:runtime。
-->
## 变更内容
<!-- 简述这次改了什么、为什么改（聚焦 why） -->
-
## 涉及业务概念
<!-- 列出涉及的业务词典英文名，例如 store / order / verification。参见 docs/domain-glossary.md -->
-
## 检查清单
### 命名一致性
- [ ] 业务概念使用了词典中的标准英文名（未出现 shop/branch/seller/voucher/writeOff 等禁用词）
- [ ] 数据库 snake_case + 复数表名；API/JSON 字段 camelCase；类型 PascalCase；常量 SCREAMING_SNAKE_CASE
- [ ] `pnpm check:naming` 通过
- [ ] `pnpm check:schema` 通过，未新增第二份状态/契约真源
### API / 契约
- [ ] 不涉及 API 变更
- [ ] 新增/修改了 API，路由符合当前生命周期规范：既有 Personnel Core 保持 `/api/personnel/*`，HR v2 领域使用 `/api/v2/{domain}/*`，身份协议使用标准 OIDC 端点
- [ ] 已更新 `packages/contracts` 中的 Zod schema / DTO / 类型（前后端共用同一份）
- [ ] 无破坏前端兼容的字段删除/重命名（如有，已在描述中说明迁移方案）
### 数据库
- [ ] 不涉及数据库变更
- [ ] 新增/修改了表或字段，已通过 migration review（表名复数、字段 snake_case、外键 xxx_id、时间 _at、状态 status）
- [ ] 高增长表已考虑分区；涉及多租户的表带 tenant_id
- [ ] 写链显式带 tenant_id；跨租户读写按 404/隔离口径处理
### 数据库迁移（迁移即代码：版本/顺序/内容/环境/发布/回滚一致）
- [ ] 改 schema.prisma 的同时**已生成并提交 migration**（`pnpm db:migrate:dev --name <change>`），未只改 schema 不落迁移
- [ ] **未修改已发布过的历史 migration 文件**（内容一致：历史不可变，新变更走新迁移）
- [ ] `pnpm check:migrations` 通过（迁移历史在位 / 无未豁免高危 DDL / schema 表、enum、`@map` 列均已落迁移）
- [ ] 破坏性变更（删表/删列/改名/改类型/加 NOT NULL/加唯一约束）走 **expand→migrate→contract** 三阶段，不一次切
- [ ] 大表加索引用 `CREATE INDEX CONCURRENTLY`；大批量回填走 BullMQ 分批任务，不塞进 migration
- [ ] 高危但确需的 DDL 已加 `-- migration-allow:<原因>` 留痕，并在下方回滚方案说明
- [ ] 非开发环境只用 `migrate deploy`（禁止 `db push` / 线上手动 ALTER）；发布前 `pnpm db:migrate:status` 无 drift
### 实时 / 队列
- [ ] 不涉及
- [ ] 关键业务事件进入 BullMQ 或持久化事件表（未仅依赖 Redis Pub/Sub）
- [ ] 写库事件与真实写操作在同一 tx 写入 outbox，未在 commit 后旁路 publish
- [ ] 实时通道选型符合规范（订单/看板/通知用 SSE；设备在线/包间控制/IM 用 WebSocket）
### 质量与发布
- [ ] 通过 `pnpm lint` 与 `pnpm typecheck`
- [ ] 通过 `pnpm check:governance`，`reports/*.latest.json` 已刷新且无棘轮回退
- [ ] 涉及写链 / DB / 租户 / 状态机时，通过 `DATABASE_URL=... pnpm check:runtime`，`reports/runtime-acceptance.latest.json` 已刷新
- [ ] 涉及页面或浏览器行为时，`pnpm check:ui` 与 `pnpm check:ui:fastify` 均通过，未只验证一个后端
- [ ] 已补充/更新必要的测试
- [ ] 不需要回滚方案
- [ ] 需要回滚方案，已在下方说明
## 回滚方案 / 其他说明
-
...
|
1
|
0
|
Edit
Delete
|
|
35
|
5
|
852
|
0
|
1793111829
|
> 状态说明：本 PR 已于 2026-10-27 合入 `main`（合并提交 `7835e > 状态说明：本 PR 已于 2026-10-27 合入 `main`（合并提交 `7835e3b`），合并时 CI 检查尚未运行；远端 CI 结果以本 PR 的检查为准。
## 概要
执行蓝图 D-10（关闭 H22）：HR API 默认只监听 `127.0.0.1`，需要容器或局域网访问时必须显式设 `HOST`（如 `0.0.0.0`，双栈用 `::`）。改动前后都实测了 04 runtime 容器的可达性。记录见 `docs/domain/enterprise-control-plane-integration-blueprint-2026-10-27.md` §4.7。
## 改动
- **监听地址单源** `apps/api-nestjs/src/listen-host.ts`：未设或空 `HOST` → `127.0.0.1`，否则用显式值。`main.ts` 只经 `resolveListenHost()` 取值，启动日志写明是否只在回环上监听。
- **Web 默认目标**：`next.config.ts` 代理与 `useRealtime` 的 WS 默认值从 `localhost:3001` 改为 `127.0.0.1:3001`，避免 `localhost` 先解析到 `::1` 时连不上只听 IPv4 回环的 API；`.claude/launch.json` 同步。
- **防回潮**：`check:dual-backend` 新增 `scripts/lib/listen-host-guard.mjs`（默认值必须是回环，`main.ts` 不得绕过解析函数），node 单测 9 个负例；把默认值改回 `0.0.0.0` 的变异探针判红 2 处。行为单测 `apps/api-nestjs/test/listen-host.test.ts` 3 例。
- **文档同步**：CLAUDE.md（常用命令、运行时拓扑、G23 中 H22 移为已关闭）、README、后端规范、Scope 来源接入、蓝图 §4.7 / H22 / D-10、给 04 的答复草稿、框架同步评估 F-7。
## 实测证据
证据文件：`docs/evidence/d10-listen-host-2026-10-27.json`（本机 Docker Desktop；对 04 容器只做只读 GET，未改 04 的容器或配置）。
**改动前**，用宿主上的最小 HTTP 探针：
| 绑定 | 宿主回环 | 本机局域网 IP | 04 容器经 `host.docker.internal` |
| --- | --- | --- | --- |
| `0.0.0.0` | 可达 | 可达 | 可达 |
| `127.0.0.1` | 可达 | 不可达 | 可达（宿主看到来源 `127.0.0.1`） |
结论：改为回环默认后，04 的 Scope 来源探针（`SCOPE_HR_SOURCE_URL` 指向 `host.docker.internal:65281`）仍可达。
**改动后**，用真实构建的 HR API 配本仓一次性 PostgreSQL/Redis（跑完已删除）：
| `HOST` | lsof | 局域网 `/api/health` | 04 容器 `/api/health` |
| --- | --- | --- | --- |
| 未设 | `127.0.0.1` | 不可达 | 200，database/redis up |
| 空串 | `127.0.0.1` | 不可达 | 200，database/redis up |
| `0.0.0.0` | `*` | 200 | 200，database/redis up |
另外，Web 不设 `API_PROXY_TARGET` 时，经 Next 代理访问 `/api/health` 返回 200。
**全量验收**（本地，clean `9c53371`，一次性库，跑完已删，报告无口令命中）：
- `check:runtime` 455/455：比 452 多出的是新增的 3 例；冻结行为、多实例 Outbox、依赖故障三项均通过。
- `check:ui` 46/46。
- `check:governance` 仅剩已知两项回退：O22（OS main 不含 0.19.6）、`osProductReleaseTargetRemotes` 2→1；来源指纹违规 0。
- 远端 CI 以本 PR 的运行为准。
**未覆盖**：
- 未用 Scope 来源真实凭据调用签名查询，只证明网络可达。
- Linux 原生 Docker 经 `host-gateway` 连不到宿主回环，这类部署必须显式设 `HOST`。
- 仓外 65281 实例当前无进程；它的源码 `326ae3e` 不读 `HOST`，恢复前须换到含本改动的提交。
- `apps/web` 的 `next dev` / `next start` 仍按 Next 默认监听全部网卡，不在本 PR 范围。
## 待裁：00 框架 F-7
00 框架 `apps/api-nestjs/src/main.ts:8` 仍是 `process.env.HOST ?? "0.0.0.0"`；`backend-standard.md:7`、`COMPATIBILITY.md:45`、ADR-0010 与迁移手册都把 `0.0.0.0` 写成默认，理由是容器内可达。HR 因此有意与框架不同。本 PR 未改框架仓，请框架 Owner 二选一：
- **(a)** 框架也改为回环默认，容器部署在 Dockerfile / compose 里显式设 `HOST=0.0.0.0`。
- **(b)** 维持 `0.0.0.0`，在 `COMPATIBILITY.md` 登记「消费者可偏离为回环」。
无论选哪个，下一次框架同步或叠加仓 `replace: true`（F-5）都不得把 HR 的回环默认冲回去。详见 `docs/framework-sync-assessment-2026-10-27.md` F-7。
## 另外发现（不在本 PR 范围）
- `apps/api-nestjs/docker-compose.yml` 的开发 PostgreSQL（口令为 `app`）与 Redis 映射到 `0.0.0.0`，属同类暴露。
- `CLAUDE.md` 基线表 runtime 行仍是 10-25 的读数 452：报告指纹包含文档，验收后改文档会使报告失效，留待下次改文档时一并更新。
🤖 Generated with [Claude Code](https://claude.com/claude-code)...
|
0
|
0
|
Edit
Delete
|
|
36
|
5
|
851
|
0
|
1793111425
|
## 改了什么
蓝图 [enterprise-control-plane-integratio ## 改了什么
蓝图 [enterprise-control-plane-integration-blueprint-2026-10-27.md](docs/domain/enterprise-control-plane-integration-blueprint-2026-10-27.md) §4 / §4.1 与 CLAUDE.md G23 仍写「本地分支、未合入 main」，而该批改动已于同日经 PR #6 合入 main（`98df51e`）。本 PR 只改这三处作用域说明，改为注明记录时作用域与合入事实。
## 验证
- `pnpm check:governance-docs` 通过（AGENTS.md 仍为 CLAUDE.md 符号链接）
- `pnpm check:docs-truth` 通过
- 门禁顺带重写的 latest 报告已还原，未随本 PR 改动
## 未覆盖
- 远端 CI 结果未查验（本机无 Gitea API 令牌）
- 蓝图 §4.6 已登记的另两处文档漂移（owner-matrix 双后端措辞、scope-source-integration IdentityLink 归属）不在本 PR 范围
🤖 Generated with [Claude Code](https://claude.com/claude-code)...
|
1
|
0
|
Edit
Delete
|
|
37
|
5
|
851
|
0
|
1793114019
|
## 改了什么
PR #9（D-10）只改了 API 默认监听地址；本 PR 补齐其蓝图 §4.7 ## 改了什么
PR #9（D-10）只改了 API 默认监听地址；本 PR 补齐其蓝图 §4.7 记为未覆盖的部分，并收口两处 D3 后文档漂移、登记新缺口 H24。
- **只绑回环**：Web `next dev` / `next start` 与 UI 验收的 `next start` 加 `-H 127.0.0.1`；开发基座 `apps/api-nestjs/docker-compose.yml` 的 PostgreSQL / Redis 端口只发布到回环（此前发布到全部网卡，PG 口令 `app`、Redis 无口令）。已在运行的基座容器须 `docker compose up -d` 重建才生效。
- **防回潮**：在 #9 的 `scripts/lib/listen-host-guard.mjs` 内新增 `exposureViolations`（同一守卫，不另立第二份），接入 `check:dual-backend`；单测 9/9（新增 5 组负例）。门禁级变异：去掉 `scripts.dev` 的 `-H` 后 `check:dual-backend` 判红，已还原。
- **文档**：owner-matrix 的 D3 前「双后端 / Fastify」措辞改为 NestJS 宿主；Scope 来源接入文档改正 IdentityLink 归属（enterprise-idp 拥有，HR 物理承载）；README、CLAUDE.md G23、对接蓝图（§4.1 / §4.7 作用域、新增 §4.8、H20 / H22 / H23）与 04 答复草稿同步。
- **新缺口 H24 / 待裁决 D-12**：D3 保护逐字节冻结全部 `packages/*`（215 个受保护文件）。H20（relay 事实类型去写死，须改 `packages/contracts`）与 publisher / scope-source 的依赖升级因此暂不能在 HR 侧推进。
## 验证（本地，2026-10-27）
- 不设 `HOST` 启动真实构建的 API：只听 `127.0.0.1`，局域网不可达，`--add-host host.docker.internal:host-gateway` 容器访问 `/api/health` 为 200
- `check:runtime` 455/455、`check:ui` 46/46（一次性 PostgreSQL / Redis）
- typecheck 12/12、lint 6/6、`check:d3`、`check:dual-backend`、`check:docs-truth`、`check:governance-docs`、`check:app-manifest` 通过
- `check:governance` 剩 2 项，与 main 相同：O22（D-8，等 OS 写入授权）、`osProductReleaseTargetRemotes` 2→1（D-9）
## 未覆盖
- 远端 CI 未查验（本机无 Gitea API 令牌）
- 00 框架同一默认值（他层仓）；README 第 3 步提到的 `.env.example` 在仓内不存在（既有不一致）
- 分支历史：`e9b02cf`（旧的作用域订正）已被 #9 与本 PR 取代，以 `-s ours` 合并保留，不改变树
🤖 Generated with [Claude Code](https://claude.com/claude-code)...
|
0
|
0
|
Edit
Delete
|
|
38
|
5
|
851
|
0
|
1793115564
|
## 改了什么
PR #9（D-10）只改了 API 默认监听地址；本 PR 补齐其蓝图 §4.7 ## 改了什么
PR #9（D-10）只改了 API 默认监听地址；本 PR 补齐其蓝图 §4.7 记为未覆盖的部分，并收口两处 D3 后文档漂移、登记新缺口 H24。
- **只绑回环**：Web `next dev` / `next start` 与 UI 验收的 `next start` 加 `-H 127.0.0.1`；开发基座 `apps/api-nestjs/docker-compose.yml` 的 PostgreSQL / Redis 端口只发布到回环（此前发布到全部网卡，PG 口令 `app`、Redis 无口令）。已在运行的基座容器须 `docker compose up -d` 重建才生效。
- **防回潮**：在 #9 的 `scripts/lib/listen-host-guard.mjs` 内新增 `exposureViolations`（同一守卫，不另立第二份），接入 `check:dual-backend`；单测 9/9（新增 5 组负例）。门禁级变异：去掉 `scripts.dev` 的 `-H` 后 `check:dual-backend` 判红，已还原。
- **文档**：owner-matrix 的 D3 前「双后端 / Fastify」措辞改为 NestJS 宿主；Scope 来源接入文档改正 IdentityLink 归属（enterprise-idp 拥有，HR 物理承载）；README、CLAUDE.md G23、对接蓝图（§4.1 / §4.7 作用域、新增 §4.8、H20 / H22 / H23）与 04 答复草稿同步。
- **新缺口 H24 / 待裁决 D-12**：D3 保护逐字节冻结全部 `packages/*`（215 个受保护文件）。H20（relay 事实类型去写死，须改 `packages/contracts`）与 publisher / scope-source 的依赖升级因此暂不能在 HR 侧推进。
## 验证（本地，2026-10-27）
- 不设 `HOST` 启动真实构建的 API：只听 `127.0.0.1`，局域网不可达，`--add-host host.docker.internal:host-gateway` 容器访问 `/api/health` 为 200
- `check:runtime` 455/455、`check:ui` 46/46（一次性 PostgreSQL / Redis）
- typecheck 12/12、lint 6/6、`check:d3`、`check:dual-backend`、`check:docs-truth`、`check:governance-docs`、`check:app-manifest` 通过
- `check:governance` 剩 2 项，与 main 相同：O22（D-8，等 OS 写入授权）、`osProductReleaseTargetRemotes` 2→1（D-9）
## 未覆盖
- 远端 CI 未查验（本机无 Gitea API 令牌）
- 00 框架同一默认值（他层仓）；README 第 3 步提到的 `.env.example` 在仓内不存在（既有不一致）
- 分支历史：`e9b02cf`（旧的作用域订正）已被 #9 与本 PR 取代，以 `-s ours` 合并保留，不改变树
🤖 Generated with [Claude Code](https://claude.com/claude-code)...
|
0
|
0
|
Edit
Delete
|
|
39
|
5
|
851
|
0
|
1793115601
|
## 改了什么
本 PR 有三部分；已合入 main 的 PR #9（D-10 API 回环）与 ## 改了什么
本 PR 有三部分；已合入 main 的 PR #9（D-10 API 回环）与 PR #10（H23 根与 apps/* 依赖）均已并入本分支。
### 1. Web / 开发基座只绑回环（蓝图 §4.9）
- Web `next dev` / `next start` 与 UI 验收的 `next start` 加 `-H 127.0.0.1`；开发基座 `apps/api-nestjs/docker-compose.yml` 的 PostgreSQL / Redis 端口只发布到回环（此前发布到全部网卡，PG 口令 `app`、Redis 无口令）。已在运行的基座容器须 `docker compose up -d` 重建才生效。
- 在 #9 的 `scripts/lib/listen-host-guard.mjs` 内新增 `exposureViolations`（同一守卫），接入 `check:dual-backend`；单测 9/9。
- 文档：owner-matrix 去掉 D3 前「双后端 / Fastify」措辞；Scope 来源接入文档改正 IdentityLink 归属（enterprise-idp 拥有）。
### 2. D-12：`packages/*` 受控升级通道（关 H24，蓝图 §4.10）
- D3 保护此前逐字节冻结全部 `packages/*`（215 个受保护文件），台账只放行产品目录。现在同一台账 `docs/post-d3-product-updates.json` 增加 `packageUpdates`：编号 `PKG-NNN` 递增，须写来源与理由，仅限 D3 冻结清单内的 `packages/*` 文件，逐文件从冻结 hash 链式放行；任一条目不合规即整体不放行。
- `check:d3` 30/30：新增登记后放行、未登记 / 台账缺失判红，以及断链、前后相同、非 hash、缺理由、缺来源、编号格式错、编号不递增、空文件、包外路径、非冻结文件、字段类型错均判红。变异探针：删掉「理由与来源」或「链式校验」规则，测试各判红 1 项，已还原。
### 3. H20：出站事实注册表（蓝图 §4.10）
- contracts 新增 `ENTERPRISE_FACT_ENVELOPE_SCHEMAS`（`factType@schemaVersion` → 信封 Schema，当前只有 `EmploymentTransferred@1`）与 `EnterpriseFactTypeUnregisteredError`；`buildEnterpriseFactEnvelope` 按注册表分派。EmploymentTransferred v1 的 Schema 不变。
- relay 去掉全部类型强转；未登记类型或版本记 `FACT_TYPE_UNREGISTERED`，立即进死信、不调用 Publisher（部署补登记后可经既有重放恢复）。
- contracts 两个文件经台账 **PKG-001** 放行（登记前 `check:d3` 对这两个文件判红）。
- `check:app-manifest` M6 新增注册表与 `facts.owns` 双向一致检查（3 个负例）。
- 测试：contracts 新增 4 例；新文件 `apps/api-nestjs/test/enterprise-fact-relay-registry.test.ts` 真实 DB 3 例。原 `enterprise-fact-relay.test.ts` 受 D3 冻结未改，12 例仍全绿。
## 验证（本地，2026-10-27，干净提交 `effed90`）
- `check:runtime` 462/462、`check:ui` 46/46（一次性 PostgreSQL / Redis，跑完删除）
- typecheck、lint、`check:d3`、`check:dual-backend`、`check:app-manifest`、`check:docs-truth`、`check:governance-docs`、`check:migrations`、`check:database-rls` 等静态门禁通过
- `check:governance` 剩 2 项，与 main 相同：O22（D-8，等 OS 写入授权）、`osProductReleaseTargetRemotes` 2→1（D-9）
## 未覆盖
- 远端 CI 未查验（本机无 Gitea API 令牌）
- 新事实（`OrganizationUnitMoved` 等）仍待 Catalog 登记；H21（Scope 消费端写死来源应用）仍开放
- `packages/*` 内的 vitest 2.1.9 与 `client-fact` rc.3 现可经台账升级，本 PR 未做
- 00 框架同一监听默认值（他层仓）；README 第 3 步提到的 `.env.example` 不存在（既有不一致）
🤖 Generated with [Claude Code](https://claude.com/claude-code)...
|
0
|
0
|
Edit
Delete
|
|
40
|
5
|
856
|
0
|
1793145750
|
## 内容
- 对接蓝图新增 §2.5 服务级对接矩阵：HR 与 02/03/04 共 20 ## 内容
- 对接蓝图新增 §2.5 服务级对接矩阵：HR 与 02/03/04 共 20 个对接点，HR 侧写到 file:line，并标明 dev 实际跑通过的只有 3 条：事实写入、Scope 来源、OS 装载产品包。
- 按 04 `e50aad416`（CHG-061）订正：
- 应用清单镜像已合到 0.19.6，工作区镜像剩 5 处差异（H1）；
- 4 条 HR 事实已在 Catalog 登记为 draft，H5 的 Catalog 半边完成；
- Scope 改按 Catalog producer 接受 `juhai.hr` 组织事实，H21 部分关闭，剩载荷约束与投影器现场摄取。
- 新增缺口：
- H25：OS 清单契约仍强制双后端，HR 清单里的 Fastify 声明是占位，不能单方删除；
- H26：门店归属事实没有生产者；
- H27：IdP 令牌 `aud` 是生成的 UUID，不是 `juhai.hr`；
- H28：数字智能层自带一份 0.19.5 副本。
- 同步落地状态：CLAUDE.md G23、两份 CHG 草稿、人域对照表。
- 已合入 `main` `46da429`：CLAUDE.md 冲突以 main 为准，只叠加本分支的 H21 订正。
## 验证（本地，合入 main 后）
- 通过：`check:governance-docs`、`check:docs-truth`、`check:app-manifest`（14/14）、`check:d3`。
- 未重跑：`check:runtime` / `check:ui`。本 PR 改了文档，runtime/UI 报告的来源指纹需要回绑。
- 远端 CI 未查验。
只改 5 份文档，不改代码、产品清单或报告。
🤖 Generated with [Claude Code](https://claude.com/claude-code)...
|
1
|
0
|
Edit
Delete
|
|
41
|
5
|
856
|
0
|
1793150315
|
## 内容
- 对接蓝图新增 §2.5 服务级对接矩阵：HR 与 02/03/04 共 20 个对 ## 内容
- 对接蓝图新增 §2.5 服务级对接矩阵：HR 与 02/03/04 共 20 个对接点，HR 侧写到 file:line，并标明 dev 实际跑通过的只有 3 条：事实写入、Scope 来源、OS 装载产品包。
- 按 04 `e50aad416`（CHG-061）订正：
- 应用清单镜像已合到 0.19.6，工作区镜像剩 5 处差异（H1）；
- 4 条 HR 事实已在 Catalog 登记为 draft，H5 的 Catalog 半边完成；
- Scope 改按 Catalog producer 接受 `juhai.hr` 组织事实，H21 部分关闭，剩载荷约束与投影器现场摄取。
- 新增缺口：
- H25：OS 清单契约仍强制双后端，HR 清单里的 Fastify 声明是占位，不能单方删除；
- H26：门店归属事实没有生产者；
- H27：IdP 令牌 `aud` 是生成的 UUID，不是 `juhai.hr`；
- H28：数字智能层自带一份 0.19.5 副本。
- §2.5 补本机现场读数（2026-10-28 00:35 UTC 前后）：
- HR API 未运行；
- 04 runtime 开了事实受理但缺 `FACT_APPLICATION_BINDINGS_JSON`，IdP 签发的机器令牌会被拒；
- Scope 来源 65281 不可达；
- OS 0.19.6 分支只在本机、未推 Gitea。
- 已确认三项：
- client-fact rc.3 与 rc.8 摘要实现逐行相同（H7 只剩发布）；
- EES 运行时以 `READ_ONLY_PROJECTION` 拒绝已撤回人域命令；
- Scope 证据 `owner: juhai.hr` 由 04 按 HR 签名组装。
- H22：本机开发基座容器已于 00:40 UTC 重建为只绑回环，数据卷沿用。
- **CI 修复**（`a174e46`）：本 PR 首次运行 26581 停在「Build locked OS compatibility sources」，原因是兼容锁指向 D3 后的 OS `1b8ae0d7`，该步却仍写死 `--filter=api-fastify`。
- 现改为经 `scripts/lib/os-host-backends.mjs` 读锁定 OS 的 `backend-profile.json` 决定宿主范围；
- `check:docs-truth` 新增 `ci-os-host-backends` 断言防回潮，对旧工作流负向判红。
- 同步落地状态：CLAUDE.md G23 / G14、两份 CHG 草稿、人域对照表。
- 已合入 `main` `46da429`：CLAUDE.md 冲突以 main 为准，只叠加本分支的 H21 订正。
## 验证（本地，PR 头 `25aecd7`，报告绑定 `a174e46`、clean）
- 通过：`check:runtime` 462/462（地板 452）、`check:ui` 46/46。用的是一次性 PostgreSQL 16 / Redis 7，只绑回环，跑完已删。
- 静态链如实停在 O22（OS main 尚无 0.19.6）。其后 governance-docs、docs-truth、lint、typecheck 通过。`check:governance` 只剩 O22，`reportProvenanceViolations` 0。
- CI 构建步骤：本地覆盖 5 种情形（nestjs-production、D3 前双宿主、缺 profile、非法 profile、profile 与 Fastify 冲突），以及锁定 OS 快照上的 turbo dry-run。
- 远端 CI 见本页检查结果。
🤖 Generated with [Claude Code](https://claude.com/claude-code)...
|
0
|
0
|
Edit
Delete
|
|
42
|
5
|
861
|
0
|
1793153681
|
> **叠在 #13 之上，请先合 #13。** 本 PR 自身只有最后 2 个提交：`7fa > **叠在 #13 之上，请先合 #13。** 本 PR 自身只有最后 2 个提交：`7faad2a`（P1 前置片）与 `19128ad`（报告回绑）；其余提交属 #13。#13 合入后这里的差异会只剩这两项。
## 内容（对接蓝图 §4.15，P1 / H5）
- **contracts**（`packages/contracts/src/enterprise-fact.ts`，台账 PKG-004）
- 新增 `organizationCanonicalIdSchema`（`org_`）。
- 新增 `EmploymentStarted`、`EmploymentTerminated`、`OrganizationUnitStatusChanged` v1 的载荷 Schema，逐字段对应 04 `contracts/schemas/facts/*.v1.json`（CHG-061）。
- 新增三份信封 Schema，固定事实类型、实体（Employment / Organization）、来源域（hr / organization）与 `juhai.hr`。另加生产侧交叉约束：
- 载荷里的实体 ID 必须等于 `entity_id`；
- 组织事实的 `valid_from` 必须等于 `effective_at`；
- `change_kind` 与 `state_after` 必须一致。
- V-04：Intent 记录的 `sourceDomain` 放宽为 `hr` / `organization`，具体取值仍由注册表里的信封 Schema 收紧。
- **刻意不做**：出站注册表、`facts.owns`、生效事务写 Intent。原因是 `check:app-manifest` M6 只认 pinned `@juhai/contracts` 的 Catalog，而含 CHG-061 的版本尚未发布（Registry 最新是 rc.7，Catalog 只有 11 条）。为此起草了给 04 的发版请求：`docs/domain/request-draft-04-contracts-release-chg061-2026-10-28.md`，未转交。
- **另受阻断**：`OrganizationUnitMoved` 受 Catalog Q5 阻断。`unit_type` 是必填项，但 HR 组织没有类型字段，词表要等 02 定。
- **文档**：蓝图 §4.15 与 H5 / P1 行、CLAUDE.md G23、CHG 草案的实现进度。
## 验证（本地，报告绑定 `7faad2a`、clean）
- contracts 223/223（enterprise-fact 共 20 例，其中新增 8 例）。
- 4 个变异探针各使 1 例判红：分别去掉实体 ID 一致、状态一致、`valid_from` 一致三条约束，以及回退 V-04。
- `check:d3` 通过；去掉 PKG-004 后判红（6 项）。
- `check:app-manifest` 14/14，`check:contract-consumers`、`check:validation`、`check:naming`、lint、typecheck 通过。
- `check:runtime` 470/470、`check:ui` 46/46，用一次性 PostgreSQL / Redis，跑完已删。
- 静态链如实停在 O22（OS main 尚无 0.19.6），`check:governance` 只剩 O22。
- 远端 CI 见本页。
🤖 Generated with [Claude Code](https://claude.com/claude-code)...
|
1
|
0
|
Edit
Delete
|
|
43
|
5
|
861
|
0
|
1793191535
|
> **叠在 #13 之上，请先合 #13。** 本分支已合入更新后的 #13（#13 已含 > **叠在 #13 之上，请先合 #13。** 本分支已合入更新后的 #13（#13 已含 main 上的 #16）。#13 合入后，这里的差异只剩 P1 前置片与报告回绑。
## 为什么重建（2026-10-28）
PR #16 已在 main 上以 PKG-004 落地 V-04（来源域按事实类型；注册表条目的 `source_domain` 须为字面量）。本 PR 原先也用 PKG-004 实现了另一版 V-04，与 #16 冲突。重建时：
- contracts 与台账取 main 版本；
- 去掉本分支自己的 `sourceDomain` 放宽；
- 改按 #16 的注册表类型重做，台账改为 **PKG-005**，蓝图记为 **§4.16**。
## 内容（对接蓝图 §4.16，P1 / H5）
- **contracts**（`packages/contracts/src/enterprise-fact.ts`，台账 PKG-005）
- 新增 `organizationCanonicalIdSchema`（`org_`）。
- 新增 `EmploymentStarted`、`EmploymentTerminated`、`OrganizationUnitStatusChanged` v1 的载荷 Schema，逐字段对应 04 `contracts/schemas/facts/*.v1.json`（CHG-061）。组织状态载荷另要求 `change_kind` 与 `state_after` 一致。
- 三份信封 Schema 保持 ZodObject，`source_domain` 为字面量（hr / organization），满足 #16 的注册表类型（typecheck 已证明），升 pin 后可以直接登记。
- `buildEnterpriseFactEnvelope` 在注册表 Schema 解析之后统一校验两条：载荷里的实体 ID 等于 `entity_id`；组织事实的 `valid_from` 等于 `effective_at`。校验失败抛 ZodError，Relay 记为 `FACT_SCHEMA_INVALID` 并进死信。这条同样约束已登记的 `EmploymentTransferred`；HR 写入时两者本来就相同。
- **刻意不做**：出站注册表、`facts.owns`、生效事务写 Intent。原因是 M6 只认 pinned `@juhai/contracts` 的 Catalog，而 Registry 上最新的 rc.7 只有 11 条事实。发版已交给单独的 04 会话推进，真实发布前须用户同意；HR 侧的请求草稿是 `docs/domain/request-draft-04-contracts-release-chg061-2026-10-28.md`。
- **F1 `OrganizationUnitMoved`**：组织类型词表已由 02 D73 定为 CHG-061 三值（`organization` / `department` / `team`）。HR 加这个字段要改 D3 冻结的宿主 Prisma 和产品迁移，已登记为待裁决 D-13（用户已同意开受控通道并实现，另起 PR）。
- **文档**：蓝图 §4.16、H5 / P1 行，矩阵 #19 按 02 D72 订正（Site / Space / SiteOperator 的现用写点改为 EES 物包），新增 D-13；同步更新 CLAUDE.md G23、CHG 草案和发版请求草稿。
## 验证（本地，报告绑定 `b8f85d3`、clean）
- contracts 227/227（enterprise-fact 24 例，其中新增 8 例）。
- 5 个变异探针各判红：去掉实体 ID 一致、去掉状态一致、去掉 `valid_from` 一致、封装不调用一致性校验、组织事实来源域改为 hr。
- `check:d3` 通过；去掉 PKG-005 后判红（6 项）。
- `check:app-manifest`、`check:contract-consumers`、`check:validation`、lint、typecheck 均通过。
- `check:runtime` 474/474、`check:ui` 46/46，用一次性 PostgreSQL / Redis 跑完已删。静态检查链如实停在 O22，`check:governance` 只剩 O22。
- 远端 CI 结果见本页。
🤖 Generated with [Claude Code](https://claude.com/claude-code)...
|
0
|
0
|
Edit
Delete
|