Persist image submissions with fixed idempotency keys, leased execution, provider identity, reference snapshots and staged results. Integrate DIY, assisted assembly and non-integrated white-background sessions without holding generation in a browser request. Recover ambiguous submissions through owner-scoped reads and stop a new eight-view batch when restoring an earlier request. Add the NativeImageGenerationJob migration and a dedicated worker to both release entry points. Protect job inputs/results from storage GC. Existing production configuration and business data are not changed by this commit. Validation: 256 focused Jest tests, isolated PostgreSQL migration/lease/transaction checks (8), deployment guard tests (9), type-check, production build and desktop/ mobile browser component scenarios. Live native 2K reference-image request worked; reusing its idempotency key returned the same task. Build uses local placeholders for otherwise absent Drawing System configuration. Three unrelated material tests also fail with the original mainline test file; they remain outside this change. Architecture/visual/root-cause review: passed with warnings. Independent review completed for the integration and shared input/storage paths; worker additionally reviewed by the primary agent. Production merge/deployment requires authorization.
由壹点「产品开发平台」
最后更新:2026-04-15
当前默认主线:资产中心 -> 辅助装配 -> 草稿组 -> 正式入库 -> 轻仓库
这是当前正在持续开发的主项目。
旧 CAD -> 装配编辑 -> 装配步骤 -> 3D 回放 链继续保留,但它属于兼容链,不再代表当前业务主线。
包装结果当前挂在草稿组、PreSku 和轻仓库承接口里,不作为独立顶层页面阶段。
开始前先读
docs/workflow/团队协作模式.mddocs/workflow/模块边界说明.mddocs/workflow/主线同步操作手册.mddocs/README.md
当前项目目标
- 用资产族和规格款作为开品基础数据
- 在辅助装配工作台完成组合、吸附、3D 预览和保存前校验
- 让用户在草稿组里确认组合、预览,并承接包装相关信息
- 再进入正式入库和轻仓库
- 保留旧 CAD 链服务历史数据、兼容导入、装配编辑和回放
快速开始
环境要求
- Node.js 18+
- PostgreSQL
- MinIO / S3 兼容对象存储
- Redis 可选
本地启动
npm install
npm run dev
常用命令
npm run type-check
npm run build
npm test
当前模块分层
新平台主链
/asset-center/assisted-assembly/draft-groups/intake/warehouse
旧兼容链
/products/products/[id]/products/[id]/assembly/products/[id]/skus/[skuId]/products/[id]/skus/[skuId]/assembly
架构硬约束
- 后端固定分层:
Route -> Service -> Repository -> Database - 前端优先复用现有 UI 元组件和平台骨架
- 交付必须做规范审查
- 优先修根因,不接受表面补丁
关键文档
docs/项目总览.mddocs/README.mddocs/部署指南.mddocs/运维指南.md
说明
- 一次性阶段报告、测试报告和旧设计稿已清理,不再占用项目入口。
- 项目内不再维护前端交接单、会话交接或
agent-memory这类台账入口。 - 历史文档里如果还出现
auto-combinations、自动组合、自动拼装,统一按旧称呼理解,不再代表当前主线入口。