WuYongJie/furniture-3d-system-Wu
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
furniture-3d-system-Wu/docs/项目总览.md
WuYongJie 8d1f86756d chore(协作流程): 收口团队协作规则与主线清理机制 
为新平台主链补齐团队协作模式、模块边界、任务单和提测清单。

新增本地清理脚本，移除误纳入仓库的 npm 缓存日志，并把清理后 type-check 失效的问题收回到脚本层修复。
2026-03-31 10:23:56 +08:00

4.5 KiB
Raw Blame History

家具开品平台 - 项目总览

最后更新：2026-03-31
项目状态：新平台一期骨架已落地，当前进入团队协作收口与业务主链稳定阶段

📊 进度概览（以代码为准）

阶段 状态 说明
Phase 1-8 ✅ 已完成 认证、权限、组织架构、产品/SKU、反馈、日志、报表等核心业务闭环
Phase 9 ✅ 已完成 性能优化与安全测试用例已配置
Phase 10 ✅ 已完成 备份/恢复、健康检查、部署脚本与配置校验
当前迭代 🚧 新平台一期 资产中心、自动组合、草稿组、正式入库、轻仓库骨架已进入主线

当前项目已经从“CAD 导入生成安装步骤工具”升级为“组件资产 -> 组合规划 -> 3D 展示 -> 入库管理”的开品平台。旧 CAD 链继续保留，但不再是新主链。

✅ 已实现功能（基于代码）

1) 新平台一期主链

  • 资产中心：板材、组件、五金、包装材料统一入口
  • 自动组合：按资产族生成候选组合
  • 草稿组：承接多个准 SKU 的预览、包装和展示
  • 正式入库：从草稿组转正式产品 / SKU
  • 轻仓库：查看正式 SKU、包装成品、库存和库位

2) 业务与协作

  • JWT 登录、首次登录流程、RBAC 6 角色
  • 部门/小组/成员管理
  • 产品（SPU）与 SKU 管理、协作者与可见性
  • 回收站与恢复
  • 分享链接与访问统计

3) 3D/装配与工艺

  • 装配步骤管理、装配版本与恢复
  • 安装顺序保存并直接生成步骤（generate-from-order）
  • 装配 PDF 生成
  • 板件管理、孔位检测
  • 五金件库、自动匹配/映射记忆、导入与同步
  • SKU 详情页与装配编辑器共享 3D 板件 / 孔位 / 爆炸 / 回放主链路
  • 装配语义保存、预览与步骤生成优先级已接入旧链

4) 材质与主题

  • 材质库与材质分类
  • 主题配置与激活（管理员）

5) 包装与报表

  • 包装方案与箱体明细
  • 操作日志与审计报表（用户活动、产品变更、SKU 交接、反馈统计）

6) 运维与生产就绪

  • 备份与恢复脚本（数据库/文件/全量）
  • 健康检查 API 与系统健康页面
  • 配置校验、部署脚本、Docker 生产配置

🧭 主要页面与入口

  • /：新平台首页导航
  • /asset-center
  • /auto-combinations
  • /draft-groups
  • /intake
  • /warehouse
  • /products
  • /products/[id]
  • /products/[id]/assembly
  • /products/[id]/skus/[skuId]
  • /products/[id]/skus/[skuId]/assembly
  • /login、/first-login
  • /products/new
  • /users
  • /admin/categories、/admin/materials、/admin/themes
  • /system-health
  • /share（分享访问）
  • /trash
  • /ui-preview、/demo-assembly、/debug-theme

📦 代码规模（当前仓库）

  • API 路由文件：71 个（src/app/api/**/route.ts）
  • Prisma 模型：22 个（prisma/schema.prisma）
  • 测试文件：39 个（tests/）
  • 脚本工具：30 个（scripts/）

🛠️ 技术栈（以代码为准）

  • Next.js 16.1.6 / React 19.2.4 / TypeScript 5
  • Three.js 0.182.0 / R3F 9.5.0 / Drei 10.7.7
  • Prisma 7.3.0 / PostgreSQL
  • Tailwind CSS 4.1.18 / Zustand 5.0.2
  • GSAP 3.12.5 / Zod 4.3.6
  • MinIO / S3 兼容对象存储

🧰 生产就绪能力清单

  • 备份与恢复：scripts/backup-db.*、scripts/backup-files.*、scripts/backup-all.*、scripts/restore.*
  • 健康检查：GET /api/health 与 /system-health
  • 配置校验：scripts/validate-config.*
  • 部署脚本：scripts/deploy.*、scripts/remote-deploy.sh
  • Docker 配置：docker-compose.prod.yml / docker-compose.standard.yml / docker-compose.lightweight.yml

🔎 需要关注/可迭代点

  • 资产精度：新平台后续成败取决于 AssetVariant 的拼装数据是否准确
  • 包装对接：包装结果需要稳定挂到 PreSku，不能重新依附旧产品详情页逻辑
  • 兼容链稳定：旧 CAD 链仍需持续回归，避免影响历史产品使用
  • 团队协作：后续必须按模块边界协作，不能继续多人直接混改同一条主链

📖 相关文档

  • docs/README.md：文档导航
  • docs/workflow/团队协作模式.md：当前协作规则
  • docs/workflow/模块边界说明.md：模块边界
  • docs/部署指南.md：部署说明
  • docs/运维指南.md：备份/恢复/监控
  • docs/Phase10完成报告.md：生产就绪落地说明

维护者：开发团队
文档版本：v2.2