跳转到正文

UmiUDI 内部即时通讯 (IM) 售后与内部协调对话系统实施方案 ​

为了在 UmiUDI 客户端内部高效处理售后服务、与管理员和企业其他岗位员工(用户)即时沟通,本项目将基于 AntdUI 的高级 Chat 控件体系,深度结合现有的 umiudi.cn:1031 API 后端,打造一套高端、流畅、沉浸式的企业级 IM 聊天系统。


🎯 系统架构设计 ​

mermaid
graph TD
    Client1[UmiUDI 客户端 - 发送方] -- "POST /api/chat/send" --> API[umiudi.cn:1031 API 服务]
    API -- "写入记录" --> DB[(MySQL 数据库: umi_basic_cer)]
    Client2[UmiUDI 客户端 - 接收方] -- "1.5s 轮询 /api/chat/unread" --> API
    API -- "查询未读" --> DB

1. 数据库存储方案 ​

在现有中央 MySQL 数据库 umi_basic_cer 中,设计用于存储聊天记录的表 cer_chat_message:

字段名类型约束说明
idINTPRIMARY KEY, AUTO_INCREMENT唯一消息ID
sender_idINTNOT NULL发送方用户ID (cer_user.id)
receiver_idINTNOT NULL接收方用户ID (cer_user.id)
contentTEXTNOT NULL消息内容(支持富文本/Base64图片)
send_timeDATETIMENOT NULL发送时间
is_readINTNOT NULL, DEFAULT 0是否已读:0-未读,1-已读

2. 后端 API 接口设计 (umiudi.cn:1031) ​

在 UmiUDI - API 项目中新增 ChatController.cs,提供轻量高并发的接口服务:

  • GET /api/chat/users?companyId={companyId}: 获取企业内部所有用户列表(用于左侧联系人菜单)。
  • POST /api/chat/send: 发送消息(保存到数据库)。
  • GET /api/chat/history?senderId={senderId}&receiverId={receiverId}: 分页获取指定两人的聊天历史记录。
  • GET /api/chat/unread?userId={userId}: 获取当前登录用户的未读消息概览及计数。

3. 客户端 ChatUI 设计 (UmiUDI 客户端) ​

参考 AntdUI 官方极其成熟的 ChatUI 示例,开发一个独立的精致悬浮对话窗 ChatWindow:

  • 左侧联系人面板:使用 AntdUI.Chat.MsgList,每一项为一个 AntdUI.Chat.MsgItem,完美呈现头像、昵称、最后一条消息摘要、发送时间以及红色未读气泡徽标。
  • 右侧聊天面板:使用 AntdUI.Chat.ChatList,动态加载 TextChatItem 气泡。
    • 右侧(Me = true):当前登录用户发送的气泡,前景色使用深邃科技蓝,头像和名字居右。
    • 左侧(Me = false):对方发送的气泡,前景色使用温和的灰白色,头像和名字居左。
  • 输入面板:包含富文本输入框 AntdUI.Input,并配备“发送”按钮 and 常用快捷键(如 Enter)。

🛠️ 具体实施方案 ​

1. 数据库模型及建表 ​

在客户端中,使用 SqlSugar 现有的 CodeFirst 特性在系统加载时自动无感建表:

csharp
[SugarTable("cer_chat_message")]
public class cer_chat_message
{
    [SugarColumn(IsPrimaryKey = true, IsIdentity = true)]
    public int id { get; set; }
    public int sender_id { get; set; }
    public int receiver_id { get; set; }
    [SugarColumn(ColumnDataType = "TEXT")]
    public string content { get; set; } = "";
    public DateTime send_time { get; set; } = DateTime.Now;
    public int is_read { get; set; } = 0;
}

2. 后端控制器实现 (ChatController.cs) ​

在 API 项目中直接使用 Dapper 或原始 ADO.NET (不依赖复杂的 EF Core Migrations) 以实现最高性能读写:

  • 提供消息发送、拉取、未读数统计。

3. 客户端即时通讯轮询核心 ​

采用 1.5 秒频率的 System.Windows.Forms.Timer 或 Task.Delay 轻量化后台高频轮询:

  • 每次轮询仅调用 GET /api/chat/unread 获取未读数和最新的未读消息包。
  • 若有属于当前激活会话的未读消息,立刻通过 chatList.AddToBottom() 追加到气泡流底部,并触发精致的滚动到底部动画,保持 100% 流畅性。

📈 任务执行计划 ​

mermaid
gantt
    title 即时通讯 (IM) 售后系统开发排期
    dateFormat  YYYY-MM-DD
    section 数据库与后端
    自动建表模型配置         :active, db_1, 2026-05-21, 1d
    后端 ChatController 实现  :api_1, after db_1, 1d
    section 客户端 UI 与交互
    ChatWindow 设计与排版    :ui_1, after db_1, 1d
    IM 高频轻量级轮询集成      :poll_1, after ui_1, 1d
    section 联调测试
    双端集成与自测          :test_1, after poll_1, 1d

🎯 验证方案 ​

1. 自动与手动测试 ​

  • 后端 API 响应测试:在本地/服务器运行 API 端口,使用 Postman 或 curl 测试发送消息与拉取历史接口。
  • 双端真实交互测试:
    • 在同一台电脑上开启两个客户端账户(例如“管理员”和“质检员”)。
    • 进行双向即时打字对话,确认双方的聊天气泡、头像、时间戳和未读数计数能无延迟平滑渲染。

IMPORTANT

设计美学提示: 聊天界面将完美集成 HSL 自适应色彩体系与圆角卡片流(Glassmorphism),彻底告别传统 WinForms 粗粝的网格界面,给用户带来如高档现代网页般丝滑、灵动的视觉体验。

UmiUDI & Drug 医疗器械与药品唯一标识全生命周期追溯系统