# 情绪博物馆 (Emotion Museum)

一个基于Spring Cloud Alibaba微服务架构的情绪管理和AI对话平台。

## 项目概述

情绪博物馆是一个创新的情绪健康管理平台，通过AI对话、情绪记录、数据分析等功能，帮助用户更好地理解和管理自己的情绪状态。

## 🚀 快速部署

### 一键部署（推荐）

```bash
# 克隆项目
git clone <repository-url>
cd EmotionMuseum

# 执行一键部署到阿里云服务器
./deploy-final.sh all
```

### 分步部署

```bash
# 1. 构建项目
./deploy-final.sh build

# 2. 配置服务器环境
./deploy-final.sh env

# 3. 部署数据库和中间件
./deploy-final.sh mysql
./deploy-final.sh redis
./deploy-final.sh nacos

# 4. 部署应用
./deploy-final.sh upload
./deploy-final.sh import-db
./deploy-final.sh deploy

# 5. 配置Web服务器
./deploy-final.sh nginx

# 6. 健康检查
./deploy-final.sh health
```

### 服务管理

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

# 启动/停止/重启服务
./deploy-final.sh start
./deploy-final.sh stop
./deploy-final.sh restart

# 查看服务日志
./deploy-final.sh logs gateway
./deploy-final.sh logs ai
./deploy-final.sh logs user
```

## 📋 部署后访问地址

- **前端应用**: http://47.111.10.27/emotion-museum/
- **API网关**: http://47.111.10.27:9000
- **Nacos控制台**: http://47.111.10.27:8848/nacos

## 🏗️ 技术架构

### 后端技术栈
- **框架**: Spring Boot 3.0.2 + Spring Cloud Alibaba
- **数据库**: MySQL 8.0
- **缓存**: Redis 7.0
- **注册中心**: Nacos 2.2.0
- **网关**: Spring Cloud Gateway
- **ORM**: MyBatis Plus
- **AI集成**: Spring AI + Coze平台

### 前端技术栈
- **框架**: Vue 3 + Vite
- **UI组件**: Ant Design Vue
- **状态管理**: Pinia
- **路由**: Vue Router
- **HTTP客户端**: Axios

## 📁 项目结构

```
EmotionMuseum/
├── backend/                 # 后端微服务
│   ├── emotion-common/      # 公共模块
│   ├── emotion-gateway/     # API网关
│   ├── emotion-user/        # 用户服务
│   ├── emotion-ai/          # AI对话服务
│   ├── emotion-record/      # 情绪记录服务
│   ├── emotion-growth/      # 成长分析服务
│   ├── emotion-explore/     # 地图探索服务
│   ├── emotion-reward/      # 奖励系统服务
│   └── emotion-stats/       # 统计分析服务
├── web/                     # 前端应用
├── deploy-final.sh          # 一键部署脚本
├── docker-compose.prod.yml  # 生产环境Docker配置
├── .env.prod               # 生产环境配置
├── DEPLOYMENT.md           # 详细部署指南
└── README.md               # 项目说明
```

## 🛠️ 本地开发

### 环境要求
- Java 17+
- Maven 3.6+
- Node.js 18+
- MySQL 8.0+
- Redis 7.0+

### 开发环境启动

1. **克隆项目**
```bash
git clone <repository-url>
cd EmotionMuseum
```

2. **启动基础服务**
```bash
# 使用Docker Compose启动MySQL、Redis、Nacos
docker-compose up -d
```

3. **导入数据库**
```bash
# 导入数据库结构和初始数据
mysql -u root -p < backend/mysql_emotion_museum_final.sql
```

4. **构建并启动后端服务**
```bash
cd backend
mvn clean package -DskipTests

# 启动网关
java -jar emotion-gateway/target/emotion-gateway-1.0.0.jar

# 启动用户服务
java -jar emotion-user/target/emotion-user-1.0.0.jar

