feat: 完善统一端点响应与请求绑定框架

- 新增 IApiResponse 统一响应契约，覆盖普通响应和分页响应
- 扩展端点映射，支持 IApiResponse 和带请求 DTO 的 MapXxx 重载
- 增加 Body、Query、Route Values 到请求 DTO 的自动绑定
- 增加 PC 端路由模式匹配，支持 {id} 和 {id:int}
- API 与 PC 端点上下文补充路由参数传递
- 调整 OpenAPI 请求类型处理，避免 GET/DELETE 被标记为 JSON Body
- 鉴权端点迁移到强类型请求绑定和 IApiResponse 返回
- 增加统一端点文件流响应支持

Avalonia-Common/Core/ApiResponse.cs

@@ -2,12 +2,24 @@ using System.Text.Json.Serialization;
 
 namespace Avalonia_Common.Core
 {
+    /// <summary>
+    /// 统一端点响应契约。
+    /// </summary>
+    public interface IApiResponse
+    {
+        /// <summary>是否成功。</summary>
+        bool Success { get; }
+
+        /// <summary>业务状态码。</summary>
+        int Code { get; }
+    }
+
     /// <summary>
     /// 统一 API 返回格式。
     /// 所有接口的返回都包装为此格式，确保前端收到一致的数据结构。
     /// </summary>
     /// <typeparam name="T">业务数据类型</typeparam>
-    public class ApiResponse<T>
+    public class ApiResponse<T> : IApiResponse
     {
         /// <summary>是否成功</summary>
         [JsonPropertyName("success")]
@@ -113,7 +125,7 @@ namespace Avalonia_Common.Core
     /// <summary>
     /// 分页返回格式
     /// </summary>
-    public class PagedResponse<T>
+    public class PagedResponse<T> : IApiResponse
     {
         /// <summary>
         /// 获取或设置操作是否成功。