feat: 实名即生效套餐沉默期、延期办理与资产出库时间
Some checks failed
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Failing after 8m39s

- 迁移 000259~000265:套餐记录沉默期字段与扫描索引、套餐默认沉默期、延期政策/流水/订单/批次/明细 5 张表、默认政策与系统配置(总开关默认关闭)、企微审批白名单、卡与设备出库时间及出库记录
- 沉默期设置(订单发放、自动购包、钱包续费)、后台购买时调整(超默认值按政策免审或企微审批)、统一判定与激活闸门、排队与孤儿扫描跳过过期套餐、过期套餐禁止退款、每 10 分钟扫描
- 总开关专用接口与打开前 4 项检查;延期政策;延期资格与计费;H5 自助与后台二维码在线支付(商户池路由)、支付回调与查单恢复、线下登记、特殊/批量延期、异常重试与原路退款;沉默期审批场景与终态处理
- 换货沉默期流水与出库时间;卡/设备列表、详情、导出与出库记录接口;延期订单与即将过期套餐列表及导出;财务流水纳入延期支付
- 沉默期与出库时间回填工具 cmd/silence-backfill;前端接口变更说明

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
邹进
2026-10-27 16:32:58 +09:00
parent d2b0d2f534
commit 909f4d0ec2
112 changed files with 10473 additions and 82 deletions

View File