# 启动AI服务
java -jar emotion-ai/target/emotion-ai-1.0.0.jar
```

5. **启动前端应用**
```bash
cd web
npm install
npm run dev
```

## 🔧 配置说明

### 生产环境配置

主要配置文件：
- `.env.prod` - 生产环境变量配置
- `web/.env.production` - 前端生产环境配置
- `backend/*/src/main/resources/application-prod.yml` - 后端生产配置

### 关键配置项

```bash
# 服务器配置
SERVER_HOST=47.111.10.27
SERVER_USER=root

# 数据库配置
MYSQL_HOST=localhost
MYSQL_PORT=3306
MYSQL_DATABASE=emotion_museum
MYSQL_USERNAME=emotion
MYSQL_PASSWORD=EmotionDB2024!

# Redis配置
REDIS_HOST=localhost
REDIS_PORT=6379

# Nacos配置
NACOS_SERVER_ADDR=localhost:8848

# Coze API配置
COZE_API_TOKEN=your_token_here
```

## 🎯 核心功能

### 1. AI智能对话
- 基于Coze平台的智能对话
- 情绪识别和分析
- 个性化建议和指导

### 2. 情绪记录
- 多维度情绪数据记录
- 情绪变化趋势分析
- 情绪触发因素识别

### 3. 成长分析
- 个人成长轨迹追踪
- 情绪健康评估
- 目标设定和进度跟踪

### 4. 地图探索
- 情绪地图可视化
- 情绪热点区域分析
- 社区情绪趋势

### 5. 奖励系统
- 成就系统
- 积分奖励
- 等级提升

## 📚 API文档

### 用户服务 API
- `POST /api/user/register` - 用户注册
- `POST /api/user/login` - 用户登录
- `GET /api/user/profile` - 获取用户信息

### AI服务 API
- `POST /api/ai/chat` - AI对话
- `GET /api/ai/history` - 对话历史
- `POST /api/ai/analyze` - 情绪分析

### 记录服务 API
- `POST /api/record/emotion` - 记录情绪
- `GET /api/record/list` - 获取记录列表
- `GET /api/record/stats` - 统计数据

## 🔍 故障排除

### 常见问题

1. **服务无法启动**
   ```bash
   # 检查服务状态
   ./deploy-final.sh status
   
   # 查看日志
   ./deploy-final.sh logs <service>
   ```

2. **数据库连接失败**
   ```bash
   # 检查MySQL容器状态
   ssh root@47.111.10.27 "docker ps | grep mysql"
   ```

3. **前端页面无法访问**
   ```bash
   # 检查Nginx状态
   ssh root@47.111.10.27 "systemctl status nginx"
   ```

### 日志位置
- 应用日志: `/data/logs/emotion-museum/*/app.log`
- Nginx日志: `/var/log/nginx/`
- Docker日志: `docker logs <container-name>`

## 🔒 安全建议

1. **修改默认密码**
   - MySQL root密码
   - 应用数据库密码
   - 服务器SSH密钥

2. **配置防火墙**
   ```bash
   # 只开放必要端口
   firewall-cmd --permanent --add-port=80/tcp
   firewall-cmd --permanent --add-port=8848/tcp
   firewall-cmd --reload
   ```

3. **定期备份**
   ```bash
   # 数据库备份
   docker exec emotion-mysql-prod mysqldump -uemotion -pEmotionDB2024! emotion_museum > backup.sql
   ```

## 📈 监控和运维

### 健康检查
```bash
# 执行完整健康检查
./deploy-final.sh health
```

### 性能监控
- Spring Boot Actuator端点
- JVM性能监控
- 数据库连接池监控
- Redis连接监控

## 🤝 贡献指南

1. Fork 项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交代码 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request

### 提交规范
```
feat: 新功能
fix: 修复bug
docs: 文档更新
style: 代码格式调整
refactor: 代码重构
test: 测试相关
chore: 构建过程或辅助工具的变动
```

## 📄 许可证

本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件

## 📞 联系我们

- 项目主页: [GitHub Repository]
- 问题反馈: [Issues]
- 邮箱: support@emotionmuseum.com

---

**注意**: 请确保在生产环境中修改默认密码和敏感配置信息。详细部署说明请参考 [DEPLOYMENT.md](DEPLOYMENT.md)。