update
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 10m49s

This commit is contained in:
2026-09-03 09:28:28 +08:00
parent dbfeeee253
commit 370fd3e67f
150 changed files with 64402 additions and 247 deletions

View File

@@ -0,0 +1,2 @@
schema: spec-driven
created: 2026-08-31

View File

@@ -0,0 +1,31 @@
## Context
套餐续购、资产钱包和复机已有独立事实;自动续费仅编排这些既有能力,不能把复机失败当作资金失败。
## Decisions
- 保存全局配置和按资产/日期的尝试记录,用唯一约束保证每日一次。
- Worker 按资产锁重读资格、当前售价和余额,以既有订单/钱包事务完成续购;人工订单通过同一锁优先。
- 成功后以可靠任务调用复机,单独记录结果;通知使用既有事件去重。
## 配置、扫描与执行契约
### 配置维护
- `GET /asset-auto-renewal-config` 与 `PUT /asset-auto-renewal-config` 仅超级管理员、平台用户。配置为单例:`enabled`、`scope`(`all_main_packages`/`specified_main_packages`)、`package_ids`(指定范围时非空且只能是可售主套餐)、`days_before_expiry`(正整数)。保存时记录操作者、前后快照和时间;代理、企业、个人客户无读取或修改入口。
- 配置变更只影响后续扫描,已产生的尝试记录不重算;关闭开关后 Worker 不创建新尝试或订单。
### 每日扫描与尝试
- Worker 在上海自然日按资产扫描,先用 `(asset_id, attempt_date)` 唯一记录占位,确保每资产每天至多一次尝试。仅选择存在当前有效主套餐、套餐未到期、最终到期时间进入 `days_before_expiry` 窗口、套餐在配置范围且资产钱包正常的资产;加油包、已到期套餐、流量阈值事件均不是触发源。
- Worker 对每项候选锁定资产、当前主套餐、资产钱包和当日尝试,再次读取配置、到期时间、当前可售续费价与人工订单。人工成功续购已产生时,标记跳过且不扣款;余额不足或套餐不可续费时记录失败原因、不建订单、不扣款。
### 续费、通知与复机
- 合格项复用既有资产钱包订单/套餐生效事务,以执行时当前续费价扣同一资产钱包可用余额,创建同套餐商品续购订单、钱包流水和套餐使用事实;任一步失败整体回滚资金、订单和套餐,并写失败尝试。成功后当日不再处理该资产。
- 余额不足、不可续费、订单失败和复机失败均使用客户/业务员/日期/原因类型幂等键投递最多一条通知;接收人只在事件创建时解析,业务员不存在时不阻断续费或尝试记录。
- 续费成功后仅当资产处于可恢复停机且运营商状态不是风险停机或已销户时投递可靠复机任务。复机成功更新既有状态;失败/未知保存执行结果并走既有恢复,不回滚钱包扣款、订单、套餐生效或续费成功事实。
## Migration Plan
新增成对迁移;隔离库验证范围、窗口、每日去重、价格、余额、手动并发、复机和 up/down/up。

View File

@@ -0,0 +1,25 @@
## Scope
- 迭代编号:`AUG26-010`。
## Why
客户容易遗漏套餐续费;资产钱包余额充足时应在到期前自动续购,但不得与手动购买、停复机或钱包资金事实混淆。
## What Changes
- 新增全局自动续费范围和最终到期前天数配置。
- 每资产每天一次从同资产钱包按当前续费价续购。
- 手动优先,失败通知,成功后条件复机且复机失败不回滚续费。
## Capabilities
### New Capabilities
- `asset-auto-renewal`: 资产钱包自动续费。
### Modified Capabilities
- 无。
## Impact
影响套餐、资产钱包、订单、任务、运营商复机、通知和 Schema。

View File

@@ -0,0 +1,25 @@
## Purpose
在套餐最终到期前的受控窗口内,仅以同一资产钱包余额自动续购当前有效主套餐,并使扣款、套餐生效和复机失败具有明确且可恢复的边界。
## ADDED Requirements
### Requirement: 自动续费配置、权限与频率
仅超级管理员和平台用户 SHALL 查看或修改全局自动续费开关、适用全部或指定主套餐及统一到期前 N 天;每次新增、修改、启用、停用必须记录操作者、修改前后值和时间。系统 SHALL 对已保存的有效配置执行续费:仅对当前有效主套餐、尚未到期、进入最终到期前窗口的资产处理;不得按流量阈值触发。每项资产每天最多尝试一次,成功后停止,套餐到期后不再自动尝试。
续费 MUST 仅扣该资产钱包可用余额,续购同一套餐商品,价格取执行时当前渠道可售续费价。余额不足或套餐不可续费时,不创建订单、不扣款,并向当前个人客户和资产所属店铺当时有效业务员各创建每日至多一条通知。
#### Scenario: 无权限修改配置
- **WHEN** 代理、企业或个人客户请求修改自动续费配置
- **THEN** 系统拒绝请求且不改变配置或产生执行任务
#### Scenario: 窗口内余额不足
- **WHEN** 合格资产进入自动续费窗口但资产钱包余额不足
- **THEN** 系统记录当日尝试失败且不扣款,并向当前客户和有效业务员各投递一次通知
### Requirement: 并发、成功与复机
手动续购 SHALL 优先于自动续费。自动任务必须锁定并重读资产、套餐和钱包;发现人工已成功续购时跳过,避免重复扣款。成功续费后,仅当资产为可恢复停机且运营商状态不是风险停机或已销户时,系统调用既有复机;复机失败不得回滚已成功的订单、套餐或钱包扣款,必须保存失败结果并通知客户和业务员。
#### Scenario: 手动续购并发成功
- **WHEN** 自动任务锁定后发现同一资产已由人工成功续购
- **THEN** 自动任务不创建第二笔订单、不扣款,并结束本次尝试

View File

@@ -0,0 +1,9 @@
## 1. 配置与执行
- [ ] 1.1 追踪套餐最终到期、续购价格、资产钱包、手动订单、停复机和通知链路。
- [ ] 1.2 新增配置、每日尝试/结果的成对迁移、模型、唯一约束和管理接口。
- [ ] 1.3 实现每日扫描、资格判断、资产锁、当前价格订单与同钱包扣款,保证手动优先。
## 2. 副作用与验证
- [ ] 2.1 实现余额/不可续费通知、成功后的条件复机、复机失败记录和通知;不得回滚续费。
- [ ] 2.2 更新路由/OpenAPI。
- [ ] 2.3 隔离库验证窗口、每日一次、并发、资金、通知、复机及 up/down/up;运行 `gofmt -w`、`go build ./cmd/api ./cmd/worker`、`go run cmd/gendocs/main.go`、`openspec validate add-asset-wallet-auto-renewal --strict` 和 `openspec doctor --json`;自动化测试按项目决策为 N/A。