fix: harden auth flows and align api contracts

cmd/server/main.go

@@ -3,10 +3,16 @@ package main
 import (
 	"log"
 
+	_ "github.com/user-management-system/docs"
 	"github.com/user-management-system/internal/config"
 	"github.com/user-management-system/internal/server"
 )
 
+// @title User Management System API
+// @version 1.0
+// @description API for user management, authentication, authorization, and administration.
+// @BasePath /api/v1
+// @schemes http https
 func main() {
 	// 加载配置
 	cfg, err := config.Load()