Blockchain-Based Real Estate Management

This system leverages blockchain technology for real estate management using the ERC721 and ERC4907 protocols, and tokenization for NFTs as registration and cadastral modifications.

The goal is to implement a property registration management system using modern technologies. The back-end is developed in Solidity along with Ethers, Hardhat, TypeScript, and Solidity compilers.

For the front-end, various methodologies were applied, such as a well-defined and decoupled architecture using TDD (Test-Driven Development) as a work methodology, Clean Architecture to distribute responsibilities across layers, always following SOLID, DRY, YAGNI, and KISS principles and applying Design Patterns to solve common problems.

Index

• About
• Applied Methodologies
• Technologies Used
• How to run the project

🔖  How It Works?

BlockImobGov is a regularity consultation platform based on oracles, registration, and management of government properties registered on the blockchain. It allows users to invest and track their contracts with the government.

How it works:

• REGISTRATION: List of addresses registered on the blockchain and implementation of government multisig. Creation of NFTs (Non-Fungible Tokens) defining registered properties by authorized entities. Management is public and auditable.
• CONSULTATION: Verification of the regularity and data of properties, validated through government oracles to ensure data authenticity. Request for map verification regarding the geolocation of rural properties.
• SALE AND LEASE: After confirmation of the property's regularity, they will be eligible for sale or lease. All transactions will be conducted in cReal (Celo blockchain cryptocurrency backed by the Brazilian Real). The lease period will be defined in the contract, including tax deductions.
• TOKENIZED REIT: Once all properties are registered and regularized on the blockchain, the system will enable the tokenization of real estate funds with all property data and categorization.

BlockImobGov Accelerating Government Real Estate Transactions!

---

㊎ Applied Methodologies

• TDD
• Clean Architecture
• DDD
• Reactive Programming
• Responsive Layout
• Conventional Commits
• GitFlow
• Modular Design
• Dependency Diagrams
• Use Cases
• Continuous Integration
• Continuous Delivery
• Continuous Deployment

📚 Principles

• Single Responsibility Principle (SRP)
• Open Closed Principle (OCP)
• Liskov Substitution Principle (LSP)
• Interface Segregation Principle (ISP)
• Dependency Inversion Principle (DIP)
• Separation of Concerns (SOC)
• Don't Repeat Yourself (DRY)
• You Aren't Gonna Need It (YAGNI)
• Keep It Simple, Silly (KISS)
• Composition Over Inheritance
• Small Commits

㌥ Design Patterns

• Factory
• Adapter
• Composite
• Decorator
• Dependency Injection
• Composition Root
• Builder
• Proxy

🚀 Technologies Used

• Typescript
• React
• React Testing Library
• React Router DOM
• Vitest
• Git
• Styled-Components
• Yarn
• Coveralls
• Husky
• Lint Staged
• Eslint
• Celo Blockchain

---

🗂 How to Run the Client (Front-End)

    # Clone the repository
    $ git clone https://github.com/renancorreadev/blockchainImob.git

    # Enter the directory
    $ cd frontend

    # Install dependencies
    $ yarn install

    # Start the project
    $ yarn dev

---

🗂 How to Compile Contracts and Deploy (Back-End)

    # Clone the repository
    $ git clone https://github.com/renancorreadev/blockchainImob.git

    # Enter the directory
    $ cd backend

    # Install dependencies
    $ yarn install

    # Compile the project
    $ yarn compile

    # Deploy contracts
    $ yarn deploy

    # Verify contracts
    $ yarn verify

---

Developed by Renan César