项目简介
Wonex 是搭建在 Telegram 小程序生态上的跨境支付结算平台，面向多主体协同的业务场景——商户发起需求、用户响应、平台撮合与清算，系统自动完成订单流转、资金状态机变更与对账。平台采用银行级 FIFO（先进先出）账务管理，确保每笔资金流向可追溯、账务零误差。覆盖用户端、商户端、平台管理端三个独立 Mini App 及完整后台，用户无需下载任何 App，在 Telegram 内完成下单、响应、资金管理全流程。
核心功能
- 撮合引擎：商户发起需求 → 用户响应 / 平台派发，两种撮合模式灵活切换
- FIFO 账务系统：银行级先进先出账务管理，每笔资金流向完整可追溯
- 实时清算引擎：订单完成后自动完成资金清算与账户状态更新
- 用户端 Mini App：注册登录、订单处理、订单管理、资金流水、消息推送
- 商户端 Mini App：商户入驻审核、服务管理、订单处理、财务结算
- 平台管理端 Mini App：用户管理、商户审核、订单监控、数据报表
- 统一后台系统：权限体系、数据仪表盘、资金对账、风控审核
- Telegram 机器人：作为三端入口，提供通知推送、客服入口、快捷操作
技术栈
React TypeScript TG WebApp SDK Python FastAPI PostgreSQL Redis WebSocket
关键技术亮点
1. 三端 Mini App 共享状态的工程化 用户端、商户端、平台端三个 Mini App 独立发布却共享会话与风控规则，通过统一身份服务 + JWT 下发、后端路由按 role 分流，避免三端各造一套登录态，也保证三端数据口径一致。
2. FIFO 账本强一致 每笔资金变动走"预占用 → 冻结 → 清算"三段式状态机，PostgreSQL 事务 + Redis 分布式锁，保证并发下单、并发响应场景下的账务不错、不重、不漏。
3. WebSocket 实时推送 订单状态、资金变动、商户通知全部通过 WebSocket 实时下推，用户端订单响应延迟稳定在 200ms 内，商户端财务结算零轮询。
4. 风控与合规系统 所有订单、账户变动、异常行为进入风控链路，规则可在后台配置。高风险动作自动拦截或进入人工审核，关键操作带完整审计日志，为合规审查提供全链路证据。
5. 多端数据一致性 Redis 作为热数据缓存层，PostgreSQL 作为强一致账本层，通过事件总线和乐观锁保证多端视图下的数据同步，避免"A 端看到已完成、B 端看到处理中"的错位。
交付成果
- 三个独立 Mini App + 统一后台 + 机器人入口，一整套业务闭环
- 完整的资金流水、风控审核、数据报表体系，满足跨境支付业务的合规要求
- 长期迭代中持续交付新功能，系统稳定支撑真实业务运营
