# integratews

## 规则（Rules）

# WebSocket联调 - 规范

## 1. WebSocket核心概念
- 通信模式：双向全双工（实时）
- 连接方式：长连接（TCP）
- 消息路由：自定义消息类型
- 适用场景：实时聊天、游戏、行情

## 2. 消息结构规范
使用统一的消息信封格式：
```json
{
  "type": "message_type",
  "payload": { ... },
  "msg_id": "uuid",
  "timestamp": 1714000000
}
```

## 3. 联调规范
- 禁止在未确认消息类型的情况下修改通信逻辑
- 禁止忽略心跳机制
- 禁止忽略重连机制

## 方法（Methods）

# WebSocket联调 - 方法

## 流程概览
```
阅读协议文档 → 检查连接建立 → 检查消息收发 → 编写数据转换 → 逐消息类型验证 → 修复问题
```

## 步骤1：阅读WebSocket协议文档
提取连接地址、认证方式、消息类型定义、通信流程、心跳机制。

## 步骤2：检查连接建立
检查服务端和客户端的WebSocket连接配置是否正确。

## 步骤3：检查消息收发
对比协议文档中的消息类型定义与实际代码，检查Payload格式。

## 步骤4：编写数据转换协议
消息类型命名映射、字段格式转换、心跳消息处理。

## 步骤5：逐消息类型验证
连接验证→发送验证→推送验证→数据转换验证→异常验证。

## 步骤6：修复问题
分类处理连接问题、消息类型不匹配、格式错误、心跳异常、重连问题。

## 技巧（Tips）

# WebSocket联调 - 技巧

## 1. 统一消息信封
设计统一的消息格式包含type和payload，便于路由和扩展。

## 2. 心跳保活
合理设置心跳间隔，确保长连接不因空闲而被断开。

## 3. 断线重连
实现自动重连机制，重连后恢复订阅状态。