!367 feat(im): 同步 im 的迁移

Merge pull request !367 from 芋道源码/migration

apps/web-antd/src/api/im/channel/material/index.ts

@@ -0,0 +1,24 @@
+import { requestClient } from '#/api/request';
+
+export namespace ImChannelMaterialApi {
+  /** 用户端能看到的频道素材详情 */
+  export interface Material {
+    id: number;
+    channelId: number;
+    type: number;
+    title: string;
+    coverUrl?: string;
+    summary?: string;
+    content?: string;
+    url?: string;
+  }
+}
+
+
+/** 获取频道素材详情；用于客户端点击图文卡片渲染详情页 */
+export function getChannelMaterial(id: number) {
+  return requestClient.get<ImChannelMaterialApi.Material>(
+    '/im/channel/material/get',
+    { params: { id } },
+  );
+}

apps/web-antd/src/api/im/conversation/read/index.ts

@@ -0,0 +1,25 @@
+import { requestClient } from '#/api/request';
+
+export namespace ImConversationReadApi {
+  /** IM 会话读位置 Response VO */
+  export interface ConversationReadRespVO {
+    id: number; // 读位置编号（增量拉取游标用）
+    conversationType: number; // 会话类型，参见 ImConversationType
+    targetId: number; // 会话目标编号
+    messageId: number; // 最大已读消息编号
+    updateTime?: number; // 最近更新时间（毫秒时间戳，增量拉取游标用）
+  }
+}
+
+
+/** 增量拉取当前用户的会话读位置（重连 / 离线补偿） */
+export function pullMyConversationReadList(params: {
+  lastId?: number;
+  lastUpdateTime?: number;
+  limit: number;
+}) {
+  return requestClient.get<ImConversationReadApi.ConversationReadRespVO[]>(
+    '/im/conversation-read/pull',
+    { params },
+  );
+}

apps/web-antd/src/api/im/face/pack/index.ts

@@ -0,0 +1,26 @@
+import { requestClient } from '#/api/request';
+
+export namespace ImFacePackApi {
+  /** 用户端表情包项（精简版） */
+  export interface FacePackUserItem {
+    id: number;
+    url: string;
+    name?: string;
+    width: number;
+    height: number;
+  }
+
+  /** 用户端表情包 + 嵌套 items */
+  export interface FacePackUser {
+    id: number;
+    name: string;
+    icon?: string;
+    items: FacePackUserItem[];
+  }
+}
+
+
+/** 拉取所有启用的系统表情包（含表情列表） */
+export function getFacePackList() {
+  return requestClient.get<ImFacePackApi.FacePackUser[]>('/im/face-pack/list');
+}

apps/web-antd/src/api/im/face/userItem/index.ts

@@ -0,0 +1,38 @@
+import { requestClient } from '#/api/request';
+
+export namespace ImFaceUserItemApi {
+  /** 个人表情 */
+  export interface FaceUserItem {
+    id: number;
+    url: string;
+    name?: string;
+    width: number;
+    height: number;
+  }
+
+  /** 添加个人表情请求 */
+  export interface FaceUserItemSaveReqVO {
+    url: string;
+    name?: string;
+    width: number;
+    height: number;
+  }
+}
+
+
+/** 获取我的个人表情列表 */
+export function getFaceUserItemList() {
+  return requestClient.get<ImFaceUserItemApi.FaceUserItem[]>('/im/face-user-item/list');
+}
+
+/** 添加个人表情 */
+export function createFaceUserItem(data: ImFaceUserItemApi.FaceUserItemSaveReqVO) {
+  return requestClient.post<number>('/im/face-user-item/create', data);
+}
+
+/** 删除个人表情 */
+export function deleteFaceUserItem(id: number) {
+  return requestClient.delete<boolean>('/im/face-user-item/delete', {
+    params: { id },
+  });
+}

apps/web-antd/src/api/im/friend/index.ts

@@ -0,0 +1,78 @@
+import { requestClient } from '#/api/request';
+
+export namespace ImFriendApi {
+  /** IM 好友 Response VO */
+  export interface FriendRespVO {
+    id: number; // 关系记录编号
+    friendUserId: number; // 好友的用户编号
+    silent?: boolean; // 是否免打扰
+    displayName?: string; // 好友展示备注（仅自己可见）
+    displayNamePinyin?: string; // 备注的拼音（小写无空格，前端按首字母分桶 / 拼音搜索）
+    addSource?: number; // 添加来源；参见 ImFriendAddSourceEnum
+    pinned?: boolean; // 是否置顶联系人
+    blocked?: boolean; // 是否拉黑
+    status?: number; // 好友状态（0=正常，1=已删除）
+    addTime?: string; // 添加好友时间
+    deleteTime?: string; // 删除好友时间
+    updateTime?: number; // 最近更新时间（毫秒时间戳，增量拉取游标用）
+    nickname?: string; // 好友昵称
+    nicknamePinyin?: string; // 昵称的拼音（小写无空格，前端按首字母分桶 / 拼音搜索）
+    avatar?: string; // 好友头像
+  }
+
+  /** IM 好友更新 Request VO */
+  export interface FriendUpdateReqVO {
+    friendUserId: number; // 好友的用户编号
+    silent?: boolean; // 是否免打扰
+    displayName?: string; // 好友展示备注
+    pinned?: boolean; // 是否置顶联系人
+  }
+}
+
+
+/** 获得当前登录用户的好友列表 */
+export function getMyFriendList() {
+  return requestClient.get<ImFriendApi.FriendRespVO[]>('/im/friend/list');
+}
+
+/** 增量拉取当前用户的好友关系（重连 / 离线补偿） */
+export function pullMyFriendList(params: {
+  lastId?: number;
+  lastUpdateTime?: number;
+  limit: number;
+}) {
+  return requestClient.get<ImFriendApi.FriendRespVO[]>('/im/friend/pull', { params });
+}
+
+/** 获得好友详情 */
+export function getFriend(friendUserId: number | string) {
+  return requestClient.get<ImFriendApi.FriendRespVO>('/im/friend/get', {
+    params: { friendUserId },
+  });
+}
+
+/** 删除好友（单向软删除） */
+export function deleteFriend(friendUserId: number | string, clear: boolean) {
+  return requestClient.delete<boolean>('/im/friend/delete', {
+    params: { friendUserId, clear },
+  });
+}
+
+/** 更新好友信息（备注 / 免打扰 / 联系人置顶） */
+export function updateFriend(data: ImFriendApi.FriendUpdateReqVO) {
+  return requestClient.put<boolean>('/im/friend/update', data);
+}
+
+/** 拉黑好友（必须先是好友；单边屏蔽对方私聊消息） */
+export function blockFriend(friendUserId: number | string) {
+  return requestClient.put<boolean>('/im/friend/block', undefined, {
+    params: { friendUserId },
+  });
+}
+
+/** 移出黑名单 */
+export function unblockFriend(friendUserId: number | string) {
+  return requestClient.put<boolean>('/im/friend/unblock', undefined, {
+    params: { friendUserId },
+  });
+}

apps/web-antd/src/api/im/friend/request/index.ts

