furniture-3d-system-Wu/furniture-3d-system/docs/会话交接-20260411-包装支线并线与资料库收口.md

2.7 KiB
Raw Permalink Blame History

会话交接-20260411-包装支线并线与资料库收口

本次收了什么

  • 收入 codex/xuxiake-packaging(包装长期分支) 中与 基材(substrate)、花色(finish)、基础资料库(material-library) 相关的改动。
  • 保留当前 辅助装配(assisted assembly) 的 manual assembly(手动拼装) 主链,不让旧的 auto combination(自动组合) 入口回流。
  • 补上 Prisma(数据库模型) 迁移,避免只改 schema.prisma(数据库模型定义) 不带迁移。

已锁定并实际落地的业务口径

  • surfaceOptionId(贴面类型) 允许为空,实木可无贴面类型。
  • 一个 substrate(基材) 可关联多个 finish(花色)。
  • 新增 weightKg(整板重量),语义是整板重量,不等于切割后单块板件重量。
  • 新增 SubstrateFinish(基材-花色关联)。
  • substrate(基材) 编码自动生成 BC-XXXX(基材编码)。
  • finish(花色) 新增 code(编码),自动生成 HS-XXXX(花色编码)。
  • 花色同名判重只看 isActive(启用),停用后允许同名重建。
  • 基础资料库(material-library) 改为右侧详情驱动面板。
  • 默认页签顺序改为 substrate(基材) 在前、finish(花色) 在后。
  • 基材录入支持“选花色 + 临时新建花色”。
  • 批准“临时新建分类”。
  • 花色缩略图 / 贴图上传先作为过渡能力保留,后续再并入完整材质系统。

5 字段唯一约束当前怎么处理

  • 当前主线先沿用包装分支现有实现:
    • 数据库层移除旧的 5 字段唯一约束;
    • 服务层当前按“同 5 字段 + 同一组花色集合”视为重复。
  • 这不是最终定稿。
  • 5 字段唯一约束 的最终业务规则、迁移策略、长期服务层真相,仍由 xuxiake(同事) 继续专题收口。

这里说的 5 字段是:

  • categoryId(材质主类)
  • environmentGradeId(环保等级)
  • thicknessSpecId(厚度规格)
  • surfaceOptionId(贴面类型)
  • systemNameOptionId(系统名称)

本次明确没做

  • 没把 辅助装配(assisted assembly) 改回旧的 auto combination(自动组合) 主流程。
  • 没改 5 字段唯一约束 的最终业务拍板,只把当前分支逻辑透明落档。
  • 没展开完整材质系统,只保留了当前资料库阶段需要的过渡能力。

最小验证

  • type-check(类型检查)
  • asset-center(资产中心) 相关测试
  • material-library(基础资料库) 相关测试
  • assisted-assembly(辅助装配) 相关测试
  • 资料库页最小冒烟与服务器部署验证