https://github.com/TheyCallMeErick/TCC-Blockchain-Licitacoes
Este é o trabalho de conclusão de curso de Sistemas de Informação na Universidade Estadual do Tocantins (UNITINS), e tem como objetivo a criação de uma rede blockchain privada, permissionada e gas free com Hyperledger Besu, para a realização de licitações públicas.
https://github.com/TheyCallMeErick/TCC-Blockchain-Licitacoes
besu blockchain csharp etherium ipfs
Last synced: 16 days ago
JSON representation
Este é o trabalho de conclusão de curso de Sistemas de Informação na Universidade Estadual do Tocantins (UNITINS), e tem como objetivo a criação de uma rede blockchain privada, permissionada e gas free com Hyperledger Besu, para a realização de licitações públicas.
- Host: GitHub
- URL: https://github.com/TheyCallMeErick/TCC-Blockchain-Licitacoes
- Owner: Azevedo-Erick
- Created: 2024-03-31T02:45:26.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-11T02:24:42.000Z (11 months ago)
- Last Synced: 2025-01-14T11:59:57.506Z (9 months ago)
- Topics: besu, blockchain, csharp, etherium, ipfs
- Language: TypeScript
- Homepage:
- Size: 764 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# TCC - Blockchain Licitações
Trabalho de Conclusão de Curso voltado para a criação de uma solução baseada em **blockchain permissionada e sem custos de transação** para a realização de **licitações públicas**, utilizando tecnologias modernas como **Hyperledger Besu**, **AdonisJS 6**, **IPFS** e contratos inteligentes em **Solidity**.
## Tecnologias
- **Hyperledger Besu** (Blockchain permissionada)
- **AdonisJS 6** (API backend com autenticação moderna e suporte a tokens)
- **Docker** e **Docker Compose**
- **IPFS** (Armazenamento descentralizado de documentos)
- **PostgreSQL** (Banco de dados relacional)
- **React.js** (Frontend - em desenvolvimento)
## Requisitos
- Docker & Docker Compose
- Node.js (>=18)
- NPM
- Git
## Autores
- [@azevedo-erick](https://github.com/azevedo-erick)
## Roadmap
### 🛠️ Implementação
- [x] Rede blockchain permissionada com **Besu** e consenso **IBFT 2.0**
- [x] Comunicação entre API e blockchain via **web3.js**
- [x] Armazenamento de documentos no **IPFS** com hash salvo na blockchain
- [x] Contratos inteligentes escritos em **Solidity** e testados com **Hardhat**
- [x] Autenticação JWT com **AdonisJS 6** e gerenciamento de tokens (OAT)
- [x] Estruturar API com **Lucid ORM**, **Service Layer** e **middlewares**
- [ ] Controle de permissões por papel (admin, candidato, visitante)
- [ ] Frontend com **React.js** para interação com a API e acompanhamento das licitações
- [X] Testes de integração e unitários
- [X] Ambiente de testes separado
### 📚 Documentação e Artefatos
- [x] Arquitetura do Sistema
- [x] Casos de Uso
- [x] Diagrama de Classes
- [ ] Diagrama de Atividades
- [ ] Diagrama ER
- [ ] Protótipos de Tela
- [ ] Cronograma consolidado (TCC1 + TCC2)
## 🚀 Executando Localmente
1. Clone o projeto:
```bash
git clone https://github.com/azevedo-erick/blockchain-licitacoes.git
cd blockchain-licitacoes
```
2. Execute o script de inicialização:
```bash
./init.sh
```
3. Inicie os nós da rede:
```bash
cd Node-1 && ./start_besu.sh
cd ../Node-2 && ./start_besu.sh
cd ../Node-3 && ./start_besu.sh
cd ../Node-4 && ./start_besu.sh
```
4. Copie os enodes e adicione ao `add_enodes.sh`, depois execute:
```bash
./add_enodes.sh
```
> ℹ️ Dicas de Comando:
>
> Adicionar conta autorizada:
> ```bash
> curl -X POST --data '{"jsonrpc":"2.0","method":"perm_addAccountsToWhitelist","params":[["0x"]],"id":1}' http://localhost:8545
> ```
>
> Verificar lista de contas autorizadas:
> ```bash
> curl -X POST --data '{"jsonrpc":"2.0","method":"perm_getAccountsWhitelist","params":[],"id":1}' http://localhost:8545
> ```
>
> Verificar conexões entre nós:
> ```bash
> curl -X POST --data '{"jsonrpc":"2.0","method":"net_peerCount","params":[],"id":1}' http://localhost:8545
> ```
## 🔧 Deploy dos Contratos Inteligentes
```bash
cd contracts
npm install
npx hardhat compile
```
Configure `hardhat.config.ts` com:
```ts
networks: {
besuPrivate: {
url: 'http://localhost:8545',
accounts: ['0x']
}
}
```
Deploy:
```bash
npx hardhat ignition deploy ./ignition/modules/.ts --network besuPrivate
```
## 📄 Documentação
- [Contratos Inteligentes](docs/contracts.md)
- [Diagramas](docs/diagrams.md)
- [Scripts de Execução](docs/scripts.md)
- [Configuração do Projeto](docs/configuration.md)