feat: 添加用户权限洞察查询与示例

src/Application/TakeoutSaaS.Application/Identity/Queries/GetUserPermissionsQuery.cs

@@ -0,0 +1,15 @@
+using MediatR;
+using TakeoutSaaS.Application.Identity.Contracts;
+
+namespace TakeoutSaaS.Application.Identity.Queries;
+
+/// <summary>
+/// 按用户 ID 获取角色/权限概览。
+/// </summary>
+public sealed class GetUserPermissionsQuery : IRequest<UserPermissionDto?>
+{
+    /// <summary>
+    /// 用户 ID（雪花）。
+    /// </summary>
+    public long UserId { get; init; }
+}

src/Application/TakeoutSaaS.Application/Identity/Queries/SearchUserPermissionsQuery.cs

@@ -0,0 +1,36 @@
+using MediatR;
+using TakeoutSaaS.Application.Identity.Contracts;
+using TakeoutSaaS.Shared.Abstractions.Results;
+
+namespace TakeoutSaaS.Application.Identity.Queries;
+
+/// <summary>
+/// 按租户分页查询用户的角色/权限概览。
+/// </summary>
+public sealed class SearchUserPermissionsQuery : IRequest<PagedResult<UserPermissionDto>>
+{
+    /// <summary>
+    /// 关键字（账号或展示名称）。
+    /// </summary>
+    public string? Keyword { get; init; }
+
+    /// <summary>
+    /// 页码，从 1 开始。
+    /// </summary>
+    public int Page { get; init; } = 1;
+
+    /// <summary>
+    /// 每页条数。
+    /// </summary>
+    public int PageSize { get; init; } = 20;
+
+    /// <summary>
+    /// 排序字段（account/displayName/createdAt）。
+    /// </summary>
+    public string? SortBy { get; init; }
+
+    /// <summary>
+    /// 是否倒序。
+    /// </summary>
+    public bool SortDescending { get; init; } = true;
+}