外观
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 -- "查询未读" --> DB1. 数据库存储方案
在现有中央 MySQL 数据库 umi_basic_cer 中,设计用于存储聊天记录的表 cer_chat_message:
| 字段名 | 类型 | 约束 | 说明 |
|---|---|---|---|
| id | INT | PRIMARY KEY, AUTO_INCREMENT | 唯一消息ID |
| sender_id | INT | NOT NULL | 发送方用户ID (cer_user.id) |
| receiver_id | INT | NOT NULL | 接收方用户ID (cer_user.id) |
| content | TEXT | NOT NULL | 消息内容(支持富文本/Base64图片) |
| send_time | DATETIME | NOT NULL | 发送时间 |
| is_read | INT | NOT 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 粗粝的网格界面,给用户带来如高档现代网页般丝滑、灵动的视觉体验。