# teacher-bff 工作排期

> 负责人：ai03
> 关联：[workline.md](../workline.md)、[coord.md §1 ARB-001](../coord.md)、[contracts/teacher-bff_contract.md](../contracts/teacher-bff_contract.md)
> 模式：全并行（各 AI 一口气完成 P2-P6 全部代码，最后统一集成测试）

---

## §1 总览

teacher-bff 是教学场景域聚合层，全阶段目标：P2 GraphQL schema 第一版 → P3 扩展 exams/homework/grades → P4 学情分析 → P5 通知+SSE → P6 admin 命名空间。

---

## §2 全阶段甘特图（P2-P6，各 AI 自行细化）

```mermaid
gantt
    title ai03 teacher-bff 全阶段排期
    dateFormat YYYY-MM-DD
    axisFormat %m-%d

    section P2 GraphQL 基础
    schema第一版(ARB-001) :crit, a3a, 2026-07-10, 2d
    Yoga endpoint+5 Query Resolver :crit, a3b, after a3a, 3d
    DataLoader+N+1防御 :a3c, after a3b, 1d
    ActionState信封+降级模式B :a3d, after a3b, 1d

    section P3-P6 扩展
    exams/homework/grades Query :a3e, after a3d, 3d
    学情分析+通知+SSE :a3f, after a3e, 4d
    admin命名空间 :a3g, after a3f, 2d
```

> **注意**：以上为 coord 初始规划，ai03 接管后必须自行细化为完整 P2-P6 排期。

---

## §3 详细任务

### P2：GraphQL schema + 5 Query + DataLoader + ActionState

- **负责人**：ai03
- **交付物**：
  - `packages/shared-ts/contracts/graphql/teacher-bff.graphql` — P2 schema
  - Yoga endpoint `POST /graphql`
  - 5 Query：dashboard / viewports / me / classes / class
  - DataLoader + ActionState 信封 + 降级模式 B
- **依赖**：iam gRPC（ai06）+ coord 仲裁 ARB-001
- **验收标准**：5 Query 可用 + ActionState 信封 + depth ≤ 7
- **完整 P3-P6 任务**：⚠️ 由 ai03 自行补充

---

## §4 依赖与就绪信号

- **我依赖**：iam gRPC 50052（ai06）+ core-edu gRPC 50053（ai08，P3+）
- **我的就绪信号**：POST /graphql 可用 + dashboard Query 返回正确数据