SuperAPI AI 工具集

idempotent-financial-workflows

办公与效率

查看项目

更新于 10-16 08:02

技能介绍

用途:为涉及资金流动的工作流设计幂等方案,适用于支付、打款、转账、批量导入、webhook 与队列重投等场景,避免重复执行造成重复扣款或重复入账。

主要能力:先对场景分类,包括 API 命令(客户端重试)、webhook(重复或乱序)、worker 任务(队列重投)、批量导入(文件或行被重处理)、外部调用(服务商成功但本地超时)。随后定义幂等:确定幂等键来源(客户端键、事件 id、转账 id、行或业务键)、作用域(租户/账户/服务商/端点)、存储结果(pending/succeeded/failed/payload/ref),以及冲突处理——同键同载荷返回先前结果,同键不同载荷拒绝;优先使用持久化数据库约束而非内存去重。

副作用排序:先校验;在外部调用前持久化意图;将共同提交的状态放入事务;提交后副作用使用 outbox;保存服务商 id;仅在记录存在后暴露完成状态。

测试要点:同键同载荷重复、同键不同载荷重复、超时或异常后重试、webhook 重复投递、worker 部分写入后崩溃、事件乱序。

实现建议:复用已有事务辅助、仓储、任务框架与服务商适配器;保持处理器轻薄,幂等决策放在服务层。

限制与护栏:不要仅依赖前端禁用、内存或队列可见性超时;不要在记录本地意图前调用资金服务商;若副作用可能已成功,不要将操作永久标记为失败;不要隐藏重复或冲突行为,应记录到指标或存储状态中。具体安装与使用命令资料未提供。