# 服务器部署检查清单

## 📋 部署前检查

### 🖥️ 服务器要求
- [ ] **操作系统**: Linux (Ubuntu 18.04+, CentOS 7+, Debian 9+)
- [ ] **CPU**: 2核心以上
- [ ] **内存**: 4GB以上（推荐8GB）
- [ ] **磁盘**: 20GB以上可用空间
- [ ] **网络**: 稳定的互联网连接

### 🔧 软件环境
- [ ] **Docker**: 20.10+ 已安装
- [ ] **Docker Compose**: 1.29+ 已安装
- [ ] **Git**: 已安装（可选）
- [ ] **Curl/Wget**: 已安装

### 🌐 网络配置
- [ ] **端口开放**: 80, 443 已开放
- [ ] **防火墙**: 已配置允许HTTP/HTTPS流量
- [ ] **域名解析**: 域名已正确解析到服务器IP（如有）
- [ ] **SSL证书**: 已准备好SSL证书文件（生产环境）

## 📦 部署包准备

### 📁 文件检查
- [ ] **部署包**: `emotion-museum-1.0.0-20250713_111829.tar.gz` 已下载
- [ ] **校验和**: SHA256校验通过
- [ ] **解压**: 部署包已成功解压
- [ ] **权限**: 脚本文件已设置执行权限

### ⚙️ 配置文件
- [ ] **环境变量**: `.env` 文件已配置
- [ ] **Coze API**: API Token 已设置
- [ ] **数据库密码**: 已修改默认密码
- [ ] **域名配置**: Nginx配置中的域名已更新（生产环境）

## 🚀 部署执行

### 🔄 部署步骤
- [ ] **1. 环境检查**: `./quick-deploy.sh` 环境检查通过
- [ ] **2. Docker安装**: Docker和Docker Compose安装成功
- [ ] **3. 配置生成**: 配置文件生成成功
- [ ] **4. 镜像构建**: Docker镜像构建成功
- [ ] **5. 服务启动**: 所有容器启动成功

### 📊 服务状态
- [ ] **MySQL**: 容器运行正常，数据库连接成功
- [ ] **Redis**: 容器运行正常，缓存服务可用
- [ ] **Nacos**: 容器运行正常，注册中心可访问
- [ ] **Gateway**: 容器运行正常，网关服务可用
- [ ] **AI Service**: 容器运行正常，AI服务可用
- [ ] **User Service**: 容器运行正常，用户服务可用
- [ ] **Frontend**: 容器运行正常，前端应用可访问
- [ ] **Nginx**: 容器运行正常，反向代理工作正常

## ✅ 部署验证

### 🌐 访问测试
- [ ] **前端首页**: http://your-domain.com 可正常访问
- [ ] **API网关**: http://your-domain.com:9000/actuator/health 返回正常
- [ ] **Nacos控制台**: http://your-domain.com:8848/nacos 可正常登录
- [ ] **API文档**: http://your-domain.com:9000/doc.html 可正常访问

### 🔍 功能测试
- [ ] **用户注册**: 新用户注册功能正常
- [ ] **用户登录**: 用户登录功能正常
- [ ] **AI对话**: AI聊天功能正常
- [ ] **数据存储**: 对话记录正常保存
- [ ] **情绪分析**: 情绪分析功能正常

### 📈 性能测试
- [ ] **响应时间**: 页面加载时间 < 3秒
- [ ] **API响应**: API接口响应时间 < 1秒
- [ ] **并发测试**: 支持预期的并发用户数
- [ ] **资源使用**: CPU和内存使用率在合理范围

## 🔒 安全配置

### 🛡️ 基础安全
- [ ] **默认密码**: 所有默认密码已修改
- [ ] **防火墙**: 只开放必要端口
- [ ] **用户权限**: 使用非root用户运行服务
- [ ] **文件权限**: 敏感文件权限设置正确

### 🔐 HTTPS配置（生产环境）
- [ ] **SSL证书**: 证书文件已正确放置
- [ ] **Nginx配置**: HTTPS配置已启用
- [ ] **HTTP重定向**: HTTP自动重定向到HTTPS
- [ ] **证书验证**: SSL证书验证通过

### 🔑 API安全
- [ ] **JWT配置**: JWT密钥已设置
- [ ] **CORS配置**: 跨域配置正确
- [ ] **限流配置**: API限流规则已启用
- [ ] **访问日志**: 访问日志记录正常

## 📊 监控配置

### 📈 服务监控
- [ ] **健康检查**: `./manage.sh health` 所有服务健康
- [ ] **日志收集**: 日志文件正常生成
- [ ] **资源监控**: `./manage.sh monitor` 监控面板正常
- [ ] **告警配置**: 异常告警机制已配置（可选）

### 💾 数据备份
- [ ] **备份脚本**: `./manage.sh backup` 备份功能正常
- [ ] **备份策略**: 定期备份计划已制定
- [ ] **恢复测试**: 数据恢复功能已测试
- [ ] **备份存储**: 备份文件存储位置已确定

## 📝 文档记录

### 📋 部署记录
- [ ] **部署时间**: 记录部署完成时间
- [ ] **版本信息**: 记录部署的版本号
- [ ] **配置信息**: 记录重要配置参数
- [ ] **访问信息**: 记录访问地址和账号

### 📖 运维文档
- [ ] **管理命令**: 熟悉 `./manage.sh` 各项命令
- [ ] **故障排除**: 了解常见问题解决方案
- [ ] **更新流程**: 了解服务更新流程
- [ ] **联系方式**: 记录技术支持联系方式

## 🎯 部署后任务

### 🔧 优化配置
- [ ] **性能调优**: 根据实际负载调整配置
- [ ] **缓存策略**: 优化Redis缓存配置
- [ ] **数据库优化**: 调整MySQL配置参数
- [ ] **网络优化**: 优化Nginx配置

### 📊 监控设置
- [ ] **日志轮转**: 配置日志文件轮转
- [ ] **磁盘清理**: 设置定期清理任务
- [ ] **性能监控**: 配置性能监控工具
- [ ] **告警通知**: 设置异常告警通知

### 🔄 维护计划
- [ ] **更新计划**: 制定定期更新计划
- [ ] **备份计划**: 制定数据备份计划
- [ ] **安全审计**: 制定安全审计计划
- [ ] **容量规划**: 制定容量扩展计划

## ⚠️ 注意事项

### 🚨 重要提醒
1. **Coze API Token**: 必须配置正确的API Token，否则AI功能无法使用
2. **数据库密码**: 生产环境必须修改默认密码
3. **防火墙配置**: 确保只开放必要的端口
4. **SSL证书**: 生产环境强烈建议使用HTTPS
5. **定期备份**: 重要数据必须定期备份

### 📞 紧急联系
- **技术支持**: support@emotion-museum.com
- **紧急热线**: 400-xxx-xxxx
- **在线文档**: https://docs.emotion-museum.com

---

## ✅ 部署完成确认

**部署工程师**: ________________  
**部署时间**: ________________  
**版本号**: emotion-museum-1.0.0-20250713_111829  
**服务器IP**: ________________  
**域名**: ________________  

**签名确认**: ________________  
**日期**: ________________  

---

**🎉 恭喜完成部署！请妥善保存此检查清单作为部署记录。**