faaaf29f67
1.AI 协作文档体系重构(objections/worklines/contracts+matrix.md) 2.coord 仲裁文档(final-decisions/cross-review/final-rulings/orchestration) 3.各服务 01/02 文档补全 4.共享包初始化(shared-ts/shared-go/hooks/ui-components/ui-tokens) 5.Proto 契约补全 6.004 架构影响地图更新 7.端口分配表 8.设计规格文档
2.8 KiB
2.8 KiB
classes 问题记录
负责人：ai07 关联：coord.md、contracts/classes_contract.md 规则：AI 遇到问题时在此追加条目，coord 仲裁后更新状态
问题列表
ISSUE-001-ai07：P3 合并后 classes 目录保留方式
- 提请方：ai07
- 日期：2026-07-10
- 类型：契约不明确
- 描述：classes 是黄金模板，P3 合并入 core-edu 后，
services/classes/目录是否保留？若保留，是只读对照基准还是改为 shared-ts 模板？若删除，黄金模板对照基准丢失，其他 TS 服务无法对齐。 - 建议方案：保留
services/classes/作为只读对照基准（不删除），core-edu 复制其结构。黄金模板 checklist（02-architecture-design.md §10）由 ai07 持续维护。 - 状态：待 coord 仲裁
ISSUE-002-ai07：cuid2 迁移时机
- 提请方：ai07
- 日期：2026-07-10
- 类型：前置依赖缺失
- 描述：classes 当前用 uuid v4 生成 ID，project_rules 要求 cuid2。迁移时机有两种选择：(A) P1 黄金模板立即迁移；(B) P3 合并入 core-edu 时统一迁移。若选 A，黄金模板先行避免 ai08 继承 uuid 遗留；若选 B，减少一次迁移成本。
- 建议方案：选 A（P1 立即迁移），黄金模板应先行，避免其他服务继承 uuid 遗留。迁移涉及 classes 表主键、proto message 字段类型。
- 状态：待 coord 仲裁
ISSUE-003-ai07：proto ClassService 合并后归属
- 提请方：ai07
- 日期：2026-07-10
- 类型：契约不明确
- 描述：P3 合并入 core-edu 后，
classes.proto的ClassService是否迁移到core_edu.proto？若迁移，破坏 proto 契约稳定性（下游需更新 import）；若保留，core_edu.proto 不会膨胀但需在 core-edu 实现中 import classes.proto。 - 建议方案：保留
classes.proto由 core-edu 实现（选项 B），保持契约稳定性，避免下游 import 路径变更。 - 状态：待 coord 仲裁
ISSUE-004-ai07：node:20-alpine → node:22-alpine 升级时机
- 提请方：ai07
- 日期：2026-07-10
- 类型：其他
- 描述：classes Dockerfile 用
node:20-alpine，project_rules §15.8 镜像预拉清单是node:22-alpine。是 P1 立即升级还是等统一升级？ - 建议方案：P1 立即升级，影响所有 TS 服务 Dockerfile 基准，黄金模板应先行。
- 状态：待 coord 仲裁