chore: 初始开源发布

iotlcm-admin-svr：管理后台服务。 - Go module：iotlcm → git.5iot.com/iotlcm-public/iotlcm-admin-svr（729 文件） - 凭据与地址脱敏：JWT signingKey（含代码里的 MustGet 默认值）、 MySQL DSN、Redis 口令、告警邮件发件人邮箱全部改为占位；私网 IP → 文档地址段；库名 xiujie_admin → iotlcm - 真实手机号/邮箱 → 合法 11 位编造号 / example.com - 移除内部资产：CI 触发器、过时 DDL（sql/db_iotlcm.sql）、私有依赖 go get 行、明文 registry 登录口令 - 启动 banner 统一 IOTLCM 方块字 + 社区惯例署名 - Dockerfile 改用公共基础镜像 - 拼错的 RADEME.md → README.md，README 重写 - 需要真实数据库的用例改为可用 IOTLCM_TEST_WITH_DB=1 显式启用 - 补 Apache-2.0 LICENSE，LF 行尾 + .gitattributes 数据库 schema 不随本仓发布（生产 DDL 已过时），README 已说明。
2026-10-23 14:46:05 +08:00
commit 59eb34976a
1132 changed files with 138197 additions and 0 deletions
@@ -0,0 +1,289 @@
+// Package gen
+// @Link  https://github.com/xiujiecn/xiu-admin
+// @Copyright  Copyright (c) 2026 LiXiujie
+// @Author  Lxj <li@xiujie.cn>
+// @License  https://github.com/xiujiecn/xiu-admin/blob/master/LICENSE
+// @AutoGenerate Version
+package common
+
+import (
+	"context"
+	"fmt"
+	"git.5iot.com/iotlcm-public/iotlcm-admin-svr/internal/dao"
+	"git.5iot.com/iotlcm-public/iotlcm-admin-svr/internal/library/contexts"
+	"git.5iot.com/iotlcm-public/iotlcm-admin-svr/internal/library/xgorm/handler"
+	"git.5iot.com/iotlcm-public/iotlcm-admin-svr/internal/library/xgorm/hook"
+	"git.5iot.com/iotlcm-public/iotlcm-admin-svr/internal/model"
+	"git.5iot.com/iotlcm-public/iotlcm-admin-svr/internal/service"
+	"git.5iot.com/iotlcm-public/iotlcm-admin-svr/utility/convert"
+	"git.5iot.com/iotlcm-public/iotlcm-admin-svr/utility/excel"
+
+	"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/os/gtime"
+	"github.com/gogf/gf/v2/util/gconv"
+)
+
+type sCommonTFinWithdrawableChange struct{}
+
+func NewCommonTFinWithdrawableChange() *sCommonTFinWithdrawableChange {
+	return &sCommonTFinWithdrawableChange{}
+}
+
+func init() {
+	service.RegisterCommonTFinWithdrawableChange(NewCommonTFinWithdrawableChange())
+}
+
+// Model 可提现变动明细表ORM模型
+func (s *sCommonTFinWithdrawableChange) Model(ctx context.Context, option ...*handler.Option) *gdb.Model {
+	if len(option) == 0 {
+		option = append(option, &handler.Option{
+			FilterTenant: true,
+			FilterAuth:   true,
+		})
+	}
+	return handler.Model(dao.TFinWithdrawableChange.Ctx(ctx), option...)
+}
+
+// List 获取可提现变动明细表列表
+func (s *sCommonTFinWithdrawableChange) List(ctx context.Context, in *model.TFinWithdrawableChangeListParam) (list []*model.TFinWithdrawableChangeListModel, totalCount int, err error) {
+
+	mod := dao.TFinWithdrawableChange.Ctx(ctx)
+	sysDeptTable := dao.SysDept.Table()
+	orderTable := dao.TOrder.Table()
+	// mod = mod.FieldsPrefix(dao.TSimCardInfo.Table(), model.TSimCardInfoListModel{})
+	// mod = mod.Fields(simChannels + ".chan_name as chanName, chan_alias as chanAlias")
+
+	mod = mod.FieldsPrefix(dao.TFinWithdrawableChange.Table(), model.TFinWithdrawableChangeListModel{})
+	mod = mod.Fields(sysDeptTable + ".dept_name as deptName")
+	mod = mod.Fields(orderTable + ".order_type as orderType")
+
+	deptId := contexts.GetDeptId(ctx)
+
+	// 字段过滤
+	mod = mod.Where(dao.TFinWithdrawableChange.Columns().DeptId, deptId)
+
+	// 查询主键ID
+	if in.Id > 0 {
+		mod = mod.Where(dao.TFinWithdrawableChange.Columns().Id, in.Id)
+	}
+	// 查询月份范围（根据 account_period 字段）
+	if len(in.Month) == 2 {
+		mod = mod.WhereGTE(dao.TFinWithdrawableChange.Columns().AccountPeriod, in.Month[0])
+		mod = mod.WhereLTE(dao.TFinWithdrawableChange.Columns().AccountPeriod, in.Month[1])
+	}
+	// 查询收支类型
+	if in.IncomeExpenseType != nil {
+		mod = mod.Where(dao.TFinWithdrawableChange.Columns().IncomeExpenseType, *in.IncomeExpenseType)
+	}
+	// 查询变动类型
+	if in.ChangeType != nil {
+		mod = mod.Where(dao.TFinWithdrawableChange.Columns().ChangeType, *in.ChangeType)
+	}
+	// 查询账期
+	if in.AccountPeriod != "" {
+		mod = mod.Where(dao.TFinWithdrawableChange.Columns().AccountPeriod, in.AccountPeriod)
+	}
+
+	mod = mod.LeftJoin(sysDeptTable, dao.TFinWithdrawableChange.Table()+"."+dao.TFinWithdrawableChange.Columns().DeptId+" COLLATE utf8mb4_general_ci="+sysDeptTable+"."+dao.SysDept.Columns().DeptId)
+	mod = mod.LeftJoin(orderTable, dao.TFinWithdrawableChange.Table()+"."+dao.TFinWithdrawableChange.Columns().SourceNo+" COLLATE utf8mb4_general_ci="+orderTable+"."+dao.TOrder.Columns().OrderSn)
+
+	// 分页
+	mod = mod.Page(in.Page, in.PageSize)
+
+	// 排序
+	mod = mod.OrderDesc(dao.TFinWithdrawableChange.Columns().Id)
+
+	// 操作人摘要信息
+	mod = mod.Hook(hook.MemberSummary)
+
+	// 查询数据
+	if err = mod.ScanAndCount(&list, &totalCount, false); err != nil {
+		err = gerror.Wrap(err, "获取可提现变动明细表列表失败，请稍后重试！")
+		return
+	}
+	// 根据 TransactionTime 赋值账期
+	for i := range list {
+		if list[i].CreatedAt != nil {
+			list[i].TradingMonth = list[i].CreatedAt.Format("Y-m")
+		}
+	}
+	return
+}
+
+// Export 导出可提现变动明细表
+func (s *sCommonTFinWithdrawableChange) Export(ctx context.Context, in *model.TFinWithdrawableChangeListParam) (err error) {
+	list, totalCount, err := s.List(ctx, in)
+	if err != nil {
+		return
+	}
+
+	// 字段的排序是依据tags的字段顺序，如果你不想使用默认的排序方式，可以直接定义 tags = []string{"字段名称", "字段名称2", ...}
+	tags, err := convert.GetEntityDescTags(model.TFinWithdrawableChangeExportModel{})
+	if err != nil {
+		return
+	}
+
+	var (
+		fileName  = "导出可提现变动明细表-" + gctx.CtxId(ctx)
+		sheetName = fmt.Sprintf("索引条件共%v行,共%v页,当前导出是第%v页,本页共%v行", totalCount, (totalCount+in.PageSize-1)/in.PageSize, in.Page, len(list))
+		exports   []model.TFinWithdrawableChangeExportModel
+	)
+
+	if err = gconv.Scan(list, &exports); err != nil {
+		return
+	}
+
+	err = excel.ExportByStructs(ctx, tags, exports, fileName, sheetName)
+	return
+}
+
+// Edit 修改/新增可提现变动明细表
+func (s *sCommonTFinWithdrawableChange) Edit(ctx context.Context, in *model.TFinWithdrawableChangeEditParam) (err error) {
+	return g.DB().Transaction(ctx, func(ctx context.Context, tx gdb.TX) (err error) {
+
+		// 修改
+		if in.Id > 0 {
+			updatedBy := contexts.GetUserId(ctx)
+			in.UpdatedBy = &updatedBy
+			in.UpdatedAt = gtime.Now()
+			if _, err = s.Model(ctx).
+				Fields(model.TFinWithdrawableChangeUpdateFields{}).
+				WherePri(in.Id).Data(in).Update(); err != nil {
+				err = gerror.Wrap(err, "修改可提现变动明细表失败，请稍后重试！")
+			}
+			return
+		}
+
+		// 新增
+		tenantId := contexts.GetTenantId(ctx)
+		in.TenantId = &tenantId
+		createdDept := contexts.GetDeptId(ctx)
+		in.CreatedDept = &createdDept
+		createdBy := contexts.GetUserId(ctx)
+		in.CreatedBy = &createdBy
+		in.CreatedAt = gtime.Now()
+		if _, err = s.Model(ctx, &handler.Option{FilterAuth: false}).
+			Fields(model.TFinWithdrawableChangeInsertFields{}).
+			Data(in).Insert(); err != nil {
+			err = gerror.Wrap(err, "新增可提现变动明细表失败，请稍后重试！")
+		}
+		return
+	})
+}
+
+// Delete 删除可提现变动明细表
+func (s *sCommonTFinWithdrawableChange) Delete(ctx context.Context, in *model.TFinWithdrawableChangeDeleteParam) (err error) {
+
+	if _, err = s.Model(ctx).WherePri(in.Id).Unscoped().Delete(); err != nil {
+		err = gerror.Wrap(err, "删除可提现变动明细表失败，请稍后重试！")
+		return
+	}
+	return
+}
+
+// View 获取可提现变动明细表指定信息
+func (s *sCommonTFinWithdrawableChange) View(ctx context.Context, in *model.TFinWithdrawableChangeViewParam) (res *model.TFinWithdrawableChangeViewModel, err error) {
+	if err = s.Model(ctx).WherePri(in.Id).Hook(hook.MemberSummary).Scan(&res); err != nil {
+		err = gerror.Wrap(err, "获取可提现变动明细表信息，请稍后重试！")
+		return
+	}
+	return
+}
+
+// CreateBalanceTransferInChange 写入余额转可提现审核通过后的可提现金额变动明细。
+func (s *sCommonTFinWithdrawableChange) CreateBalanceTransferInChange(ctx context.Context, tx gdb.TX, in *model.TFinWithdrawableBalanceTransferInParam) error {
+	if in == nil {
+		return gerror.New("可提现变动明细参数不能为空")
+	}
+	tenantId := contexts.GetTenantId(ctx)
+	userId := contexts.GetUserId(ctx)
+	deptId := contexts.GetDeptId(ctx)
+	createdAt := gtime.Now()
+	columns := dao.TFinWithdrawableChange.Columns()
+	if _, err := tx.Ctx(ctx).Model(dao.TFinWithdrawableChange.Table()).Data(g.Map{
+		columns.DeptId:            in.DeptId,
+		columns.ChangeType:        financeWithdrawableChangeTypeBalanceTransferIn,
+		columns.IncomeExpenseType: financeIncomeExpenseIncome,
+		columns.ChangeAmount:      in.ChangeAmount,
+		columns.BeforeBalance:     in.BeforeBalance,
+		columns.AfterBalance:      in.AfterBalance,
+		columns.AccountType:       in.AccountType,
+		columns.BankName:          in.BankName,
+		columns.BankAccount:       in.BankAccount,
+		columns.AccountName:       in.AccountName,
+		columns.IdentityCard:      in.IdentityCard,
+		columns.SourceNo:          in.SourceNo,
+		columns.Remark:            in.Remark,
+		columns.AccountPeriod:     in.AccountPeriod,
+		columns.TenantId:          tenantId,
+		columns.CreatedDept:       deptId,
+		columns.CreatedBy:         userId,
+		columns.CreatedAt:         createdAt,
+	}).Insert(); err != nil {
+		return gerror.Wrap(err, "新增可提现变动明细失败，请稍后重试！")
+	}
+	return nil
+}
+
+// CreateCommissionSettlementChange 写入分润结算产生的可提现明细。
+func (s *sCommonTFinWithdrawableChange) CreateCommissionSettlementChange(ctx context.Context, tx gdb.TX, in *model.TFinWithdrawableCommissionSettlementParam) error {
+	if in == nil {
+		return gerror.New("分润结算可提现明细参数不能为空")
+	}
+	if in.DeptId <= 0 {
+		return gerror.New("机构ID不能为空")
+	}
+	if in.ChangeAmount <= 0 {
+		return gerror.New("分润结算金额必须大于0")
+	}
+	if in.AccountPeriod == "" {
+		return gerror.New("账期不能为空")
+	}
+	if in.SourceNo == "" {
+		return gerror.New("结算批次号不能为空")
+	}
+
+	tenantId := in.TenantId
+	if tenantId == "" {
+		tenantId = contexts.GetTenantId(ctx)
+	}
+	userId := in.CreatedBy
+	if userId <= 0 {
+		userId = contexts.GetUserId(ctx)
+	}
+	deptId := in.CreatedDept
+	if deptId <= 0 {
+		deptId = contexts.GetDeptId(ctx)
+	}
+	if deptId <= 0 {
+		deptId = in.DeptId
+	}
+	createdAt := in.CreatedAt
+	if createdAt == nil {
+		createdAt = gtime.Now()
+	}
+
+	columns := dao.TFinWithdrawableChange.Columns()
+	if _, err := tx.Ctx(ctx).Model(dao.TFinWithdrawableChange.Table()).Data(g.Map{
+		columns.DeptId:            in.DeptId,
+		columns.ChangeType:        financeWithdrawableChangeTypeCommission,
+		columns.IncomeExpenseType: financeIncomeExpenseIncome,
+		columns.ChangeAmount:      in.ChangeAmount,
+		columns.BeforeBalance:     in.BeforeBalance,
+		columns.AfterBalance:      in.AfterBalance,
+		columns.AccountType:       0,
+		columns.SourceNo:          in.SourceNo,
+		columns.Remark:            in.Remark,
+		columns.AccountPeriod:     in.AccountPeriod,
+		columns.TenantId:          tenantId,
+		columns.CreatedDept:       deptId,
+		columns.CreatedBy:         userId,
+		columns.CreatedAt:         createdAt,
+	}).Insert(); err != nil {
+		return gerror.Wrap(err, "新增分润结算可提现明细失败，请稍后重试！")
+	}
+	return nil
+}