# 🏗️ 双 App 生态项目总览

**AI 驱动的家居装修完整解决方案** - 从设计到购买到记录的全流程管理。

---

## 🎯 项目愿景

构建一个**完整的家居装修生态系统**，解决用户从设计、购买到预算管理的全流程痛点。

```
设计阶段          购买阶段          记录阶段
    ↓                ↓                ↓
【家居装修 App】  【线下购买】    【收据扫描 App】
生成装修方案  →  购买材料     →  扫描收据记录
    ↓                ↓                ↓
材料清单预算      实际花费        价格追踪对比
    └────────────────┬────────────────┘
                     ↓
              数据互通 + 预算对比
              节省 15-20% 装修预算 ✅
```

---

## 📱 两个互补的 App

### 1️⃣ **AI 家居装修 App** 🏠

**定位**：设计工具 + 材料推荐  
**平台**：Web、Android、iOS（Flutter 跨平台）  
**核心功能**：
- AI 生成装修方案（3套，含效果图）
- 智能材料推荐（33+ 种材料，中美双市场）
- 预算估算（根据房间面积自动计算）
- Stability AI 生成真实装修效果图

**技术栈**：
- 前端：Flutter + Dart
- 后端：FastAPI + Python 3.11
- AI 服务：Stability AI API
- 部署：Docker + OCI ARM64

