kra-oa/internal/server/README.md

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.