Merge pull request #246 from skiffer-git/n4

add docs

Author: skiffer-git

docs/guides/solution/migrate.mdx

@@ -3,3 +3,73 @@ title: '如何从IM云服务迁移到OpenIM'
 sidebar_position: 9
 
 ---
+
+
+
+
+在 OpenIM 系统中，一般会涉及以下几个关键数据存储：
+- **用户信息**
+- **好友关系**
+- **黑名单**
+- **群组**
+- **消息**
+- **会话**（通常可通过消息进行重建）
+
+若您正准备从其他 IM 云服务迁移至 **OpenIM**，或需要将低版本的 OpenIM升级到更高版本（如从3.3升级到3.8，本文暂不包括 **Chat** 的迁移），可参照以下操作步骤进行数据导入与同步。
+
+---
+
+## 1. 导入用户
+
+- **接口说明**：[用户注册/导入](../../restapi/apis/userManagement/userRegister)
+- **操作目的**：将外部或历史系统中的用户信息导入到 OpenIM。
+
+---
+
+## 2. 导入好友关系
+
+- **接口说明**：[批量导入好友关系](../../restapi/apis/friendsManagement/importFriend)
+- **操作目的**：将外部或历史系统中的好有关系导入到 OpenIM。
+
+---
+
+## 3. 导入黑名单
+
+- **接口说明**：[添加到黑名单](../../restapi/apis/friendsManagement/addBlackList)
+- **操作目的**：将外部或历史系统中的黑名单导入到 OpenIM。
+
+---
+
+## 4. 创建群组
+
+- **接口说明**：[创建群组](../../restapi/apis/groupManagement/createGroup)
+- **操作目的**：将外部或历史系统中的群组导入到OpenIM。
+
+---
+
+## 5. 导入群成员
+
+- **接口说明**：[邀请用户进群](../../restapi/apis/groupManagement/inviteUserToGroup)
+- **操作目的**：将外部或历史系统中的群成员导入到 OpenIM。
+
+---
+
+## 6. 导入消息
+
+- **接口说明**：[发送消息接口](../../restapi/apis/messageManagement/sendMessage)
+- **重点关注**：`sendTime` 字段
+- **操作目的**：将外部或历史系统中的历史消息导入到 OpenIM。 如果对OpenIM升级，需要自己解析历史消息，再通过此接口导入。
+
+---
+
+## 7. 设置会话状态
+
+- **接口说明**：[设置会话接口](../../restapi/apis/conversationManagement/setConversations)
+- **操作目的**：将外部或历史系统中的会话状态导入到 OpenIM。
+
+---
+
+以上操作完成后，OpenIM 系统就会拥有完整的用户信息、好友关系、黑名单、群组、消息以及会话状态，客户端SDK升级到对应的版本即可完成迁移。
+如需要同步好友备注，群组设置等，调用对应的REST API 即可。
+
+

docs/guides/solution/offlinePush.mdx

@@ -1,4 +1,46 @@
 ---
 title: '如何接入离线推送'
 sidebar_position: 1
----
+---
+
+
+
+在移动端环境中，情况相对复杂：当用户不在线，或者 APP 被杀死、置于后台时，系统可能会挂起进程，导致 **OpenIM 长连接** 无法推送消息。为了确保消息能够及时触达用户，需要额外借助第三方推送服务：
+
+- **中国境内环境** 推荐使用 [个推（GeTui）](https://www.getui.com/)。
+- **中国境外环境** 推荐使用 [Firebase](https://firebase.google.com/)。
+
+
+---
+
+## 服务端与客户端的配置
+
+对于使用 OpenIM 的开发者，需要在 **服务端** 和 **客户端** 进行对应的配置。
+
+### 1. 服务端配置
+
+以 YAML 格式为例，主要说明如何启用离线推送，以及个推（GeTui）、Firebase（FCM） 配置示例。
+
+```yaml
+# 使用 GeTui 进行离线推送，也可选择 fcm 或 jpns；从对应的服务商获取相关配置，并配置。
+
+enable: #选择 getui 或者 fcm
+  getui:
+    pushUrl: https://restapi.getui.com/v2/$appId
+    masterSecret:
+    appKey:
+    intent:
+    channelID:
+    channelName:
+  fcm:
+    # 优先使用文件路径，若 filePath 为空，则使用 URL
+    filePath:   # filePath 相对 config目录的路径，如放在config目录则为./your-fcm-file.json
+    authURL:    # 必须以 https 或 http 开头
+```
+
+### 2. 客户端配置
+
+**Flutter 客户端** 的详细接入方式可参考下方链接：
+[OpenIM Flutter Demo 配置说明](https://github.com/openimsdk/openim-flutter-demo/blob/main/CONFIGKEY.zh-CN.md)
+
+