@@ -6,6 +6,7 @@ package asset
import (
"context"
stderrors "errors"
packagesilenceapp "github.com/break/junhong_cmp_fiber/internal/application/packagesilence"
stopresumedomain "github.com/break/junhong_cmp_fiber/internal/domain/stopresume"
"strconv"
"time"
@@ -38,6 +39,7 @@ type PackageExpiryResolver interface {
// Service 资产查询与操作服务
type Service struct {
silenceSwitch SilenceSwitch
db *gorm.DB
deviceStore *postgres.DeviceStore
iotCardStore *postgres.IotCardStore
@@ -199,6 +201,7 @@ func (s *Service) buildDeviceResolveResponse(ctx context.Context, device *model.
AssetType: "device",
AssetID: device.ID,
VirtualNo: device.VirtualNo,
OutboundAt: device.OutboundAt,
Status: device.Status,
StatusName: constants.GetDeviceStatusName(device.Status),
BatchNo: device.BatchNo,
@@ -343,6 +346,7 @@ func (s *Service) buildCardResolveResponse(ctx context.Context, card *model.IotC
AssetType: "card",
AssetID: card.ID,
VirtualNo: card.VirtualNo,
OutboundAt: card.OutboundAt,
Status: card.Status,
StatusName: constants.GetIotCardStatusName(card.Status),
BatchNo: card.BatchNo,
@@ -862,7 +866,9 @@ func (s *Service) GetPackages(ctx context.Context, assetType string, id uint, pa
items := make([]*dto.AssetPackageHistoryNode, 0, len(history.Items))
for _, node := range history.Items {
items = append(items, buildAssetPackageHistoryNode(node, packageMap, callerAccountType))
item := buildAssetPackageHistoryNode(node, packageMap, callerAccountType)
s.fillSilenceViews(ctx, item, node)
items = append(items, item)
}
return &dto.AssetPackagesResult{
@@ -1181,6 +1187,7 @@ func (s *Service) buildAssetPackageResponse(ctx context.Context, usage *model.Pa
PaidAmount: paidAmount,
RetailAmount: usage.RetailAmount,
CreatedAt: usage.CreatedAt,
Silence: s.silenceView(ctx, usage),
}
}
@@ -1540,3 +1547,39 @@ func (s *Service) restorePollingAfterExpiryChange(ctx context.Context, assetType
}
})
}
// SilenceSwitch 读取沉默期总开关。
type SilenceSwitch interface {
Enabled(ctx context.Context) bool
}
// SetSilenceSwitch 注入沉默期总开关;打开时资产套餐列表与详情返回沉默期信息。
func (s *Service) SetSilenceSwitch(sw SilenceSwitch) {
s.silenceSwitch = sw
}
// silenceView 返回套餐记录的沉默期展示信息;总开关关闭时不返回。
func (s *Service) silenceView(ctx context.Context, usage *model.PackageUsage) *dto.PackageSilenceView {
if s.silenceSwitch == nil || !s.silenceSwitch.Enabled(ctx) {
return nil
}
return packagesilenceapp.BuildView(usage, time.Now())
}
// fillSilenceViews 按历史树逐节点填写沉默期展示信息。
func (s *Service) fillSilenceViews(ctx context.Context, item *dto.AssetPackageHistoryNode, node *assetquery.PackageHistoryNode) {
if item == nil || node == nil {
return
}
item.Silence = s.silenceView(ctx, node.Usage)
for index, child := range node.Children {
if index < len(item.Children) {
s.fillSilenceViews(ctx, item.Children[index], child)
}
}
}
// SilenceView 返回套餐记录的沉默期展示信息(H5 资产套餐历史复用);总开关关闭时返回 nil。
func (s *Service) SilenceView(ctx context.Context, usage *model.PackageUsage) *dto.PackageSilenceView {
return s.silenceView(ctx, usage)
}

View File

@@ -262,6 +262,9 @@ func (s *Service) List(ctx context.Context, req *dto.ListDeviceRequest) (*dto.Li
if req.IsAuthorizedToEnterprise != nil {
filters["is_authorized_to_enterprise"] = *req.IsAuthorizedToEnterprise
}
if err := applyOutboundFilters(filters, req.OutboundStart, req.OutboundEnd); err != nil {
return nil, err
}
devices, total, err := s.deviceStore.List(ctx, opts, filters)
if err != nil {
@@ -892,6 +895,7 @@ func (s *Service) toDeviceResponse(device *model.Device, shopMap map[uint]string
activationStatus := activationStatuses[device.ID]
resp := &dto.DeviceResponse{
EnablePolling: device.EnablePolling,
OutboundAt: device.OutboundAt,
ID: device.ID,
VirtualNo: device.VirtualNo,
IMEI: device.IMEI,
@@ -1769,3 +1773,22 @@ func (s *Service) recordCardCommand(ctx context.Context, card *model.IotCard, ac
Attempt: 1, CallErr: callErr, Duration: duration,
})
}
// applyOutboundFilters 解析出库时间范围筛选(RFC3339)。
func applyOutboundFilters(filters map[string]any, start, end string) error {
if start != "" {
value, err := time.Parse(time.RFC3339, start)
if err != nil {
return errors.New(errors.CodeInvalidParam, "出库时间起格式应为 RFC3339")
}
filters["outbound_start"] = value
}
if end != "" {
value, err := time.Parse(time.RFC3339, end)
if err != nil {
return errors.New(errors.CodeInvalidParam, "出库时间止格式应为 RFC3339")
}
filters["outbound_end"] = value
}
return nil
}

View File

@@ -2,6 +2,7 @@ package exchange
import (
"context"
packagesilenceapp "github.com/break/junhong_cmp_fiber/internal/application/packagesilence"
"strings"
"time"
@@ -35,6 +36,12 @@ type Service struct {
shippingCreatedNotifier *exchangeapp.ShippingCreatedNotifier
auditWriter *audit.Writer
logger *zap.Logger
silenceHook *packagesilenceapp.ExchangeHook
}
// SetSilenceHook 注入沉默期与出库时间换货接缝。
func (s *Service) SetSilenceHook(hook *packagesilenceapp.ExchangeHook) {
s.silenceHook = hook
}
func New(
@@ -395,6 +402,10 @@ func (s *Service) Renew(ctx context.Context, id uint) error {
}).Error; updateErr != nil {
return errors.Wrap(errors.CodeDatabaseError, updateErr, "重置旧卡转新状态失败")
}
// 出库时间:旧卡回库、世代 +1,清空出库时间并结束旧世代出库记录
if hookErr := s.silenceHook.OnOldAssetRenewedInTx(ctx, tx, constants.ExchangeAssetTypeIotCard, card.ID, card.Generation, time.Now()); hookErr != nil {
return hookErr
}
cardKey := exchangeAssetBindingKey(&resolvedExchangeAsset{AssetType: constants.ExchangeAssetTypeIotCard, Card: &card, VirtualNo: card.VirtualNo})
if cardKey != "" {
@@ -468,6 +479,10 @@ func (s *Service) Renew(ctx context.Context, id uint) error {
}).Error; err != nil {
return errors.Wrap(errors.CodeDatabaseError, err, "重置旧设备转新状态失败")
}
// 出库时间:旧设备回库、世代 +1,清空出库时间并结束旧世代出库记录
if err = s.silenceHook.OnOldAssetRenewedInTx(ctx, tx, constants.ExchangeAssetTypeDevice, device.ID, device.Generation, time.Now()); err != nil {
return err
}
deviceKey := exchangeAssetBindingKey(&resolvedExchangeAsset{AssetType: constants.ExchangeAssetTypeDevice, Device: &device, VirtualNo: device.VirtualNo})
if deviceKey != "" {
@@ -848,6 +863,10 @@ func (s *Service) completeExchangeWithTx(ctx context.Context, tx *gorm.DB, order
if err != nil {
return err
}
// 沉默期随套餐记录迁移、不重新起算,写换货流水
if err = s.silenceHook.OnUsagesMigratedInTx(ctx, tx, order, migration.PackageUsageIDs); err != nil {
return errors.Wrap(errors.CodeExchangeMigrationFailed, err, "写入沉默期换货流水失败")
}
}
now := time.Now()
@@ -878,6 +897,10 @@ func (s *Service) completeExchangeWithTx(ctx context.Context, tx *gorm.DB, order
if result.RowsAffected == 0 {
return errors.New(errors.CodeExchangeStatusInvalid)
}
// 出库时间:换货后的新资产取换货完成时间(当前世代已有出库时间的不覆盖)
if err = s.silenceHook.OnNewAssetInTx(ctx, tx, order.NewAssetType, *order.NewAssetID, order, now); err != nil {
return err
}
orderBefore := map[string]any{"status": fromStatus, "migration_completed": order.MigrationCompleted, "migration_balance": order.MigrationBalance, "migration_status": beforeMigrationStatus}
order.Status = constants.ExchangeStatusCompleted
order.CompletedAt = &now

View File

@@ -275,6 +275,9 @@ func (s *Service) ListStandalone(ctx context.Context, req *dto.ListStandaloneIot
if req.IsAuthorizedToEnterprise != nil {
filters["is_authorized_to_enterprise"] = *req.IsAuthorizedToEnterprise
}
if err := applyOutboundFilters(filters, req.OutboundStart, req.OutboundEnd); err != nil {
return nil, err
}
// 代理用户注入 subordinate_shop_ids,让 Store 层走并行查询路径
// 避免 PG 对 shop_id IN (...) + ORDER BY 选择全表扫描
@@ -481,6 +484,7 @@ func (s *Service) toStandaloneResponse(card *model.IotCard, shopMap map[uint]str
ID: card.ID,
ICCID: card.ICCID,
VirtualNo: card.VirtualNo,
OutboundAt: card.OutboundAt,
CardCategory: card.CardCategory,
CarrierID: card.CarrierID,
CarrierType: card.CarrierType,
@@ -2073,3 +2077,22 @@ func (s *Service) clearRealnameReversalCounter(ctx context.Context, cardID uint)
zap.Error(err))
}
}
// applyOutboundFilters 解析出库时间范围筛选(RFC3339)。
func applyOutboundFilters(filters map[string]any, start, end string) error {
if start != "" {
value, err := time.Parse(time.RFC3339, start)
if err != nil {
return errors.New(errors.CodeInvalidParam, "出库时间起格式应为 RFC3339")
}
filters["outbound_start"] = value
}
if end != "" {
value, err := time.Parse(time.RFC3339, end)
if err != nil {
return errors.New(errors.CodeInvalidParam, "出库时间止格式应为 RFC3339")
}
filters["outbound_end"] = value
}
return nil
}

View File

@@ -14,6 +14,7 @@ import (
cardObservationApp "github.com/break/junhong_cmp_fiber/internal/application/cardobservation"
employeecollectionapp "github.com/break/junhong_cmp_fiber/internal/application/employeecollection"
merchantpayment "github.com/break/junhong_cmp_fiber/internal/application/merchantpayment"
packagesilenceapp "github.com/break/junhong_cmp_fiber/internal/application/packagesilence"
priorityapp "github.com/break/junhong_cmp_fiber/internal/application/prioritypolling"
walletapp "github.com/break/junhong_cmp_fiber/internal/application/wallet"
employeecollectiondomain "github.com/break/junhong_cmp_fiber/internal/domain/employeecollection"
@@ -85,6 +86,18 @@ type Service struct {
auditWriter *audit.Writer
paymentIntegration *integrationlog.Repository
billCreation *employeecollectionapp.BillCreationService
silenceSetter *packagesilenceapp.Setter
outboundRecorder *packagesilenceapp.OutboundRecorder
}
// SetSilenceSetter 注入沉默期设置用例(支付成功创建套餐记录时设置沉默期)。
func (s *Service) SetSilenceSetter(setter *packagesilenceapp.Setter) {
s.silenceSetter = setter
}
// SetOutboundRecorder 注入资产出库时间写入用例。
func (s *Service) SetOutboundRecorder(recorder *packagesilenceapp.OutboundRecorder) {
s.outboundRecorder = recorder
}
// SetEmployeeCollectionBillCreation 注入员工代收款账单建账用例。
@@ -280,6 +293,18 @@ func (s *Service) CreateAdminOrder(ctx context.Context, req *dto.CreateAdminOrde
}
}
// 购买时调整沉默期:事务前校验权限、天数与原因,超默认值需审批时提前完成审批渠道检查
if req.SilencePeriodDays != nil {
if s.silenceSetter == nil {
return nil, errors.New(errors.CodeSilenceOverrideForbidden)
}
override, overrideErr := s.silenceSetter.PrepareOverride(ctx, middleware.GetUserIDFromContext(ctx), req.SilencePeriodDays, req.SilenceReason, validationResult.Packages)
if overrideErr != nil {
return nil, overrideErr
}
ctx = packagesilenceapp.WithPurchaseOverride(ctx, override)
}
carrierType, carrierID := resolveAdminCarrierInfoFromVars(orderType, iotCardID, deviceID)
existingOrderID, lockToken, err := s.checkOrderIdempotency(ctx, buyerType, buyerID, orderType, carrierType, carrierID, req.PackageIDs)
lockKey := constants.RedisOrderCreateLockKey(carrierType, carrierID)
@@ -2334,6 +2359,12 @@ func (s *Service) activatePackage(ctx context.Context, tx *gorm.DB, order *model
createdUsage = true
}
}
if createdUsage && s.outboundRecorder != nil {
// 出库时间:资产当前世代第 1 次购买套餐的支付时间(只记录展示,不受沉默期总开关影响)
if err := s.outboundRecorder.RecordForOrderInTx(ctx, tx, order); err != nil {
return err
}
}
if createdUsage {
if s.observationSeriesEvents == nil {
return errors.New(errors.CodeInternalError, "购包观测 Outbox Writer 未配置")
@@ -2740,6 +2771,16 @@ func (s *Service) activateMainPackage(ctx context.Context, tx *gorm.DB, order *m
}).Error; err != nil {
return errors.Wrap(errors.CodeDatabaseError, err, "更新主套餐状态失败")
}
// 沉默期:实名即生效主套餐在资产未实名时购买,从支付成功起计算沉默期(总开关关闭也记录)
if s.silenceSetter != nil {
paidAt := now
if order.PaidAt != nil {
paidAt = *order.PaidAt
}
if err := s.silenceSetter.ApplyOnUsageCreatedInTx(ctx, tx, usage, pkg, paidAt, constants.SilenceTriggerOrderPaid); err != nil {
return err
}
}
// 仅在生效状态分支追加优先轮询请求:待生效(含等待实名激活)不属于本 Change 的触发场景。
if status == constants.PackageUsageStatusActive {

View File

@@ -37,6 +37,41 @@ type ActivationService struct {
priorityEvents priorityapp.PriorityEventWriter
auditWriter *audit.Writer
preActivationSettler PreActivationSettler // 激活前流量结算,可选
silenceGate SilenceGate // 沉默期激活闸门,可选
silenceFilter SilenceStatusFilter // 沉默期总开关,可选
}
// SilenceGate 是沉默期激活闸门(add-package-silence-period §5.3):激活事务内、实名判断前判定沉默期;
// 返回 false 表示套餐沉默期已过期,任何入口都不能激活。
type SilenceGate interface {
AllowActivationInTx(ctx context.Context, tx *gorm.DB, usage *model.PackageUsage) (bool, error)
}
// SilenceStatusFilter 返回总开关打开时排队与孤儿扫描需要排除过期套餐的判断。
type SilenceStatusFilter interface {
Enabled(ctx context.Context) bool
}
// SetSilenceGate 注入沉默期激活闸门与总开关;未注入时行为与现状一致。
func (s *ActivationService) SetSilenceGate(gate SilenceGate, filter SilenceStatusFilter) {
s.silenceGate = gate
s.silenceFilter = filter
}
// excludeSilenceExpired 在总开关打开时为待生效主套餐查询追加"跳过沉默期已过期"条件。
func (s *ActivationService) excludeSilenceExpired(ctx context.Context, query *gorm.DB) *gorm.DB {
if s.silenceFilter == nil || !s.silenceFilter.Enabled(ctx) {
return query
}
return query.Where("(silence_status IS NULL OR silence_status <> ?)", constants.SilenceStatusExpired)
}
// allowSilence 执行沉默期闸门;未注入时放行。
func (s *ActivationService) allowSilence(ctx context.Context, tx *gorm.DB, usage *model.PackageUsage) (bool, error) {
if s.silenceGate == nil || usage == nil {
return true, nil
}
return s.silenceGate.AllowActivationInTx(ctx, tx, usage)
}
// PreActivationSettler 在资产从无生效主套餐变为有生效主套餐之前做一次流量结算(尽力而为,不阻塞激活)。
@@ -172,6 +207,15 @@ func (s *ActivationService) ActivateByRealname(ctx context.Context, carrierType
// 检查是否是主套餐
if usage.MasterUsageID == nil {
// 沉默期闸门:期内实名记为结束(之后照常激活或排队),沉默期已过期的不激活
allowed, gateErr := s.allowSilence(ctx, tx, usage)
if gateErr != nil {
return gateErr
}
if !allowed {
s.logger.Info("套餐沉默期已过期,实名后不激活", zap.Uint("usage_id", usage.ID))
continue
}
// 主套餐:需要检查是否有已激活或已用完(仍在有效期)的主套餐
var activeMain model.PackageUsage
err := tx.Where("status IN ?", []int{constants.PackageUsageStatusActive, constants.PackageUsageStatusDepleted}).
@@ -193,6 +237,17 @@ func (s *ActivationService) ActivateByRealname(ctx context.Context, carrierType
}
}
if usage.MasterUsageID != nil {
// 挂在沉默期已过期主套餐下的待生效加油包随主套餐一并不可用(D21)
masterExpired, masterErr := s.isMasterSilenceExpired(ctx, tx, *usage.MasterUsageID)
if masterErr != nil {
return masterErr
}
if masterExpired {
continue
}
}
terms, termsErr := ResolveUsageTerms(usage, &pkg, s.logger)
if termsErr != nil {
return termsErr
@@ -636,10 +691,12 @@ func (s *ActivationService) activateNextMainPackage(ctx context.Context, tx *gor
func (s *ActivationService) getNextPendingMainPackage(ctx context.Context, tx *gorm.DB, carrierType string, carrierID uint) (*model.PackageUsage, error) {
var nextMain model.PackageUsage
err := tx.WithContext(ctx).
query := tx.WithContext(ctx).
Where("status = ?", constants.PackageUsageStatusPending).
Where("master_usage_id IS NULL").
Where(carrierType+"_id = ?", carrierID).
Where(carrierType+"_id = ?", carrierID)
// 沉默期已过期的套餐不能挡住同资产后续套餐(总开关打开时)
err := s.excludeSilenceExpired(ctx, query).
Order("priority ASC, created_at ASC").
First(&nextMain).Error
if err != nil {
@@ -669,6 +726,10 @@ func (s *ActivationService) canActivatePendingUsage(ctx context.Context, tx *gor
if usage == nil {
return false, nil
}
allowed, err := s.allowSilence(ctx, tx, usage)
if err != nil || !allowed {
return false, err
}
if !usage.PendingRealnameActivation {
return true, nil
}
@@ -996,3 +1057,22 @@ func (s *ActivationService) InvalidateAllPackagesByAsset(ctx context.Context, as
return nil
}
// isMasterSilenceExpired 判断主套餐沉默期是否已过期(总开关打开时才生效)。
func (s *ActivationService) isMasterSilenceExpired(ctx context.Context, tx *gorm.DB, masterUsageID uint) (bool, error) {
if s.silenceFilter == nil || !s.silenceFilter.Enabled(ctx) {
return false, nil
}
var count int64
if err := tx.WithContext(ctx).Model(&model.PackageUsage{}).
Where("id = ? AND silence_status = ?", masterUsageID, constants.SilenceStatusExpired).
Count(&count).Error; err != nil {
return false, errors.Wrap(errors.CodeDatabaseError, err, "查询主套餐沉默期状态失败")
}
return count > 0, nil
}
// SilenceRulesEnabled 返回沉默期总开关是否打开(孤儿扫描等外部查询用于排除过期套餐)。
func (s *ActivationService) SilenceRulesEnabled(ctx context.Context) bool {
return s != nil && s.silenceFilter != nil && s.silenceFilter.Enabled(ctx)
}

View File

@@ -23,6 +23,8 @@ func FindAttachableMainPackageForAddon(tx *gorm.DB, carrierType string, carrierI
},
now,
).
// 沉默期已过期的待生效主套餐不能再挂加油包(D21:其下加油包随主套餐不可用)
Where("NOT (status = ? AND silence_status IS NOT NULL AND silence_status = ?)", constants.PackageUsageStatusPending, constants.SilenceStatusExpired).
Order("priority ASC")
switch carrierType {

View File

@@ -107,5 +107,26 @@ func packageData(pkg *model.Package) map[string]any {
"suggested_retail_price": pkg.SuggestedRetailPrice, "price_config_status": pkg.PriceConfigStatus,
"is_gift": pkg.IsGift, "status": pkg.Status, "shelf_status": pkg.ShelfStatus,
"calendar_type": pkg.CalendarType, "data_reset_cycle": pkg.DataResetCycle, "expiry_base": pkg.ExpiryBase,
"silence_period_days": pkg.SilencePeriodDays, "silence_extension_enabled": pkg.SilenceExtensionEnabled,
}
}
// appendSilenceDefaultAudit 在默认沉默期或是否支持延期变化时写审计 package.silence_default_changed。
// 修改默认值只影响之后的新购买,已有套餐记录的截止日不变。
func (s *Service) appendSilenceDefaultAudit(ctx context.Context, tx *gorm.DB, before, after *model.Package) error {
if sameIntPointer(before.SilencePeriodDays, after.SilencePeriodDays) && before.SilenceExtensionEnabled == after.SilenceExtensionEnabled {
return nil
}
if s.auditWriter == nil {
return nil
}
beforeData := map[string]any{"silence_period_days": before.SilencePeriodDays, "silence_extension_enabled": before.SilenceExtensionEnabled}
afterData := map[string]any{"silence_period_days": after.SilencePeriodDays, "silence_extension_enabled": after.SilenceExtensionEnabled}
resource := audit.PackageResource(after, constants.AuditResourceRelationPrimary, constants.AuditResourceRolePackageTarget, beforeData, afterData)
return s.auditWriter.AppendSilenceResource(ctx, tx, constants.AuditActionPackageSilenceDefaultChanged,
"修改套餐默认沉默期 "+after.PackageCode, resource, nil)
}
func sameIntPointer(left, right *int) bool {
return left == nil && right == nil || left != nil && right != nil && *left == *right
}

View File

@@ -149,11 +149,22 @@ func (s *Service) Create(ctx context.Context, req *dto.CreatePackageRequest) (_
}
pkg.VirtualRatio = calculateVirtualRatio(pkg.EnableVirtualData, pkg.RealDataMB, pkg.VirtualDataMB)
pkg.Creator = currentUserID
pkg.SilencePeriodDays = req.SilencePeriodDays
pkg.SilenceExtensionEnabled = req.SilenceExtensionEnabled == nil || *req.SilenceExtensionEnabled
if err := ValidatePackageSilenceConfig(pkg); err != nil {
return nil, err
}
if err := s.db.WithContext(ctx).Transaction(func(tx *gorm.DB) error {
if err := postgres.NewPackageStore(tx).Create(ctx, pkg); err != nil {
return errors.Wrap(errors.CodeInternalError, err, "创建套餐失败")
}
// GORM 对 false 布尔值使用数据库默认值 true,显式关闭时补写一次。
if !pkg.SilenceExtensionEnabled {
if err := tx.Model(&model.Package{}).Where("id = ?", pkg.ID).Update("silence_extension_enabled", false).Error; err != nil {
return errors.Wrap(errors.CodeDatabaseError, err, "保存是否支持延期失败")
}
}
return s.appendPackageAudit(ctx, tx, constants.AuditActionPackageCreated, "创建套餐商品 "+pkg.PackageCode, pkg, nil, packageData(pkg))
}); err != nil {
return nil, err
@@ -283,6 +294,21 @@ func (s *Service) Update(ctx context.Context, id uint, req *dto.UpdatePackageReq
if req.ExpiryBase != nil {
pkg.ExpiryBase = *req.ExpiryBase
}
if err := ValidatePackageExpiryBaseChange(&before, before.ExpiryBase, pkg.ExpiryBase, req.SilencePeriodDays != nil); err != nil {
return nil, err
}
if req.SilencePeriodDays != nil {
pkg.SilencePeriodDays = req.SilencePeriodDays
} else if !RequiresSilencePeriod(pkg) {
// 套餐不再需要沉默期(如改为加油包)时清空默认值,避免普通套餐残留沉默期配置。
pkg.SilencePeriodDays = nil
}
if req.SilenceExtensionEnabled != nil {
pkg.SilenceExtensionEnabled = *req.SilenceExtensionEnabled
}
if err := ValidatePackageSilenceConfig(pkg); err != nil {
return nil, err
}
var rawSuggestedRetailPrice *int64
switch {
@@ -329,7 +355,10 @@ func (s *Service) Update(ctx context.Context, id uint, req *dto.UpdatePackageReq
if err := postgres.NewPackageStore(tx).Update(ctx, pkg); err != nil {
return errors.Wrap(errors.CodeInternalError, err, "更新套餐失败")
}
return s.appendPackageAudit(ctx, tx, constants.AuditActionPackageUpdated, "更新套餐商品 "+pkg.PackageCode, pkg, packageData(&before), packageData(pkg))
if err := s.appendPackageAudit(ctx, tx, constants.AuditActionPackageUpdated, "更新套餐商品 "+pkg.PackageCode, pkg, packageData(&before), packageData(pkg)); err != nil {
return err
}
return s.appendSilenceDefaultAudit(ctx, tx, &before, pkg)
}); err != nil {
return nil, err
}
@@ -390,6 +419,9 @@ func (s *Service) List(ctx context.Context, req *dto.PackageListRequest) ([]*dto
if req.PackageType != nil {
filters["package_type"] = *req.PackageType
}
if req.SilenceUnconfigured != nil && *req.SilenceUnconfigured {
filters["silence_unconfigured"] = true
}
packages, total, err := s.packageStore.List(ctx, opts, filters)
if err != nil {
@@ -818,6 +850,9 @@ func initPackageExpiryBaseFields(resp *dto.PackageResponse, pkg *model.Package)
resp.DefaultExpiryBaseName = ExpiryBaseName(pkg.ExpiryBase)
resp.EffectiveExpiryBase = pkg.ExpiryBase
resp.EffectiveExpiryBaseName = ExpiryBaseName(pkg.ExpiryBase)
resp.SilencePeriodDays = pkg.SilencePeriodDays
resp.SilenceExtensionEnabled = pkg.SilenceExtensionEnabled
resp.SilenceConfigRequired = RequiresSilencePeriod(pkg)
}
func applyAllocationExpiryBase(resp *dto.PackageResponse, pkg *model.Package, allocation *model.ShopPackageAllocation) {

View File

@@ -47,3 +47,52 @@ func ExpiryBaseOverrideName(value *string) string {
}
return ExpiryBaseName(*value)
}
// ValidateAllocationExpiryBaseOverride 校验分配覆盖不得改变套餐生效条件(add-package-silence-period §3.3)。
// 套餐服务与店铺分配(单个、批量、系列授权)写入路径共用:
// 覆盖把实名即生效套餐改成购买即生效会绕过沉默期;把购买即生效套餐改成实名即生效时该套餐没有默认沉默期,两者都阻断。
// 覆盖为空(跟随套餐默认)或与套餐一致时放行;加油包不进入沉默期,不受此约束。
func ValidateAllocationExpiryBaseOverride(pkg *model.Package, override *string) error {
if pkg == nil || override == nil || pkg.PackageType == constants.PackageTypeAddon {
return nil
}
if *override != pkg.ExpiryBase {
return errors.New(errors.CodePackageExpiryBaseChangeForbidden,
"套餐「"+pkg.PackageName+"」不允许通过分配覆盖改变生效条件(实名即生效与购买即生效不能互相覆盖)")
}
return nil
}
// ValidatePackageExpiryBaseChange 校验套餐自身生效条件变更(§3.3):实名即生效改为购买即生效阻断;
// 购买即生效改为实名即生效时,同一请求必须提供默认沉默期。
func ValidatePackageExpiryBaseChange(pkg *model.Package, before, after string, silenceDaysSubmitted bool) error {
if pkg == nil || pkg.PackageType == constants.PackageTypeAddon || before == after {
return nil
}
if before == constants.PackageExpiryBaseFromActivation && after == constants.PackageExpiryBaseFromPurchase {
return errors.New(errors.CodePackageExpiryBaseChangeForbidden, "实名即生效套餐不允许改为购买即生效")
}
if before == constants.PackageExpiryBaseFromPurchase && after == constants.PackageExpiryBaseFromActivation && !silenceDaysSubmitted {
return errors.New(errors.CodeSilencePeriodOutOfRange, "改为实名即生效时必须同时设置默认沉默期(1~90 天)")
}
return nil
}
// RequiresSilencePeriod 判断套餐是否必须配置默认沉默期:实名即生效的正式套餐。
func RequiresSilencePeriod(pkg *model.Package) bool {
return pkg != nil && pkg.PackageType != constants.PackageTypeAddon && pkg.ExpiryBase == constants.PackageExpiryBaseFromActivation
}
// ValidatePackageSilenceConfig 校验套餐最终的沉默期配置:实名即生效正式套餐必填 1~90 天;其他套餐不得填写。
func ValidatePackageSilenceConfig(pkg *model.Package) error {
if RequiresSilencePeriod(pkg) {
if pkg.SilencePeriodDays == nil || *pkg.SilencePeriodDays < constants.SilencePackageDaysMin || *pkg.SilencePeriodDays > constants.SilencePackageDaysMax {
return errors.New(errors.CodeSilencePeriodOutOfRange, "实名即生效套餐必须配置默认沉默期(1~90 天)")
}
return nil
}
if pkg != nil && pkg.SilencePeriodDays != nil {
return errors.New(errors.CodeInvalidParam, "只有实名即生效的正式套餐可以配置沉默期")
}
return nil
}

View File

@@ -65,6 +65,7 @@ type Service struct {
paymentMerchantRuntime *merchantpayment.RuntimeLoader
refundOffset *employeecollectionapp.RefundOffsetService
channelRefund *refundchannelapp.Service
silenceSwitch SilenceSwitch
}
// SetChannelRefundService 注入渠道原路退款用例。
@@ -159,6 +160,9 @@ func (s *Service) Create(ctx context.Context, req *dto.CreateRefundRequest) (*dt
}
return nil, errors.New(errors.CodeInvalidStatus, "仅已支付订单可申请退款")
}
if err := s.ensureSilenceRefundable(ctx, order.ID, req.PackageUsageID); err != nil {
return nil, err
}
decision, err := s.decideRefundMethods(ctx, order)
if err != nil {

View File

@@ -0,0 +1,42 @@
package refund
import (
"context"
"github.com/break/junhong_cmp_fiber/internal/model"
"github.com/break/junhong_cmp_fiber/pkg/constants"
"github.com/break/junhong_cmp_fiber/pkg/errors"
)
// SilenceSwitch 读取沉默期总开关。
type SilenceSwitch interface {
Enabled(ctx context.Context) bool
}
// SetSilenceSwitch 注入沉默期总开关;打开时沉默期已过期的套餐不能申请退款。
func (s *Service) SetSilenceSwitch(sw SilenceSwitch) {
s.silenceSwitch = sw
}
// ensureSilenceRefundable 拦截沉默期已过期套餐的退款申请(add-package-silence-period §5.5)。
// 退款套餐定位口径与退款套餐失效一致:优先冻结的套餐记录,否则取订单下主套餐记录。
func (s *Service) ensureSilenceRefundable(ctx context.Context, orderID uint, packageUsageID *uint) error {
if s.silenceSwitch == nil || !s.silenceSwitch.Enabled(ctx) {
return nil
}
query := s.db.WithContext(ctx).Model(&model.PackageUsage{}).
Where("status = ? AND silence_status = ?", constants.PackageUsageStatusPending, constants.SilenceStatusExpired)
if packageUsageID != nil && *packageUsageID > 0 {
query = query.Where("id = ?", *packageUsageID)
} else {
query = query.Where("order_id = ? AND master_usage_id IS NULL", orderID)
}
var count int64
if err := query.Count(&count).Error; err != nil {
return errors.Wrap(errors.CodeDatabaseError, err, "查询套餐沉默期状态失败")
}
if count > 0 {
return errors.New(errors.CodeSilenceExpiredNotRefundable)
}
return nil
}

View File

@@ -57,6 +57,9 @@ func (s *Service) UpdateExpiryBase(ctx context.Context, id uint, req *dto.Update
if err != nil {
return nil, errors.New(errors.CodeForbidden, "无权限操作该资源或资源不存在")
}
if err := packagepkg.ValidateAllocationExpiryBaseOverride(pkg, override); err != nil {
return nil, err
}
before := allocation.ExpiryBaseOverride
beforeAllocation := *allocation
defer func() {
@@ -154,6 +157,9 @@ func (s *Service) BatchAllocate(ctx context.Context, req *dto.BatchAllocatePacka
createdAllocations := make([]*model.ShopPackageAllocation, 0, len(packages))
packageMap := make(map[uint]*model.Package, len(packages))
for _, pkg := range packages {
if err := packagepkg.ValidateAllocationExpiryBaseOverride(pkg, expiryBaseOverride); err != nil {
return nil, err
}
packageMap[pkg.ID] = pkg
}
batchTotal = len(packages)

View File

@@ -105,6 +105,9 @@ func (s *Service) validateInitialGrantPackages(ctx context.Context, tx *gorm.DB,
packageMap := make(map[uint]*model.Package, len(packages))
for _, pkg := range packages {
if err := packagepkg.ValidateAllocationExpiryBaseOverride(pkg, req.ExpiryBaseOverride); err != nil {
return nil, err
}
packageMap[pkg.ID] = pkg
}
@@ -947,6 +950,9 @@ func (s *Service) ManagePackages(ctx context.Context, id uint, req *dto.ManageGr
if pkg.IsGift {
return errors.New(errors.CodeForbidden, "赠送套餐不能分配给代理")
}
if overrideErr := packagepkg.ValidateAllocationExpiryBaseOverride(pkg, expiryBaseOverride); overrideErr != nil {
return overrideErr
}
if allocation.AllocatorShopID > 0 {
_, authErr := s.shopPackageAllocationStore.GetByShopAndPackageForSystem(ctx, allocation.AllocatorShopID, item.PackageID)
if authErr != nil {