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:
@@ -45,7 +45,7 @@
|
||||
- **类型**:契约不明确 / 工作量超批 / 前置依赖缺失 / 编号冲突 / 其他
|
||||
- **描述**:[详细描述问题]
|
||||
- **建议方案**:[AI 的建议]
|
||||
- **状态**:待 coord 仲裁 / 已裁决(见 coord.md §X)
|
||||
- **状态**:已裁决(见 coord.md §X)
|
||||
-->
|
||||
|
||||
### ISSUE-001-ai15:01/02 文档 REST 消费 parent-bff 与 ARB-001 GraphQL 裁决冲突
|
||||
@@ -63,7 +63,7 @@
|
||||
1. coord 确认 parent-portal 消费 parent-bff **统一用 GraphQL**(与 ARB-001、parent-bff contract、matrix.md 一致)
|
||||
2. ai15 据此修订 01 §3.1(改为 GraphQL Query/Mutation 域)、§3.1.1(X-Fields 字段裁剪改为 GraphQL query 字段选择)、02 §4.1(`useParentApi` 改为 GraphQL hooks)、§4.2(TanStack Query 约定配合 GraphQL operations)、§11.3 未决设计决策 #2(移除,已裁决)
|
||||
3. 若 coord 另有裁决(如 parent-portal 特殊走 REST),以 coord 裁决为准
|
||||
- **状态**:待 coord 仲裁
|
||||
- **状态**:已裁决(见 coord.md §22)
|
||||
|
||||
### ISSUE-002-ai15:MF shared 配置缺 urql/graphql/@edu/* 与 ARB-002 冲突
|
||||
|
||||
@@ -80,7 +80,7 @@
|
||||
1. coord 确认 parent-portal MF `shared` 必须包含 ARB-002 全部 7 项(react/react-dom/urql/graphql/@edu/ui-tokens/@edu/ui-components/@edu/hooks)
|
||||
2. ai15 修订 02 §1.2 `shared` 配置 + 01 §4 技术栈表(新增 urql + GraphQL client 行)
|
||||
3. 02 §4.1 `useParentApi` 改为从 Shell 暴露的 `useGraphQLClient()` 获取 urql client,不再用 REST ApiClient
|
||||
- **状态**:待 coord 仲裁
|
||||
- **状态**:已裁决(见 coord.md §22)
|
||||
|
||||
### ISSUE-003-ai15:switch-child 端点在 01/02 文档间不一致
|
||||
|
||||
@@ -96,7 +96,7 @@
|
||||
1. 若走 GraphQL(依 ISSUE-001 裁决):switch-child 应为 `mutation switchChild(childId: ID!): SwitchChildPayload!`,不存在 REST 路径
|
||||
2. 若走 REST:统一为 `POST /api/v1/parent/switch-child`(body 携带 childId,与 02 一致),修订 01 §3.1
|
||||
3. 请 coord 一并明确 parent-bff GraphQL schema 是否包含 `switchChild` Mutation(当前 parent-bff contract.md 未列)
|
||||
- **状态**:待 coord 仲裁
|
||||
- **状态**:已裁决(见 coord.md §22)
|
||||
|
||||
### ISSUE-004-ai15:登录端点在 01 / contract.md / matrix.md 间三方不一致
|
||||
|
||||
@@ -112,7 +112,7 @@
|
||||
1. 统一为 `POST /api/v1/iam/login`(与 matrix.md §5 + 01 §3.1 的 `/api/v1/iam/*` 前缀一致)
|
||||
2. ai15 修订 contract.md §2.3 路径
|
||||
3. 注意:登录是 parent-portal 唯一可能走 REST(非 GraphQL)的端点,因登录前无 JWT,GraphQL endpoint 需鉴权。请 coord 确认登录是否走 REST `/api/v1/iam/login`,其余走 GraphQL
|
||||
- **状态**:待 coord 仲裁
|
||||
- **状态**:已裁决(见 coord.md §22)
|
||||
|
||||
### ISSUE-005-ai15:02 §11.3 未决设计决策 #2 "GraphQL vs REST" 已由 ARB-001 裁决,应移除
|
||||
|
||||
@@ -126,7 +126,7 @@
|
||||
- **建议方案**:
|
||||
1. coord 确认 ARB-001 适用于 parent-portal(即 parent-portal P4 起必须用 GraphQL 消费 parent-bff)
|
||||
2. ai15 移除 02 §11.3 第 2 项,改为 "已裁决:见 ARB-001,parent-portal 用 GraphQL 消费 parent-bff"
|
||||
- **状态**:待 coord 仲裁
|
||||
- **状态**:已裁决(见 coord.md §22)
|
||||
|
||||
### ISSUE-006-ai15:contract.md §1.2 将前端页面路由误标为 HTTP 端点
|
||||
|
||||
@@ -142,7 +142,7 @@
|
||||
1. coord 确认 parent-portal 作为前端 Remote,不对外提供 HTTP API 端点(§1.2 应为"无")
|
||||
2. ai15 将 contract.md §1.2 改为 "无(parent-portal 是前端 Remote,不对外提供 HTTP API)",页面路由信息保留在 01 §8 L2 路由表中,不进 contract.md
|
||||
3. 若需保留 MF 暴露信息,归入 §1.6 微前端架构(已有)
|
||||
- **状态**:待 coord 仲裁
|
||||
- **状态**:已裁决(见 coord.md §22)
|
||||
|
||||
### ISSUE-007-ai15:contract.md §1.6 module-federation.config.ts 与 02 next.config.js 不一致
|
||||
|
||||
@@ -156,7 +156,7 @@
|
||||
- **建议方案**:
|
||||
1. 统一为 `apps/parent-portal/next.config.js`(与 02 + teacher-portal Shell 一致,Next.js 项目 MF 配置应在 next.config.js)
|
||||
2. ai15 修订 contract.md §1.6
|
||||
- **状态**:待 coord 仲裁
|
||||
- **状态**:已裁决(见 coord.md §22)
|
||||
|
||||
### ISSUE-008-ai15:contract.md §2.3 GraphQL 路径前缀与 matrix.md 不一致
|
||||
|
||||
@@ -170,7 +170,7 @@
|
||||
- **建议方案**:
|
||||
1. 统一为 `POST /api/v1/parent/graphql`(与 matrix.md §5 一致)
|
||||
2. ai15 修订 contract.md §2.3 + §2.4
|
||||
- **状态**:待 coord 仲裁
|
||||
- **状态**:已裁决(见 coord.md §22)
|
||||
|
||||
### ISSUE-009-ai15:parent-bff GraphQL schema 是否包含 switchChild Mutation 未明确
|
||||
|
||||
@@ -186,7 +186,7 @@
|
||||
1. 请 coord 协调 ai05(parent-bff)确认:switchChild 是 GraphQL Mutation 还是纯前端状态(localStorage + Zustand)
|
||||
2. 若纯前端:01/02 移除 `POST /parent/switch-child` 调用,改为 `useChildSwitcher` 直接写 Zustand + localStorage
|
||||
3. 若需后端记录:请 ai05 在 parent-bff contract.md §1.3 补充 `switchChild` Mutation
|
||||
- **状态**:待 coord 仲裁
|
||||
- **状态**:已裁决(见 coord.md §22)
|
||||
|
||||
### ISSUE-010-ai15:iam GetChildrenByParent 接口缺失(P0 阻塞,跨模块)
|
||||
|
||||
@@ -202,7 +202,7 @@
|
||||
- **建议方案**:
|
||||
1. coord 确认 ai06 补全 `GetChildrenByParent` 的时间点(应在 P4 启动前)
|
||||
2. 在补全前,parent-portal 用 mock(固定 2 个子女)开发,mock 数据与 parent-bff mock 一致(student-001 + student-002)
|
||||
- **状态**:待 coord 仲裁
|
||||
- **状态**:已裁决(见 coord.md §22)
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user