@@ -0,0 +1,84 @@
+import { requestClient } from '#/api/request';
+
+export namespace ImFriendRequestApi {
+  /** IM 好友申请 Response VO */
+  export interface FriendRequestRespVO {
+    id: number; // 申请编号
+    fromUserId: number; // 发起方用户编号
+    toUserId: number; // 接收方用户编号
+    handleResult: number; // 处理结果；0=未处理；1=同意；2=拒绝
+    applyContent?: string; // 申请理由
+    handleContent?: string; // 处理理由（接收方拒绝时可选填）
+    addSource?: number; // 添加来源；参见 ImFriendAddSourceEnum
+    handleTime?: string; // 处理时间
+    createTime: string; // 申请创建时间
+    updateTime?: number; // 最近更新时间（毫秒时间戳，增量拉取游标用）
+    fromNickname?: string; // 发起方昵称
+    fromAvatar?: string; // 发起方头像
+    toNickname?: string; // 接收方昵称
+    toAvatar?: string; // 接收方头像
+  }
+
+  /** IM 好友申请发起 Request VO */
+  export interface FriendRequestApplyReqVO {
+    toUserId: number; // 接收方用户编号
+    applyContent?: string; // 申请理由
+    displayName?: string; // 对接收方的备注（仅自己可见）
+    addSource?: number; // 添加来源
+  }
+}
+
+
+/** 发起好友申请 */
+export function applyFriendRequest(data: ImFriendRequestApi.FriendRequestApplyReqVO) {
+  return requestClient.post<null | number>('/im/friend-request/apply', data);
+}
+
+/** 同意好友申请 */
+export function agreeFriendRequest(id: number | string) {
+  return requestClient.put<boolean>('/im/friend-request/agree', undefined, {
+    params: { id },
+  });
+}
+
+/** 拒绝好友申请 */
+export function refuseFriendRequest(
+  id: number | string,
+  handleContent?: string,
+) {
+  return requestClient.put<boolean>('/im/friend-request/refuse', undefined, {
+    params: { id, handleContent },
+  });
+}
+
+/** 查询「我相关」的好友申请列表（游标分页：传 maxId 加载更多） */
+export function getMyFriendRequestList(limit: number, maxId?: number) {
+  const params: Record<string, number> = { limit };
+  if (maxId != null) {
+    params.maxId = maxId;
+  }
+  return requestClient.get<ImFriendRequestApi.FriendRequestRespVO[]>(
+    '/im/friend-request/list',
+    { params },
+  );
+}
+
+/** 增量拉取「我相关」的好友申请变更（重连 / 离线补偿） */
+export function pullMyFriendRequestList(params: {
+  lastId?: number;
+  lastUpdateTime?: number;
+  limit: number;
+}) {
+  return requestClient.get<ImFriendRequestApi.FriendRequestRespVO[]>(
+    '/im/friend-request/pull',
+    { params },
+  );
+}
+
+/** 按 id 单查「我相关」的申请记录（带越权过滤；WebSocket 通知到达后用） */
+export function getMyFriendRequest(id: number) {
+  return requestClient.get<ImFriendRequestApi.FriendRequestRespVO | null>(
+    '/im/friend-request/get',
+    { params: { id } },
+  );
+}

apps/web-antd/src/api/im/group/index.ts

@@ -0,0 +1,146 @@
+import type { ImGroupMessageApi } from '#/api/im/message/group';
+
+import { requestClient } from '#/api/request';
+
+export namespace ImGroupApi {
+  /** 群 Response VO */
+  export interface GroupRespVO {
+    id: number; // 编号
+    name: string; // 群名称
+    ownerUserId: number; // 群主用户编号
+    avatar?: string; // 群头像
+    notice?: string; // 群公告
+    banned?: boolean; // 是否封禁
+    mutedAll?: boolean; // 是否全群禁言
+    joinApproval?: boolean; // 进群是否需群主 / 管理员审批
+    bannedTime?: string; // 封禁时间
+    status: number; // 群状态（0=正常，1=已解散）
+    dissolvedTime?: string; // 解散时间
+    createTime?: string; // 创建时间
+    pinnedMessages?: ImGroupMessageApi.GroupMessageRespVO[]; // 群置顶消息列表（后端关联回填，仅当登录用户是群成员时非空）
+    joinStatus?: number; // 当前登录用户在该群的成员状态（参见 CommonStatusEnum：0 在群 / 1 已退群）；历史退群群仍返回，供展示离线消息的群名 / 头像
+    groupRemark?: string; // 当前登录用户对该群的备注
+    silent?: boolean; // 当前登录用户是否免打扰
+  }
+
+  /** 群消息置顶 / 取消置顶 Request VO */
+  export interface GroupMessagePinReqVO {
+    id: number; // 群编号
+    messageId: number; // 消息编号
+  }
+
+  /** 群创建 Request VO */
+  export interface GroupCreateReqVO {
+    name: string; // 群名称
+    memberUserIds?: number[]; // 初始成员用户编号列表（建群同时邀请的好友，不含创建者自己）
+    joinApproval?: boolean; // 进群是否需审批；不传默认 false 自由进群
+  }
+
+  /** 群更新 Request VO */
+  export interface GroupUpdateReqVO {
+    id: number; // 群编号
+    name?: string; // 群名称
+    avatar?: string; // 群头像
+    notice?: string; // 群公告
+    joinApproval?: boolean; // 进群是否需审批
+  }
+
+  /** 添加 / 撤销群管理员 Request VO */
+  export interface GroupAdminReqVO {
+    id: number; // 群编号
+    userIds: number[]; // 目标用户编号列表
+  }
+
+  /** 群主转让 Request VO */
+  export interface GroupTransferOwnerReqVO {
+    id: number; // 群编号
+    newOwnerUserId: number; // 新群主用户编号
+  }
+
+  /** 全群禁言 / 取消 Request VO */
+  export interface GroupMuteAllReqVO {
+    id: number; // 群编号
+    mutedAll: boolean; // 是否全群禁言
+  }
+
+  /** 成员禁言 Request VO */
+  export interface GroupMuteMemberReqVO {
+    id: number; // 群编号
+    userId: number; // 被禁言的用户编号
+    mutedSeconds: number; // 禁言时长（秒），0 表示永久禁言
+  }
+
+  /** 取消成员禁言 Request VO */
+  export interface GroupCancelMuteMemberReqVO {
+    id: number; // 群编号
+    userId: number; // 被取消禁言的用户编号
+  }
+}
+
+
+/** 获得当前登录用户的群列表 */
+export function getMyGroupList() {
+  return requestClient.get<ImGroupApi.GroupRespVO[]>('/im/group/list');
+}
+
+/** 获得群详情 */
+export function getGroup(id: number | string) {
+  return requestClient.get<ImGroupApi.GroupRespVO>('/im/group/get', { params: { id } });
+}
+
+/** 创建群 */
+export function createGroup(data: ImGroupApi.GroupCreateReqVO) {
+  return requestClient.post<ImGroupApi.GroupRespVO>('/im/group/create', data);
+}
+
+/** 更新群 */
+export function updateGroup(data: ImGroupApi.GroupUpdateReqVO) {
+  return requestClient.put<ImGroupApi.GroupRespVO>('/im/group/update', data);
+}
+
+/** 解散群 */
+export function dissolveGroup(id: number | string) {
+  return requestClient.delete<boolean>('/im/group/dissolve', {
+    params: { id },
+  });
+}
+
+/** 添加群管理员（仅群主可调） */
+export function addGroupAdmin(data: ImGroupApi.GroupAdminReqVO) {
+  return requestClient.put<boolean>('/im/group/add-admin', data);
+}
+
+/** 撤销群管理员（仅群主可调） */
+export function removeGroupAdmin(data: ImGroupApi.GroupAdminReqVO) {
+  return requestClient.put<boolean>('/im/group/remove-admin', data);
+}
+
+/** 转让群主（仅老群主可调；旧群主转让后降为普通成员） */
+export function transferGroupOwner(data: ImGroupApi.GroupTransferOwnerReqVO) {
+  return requestClient.put<boolean>('/im/group/transfer-owner', data);
+}
+
+/** 置顶群消息（仅群主 / 管理员可调） */
+export function pinGroupMessage(data: ImGroupApi.GroupMessagePinReqVO) {
+  return requestClient.put<boolean>('/im/group/pin-message', data);
+}
+
+/** 取消置顶群消息（仅群主 / 管理员可调） */
+export function unpinGroupMessage(data: ImGroupApi.GroupMessagePinReqVO) {
+  return requestClient.put<boolean>('/im/group/unpin-message', data);
+}
+
+/** 全群禁言 / 取消（仅群主 / 管理员可调） */
+export function muteAll(data: ImGroupApi.GroupMuteAllReqVO) {
+  return requestClient.put<boolean>('/im/group/mute-all', data);
+}
+
+/** 禁言成员 */
+export function muteMember(data: ImGroupApi.GroupMuteMemberReqVO) {
+  return requestClient.put<boolean>('/im/group/mute-member', data);
+}
+
+/** 取消成员禁言 */
+export function cancelMuteMember(data: ImGroupApi.GroupCancelMuteMemberReqVO) {
+  return requestClient.put<boolean>('/im/group/cancel-mute-member', data);
+}

