更新

2026-03-13 14:08:52 +08:00
parent 08dd9cd307
commit eb283f008b
667 changed files with 8425 additions and 27053 deletions
@@ -0,0 +1,308 @@
+# 部署文档索引
+
+## 📋 快速导航
+
+### 🚀 快速开始
+- **[DEPLOYMENT_README.md](DEPLOYMENT_README.md)** - 部署指南总览
+- **[QUICK_REFERENCE.md](QUICK_REFERENCE.md)** - 快速参考卡片
+
+### 🔧 详细指南
+- **[HTTPS_DEPLOYMENT_GUIDE.md](HTTPS_DEPLOYMENT_GUIDE.md)** - HTTPS 配置详细指南
+- **[SOLUTION_SUMMARY.md](SOLUTION_SUMMARY.md)** - 完整解决方案说明
+- **[TROUBLESHOOTING.md](TROUBLESHOOTING.md)** - 故障排查指南
+
+### 📁 配置文件
+- **[nginx-production.conf](nginx-production.conf)** - Nginx 生产环境配置
+- **[setup-https.sh](setup-https.sh)** - 自动化 HTTPS 配置脚本
+- **[diagnose.js](diagnose.js)** - 浏览器诊断脚本
+
+---
+
+## 📖 文档说明
+
+### DEPLOYMENT_README.md
+**用途**: 部署指南总览
+**内容**:
+- 快速开始步骤
+- 部署流程
+- 常见问题
+- 性能优化
+- 监控和维护
+
+**何时阅读**: 第一次部署时
+
+### QUICK_REFERENCE.md
+**用途**: 快速参考卡片
+**内容**:
+- 常用命令
+- 文件位置
+- 常见问题速查
+- 配置检查清单
+- 故障排查流程
+
+**何时阅读**: 需要快速查找命令或信息时
+
+### HTTPS_DEPLOYMENT_GUIDE.md
+**用途**: HTTPS 配置详细指南
+**内容**:
+- 问题说明
+- Let's Encrypt 配置步骤
+- 证书管理
+- 常见问题
+- 安全建议
+
+**何时阅读**: 需要配置 HTTPS 时
+
+### SOLUTION_SUMMARY.md
+**用途**: 完整解决方案说明
+**内容**:
+- 问题分析
+- 实施的解决方案
+- 部署步骤
+- 验证方法
+- 性能指标
+
+**何时阅读**: 需要了解完整解决方案时
+
+### TROUBLESHOOTING.md
+**用途**: 故障排查指南
+**内容**:
+- 常见问题和解决方案
+- 调试技巧
+- 错误代码说明
+- 获取帮助方法
+
+**何时阅读**: 遇到问题时
+
+---
+
+## 🛠️ 配置文件说明
+
+### nginx-production.conf
+**用途**: Nginx 生产环境配置
+**包含**:
+- HTTPS 配置
+- SSL 证书设置
+- 安全头部
+- 静态文件缓存
+- API 代理
+- 日志配置
+
+**使用方法**:
+```bash
+sudo cp nginx-production.conf /etc/nginx/sites-available/admin
+sudo nano /etc/nginx/sites-available/admin  # 修改路径和端口
+sudo ln -s /etc/nginx/sites-available/admin /etc/nginx/sites-enabled/
+sudo nginx -t
+sudo systemctl restart nginx
+```
+
+### setup-https.sh
+**用途**: 自动化 HTTPS 配置脚本
+**功能**:
+- 检查域名解析
+- 安装 Certbot
+- 获取 SSL 证书
+- 配置 Nginx
+- 设置自动续期
+
+**使用方法**:
+```bash
+sudo bash setup-https.sh
+```
+
+### diagnose.js
+**用途**: 浏览器诊断脚本
+**检查项**:
+- 协议检查
+- 浏览器兼容性
+- WebRTC 支持
+- 设备权限
+- 网络连接
+- TUIKit 状态
+- 存储可用性
+- API 连接
+- 性能指标
+- 内存使用
+
+**使用方法**:
+1. 打开浏览器开发者工具 (F12)
+2. 切换到 Console 标签页
+3. 复制并粘贴 diagnose.js 中的代码
+4. 按 Enter 运行
+
+---
+
+## 📊 部署流程图
+
+```
+开始
+  ↓
+1. 打包应用 (npm run build)
+  ↓
+2. 配置 HTTPS
+  ├─ 自动: sudo bash setup-https.sh
+  └─ 手动: 参考 HTTPS_DEPLOYMENT_GUIDE.md
+  ↓
+3. 配置 Nginx
+  ├─ 复制 nginx-production.conf
+  ├─ 修改路径和端口
+  └─ 测试配置 (sudo nginx -t)
+  ↓
+4. 重启 Nginx
+  └─ sudo systemctl restart nginx
+  ↓
+5. 验证部署
+  ├─ 检查 HTTPS 连接
+  ├─ 检查证书
+  ├─ 在浏览器中访问
+  └─ 运行诊断脚本
+  ↓
+6. 监控和维护
+  ├─ 查看日志
+  ├─ 监控性能
+  └─ 定期更新
+  ↓
+完成
+```
+
+---
+
+## ✅ 部署检查清单
+
+### 部署前
+- [ ] 代码已提交
+- [ ] 依赖已安装
+- [ ] 环境变量已配置
+- [ ] 打包测试通过
+
+### 部署中
+- [ ] 应用已打包
+- [ ] HTTPS 已配置
+- [ ] Nginx 已配置
+- [ ] 配置测试通过
+- [ ] 服务已重启
+
+### 部署后
+- [ ] HTTPS 访问正常
+- [ ] 页面加载正常
+- [ ] 控制台无错误
+- [ ] API 连接正常
+- [ ] WebRTC 功能正常
+- [ ] 证书自动续期已配置
+- [ ] 日志监控已启用
+
+---
+
+## 🔍 常见问题速查
+
+| 问题 | 文档 | 命令 |
+|------|------|------|
+| 页面打不开 | TROUBLESHOOTING.md | `sudo nginx -t` |
+| TUIKit 错误 | SOLUTION_SUMMARY.md | 运行 diagnose.js |
+| 证书过期 | HTTPS_DEPLOYMENT_GUIDE.md | `sudo certbot renew` |
+| 性能问题 | DEPLOYMENT_README.md | `top`, `free -h` |
+| 网络连接 | TROUBLESHOOTING.md | `curl -I https://...` |
+
+---
+
+## 📞 获取帮助
+
+### 第一步：自助诊断
+1. 查看 QUICK_REFERENCE.md 快速查找
+2. 运行 diagnose.js 诊断脚本
+3. 查看 TROUBLESHOOTING.md 故障排查
+
+### 第二步：查看详细文档
+1. 根据问题类型选择相应文档
+2. 按照步骤操作
+3. 查看常见问题部分
+
+### 第三步：检查日志
+```bash
+# Nginx 错误日志
+sudo tail -f /var/log/nginx/admin_https_error.log
+
+# 应用日志
+tail -f /path/to/your/app.log
+
+# 浏览器控制台
+F12 → Console
+```
+
+### 第四步：联系支持
+- 提供完整的错误信息
+- 提供诊断脚本输出
+- 提供系统和浏览器信息
+- 提供日志文件
+
+---
+
+## 📚 相关文档
+
+### 应用功能文档
+- [README.md](README.md) - 项目说明
+- [README_VIDEO_CALL.md](README_VIDEO_CALL.md) - 视频通话功能
+- [GROUP_VIDEO_CALL.md](GROUP_VIDEO_CALL.md) - 群组通话
+
+### 功能实现文档
+- [APPOINTMENT_SYSTEM.md](APPOINTMENT_SYSTEM.md) - 预约系统
+- [ORDER_SYSTEM_GUIDE.md](ORDER_SYSTEM_GUIDE.md) - 订单系统
+- [PAYMENT_GATEWAY_INTEGRATION.md](PAYMENT_GATEWAY_INTEGRATION.md) - 支付集成
+
+### 升级和迁移
+- [UPGRADE_STEPS.md](UPGRADE_STEPS.md) - 升级步骤
+- [PAYMENT_MIGRATION.md](PAYMENT_MIGRATION.md) - 支付迁移
+- [WEB_UIKIT_UPGRADE_GUIDE.md](WEB_UIKIT_UPGRADE_GUIDE.md) - UIKit 升级
+
+---
+
+## 🎯 按场景选择文档
+
+### 场景 1: 第一次部署
+1. 阅读 DEPLOYMENT_README.md
+2. 运行 setup-https.sh
+3. 访问应用验证
+
+### 场景 2: 遇到问题
+1. 运行 diagnose.js
+2. 查看 TROUBLESHOOTING.md
+3. 检查相应日志
+
+### 场景 3: 需要快速查找
+1. 使用 QUICK_REFERENCE.md
+2. 查找相应命令或信息
+
+### 场景 4: 需要详细了解
+1. 阅读 SOLUTION_SUMMARY.md
+2. 查看 HTTPS_DEPLOYMENT_GUIDE.md
+3. 参考 DEPLOYMENT_README.md
+
+### 场景 5: 性能优化
+1. 查看 DEPLOYMENT_README.md 性能优化部分
+2. 运行 diagnose.js 检查性能指标
+3. 实施优化措施
+
+---
+
+## 📝 文档维护
+
+### 最后更新
+- **日期**: 2024-03-12
+- **版本**: 1.0.0
+- **状态**: ✓ 生产就绪
+
+### 更新日志
+- v1.0.0: 初始版本，包含完整的部署指南和故障排查文档
+
+### 反馈和改进
+- 如有问题或建议，请提交 Issue
+- 如有改进建议，请提交 Pull Request
+
+---
+
+**开始部署**: [DEPLOYMENT_README.md](DEPLOYMENT_README.md)
+
+**快速查找**: [QUICK_REFERENCE.md](QUICK_REFERENCE.md)
+
+**遇到问题**: [TROUBLESHOOTING.md](TROUBLESHOOTING.md)