# 总裁最终裁决（President Final Rulings）

> 版本：1.0
> 日期：2026-07-09
> 决策者：总裁（用户）
> 执行者：coord（统一落实）
> 适用范围：Edu 微服务架构全部 16 个 AI（ai01-ai16）+ coord 维护的 shared-* 包与文档
> 关联文档：
>
> - [coord-final-decisions.md](./coord-final-decisions.md)（80+ 项强制裁决，本文件为其上层总裁裁决）
> - [ai-work-orchestration.md](./ai-work-orchestration.md)（6 批次并行规划，本文件调整其时间线）
> - [issues.md](../issues.md)（70+ 问题汇总，本文件逐个裁决）
> - [004 架构影响地图](./004_architecture_impact_map.md)
> - [port-allocation.md](../../infra/port-allocation.md)
> - [ai-allocation.md](./ai-allocation.md)

---

## 0. 裁决原则

### 0.1 总裁授权范围

本文件是用户作为总裁对全部已汇总问题（ISSUE-001 ~ ISSUE-066，含编号冲突）的**最终裁决**，覆盖：

1. **coord-final-decisions.md** 80+ 项裁决的最终确认（无推翻）
2. **ai-work-orchestration.md** 6 批次时间线的最终调整
3. **issues.md** 70+ 问题的逐个裁决（状态全部转为"总裁已裁决"）
4. 文档同步遗漏的修复指令
5. 编号冲突的整理规则
6. 各 AI 工作内容的最终边界

### 0.2 裁决优先级

裁决按以下优先级分组，AI 执行时按优先级处理：

- **P0 立即执行**：文档同步遗漏修复 + 编号冲突整理
- **P1 批次 0 启动前完成**：设计契约明确 + 工具包产出
- **P2 各批次启动前完成**：文档回写 + 工作量分级
- **P3 各阶段执行中持续**：跨阶段扩展例外执行

### 0.3 "不分阶段"与"批次"的最终澄清

针对 ISSUE-021（ai08）/ ISSUE-015 §0.1（ai15）表述歧义问题，总裁最终澄清：

| 概念               | 适用层级               | 含义                                                                                           | 禁止事项                                                         |
| ------------------ | ---------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| **不分阶段**       | 代码实现层面           | 服务首次落地即采用最终方案，禁止"前期简化版后期重构"                                           | 禁止 P2 写 REST 后期切 GraphQL；禁止 P2 mock 数据后期接真实 gRPC |
| **批次**           | 工作排序层面           | 因服务依赖需串行启动（下游未就绪时上游无法启动）                                               | 批次时间线允许调整，但不得作为"先简化后重构"的借口               |
| **跨阶段扩展例外** | 唯一允许的"分阶段"场景 | BFF /readyz 探针列表 / Dashboard Resolver 字段填充 / AuthorizationGuard 内部实现允许按阶段扩展 | 见 §2.3 详细验收标准                                             |

**核心规则**：批次规划保证下游就绪后再启动上游；不分阶段保证每个服务首次实现即最终方案。两者不冲突。

### 0.4 编号冲突整理规则（ISSUE-031/035 处理）

针对 issues.md 严重的编号冲突（ISSUE-024/025 ai11 与 ai09 重复 / ISSUE-028~~030 ai04 与 ai11 重复 / ISSUE-031 ai04 与 ai15 重复 / ISSUE-032~~035 ai03 与 ai15 重复 / ISSUE-036 ai03 与 ai13 重复 / ISSUE-044~048 ai16 与 ai06 重复），总裁裁决：

1. **保留所有 issues 原始内容不删除**（避免信息丢失）
2. **不再重新编号**（重编号工作量大，且 AI 已在文档中引用现有编号）
3. **在本文件 §10 问题索引表中统一映射**，每个 issue 用 `ISSUE-XXX-<提请AI>` 格式唯一定位（如 ISSUE-024-ai11 / ISSUE-024-ai09）
4. **coord 在 issues.md §0.5 添加索引指针**指向本文件，AI 查询时先看本文件索引表

---

## 1. P0 立即修复：文档同步遗漏

### 1.1 port-allocation.md §5 iam 行修正（ISSUE-001/015）

**裁决**：修正 port-allocation.md §5（行 77 附近）iam 行：

- 修改前：`IamService（P3 启用） | P3`
- 修改后：`IamService（P2 启用，I1 裁决） | P2`

**理由**：对齐 coord-final-decisions.md I1 裁决（iam P2 即启用 gRPC server 50052）+ port-allocation.md §3 已修正的内容。

**执行者**：coord
**完成期限**：本裁决发布后立即

### 1.2 004 §4.2 gRPC 启用矩阵修正（ISSUE-003）

**裁决**：修正 004 §4.2 gRPC 启用阶段矩阵，iam 行从"P3 启用"改为"P2 启用"。

**理由**：对齐 I1 裁决。

**执行者**：coord
**完成期限**：本裁决发布后立即

### 1.3 004 §16.7.4 P4 清单补 QuestionService（ISSUE-016）

**裁决**：004 §16.7.4 P4 启动前整改清单补充 content QuestionService：

- 修改前：仅列"ChapterService / TextbookService.ListTextbooks"
- 修改后：补充"+ QuestionService（N3 裁决，P4 即补全，不等到 P5）"

**理由**：对齐 coord-final-decisions.md N3 裁决（QuestionService proto P4 即补全）。

**执行者**：coord
**完成期限**：本裁决发布后立即

### 1.4 004 §16.7.5 P5 清单删 QuestionService（ISSUE-016）

**裁决**：004 §16.7.5 P5 启动前整改清单删除"ai09 content 补 QuestionService RPC（阻塞 ai 出题）"项。

**理由**：QuestionService 已在 P4 补全，P5 不再重复。

**执行者**：coord
**完成期限**：本裁决发布后立即

### 1.5 004 §7.2 Kafka topic 表格修订（ISSUE-043/053）

**裁决**：修订 004 §7.2 Kafka topic 路由表：

- 删除：`| edu.notification.events | 通知事件 | Msg | push-gateway |`
- 新增 3 行：

```
| edu.notification.sent     | 通知发送 | Msg | push-gateway、DataAna |
| edu.notification.read     | 通知已读 | Msg | DataAna              |
| edu.notification.recalled | 通知撤回 | Msg | DataAna              |
| edu.notification.requested | 通知投递请求 | Msg | push-gateway       |
```

- 在表格下方追加注释："本表已对齐 §16.3.2 + G16 裁决，禁止抽象名 `edu.*.events`"

**理由**：对齐 G16 裁决（topic 命名统一 `edu.<domain>.<aggregate>.<action>`，禁止抽象名）+ ai10 msg 02 §5 已设计的具体动作名 + ai02 push-gateway 消费 `edu.notification.requested`（ISSUE-053）。

**执行者**：coord
**完成期限**：本裁决发布后立即

### 1.6 coord-final-decisions.md + ai-work-orchestration.md 相对路径修正（ISSUE-031-ai15）

**裁决**：修正两份文档 L7 关联文档引用：

- `coord-final-decisions.md` L7：`[ai-allocation.md](./architecture/ai-allocation.md)` → `[ai-allocation.md](./ai-allocation.md)`
- `ai-work-orchestration.md` L7：`[ai-allocation.md](./architecture/ai-allocation.md)` → `[ai-allocation.md](./ai-allocation.md)`

**理由**：两份文档自身位于 `docs/architecture/` 目录下，引用 `./architecture/ai-allocation.md` 会多一层路径。

**执行者**：coord
**完成期限**：本裁决发布后立即

### 1.7 issues.md §0.5 添加总裁裁决索引指针

**裁决**：在 issues.md §0.4 之后新增 §0.5：

```markdown
### 0.5 总裁最终裁决索引

> 所有 ISSUE-001 ~ ISSUE-066 的"coord 裁决"字段已由总裁最终裁决覆盖。
> 查询裁决结果请先查阅 [president-final-rulings.md](./architecture/president-final-rulings.md)。
> 本文件保留所有 issues 原始内容作为问题追溯，编号冲突通过 `ISSUE-XXX-<提请AI>` 格式唯一定位（见 president-final-rulings.md §10）。
```

**执行者**：coord
**完成期限**：本裁决发布后立即

---

## 2. P1 批次 0 启动前完成：设计契约明确

### 2.1 shared-ts Outbox 工具包设计（ISSUE-018/050）

**裁决**：coord 在批次 0.4 完成 `packages/shared-ts/src/outbox/` 设计草案，包含：

1. **包名**：`@edu/shared-ts/outbox`
2. **导出 API**：

```typescript
// 1. OutboxModule（NestJS Module 注入）
export class OutboxModule {
  static forRoot(config: OutboxConfig): DynamicModule;
}

// 2. OutboxService（发布接口）
export class OutboxService {
  publish(
    eventType: string,
    payload: unknown,
    options?: PublishOptions,
  ): Promise<string>;
  // 返回 outbox record id
}

// 3. OutboxRelayWorker（内置 Relay Worker，可注入）
export class OutboxRelayWorker {
  start(): void;
  stop(): Promise<void>;
}
```

3. **配置项**：

```typescript
interface OutboxConfig {
  tableName: string; // 各服务可配，默认 'outbox_events'
  kafkaTopic: string; // 各服务可配
  pollIntervalMs: number; // 默认 1000
  batchSize: number; // 默认 100
  maxRetryCount: number; // 默认 5
  retryBackoffMs: number; // 默认 1000，指数退避
}
```

4. **表 schema**（Drizzle migration，各服务执行）：

```sql
CREATE TABLE outbox_events (
  id VARCHAR(32) PRIMARY KEY,           -- cuid2
  event_type VARCHAR(64) NOT NULL,
  payload JSON NOT NULL,
  status VARCHAR(16) DEFAULT 'pending', -- pending / published / failed
  retry_count INT DEFAULT 0,
  last_error TEXT,
  created_at TIMESTAMP DEFAULT NOW(),
  published_at TIMESTAMP
);
CREATE INDEX idx_outbox_status_created ON outbox_events(status, created_at);
```

