feat: 新增IM即时通讯(浮窗)、工作流、打印模块及工作台增强

- IM: 新增浮窗聊天(ImFloatWindow)、管理页(monitor/config/service/message)、SSE推送
- 工作流: 新增待办/我的流程页面及后端服务
- 打印: 新增打印模板、出库单打印(PrintPage)、模板种子脚本
- 工作台: 增强快捷入口与工作台数据
- 修复: TagsView页签关闭、CrudPage通用表格增强
- 移除导航菜单中的即时通讯入口,改为右下角浮窗
This commit is contained in:
2026-08-16 00:19:24 +08:00
parent 7235265749
commit 1bec470647
49 changed files with 5791 additions and 51 deletions
@@ -0,0 +1,219 @@
using F9MES.Common.Result;
using F9MES.Domain.BaseSys;
using F9MES.Domain.Common;
using F9MES.Domain.Im;
using FreeSql;
using System.Diagnostics;
using System.Text;
namespace F9MES.Application.Im;
/// <summary>IM 系统管理:性能监测 / 服务监测 / 配置管理 / 消息管理</summary>
public class ImAdminService
{
private readonly IFreeSql _db;
private readonly ImService _im;
public ImAdminService(IFreeSql db, ImService im)
{
_db = db;
_im = im;
}
// ==================== 性能监测 ====================
public async Task<object> PerformanceAsync()
{
var now = DateTime.Now;
var todayStart = now.Date;
var weekStart = todayStart.AddDays(-6);
var total = await _db.Select<Common_Message>().Where(m => m.Flag == 1).CountAsync();
var today = await _db.Select<Common_Message>()
.Where(m => m.Flag == 1 && m.SendTime >= todayStart).CountAsync();
var unread = await _db.Select<Common_Message>()
.Where(m => m.Flag == 1 && m.IsRead == 0).CountAsync();
// 近 7 天消息趋势
var weekRows = await _db.Select<Common_Message>()
.Where(m => m.Flag == 1 && m.SendTime >= weekStart)
.GroupBy(m => m.SendTime.Date)
.ToListAsync(g => new { Day = g.Key, Count = g.Count() });
var trendMap = weekRows.ToDictionary(x => x.Day.Date, x => x.Count);
var trend = new List<object>();
for (var d = weekStart; d <= todayStart; d = d.AddDays(1))
trend.Add(new { date = d.ToString("MM-dd"), count = trendMap.TryGetValue(d, out var c) ? c : 0 });
// 消息类型分布
var typeRows = await _db.Select<Common_Message>()
.Where(m => m.Flag == 1)
.GroupBy(m => m.MsgType)
.ToListAsync(g => new { Type = g.Key, Count = g.Count() });
var typeNames = new Dictionary<int, string>
{
{ 0, "系统通知" }, { 1, "业务提醒" }, { 2, "审批通知" }, { 3, "预警" }, { 4, "单聊消息" }
};
var typeDist = typeRows.Select(x => new { type = x.Type, name = typeNames.GetValueOrDefault(x.Type, $"类型{x.Type}"), count = x.Count }).ToList();
// 会话数:去重 发送人+接收人 组合(系统群发 SenderId=0 不参与)
var pairs = await _db.Select<Common_Message>()
.Where(m => m.Flag == 1 && m.SenderId != 0)
.ToListAsync(m => new { A = m.SenderId < m.UserId ? m.SenderId : m.UserId, B = m.SenderId < m.UserId ? m.UserId : m.SenderId });
var sessionCount = pairs.Select(p => $"{p.A}-{p.B}").Distinct().Count();
// 平均消息长度
var bodyLen = await _db.Select<Common_Message>()
.Where(m => m.Flag == 1 && m.Content != null)
.ToListAsync(m => m.Content ?? "");
var avgLen = bodyLen.Count == 0 ? 0 : (int)Math.Round(bodyLen.Average(s => Encoding.UTF8.GetByteCount(s)));
return new
{
total,
today,
unread,
online = _im.OnlineCount(),
sessions = sessionCount,
avgLen,
trend,
typeDist,
updatedAt = now.ToString("yyyy-MM-dd HH:mm:ss"),
};
}
// ==================== 服务监测 ====================
public async Task<object> ServiceStatusAsync()
{
var dbOk = false;
string dbDetail = "";
try
{
await _db.Ado.ExecuteScalarAsync("SELECT 1");
dbOk = true;
dbDetail = _db.Ado.DataType.ToString();
}
catch (Exception ex)
{
dbDetail = ex.Message;
}
var lastMsg = await _db.Select<Common_Message>()
.Where(m => m.Flag == 1)
.OrderByDescending(m => m.SendTime)
.FirstAsync(m => m.SendTime);
var total = await _db.Select<Common_Message>().Where(m => m.Flag == 1).CountAsync();
var startTime = Process.GetCurrentProcess().StartTime;
var uptime = DateTime.Now - startTime;
var tableCountObj = await _db.Ado.ExecuteScalarAsync(
"SELECT COUNT(*) FROM information_schema.tables WHERE table_schema = DATABASE()");
var tableCount = tableCountObj == null ? 0 : Convert.ToInt64(tableCountObj);
return new
{
apiStatus = "正常",
apiDetail = "HTTP API 响应正常",
dbStatus = dbOk ? "正常" : "异常",
dbDetail,
dbName = "f9webMySQL",
startTime = startTime.ToString("yyyy-MM-dd HH:mm:ss"),
uptime = $"{uptime.Days}天{uptime.Hours}小时{uptime.Minutes}分",
lastMsgTime = lastMsg == default ? "" : lastMsg.ToString("yyyy-MM-dd HH:mm:ss"),
totalMessages = total,
online = _im.OnlineCount(),
serverTime = DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss"),
tableCount,
};
}
// ==================== 配置管理 ====================
private static List<ImConfigInput> DefaultConfigs() => new()
{
new() { Key = "pollInterval", Name = "轮询间隔(秒)", Value = "5", },
new() { Key = "retainDays", Name = "消息保留天数", Value = "30", },
new() { Key = "defaultTitle", Name = "默认公告标题", Value = "系统公告", },
new() { Key = "maxBody", Name = "消息内容最大长度", Value = "500", },
};
/// <summary>读取配置(含默认值,数据库已存的覆盖)</summary>
public async Task<List<ImConfigInput>> GetConfigAsync()
{
var rows = await _db.Select<Im_Config>().ToListAsync();
var map = rows.ToDictionary(r => r.Key, r => new ImConfigInput { Key = r.Key, Value = r.Value, Name = r.Name });
var list = DefaultConfigs();
foreach (var item in list)
if (map.TryGetValue(item.Key, out var saved))
item.Value = saved.Value;
return list;
}
/// <summary>保存配置(按 Key 更新或插入)</summary>
public async Task SaveConfigAsync(List<ImConfigInput> inputs)
{
if (inputs == null || inputs.Count == 0) return;
foreach (var i in inputs)
{
var exists = await _db.Select<Im_Config>().Where(c => c.Key == i.Key).FirstAsync();
if (exists == null)
{
await _db.Insert(new Im_Config { Key = i.Key, Value = i.Value, Name = i.Name, Flag = 1 }).ExecuteAffrowsAsync();
}
else
{
await _db.Update<Im_Config>()
.Set(c => c.Value, i.Value)
.Set(c => c.Name, i.Name)
.Set(c => c.UpdateTime, DateTime.Now)
.Where(c => c.Key == i.Key)
.ExecuteAffrowsAsync();
}
}
}
// ==================== 消息管理 ====================
/// <summary>消息管理分页(msgType=-1 全部;kw 匹配标题/内容)</summary>
public async Task<PageResult<ImAdminMessageDto>> GetMessagesAsync(string? kw, int msgType, int page, int size)
{
var q = _db.Select<Common_Message>().Where(m => m.Flag == 1);
if (msgType >= 0) q = q.Where(m => m.MsgType == msgType);
if (!string.IsNullOrWhiteSpace(kw))
q = q.Where(m => m.Title.Contains(kw) || (m.Content != null && m.Content.Contains(kw)));
q = q.OrderByDescending(m => m.SendTime);
var total = await q.CountAsync();
var rows = await q.Skip((page - 1) * size).Take(size)
.ToListAsync(m => new { m.Id, m.SenderId, m.SenderName, m.UserId, m.Title, m.Content, m.MsgType, m.IsRead, m.SendTime });
var userIds = rows.Select(r => r.UserId).Distinct().ToList();
var users = await _db.Select<BaseSys_User>()
.Where(u => userIds.Contains(u.Id))
.ToListAsync(u => new { u.Id, u.Name });
var nameMap = users.ToDictionary(u => u.Id, u => u.Name);
var items = rows.Select(r => new ImAdminMessageDto
{
Id = r.Id,
SenderId = r.SenderId,
SenderName = r.SenderId == 0 ? "系统" : (r.SenderName ?? $"用户{r.SenderId}"),
ReceiverId = r.UserId,
ReceiverName = nameMap.TryGetValue(r.UserId, out var n) ? n : $"用户{r.UserId}",
Title = r.Title,
Content = r.Content ?? "",
MsgType = r.MsgType,
IsRead = r.IsRead,
SendTime = r.SendTime,
}).ToList();
return PageResult<ImAdminMessageDto>.From(page, size, total, items);
}
/// <summary>删除消息(软删)</summary>
public async Task<int> DeleteMessageAsync(long id)
{
return await _db.Update<Common_Message>()
.Set(m => m.Flag, 0)
.Where(m => m.Id == id)
.ExecuteAffrowsAsync();
}
}
+102
View File
@@ -0,0 +1,102 @@
namespace F9MES.Application.Im;
/// <summary>发送单聊消息入参</summary>
public class ImSendInput
{
/// <summary>接收人用户ID</summary>
public long PeerId { get; set; }
/// <summary>消息内容</summary>
public string Content { get; set; } = "";
}
/// <summary>标记已读入参</summary>
public class ImReadInput
{
/// <summary>对端用户ID(标记与该用户的所有未读)</summary>
public long PeerId { get; set; }
}
/// <summary>系统/业务通知入参(群发)</summary>
public class ImNotifyInput
{
/// <summary>接收人用户ID列表(空=全部启用用户)</summary>
public List<long>? UserIds { get; set; }
/// <summary>消息类型:0=系统通知 1=业务提醒 2=审批通知 3=预警</summary>
public int MsgType { get; set; } = 0;
/// <summary>标题</summary>
public string Title { get; set; } = "";
/// <summary>内容</summary>
public string Content { get; set; } = "";
}
/// <summary>会话条目</summary>
public class ImSessionDto
{
public long PeerId { get; set; }
public string PeerName { get; set; } = "";
public string? LastContent { get; set; }
public DateTime LastTime { get; set; }
public int Unread { get; set; }
public int MsgType { get; set; }
/// <summary>是否系统通知/公告会话(PeerId=0</summary>
public bool IsSystem { get; set; }
}
/// <summary>消息条目</summary>
public class ImMessageDto
{
public long Id { get; set; }
public long SenderId { get; set; }
public string SenderName { get; set; } = "";
public long ReceiverId { get; set; }
public string Content { get; set; } = "";
/// <summary>标题(系统通知/公告标题)</summary>
public string? Title { get; set; }
public int MsgType { get; set; }
public DateTime SendTime { get; set; }
/// <summary>是否我发出的</summary>
public bool Mine { get; set; }
/// <summary>是否系统通知/公告消息</summary>
public bool IsSystem { get; set; }
}
/// <summary>IM 配置项(读写入参/返回)</summary>
public class ImConfigInput
{
/// <summary>配置键</summary>
public string Key { get; set; } = "";
/// <summary>配置值</summary>
public string Value { get; set; } = "";
/// <summary>配置名称</summary>
public string Name { get; set; } = "";
}
/// <summary>IM 管理消息条目</summary>
public class ImAdminMessageDto
{
public long Id { get; set; }
/// <summary>发送人ID0=系统)</summary>
public long SenderId { get; set; }
/// <summary>发送人姓名</summary>
public string SenderName { get; set; } = "";
/// <summary>接收人ID</summary>
public long ReceiverId { get; set; }
/// <summary>接收人姓名</summary>
public string ReceiverName { get; set; } = "";
/// <summary>标题</summary>
public string Title { get; set; } = "";
/// <summary>内容</summary>
public string Content { get; set; } = "";
/// <summary>消息类型:0=系统 1=业务 2=审批 3=预警 4=单聊</summary>
public int MsgType { get; set; }
/// <summary>是否已读</summary>
public int IsRead { get; set; }
/// <summary>发送时间</summary>
public DateTime SendTime { get; set; }
}
@@ -0,0 +1,108 @@
using System.Collections.Concurrent;
using System.Text.Json;
using Microsoft.AspNetCore.Http;
namespace F9MES.Application.Im;
/// <summary>
/// IM SSE 长连接中枢(单例):
/// 维护 userId -> 连接集合,向在线客户端实时推送新消息/通知。
/// 客户端通过 GET /api/im/events 订阅,服务端在消息落库后推送。
/// </summary>
public class ImEventHub
{
private readonly ConcurrentDictionary<long, List<ImSseClient>> _clients = new();
private static readonly JsonSerializerOptions JsonOpts = new()
{
PropertyNamingPolicy = JsonNamingPolicy.CamelCase
};
/// <summary>当前已建立 SSE 长连接的用户数</summary>
public int OnlineCount => _clients.Count;
/// <summary>订阅:注册连接并保持到请求取消(客户端断开/服务端关闭)</summary>
public async Task SubscribeAsync(long userId, HttpResponse response, CancellationToken ct)
{
var client = new ImSseClient(userId, response);
var list = _clients.GetOrAdd(userId, _ => new List<ImSseClient>());
lock (list) list.Add(client);
try
{
// 握手事件:客户端可据此确认连接成功
await client.WriteEventAsync("connected", "{}");
// 心跳:每 20s 发注释行,防止代理/网关超时断开
using var timer = new PeriodicTimer(TimeSpan.FromSeconds(20));
try
{
while (await timer.WaitForNextTickAsync(ct))
await client.WriteCommentAsync("ping");
}
catch (OperationCanceledException) { /* 客户端断开 */ }
}
finally
{
lock (list) list.Remove(client);
if (list.Count == 0) _clients.TryRemove(userId, out _);
}
}
/// <summary>向指定用户推送事件</summary>
public async Task PushToUserAsync(long userId, object data)
{
var payload = JsonSerializer.Serialize(data, JsonOpts);
await PushRawAsync(userId, payload);
}
/// <summary>向多个用户推送同一事件(按用户去重)</summary>
public async Task PushToUsersAsync(IEnumerable<long> userIds, object data)
{
var payload = JsonSerializer.Serialize(data, JsonOpts);
var done = new HashSet<long>();
foreach (var uid in userIds)
{
if (done.Add(uid)) await PushRawAsync(uid, payload);
}
}
private async Task PushRawAsync(long userId, string payload)
{
if (!_clients.TryGetValue(userId, out var list)) return;
List<ImSseClient> snapshot;
lock (list) snapshot = list.ToList();
foreach (var c in snapshot)
await c.WriteEventAsync("message", payload);
}
}
/// <summary>单个 SSE 连接(写入失败即视为已断开,静默忽略)</summary>
public class ImSseClient
{
public long UserId { get; }
private readonly HttpResponse _response;
public ImSseClient(long userId, HttpResponse response)
{
UserId = userId;
_response = response;
}
public async Task WriteEventAsync(string eventName, string data)
{
try
{
await _response.WriteAsync($"event: {eventName}\ndata: {data}\n\n");
await _response.Body.FlushAsync();
}
catch { /* 连接已断开 */ }
}
public async Task WriteCommentAsync(string text)
{
try
{
await _response.WriteAsync($": {text}\n\n");
await _response.Body.FlushAsync();
}
catch { /* 忽略 */ }
}
}
@@ -0,0 +1,262 @@
using F9MES.Common.Auth;
using F9MES.Common.Cache;
using F9MES.Domain.Common;
using F9MES.Domain.BaseSys;
using FreeSql;
namespace F9MES.Application.Im;
/// <summary>轻量级 IM:单聊消息 + 系统通知</summary>
public class ImService
{
private const string ActiveKeyPrefix = "im:active:";
private readonly IFreeSql _db;
private readonly CurrentUserService _currentUser;
private readonly CacheService _cache;
private readonly ImEventHub _hub;
public ImService(IFreeSql db, CurrentUserService currentUser, CacheService cache, ImEventHub hub)
{
_db = db;
_currentUser = currentUser;
_cache = cache;
_hub = hub;
}
/// <summary>记录当前用户活跃时间(SSE 订阅 / 接口调用时触发)</summary>
public void TouchActive()
{
var me = _currentUser.UserId;
if (me > 0) _cache.Set(ActiveKeyPrefix + me, DateTime.Now, 60);
}
/// <summary>当前在线用户数(SSE 长连接数为准,缓存活跃估算兜底)</summary>
public int OnlineCount() => Math.Max(_hub.OnlineCount, _cache.CountByPrefix(ActiveKeyPrefix));
/// <summary>会话列表:按对端聚合最后一条消息 + 未读数(系统通知/公告聚合为 peerId=0 会话并置顶)</summary>
public async Task<List<ImSessionDto>> GetSessionsAsync()
{
TouchActive();
var me = _currentUser.UserId;
var msgs = await _db.Select<Common_Message>()
.Where(m => m.Flag == 1 && (m.UserId == me || m.SenderId == me))
.OrderByDescending(m => m.SendTime)
.Limit(500)
.ToListAsync(m => new { m.Id, m.SenderId, m.UserId, m.Content, m.Title, m.SendTime, m.MsgType, m.IsRead });
// 按对端聚合(系统通知 SenderId=0 统一聚合为 peerId=0 的"系统通知"会话)
var dict = new Dictionary<long, ImSessionDto>();
foreach (var m in msgs)
{
long peerId;
bool isSystem;
if (m.SenderId == 0)
{
if (m.UserId != me) continue; // 只看发给我的系统通知
peerId = 0;
isSystem = true;
}
else
{
peerId = m.SenderId == me ? m.UserId : m.SenderId;
if (peerId == me || peerId == 0) continue; // 跳过自聊
isSystem = false;
}
if (!dict.TryGetValue(peerId, out var s))
{
s = new ImSessionDto
{
PeerId = peerId,
PeerName = isSystem ? "系统通知" : "",
IsSystem = isSystem,
};
dict[peerId] = s;
}
if (s.LastTime < m.SendTime)
{
s.LastTime = m.SendTime;
s.LastContent = isSystem && !string.IsNullOrEmpty(m.Title) ? m.Title : m.Content;
s.MsgType = m.MsgType;
}
// 未读:接收者是我且未读
if (m.UserId == me && m.IsRead == 0)
s.Unread++;
}
var sessions = dict.Values
.OrderBy(s => s.IsSystem ? 0 : 1) // 系统通知/公告置顶
.ThenByDescending(s => s.LastTime)
.ToList();
// 补全对端用户姓名(系统会话除外)
var peerIds = sessions.Where(s => !s.IsSystem).Select(s => s.PeerId).Distinct().ToList();
if (peerIds.Count > 0)
{
var users = await _db.Select<BaseSys_User>()
.Where(u => peerIds.Contains(u.Id))
.ToListAsync(u => new { u.Id, u.Name });
var nameMap = users.ToDictionary(u => u.Id, u => u.Name);
foreach (var s in sessions)
if (!s.IsSystem)
s.PeerName = nameMap.TryGetValue(s.PeerId, out var n) ? n : $"用户{s.PeerId}";
}
return sessions;
}
/// <summary>聊天记录(分页;peerId=0 时查询系统通知/公告)</summary>
public async Task<(List<ImMessageDto> Items, int Total)> GetMessagesAsync(long peerId, int page, int size)
{
var me = _currentUser.UserId;
var query = _db.Select<Common_Message>().Where(m => m.Flag == 1);
if (peerId == 0)
{
// 系统通知/公告:发给我的系统消息
query = query.Where(m => m.SenderId == 0 && m.UserId == me);
}
else
{
query = query.Where(m =>
(m.UserId == me && m.SenderId == peerId) || (m.UserId == peerId && m.SenderId == me));
}
query = query.OrderByDescending(m => m.SendTime);
var total = await query.CountAsync();
var rows = await query.Skip((page - 1) * size).Take(size)
.ToListAsync(m => new { m.Id, m.SenderId, m.UserId, m.Content, m.Title, m.SendTime, m.MsgType });
// 补全对端姓名(系统通知对端即"系统通知")
string peerName = "系统通知";
if (peerId != 0)
{
var peer = await _db.Select<BaseSys_User>().Where(u => u.Id == peerId).FirstAsync();
peerName = string.IsNullOrEmpty(peer?.Name) ? $"用户{peerId}" : peer.Name;
}
var items = rows.Select(m => new ImMessageDto
{
Id = m.Id,
SenderId = m.SenderId,
SenderName = m.SenderId == me ? "我" : peerName,
ReceiverId = m.UserId,
Content = m.Content ?? "",
Title = m.Title,
MsgType = m.MsgType,
IsSystem = m.SenderId == 0,
SendTime = m.SendTime,
Mine = m.SenderId == me
}).ToList();
return (items, (int)total);
}
/// <summary>发送单聊消息(落库后向接收方 SSE 实时推送)</summary>
public async Task SendAsync(long peerId, string content)
{
var me = _currentUser.UserId;
if (peerId == me) throw new InvalidOperationException("不能给自己发送消息");
if (string.IsNullOrWhiteSpace(content)) throw new InvalidOperationException("消息内容不能为空");
var meName = _currentUser.User?.Name ?? "";
var now = DateTime.Now;
var id = await _db.Insert(new Common_Message
{
SenderId = me,
SenderName = meName,
UserId = peerId,
Title = "单聊消息",
Content = content,
MsgType = 4,
IsRead = 0,
SendTime = now,
Flag = 1,
Adder = me,
}).ExecuteIdentityAsync();
// 实时推送:仅推给接收方(发送方本地已刷新)
await _hub.PushToUserAsync(peerId, new ImMessageDto
{
Id = id,
SenderId = me,
SenderName = meName,
ReceiverId = peerId,
Title = "单聊消息",
Content = content,
MsgType = 4,
IsSystem = false,
SendTime = now,
Mine = false,
});
}
/// <summary>标记会话已读(peerId=0 时标记全部系统通知已读)</summary>
public async Task ReadAsync(long peerId)
{
var me = _currentUser.UserId;
var q = _db.Update<Common_Message>().Set(m => m.IsRead, 1);
if (peerId == 0)
q = q.Where(m => m.Flag == 1 && m.UserId == me && m.SenderId == 0 && m.IsRead == 0);
else
q = q.Where(m => m.Flag == 1 && m.UserId == me && m.SenderId == peerId && m.IsRead == 0);
await q.ExecuteAffrowsAsync();
}
/// <summary>未读消息总数(顶栏角标)</summary>
public async Task<int> GetUnreadCountAsync()
{
TouchActive();
var me = _currentUser.UserId;
return (int)await _db.Select<Common_Message>()
.Where(m => m.Flag == 1 && m.UserId == me && m.IsRead == 0)
.CountAsync();
}
/// <summary>系统/业务通知群发:给指定用户(空=全部启用用户)</summary>
public async Task<int> NotifyAsync(ImNotifyInput input)
{
var me = _currentUser.UserId;
var title = string.IsNullOrEmpty(input.Title) ? "系统通知" : input.Title;
List<long> userIds;
if (input.UserIds is { Count: > 0 })
userIds = input.UserIds;
else
userIds = await _db.Select<BaseSys_User>()
.Where(u => u.Flag == 1 && u.Status == 1)
.ToListAsync(u => u.Id);
if (userIds.Count == 0) return 0;
var now = DateTime.Now;
var msgs = userIds.Select(uid => new Common_Message
{
SenderId = 0,
SenderName = "系统",
UserId = uid,
Title = title,
Content = input.Content,
MsgType = input.MsgType,
IsRead = 0,
SendTime = now,
Flag = 1,
Adder = me,
}).ToList();
await _db.Insert(msgs).ExecuteAffrowsAsync();
// 实时推送:给每个接收用户推送一条消息事件
foreach (var uid in userIds)
{
await _hub.PushToUserAsync(uid, new ImMessageDto
{
Id = 0,
SenderId = 0,
SenderName = "系统",
ReceiverId = uid,
Title = title,
Content = input.Content ?? "",
MsgType = input.MsgType,
IsSystem = true,
SendTime = now,
Mine = false,
});
}
return msgs.Count;
}
}