372 lines
13 KiB
Markdown
372 lines
13 KiB
Markdown
# 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*
|