furniture-3d-system-Wu/furniture-3d-system/docs/项目总览.md

由壹点「产品开发平台」项目总览

最后更新：2026-04-15
当前状态：新平台主线已进入真实业务测试与收口阶段

一句话说明

这个项目现在的真主线不是旧 CAD 装配编辑器，而是：

资产中心 -> 辅助装配 -> 草稿组 -> 正式入库 -> 轻仓库

旧 CAD -> 装配编辑 -> 装配步骤 -> 回放 继续保留，但属于兼容链。 包装相关能力当前挂在草稿组、PreSku 和轻仓库承接口里，不作为独立顶层主链页面。

当前主线目标

1. 资产中心

• 管理板件、组件、五金、包装材料等资产族和规格款
• 承接 CAD ZIP 导入
• 为后续辅助装配提供稳定、干净的资产基础数据

2. 辅助装配

• 用户在工作台选择和组合资产
• 系统按 mountFace / holeGroup / mountPattern 承接准确吸附与 3D 预览
• 通过保存前校验后，再进入草稿组

3. 草稿组

• 承接辅助装配结果
• 汇总 BOM、预览、包装占位和后续承接口

4. 正式入库与轻仓库

• 从草稿组转正式产品和 SKU
• 承接库存、库位、包装成品等业务结果
• 包装结果当前通过 PreSku 与仓库承接口进入后续链路，而不是独立顶层主线阶段

当前模块边界

新平台主链

• /asset-center
• /assisted-assembly
• /draft-groups
• /intake
• /warehouse

旧兼容链

• /products
• /products/[id]
• /products/[id]/assembly
• /products/[id]/skus/[skuId]
• /products/[id]/skus/[skuId]/assembly

当前协作口径

• main 继续由 WuYongJie 收口
• 具体模块职责不再由这份总览固定分配；以当前任务单、交接摘要、已确认协作信息和实际代码现状为准
• 包装与轻仓库仍保留承接口，但不再作为独立顶层主链入口
• 共享接缝改动仍需先对齐影响范围，再决定谁来收口

已落地的基础能力

• 登录、权限、组织架构
• 资产族 / 规格款管理
• CAD ZIP 导入基础链路
• 辅助装配工作台、3D 预览与草稿组承接基础链路
• 草稿组详情与预览承接
• 正式入库和轻仓库基础页
• 旧装配编辑器、装配步骤、回放兼容能力
• 部署、运维、健康检查、备份恢复

当前最需要关注的事

• 资产数据精度是否稳定
• mountFace / holeGroup / mountPattern 这条准确吸附链是否稳定
• 辅助装配和 3D 预览是否真实一致
• 包装结果是否稳定挂到 PreSku / Warehouse 承接口
• 用户系统与权限链路是否完成真人闭环验收
• 前端视觉是否统一，不再混多套旧风格

协作入口

• docs/workflow/团队协作模式.md
• docs/workflow/模块边界说明.md
• docs/workflow/主线同步操作手册.md

其他说明

• 一次性阶段报告、完成报告和旧 UI 方案已经从活跃入口清理，不再作为默认入口。
• 项目内不再维护前端交接单、会话交接或 agent-memory 这类台账文件。
• 历史文档里如果还保留 auto-combinations、自动组合、自动拼装 等旧称呼，统一按历史口径理解，不再代表当前主线页面入口。