| 特性 | 说明 |
|---|---|
| 🆔 DID身份系统 | W3C标准去中心化身份，用户完全掌控数字身份 |
| 📜 可验证凭证VC | 密码学证明的身份属性，一次认证多平台复用 |
| 💳 跨境支付 | 多币种钱包、实时汇率、合规风控 |
| ✅ KYC自动合规 | 身份认证通过后自动签发VC，无缝衔接 |
| 🔐 多元登录 | 账密、OAuth、零知识证明多种认证方式 |
| 层面 | 技术 |
|---|---|
| Backend | Java 17 / Spring Boot 3.4 |
| Frontend | Vue 3.5 / Vite / Pinia |
| Database | MySQL 8.0 / Redis 7.0 |
| Deploy | Docker Compose / Swagger UI |
ChainPass 是一个基于区块链技术的跨境数字身份与合规支付解决方案，为大创项目"基于区块链的跨境数字身份与合规支付解决方案"的核心实现。
| 模块 | 功能 | 状态 |
|---|---|---|
| 🆔 DID系统 | 去中心化身份创建、验证、管理 | ✅ 已完成 |
| 📜 可验证凭证 | VC签发、验证、吊销 | ✅ 已完成 |
| 💳 跨境支付 | 多币种钱包、模拟支付、汇率转换 | ✅ 已完成 |
| ✅ KYC认证 | 身份认证、自动审批、VC发放 | ✅ 已完成 |
| 🔐 多种登录 | 账密、OAuth、ZKP零知识证明 | ✅ 已完成 |
┌────────────────────────────────────────────────────────────────┐
│ 用户界面层 │
│ Vue 3 Web App │ Mobile App (预留) │ 开放API │
├────────────────────────────────────────────────────────────────┤
│ 服务层 │
│ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ │
│ │ DID服务 │ │ VC服务 │ │ 支付服务 │ │ KYC服务 │ │
│ │ 创建/验证 │ │ 签发/验证 │ │ 钱包/跨境 │ │ 认证/审核 │ │
│ └───────────┘ └───────────┘ └───────────┘ └───────────┘ │
├────────────────────────────────────────────────────────────────┤
│ 数据层 │
│ MySQL 8.0 │ Redis 7.0 │ 模拟区块链 │
└────────────────────────────────────────────────────────────────┘
| 工具 | 版本 | 说明 |
|---|---|---|
| Java | 17+ | JDK 17 LTS |
| Node.js | 20+ | 前端运行环境 |
| pnpm | 9+ | 包管理器 |
| Docker | 20+ | 容器化部署 |
| MySQL | 8.0+ | 数据库 |
| Redis | 7.0+ | 缓存 |
# 1. 克隆项目
git clone [repository-url]
cd chainpass
# 2. 启动基础设施（MySQL + Redis）
docker-compose -f docker/docker-compose.yml up -d
# 3. 初始化数据库
mysql -u root -p < docker/mysql/init-v2.sql
# 4. 启动后端
cd apps/server
mvn spring-boot:run
# 5. 启动前端（新终端）
cd apps/web
pnpm install
pnpm dev| 服务 | 地址 |
|---|---|
| 前端应用 | http://localhost:5173 |
| 后端API | http://localhost:8080 |
| Swagger文档 | http://localhost:8080/swagger-ui.html |
| 默认账号 | admin / admin123 |
# 创建DID
POST /did/create
# 验证DID签名
POST /did/verify
# 获取我的DID
GET /did/my# 签发凭证
POST /vc/issue
# 验证凭证
POST /vc/verify
# 获取凭证列表
GET /vc/my# 获取钱包
GET /payment/wallet
# 创建支付订单
POST /payment/create
# 执行支付
POST /payment/execute/{orderNo}# 提交KYC认证
POST /kyc/submit
# 获取认证状态
GET /kyc/status完整API文档请访问 Swagger UI：http://localhost:8080/swagger-ui.html
chainpass/
├── apps/
│ ├── web/ # Vue 3 前端
│ │ ├── src/
│ │ │ ├── api/ # API请求模块
│ │ │ ├── components/ # 组件
│ │ │ ├── router/ # 路由配置
│ │ │ ├── stores/ # Pinia状态管理
│ │ │ └── views/ # 页面视图
│ │ └── package.json
│ │
│ └── server/ # Spring Boot 后端
│ ├── src/main/java/com/chainpass/
│ │ ├── did/ # DID去中心化身份
│ │ │ ├── controller/
│ │ │ ├── service/
│ │ │ └── entity/
│ │ ├── vc/ # 可验证凭证
│ │ ├── payment/ # 跨境支付
│ │ ├── compliance/ # 合规系统(KYC)
│ │ ├── config/ # 配置类
│ │ └── util/ # 工具类
│ └── pom.xml
│
├── docker/
│ ├── docker-compose.yml # 开发环境编排
│ └── mysql/
│ └── init-v2.sql # 数据库初始化
│
├── docs/
│ ├── PROJECT_GUIDE.md # 项目使用指南
│ ├── API_DOCUMENTATION.md # API文档
│ ├── SECURITY_GUIDE.md # 安全配置指南
│ ├── INNOVATION_PROJECT.md # 大创项目材料
│ └── PITCH_DECK_OUTLINE.md # 路演PPT大纲
│
├── scripts/
│ ├── generate-secrets.sh # 密钥生成脚本
│ └── generate-ssl.sh # SSL证书生成
│
└── README.md
# 运行后端测试
cd apps/server
mvn test
# 运行前端测试
cd apps/web
pnpm test生产环境部署请参考 安全配置指南：
- JWT密钥: 使用强密钥（≥64字符）
- 数据库密码: 使用强密码，专用账户
- Redis密码: 生产环境必须设置
- HTTPS: 配置SSL证书
- OAuth: 配置真实的Gitee应用
| 文档 | 说明 |
|---|---|
| 项目指南 | 完整项目使用说明 |
| API文档 | REST API接口文档 |
| 安全配置 | 生产环境安全配置 |
| 大创材料 | 项目计划书、商业分析 |
| 路演大纲 | 答辩PPT结构 |
- W3C DID标准: 采用国际标准的去中心化身份
- 可验证凭证: 密码学证明的身份属性，一次认证多平台使用
- 零知识证明: Ed25519签名验证，隐私保护
- 跨境支付: 多币种支持，汇率转换，合规风控
- 自动化合规: KYC认证通过自动签发VC凭证
- 项目地址: [GitHub链接]
- 问题反馈: [Issues]
- 邮箱: team@chainpass.io
MIT License
Copyright (c) 2024 ChainPass Team
Made with ❤️ by ChainPass Team
Made with ❤️ by ChainPass Team