5. **集成方式**：NestJS Module 注入（`@Module({ imports: [OutboxModule.forRoot(config)] })`）
6. **是否含 Kafka producer**：内置（iam 仅配置 topic）
7. **ORM 支持**：仅支持 Drizzle ORM（对齐黄金模板）
8. **事务边界**：业务表 + outbox 表同事务（Drizzle 事务 API），示例：

```typescript
await db.transaction(async (tx) => {
  await tx.insert(users).values(newUser);
  await outboxService.publish("user.created", { userId: newUser.id }, { tx });
});
```

**理由**：iam 首次接入方需求迫切（I2 裁决），core-edu / content / msg 后续接入保持一致。

**执行者**：coord
**完成期限**：批次 0.4（批次 1 启动前）

### 2.2 GraphQL schema 仲裁机制（ISSUE-019/030/037）

**裁决**：建立 GraphQL schema 仲裁规范：

1. **存放位置**：`packages/shared-ts/contracts/graphql/`
   - `teacher-bff.schema.graphql`（ai03 定义，coord 仲裁）
   - `student-bff.schema.graphql`（ai04 定义，coord 仲裁）
   - `parent-bff.schema.graphql`（ai05 定义，coord 仲裁）
   - `admin.schema.graphql`（admin 命名空间，复用 teacher-bff schema，见 §5.1）

2. **起草方**：各 BFF 负责 AI 起草，coord 仲裁
   - teacher-bff：ai03 起草，coord 在批次 1 启动前仲裁第一版
   - student-bff：ai04 起草（批次 1 等待期），coord 在批次 2 启动前仲裁第一版
   - parent-bff：ai05 起草（批次 2 等待期），coord 在批次 3 启动前仲裁第一版

3. **覆盖范围**：
   - Query/Mutation 清单（含字段定义 + 类型 + 分页规范）
   - 权限点标注（F7 规范，注释形式 `# @permission: DASHBOARD_VIEW`）
   - DataScope 标注（注释形式 `# @dataScope: OWN/CHILD/CLASS`）
   - 错误响应格式（GraphQL errors 数组扩展 ActionState 字段，`extensions.code = BFF_*`）

4. **版本管理**：SDL-first（schema.graphql 文件），配合 graphql-codegen 生成 TS 类型

5. **命名规范**：
   - Query/Mutation：camelCase（如 `teacherDashboard` / `listClassesByTeacher`）
   - 分页：Relay Cursor Connections 规范（`{ edges, pageInfo, totalCount }`）
   - 错误：GraphQL errors 数组 + `extensions.code` + `extensions.traceId`

6. **协调流程**：
   - BFF AI 起草 schema 草案 → coord 仲裁第一版 → 前端 AI 消费
   - schema 变更需 PR + BFF AI + 前端 AI 双方 review
   - 重大变更（删除字段 / 修改类型）需 coord 仲裁

**理由**：ai03 / ai04 / ai05 / ai13 / ai14 / ai15 均依赖 schema 仲裁，需统一机制。

**执行者**：coord（仲裁）+ 各 BFF AI（起草）+ 各前端 AI（消费）
**完成期限**：

- teacher-bff schema 第一版：批次 1 启动前
- student-bff schema 第一版：批次 2 启动前
- parent-bff schema 第一版：批次 3 启动前

### 2.3 BFF 跨阶段扩展例外验收标准（ISSUE-020）

**裁决**：明确"跨阶段扩展例外"的允许范围：

**允许扩展**：

1. 新增下游 gRPC 调用（新增 RPC 方法到 DownstreamClient）
2. 新增下游配置（gRPC endpoint 配置）
3. 新增 /readyz 探针（按阶段启用，见 §2.4）
4. Dashboard Query Resolver 内部数据源扩展（null 字段 → 真实数据）
5. AuthorizationGuard 内部实现替换（DEV_MODE 放行 → 真实 gRPC 校验）

**禁止变更**：

1. 修改已有 RPC 调用的签名或返回类型
2. 删除已实现的 RPC 调用（除非下游服务下线）
3. 修改 GraphQL schema 已有字段的类型（新增字段允许）
4. 修改 /readyz 已有探针的检查项（只能新增，不能修改）

**验收标准**：

1. 扩展时必须更新 BFF 的 02-architecture-design.md 下游调用矩阵
2. 扩展时必须更新 packages/shared-ts/contracts/graphql/ 下对应 schema 文件
3. 扩展时必须运行 `pnpm run arch:scan` 更新 arch.db
4. coord 在批次验收时检查上述 3 项

**理由**：ai03 / ai04 / ai05 跨阶段扩展时需统一标准。

**执行者**：各 BFF AI 执行，coord 验收

### 2.4 /readyz 探针按阶段扩展规则（ISSUE-023/034/042/055）

**裁决**：G2 裁决"首次实现即检查全部下游依赖"按以下规则执行：

1. **探针列表按阶段扩展**（属"跨阶段扩展例外"）：
   - P2 teacher-bff /readyz：DB + Redis + iam gRPC 50052（3 项）
   - P3 teacher-bff：+ core-edu gRPC 50053（4 项）
   - P4 teacher-bff：+ content gRPC 50054 + data-ana gRPC 50055（6 项）
   - P5 teacher-bff：+ ai gRPC 50058 + msg gRPC 50056（8 项）

2. **实现方式**：`DownstreamHealthCheck` 注册表模式，每个下游注册独立探针，按阶段启用

3. **可选依赖软失败规则**（针对 ISSUE-042/055）：
   - **必需依赖**（DB / Redis / 已启用 gRPC 下游）：失败返回 503，触发 Pod 重启
   - **可选依赖**（Kafka 消费 / PushGateway / 未启用 gRPC 下游）：失败仅告警，返回 200 + body `degraded: true`
   - msg /readyz 对 PushGateway：软失败（ISSUE-042 采纳方案 A）
   - push-gateway /readyz 对 Kafka：软失败（ISSUE-055）

4. **未引入依赖跳过**（ISSUE-023）：
   - content P4 /readyz：检查 MySQL + Neo4j + Kafka（3 项，ES 未配置则跳过）
   - content P5 /readyz：扩展 ES 检查（4 项，ES_URL 存在时才检查）
   - 实现方式：检查项数组通过 ENV 过滤（`if (env.ES_URL) checks.push(checkES)`）

5. **分级检查**（ISSUE-029）：
   - data-ana /readyz 对 iam gRPC：
     - L1 ping iam 50052 端口可达（基础就绪，失败 ready=false）
     - L2 调用 GetEffectiveDataScope 返回有效（深度就绪，失败 degraded=true）

**理由**：G2 原裁决"全部下游依赖"在 P2 不可行，需按阶段扩展 + 软失败策略。

**执行者**：各 AI 按规则实现

### 2.5 AttendanceService proto 责任方（ISSUE-022）

**裁决**：

1. **coord 负责 proto 契约定义**：core_edu.proto 补 AttendanceService + GetClassesByTeacher + BatchGetClasses 的 message + RPC 签名
2. **ai08 负责 proto 实现**：基于 coord 定义的 proto 生成 TS 代码 + 实现 AttendanceService 业务逻辑
3. **修正 coord-cross-review.md §6 #14**：责任方从 ai03 改为 coord（proto）+ ai08（实现）
4. **修正 004 §16.7.3**：保留 ai08 实现，但补注"proto 契约由 coord 定义"

**理由**：proto 契约是跨服务协作的接口，应由 coord 统一维护；业务实现由服务负责 AI 完成。

**执行者**：coord（proto）+ ai08（实现）
**完成期限**：proto 在批次 0.8 完成，实现 ai08 P3 完成

### 2.6 降级模式 ActionState 表达（ISSUE-030-ai11）

**裁决**：采纳方案 B（success=true + error=null + data 内 degraded 字段）：

```typescript
// 降级响应
{
  success: true,
  data: {
    ...actualData,
    degraded: true,           // 降级标记
    degradedReason: "redis_unavailable"  // 降级原因
  },
  error: null
}
```

**规则**：

1. 降级时 `success=true`，HTTP 200
2. `data` 内统一加 `degraded: boolean` + `degradedReason: string` 字段
3. BFF 消费端检查 `data.degraded` 判断降级
4. Python 服务（data-ana / ai）的 data 类型需统一加 degraded 字段
5. 修正 data-ana 02-architecture-design.md §4.3 ActionState.ok() 实现

**理由**：方案 B 最符合"成功返回数据但质量降级"的语义，避免"success=true 但 error 有值"的语义矛盾。

**执行者**：ai11（data-ana）+ ai12（ai）实现，coord 验收

### 2.7 BFF 错误码语义区分（ISSUE-059）

**裁决**：采纳 ai03 建议方案，明确 3 类 BFF 越权防御错误码：

| 错误码                           | HTTP | 场景                                                 | i18n key                              |
| -------------------------------- | ---- | ---------------------------------------------------- | ------------------------------------- |
| `BFF_TEACHER_UNAUTHORIZED`       | 401  | x-user-id 缺失或无效                                 | `error.bffTeacher.unauthorized`       |
| `BFF_TEACHER_FORBIDDEN_RESOURCE` | 403  | teacherId 与资源无归属关系（场景 A）                 | `error.bffTeacher.forbidden_resource` |
| `BFF_TEACHER_IDENTITY_MISMATCH`  | 403  | JWT teacherId 与请求 body teacherId 不一致（场景 B） | `error.bffTeacher.identity_mismatch`  |

**B3 裁决澄清**：BFF 豁免 @RequirePermission 指不做"功能权限决策"（如"能否查看仪表盘"），但必须做"数据权限防御"（如"只能看自己的班级"）。

