feat: 项目初始化及当前全部内容提交

2025-07-15 17:37:50 +08:00
parent ec817067f1
commit e78f192d34
622 changed files with 75174 additions and 383 deletions
@@ -0,0 +1,210 @@
+# 情绪博物馆快速部署指南
+
+## 📦 包内容说明
+
+```
+emotion-museum-1.0.0-YYYYMMDD_HHMMSS/
+├── frontend/                   # 前端构建产物
+│   ├── dist/                  # 静态文件
+│   ├── Dockerfile             # 前端容器配置
+│   └── nginx.conf             # Nginx配置
+├── backend/                   # 后端JAR文件
+│   ├── emotion-gateway-*.jar  # 网关服务
+│   ├── emotion-ai-*.jar       # AI服务
+│   ├── emotion-user-*.jar     # 用户服务
+│   ├── config/                # 配置文件
+│   └── *-Dockerfile           # 各服务容器配置
+├── database/                  # 数据库脚本
+│   └── mysql_emotion_museum_final.sql
+├── deploy/                    # 部署配置
+│   ├── nginx/                 # Nginx配置
+│   ├── mysql/                 # MySQL配置
+│   └── redis/                 # Redis配置
+├── docker-compose.yml         # 开发环境配置
+├── docker-compose.prod.yml    # 生产环境配置
+├── deploy.sh                  # 部署脚本
+├── quick-deploy.sh            # 快速部署脚本
+├── manage.sh                  # 管理脚本
+├── .env                       # 环境变量模板
+├── VERSION.txt                # 版本信息
+├── DEPLOY.md                  # 详细部署文档
+└── QUICK_START.md             # 本文件
+```
+
+## 🚀 快速部署步骤
+
+### 1. 系统要求
+- **操作系统**: Linux/macOS/Windows
+- **Docker**: 20.10+
+- **Docker Compose**: 1.29+
+- **内存**: 最少4GB，推荐8GB+
+- **磁盘**: 最少10GB可用空间
+
+### 2. 部署步骤
+
+#### 方式一：一键部署（推荐）
+```bash
+# 1. 解压部署包
+tar -xzf emotion-museum-*.tar.gz
+cd emotion-museum-*
+
+# 2. 配置环境变量
+cp .env .env.local
+vim .env.local  # 编辑配置，特别是COZE_API_TOKEN
+
+# 3. 一键部署
+chmod +x quick-deploy.sh
+./quick-deploy.sh
+```
+
+#### 方式二：手动部署
+```bash
+# 1. 解压部署包
+tar -xzf emotion-museum-*.tar.gz
+cd emotion-museum-*
+
+# 2. 配置环境变量
+cp .env .env.local
+vim .env.local
+
+# 3. 手动部署
+chmod +x deploy.sh
+./deploy.sh
+```
+
+### 3. 验证部署
+```bash
+# 查看服务状态
+./manage.sh status
+
+# 健康检查
+./manage.sh health
+
+# 查看日志
+./manage.sh logs
+```
+
+### 4. 访问应用
+- **前端应用**: http://localhost
+- **API网关**: http://localhost:9000
+- **Nacos控制台**: http://localhost:8848/nacos (nacos/nacos)
+
+## ⚙️ 配置说明
+
+### 必须配置项
+编辑 `.env` 文件中的以下配置：
+
+```bash
+# Coze API配置（必须）
+COZE_API_TOKEN=your-actual-coze-api-token
+
+# 数据库密码（建议修改）
+MYSQL_ROOT_PASSWORD=your-secure-password
+MYSQL_PASSWORD=your-secure-password
+```
+
+### 可选配置项
+```bash
+# 时区设置
+TZ=Asia/Shanghai
+
+# 域名配置（生产环境）
+DOMAIN_NAME=your-domain.com
+```
+
+## 🛠️ 管理命令
+
+```bash
+# 服务管理
+./manage.sh start          # 启动服务
+./manage.sh stop           # 停止服务
+./manage.sh restart        # 重启服务
+./manage.sh status         # 查看状态
+
+# 日志管理
+./manage.sh logs           # 查看所有日志
+./manage.sh logs -f        # 跟踪日志
+./manage.sh logs -s ai     # 查看AI服务日志
+
+# 数据管理
+./manage.sh backup         # 备份数据
+./manage.sh restore file   # 恢复数据
+
+# 监控
+./manage.sh monitor        # 监控面板
+./manage.sh health         # 健康检查
+```
+
+## 🔧 生产环境配置
+
+### 1. 使用生产配置
+```bash
+# 使用生产环境配置
+docker-compose -f docker-compose.prod.yml up -d
+```
+
+### 2. 配置HTTPS
+```bash
+# 1. 放置SSL证书
+cp your-domain.crt deploy/nginx/ssl/emotion-museum.crt
+cp your-domain.key deploy/nginx/ssl/emotion-museum.key
+
+# 2. 修改Nginx配置
+vim deploy/nginx/conf.d/emotion-museum.conf
+# 取消HTTPS相关配置的注释
+
+# 3. 重启Nginx
+docker-compose restart nginx
+```
+
+### 3. 配置域名
+```bash
+# 修改Nginx配置中的域名
+vim deploy/nginx/conf.d/emotion-museum.conf
+# 将 localhost 替换为您的域名
+```
+
+## 🚨 故障排除
+
+### 常见问题
+
+1. **端口冲突**
+   ```bash
+   # 检查端口占用
+   netstat -tlnp | grep :80
+   netstat -tlnp | grep :3306
+   ```
+
+2. **服务启动失败**
+   ```bash
+   # 查看具体错误
+   ./manage.sh logs -s service-name
+   ```
+
+3. **数据库连接失败**
+   ```bash
+   # 检查数据库状态
+   docker-compose exec mysql mysqladmin ping -u root -p
+   ```
+
+4. **前端访问404**
+   ```bash
+   # 检查Nginx配置
+   docker-compose exec nginx nginx -t
+   ```
+
+### 获取帮助
+- 查看详细文档: `cat DEPLOY.md`
+- 查看版本信息: `cat VERSION.txt`
+- 查看管理命令: `./manage.sh --help`
+
+## 📞 技术支持
+
+如遇到问题，请：
+1. 查看相关服务日志
+2. 检查配置文件
+3. 参考 DEPLOY.md 中的故障排除指南
+4. 联系技术支持团队
+
+---
+**部署完成后，请及时修改默认密码和敏感配置！**