SuperAPI AI 工具集

ledger-design

编程与开发

查看项目

更新于 10-25 06:58

技能介绍

用途

Ledger Design 用于勾画一个复式记账系统记录(system of record):科目表、分录规则、不可变性,以及余额如何派生。资料指出,账本能捕捉到支付服务商仪表盘漏掉的问题。它主要作为设计辅助和评审清单,在实现资金系统之前或同步于支付流程评审使用。

主要能力

  • 命名资金事件:授权、capture、手续费、打款、退款、外币兑换、更正等;无法分录的事件说明尚未纳入账本。
  • 勾画科目表:标注类型(资产/负债/收入/费用/权益)与币种,要求一个账户一种币种。
  • 写出借贷成对或多腿平衡的分录规则,以最小货币单位表示,要求每种币种内借方合计等于贷方合计。
  • 说明不可变性:事件与分录只追加,更正通过新的补偿事件指向原事件 id。
  • 命名对账钩子:把外部 id(服务商扣款、银行转账)挂在事件上,便于日后核对。
  • 给出玩具级(虚构金额)示例数据,用于验证平衡不变量,而非生产数据。
  • 提供可度量的检查项,覆盖复式不变量、科目表、不可变性与更正、金额与舍入、派生余额,以及严重度分级。

使用方式

按资料中的操作步骤执行:命名资金事件、勾画科目表、写借贷分录规则、声明不可变性、命名对账钩子、提出玩具示例;如果连一组平衡分录都写不出来,就停下来追问。输出采用固定结构:Job、Chart、Posting rules、Invariant、Immutability、Recon hooks、Toy fixtures、Findings、Leftovers。资料还给出一个玩具示例:处理器捕获 1000 美分、平台手续费 50、商户托管 950,借方资产 1000 等于贷方托管 950 加收入 50;后续打款和退款必须冲销原分录。

适用场景

设计新的资金流转系统;从“看服务商仪表盘”迁移到自有账本;把“余额对不上”当作设计问题排查(分录规则问题,而非实时对账);新增退款、打款、手续费或外币兑换分录路径。

限制

资料明确说明:该技能仅用于文档与设计评审,不构成法律或会计建议;不提供欺诈、逃税或漏洞利用指导。严禁嵌入真实卡号、密钥或客户个人信息,只允许玩具金额与虚构账户名。必须使用整数最小货币单位,禁止浮点数。它不能用作会计部门的总账、分析仓库或日志堆;每日的预期与实际核对属于对账(资料称仍为占位),审计追踪(资料称已缺失)也不在本技能范围内。未提及具体收费、平台或运行环境信息。