**student-bff / parent-bff 同规则**：`BFF_STUDENT_*` / `BFF_PARENT_*` 前缀对应。

**执行者**：ai03 / ai04 / ai05 实现

### 2.8 Dashboard Query Resolver P2 实现方式（ISSUE-032）

**裁决**：采纳 ai03 建议方案：

1. **GraphQL schema 设计完整**（含全部 Query/Mutation 字段定义），P2 即定型，后续不重构
2. **Resolver 实现**：P2 阶段 Dashboard Query Resolver 内部仅调 iam gRPC（返回用户基础信息 + 角色），未启用的下游字段（班级数 / 作业数等）返回 `null` + `extensions.warning = "field_unavailable_in_p2"`
3. **P3-P5 扩展**：按"跨阶段扩展例外"原则，在 Resolver 内逐步补 gRPC 调用，将 null 字段替换为真实数据
4. **ai13 前端**：P2 联调时对 null 字段做 UI 降级展示（如"数据加载中"或隐藏模块）
5. **此方案不违反"不分阶段"**：schema 即最终方案，Resolver 内部数据源扩展属"跨阶段扩展例外"

**执行者**：ai03 实现 + ai13 前端配合

### 2.9 越权防御 P2 实现方式（ISSUE-033）

**裁决**：采纳 ai03 建议方案 D：

1. P2 抽象 `AuthorizationGuard` 接口（`canAccessClass(userId, classId): Promise<boolean>`）
2. P2 内部实现为"DEV_MODE 放行 + 生产拒绝"（保守策略）
3. **Redis 缓存**：P3 接入 core-edu gRPC 后，`GetClassesByTeacher` 结果缓存到 Redis（key: `authz:teacher:{teacherId}:classes`，TTL 5min），AuthorizationGuard 优先查缓存
4. **此方案不违反"不分阶段"**：Guard 接口即最终方案，P2→P3 仅替换内部实现（属"跨阶段扩展例外"）

**P2 阶段生产环境**：Guard 全部拒绝时，teacher-bff P2 端到端验证仅限 DEV_MODE。生产环境 P2 不接入流量（仅 dev 测试），P3 接入真实校验后正式上线。

**执行者**：ai03 实现

### 2.10 analytics.proto 补全时间（ISSUE-027）

**裁决**：

1. coord 在批次 0.11 完成 analytics.proto 扩展（4 端 Dashboard + Warning + MasteryDistribution + SubscribeMasteryUpdate Stream RPC）
2. ai11 在批次 3（P4）启动前确认 proto 已就绪
3. ai11 等待期间可先实现 HTTP 端点 + CDC 消费者 + ClickHouse DDL 等不依赖 proto 的工作

**执行者**：coord
**完成期限**：批次 0.11（批次 3 启动前）

### 2.11 warning.triggered topic 处理（ISSUE-028-ai11）

**裁决**：采纳方案 B（复用 topic）：

1. 维持现状，`warning.triggered` 复用 `edu.insight.mastery.updated` topic
2. events.proto MasteryEvent 用 `action` 字段区分 `mastery.updated` / `warning.triggered`
3. consumer 按 action 字段路由
4. D5 描述修正为"复用 mastery.updated topic，非独立登记"
5. 004 §7.2 表格补充注释："warning.triggered 复用 edu.insight.mastery.updated topic，通过 action 字段区分"

**理由**：避免拆分为两个 message 增加复杂度，复用 topic + action 字段路由是 Kafka 常见模式。

**执行者**：coord 修订 004 §7.2 + D5 描述

### 2.12 ClickHouse DDL 归属（ISSUE-026）

**裁决**：

1. **ai11 提供 DDL 内容**（已在 02 文档 §3 设计完毕）
2. **coord 授权 ai11 在 `infra/clickhouse/ddl/` 下创建纯 DDL .sql 文件**（不涉及部署脚本）
3. **SRE AI 负责部署执行脚本**（如 `init-clickhouse.sh`）
4. **修正 project_rules §14.2 解释**：业务 AI 可创建纯 DDL 文件（不涉及部署脚本），SRE AI 负责部署执行

**理由**：DDL 内容是业务特定的（5 张宽表设计），由 ai11 提供最合适；部署脚本属 infra 范畴。

**执行者**：ai11（DDL）+ SRE AI（部署）

### 2.13 Neo4j 知识图谱派生数据裁决（ISSUE-025-ai09）

**裁决**：Neo4j 知识图谱属于"派生数据读模型"：

1. Neo4j 节点数据完全从 MySQL 的 knowledge_points / kp_prerequisites 表派生
2. Neo4j 是读模型（图查询优化），MySQL 是写模型（权威源）
3. 符合 CQRS 读写分离原则
4. **实现方式**：content 主领域事件走 Outbox → Kafka，Neo4j Sync Worker 作为 Kafka consumer 消费这些事件并同步图谱（无需独立 Outbox）

**理由**：采纳 ai09 建议方案，符合 004 §12.2 派生数据事件豁免 Outbox 模式。

**执行者**：ai09 实现

### 2.14 ES Projector 实现位置（ISSUE-024-ai09）

**裁决**：采纳方案 A（content 内部实现）：

1. ES Projector 在 content 服务内部实现（`shared/sync/es-sync.worker.ts`）
2. 与 Neo4j Sync Worker 同构（一对 Sync Worker 模式）
3. shared-ts 仅承载通用的 Outbox Publisher（Kafka producer 通用能力），特定 Projector 由各服务自实现
4. ES mapping 是 content 特有的（questions/knowledge_points 索引结构、ik_max_word 分词、dense_vector embedding），通用 Projector 难以抽象

**执行者**：ai09 实现（P5 阶段）

### 2.15 API 版本化 /iam/v1/* 规则（ISSUE-048）

**裁决**：

1. **全服务统一加 `/v1` 前缀**（不只是 iam），各服务按自身节奏推进（iam P2 / core-edu P3 / content P4 / msg P5）
2. **前缀位置**：Controller 内加 `v1` 前缀（NestJS `@Controller('v1/iam/auth')`）
3. **Gateway 透传**：Gateway 路由 `/iam/v1/*` → iam 服务 `/v1/iam/*`（Gateway 不改路径，直接透传）
4. **避免双 v1**：Controller 加 `/v1`，Gateway 转发路径不含 `/v1`（Gateway 仅做路径匹配 + 代理）
5. **现有端点立即迁移**：不保留旧路径（遵循"不分阶段"原则，P1 链路由 ai01 + ai06 同步修复）
6. **gateway 路由配置同步更新**（ai01 P2 工作项）

**理由**：采纳 ai06 建议方案，统一规则避免各 AI 自行理解。

**执行者**：各服务 AI 实现 + ai01 Gateway 配置

### 2.16 gRPC 与 REST 双入口策略（ISSUE-049）

**裁决**：

1. **双入口策略**：REST 供 gateway 透传 + 前端直连（admin-portal），gRPC 供 BFF 聚合调用
2. **NestJS 复用**：同一 Application Service 同时被 REST Controller + gRPC Controller 调用，业务逻辑不重复
3. **gateway 保持 HTTP 透传**：gateway 不改为 gRPC 客户端（降低 P2 工作量），gateway → iam REST 路径不变
4. **BFF gRPC 调 iam**：teacher-bff / student-bff / parent-bff 用 gRPC 调 iam（B2 裁决）
5. **写入 coord-final-decisions.md I1 补充条款**

**理由**：采纳 ai06 建议方案，避免 gateway 改为 gRPC 客户端的额外工作量。

**执行者**：ai06 实现 + ai01 Gateway

### 2.17 MF AppShell GraphQL client 单例（ISSUE-038/047）

**裁决**：采纳方案 A（Shell 暴露 GraphQL client 单例）：

1. **Shell 暴露 GraphQLProvider**：ai13 P2 teacher-portal MF shell 的 AppShell 包含 `<GraphQLProvider client={sharedClient}>`
2. **统一缓存**：避免跨 Remote 数据不一致
3. **统一鉴权 header 注入**：Authorization: Bearer token
4. **统一错误处理**：401 跳转登录、5xx 降级
5. **MF shared 配置**：react / urql / apollo 设为 singleton，避免多实例
6. **admin-portal 复用**（ISSUE-047）：ai16 admin-portal 作为 MF Remote 接入 teacher-portal Shell，复用 Shell 暴露的 GraphQL client 单例
7. **ai16 回写 02 文档 §4.1**：将"复用 ApiClient (REST)"改为"复用 Shell 暴露的 GraphQL client 单例"
8. **coord 在批次 1 启动前仲裁 MF shell 暴露清单**（增加 GraphQL client 项）

**理由**：统一缓存 + 鉴权 + 错误处理，避免各 Remote 自行初始化导致数据不一致。

**执行者**：ai13 实现 + ai14/ai15/ai16 消费

### 2.18 ai13 packages 建立时机（ISSUE-039）

**裁决**：

1. **ai13 在 P2 启动前（批次 0 末或批次 1 初）建立 3 个 packages 骨架**：
   - `packages/ui-tokens`（设计令牌，无依赖）
   - `packages/ui-components`（依赖 ui-tokens）
   - `packages/hooks`（依赖 ui-components）
2. **4 个 portal 统一消费**，版本通过 pnpm workspace 协议（`"workspace:*"`）
3. **ai13 完成后通知 ai14/ai15/ai16** 消费
4. **coord 在批次 1 验收 ai13 时检查 packages 已建立**
5. **批次 0 增加 0.15 任务**："ai13 建立 packages/ui-tokens + ui-components + hooks 骨架"

**执行者**：ai13
**完成期限**：批次 0.15（批次 1 启动前）

### 2.19 shared-go 包建立（ISSUE-054）

**裁决**：

