# 易分宝回收系统 Docker 部署指南

## 项目简介

易分宝现场回收系统是一个再生资源回收小程序，包含：
- **后端 API 服务** (Node.js + Express + SQLite)
- **后台管理端** (静态 HTML)
- **小程序端** (uni-app)

## 快速开始

### 1. 确保已安装 Docker

```bash
# 检查 Docker 版本
docker --version
docker-compose --version
```

### 2. 构建并启动服务

```bash
# 进入项目目录
cd D:\Trae\huishou

# 构建并启动（前台运行）
docker-compose up --build

# 或者后台运行
docker-compose up -d --build

# 查看运行状态
docker-compose ps

# 查看日志
docker-compose logs -f backend
```

### 3. 访问服务

- **后端 API**: http://localhost:4000
- **后台管理端**: http://localhost:4001
  - 用户名: `admin`
  - 密码: `123456`

### 4. 停止服务

```bash
# 停止并移除容器
docker-compose down

# 停止并移除容器和数据卷
docker-compose down -v
```

## 数据持久化

以下目录已配置为持久化存储：
- `./server/data` - SQLite 数据库文件
- `./server/icons` - 上传的图标文件

## 环境变量

| 变量名 | 默认值 | 说明 |
|--------|--------|------|
| NODE_ENV | production | 运行环境 |
| PORT | 3000 | 服务端口 |

## API 接口

### 价格管理
- `GET /api/prices` - 获取所有价格
- `POST /api/prices` - 添加价格
- `PUT /api/prices/:category` - 更新价格
- `DELETE /api/prices/:category` - 删除价格

### 区域管理
- `GET /api/regions/cities` - 获取城市列表
- `GET /api/regions/districts/:city` - 获取区域列表
- `GET /api/regions/stations/:city/:district` - 获取回收站点列表
- `GET /api/regions/users/:station` - 获取用户列表

### 订单管理
- `GET /api/orders` - 获取订单列表
- `POST /api/orders` - 创建订单
- `PUT /api/orders/:orderId` - 更新订单状态

### 统计
- `GET /api/statistics` - 获取统计数据

### 图标
- `GET /api/icons/:filename` - 获取上传的图标

## 项目文件结构

```
huishou/
├── Dockerfile              # Docker 镜像构建文件
├── docker-compose.yml      # Docker Compose 配置
├── .dockerignore           # Docker 构建忽略文件
├── DEPLOY.md              # 部署文档
├── server/                # 后端服务
│   ├── server.js          # 主服务器文件
│   ├── package.json       # 依赖配置
│   ├── data/              # 数据库文件（持久化）
│   └── icons/             # 上传图标（持久化）
├── admin/                 # 后台管理端
│   └── index.html         # 管理页面
└── dist/
    └── build/
        └── mp-weixin/    # 小程序编译产物
```

## 注意事项

1. **小程序端**：需要在微信开发者工具中导入 `dist/build/mp-weixin` 目录运行
2. **端口冲突**：确保 3000 端口未被占用
3. **数据库初始化**：首次启动会自动初始化数据库并插入默认数据

## 故障排查

### 容器启动失败

```bash
# 查看详细日志
docker-compose logs backend

# 进入容器调试
docker exec -it yifenbao-backend sh
```

### 数据库问题

```bash
# 重置数据库（删除数据卷）
docker-compose down -v
docker-compose up -d
```

## 生产环境部署建议

1. 使用 Nginx 反向代理
2. 配置 HTTPS
3. 使用外部数据库（如 MySQL）替代 SQLite
4. 配置定时备份
5. 使用 Docker Swarm 或 Kubernetes 进行编排