# 项目上下文（长期）

最后更新：2026-02-26

## 项目目标

- 核心：CAD 导入后，在装配编辑器中设置安装顺序并自动生成装配步骤。
- 重点链路：`装配编辑器（3D） -> 安装顺序 -> 自动生成步骤 -> 回放验证`。

## 当前硬约束

- 后端必须遵循：`API Route -> Service -> Repository -> Database`。
- 前端必须优先复用：`src/components/ui/` 元组件。
- 开发阶段策略：批量闭环修复，不以“最小改动”为默认目标。
- 交付前必须完成：规范审查；安全 / 性能 / QA 按任务风险追加。
- 当前总规则入口：根目录 `AGENTS.md` 与 `docs/workflow/*.md`。

## 用户关注的高频回归点

- 孔位高亮位置与爆炸程度同步。
- 折角线显示、文本与板材关联、边界不越出预览区。
- 白膜模式灰度正确（不是改背景色）。
- 板材可选中与高亮稳定。
- 右键菜单层级、位置、可见区域裁剪、材质预览交互。
- 爆炸程度滑块流畅性（无明显卡顿）。
- 中文 UI 文案与样式规范一致。

## 当前默认工作流

- 默认由当前开发流程直接推进任务。
- 开始前先明确：目标、验收标准、适用标准、根因判断。
- 开发后先做最小必要验证，再进入规范审查阶段。
- 规范审查固定检查：企业级架构标准、统一视觉标准、是否为根因修复。
- 遇到安全、性能、关键用户链路时，再补安全 / 性能 / QA 审查。