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
@@ -62,7 +62,7 @@
|
||||
- **类型**：契约不明确 / 工作量超批 / 前置依赖缺失 / 编号冲突 / 其他
|
||||
- **描述**：[详细描述问题]
|
||||
- **建议方案**：[AI 的建议]
|
||||
- **状态**：待 coord 仲裁 / 已裁决（见 coord.md §X）
|
||||
- **状态**：已裁决（见 coord.md §X）
|
||||
-->
|
||||
|
||||
### ISSUE-001-ai01：matrix.md gRPC 矩阵错误声明 api-gateway 消费 iam gRPC
|
||||
@@ -74,7 +74,7 @@
|
||||
- **建议方案**：
|
||||
1. matrix.md §2 iam 行"消费方"列移除 `api-gateway`
|
||||
2. matrix.md §7 Mock 策略表中 api-gateway 行改为"硬编码 RS256 公钥（DEV_MODE）→ HTTP JWKS 端点"
|
||||
- **状态**：待 coord 仲裁
|
||||
- **状态**：已裁决（见 coord.md §24.3）
|
||||
|
||||
### ISSUE-002-ai01：shared-go 接入方式与时机
|
||||
|
||||
@@ -87,7 +87,7 @@
|
||||
2. go.work 增加 `./packages/shared-go`
|
||||
3. ai01 go.mod 增加 `github.com/edu-cloud/shared-go` 依赖
|
||||
4. P2.1 任务接入 jwks/logger/tracer/env
|
||||
- **状态**：待 coord 仲裁
|
||||
- **状态**：已裁决（见 coord.md §24.5）
|
||||
|
||||
### ISSUE-003-ai01：API 版本化路由方案（/v1 前缀位置）
|
||||
|
||||
@@ -99,7 +99,7 @@
|
||||
- 方案 B：Gateway 路由 `/api/v1/iam/*path`，proxy 透传 `/iam/*path`，下游 Controller 内加 `/v1`（前端调用 `/api/v1/iam/v1/auth/login`，Gateway 不含 `/v1`）
|
||||
- 方案 C：其他
|
||||
- **建议方案**：采纳方案 B（Gateway 路由不含服务级 `/v1`，由下游 Controller 添加），符合裁决第 4 条"避免双 v1"和第 3 条"Gateway 不改路径直接透传"
|
||||
- **状态**：待 coord 仲裁
|
||||
- **状态**：已裁决（见 coord.md §24.4）
|
||||
|
||||
### ISSUE-004-ai01：zap vs slog 选型
|
||||
|
||||
@@ -108,7 +108,7 @@
|
||||
- **类型**：契约不明确
|
||||
- **描述**：W3 裁决"首次实现即用 slog"，但 [shared-go/logger](../../../packages/shared-go/logger/logger.go) 的实现选型（zap 还是 slog）影响 ai01 接入方式。若 shared-go 用 zap，ai01 需通过 shared-go/logger 间接使用 zap；若 shared-go 用 slog，ai01 可直接用标准库 `log/slog` 或 shared-go 封装。需 coord 仲裁 shared-go/logger 最终选型。
|
||||
- **建议方案**：shared-go/logger 基于 `log/slog` 封装（标准库零依赖，W3 裁决原文即 slog），ai01 直接 import shared-go/logger
|
||||
- **状态**：待 coord 仲裁
|
||||
- **状态**：已裁决（见 coord.md §24.6）
|
||||
|
||||
### ISSUE-005-ai01：go.mod 与 Dockerfile Go 版本不一致
|
||||
|
||||
@@ -117,7 +117,7 @@
|
||||
- **类型**：其他
|
||||
- **描述**：[go.mod](../../../services/api-gateway/go.mod) L3 声明 `go 1.25.0`，[go.work](../../../go.work) L1 声明 `go 1.26.0`，但 [Dockerfile](../../../services/api-gateway/Dockerfile) L1 用 `golang:1.22-alpine`。三者不一致，可能导致构建环境与本地开发环境行为差异。
|
||||
- **建议方案**：统一为 `go 1.22`（与 Dockerfile 一致，与 [01-understanding.md](../../../services/api-gateway/docs/01-understanding.md) §4 声明一致），或升级 Dockerfile 到 `golang:1.25-alpine` 并同步 go.mod/go.work
|
||||
- **状态**：待 coord 仲裁
|
||||
- **状态**：已裁决（见 coord.md §24.7）
|
||||
|
||||
### ISSUE-007-ai01：01-understanding.md §6 审计表 metrics 行过时
|
||||
|
||||
@@ -126,7 +126,7 @@
|
||||
- **类型**：其他
|
||||
- **描述**：[01-understanding.md](../../../services/api-gateway/docs/01-understanding.md) §6 审计表 metrics 行标注 `❌ 无`，§7.1 issue #1 也说"无 `/metrics` 端点，Prometheus 404"。但实际 [main.go](../../../services/api-gateway/main.go) L56 已注册 `r.GET("/metrics", gin.WrapH(promhttp.Handler()))`，`/metrics` 端点已存在。文档过时，需更新为"⚠️ 端点已注册，但缺 7 个业务指标"。
|
||||
- **建议方案**：更新 01-understanding.md §6 审计表 metrics 行为 `⚠️ 端点已注册，缺业务指标`；§7.1 issue #1 更新为"已注册 /metrics，需补 7 个业务指标"
|
||||
- **状态**：待 coord 仲裁
|
||||
- **状态**：已裁决（见 coord.md §24.8）
|
||||
|
||||
### ISSUE-008-ai01：01-understanding.md §7.1 issue #3 死代码引用过时
|
||||
|
||||
@@ -135,7 +135,7 @@
|
||||
- **类型**：其他
|
||||
- **描述**：[01-understanding.md](../../../services/api-gateway/docs/01-understanding.md) §7.1 issue #3 引用"auth.go L124-139 死代码 `RequestIDMiddleware()` + `generateUUID()`"，但实际 [auth.go](../../../services/api-gateway/internal/middleware/auth.go) 当前仅 121 行，L124-139 不存在，死代码已删除。文档引用过时。
|
||||
- **建议方案**：删除 01-understanding.md §7.1 issue #3 整行（死代码已修复）
|
||||
- **状态**：待 coord 仲裁
|
||||
- **状态**：已裁决（见 coord.md §24.9）
|
||||
|
||||
### ISSUE-009-ai01：W1/W2 错误码 GW_ 前缀 + ActionState 信封未遵循
|
||||
|
||||
@@ -148,7 +148,7 @@
|
||||
- [circuit-breaker.go](../../../services/api-gateway/internal/middleware/circuit-breaker.go) L55-58 响应 `{"error":"circuit_open","retry_after":30}`（无 GW_ 前缀，无信封）
|
||||
- [recovery.go](../../../services/api-gateway/internal/middleware/recovery.go) L24-27 响应 `{"error":"internal_error","request_id":"..."}`（无 GW_ 前缀，无信封）
|
||||
- **建议方案**：P2.3 任务统一修复（见 [workline.md](../worklines/api-gateway_workline.md) P2.3），所有错误码改为 `GW_*`，所有响应体改为 `{success:false,error:{code:"GW_*",message:"..."},...}`
|
||||
- **状态**：待 coord 仲裁
|
||||
- **状态**：已裁决（见 coord.md §24.10）
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user