Files
ywsandClaude Opus 5.5 973afd7886 收款原型并进预览站:下单表单 + 收银台 / 订单页 + 收款后台(参考 Epusdt 收银台、独角数卡浏览器缓存查单)
- 预览站 order.html:模板多选、分辨率、皮肤三色灯(绿放行 / 黄勾无视风险 / 红拦住),吸底金额条;
  「我的订单」= 本机下过的单 + 订单号/取件码查单。
- 新 pay.html:用站点「票据」样式做收银台(爱发电 / 支付宝扫码、二维码 + 倒计时、自动轮询、付好了没反应),
  到账后同页变订单页;超时关闭态;取件码存根、复制订单链接。
- cms/pay.html:收款后台(待办 / 认领 / 渠道熔断 / 订单 / 支付单 / 流水)。演示控制台收进顶部预览横幅。
- 后端:订单记模板 / 分辨率 / 皮肤名,金额按模板数;取件码 10 位好抄;接口挂 /svc/,原型独立页撤掉。
- 测试 26 条;浏览器端到端 22 条(桌面 + 手机)。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 06:58:21 +00:00

42 lines
2.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 收款原型(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`。**只在预览机,不碰生产。**