Files

T

goukiandDevin <158243242+devin-ai-integration[bot]@users.noreply.github.com> 132fef051b feat(commerce): 排盘保存需显式同意，默认本地计算不上传

- 前端免费排盘默认不保存，勾选同意后才调用保存接口
- 服务端要求 consentVersion，记录 consentAt，校验并限流公开保存接口
- 付费结算单独披露报告快照与订单信息将由服务端存储
- 管理端展示同意版本与时间，历史无同意证据记录保留并标注

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>

2026-09-27 23:21:16 +00:00

3.9 KiB

Raw Blame History

知命 / 祈福后端服务

基于 Go、Gin、GORM 的统一后端，提供微信小程序能力、商业版八字报告、邮箱登录、支付、订单权益和管理后台。

功能模块

微信小程序登录与生辰档案。
Postmark 邮箱验证码登录。
Stripe 4.99 USD 报告支付。
Binance Pay 5 USDT 报告支付。
签名 Webhook、幂等事件、退款权益撤销。
随机报告恢复码与不可变报告快照。
用户订单与报告权益查询。
数据库驱动的 PC 商业版订单列表和收入统计。
PC 商业版后台只查询 type=bazi_report，与小程序许愿等旧业务订单逻辑隔离。
许愿树与百科数据。

快速开始

cp .env.example .env.local
go mod download
go run ./cmd

默认地址：http://localhost:8080。

生产部署可使用 systemd 直接运行二进制，商业前端静态文件放在服务目录的 frontend/，根路径 / 为商业站点，/admin/orders 为管理后台，/api/* 为后端接口。这样无需 Docker 或 Nginx，适合小内存服务器；Cloudflare 可在边缘终结 HTTPS 并回源到 80 端口。

测试

项目包含 HTTP API 测试，覆盖未认证拦截、Webhook 拒绝、Stripe 模拟下单、签名回调、权益发放、恢复码和快照读取。

go test ./...

测试环境文件为本地 server/.env.test，不提交任何真实密钥。

商业支付 API

邮箱登录

POST /api/auth/email/request
POST /api/auth/email/verify

支付与报告

POST /api/commerce/checkout — 创建 Stripe 或 Binance Pay 订单。
POST /api/commerce/webhooks/stripe — Stripe 签名通知。
POST /api/commerce/webhooks/binance-pay — Binance Pay 签名通知。
GET /api/commerce/orders/:orderNo — 查询本人订单。
GET /api/commerce/reports/:reportId/access — 查询报告权益。
GET /api/commerce/reports — 本人已购报告。
GET /api/commerce/reports/recover/:accessCode — 使用恢复码读取购买时快照。
POST /api/commerce/charts — 用户主动同意后保存免费排盘记录；接口限流并记录同意版本与时间。

除 Webhook 和需同意的公开排盘记录接口外，商业接口都要求 Authorization: Bearer <JWT>。

免费排盘默认不上传。创建付费订单时，报告快照会发送并保存在服务端，用于生成、交付和恢复已购报告。

管理后台

/admin/orders — 真实订单列表。
/admin/api/orders — 按渠道、状态、订单号、邮箱、报告号查询。
/admin/api/orders/stats — 订单和收入统计。

后台使用 ADMIN_PASSWORD 登录并写入 HttpOnly Cookie。

支付安全

金额只从 report_products 读取。
Stripe 使用 Checkout Session 和 Idempotency-Key。
Stripe Webhook 校验 HMAC 签名与 5 分钟时间窗口。
Binance Pay 下单使用 HMAC-SHA512。
Binance Pay Webhook 使用商户证书 RSA 公钥验签。
Webhook 同时校验服务商订单号、金额与币种。
payment_events 唯一索引保证重复回调不会重复发放权益。
支付、事件、恢复码和权益在数据库事务中完成。
退款后报告权益自动撤销。

数据库

新安装由 GORM AutoMigrate 创建表。商业排盘记录新增同意版本和时间字段，服务启动时通过 AutoMigrate 增量添加；已有 MySQL 数据库应先备份再升级，不要执行数据库 fresh 或 refresh。商业表结构初始化脚本仍为：

mysql < migrations/002_commerce.sql

环境变量

完整模板见 .env.example。生产环境至少需要：

JWT_SECRET
ADMIN_PASSWORD
PUBLIC_BASE_URL
WEB_APP_URL
POSTMARK_SERVER_TOKEN
POSTMARK_FROM_EMAIL
STRIPE_SECRET_KEY
STRIPE_WEBHOOK_SECRET
BINANCE_PAY_API_KEY
BINANCE_PAY_SECRET_KEY
BINANCE_PAY_WEBHOOK_PUBLIC_KEY

所有支付与邮件密钥必须通过部署环境注入，禁止提交到 Git。

3.9 KiB Raw Blame History