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.设计规格文档
59 lines
2.8 KiB
Markdown
59 lines
2.8 KiB
Markdown
# classes 问题记录
|
||
|
||
> 负责人：ai07
|
||
> 关联：[coord.md](../coord.md)、[contracts/classes_contract.md](../contracts/classes_contract.md)
|
||
> 规则：AI 遇到问题时在此追加条目，coord 仲裁后更新状态
|
||
|
||
---
|
||
|
||
## 问题列表
|
||
|
||
<!--
|
||
追加条目格式：
|
||
|
||
### ISSUE-[编号]-[AI标识]：[标题]
|
||
|
||
- **提请方**：aiXX
|
||
- **日期**：YYYY-MM-DD
|
||
- **类型**：契约不明确 / 工作量超批 / 前置依赖缺失 / 编号冲突 / 其他
|
||
- **描述**：[详细描述问题]
|
||
- **建议方案**：[AI 的建议]
|
||
- **状态**：待 coord 仲裁 / 已裁决（见 coord.md §X）
|
||
-->
|
||
|
||
### 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 仲裁
|