Rogee
5dc0f89ac0
- Added `operator_user_id`, `biz_ref_type`, and `biz_ref_id` fields to the TenantLedger model for enhanced auditing and traceability. - Updated the tenant ledgers query generation to include new fields. - Introduced new API endpoint for retrieving tenant ledger records with filtering options based on the new fields. - Enhanced Swagger documentation to reflect the new endpoint and its parameters. - Created DTOs for admin ledger filtering and item representation. - Implemented the admin ledger retrieval logic in the tenant service. - Added database migration scripts to introduce new fields and indexes for efficient querying.
75 lines
7.1 KiB
Go
75 lines
7.1 KiB
Go
// Code generated by go.ipao.vip/gen. DO NOT EDIT.
|
||
// Code generated by go.ipao.vip/gen. DO NOT EDIT.
|
||
// Code generated by go.ipao.vip/gen. DO NOT EDIT.
|
||
|
||
package models
|
||
|
||
import (
|
||
"context"
|
||
"time"
|
||
|
||
"quyun/v2/pkg/consts"
|
||
|
||
"go.ipao.vip/gen"
|
||
)
|
||
|
||
const TableNameTenantLedger = "tenant_ledgers"
|
||
|
||
// TenantLedger mapped from table <tenant_ledgers>
|
||
type TenantLedger struct {
|
||
ID int64 `gorm:"column:id;type:bigint;primaryKey;autoIncrement:true;comment:主键ID：自增" json:"id"` // 主键ID：自增
|
||
TenantID int64 `gorm:"column:tenant_id;type:bigint;not null;comment:租户ID：多租户隔离关键字段；必须与 tenant_users.tenant_id 一致" json:"tenant_id"` // 租户ID：多租户隔离关键字段；必须与 tenant_users.tenant_id 一致
|
||
UserID int64 `gorm:"column:user_id;type:bigint;not null;comment:用户ID：余额账户归属用户；对应 tenant_users.user_id" json:"user_id"` // 用户ID：余额账户归属用户；对应 tenant_users.user_id
|
||
OrderID int64 `gorm:"column:order_id;type:bigint;comment:关联订单ID：购买/退款类流水应关联 orders.id；非订单类可为空" json:"order_id"` // 关联订单ID：购买/退款类流水应关联 orders.id；非订单类可为空
|
||
Type consts.TenantLedgerType `gorm:"column:type;type:character varying(32);not null;comment:流水类型：credit_topup/debit_purchase/credit_refund/freeze/unfreeze/adjustment；不同类型决定余额/冻结余额的变更方向" json:"type"` // 流水类型：credit_topup/debit_purchase/credit_refund/freeze/unfreeze/adjustment；不同类型决定余额/冻结余额的变更方向
|
||
Amount int64 `gorm:"column:amount;type:bigint;not null;comment:流水金额：分/最小货币单位；通常为正数，方向由 type 决定（由业务层约束）" json:"amount"` // 流水金额：分/最小货币单位；通常为正数，方向由 type 决定（由业务层约束）
|
||
BalanceBefore int64 `gorm:"column:balance_before;type:bigint;not null;comment:变更前可用余额：用于审计与对账回放" json:"balance_before"` // 变更前可用余额：用于审计与对账回放
|
||
BalanceAfter int64 `gorm:"column:balance_after;type:bigint;not null;comment:变更后可用余额：用于审计与对账回放" json:"balance_after"` // 变更后可用余额：用于审计与对账回放
|
||
FrozenBefore int64 `gorm:"column:frozen_before;type:bigint;not null;comment:变更前冻结余额：用于审计与对账回放" json:"frozen_before"` // 变更前冻结余额：用于审计与对账回放
|
||
FrozenAfter int64 `gorm:"column:frozen_after;type:bigint;not null;comment:变更后冻结余额：用于审计与对账回放" json:"frozen_after"` // 变更后冻结余额：用于审计与对账回放
|
||
IdempotencyKey string `gorm:"column:idempotency_key;type:character varying(128);not null;comment:幂等键：同一租户同一用户同一业务操作固定；用于防止重复落账（建议由业务层生成）" json:"idempotency_key"` // 幂等键：同一租户同一用户同一业务操作固定；用于防止重复落账（建议由业务层生成）
|
||
Remark string `gorm:"column:remark;type:character varying(255);not null;comment:备注：业务说明/后台操作原因等；用于审计" json:"remark"` // 备注：业务说明/后台操作原因等；用于审计
|
||
CreatedAt time.Time `gorm:"column:created_at;type:timestamp with time zone;not null;default:now();comment:创建时间：默认 now()" json:"created_at"` // 创建时间：默认 now()
|
||
UpdatedAt time.Time `gorm:"column:updated_at;type:timestamp with time zone;not null;default:now();comment:更新时间：默认 now()" json:"updated_at"` // 更新时间：默认 now()
|
||
OperatorUserID int64 `gorm:"column:operator_user_id;type:bigint;comment:操作者用户ID：谁触发该流水（admin/buyer/system）；用于审计与追责；可为空（历史数据或无法识别时）" json:"operator_user_id"` // 操作者用户ID：谁触发该流水（admin/buyer/system）；用于审计与追责；可为空（历史数据或无法识别时）
|
||
BizRefType string `gorm:"column:biz_ref_type;type:character varying(32);comment:业务引用类型：order/refund/topup/etc；与 biz_ref_id 组成可选的结构化幂等/追溯键" json:"biz_ref_type"` // 业务引用类型：order/refund/topup/etc；与 biz_ref_id 组成可选的结构化幂等/追溯键
|
||
BizRefID int64 `gorm:"column:biz_ref_id;type:bigint;comment:业务引用ID：与 biz_ref_type 配合使用（例如 orders.id）；用于对账与审计" json:"biz_ref_id"` // 业务引用ID：与 biz_ref_type 配合使用（例如 orders.id）；用于对账与审计
|
||
Order *Order `gorm:"foreignKey:OrderID;references:ID" json:"order,omitempty"`
|
||
}
|
||
|
||
// Quick operations without importing query package
|
||
// Update applies changed fields to the database using the default DB.
|
||
func (m *TenantLedger) Update(ctx context.Context) (gen.ResultInfo, error) {
|
||
return Q.TenantLedger.WithContext(ctx).Updates(m)
|
||
}
|
||
|
||
// Save upserts the model using the default DB.
|
||
func (m *TenantLedger) Save(ctx context.Context) error {
|
||
return Q.TenantLedger.WithContext(ctx).Save(m)
|
||
}
|
||
|
||
// Create inserts the model using the default DB.
|
||
func (m *TenantLedger) Create(ctx context.Context) error {
|
||
return Q.TenantLedger.WithContext(ctx).Create(m)
|
||
}
|
||
|
||
// Delete removes the row represented by the model using the default DB.
|
||
func (m *TenantLedger) Delete(ctx context.Context) (gen.ResultInfo, error) {
|
||
return Q.TenantLedger.WithContext(ctx).Delete(m)
|
||
}
|
||
|
||
// ForceDelete permanently deletes the row (ignores soft delete) using the default DB.
|
||
func (m *TenantLedger) ForceDelete(ctx context.Context) (gen.ResultInfo, error) {
|
||
return Q.TenantLedger.WithContext(ctx).Unscoped().Delete(m)
|
||
}
|
||
|
||
// Reload reloads the model from database by its primary key and overwrites current fields.
|
||
func (m *TenantLedger) Reload(ctx context.Context) error {
|
||
fresh, err := Q.TenantLedger.WithContext(ctx).GetByID(m.ID)
|
||
if err != nil {
|
||
return err
|
||
}
|
||
*m = *fresh
|
||
return nil
|
||
}
|