|
|
1aa4eacee2
|
feat(退款分佣): 佣金回溯明细替换全额失效并补齐读侧与导出
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 9m26s
用 PRD 2.14 语义整体替换退款佣金「整单全额失效」实现：原佣金保持已发放不变，
回溯事实落在新表 tb_commission_clawback_record 的负数、不可提现明细上。
- 新增成对迁移 000220 建 tb_commission_clawback_record，唯一约束
(refund_id, original_commission_id) 为权威幂等键，附店铺+时间/原佣金/订单索引。
- 回溯用例（internal/service/refund/clawback.go）：准入仅由退款申请状态、审批异常
标记与退款方式决定；金额按分整数计算，分母取冻结实收（缺失回落审批尝试）、
分子原路取渠道成功金额，乘法用 math/big 中间量，舍入差自末条起向前补差；
终态判据要求订单佣金已离开待计算且不存在 status IN (1,2,99) 的记录。
- 三层幂等：唯一约束兜底、佣金行行锁 + 钱包乐观锁、commission_deducted 仅作投影
并带 WHERE commission_deducted = false 条件置位；闭合三结果为已回溯、无需回溯、
审批异常转人工。
- 事务内顺序固定：锁提现申请行 → 锁尝试行 → 解冻冻结 → 置驳回 → 插回溯明细 →
扣 balance（允许为负）→ 写负数流水 → 审计；删除旧全额失效写入与其两个审计调用点，
refund.invalidate_commission 仅保留常量与注册供历史审计读取。
- 读侧：佣金明细列表 status 筛选透传，两表 UNION ALL 合并分页并以 source ASC 作
末位次序键；新增佣金明细详情接口并同步路由与 OpenAPI 装配。
- 导出：新增 commission_record 场景（白名单、exporter 注册、DTO oneof、DataSource
与列定义），粒度为佣金记录，原佣金与回溯各一行，金额保持分且可为负。
- 新增退款佣金回溯周期补偿任务（@every 1m / MaxRetry(3) / Timeout(10m) /
Unique(10m)，独立队列），保留启动时补偿扫描，判据与既有实现一致。
Refs: AUG26-012
|
2026-09-14 13:40:34 +08:00 |
|
|
|
67893617fe
|
feat(退款): AUG26-006 补充当前退款套餐已用量与总量
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m33s
补齐 PRD §2.3.1「退款管理补充字段」：退款列表、详情与导出新增
「当前退款套餐已用量」与「当前退款套餐总量」两个纯展示字段。
- 套餐定位口径与退款套餐失效保持一致，按优先级取唯一一条：
冻结的 package_usage_id（且属于该订单）→ 订单主套餐 → 订单任一套餐，
同级按标识升序。不按当前世代或当前生效套餐推断；不按套餐状态过滤，
使退款后套餐转已失效时仍能回看用量。
- 列表与详情用固定两次查询批量解析（按标识、按订单），查询次数不随条数增长；
详情复用同一函数。解析不到套餐或记录已物理删除时返回 0，不阻断读取。
- 导出新增两列并改用同一优先级的 LATERAL 取法，不再依赖只按 r.package_usage_id
的 join——生产库 1296 条退款仅 157 条带该字段，旧取法会让多数行显示零值。
- 不改变退款金额校验、冻结实收、套餐失效、接续、停机与佣金回溯任何规则。
验证：测试库 junhong_cmp_test 实测冻结记录、订单主套餐回退、记录缺失返回 0 三项
解析场景与「4 条退款固定 2 次查询」；并以同批 43 条退款对拍 Go 解析器与导出 SQL，
口径不一致 0 条；导出 43 行列数与表头一致。无迁移、无接口路径变化。
|
2026-09-14 12:11:55 +08:00 |
|
|
|
ba0855d9eb
|
feat(退款): AUG26-006 退款方式选择与原路退款
按 PRD 2.3/2.4/2.5 落地套餐退款的方式矩阵与原路渠道退款：
- 退款申请派生并冻结权威实收金额（线上取原成功支付记录，钱包/线下取订单实际收款），
提交人不可填写或修改；按来源支付方式生成可选方式矩阵并在创建、提交、执行前重复校验。
- 审批切换为「每次提交一条不可变审批尝试记录 + 独立企业微信审批实例」，业务标识取尝试
记录主键；终态消费按尝试记录优先、退款申请兜底双读，兼容存量无实例与已关联实例申请。
新增活动退款部分唯一索引 (order_id) WHERE status IN (1,5,6)。
- 本地人工终审保持既有开关，补齐通过入口的 approval_instance_id IS NULL 守卫，使三个
入口一致拒绝已关联审批实例的申请；重提按尝试模式重写（仅已拒绝/已退回/原路失败且无异常）。
- 权益时点：企微通过事务写退款终态、按方式确定的订单态、钱包回款、员工账单冲销与可靠
失效事实；套餐失效/接续/停机仍由既有可靠机制最终一致执行，不把外部调用放入资金事务。
订单支付状态按方式置位：凭证退款与退回原钱包在企微通过时置已退款，原路须渠道明确成功。
- 按官方契约实现微信直连 v3、微信 v2（双向证书）、富友（/commonRefund 与 /refundQuery）、
支付宝四类原路退款；能力只由服务商类型与退款必需凭证完整性决定，无人工开关。
渠道请求号在提交时冻结到尝试记录，并以 channel_submitted_at 条件认领保证资金动作至多
提交一次（重复投递只查询不二次提交）；不向任何渠道传递退款结果通知地址。
- 新增 refund:channel:recovery 恢复任务只查询回填；本地查询窗口超期（富友 72 小时、
微信 v2 7 天）转原路退款失败、渠道状态已失败、分类超时未知并置异常转人工，不放行自动
重提以避免重复退款。
- 同步退款 DTO/导出/审计资源与审计查询关联、商户凭证文档，并修正 fuiou 集成契约文档。
迁移 000218（退款尝试与渠道退款事实）、000219（微信 v2 客户端证书凭证）成对提供，
未修改既有迁移；测试库 junhong_cmp_test 完成 up/down/up 与行为核对，未调用真实渠道。
|
2026-09-14 11:55:16 +08:00 |
|
|
|
575d056f54
|
feat(代理分销提现): 落地扫码注册、提现资料资格与企微终审提现
构建并部署到测试环境（无 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
配置启用场景与模板控件映射；未配置时相应提交失败关闭。
|
2026-09-14 09:45:13 +08:00 |
|
|
|
7891189712
|
feat(代理自充): AUG26-017 代理自充收款方式与线下预存款审批字段
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m52s
- 受控配置新增代理在线自充允许范围（仅微信/仅支付宝/同时支持），读侧与创建侧取允许范围与可用商户池交集，两侧失败关闭
- 新增允许范围查询与修改端点，读限代理与平台账号、写限超级管理员，复用受控配置写服务留痕
- tb_agent_recharge_record 新增交易流水号、线下收款方式三列快照与其他凭证列（成对迁移 000213）
- 线下申请校验启用的收款方式字典项与必填交易流水号，交易流水号独立于在线渠道交易号、不参与去重
- 扩展 offline_recharge_approval 场景可映射字段白名单与字典引用保护
- 新增付款凭证识别能力与交易流水号预填接口，识别不落库、日志不记录载荷
|
2026-09-11 15:21:23 +08:00 |
|
|
|
ce24d5612e
|
feat(员工代收款): 新增员工代收款账单闭环
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 9m20s
- 新增 6 张表与成对迁移 000212，扩展企业微信审批场景业务类型白名单
- 后台线下套餐订单与两条代理线下充值入账路径在来源成功事务内建账，来源唯一键幂等
- 核销申请、审批尝试记录、账单分摊预占与驳回重提，审批业务类型 employee_collection_approval
- 企业微信终态消费幂等：通过转已核销、驳回释放预占、通过后撤销不回滚并转异常终态
- 退款成功事务内按 bill_id+refund_id 幂等冲销账单或仅写退款关联提示
- 线下收款方式字典、账单查询/统计/关闭、申请查询与代办权限，均写入事务内审计
OpenSpec Change: add-employee-collection-bills
|
2026-09-10 18:24:05 +08:00 |
|
|
|
b9e8592cc4
|
修复换货迁移后 after_order 实名门槛误判
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m33s
换货迁移只迁移套餐权益不迁移订单，已支付订单仍挂在旧资产上，
导致新资产 HasValidRechargeOrPaidOrder 查不到支付事实，返回 1189。
现增加套餐权益兜底：当前世代存在未退款套餐权益且其关联订单已支付，
即视为满足充值/购买条件。
|
2026-09-10 11:26:07 +08:00 |
|
|
|
98c145fe70
|
实现支付商户池与微信授权配置
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Failing after 3m55s
新增收款商户、商户池轮询、微信授权配置独立管理；三类新支付
（C端套餐购买、C端资产钱包充值、代理在线预存款充值）无条件
经商户池选择并冻结路由，无旧综合配置回退。merchant_id 为空
历史支付继续按 payment_config_id 双读。凭证版本化加载与
ID+版本缓存保证轮换一致性。删除商户池新支付创建开关及全部
引用。
|
2026-09-09 18:13:04 +08:00 |
|
|
|
ff25586dc9
|
修复已用完套餐展示
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m43s
|
2026-09-08 17:25:34 +08:00 |
|
|
|
696120ab38
|
feat: 资产套餐历史增加主子层级查询
|
2026-09-07 17:17:15 +08:00 |
|
|
|
5424751993
|
修复停复机忽略免实名策略并归档变更
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Has been cancelled
|
2026-09-07 10:06:17 +08:00 |
|
|
|
370fd3e67f
|
update
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 10m49s
|
2026-09-03 09:28:28 +08:00 |
|
|
|
dbfeeee253
|
缓解io压力
|
2026-09-02 16:14:27 +08:00 |
|
|
|
395e5fb47c
|
修复套餐接续停机竞态与轮询兜底
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 11m13s
|
2026-08-29 16:27:48 +08:00 |
|
|
|
5797fd0e94
|
修复企微兜底机制
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 10m40s
|
2026-08-20 18:06:45 +08:00 |
|
|
|
247d7d9f6e
|
新增接口
|
2026-08-18 16:15:46 +08:00 |
|
|
|
c8052df8eb
|
补充退款列表应当让本店铺的人看见
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m30s
|
2026-08-18 11:44:30 +08:00 |
|
|
|
586a1cccd5
|
修复佣金回扣问题
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m25s
|
2026-08-14 09:08:43 +08:00 |
|
|
|
cbadf77517
|
修复价格不一致的问题
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m28s
|
2026-08-13 17:43:14 +08:00 |
|
|
|
4c393bb427
|
回溯佣金
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m34s
|
2026-08-13 17:00:06 +08:00 |
|
|
|
e134552ec5
|
更新
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m35s
|
2026-08-13 12:31:47 +08:00 |
|
|
|
fcfa347005
|
修复
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m38s
|
2026-08-12 10:42:35 +08:00 |
|
|
|
5c01008d8a
|
百分比问题
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m24s
|
2026-08-11 09:54:21 +08:00 |
|
|
|
f6b11eb9ac
|
修复
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m23s
|
2026-08-10 17:37:55 +08:00 |
|
|
|
77ce9db722
|
并发监控修复
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m20s
|
2026-08-10 16:58:33 +08:00 |
|
|
|
f15a64395f
|
修复反馈
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m30s
|
2026-08-10 16:30:38 +08:00 |
|
|
|
7aa03e91fb
|
修复
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m25s
|
2026-08-07 18:00:15 +08:00 |
|
|
|
79e2d9ff92
|
重置项目上下文与规范文档
|
2026-08-07 16:18:07 +08:00 |
|
|
|
6611ca5226
|
修复行业卡手动停复机实名校验
|
2026-08-07 16:17:29 +08:00 |
|
|
|
f45b296b70
|
修复卡套餐调整审计资产类型错误
|
2026-08-07 16:17:29 +08:00 |
|
|
|
c64f3d8b80
|
全局审计完成
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m31s
|
2026-08-07 11:02:52 +08:00 |
|
|
|
88cc5e96ec
|
暂存
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m32s
|
2026-08-06 09:35:00 +08:00 |
|
|
|
8659dfc658
|
让迁移套餐恢复月流量重置调度
缺少 next_reset_at 时，轮询根据已有激活时间或到期时间与套餐天数推算下一重置点；已有值通过查询条件和条件更新双重保护，不会被覆盖。
Constraint: 兼容迁移套餐缺少 activated_at 与 next_reset_at 的历史数据
Rejected: 单次 SQL 人工回填 | 后续迁移数据仍可能再次遗漏
Confidence: high
Scope-risk: narrow
Directive: 保持 next_reset_at 非空记录不可覆盖
Not-tested: 按用户要求未运行测试
|
2026-08-05 14:36:06 +08:00 |
|
|
|
5e552d99bc
|
收口审计治理与套餐任务进展
Constraint: 在线热修前必须保存当前迭代分支全部有效代码进展
Confidence: medium
Scope-risk: broad
Directive: 后续修改需保持审计事件与业务事务边界一致
Tested: git diff --cached --check
Not-tested: 未运行全量测试，提交用于切换分支前保存既有工作
|
2026-08-05 14:30:54 +08:00 |
|
|
|
b3499adfca
|
固化七月迭代审计治理进展以隔离线上热修
Constraint: 切换 main 前必须保存当前七月分支全部项目进展，套餐生效提案仅属于 Iteration/7-11。
Rejected: 将七月套餐修复直接移植到 main | 两个分支的可靠投递架构不同。
Confidence: medium
Scope-risk: broad
Directive: 不得将本提交整体 cherry-pick 到 main；main 套餐热修必须基于其纯 Asynq 代码独立实施。
Tested: git diff --check；openspec validate fix-package-activation-starvation --strict。
Not-tested: 按用户要求未运行自动化测试；go build ./... 因当前审计改造中的 Enterprise 模型字面量和 role.recordFailure 参数类型错误未通过。
|
2026-08-03 09:47:22 +08:00 |
|
|
|
faf973accb
|
确保资产列表返回实名策略
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m19s
Constraint: 设备列表与独立卡列表必须和详情接口返回一致的实名策略\nRejected: 在查询层补默认值 | 数据库字段已正确读取，问题仅在响应映射遗漏\nConfidence: high\nScope-risk: narrow\nDirective: DTO 新增字段时同步检查列表与详情的全部映射路径\nTested: 未运行测试，按用户要求仅检查暂存差异\nNot-tested: 未执行自动化测试
|
2026-07-30 15:40:53 +08:00 |
|
|
|
b3a215b19e
|
越权问题
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m14s
|
2026-07-28 18:44:39 +08:00 |
|
|
|
dc080436bf
|
越权
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m6s
|
2026-07-28 16:57:27 +08:00 |
|
|
|
4b98612816
|
任务列表返回目标名称
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m1s
|
2026-07-28 16:03:42 +08:00 |
|
|
|
1fee19feeb
|
补充一些通知
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m7s
|
2026-07-28 15:50:12 +08:00 |
|
|
|
178cc45bc2
|
批量收回功能
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m1s
|
2026-07-28 10:53:15 +08:00 |
|
|
|
a8ca00e5f2
|
让换货选择不受新资产状态与原归属阻碍
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m13s
新资产仍需通过有效客户绑定和进行中换货占用校验，并返回明确的绑定冲突提示。
Constraint: 运营明确要求移除新资产在库和店铺一致限制
Rejected: 保留在库条件仅放宽店铺归属 | 无法支持已销售资产参与换货
Confidence: high
Scope-risk: moderate
Directive: 不得移除客户绑定和换货占用校验
Tested: git diff --check
Not-tested: 按用户要求未运行自动化测试
|
2026-07-27 18:43:16 +08:00 |
|
|
|
2f0ecffdf2
|
补全返回参数
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m9s
|
2026-07-27 17:44:49 +08:00 |
|
|
|
cbf909b878
|
代理在线充值
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m6s
|
2026-07-27 16:02:55 +08:00 |
|
|
|
73f5125d3d
|
七月迭代短暂完结,还有很多后端的关键东西没有弄,这是一版赶时间做的东西
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m26s
|
2026-07-25 17:06:58 +08:00 |
|
|
|
5c4d17e9fc
|
收口七月卡状态回调与系列授权兼容契约
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Has been cancelled
完成运营商实名回调、业务事件观测序列与受控配置装配，同时恢复 UR43 已交付的 packages[].remove 字段及旧响应兼容，统一更新 OpenSpec、OpenAPI 和交付文档。
Constraint: 七月测试环境里程碑不新增或运行自动化测试
Rejected: 以必填 operation_type 替换 packages[].remove | 会破坏已交付前端契约
Confidence: high
Scope-risk: broad
Directive: 后续修改系列套餐管理接口必须保持 packages[].remove 和 ShopSeriesGrantResponse 兼容
Tested: go run ./cmd/gendocs；go build -buildvcs=false ./...；openspec validate complete-july-iteration-test-release --strict；git diff --check
Not-tested: 按本 Change 约定未运行 go test，真实运营商与 Gateway 联调延期
|
2026-07-24 19:59:24 +08:00 |
|
|
|
a18ed8bc8d
|
暂存一下,防止丢失
|
2026-07-24 16:07:18 +08:00 |
|
|
|
5d6e23f1a5
|
允许平台库存资产直接完成换货归属继承
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 11m27s
换货完成事务允许平台库存新资产换入，并同步店铺归属、分销状态及钱包租户标签；其他店铺资产继续拒绝。
Constraint: 七月迭代要求归属继承不受 migrate_data 控制
Rejected: 先将新资产人工分配到旧资产店铺 | 会保留冲突校验并增加多余操作
Confidence: high
Scope-risk: narrow
Directive: 后续换货资料迁移不得覆盖归属继承规则
Tested: gofmt；git diff --check
Not-tested: 按用户要求未运行自动化测试
|
2026-07-24 11:31:45 +08:00 |
|
|
|
17782d5f8e
|
实现七月迭代公共技术基础
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 9m20s
|
2026-07-23 17:52:48 +09:00 |
|
|
|
8d65b26e96
|
实现资产预计最终到期时间
|
2026-07-23 13:14:43 +09:00 |
|
