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
@@ -57,7 +57,7 @@ coord-cross-review.md §8.2 声称批次 0 已完成 proto 补全，ai11 逐文
|
||||
- **类型**：前置依赖缺失
|
||||
- **描述**：coord-cross-review.md §2.2 #3 已仲裁"iam P4 补全 `GetEffectiveDataScope` RPC，data-ana gRPC 调用"，但 iam.proto 当前仅 4 RPC，无此 RPC。data-ana 的 DataScope 6 级过滤（SELF/CLASS/GRADE/SCHOOL/DISTRICT/ALL）依赖此 RPC 解析用户可见数据范围，是 P4 实现的硬阻塞项。
|
||||
- **建议方案**：coord 确认 iam.proto 补全进度。若 iam 侧尚未实现，data-ana P4 阶段将使用硬编码 DataScope 降级（按 role 映射默认 scope），并标注 `details.degraded: true`，待 iam 就绪后切换。
|
||||
- **状态**：待 coord 仲裁（核查已有仲裁 §0.2 #1 未落实）
|
||||
- **状态**：已裁决（见 coord.md §11）
|
||||
|
||||
---
|
||||
|
||||
@@ -68,7 +68,7 @@ coord-cross-review.md §8.2 声称批次 0 已完成 proto 补全，ai11 逐文
|
||||
- **类型**：前置依赖缺失
|
||||
- **描述**：coord-cross-review.md §3.2 已仲裁"补登 `edu.insight.ai.usage` topic + events.proto 补 `AIUsageEvent` message"，但 events.proto 当前仅 4 message（ClassEvent/ExamEvent/HomeworkEvent/GradeEvent），缺 AIUsageEvent。data-ana 需消费此事件落 `ai_usage_log` 宽表，供管理员仪表盘展示 AI 用量统计。
|
||||
- **建议方案**：coord 在 events.proto 补 `AIUsageEvent` message，字段建议：`{event_id, request_id, user_id, provider, model, prompt_tokens, completion_tokens, total_tokens, latency_ms, success, cost_cents, occurred_at}`。P5 前补全即可，P4 仪表盘 AI 用量区块显示"暂无数据"。
|
||||
- **状态**：待 coord 仲裁（核查已有仲裁 §0.2 #3 未落实）
|
||||
- **状态**：已裁决（见 coord.md §11）
|
||||
|
||||
---
|
||||
|
||||
@@ -79,7 +79,7 @@ coord-cross-review.md §8.2 声称批次 0 已完成 proto 补全，ai11 逐文
|
||||
- **类型**：前置依赖缺失 + 声明与实际不符
|
||||
- **描述**：coord-cross-review.md §8.2 声称"analytics.proto 扩展 ✅ 12 RPC（含 Stream）"，但实际文件仅 3 RPC（GetClassPerformance/GetStudentWeakness/GetLearningTrend）。ai-allocation.md §5 与 matrix.md §2 均要求 data-ana 提供 12 RPC，02-architecture-design.md §4.2 已设计完整 12 RPC 清单（含 4 端 Dashboard + Warning + Mastery + Server Streaming），但 proto 未补全导致无法生成 stub。
|
||||
- **建议方案**：coord 确认 analytics.proto 扩展进度。ai11 可提供 12 RPC 的完整 message 定义提案（见 [02-architecture-design.md §4.2](../../../services/data-ana/docs/02-architecture-design.md)），coord 审议后合并到 analytics.proto。若 coord 未补全，ai11 在 P4 阶段自行补全 proto（本分支内），提请 coord 合并。
|
||||
- **状态**：待 coord 仲裁
|
||||
- **状态**：已裁决（见 coord.md §11）
|
||||
|
||||
---
|
||||
|
||||
@@ -97,7 +97,7 @@ coord-cross-review.md §8.2 声称批次 0 已完成 proto 补全，ai11 逐文
|
||||
这导致 01-understanding.md 和 02-architecture-design.md 中引用 004 §4.2/§11.4/§11.5/§15.3 等章节均断裂（004 正文仅到 §14，§15 在 004-p6-addendum.md 但内容不同）。ai11 已在 v2.1 修订中临时改为引用 coord-cross-review.md 对应裁决章节，但这是过渡方案。
|
||||
|
||||
- **建议方案**：coord 按整改清单 #7/#8/#9/#10 补全 004 对应章节，使 004 成为可信的架构设计意图唯一源。各 AI 文档随后将引用从 coord-cross-review.md 回切到 004 对应章节。
|
||||
- **状态**：待 coord 仲裁
|
||||
- **状态**：已裁决（见 coord.md §11）
|
||||
|
||||
---
|
||||
|
||||
@@ -117,7 +117,7 @@ coord-cross-review.md §8.2 声称批次 0 已完成 proto 补全，ai11 逐文
|
||||
按 004 §7.2 命名规范 `edu.<domain>.<aggregate>.<action>`，data-ana 属于 D6 智能洞察领域（domain=insight），故 `edu.insight.mastery.updated` 符合规范。matrix.md 的 `edu.analytics.mastery` 不符合命名规范（缺 action 层级，且 domain 用了服务名而非领域名）。
|
||||
|
||||
- **建议方案**：coord 裁决统一为 `edu.insight.mastery.updated` + `edu.insight.warning.triggered`，coord 修正 matrix.md §4。ai11 已在 contract.md 中采用此命名。
|
||||
- **状态**：待 coord 仲裁
|
||||
- **状态**：已裁决（见 coord.md §11）
|
||||
|
||||
---
|
||||
|
||||
@@ -128,4 +128,4 @@ coord-cross-review.md §8.2 声称批次 0 已完成 proto 补全，ai11 逐文
|
||||
- **类型**：其他（声明与实际不符）
|
||||
- **描述**：coord-cross-review.md §8.2 声称批次 0 已完成 iam.proto（12 RPC）/ analytics.proto（12 RPC）/ events.proto（9 message）补全，但 ai11 逐文件核查发现实际均未补全（详见 §0.3 核查表）。这影响所有依赖这些 proto 的下游 AI 的排期评估——若 AI 信任 §8.2 声明，会在排期中忽略 proto 补全的等待时间，导致排期失真。
|
||||
- **建议方案**：coord 核实 §8.2 声明真实性。若实际已补全但未合并到各 worktree 分支，请协调合并；若实际未补全，请更新 §8.2 状态为"计划中"或"待执行"，并明确补全时间点，以便下游 AI 据此排期。
|
||||
- **状态**：待 coord 仲裁
|
||||
- **状态**：已裁决（见 coord.md §11）
|
||||
|
||||
Reference in New Issue
Block a user