apps/web-antd/src/api/im/group/member/index.ts

@@ -0,0 +1,78 @@
+import { requestClient } from '#/api/request';
+
+export namespace ImGroupMemberApi {
+  /** 群成员 Response VO */
+  export interface GroupMemberRespVO {
+    id: number; // 编号
+    groupId: number; // 群编号
+    userId: number; // 用户编号
+    displayUserName?: string; // 组内显示名（群主设置的备注）
+    groupRemark?: string; // 群备注（当前用户对群的备注）
+    silent?: boolean; // 是否免打扰
+    status?: number; // 成员状态（0=在群，1=退群）
+    role?: number; // 成员角色，参见 ImGroupMemberRole 枚举
+    joinTime?: string; // 入群时间
+    quitTime?: string; // 退群时间
+    muteEndTime?: string; // 禁言到期时间
+    createTime?: string; // 创建时间
+    nickname?: string; // 用户昵称
+    avatar?: string; // 用户头像
+  }
+
+  /** 群成员邀请 Request VO */
+  export interface GroupMemberInviteReqVO {
+    groupId: number; // 群编号
+    memberUserIds: number[]; // 被邀请的用户编号列表
+  }
+
+  /** 群成员移除 Request VO */
+  export interface GroupMemberRemoveReqVO {
+    groupId: number; // 群编号
+    memberUserIds: number[]; // 被移除的用户编号列表
+  }
+
+  /** 群成员更新 Request VO */
+  export interface GroupMemberUpdateReqVO {
+    groupId: number; // 群编号
+    displayUserName?: string; // 群内昵称
+    groupRemark?: string; // 群备注
+    silent?: boolean; // 是否免打扰
+  }
+}
+
+
+/** 邀请用户加入群 */
+export function inviteGroupMember(data: ImGroupMemberApi.GroupMemberInviteReqVO) {
+  return requestClient.post<boolean>('/im/group/invite', data);
+}
+
+/** 退出群 */
+export function quitGroup(groupId: number | string) {
+  return requestClient.delete<boolean>('/im/group/quit', {
+    params: { groupId },
+  });
+}
+
+/** 移除群成员 */
+export function removeGroupMember(data: ImGroupMemberApi.GroupMemberRemoveReqVO) {
+  return requestClient.delete<boolean>('/im/group/kicking', { data });
+}
+
+/** 获得群成员详情 */
+export function getGroupMember(groupId: number, userId: number) {
+  return requestClient.get<ImGroupMemberApi.GroupMemberRespVO>('/im/group-member/get', {
+    params: { groupId, userId },
+  });
+}
+
+/** 获得指定群的成员列表（聚合 AdminUser 昵称 / 头像） */
+export function getGroupMemberList(groupId: number | string) {
+  return requestClient.get<ImGroupMemberApi.GroupMemberRespVO[]>('/im/group-member/list', {
+    params: { groupId },
+  });
+}
+
+/** 更新群成员 */
+export function updateGroupMember(data: ImGroupMemberApi.GroupMemberUpdateReqVO) {
+  return requestClient.put<boolean>('/im/group-member/update', data);
+}

apps/web-antd/src/api/im/group/request/index.ts

@@ -0,0 +1,90 @@
+import { requestClient } from '#/api/request';
+
+export namespace ImGroupRequestApi {
+  /** IM 加群申请 Response VO */
+  export interface GroupRequestRespVO {
+    id: number; // 申请编号
+    groupId: number; // 群编号
+    userId: number; // 申请人 / 被邀请人用户编号
+    inviterUserId?: number; // 邀请人；NULL 表示用户主动申请
+    handleResult: number; // 处理结果；0=未处理；1=同意；2=拒绝
+    applyContent?: string; // 申请理由
+    handleContent?: string; // 处理理由（拒绝时可选填）
+    handleUserId?: number; // 处理人用户编号
+    addSource?: number; // 加入来源；参见 ImGroupAddSourceEnum
+    handleTime?: string; // 处理时间
+    createTime: string; // 申请创建时间
+    updateTime?: number; // 最近更新时间（毫秒时间戳，增量拉取游标用）
+    userNickname?: string; // 申请人 / 被邀请人昵称
+    userAvatar?: string; // 申请人 / 被邀请人头像
+    inviterNickname?: string; // 邀请人昵称
+    inviterAvatar?: string; // 邀请人头像
+    groupName?: string; // 群名称
+    groupAvatar?: string; // 群头像
+  }
+
+  /** IM 加群申请发起 Request VO */
+  export interface GroupRequestApplyReqVO {
+    groupId: number; // 群编号
+    applyContent?: string; // 申请理由
+    addSource?: number; // 加入来源
+  }
+}
+
+
+/** 申请加群 */
+export function applyJoinGroup(data: ImGroupRequestApi.GroupRequestApplyReqVO) {
+  return requestClient.post<null | number>('/im/group-request/apply', data);
+}
+
+/** 同意加群申请（群主或管理员） */
+export function agreeGroupRequest(id: number | string) {
+  return requestClient.put<boolean>('/im/group-request/agree', undefined, {
+    params: { id },
+  });
+}
+
+/** 拒绝加群申请（群主或管理员） */
+export function refuseGroupRequest(
+  id: number | string,
+  handleContent?: string,
+) {
+  return requestClient.put<boolean>('/im/group-request/refuse', undefined, {
+    params: { id, handleContent },
+  });
+}
+
+/** 查询「我管理的所有群」下的未处理加群申请列表（不分页）；前端 store 据此派生横幅红点 + Drawer 列表 */
+export function getUnhandledRequestList() {
+  return requestClient.get<ImGroupRequestApi.GroupRequestRespVO[]>(
+    '/im/group-request/unhandled-list',
+  );
+}
+
+/** 查询指定群下的全部加群申请（含已处理）；仅群主 / 管理员可查 */
+export function getGroupRequestListByGroupId(groupId: number) {
+  return requestClient.get<ImGroupRequestApi.GroupRequestRespVO[]>(
+    '/im/group-request/list-by-group',
+    { params: { groupId } },
+  );
+}
+
+/** 按 id 单查申请记录（带越权过滤；WebSocket 通知到达后用） */
+export function getMyGroupRequest(id: number) {
+  return requestClient.get<ImGroupRequestApi.GroupRequestRespVO | null>(
+    '/im/group-request/get',
+    { params: { id } },
+  );
+}
+
+/** 增量拉取我管理的所有群下加群申请变更（重连 / 离线补偿） */
+export function pullMyGroupRequestList(params: {
+  lastId?: number;
+  lastUpdateTime?: number;
+  limit: number;
+}) {
+  return requestClient.get<ImGroupRequestApi.GroupRequestRespVO[]>(
+    '/im/group-request/pull',
+    { params },
+  );
+}

apps/web-antd/src/api/im/manager/channel/index.ts

