183 lines
9.7 KiB
Markdown
183 lines
9.7 KiB
Markdown
# 总工作安排（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) — 上下游对接总矩阵
|