feat: 引入 CloudSync 核心能力并新增 Avalonia 桌面端与发布脚本

- 后端：新增 CloudSync 认证/权限/端点/服务与 DTO - 数据：新增用户/会话/安全策略实体与 EF Core migrations - 前端：新增云同步设置 UI、客户端与本地存储；Vite 支持 maui 构建输出到 wwwroot - 桌面端：新增 Avalonia 项目、内置 WebServer、托盘与 Windows 全局热键 - 发布/构建：新增 Windows/Linux 发布脚本与统一入口；调整 MAUI 资源与安装包配置 - 文档：同步更新 README/docs 与协作规则
2026-04-07 03:34:34 +08:00
parent 18d37fdd24
commit 7a4c516a20
85 changed files with 5774 additions and 127 deletions
@@ -0,0 +1,54 @@
+using Microsoft.AspNetCore.Http;
+
+namespace Hua.Todo.Application.CloudSync.Models;
+
+/// <summary>
+/// 云同步 API 错误响应生成器。
+/// </summary>
+public static class CloudApiErrors
+{
+    /// <summary>
+    /// 生成标准错误响应。
+    /// </summary>
+    /// <param name="statusCode">HTTP 状态码。</param>
+    /// <param name="code">业务错误码。</param>
+    /// <param name="message">错误消息。</param>
+    /// <returns>最小 API 结果。</returns>
+    public static IResult Error(int statusCode, string code, string message)
+    {
+        return Results.Json(
+            new ApiErrorResponse { Code = code, Message = message },
+            statusCode: statusCode);
+    }
+
+    /// <summary>
+    /// 未认证。
+    /// </summary>
+    public static IResult Unauthorized(string message = "Unauthorized.")
+        => Error(StatusCodes.Status401Unauthorized, "UNAUTHORIZED", message);
+
+    /// <summary>
+    /// 权限不足。
+    /// </summary>
+    public static IResult Forbidden(string message = "Forbidden.")
+        => Error(StatusCodes.Status403Forbidden, "FORBIDDEN", message);
+
+    /// <summary>
+    /// 需要二次认证（step-up）。
+    /// </summary>
+    public static IResult SecondFactorRequired(string message = "Second factor required.")
+        => Error(StatusCodes.Status403Forbidden, "SECOND_FACTOR_REQUIRED", message);
+
+    /// <summary>
+    /// 请求非法。
+    /// </summary>
+    public static IResult BadRequest(string message = "Bad request.")
+        => Error(StatusCodes.Status400BadRequest, "BAD_REQUEST", message);
+
+    /// <summary>
+    /// 资源不存在。
+    /// </summary>
+    public static IResult NotFound(string message = "Not found.")
+        => Error(StatusCodes.Status404NotFound, "NOT_FOUND", message);
+}
+