# 收款原型(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`。