doc: 增加代码注释

This commit is contained in:
2026-05-23 12:19:33 +08:00
parent 6801072671
commit 72497d8dc1
4 changed files with 18 additions and 8 deletions
+7 -3
View File
@@ -1,15 +1,19 @@
// Package model 定义请求/响应的数据结构。
package model
// Response 统一 API 响应格式,所有接口均返回此结构。
type Response struct {
Code int `json:"code"`
Message string `json:"message"`
Data any `json:"data,omitempty"`
Code int `json:"code"` // 业务状态码,0 表示成功
Message string `json:"message"` // 状态描述
Data any `json:"data,omitempty"` // 响应数据,错误时省略
}
// OK 构造成功响应。
func OK(data any) Response {
return Response{Code: 0, Message: "ok", Data: data}
}
// Fail 构造错误响应。
func Fail(code int, msg string) Response {
return Response{Code: code, Message: msg}
}