feat(员工代收款): 新增员工代收款账单闭环
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 9m20s
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 9m20s
- 新增 6 张表与成对迁移 000212，扩展企业微信审批场景业务类型白名单 - 后台线下套餐订单与两条代理线下充值入账路径在来源成功事务内建账，来源唯一键幂等 - 核销申请、审批尝试记录、账单分摊预占与驳回重提，审批业务类型 employee_collection_approval - 企业微信终态消费幂等：通过转已核销、驳回释放预占、通过后撤销不回滚并转异常终态 - 退款成功事务内按 bill_id+refund_id 幂等冲销账单或仅写退款关联提示 - 线下收款方式字典、账单查询/统计/关闭、申请查询与代办权限，均写入事务内审计 OpenSpec Change: add-employee-collection-bills
This commit is contained in:
@@ -8,6 +8,7 @@ import (
|
||||
"gorm.io/gorm/clause"
|
||||
|
||||
approvalapp "github.com/break/junhong_cmp_fiber/internal/application/approval"
|
||||
employeecollectionapp "github.com/break/junhong_cmp_fiber/internal/application/employeecollection"
|
||||
walletapp "github.com/break/junhong_cmp_fiber/internal/application/wallet"
|
||||
"github.com/break/junhong_cmp_fiber/internal/model"
|
||||
"github.com/break/junhong_cmp_fiber/pkg/auditcontext"
|
||||
@@ -17,14 +18,20 @@ import (
|
||||
|
||||
// ApprovalDecisionHandler 将渠道无关审批终态应用到员工线下代充值业务。
|
||||
type ApprovalDecisionHandler struct {
|
||||
db *gorm.DB
|
||||
posting *walletapp.PostingService
|
||||
audit RechargeAuditWriter
|
||||
db *gorm.DB
|
||||
posting *walletapp.PostingService
|
||||
audit RechargeAuditWriter
|
||||
billCreation *employeecollectionapp.BillCreationService
|
||||
}
|
||||
|
||||
// NewApprovalDecisionHandler 创建员工线下代充值审批终态消费者。
|
||||
func NewApprovalDecisionHandler(db *gorm.DB, posting *walletapp.PostingService, audit RechargeAuditWriter) *ApprovalDecisionHandler {
|
||||
return &ApprovalDecisionHandler{db: db, posting: posting, audit: audit}
|
||||
func NewApprovalDecisionHandler(
|
||||
db *gorm.DB,
|
||||
posting *walletapp.PostingService,
|
||||
audit RechargeAuditWriter,
|
||||
billCreation *employeecollectionapp.BillCreationService,
|
||||
) *ApprovalDecisionHandler {
|
||||
return &ApprovalDecisionHandler{db: db, posting: posting, audit: audit, billCreation: billCreation}
|
||||
}
|
||||
|
||||
// Handle 幂等处理标准审批终态；只有 approved 首次入账，其他终态不修改钱包。
|
||||
@@ -32,6 +39,9 @@ func (h *ApprovalDecisionHandler) Handle(ctx context.Context, event approvalapp.
|
||||
if h == nil || h.db == nil || h.posting == nil || h.audit == nil {
|
||||
return errors.New(errors.CodeInternalError, "员工线下代充值审批终态能力未配置")
|
||||
}
|
||||
if h.billCreation == nil {
|
||||
return errors.New(errors.CodeInternalError, "员工代收款建账能力未配置")
|
||||
}
|
||||
if event.BusinessType != constants.ApprovalBusinessTypeOfflineRecharge || event.BusinessID == 0 || event.InstanceID == 0 {
|
||||
return errors.New(errors.CodeInvalidParam, "员工线下代充值审批终态参数无效")
|
||||
}
|
||||
@@ -99,6 +109,10 @@ func (h *ApprovalDecisionHandler) applyApproved(
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
// 员工代收款建账：锚点为“平台账号发起的线下充值入账成功”，按来源唯一键 recharge:{id} 幂等。
|
||||
if _, err := h.billCreation.CreateFromRechargeInTx(ctx, tx, record); err != nil {
|
||||
return err
|
||||
}
|
||||
if record.Status == constants.RechargeStatusCompleted && posting.AlreadyApplied {
|
||||
return nil
|
||||
}
|
||||
|
||||
671
internal/application/employeecollection/application.go
Normal file
671
internal/application/employeecollection/application.go
Normal file
@@ -0,0 +1,671 @@
|
||||
package employeecollection
|
||||
|
||||
import (
|
||||
"context"
|
||||
"fmt"
|
||||
"sort"
|
||||
"strings"
|
||||
"time"
|
||||
|
||||
"github.com/bytedance/sonic"
|
||||
"github.com/google/uuid"
|
||||
"gorm.io/gorm"
|
||||
"gorm.io/gorm/clause"
|
||||
|
||||
approvalapp "github.com/break/junhong_cmp_fiber/internal/application/approval"
|
||||
employeecollectiondomain "github.com/break/junhong_cmp_fiber/internal/domain/employeecollection"
|
||||
"github.com/break/junhong_cmp_fiber/internal/model"
|
||||
"github.com/break/junhong_cmp_fiber/pkg/constants"
|
||||
"github.com/break/junhong_cmp_fiber/pkg/errors"
|
||||
"github.com/break/junhong_cmp_fiber/pkg/middleware"
|
||||
)
|
||||
|
||||
// ApplicationAllocationCommand 描述核销申请中单张账单的本次分摊。
|
||||
type ApplicationAllocationCommand struct {
|
||||
BillID uint
|
||||
Amount int64
|
||||
}
|
||||
|
||||
// SubmitApplicationCommand 描述创建或重提核销申请的稳定输入。
|
||||
type SubmitApplicationCommand struct {
|
||||
PaymentMethodID uint
|
||||
PaidAmount int64
|
||||
PayerName string
|
||||
PaidAt time.Time
|
||||
ExternalTransactionNo string
|
||||
PaymentVoucherKeys []string
|
||||
Remark string
|
||||
ActingReason string
|
||||
Allocations []ApplicationAllocationCommand
|
||||
}
|
||||
|
||||
// ApplicationSubmitResult 返回已原子保存的申请、审批尝试记录与分摊。
|
||||
type ApplicationSubmitResult struct {
|
||||
Application *model.EmployeeCollectionApplication
|
||||
Attempt *model.EmployeeCollectionApplicationAttempt
|
||||
Allocations []*model.EmployeeCollectionApplicationAllocation
|
||||
Bills []*model.EmployeeCollectionBill
|
||||
InstanceID uint
|
||||
InstanceStatus int
|
||||
}
|
||||
|
||||
// ApplicationService 创建与重提核销申请。
|
||||
// 申请、审批尝试记录、审批实例与账单预占在同一事务完成；任一校验失败都不留下半成品事实。
|
||||
type ApplicationService struct {
|
||||
db *gorm.DB
|
||||
approval approvalapp.Port
|
||||
audit ApplicationAuditWriter
|
||||
}
|
||||
|
||||
// NewApplicationService 创建核销申请用例。
|
||||
func NewApplicationService(db *gorm.DB, approval approvalapp.Port, audit ApplicationAuditWriter) *ApplicationService {
|
||||
return &ApplicationService{db: db, approval: approval, audit: audit}
|
||||
}
|
||||
|
||||
// Create 为本人可见账单创建核销申请；超级管理员可为账单欠款人代办并必须填写代办原因。
|
||||
func (s *ApplicationService) Create(ctx context.Context, command SubmitApplicationCommand) (*ApplicationSubmitResult, error) {
|
||||
if err := s.ensureReady(); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
caller, err := currentApplicationCaller(ctx)
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
return s.submit(ctx, caller, 0, command)
|
||||
}
|
||||
|
||||
// Resubmit 修改并重提已驳回的核销申请，新增审批尝试记录与新的企业微信审批实例。
|
||||
func (s *ApplicationService) Resubmit(ctx context.Context, applicationID uint, command SubmitApplicationCommand) (*ApplicationSubmitResult, error) {
|
||||
if err := s.ensureReady(); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
caller, err := currentApplicationCaller(ctx)
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
if applicationID == 0 {
|
||||
return nil, errors.New(errors.CodeEmployeeCollectionApplicationNotFound)
|
||||
}
|
||||
return s.submit(ctx, caller, applicationID, command)
|
||||
}
|
||||
|
||||
// ensureReady 校验用例依赖完整，缺失时失败关闭，避免绕过企业微信终审。
|
||||
func (s *ApplicationService) ensureReady() error {
|
||||
if s == nil || s.db == nil || s.approval == nil || s.audit == nil {
|
||||
return errors.New(errors.CodeServiceUnavailable, "核销申请能力尚未配置")
|
||||
}
|
||||
return nil
|
||||
}
|
||||
|
||||
// applicationCaller 是发起核销申请的真实操作者。
|
||||
type applicationCaller struct {
|
||||
AccountID uint
|
||||
AccountName string
|
||||
IsAdmin bool
|
||||
}
|
||||
|
||||
// currentApplicationCaller 从上下文取当前操作者，未认证时拒绝。
|
||||
func currentApplicationCaller(ctx context.Context) (applicationCaller, error) {
|
||||
accountID := middleware.GetUserIDFromContext(ctx)
|
||||
if accountID == 0 {
|
||||
return applicationCaller{}, errors.New(errors.CodeUnauthorized)
|
||||
}
|
||||
return applicationCaller{
|
||||
AccountID: accountID,
|
||||
AccountName: middleware.GetUsernameFromContext(ctx),
|
||||
IsAdmin: middleware.GetUserTypeFromContext(ctx) == constants.UserTypeSuperAdmin,
|
||||
}, nil
|
||||
}
|
||||
|
||||
// submit 在同一事务内完成校验、加锁、写申请、写审批尝试记录、创建审批实例与账单预占。
|
||||
// 加锁次序全仓统一为「申请行 → 账单行（ID 升序）」，与审批终态消费者保持一致，避免死锁。
|
||||
func (s *ApplicationService) submit(
|
||||
ctx context.Context,
|
||||
caller applicationCaller,
|
||||
applicationID uint,
|
||||
command SubmitApplicationCommand,
|
||||
) (*ApplicationSubmitResult, error) {
|
||||
if command.PaymentMethodID == 0 {
|
||||
return nil, errors.New(errors.CodeInvalidParam, "核销申请必须选择线下收款方式")
|
||||
}
|
||||
allocationCommands, err := sortedAllocationCommands(command.Allocations)
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
correlationID := "employee_collection:application:" + uuid.NewString()
|
||||
preparation, err := s.approval.Prepare(ctx, approvalapp.PrepareRequest{
|
||||
BusinessType: constants.ApprovalBusinessTypeEmployeeCollection,
|
||||
SubmitterAccountID: caller.AccountID, CorrelationID: correlationID,
|
||||
})
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
var result *ApplicationSubmitResult
|
||||
err = s.db.WithContext(ctx).Transaction(func(tx *gorm.DB) error {
|
||||
var existing *model.EmployeeCollectionApplication
|
||||
if applicationID != 0 {
|
||||
existing, err = lockApplication(ctx, tx, applicationID)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
if err := employeecollectiondomain.ValidateApplicationResubmit(existing.Status); err != nil {
|
||||
return err
|
||||
}
|
||||
if existing.ApplicantAccountID != caller.AccountID && !caller.IsAdmin {
|
||||
return errors.New(errors.CodeEmployeeCollectionApplicationNotFound)
|
||||
}
|
||||
}
|
||||
bills, err := lockBillsInAscendingOrder(ctx, tx, allocationCommands)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
paymentMethod, err := loadEnabledPaymentMethod(ctx, tx, command.PaymentMethodID)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
applicantAccountID, err := resolveApplicantAccountID(caller, existing, bills)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
acting := applicantAccountID != caller.AccountID
|
||||
normalized, err := employeecollectiondomain.NormalizeApplicationInput(employeecollectiondomain.ApplicationInput{
|
||||
PaidAmount: command.PaidAmount, PayerName: command.PayerName, PaidAt: command.PaidAt,
|
||||
ExternalTransactionNo: command.ExternalTransactionNo, Remark: command.Remark,
|
||||
ActingReason: command.ActingReason, PaymentVoucherKeys: command.PaymentVoucherKeys,
|
||||
}, acting)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
candidates := make([]employeecollectiondomain.AllocationCandidate, 0, len(allocationCommands))
|
||||
for _, item := range allocationCommands {
|
||||
bill := bills[item.BillID]
|
||||
candidates = append(candidates, employeecollectiondomain.AllocationCandidate{
|
||||
BillID: item.BillID, BillStatus: bill.Status, Amount: item.Amount,
|
||||
Available: billAmounts(bill).Available(),
|
||||
})
|
||||
}
|
||||
if err := employeecollectiondomain.ValidateAllocations(normalized.PaidAmount, candidates); err != nil {
|
||||
return err
|
||||
}
|
||||
|
||||
application, beforeData, err := prepareApplication(
|
||||
ctx, tx, caller, existing, applicantAccountID, paymentMethod, normalized)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
attemptNo, err := nextAttemptNo(ctx, tx, application.ID)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
attempt, err := buildAttempt(ctx, tx, application.ID, attemptNo, caller, paymentMethod, normalized, bills, allocationCommands)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
submitterSnapshot, requestSnapshot, err := approvalSnapshots(application.ID, caller, paymentMethod, normalized, bills, allocationCommands)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
reference, err := s.approval.CreateInTx(ctx, tx, approvalapp.CreateRequest{
|
||||
Preparation: preparation, BusinessType: constants.ApprovalBusinessTypeEmployeeCollection,
|
||||
BusinessID: attempt.ID, SubmitterAccountID: caller.AccountID,
|
||||
SubmitterSnapshot: submitterSnapshot, RequestSnapshot: requestSnapshot,
|
||||
CorrelationID: correlationID,
|
||||
})
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
if err := attachAttemptInstance(ctx, tx, attempt, reference.InstanceID); err != nil {
|
||||
return err
|
||||
}
|
||||
if err := updateApplicationLatest(ctx, tx, application, attempt, reference.InstanceID); err != nil {
|
||||
return err
|
||||
}
|
||||
allocations, reservedBills, err := createAllocations(ctx, tx, application.ID, attempt.ID, caller, bills, allocationCommands)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
submitEventID, err := composeAuditEventID(
|
||||
"employee_collection", "application", uintText(application.ID), "attempt", intText(attempt.AttemptNo), "submit")
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
if err := s.audit.WriteEmployeeCollectionApplication(ctx, tx, ApplicationAudit{
|
||||
EventID: submitEventID,
|
||||
ActionCode: constants.AuditActionEmployeeCollectionApplicationSubmitted,
|
||||
Summary: submitSummary(existing != nil),
|
||||
Application: application, Attempt: attempt, Allocations: allocations, Bills: reservedBills,
|
||||
BeforeData: beforeData, AfterData: applicationAuditSnapshot(application),
|
||||
CorrelationID: correlationID,
|
||||
}); err != nil {
|
||||
return err
|
||||
}
|
||||
result = &ApplicationSubmitResult{
|
||||
Application: application, Attempt: attempt, Allocations: allocations,
|
||||
Bills: reservedBills, InstanceID: reference.InstanceID, InstanceStatus: reference.Status,
|
||||
}
|
||||
return nil
|
||||
})
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
return result, nil
|
||||
}
|
||||
|
||||
// submitSummary 区分首次提交与重提的审计摘要。
|
||||
func submitSummary(resubmit bool) string {
|
||||
if resubmit {
|
||||
return "重提员工代收款核销申请"
|
||||
}
|
||||
return "提交员工代收款核销申请"
|
||||
}
|
||||
|
||||
// sortedAllocationCommands 校验分摊入参基本形态并按账单 ID 升序返回，保证锁序唯一。
|
||||
func sortedAllocationCommands(items []ApplicationAllocationCommand) ([]ApplicationAllocationCommand, error) {
|
||||
if len(items) == 0 {
|
||||
return nil, errors.New(errors.CodeInvalidParam, "核销申请至少需要一个账单分摊")
|
||||
}
|
||||
if len(items) > constants.EmployeeCollectionAllocationMaxCount {
|
||||
return nil, errors.New(errors.CodeInvalidParam, "核销申请账单分摊数量超出限制")
|
||||
}
|
||||
seen := make(map[uint]struct{}, len(items))
|
||||
for _, item := range items {
|
||||
if item.BillID == 0 {
|
||||
return nil, errors.New(errors.CodeInvalidParam, "账单分摊缺少目标账单")
|
||||
}
|
||||
if item.Amount <= 0 {
|
||||
return nil, errors.New(errors.CodeEmployeeCollectionAllocationAmountInvalid)
|
||||
}
|
||||
if _, exists := seen[item.BillID]; exists {
|
||||
return nil, errors.New(errors.CodeInvalidParam, "同一账单不能重复分摊")
|
||||
}
|
||||
seen[item.BillID] = struct{}{}
|
||||
}
|
||||
sorted := append([]ApplicationAllocationCommand(nil), items...)
|
||||
sort.Slice(sorted, func(i, j int) bool { return sorted[i].BillID < sorted[j].BillID })
|
||||
return sorted, nil
|
||||
}
|
||||
|
||||
// lockApplication 以行锁读取核销申请，未找到返回稳定不存在错误。
|
||||
func lockApplication(ctx context.Context, tx *gorm.DB, id uint) (*model.EmployeeCollectionApplication, error) {
|
||||
var application model.EmployeeCollectionApplication
|
||||
if err := tx.WithContext(ctx).Clauses(clause.Locking{Strength: "UPDATE"}).
|
||||
First(&application, id).Error; err != nil {
|
||||
if err == gorm.ErrRecordNotFound {
|
||||
return nil, errors.New(errors.CodeEmployeeCollectionApplicationNotFound)
|
||||
}
|
||||
return nil, errors.Wrap(errors.CodeDatabaseError, err, "锁定核销申请失败")
|
||||
}
|
||||
return &application, nil
|
||||
}
|
||||
|
||||
// lockBillsInAscendingOrder 按账单 ID 升序逐行加锁并返回账单事实。
|
||||
// 单条 `WHERE id IN (...) ORDER BY id FOR UPDATE` 在 PostgreSQL 中先取行加锁再排序，
|
||||
// 无法保证加锁次序；因此对每个账单各发一条只锁一行的语句，由调用方保证 ID 升序且不重复。
|
||||
func lockBillsInAscendingOrder(
|
||||
ctx context.Context,
|
||||
tx *gorm.DB,
|
||||
items []ApplicationAllocationCommand,
|
||||
) (map[uint]*model.EmployeeCollectionBill, error) {
|
||||
bills := make(map[uint]*model.EmployeeCollectionBill, len(items))
|
||||
for _, item := range items {
|
||||
var bill model.EmployeeCollectionBill
|
||||
if err := tx.WithContext(ctx).Clauses(clause.Locking{Strength: "UPDATE"}).
|
||||
First(&bill, item.BillID).Error; err != nil {
|
||||
if err == gorm.ErrRecordNotFound {
|
||||
return nil, errors.New(errors.CodeEmployeeCollectionBillNotFound)
|
||||
}
|
||||
return nil, errors.Wrap(errors.CodeDatabaseError, err, "锁定员工代收款账单失败")
|
||||
}
|
||||
bills[item.BillID] = &bill
|
||||
}
|
||||
return bills, nil
|
||||
}
|
||||
|
||||
// loadEnabledPaymentMethod 读取启用中的线下收款方式字典项作为冻结来源。
|
||||
func loadEnabledPaymentMethod(ctx context.Context, tx *gorm.DB, id uint) (*model.EmployeeCollectionPaymentMethod, error) {
|
||||
var paymentMethod model.EmployeeCollectionPaymentMethod
|
||||
if err := tx.WithContext(ctx).First(&paymentMethod, id).Error; err != nil {
|
||||
if err == gorm.ErrRecordNotFound {
|
||||
return nil, errors.New(errors.CodeEmployeeCollectionPaymentMethodNotFound)
|
||||
}
|
||||
return nil, errors.Wrap(errors.CodeDatabaseError, err, "查询线下收款方式失败")
|
||||
}
|
||||
if paymentMethod.Status != constants.EmployeeCollectionPaymentMethodStatusEnabled {
|
||||
return nil, errors.New(errors.CodeEmployeeCollectionPaymentMethodDisabled)
|
||||
}
|
||||
return &paymentMethod, nil
|
||||
}
|
||||
|
||||
// resolveApplicantAccountID 依据所选账单确定申请人。
|
||||
// 新建：非超级管理员只能选择本人欠款账单；超级管理员代办时全部账单必须属于同一欠款人。
|
||||
// 重提：被选账单必须仍属于原申请人，申请人的其他越权访问与不存在返回同一错误。
|
||||
func resolveApplicantAccountID(
|
||||
caller applicationCaller,
|
||||
existing *model.EmployeeCollectionApplication,
|
||||
bills map[uint]*model.EmployeeCollectionBill,
|
||||
) (uint, error) {
|
||||
if existing != nil {
|
||||
applicant := existing.ApplicantAccountID
|
||||
for _, bill := range bills {
|
||||
if bill.DebtorAccountID != applicant {
|
||||
return 0, errors.New(errors.CodeEmployeeCollectionBillNotFound)
|
||||
}
|
||||
}
|
||||
return applicant, nil
|
||||
}
|
||||
applicant := uint(0)
|
||||
for _, bill := range bills {
|
||||
if !caller.IsAdmin && bill.DebtorAccountID != caller.AccountID {
|
||||
return 0, errors.New(errors.CodeEmployeeCollectionBillNotFound)
|
||||
}
|
||||
if applicant == 0 {
|
||||
applicant = bill.DebtorAccountID
|
||||
continue
|
||||
}
|
||||
if applicant != bill.DebtorAccountID {
|
||||
return 0, errors.New(errors.CodeInvalidParam, "代办核销申请时全部账单必须属于同一欠款人")
|
||||
}
|
||||
}
|
||||
return applicant, nil
|
||||
}
|
||||
|
||||
// billAmounts 将账单持久化事实映射为领域金额事实。
|
||||
func billAmounts(bill *model.EmployeeCollectionBill) employeecollectiondomain.BillAmounts {
|
||||
return employeecollectiondomain.BillAmounts{
|
||||
Receivable: bill.ReceivableAmount, Received: bill.ReceivedAmount, Reserved: bill.ReservedAmount,
|
||||
Closed: bill.Status == constants.EmployeeCollectionBillStatusClosed,
|
||||
}
|
||||
}
|
||||
|
||||
// nextAttemptNo 返回该申请的下一条审批尝试序号；申请行已加锁，序号在同一事务内唯一。
|
||||
func nextAttemptNo(ctx context.Context, tx *gorm.DB, applicationID uint) (int, error) {
|
||||
var row struct {
|
||||
MaxAttemptNo int
|
||||
}
|
||||
if err := tx.WithContext(ctx).Model(&model.EmployeeCollectionApplicationAttempt{}).
|
||||
Select("COALESCE(MAX(attempt_no), 0) AS max_attempt_no").
|
||||
Where("application_id = ?", applicationID).Scan(&row).Error; err != nil {
|
||||
return 0, errors.Wrap(errors.CodeDatabaseError, err, "查询核销审批尝试序号失败")
|
||||
}
|
||||
return row.MaxAttemptNo + 1, nil
|
||||
}
|
||||
|
||||
// prepareApplication 新建或就地更新核销申请，返回申请事实与变更前快照。
|
||||
// 重提使用 expected-status 条件更新，状态已变化时返回冲突。
|
||||
func prepareApplication(
|
||||
ctx context.Context,
|
||||
tx *gorm.DB,
|
||||
caller applicationCaller,
|
||||
existing *model.EmployeeCollectionApplication,
|
||||
applicantAccountID uint,
|
||||
paymentMethod *model.EmployeeCollectionPaymentMethod,
|
||||
normalized employeecollectiondomain.NormalizedApplicationInput,
|
||||
) (*model.EmployeeCollectionApplication, map[string]any, error) {
|
||||
actingOperatorID := uint(0)
|
||||
if applicantAccountID != caller.AccountID {
|
||||
actingOperatorID = caller.AccountID
|
||||
}
|
||||
if existing == nil {
|
||||
application := &model.EmployeeCollectionApplication{
|
||||
ApplicantAccountID: applicantAccountID, ActingOperatorID: actingOperatorID,
|
||||
ActingReason: normalized.ActingReason,
|
||||
PaymentMethodID: paymentMethod.ID, PaymentMethodCode: paymentMethod.Code,
|
||||
PaymentMethodName: paymentMethod.Name, PaidAmount: normalized.PaidAmount,
|
||||
PayerName: normalized.PayerName, PaidAt: normalized.PaidAt,
|
||||
ExternalTransactionNo: normalized.ExternalTransactionNo,
|
||||
PaymentVoucherKeys: model.StringJSONBArray(normalized.PaymentVoucherKeys),
|
||||
Remark: normalized.Remark,
|
||||
Status: constants.EmployeeCollectionApplicationStatusPending,
|
||||
Creator: caller.AccountID, Updater: caller.AccountID,
|
||||
}
|
||||
if err := tx.WithContext(ctx).Create(application).Error; err != nil {
|
||||
return nil, nil, errors.Wrap(errors.CodeDatabaseError, err, "创建核销申请失败")
|
||||
}
|
||||
return application, nil, nil
|
||||
}
|
||||
beforeData := applicationAuditSnapshot(existing)
|
||||
expectedStatus := existing.Status
|
||||
result := tx.WithContext(ctx).Model(&model.EmployeeCollectionApplication{}).
|
||||
Where("id = ? AND status = ?", existing.ID, expectedStatus).
|
||||
Updates(map[string]any{
|
||||
"acting_operator_id": actingOperatorID,
|
||||
"acting_reason": normalized.ActingReason,
|
||||
"payment_method_id": paymentMethod.ID,
|
||||
"payment_method_code": paymentMethod.Code,
|
||||
"payment_method_name": paymentMethod.Name,
|
||||
"paid_amount": normalized.PaidAmount,
|
||||
"payer_name": normalized.PayerName,
|
||||
"paid_at": normalized.PaidAt,
|
||||
"external_transaction_no": normalized.ExternalTransactionNo,
|
||||
"payment_voucher_keys": model.StringJSONBArray(normalized.PaymentVoucherKeys),
|
||||
"remark": normalized.Remark,
|
||||
"status": constants.EmployeeCollectionApplicationStatusPending,
|
||||
"decided_at": nil,
|
||||
"terminal_reason": "",
|
||||
"updater": caller.AccountID,
|
||||
})
|
||||
if result.Error != nil {
|
||||
return nil, nil, errors.Wrap(errors.CodeDatabaseError, result.Error, "更新核销申请失败")
|
||||
}
|
||||
if result.RowsAffected != 1 {
|
||||
return nil, nil, errors.New(errors.CodeConflict, "核销申请状态已变化，请刷新后重试")
|
||||
}
|
||||
existing.ActingOperatorID = actingOperatorID
|
||||
existing.ActingReason = normalized.ActingReason
|
||||
existing.PaymentMethodID = paymentMethod.ID
|
||||
existing.PaymentMethodCode = paymentMethod.Code
|
||||
existing.PaymentMethodName = paymentMethod.Name
|
||||
existing.PaidAmount = normalized.PaidAmount
|
||||
existing.PayerName = normalized.PayerName
|
||||
existing.PaidAt = normalized.PaidAt
|
||||
existing.ExternalTransactionNo = normalized.ExternalTransactionNo
|
||||
existing.PaymentVoucherKeys = model.StringJSONBArray(normalized.PaymentVoucherKeys)
|
||||
existing.Remark = normalized.Remark
|
||||
existing.Status = constants.EmployeeCollectionApplicationStatusPending
|
||||
existing.DecidedAt = nil
|
||||
existing.TerminalReason = ""
|
||||
existing.Updater = caller.AccountID
|
||||
return existing, beforeData, nil
|
||||
}
|
||||
|
||||
// buildAttempt 新增一条不可变审批尝试记录，冻结当次收款方式、外部付款、附件与账单分摊快照。
|
||||
func buildAttempt(
|
||||
ctx context.Context,
|
||||
tx *gorm.DB,
|
||||
applicationID uint,
|
||||
attemptNo int,
|
||||
caller applicationCaller,
|
||||
paymentMethod *model.EmployeeCollectionPaymentMethod,
|
||||
normalized employeecollectiondomain.NormalizedApplicationInput,
|
||||
bills map[uint]*model.EmployeeCollectionBill,
|
||||
items []ApplicationAllocationCommand,
|
||||
) (*model.EmployeeCollectionApplicationAttempt, error) {
|
||||
snapshot, err := allocationSnapshot(bills, items)
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
attempt := &model.EmployeeCollectionApplicationAttempt{
|
||||
ApplicationID: applicationID, AttemptNo: attemptNo,
|
||||
PaymentMethodID: paymentMethod.ID, PaymentMethodCode: paymentMethod.Code, PaymentMethodName: paymentMethod.Name,
|
||||
PaidAmount: normalized.PaidAmount, PayerName: normalized.PayerName, PaidAt: normalized.PaidAt,
|
||||
ExternalTransactionNo: normalized.ExternalTransactionNo,
|
||||
PaymentVoucherKeys: model.StringJSONBArray(normalized.PaymentVoucherKeys),
|
||||
Remark: normalized.Remark, SubmittedByAccountID: caller.AccountID,
|
||||
ActingReason: normalized.ActingReason, AllocationSnapshot: snapshot,
|
||||
}
|
||||
if err := tx.WithContext(ctx).Create(attempt).Error; err != nil {
|
||||
return nil, errors.Wrap(errors.CodeDatabaseError, err, "创建核销审批尝试记录失败")
|
||||
}
|
||||
return attempt, nil
|
||||
}
|
||||
|
||||
// allocationSnapshot 生成账单分摊快照，只保存账单摘要与金额，不含付款凭证内容。
|
||||
func allocationSnapshot(
|
||||
bills map[uint]*model.EmployeeCollectionBill,
|
||||
items []ApplicationAllocationCommand,
|
||||
) ([]byte, error) {
|
||||
entries := make([]map[string]any, 0, len(items))
|
||||
for _, item := range items {
|
||||
bill := bills[item.BillID]
|
||||
entries = append(entries, map[string]any{
|
||||
"bill_id": bill.ID, "source_type": bill.SourceType, "source_no": bill.SourceNo,
|
||||
"bill_status": bill.Status, "receivable_amount": bill.ReceivableAmount,
|
||||
"received_amount": bill.ReceivedAmount, "reserved_amount": bill.ReservedAmount,
|
||||
"amount": item.Amount,
|
||||
})
|
||||
}
|
||||
payload, err := sonic.Marshal(entries)
|
||||
if err != nil {
|
||||
return nil, errors.Wrap(errors.CodeInternalError, err, "序列化账单分摊快照失败")
|
||||
}
|
||||
return payload, nil
|
||||
}
|
||||
|
||||
// approvalSnapshots 生成通用审批的提交人快照与企业微信表单业务快照。
|
||||
// 表单快照必须包含审批人核验所需的付款信息，因此保留经人工确认的完整外部流水号。
|
||||
func approvalSnapshots(
|
||||
applicationID uint,
|
||||
caller applicationCaller,
|
||||
paymentMethod *model.EmployeeCollectionPaymentMethod,
|
||||
normalized employeecollectiondomain.NormalizedApplicationInput,
|
||||
bills map[uint]*model.EmployeeCollectionBill,
|
||||
items []ApplicationAllocationCommand,
|
||||
) ([]byte, []byte, error) {
|
||||
submitterSnapshot, err := sonic.Marshal(map[string]any{
|
||||
"account_id": caller.AccountID, "account_name": caller.AccountName,
|
||||
})
|
||||
if err != nil {
|
||||
return nil, nil, errors.Wrap(errors.CodeInternalError, err, "编码核销申请提交人快照失败")
|
||||
}
|
||||
requestSnapshot, err := sonic.Marshal(map[string]any{
|
||||
constants.ApprovalFieldCollectionApplicationID: applicationID,
|
||||
constants.ApprovalFieldCollectionPaymentMethod: paymentMethod.Name,
|
||||
constants.ApprovalFieldCollectionPaidAmount: formatAmountYuan(normalized.PaidAmount),
|
||||
constants.ApprovalFieldCollectionPaidAmountCent: normalized.PaidAmount,
|
||||
constants.ApprovalFieldCollectionPayerName: normalized.PayerName,
|
||||
constants.ApprovalFieldCollectionPaidAt: normalized.PaidAt.Format(time.RFC3339),
|
||||
constants.ApprovalFieldCollectionExternalTransactionNo: normalized.ExternalTransactionNo,
|
||||
constants.ApprovalFieldPaymentVoucherKey: normalized.PaymentVoucherKeys,
|
||||
constants.ApprovalFieldRemark: normalized.Remark,
|
||||
constants.ApprovalFieldSubmitterID: caller.AccountID,
|
||||
constants.ApprovalFieldSubmitterName: caller.AccountName,
|
||||
constants.ApprovalFieldCollectionBillCount: len(items),
|
||||
constants.ApprovalFieldCollectionBillSummary: allocationSummary(bills, items),
|
||||
})
|
||||
if err != nil {
|
||||
return nil, nil, errors.Wrap(errors.CodeInternalError, err, "编码核销审批业务快照失败")
|
||||
}
|
||||
return submitterSnapshot, requestSnapshot, nil
|
||||
}
|
||||
|
||||
// allocationSummary 生成给审批人阅读的账单分摊摘要。
|
||||
func allocationSummary(bills map[uint]*model.EmployeeCollectionBill, items []ApplicationAllocationCommand) string {
|
||||
parts := make([]string, 0, len(items))
|
||||
for _, item := range items {
|
||||
bill := bills[item.BillID]
|
||||
parts = append(parts, fmt.Sprintf("账单%d（%s）应收%s 本次分摊%s",
|
||||
bill.ID, bill.SourceNo, formatAmountYuan(bill.ReceivableAmount), formatAmountYuan(item.Amount)))
|
||||
}
|
||||
return strings.Join(parts, "；")
|
||||
}
|
||||
|
||||
// formatAmountYuan 将分金额格式化为元字符串，仅用于展示与审批表单。
|
||||
func formatAmountYuan(amount int64) string {
|
||||
return fmt.Sprintf("%d.%02d", amount/100, amount%100)
|
||||
}
|
||||
|
||||
// attachAttemptInstance 把审批实例 ID 回写到本次审批尝试记录，写入一次后不可修改。
|
||||
func attachAttemptInstance(ctx context.Context, tx *gorm.DB, attempt *model.EmployeeCollectionApplicationAttempt, instanceID uint) error {
|
||||
result := tx.WithContext(ctx).Model(&model.EmployeeCollectionApplicationAttempt{}).
|
||||
Where("id = ? AND approval_instance_id IS NULL", attempt.ID).
|
||||
Update("approval_instance_id", instanceID)
|
||||
if result.Error != nil {
|
||||
return errors.Wrap(errors.CodeDatabaseError, result.Error, "关联核销审批实例失败")
|
||||
}
|
||||
if result.RowsAffected != 1 {
|
||||
return errors.New(errors.CodeConflict, "核销审批实例关联已变化")
|
||||
}
|
||||
attempt.ApprovalInstanceID = &instanceID
|
||||
return nil
|
||||
}
|
||||
|
||||
// updateApplicationLatest 更新申请的最新审批尝试与审批实例引用，仅用于展示。
|
||||
func updateApplicationLatest(
|
||||
ctx context.Context,
|
||||
tx *gorm.DB,
|
||||
application *model.EmployeeCollectionApplication,
|
||||
attempt *model.EmployeeCollectionApplicationAttempt,
|
||||
instanceID uint,
|
||||
) error {
|
||||
result := tx.WithContext(ctx).Model(&model.EmployeeCollectionApplication{}).
|
||||
Where("id = ?", application.ID).
|
||||
Updates(map[string]any{
|
||||
"latest_attempt_id": attempt.ID, "latest_approval_instance_id": instanceID,
|
||||
})
|
||||
if result.Error != nil {
|
||||
return errors.Wrap(errors.CodeDatabaseError, result.Error, "更新核销申请最新审批实例失败")
|
||||
}
|
||||
if result.RowsAffected != 1 {
|
||||
return errors.New(errors.CodeConflict, "核销申请最新审批实例更新已变化")
|
||||
}
|
||||
application.LatestAttemptID = attempt.ID
|
||||
application.LatestApprovalInstanceID = instanceID
|
||||
return nil
|
||||
}
|
||||
|
||||
// createAllocations 写入分摊行并按账单 ID 升序预占余额。
|
||||
// 预占使用条件更新并要求 RowsAffected 为 1，避免并发申请超额占用同一账单。
|
||||
func createAllocations(
|
||||
ctx context.Context,
|
||||
tx *gorm.DB,
|
||||
applicationID uint,
|
||||
attemptID uint,
|
||||
caller applicationCaller,
|
||||
bills map[uint]*model.EmployeeCollectionBill,
|
||||
items []ApplicationAllocationCommand,
|
||||
) ([]*model.EmployeeCollectionApplicationAllocation, []*model.EmployeeCollectionBill, error) {
|
||||
allocations := make([]*model.EmployeeCollectionApplicationAllocation, 0, len(items))
|
||||
reservedBills := make([]*model.EmployeeCollectionBill, 0, len(items))
|
||||
for _, item := range items {
|
||||
bill := bills[item.BillID]
|
||||
allocation := &model.EmployeeCollectionApplicationAllocation{
|
||||
ApplicationID: applicationID, AttemptID: attemptID, BillID: bill.ID,
|
||||
Amount: item.Amount, Status: constants.EmployeeCollectionAllocationStatusPending,
|
||||
Creator: caller.AccountID, Updater: caller.AccountID,
|
||||
}
|
||||
if err := tx.WithContext(ctx).Create(allocation).Error; err != nil {
|
||||
return nil, nil, errors.Wrap(errors.CodeDatabaseError, err, "写入核销分摊失败")
|
||||
}
|
||||
result := tx.WithContext(ctx).Model(&model.EmployeeCollectionBill{}).
|
||||
Where("id = ? AND reserved_amount + ? <= receivable_amount - received_amount", bill.ID, item.Amount).
|
||||
Updates(map[string]any{
|
||||
"reserved_amount": gorm.Expr("reserved_amount + ?", item.Amount),
|
||||
"updater": caller.AccountID,
|
||||
})
|
||||
if result.Error != nil {
|
||||
return nil, nil, errors.Wrap(errors.CodeDatabaseError, result.Error, "预占账单可核销余额失败")
|
||||
}
|
||||
if result.RowsAffected != 1 {
|
||||
return nil, nil, errors.New(errors.CodeEmployeeCollectionAllocationExceeded)
|
||||
}
|
||||
bill.ReservedAmount += item.Amount
|
||||
allocations = append(allocations, allocation)
|
||||
reservedBills = append(reservedBills, bill)
|
||||
}
|
||||
return allocations, reservedBills, nil
|
||||
}
|
||||
|
||||
// applicationAuditSnapshot 生成申请审计快照，外部交易流水号按脱敏值记录。
|
||||
func applicationAuditSnapshot(application *model.EmployeeCollectionApplication) map[string]any {
|
||||
return map[string]any{
|
||||
"id": application.ID, "applicant_account_id": application.ApplicantAccountID,
|
||||
"acting_operator_id": application.ActingOperatorID,
|
||||
"payment_method_id": application.PaymentMethodID, "payment_method_code": application.PaymentMethodCode,
|
||||
"paid_amount": application.PaidAmount, "payer_name": application.PayerName,
|
||||
"external_transaction_no_masked": employeecollectiondomain.MaskExternalTransactionNo(application.ExternalTransactionNo),
|
||||
"voucher_count": len(application.PaymentVoucherKeys),
|
||||
"status": application.Status,
|
||||
"latest_attempt_id": application.LatestAttemptID,
|
||||
"latest_approval_instance_id": application.LatestApprovalInstanceID,
|
||||
}
|
||||
}
|
||||
37
internal/application/employeecollection/application_audit.go
Normal file
37
internal/application/employeecollection/application_audit.go
Normal file
@@ -0,0 +1,37 @@
|
||||
package employeecollection
|
||||
|
||||
import (
|
||||
"context"
|
||||
|
||||
"gorm.io/gorm"
|
||||
|
||||
"github.com/break/junhong_cmp_fiber/internal/model"
|
||||
)
|
||||
|
||||
// ApplicationAudit 描述核销申请、审批尝试记录与受影响账单的事实变化。
|
||||
type ApplicationAudit struct {
|
||||
// EventID 是审计事件稳定标识，同一业务事实重复重放时保持相同值。
|
||||
EventID string
|
||||
// ActionCode 是已注册的核销申请审计动作码。
|
||||
ActionCode string
|
||||
// Summary 是给人工阅读的中文摘要。
|
||||
Summary string
|
||||
// Application 是本次动作后的核销申请事实。
|
||||
Application *model.EmployeeCollectionApplication
|
||||
// Attempt 是本次动作对应的审批尝试记录。
|
||||
Attempt *model.EmployeeCollectionApplicationAttempt
|
||||
// Allocations 是本次动作涉及的分摊事实。
|
||||
Allocations []*model.EmployeeCollectionApplicationAllocation
|
||||
// Bills 是本次动作影响的员工代收款账单事实。
|
||||
Bills []*model.EmployeeCollectionBill
|
||||
// BeforeData 与 AfterData 是脱敏前后的字段快照，不得包含付款凭证内容。
|
||||
BeforeData map[string]any
|
||||
AfterData map[string]any
|
||||
// CorrelationID 是申请链路标识。
|
||||
CorrelationID string
|
||||
}
|
||||
|
||||
// ApplicationAuditWriter 在员工代收款核销事务内追加统一 Audit Event。
|
||||
type ApplicationAuditWriter interface {
|
||||
WriteEmployeeCollectionApplication(ctx context.Context, tx *gorm.DB, change ApplicationAudit) error
|
||||
}
|
||||
501
internal/application/employeecollection/approval_decision.go
Normal file
501
internal/application/employeecollection/approval_decision.go
Normal file
@@ -0,0 +1,501 @@
|
||||
package employeecollection
|
||||
|
||||
import (
|
||||
"context"
|
||||
"time"
|
||||
|
||||
"gorm.io/gorm"
|
||||
"gorm.io/gorm/clause"
|
||||
|
||||
approvalapp "github.com/break/junhong_cmp_fiber/internal/application/approval"
|
||||
"github.com/break/junhong_cmp_fiber/internal/model"
|
||||
"github.com/break/junhong_cmp_fiber/pkg/auditcontext"
|
||||
"github.com/break/junhong_cmp_fiber/pkg/constants"
|
||||
"github.com/break/junhong_cmp_fiber/pkg/errors"
|
||||
)
|
||||
|
||||
// ApprovalDecisionHandler 将渠道无关企业微信审批终态应用到员工代收款核销申请。
|
||||
// 通过才增加账单已核销金额，驳回才释放预占；重复、乱序或延迟回调都不重复入账。
|
||||
type ApprovalDecisionHandler struct {
|
||||
db *gorm.DB
|
||||
audit ApplicationAuditWriter
|
||||
}
|
||||
|
||||
// NewApprovalDecisionHandler 创建员工代收款核销审批终态消费者。
|
||||
func NewApprovalDecisionHandler(db *gorm.DB, audit ApplicationAuditWriter) *ApprovalDecisionHandler {
|
||||
return &ApprovalDecisionHandler{db: db, audit: audit}
|
||||
}
|
||||
|
||||
// Handle 幂等消费标准审批终态。
|
||||
// 业务标识为审批尝试记录主键：先锁定尝试记录并校验审批实例一致，再按申请与账单 ID 升序加锁。
|
||||
func (h *ApprovalDecisionHandler) Handle(ctx context.Context, event approvalapp.TerminalDecisionEvent) error {
|
||||
if h == nil || h.db == nil || h.audit == nil {
|
||||
return errors.New(errors.CodeInternalError, "员工代收款核销审批终态能力未配置")
|
||||
}
|
||||
if event.BusinessType != constants.ApprovalBusinessTypeEmployeeCollection || event.BusinessID == 0 || event.InstanceID == 0 {
|
||||
return errors.New(errors.CodeInvalidParam, "员工代收款核销审批终态参数无效")
|
||||
}
|
||||
ctx = auditcontext.With(ctx, auditcontext.Context{CorrelationID: event.CorrelationID, ParentEventID: event.EventID})
|
||||
return h.db.WithContext(ctx).Transaction(func(tx *gorm.DB) error {
|
||||
var attempt model.EmployeeCollectionApplicationAttempt
|
||||
if err := tx.WithContext(ctx).Clauses(clause.Locking{Strength: "UPDATE"}).
|
||||
First(&attempt, event.BusinessID).Error; err != nil {
|
||||
if err == gorm.ErrRecordNotFound {
|
||||
return errors.New(errors.CodeNotFound, "核销审批尝试记录不存在")
|
||||
}
|
||||
return errors.Wrap(errors.CodeDatabaseError, err, "锁定核销审批尝试记录失败")
|
||||
}
|
||||
if attempt.ApprovalInstanceID == nil || *attempt.ApprovalInstanceID != event.InstanceID {
|
||||
return errors.New(errors.CodeConflict, "核销审批尝试记录关联的审批实例不一致")
|
||||
}
|
||||
application, err := lockApplication(ctx, tx, attempt.ApplicationID)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
if application.LatestAttemptID != attempt.ID {
|
||||
// 已被更新尝试取代的历史尝试终态不再改变申请事实。
|
||||
return nil
|
||||
}
|
||||
switch event.Decision {
|
||||
case constants.ApprovalDecisionApproved:
|
||||
return h.applyApproved(ctx, tx, application, &attempt, event)
|
||||
case constants.ApprovalDecisionRejected:
|
||||
return h.applyClosed(ctx, tx, application, &attempt, event,
|
||||
constants.EmployeeCollectionApplicationStatusRejected, "企业微信审批已驳回")
|
||||
case constants.ApprovalDecisionCancelled:
|
||||
return h.applyClosed(ctx, tx, application, &attempt, event,
|
||||
constants.EmployeeCollectionApplicationStatusRevoked, "企业微信审批已撤销")
|
||||
case constants.ApprovalDecisionDeleted:
|
||||
return h.applyClosed(ctx, tx, application, &attempt, event,
|
||||
constants.EmployeeCollectionApplicationStatusRevoked, "企业微信审批已删除")
|
||||
case constants.ApprovalDecisionRevokedAfterApproved:
|
||||
return h.applyRevoked(ctx, tx, application, &attempt, event)
|
||||
default:
|
||||
return errors.New(errors.CodeInvalidParam, "不支持的核销申请审批终态")
|
||||
}
|
||||
})
|
||||
}
|
||||
|
||||
// applyApproved 将本次尝试的全部预占分摊转入已核销并重算账单状态。
|
||||
// 仅当申请仍处于审批中时推进，重复或乱序回调不重复增加已核销金额。
|
||||
func (h *ApprovalDecisionHandler) applyApproved(
|
||||
ctx context.Context,
|
||||
tx *gorm.DB,
|
||||
application *model.EmployeeCollectionApplication,
|
||||
attempt *model.EmployeeCollectionApplicationAttempt,
|
||||
event approvalapp.TerminalDecisionEvent,
|
||||
) error {
|
||||
if application.Status != constants.EmployeeCollectionApplicationStatusPending {
|
||||
return nil
|
||||
}
|
||||
allocations, err := loadAttemptAllocations(ctx, tx, attempt.ID)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
if _, err := lockBillsInAscendingOrder(ctx, tx, allocationCommandsOf(allocations)); err != nil {
|
||||
return err
|
||||
}
|
||||
now := time.Now().UTC()
|
||||
for _, allocation := range allocations {
|
||||
if err := approveAllocation(ctx, tx, allocation, now); err != nil {
|
||||
return err
|
||||
}
|
||||
if err := settleBillReservation(ctx, tx, allocation); err != nil {
|
||||
return err
|
||||
}
|
||||
}
|
||||
result := tx.WithContext(ctx).Model(&model.EmployeeCollectionApplication{}).
|
||||
Where("id = ? AND status = ?", application.ID, constants.EmployeeCollectionApplicationStatusPending).
|
||||
Updates(map[string]any{
|
||||
"status": constants.EmployeeCollectionApplicationStatusApproved,
|
||||
"decided_at": now, "updater": 0,
|
||||
})
|
||||
if result.Error != nil {
|
||||
return errors.Wrap(errors.CodeDatabaseError, result.Error, "标记核销申请已通过失败")
|
||||
}
|
||||
if result.RowsAffected != 1 {
|
||||
return errors.New(errors.CodeConflict, "核销申请状态已变化")
|
||||
}
|
||||
before := application.Status
|
||||
application.Status = constants.EmployeeCollectionApplicationStatusApproved
|
||||
application.DecidedAt = &now
|
||||
application.Updater = 0
|
||||
bills, err := reloadBills(ctx, tx, allocationCommandsOf(allocations))
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
approvedEventID, err := decisionEventID(application.ID, attempt.AttemptNo, "approved")
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
return h.audit.WriteEmployeeCollectionApplication(ctx, tx, ApplicationAudit{
|
||||
EventID: approvedEventID,
|
||||
ActionCode: constants.AuditActionEmployeeCollectionApplicationApproved,
|
||||
Summary: "企业微信审批通过，核销分摊转入已核销",
|
||||
Application: application, Attempt: attempt, Allocations: allocations, Bills: bills,
|
||||
BeforeData: map[string]any{"status": before},
|
||||
AfterData: applicationAuditSnapshot(application), CorrelationID: event.CorrelationID,
|
||||
})
|
||||
}
|
||||
|
||||
// applyClosed 处理最终驳回与渠道撤销、删除：释放全部预占并把申请置为对应终态。
|
||||
func (h *ApprovalDecisionHandler) applyClosed(
|
||||
ctx context.Context,
|
||||
tx *gorm.DB,
|
||||
application *model.EmployeeCollectionApplication,
|
||||
attempt *model.EmployeeCollectionApplicationAttempt,
|
||||
event approvalapp.TerminalDecisionEvent,
|
||||
targetStatus int,
|
||||
reason string,
|
||||
) error {
|
||||
if application.Status != constants.EmployeeCollectionApplicationStatusPending {
|
||||
return nil
|
||||
}
|
||||
allocations, err := loadAttemptAllocations(ctx, tx, attempt.ID)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
if _, err := lockBillsInAscendingOrder(ctx, tx, allocationCommandsOf(allocations)); err != nil {
|
||||
return err
|
||||
}
|
||||
now := time.Now().UTC()
|
||||
for _, allocation := range allocations {
|
||||
if err := releaseAllocation(ctx, tx, allocation, now); err != nil {
|
||||
return err
|
||||
}
|
||||
if err := releaseBillReservation(ctx, tx, allocation); err != nil {
|
||||
return err
|
||||
}
|
||||
}
|
||||
terminalReason := ""
|
||||
if targetStatus == constants.EmployeeCollectionApplicationStatusRevoked {
|
||||
terminalReason = reason
|
||||
}
|
||||
result := tx.WithContext(ctx).Model(&model.EmployeeCollectionApplication{}).
|
||||
Where("id = ? AND status = ?", application.ID, constants.EmployeeCollectionApplicationStatusPending).
|
||||
Updates(map[string]any{
|
||||
"status": targetStatus, "decided_at": now,
|
||||
"terminal_reason": terminalReason, "updater": 0,
|
||||
})
|
||||
if result.Error != nil {
|
||||
return errors.Wrap(errors.CodeDatabaseError, result.Error, "更新核销申请终态失败")
|
||||
}
|
||||
if result.RowsAffected != 1 {
|
||||
return errors.New(errors.CodeConflict, "核销申请状态已变化")
|
||||
}
|
||||
before := application.Status
|
||||
application.Status = targetStatus
|
||||
application.DecidedAt = &now
|
||||
application.TerminalReason = terminalReason
|
||||
application.Updater = 0
|
||||
bills, err := reloadBills(ctx, tx, allocationCommandsOf(allocations))
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
closedEventID, err := decisionEventID(application.ID, attempt.AttemptNo, decisionEventSuffix(event.Decision))
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
return h.audit.WriteEmployeeCollectionApplication(ctx, tx, ApplicationAudit{
|
||||
EventID: closedEventID,
|
||||
ActionCode: constants.AuditActionEmployeeCollectionApplicationRejected,
|
||||
Summary: "企业微信审批未通过，核销申请预占已释放",
|
||||
Application: application, Attempt: attempt, Allocations: allocations, Bills: bills,
|
||||
BeforeData: map[string]any{"status": before},
|
||||
AfterData: applicationAuditSnapshot(application), CorrelationID: event.CorrelationID,
|
||||
})
|
||||
}
|
||||
|
||||
// applyRevoked 处理通过后撤销。
|
||||
// 申请已通过：不回滚已核销金额，只转异常终态并禁止自动重提。
|
||||
// 申请仍在审批中（渠道乱序投递）：释放全部审批中预占并转异常终态，避免预占永久占用账单。
|
||||
func (h *ApprovalDecisionHandler) applyRevoked(
|
||||
ctx context.Context,
|
||||
tx *gorm.DB,
|
||||
application *model.EmployeeCollectionApplication,
|
||||
attempt *model.EmployeeCollectionApplicationAttempt,
|
||||
event approvalapp.TerminalDecisionEvent,
|
||||
) error {
|
||||
switch application.Status {
|
||||
case constants.EmployeeCollectionApplicationStatusApproved:
|
||||
return h.revokeApproved(ctx, tx, application, attempt, event)
|
||||
case constants.EmployeeCollectionApplicationStatusPending:
|
||||
return h.revokePending(ctx, tx, application, attempt, event)
|
||||
default:
|
||||
// 已驳回、已撤销等终态不再改变事实。
|
||||
return nil
|
||||
}
|
||||
}
|
||||
|
||||
// revokeApproved 在已通过态撤销：保留已核销金额，仅转异常终态。
|
||||
func (h *ApprovalDecisionHandler) revokeApproved(
|
||||
ctx context.Context,
|
||||
tx *gorm.DB,
|
||||
application *model.EmployeeCollectionApplication,
|
||||
attempt *model.EmployeeCollectionApplicationAttempt,
|
||||
event approvalapp.TerminalDecisionEvent,
|
||||
) error {
|
||||
now := time.Now().UTC()
|
||||
terminalReason := "企业微信通过后撤销"
|
||||
result := tx.WithContext(ctx).Model(&model.EmployeeCollectionApplication{}).
|
||||
Where("id = ? AND status = ?", application.ID, constants.EmployeeCollectionApplicationStatusApproved).
|
||||
Updates(map[string]any{
|
||||
"status": constants.EmployeeCollectionApplicationStatusRevoked,
|
||||
"decided_at": now, "terminal_reason": terminalReason, "updater": 0,
|
||||
})
|
||||
if result.Error != nil {
|
||||
return errors.Wrap(errors.CodeDatabaseError, result.Error, "标记核销申请通过后撤销失败")
|
||||
}
|
||||
if result.RowsAffected != 1 {
|
||||
return errors.New(errors.CodeConflict, "核销申请状态已变化")
|
||||
}
|
||||
before := application.Status
|
||||
application.Status = constants.EmployeeCollectionApplicationStatusRevoked
|
||||
application.DecidedAt = &now
|
||||
application.TerminalReason = terminalReason
|
||||
application.Updater = 0
|
||||
allocations, err := loadAttemptAllocations(ctx, tx, attempt.ID)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
bills, err := reloadBills(ctx, tx, allocationCommandsOf(allocations))
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
revokedEventID, err := decisionEventID(application.ID, attempt.AttemptNo, "revoked")
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
return h.audit.WriteEmployeeCollectionApplication(ctx, tx, ApplicationAudit{
|
||||
EventID: revokedEventID,
|
||||
ActionCode: constants.AuditActionEmployeeCollectionApplicationRevoked,
|
||||
Summary: "企业微信通过后撤销，已核销金额不回滚",
|
||||
Application: application, Attempt: attempt, Allocations: allocations, Bills: bills,
|
||||
BeforeData: map[string]any{"status": before},
|
||||
AfterData: applicationAuditSnapshot(application), CorrelationID: event.CorrelationID,
|
||||
})
|
||||
}
|
||||
|
||||
// revokePending 在审批中态撤销：释放全部审批中预占并转异常终态。
|
||||
func (h *ApprovalDecisionHandler) revokePending(
|
||||
ctx context.Context,
|
||||
tx *gorm.DB,
|
||||
application *model.EmployeeCollectionApplication,
|
||||
attempt *model.EmployeeCollectionApplicationAttempt,
|
||||
event approvalapp.TerminalDecisionEvent,
|
||||
) error {
|
||||
allocations, err := loadAttemptAllocations(ctx, tx, attempt.ID)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
if _, err := lockBillsInAscendingOrder(ctx, tx, allocationCommandsOf(allocations)); err != nil {
|
||||
return err
|
||||
}
|
||||
now := time.Now().UTC()
|
||||
for _, allocation := range allocations {
|
||||
if err := releaseAllocation(ctx, tx, allocation, now); err != nil {
|
||||
return err
|
||||
}
|
||||
if err := releaseBillReservation(ctx, tx, allocation); err != nil {
|
||||
return err
|
||||
}
|
||||
}
|
||||
terminalReason := "企业微信通过后在本地审批中状态被撤销"
|
||||
result := tx.WithContext(ctx).Model(&model.EmployeeCollectionApplication{}).
|
||||
Where("id = ? AND status = ?", application.ID, constants.EmployeeCollectionApplicationStatusPending).
|
||||
Updates(map[string]any{
|
||||
"status": constants.EmployeeCollectionApplicationStatusRevoked,
|
||||
"decided_at": now, "terminal_reason": terminalReason, "updater": 0,
|
||||
})
|
||||
if result.Error != nil {
|
||||
return errors.Wrap(errors.CodeDatabaseError, result.Error, "标记核销申请撤销失败")
|
||||
}
|
||||
if result.RowsAffected != 1 {
|
||||
return errors.New(errors.CodeConflict, "核销申请状态已变化")
|
||||
}
|
||||
before := application.Status
|
||||
application.Status = constants.EmployeeCollectionApplicationStatusRevoked
|
||||
application.DecidedAt = &now
|
||||
application.TerminalReason = terminalReason
|
||||
application.Updater = 0
|
||||
bills, err := reloadBills(ctx, tx, allocationCommandsOf(allocations))
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
revokedEventID, err := decisionEventID(application.ID, attempt.AttemptNo, "revoked")
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
return h.audit.WriteEmployeeCollectionApplication(ctx, tx, ApplicationAudit{
|
||||
EventID: revokedEventID,
|
||||
ActionCode: constants.AuditActionEmployeeCollectionApplicationRevoked,
|
||||
Summary: "企业微信通过后撤销，申请仍在审批中，已释放预占",
|
||||
Application: application, Attempt: attempt, Allocations: allocations, Bills: bills,
|
||||
BeforeData: map[string]any{"status": before},
|
||||
AfterData: applicationAuditSnapshot(application), CorrelationID: event.CorrelationID,
|
||||
})
|
||||
}
|
||||
|
||||
// loadAttemptAllocations 按账单 ID 升序读取本次尝试的分摊，保证后续加锁与写入次序唯一。
|
||||
func loadAttemptAllocations(ctx context.Context, tx *gorm.DB, attemptID uint) ([]*model.EmployeeCollectionApplicationAllocation, error) {
|
||||
var allocations []model.EmployeeCollectionApplicationAllocation
|
||||
if err := tx.WithContext(ctx).Clauses(clause.Locking{Strength: "UPDATE"}).
|
||||
Where("attempt_id = ?", attemptID).Order("bill_id ASC, id ASC").Find(&allocations).Error; err != nil {
|
||||
return nil, errors.Wrap(errors.CodeDatabaseError, err, "查询核销审批尝试分摊失败")
|
||||
}
|
||||
if len(allocations) == 0 {
|
||||
return nil, errors.New(errors.CodeConflict, "核销审批尝试记录缺少分摊事实")
|
||||
}
|
||||
result := make([]*model.EmployeeCollectionApplicationAllocation, 0, len(allocations))
|
||||
for index := range allocations {
|
||||
result = append(result, &allocations[index])
|
||||
}
|
||||
return result, nil
|
||||
}
|
||||
|
||||
// allocationCommandsOf 提取分摊涉及的账单与金额，用于复用升序加锁函数。
|
||||
func allocationCommandsOf(allocations []*model.EmployeeCollectionApplicationAllocation) []ApplicationAllocationCommand {
|
||||
items := make([]ApplicationAllocationCommand, 0, len(allocations))
|
||||
for _, allocation := range allocations {
|
||||
items = append(items, ApplicationAllocationCommand{BillID: allocation.BillID, Amount: allocation.Amount})
|
||||
}
|
||||
return items
|
||||
}
|
||||
|
||||
// approveAllocation 把分摊从审批中预占条件更新为已通过；重复处理时返回冲突。
|
||||
func approveAllocation(
|
||||
ctx context.Context,
|
||||
tx *gorm.DB,
|
||||
allocation *model.EmployeeCollectionApplicationAllocation,
|
||||
now time.Time,
|
||||
) error {
|
||||
result := tx.WithContext(ctx).Model(&model.EmployeeCollectionApplicationAllocation{}).
|
||||
Where("id = ? AND status = ?", allocation.ID, constants.EmployeeCollectionAllocationStatusPending).
|
||||
Updates(map[string]any{
|
||||
"status": constants.EmployeeCollectionAllocationStatusApproved, "released_at": now, "updater": 0,
|
||||
})
|
||||
if result.Error != nil {
|
||||
return errors.Wrap(errors.CodeDatabaseError, result.Error, "标记核销分摊已通过失败")
|
||||
}
|
||||
if result.RowsAffected != 1 {
|
||||
return errors.New(errors.CodeConflict, "核销分摊状态已变化")
|
||||
}
|
||||
allocation.Status = constants.EmployeeCollectionAllocationStatusApproved
|
||||
allocation.ReleasedAt = &now
|
||||
return nil
|
||||
}
|
||||
|
||||
// releaseAllocation 把分摊从审批中预占条件更新为已释放；重复处理时返回冲突。
|
||||
func releaseAllocation(
|
||||
ctx context.Context,
|
||||
tx *gorm.DB,
|
||||
allocation *model.EmployeeCollectionApplicationAllocation,
|
||||
now time.Time,
|
||||
) error {
|
||||
result := tx.WithContext(ctx).Model(&model.EmployeeCollectionApplicationAllocation{}).
|
||||
Where("id = ? AND status = ?", allocation.ID, constants.EmployeeCollectionAllocationStatusPending).
|
||||
Updates(map[string]any{
|
||||
"status": constants.EmployeeCollectionAllocationStatusReleased, "released_at": now, "updater": 0,
|
||||
})
|
||||
if result.Error != nil {
|
||||
return errors.Wrap(errors.CodeDatabaseError, result.Error, "释放核销分摊预占失败")
|
||||
}
|
||||
if result.RowsAffected != 1 {
|
||||
return errors.New(errors.CodeConflict, "核销分摊状态已变化")
|
||||
}
|
||||
allocation.Status = constants.EmployeeCollectionAllocationStatusReleased
|
||||
allocation.ReleasedAt = &now
|
||||
return nil
|
||||
}
|
||||
|
||||
// settleBillReservation 将账单预占转为已核销并重算账单状态。
|
||||
// 条件更新要求账单预占不小于分摊金额，并检查 RowsAffected，避免并发下重复入账。
|
||||
func settleBillReservation(
|
||||
ctx context.Context,
|
||||
tx *gorm.DB,
|
||||
allocation *model.EmployeeCollectionApplicationAllocation,
|
||||
) error {
|
||||
result := tx.WithContext(ctx).Model(&model.EmployeeCollectionBill{}).
|
||||
Where("id = ? AND reserved_amount >= ?", allocation.BillID, allocation.Amount).
|
||||
Updates(map[string]any{
|
||||
"received_amount": gorm.Expr("received_amount + ?", allocation.Amount),
|
||||
"reserved_amount": gorm.Expr("reserved_amount - ?", allocation.Amount),
|
||||
"status": gorm.Expr(
|
||||
"CASE WHEN received_amount + ? >= receivable_amount THEN ?::smallint WHEN received_amount + ? > 0 THEN ?::smallint ELSE ?::smallint END",
|
||||
allocation.Amount, constants.EmployeeCollectionBillStatusSettled,
|
||||
allocation.Amount, constants.EmployeeCollectionBillStatusPartial,
|
||||
constants.EmployeeCollectionBillStatusPending,
|
||||
),
|
||||
"updater": 0,
|
||||
})
|
||||
if result.Error != nil {
|
||||
return errors.Wrap(errors.CodeDatabaseError, result.Error, "账单预占转入已核销失败")
|
||||
}
|
||||
if result.RowsAffected != 1 {
|
||||
return errors.New(errors.CodeConflict, "账单预占已变化，核销未入账")
|
||||
}
|
||||
return nil
|
||||
}
|
||||
|
||||
// releaseBillReservation 释放账单预占金额，条件更新并检查 RowsAffected。
|
||||
func releaseBillReservation(
|
||||
ctx context.Context,
|
||||
tx *gorm.DB,
|
||||
allocation *model.EmployeeCollectionApplicationAllocation,
|
||||
) error {
|
||||
result := tx.WithContext(ctx).Model(&model.EmployeeCollectionBill{}).
|
||||
Where("id = ? AND reserved_amount >= ?", allocation.BillID, allocation.Amount).
|
||||
Updates(map[string]any{
|
||||
"reserved_amount": gorm.Expr("reserved_amount - ?", allocation.Amount),
|
||||
"updater": 0,
|
||||
})
|
||||
if result.Error != nil {
|
||||
return errors.Wrap(errors.CodeDatabaseError, result.Error, "释放账单预占失败")
|
||||
}
|
||||
if result.RowsAffected != 1 {
|
||||
return errors.New(errors.CodeConflict, "账单预占已变化")
|
||||
}
|
||||
return nil
|
||||
}
|
||||
|
||||
// reloadBills 重新读取受影响账单，保证审计快照反映终态金额。
|
||||
// 账单行已在同一事务内持有排他锁，这里只做一次按 ID 升序的普通读取。
|
||||
func reloadBills(
|
||||
ctx context.Context,
|
||||
tx *gorm.DB,
|
||||
items []ApplicationAllocationCommand,
|
||||
) ([]*model.EmployeeCollectionBill, error) {
|
||||
billIDs := make([]uint, 0, len(items))
|
||||
for _, item := range items {
|
||||
billIDs = append(billIDs, item.BillID)
|
||||
}
|
||||
var bills []model.EmployeeCollectionBill
|
||||
if err := tx.WithContext(ctx).Where("id IN ?", billIDs).Order("id ASC").Find(&bills).Error; err != nil {
|
||||
return nil, errors.Wrap(errors.CodeDatabaseError, err, "查询受影响员工代收款账单失败")
|
||||
}
|
||||
result := make([]*model.EmployeeCollectionBill, 0, len(bills))
|
||||
for index := range bills {
|
||||
result = append(result, &bills[index])
|
||||
}
|
||||
return result, nil
|
||||
}
|
||||
|
||||
// decisionEventID 生成审批终态审计事件的稳定标识，并约束在审计列宽内。
|
||||
func decisionEventID(applicationID uint, attemptNo int, suffix string) (string, error) {
|
||||
return composeAuditEventID(
|
||||
"employee_collection", "application", uintText(applicationID), "attempt", intText(attemptNo), suffix)
|
||||
}
|
||||
|
||||
// decisionEventSuffix 把渠道决策映射为审计事件后缀。
|
||||
func decisionEventSuffix(decision string) string {
|
||||
switch decision {
|
||||
case constants.ApprovalDecisionRejected:
|
||||
return "rejected"
|
||||
case constants.ApprovalDecisionCancelled:
|
||||
return "cancelled"
|
||||
case constants.ApprovalDecisionDeleted:
|
||||
return "deleted"
|
||||
default:
|
||||
return "closed"
|
||||
}
|
||||
}
|
||||
31
internal/application/employeecollection/audit_event.go
Normal file
31
internal/application/employeecollection/audit_event.go
Normal file
@@ -0,0 +1,31 @@
|
||||
package employeecollection
|
||||
|
||||
import (
|
||||
"strconv"
|
||||
"strings"
|
||||
|
||||
"github.com/break/junhong_cmp_fiber/pkg/errors"
|
||||
)
|
||||
|
||||
// auditEventMaxLength 是统一审计事件标识的列宽上限，与 tb_audit_event.event_id 保持一致。
|
||||
const auditEventMaxLength = 64
|
||||
|
||||
// composeAuditEventID 以冒号连接业务标识片段，生成确定性的审计事件标识。
|
||||
// 超出审计列宽时返回稳定错误，避免写入时分段截断或事务被数据库拒绝。
|
||||
func composeAuditEventID(parts ...string) (string, error) {
|
||||
eventID := strings.Join(parts, ":")
|
||||
if len(eventID) > auditEventMaxLength {
|
||||
return "", errors.New(errors.CodeInternalError, "审计事件标识超出长度限制")
|
||||
}
|
||||
return eventID, nil
|
||||
}
|
||||
|
||||
// uintText 将主键转为审计标识片段。
|
||||
func uintText(value uint) string {
|
||||
return strconv.FormatUint(uint64(value), 10)
|
||||
}
|
||||
|
||||
// intText 将序号转为审计标识片段。
|
||||
func intText(value int) string {
|
||||
return strconv.Itoa(value)
|
||||
}
|
||||
118
internal/application/employeecollection/bill_close.go
Normal file
118
internal/application/employeecollection/bill_close.go
Normal file
@@ -0,0 +1,118 @@
|
||||
package employeecollection
|
||||
|
||||
import (
|
||||
"context"
|
||||
"strings"
|
||||
"time"
|
||||
|
||||
"gorm.io/gorm"
|
||||
"gorm.io/gorm/clause"
|
||||
|
||||
employeecollectiondomain "github.com/break/junhong_cmp_fiber/internal/domain/employeecollection"
|
||||
"github.com/break/junhong_cmp_fiber/internal/model"
|
||||
"github.com/break/junhong_cmp_fiber/pkg/constants"
|
||||
"github.com/break/junhong_cmp_fiber/pkg/errors"
|
||||
)
|
||||
|
||||
// BillCloseService 关闭员工代收款账单。
|
||||
// 仅超级管理员可关闭，且只允许关闭仍待核销或部分核销、且不存在审批中分摊的账单。
|
||||
type BillCloseService struct {
|
||||
db *gorm.DB
|
||||
audit BillAuditWriter
|
||||
}
|
||||
|
||||
// NewBillCloseService 创建账单关闭事务脚本。
|
||||
func NewBillCloseService(db *gorm.DB, audit BillAuditWriter) *BillCloseService {
|
||||
return &BillCloseService{db: db, audit: audit}
|
||||
}
|
||||
|
||||
// Close 关闭账单：作废未核销余额、保留已核销金额，并在同一事务内写关闭审计。
|
||||
// 并发关闭通过行锁加 expected-status 条件更新兜底，状态已变化时返回冲突。
|
||||
func (s *BillCloseService) Close(ctx context.Context, id uint, reason string) (*model.EmployeeCollectionBill, error) {
|
||||
operatorID, err := requireSuperAdmin(ctx)
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
if s == nil || s.db == nil || s.audit == nil {
|
||||
return nil, errors.New(errors.CodeServiceUnavailable, "账单关闭能力尚未配置")
|
||||
}
|
||||
if id == 0 {
|
||||
return nil, errors.New(errors.CodeEmployeeCollectionBillNotFound)
|
||||
}
|
||||
closeReason := strings.TrimSpace(reason)
|
||||
var closed *model.EmployeeCollectionBill
|
||||
err = s.db.WithContext(ctx).Transaction(func(tx *gorm.DB) error {
|
||||
bill, err := lockBill(ctx, tx, id)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
var pendingAllocations int64
|
||||
if err := tx.WithContext(ctx).Model(&model.EmployeeCollectionApplicationAllocation{}).
|
||||
Where("bill_id = ? AND status = ?", id, constants.EmployeeCollectionAllocationStatusPending).
|
||||
Count(&pendingAllocations).Error; err != nil {
|
||||
return errors.Wrap(errors.CodeDatabaseError, err, "统计账单审批中分摊失败")
|
||||
}
|
||||
if err := employeecollectiondomain.ValidateBillClose(employeecollectiondomain.BillCloseInput{
|
||||
Status: bill.Status, PendingAllocations: pendingAllocations, Reason: closeReason,
|
||||
}); err != nil {
|
||||
return err
|
||||
}
|
||||
before := *bill
|
||||
closedAt := time.Now().UTC()
|
||||
result := tx.WithContext(ctx).Model(&model.EmployeeCollectionBill{}).
|
||||
Where("id = ? AND status = ?", bill.ID, bill.Status).
|
||||
Updates(map[string]any{
|
||||
"status": constants.EmployeeCollectionBillStatusClosed,
|
||||
"closed_reason": closeReason,
|
||||
"closed_at": closedAt,
|
||||
"updater": operatorID,
|
||||
})
|
||||
if result.Error != nil {
|
||||
return errors.Wrap(errors.CodeDatabaseError, result.Error, "关闭员工代收款账单失败")
|
||||
}
|
||||
if result.RowsAffected != 1 {
|
||||
return errors.New(errors.CodeConflict, "账单状态已变化，请刷新后重试")
|
||||
}
|
||||
bill.Status = constants.EmployeeCollectionBillStatusClosed
|
||||
bill.ClosedReason = closeReason
|
||||
bill.ClosedAt = &closedAt
|
||||
bill.Updater = operatorID
|
||||
closeEventID, err := composeAuditEventID("employee_collection", "bill", uintText(bill.ID), "close")
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
if err := s.audit.WriteEmployeeCollectionBill(ctx, tx, BillAudit{
|
||||
EventID: closeEventID,
|
||||
ActionCode: constants.AuditActionEmployeeCollectionBillClosed, Summary: "关闭员工代收款账单",
|
||||
Bill: bill,
|
||||
BeforeData: map[string]any{
|
||||
"status": before.Status, "closed_reason": before.ClosedReason,
|
||||
},
|
||||
AfterData: map[string]any{
|
||||
"status": bill.Status, "closed_reason": bill.ClosedReason,
|
||||
},
|
||||
CorrelationID: bill.SourceNo,
|
||||
}); err != nil {
|
||||
return err
|
||||
}
|
||||
closed = bill
|
||||
return nil
|
||||
})
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
return closed, nil
|
||||
}
|
||||
|
||||
// lockBill 以行锁读取账单，未找到返回稳定不存在错误。
|
||||
func lockBill(ctx context.Context, tx *gorm.DB, id uint) (*model.EmployeeCollectionBill, error) {
|
||||
var bill model.EmployeeCollectionBill
|
||||
if err := tx.WithContext(ctx).Clauses(clause.Locking{Strength: "UPDATE"}).
|
||||
First(&bill, id).Error; err != nil {
|
||||
if err == gorm.ErrRecordNotFound {
|
||||
return nil, errors.New(errors.CodeEmployeeCollectionBillNotFound)
|
||||
}
|
||||
return nil, errors.Wrap(errors.CodeDatabaseError, err, "锁定员工代收款账单失败")
|
||||
}
|
||||
return &bill, nil
|
||||
}
|
||||
233
internal/application/employeecollection/bill_creation.go
Normal file
233
internal/application/employeecollection/bill_creation.go
Normal file
@@ -0,0 +1,233 @@
|
||||
package employeecollection
|
||||
|
||||
import (
|
||||
"context"
|
||||
|
||||
"github.com/bytedance/sonic"
|
||||
"gorm.io/gorm"
|
||||
"gorm.io/gorm/clause"
|
||||
|
||||
employeecollectiondomain "github.com/break/junhong_cmp_fiber/internal/domain/employeecollection"
|
||||
"github.com/break/junhong_cmp_fiber/internal/model"
|
||||
"github.com/break/junhong_cmp_fiber/pkg/constants"
|
||||
"github.com/break/junhong_cmp_fiber/pkg/errors"
|
||||
)
|
||||
|
||||
// BillAudit 描述员工代收款账单事实的实际变化。
|
||||
type BillAudit struct {
|
||||
// EventID 是审计事件稳定标识，同一业务事实重复重放时保持相同值。
|
||||
EventID string
|
||||
// ActionCode 是已注册的账单审计动作码。
|
||||
ActionCode string
|
||||
// Summary 是给人工阅读的中文摘要。
|
||||
Summary string
|
||||
// Bill 是本次动作后的账单事实。
|
||||
Bill *model.EmployeeCollectionBill
|
||||
// BeforeData 与 AfterData 是脱敏前后的字段快照。
|
||||
BeforeData map[string]any
|
||||
AfterData map[string]any
|
||||
// CorrelationID 是来源业务链路标识。
|
||||
CorrelationID string
|
||||
}
|
||||
|
||||
// BillAuditWriter 在员工代收款业务事务内追加统一 Audit Event。
|
||||
type BillAuditWriter interface {
|
||||
WriteEmployeeCollectionBill(ctx context.Context, tx *gorm.DB, change BillAudit) error
|
||||
}
|
||||
|
||||
// BillCreationService 在来源成功事务内按来源唯一键幂等创建员工代收款账单。
|
||||
// 建账只由来源成功事务携带的来源主键触发，不存在扫描历史订单或充值补建的路径。
|
||||
type BillCreationService struct {
|
||||
audit BillAuditWriter
|
||||
}
|
||||
|
||||
// NewBillCreationService 创建员工代收款建账用例。
|
||||
func NewBillCreationService(audit BillAuditWriter) *BillCreationService {
|
||||
return &BillCreationService{audit: audit}
|
||||
}
|
||||
|
||||
// CreateFromOrderInTx 在后台线下套餐订单激活事务内建账。
|
||||
// 判据见 employeecollectiondomain.ShouldCreateBillForOrder；不满足判据时返回 (nil, nil)。
|
||||
// 重复订单事务、重放或重试都命中 source_key 唯一约束并返回既有账单，不使订单事务失败。
|
||||
func (s *BillCreationService) CreateFromOrderInTx(
|
||||
ctx context.Context,
|
||||
tx *gorm.DB,
|
||||
order *model.Order,
|
||||
hasGiftPackage bool,
|
||||
) (*model.EmployeeCollectionBill, error) {
|
||||
if s == nil || tx == nil || s.audit == nil {
|
||||
return nil, errors.New(errors.CodeInternalError, "员工代收款建账用例未完整配置")
|
||||
}
|
||||
if order == nil || order.ID == 0 {
|
||||
return nil, errors.New(errors.CodeInvalidParam, "员工代收款建账缺少来源订单")
|
||||
}
|
||||
if !employeecollectiondomain.ShouldCreateBillForOrder(
|
||||
employeecollectiondomain.OrderBillSubjectFromOrder(order, hasGiftPackage)) {
|
||||
return nil, nil
|
||||
}
|
||||
if order.OperatorAccountID == nil || *order.OperatorAccountID == 0 {
|
||||
return nil, errors.New(errors.CodeInternalError, "线下套餐订单缺少欠款人账号")
|
||||
}
|
||||
debtorAccountID := *order.OperatorAccountID
|
||||
debtorSnapshot, err := marshalSnapshot(map[string]any{
|
||||
"account_id": debtorAccountID, "account_name": order.OperatorAccountName,
|
||||
"account_type": order.OperatorAccountType,
|
||||
})
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
// shop_id 与 seller_shop_id 同时写入：店铺筛选统一读 shop_id，seller_shop_id 保留兼容口径。
|
||||
customerSnapshot, err := marshalSnapshot(map[string]any{
|
||||
"buyer_type": order.BuyerType, "buyer_id": order.BuyerID,
|
||||
"buyer_nickname": order.BuyerNickname,
|
||||
"shop_id": order.SellerShopID, "seller_shop_id": order.SellerShopID,
|
||||
"asset_identifier": order.AssetIdentifier,
|
||||
})
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
sourceKey := employeecollectiondomain.OrderSourceKey(order.ID)
|
||||
bill := &model.EmployeeCollectionBill{
|
||||
SourceType: constants.EmployeeCollectionSourceTypeOrder,
|
||||
SourceID: order.ID,
|
||||
SourceKey: sourceKey,
|
||||
SourceNo: order.OrderNo,
|
||||
DebtorAccountID: debtorAccountID,
|
||||
DebtorSnapshot: debtorSnapshot,
|
||||
CustomerSnapshot: customerSnapshot,
|
||||
ReceivableAmount: *order.ActualPaidAmount,
|
||||
Status: constants.EmployeeCollectionBillStatusPending,
|
||||
Creator: debtorAccountID,
|
||||
Updater: debtorAccountID,
|
||||
}
|
||||
return s.persistInTx(ctx, tx, bill,
|
||||
[]string{"employee_collection", "bill", "order", uintText(order.ID), "create"},
|
||||
"后台线下套餐订单创建员工代收款账单", order.OrderNo)
|
||||
}
|
||||
|
||||
// CreateFromRechargeInTx 在代理线下充值入账事务内建账。
|
||||
// 判据见 employeecollectiondomain.ShouldCreateBillForRecharge；欠款人为发起充值的后台账号。
|
||||
// 覆盖企业微信终审通过入账与后台人工确认入账两条入口，重复入账不重复建账。
|
||||
func (s *BillCreationService) CreateFromRechargeInTx(
|
||||
ctx context.Context,
|
||||
tx *gorm.DB,
|
||||
record *model.AgentRechargeRecord,
|
||||
) (*model.EmployeeCollectionBill, error) {
|
||||
if s == nil || tx == nil || s.audit == nil {
|
||||
return nil, errors.New(errors.CodeInternalError, "员工代收款建账用例未完整配置")
|
||||
}
|
||||
if record == nil || record.ID == 0 {
|
||||
return nil, errors.New(errors.CodeInvalidParam, "员工代收款建账缺少来源充值记录")
|
||||
}
|
||||
if !employeecollectiondomain.ShouldCreateBillForRecharge(employeecollectiondomain.RechargeBillSubject{
|
||||
PaymentMethod: record.PaymentMethod, Amount: record.Amount,
|
||||
}) {
|
||||
return nil, nil
|
||||
}
|
||||
if record.UserID == 0 {
|
||||
return nil, errors.New(errors.CodeInternalError, "线下充值记录缺少发起账号")
|
||||
}
|
||||
debtorName, err := rechargeAccountName(ctx, tx, record.UserID)
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
debtorSnapshot, err := marshalSnapshot(map[string]any{
|
||||
"account_id": record.UserID, "account_name": debtorName,
|
||||
"account_type": model.OperatorAccountTypePlatform,
|
||||
})
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
customerSnapshot, err := marshalSnapshot(map[string]any{
|
||||
"shop_id": record.ShopID, "agent_wallet_id": record.AgentWalletID,
|
||||
"payment_method": record.PaymentMethod, "recharge_no": record.RechargeNo,
|
||||
})
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
sourceKey := employeecollectiondomain.RechargeSourceKey(record.ID)
|
||||
bill := &model.EmployeeCollectionBill{
|
||||
SourceType: constants.EmployeeCollectionSourceTypeRecharge,
|
||||
SourceID: record.ID,
|
||||
SourceKey: sourceKey,
|
||||
SourceNo: record.RechargeNo,
|
||||
DebtorAccountID: record.UserID,
|
||||
DebtorSnapshot: debtorSnapshot,
|
||||
CustomerSnapshot: customerSnapshot,
|
||||
ReceivableAmount: record.Amount,
|
||||
Status: constants.EmployeeCollectionBillStatusPending,
|
||||
Creator: record.UserID,
|
||||
Updater: record.UserID,
|
||||
}
|
||||
return s.persistInTx(ctx, tx, bill,
|
||||
[]string{"employee_collection", "bill", "recharge", uintText(record.ID), "create"},
|
||||
"代理线下充值入账创建员工代收款账单", record.RechargeNo)
|
||||
}
|
||||
|
||||
// persistInTx 以来源唯一键幂等写入账单：已存在同一来源账单时返回既有事实且不重复审计。
|
||||
func (s *BillCreationService) persistInTx(
|
||||
ctx context.Context,
|
||||
tx *gorm.DB,
|
||||
bill *model.EmployeeCollectionBill,
|
||||
eventIDParts []string,
|
||||
summary string,
|
||||
correlationID string,
|
||||
) (*model.EmployeeCollectionBill, error) {
|
||||
eventID, err := composeAuditEventID(eventIDParts...)
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
result := tx.WithContext(ctx).Clauses(clause.OnConflict{
|
||||
Columns: []clause.Column{{Name: "source_key"}},
|
||||
DoNothing: true,
|
||||
}).Create(bill)
|
||||
if result.Error != nil {
|
||||
return nil, errors.Wrap(errors.CodeDatabaseError, result.Error, "创建员工代收款账单失败")
|
||||
}
|
||||
if result.RowsAffected == 0 {
|
||||
var existing model.EmployeeCollectionBill
|
||||
if err := tx.WithContext(ctx).Where("source_key = ?", bill.SourceKey).First(&existing).Error; err != nil {
|
||||
return nil, errors.Wrap(errors.CodeDatabaseError, err, "读取既有员工代收款账单失败")
|
||||
}
|
||||
return &existing, nil
|
||||
}
|
||||
if err := s.audit.WriteEmployeeCollectionBill(ctx, tx, BillAudit{
|
||||
EventID: eventID, ActionCode: constants.AuditActionEmployeeCollectionBillCreated, Summary: summary,
|
||||
Bill: bill, AfterData: billAuditSnapshot(bill), CorrelationID: correlationID,
|
||||
}); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
return bill, nil
|
||||
}
|
||||
|
||||
// marshalSnapshot 将只读业务快照序列化为 jsonb，快照不得包含付款凭证或外部交易敏感内容。
|
||||
func marshalSnapshot(snapshot map[string]any) ([]byte, error) {
|
||||
payload, err := sonic.Marshal(snapshot)
|
||||
if err != nil {
|
||||
return nil, errors.Wrap(errors.CodeInternalError, err, "序列化员工代收款账单快照失败")
|
||||
}
|
||||
return payload, nil
|
||||
}
|
||||
|
||||
// rechargeAccountName 读取充值发起账号名称用于欠款人快照；账号已被删除时留空名称。
|
||||
func rechargeAccountName(ctx context.Context, tx *gorm.DB, accountID uint) (string, error) {
|
||||
var account model.Account
|
||||
if err := tx.WithContext(ctx).Unscoped().First(&account, accountID).Error; err != nil {
|
||||
if err == gorm.ErrRecordNotFound {
|
||||
return "", nil
|
||||
}
|
||||
return "", errors.Wrap(errors.CodeDatabaseError, err, "查询线下充值发起账号失败")
|
||||
}
|
||||
return account.Username, nil
|
||||
}
|
||||
|
||||
// billAuditSnapshot 生成账单审计快照，只包含 ID、来源、金额与状态，不含凭证内容。
|
||||
func billAuditSnapshot(bill *model.EmployeeCollectionBill) map[string]any {
|
||||
return map[string]any{
|
||||
"id": bill.ID, "source_type": bill.SourceType, "source_id": bill.SourceID,
|
||||
"source_key": bill.SourceKey, "source_no": bill.SourceNo,
|
||||
"debtor_account_id": bill.DebtorAccountID, "receivable_amount": bill.ReceivableAmount,
|
||||
"received_amount": bill.ReceivedAmount, "reserved_amount": bill.ReservedAmount,
|
||||
"status": bill.Status,
|
||||
}
|
||||
}
|
||||
337
internal/application/employeecollection/payment_method.go
Normal file
337
internal/application/employeecollection/payment_method.go
Normal file
@@ -0,0 +1,337 @@
|
||||
// Package employeecollection 收口员工代收款账单、核销申请与线下收款方式字典的写用例。
|
||||
// 写用例在事务内保存业务事实与审计事实，读取由 internal/query 提供。
|
||||
package employeecollection
|
||||
|
||||
import (
|
||||
"context"
|
||||
stdErrors "errors"
|
||||
"strconv"
|
||||
|
||||
"github.com/jackc/pgx/v5/pgconn"
|
||||
"gorm.io/gorm"
|
||||
"gorm.io/gorm/clause"
|
||||
|
||||
systemconfigapp "github.com/break/junhong_cmp_fiber/internal/application/systemconfig"
|
||||
employeecollectiondomain "github.com/break/junhong_cmp_fiber/internal/domain/employeecollection"
|
||||
"github.com/break/junhong_cmp_fiber/internal/model"
|
||||
"github.com/break/junhong_cmp_fiber/internal/model/dto"
|
||||
"github.com/break/junhong_cmp_fiber/pkg/constants"
|
||||
"github.com/break/junhong_cmp_fiber/pkg/errors"
|
||||
"github.com/break/junhong_cmp_fiber/pkg/middleware"
|
||||
)
|
||||
|
||||
// AuditWriter 接收员工代收款用例在业务事务内产生的配置审计事实。
|
||||
type AuditWriter interface {
|
||||
WriteConfigChange(ctx context.Context, tx *gorm.DB, audit systemconfigapp.ChangeAudit) error
|
||||
}
|
||||
|
||||
// PaymentMethodService 维护线下收款方式字典。
|
||||
// 已启用的字典项由其稳定编码对外，被核销申请引用后只可停用，不允许物理删除或改编码。
|
||||
type PaymentMethodService struct {
|
||||
db *gorm.DB
|
||||
audit AuditWriter
|
||||
}
|
||||
|
||||
// NewPaymentMethodService 创建线下收款方式字典事务脚本。
|
||||
func NewPaymentMethodService(db *gorm.DB, audit AuditWriter) *PaymentMethodService {
|
||||
return &PaymentMethodService{db: db, audit: audit}
|
||||
}
|
||||
|
||||
// Create 创建线下收款方式，并在同一事务内写入配置审计。
|
||||
func (s *PaymentMethodService) Create(
|
||||
ctx context.Context,
|
||||
request dto.CreateEmployeeCollectionPaymentMethodRequest,
|
||||
) (*dto.EmployeeCollectionPaymentMethodResponse, error) {
|
||||
operatorID, err := requireSuperAdmin(ctx)
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
if s == nil || s.db == nil || s.audit == nil {
|
||||
return nil, errors.New(errors.CodeServiceUnavailable, "线下收款方式维护能力尚未配置")
|
||||
}
|
||||
status := constants.EmployeeCollectionPaymentMethodStatusDisabled
|
||||
if request.Enabled != nil && *request.Enabled {
|
||||
status = constants.EmployeeCollectionPaymentMethodStatusEnabled
|
||||
}
|
||||
var sortOrder int64
|
||||
if request.Sort != nil {
|
||||
sortOrder = *request.Sort
|
||||
}
|
||||
normalized, err := employeecollectiondomain.NormalizePaymentMethodInput(employeecollectiondomain.PaymentMethodInput{
|
||||
Code: request.Code, Name: request.Name, SortOrder: sortOrder, Status: status, Remark: request.Remark,
|
||||
})
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
paymentMethod := &model.EmployeeCollectionPaymentMethod{
|
||||
Code: normalized.Code, Name: normalized.Name, SortOrder: normalized.SortOrder,
|
||||
Status: normalized.Status, Remark: normalized.Remark,
|
||||
BaseModel: model.BaseModel{Creator: operatorID, Updater: operatorID},
|
||||
}
|
||||
err = s.db.WithContext(ctx).Transaction(func(tx *gorm.DB) error {
|
||||
if err := ensurePaymentMethodCodeAvailable(ctx, tx, normalized.Code, 0); err != nil {
|
||||
return err
|
||||
}
|
||||
if err := tx.WithContext(ctx).Create(paymentMethod).Error; err != nil {
|
||||
return errors.Wrap(errors.CodeDatabaseError, err, "创建线下收款方式失败")
|
||||
}
|
||||
return s.audit.WriteConfigChange(ctx, tx, systemconfigapp.ChangeAudit{
|
||||
OperatorID: operatorID, OperationType: constants.AuditOperationEmployeeCollectionPaymentMethodCreate,
|
||||
Description: "创建线下收款方式", ConfigKey: paymentMethodAuditConfigKey(paymentMethod.ID),
|
||||
Module: constants.EmployeeCollectionAuditModule, ResourceID: paymentMethodAuditResourceID(paymentMethod.ID),
|
||||
DisplayName: paymentMethod.Name, Identity: paymentMethodAuditIdentity(paymentMethod),
|
||||
AfterData: paymentMethodAuditSnapshot(paymentMethod), Result: constants.AuditResultSuccess,
|
||||
})
|
||||
})
|
||||
if err != nil {
|
||||
return nil, mapPaymentMethodCodeConflict(err)
|
||||
}
|
||||
return toPaymentMethodResponse(paymentMethod), nil
|
||||
}
|
||||
|
||||
// Update 修改线下收款方式的名称、排序、启停与备注，并在未被引用时允许修改稳定编码。
|
||||
func (s *PaymentMethodService) Update(
|
||||
ctx context.Context,
|
||||
id uint,
|
||||
request dto.UpdateEmployeeCollectionPaymentMethodRequest,
|
||||
) (*dto.EmployeeCollectionPaymentMethodResponse, error) {
|
||||
operatorID, err := requireSuperAdmin(ctx)
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
if s == nil || s.db == nil || s.audit == nil {
|
||||
return nil, errors.New(errors.CodeServiceUnavailable, "线下收款方式维护能力尚未配置")
|
||||
}
|
||||
if id == 0 {
|
||||
return nil, errors.New(errors.CodeEmployeeCollectionPaymentMethodNotFound)
|
||||
}
|
||||
var updated *model.EmployeeCollectionPaymentMethod
|
||||
err = s.db.WithContext(ctx).Transaction(func(tx *gorm.DB) error {
|
||||
paymentMethod, err := lockPaymentMethod(ctx, tx, id)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
before := *paymentMethod
|
||||
beforeData := paymentMethodAuditSnapshot(&before)
|
||||
|
||||
if request.Code != nil {
|
||||
code := *request.Code
|
||||
normalized, err := employeecollectiondomain.NormalizePaymentMethodInput(employeecollectiondomain.PaymentMethodInput{
|
||||
Code: code, Name: paymentMethod.Name, SortOrder: paymentMethod.SortOrder,
|
||||
Status: paymentMethod.Status, Remark: paymentMethod.Remark,
|
||||
})
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
if normalized.Code != paymentMethod.Code {
|
||||
referenced, err := countPaymentMethodReferences(ctx, tx, id)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
if referenced > 0 {
|
||||
return errors.New(errors.CodeEmployeeCollectionPaymentMethodReferenced,
|
||||
"线下收款方式已被核销申请引用，不能修改稳定编码")
|
||||
}
|
||||
if err := ensurePaymentMethodCodeAvailable(ctx, tx, normalized.Code, id); err != nil {
|
||||
return err
|
||||
}
|
||||
}
|
||||
paymentMethod.Code = normalized.Code
|
||||
}
|
||||
if request.Name != nil {
|
||||
paymentMethod.Name = *request.Name
|
||||
}
|
||||
if request.Sort != nil {
|
||||
paymentMethod.SortOrder = *request.Sort
|
||||
}
|
||||
if request.Enabled != nil {
|
||||
if *request.Enabled {
|
||||
paymentMethod.Status = constants.EmployeeCollectionPaymentMethodStatusEnabled
|
||||
} else {
|
||||
paymentMethod.Status = constants.EmployeeCollectionPaymentMethodStatusDisabled
|
||||
}
|
||||
}
|
||||
if request.Remark != nil {
|
||||
paymentMethod.Remark = *request.Remark
|
||||
}
|
||||
normalized, err := employeecollectiondomain.NormalizePaymentMethodInput(employeecollectiondomain.PaymentMethodInput{
|
||||
Code: paymentMethod.Code, Name: paymentMethod.Name, SortOrder: paymentMethod.SortOrder,
|
||||
Status: paymentMethod.Status, Remark: paymentMethod.Remark,
|
||||
})
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
paymentMethod.Code = normalized.Code
|
||||
paymentMethod.Name = normalized.Name
|
||||
paymentMethod.SortOrder = normalized.SortOrder
|
||||
paymentMethod.Status = normalized.Status
|
||||
paymentMethod.Remark = normalized.Remark
|
||||
paymentMethod.Updater = operatorID
|
||||
|
||||
if err := tx.WithContext(ctx).Save(paymentMethod).Error; err != nil {
|
||||
return errors.Wrap(errors.CodeDatabaseError, err, "更新线下收款方式失败")
|
||||
}
|
||||
if err := s.audit.WriteConfigChange(ctx, tx, systemconfigapp.ChangeAudit{
|
||||
OperatorID: operatorID, OperationType: constants.AuditOperationEmployeeCollectionPaymentMethodUpdate,
|
||||
Description: "更新线下收款方式", ConfigKey: paymentMethodAuditConfigKey(paymentMethod.ID),
|
||||
Module: constants.EmployeeCollectionAuditModule, ResourceID: paymentMethodAuditResourceID(paymentMethod.ID),
|
||||
DisplayName: paymentMethod.Name, Identity: paymentMethodAuditIdentity(paymentMethod),
|
||||
BeforeData: beforeData, AfterData: paymentMethodAuditSnapshot(paymentMethod),
|
||||
Result: constants.AuditResultSuccess,
|
||||
}); err != nil {
|
||||
return err
|
||||
}
|
||||
updated = paymentMethod
|
||||
return nil
|
||||
})
|
||||
if err != nil {
|
||||
return nil, mapPaymentMethodCodeConflict(err)
|
||||
}
|
||||
return toPaymentMethodResponse(updated), nil
|
||||
}
|
||||
|
||||
// Delete 物理删除未被任何核销申请引用的线下收款方式，并写入配置审计。
|
||||
// 已被引用的字典项只允许停用，保证历史申请继续显示冻结名称。
|
||||
func (s *PaymentMethodService) Delete(ctx context.Context, id uint) error {
|
||||
operatorID, err := requireSuperAdmin(ctx)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
if s == nil || s.db == nil || s.audit == nil {
|
||||
return errors.New(errors.CodeServiceUnavailable, "线下收款方式维护能力尚未配置")
|
||||
}
|
||||
if id == 0 {
|
||||
return errors.New(errors.CodeEmployeeCollectionPaymentMethodNotFound)
|
||||
}
|
||||
return s.db.WithContext(ctx).Transaction(func(tx *gorm.DB) error {
|
||||
paymentMethod, err := lockPaymentMethod(ctx, tx, id)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
referenced, err := countPaymentMethodReferences(ctx, tx, id)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
if referenced > 0 {
|
||||
return errors.New(errors.CodeEmployeeCollectionPaymentMethodReferenced)
|
||||
}
|
||||
beforeData := paymentMethodAuditSnapshot(paymentMethod)
|
||||
paymentMethod.Updater = operatorID
|
||||
if err := tx.WithContext(ctx).Save(paymentMethod).Error; err != nil {
|
||||
return errors.Wrap(errors.CodeDatabaseError, err, "更新线下收款方式失败")
|
||||
}
|
||||
if err := tx.WithContext(ctx).Delete(paymentMethod).Error; err != nil {
|
||||
return errors.Wrap(errors.CodeDatabaseError, err, "删除线下收款方式失败")
|
||||
}
|
||||
return s.audit.WriteConfigChange(ctx, tx, systemconfigapp.ChangeAudit{
|
||||
OperatorID: operatorID, OperationType: constants.AuditOperationEmployeeCollectionPaymentMethodDelete,
|
||||
Description: "删除线下收款方式", ConfigKey: paymentMethodAuditConfigKey(paymentMethod.ID),
|
||||
Module: constants.EmployeeCollectionAuditModule, ResourceID: paymentMethodAuditResourceID(paymentMethod.ID),
|
||||
DisplayName: paymentMethod.Name, Identity: paymentMethodAuditIdentity(paymentMethod),
|
||||
BeforeData: beforeData, Result: constants.AuditResultSuccess,
|
||||
})
|
||||
})
|
||||
}
|
||||
|
||||
// requireSuperAdmin 校验当前调用者是超级管理员，并返回其账号 ID。
|
||||
// 字典维护不对外开放，未授权一律返回同一禁止访问错误。
|
||||
func requireSuperAdmin(ctx context.Context) (uint, error) {
|
||||
if middleware.GetUserTypeFromContext(ctx) != constants.UserTypeSuperAdmin {
|
||||
return 0, errors.New(errors.CodeForbidden, "无权限操作该资源或资源不存在")
|
||||
}
|
||||
operatorID := middleware.GetUserIDFromContext(ctx)
|
||||
if operatorID == 0 {
|
||||
return 0, errors.New(errors.CodeUnauthorized)
|
||||
}
|
||||
return operatorID, nil
|
||||
}
|
||||
|
||||
// lockPaymentMethod 以行锁读取线下收款方式，未找到返回稳定不存在错误。
|
||||
func lockPaymentMethod(ctx context.Context, tx *gorm.DB, id uint) (*model.EmployeeCollectionPaymentMethod, error) {
|
||||
var paymentMethod model.EmployeeCollectionPaymentMethod
|
||||
err := tx.WithContext(ctx).Clauses(clause.Locking{Strength: "UPDATE"}).
|
||||
First(&paymentMethod, id).Error
|
||||
if err != nil {
|
||||
if err == gorm.ErrRecordNotFound {
|
||||
return nil, errors.New(errors.CodeEmployeeCollectionPaymentMethodNotFound)
|
||||
}
|
||||
return nil, errors.Wrap(errors.CodeDatabaseError, err, "查询线下收款方式失败")
|
||||
}
|
||||
return &paymentMethod, nil
|
||||
}
|
||||
|
||||
// ensurePaymentMethodCodeAvailable 校验稳定编码在未删除记录中唯一，excludeID 用于更新自身。
|
||||
func ensurePaymentMethodCodeAvailable(ctx context.Context, tx *gorm.DB, code string, excludeID uint) error {
|
||||
query := tx.WithContext(ctx).Model(&model.EmployeeCollectionPaymentMethod{}).Where("code = ?", code)
|
||||
if excludeID != 0 {
|
||||
query = query.Where("id <> ?", excludeID)
|
||||
}
|
||||
var count int64
|
||||
if err := query.Count(&count).Error; err != nil {
|
||||
return errors.Wrap(errors.CodeDatabaseError, err, "校验线下收款方式编码失败")
|
||||
}
|
||||
if count > 0 {
|
||||
return errors.New(errors.CodeEmployeeCollectionPaymentMethodCodeExists)
|
||||
}
|
||||
return nil
|
||||
}
|
||||
|
||||
// countPaymentMethodReferences 统计引用该收款方式的核销申请数量。
|
||||
func countPaymentMethodReferences(ctx context.Context, tx *gorm.DB, id uint) (int64, error) {
|
||||
var count int64
|
||||
if err := tx.WithContext(ctx).Model(&model.EmployeeCollectionApplication{}).
|
||||
Where("payment_method_id = ?", id).Count(&count).Error; err != nil {
|
||||
return 0, errors.Wrap(errors.CodeDatabaseError, err, "统计线下收款方式引用失败")
|
||||
}
|
||||
return count, nil
|
||||
}
|
||||
|
||||
// mapPaymentMethodCodeConflict 把稳定编码唯一索引冲突映射为稳定业务错误。
|
||||
// 并发创建或改码时唯一索引是最终裁决，避免把约束冲突暴露成内部错误。
|
||||
func mapPaymentMethodCodeConflict(err error) error {
|
||||
var pgErr *pgconn.PgError
|
||||
if stdErrors.As(err, &pgErr) && pgErr.Code == "23505" {
|
||||
return errors.New(errors.CodeEmployeeCollectionPaymentMethodCodeExists)
|
||||
}
|
||||
return err
|
||||
}
|
||||
|
||||
// toPaymentMethodResponse 将字典项投影为对外响应。
|
||||
func toPaymentMethodResponse(paymentMethod *model.EmployeeCollectionPaymentMethod) *dto.EmployeeCollectionPaymentMethodResponse {
|
||||
if paymentMethod == nil {
|
||||
return nil
|
||||
}
|
||||
return &dto.EmployeeCollectionPaymentMethodResponse{
|
||||
ID: paymentMethod.ID, Code: paymentMethod.Code, Name: paymentMethod.Name,
|
||||
Enabled: paymentMethod.Status == constants.EmployeeCollectionPaymentMethodStatusEnabled,
|
||||
Sort: paymentMethod.SortOrder, Remark: paymentMethod.Remark,
|
||||
CreatedAt: paymentMethod.CreatedAt, UpdatedAt: paymentMethod.UpdatedAt,
|
||||
}
|
||||
}
|
||||
|
||||
// paymentMethodAuditConfigKey 生成字典项的审计配置键。
|
||||
func paymentMethodAuditConfigKey(id uint) string {
|
||||
return constants.EmployeeCollectionAuditConfigKeyPrefix + "." + strconv.FormatUint(uint64(id), 10)
|
||||
}
|
||||
|
||||
// paymentMethodAuditResourceID 生成字典项审计资源标识。
|
||||
func paymentMethodAuditResourceID(id uint) *string {
|
||||
value := strconv.FormatUint(uint64(id), 10)
|
||||
return &value
|
||||
}
|
||||
|
||||
// paymentMethodAuditIdentity 生成字典项审计身份快照，不含任何凭证内容。
|
||||
func paymentMethodAuditIdentity(paymentMethod *model.EmployeeCollectionPaymentMethod) map[string]any {
|
||||
return map[string]any{
|
||||
"id": paymentMethod.ID, "code": paymentMethod.Code, "name": paymentMethod.Name,
|
||||
"status": paymentMethod.Status, "sort": paymentMethod.SortOrder,
|
||||
}
|
||||
}
|
||||
|
||||
// paymentMethodAuditSnapshot 生成字典项审计前后值快照，不含任何凭证内容。
|
||||
func paymentMethodAuditSnapshot(paymentMethod *model.EmployeeCollectionPaymentMethod) map[string]any {
|
||||
return map[string]any{
|
||||
"id": paymentMethod.ID, "code": paymentMethod.Code, "name": paymentMethod.Name,
|
||||
"status": paymentMethod.Status, "sort": paymentMethod.SortOrder, "remark": paymentMethod.Remark,
|
||||
}
|
||||
}
|
||||
161
internal/application/employeecollection/refund_offset.go
Normal file
161
internal/application/employeecollection/refund_offset.go
Normal file
@@ -0,0 +1,161 @@
|
||||
package employeecollection
|
||||
|
||||
import (
|
||||
"context"
|
||||
"time"
|
||||
|
||||
"gorm.io/gorm"
|
||||
"gorm.io/gorm/clause"
|
||||
|
||||
employeecollectiondomain "github.com/break/junhong_cmp_fiber/internal/domain/employeecollection"
|
||||
"github.com/break/junhong_cmp_fiber/internal/model"
|
||||
"github.com/break/junhong_cmp_fiber/pkg/constants"
|
||||
"github.com/break/junhong_cmp_fiber/pkg/errors"
|
||||
)
|
||||
|
||||
// RefundOffsetSource 是来源订单退款成功的事实快照。
|
||||
type RefundOffsetSource struct {
|
||||
// RefundID 表示本次退款申请 ID。
|
||||
RefundID uint
|
||||
// OrderID 表示退款关联的来源订单 ID。
|
||||
OrderID uint
|
||||
// RefundAmount 表示本次退款成功金额（分），与退款入账使用的金额为同一实参。
|
||||
RefundAmount int64
|
||||
}
|
||||
|
||||
// RefundOffsetService 在既有退款成功事务内冲销或提示员工代收款账单。
|
||||
// 只处理来源为后台线下套餐订单的账单，其他订单直接跳过，不阻断退款链路。
|
||||
type RefundOffsetService struct {
|
||||
audit BillAuditWriter
|
||||
}
|
||||
|
||||
// NewRefundOffsetService 创建退款冲销用例。
|
||||
func NewRefundOffsetService(audit BillAuditWriter) *RefundOffsetService {
|
||||
return &RefundOffsetService{audit: audit}
|
||||
}
|
||||
|
||||
// ApplyInTx 在既有退款成功事务内按来源唯一键 order:{id} 查找账单并幂等写入冲销事实。
|
||||
// 同一退款对同一账单至多一条关联：重复投递时关联写入影响 0 行，不再冲减、不再写审计、
|
||||
// 也不依赖退款事务的 changed 标志。
|
||||
func (s *RefundOffsetService) ApplyInTx(ctx context.Context, tx *gorm.DB, source RefundOffsetSource) error {
|
||||
if s == nil || tx == nil || s.audit == nil {
|
||||
return errors.New(errors.CodeInternalError, "员工代收款退款冲销能力未配置")
|
||||
}
|
||||
if source.RefundID == 0 || source.OrderID == 0 || source.RefundAmount <= 0 {
|
||||
return errors.New(errors.CodeInvalidParam, "员工代收款退款冲销参数无效")
|
||||
}
|
||||
var bill model.EmployeeCollectionBill
|
||||
if err := tx.WithContext(ctx).Clauses(clause.Locking{Strength: "UPDATE"}).
|
||||
Where("source_key = ?", employeecollectiondomain.OrderSourceKey(source.OrderID)).
|
||||
First(&bill).Error; err != nil {
|
||||
if err == gorm.ErrRecordNotFound {
|
||||
// 来源订单未产生员工代收款账单，跳过而不阻断退款。
|
||||
return nil
|
||||
}
|
||||
return errors.Wrap(errors.CodeDatabaseError, err, "锁定来源订单员工代收款账单失败")
|
||||
}
|
||||
decision, err := employeecollectiondomain.DecideRefundOffset(billAmounts(&bill), source.RefundAmount)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
record := &model.EmployeeCollectionBillRefund{
|
||||
BillID: bill.ID, RefundID: source.RefundID, SourceOrderID: source.OrderID,
|
||||
RefundAmount: source.RefundAmount, BillReceivableAmount: bill.ReceivableAmount,
|
||||
Outcome: decision.Outcome, ReducedAmount: decision.ReducedAmount,
|
||||
}
|
||||
result := tx.WithContext(ctx).Clauses(clause.OnConflict{
|
||||
Columns: []clause.Column{{Name: "bill_id"}, {Name: "refund_id"}},
|
||||
DoNothing: true,
|
||||
}).Create(record)
|
||||
if result.Error != nil {
|
||||
return errors.Wrap(errors.CodeDatabaseError, result.Error, "写入员工代收款退款冲销关联失败")
|
||||
}
|
||||
if result.RowsAffected == 0 {
|
||||
// 同一退款已冲销过同一账单，保留既有事实。
|
||||
return nil
|
||||
}
|
||||
before := bill
|
||||
if err := applyRefundOutcome(ctx, tx, &bill, decision); err != nil {
|
||||
return err
|
||||
}
|
||||
offsetEventID, err := composeAuditEventID(
|
||||
"employee_collection", "bill", "order", uintText(source.OrderID), "refund", uintText(source.RefundID))
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
return s.audit.WriteEmployeeCollectionBill(ctx, tx, BillAudit{
|
||||
EventID: offsetEventID,
|
||||
ActionCode: constants.AuditActionEmployeeCollectionBillRefundOffseted,
|
||||
Summary: constants.GetEmployeeCollectionRefundOutcomeName(decision.Outcome),
|
||||
Bill: &bill,
|
||||
BeforeData: map[string]any{
|
||||
"receivable_amount": before.ReceivableAmount, "received_amount": before.ReceivedAmount,
|
||||
"reserved_amount": before.ReservedAmount, "status": before.Status,
|
||||
},
|
||||
AfterData: map[string]any{
|
||||
"receivable_amount": bill.ReceivableAmount, "received_amount": bill.ReceivedAmount,
|
||||
"reserved_amount": bill.ReservedAmount, "status": bill.Status,
|
||||
"refund_id": source.RefundID, "refund_amount": source.RefundAmount, "outcome": decision.Outcome,
|
||||
},
|
||||
CorrelationID: bill.SourceNo,
|
||||
})
|
||||
}
|
||||
|
||||
// applyRefundOutcome 按判定结果修改账单：全额退款关闭、部分冲减应收，提示结果不修改金额与状态。
|
||||
// 关闭与冲减都使用 expected-status 条件更新并检查 RowsAffected，避免并发覆盖。
|
||||
func applyRefundOutcome(
|
||||
ctx context.Context,
|
||||
tx *gorm.DB,
|
||||
bill *model.EmployeeCollectionBill,
|
||||
decision employeecollectiondomain.RefundOffsetDecision,
|
||||
) error {
|
||||
expectedStatus := bill.Status
|
||||
switch decision.Outcome {
|
||||
case constants.EmployeeCollectionRefundOutcomeHintOnly:
|
||||
return nil
|
||||
case constants.EmployeeCollectionRefundOutcomeClosedFull:
|
||||
closedAt := time.Now().UTC()
|
||||
result := tx.WithContext(ctx).Model(&model.EmployeeCollectionBill{}).
|
||||
Where("id = ? AND status = ?", bill.ID, expectedStatus).
|
||||
Updates(map[string]any{
|
||||
"status": constants.EmployeeCollectionBillStatusClosed,
|
||||
"closed_reason": "来源订单全额退款",
|
||||
"closed_at": closedAt,
|
||||
"updater": 0,
|
||||
})
|
||||
if result.Error != nil {
|
||||
return errors.Wrap(errors.CodeDatabaseError, result.Error, "关闭来源订单全额退款账单失败")
|
||||
}
|
||||
if result.RowsAffected != 1 {
|
||||
return errors.New(errors.CodeConflict, "员工代收款账单状态已变化，退款冲销未完成")
|
||||
}
|
||||
bill.Status = constants.EmployeeCollectionBillStatusClosed
|
||||
bill.ClosedReason = "来源订单全额退款"
|
||||
bill.ClosedAt = &closedAt
|
||||
return nil
|
||||
case constants.EmployeeCollectionRefundOutcomeReduced:
|
||||
amounts, err := billAmounts(bill).ReduceReceivable(decision.ReducedAmount)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
nextStatus := amounts.DerivedStatus()
|
||||
result := tx.WithContext(ctx).Model(&model.EmployeeCollectionBill{}).
|
||||
Where("id = ? AND status = ?", bill.ID, expectedStatus).
|
||||
Updates(map[string]any{
|
||||
"receivable_amount": amounts.Receivable,
|
||||
"status": nextStatus,
|
||||
"updater": 0,
|
||||
})
|
||||
if result.Error != nil {
|
||||
return errors.Wrap(errors.CodeDatabaseError, result.Error, "冲减来源订单退款账单应收失败")
|
||||
}
|
||||
if result.RowsAffected != 1 {
|
||||
return errors.New(errors.CodeConflict, "员工代收款账单状态已变化，退款冲减未完成")
|
||||
}
|
||||
bill.ReceivableAmount = amounts.Receivable
|
||||
bill.Status = nextStatus
|
||||
return nil
|
||||
default:
|
||||
return errors.New(errors.CodeInternalError, "不支持的退款冲销处理结果")
|
||||
}
|
||||
}
|
||||
@@ -333,6 +333,22 @@ func sceneBusinessFields(businessType string) ([]dto.WeComBusinessFieldResponse,
|
||||
{Code: constants.ApprovalFieldSubmitterID, Name: "提交人账号 ID", ValueType: constants.ApprovalFieldValueTypeInteger, Description: "本系统真实业务提交人账号 ID"},
|
||||
{Code: constants.ApprovalFieldSubmitterName, Name: "提交人名称", ValueType: constants.ApprovalFieldValueTypeString, Description: "本系统真实业务提交人名称快照"},
|
||||
}, true
|
||||
case constants.ApprovalBusinessTypeEmployeeCollection:
|
||||
return []dto.WeComBusinessFieldResponse{
|
||||
{Code: constants.ApprovalFieldCollectionApplicationID, Name: "核销申请 ID", ValueType: constants.ApprovalFieldValueTypeInteger, Description: "员工代收款核销申请的系统 ID"},
|
||||
{Code: constants.ApprovalFieldCollectionPaymentMethod, Name: "线下收款方式", ValueType: constants.ApprovalFieldValueTypeString, Description: "本次外部付款使用的线下收款方式名称快照"},
|
||||
{Code: constants.ApprovalFieldCollectionPaidAmount, Name: "付款金额", ValueType: constants.ApprovalFieldValueTypeMoney, Description: "以元为单位且保留两位小数的人工确认付款金额"},
|
||||
{Code: constants.ApprovalFieldCollectionPaidAmountCent, Name: "付款金额（分）", ValueType: constants.ApprovalFieldValueTypeInteger, Description: "以分为单位的人工确认付款金额整数"},
|
||||
{Code: constants.ApprovalFieldCollectionPayerName, Name: "付款方", ValueType: constants.ApprovalFieldValueTypeString, Description: "本次外部付款的付款方名称"},
|
||||
{Code: constants.ApprovalFieldCollectionPaidAt, Name: "付款时间", ValueType: constants.ApprovalFieldValueTypeString, Description: "本次外部付款时间，RFC3339 格式"},
|
||||
{Code: constants.ApprovalFieldCollectionExternalTransactionNo, Name: "外部交易流水号", ValueType: constants.ApprovalFieldValueTypeString, Description: "人工确认的第三方交易流水号，用于审批人核验"},
|
||||
{Code: constants.ApprovalFieldPaymentVoucherKey, Name: "付款凭证", ValueType: constants.ApprovalFieldValueTypeFileList, Description: "提交时上传到企微文件控件的付款凭证列表"},
|
||||
{Code: constants.ApprovalFieldRemark, Name: "备注", ValueType: constants.ApprovalFieldValueTypeString, Description: "申请人填写的核销备注"},
|
||||
{Code: constants.ApprovalFieldCollectionBillCount, Name: "分摊账单数量", ValueType: constants.ApprovalFieldValueTypeInteger, Description: "本次核销分摊的账单数量"},
|
||||
{Code: constants.ApprovalFieldCollectionBillSummary, Name: "账单分摊摘要", ValueType: constants.ApprovalFieldValueTypeString, Description: "本次各账单应收金额与分摊金额摘要"},
|
||||
{Code: constants.ApprovalFieldSubmitterID, Name: "提交人账号 ID", ValueType: constants.ApprovalFieldValueTypeInteger, Description: "本系统真实业务提交人账号 ID"},
|
||||
{Code: constants.ApprovalFieldSubmitterName, Name: "提交人名称", ValueType: constants.ApprovalFieldValueTypeString, Description: "本系统真实业务提交人名称快照"},
|
||||
}, true
|
||||
default:
|
||||
return nil, false
|
||||
}
|
||||
@@ -353,14 +369,27 @@ func normalizeSceneMapping(mapping []dto.WeComControlMappingItem) []dto.WeComCon
|
||||
}
|
||||
|
||||
func validApprovalBusinessType(businessType string) bool {
|
||||
return businessType == constants.ApprovalBusinessTypeRefund || businessType == constants.ApprovalBusinessTypeOfflineRecharge
|
||||
switch businessType {
|
||||
case constants.ApprovalBusinessTypeRefund,
|
||||
constants.ApprovalBusinessTypeOfflineRecharge,
|
||||
constants.ApprovalBusinessTypeEmployeeCollection:
|
||||
return true
|
||||
default:
|
||||
return false
|
||||
}
|
||||
}
|
||||
|
||||
func approvalBusinessTypeName(businessType string) string {
|
||||
if businessType == constants.ApprovalBusinessTypeRefund {
|
||||
switch businessType {
|
||||
case constants.ApprovalBusinessTypeRefund:
|
||||
return "退款审批"
|
||||
case constants.ApprovalBusinessTypeOfflineRecharge:
|
||||
return "员工线下代充值审批"
|
||||
case constants.ApprovalBusinessTypeEmployeeCollection:
|
||||
return "员工代收款核销审批"
|
||||
default:
|
||||
return "未知审批业务类型"
|
||||
}
|
||||
return "员工线下代充值审批"
|
||||
}
|
||||
|
||||
func sceneAuditSnapshot(scene *model.WeComApprovalScene) map[string]any {
|
||||
|
||||
Reference in New Issue
Block a user