承兑平台在线文档

Appearance

技术栈选择 ​

**本文引用的文件** - [决策变更清单.md](file://决策变更清单.md) - [待确认决策清单.md](file://待确认决策清单.md) - [承兑平台产品方案文档.md](file://承兑平台产品方案文档.md) - [文档/Readme.md](file://文档/Readme.md) - [任务和测试过程/Readme.md](file://任务和测试过程/Readme.md) - [AI沟通记录/2026-06-03-Chat.md](file://AI沟通记录/2026-06-03-Chat.md) - [AI沟通记录/2026-06-04-Chat.md](file://AI沟通记录/2026-06-04-Chat.md) - [AI沟通记录/2026-06-05-Chat.md](file://AI沟通记录/2026-06-05-Chat.md) - [AI沟通记录/2026-06-06_沟通记录.md](file://AI沟通记录/2026-06-06_沟通记录.md)

目录 ​

  1. 简介
  2. 项目结构
  3. 核心组件
  4. 架构总览
  5. 详细组件分析
  6. 依赖分析
  7. 性能考量
  8. 故障排查指南
  9. 结论
  10. 附录

简介 ​

本文件面向“承兑平台”的技术栈选择，基于仓库中的产品方案、决策清单与沟通记录，系统梳理后端开发语言、前端框架、数据库、消息队列、缓存、区块链节点与钱包服务、合规与风控工具、云与运维工具等关键组件的选型依据、对比分析、替代方案与迁移路径。文档同时给出版本兼容性、性能与安全要求的量化建议，并覆盖开发工具链、CI/CD、监控告警等工程实践。

项目结构 ​

仓库以产品文档与决策为主，辅以原型与沟通记录，形成“业务驱动—技术选型—落地实施”的闭环。项目结构要点如下：

  • 产品方案与决策：产品方案文档、待确认/已确认决策清单，明确业务模型、流程、参数与合规要求
  • 原型与交互：Axure 原型文件，支撑前端与移动端交互设计
  • 沟通记录：与AI的多轮评审与讨论，体现技术架构与风控要点
  • 文档与测试：文档目录与测试过程说明，支撑技术文档与测试规范
mermaid
graph TB
A["产品方案与决策<br/>产品方案、待确认/已确认决策"]
B["原型与交互<br/>Axure 原型"]
C["沟通记录<br/>AI评审与讨论"]
D["文档与测试<br/>文档/Readme、测试过程"]
A --> C
B --> C
C --> D

章节来源

  • [文档/Readme.md:1-3](file://文档/Readme.md#L1-L3)
  • [任务和测试过程/Readme.md](file://任务和测试过程/Readme.md)

核心组件 ​

围绕承兑平台的业务特性（法币-USDT 承兑、做市商+撮合、交易员被动接单、平台价差抽成），技术栈选择聚焦以下方面：

  • 后端开发语言与框架

    • 语言：Java（Spring Boot）或 Go（Gin/GORM）均可，结合团队能力与生态选择
    • 框架：Spring Boot（Java）或 Gin（Go）均可，强调微服务化、可观测性与高并发
    • 选型理由：Java 生态成熟、社区丰富；Go 性能与并发优势明显，适合高吞吐 API 与链上交互
    • 替代方案：Node.js（Express/Koa）适合快速迭代，但需强化并发与稳定性；Python（FastAPI）适合数据与风控规则引擎，但不适合高并发交易 API

  • 前端框架

    • PC 管理后台：React/Vue（Element Plus/Antd Pro）或 Angular
    • 移动端/交易员 App：React Native 或 Flutter，统一技术栈与交付效率
    • 选型理由：组件化、路由与状态管理成熟；跨端能力满足 App 与 H5 需求
    • 替代方案：原生 iOS/Android（开发成本高），SaaS 套件（定制性受限）

  • 数据库

    • 主库：PostgreSQL（ACID、JSON/JSONB、扩展丰富）
    • 缓存：Redis（高性能键值、发布订阅、限流、分布式锁）
    • 选型理由：PG 适合复杂业务与强一致；Redis 满足高频读写、会话与队列
    • 替代方案：MySQL（成熟但扩展性不及 PG）；MongoDB（文档模型适合风控日志，不适合强一致账务）

  • 消息队列与事件总线

    • RabbitMQ/ActiveMQ（可靠投递、死信队列、延迟队列）
    • Kafka（高吞吐、流式处理、审计与风控）
    • 选型理由：订单状态流转、异步通知、风控规则触发、批量出金处理
    • 替代方案：本地队列（不适用于分布式与高可用）

  • 缓存系统

    • Redis Cluster（高可用、分片、持久化）
    • 选型理由：热点数据、限流、会话、分布式锁、布隆过滤器
    • 替代方案：Memcached（性能略低），Ehcache（本地缓存，不适合分布式）

  • 区块链节点与钱包服务

    • 节点：QuickNode/Alchemy（稳定、可扩展）
    • 多签：Gnosis Safe（标准、多链支持）
    • 密钥管理：AWS KMS/HashiCorp Vault（HSM）
    • 选型理由：TRC20/ERC20/BEP20 三链支持、冷热钱包分层、多签与密钥安全
    • 替代方案：自建节点（运维成本高），传统钱包（安全性不足）

  • 合规与风控工具

    • KYC：SumSub/Jumio（V2 升级，活体检测）
    • 反洗钱/制裁名单：Chainalysis/Elliptic/TRM Labs（地址评分与监控）
    • 选型理由：满足 VASPA（香港）与中国法律专家评估要求
    • 替代方案：自研（周期长、成本高）

  • 云与基础设施

    • 云：AWS（新加坡/香港节点）或阿里云国际版
    • 选型理由：全球化部署、合规节点、SLA 与灾备
    • 替代方案：Azure/Tencent Cloud（需评估合规与延迟）

  • 开发工具链与 CI/CD

    • 构建与测试：Gradle/Maven（Java）或 Go Modules（Go）
    • 容器化：Docker + Kubernetes（Helm）
    • CI/CD：GitLab CI/ArgoCD（GitOps）
    • 选型理由：标准化交付、可重复性、可观测性
    • 替代方案：Jenkins（传统但可扩展）

  • 监控告警系统

    • APM：Prometheus + Grafana + Loki（指标、日志、追踪）
    • 告警：Alertmanager + 企业微信/钉钉集成
    • 选型理由：高并发、低延迟、链路追踪、合规审计
    • 替代方案：SkyWalking（链路追踪）、ELK（日志分析）

章节来源

  • [承兑平台产品方案文档.md:656-694](file://承兑平台产品方案文档.md#L656-L694)
  • [决策变更清单.md:107-140](file://决策变更清单.md#L107-L140)
  • [待确认决策清单.md:480-523](file://待确认决策清单.md#L480-L523)

架构总览 ​

下图展示承兑平台的技术架构：业务中台（订单、账户、费率、风控、通知、报表）与链上钱包中心协同，支撑商户端、交易员端与运营后台。

mermaid
graph TB
subgraph "前端"
M["商户端API/后台"]
T["交易员端App/H5"]
O["运营后台Web"]
end
subgraph "业务中台"
OC["订单中心"]
AC["账户中心"]
RE["费率引擎"]
RC["风控中心"]
NC["通知中心"]
DC["数据报表中心"]
end
subgraph "链上与安全"
WC["钱包中心地址/链上交互/多签"]
BK["区块链节点QuickNode/Alchemy"]
KM["密钥管理AWS KMS/Vault"]
end
subgraph "基础设施"
DB["数据库PostgreSQL"]
RS["缓存Redis"]
MQ["消息队列RabbitMQ/Kafka"]
CL["容器编排Kubernetes"]
MON["监控告警Prometheus/Grafana/Loki"]
end
M --> OC
T --> OC
O --> OC
OC --> AC
OC --> RE
OC --> RC
OC --> NC
OC --> DC
AC --> DB
AC --> RS
RE --> DB
RC --> MQ
NC --> MQ
DC --> DB
WC --> BK
WC --> KM
DB --> CL
RS --> CL
MQ --> CL
MON --> CL

图表来源

  • [承兑平台产品方案文档.md:295-331](file://承兑平台产品方案文档.md#L295-L331)

章节来源

  • [承兑平台产品方案文档.md:295-331](file://承兑平台产品方案文档.md#L295-L331)

详细组件分析 ​

后端开发语言与框架 ​

  • 选型建议
    • Java（Spring Boot）：生态成熟、微服务与可观测性工具丰富，适合复杂业务与强一致账务
    • Go（Gin/GORM）：并发与性能优异，适合高吞吐 API 与链上交互
  • 替代方案与权衡
    • Node.js：开发效率高，但高并发与稳定性需额外投入
    • Python：适合风控规则引擎与数据分析，不适合高并发交易 API
  • 迁移路径
    • 从 Node.js/Python 迁移到 Java/Go：分层重构、API 网关与灰度发布、链路追踪与压测

章节来源

  • [待确认决策清单.md:480-523](file://待确认决策清单.md#L480-L523)

前端框架 ​

  • 选型建议
    • PC 管理后台：React + Antd Pro 或 Vue + Element Plus
    • 移动端/交易员 App：React Native 或 Flutter
  • 替代方案与权衡
    • 原生 iOS/Android：开发成本高，维护复杂
    • SaaS 套件：定制性差，不利于长期演进
  • 迁移路径
    • 从原生到 RN/Flutter：组件化封装、跨端适配、性能优化

章节来源

  • [AI沟通记录/2026-06-04-Chat.md:8-12](file://AI沟通记录/2026-06-04-Chat.md#L8-L12)

数据库与缓存 ​

  • 选型建议
    • 主库：PostgreSQL（强一致、JSON/JSONB、扩展丰富）
    • 缓存：Redis（高性能键值、发布订阅、限流、分布式锁）
  • 替代方案与权衡
    • MySQL：成熟但扩展性不及 PG；MongoDB：文档模型适合风控日志，不适合强一致账务
  • 迁移路径
    • 从 MySQL/MongoDB 迁移到 PG/Redis：数据模型映射、索引与分区策略、压测与回滚预案

章节来源

  • [承兑平台产品方案文档.md:656-694](file://承兑平台产品方案文档.md#L656-L694)

消息队列与事件总线 ​

  • 选型建议
    • RabbitMQ/ActiveMQ：可靠投递、死信队列、延迟队列，适合订单状态流转与通知
    • Kafka：高吞吐、流式处理、审计与风控
  • 替代方案与权衡
    • 本地队列：不适用于分布式与高可用
  • 迁移路径
    • 从本地队列迁移到 RabbitMQ/Kafka：幂等设计、重试与死信、监控告警

章节来源

  • [决策变更清单.md:127-133](file://决策变更清单.md#L127-L133)

缓存系统 ​

  • 选型建议
    • Redis Cluster：高可用、分片、持久化
  • 替代方案与权衡
    • Memcached：性能略低；Ehcache：本地缓存，不适合分布式
  • 迁移路径
    • 从单机缓存迁移到 Redis Cluster：一致性与失效策略、热点与雪崩治理

章节来源

  • [承兑平台产品方案文档.md:656-694](file://承兑平台产品方案文档.md#L656-L694)

区块链节点与钱包服务 ​

  • 选型建议
    • 节点：QuickNode/Alchemy（稳定、可扩展）
    • 多签：Gnosis Safe（标准、多链支持）
    • 密钥管理：AWS KMS/HashiCorp Vault（HSM）
  • 替代方案与权衡
    • 自建节点：运维成本高；传统钱包：安全性不足
  • 迁移路径
    • 从单一节点/钱包迁移到多节点/多签：冷热钱包分层、密钥轮换、监控告警

章节来源

  • [承兑平台产品方案文档.md:656-694](file://承兑平台产品方案文档.md#L656-L694)

合规与风控工具 ​

  • 选型建议
    • KYC：SumSub/Jumio（V2 升级，活体检测）
    • 反洗钱/制裁名单：Chainalysis/Elliptic/TRM Labs（地址评分与监控）
  • 替代方案与权衡
    • 自研：周期长、成本高
  • 迁移路径
    • 从静态拍照到活体检测：SDK 集成、隐私与合规、压测与回滚

章节来源

  • [待确认决策清单.md:97-107](file://待确认决策清单.md#L97-L107)
  • [决策变更清单.md:142-164](file://决策变更清单.md#L142-L164)

云与基础设施 ​

  • 选型建议
    • 云：AWS（新加坡/香港节点）或阿里云国际版
  • 替代方案与权衡
    • Azure/Tencent Cloud：需评估合规与延迟
  • 迁移路径
    • 从本地/单一云迁移到多区域部署：镜像与备份、灾难恢复、合规审计

章节来源

  • [承兑平台产品方案文档.md:656-694](file://承兑平台产品方案文档.md#L656-L694)

开发工具链与 CI/CD ​

  • 选型建议
    • 构建与测试：Gradle/Maven（Java）或 Go Modules（Go）
    • 容器化：Docker + Kubernetes（Helm）
    • CI/CD：GitLab CI/ArgoCD（GitOps）
  • 迁移路径
    • 从传统流水线迁移到 GitOps：模板化、权限与审计、回滚策略

章节来源

  • [AI沟通记录/2026-06-05-Chat.md:9-19](file://AI沟通记录/2026-06-05-Chat.md#L9-L19)

监控告警系统 ​

  • 选型建议
    • APM：Prometheus + Grafana + Loki（指标、日志、追踪）
    • 告警：Alertmanager + 企业微信/钉钉集成
  • 迁移路径
    • 从无监控到全链路监控：指标体系、日志采集、告警收敛与演练

章节来源

  • [AI沟通记录/2026-06-04-Chat.md:8-12](file://AI沟通记录/2026-06-04-Chat.md#L8-L12)

依赖分析 ​

  • 组件耦合与内聚
    • 订单中心与账户中心高内聚，通过 API 与消息队列解耦
    • 钱包中心与风控中心通过事件总线解耦
  • 外部依赖
    • 区块链节点与多签钱包服务、合规与风控 SaaS
  • 潜在循环依赖
    • 避免业务模块相互引用，通过事件与消息队列解耦
  • 接口契约
    • API 文档与 OpenAPI/Swagger 管理，版本化与向后兼容
mermaid
graph LR
OC["订单中心"] --> AC["账户中心"]
OC --> RE["费率引擎"]
OC --> RC["风控中心"]
OC --> NC["通知中心"]
AC --> DB["数据库"]
AC --> RS["缓存"]
RE --> DB
RC --> MQ["消息队列"]
NC --> MQ
WC["钱包中心"] --> BK["区块链节点"]
WC --> KM["密钥管理"]

图表来源

  • [承兑平台产品方案文档.md:295-331](file://承兑平台产品方案文档.md#L295-L331)

章节来源

  • [承兑平台产品方案文档.md:295-331](file://承兑平台产品方案文档.md#L295-L331)

性能考量 ​

  • 并发与吞吐
    • 交易 API 使用 Go/Java 微服务，结合 Redis 缓存热点数据
    • 消息队列采用 RabbitMQ/Kafka，支持死信与重试
  • 延迟与可用性
    • 采用 Redis Cluster 与 PG 主从复制，结合 CDN 与就近部署
  • 数据一致性
    • 订单状态机与分布式事务（Saga/消息最终一致），结合幂等与补偿
  • 风控与安全
    • 限流、熔断、黑白名单、DDoS 防护、TLS 与 API 签名

[本节为通用指导，无需特定文件引用]

故障排查指南 ​

  • 常见问题与定位
    • 订单状态异常：检查消息队列重试与死信、日志与追踪
    • 链上交互失败：检查节点连通性、私钥与签名、Gas 与区块确认
    • 缓存穿透/雪崩：限流与降级、热点数据预热、缓存失效策略
  • 排障流程
    • 快速定位（指标/日志/追踪）→ 降级与隔离（熔断/限流）→ 修复与回滚（灰度/回滚）→ 复盘与改进（SOP/演练）

章节来源

  • [AI沟通记录/2026-06-04-Chat.md:8-12](file://AI沟通记录/2026-06-04-Chat.md#L8-L12)

结论 ​

承兑平台的技术栈选择以“业务驱动、安全优先、性能与合规兼顾”为核心原则。后端建议采用 Java/Go 微服务，前端采用 React/Vue/Flutter，数据库与缓存采用 PG/Redis，消息队列采用 RabbitMQ/Kafka，区块链采用 QuickNode/Alchemy 与 Gnosis Safe，合规与风控采用 SaaS 方案。通过容器化与 GitOps 实现标准化交付，借助 Prometheus/Grafana/Loki 构建全链路监控告警体系。迁移路径遵循分层重构、灰度发布与压测验证，确保平滑过渡与稳定运行。

[本节为总结，无需特定文件引用]

附录 ​

  • 版本兼容性建议
    • Java：Spring Boot 3.x + JDK 17+
    • Go：Go 1.21+，Gin 1.9+
    • PostgreSQL：15+，Redis 7+
    • RabbitMQ：3.12+，Kafka：3.5+
    • Docker：24+，Kubernetes：1.28+
  • 安全要求
    • TLS 1.3、API 签名（HMAC-SHA256）、密钥轮换、多因素认证、审计日志
  • 开发工具链
    • Gradle/Maven、Go Modules、Docker、Helm、GitLab CI/ArgoCD
  • 监控告警
    • Prometheus、Grafana、Loki、Alertmanager、企业微信/钉钉

章节来源

  • [决策变更清单.md:127-133](file://决策变更清单.md#L127-L133)
  • [待确认决策清单.md:480-523](file://待确认决策清单.md#L480-L523)