From 0e2b3d05d0d8d5a379ed13c9b988c860b6296abc Mon Sep 17 00:00:00 2001
From: root <root@DESKTOP-J0QK89R.localdomain>
Date: Sat, 28 Feb 2026 23:01:27 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=E7=94=9F=E4=BA=A7?=
 =?UTF-8?q?=E7=8E=AF=E5=A2=83=E9=85=8D=E7=BD=AE=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/PRODUCTION_CONFIG.md | 202 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 202 insertions(+)
 create mode 100644 docs/PRODUCTION_CONFIG.md

diff --git a/docs/PRODUCTION_CONFIG.md b/docs/PRODUCTION_CONFIG.md
new file mode 100644
index 0000000..713ab26
--- /dev/null
+++ b/docs/PRODUCTION_CONFIG.md
@@ -0,0 +1,202 @@
+# 生产环境配置文档
+
+**版本**: 1.0.0
+**更新时间**: 2026-02-28
+**环境**: 生产环境
+
+---
+
+## 🌐 服务器信息
+
+### SSH 连接
+```
+IP: 45.153.130.80
+用户: root
+密码: jRRAxCG28SMP
+```
+
+### 项目路径
+```
+站点根目录: /opt/1panel/www/sites/uniservice-mobile.hnxinyouhe.com/index
+前端目录: /opt/1panel/www/sites/uniservice-mobile.hnxinyouhe.com/index
+项目代码目录: /opt/1panel/www/sites/uniservice-mobile.hnxinyouhe.com/index/server
+```
+
+---
+
+## 🗄️ 数据库配置
+
+### MySQL
+```
+容器名: 1Panel-mysql-XyxS
+数据库: xserver
+用户名: xserver
+密码: NsNBSQm4b2b7SzhR
+端口: 3306
+```
+
+### 常用命令
+```bash
+# 进入 MySQL 容器
+docker exec -it 1Panel-mysql-XyxS mysql -uxserver -pNsNBSQm4b2b7SzhR xserver
+
+# 备份数据库
+docker exec 1Panel-mysql-XyxS mysqldump -uxserver -pNsNBSQm4b2b7SzhR xserver > backup.sql
+
+# 查看表结构
+docker exec 1Panel-mysql-XyxS mysql -uxserver -pNsNBSQm4b2b7SzhR xserver -e "SHOW TABLES;"
+```
+
+---
+
+## 🔴 Redis 配置
+
+```
+容器名: 1Panel-redis-pxdb
+密码: redis_FTzdM6
+端口: 6379
+```
+
+### 常用命令
+```bash
+# 进入 Redis 容器
+docker exec -it 1Panel-redis-pxdb redis-cli -a redis_FTzdM6
+
+# 查看所有 key
+docker exec 1Panel-redis-pxdb redis-cli -a redis_FTzdM6 KEYS '*'
+
+# 清空缓存（慎用）
+docker exec 1Panel-redis-pxdb redis-cli -a redis_FTzdM6 FLUSHALL
+```
+
+---
+
+## 🐳 Docker 配置
+
+### 网络
+```
+网络名: 1panel-network
+```
+
+### 容器列表
+```bash
+# 查看所有容器
+docker ps
+
+# 查看容器日志
+docker logs <container-name> -f --tail 100
+
+# 重启容器
+docker restart <container-name>
+```
+
+### 后端容器
+```bash
+# 重启后端
+docker restart x-server-backend
+
+# 查看后端日志
+docker logs x-server-backend -f --tail 100
+
+# 进入后端容器
+docker exec -it x-server-backend bash
+```
+
+---
+
+## 🔧 调试命令
+
+### 查看实时日志
+```bash
+# 后端日志
+docker logs x-server-backend -f --tail 50
+
+# 查看消息日志
+docker exec 1Panel-mysql-XyxS mysql -uxserver -pNsNBSQm4b2b7SzhR xserver -e "
+SELECT id, action, order_id, user_id, message_id, status, created_at
+FROM feishu_message_log
+ORDER BY created_at DESC
+LIMIT 20;
+"
+```
+
+### 测试接口
+```bash
+# 查看消息日志（带 debug 参数）
+curl "http://localhost:8787/debug/message-logs?debug=1&limit=50"
+```
+
+---
+
+## 📋 调试计划
+
+### 1. 审批逻辑调试
+- [ ] 创建测试数据
+- [ ] 测试提交申请
+- [ ] 测试单人审批
+- [ ] 测试会签（and_approve）
+- [ ] 测试或签（or_approve）
+- [ ] 测试重复操作防护
+- [ ] 验证状态流转
+
+### 2. 消息逻辑调试
+- [ ] 测试消息发送
+- [ ] 验证 message_id 保存
+- [ ] 测试消息卡片更新（或签/单人）
+- [ ] 验证日志记录
+- [ ] 测试自审批场景
+- [ ] 测试抄送场景
+
+### 3. 集成测试
+- [ ] 完整流程测试
+- [ ] 多用户并发测试
+- [ ] 异常场景测试
+
+---
+
+## 🚨 常见问题处理
+
+### 后端无法启动
+```bash
+# 检查日志
+docker logs x-server-backend --tail 100
+
+# 检查配置
+docker exec x-server-backend cat /app/.env
+
+# 重启服务
+docker restart x-server-backend
+```
+
+### 数据库连接失败
+```bash
+# 测试连接
+docker exec 1Panel-mysql-XyxS mysql -uxserver -pNsNBSQm4b2b7SzhR -e "SELECT 1;"
+
+# 检查网络
+docker network inspect 1panel-network
+```
+
+### 消息发送失败
+```bash
+# 查看日志表
+docker exec 1Panel-mysql-XyxS mysql -uxserver -pNsNBSQm4b2b7SzhR xserver -e "
+SELECT * FROM feishu_message_log
+WHERE status = 'failed'
+ORDER BY created_at DESC
+LIMIT 10;
+"
+```
+
+---
+
+## 📝 维护记录
+
+| 日期 | 操作 | 操作人 | 备注 |
+|------|------|--------|------|
+| 2026-02-28 | 初始化文档 | Claude | 创建配置文档 |
+
+---
+
+**维护人**: 开发团队
+**最后更新**: 2026-02-28