Files
quyun-v2/backend/app/http/tenant/ledger_admin.go
Rogee 5dc0f89ac0 feat: add operator and business reference fields to tenant ledgers
- 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.
2025-12-22 21:35:10 +08:00

58 lines
1.5 KiB
Go

package tenant
import (
"quyun/v2/app/http/tenant/dto"
"quyun/v2/app/requests"
"quyun/v2/app/services"
"quyun/v2/database/models"
"github.com/gofiber/fiber/v3"
log "github.com/sirupsen/logrus"
)
// ledgerAdmin provides tenant-admin ledger audit endpoints.
//
// @provider
type ledgerAdmin struct{}
// adminLedgers
//
// @Summary 余额流水列表(租户管理/审计)
// @Tags Tenant
// @Accept json
// @Produce json
// @Param tenantCode path string true "Tenant Code"
// @Param filter query dto.AdminLedgerListFilter true "Filter"
// @Success 200 {object} requests.Pager{items=dto.AdminLedgerItem}
//
// @Router /t/:tenantCode/v1/admin/ledgers [get]
// @Bind tenant local key(tenant)
// @Bind tenantUser local key(tenant_user)
// @Bind filter query
func (*ledgerAdmin) adminLedgers(
ctx fiber.Ctx,
tenant *models.Tenant,
tenantUser *models.TenantUser,
filter *dto.AdminLedgerListFilter,
) (*requests.Pager, error) {
if err := requireTenantAdmin(tenantUser); err != nil {
return nil, err
}
if filter == nil {
filter = &dto.AdminLedgerListFilter{}
}
log.WithFields(log.Fields{
"tenant_id": tenant.ID,
"user_id": tenantUser.UserID,
"operator_user_id": filter.OperatorUserID,
"target_user_id": filter.UserID,
"type": filter.Type,
"order_id": filter.OrderID,
"biz_ref_type": filter.BizRefType,
"biz_ref_id": filter.BizRefID,
}).Info("tenant.admin.ledgers.list")
return services.Ledger.AdminLedgerPage(ctx.Context(), tenant.ID, filter)
}