@@ -0,0 +1,56 @@
+import type { PageParam, PageResult } from '@vben/request';
+
+import { requestClient } from '#/api/request';
+
+export namespace ImManagerChannelApi {
+  /** 频道 */
+  export interface Channel {
+    id: number;
+    code: string;
+    name: string;
+    avatar?: string;
+    sort: number;
+    status: number;
+    createTime?: Date;
+  }
+}
+
+
+/** 获得频道分页 */
+export function getManagerChannelPage(params: PageParam) {
+  return requestClient.get<PageResult<ImManagerChannelApi.Channel>>(
+    '/im/manager/channel/page',
+    { params },
+  );
+}
+
+/** 获得频道详情 */
+export function getManagerChannel(id: number) {
+  return requestClient.get<ImManagerChannelApi.Channel>('/im/manager/channel/get', {
+    params: { id },
+  });
+}
+
+/** 新增频道 */
+export function createManagerChannel(data: ImManagerChannelApi.Channel) {
+  return requestClient.post<number>('/im/manager/channel/create', data);
+}
+
+/** 修改频道 */
+export function updateManagerChannel(data: ImManagerChannelApi.Channel) {
+  return requestClient.put<boolean>('/im/manager/channel/update', data);
+}
+
+/** 删除频道 */
+export function deleteManagerChannel(id: number) {
+  return requestClient.delete<boolean>('/im/manager/channel/delete', {
+    params: { id },
+  });
+}
+
+/** 获得启用的频道精简列表（表单选择用） */
+export function getSimpleChannelList() {
+  return requestClient.get<ImManagerChannelApi.Channel[]>(
+    '/im/manager/channel/simple-list',
+  );
+}

apps/web-antd/src/api/im/manager/channel/material/index.ts

@@ -0,0 +1,68 @@
+import type { PageParam, PageResult } from '@vben/request';
+
+import { requestClient } from '#/api/request';
+
+export namespace ImManagerChannelMaterialApi {
+  /** 频道素材 */
+  export interface Material {
+    id: number;
+    channelId: number;
+    channelName?: string;
+    type: number;
+    title: string;
+    coverUrl?: string;
+    summary?: string;
+    content?: string;
+    url?: string;
+    createTime?: Date;
+  }
+}
+
+
+/** 获得素材分页 */
+export function getManagerChannelMaterialPage(params: PageParam) {
+  return requestClient.get<PageResult<ImManagerChannelMaterialApi.Material>>(
+    '/im/manager/channel-material/page',
+    { params },
+  );
+}
+
+/** 获得指定频道下的素材精简列表 */
+export function getSimpleManagerChannelMaterialList(channelId: number) {
+  return requestClient.get<ImManagerChannelMaterialApi.Material[]>(
+    '/im/manager/channel-material/simple-list',
+    { params: { channelId } },
+  );
+}
+
+/** 获得素材详情 */
+export function getManagerChannelMaterial(id: number) {
+  return requestClient.get<ImManagerChannelMaterialApi.Material>(
+    '/im/manager/channel-material/get',
+    { params: { id } },
+  );
+}
+
+/** 新增素材 */
+export function createManagerChannelMaterial(
+  data: ImManagerChannelMaterialApi.Material,
+) {
+  return requestClient.post<number>('/im/manager/channel-material/create', data);
+}
+
+/** 修改素材 */
+export function updateManagerChannelMaterial(
+  data: ImManagerChannelMaterialApi.Material,
+) {
+  return requestClient.put<boolean>(
+    '/im/manager/channel-material/update',
+    data,
+  );
+}
+
+/** 删除素材 */
+export function deleteManagerChannelMaterial(id: number) {
+  return requestClient.delete<boolean>('/im/manager/channel-material/delete', {
+    params: { id },
+  });
+}

apps/web-antd/src/api/im/manager/channel/message/index.ts

@@ -0,0 +1,48 @@
+import type { PageParam, PageResult } from '@vben/request';
+
+import { requestClient } from '#/api/request';
+
+export namespace ImManagerChannelMessageApi {
+  /** 频道消息 */
+  export interface ChannelMessage {
+    id: number;
+    channelId: number;
+    channelName?: string;
+    materialId: number;
+    materialTitle?: string;
+    materialCoverUrl?: string;
+    type: number;
+    content?: string;
+    receiverUserIds?: number[];
+    sendTime?: Date;
+  }
+
+  /** 频道消息发送请求 */
+  export interface ChannelMessageSendReqVO {
+    materialId: number;
+    receiverUserIds?: number[];
+  }
+}
+
+
+/** 立即推送频道消息 */
+export function sendManagerChannelMessage(
+  data: ImManagerChannelMessageApi.ChannelMessageSendReqVO,
+) {
+  return requestClient.post<number>('/im/manager/channel-message/send', data);
+}
+
+/** 删除频道消息 */
+export function deleteManagerChannelMessage(id: number) {
+  return requestClient.delete<boolean>('/im/manager/channel-message/delete', {
+    params: { id },
+  });
+}
+
+/** 获得频道消息分页 */
+export function getManagerChannelMessagePage(params: PageParam) {
+  return requestClient.get<PageResult<ImManagerChannelMessageApi.ChannelMessage>>(
+    '/im/manager/channel-message/page',
+    { params },
+  );
+}

apps/web-antd/src/api/im/manager/face/item/index.ts

@@ -0,0 +1,63 @@
+import type { PageParam, PageResult } from '@vben/request';
+
+import { requestClient } from '#/api/request';
+
+export namespace ImManagerFacePackItemApi {
+  /** 表情项 */
+  export interface FacePackItem {
+    id: number;
+    packId: number;
+    url: string;
+    name?: string;
+    width: number;
+    height: number;
+    sort: number;
+    status: number;
+    createTime?: Date;
+  }
+}
+
+
+/** 获得表情分页 */
+export function getManagerFacePackItemPage(params: PageParam) {
+  return requestClient.get<PageResult<ImManagerFacePackItemApi.FacePackItem>>(
+    '/im/manager/face-pack-item/page',
+    { params },
+  );
+}
+
+/** 获得表情详情 */
+export function getManagerFacePackItem(id: number) {
+  return requestClient.get<ImManagerFacePackItemApi.FacePackItem>(
+    '/im/manager/face-pack-item/get',
+    { params: { id } },
+  );
+}
+
+/** 新增表情 */
+export function createManagerFacePackItem(data: ImManagerFacePackItemApi.FacePackItem) {
+  return requestClient.post<number>('/im/manager/face-pack-item/create', data);
+}
+
+/** 修改表情 */
+export function updateManagerFacePackItem(data: ImManagerFacePackItemApi.FacePackItem) {
+  return requestClient.put<boolean>(
+    '/im/manager/face-pack-item/update',
+    data,
+  );
+}
+
+/** 删除表情 */
+export function deleteManagerFacePackItem(id: number) {
+  return requestClient.delete<boolean>('/im/manager/face-pack-item/delete', {
+    params: { id },
+  });
+}
+
+/** 批量删除表情 */
+export function deleteManagerFacePackItemList(ids: number[]) {
+  return requestClient.delete<boolean>(
+    '/im/manager/face-pack-item/delete-list',
+    { params: { ids: ids.join(',') } },
+  );
+}

apps/web-antd/src/api/im/manager/face/pack/index.ts

