SuperAPI AI 工具集

credit-metering

办公与效率

查看项目

更新于 10-16 05:53

技能介绍

用途:实现或审计用量积分系统,把积分当作财务状态机处理,并保留现有计价单位、计费语义与支付服务商集成。

工作流程:先检查后端/运行时、数据库/ORM、认证与租户键、现有余额/账本字段、支付服务商、用量路径、重试、队列和前端状态;从代码推断既有成本、发放与套餐,仅对未明确的商业政策提问(计价单位、按动作或按量计费、免费/周期发放、过期/结转、退款/追回、超支/欠费策略),已有支付服务商时绝不默认换新。

主要能力:读取数据库 schema 后只实现匹配的数据库变体,不把 PostgreSQL、MySQL/PlanetScale、Prisma 提供者和 MongoDB 视为可互换;使用带唯一幂等键/外部事件 ID 的追加式账本,在单个数据库事务内更新缓存余额与账本,或在规模允许时由账本推导余额;在数据库中强制正数入账和所选的非负/欠费规则。

显式操作:grant(注册、订阅、促销或管理员发放)、reserve(昂贵/并发工作前预留)、capture(按量成功后扣减)、release(取消/失败释放)、refund/reverse(关联原交易)、expire/rollover(积分有生命周期规则时)。

安全与一致:只从服务端上下文认证授权,绝不接受浏览器传入的余额、价格、套餐金额或用户身份;把服务端拥有的产品/价格 ID 映射到积分数;仅按检测到的服务商读取支付集成,校验原始 body 签名、持久去重事件、重试瞬时失败,且只在持久队列/收件箱写入后确认;促销原子化,按“每用户一次”意图使用带唯一 (promo_id, user_id) 约束的兑换表,并在同一事务内更新全局用量与发放积分。

UI 与验证:UI 余额仅作投影,需在响应后、账户切换、多标签更新、退款和 webhook 发放后对账,乐观显示不得用于授权;测试注册/周期发放、预留-捕获、预留-释放、余额不足、可变最终成本、重复请求、并发消费、支付重放、乱序事件、退款/追回、促销竞争、账户切换和网络失败后对账,断言账本/余额不变量并运行数据库并发测试及仓库 lint/type/test/build 命令。

输出:报告计价单位与政策、schema/迁移、账本操作与不变量、受保护的用量路径、服务商/产品映射、UI 对账、验证证据以及剩余仪表盘或生产配置。缺失事实:未提供具体命令、代码示例或官方文档。