1. **coord 在批次 0 增加 0.14 任务**："建立 `packages/shared-go` 包骨架（含 tracer/logger/jwks/env 4 个模块的接口定义 + 默认实现）"
2. **ai01 / ai02 在 P2/P5 启动时直接 import `packages/shared-go`**，禁止各自维护副本
3. **shared-go 包版本管理**：通过 go.workspace 引用，对齐 project_rules §11
4. **后续提取候选**：circuit-breaker.go / rate-limiter.go（若 ai01 P2 实现后 ai02 P5 复用）

**执行者**：coord
**完成期限**：批次 0.14（批次 1 启动前）

---

## 3. P2 各批次启动前完成：文档回写与工作量分级

### 3.1 ai03 P2 工作量分级（ISSUE-036）

**裁决**：采纳 ai03 建议方案，明确 P2 最小交付范围：

**Must Have（P2 必须完成）**：

1. GraphQL endpoint + schema 第一版（阻塞 ai13）
2. DownstreamClient 抽象 + iam gRPC（阻塞 ai04/ai05）
3. AuthMiddleware 越权防御抽象（B4 + ISSUE-033）
4. /readyz 探针注册表 + iam 探针（G2 + ISSUE-034）
5. /healthz liveness（G3）
6. pino 结构化日志（G4）
7. GlobalErrorFilter + ActionState 信封（G8）
8. BFF_TEACHER_ 错误码前缀（B5 + G14 + ISSUE-059）
9. 回写 02 文档（§7.2 + ISSUE-035）
10. ESM import .js 后缀（G12）
11. import type（G13）
12. getDb() 统一（G10）
13. cuid2 ID（G11）

**Should Have（P2 末期或 P3 初期补）**：14. OTel tracer（G6，P2 可降级为 logger-only）15. /metrics 业务指标（G5，P2 仅暴露 process metrics）16. DataLoader 集成（B1，P2 可先用普通 resolver）17. Redis 5-30s 短缓存（B6）

**Nice to Have（P3 持续补）**：18. Zod 全量验证（G7，P2 先校验核心 Query）19. 优雅关闭 SIGTERM（G9，P2 可简化为 HTTP close）

**理由**：批次 1 时间线 5-7 天内完成 19 项工作风险高，按 Must/Should/Nice 分级保证关键路径。

**执行者**：ai03
**完成期限**：Must Have 在批次 1 完成，Should Have 在 P3 初期补，Nice to Have 在 P3 持续补

### 3.2 ai06 iam P2 工作量分级（ISSUE-052）

**裁决**：采纳方案 A（拆分 P2 为 P2.1 核心 + P2.2 扩展）：

**P2.1（批次 1，5-7 天，阻塞批次 2）**：

1. gRPC server 50052 + 8 RPC 实现（GetViewports / GetEffectivePermissions / GetEffectiveAccess / Logout / GetPublicKey / BatchGetUsers / GetEffectiveDataScope / GetChildrenByParent）
2. AuthMiddleware 注册 + Controller 改用 @Req() 注入（I4 裁决）
3. JWT RS256 本地文件 + refresh token 轮换（I5 裁决）
4. iam_student_guardians 表 + GetChildrenByParent RPC + GET /iam/children REST（I6 裁决）
5. shared-ts Outbox 接入（I2 裁决）
6. /iam/v1/* 前缀迁移（I7 裁决）+ 端点路径统一（I8 裁决）
7. DB 驱动 PermissionGuard 基础（I3 裁决，废弃硬编码 ROLE_PERMISSIONS map）
8. 回写 02 文档（ISSUE-051）

**P2.2（P3 期间持续补，不阻塞批次 2/3）**：9. 三层角色模型（school_admin / teacher / student + 自定义角色）10. DataScope 6 级实现（ALL / SCHOOL / GRADE / CLASS / SUBJECT / SELF）11. 视口 4 层（admin / teacher / student / parent）+ getEffectivePermissions 12. 审计日志（user_audit_log 表 + 记录关键操作）13. 密码策略（强度 / 过期 / 重用限制）14. 单元测试 + 集成测试 15. Redis 缓存（I3 裁决完整实现）

**批次 2 启动条件**：仅依赖 P2.1 完成（gRPC 50052 + 8 RPC + GetChildrenByParent 已就绪），不依赖 P2.2。

**理由**：iam 实际工作量 26-27 天，批次 1 时间线 5-7 天严重不匹配。拆分 P2.1 / P2.2 保证关键路径不阻塞。

**执行者**：ai06
**完成期限**：P2.1 在批次 1 完成，P2.2 在 P3 期间持续补

### 3.3 ai10 P5 工作量分级（关联 ISSUE-052）

**裁决**：ai10 msg P5 实际工作量 14-15 天，批次 4 预估 7-10 天差距约 50%。采纳分级交付：

**P5 Must Have（批次 4，10-12 天）**：

1. proto 生成代码 + gRPC server 50056 框架搭建
2. DB schema 建立（6 表扩展/新增）+ ES mapping + Redis bitmap schema
3. 6 层架构骨架（Entry/Guard/App/Strategy/Domain/Data）+ getDb() + cuid2
4. 8 gRPC RPC 实现 + 16 REST 端点实现
5. 7 Kafka 消费方实现 + 3 发布事件 Outbox
6. 4 ChannelStrategy 基础实现（InApp/Email/SMS/Push）
7. /readyz + /healthz + /metrics + 优雅关闭 + OTel

**P5 Should Have（批次 4 末期或 P6 初期补）**：8. 模板渲染完整实现 9. 静默时段 10. DLQ 完整实现 11. 三层幂等完整实现 12. 集成测试 + 端到端验证（含 push-gateway 联调）

**理由**：与 ai06 iam P2 同类问题，分级交付保证关键路径。

**执行者**：ai10
**完成期限**：Must Have 在批次 4 完成，Should Have 在 P6 初期补

### 3.4 各 AI 文档回写义务（ISSUE-028/032-ai15/034-ai15/036-ai13/051-ai06/053-ai02/063-ai14）

**裁决**：各 AI 在 coord 仲裁后 3 个工作日内（或对应批次启动前）完成回写：

| AI   | 文档              | 回写内容                                                                           | 完成期限      |
| ---- | ----------------- | ---------------------------------------------------------------------------------- | ------------- |
| ai03 | teacher-bff 02    | 4 处 GetTeacherDashboardStats → GetTeacherDashboard（ISSUE-035）                   | 批次 1 启动前 |
| ai04 | student-bff 02    | B1 GraphQL + B2 gRPC + B8 DownstreamClient 回写（ISSUE-028）                       | 批次 2 启动前 |
| ai05 | parent-bff 02     | B1 GraphQL + B2 gRPC 回写                                                          | 批次 3 启动前 |
| ai06 | iam 02            | I1-I8 裁决对齐 4 处 + §9 标注前移（ISSUE-051）                                     | 批次 1 启动前 |
| ai09 | content 02        | 移除已裁决项 + ES 启用时机标注                                                     | 批次 3 启动前 |
| ai10 | msg 02            | M2 软失败 + ISSUE-043 验证 + ISSUE-012 契约更新                                    | 批次 4 启动前 |
| ai02 | push-gateway 02   | ISSUE-053 topic + ISSUE-055 /readyz + ISSUE-056 设计决策记录 + ISSUE-058 Redis SET | 批次 4 启动前 |
| ai13 | teacher-portal 03 | 删除 §6 REST→GraphQL 演进策略（ISSUE-036）                                         | 批次 1 启动前 |
| ai14 | student-portal 02 | F9 GraphQL + F7 权限点命名回写（ISSUE-063/064）                                    | 批次 2 启动前 |
| ai15 | parent-portal 02  | F9 GraphQL + 删除"P4 用 REST 后续切 GraphQL"（ISSUE-032/034）                      | 批次 3 启动前 |
| ai16 | admin-portal 02   | ISSUE-044~048 仲裁结果回写                                                         | 批次 5 启动前 |

**回写验收**：

1. 回写完成后在 known-issues.md 工作经验日志追加记录
2. coord 在批次验收时检查 02 文档与裁决一致性
3. 不回写视为违反 coord-final-decisions §0.1 回写义务，coord 验收不通过

**执行者**：各 AI

### 3.5 ai03 P2 功能范围（关联 ISSUE-040）

**裁决**：明确 ai13 teacher-portal P2 功能范围：

**P2 实现**（依赖 iam + teacher-bff GraphQL schema）：

- 登录 + 权限上下文
- Dashboard 框架（null 字段降级展示）
- 个人设置
- 班级列表（iam 数据）
- 学生列表（iam 数据）

**P3 扩展**（跟随 teacher-bff 调 core-edu）：

- 课表 / 考勤 / 考试 / 作业

**P4 扩展**（跟随 teacher-bff 调 content/data-ana）：

- 教材 / 题库 / 分析仪表盘

**P5 扩展**（跟随 teacher-bff 调 ai/msg）：

- AI 助教 / 消息通知

**规则**：前端路由骨架 P2 一次性建立，但页面内容随 BFF 能力分阶段填充（属"跨阶段扩展例外"）。

**执行者**：ai13

### 3.6 ai14 student-portal P3 功能范围（ISSUE-065）

**裁决**：明确 ai14 student-portal P3 功能范围：

**P3 实现**（7 页，依赖 iam + core-edu）：

- dashboard / homework / exams / take / result / grades / my-schedule

**P4 扩展**（4 页，依赖 content + data-ana）：

- textbooks / questions / diagnostic / weakness

**P5 扩展**（2 页，依赖 msg + ai）：

- notifications / ai-chat

**P4/P5 页面**：设 `<FeatureFlag>` 占位（显示"功能开发中"提示页），避免用户访问 404。

**coord 验收 ai14 P3 时检查**：P3 范围 7 页全部可用 + P4/P5 页面有占位。

**执行者**：ai14

### 3.7 BFF 通知功能阶段归属（ISSUE-013/033/066）

**裁决**：BFF 通知功能统一推迟到 P5：

1. **P2-P4 阶段**：BFF 不订阅 Kafka（B7 裁决），通知功能不实现
2. **P5 阶段**：msg + push-gateway 就绪后，BFF 订阅 Kafka + 前端接入 push-gateway WebSocket/SSE
3. **parent-portal 通知偏好**（ISSUE-033）：
   - P4 阶段：通知偏好设置页面 UI + 表单校验，偏好暂存前端 localStorage（降级方案），不调后端 API
   - P5 阶段：parent-bff 接入 msg 服务 GraphQL mutation `updateNotificationPreferences`，偏好持久化到 msg DB
4. **student-portal 通知中心**（ISSUE-066）：
   - P3-P4：notifications route 设 `<FeatureFlag>` 占位
   - P5：实现通知中心页面 + WebSocket/SSE 接入 push-gateway
5. **P3-P4 降级方案**：学生端可提供"手动刷新"（轮询 core-edu 查询最近作业/考试），但不作为正式通知功能

**理由**：B7 裁决 P2-P4 BFF 不订阅 Kafka 简化实现，通知功能推迟到 P5 统一启用。

**执行者**：ai03/ai04/ai05（BFF）+ ai13/ai14/ai15（前端）

---

## 4. P2 各批次启动前完成：服务依赖与时序

### 4.1 批次 0 完成信号机制（ISSUE-047）

**裁决**：

1. **coord 在 ai-work-orchestration.md §3.1 标注每项任务完成状态**（✅ 已完成 / ⏳ 待办 / 🔄 进行中）
2. **批次 0 全部 15 项任务完成后，coord 发布批次 1 启动公告**（在 ai-work-orchestration.md §9 时间线末尾追加"批次 0 已完成，批次 1 启动"）
3. **建立"前置依赖就绪检查清单"**，coord 在批次 1/2/3/4/5 启动前逐项确认
4. **批次 0 任务清单**（最终 15 项）：
   - 0.1 arch:scan 更新
   - 0.2 修订 coord-cross-review.md
   - 0.3 补全 iam.proto 8 RPC
   - 0.4 建立 shared-ts Outbox 工具包（含设计草案 + 实现）
   - 0.5 补全 content.proto（QuestionService 等）
   - 0.6 补全 msg.proto
   - 0.7 补全 analytics.proto 扩展
   - 0.8 补全 core_edu.proto（AttendanceService / GetClassesByTeacher / BatchGetClasses）
   - 0.9 buf.gen.yaml 补 gRPC 插件
   - 0.10 补全 events.proto（7 message 已完成）
   - 0.11 analytics.proto 扩展（4 端 Dashboard + Warning + MasteryDistribution + SubscribeMasteryUpdate）
   - 0.12 补全 push-gateway 相关 proto（如有）
   - 0.13 补全 msg.proto（5 RPC + NotificationPreferenceService + NotificationTemplateService + 3 message）
   - 0.14 建立 shared-go 包骨架（tracer/logger/jwks/env 4 模块）
   - 0.15 ai13 建立 packages/ui-tokens + ui-components + hooks 骨架

**执行者**：coord（0.1-0.14）+ ai13（0.15）
**完成期限**：批次 0 全部完成后再启动批次 1

### 4.2 /internal/push 契约采纳（ISSUE-057/012）

**裁决**：

1. **coord 直接采纳 ai02 02 §4.2 作为第一版 /internal/push 契约**（"as-is"采纳）
2. **仅在 ai10 提出异议时**（如 msg 调用方需要 batch 接口 / 异步回调机制），coord 才调整契约
3. **coord 在批次 4 启动前公布"采纳 ai02 02 §4.2 作为第一版契约"的决定**，避免重复仲裁
4. **若 coord 决定调整**，必须给出具体差异点（如新增字段、修改响应格式），ai02/ai10 按差异点调整

**执行者**：coord
**完成期限**：批次 4 启动前

### 4.3 Redis SET 心跳重建机制（ISSUE-058）

**裁决**：采纳 ai02 建议方案：

1. **ai02 02 §3.1 补充"Hub 启动时重建 Redis SET"机制**：
   - Hub 启动时遍历内存连接（userID），SADD 自己 instanceID 到 `edu:push:online:<userID>` + EXPIRE 60s
   - 启动时清空 Redis 中本 instanceID 的旧成员（避免幽灵成员）
2. **/readyz Redis 检查失败时仅告警不阻塞**（与 ISSUE-055 协调），避免雪崩
3. **metrics 暴露 `push_gateway_redis_set_rebuild_total`** 监控重建次数
4. **文档化"Redis 故障恢复后 60s 内在线状态可能短暂不一致"**，msg 服务调用方需容忍 `online: false` 误判（msg 应继续尝试 HTTP /internal/push，由 push-gateway 返回真实在线状态）

