 wonder
|
8898437e9e
|
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 元信息（标题、版本、联系方式、许可证、安全定义）
|
2026-07-15 11:33:00 +08:00 |
|
|
wonder
|
4f1df02f53
|
feat(server): 实现统一响应格式和错误码
- 添加 server/go.mod，模块路径为 github.com/1024XEngineer/xinfra/server
- 实现 response.go 统一 JSON 响应结构：
- 响应信封：{ code, message, data, details }
- 业务错误码 (10001-20002) 与 MVP 规范一致
- 便捷函数：Success, Error, BadRequest, Unauthorized 等
- 分页响应支持，包含 total 和 items
- 添加 recovery 中间件捕获 panic 并返回 500 错误
- 添加 logger 中间件记录请求日志
为所有后端处理器建立统一的 API 响应基础，与前端期望的格式保持一致。
|
2026-07-15 10:44:32 +08:00 |
|
mac