@@ -0,0 +1,55 @@
+import type { PageParam, PageResult } from '@vben/request';
+
+import { requestClient } from '#/api/request';
+
+export namespace ImManagerFacePackApi {
+  /** 表情包 */
+  export interface FacePack {
+    id: number;
+    name: string;
+    icon?: string;
+    sort: number;
+    status: number;
+    createTime?: Date;
+  }
+}
+
+
+/** 获得表情包分页 */
+export function getManagerFacePackPage(params: PageParam) {
+  return requestClient.get<PageResult<ImManagerFacePackApi.FacePack>>(
+    '/im/manager/face-pack/page',
+    { params },
+  );
+}
+
+/** 获得表情包详情 */
+export function getManagerFacePack(id: number) {
+  return requestClient.get<ImManagerFacePackApi.FacePack>('/im/manager/face-pack/get', {
+    params: { id },
+  });
+}
+
+/** 新增表情包 */
+export function createManagerFacePack(data: ImManagerFacePackApi.FacePack) {
+  return requestClient.post<number>('/im/manager/face-pack/create', data);
+}
+
+/** 修改表情包 */
+export function updateManagerFacePack(data: ImManagerFacePackApi.FacePack) {
+  return requestClient.put<boolean>('/im/manager/face-pack/update', data);
+}
+
+/** 删除表情包 */
+export function deleteManagerFacePack(id: number) {
+  return requestClient.delete<boolean>('/im/manager/face-pack/delete', {
+    params: { id },
+  });
+}
+
+/** 批量删除表情包 */
+export function deleteManagerFacePackList(ids: number[]) {
+  return requestClient.delete<boolean>('/im/manager/face-pack/delete-list', {
+    params: { ids: ids.join(',') },
+  });
+}

apps/web-antd/src/api/im/manager/face/userItem/index.ts

@@ -0,0 +1,33 @@
+import type { PageParam, PageResult } from '@vben/request';
+
+import { requestClient } from '#/api/request';
+
+export namespace ImManagerFaceUserItemApi {
+  /** 用户表情 */
+  export interface FaceUserItem {
+    id: number;
+    userId: number;
+    userNickname?: string;
+    url: string;
+    name?: string;
+    width?: number;
+    height?: number;
+    createTime?: Date;
+  }
+}
+
+
+/** 获得用户表情分页 */
+export function getManagerFaceUserItemPage(params: PageParam) {
+  return requestClient.get<PageResult<ImManagerFaceUserItemApi.FaceUserItem>>(
+    '/im/manager/face-user-item/page',
+    { params },
+  );
+}
+
+/** 删除用户表情 */
+export function deleteManagerFaceUserItem(id: number) {
+  return requestClient.delete<boolean>('/im/manager/face-user-item/delete', {
+    params: { id },
+  });
+}

apps/web-antd/src/api/im/manager/friend/index.ts

@@ -0,0 +1,32 @@
+import type { PageParam, PageResult } from '@vben/request';
+
+import { requestClient } from '#/api/request';
+
+export namespace ImManagerFriendApi {
+  /** 好友关系 */
+  export interface Friend {
+    id: number;
+    userId: number;
+    userNickname?: string;
+    friendUserId: number;
+    friendNickname?: string;
+    displayName?: string;
+    addSource?: number;
+    silent: boolean;
+    pinned: boolean;
+    blocked: boolean;
+    status: number;
+    addTime?: Date;
+    deleteTime?: Date;
+    createTime: Date;
+  }
+}
+
+
+/** 获得好友关系分页 */
+export function getManagerFriendPage(params: PageParam) {
+  return requestClient.get<PageResult<ImManagerFriendApi.Friend>>(
+    '/im/manager/friend/page',
+    { params },
+  );
+}

apps/web-antd/src/api/im/manager/friend/request/index.ts

@@ -0,0 +1,30 @@
+import type { PageParam, PageResult } from '@vben/request';
+
+import { requestClient } from '#/api/request';
+
+export namespace ImManagerFriendRequestApi {
+  /** 好友申请 */
+  export interface FriendRequest {
+    id: number;
+    fromUserId: number;
+    fromNickname?: string;
+    toUserId: number;
+    toNickname?: string;
+    applyContent?: string;
+    displayName?: string;
+    addSource?: number;
+    handleResult: number;
+    handleContent?: string;
+    handleTime?: Date;
+    createTime: Date;
+  }
+}
+
+
+/** 获得好友申请分页 */
+export function getManagerFriendRequestPage(params: PageParam) {
+  return requestClient.get<PageResult<ImManagerFriendRequestApi.FriendRequest>>(
+    '/im/manager/friend-request/page',
+    { params },
+  );
+}

apps/web-antd/src/api/im/manager/group/index.ts

@@ -0,0 +1,87 @@
+import type { PageParam, PageResult } from '@vben/request';
+
+import { requestClient } from '#/api/request';
+
+export namespace ImManagerGroupApi {
+  /** 群 */
+  export interface Group {
+    id: number;
+    name: string;
+    avatar?: string;
+    notice?: string;
+    ownerUserId: number;
+    ownerNickname?: string;
+    memberCount?: number;
+    status: number;
+    banned: boolean;
+    mutedAll?: boolean; // 是否全群禁言
+    bannedReason?: string;
+    bannedTime?: Date;
+    dissolvedTime?: Date;
+    createTime: Date;
+  }
+
+  /** 群成员 */
+  export interface GroupMember {
+    userId: number;
+    nickname?: string;
+    avatar?: string;
+    displayUserName?: string;
+    groupRemark?: string;
+    silent?: boolean;
+    status: number;
+    role?: number; // 成员角色，参见 ImGroupMemberRole 枚举
+    joinTime?: Date;
+    quitTime?: Date;
+    muteEndTime?: Date; // 禁言到期时间
+  }
+
+  /** 群封禁请求 */
+  export interface GroupBanReqVO {
+    id: number;
+    reason: string;
+  }
+}
+
+
+/** 获得群分页 */
+export function getManagerGroupPage(params: PageParam) {
+  return requestClient.get<PageResult<ImManagerGroupApi.Group>>(
+    '/im/manager/group/page',
+    { params },
+  );
+}
+
+/** 获得群详情 */
+export function getManagerGroup(id: number) {
+  return requestClient.get<ImManagerGroupApi.Group>('/im/manager/group/get', {
+    params: { id },
+  });
+}
+
+/** 封禁群 */
+export function banManagerGroup(data: ImManagerGroupApi.GroupBanReqVO) {
+  return requestClient.put<boolean>('/im/manager/group/ban', data);
+}
+
+/** 解封群 */
+export function unbanManagerGroup(id: number) {
+  return requestClient.put<boolean>('/im/manager/group/unban', undefined, {
+    params: { id },
+  });
+}
+
+/** 解散群 */
+export function dissolveManagerGroup(id: number) {
+  return requestClient.delete<boolean>('/im/manager/group/dissolve', {
+    params: { id },
+  });
+}
+
+/** 获得群成员列表（含已退群成员，由前端按需过滤） */
+export function getManagerGroupMemberList(groupId: number) {
+  return requestClient.get<ImManagerGroupApi.GroupMember[]>(
+    '/im/manager/group/member/list',
+    { params: { groupId } },
+  );
+}

apps/web-antd/src/api/im/manager/group/request/index.ts

@@ -0,0 +1,33 @@
+import type { PageParam, PageResult } from '@vben/request';
+
+import { requestClient } from '#/api/request';
+
+export namespace ImManagerGroupRequestApi {
+  /** 加群申请 */
+  export interface GroupRequest {
+    id: number;
+    groupId: number;
+    groupName?: string;
+    userId: number;
+    userNickname?: string;
+    inviterUserId?: number;
+    inviterNickname?: string;
+    applyContent?: string;
+    addSource?: number;
+    handleResult: number;
+    handleUserId?: number;
+    handleNickname?: string;
+    handleContent?: string;
+    handleTime?: Date;
+    createTime: Date;
+  }
+}
+
+
+/** 获得加群申请分页 */
+export function getManagerGroupRequestPage(params: PageParam) {
+  return requestClient.get<PageResult<ImManagerGroupRequestApi.GroupRequest>>(
+    '/im/manager/group-request/page',
+    { params },
+  );
+}

apps/web-antd/src/api/im/manager/message/group/index.ts