**执行者**：ai02
**完成期限**：P5 启动前回写 02 文档

### 4.4 设计决策记录章节保留规则（ISSUE-056）

**裁决**：

1. **coord-final-decisions.md §7.2 回写义务表补充澄清**："设计决策记录章节（已被 coord 采纳的仲裁请求）保留，但正文需标注'coord 已采纳，见 coord-final-decisions P1/P5/P6'，标题改为'设计决策记录：xxx'"
2. **ai02 02 §5.4 改名**为"设计决策记录：gRPC vs HTTP 协议选型（coord 已采纳 P1）"
3. **ai02 02 §14.2 改名**为"设计决策记录：SSE/断线重连范围（coord 已采纳 P5/P6）"
4. **章节内容保留作为决策追溯依据**，但删除"中间过渡方案"字样
5. **其他 AI 的同类"过渡方案描述"**（如 ai13 ISSUE-036、ai15 ISSUE-034）按此原则处理：删除过渡方案本身，保留设计决策记录

**执行者**：coord（§7.2 补充）+ ai02（02 文档回写）+ 其他 AI 同规则

### 4.5 iam /readyz 检查深度（ISSUE-029-ai11）

**裁决**：采纳 ai11 建议方案：

1. **coord 验收 iam P2 时强制检查 GetEffectiveDataScope RPC 已落地**（不仅仅是 gRPC server 启用）
2. **data-ana /readyz 分两级检查**：
   - L1 ping iam 50052 端口可达（基础就绪，失败 ready=false）
   - L2 调用 GetEffectiveDataScope 返回有效（深度就绪，失败 degraded=true）

**执行者**：ai11 实现 + coord 验收

---

## 5. P2 各批次启动前完成：工作归属裁决

### 5.1 admin-portal BFF 归属（ISSUE-044）

**裁决**：采纳方案 2（复用 teacher-bff）：

1. **admin-portal 复用 teacher-bff 的 GraphQL endpoint**，不新建 admin-bff 服务
2. **ai03 P2 预留 admin schema 命名空间**（如 `admin.*` Query/Mutation）
3. **coord 在批次 1 启动前仲裁 schema 第一版时纳入 admin 命名空间**
4. **004 §1.2 服务清单保持不变**（无 admin-bff）
5. **ai16 回写 02 文档 §4.1**：数据获取路径改为"复用 teacher-bff GraphQL endpoint"

**理由**：admin 操作低 QPS，无需独立 BFF 实例；减少 ai16 工作量。

**执行者**：ai03（预留 admin 命名空间）+ ai16（回写 02 文档）

### 5.2 admin-portal 错误码前缀（ISSUE-045）

**裁决**：

1. **G14 清单补充 `ADMIN_` 前缀**（合并 SCHOOL_ 入 ADMIN_，因学校设置属 admin 业务子域）
2. **ORG 管理也归入 ADMIN\_ 前缀**（统一 admin 域）
3. **错误码命名**：`ADMIN_<RESOURCE>_<ERROR>`（如 `ADMIN_SCHOOL_NOT_FOUND`、`ADMIN_ORG_DUPLICATE_NAME`）
4. **i18n key**：`error.admin.*`（对齐 F4 规范）
5. **写入 coord-final-decisions.md G14 补充条款**

**执行者**：coord（G14 补充）+ ai16（实现）

### 5.3 admin-portal 权限点命名（ISSUE-046）

**裁决**：

1. **F7 允许服务前缀作为命名空间**（避免不同域同名资源冲突，如 `CONTENT_QUESTION_READ` vs `CORE_EDU_QUESTION_READ`）
2. **命名规则**：`[<SERVICE>_]<RESOURCE>_<ACTION>[_<SCOPE>]`，SERVICE 可选
3. **admin-portal 权限点统一加 `ADMIN_` 前缀**（与错误码前缀对齐）
4. **跨服务资源**（如调 iam 用户管理）保留 iam 前缀（`IAM_USER_READ`），admin 自身资源用 `ADMIN_` 前缀
5. **admin-portal 调下游服务的权限点校验由下游服务负责**（B3 裁决 BFF 豁免 @RequirePermission，admin-portal 作为 client 不做权限决策）
6. **写入 coord-final-decisions.md F7 补充条款**

**执行者**：coord（F7 补充）+ ai16（实现）

### 5.4 admin-portal GraphQL 客户端（ISSUE-047）

**裁决**：已在 §2.17 裁决，admin-portal 复用 Shell 暴露的 GraphQL client 单例。

**执行者**：ai13（Shell 暴露）+ ai16（消费）

### 5.5 admin-portal 审计日志归属（ISSUE-048）

**裁决**：X3 审计日志归属前置到 P6 启动前裁决：

1. **审计日志归 iam**（iam 已掌握用户/角色数据，审计事件天然属 iam 域）
2. **events.proto 补 `AuditEvent` message**：

```protobuf
message AuditEvent {
  string event_id = 1;
  string aggregate_id = 2;
  string event_type = 3;
  int64 occurred_at = 4;
  string actor_user_id = 5;
  string action = 6;              // create / update / delete / login / logout
  string resource_type = 7;       // user / role / class / exam ...
  string resource_id = 8;
  string before_state = 9;        // JSON string
  string after_state = 10;        // JSON string
  string ip = 11;
  string user_agent = 12;
  string trace_id = 13;
  map<string, string> metadata = 14;
}
```

