收款原型 pay-proto:渠道抽象层 + 爱发电主通道 + 当面付辅助通道(占位符配置,内置模拟网关)

Browse Source
- core:支付单 / 流水 / 待办三张表,统一到账入口 settle_payment()(幂等、金额闸门、迟到恢复、重复付款进待办),
  定时任务:爱发电对账、当面付补查、支付单过期关单、订单超时关闭、迟到付款扫描;演示时钟可快进。
- channels:爱发电(专链 custom_order_id/custom_price、Webhook RSA 验签、query-order 按订单号精确反查);
  当面付(precreate/query/close/refund,请求应用私钥 RSA2 签名、响应与异步通知用支付宝公钥验签;熔断、限额、节奏控制)。
- mockgw:占位符时的模拟爱发电收银台 / 查单接口与模拟支付宝网关 / 扫码页。
- 付款页 + 后台页;场景测试 24 条(本机与甲骨文 ARM 均全过)。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
yws
2026-10-07 05:53:12 +00:00
co-authored by Claude Opus 5.5
parent 8fbffd8408
commit 56c1fa648a
11 changed files with 2175 additions and 0 deletions
+36
View File
@@ -0,0 +1,36 @@
# 收款原型(pay-proto)
设计文档里「渠道抽象层 + 爱发电主通道 + 当面付辅助通道」的可运行原型。
标准库 + SQLite + `cryptography`,只绑 127.0.0.1,由 nginx 反代。
## 占位符
`config.py` 里所有账号 / 密钥都是 `<占位符>`。值还是占位符的渠道,自动接到内置的**模拟网关**(`mockgw.py`):
签名、验签、HTTP 调用都是真实代码,只是对面换成模拟的爱发电 / 支付宝。填上真实值(环境变量)即切到真渠道。
| 环境变量 | 说明 |
|---|---|
| `AFDIAN_USER_ID` / `AFDIAN_TOKEN` | 爱发电开放接口(query-order 的 md5 签名) |
| `AFDIAN_PUBKEY_FILE` | 爱发电 Webhook 验签公钥(PEM) |
| `AFDIAN_PLAN_ID` | 承载 `custom_price` 的「自选金额」方案 |
| `ALIPAY_APP_ID` | 当面付应用 AppID |
| `ALIPAY_APP_PRIVATE_KEY_FILE` | 应用私钥(PEM,权限 600,只放服务器) |
| `ALIPAY_PUBLIC_KEY_FILE` | 支付宝公钥(验响应 / 异步通知) |
| `PAY_ADMIN_TOKEN` | 后台口令;占位符时首次启动自动生成到 `data/admin_token` |
| `PAY_BASE_URL` / `PAY_PORT` / `PAY_DATA_DIR` | 对外地址 / 端口 / 数据目录 |
## 结构
- `core.py`:数据库、演示时钟、统一到账入口 `settle_payment()`、定时任务(爱发电对账 / 当面付补查 / 支付单过期 / 订单超时 / 迟到扫描)
- `channels.py`:渠道抽象层,`Afdian`、`AlipayF2F`(create / verify_notify / query / close / refund)
- `mockgw.py`:模拟网关(只在占位符时用)
- `app.py`:HTTP 服务;`static/`:付款页、后台页、二维码库(qrcode-generator 1.4.4,MIT)
## 测试
`python3 tests/test_proto.py`:临时目录起一份服务,从 HTTP 层打 24 个场景。
## 预览部署(甲骨文 ARM)
`/opt/jz-pay-proto` + systemd `jz-pay-proto`(DynamicUser,数据 `/var/lib/jz-pay-proto`),
nginx `jz-preview.conf` 里 `/pay-proto/` 反代到 `127.0.0.1:18100`。