# 情绪博物馆 - 测试环境部署指南

## 项目简介

情绪博物馆是一个基于Spring Cloud Alibaba微服务架构的情感AI对话平台，集成了Coze AI平台，提供智能情感分析和对话功能。

## 系统架构

- **前端**: Vue 3 + Ant Design
- **网关**: Spring Cloud Gateway
- **微服务**: 用户服务、AI服务
- **注册中心**: Nacos
- **数据库**: MySQL 8.0
- **缓存**: Redis 7
- **容器化**: Docker + Docker Compose

## 快速部署

### 1. 环境要求

- **操作系统**: Linux/macOS/Windows (推荐 Ubuntu 20.04+)
- **内存**: 最低 4GB，推荐 8GB+
- **磁盘**: 最低 20GB 可用空间
- **网络**: 能够访问互联网

### 2. 一键部署

```bash
# 下载部署包并解压
cd emotion-museum-1.0.0-20250713_111829

# 执行一键部署（包含环境安装、数据库初始化、服务部署）
chmod +x deploy.sh
./deploy.sh
```

### 3. 分步部署

如果需要分步执行，可以使用以下命令：

```bash
# 1. 安装基础环境 (Java, Maven, Node.js, Docker等)
./deploy.sh install-env

# 2. 初始化数据库
./deploy.sh init-db

# 3. 构建应用镜像
./deploy.sh build

# 4. 启动服务
./deploy.sh start
```

### 4. 跳过某些步骤

```bash
# 跳过环境安装（如果已安装）
./deploy.sh --skip-env

# 跳过数据库初始化（如果已初始化）
./deploy.sh --skip-db

# 启用调试模式
./deploy.sh --debug
```

## 服务管理

### 查看服务状态
```bash
./deploy.sh status
```

### 查看服务日志
```bash
# 查看所有服务日志
./deploy.sh logs

# 查看特定服务日志
./deploy.sh logs gateway
./deploy.sh logs user-service
./deploy.sh logs ai-service

# 实时跟踪日志
./deploy.sh logs -f
```

### 重启服务
```bash
# 重启所有服务
./deploy.sh restart

# 重启特定服务
./deploy.sh restart gateway
```

### 停止服务
```bash
./deploy.sh stop
```

### 健康检查
```bash
./deploy.sh health
```

### 备份数据
```bash
./deploy.sh backup
```

### 更新服务
```bash
./deploy.sh update
```

### 清理资源
```bash
./deploy.sh clean
```

## 访问地址

部署完成后，可以通过以下地址访问：

- **前端应用**: http://localhost
- **API网关**: http://localhost:9000
- **Nacos控制台**: http://localhost:8848/nacos (用户名/密码: nacos/nacos)

## 配置说明

### 环境变量配置

主要配置文件：`.env.test`

```bash
# 服务器IP（重要：部署时请修改为实际IP）
SERVER_IP=localhost

# 数据库配置
MYSQL_HOST=localhost
MYSQL_PORT=3306
MYSQL_USERNAME=emotion
MYSQL_PASSWORD=emotion123

# Redis配置
REDIS_HOST=localhost
REDIS_PORT=6379

# Nacos配置
NACOS_SERVER_ADDR=localhost:8848

# COZE AI配置（重要：请配置实际的API Token）
COZE_API_TOKEN=your-coze-api-token
```

### 端口配置

- **前端**: 80 (Nginx)
- **网关**: 9000
- **用户服务**: 9001
- **AI服务**: 9002
- **MySQL**: 3306
- **Redis**: 6379
- **Nacos**: 8848

## 故障排除

### 常见问题

1. **Docker服务未启动**
   ```bash
   sudo systemctl start docker
   sudo systemctl enable docker
   ```

2. **端口被占用**
   ```bash
   # 查看端口占用
   netstat -tlnp | grep :端口号
   
   # 修改 .env.test 文件中的端口配置
   ```

3. **内存不足**
   ```bash
   # 调整JVM内存配置
   export JVM_XMS=256m
   export JVM_XMX=512m
   ```

4. **数据库连接失败**
   ```bash
   # 检查MySQL容器状态
   docker logs emotion-mysql
   
   # 重新初始化数据库
   ./deploy.sh init-db
   ```

### 查看详细日志

```bash
# 查看部署日志
./deploy.sh logs --debug

# 查看容器状态
docker ps -a

# 查看容器日志
docker logs emotion-gateway
docker logs emotion-mysql
docker logs emotion-nacos
```

## 开发调试

### 本地开发模式

```bash
# 启用调试模式
export DEBUG_MODE=true
./deploy.sh --debug
```

### 修改配置

1. 修改后端配置：`backend/config/application-test.yml`
2. 修改前端配置：`frontend/config/test.env.js`
3. 修改环境变量：`.env.test`

### 重新构建

```bash
# 重新构建并部署
./deploy.sh build
./deploy.sh restart
```

## 生产环境部署

1. 修改 `.env.test` 中的配置
2. 配置实际的服务器IP
3. 配置HTTPS证书（如需要）
4. 配置域名解析（如需要）
5. 调整资源限制和性能参数

## 技术支持

如遇到问题，请检查：

1. 系统资源是否充足
2. 网络连接是否正常
3. 配置文件是否正确
4. 日志中的错误信息

更多详细信息请参考：
- `DEPLOY.md` - 详细部署文档
- `QUICK_START.md` - 快速开始指南