发布v2.2.10版本，更新内容请查看：https://github.com/bufanyun/hotgo/tree/v2.0/docs/guide-zh-CN/addon-version-upgrade.md

server/addons/hgexample/logic/logic.go

@@ -0,0 +1,9 @@
+// ==========================================================================
+// Code generated by GoFrame CLI tool. DO NOT EDIT.
+// ==========================================================================
+
+package logic
+
+import (
+	_ "hotgo/addons/hgexample/logic/sys"
+)

server/addons/hgexample/logic/sys/config.go

@@ -0,0 +1,54 @@
+package sys
+
+import (
+	"context"
+	"github.com/gogf/gf/v2/util/gconv"
+	"hotgo/addons/hgexample/global"
+	"hotgo/addons/hgexample/model"
+	"hotgo/addons/hgexample/model/input/sysin"
+	"hotgo/addons/hgexample/service"
+	isc "hotgo/internal/service"
+)
+
+type sSysConfig struct{}
+
+func NewSysConfig() *sSysConfig {
+	return &sSysConfig{}
+}
+
+func init() {
+	service.RegisterSysConfig(NewSysConfig())
+}
+
+// GetBasic 获取基础配置
+func (s *sSysConfig) GetBasic(ctx context.Context) (conf *model.BasicConfig, err error) {
+	var in sysin.GetConfigInp
+	in.GetAddonsConfigInp.AddonName = global.GetSkeleton().Name
+	in.GetAddonsConfigInp.Group = "basic"
+	models, err := isc.SysAddonsConfig().GetConfigByGroup(ctx, in.GetAddonsConfigInp)
+	if err != nil {
+		return
+	}
+
+	err = gconv.Struct(models.List, &conf)
+	return
+}
+
+// GetConfigByGroup 获取指定分组配置
+func (s *sSysConfig) GetConfigByGroup(ctx context.Context, in sysin.GetConfigInp) (res *sysin.GetConfigModel, err error) {
+	in.GetAddonsConfigInp.AddonName = global.GetSkeleton().Name
+	models, err := isc.SysAddonsConfig().GetConfigByGroup(ctx, in.GetAddonsConfigInp)
+	if err != nil {
+		return
+	}
+
+	res = new(sysin.GetConfigModel)
+	res.List = models.List
+	return
+}
+
+// UpdateConfigByGroup 更新指定分组的配置
+func (s *sSysConfig) UpdateConfigByGroup(ctx context.Context, in sysin.UpdateConfigInp) error {
+	in.UpdateAddonsConfigInp.AddonName = global.GetSkeleton().Name
+	return isc.SysAddonsConfig().UpdateConfigByGroup(ctx, in.UpdateAddonsConfigInp)
+}

server/addons/hgexample/logic/sys/index.go

@@ -0,0 +1,35 @@
+// Package sys
+// @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 sys
+
+import (
+	"context"
+	"fmt"
+	"github.com/gogf/gf/v2/os/gtime"
+	"hotgo/addons/hgexample/global"
+	"hotgo/addons/hgexample/model/input/sysin"
+	"hotgo/addons/hgexample/service"
+	"hotgo/internal/library/contexts"
+)
+
+type sSysIndex struct{}
+
+func NewSysIndex() *sSysIndex {
+	return &sSysIndex{}
+}
+
+func init() {
+	service.RegisterSysIndex(NewSysIndex())
+}
+
+// Test 测试
+func (s *sSysIndex) Test(ctx context.Context, in sysin.IndexTestInp) (res *sysin.IndexTestModel, err error) {
+	res = new(sysin.IndexTestModel)
+	res.Name = in.Name
+	res.Module = fmt.Sprintf("当前插件模块是：%s，当前应用模块是：%s", global.GetSkeleton().Name, contexts.Get(ctx).Module)
+	res.Time = gtime.Now()
+	return
+}

server/addons/hgexample/logic/sys/table.go

