x-server-mobile/docs/PRODUCTION_CONFIG.md

# 生产环境配置文档

**版本**: 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