📝 docs: comprehensive Swagger documentation skill with hierarchical tagging

pkg/server/server.go

@@ -1,4 +1,4 @@
-//go:generate swag init -g ../../cmd/server/main.go
+//go:generate swag init -g ../../cmd/server/main.go  --parseDependency --parseInternal
 
 package server
 
@@ -136,7 +136,7 @@ func (s *Server) getAllMiddlewares() []func(http.Handler) http.Handler {
 // handleHealth godoc
 // @Summary Health check
 // @Description Check if the service is healthy
-// @Tags health
+// @Tags System/Health
 // @Accept json
 // @Produce json
 // @Success 200 {object} map[string]string "Service is healthy"
@@ -149,7 +149,7 @@ func (s *Server) handleHealth(w http.ResponseWriter, r *http.Request) {
 // handleReadiness godoc
 // @Summary Readiness check
 // @Description Check if the service is ready to accept traffic
-// @Tags health
+// @Tags System/Health
 // @Accept json
 // @Produce json
 // @Success 200 {object} map[string]bool "Service is ready"