574 Commits

Author	SHA1	Message	Date
break	bb06cc89c5	修复	2026-09-14 09:45:47 +08:00
break	575d056f54	feat(代理分销提现): 落地扫码注册、提现资料资格与企微终审提现 ... 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
break	7891189712	feat(代理自充): AUG26-017 代理自充收款方式与线下预存款审批字段 ... - 受控配置新增代理在线自充允许范围（仅微信/仅支付宝/同时支持），读侧与创建侧取允许范围与可用商户池交集，两侧失败关闭 - 新增允许范围查询与修改端点，读限代理与平台账号、写限超级管理员，复用受控配置写服务留痕 - tb_agent_recharge_record 新增交易流水号、线下收款方式三列快照与其他凭证列（成对迁移 000213） - 线下申请校验启用的收款方式字典项与必填交易流水号，交易流水号独立于在线渠道交易号、不参与去重 - 扩展 offline_recharge_approval 场景可映射字段白名单与字典引用保护 - 新增付款凭证识别能力与交易流水号预填接口，识别不落库、日志不记录载荷	2026-09-11 15:21:23 +08:00
break	ff1362df3f	fix(员工代收款): 修正路由前缀注册方式，消除 /api/admin 根级 /:id 抢占 ... Register 的 basePath 仅用于生成 OpenAPI 文档，不参与路由注册；员工代收款 三个注册函数把资源前缀传给了 basePath、path 只写相对段，导致 GET /api/admin/:id 与 POST /api/admin/:id/close 落在 /api/admin 根上。 账单单段路径被当作路径 ID 解析返回“无效的路径ID”，并抢占其后注册的 同层单段 GET（/api/admin/refunds、/system-configs 等）。 改为 router.Group(前缀) 注册，与仓库既有写法一致；路由布局与文档路径不变。	2026-09-11 14:40:23 +08:00
break	fe07df0b3e	docs(企业微信审批): 场景业务类型枚举补充员工代收款核销审批 ... - wecom/scenes/{business_type} 与 scenes/{business_type}/fields 的 business_type 路径参数描述补齐第三个业务类型，避免管理员按文档无法配置核销审批场景 - 同步补机读 enum 标签，与既有可枚举参数约定一致 OpenSpec Change: add-employee-collection-bills	2026-09-11 09:24:29 +08:00
break	69b37eb89b	docs(员工代收款): 补充审批中通过后撤销兜底语义并清理死参数 ... - spec.md 增补「审批中收到通过后撤销」场景与规范条文：释放该次尝试全部审批中预占、转异常终态并记录原因、保留审计、禁止自动重提 - design.md「企业微信审批结果消费」补充审批中命中该决策的兜底处理与理由（避免申请永久停在审批中且预占永久占用账单） - query/employeecollection 删除 approvalStatusOfAttempts 恒为 true 的 withOpinion 形参、修正失真注释，行为不变 OpenSpec Change: add-employee-collection-bills	2026-09-10 18:45:43 +08:00
break	ce24d5612e	feat(员工代收款): 新增员工代收款账单闭环 ... - 新增 6 张表与成对迁移 000212，扩展企业微信审批场景业务类型白名单 - 后台线下套餐订单与两条代理线下充值入账路径在来源成功事务内建账，来源唯一键幂等 - 核销申请、审批尝试记录、账单分摊预占与驳回重提，审批业务类型 employee_collection_approval - 企业微信终态消费幂等：通过转已核销、驳回释放预占、通过后撤销不回滚并转异常终态 - 退款成功事务内按 bill_id+refund_id 幂等冲销账单或仅写退款关联提示 - 线下收款方式字典、账单查询/统计/关闭、申请查询与代办权限，均写入事务内审计 OpenSpec Change: add-employee-collection-bills	2026-09-10 18:24:05 +08:00
break	b9e8592cc4	修复换货迁移后 after_order 实名门槛误判 ... 换货迁移只迁移套餐权益不迁移订单，已支付订单仍挂在旧资产上， 导致新资产 HasValidRechargeOrPaidOrder 查不到支付事实，返回 1189。 现增加套餐权益兜底：当前世代存在未退款套餐权益且其关联订单已支付， 即视为满足充值/购买条件。	2026-09-10 11:26:07 +08:00
break	b38b2b39c9	修复支付购包后自动复机	2026-09-10 11:26:07 +08:00
break	bcb1304937	修复支付商户路由权限泄漏 ... registerPaymentMerchantRoutes 使用空前缀 Group 承载权限中间件， Fiber 将其等价于在整个 /api/admin 上 Use，导致代理账号访问 /api/admin/agent-recharges 等无关路由被误拦。 改为 requirePaymentMerchantAccess 包装函数，仅包装 payment-merchants、 payment-merchant-pools、wechat-authorizations 共 13 个管理路由， 路径、方法与权限语义不变。	2026-09-10 10:00:53 +08:00
break	98c145fe70	实现支付商户池与微信授权配置 ... 新增收款商户、商户池轮询、微信授权配置独立管理；三类新支付 （C端套餐购买、C端资产钱包充值、代理在线预存款充值）无条件 经商户池选择并冻结路由，无旧综合配置回退。merchant_id 为空 历史支付继续按 payment_config_id 双读。凭证版本化加载与 ID+版本缓存保证轮换一致性。删除商户池新支付创建开关及全部 引用。	2026-09-09 18:13:04 +08:00
break	ff25586dc9	修复已用完套餐展示	2026-09-08 17:25:34 +08:00
break	696120ab38	feat: 资产套餐历史增加主子层级查询	2026-09-07 17:17:15 +08:00
break	5424751993	修复停复机忽略免实名策略并归档变更	2026-09-07 10:06:17 +08:00
break	370fd3e67f	update	2026-09-03 09:28:28 +08:00
break	dbfeeee253	缓解io压力	2026-09-02 16:14:27 +08:00
break	395e5fb47c	修复套餐接续停机竞态与轮询兜底	2026-08-29 16:27:48 +08:00
break	62f3d25e81	修复批量订购	2026-08-26 14:54:26 +08:00
break	5797fd0e94	修复企微兜底机制	2026-08-20 18:06:45 +08:00
break	22b95db2f9	每日清理	2026-08-20 12:03:17 +08:00
break	656a921ff0	富友支付支持	2026-08-18 17:13:20 +08:00
break	247d7d9f6e	新增接口	2026-08-18 16:15:46 +08:00
break	d256f6d176	合并七月迭代分支	2026-08-18 14:53:29 +08:00
break	c8052df8eb	补充退款列表应当让本店铺的人看见	2026-08-18 11:44:30 +08:00
break	586a1cccd5	修复佣金回扣问题	2026-08-14 09:08:43 +08:00
break	cbadf77517	修复价格不一致的问题	2026-08-13 17:43:14 +08:00
break	4c393bb427	回溯佣金	2026-08-13 17:00:06 +08:00
break	d42c92a2e1	字段	2026-08-13 16:33:55 +08:00
break	e134552ec5	更新	2026-08-13 12:31:47 +08:00
break	fcfa347005	修复	2026-08-12 10:42:35 +08:00
break	2a7a8fb49d	修复	2026-08-11 15:27:18 +08:00
break	629609a556	修复	2026-08-11 14:41:33 +08:00
break	a795ca3650	修复通知	2026-08-11 11:18:11 +08:00
break	5c01008d8a	百分比问题	2026-08-11 09:54:21 +08:00
break	f6b11eb9ac	修复	2026-08-10 17:37:55 +08:00
break	77ce9db722	并发监控修复	2026-08-10 16:58:33 +08:00
break	f15a64395f	修复反馈	2026-08-10 16:30:38 +08:00
break	7aa03e91fb	修复	2026-08-07 18:00:15 +08:00
break	79e2d9ff92	重置项目上下文与规范文档	2026-08-07 16:18:07 +08:00
break	6611ca5226	修复行业卡手动停复机实名校验	2026-08-07 16:17:29 +08:00
break	f45b296b70	修复卡套餐调整审计资产类型错误	2026-08-07 16:17:29 +08:00
break	65e2838aa9	修复审计关联资源主体投影	2026-08-07 12:02:55 +08:00
break	c64f3d8b80	全局审计完成	2026-08-07 11:02:52 +08:00
break	88cc5e96ec	暂存	2026-08-06 09:35:00 +08:00
break	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
break	7029104e5c	让迁移套餐恢复月流量重置调度 ... 缺少 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:33:16 +08:00
break	5e552d99bc	收口审计治理与套餐任务进展 ... Constraint: 在线热修前必须保存当前迭代分支全部有效代码进展 Confidence: medium Scope-risk: broad Directive: 后续修改需保持审计事件与业务事务边界一致 Tested: git diff --cached --check Not-tested: 未运行全量测试，提交用于切换分支前保存既有工作	2026-08-05 14:30:54 +08:00
break	a0de08d789	避免套餐过期后排队权益永久失联 ... 线上保持现有纯 Asynq 架构，以公平孤儿扫描和提交后投递消除永久饥饿及事务可见性竞态。 Constraint: 线上保持现有纯 Asynq 架构，不引入 Outbox、迁移或新任务基础设施。 Rejected: 事务内投递或扩大扫描 LIMIT | 无法消除竞态和永久饥饿。 Confidence: high Scope-risk: narrow Directive: 后续分支整合时按目标分支的套餐接续架构独立处理，不混用本热修实现。 Tested: go build ./...（退出码 0）；git diff --check；openspec validate fix-main-package-activation-starvation --strict。 Not-tested: 按用户要求未新增、修改或运行自动化测试；线上 SQL、查询计划和日志待部署后核验。	2026-08-03 09:58:05 +08:00
break	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
break	cf2ff0ac1c	避免续费报价缺失阻断资产详情 ... Constraint: 代理渠道缺少套餐分配记录时不存在可信的当前续费价 Rejected: 回退平台价或历史成交价 | 会与实际下单校验和当前价格口径不一致 Confidence: high Scope-risk: narrow Directive: renewal_price 为 null 时前端不得展示价格或发起续费 Tested: go build ./internal/handler/app Not-tested: 按用户要求未添加或运行测试	2026-07-30 17:14:28 +08:00