3D 家具安装展示系统 - 工作区

项目状态：Phase 10（生产就绪）功能已落地，进入持续迭代
最后更新：2026-02-07

---

🏗️ 企业级架构与统一视觉标准（强制）

本工作区开发请优先遵循 AGENTS.md 与 furniture-3d-system/.cursor/rules/*.mdc。

企业级架构（后端）

• 统一分层：API Route -> Service -> Repository -> Database
• API Route：接收参数、鉴权、调用 Service、统一响应；不直接写 Prisma 业务查询
• Service：权限校验、业务规则、缓存策略、DTO 组装、事务编排
• Repository：仅做数据访问，不承载业务分支
• 错误与响应：统一 AppError + ErrorCode、handleRequest/jsonSuccess/jsonError
• 架构治理：优先做系统性收口，不做临时补丁式修补

统一视觉标准（前端）

• 优先复用 src/components/ui/ 元组件（Button/Input/Modal/Select/Toast）
• 视觉语言统一为苹果风格，遵循设计令牌，不随意改全局样式
• 品牌色：#008D74（浅色）/ #00B896（深色）
• 字体与字距：font-apple-system + tracking-apple-*

规则来源

• furniture-3d-system/.cursor/rules/core-standards.mdc
• furniture-3d-system/.cursor/rules/backend.mdc
• furniture-3d-system/.cursor/rules/frontend.mdc
• furniture-3d-system/.cursor/rules/checklist.mdc
• furniture-3d-system/docs/设计规范/苹果风格视觉标准.md

---

📂 工作区结构

工作区/
├── furniture-3d-system/     # 🎯 主项目目录
│   ├── src/                 # 源代码
│   ├── docs/                # 项目文档
│   ├── tests/               # 测试文件
│   └── README.md            # 项目说明
│
├── flnxi_sucai/             # 📖 参考项目（只读）
│   └── ...                  # 原始项目文件
│
├── scripts/                 # 🛠️ 部署和维护脚本
│   ├── quick-start.ps1      # 快速启动脚本
│   ├── docker-cleanup.ps1   # Docker 清理脚本
│   └── README.md            # 脚本使用说明
│
├── .kiro/                   # ⚙️ Kiro 配置和规划
│   ├── specs/               # 项目规划文档
│   ├── steering/            # 项目指导文档
│   └── hooks/               # 自动化钩子
│
├── 方案设定/                # 📸 设计方案图片
├── 截图/                    # 📸 项目截图
└── README.md                # 本文档

---

🚀 快速开始

1. 查看项目文档

# 项目主页
cat furniture-3d-system/README.md

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

# 文档导航
cat furniture-3d-system/docs/README.md

2. 启动开发环境

cd furniture-3d-system
npm install
npm run dev

3. 使用快速启动脚本（推荐）

.\scripts\quick-start.ps1

---

📖 主要文档

项目文档

• 项目主页：furniture-3d-system/README.md
• 项目总览：furniture-3d-system/docs/项目总览.md
• 文档导航：furniture-3d-system/docs/README.md
• Phase 10 完成报告：furniture-3d-system/docs/Phase10完成报告.md

规划文档

• 规划文档导航：.kiro/specs/README.md

协作与审查

• 总规则：AGENTS.md
• 工作流卡片：docs/workflow/最简执行卡片.md
• 审查清单：docs/workflow/规范审查清单.md

脚本文档

• 脚本使用说明：scripts/README.md

---

✅ 当前实现概览（基于代码）

• 认证与 RBAC 权限（6 角色）、组织架构（部门/小组）
• 产品与 SKU 管理、协作与可见性、回收站与恢复
• 装配步骤、版本管理与恢复、装配 PDF 生成
• 板件/孔位/五金件体系（匹配、映射、导入）
• 材质库与主题配置（管理员管理）
• 包装方案管理与分享链接
• 操作日志与审计报表
• 生产就绪能力：备份/恢复脚本、健康检查 API 与页面、部署脚本、配置校验

---

📊 代码规模（当前仓库）

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

---

🛠️ 常用命令

开发

cd furniture-3d-system
npm run dev
npm run build
npm test

部署与维护

.\scripts\quick-start.ps1
.\scripts\docker-cleanup.ps1
.\scripts\docker-monitor.ps1

---

📁 目录说明

furniture-3d-system/

主项目目录，包含源代码、文档、测试与部署脚本。

flnxi_sucai/

参考项目目录（只读），不参与构建。

scripts/

工作区级别脚本目录，包含启动与维护脚本。

---

工作区版本：v1.0
最后更新：2026-02-07
维护者：开发团队