CBDC Wiki

主题

组合性设计 ​

把外部基础包与 cbdc-solution 业务层看作零件，本节讲它们如何组成完整系统。当前工作区由 go.work 管理 9 个 Go 模块；核心业务包括 cbdc-token（issuer / endorser / auditor / walletnode 四个 FSC 应用）、cbdc-bizhub、cbdc-central、已实现 Wallet / Transfer / Transaction API 的 cbdc-facade、cbdc-common 与 cbdc-rtgs-mock。

严格基于代码

cbdc-solution/docs/（含 ARCHITECTURE.md / DEPLOYMENT_AND_SCALING.md / CAPACITY_PLAN_*.md / AUDIT_PERFORMANCE_PLAN.md / cbdc-central-integration-design.md 等）以及 cbdc-solution/docs/plans/ 已与代码脱节，本章节不引用任何 docs/ 内容作为事实依据。所有声明出自：

  • Go 源码（.go / .proto / .pb.go）
  • dev/cbdc-dev / dev/internal/controller / dev/config
  • Dockerfile / docker-compose*.yml
  • cbdc-token/conf/<role>/core.yaml、dev/config/token/<role>/core.yaml、各服务 conf/core.yaml
  • .env.example / .env-example
  • go.work、go.mod、dev/scripts/*.sh
  • 各子项目根 README.md（已交叉核对目录树）

章节导览 ​

章节内容
01 系统整体架构9 个 workspace 模块、7 个开发运行单元、服务边界、数据库归属与节点发现
02 信任与身份模型Fabric-CA + sign-pki + sign-kms 三件套；KMS namespace；env 注入；Fabric-X 链上 5 关卡；ConfigUpdate 时序；缺陷 + 加固清单
03 交易跨包全链路FSC View 注册图（实证 RegisterResponder）；bizhub 3 Worker；RTGS 流程
04 部署拓扑dev/cbdc-dev 控制器、生成目录、网络与业务运行单元
05 数据流与状态视图链上 / FSC PG / BizHub 20 个 schema / Central 独立库 / Auditor 索引
06 关键设计取舍仅从代码可见的设计：rtgs-mock / Token Selector 双模 / Endorser Init 手动 / etc.
07 性能优化思路代码中可定位的调优旋钮、默认值、验证手段（cbdc-stress / pprof）；20 项可落地清单
08 扩容指南扩容矩阵、DB / 证书 / 机型三规则、单点故障清单、FAQ、配置文件索引
09 CA 与证书签发代码可定位的 CA / 证书签发事实（sign-pki + fabric-ca + KMS PKCS#11）
10 问题排查指南按症状定段：每段的逐字报错原文（可 grep 日志）+ 代码出处 + 排查动作；pp 漂移统一信号；容量问题升级信号
11 调用链路速查全部业务链路的函数级调用链：启动 / Transfer 同步异步 / Issue / Redeem / 钱包创建 / pp 部署 / 审计背书 / finality 四结局
12 运行流程 QA交易签名次数 / pp 文件 / KMS 天花板 / orderer vs committer / BFT vs CFT / finality 推送 / 10 万 TPS 路线——基于代码核实的常见问题集
13 PG 高可用部署PostgreSQL 产线部署 runbook:K8s + CloudNativePG,RPO=0 同步复制,PgBouncer 池化,S3 备份 / PITR,故障演练清单

引用约定 ​

  • cbdc-token/conf/issuer/core.yaml:10 — 文件 + 行号
  • cbdc-bizhub/cmd/bizhub/main.go:58 — 同
  • 包名（如 fabric-ca）链接到本 wiki 已写的包页
  • 应用名（如 cbdc-solution/apps/bizhub）链接到 cbdc-solution app 深度分析

相关阅读 ​