- 预览站 order.html:模板多选、分辨率、皮肤三色灯(绿放行 / 黄勾无视风险 / 红拦住),吸底金额条; 「我的订单」= 本机下过的单 + 订单号/取件码查单。 - 新 pay.html:用站点「票据」样式做收银台(爱发电 / 支付宝扫码、二维码 + 倒计时、自动轮询、付好了没反应), 到账后同页变订单页;超时关闭态;取件码存根、复制订单链接。 - cms/pay.html:收款后台(待办 / 认领 / 渠道熔断 / 订单 / 支付单 / 流水)。演示控制台收进顶部预览横幅。 - 后端:订单记模板 / 分辨率 / 皮肤名,金额按模板数;取件码 10 位好抄;接口挂 /svc/,原型独立页撤掉。 - 测试 26 条;浏览器端到端 22 条(桌面 + 手机)。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
42 lines
2.6 KiB
Markdown
42 lines
2.6 KiB
Markdown
# 收款原型(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 服务(只有接口和模拟网关,页面都在站点里)
|
||
- `preview/`:并进预览站的页面 —— `order.html`(下单表单 + 我的订单)、`pay.html`(收银台 / 订单页)、
|
||
`cms/pay.html`(收款后台)、`assets/pay.css`、`assets/pay.js`(含演示控制台)、`assets/vendor/qrcode.min.js`(qrcode-generator 1.4.4,MIT)。
|
||
另外 `cms/index.html` 的「下单页」分组里加了一个「收款与对账」链接(预览站上直接改的,三行)。
|
||
|
||
## 测试
|
||
|
||
`python3 tests/test_proto.py`:临时目录起一份服务,从 HTTP 层打 26 个场景。
|
||
|
||
## 预览部署(甲骨文 ARM)
|
||
|
||
`/opt/jz-pay-proto` + systemd `jz-pay-proto`(DynamicUser,数据 `/var/lib/jz-pay-proto`,
|
||
`PAY_BASE_URL=http://161.33.11.66/svc`、`PAY_SITE_URL=http://161.33.11.66`),
|
||
nginx `jz-preview.conf` 里 `/svc/` 反代到 `127.0.0.1:18100`;旧的 `/pay-proto/` 301 到 `/order.html`。
|
||
页面:`/order.html` → `/pay.html?o=…&t=…`;后台 `/cms/pay.html`。**只在预览机,不碰生产。**
|