@@ -0,0 +1,40 @@
+import type { PageParam, PageResult } from '@vben/request';
+
+import { requestClient } from '#/api/request';
+
+export namespace ImManagerGroupMessageApi {
+  /** 群聊消息 */
+  export interface GroupMessage {
+    id: number;
+    clientMessageId?: string;
+    groupId: number;
+    groupName?: string;
+    senderId: number;
+    senderNickname?: string;
+    type: number;
+    content: string;
+    status: number;
+    atUserIds?: number[];
+    atUserNicknames?: (null | string)[];
+    receiptStatus: number;
+    sendTime: Date;
+    createTime: Date;
+  }
+}
+
+
+/** 获得群聊消息分页 */
+export function getManagerGroupMessagePage(params: PageParam) {
+  return requestClient.get<PageResult<ImManagerGroupMessageApi.GroupMessage>>(
+    '/im/manager/message/group/page',
+    { params },
+  );
+}
+
+/** 获得群聊消息详情 */
+export function getManagerGroupMessage(id: number) {
+  return requestClient.get<ImManagerGroupMessageApi.GroupMessage>(
+    '/im/manager/message/group/get',
+    { params: { id } },
+  );
+}

apps/web-antd/src/api/im/manager/message/private/index.ts

@@ -0,0 +1,38 @@
+import type { PageParam, PageResult } from '@vben/request';
+
+import { requestClient } from '#/api/request';
+
+export namespace ImManagerPrivateMessageApi {
+  /** 私聊消息 */
+  export interface PrivateMessage {
+    id: number;
+    clientMessageId?: string;
+    senderId: number;
+    senderNickname?: string;
+    receiverId: number;
+    receiverNickname?: string;
+    type: number;
+    content: string;
+    status: number;
+    receiptStatus?: number;
+    sendTime: Date;
+    createTime: Date;
+  }
+}
+
+
+/** 获得私聊消息分页 */
+export function getManagerPrivateMessagePage(params: PageParam) {
+  return requestClient.get<PageResult<ImManagerPrivateMessageApi.PrivateMessage>>(
+    '/im/manager/message/private/page',
+    { params },
+  );
+}
+
+/** 获得私聊消息详情 */
+export function getManagerPrivateMessage(id: number) {
+  return requestClient.get<ImManagerPrivateMessageApi.PrivateMessage>(
+    '/im/manager/message/private/get',
+    { params: { id } },
+  );
+}

apps/web-antd/src/api/im/manager/rtc/index.ts

@@ -0,0 +1,53 @@
+import type { PageParam, PageResult } from '@vben/request';
+
+import { requestClient } from '#/api/request';
+
+export namespace ImManagerRtcApi {
+  /** RTC 通话 */
+  export interface RtcCall {
+    id: number;
+    room: string;
+    conversationType: number;
+    mediaType: number;
+    inviterUserId: number;
+    inviterNickname?: string;
+    groupId?: number;
+    groupName?: string;
+    status: number;
+    endReason?: number;
+    startTime: Date;
+    acceptTime?: Date;
+    endTime?: Date;
+    createTime: Date;
+  }
+
+  /** RTC 通话参与者 */
+  export interface RtcParticipant {
+    id: number;
+    callId: number;
+    userId: number;
+    userNickname?: string;
+    role: number;
+    status: number;
+    inviteTime: Date;
+    acceptTime?: Date;
+    leaveTime?: Date;
+  }
+}
+
+
+/** 获得通话记录分页 */
+export function getManagerRtcCallPage(params: PageParam) {
+  return requestClient.get<PageResult<ImManagerRtcApi.RtcCall>>(
+    '/im/manager/rtc/page',
+    { params },
+  );
+}
+
+/** 获得通话参与者列表 */
+export function getManagerRtcCallParticipantList(id: number) {
+  return requestClient.get<ImManagerRtcApi.RtcParticipant[]>(
+    '/im/manager/rtc/participant-list',
+    { params: { id } },
+  );
+}

apps/web-antd/src/api/im/manager/sensitiveword/index.ts

@@ -0,0 +1,60 @@
+import type { PageParam, PageResult } from '@vben/request';
+
+import { requestClient } from '#/api/request';
+
+export namespace ImManagerSensitiveWordApi {
+  /** 敏感词 */
+  export interface SensitiveWord {
+    id: number;
+    word: string;
+    status: number;
+    creator?: string;
+    creatorName?: string;
+    createTime?: Date;
+  }
+}
+
+
+/** 获得敏感词分页 */
+export function getManagerSensitiveWordPage(params: PageParam) {
+  return requestClient.get<PageResult<ImManagerSensitiveWordApi.SensitiveWord>>(
+    '/im/manager/sensitive-word/page',
+    { params },
+  );
+}
+
+/** 获得敏感词详情 */
+export function getManagerSensitiveWord(id: number) {
+  return requestClient.get<ImManagerSensitiveWordApi.SensitiveWord>(
+    '/im/manager/sensitive-word/get',
+    { params: { id } },
+  );
+}
+
+/** 新增敏感词 */
+export function createManagerSensitiveWord(data: ImManagerSensitiveWordApi.SensitiveWord) {
+  return requestClient.post<number>('/im/manager/sensitive-word/create', data);
+}
+
+/** 修改敏感词 */
+export function updateManagerSensitiveWord(data: ImManagerSensitiveWordApi.SensitiveWord) {
+  return requestClient.put<boolean>(
+    '/im/manager/sensitive-word/update',
+    data,
+  );
+}
+
+/** 删除敏感词 */
+export function deleteManagerSensitiveWord(id: number) {
+  return requestClient.delete<boolean>('/im/manager/sensitive-word/delete', {
+    params: { id },
+  });
+}
+
+/** 批量删除敏感词 */
+export function deleteManagerSensitiveWordList(ids: number[]) {
+  return requestClient.delete<boolean>(
+    '/im/manager/sensitive-word/delete-list',
+    { params: { ids: ids.join(',') } },
+  );
+}

apps/web-antd/src/api/im/manager/statistics/index.ts

@@ -0,0 +1,88 @@
+import { requestClient } from '#/api/request';
+
+export namespace ImManagerStatisticsApi {
+  /** 统计概览 */
+  export interface Overview {
+    totalUser: number;
+    newUserToday: number;
+    totalGroup: number;
+    newGroupToday: number;
+    activeUserDaily: number;
+    activeUserWeekly: number;
+    activeUserMonthly: number;
+    privateMessageToday: number;
+    groupMessageToday: number;
+    privateMessageYesterday: number;
+    groupMessageYesterday: number;
+  }
+
+  /** 趋势数据 */
+  export interface Trend {
+    dates: string[];
+    series: Record<string, number[]>;
+  }
+
+  /** 消息类型分布 */
+  export interface MessageType {
+    type: number; // 参见 ImContentTypeEnum 枚举类，由前端按 DICT_TYPE.IM_CONTENT_TYPE 翻译
+    value: number;
+  }
+
+  /** 群规模分布 */
+  export interface GroupSize {
+    range: string;
+    count: number;
+  }
+
+  /** 消息发送排行 */
+  export interface TopSender {
+    userId: number;
+    nickname: string;
+    messageCount: number;
+  }
+}
+
+
+/** 获得 KPI 概览 */
+export function getStatisticsOverview() {
+  return requestClient.get<ImManagerStatisticsApi.Overview>(
+    '/im/manager/statistics/overview',
+  );
+}
+
+/** 获得消息趋势（私聊 + 群聊双线） */
+export function getMessageTrend(days: number) {
+  return requestClient.get<ImManagerStatisticsApi.Trend>(
+    '/im/manager/statistics/message-trend',
+    { params: { days } },
+  );
+}
+
+/** 获得用户趋势（新增注册 + 日活双线） */
+export function getUserTrend(days: number) {
+  return requestClient.get<ImManagerStatisticsApi.Trend>(
+    '/im/manager/statistics/user-trend',
+    { params: { days } },
+  );
+}
+
+/** 获得内容类型分布（最近 30 天） */
+export function getMessageTypeDistribution() {
+  return requestClient.get<ImManagerStatisticsApi.MessageType[]>(
+    '/im/manager/statistics/message-type-distribution',
+  );
+}
+
+/** 获得群规模分布 */
+export function getGroupSizeDistribution() {
+  return requestClient.get<ImManagerStatisticsApi.GroupSize[]>(
+    '/im/manager/statistics/group-size-distribution',
+  );
+}
+
+/** 获得消息 TOP 发送者（最近 30 天） */
+export function getTopSenders() {
+  return requestClient.get<ImManagerStatisticsApi.TopSender[]>(
+    '/im/manager/statistics/top-senders',
+  );
+}

