wx-gateway · 微信公众号统一网关
Container View · 双实例(造悟者 + 莆阳)共代码,共宿主,各自一个公众号 / DB
wx-gateway · trust boundary
微信用户
[Person]
公众号粉丝
业务方应用
[External Software System]
echo / pack / ph / ...
微信公众号平台
[External]
mp.weixin.qq.com
网关 Web 应用
[Container · Next.js 15 + TypeScript · PM2 · Caddy]
微信回调 + 消息分发
/wx/callback · lib/fanout
XML 解析 → 路由匹配
扫码登录 + OAuth
/wx/qr · /wx/poll · /wx/oauth
UserAppBinding 自动写入
支付 (微信支付 v3)
/pay/* · JSAPI · 异步回调
5min 对账 cron
access_token API
/internal/wx-token
HMAC + advisory lock
Admin 后台 (secure path)
apps · invites · payments · routes · endpoints · scans · health
业务方注册 + 健康检查 + selftest
/apps/register · /health/downstreams · /wx/selftest
网关数据库
[Container · PostgreSQL 16 表]
App · WxLoginToken · Payment · MessageRoute · UserAppBinding · FanoutLog ...
HTTPS · 扫码/浏览器回跳
HTTPS · OAuth / 取 token / 接收 fanout
HTTPS · fanout 推消息 / 登录 redirect
HTTPS · 推 XML 消息 / 扫码事件
HTTPS · 拉 access_token / 换 openid
Prisma · SQL 读写
Legend
External · Person/System
Container · 我方应用
Component · 内部子模块
Database
Trust Boundary
Call · 协议 · 动作
部署形态
同一份代码 → 2 个 PM2 进程
· 造悟者 :3794 (服务号)
· 莆阳 :3800 (订阅号)
PG 共宿主,各一个独立库
公用 Caddy + mvp-deployer