# 待办与阻塞（长期）

最后更新：2026-03-11

## P0（高优先级）

- 问题：SKU 详情页与 SKU 装配页“部分板材不可选/折角线贴合异常”已完成代码修复，但仍需基于真实模型做人工终验（自动化仅验证到开关/基础交互）。
  - 责任角色：QA 测试员 / 3D 工程师 / 前端工程师
  - 下一步：在 `3000` 端口对固定 SKU 执行全量点选回归（非抽样），逐板件验证：可选中、安装顺序可入列、折角线贴边。
  - 证据：`src/app/products/[id]/skus/[skuId]/SKUDetailClient.workspace.tsx`、`src/components/3d/model-viewer-pick-tolerance.ts`、`output/playwright/sku-regression-progress-2026-03-05T02-36-59-091Z/report.json`
  - 状态：处理中

- 问题：`HoleOverlay2D` 在 `requestAnimationFrame` 内仍有较重计算（每帧分组聚合与多次对象创建），孔位多时存在掉帧风险。
  - 责任角色：3D 工程师
  - 下一步：抽离“静态分组/标签聚合”到 `useMemo`，绘制环节仅做投影与绘制；减少帧内临时对象创建。
  - 证据：`src/components/3d/HoleOverlay2D.tsx`
  - 状态：待处理

## P1（中优先级）

- 问题：`generate-from-order` 仍缺“接口限频 + 幂等键”治理，网络抖动下存在重复生成与写放大风险。
  - 责任角色：后端工程师
  - 下一步：为该路由增加用户维度限频，并设计幂等键（同一次提交在短窗口只执行一次）。
  - 证据：`src/app/api/products/[id]/assembly/generate-from-order/route.ts`
  - 状态：待处理

- 问题：当前补偿回滚仅覆盖安装顺序，生成前创建版本的写放大仍需评估（失败时可能产生额外版本记录）。
  - 责任角色：后端工程师
  - 下一步：评估“版本创建时机后移”或“失败标记版本”策略，避免无效版本增长。
  - 证据：`src/server/services/assembly.service.ts`
  - 状态：待处理

- 问题：安装顺序单接口 `generate-from-order` 已接入，仍需联调确认异常场景与 `warnings` 展示策略。
  - 责任角色：前端工程师 / 后端工程师
  - 下一步：用真实产品执行“点选顺序 -> 保存并生成”，确认失败提示与步骤回填一致；评估是否补充 `warnings` UI。
  - 证据：`src/app/products/[id]/assembly/AssemblyEditorWorkspace.tsx`
  - 状态：待处理

- 问题：`AssemblyEditorWorkspace` 仍有历史视觉 token 不统一（如部分 `bg-white/text-white`）。
  - 责任角色：前端工程师
  - 下一步：按页面分区批量替换为语义 token，不改业务逻辑
  - 证据：`src/app/products/[id]/assembly/AssemblyEditorWorkspace.tsx`
  - 状态：待处理

- 问题：`AssemblyEditorWorkspace` 仍存在组件内直写 `fetch` 的历史实现，未完全收口到 hooks/数据层。
  - 责任角色：前端工程师
  - 下一步：按接口链路分批迁移到 `src/hooks/api`，先迁移装配页高频接口，保持行为不变。
  - 证据：`src/app/products/[id]/assembly/AssemblyEditorWorkspace.tsx`
  - 状态：待处理

## 阻塞项

> 暂无

## 记录模板

- 问题：
- 责任角色：
- 下一步：
- 证据（文件/命令）：
- 状态：待处理 / 处理中 / 已完成 / 阻塞