Add HttpMethodSorterDocumentFilter

Back/Configs/DocsConfigs.cs

@@ -39,6 +39,7 @@ public static void AddDocsConfigs(this IServiceCollection services)
             options.DocInclusionPredicate((name, api) => true);
 
             options.OperationFilter<AuthOperationsFilter>();
+            options.DocumentFilter<HttpMethodSorterDocumentFilter>();
 
             options.ExampleFilters();
 

Back/Filters/AuthOperationsFilter.cs

@@ -1,7 +1,6 @@
 using Microsoft.OpenApi.Models;
 using Swashbuckle.AspNetCore.SwaggerGen;
 using Microsoft.AspNetCore.Mvc.Controllers;
-using Syki.Back.Features.Cross.SkipUserRegister;
 
 namespace Syki.Back.Filters;
 

Back/Filters/HttpMethodSorterDocumentFilter.cs

@@ -0,0 +1,50 @@
+using Microsoft.OpenApi.Models;
+using Swashbuckle.AspNetCore.SwaggerGen;
+
+namespace Syki.Back.Filters;
+
+public class HttpMethodSorterDocumentFilter : IDocumentFilter
+{
+    public void Apply(OpenApiDocument document, DocumentFilterContext context)
+    {
+        // Order path groups (OpenApiPathItems) alphabetically
+        var pathKvps = document.Paths
+            .OrderBy(pathKvp =>
+            {
+                if (pathKvp.Value.Operations.Any(x => x.Key == OperationType.Post)) return 10;
+                if (pathKvp.Value.Operations.Any(x => x.Key == OperationType.Get)) return 20;
+                if (pathKvp.Value.Operations.Any(x => x.Key == OperationType.Put)) return 30;
+                if (pathKvp.Value.Operations.Any(x => x.Key == OperationType.Delete)) return 40;
+                return 50;
+            })
+            .ToList();
+
+        document.Paths.Clear();
+        pathKvps.ForEach(kvp => document.Paths.Add(kvp.Key, kvp.Value));
+
+        // Order operations by method within each group
+        document.Paths.ToList().ForEach(pathKvp =>
+        {
+            var operationKvps = pathKvp.Value.Operations
+                .OrderBy(kvp =>
+                {
+                    var weight = kvp.Key switch
+                    {
+                        OperationType.Post => 10,
+                        OperationType.Get => 20,
+                        OperationType.Put => 30,
+                        OperationType.Delete => 40,
+                        _ => 50,
+                    };
+                    return weight;
+                })
+                .ToList();
+
+            pathKvp.Value.Operations.Clear();
+            operationKvps.ForEach(operationKvp =>
+            {
+                pathKvp.Value.Operations.Add(operationKvp);
+            });
+        });
+    }
+}