3. **新增 topic `edu.iam.audit.created`**（统一审计事件 topic，不按操作类型分）
4. **admin-portal 作为 consumer 订阅 `edu.iam.audit.created`**，写入 ClickHouse 审计表（或 MySQL 审计表）
5. **admin-portal 8 个新 Kafka topic 重新评估**：若审计归 iam，admin-portal 仅需 1 个 audit consumer topic，无需 8 个
6. **iam P2.2 扩展阶段补 AuditEvent 发布**（user_audit_log 表 + 事件发布）
7. **events.proto 补 AuditEvent 在批次 0.10 完成**

**执行者**：coord（proto + topic）+ ai06（iam 发布）+ ai16（admin-portal 消费）

---

## 6. 时间统筹总表（批次时间线最终调整）

### 6.1 批次时间线（最终版）

基于工作量分级裁决（§3.1-3.3），批次时间线最终调整如下：

| 批次       | 阶段       | AI 并行                                  | 时间线   | 关键交付                                                                                               | 启动条件                                          |
| ---------- | ---------- | ---------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------- |
| **批次 0** | coord 前置 | coord（0.1-0.14）+ ai13（0.15）          | 3-5 天   | proto 契约 + shared-ts Outbox + shared-go + packages 骨架                                              | 本裁决发布后立即                                  |
| **批次 1** | P2         | ai01 + ai06 + ai03⟷ai13                  | 7-10 天  | iam P2.1 + teacher-bff Must Have + teacher-portal P2 + Gateway 路由                                    | 批次 0 全部完成                                   |
| **批次 2** | P3         | ai08 + ai07 交接 + ai04⟷ai14 + ai03 扩展 | 7-10 天  | core-edu gRPC 50053 + student-bff + student-portal P3（7 页）+ teacher-bff P3 扩展                     | 批次 1 P2.1 完成 + ai03 DownstreamClient 抽象就绪 |
| **批次 3** | P4         | ai09 + ai11 + ai05⟷ai15 + ai03/ai04 扩展 | 10-12 天 | content gRPC 50054 + data-ana gRPC 50055 + parent-bff + parent-portal P4 + teacher/student-bff P4 扩展 | 批次 2 完成                                       |
| **批次 4** | P5         | ai10⟷ai02 + ai12 + ai03 扩展             | 12-15 天 | msg gRPC 50056 + push-gateway + ai 服务 + teacher-bff P5 扩展 + 通知功能启用                           | 批次 3 完成                                       |
| **批次 5** | P6         | ai16 + 持续优化                          | 10-12 天 | admin-portal + 审计日志 + iam P2.2 补全 + 持续优化                                                     | 批次 4 完成                                       |

**总时间线**：49-64 天（约 10-13 周）

### 6.2 批次 0 详细任务清单

| 任务 | 责任方 | 内容                                                                                                       | 完成信号                              |
| ---- | ------ | ---------------------------------------------------------------------------------------------------------- | ------------------------------------- |
| 0.1  | coord  | arch:scan 更新                                                                                             | arch.db 已更新                        |
| 0.2  | coord  | 修订 coord-cross-review.md                                                                                 | 文档已更新                            |
| 0.3  | coord  | 补全 iam.proto 8 RPC                                                                                       | proto 文件已提交                      |
| 0.4  | coord  | 建立 shared-ts Outbox 工具包（含设计草案 + 实现）                                                          | packages/shared-ts/src/outbox/ 已建立 |
| 0.5  | coord  | 补全 content.proto（QuestionService 等）                                                                   | proto 文件已提交                      |
| 0.6  | coord  | 补全 msg.proto 基础                                                                                        | proto 文件已提交                      |
| 0.7  | coord  | 补全 analytics.proto 基础                                                                                  | proto 文件已提交                      |
| 0.8  | coord  | 补全 core_edu.proto（AttendanceService / GetClassesByTeacher / BatchGetClasses）                           | proto 文件已提交                      |
| 0.9  | coord  | buf.gen.yaml 补 gRPC 插件                                                                                  | buf generate 可运行                   |
| 0.10 | coord  | 补全 events.proto（含 AuditEvent）                                                                         | proto 文件已提交                      |
| 0.11 | coord  | analytics.proto 扩展（4 端 Dashboard + Warning + MasteryDistribution + SubscribeMasteryUpdate Stream RPC） | proto 文件已提交                      |
| 0.12 | coord  | 补全 push-gateway 相关 proto（如有）                                                                       | proto 文件已提交                      |
| 0.13 | coord  | 补全 msg.proto（5 RPC + NotificationPreferenceService + NotificationTemplateService + 3 message）          | proto 文件已提交                      |
| 0.14 | coord  | 建立 shared-go 包骨架（tracer/logger/jwks/env 4 模块）                                                     | packages/shared-go/ 已建立            |
| 0.15 | ai13   | 建立 packages/ui-tokens + ui-components + hooks 骨架                                                       | 3 个 packages 已建立                  |

### 6.3 批次 1 详细任务清单（P2）

