优化结构

2026-08-21 10:29:14 +08:00
parent 56980c8087
commit 055f6811ca
340 changed files with 382 additions and 382 deletions
@@ -0,0 +1,12 @@
+# Server Layer
+
+The root package owns Gin server lifecycle and Swagger setup. HTTP concerns are
+grouped by role:
+
+- `handler/`: resource handlers and HTTP boundary validation
+- `middleware/`: request metadata, auth, access control, audit, recovery, CORS
+- `router/`: resource route registration and the system route registrar
+- `httpx/`: system adapter for shared response and cookie helpers
+
+Keep new files in the matching role directory instead of adding transport files
+to the root package.