Genex 券交易平台 - 软件开发需求规格
本文档基于《Genex 券交易平台 - 软件需求规格说明书 v4.1》提取的软件开发需求概要，供开发团队快速了解系统全貌
1. 系统概述
1.1 项目定位
构建一个券类资产的金融交易平台，实现券的完整金融生命周期管理：
发行方发行 → 一级市场销售 → 二级市场流通 → 估值定价 → 清算兑付 → 到期管理
1.2 核心价值
- 区块链是基础设施，不是用户界面——用户看到的是支付宝/Zelle，底层是Genex Chain
- 合约清算保护企业客户——消费环节平台不介入，客户数据不经过平台
- 券类型防火墙——消费型券(Utility)与投资型券(Securities)双轨隔离
1.3 核心目标
让每一张券都具备"价格 + 信用 + 流动性"，构建券金融交易的标准化底层系统。
2. 系统架构需求
2.1 总体架构
| 层级 |
功能 |
技术选型 |
| 用户层 |
Web2体验（手机号注册、银行卡支付、中文术语） |
React/Flutter + Ant Design Pro |
| 翻译层 |
手机号→地址映射、Gas代付、术语翻译 |
Go微服务 + Redis |
| 基础设施层 |
链上资产管理、合约清算、不可篡改记录 |
Genex Chain（Cosmos SDK + cosmos/evm + CometBFT） |
2.2 Genex Chain（自建链）
| 参数 |
规格 |
| 链框架 |
Cosmos SDK + cosmos/evm（官方EVM模块，Apache 2.0） |
| 共识引擎 |
CometBFT（即时终结性，1区块=最终确认） |
| 出块时间 |
≤ 1秒 |
| TPS |
≥ 5,000 |
| EVM兼容 |
完全兼容（Solidity、Hardhat、MetaMask） |
| 跨链 |
IBC + Axelar桥 |
| Gas策略 |
平台前期全额补贴，用户零Gas |
| 原生代币 |
GNX（Gas + 治理，当前阶段用户不接触） |
| 参考链 |
Cronos、dYdX v4、Injective |
2.3 整体产品结构
├── 消费者端（Consumer App）
│ ├── 我的券：查看、管理、转赠（手机号转赠）
│ ├── 交易市场：买卖券（价格≤面值，Utility Track）
│ ├── 消费：出示券码/扫码核销
│ └── 账户：余额、订单记录、消息通知
│
├── 发行方端（Issuer Console）
│ ├── 发券中心：模板化发券、规则配置
│ ├── 核销管理：扫码核销、在线核销、离线核销
│ ├── 数据中心：发行/兑付/Breakage数据看板
│ └── 财务管理：销售收入、提现、对账
│
├── 商户核销端（Merchant App）
│ ├── 扫码核销（3秒完成）
│ ├── 输码核销（备选）
│ └── 离线核销（断网可用）
│
├── 监管端（RegNode）
│ ├── 只读审计接口
│ ├── 实时数据报送
│ └── 链上可追溯
│
└── 平台核心服务层（Core Engine）
├── 7合约智能合约系统（CouponFactory/Coupon/Settlement/Redemption/Treasury/Compliance/Governance）
├── 链下撮合引擎（内存订单簿）
├── UX翻译层
├── AI信用评分与定价引擎
└── KYC/AML/OFAC合规引擎
3. 核心功能模块需求
3.1 券发行系统
| 功能 |
描述 |
优先级 |
| 发行方入驻审核 |
营业执照、资质验证、初始信用评级 |
P0 |
| 零保证金信用成长 |
初始低额度→兑付表现→信用提升→额度提升 |
P0 |
| 模板化发券 |
满减券、折扣券、礼品卡、储值券模板 |
P0 |
| 可配置规则（7项） |
可转让性、转售次数、人群限定、单人限购、门店限定、叠加使用、最低消费 |
P0 |
| 券类型标记 |
Utility/Security类型，铸造时写入合约，不可更改 |
P0 |
| 链上铸造 |
CouponFactory合约批量铸造ERC-721/1155 |
P0 |
3.2 券交易市场
| 功能 |
描述 |
优先级 |
| 一级市场 |
发行方→消费者，银行卡支付→链上结算 |
P0 |
| 二级市场 |
持有人间自由交易，价格上限=面值（Utility Track） |
P0 |
| 链下撮合引擎 |
价格优先→时间优先，延迟<10ms |
P0 |
| 链上原子交换 |
Settlement合约，券↔稳定币同时转移 |
P0 |
| 做市商接口 |
KYC L3准入，低延迟API，Maker-Taker模型 |
P1 |
| AI定价建议 |
三因子模型（时间折扣+信用风险+流动性溢价）+ LSTM预测 |
P1 |
3.3 清算与兑付
| 功能 |
描述 |
优先级 |
| 合约直接结算 |
Redemption合约，消费者与发行方直接结算，平台不介入 |
P0 |
| 退款机制 |
Settlement合约反向原子交换（券↔资金同时退回） |
P0 |
| 链上对账 |
链上数据即账本，无需日终对账 |
P0 |
| Breakage收益计算 |
过期未使用券自动计入发行方收益 |
P1 |
3.4 资产托管（三级模型）
| 级别 |
用户画像 |
说明 |
| 标准模式（默认） |
99%用户 |
平台MPC托管，用户无感知，手机号注册即用 |
| 提取到外部钱包 |
自持资产用户 |
券转至MetaMask等外部钱包，平台无关 |
| Pro模式 |
加密原生用户 |
WalletConnect自托管，链上完全可见 |
3.5 风控与合规
| 功能 |
描述 |
优先级 |
| KYC分级 |
L0浏览/L1小额/L2标准/L3专业 |
P0 |
| OFAC筛查 |
SDN制裁名单比对，命中即冻结（零容忍） |
P0 |
| Travel Rule |
P2P≥$3,000强制Compliance合约路由 |
P0 |
| AML监控 |
链上行为分析、关联交易检测、SAR自动生成 |
P0 |
| 链级合规 |
验证节点OFAC过滤、Travel Rule打包检查 |
P0 |
| 信用评分 |
四因子公式（核销率35%+沉淀率25%+存续时长20%+满意度20%） |
P1 |
| 异常检测 |
Isolation Forest + DeepSVDD实时检测 |
P1 |
3.6 用户系统
| 功能 |
描述 |
优先级 |
| 手机号/邮箱注册 |
后台自动创建MPC托管钱包，用户无感知 |
P0 |
| 个人中心 |
我的券/我的订单/我的余额（Web2术语，无区块链术语） |
P0 |
| P2P转赠 |
输入手机号即可转赠（后台解析为链上地址） |
P0 |
| 账户恢复 |
手机号/邮箱验证即可恢复（MPC托管无私钥丢失风险） |
P0 |
| 消息通知 |
交易状态、券过期提醒、价格变动 |
P1 |
3.7 商户核销
| 功能 |
描述 |
优先级 |
| 扫码核销 |
门店收银员扫消费者券码，≤3秒完成 |
P0 |
| 离线核销 |
断网时本地验证+暂存，联网后上链 |
P0 |
| 多门店管理 |
总部→区域→门店层级，独立核销权限 |
P1 |
| POS SDK |
嵌入现有收银系统 |
P2 |
3.8 发行方管理后台（B端Web2体验）
| 功能 |
描述 |
优先级 |
| 模板化发券 |
填表即可发券，无需了解NFT/ERC标准 |
P0 |
| 兑付管理 |
扫码/在线核销，后台自动调用Redemption合约 |
P0 |
| 财务管理 |
法币视图（销售收入、提现、对账） |
P0 |
| 数据仪表盘 |
发行/兑付/流通/Breakage可视化 |
P1 |
| 消费者数据隔离 |
仅可见汇总数据，不可见个人信息 |
P0 |
4. API生态与开放平台
4.1 核心API接口
| API域 |
路径 |
功能 |
| /api/v1/coupons |
券服务 |
发行、查询、转让、核销 |
| /api/v1/trades |
交易服务 |
挂单、撤单、成交、历史 |
| /api/v1/payments |
支付服务 |
充值、提现、法币转换 |
| /api/v1/issuers |
企业服务 |
入驻、审核、数据统计 |
| /api/v1/compliance |
合规服务 |
KYC、AML、审计日志 |
| /api/v1/translate |
翻译层 |
地址映射、Gas代付 |
4.2 API设计要求
- RESTful规范
- OAuth 2.1 + JWT认证
- 限流（普通100/企业1K/做市商10K req/min）
- RFC 7807错误格式
- 完整API文档与沙箱环境
4.3 SDK支持
| SDK |
语言 |
优先级 |
| genex-js |
JavaScript/Node.js |
P0 |
| genex-java |
Java/Android |
P0 |
| genex-python |
Python |
P1 |
| genex-swift |
Swift/iOS |
P1 |
| genex-go |
Go |
P2 |
5. 安全与合规需求
5.1 安全架构
| 层级 |
机制 |
技术 |
| 网络层 |
全链路加密、服务间mTLS |
TLS 1.3 |
| 应用层 |
多因素认证、角色权限 |
OAuth 2.1 + MFA + RBAC |
| 数据层 |
加密存储、字段脱敏 |
AES-256 |
| 审计层 |
全链路日志、链上存证 |
不可篡改 |
| 合约层 |
第三方审计、升级多签 |
Transparent Proxy + 3/5多签 |
5.2 美国联邦合规（核心）
| 合规项 |
监管方 |
说明 |
| MSB注册 |
FinCEN |
货币服务业务，Form 107 |
| OFAC制裁筛查 |
OFAC |
SDN名单比对，零容忍 |
| Travel Rule |
FATF |
P2P≥$3,000身份信息传递 |
| BSA/AML |
FinCEN |
反洗钱计划、SAR/CTR申报 |
| 消费者保护 |
FTC |
券信息披露、退款政策透明 |
| 州MTL |
各州 |
49州+DC货币转移牌照 |
| SOX合规 |
SEC |
Nasdaq上市必须 |
5.3 券的证券属性合规
- 券类型防火墙：Utility Track（价格≤面值，不是证券）vs Securities Track（需Broker-Dealer）
- GNX代币：当前阶段用户不接触，仅作链内部机制
- 运营策略：Phase 1只开放Utility Track，规避SEC风险
5.4 安全事件响应
| 级别 |
响应时限 |
示例 |
| P0 |
15分钟 |
资产被盗、合约漏洞 |
| P1 |
1小时 |
数据泄露、系统入侵 |
| P2 |
4小时 |
局部异常、可疑活动 |
| P3 |
24小时 |
潜在风险、安全隐患 |
5.5 隐私合规（CCPA/GDPR vs 区块链）
- 链上仅存储地址和哈希（无PII）
- 链下存储个人信息（可删除）
- 用户请求删除→删除链下PII→链上地址变为匿名
6. 技术栈
| 层级 |
技术选型 |
| 前端 |
React + Next.js（Web）、Flutter（移动端）、Ant Design Pro（后台） |
| 后端 |
Go微服务架构 |
| 数据库 |
PostgreSQL + Redis + TimescaleDB |
| 消息队列 |
Kafka |
| 搜索 |
Elasticsearch |
| 区块链 |
Genex Chain（Cosmos SDK + cosmos/evm + CometBFT） |
| 智能合约 |
Solidity（7合约系统） |
| AI/ML |
LightGBM（信用）、LSTM+Prophet（定价）、Isolation Forest（异常检测） |
| 监控 |
Prometheus + Grafana + ELK + Jaeger |
| 基础设施 |
Kubernetes + Istio + GitLab CI + ArgoCD |
| 密钥管理 |
HSM + MPC |
7. 非功能性需求
7.1 性能需求
| 指标 |
目标值 |
| Genex Chain TPS |
≥ 5,000 |
| 出块时间 |
≤ 1秒 |
| 撮合延迟 |
< 10ms |
| API P99 |
< 200ms |
| 翻译层延迟 |
< 50ms |
| 系统可用性 |
> 99.9% |
7.2 灾难恢复
| 指标 |
目标值 |
| RPO |
< 1分钟 |
| RTO |
< 15分钟 |
7.3 容量规划
| 阶段 |
用户规模 |
日交易量 |
| Phase 1（基础平台） |
10万 |
50万笔 |
| Phase 2 |
100万 |
500万笔 |
| Phase 3 |
1,000万 |
5,000万笔 |
7.4 合规需求
- CCPA（加州消费者隐私法）
- GDPR（如服务欧盟用户）
- SOX（Nasdaq上市要求）
- PCI-DSS（支付安全）
- ISO 27001（信息安全）
8. 产品路线图
| 阶段 |
核心目标 |
| Phase 1 — 基础平台 |
Genex Chain上线 + Utility Track消费型券 + 手机号注册 + 基础交易市场 + OFAC/Travel Rule |
| Phase 2 — 体验优化 |
AI定价/信用评分 + 做市商 + 完整数据看板 |
| Phase 3 — B端增强 |
批量发券 + POS SDK + 多门店管理 |
| Phase 4 — Securities Track |
法律意见书 + Broker-Dealer + 投资型券市场 + GCFN跨境节点 |
9. 关键指标（KPI）
9.1 核心业务
| 指标 |
目标值 |
| 交易成功率 |
> 95% |
| 发行方兑付率 |
> 85% |
| 链上确认时间 |
< 1秒 |
| 用户投诉率 |
< 1% |
| 核销成功率（含离线） |
> 99.5% |
9.2 UX体验
| 指标 |
目标值 |
| 标准模式用户占比 |
> 95% |
| 注册→首次购买转化率 |
> 30% |
| 用户零区块链感知率 |
> 90% |
9.3 安全合规
| 指标 |
目标值 |
| OFAC筛查覆盖率 |
100% |
| 映射表完整性（链上锚定校验） |
100% |
| P0事件响应时间 |
< 15分钟 |
10. 附录
10.1 术语表
| 术语 |
定义 |
| 券（Coupon） |
链上数字资产，可发行、可交易、可清算的金融工具 |
| Genex Chain |
平台自建EVM兼容应用链（Cosmos SDK + cosmos/evm + CometBFT） |
| Utility Track |
消费型券轨道，价格≤面值，规避SEC证券风险 |
| Securities Track |
投资型券轨道，需完整证券合规 |
| MPC托管 |
多方计算托管钱包，用户无感知，平台自动管理 |
| 翻译层 |
将Web3操作翻译为Web2用户可理解概念的中间层 |
| CometBFT |
Cosmos SDK共识引擎，提供即时终结性 |
| GNX |
Genex Chain原生代币（Gas + 治理） |
| Breakage |
券过期未使用比例，发行方潜在收益 |
| GCFN |
Global Coupon Financial Network，全球券金融网络 |
10.2 参考文档
- 《Genex 券交易平台 - 软件需求规格说明书 v4.1》（权威源）
- 《Genex 券交易平台 - 技术架构开发需求文档 v3.0》
- 《券的金融本质与短期资金募集机制白皮书》
文档版本: v2.0
创建日期: 2026-02-09
最后更新: 2026-02-09
基于: Genex 券交易平台 - 软件需求规格说明书 v4.1