BJ_ZTEITS-Developers / parking-cloud-yudao

- refactor: inviteCall 拆成 createCall（创建新通话）/ inviteCall（追加邀请）；VO `ImRtcCallInviteReqVO`（统一版）→ git mv 为 `ImRtcCallCreateReqVO`；恢复 + git mv `ImRtcCallInviteMoreReqVO` → `ImRtcCallInviteReqVO`（room + inviteeIds）；Controller 端点 `/invite` → `/create` + 新 `/invite`；Service 内部拆 createGroupCall / createPrivateCall / createCall0
- refactor: VO 字段 `scene` → `conversationType`（CreateReqVO / RespVO 同步），与 ImConversationTypeEnum 对齐；`peerUserId` 融合进 `inviteeIds`，私聊必传 1 个对端从集合派生
- feat: 群通话关房语义升级；shouldCloseGroupRoom 改 `(JOINED==0) || (JOINED==1 && INVITING==0)`，1 人独守 + 无后续即关；endSessionIfTerminal 按 call.status 自动推 reason（CREATED→CANCEL 没真接通过 / RUNNING→HANGUP）；rejectCall 群分支末尾触发关房判定，全员拒接自动收敛
- chore: 错误码新增 RTC_GROUP_INVITEE_REQUIRED；validateInviteScene → validateCreateCall；Controller `getLoginUserId` 抽局部变量；resolveDisplayName 抽私有 helper 复用 displayName 派生
- fix: pushCallInviteNotification 加 NPE 防御（getUserMap 缺键时降级为 userId 字符串）；pushCallEndNotification 私聊 receiverId 去掉错误的 senderId 兜底
- chore: handleLiveKitEvent 改回传统 switch 兼容 JDK8；其它若干 Javadoc 补齐 / 注释精简 / typo 修复

✨ feat(im): RTC 通话逻辑收口（displayName / inviteeIds 校验 / 配置化阈值）

- fix: pushCallInviteNotification 给被邀请人签 token 时 displayName 改用 invitee 自己的昵称（原来错用 inviter）
- feat: 群通话发起 / 追加邀请均强制 inviteeIds 非空，对齐微信交互；超量改抛 RTC_GROUP_INVITEE_OVER_LIMIT，不再静默截断
- refactor: ImGroupMemberService 抽 validateMembersInGroup(groupId, ids) 批量校验，inviteMoreCall / resolveInvitees 复用
- refactor: 僵尸通话清理阈值从 ImRtcCallCleanupJob 静态常量挪到 ImProperties.rtc.cleanupZombieThresholdMinutes
- perf: createCall / inviteMoreCall 推 INVITE 前一次 getUserMap 批量拉用户，省 N 次 RPC
- refactor: inviteMoreCall 参与者构造改 CollectionUtils.convertList；trim 多余注释
- docs: 补齐 RTC service / controller / job / LiveKitClient 私有方法的 @param / @return
- chore: 错误码新增 RTC_GROUP_INVITEE_REQUIRED / RTC_GROUP_INVITEE_OVER_LIMIT
```

优化好友状态的获取和验证逻辑，将 ImFriendStateEnum 的使用改为整型状态值，简化了好友关系的校验过程。新增 validateFriend 方法，统一处理好友和黑名单的校验，提升代码可读性和维护性。

ImProperties.message 新增 privateReadEnabled / groupReadEnabled，前端 config.ts 同步镜像。关闭后：
- 后端：read 系列接口（read / getMaxReadMessageId / getGroupReadUserIds）抛业务异常；sendGroupMessage 强制 NO_RECEIPT 忽略 receipt=true；pull 群消息跳过 Redis 已读游标读取与 readCount 补齐
- 前端：气泡已读标签 / 群回执 popover / 「发送回执消息」下拉入口 / admin 列表「状态」「回执」列与详情对应字段按开关隐藏；自动上报 / 冷启动同步对方已读位置 / WS READ & RECEIPT handler 全部按开关短路兜底，避免打到禁用接口
- 单测：补 @Spy ImProperties 修复原本就在的 NPE，加 disabled 分支断言

…块分组），常量类仅保留 AT_USER_ID_ALL 协议契约值

♻️ refactor(im): 抽出 utils/config.ts 集中数值常量，按业务域统一前缀（GROUP_ / MESSAGE_ / FRIEND_ / CONVERSATION_ / FORWARD_），constants.ts 只留协议枚举与契约值

1. ImMessageTypeEnum 新增 GROUP_BANNED(1533) 枚举
2. 新增 GroupBannedNotification 通知 DTO
3. ImGroupMessageSendDTO 新增 ofGroupBanned 工厂方法
4. banGroup / unbanGroup 添加 operatorUserId 参数，
   封禁/解封后广播 GROUP_BANNED 通知到全群成员
5. ImGroupManagerController 传递 getLoginUserId()

1. im_group 新增 muted_all 字段，支持全群禁言 / 取消
2. im_group_member 新增 mute_end_time 字段，支持单成员定时禁言
3. 新增 3 个 API：mute-all、mute-member、cancel-mute-member
4. sendGroupMessage 新增 validateMuteStatus 拦截：全群禁言（群主/管理员豁免）+ 成员禁言
5. 三档分层权限校验：群主可禁言管理员和普通成员，管理员仅可禁言普通成员
6. 新增 4 个 WebSocket 通知类（1512-1515）及对应 DTO 工厂方法
7. Mapper 新增 updateMuteEndTimeNull 方法，解决 MyBatis-Plus 默认跳过 null 字段的问题
8. 新增 5 个错误码（GROUP_MUTED_CANNOT_SEND 等）

…ore/组件/管理后台），为后续 mute 禁言功能腾出词族

…_APPLICATION 重命名 FRIEND_REQUEST_RECEIVED

…，IM Consumer 监听后批量推好友多端）

…k 开 setTransactionAware 让 @CacheEvict 自动事务感知

顺带修复 Bug-Y（删除最后一条消息后孤立时间分隔条）