Files
Edu/docs/architecture/issues/workline.md

9.7 KiB
Raw Blame History

总工作安排coord 汇总)

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


§1 全并行总览

15 AI 同时启动,各自完成自己模块从 P2 到 P6 的所有代码。开发期间用 mockmatrix.md §7),所有模块就绪后统一集成测试。

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

§2 15 AI 总甘特图

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

关键路径(红色 critiam + 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
ai02 push-gateway HTTP /internal/* + WebSocket/SSE + 多设备会话 + 审计表 workline

3.2 BFF 层

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

3.3 业务服务

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

3.4 前端

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

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 更新状态

模块 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 检查清单进行

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的历史产物保留作为追溯凭证

当前权威文档