@@ -0,0 +1,244 @@
+// Package sys
+// @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 sys
+
+import (
+	"context"
+	"fmt"
+	"github.com/gogf/gf/v2/database/gdb"
+	"github.com/gogf/gf/v2/errors/gerror"
+	"github.com/gogf/gf/v2/frame/g"
+	"github.com/gogf/gf/v2/os/gctx"
+	"github.com/gogf/gf/v2/util/gconv"
+	"hotgo/addons/hgexample/model/input/sysin"
+	"hotgo/addons/hgexample/service"
+	"hotgo/internal/consts"
+	"hotgo/internal/dao"
+	"hotgo/internal/library/contexts"
+	"hotgo/internal/library/hgorm"
+	"hotgo/internal/library/hgorm/handler"
+	"hotgo/internal/model/input/form"
+	"hotgo/utility/convert"
+	"hotgo/utility/excel"
+	"hotgo/utility/validate"
+)
+
+type sSysTable struct{}
+
+func NewSysTable() *sSysTable {
+	return &sSysTable{}
+}
+
+func init() {
+	service.RegisterSysTable(NewSysTable())
+}
+
+// Model Orm模型
+func (s *sSysTable) Model(ctx context.Context, option ...*handler.Option) *gdb.Model {
+	return handler.Model(dao.AddonHgexampleTable.Ctx(ctx), option...)
+}
+
+// List 获取列表
+func (s *sSysTable) List(ctx context.Context, in sysin.TableListInp) (list []*sysin.TableListModel, totalCount int, err error) {
+	mod := s.Model(ctx)
+
+	if in.Title != "" {
+		mod = mod.WhereLike(dao.AddonHgexampleTable.Columns().Title, "%"+in.Title+"%")
+	}
+
+	if in.Content != "" {
+		mod = mod.WhereLike(dao.AddonHgexampleTable.Columns().Content, "%"+in.Content+"%")
+	}
+
+	if in.Status > 0 {
+		mod = mod.Where(dao.AddonHgexampleTable.Columns().Status, in.Status)
+	}
+
+	if in.Switch > 0 {
+		mod = mod.Where(dao.AddonHgexampleTable.Columns().Switch, in.Switch)
+	}
+
+	if len(in.Price) > 0 {
+		if in.Price[0] > float64(0) && in.Price[1] > float64(0) {
+			mod = mod.WhereBetween(dao.AddonHgexampleTable.Columns().Price, in.Price[0], in.Price[1])
+		} else if in.Price[0] > float64(0) && in.Price[1] == float64(0) {
+			mod = mod.WhereGTE(dao.AddonHgexampleTable.Columns().Price, in.Price[0])
+		} else if in.Price[0] == float64(0) && in.Price[1] > float64(0) {
+			mod = mod.WhereLTE(dao.AddonHgexampleTable.Columns().Price, in.Price[1])
+		}
+	}
+
+	if in.ActivityAt != nil {
+		mod = mod.Where(dao.AddonHgexampleTable.Columns().ActivityAt, in.ActivityAt)
+	}
+
+	if len(in.CreatedAt) == 2 {
+		mod = mod.WhereBetween(dao.AddonHgexampleTable.Columns().CreatedAt, in.CreatedAt[0], in.CreatedAt[1])
+	}
+
+	if !in.Flag.IsNil() {
+		mod = mod.Where(fmt.Sprintf(`JSON_CONTAINS(%s,'%v')`, dao.AddonHgexampleTable.Columns().Flag, in.Flag))
+	}
+
+	if !in.Hobby.IsNil() {
+		mod = mod.Where(fmt.Sprintf(`JSON_CONTAINS(%s,'%v')`, dao.AddonHgexampleTable.Columns().Hobby, in.Hobby))
+	}
+
+	//// 关联表testCategory
+	//mod = mod.LeftJoin(hgorm.GenJoinOnRelation(
+	//	dao.AddonHgexampleTable.Table(), dao.AddonHgexampleTable.Columns().CategoryId, // 主表表名,关联条件
+	//	dao.AddonHgexampleTableCategory.Table(), "testCategory", dao.AddonHgexampleTableCategory.Columns().Id, // 关联表表名,别名,关联条件
+	//)...)
+	//
+	//mod = mod.Where(`testCategory.`+dao.AddonHgexampleTableCategory.Columns().Name, "微信公众号")
+
+	totalCount, err = mod.Clone().Count(1)
+	if err != nil {
+		err = gerror.Wrap(err, consts.ErrorORM)
+		return
+	}
+
+	if totalCount == 0 {
+		return
+	}
+
+	////关联表select
+	//fields, err := hgorm.GenJoinSelect(ctx, sysin.TableListModel{}, dao.AddonHgexampleTable, []*hgorm.Join{
+	//	{Dao: dao.AddonHgexampleTableCategory, Alias: "testCategory"},
+	//	//{Dao: dao.AddonHgexampleTableCategory, Alias: "testCategory"},
+	//})
+
+	fields, err := hgorm.GenSelect(ctx, sysin.TableListModel{}, dao.AddonHgexampleTable)
+	if err != nil {
+		return
+	}
+
+	if err = mod.Fields(fields).Page(in.Page, in.PerPage).OrderAsc(dao.AddonHgexampleTable.Columns().Sort).OrderDesc(dao.AddonHgexampleTable.Columns().Id).Scan(&list); err != nil {
+		err = gerror.Wrap(err, consts.ErrorORM)
+		return
+	}
+	return
+}
+
+// Export 导出
+func (s *sSysTable) Export(ctx context.Context, in sysin.TableListInp) (err error) {
+	list, totalCount, err := s.List(ctx, in)
+	if err != nil {
+		return
+	}
+
+	// 字段的排序是依据tags的字段顺序，如果你不想使用默认的排序方式，可以直接定义 tags = []string{"字段名称", "字段名称2", ...}
+	tags, err := convert.GetEntityDescTags(sysin.TableExportModel{})
+	if err != nil {
+		return
+	}
+
+	var (
+		fileName  = "表格例子导出-" + gctx.CtxId(ctx) + ".xlsx"
+		sheetName = fmt.Sprintf("索引条件共%v行,共%v页,当前导出是第%v页,本页共%v行", totalCount, form.CalPageCount(totalCount, in.PerPage), in.Page, len(list))
+		exports   []sysin.TableExportModel
+	)
+
+	if err = gconv.Scan(list, &exports); err != nil {
+		return
+	}
+
+	if err = excel.ExportByStructs(ctx, tags, exports, fileName, sheetName); err != nil {
+		return
+	}
+	return
+}
+
+// Edit 修改/新增
+func (s *sSysTable) Edit(ctx context.Context, in sysin.TableEditInp) (err error) {
+	if err = hgorm.IsUnique(ctx, dao.AddonHgexampleTable, g.Map{dao.AddonHgexampleTable.Columns().Qq: in.Qq}, "QQ号码已存在，请换一个", in.Id); err != nil {
+		return
+	}
+
+	// 修改
+	if in.Id > 0 {
+		in.UpdatedBy = contexts.GetUserId(ctx)
+		_, err = s.Model(ctx).Where(dao.AddonHgexampleTable.Columns().Id, in.Id).Data(in).Update()
+		return
+	}
+
+	// 新增
+	in.CreatedBy = contexts.GetUserId(ctx)
+	_, err = s.Model(ctx, &handler.Option{FilterAuth: false}).Data(in).Insert()
+	return
+}
+
+// Delete 删除
+func (s *sSysTable) Delete(ctx context.Context, in sysin.TableDeleteInp) (err error) {
+	_, err = s.Model(ctx).Where(dao.AddonHgexampleTable.Columns().Id, in.Id).Delete()
+	return
+}
+
+// Status 更新状态
+func (s *sSysTable) Status(ctx context.Context, in sysin.TableStatusInp) (err error) {
+	if in.Id <= 0 {
+		err = gerror.New("ID不能为空")
+		return
+	}
+
+	if in.Status <= 0 {
+		err = gerror.New("状态不能为空")
+		return
+	}
+
+	if !validate.InSliceInt(consts.StatusMap, in.Status) {
+		err = gerror.New("状态不正确")
+		return
+	}
+
+	// 修改
+	_, err = s.Model(ctx).Where(dao.AddonHgexampleTable.Columns().Id, in.Id).Data(g.Map{
+		dao.AddonHgexampleTable.Columns().Status:    in.Status,
+		dao.AddonHgexampleTable.Columns().UpdatedBy: contexts.GetUserId(ctx),
+	}).Update()
+	return
+}
+
+// Switch 更新开关状态
+func (s *sSysTable) Switch(ctx context.Context, in sysin.TableSwitchInp) (err error) {
+	var fields = []string{
+		dao.AddonHgexampleTable.Columns().Switch,
+		// ...
+	}
+
+	if !validate.InSliceString(fields, in.Key) {
+		err = gerror.New("开关键名不在白名单")
+		return
+	}
+
+	// 修改
+	_, err = s.Model(ctx).Where(dao.AddonHgexampleTable.Columns().Id, in.Id).Data(g.Map{
+		in.Key: in.Value,
+		dao.AddonHgexampleTable.Columns().UpdatedBy: contexts.GetUserId(ctx),
+	}).Update()
+	return
+}
+
+// MaxSort 最大排序
+func (s *sSysTable) MaxSort(ctx context.Context, in sysin.TableMaxSortInp) (res *sysin.TableMaxSortModel, err error) {
+	if err = dao.AddonHgexampleTable.Ctx(ctx).Fields(dao.AddonHgexampleTable.Columns().Sort).OrderDesc(dao.AddonHgexampleTable.Columns().Sort).Scan(&res); err != nil {
+		err = gerror.Wrap(err, consts.ErrorORM)
+		return
+	}
+
+	if res == nil {
+		res = new(sysin.TableMaxSortModel)
+	}
+
+	res.Sort = form.DefaultMaxSort(ctx, res.Sort)
+	return
+}
+
+// View 获取指定信息
+func (s *sSysTable) View(ctx context.Context, in sysin.TableViewInp) (res *sysin.TableViewModel, err error) {
+	err = s.Model(ctx).Where(dao.AddonHgexampleTable.Columns().Id, in.Id).Scan(&res)
+	return
+}