**仓库**：[github.com/davidyin/home-renovation-app](https://github.com/davidyin/home-renovation-app)

---

### 2️⃣ **收据扫描 App** 📸

**定位**：收据管理 + 预算追踪  
**平台**：iOS（SwiftUI 原生）  
**核心功能**：
- Apple Vision Kit OCR（准确率 95%+）
- ChatGPT 3.5 智能分析 line items
- 自动匹配装修材料数据库
- 预算追踪 + 价格历史图表
- 社交分享（微信、微博、Twitter）

**技术栈**：
- 语言：Swift 5.9+
- UI：SwiftUI（iOS 14+）
- OCR：Apple Vision Framework
- AI：ChatGPT 3.5 API
- 存储：Core Data
- 图表：Swift Charts

**仓库**：[github.com/davidyin/receipt-scan-app](https://github.com/davidyin/receipt-scan-app)

---

## 🔗 集成关系

### 数据共享
```
┌───────────────────────────────────────────┐
│           共享材料数据库                  │
│  （33+ 材料，中美双市场）               │
└──────────────┬───────────────────────────┘
               │ REST API
       ┌───────┴────────┐
       ▼                ▼
┌─────────────┐    ┌─────────────┐
│ 装修 App    │    │ 收据 App    │
│ (FastAPI)   │    │ (SwiftUI)   │
└─────────────┘    └─────────────┘
```

### 用户旅程
1. **设计**：在装修 App 生成方案，得到材料清单（预算 $15,780）
2. **购买**：去 Home Depot / 居然之家购买材料
3. **记录**：用收据 App 扫描收据，自动匹配材料
4. **对比**：实际花费 $12,350 vs 预算 $15,780
5. **节省**：$3,430（21.7%）✅

---

## 💰 成本分析

### 月度运营成本
| 项目 | 装修 App | 收据 App | 总计 |
|------|-----------|----------|------|
| **云服务（OCI）** | $0（免费套餐） | - | $0 |
| **AI 效果图（Stability AI）** | $10（2000张） | - | $10 |
| **AI 分析（ChatGPT 3.5）** | - | $1.50（500张） | $1.50 |
| **域名 + CDN（可选）** | $10 | - | $10 |
| **总计** | **$20/月** | **$1.50/月** | **$21.50/月** ✅ |

### 用户价值
- 节省装修预算：**15-20%**（$2,000+ 对于 $15,000 预算）
- ROI：**9,200%**（每月花 $21.5，节省 $2,000+）

---

## 📊 功能对比

| 功能模块 | 装修 App | 收据 App | 集成优势 |
|---------|-----------|----------|----------|
| **AI 方案生成** | ✅ | - | 设计起点 |
| **材料推荐** | ✅ 33+ 种 | ✅ 自动匹配 | 数据互通 ✅ |
| **预算估算** | ✅ | ✅ 实际追踪 | 实时对比 ✅ |
| **OCR 扫描** | - | ✅ Vision Kit | 独家优势 ✅ |
| **价格历史** | - | ✅ Swift Charts | 买在低点 ✅ |
| **社交分享** | - | ✅ 精美卡片 | 口碑传播 ✅ |

---

## 🚀 技术架构

### 装修 App 架构
```
Flutter Web/Android/iOS
        ↓ HTTP/REST
FastAPI 后端 (Port 8000)
    ├── /api/v1/materials (材料列表)
    ├── /api/v1/upload-layout (上传户型图)
    └── /api/v1/generate-plan (生成方案)
            ↓
    Stability AI 服务 (Port 8001)
    └── /inference (生成效果图)
```

### 收据 App 架构
```
SwiftUI (iOS)
    ├── ScannerView (扫描界面)
    ├── ReceiptListView (收据列表)
    ├── MaterialMatchView (材料匹配)
    └── BudgetTrackerView (预算追踪)
            ↓ Vision OCR
    ScannerViewModel
            ↓ ChatGPT API
    APIService → 装修 App 后端 (REST)
```

---

## 🎯 目标用户

### 装修 App
- 🏠 **新房装修业主**（主要）
- 🔨 **旧房翻新用户**（次要）
- 🏢 **小型装修公司**（未来）

### 收据 App
- 💰 **精打细算型用户**（主要）
- 📊 **数据控**（次要）
- 🛒 **频繁购物者**（次要）

---

## 📈 市场分析

### 北美市场（US）
- 市场规模：**$6,200 亿美元**（2024）
- 年增长率：**4.8%**
- 核心玩家：Houzz、Angi、Buildertrend
- **我们的优势**：AI 驱动 + 双 App 生态 + 低成本

### 中国市场（CN）
- 市场规模：**¥3.8 万亿元**（2024）
- 年增长率：**5.5%**
- 核心玩家：土巴兔、齐家网、爱空间
- **我们的优势**：材料数据库本地化 + 价格追踪

---

## 🛣️ 发展路线图

### Phase 1：MVP（当前）✅
- [x] 装修 App MVP（AI 方案 + 材料推荐）
- [x] 收据 App MVP（OCR + 扫描 + 匹配）
- [x] 基础 API 集成

### Phase 2：增强（3 个月）
- [ ] 用户账号系统（JWT）
- [ ] PostgreSQL 数据库
- [ ] 社交分享功能
- [ ] 预算追踪可视化

### Phase 3：生态（6 个月）
- [ ] 两个 App 数据互通
- [ ] iCloud 同步（iOS）
- [ ] 电商联盟佣金（材料购买）
- [ ] 企业版（装修公司）

### Phase 4：扩展（12 个月）
- [ ] Android 版收据 App
- [ ] Web 版收据管理
- [ ] 多用户协作
- [ ] AI 语音助手集成

---

## 📄 项目文档

### 家居装修 App
- [README.md](../home-renovation-app/README.md) - 项目介绍
- [API.md](../home-renovation-app/docs/API.md) - API 接口文档
- [HYBRID_STRATEGY.md](../home-renovation-app/docs/HYBRID_STRATEGY.md) - 混合方案

### 收据扫描 App
- [README.md](../receipt-scan-app/README.md) - App 介绍
- [INTEGRATION.md](../receipt-scan-app/INTEGRATION.md) - 集成指南
- [CLAUDE.md](../receipt-scan-app/ios/CLAUDE.md) - iOS 工程师上下文

---

## 👤 作者

**David Yin**  
- GitHub: [@davidyin](https://github.com/davidyin)
- 项目: [home-renovation-app](https://github.com/davidyin/home-renovation-app) | [receipt-scan-app](https://github.com/davidyin/receipt-scan-app)

---

**🎉 从设计到购买到记录，一站式家居装修管理解决方案！**