Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/togettoyou/fabric-realty
🤹 基于区块链（Hyperledger Fabric 联盟链）的房地产交易系统，全网最新、最易上手、最适合入门的实战项目，完整实现多组织架构、智能合约、身份认证与交易上链，部署简单，仅依赖 Docker，一条命令即可启动！
https://github.com/togettoyou/fabric-realty
blockchain fabric fabric-gateway hyperledger hyperledger-fabric hyperledger-fabric-network
Last synced: 1 day ago
JSON representation
🤹 基于区块链（Hyperledger Fabric 联盟链）的房地产交易系统，全网最新、最易上手、最适合入门的实战项目，完整实现多组织架构、智能合约、身份认证与交易上链，部署简单，仅依赖 Docker，一条命令即可启动！
- Host: GitHub
- URL: https://github.com/togettoyou/fabric-realty
- Owner: togettoyou
- License: mit
- Created: 2020-03-08T18:02:11.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2025-01-30T17:21:08.000Z (9 days ago)
- Last Synced: 2025-01-31T16:03:55.136Z (8 days ago)
- Topics: blockchain, fabric, fabric-gateway, hyperledger, hyperledger-fabric, hyperledger-fabric-network
- Language: Go
- Homepage:
- Size: 265 MB
- Stars: 750
- Watchers: 15
- Forks: 189
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 基于 Hyperledger Fabric 的房地产交易系统
本项目是一个基于 Hyperledger Fabric 的房地产交易系统，实现了房产登记和交易的业务流程。
系统采用联盟链技术，由不动产登记机构、交易平台和银行三个组织共同维护。
> 🎓 提供项目教学及问题解答服务，欢迎通过以下方式联系：
👆 扫码或搜索关注公众号：**gopher云原生**
## 快速部署
### 环境要求
- Docker
- Docker Compose
### 部署步骤
1. 拉取项目并设置权限
```bash
git clone --depth 1 https://github.com/togettoyou/fabric-realty.git && cd fabric-realty && find . -name "*.sh" -exec chmod +x {} \;
```
2. 一键部署
```bash
./install.sh
```
3. 一键卸载
```bash
./uninstall.sh
```
### 访问服务
http://localhost:8000
### 系统演示
系统包含三个组织身份，每个组织都有独立的操作界面和权限
#### 业务操作流程
1. 房产登记上链
- 不动产登记机构登录系统
- 点击"登记新房产"，填写房产信息
- 提交后，房产信息将上链保存
2. 发起房产交易
- 交易平台登录系统
- 点击"生成新交易"，填写交易信息
- 提交后，交易信息将上链保存
3. 银行确认交易
- 银行登录系统
- 核实双方交易信息和资金状态
- 点击"完成交易"，完成交易
- 交易完成后，房产所有权将自动变更
4. 区块链浏览
- 所有组织都可以查看区块信息
- 确保信息公开透明且不可篡改
> 💡 系统特点：
> - 基于区块链的分布式账本，确保数据不可篡改
> - 基于智能合约的权限控制，确保操作安全可控
> - 每个组织只能执行自己权限范围内的操作
> - 所有操作都会记录在区块链上，可追溯、可审计
## 系统架构
### 网络架构（Network）
系统由三个组织构成的联盟链网络：
1. 不动产登记机构（Org1）
- 负责房产信息的登记
- 维护两个 Peer 节点：peer0.org1 和 peer1.org1
2. 银行（Org2）
- 负责交易的完成确认
- 维护两个 Peer 节点：peer0.org2 和 peer1.org2
3. 交易平台（Org3）
- 负责生成交易信息
- 维护两个 Peer 节点：peer0.org3 和 peer1.org3
### 智能合约（Chaincode）
智能合约实现了以下核心功能：
1. 房产信息管理
- 创建房产（仅不动产登记机构可操作）
- 查询房产信息
- 分页查询房产列表
2. 交易管理
- 生成交易（仅交易平台可操作）
- 完成交易（仅银行可操作）
- 查询交易信息
- 分页查询交易列表
### 应用服务器（Application）
API 接口设计：
```
/api/realty-agency
POST /realty/create # 创建房产信息
GET /realty/:id # 查询房产信息
GET /realty/list # 分页查询房产列表
- pageSize: 每页记录数
- bookmark: 分页标记
- status: 房产状态（可选，NORMAL-正常、IN_TRANSACTION-交易中）
GET /block/list # 分页查询区块列表
- pageSize: 每页记录数，默认10
- pageNum: 页码，默认1
/api/trading-platform
POST /transaction/create # 生成交易
GET /realty/:id # 查询房产信息
GET /transaction/:txId # 查询交易信息
GET /transaction/list # 分页查询交易列表
- pageSize: 每页记录数
- bookmark: 分页标记
- status: 交易状态（可选，PENDING-待付款、COMPLETED-已完成）
GET /block/list # 分页查询区块列表
- pageSize: 每页记录数，默认10
- pageNum: 页码，默认1
/api/bank
POST /transaction/complete/:txId # 完成交易
GET /transaction/:txId # 查询交易信息
GET /transaction/list # 分页查询交易列表
- pageSize: 每页记录数
- bookmark: 分页标记
- status: 交易状态（可选，PENDING-待付款、COMPLETED-已完成）
GET /block/list # 分页查询区块列表
- pageSize: 每页记录数，默认10
- pageNum: 页码，默认1
```
## 技术栈功能说明
### 区块链层
- Hyperledger Fabric v2.5.10
- 分布式账本存储房产和交易数据
- 智能合约实现业务逻辑和权限控制
- 多组织（不动产登记机构、银行、交易平台）的联盟链网络
### 后端（Go）
- Gin v1.10.0
- RESTful API 接口框架
- fabric-gateway v1.7.0
- 提供区块链网络交互接口
- 处理链码调用和查询
- fabric-protos-go-apiv2 v0.3.4
- 处理区块链数据的序列化和反序列化
- 提供区块链交互的协议支持
### 前端（Vue）
- Vue v3.3.8
- 前端主框架
- 响应式数据处理
- TypeScript v5.0.2
- 类型检查
- 代码提示和重构支持
- Vite v4.5.0
- 开发服务器
- 构建工具
- Ant Design Vue v3.2.20
- UI 组件库
- 提供完整的设计体系