完整的订阅链路
从商品报价、支付到权益履约和订阅分发，关键写入在同一事务内完成。
PPanel Edge
使用文档
PPanel Edge 将商品、订阅、支付与节点管理连接起来。以 PostgreSQL 为业务核心，优先部署在 Cloudflare Workers。
TypeScript · Hono · PostgreSQL · Cloudflare Workers
面向节点的开放协议
协议 v1、契约测试和模拟器，帮助外部节点实现配置同步与幂等用量上报。
清晰的运营边界
员工权限、后台 MFA、不可变账务流水与审计记录，让操作可追溯。
控制面，连接业务与节点
PPanel Edge 面向代理服务运营者，管理商品规格、订单、钱包、订阅权益、节点配置与流量用量。用户在门户购买和管理订阅，员工在后台按权限运营。实际代理流量由独立的外部节点程序处理；本项目提供节点协议 v1、模拟器和契约测试。
本文档描述当前实现与产品约定。功能均已实现并有自动化测试覆盖；真实生产部署仍需在预发布环境完成验证（真实 Cloudflare 资源、数据库与支付商户）。
架构一览
用户门户 · 管理后台
外部节点 · 协议 v1
经 HTTPS 连接控制面
Hono API
Cloudflare Workers / Bun / Node.js
按职责存储
- PostgreSQL
- 业务事实与可靠任务；Workers 经 Hyperdrive 访问。
- R2
- 文件字节，公开与私有分桶。
- DO / Redis / PG
- 临时状态，按部署选择一种实现。
PostgreSQL 是业务数据的唯一存储。Workers 经关闭查询缓存的 Hyperdrive 访问数据库；可靠任务也存储在 PostgreSQL。公开和私有文件分桶存放在 R2，短期状态使用 Durable Objects；Bun 自托管适配使用 Redis 或 PostgreSQL。
订阅流程
- 用户门户
选择商品并确认报价，创建待支付订单。
- 支付与履约
确认支付事实后，在事务中写入订单与订阅权益。
- 订阅分发
用户导入订阅链接；外部节点按授权提供代理服务。
从你的角色开始
- 部署者：本地快速开始、Workers 部署、备份与恢复。
- 运营者：运营指南、配置参考。
- 最终用户：注册、购买与导入订阅。
- 节点实现者：节点协议、契约与模拟器。
- 开发者：开发者集成、自动生成的 API 参考。
生产验收
本地测试通过不等于生产验收。上线前在预发布环境逐项完成真实 Workers、Hyperdrive、支付商户、Apple 与客户端的验证，步骤见 Workers 部署与备份与恢复。