主题
IM 即时通讯(预留模块)
IM-00 | Maven
pmforge-module-im| 状态 ⏸ 预留(已纳入构建,未接入运行时)
单聊、群聊、消息、已读回执与会话管理;system 里曾为它留过免鉴权的名片与好友接口。
1. 模块概览
| 项 | 值 |
|---|---|
| Maven 模块 | pmforge-module-im |
| 控制器 | 30 |
| 接口 | 126 |
| 唯一权限点 | 34 |
| 数据对象(DO) | 17 |
| 已拆功能点 | 未逐条拆分 |
| 需求原件 | 09-01-IM即时通讯 |
2. 能力清单
本模块尚未逐条拆分功能点,能力范围见需求原件;规模以接口数与数据对象为准。
3. 控制器与接口
| Controller | 路径前缀 | 接口 | 权限点 | 代码位置 |
|---|---|---|---|---|
| ImGroupController | /im/group | 16 | 0 | modules/im/src/main/java/com/pmforge/module/im/controller/admin/group/ImGroupController.java#L48 |
| ImRtcCallController | /im/rtc | 9 | 0 | modules/im/src/main/java/com/pmforge/module/im/controller/admin/rtc/ImRtcCallController.java#L41 |
| ImFriendController | /im/friend | 7 | 0 | modules/im/src/main/java/com/pmforge/module/im/controller/admin/friend/ImFriendController.java#L48 |
| ImGroupRequestController | /im/group-request | 7 | 0 | modules/im/src/main/java/com/pmforge/module/im/controller/admin/group/ImGroupRequestController.java#L61 |
| ImChannelManagerController | /im/manager/channel | 6 | 4 | modules/im/src/main/java/com/pmforge/module/im/controller/admin/manager/channel/ImChannelManagerController.java#L34 |
| ImChannelMaterialManagerController | /im/manager/channel-material | 6 | 4 | modules/im/src/main/java/com/pmforge/module/im/controller/admin/manager/channel/ImChannelMaterialManagerController.java#L42 |
| ImFacePackItemManagerController | /im/manager/face-pack-item | 6 | 4 | modules/im/src/main/java/com/pmforge/module/im/controller/admin/manager/face/ImFacePackItemManagerController.java#L34 |
| ImFacePackManagerController | /im/manager/face-pack | 6 | 4 | modules/im/src/main/java/com/pmforge/module/im/controller/admin/manager/face/ImFacePackManagerController.java#L34 |
| ImFriendRequestController | /im/friend-request | 6 | 0 | modules/im/src/main/java/com/pmforge/module/im/controller/admin/friend/ImFriendRequestController.java#L55 |
| ImGroupMessageController | /im/message/group | 6 | 0 | modules/im/src/main/java/com/pmforge/module/im/controller/admin/message/ImGroupMessageController.java#L33 |
| ImPrivateMessageController | /im/message/private | 6 | 0 | modules/im/src/main/java/com/pmforge/module/im/controller/admin/message/ImPrivateMessageController.java#L33 |
| ImSensitiveWordManagerController | /im/manager/sensitive-word | 6 | 4 | modules/im/src/main/java/com/pmforge/module/im/controller/admin/manager/sensitiveword/ImSensitiveWordManagerController.java#L43 |
| … | 其余 18 个 | 见接口索引 |
4. 数据对象
| 表 | DO | 字段数 |
|---|---|---|
im_channel | ImChannelDO | 0 |
im_channel_material | ImChannelMaterialDO | 0 |
im_channel_message | ImChannelMessageDO | 0 |
im_conversation_read | ImConversationReadDO | 0 |
im_face_pack | ImFacePackDO | 0 |
im_face_pack_item | ImFacePackItemDO | 0 |
im_face_user_item | ImFaceUserItemDO | 0 |
im_friend | ImFriendDO | 0 |
im_friend_request | ImFriendRequestDO | 0 |
im_group | ImGroupDO | 0 |
im_group_member | ImGroupMemberDO | 0 |
im_group_message | ImGroupMessageDO | 0 |
im_group_request | ImGroupRequestDO | 0 |
im_private_message | ImPrivateMessageDO | 0 |
im_rtc_call | ImRtcCallDO | 0 |
| … | 其余 2 个 DO |
主库脚本
sql/mysql/pmforge.sql只覆盖 system 与 infra,本模块的表结构以 DO 为准;启用前需自备 DDL(部分模块有测试脚本src/test/resources/sql/create_tables.sql)。
5. 启用前提
依赖:无强依赖;测试 DDL 在 modules/im/src/test/resources/sql/create_tables.sql。
- 根 pom 取消注释
- server 加依赖
- 用测试 DDL 起库
- 配置 WebSocket 发送通道(
pmforge.websocket.sender-type) - 补
im:*菜单与权限点
6. 风险与注意
- 消息可达性依赖 WebSocket 通道,本地默认
sender-type=local,集群要切 redis/rabbitmq
7. 关联
- 相关页面:MOD-RSV-00
- 相关页面:PAT-06
- 模块手册:/modules/reserved/
- 接口索引:/code/api/im