feat: add Go backend

2026-10-10 20:56:17 +08:00
parent 50fcfd2d3d
commit f6024f0964
1040 changed files with 107169 additions and 0 deletions
@@ -0,0 +1,30 @@
+// Package form
+// @Link  https://github.com/bufanyun/hotgo
+// @Copyright  Copyright (c) 2023 HotGo CLI
+// @Author  Ms <133814250@qq.com>
+// @License  https://github.com/bufanyun/hotgo/blob/master/LICENSE
+package form
+
+import "hotgo/internal/consts"
+
+// StatusReq 通用状态查询
+type StatusReq struct {
+	Status int `json:"status" v:"in:-1,0,1,2,3#输入的状态是无效的" dc:"状态"`
+}
+
+// SwitchReq 更新开关状态
+type SwitchReq struct {
+	Key   string `json:"key" v:"required#测试ID不能为空" dc:"开关字段"`
+	Value int    `json:"value" v:"in:1,2#输入的开关值是无效的" dc:"更新值"`
+}
+
+// AvatarGroup 头像组
+type AvatarGroup struct {
+	Name string `json:"name" dc:"姓名"`
+	Src  string `json:"src" dc:"头像地址"`
+}
+
+// DefaultMaxSort 默认最大排序
+func DefaultMaxSort(baseSort int) int {
+	return baseSort + consts.MaxSortIncr
+}
@@ -0,0 +1,68 @@
+// Package form
+// @Link  https://github.com/bufanyun/hotgo
+// @Copyright  Copyright (c) 2023 HotGo CLI
+// @Author  Ms <133814250@qq.com>
+// @License  https://github.com/bufanyun/hotgo/blob/master/LICENSE
+package form
+
+import (
+	"hotgo/internal/consts"
+)
+
+type ReqPageFunc interface {
+	GetPage() int
+	GetPerPage() int
+}
+
+// PageReq 分页请求
+type PageReq struct {
+	Page       int  `json:"page" example:"10" d:"1" v:"page@min:1#页码最小值不能低于1"  dc:"当前页码"`
+	PerPage    int  `json:"pageSize" example:"1" d:"10" v:"pageSize@min:1|max:200#每页数量最小值不能低于1|每页数量最大值不能大于200" dc:"每页数量"`
+	Pagination bool `json:"pagination" d:"true" dc:"是否需要进行分页"`
+}
+
+// GetPage 获取当前页码
+func (req *PageReq) GetPage() int {
+	return req.Page
+}
+
+// GetPerPage 获取每页数量
+func (req *PageReq) GetPerPage() int {
+	return req.PerPage
+}
+
+// PageRes 分页响应
+type PageRes struct {
+	PageReq
+	PageCount  int `json:"pageCount" example:"0"  dc:"分页个数"`
+	TotalCount int `json:"totalCount" example:"0" dc:"数据总行数"`
+}
+
+// Pack 打包分页数据
+func (res *PageRes) Pack(req ReqPageFunc, totalCount int) {
+	res.TotalCount = totalCount
+	res.PageCount = CalPageCount(totalCount, req.GetPerPage())
+	res.Page = req.GetPage()
+	res.PerPage = req.GetPerPage()
+}
+
+func CalPageCount(totalCount int, perPage int) int {
+	return (totalCount + perPage - 1) / perPage
+}
+
+// CalPage 计算分页偏移量
+func CalPage(page, perPage int) (newPage, newPerPage int, offset int) {
+	if page <= 0 {
+		newPage = consts.DefaultPage
+	} else {
+		newPage = page
+	}
+	if perPage <= 0 {
+		newPerPage = consts.DefaultPageSize
+	} else {
+		newPerPage = perPage
+	}
+
+	offset = (newPage - 1) * newPerPage
+	return
+}
@@ -0,0 +1,30 @@
+// Package form
+// @Link  https://github.com/bufanyun/hotgo
+// @Copyright  Copyright (c) 2023 HotGo CLI
+// @Author  Ms <133814250@qq.com>
+// @License  https://github.com/bufanyun/hotgo/blob/master/LICENSE
+package form
+
+import "github.com/gogf/gf/v2/util/gconv"
+
+// Selects 选项
+type Selects []*Select
+
+type Select struct {
+	Value    interface{} `json:"value"`
+	Label    string      `json:"label"`
+	Name     string      `json:"name"`
+	Disabled bool        `json:"disabled"`
+}
+
+func (p Selects) Len() int {
+	return len(p)
+}
+
+func (p Selects) Swap(i, j int) {
+	p[i], p[j] = p[j], p[i]
+}
+
+func (p Selects) Less(i, j int) bool {
+	return gconv.Int64(p[j].Value) > gconv.Int64(p[i].Value)
+}
@@ -0,0 +1,20 @@
+// Package form
+// @Link  https://github.com/bufanyun/hotgo
+// @Copyright  Copyright (c) 2023 HotGo CLI
+// @Author  Ms <133814250@qq.com>
+// @License  https://github.com/bufanyun/hotgo/blob/master/LICENSE
+package form
+
+// Sorter 排序器，兼容naiveUI
+type Sorter struct {
+	ColumnKey string `json:"columnKey"  dc:"排序字段"`
+	Order interface{} `json:"order"      dc:"排序方式 descend|ascend|false"`
+}
+
+type Sorters struct {
+	Sorters []*Sorter `json:"sorters"  dc:"排序器"`
+}
+
+func (s *Sorters) GetSorters() []*Sorter {
+	return s.Sorters
+}