BJ_ZTEITS-Developers / parking-cloud-yudao

✨ feat(im): 管理后台新增通话记录页面（列表 + 详情抽屉 + 参与者表），消息预览补 RTC_CALL_START / END 文案

✨ feat(im): 处理 RTC_CALL(NO_ANSWER) 信令；私聊气泡显示「未接听」

✨ feat(im): 处理 RTC_CALL(NO_ANSWER) 信令；私聊气泡显示「未接听」

- 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
```

✨ 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 只留协议枚举与契约值

后端
- createInviteRequestList N+1 → 3 SQL：批量 select IN + update IN + insertBatch；20 人邀请从 40 RTT 降到 3 RTT
- service 不再出现 mybatis：复用记录的 update(null, wrapper) 下沉到 Im{Group,Friend}RequestMapper.update*Reset helper
- inviteGroupMember 入参去重切 hutool：CollUtil.subtractToList(CollUtil.distinct(...), activeMemberUserIds)
- 删除 dead 字段 inviterUserId（GroupRequestApprovedNotification / GroupRequestRejectedNotification）：前端不再消费

前端
- 1505 / 1506 通知改静默：同意走群事件 1509 / 1510 渲染系统提示，拒绝不再打扰
- 修竞态：addByRequestId 校验 handleResult === UNHANDLED，避免 1503 在途时被 1505 / 1506 抢先后又把已处理记录塞回未处理列表
- 修复 dialog 复用记录刷新：watch key 含 inviterUserId / applyContent，同 id 不同内容也触发 refetch；actingId 期间跳过避免本端动作多余 RTT
- 修复 willGoApproval 误报：group.ownerUserId 兜底群主；members 未到位时保守按非审批处理
- unhandledCountMap memoized getter：O(N) 扫一次缓存到 Map，ConversationItem 直读 Map 消除 O(N×M) 重复 filter

- 邀请路径写 addSource=INVITE；群主 / 管理员邀请绕过审批；inviteGroupMember 入参去重
- getGroupRequest 越权校验加成员有效状态判断；新增 list-by-group 接口
- 申请列表按 update_time 倒序，update(null, wrapper) 路径手动刷 updateTime
- addByRequestId 不再 skip 同 id，复用记录刷新并置顶
- GroupRequestListDialog 单群模式订阅 store 增量同步；GroupMemberAddDialog 审批分支文案区分
- ConversationItem 增加 [X 条进群申请] 红字前缀；MessagePanel 顶部胶囊横幅
- 1505 / 1506 通知改静默：同意走群事件渲染系统提示，拒绝不再打扰；清掉 dead inviterUserId 字段