# Renovation

**Repository Path**: minterest/renovation

## Basic Information

- **Project Name**: Renovation
- **Description**: 自用装修软件
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-01
- **Last Updated**: 2026-04-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🏠 装修设计软件 — renovation

AI 驱动的家庭装修预览工具，支持上传房间照片 + 自然语言描述 → 生成装修效果图。

## 功能特性

- [x] AI 装修效果图生成（MiniMax 云端模型）
- [ ] 2D 户型图画布编辑
- [ ] 3D 全屋预览
- [ ] 局部重绘（只改指定区域）
- [ ] 材质/色彩替换
- [ ] 家具库管理
- [ ] 预算清单
- [ ] 施工进度管理
- [ ] 装修日记
- [ ] 多方案对比
- [ ] AR 预览

## 技术栈

| 层次 | 技术 |
|---|---|
| 前端 | Vue3 + Vite + TypeScript + TailwindCSS |
| 后端 | Python FastAPI |
| AI 绘图 | MiniMax API |
| 数据库 | SQLite（本地轻量） |
| 文件存储 | 本地文件系统 |

## 项目结构

```
renovation/
├── docs/               # 项目文档
├── frontend/           # 前端 Web 应用
│   ├── src/
│   │   ├── components/ # 通用组件
│   │   ├── views/      # 页面视图
│   │   ├── stores/     # 状态管理
│   │   └── utils/      # 工具函数
│   └── package.json
├── backend/            # 后端服务
│   ├── app/
│   │   ├── routes/     # API 路由
│   │   ├── services/   # 业务逻辑
│   │   └── models/     # 数据模型
│   └── requirements.txt
└── README.md
```

## 快速开始

### 前置要求

- Python 3.10+
- Node.js 18+
- MiniMax API Key

### 后端安装

```bash
cd backend
pip install -r requirements.txt
cp .env.example .env
# 编辑 .env 填入 MINIMAX_API_KEY
uvicorn app.main:app --reload --port 8000
```

### 前端安装

```bash
cd frontend
npm install
npm run dev
```

### 访问

- 前端：http://localhost:5173
- 后端 API：http://localhost:8000
- API 文档：http://localhost:8000/docs

## 开发计划

- [ ] Phase 1: AI 核心功能（效果图生成）
- [ ] Phase 2: 前端基础框架 + 户型图画布
- [ ] Phase 3: 家具库 + 材质替换
- [ ] Phase 4: 预算清单 + 进度管理
- [ ] Phase 5: 优化与扩展功能

## 分支规范

- `main` — 主分支，稳定版本
- `feat/*` — 新功能开发
- `fix/*` — Bug 修复
- `docs/*` — 文档更新

## 提交规范

参考 Conventional Commits：
- `feat:` 新功能
- `fix:` 修复
- `docs:` 文档
- `refactor:` 重构
- `test:` 测试
- `chore:` 构建/工具