feat(billing): 支付 P5.1 —— 订单骨架 + 兑换码渠道全闭环
按 PAYMENT_DESIGN.md 施工。零资质渠道先把「订单→入账→对账」的骨架跑真, 微信 Native(P5.2)进来只是多一个 adapter。 - store/payment.go:CreditPack(admin 可配包)/PaymentOrder(支付侧事实源,兑换 也写单,全部充值一个查法)/RedeemCode(SDX-XXXX-XXXX-XXXX,crypto/rand,剔除 易混字符)。三模型都不标 isTenantScoped——订单归计费租户,与活跃租户可能 分叉,插件自动注入会写错归属(RecentRuns 同款教训),显式赋值+显式过滤。 - Redeem 单事务:码 CAS 占用(unused→used 只成功一次,幂等主闸)→建已支付 订单→账本分录+物化余额。credit_ledger 加 (kind,ref) 部分唯一索引兜底 ——GrantCredits 此前对 ref 零约束,回调 at-least-once 就是重复入账事故。 - 路由:/billing/packs|orders(查,全员) + /billing/redeem(≥member+审计); admin /redeem-codes(生成/列表) + /packs(配包)。 - Web 面账单页:兑换码输入(viewer 不摆输入框,真闸在后端)+最近充值订单流。 - 测试:码形态/200 样本无撞码/参数边界;go+tsc+vitest 全绿。 live 13 项:生成→核销余额精确+100→重core 400(主闸)→DB 直插重复 ref 被唯一 索引打回(兜底闸实证)→viewer 403→balance==SUM(ledger) 不变量→审计留痕→ 浏览器 UI 兑换 100→200+订单流展示。 已知余项:admin 生成码暂只有 API(admin 页 UI 下一刀);微信 adapter=P5.2。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
@@ -246,6 +246,36 @@ export async function myUsage(days = 30): Promise<MyUsage> {
|
||||
};
|
||||
}
|
||||
|
||||
// ---- 充值(P5.1 兑换码;微信支付 P5.2 上线)----
|
||||
export interface TopupOrder {
|
||||
id: string;
|
||||
credits_micro: number;
|
||||
amount_fen: number;
|
||||
channel: string;
|
||||
status: string;
|
||||
created_at: string;
|
||||
}
|
||||
|
||||
// redeemCode 核销兑换码,返回入账后的余额。
|
||||
export async function redeemCode(code: string): Promise<{ balance_micro: number }> {
|
||||
const res = guard401(
|
||||
await fetch(`${GATEWAY}/api/v1/billing/redeem`, {
|
||||
method: "POST",
|
||||
headers: { "Content-Type": "application/json", ...bearer() },
|
||||
body: JSON.stringify({ code }),
|
||||
}),
|
||||
);
|
||||
return jsonOrThrow<{ balance_micro: number }>(res, "兑换失败");
|
||||
}
|
||||
|
||||
// billingOrders 计费租户最近充值记录。
|
||||
export async function billingOrders(): Promise<TopupOrder[]> {
|
||||
const res = guard401(await fetch(`${GATEWAY}/api/v1/billing/orders`, { headers: bearer() }));
|
||||
if (!res.ok) return [];
|
||||
const d = (await res.json()) as { orders?: TopupOrder[] };
|
||||
return d.orders ?? [];
|
||||
}
|
||||
|
||||
// 积分显示:micro(1e6) → 人类可读。与桌面端同一约定;小数去尾零(1.50 → 1.5)。
|
||||
export function fmtCredits(micro: number): string {
|
||||
const v = micro / 1e6;
|
||||
|
||||
Reference in New Issue
Block a user