update

internal/pkg/response/response.go

@@ -0,0 +1,52 @@
+// Package response 统一 HTTP 响应结构。
+//
+// 响应形状严格沿用原项目，前端 (src/lib/api.ts、data.ts) 依赖这些字段名：
+//   - 列表：{ data, total, current_page, last_page, per_page }
+//   - 详情：{ data }
+//   - 错误：{ error }
+//
+// 集中在此处定义，避免各 handler 手写 gin.H 时出现字段拼写漂移。
+package response
+
+import "github.com/gin-gonic/gin"
+
+// Data 返回单个对象：{ "data": v }。
+func Data(c *gin.Context, status int, v any) {
+	c.JSON(status, gin.H{"data": v})
+}
+
+// Page 返回分页列表：{ data, total, current_page, last_page, per_page }。
+func Page(c *gin.Context, status int, data any, total int64, page, size int) {
+	c.JSON(status, gin.H{
+		"data":         data,
+		"total":        total,
+		"current_page": page,
+		"last_page":    LastPage(total, size),
+		"per_page":     size,
+	})
+}
+
+// Error 返回错误：{ "error": msg }。
+func Error(c *gin.Context, status int, msg string) {
+	c.JSON(status, gin.H{"error": msg})
+}
+
+// AbortError 中断请求并返回错误，供中间件使用。
+func AbortError(c *gin.Context, status int, msg string) {
+	c.AbortWithStatusJSON(status, gin.H{"error": msg})
+}
+
+// LastPage 计算总页数；无数据时返回 1（与原项目一致，避免前端出现 0 页）。
+func LastPage(total int64, size int) int {
+	if size <= 0 {
+		return 1
+	}
+	last := int(total) / size
+	if int(total)%size > 0 {
+		last++
+	}
+	if last == 0 {
+		last = 1
+	}
+	return last
+}