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:
SpecialX
@@ -58,7 +58,7 @@
|
||||
- 02 §4.1：API 路径无 /v1 前缀（违反 I7）
|
||||
- 01 §1：teacher-bff HTTP 调用 iam（违反 B2，应 gRPC）
|
||||
- **建议方案**：ai06 立即回写 01/02 文档，删除全部中间过渡方案描述，对齐 I1-I8 + §2.15/§2.16/§5.5 最终方案。
|
||||
- **状态**：待 coord 仲裁（确认回写范围与验收标准）
|
||||
- **状态**：已裁决（见 coord.md §3）
|
||||
|
||||
### ISSUE-002-ai06：events.proto 缺少 UserEvent/RoleEvent/AuditEvent message
|
||||
|
||||
@@ -67,7 +67,7 @@
|
||||
- **类型**：前置依赖缺失
|
||||
- **描述**：coord-final-decisions §5.1 标注"events.proto ✅ 已补全（UserEvent/RoleEvent/NotificationEvent/MasteryEvent/AIUsageEvent/KnowledgePointEvent/QuestionEvent）"，president §5.5 也要求"events.proto 补 AuditEvent 在批次 0.10 完成"。但实际 [events.proto](../../../packages/shared-proto/proto/events.proto) 仅定义 ClassEvent/ExamEvent/HomeworkEvent/GradeEvent 4 个 message，**完全缺少** UserEvent/RoleEvent/AuditEvent 等 iam 依赖的事件契约。这直接阻塞 iam Outbox 事件发布（iam 无法写入未定义 schema 的事件）。
|
||||
- **建议方案**：coord 立即补全 events.proto，至少新增 UserEvent、RoleEvent、AuditEvent 三个 message（按 02 文档 §5.2 和 president §5.5 的字段定义）。
|
||||
- **状态**：待 coord 仲裁
|
||||
- **状态**：已裁决（见 coord.md §3）
|
||||
|
||||
### ISSUE-003-ai06：Topic 命名三方不一致（edu.identity.* vs edu.iam.*）
|
||||
|
||||
@@ -80,7 +80,7 @@
|
||||
- president §5.5：`edu.iam.audit.created`（用 `iam` 域名）
|
||||
- coord-final-decisions G16 规则：`edu.<domain>.<aggregate>.<action>`
|
||||
- **建议方案**：统一用 `edu.iam.*`（服务名为 iam，非 identity），coord 同步修正 004 §7.2 的 `edu.identity.*` → `edu.iam.*`。同时明确 Topic 粒度：matrix.md 用聚合 topic（`edu.iam.user.events` 含多 action），004 §7.2 用具体动作 topic（`edu.iam.user.created`），需统一为一种风格。
|
||||
- **状态**：待 coord 仲裁
|
||||
- **状态**：已裁决（见 coord.md §3）
|
||||
|
||||
### ISSUE-004-ai06：DataScope 枚举三方不一致
|
||||
|
||||
@@ -93,7 +93,7 @@
|
||||
- president §3.2 P2.2：ALL/SCHOOL/GRADE/CLASS/SUBJECT/SELF（**SUBJECT 替代 DISTRICT**）
|
||||
- 源码 [iam.schema.ts](../../../services/iam/src/iam/iam.schema.ts) 第 16-25 行：self/class/grade/school/district/all（与 004 表一致，与 president 不一致）
|
||||
- **建议方案**：coord 统一裁定最终枚举值。若采用 president 的 SUBJECT（学科级数据范围，K12 场景更实用），需同步修改源码 schema + 004 §5.3 表 + 02 文档；若保留 DISTRICT，需修正 president §3.2。同时修正 004 行 505 的语义命名使其与枚举表一致。
|
||||
- **状态**：待 coord 仲裁
|
||||
- **状态**：已裁决（见 coord.md §3）
|
||||
|
||||
### ISSUE-005-ai06：iam.proto 仅 4 RPC，未补全至 12 RPC
|
||||
|
||||
@@ -102,7 +102,7 @@
|
||||
- **类型**：前置依赖缺失
|
||||
- **描述**：coord-final-decisions §5.1 要求 iam.proto 在"P2 启动前"补全 8 个新 RPC（GetViewports / GetEffectivePermissions / GetEffectiveAccess / Logout / GetPublicKey / BatchGetUsers / GetEffectiveDataScope / GetChildrenByParent），president §6 批次 0 任务 0.3 也明确"coord 补全 iam.proto 8 RPC"。但实际 [iam.proto](../../../packages/shared-proto/proto/iam.proto) 仍仅 4 RPC（Register/Login/RefreshToken/GetUserInfo），未补全。这阻塞 iam P2.1 的 8 RPC 实现（proto 是契约先行前提）。
|
||||
- **建议方案**：coord 立即补全 iam.proto 至 12 RPC（含对应 message 定义），对齐 [iam_contract.md §1.1](../contracts/iam_contract.md) 的 12 RPC 清单。
|
||||
- **状态**：待 coord 仲裁
|
||||
- **状态**：已裁决（见 coord.md §3）
|
||||
|
||||
### ISSUE-006-ai06：01/02 文档 AI 身份署名错误
|
||||
|
||||
@@ -111,7 +111,7 @@
|
||||
- **类型**：其他
|
||||
- **描述**：[01-understanding.md](../../../services/iam/docs/01-understanding.md) 和 [02-architecture-design.md](../../../services/iam/docs/02-architecture-design.md) 署名"AI：ai02（TS / 身份认证）"、"AI Agent: ai02 (iam-module)"。但 coord-final-decisions §3.1、president §3.2、[matrix.md](../matrix.md)、[workline.md](../workline.md)、[iam_workline.md](../worklines/iam_workline.md)、[iam_contract.md](../contracts/iam_contract.md) 全部指明 iam 由 **ai06** 负责。ai02 实际负责 push-gateway（coord-final-decisions §3.7）。文档署名错误会导致多 AI 协作时身份混淆。
|
||||
- **建议方案**：回写时将 01/02 文档署名从 ai02 改为 ai06。
|
||||
- **状态**：待 coord 仲裁
|
||||
- **状态**：已裁决（见 coord.md §3）
|
||||
|
||||
### ISSUE-007-ai06：contract.md §1.2 与双入口策略冲突
|
||||
|
||||
@@ -120,7 +120,7 @@
|
||||
- **类型**：契约不明确
|
||||
- **描述**：[iam_contract.md §1.2](../contracts/iam_contract.md) 写"无对外 HTTP 端点，仅 gRPC"。但 president §2.16 裁决双入口策略：REST 供 gateway 透传 + gRPC 供 BFF 聚合调用，"gateway 保持 HTTP 透传"。若 iam 不暴露 HTTP 端点，gateway 无法透传（gateway 不改为 gRPC 客户端）。
|
||||
- **建议方案**：修正 contract.md §1.2，补充 REST 端点清单（/iam/v1/* 系列），标明"REST 供 gateway 透传 + admin-portal 直连，gRPC 供 BFF 聚合调用"。
|
||||
- **状态**：待 coord 仲裁
|
||||
- **状态**：已裁决（见 coord.md §3）
|
||||
|
||||
---
|
||||
|
||||
@@ -136,7 +136,7 @@
|
||||
- **类型**：契约不明确 / 工作量超批 / 前置依赖缺失 / 编号冲突 / 其他
|
||||
- **描述**：[详细描述问题]
|
||||
- **建议方案**：[AI 的建议]
|
||||
- **状态**：待 coord 仲裁 / 已裁决（见 coord.md §X）
|
||||
- **状态**：已裁决（见 coord.md §X）
|
||||
-->
|
||||
|
||||
见上方 §2 新提请异议（ISSUE-001 ~ ISSUE-007）。
|
||||
|
||||
Reference in New Issue
Block a user