diff --git a/docs/券金融平台-软件需求规格.md b/docs/券金融平台-软件需求规格.md index 883e781..affe450 100644 --- a/docs/券金融平台-软件需求规格.md +++ b/docs/券金融平台-软件需求规格.md @@ -307,19 +307,26 @@ P = F × (1 - dt) × (1 - rc) ### 3.4 清算与支付模块 -#### 3.4.1 资金与资产托管（两种模式） +#### 3.4.1 资金与资产托管（平台托管为默认） -| | 方案B（默认） | 方案A（定制服务） | -|--|--------------|-----------------| -| **券资产** | 用户自托管（自有钱包） | 平台托管（平台钱包） | +> **设计原则：用户不需要知道"钱包"的存在。平台在后台自动为每个用户创建托管钱包，用户只看到"我的账户余额"和"我的券"。** + +| | 标准模式（默认，所有用户） | Pro模式（自助托管，主动开通） | +|--|--------------------------|--------------------------| +| **用户体验** | **手机号/邮箱注册即用**，与传统App无异 | WalletConnect连接外部钱包 | +| **券资产** | **平台托管**（后台自动创建托管钱包，用户无感） | 用户自托管（自有钱包） | | **法币** | 平台托管（隔离账户） | 平台托管（隔离账户） | -| **消费结算** | 合约直接清算，平台不介入 | 经平台验证后清算 | -| **P2P流通** | 用户间直接转移 | 需经平台 | -| **适用场景** | 所有用户默认模式 | 企业与平台签订托管服务协议 | -| **启用条件** | 注册即可 | 需签订服务协议 | +| **消费结算** | 合约直接清算，平台不介入 | 合约直接清算，平台不介入 | +| **P2P转移** | **手机号/邮箱转赠**（平台后台解析为链上地址） | 链上地址直接转移 | +| **钱包恢复** | **平台负责**（手机号/邮箱验证即可恢复） | 用户自行备份助记词/社交恢复 | +| **适用场景** | 99%普通用户（消费者、发行方） | 加密原生用户、技术开发者 | +| **启用条件** | 注册即默认开通 | 在设置中主动切换（需确认风险提示） | +| **区块链可见性** | **完全不可见**（用户界面无任何区块链术语） | 可查看链上地址、交易哈希等 | -- [ ] 默认方案B：券在用户自有钱包，平台只托管法币 -- [ ] 方案A：企业与平台签订托管服务协议后开通，平台代管券资产 +- [ ] **默认标准模式**：注册后平台自动在Genex Chain上创建托管钱包（MPC托管），用户无感知 +- [ ] **Pro模式可选**：用户在"设置→高级"中可切换至自托管模式（WalletConnect），需签署风险确认 +- [ ] 标准模式用户的P2P转移：输入对方手机号/邮箱，平台后台解析为链上地址后执行链上转移 +- [ ] 标准模式钱包恢复：通过手机号/邮箱验证 + KYC身份验证即可恢复账户（平台MPC托管，不会丢失） - [ ] 法币通道对接（出入金） - [ ] 可选：保障资金链上锁定（发行方自愿缴纳的保证金/冻结款，见3.1.2） @@ -395,36 +402,62 @@ P = F × (1 - dt) × (1 - rc) ### 3.6 用户系统模块 -#### 3.6.1 账户管理（钱包为核心） -- [ ] 钱包连接（WalletConnect / 内置钱包） -- [ ] 可选：手机号/社交账号绑定（便于找回） -- [ ] **KYC分级强制认证**（见下表） -- [ ] 法币通道绑定（出入金，需完成KYC L2） +> **设计原则：用户体验与支付宝/Zelle/Venmo一致。手机号/邮箱是账户入口，区块链完全不可见。** -**钱包丢失与恢复方案（方案B下核心风险）：** -> 方案B用户自托管券，私钥丢失 = 资产永久丢失，必须提供恢复机制 -- [ ] **内置MPC钱包（推荐）**：平台提供MPC（多方计算）钱包，密钥分片存储（用户设备 + 平台 + 第三方），任意两方可恢复 -- [ ] **社交恢复**：用户预设3-5个可信联系人（Guardian），丢失时多数Guardian确认即可恢复钱包权限 -- [ ] **助记词备份提醒**：首次创建钱包时强制提示备份助记词，定期提醒验证 -- [ ] **账户抽象（AA钱包）**：支持ERC-4337账户抽象，用邮箱/手机号作为账户入口，降低Web3门槛 -- [ ] 方案A用户不受影响（平台托管，平台负责恢复） +#### 3.6.1 账户注册与管理（手机号/邮箱为核心） + +**注册流程（标准模式，99%用户）：** +``` +手机号/邮箱注册 → 设置密码 → 短信/邮件验证码确认 → 注册成功 + ↓（后台静默执行，用户无感知） + 平台自动在Genex Chain上创建MPC托管钱包 + 钱包地址与手机号/邮箱绑定映射表 +``` + +- [ ] **手机号/邮箱注册**（主流程）：与普通App注册完全一致 +- [ ] 可选：Google/Apple/微信等社交账号一键注册 +- [ ] 注册后**平台后台自动创建MPC托管钱包**（用户不知道、不需要知道钱包的存在） +- [ ] **KYC分级强制认证**（见下表） +- [ ] 支付方式绑定（银行卡/信用卡/Apple Pay，需完成KYC L2） +- [ ] 可选：Pro模式切换入口（设置→高级→自托管模式，面向加密原生用户） + +**账户恢复（标准模式下极简）：** +> 标准模式用户的钱包由平台MPC托管，**不存在"私钥丢失"风险**。账户恢复与普通App一致。 +- [ ] 忘记密码：手机号/邮箱验证码重置 +- [ ] 换手机号：KYC身份验证（人脸+证件）后迁移账户 +- [ ] 账户冻结/封禁后申诉：客服工单 + 身份验证 + +**Pro模式用户（自托管）的额外恢复方案：** +- [ ] 助记词备份（切换Pro模式时强制提示） +- [ ] 社交恢复：预设3-5个可信联系人（Guardian），多数确认即可恢复 +- [ ] 账户抽象（AA钱包，ERC-4337）：邮箱/手机号作为恢复入口 **KYC分级制度：** | 等级 | 要求 | 权限 | |------|------|------| -| **L0（浏览）** | 仅钱包连接 | 浏览市场、查看行情，不可交易 | -| **L1（基础）** | 手机号 + 邮箱验证 | 小额交易（日限额X元）、持券上限Y张 | -| **L2（标准）** | 身份证/护照 + 人脸识别 | 正常交易、法币出入金 | +| **L0（浏览）** | 手机号/邮箱注册即可 | 浏览市场、查看行情，不可交易 | +| **L1（基础）** | 手机号 + 邮箱双重验证 | 小额交易（日限额X元）、持券上限Y张 | +| **L2（标准）** | 身份证/护照 + 人脸识别 | 正常交易、绑定支付方式、出入金 | | **L3（专业）** | 企业/机构认证 + 合规审查 | 大额交易、做市、发行 | > 不完成KYC不能交易。发行方必须达到L3。 -#### 3.6.2 个人中心（链上资产视图） -- [ ] 我的券库（链上钱包持有的数字券） -- [ ] 我的订单（链上/链下订单记录） -- [ ] 我的钱包（链上余额 + 法币余额） -- [ ] 交易历史（链上可验证） +#### 3.6.2 个人中心（用户友好视图，无区块链术语） + +| 用户界面展示 | 后台实际对应 | +|-------------|-------------| +| **我的券** | 链上钱包持有的ERC-721/1155代币 | +| **我的订单** | 链上交易记录 + 链下订单记录 | +| **我的余额** | 链上稳定币余额 + 法币账户余额 | +| **交易记录** | 链上交易哈希（用户看到的是"订单号"） | +| **转赠记录** | 链上P2P转移记录 | + +- [ ] 我的券（展示持有的券，含图片、面值、有效期、发行方） +- [ ] 我的订单（买入/卖出历史，状态追踪） +- [ ] 我的余额（统一展示，不区分链上/链下） +- [ ] 交易记录（用"订单号"代替"交易哈希"，Pro模式可查看链上详情） +- [ ] 转赠记录（显示"转赠给 138****1234"而非"转至 0x..."） #### 3.6.3 消息通知 - [ ] 交易状态通知 @@ -538,7 +571,7 @@ P = F × (1 - dt) × (1 - rc) | **交易手续费** | 二级市场每笔交易收取买卖双方手续费 | | **发行服务费** | 发行方在平台发行券时收取服务费 | | **增值服务** | 券推广置顶、数据分析报告、信用评级加速 | -| **方案A托管服务费** | 选择平台托管模式的企业收取托管服务费 | +| **Pro模式增值服务** | 自托管技术支持、高级API调用 | | **API/开发者服务** | 第三方接入API收取调用费 | --- @@ -582,7 +615,7 @@ P = F × (1 - dt) × (1 - rc) | 搜索 | Elasticsearch | | **区块链（核心）** | **Genex Chain**——Cosmos SDK + cosmos/evm（参考Cronos/dYdX v4） | | **智能合约** | Solidity（cosmos/evm模块）- 券发行、转移、兑付、合规合约 | -| **钱包集成** | WalletConnect / 内置MPC钱包 / AA钱包（ERC-4337） | +| **账户系统** | 手机号/邮箱注册 + 后台MPC托管钱包（默认）；WalletConnect / AA钱包（Pro模式） | #### 4.2.1 自建链：Genex Chain @@ -796,6 +829,85 @@ P = F × (1 - dt) × (1 - rc) - [ ] 年度DR演练：每年至少1次全量灾难恢复演练并记录 - [ ] BCP文档：灾难分级、响应流程、通知链、恢复步骤（SOX审计要求） +### 4.6 UX架构层：Web2体验 + Web3基础设施 + +> **核心设计理念：用户看到的是支付宝/Zelle，底层跑的是区块链。区块链是基础设施，不是用户界面。** + +#### 4.6.1 三层架构 + +``` +┌─────────────────────────────────────────────────────┐ +│ 用户层（Web2体验） │ +│ │ +│ 手机号/邮箱注册 我的券 我的余额 转赠给朋友 │ +│ 银行卡支付 订单记录 消息通知 客服中心 │ +│ │ +│ → 用户看到的一切与传统App完全一致，零学习成本 │ +├─────────────────────────────────────────────────────┤ +│ 翻译层（平台后端API） │ +│ │ +│ 手机号 → 链上地址映射 "转赠" → P2P链上转移 │ +│ "购买" → 合约调用+结算 "我的券" → 链上资产查询 │ +│ "订单号" → 交易哈希映射 "余额" → 链上代币余额查询 │ +│ MPC钱包管理 Gas代付（Paymaster） │ +│ │ +│ → 将所有Web3操作翻译为Web2用户可理解的概念 │ +├─────────────────────────────────────────────────────┤ +│ 基础设施层（Genex Chain） │ +│ │ +│ ERC-721/1155券合约 Settlement结算合约 │ +│ Compliance合规合约 CometBFT共识引擎 │ +│ P2P转移 链上记录不可篡改 │ +│ │ +│ → 提供安全、透明、不可篡改的底层保障 │ +└─────────────────────────────────────────────────────┘ +``` + +#### 4.6.2 翻译层核心功能 + +| 功能 | Web2用户操作 | 翻译层处理 | Web3实际执行 | +|------|------------|-----------|-------------| +| **注册** | 手机号/邮箱注册 | 创建MPC托管钱包，绑定映射 | 链上地址生成 | +| **购买券** | 点击"立即购买"，银行卡支付 | 法币→稳定币转换，调用合约 | Settlement合约原子交换 | +| **转赠** | 输入朋友手机号，点"转赠" | 手机号→地址解析，Gas代付 | 链上P2P转移（含合规路由） | +| **消费** | 出示券码/扫码核销 | 调用Redemption合约 | 合约清算+券销毁 | +| **查看余额** | 打开"我的余额" | 聚合链上+链下余额 | 查询链上代币余额 | +| **查看记录** | 打开"交易记录" | 交易哈希→订单号映射 | 读取链上事件日志 | + +- [ ] **手机号/邮箱→地址映射服务**：维护手机号↔链上地址的安全映射表（加密存储） +- [ ] **Gas代付服务（Paymaster）**：所有标准模式用户的链上操作Gas由平台代付，用户零感知 +- [ ] **法币↔稳定币自动转换**：用户用银行卡支付，后台自动完成法币→USDC→链上结算 +- [ ] **交易哈希→订单号映射**：用户看到可读的订单号（如GNX-20260209-001234），后台对应链上TX哈希 +- [ ] **推送通知翻译**：链上事件（Transfer、Redeem）翻译为用户友好的推送（"您的券已转赠成功"） + +#### 4.6.3 术语映射表（全平台执行） + +> **所有面向用户的界面（App、网站、邮件、客服话术）统一使用左列术语，禁止使用右列术语** + +| 用户界面术语 | 底层技术术语（仅内部/Pro模式可见） | +|-------------|-------------------------------| +| 我的账户 | 链上钱包地址 | +| 我的券 | ERC-721/1155 NFT资产 | +| 我的余额 | 链上稳定币（USDC）余额 | +| 转赠给朋友 | P2P链上转移（Transfer） | +| 购买 | 链上原子交换（Atomic Swap） | +| 核销/使用 | 合约兑付（Redemption） | +| 订单号 | 交易哈希（TX Hash） | +| 交易记录 | 链上事件日志（Event Log） | +| 平台积分 | GNX代币 | +| 支付 | 法币→稳定币→合约结算 | +| 安全验证 | 链上签名（由MPC钱包后台执行） | + +#### 4.6.4 Pro模式（加密原生用户） + +> Pro模式为熟悉区块链的用户提供完整的链上操作能力，但默认关闭 + +- [ ] 在"设置→高级"中开启Pro模式（需阅读并确认风险提示） +- [ ] Pro模式额外功能：查看链上地址、交易哈希、合约交互详情 +- [ ] Pro模式可切换至自托管钱包（WalletConnect） +- [ ] Pro模式可直接使用MetaMask等外部钱包操作 +- [ ] 标准模式与Pro模式可随时切换（自托管→平台托管需转移资产） + --- ## 5. 未来扩展需求（白皮书第八章） @@ -893,15 +1005,17 @@ P = F × (1 - dt) × (1 - rc) > **Phase 1只开放消费型券（Utility Track），不开放投资型券。完全规避SEC证券合规风险，仅需MSB + FTC消费者保护合规。** 1. Genex Chain主网上线（Cosmos SDK + cosmos/evm） -2. KYC分级认证（L1/L2/L3） -3. 发行方入驻与基础审核（零保证金，信用成长） -4. 消费型券发行与上架（链上铸造，Utility类型标记） -5. 一级市场购买 -6. 基础二级市场挂单/购买（价格上限=面值，不允许溢价） -7. 支付与清算（合约直接结算） -8. P2P转移（含Travel Rule合规路由） -9. 基础风控与AML（OFAC筛查、链级监控） -10. 基础客服与争议处理 +2. **手机号/邮箱注册系统**（后台自动创建MPC托管钱包，用户无感知） +3. **UX翻译层**（手机号→地址映射、Gas代付、订单号映射） +4. KYC分级认证（L0注册即可浏览，L1/L2/L3逐级开放交易权限） +5. 发行方入驻与基础审核（零保证金，信用成长） +6. 消费型券发行与上架（链上铸造，Utility类型标记） +7. 一级市场购买（银行卡/信用卡支付，后台自动转换为链上结算） +8. 基础二级市场挂单/购买（价格上限=面值，不允许溢价） +9. **手机号/邮箱P2P转赠**（含Travel Rule合规路由） +10. 支付与清算（合约直接结算） +11. 基础风控与AML（OFAC筛查、链级监控） +12. 基础客服与争议处理 ### Phase 2 - 体验优化 1. 智能定价建议 @@ -937,7 +1051,9 @@ P = F × (1 - dt) × (1 - rc) --- -## 9. 术语表（白皮书定义） +## 9. 术语表 + +### 9.1 金融术语（白皮书定义） | 术语 | 定义 | |------|------| @@ -947,9 +1063,26 @@ P = F × (1 - dt) × (1 - rc) | 信用利差 | 基于发行方信用风险的额外折价 | | 递延负债 | 发行方发行券形成的预收账款 | +### 9.2 技术术语映射（内部↔用户界面） + +> 详见4.6.3完整术语映射表。以下为关键术语对照。 + +| 内部/技术术语 | 用户界面术语 | 说明 | +|-------------|------------|------| +| 链上钱包（Wallet） | 我的账户 | 用户不知道钱包的存在 | +| MPC托管钱包 | （后台，不展示） | 平台自动创建并管理 | +| ERC-721/1155代币 | 我的券 | 用户看到的是券的图片和信息 | +| P2P Transfer | 转赠给朋友 | 用户输入手机号即可转赠 | +| TX Hash | 订单号 | 如GNX-20260209-001234 | +| Gas Fee | （后台，不展示） | 平台代付，用户零感知 | +| 稳定币（USDC） | 余额（美元） | 用户看到法币金额 | +| Atomic Swap | 购买/交易 | 链上原子交换对用户透明 | +| 标准模式 | 默认模式 | 99%用户，平台托管，Web2体验 | +| Pro模式 | 高级模式 | 加密原生用户，自托管，链上可见 | + --- -*文档版本: v3.6* +*文档版本: v3.7* *生成日期: 2026-02-09* *来源: 券的金融本质与短期资金募集机制白皮书 (draft v0.1)* -*更新: 券类型防火墙（1.6，Utility/Securities双轨制），P2P合规路由架构（4.3.4），MVP Phase 1仅Utility Track* +*更新: Web2 UX + Web3基础设施重构——平台托管为默认（3.4.1），手机号/邮箱注册优先（3.6），UX三层架构（4.6），术语映射表（9.2）* diff --git a/docs/券金融平台-软件需求规格.pdf b/docs/券金融平台-软件需求规格.pdf index 0924792..c60cdc5 100644 Binary files a/docs/券金融平台-软件需求规格.pdf and b/docs/券金融平台-软件需求规格.pdf differ