feat: add agora rtc token join endpoint

docs/third/IM-声网音视频通话接入文档.md

@@ -25,9 +25,9 @@
 | 配置 | 说明 |
 | --- | --- |
 | `agora_app_id` | 声网项目 App ID，客户端初始化 RTC SDK 使用。 |
-| `agora_auth_mode` | 首期填 `app_id`，表示仅 App ID 鉴权。 |
+| `agora_auth_mode` | 当前建议填 `token`，由服务端生成 RTC Token。 |
 | `agora_enabled` | 是否启用声网通话，建议测试环境先设为 `true`。 |
-| `agora_uid_mode` | 建议先用 `int`，客户端加入频道时使用数字 UID。 |
+| `agora_uid_mode` | 建议用 `string`，客户端加入频道时使用 `usr...` 作为声网 user account，避免 BIGINT 用户 ID 超过声网数字 UID 范围。 |
 | `agora_channel_prefix` | 建议 `call_`，最终频道名为 `call_{call_id}`。 |
 
 ### 3.2 正式模式后续准备
@@ -41,7 +41,7 @@
 | `agora_rest_primary_domain` | 国内建议 `https://api.sd-rtn.com`。 |
 | `agora_rest_backup_domain` | 备用建议 `https://api.agora.io`。 |
 
-配置建议继续存放在 HotGo `hg_sys_config` 的 `im_third_party` 分组，IM Server 通过现有 `store.ThirdPartyConfig.Get("im_third_party", ...)` 读取，并受 Kafka `third_party.updated` 或 `cache.third_party.invalidate` 事件清理进程内缓存。
+配置建议存放在 HotGo `hg_sys_config` 的 `im_shengwang` 分组，IM Server 通过 `store.ThirdPartyConfig.Get("im_shengwang", ...)` 读取，并受 Kafka `third_party.updated` 或 `cache.third_party.invalidate` 事件清理进程内缓存。
 
 ## 4. 后端与声网 API 对接
 
@@ -286,7 +286,7 @@ Content-Type: application/json
 
 | 编号 | 场景 | 预期 |
 | --- | --- | --- |
-| AGORA-01 | 后台只配置 `agora_app_id` 和 `agora_auth_mode=app_id` | `/v1/im/calls/rtc-join` 返回 App ID、频道名、UID，Token 为空。 |
+| AGORA-01 | 后台配置 `agora_app_id`、`agora_app_certificate` 和 `agora_auth_mode=token` | `/v1/im/calls/rtc-join` 返回 App ID、频道名、UID 和 RTC Token。 |
 | AGORA-02 | A 发起语音通话，B 接听 | 双方使用同一 `channel_name` 加入声网频道，IM 通话状态变为 `accepted`。 |
 | AGORA-03 | A 发起视频通话，B 接听 | 双方可看到/听到媒体流，IM 通话记录为 `video`。 |
 | AGORA-04 | B 拒接 | IM 替换原通话消息为 `declined`，双方退出声网频道。 |