feat(server): 集成 Swagger API 文档

- 引入 swaggo/gin-swagger 和 swaggo/files 依赖
- 配置 Swagger UI 路由 /swagger/*
- 为测试 handler 函数添加 Swagger 注解
- 将 main.go 中的内联 handler 重构到 handler/test.go 以支持注解
- 生成 Swagger 文档 (docs.go, swagger.json, swagger.yaml)
- Makefile 新增 make swagger 命令
- .gitignore 添加 server/docs/ 以跟踪生成的文档
- 添加 API 元信息（标题、版本、联系方式、许可证、安全定义）

This commit is contained in:

hezhaohui

2026-07-15 11:33:00 +08:00

parent 659ff617a4

commit 8898437e9e

9 changed files with 1200 additions and 49 deletions

.gitignore

View File

@@ -51,5 +51,6 @@ docker-compose.override.yml
 # Documentation & local dev config (not tracked in repo)
 docs/
 !server/docs/
 CLAUDE.md
 AGENTS.md