# 总工作安排（coord 汇总）

> 维护者：coord（协调 AI）
> 维护规则：各 AI 在 `worklines/[模块名]_workline.md` 写入甘特图工作排期 → coord 汇总到本文件
> 模式：**全并行**（各 AI 一口气完成 P2-P6 全部代码，开发期间用 mock，最后统一集成测试）
> 关联文档：[ai-allocation.md](../ai-allocation.md) v2.0、[coord.md](./coord.md)、[matrix.md](./matrix.md)、[issues/README.md](./README.md)

---

## §1 全并行总览

15 AI 同时启动，各自完成自己模块从 P2 到 P6 的所有代码。开发期间用 mock（见 [matrix.md §7](./matrix.md#§7-全并行开发-mock-策略汇总)），所有模块就绪后统一集成测试。

```
各 AI 独立开发（全并行）         coord 协调
     │                              │
  读 contract.md                  维护 proto 契约
  写 workline.md                  仲裁异议（objections/）
  用 mock 开发                    汇总就绪信号（matrix.md §8）
     │                              │
     ▼                              ▼
  交付：完整代码 + 就绪信号      交付：契约 + 仲裁 + 总矩阵
     │                              │
     └────────► 统一集成测试 ◄──────┘
                   (release/integration)
```

---

## §2 15 AI 总甘特图

```mermaid
gantt
    title Edu 项目 15 AI 全并行时间线
    dateFormat YYYY-MM-DD
    axisFormat %m-%d

    section 网关层
    ai01 api-gateway :a01, 2026-07-10, 10d
    ai02 push-gateway :a02, 2026-07-10, 12d

    section BFF 层
    ai03 teacher-bff :a03, 2026-07-10, 12d
    ai04 student-bff :a04, 2026-07-10, 10d
    ai05 parent-bff :a05, 2026-07-10, 10d

    section 业务服务
    ai06 iam :crit, a06, 2026-07-10, 10d
    ai08 core-edu :crit, a08, 2026-07-10, 12d
    ai09 content :a09, 2026-07-10, 12d
    ai10 msg :a10, 2026-07-10, 10d
    ai11 data-ana :a11, 2026-07-10, 12d
    ai12 ai服务 :a12, 2026-07-10, 10d

    section 前端
    ai13 teacher-portal :crit, a13, 2026-07-10, 12d
    ai14 student-portal :a14, 2026-07-10, 10d
    ai15 parent-portal :a15, 2026-07-10, 10d
    ai16 admin-portal :a16, 2026-07-10, 12d

    section 集成
    统一集成测试 :crit, integ, after a06, 7d
```

**关键路径**（红色 crit）：iam + core-edu + teacher-portal → 统一集成测试
**总时间线**：12-15 天（各 AI 并行）+ 7 天集成测试 = **约 19-22 天**

---

## §3 各 AI 工作清单（汇总）

> 详细排期见各模块 `worklines/[模块名]_workline.md`

### 3.1 网关层

| AI   | 模块         | 全阶段目标                                                  | workline                                         |
| ---- | ------------ | ----------------------------------------------------------- | ------------------------------------------------ |
| ai01 | api-gateway  | 路由 + JWT RS256 验签 + 限流 + 熔断 + CORS + shared-go 接入 | [workline](./worklines/api-gateway_workline.md)  |
| ai02 | push-gateway | HTTP /internal/* + WebSocket/SSE + 多设备会话 + 审计表      | [workline](./worklines/push-gateway_workline.md) |

### 3.2 BFF 层

| AI   | 模块        | 全阶段目标                                                 | workline                                        |
| ---- | ----------- | ---------------------------------------------------------- | ----------------------------------------------- |
| ai03 | teacher-bff | GraphQL schema + DataLoader + ActionState + admin 命名空间 | [workline](./worklines/teacher-bff_workline.md) |
| ai04 | student-bff | GraphQL schema + Dashboard + 考试作答 + 作业提交           | [workline](./worklines/student-bff_workline.md) |
| ai05 | parent-bff  | GraphQL schema + Dashboard + 多子女切换 + 成绩趋势         | [workline](./worklines/parent-bff_workline.md)  |

### 3.3 业务服务

| AI   | 模块     | 全阶段目标                                                                    | workline                                     |
| ---- | -------- | ----------------------------------------------------------------------------- | -------------------------------------------- |
| ai06 | iam      | gRPC 50052 + 12 RPC + RBAC + DataScope + JWT + 审计日志 + Outbox              | [workline](./worklines/iam_workline.md)      |
| ai08 | core-edu | gRPC 50053 + 5 Service 22 RPC + Outbox + 考试/作业/成绩状态机（含原 classes） | [workline](./worklines/core-edu_workline.md) |
| ai09 | content  | gRPC 50054 + 4 Service 18 RPC + Neo4j + ES + Outbox                           | [workline](./worklines/content_workline.md)  |
| ai10 | msg      | gRPC 50056 + 3 Service 13 RPC + Outbox + 多渠道通知                           | [workline](./worklines/msg_workline.md)      |
| ai11 | data-ana | gRPC 50055 + 12 RPC + ClickHouse + CDC 消费                                   | [workline](./worklines/data-ana_workline.md) |
| ai12 | ai       | gRPC 50057 + 6 RPC + ES 检索 + LLM 网关 + 流式响应                            | [workline](./worklines/ai_workline.md)       |

### 3.4 前端

| AI   | 模块           | 全阶段目标                                        | workline                                           |
| ---- | -------------- | ------------------------------------------------- | -------------------------------------------------- |
| ai13 | teacher-portal | MF Shell + GraphQL client + AppShell + 共享组件库 | [workline](./worklines/teacher-portal_workline.md) |
| ai14 | student-portal | MF Remote + 考试作答 + 作业提交                   | [workline](./worklines/student-portal_workline.md) |
| ai15 | parent-portal  | MF Remote + Dashboard + 多子女切换                | [workline](./worklines/parent-portal_workline.md)  |
| ai16 | admin-portal   | MF Remote + 用户管理 + 角色权限 + 审计日志        | [workline](./worklines/admin-portal_workline.md)   |

### 3.5 coord

| 职责       | 内容                                                         |
| ---------- | ------------------------------------------------------------ |
| proto 契约 | 统一管理 packages/shared-proto/                              |
| 仲裁       | 审阅 objections/ → 写入 coord.md                             |
| 总矩阵     | 维护 matrix.md + 就绪信号跟踪                                |
| 共享包     | shared-proto / shared-ts / shared-go / shared-py / ui-tokens |
| 集成       | 合并各模块到 release/integration → 集成测试 → 合并到 main    |

---

## §4 就绪信号跟踪

> 各 AI 完成模块后，在 [matrix.md §8](./matrix.md#§8-就绪信号跟踪表) 更新状态

| 模块           | AI   | 就绪信号                                    | 状态 |
| -------------- | ---- | ------------------------------------------- | ---- |
| iam            | ai06 | gRPC 50052 + 12 RPC + HealthService SERVING | ⏳   |
| api-gateway    | ai01 | :8080 可访问 + JWT 验签                     | ⏳   |
| teacher-bff    | ai03 | POST /graphql + 5 Query                     | ⏳   |
| teacher-portal | ai13 | :4000 可访问 + 登录→Dashboard               | ⏳   |
| core-edu       | ai08 | gRPC 50053 + 22 RPC + HealthService SERVING | ⏳   |
| content        | ai09 | gRPC 50054 + 18 RPC + HealthService SERVING | ⏳   |
| msg            | ai10 | gRPC 50056 + 13 RPC + HealthService SERVING | ⏳   |
| data-ana       | ai11 | gRPC 50055 + 12 RPC + HealthService SERVING | ⏳   |
| ai             | ai12 | gRPC 50057 + 6 RPC + HealthService SERVING  | ⏳   |
| student-bff    | ai04 | POST /graphql + Dashboard Query             | ⏳   |
| parent-bff     | ai05 | POST /graphql + Dashboard Query             | ⏳   |
| push-gateway   | ai02 | :8081 可访问 + /internal/push               | ⏳   |
| student-portal | ai14 | :4001 可访问 + MF Remote                    | ⏳   |
| parent-portal  | ai15 | :4002 可访问 + MF Remote                    | ⏳   |
| admin-portal   | ai16 | :4003 可访问 + MF Remote + admin            | ⏳   |

---

## §5 统一集成测试

> 所有模块就绪后，按 [matrix.md §9](./matrix.md#§9-统一集成测试检查清单) 检查清单进行

### 5.1 集成测试流程

1. 各 AI 在自己分支完成开发 + mock 测试
2. 通知 coord 模块就绪
3. coord 将各分支合并到 `release/integration`
4. coord 运行集成测试检查清单（5 大链路）
5. 集成测试通过后，coord 合并到 `main`

### 5.2 集成测试 5 大链路

| 链路         | 测试内容                                                       |
| ------------ | -------------------------------------------------------------- |
| 认证链路     | 前端登录 → gateway → iam → JWT 签发 → 验签 → x-user-id 注入    |
| GraphQL 链路 | 前端 → BFF GraphQL → 业务服务 gRPC 并行聚合 → ActionState 信封 |
| 事件链路     | core-edu 发布事件 → Kafka → msg 消费 → push-gateway 推送       |
| MF 链路      | teacher-portal Shell 加载 Remote + GraphQL client 单例共享     |
| 推送链路     | msg → push-gateway /internal/push → WebSocket 推送前端         |

---

## §6 历史参考

以下文档为**批次模式时期**（2026-07-09）的历史产物，保留作为追溯凭证：

- [president-final-rulings.md](../president-final-rulings.md) — 总裁最终裁决（70+ 问题逐个裁决 + 6 批次时间线）
- [coord-final-decisions.md](../coord-final-decisions.md) — coord 强制裁决（80+ 项）
- [coord-cross-review.md](../coord-cross-review.md) — coord 交叉审查报告
- [ai-work-orchestration.md](../ai-work-orchestration.md) — 6 批次并行规划

**当前权威文档**：

- [ai-allocation.md](../ai-allocation.md) v2.0 — 15 AI 分配方案 + 全并行模式
- [issues/README.md](./README.md) — AI 协作文档使用指南
- [issues/matrix.md](./matrix.md) — 上下游对接总矩阵