apps/web-antd/src/api/im/message/channel/index.ts

@@ -0,0 +1,34 @@
+import { requestClient } from '#/api/request';
+
+export namespace ImChannelMessageApi {
+  /** 频道消息 */
+  export interface ChannelMessageRespVO {
+    id: number;
+    clientMessageId?: string;
+    channelId: number;
+    materialId: number;
+    type: number;
+    content: string;
+    receiptStatus?: number;
+    sendTime: string;
+  }
+}
+
+
+/** 拉取当前用户应收的频道消息（离线增量）；按 minId 游标分页 */
+export function pullChannelMessageList(
+  params: { minId: number; size?: number },
+  signal?: AbortSignal,
+) {
+  return requestClient.get<ImChannelMessageApi.ChannelMessageRespVO[]>(
+    '/im/channel/message/pull',
+    { params, signal },
+  );
+}
+
+/** 上报频道消息已读位置；切到频道会话或拉到新消息后调 */
+export function readChannelMessages(channelId: number, messageId: number) {
+  return requestClient.put<boolean>('/im/channel/message/read', undefined, {
+    params: { channelId, messageId },
+  });
+}

apps/web-antd/src/api/im/message/group/index.ts

@@ -0,0 +1,92 @@
+import { requestClient } from '#/api/request';
+
+export namespace ImGroupMessageApi {
+  /** 群聊消息 Response VO */
+  export interface GroupMessageRespVO {
+    id: number; // 消息编号
+    clientMessageId: string; // 客户端消息编号
+    senderId: number; // 发送人编号
+    groupId: number; // 群编号
+    type: number; // 内容类型
+    content: string; // 消息内容（JSON 格式）
+    status: number; // 消息状态
+    sendTime: string; // 发送时间
+    atUserIds?: number[]; // @ 目标用户编号列表
+    receiverUserIds?: number[]; // 定向接收用户编号列表
+    receiptStatus?: number; // 回执状态
+    readCount?: number; // 已读人数（回执消息、且发送人为当前用户时有值）
+  }
+
+  /** 群聊消息发送 Request VO */
+  export interface GroupMessageSendReqVO {
+    clientMessageId: string; // 客户端消息编号
+    groupId: number; // 群编号
+    type: number; // 内容类型
+    content: string; // 消息内容（JSON 格式）
+    atUserIds?: number[]; // @ 目标用户编号列表
+    receipt?: boolean; // 是否需要回执
+  }
+
+  /** 群聊历史消息列表 Request VO */
+  export interface GroupMessageListReqVO {
+    groupId: number | string; // 群编号
+    maxId?: number | string; // 起始消息编号（不含），为空则从最新消息开始
+    limit: number; // 拉取数量（1 ~ 200）
+  }
+}
+
+
+/** 发送群聊消息 */
+export function sendGroupMessage(data: ImGroupMessageApi.GroupMessageSendReqVO) {
+  return requestClient.post<ImGroupMessageApi.GroupMessageRespVO>(
+    '/im/message/group/send',
+    data,
+  );
+}
+
+/** 拉取群聊消息（增量） */
+export function pullGroupMessageList(
+  params: { minId: number | string; size: number },
+  signal?: AbortSignal,
+) {
+  return requestClient.get<ImGroupMessageApi.GroupMessageRespVO[]>(
+    '/im/message/group/pull',
+    { params, signal },
+  );
+}
+
+/** 查询群聊历史消息 */
+export function getGroupMessageList(params: ImGroupMessageApi.GroupMessageListReqVO) {
+  return requestClient.get<ImGroupMessageApi.GroupMessageRespVO[]>(
+    '/im/message/group/list',
+    { params },
+  );
+}
+
+/** 标记群聊消息已读 */
+export function readGroupMessages(
+  groupId: number | string,
+  messageId: number | string,
+) {
+  return requestClient.put<boolean>('/im/message/group/read', undefined, {
+    params: { groupId, messageId },
+  });
+}
+
+/** 撤回群聊消息 */
+export function recallGroupMessage(id: number | string) {
+  return requestClient.delete<ImGroupMessageApi.GroupMessageRespVO>(
+    '/im/message/group/recall',
+    { params: { id } },
+  );
+}
+
+/** 获取群消息已读用户列表 */
+export function getGroupReadUsers(params: {
+  groupId: number | string;
+  messageId: number | string;
+}) {
+  return requestClient.get<number[]>('/im/message/group/get-read-user-ids', {
+    params,
+  });
+}

apps/web-antd/src/api/im/message/private/index.ts

@@ -0,0 +1,89 @@
+import { requestClient } from '#/api/request';
+
+export namespace ImPrivateMessageApi {
+  /** 私聊消息 Response VO */
+  export interface PrivateMessageRespVO {
+    id: number; // 消息编号
+    clientMessageId: string; // 客户端消息编号
+    senderId: number; // 发送人编号
+    receiverId: number; // 接收人编号
+    type: number; // 内容类型
+    content: string; // 消息内容（JSON 格式）
+    status: number; // 消息状态（正常 / 已撤回）
+    receiptStatus?: number; // 回执状态（不需要 / 待完成 / 已完成），对齐 ImMessageReceiptStatus
+    sendTime: string; // 发送时间
+  }
+
+  /** 私聊消息发送 Request VO */
+  export interface PrivateMessageSendReqVO {
+    clientMessageId: string; // 客户端消息编号
+    receiverId: number; // 接收人编号
+    type: number; // 内容类型
+    content: string; // 消息内容（JSON 格式）
+    receipt?: boolean; // 是否需要回执；不传后端默认 true（普通私聊用户消息）
+  }
+
+  /** 私聊历史消息列表 Request VO */
+  export interface PrivateMessageListReqVO {
+    receiverId: number | string; // 接收人编号（对方）
+    maxId?: number | string; // 起始消息编号（不含），为空则从最新消息开始
+    limit: number; // 拉取数量（1 ~ 200）
+  }
+}
+
+
+/** 发送私聊消息 */
+export function sendPrivateMessage(data: ImPrivateMessageApi.PrivateMessageSendReqVO) {
+  return requestClient.post<ImPrivateMessageApi.PrivateMessageRespVO>(
+    '/im/message/private/send',
+    data,
+  );
+}
+
+/** 拉取私聊消息（增量） */
+export function pullPrivateMessageList(
+  params: { minId: number | string; size: number },
+  signal?: AbortSignal,
+) {
+  return requestClient.get<ImPrivateMessageApi.PrivateMessageRespVO[]>(
+    '/im/message/private/pull',
+    { params, signal },
+  );
+}
+
+/** 查询私聊历史消息 */
+export function getPrivateMessageList(params: ImPrivateMessageApi.PrivateMessageListReqVO) {
+  return requestClient.get<ImPrivateMessageApi.PrivateMessageRespVO[]>(
+    '/im/message/private/list',
+    { params },
+  );
+}
+
+/** 标记私聊消息已读 */
+export function readPrivateMessages(
+  receiverId: number | string,
+  messageId: number | string,
+) {
+  return requestClient.put<boolean>('/im/message/private/read', undefined, {
+    params: { receiverId, messageId },
+  });
+}
+
+/** 查询对方已读到我发的最大消息 id（多端 / 离线后用于补齐已读状态） */
+export function getPrivateMaxReadMessageId(
+  peerId: number | string,
+  signal?: AbortSignal,
+) {
+  return requestClient.get<null | number>(
+    '/im/message/private/max-read-message-id',
+    { params: { peerId }, signal },
+  );
+}
+
+/** 撤回私聊消息 */
+export function recallPrivateMessage(id: number | string) {
+  return requestClient.delete<ImPrivateMessageApi.PrivateMessageRespVO>(
+    '/im/message/private/recall',
+    { params: { id } },
+  );
+}