| AI   | 任务                                                                                                                                             | 时间线  | 关键交付                                                  |
| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ------- | --------------------------------------------------------- |
| ai01 | Gateway 路由配置（/iam/v1/* + /teacher/* + /parent/* 前缀）                                                                                      | 3-5 天  | Gateway 路由就绪                                          |
| ai06 | iam P2.1（gRPC + 8 RPC + AuthMiddleware + JWT RS256 + iam_student_guardians + shared-ts Outbox + /iam/v1/* 前缀 + DB 驱动 PermissionGuard 基础） | 7-10 天 | iam gRPC 50052 + 8 RPC 就绪                               |
| ai03 | teacher-bff P2 Must Have（GraphQL + DownstreamClient + AuthMiddleware + /readyz + /healthz + pino + GlobalErrorFilter + 错误码 + ESM + cuid2）   | 7-10 天 | teacher-bff GraphQL schema 第一版 + DownstreamClient 抽象 |
| ai13 | teacher-portal P2（client 改造 + MF shell + 共享组件抽取 + GraphQL Provider + packages 完善）                                                    | 7-10 天 | teacher-portal P2 可联调                                  |

**批次 1 启动前 coord 仲裁**：

- teacher-bff GraphQL schema 第一版（含 admin 命名空间）
- MF shell 暴露清单（含 GraphQL client 单例）
- /internal/push 契约（如批次 4 提前需要，可延后）

### 6.4 批次 2-5 启动前 coord 仲裁

| 批次   | 仲裁内容                                         | 完成期限      |
| ------ | ------------------------------------------------ | ------------- |
| 批次 2 | student-bff GraphQL schema 第一版                | 批次 2 启动前 |
| 批次 3 | parent-bff GraphQL schema 第一版                 | 批次 3 启动前 |
| 批次 4 | /internal/push 契约（采纳 ai02 02 §4.2）         | 批次 4 启动前 |
| 批次 5 | admin-portal schema 命名空间（复用 teacher-bff） | 批次 5 启动前 |

---

## 7. 各 AI 工作内容最终清单

### 7.1 ai01（api-gateway）

- **批次 1（P2）**：Gateway 路由配置（/iam/v1/* + /teacher/* + /parent/* 前缀）+ 接入 shared-go 包
- **批次 2-5**：路由扩展（core-edu / content / data-ana / msg / ai 路由）+ 持续优化

### 7.2 ai02（push-gateway）

- **批次 0 等待期**：复审 02 文档 + 回写 ISSUE-053/055/056/058
- **批次 4（P5）**：/internal/push + WebSocket + Redis Pub/Sub + Kafka 消费（可选）+ /readyz + /metrics + OTel + 多阶段 Dockerfile + slog + X-Internal-Token 重命名 + 集成测试

### 7.3 ai03（teacher-bff）

- **批次 1（P2）**：Must Have 13 项（见 §3.1）+ DownstreamClient 抽象 + admin schema 命名空间预留
- **批次 2-5**：跨阶段扩展（core-edu / content / data-ana / msg / ai gRPC 调用）+ Should Have + Nice to Have 持续补

### 7.4 ai04（student-bff）

- **批次 0/1 等待期**：回写 02 文档（B1/B2/B8）+ 起草 student-bff GraphQL schema 草案
- **批次 2（P3）**：student-bff P3（GraphQL + DownstreamClient 复用 + iam + core-edu gRPC）
- **批次 3-4**：跨阶段扩展（content / data-ana gRPC）
- **批次 4**：跨阶段扩展（msg / ai gRPC）+ 通知功能启用

### 7.5 ai05（parent-bff）

- **批次 0-2 等待期**：回写 02 文档 + 起草 parent-bff GraphQL schema 草案
- **批次 3（P4）**：parent-bff P4（GraphQL + DownstreamClient 复用 + iam + core-edu gRPC）
- **批次 4**：跨阶段扩展（data-ana gRPC）+ 通知功能启用

### 7.6 ai06（iam）

- **批次 0 等待期**：回写 02 文档（I1-I8）+ 监控批次 0.3/0.4 完成
- **批次 1（P2.1）**：gRPC + 8 RPC + AuthMiddleware + JWT RS256 + iam_student_guardians + shared-ts Outbox + /iam/v1/* 前缀 + DB 驱动 PermissionGuard 基础
- **批次 2-5（P2.2 持续补）**：三层角色 + DataScope + 视口 + 审计日志 + 密码策略 + 测试

### 7.7 ai07（classes 交接）

- **批次 0**：classes 黄金模板代码交接给 ai08
- **后续**：无（ai07 已完成黄金模板工作）

### 7.8 ai08（core-edu）

- **批次 0 等待期**：复审 02 文档 + 监控批次 0.8 完成
- **批次 2（P3）**：core-edu gRPC 50053 + AttendanceService 实现 + classes 代码交接 + Outbox + TOPIC_MAP 修订（edu.teaching.*）
- **批次 3-5**：跨阶段扩展（如需）

### 7.9 ai09（content）

- **批次 0-2 等待期**：复审 02 文档 + 移除已裁决项
- **批次 3（P4）**：content gRPC 50054 + QuestionService 完整实现 + Outbox + Neo4j Sync Worker + /readyz（MySQL + Neo4j + Kafka）
- **批次 4（P5）**：ES Projector 实现 + /readyz 扩展 ES 检查

### 7.10 ai10（msg）

- **批次 0-3 等待期**：复审 02 文档 + 回写 ISSUE-042/043
- **批次 4（P5）**：msg gRPC 50056 + Must Have（gRPC + REST + Outbox + 基础 channel）+ Should Have（模板 + 静默 + DLQ + 完整幂等）
- **批次 5**：Should Have 补全 + 集成测试

### 7.11 ai11（data-ana）

- **批次 0-2 等待期**：复审 02 文档 + ClickHouse DDL 文件创建
- **批次 3（P4）**：data-ana gRPC 50055 + CDC 消费者 + ClickHouse 宽表 + /readyz（分两级检查 iam gRPC）
- **批次 4-5**：跨阶段扩展（如需）

### 7.12 ai12（ai）

- **批次 0-3 等待期**：复审 02 文档
- **批次 4（P5）**：ai 服务（ES 检索 + AI 备课 + 出题 + StreamChat）+ 接入 content/data-ana gRPC

### 7.13 ai13（teacher-portal）

- **批次 0（0.15）**：建立 packages/ui-tokens + ui-components + hooks 骨架
- **批次 1（P2）**：teacher-portal P2（client 改造 + MF shell + GraphQL Provider + 共享组件抽取）+ 03 文档回写
- **批次 2-5**：跟随 teacher-bff 扩展页面

### 7.14 ai14（student-portal）

- **批次 0/1 等待期**：回写 02 文档（F9 GraphQL + F7 权限点命名）+ 起草 client query 清单
- **批次 2（P3）**：student-portal P3（7 页：dashboard/homework/exams/take/result/grades/my-schedule）
- **批次 3**：P4 扩展（4 页：textbooks/questions/diagnostic/weakness）
- **批次 4**：P5 扩展（2 页：notifications/ai-chat）

### 7.15 ai15（parent-portal）

- **批次 0-2 等待期**：回写 02 文档（F9 GraphQL + 删除"P4 用 REST 后续切 GraphQL"）+ 起草 client query 清单
- **批次 3（P4）**：parent-portal P4（Dashboard + 孩子列表 + 考试/作业/成绩 + 通知偏好 UI 占位）
- **批次 4**：P5 扩展（通知偏好持久化 + 通知中心）

### 7.16 ai16（admin-portal）

- **批次 0-4 等待期**：回写 02 文档（ISSUE-044~048 仲裁结果）
- **批次 5（P6）**：admin-portal（用户/角色管理 + 学校设置 + 组织管理 + 审计日志消费）+ 复用 teacher-bff GraphQL endpoint

---

## 8. 总裁裁决执行检查清单

### 8.1 P0 立即执行（coord）

- [ ] 修正 port-allocation.md §5 iam 行（§1.1）
- [ ] 修正 004 §4.2 gRPC 启用矩阵（§1.2）
- [ ] 修正 004 §16.7.4 P4 清单补 QuestionService（§1.3）
- [ ] 修正 004 §16.7.5 P5 清单删 QuestionService（§1.4）
- [ ] 修订 004 §7.2 Kafka topic 表格（§1.5）
- [ ] 修正 coord-final-decisions.md + ai-work-orchestration.md 相对路径（§1.6）
- [ ] 在 issues.md §0.5 添加总裁裁决索引指针（§1.7）

### 8.2 P1 批次 0 启动前完成（coord + ai13）

- [ ] coord 完成 shared-ts Outbox 工具包设计 + 实现（§2.1，0.4）
- [ ] coord 建立 GraphQL schema 仲裁规范（§2.2）
- [ ] coord 补全 core_edu.proto AttendanceService（§2.5，0.8）
- [ ] coord 补全 analytics.proto 扩展（§2.10，0.11）
- [ ] coord 补全 events.proto AuditEvent（§5.5，0.10）
- [ ] coord 建立 shared-go 包骨架（§2.19，0.14）
- [ ] ai13 建立 packages 骨架（§2.18，0.15）
- [ ] coord 修订 004 §7.2 warning.triggered 注释（§2.11）
- [ ] coord 修正 coord-cross-review.md §6 #14 责任方（§2.5）
- [ ] coord 在 coord-final-decisions.md 补充 I1 双入口策略（§2.16）
- [ ] coord 在 coord-final-decisions.md 补充 F7 服务前缀规则（§5.3）
- [ ] coord 在 coord-final-decisions.md 补充 G14 ADMIN_ 前缀（§5.2）
- [ ] coord 在 coord-final-decisions.md §7.2 补充设计决策记录保留规则（§4.4）

### 8.3 P2 各批次启动前完成（各 AI）

- [ ] ai03 回写 teacher-bff 02（GetTeacherDashboard 命名，§3.4）
- [ ] ai04 回写 student-bff 02（B1/B2/B8，§3.4）
- [ ] ai06 回写 iam 02（I1-I8，§3.4）
- [ ] ai13 回写 teacher-portal 03（删除 REST→GraphQL，§3.4）
- [ ] ai14 回写 student-portal 02（F9/F7，§3.4）
- [ ] ai15 回写 parent-portal 02（F9/删除过渡方案，§3.4）
- [ ] ai02 回写 push-gateway 02（ISSUE-053/055/056/058，§3.4）
- [ ] ai10 回写 msg 02（ISSUE-042/043/012，§3.4）
- [ ] ai16 回写 admin-portal 02（ISSUE-044~048，§3.4）

### 8.4 P3 各阶段执行中持续（各 AI）

- [ ] 各 AI 按工作量分级执行（§3.1-3.3）
- [ ] 各 AI 按跨阶段扩展例外执行（§2.3）
- [ ] 各 AI 按回写义务执行（§3.4）
- [ ] coord 按批次验收检查（§8.1-8.3）

---

## 9. 未解决问题后续处理

### 9.1 待 P6 评估的问题（保留）

以下问题待 P6 阶段评估，不阻塞当前批次：

- **ISSUE-014**：admin-portal 8 个新 Kafka topic（若审计归 iam，仅需 1 个 audit consumer topic，见 §5.5）
- **X3 审计日志归属**：已前置裁决（§5.5），归 iam
- **X6 httpOnly Cookie 迁移**：P6 评估
- **X7 其他 P6+ 事项**：P6 评估

### 9.2 不再追溯的问题

以下问题已被本裁决覆盖，不再单独追溯：

- ISSUE-001 ~ ISSUE-014（coord 初始识别，已被 coord-final-decisions + 本裁决覆盖）
- ISSUE-015 ~ ISSUE-022（ai08 提请，已在 §1/§2 裁决）
- ISSUE-023 ~ ISSUE-025-ai09（ai09 提请，已在 §2.4/2.13/2.14 裁决）
- ISSUE-026 ~ ISSUE-030-ai11（ai11 提请，已在 §2.6/2.10/2.11/4.5 裁决）
- ISSUE-028 ~ ISSUE-031-ai04（ai04 提请，已在 §3.4 裁决）
- ISSUE-032 ~ ISSUE-036+059-ai03（ai03 提请，已在 §2.7/2.8/2.9/3.1 裁决）
- ISSUE-036 ~ ISSUE-041-ai13（ai13 提请，已在 §2.2/2.17/2.18/3.5 裁决）
- ISSUE-031 ~ ISSUE-035-ai15（ai15 提请，已在 §0.3/0.4/3.4 裁决）
- ISSUE-042 ~ ISSUE-043-ai10（ai10 提请，已在 §1.5/2.4 裁决）
- ISSUE-044 ~ ISSUE-048-ai16（ai16 提请，已在 §5.1-5.5 裁决）
- ISSUE-047 ~ ISSUE-052-ai06（ai06 提请，已在 §2.15/2.16/3.2/4.1 裁决）
- ISSUE-053 ~ ISSUE-058-ai02（ai02 提请，已在 §1.5/2.4/4.2/4.3/4.4 裁决）
- ISSUE-063 ~ ISSUE-066-ai14（ai14 提请，已在 §3.4/3.6/4.7 裁决）

---

## 10. 问题索引表（编号冲突映射）

> 由于 issues.md 存在严重编号冲突（见 §0.4），本表提供 `ISSUE-XXX-<提请AI>` 格式的唯一定位。

| ISSUE 编号     | 提请 AI | 主题                                                                           | 裁决章节  |
| -------------- | ------- | ------------------------------------------------------------------------------ | --------- |
| ISSUE-001      | coord   | iam gRPC server 启用时机三处文档冲突                                           | §1.1/1.2  |
| ISSUE-002      | coord   | shared-ts Outbox 工具包未列入 P2 整改清单                                      | §2.1      |
| ISSUE-003      | coord   | 004 §4.2 gRPC 启用阶段矩阵与 B2 裁决冲突                                       | §1.2      |
| ISSUE-004      | coord   | teacher-bff P2 "首次实现即 gRPC 调下游"与下游服务分阶段启用矛盾                | §2.3/2.8  |
| ISSUE-005      | coord   | teacher-bff 跨阶段持续改造与"不分阶段"裁决原则矛盾                             | §0.3/2.3  |
| ISSUE-006      | coord   | student-bff P3 同样存在跨度过大问题                                            | §2.3      |
| ISSUE-007      | coord   | BFF DownstreamClient 抽象回写 teacher-bff 的时间点                             | §3.4      |
| ISSUE-008      | coord   | teacher-portal P2 改造为 urql/apollo 的工作量                                  | §2.17/3.5 |
| ISSUE-009      | coord   | parent-bff P4 依赖 iam.GetChildrenByParent                                     | §3.2      |
| ISSUE-010      | coord   | ai12 ai P5 调 content.QuestionService 的 proto 补全时机冲突                    | §1.3/1.4  |
| ISSUE-011      | coord   | ai12 ai P5 调 core-edu.ExamService.GetExam 的方向修正                          | §7.12     |
| ISSUE-012      | coord   | msg P5 调 push-gateway HTTP /internal/push 的时序协调                          | §4.2      |
| ISSUE-013      | coord   | BFF P2-P4 不订阅 Kafka，家长通知实时性如何保证                                 | §3.7      |
| ISSUE-014      | coord   | admin-portal P6 + 8 个新 Kafka topic 时序                                      | §5.5/9.1  |
| ISSUE-015      | ai08    | port-allocation.md §3 与 §5 关于 iam gRPC 启用阶段冲突                         | §1.1      |
| ISSUE-016      | ai08    | 004 §16.7.4 P4 清单未列 content QuestionService                                | §1.3/1.4  |
| ISSUE-017      | ai08    | 14 个 issues 状态字段未回填 coord 裁决                                         | §0.4/9.2  |
| ISSUE-018      | ai08    | shared-ts Outbox 工具包设计未明确                                              | §2.1      |
| ISSUE-019      | ai08    | GraphQL schema 第一版仲裁机制未明确                                            | §2.2      |
| ISSUE-020      | ai08    | BFF 跨阶段扩展例外的验收标准未明确                                             | §2.3      |
| ISSUE-021      | ai08    | "不分阶段"原则与"批次时间线"表述易混淆                                         | §0.3      |
| ISSUE-022      | ai08    | core-edu AttendanceService proto 补全责任方不明                                | §2.5      |
| ISSUE-023-ai09 | ai09    | content /readyz 检查项与 P5 ES 引入的时序冲突                                  | §2.4      |
| ISSUE-024-ai09 | ai09    | content ES Projector 实现位置未明确                                            | §2.14     |
| ISSUE-025-ai09 | ai09    | Neo4j 知识图谱同步是否属于"派生数据事件"豁免 Outbox                            | §2.13     |
| ISSUE-026-ai11 | ai11    | ClickHouse DDL 目录归属不明                                                    | §2.12     |
| ISSUE-027-ai11 | ai11    | analytics.proto 扩展交付时间不明确                                             | §2.10     |
| ISSUE-028-ai11 | ai11    | warning.triggered topic 登记状态不明确                                         | §2.11     |
| ISSUE-029-ai11 | ai11    | data-ana /readyz 检查 iam gRPC 依赖落地验证                                    | §4.5      |
| ISSUE-030-ai11 | ai11    | 降级模式在 ActionState 信封中的表达方式                                        | §2.6      |
| ISSUE-028-ai04 | ai04    | ai04 02 文档与 coord B1+B2 裁决冲突需回写                                      | §3.4      |
| ISSUE-029-ai04 | ai04    | ai04 P3 启动前置依赖确认                                                       | §4.1/6.1  |
| ISSUE-030-ai04 | ai04    | ai04⟷ai14 student-bff GraphQL schema 第一版仲裁时机                            | §2.2      |
| ISSUE-031-ai04 | ai04    | issues.md ISSUE-024/025 编号冲突                                               | §0.4      |
| ISSUE-031-ai15 | ai15    | coord-final-decisions.md + ai-work-orchestration.md 相对路径错误               | §1.6      |
| ISSUE-032-ai03 | ai03    | B2 裁决 P2 阶段 teacher-bff Dashboard Query Resolver 实现方式                  | §2.8      |
| ISSUE-033-ai03 | ai03    | B4 越权防御校验 teacherId 与班级关系在 P2 阶段实现方式                         | §2.9      |
| ISSUE-034-ai03 | ai03    | G2 /readyz 检查全部下游依赖在 P2 阶段不可行                                    | §2.4      |
| ISSUE-035-ai03 | ai03    | §5.2 接口命名 GetTeacherDashboard 需 ai03 回写 02 文档                         | §3.4      |
| ISSUE-036-ai03 | ai03    | ai03 P2 工作量激增                                                             | §3.1      |
| ISSUE-059      | ai03    | BFF_TEACHER_FORBIDDEN_RESOURCE vs BFF_TEACHER_PERMISSION_DENIED 错误码语义区分 | §2.7      |
| ISSUE-032-ai15 | ai15    | ai15 parent-portal API 契约 REST 假设与 F9 GraphQL 裁决冲突                    | §3.4      |
| ISSUE-033-ai15 | ai15    | ai15 parent-portal 通知偏好 P4 落地与 B7 裁决冲突                              | §3.7      |
| ISSUE-034-ai15 | ai15    | ai15 parent-portal §476 "P4 用 REST 后续切 GraphQL"违反"不分阶段"原则          | §3.4      |
| ISSUE-035-ai15 | ai15    | issues.md 文件结构严重混乱                                                     | §0.4      |
| ISSUE-036-ai13 | ai13    | ai13 03-long-term-architecture.md §6 "REST→GraphQL 演进策略"与 F9 裁决冲突     | §3.4      |
| ISSUE-037-ai13 | ai13    | ai13 与 ai03 的 GraphQL schema 契约协调机制未明确                              | §2.2      |
| ISSUE-038-ai13 | ai13    | MF 暴露 AppShell 整体是否包含 GraphQL client 单例未明确                        | §2.17     |
| ISSUE-039-ai13 | ai13    | F8 ai13 维护 packages 的建立时机与依赖未明确                                   | §2.18     |
| ISSUE-040-ai13 | ai13    | ai13 teacher-portal P2 功能范围与下游服务启用阶段的关系未明确                  | §3.5      |
| ISSUE-041-ai13 | ai13    | 仲裁评估总结                                                                   | §9.2      |
| ISSUE-042-ai10 | ai10    | M2 msg /readyz 强依赖 PushGateway 与 P5 同批次启动时序冲突                     | §2.4      |
| ISSUE-043-ai10 | ai10    | 004 §7.2 表格 edu.notification.events 与 §16.3.2 + G16 裁决不同步              | §1.5      |
| ISSUE-044-ai16 | ai16    | admin-portal BFF 归属不明                                                      | §5.1      |
| ISSUE-045-ai16 | ai16    | admin-portal 错误码前缀缺失                                                    | §5.2      |
| ISSUE-046-ai16 | ai16    | admin-portal 权限点命名与 F7 规范的契合度                                      | §5.3      |
| ISSUE-047-ai16 | ai16    | admin-portal GraphQL 客户端复用 Shell 还是独立引入                             | §2.17/5.4 |
| ISSUE-048-ai16 | ai16    | admin-portal 审计日志与 iam 审计事件归属耦合                                   | §5.5      |
| ISSUE-047-ai06 | ai06    | 批次 0 强阻塞 ai06 iam P2 启动                                                 | §4.1      |
| ISSUE-048-ai06 | ai06    | I7 API 版本化 /iam/v1/* 破坏性变更跨服务协调                                   | §2.15     |
| ISSUE-049-ai06 | ai06    | gRPC 与 REST 双入口实现策略未明确                                              | §2.16     |
| ISSUE-050-ai06 | ai06    | shared-ts Outbox 工具包 API 契约未明确                                         | §2.1      |
| ISSUE-051-ai06 | ai06    | 02-architecture-design.md 与 I1-I8 裁决对齐回写义务                            | §3.4      |
| ISSUE-052-ai06 | ai06    | iam P2 工作量评估与批次时间线不匹配                                            | §3.2      |
| ISSUE-053-ai02 | ai02    | G16 Kafka topic 命名规则与 push-gateway 02 §5.1 消费 topic 不一致              | §1.5      |
| ISSUE-054-ai02 | ai02    | shared-go 共享包建立时机与责任方未在批次规划中明确                             | §2.19     |
| ISSUE-055-ai02 | ai02    | G2 /readyz "全部下游依赖"对 push-gateway Kafka 可选消费的适用性                | §2.4      |
| ISSUE-056-ai02 | ai02    | 02 文档 §5.4/§14.2 仲裁请求章节删除会丢失设计决策追溯                          | §4.4      |
| ISSUE-057-ai02 | ai02    | ISSUE-012 /internal/push 契约仲裁前置与 02 §4.2 已有定义重复                   | §4.2      |
| ISSUE-058-ai02 | ai02    | push-gateway 在线状态 Redis SET 心跳续期与 G2 /readyz 检查的耦合               | §4.3      |
| ISSUE-063-ai14 | ai14    | ai14 student-portal 02 REST 假设与 F9/B1 GraphQL 裁决冲突                      | §3.4      |
| ISSUE-064-ai14 | ai14    | F7 权限点命名风格 ai14 文档与裁决不一致                                        | §3.4      |
| ISSUE-065-ai14 | ai14    | student-portal P3 功能范围受限                                                 | §3.6      |
| ISSUE-066-ai14 | ai14    | student-portal 通知功能推迟到 P5                                               | §3.7      |

---

## 11. 裁决效力

### 11.1 裁决生效

本文件自发布之日起生效，覆盖以下文档的冲突条款：

- `coord-final-decisions.md`（80+ 项裁决保持有效，本文件为其补充 + 澄清）
- `ai-work-orchestration.md`（批次时间线以本文件 §6 为准）
- `issues.md`（所有问题状态转为"总裁已裁决"）

### 11.2 裁决变更

本文件的裁决变更需总裁（用户）再次确认。coord 无权单方面变更。

### 11.3 裁决执行

- **coord**：负责 P0 立即执行项（§8.1）+ P1 批次 0 启动前完成项（§8.2）+ 批次验收
- **各 AI**：负责 P2 各批次启动前完成项（§8.3）+ P3 各阶段执行中持续项（§8.4）

---

**本文件为总裁最终裁决，所有 AI 必须遵守。**
