# house-decroate-party

**Repository Path**: fireduck_admin/house-decroate-party

## Basic Information

- **Project Name**: house-decroate-party
- **Description**: ooooooooooop龙虾测试项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-09
- **Last Updated**: 2026-03-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 拼好房 (Pin Hao Fang) 🏠

## 🎯 项目定位

一个游戏化的 3D 软装设计工具，用户可以通过：
- 📐 户型图识别或手动输入尺寸构建 3D 空间
- 🖼️ AI 生成 3D 家具物品
- 🎮 拖拽摆放物品，实时预览效果
- 📱 手机端 H5 优先，后迁移小程序

**项目名称含义：** "拼好房" = 拼出好房子，让用户轻松设计和搭配理想家居空间！

## 📅 7 天开发计划

### Day 1: 技术调研
- [x] Three.js vs Babylon.js 对比
- [ ] 户型图识别 AI 方案
- [ ] 3D 物品生成 AI 方案
- [ ] 技术选型报告

### Day 2: 原型开发
- [ ] Three.js 基础场景
- [ ] 简单房间建模
- [ ] 相机控制
- [ ] 原型 Demo

### Day 3: 核心功能
- [ ] 拖拽交互系统
- [ ] 碰撞检测
- [ ] 吸附对齐
- [ ] 物品库管理

### Day 4: 空间构建
- [ ] 手动输入尺寸建模
- [ ] 户型图上传解析
- [ ] 3D 空间生成
- [ ] 墙面/地板/天花板

### Day 5: AI 集成
- [ ] 接入物品生成 AI
- [ ] 图片转 3D 模型
- [ ] 风格迁移
- [ ] AI 功能优化

### Day 6: 渲染优化
- [ ] 光照系统优化
- [ ] 材质系统
- [ ] 性能优化
- [ ] 移动端适配

### Day 7: 测试部署
- [ ] 功能测试
- [ ] 性能测试
- [ ] Bug 修复
- [ ] 部署上线

## 🛠️ 技术栈

- **3D 引擎**: Three.js + React Three Fiber
- **框架**: React 18 + Vite
- **UI**: Ant Design Mobile
- **状态管理**: Zustand
- **部署**: Vercel

## 📁 项目结构

```
soft-decor-3d/
├── src/
│   ├── components/     # React 组件
│   ├── scenes/         # 3D 场景
│   ├── hooks/          # 自定义 Hooks
│   ├── utils/          # 工具函数
│   └── assets/         # 资源文件
├── public/             # 静态资源
└── package.json
```

## 🚀 快速开始

```bash
npm install
npm run dev
```

## 📱 预览

访问：http://localhost:3000

## 📝 进度日志

### Day 1 - 2026-03-09
- ✅ 项目初始化
- ✅ 技术栈确定
- ⏳ 技术调研中...

### Day 2 - 2026-03-10
- ✅ 项目命名：拼好房 (Pin Hao Fang)
- ✅ 核心组件开发完成（App、RoomScene、FurnitureItem、FurnitureLibrary、ControlPanel）
- ✅ 3D 场景功能完成（Canvas、光照、天空盒、相机控制、网格地面）
- ✅ 家具系统完成（6 种家具类型、添加、选择、拖拽变换）
- ✅ 拖拽交互实现（TransformControls）
- ⏳ 原型 Demo 测试中...

---

## 🔗 代码仓库

- **Gitee:** https://gitee.com/fireduck_admin/house-decroate-party.git

---

**目标：打造精品，拒绝垃圾！** ✨