docs(docs): 更新 issue 仲裁状态 + 生成集成测试阶段规划
- 14 个 issue.md 状态字段更新为"已裁决" - 对应 coord.md ARB-001~022 章节 - 共 104 处状态字段更新 - 新增 integration-test-phase.md - 集成测试与部署验证阶段(P7)规划 - 6 个批次任务分解 - 8 条核心 E2E 链路定义 - 验收标准和退出标准 Coord-AI
This commit is contained in:
@@ -37,7 +37,7 @@
|
||||
- U4(BFF 豁免 @RequirePermission):01 §6 表格"权限装饰器"行标"⚠️ 不对齐",未引用 U4 仲裁
|
||||
- C1(错误码前缀 BFF_PARENT_):01 §3.3 仍用 `PARENT_BFF_` 旧前缀
|
||||
- **建议方案**:01-understanding.md 头部更新为 ai05 复审版,同步 U3/U4/C1 仲裁结论;或由 coord 确认 01 作为"阶段 1 历史快照"保留原样,以 02 为准
|
||||
- **状态**:待 coord 仲裁
|
||||
- **状态**:已裁决(见 coord.md §20)
|
||||
|
||||
### ISSUE-002-ai05:02 文档内部 ChildGuard 缓存 TTL 不一致
|
||||
|
||||
@@ -50,7 +50,7 @@
|
||||
- §13 #7 黄金模板对齐表:写 "30s"
|
||||
§3.1.1 表格未同步 §9 的调整,导致同一文档内 60s 与 30s 并存。
|
||||
- **建议方案**:§3.1.1 表格 ChildGuard 行 TTL 改为 "30s",与 §9 #2 + §13 #7 一致
|
||||
- **状态**:待 coord 仲裁(ai05 建议直接修正,属于文档勘误)
|
||||
- **状态**:已裁决(见 coord.md §20)
|
||||
|
||||
### ISSUE-003-ai05:contract.md 仲裁引用编号错误(I3 → I6)
|
||||
|
||||
@@ -62,7 +62,7 @@
|
||||
- I6 才是 "家长-学生关联:P2 即补全 iam_student_guardians 表 + GetChildrenByParent RPC" 裁决
|
||||
- 全仓库未检索到 "ISSUE-047" 编号(grep 无结果),疑为虚构编号
|
||||
- **建议方案**:contract.md 将 "I3/ISSUE-047 裁决" 修正为 "I6 裁决(coord-final-decisions.md §1)"
|
||||
- **状态**:待 coord 仲裁(ai05 建议直接修正,属于引用勘误)
|
||||
- **状态**:已裁决(见 coord.md §20)
|
||||
|
||||
### ISSUE-004-ai05:004 §4 服务依赖图与 matrix.md §1 未同步 C6 仲裁
|
||||
|
||||
@@ -75,7 +75,7 @@
|
||||
- 02 §0.1 C6 行已标注 "004 §4 待 coord 同步更新",但至今未同步
|
||||
此差异导致新接手的 AI 看 004/matrix 会误以为 parent-bff 不依赖 data-ana/msg,与 02 设计冲突。
|
||||
- **建议方案**:coord 在 004 §4 服务依赖图补 `PBFF --> DataAna` + `PBFF --> Msg`,matrix.md §1 同步;更新 004 时按 project_rules §1 "改码必同步图" 执行
|
||||
- **状态**:待 coord 仲裁
|
||||
- **状态**:已裁决(见 coord.md §20)
|
||||
|
||||
### ISSUE-005-ai05:parent-portal 01 文档与 parent-bff GraphQL 决策跨模块冲突
|
||||
|
||||
@@ -89,7 +89,7 @@
|
||||
- parent-portal §3.1 标 "BFF 对接:parent-bff(ai04 设计)",ai04 已过时(现 ai05)
|
||||
此冲突若不解决,parent-portal(ai15)会按 REST 实现 frontend client,与 parent-bff GraphQL 端点不兼容。
|
||||
- **建议方案**:coord 协调 ai15 将 parent-portal 01/02 文档的 parent-bff 消费契约从 REST 改为 GraphQL(`POST /api/v1/parent/graphql`),同步 C4 iam 路径仲裁;此属跨模块契约,按 project_rules §14.4 跨模块变更顺序处理
|
||||
- **状态**:待 coord 仲裁
|
||||
- **状态**:已裁决(见 coord.md §20)
|
||||
|
||||
### ISSUE-006-ai05:proto 包名引用不一致(缺失 next_edu_cloud 前缀)
|
||||
|
||||
@@ -103,7 +103,7 @@
|
||||
- msg.proto: `package next_edu_cloud.msg.v1;`
|
||||
引用不一致会导致 gRPC client 代码生成时 package 路径错误。
|
||||
- **建议方案**:02 §3.3 DTO 映射表 proto message 列全部补 `next_edu_cloud.` 前缀;或确认是否统一去掉前缀(需 buf.yaml 配置一致)
|
||||
- **状态**:待 coord 仲裁
|
||||
- **状态**:已裁决(见 coord.md §20)
|
||||
|
||||
### ISSUE-007-ai05:GraphQL Notification.childId 字段在 msg.proto 缺失
|
||||
|
||||
@@ -125,7 +125,7 @@
|
||||
```
|
||||
parent-bff 无法从 msg 服务获取通知关联的孩子 ID,影响"按孩子过滤通知"场景。
|
||||
- **建议方案**:coord 协调 ai10 在 msg.proto Notification message 补 `string child_id = 9;` 字段(可选,非家长通知为空);或 parent-bff 从 notification.content 解析(脆弱,不推荐)
|
||||
- **状态**:待 coord 仲裁
|
||||
- **状态**:已裁决(见 coord.md §20)
|
||||
|
||||
### ISSUE-008-ai05:core_edu.proto 缺 ClassService,02 §7.1 列为已有
|
||||
|
||||
@@ -138,7 +138,7 @@
|
||||
1. coord 确认 ClassService 归属(core-edu 还是 classes 服务),补 proto
|
||||
2. 02 §7.1 ClassService.GetClass 状态从 "✅ 已有" 改为 "❌ 待补"
|
||||
3. 02 §3.3 补 Grade.score string→Float 转换规则说明
|
||||
- **状态**:待 coord 仲裁
|
||||
- **状态**:已裁决(见 coord.md §20)
|
||||
|
||||
### ISSUE-009-ai05:ai-allocation iam 责任方与 01/02 文档不一致
|
||||
|
||||
@@ -147,7 +147,7 @@
|
||||
- **类型**:责任方引用过时
|
||||
- **描述**:01-understanding.md §7.1/§7.3 多处提"推动 ai02 在 iam 补接口",02 §8.1 P0 阻塞项 + §14.1 P0-1 也标 iam 责任方为 "ai06(iam 现归属)" 但 §7.3 #1 仍标 ai02。实际 ai-allocation.md §3.2 确认 iam 归属 ai06。01 文档未同步。
|
||||
- **建议方案**:01 §7.1/§7.3 将 "ai02" 改为 "ai06";02 §7.3 #1 同步
|
||||
- **状态**:待 coord 仲裁(ai05 建议直接修正,属于引用勘误)
|
||||
- **状态**:已裁决(见 coord.md §20)
|
||||
|
||||
### ISSUE-010-ai05:02 缺少 ADR / NFR / 容量规划 / 威胁建模(业界规范差距)
|
||||
|
||||
@@ -161,7 +161,7 @@
|
||||
4. **安全威胁建模缺失**:§6.2 列错误码但未做威胁建模(STRIDE)。家长场景涉及未成年人数据(COPPA/FERPA/PIPL),应补威胁模型。
|
||||
5. **数据流图(DFD)缺失**:§1.2 只有 Dashboard 时序图,缺少 DFD 展示数据跨信任边界流动。
|
||||
- **建议方案**:coord 确认是否在 02 补全上述章节,或作为 P6 硬化阶段补全;当前不阻塞 P4 实施
|
||||
- **状态**:待 coord 仲裁
|
||||
- **状态**:已裁决(见 coord.md §20)
|
||||
|
||||
---
|
||||
|
||||
@@ -175,5 +175,5 @@
|
||||
- **类型**:契约不明确 / 工作量超批 / 前置依赖缺失 / 编号冲突 / 其他
|
||||
- **描述**:[详细描述问题]
|
||||
- **建议方案**:[AI 的建议]
|
||||
- **状态**:待 coord 仲裁 / 已裁决(见 coord.md §X)
|
||||
- **状态**:已裁决(见 coord.md §X)
|
||||
-->
|
||||
|
||||
Reference in New Issue
Block a user