119 Commits

Author	SHA1	Message	Date
break	67893617fe	feat(退款): AUG26-006 补充当前退款套餐已用量与总量 ... 补齐 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
break	09abee9778	docs(归档): 归档退款方式与原路退款变更并同步主规格 ... - 将 add-refund-methods-and-original-route-refunds 归档为 2026-09-14-add-refund-methods-and-original-route-refunds。 - 合并两份 delta 到主规格： * order-refund-exchange：改写「订单、退款与换货状态门禁」，新增「退款实收金额与方式矩阵」 「企业微信唯一终审与审批尝试重提」「原路退款渠道能力与执行」「退款权益与订单状态时点」 「退款终态事实与失败分类」五项行为要求。 * merchant-payment-routing：改写「商户与微信授权配置管理」与「新支付商户快照与历史兼容」 （删除「不得新增渠道退款能力」与「不新增富友退款」，改由退款能力按商户凭证执行； 微信 v2 客户端证书改为可选凭证键）。 - 同步上下文健康检查证据链与入口矩阵：为新要求登记证据行，并把退款创建、重提、 企微审批回调、退款详情与 refund:channel:recovery 任务与对应要求双向关联。	2026-09-14 12:00:35 +08:00
break	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
break	48c85a4916	docs(归档): 归档已用完套餐展示与支付购包即时复机两个变更 ... - fix-depleted-package-display → archive/2026-09-14-fix-depleted-package-display； 补记验证：`GetCurrentMainPackage`（package_usage_store.go:63-66）按 status IN (1,2) 读取主套餐， 资产信息 `fillPackageInfo`（service/asset/service.go:348-349）复用该读取， 已用完主套餐返回名称、使用记录、时间与流量指标，待生效/已过期/已失效仍不作为当前套餐； 实现提交 ff25586，4 项任务全部完成。 - fix-immediate-package-payment-resume → archive/2026-09-14-fix-immediate-package-payment-resume； 补记八月迭代同步验证：定点同步提交 b38b2b3 已是 Iteration/8-11 的 HEAD 祖先， 在途支付商户装配保留（98c145f）；services.go:277 `orderService.SetResumeCallback(stopResumeService)` 在位，`go build ./cmd/api ./cmd/worker` 通过；2.1/2.2 据此勾选。 - 主 Spec 同步：personal-customer 新增「资产信息展示当前可用或已用完主套餐」； package-lifecycle 修改为支付成功后已生效主套餐触发一次即时自动复机检查。 openspec validate --all 为 38 passed / 0 failed；doctor healthy。	2026-09-14 09:49:03 +08:00
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	315a7de3e4	docs(归档): 归档代理自充支付方式与员工代收款路由前缀两个变更 ... - add-agent-self-recharge-payment-methods 归档为 2026-09-11-add-agent-self-recharge-payment-methods，delta 应用后主规格 agent-funds-commission 完成 1 条 Requirement 改名并新增 4 条 Requirement - 在可达操作索引补充代理自充支付方式配置与付款凭证识别共 3 个端点 - 同步 requirement-evidence.json 与 entry-capability-requirement-matrix.json 证据链 - fix-employee-collection-route-prefix 归档为 2026-09-11-fix-employee-collection-route-prefix 并勾选任务 2.5 门禁：context-health 通过、openspec validate --all 40 passed / 0 failed、doctor healthy	2026-09-11 15:50:15 +08:00
break	e687a266e6	补齐员工代收款账单能力证据链与可达操作索引	2026-09-11 15:20:21 +08:00
break	9c3e3fe32b	归档员工代收款账单闭环变更并同步主规格 ... - 新增主规格 openspec/specs/employee-collection-bill/spec.md（5 条 Requirement、22 个 Scenario） - 变更目录归档至 openspec/changes/archive/2026-09-11-add-employee-collection-bills	2026-09-11 09:45:12 +08:00
break	dc4e0d4103	归档支付商户池变更并同步主规格	2026-09-10 12:03:28 +08:00
break	a9e2302f7c	1	2026-09-10 10:53:07 +08:00
break	696120ab38	feat: 资产套餐历史增加主子层级查询	2026-09-07 17:17:15 +08:00
break	c7c2b17d78	归档	2026-09-07 11:34:23 +08:00
break	5424751993	修复停复机忽略免实名策略并归档变更	2026-09-07 10:06:17 +08:00
break	370fd3e67f	update	2026-09-03 09:28:28 +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	c8052df8eb	补充退款列表应当让本店铺的人看见	2026-08-18 11:44:30 +08:00
break	b5285877bf	归档	2026-08-13 17:45:49 +08:00
break	6883b5b42b	归档	2026-08-13 17:26:36 +08:00
break	7e7f1cbb67	更新	2026-08-13 16:09:38 +08:00
break	fcfa347005	修复	2026-08-12 10:42:35 +08:00
break	619d0c5efe	提案	2026-08-11 15:39:51 +08:00
break	a795ca3650	修复通知	2026-08-11 11:18:11 +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	79e2d9ff92	重置项目上下文与规范文档	2026-08-07 16:18:07 +08:00
break	8fc667daee	让代理充值复用现有网页支付能力 ... 微信按当前 v2/v3 配置分别生成 MWEB/H5 链接，支付宝复用 C 端 WAP 链接，并让可用支付方式基于生效配置判断。 Constraint: 支付链接统一通过 qr_content 返回，由前端渲染二维码；按要求不运行测试 Rejected: 微信 Native 与支付宝当面付 | 会引入非当前商户配置所需的额外产品开通 Confidence: high Scope-risk: moderate Directive: 微信 H5/MWEB 二维码仅承诺系统相机或外部浏览器扫码链路 Tested: 相关 Go 包编译通过；gofmt 与 git diff --check 通过 Not-tested: 按用户要求未运行自动化测试及真实支付联调	2026-07-30 11:41:50 +08:00
break	072ec1db7e	修复企微的问题	2026-07-27 17:04:32 +08:00
Break	c437593a8c	修复错误购买报错的问题,修复接口返回虚流量启动错误的问题	2026-06-11 14:51:26 +08:00
huang	480d4c4583	1	2026-05-18 10:34:04 +08:00
huang	95fc0b0a1b	修复一些问题,主要是生效套餐	2026-05-12 10:32:38 +08:00
huang	3a2e3f2571	浅浅升级一下	2026-05-06 14:41:14 +08:00
huang	21b73a750d	c端当前套餐开始时间过期时间,以及excel导入字段	2026-05-06 09:57:58 +08:00
huang	b4a9e0c1c9	归档	2026-04-30 15:59:40 +08:00
huang	70fb7dadef	归档	2026-04-30 11:58:33 +08:00
huang	c3ae7fcfbc	修复设备WiFi上游请求参数	2026-04-27 15:19:23 +08:00
huang	2b3a9cb33f	feat: 新增套餐使用记录实付金额快照字段 paid_amount ... - 新增迁移 000129：tb_package_usage 添加 paid_amount BIGINT 字段，存量数据通过 JOIN tb_order 回填 - PackageUsage Model 新增 PaidAmount *int64 字段 - 4 个写入点（order service 主套餐/加油包、auto_purchase 主套餐/加油包）赋值 order.ActualPaidAmount - AssetPackageResponse DTO 新增 paid_amount 字段 - GetCurrentPackage / GetPackages 填充 paid_amount，接口直接返回购买价格无需 JOIN 订单表	2026-04-18 10:19:21 +08:00
huang	e52671eaed	归档提案	2026-04-18 09:35:27 +08:00
huang	4aab0bcbf2	提案以及归档	2026-04-18 09:10:29 +08:00
huang	5d9be1d7e4	fix: 修正轮询配置多匹配逻辑，支持同卡匹配多个配置并按 priority 合并 interval ... 核心变更： - MatchConfig 改为 MatchConfigs，返回所有匹配配置 - MergedTaskIntervals 按 task type 合并各配置，选取最高优先级（非 nil 且最小 priority 值） - hasAnyEnabledInterval 过滤所有 interval 均为 NULL 的配置 - calcInitialDelay 重构为纯函数，接收 interval 参数 - 移除 getEnabledTaskTypes 和 getIntervalByTaskType（被 MergedTaskIntervals 替代） - scheduler.go 新增心跳 key + 顶层 panic recovery + Init 完成守卫 - initializer.go 批量失败日志升级为 Error，逐条检查 Pipeline 命令错误 - 数据迁移：禁用 id=29 的轮询配置（所有 interval 均为 NULL） Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-04-16 14:27:47 +08:00
huang	8bf1282378	归档: add-polling-card-status-with-verbose-log，同步主规范 ... change 目录归档至 openspec/changes/archive/2026-04-15-add-polling-card-status-with-verbose-log/ 新建主规范 openspec/specs/polling-card-status-task/spec.md（6个需求） 追加 verbose log 需求至 openspec/specs/polling-task-handlers/spec.md（4个新需求） protect handler 规范更新字段名：network_status → network_status_at_check + action_taken Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>	2026-04-15 12:23:05 +08:00
huang	d9de704d73	归档	2026-04-14 12:14:29 +08:00
huang	7308afe801	归档	2026-04-13 15:03:02 +08:00
huang	246ae5e123	docs: 新增 status-convention 主规范 ... Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>	2026-04-11 12:21:07 +08:00