apps/web-antd/src/api/im/rtc/index.ts

@@ -0,0 +1,105 @@
+import { requestClient } from '#/api/request';
+
+export namespace ImRtcApi {
+  /** 创建新通话请求 VO */
+  export interface RtcCallCreateReqVO {
+    conversationType: number;
+    mediaType: number;
+    groupId?: number;
+    inviteeIds: number[]; // 被邀请的用户编号集合；私聊必传 1 个对端，群聊必传至少 1 人
+  }
+
+  /** 通话中追加邀请请求 VO；仅群通话可用 */
+  export interface RtcCallInviteReqVO {
+    room: string;
+    inviteeIds: number[];
+  }
+
+  /** 通话会话 VO；create / join / accept / refreshToken 共用 */
+  export interface RtcCallRespVO {
+    room: string; // 业务通话编号（同时作为 LiveKit 房间名）
+    livekitUrl: string;
+    token?: string; // ENDED 状态时为 null（无需 connect LiveKit）
+    conversationType: number;
+    mediaType: number;
+    status: number;
+    endReason?: number; // 结束原因；仅 status=ENDED 时有值
+    inviterId: number;
+    groupId?: number;
+    inviteeIds?: number[];
+    joinedUserIds?: number[];
+  }
+
+  /** 群活跃通话查询响应；不含 token */
+  export interface RtcGroupCallRespVO {
+    room: string;
+    groupId: number;
+    mediaType: number;
+    inviterId: number;
+    joinedUserIds?: number[];
+    inviteeIds?: number[];
+  }
+}
+
+
+/** 创建新通话；私聊或群聊根据 conversationType 区分 */
+export function createCall(data: ImRtcApi.RtcCallCreateReqVO) {
+  return requestClient.post<ImRtcApi.RtcCallRespVO>('/im/rtc/create', data);
+}
+
+/** 通话中追加邀请；仅群通话可用 */
+export function inviteCall(data: ImRtcApi.RtcCallInviteReqVO) {
+  return requestClient.post<boolean>('/im/rtc/invite', data);
+}
+
+/** 加入已有群通话；用于胶囊条「加入」按钮 */
+export function joinCall(room: string) {
+  return requestClient.post<ImRtcApi.RtcCallRespVO>('/im/rtc/join', undefined, {
+    params: { room },
+  });
+}
+
+/** 接听通话 */
+export function acceptCall(room: string) {
+  return requestClient.post<ImRtcApi.RtcCallRespVO>('/im/rtc/accept', undefined, {
+    params: { room },
+  });
+}
+
+/** 拒绝通话 */
+export function rejectCall(room: string) {
+  return requestClient.post<boolean>('/im/rtc/reject', undefined, {
+    params: { room },
+  });
+}
+
+/** 取消邀请；主叫接通前调用 */
+export function cancelCall(room: string) {
+  return requestClient.post<boolean>('/im/rtc/cancel', undefined, {
+    params: { room },
+  });
+}
+
+/** 离开通话；接通后调用 */
+export function leaveCall(room: string) {
+  return requestClient.post<boolean>('/im/rtc/leave', undefined, {
+    params: { room },
+  });
+}
+
+/** 振铃超时检查；RUNNING 端 timer 兜底，触发后端立即扫描该 room 的超时 INVITING（接口静默） */
+export function noAnswerCallCheck(room: string) {
+  return requestClient.post<boolean>(
+    '/im/rtc/no-answer-call-check',
+    undefined,
+    { params: { room } },
+  );
+}
+
+/** 查询当前进行中的通话；目前仅群聊场景（胶囊条），返回 null 表示无活跃通话 */
+export function getActiveCall(groupId: number) {
+  return requestClient.get<ImRtcApi.RtcGroupCallRespVO | null>(
+    '/im/rtc/get-active-call',
+    { params: { groupId } },
+  );
+}

apps/web-antd/src/api/infra/job/index.ts

@@ -75,3 +75,8 @@ export function runJob(id: number) {
 export function getJobNextTimes(id: number) {
   return requestClient.get(`/infra/job/get_next_times?id=${id}`);
 }
+
+/** 同步定时任务到 Quartz */
+export function syncJob() {
+  return requestClient.post('/infra/job/sync');
+}

apps/web-antd/src/api/mes/wm/sn/index.ts

@@ -17,6 +17,21 @@ export namespace MesWmSnApi {
     createTime?: Date; // 生成时间
   }
 
+  /** MES SN 码明细 */
+  export interface Sn {
+    id?: number; // 编号
+    uuid?: string; // 批次 UUID
+    code?: string; // SN 码
+    itemId?: number; // 物料编号
+    itemCode?: string; // 物料编码
+    itemName?: string; // 物料名称
+    specification?: string; // 规格型号
+    unitName?: string; // 单位名称
+    batchCode?: string; // 批次号
+    workOrderId?: number; // 生产工单编号
+    createTime?: Date; // 生成时间
+  }
+
   /** MES SN 码生成参数 */
   export interface SnGenerate {
     itemId?: number; // 物料编号
@@ -48,6 +63,13 @@ export function getSnGroupPage(params: MesWmSnApi.PageParams) {
   );
 }
 
+/** 查询批次 SN 码明细列表 */
+export function getSnListByUuid(uuid: string) {
+  return requestClient.get<MesWmSnApi.Sn[]>('/mes/wm/sn/list-by-uuid', {
+    params: { uuid },
+  });
+}
+
 /** 批量删除 SN 码（按批次 UUID） */
 export function deleteSnBatch(uuid: string) {
   return requestClient.delete('/mes/wm/sn/delete-batch', {

apps/web-antd/src/api/system/user/index.ts

@@ -9,16 +9,23 @@ export namespace SystemUserApi {
     username: string;
     nickname: string;
     deptId: number;
+    deptName?: string;
     postIds: string[];
     email: string;
     mobile: string;
     sex: number;
     avatar: string;
     loginIp: string;
+    loginDate?: Date;
     status: number;
     remark: string;
     createTime?: Date;
   }
+
+  /** 用户精简信息 */
+  export interface UserSimple extends User {
+    id: number;
+  }
 }
 
 /** 查询用户管理列表 */
@@ -34,6 +41,13 @@ export function getUser(id: number) {
   return requestClient.get<SystemUserApi.User>(`/system/user/get?id=${id}`);
 }
 
+/** 查询用户列表 */
+export function getUserList(ids: number[]) {
+  return requestClient.get<SystemUserApi.User[]>('/system/user/list', {
+    params: { ids: ids.join(',') },
+  });
+}
+
 /** 新增用户 */
 export function createUser(data: SystemUserApi.User) {
   return requestClient.post('/system/user/create', data);
@@ -86,3 +100,17 @@ export function updateUserStatus(id: number, status: number) {
 export function getSimpleUserList() {
   return requestClient.get<SystemUserApi.User[]>('/system/user/simple-list');
 }
+
+/** 按用户编号查询用户精简信息 */
+export function getSimpleUser(id: number | string) {
+  return requestClient.get<SystemUserApi.UserSimple>('/system/user/get-simple', {
+    params: { id },
+  });
+}
+
+/** 按昵称模糊搜索用户 */
+export function getSimpleUserListByNickname(nickname: string) {
+  return requestClient.get<SystemUserApi.UserSimple[]>('/system/user/list-by-nickname', {
+    params: { nickname },
+  });
+}