基于 Hyperledger Fabric 的房地产交易系统

本项目是一个基于 Hyperledger Fabric 的房地产交易系统，实现了房产登记和交易的业务流程。

系统采用联盟链技术，由不动产登记机构、交易平台和银行三个组织共同维护。

🎓 提供项目教学及问题解答服务，欢迎通过以下方式联系：

👆 扫码或搜索关注公众号：gopher云原生

快速部署

环境要求

• Docker
• Docker Compose

部署步骤

1. 拉取项目并设置权限

   git clone --depth 1 https://github.com/togettoyou/fabric-realty.git && cd fabric-realty && find . -name "*.sh" -exec chmod +x {} \;

2. 一键部署

   ./install.sh

3. 一键卸载

   ./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 组件库
  • 提供完整的设计体系