docs: 完善身份模块文档注释与字段说明

src/Application/TakeoutSaaS.Application/Identity/Handlers/UpdateRoleCommandHandler.cs

@@ -14,6 +14,12 @@ public sealed class UpdateRoleCommandHandler(
     ITenantProvider tenantProvider)
     : IRequestHandler<UpdateRoleCommand, RoleDto?>
 {
+    /// <summary>
+    /// 执行角色更新。
+    /// </summary>
+    /// <param name="request">更新命令。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>更新后的角色 DTO 或 null。</returns>
     public async Task<RoleDto?> Handle(UpdateRoleCommand request, CancellationToken cancellationToken)
     {
         // 1. 获取租户上下文并查询角色