furniture-3d-system-Wu/furniture-3d-system
WuYongJie 928a7b37a9 feat(ai): use durable Relay native image tasks
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-10-15 14:55:46 +08:00
..
…
…

由壹点「产品开发平台」

最后更新:2026-04-15
当前默认主线:资产中心 -> 辅助装配 -> 草稿组 -> 正式入库 -> 轻仓库

这是当前正在持续开发的主项目。 旧 CAD -> 装配编辑 -> 装配步骤 -> 3D 回放 链继续保留,但它属于兼容链,不再代表当前业务主线。 包装结果当前挂在草稿组、PreSku 和轻仓库承接口里,不作为独立顶层页面阶段。

开始前先读

  1. docs/workflow/团队协作模式.md
  2. docs/workflow/模块边界说明.md
  3. docs/workflow/主线同步操作手册.md
  4. docs/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/项目总览.md
  • docs/README.md
  • docs/部署指南.md
  • docs/运维指南.md

说明

  • 一次性阶段报告、测试报告和旧设计稿已清理,不再占用项目入口。
  • 项目内不再维护前端交接单、会话交接或 agent-memory 这类台账入口。
  • 历史文档里如果还出现 auto-combinations、自动组合、自动拼装,统一按旧称呼理解,不再代表当前主线入口。