break
575d056f54
Some checks failed
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Has been cancelled
AUG26-008。
- 迁移 000214–000217：tb_shop 全局唯一且不可修改的随机分销码（含存量回填）、
tb_agent_distribution_registration 待审批注册记录、tb_withdrawal_qualification 资料版本、
tb_commission_withdrawal_request_attempt 审批尝试记录，以及提现申请的 latest_*/异常标记列；
不修改既有迁移，down 在存在本 Change 业务事实或新类型场景行时拒绝破坏性回滚。
- 公开接口 POST /api/c/v1/agent-distribution-registrations：无认证，复用既有短信验证码校验、
消费与限流；无效分销码、停用上级、验证码无效或已消费统一返回「分销码不可用」且不落库，
审批通过前不创建店铺、账号或钱包。
- 审批通过才在同一事务内建启用店铺、代理主账号、钱包、上级层级与业务员快照，驳回不建实体，
重复回调不重复建实体，提交后清理上级下级缓存。
- 提现资料资格按不可变版本保存，替换合同或法人身份证即新增版本并同事务失效旧有效版本；
超管作废原因必填；代理停用与店铺删除联动失效。
- 提现每次提交或重提新增不可变审批尝试记录并冻结金额；企业微信通过仅一次从冻结扣减、
保持状态 2 并写 paid_at（不使用状态 4），驳回/cancelled/deleted 仅一次释放，
通过后撤销不回滚、不重新冻结、只写正交异常标记；加锁顺序统一为申请→尝试→钱包。
- 本地人工终审对已关联审批实例的申请返回状态冲突，approval_instance_id 为空的存量申请保持既有行为，
不新增任何配置开关。
- 补齐审批业务类型注册点全集：业务类型与场景字段常量、场景 DTO 两处枚举与中文描述、
场景字段白名单/合法类型/中文名、数据库 CHECK、Worker 决策消费者与装配、审批审计资源映射，
以及三个新审计资源与 13 个审计动作；失败/拒绝审计改为必达。
- 新增后台路由与 OpenAPI：资格提交/查询/作废、提现申请/重提/详情、店铺详情返回只读分销码。
- 归档本 Change：主 Spec 新增 agent-distribution-withdrawal 能力（5 个 Requirement）。
验证（junhong_cmp_test + Redis DB 6，显式 DB_*，未重置整库）：
- 迁移 up → version 217 且 dirty=false → down 3 → up 回 217，fixture 复核残留为 0。
- 受控状态机脚手架 227 项通过 / 0 项失败，覆盖 18 组场景（幂等与乱序回调、资金冻结/释放/重提、
退款回扣 × 在途提现并发、负向场景拒绝审计与 14 个动作码审计真实落库）。
- gofmt 空、go build/go vet 通过、gendocs 与工作区逐字节一致、context-health 通过、
openspec validate --strict 通过、doctor healthy；自动化测试按项目决策为 N/A。
运行期前置（未完成，非代码交付物）：由超管经 PUT /api/admin/wecom/scenes/{business_type} 为
agent_distribution_approval、withdrawal_qualification_approval、commission_withdrawal_approval
配置启用场景与模板控件映射；未配置时相应提交失败关闭。
77 lines
3.4 KiB
Go
77 lines
3.4 KiB
Go
package postgres
|
||
|
||
import (
|
||
"context"
|
||
"time"
|
||
|
||
"gorm.io/gorm"
|
||
"gorm.io/gorm/clause"
|
||
|
||
"github.com/break/junhong_cmp_fiber/internal/model"
|
||
"github.com/break/junhong_cmp_fiber/pkg/errors"
|
||
)
|
||
|
||
// ReleaseUnsettledForRequestsInTx 按申请释放未结算的提现审批尝试冻结事实。
|
||
//
|
||
// 语义：对每个申请，按 `released_at IS NULL` 条件更新写入 released_at，并返回各申请
|
||
// 本次实际释放的金额合计（金额取 attempt.amount 稳定冻结事实）。已释放的尝试不会被重复释放，
|
||
// 因此返回值对该申请是幂等的：重复调用得到空映射或 0。
|
||
//
|
||
// 该原语只写「尝试已释放」事实，不调整钱包余额；调用方必须按返回金额在同一事务内解冻钱包，
|
||
// 使尝试事实与钱包变动保持一致。终态消费者、重提与退款佣金回扣共用本原语，
|
||
// 避免出现「尝试声称未结算而钱包已无冻结」的矛盾事实。
|
||
//
|
||
// 加锁顺序：本函数只负责尝试行（按 ID 升序 FOR UPDATE）。调用方必须先锁申请行，
|
||
// 再进入本函数锁尝试行，最后才锁钱包行，即全库统一的「申请行 → 尝试行 → 钱包行」。
|
||
// 三条路径均遵守该顺序：提现终态消费者（withdrawal_approval.go）、重提与释放接缝
|
||
// （withdrawal.go:releaseUnsettledForRequests）、退款佣金回扣（refund/service.go:
|
||
// collectPendingWithdrawalRejects 在钱包加锁前收集）。
|
||
func ReleaseUnsettledForRequestsInTx(
|
||
ctx context.Context,
|
||
tx *gorm.DB,
|
||
requestIDs []uint,
|
||
now time.Time,
|
||
) (map[uint]int64, error) {
|
||
released := make(map[uint]int64, len(requestIDs))
|
||
if tx == nil || len(requestIDs) == 0 {
|
||
return released, nil
|
||
}
|
||
var attempts []model.CommissionWithdrawalRequestAttempt
|
||
if err := tx.WithContext(ctx).Clauses(clause.Locking{Strength: "UPDATE"}).
|
||
Where("request_id IN ? AND released_at IS NULL", requestIDs).
|
||
Order("id ASC").Find(&attempts).Error; err != nil {
|
||
return nil, errors.Wrap(errors.CodeDatabaseError, err, "查询未结算提现审批尝试失败")
|
||
}
|
||
for index := range attempts {
|
||
attempt := &attempts[index]
|
||
// 行已由上面的 FOR UPDATE 锁定且筛选条件为 released_at IS NULL，
|
||
// 不存在并发改写，故条件更新必然命中，无需再判 RowsAffected。
|
||
if err := tx.WithContext(ctx).Model(&model.CommissionWithdrawalRequestAttempt{}).
|
||
Where("id = ? AND released_at IS NULL", attempt.ID).
|
||
Update("released_at", now).Error; err != nil {
|
||
return nil, errors.Wrap(errors.CodeDatabaseError, err, "标记提现审批尝试已释放失败")
|
||
}
|
||
released[attempt.RequestID] += attempt.Amount
|
||
}
|
||
return released, nil
|
||
}
|
||
|
||
// CountRequestsWithAttemptsInTx 返回给定申请中「已存在审批尝试记录」的申请 ID 集合。
|
||
// 用于区分接入企业微信审批的申请与从未关联审批实例的存量申请。
|
||
func CountRequestsWithAttemptsInTx(ctx context.Context, tx *gorm.DB, requestIDs []uint) (map[uint]struct{}, error) {
|
||
result := make(map[uint]struct{}, len(requestIDs))
|
||
if tx == nil || len(requestIDs) == 0 {
|
||
return result, nil
|
||
}
|
||
var found []uint
|
||
if err := tx.WithContext(ctx).Model(&model.CommissionWithdrawalRequestAttempt{}).
|
||
Where("request_id IN ?", requestIDs).
|
||
Distinct().Pluck("request_id", &found).Error; err != nil {
|
||
return nil, errors.Wrap(errors.CodeDatabaseError, err, "查询提现审批尝试记录归属失败")
|
||
}
|
||
for _, requestID := range found {
|
||
result[requestID] = struct{}{}
|
||
}
|
||
return result, nil
|
||
}
|