{"id":15152923,"url":"https://github.com/TheyCallMeErick/TCC-Blockchain-Licitacoes","last_synced_at":"2025-10-01T17:30:58.988Z","repository":{"id":230802088,"uuid":"779874028","full_name":"Azevedo-Erick/TCC-Blockchain-Licitacoes","owner":"Azevedo-Erick","description":"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.","archived":false,"fork":false,"pushed_at":"2024-11-11T02:24:42.000Z","size":782,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-14T11:59:57.506Z","etag":null,"topics":["besu","blockchain","csharp","etherium","ipfs"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Azevedo-Erick.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-03-31T02:45:26.000Z","updated_at":"2024-11-11T02:24:46.000Z","dependencies_parsed_at":"2024-04-08T20:04:02.997Z","dependency_job_id":"73f674a1-2a63-4ce0-8209-1628724b53da","html_url":"https://github.com/Azevedo-Erick/TCC-Blockchain-Licitacoes","commit_stats":{"total_commits":12,"total_committers":2,"mean_commits":6.0,"dds":0.5,"last_synced_commit":"c5a0b571647b8de521606358f00da52069c05e6e"},"previous_names":["azevedo-erick/tcc-blockchain-licitacoes"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Azevedo-Erick%2FTCC-Blockchain-Licitacoes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Azevedo-Erick%2FTCC-Blockchain-Licitacoes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Azevedo-Erick%2FTCC-Blockchain-Licitacoes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Azevedo-Erick%2FTCC-Blockchain-Licitacoes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Azevedo-Erick","download_url":"https://codeload.github.com/Azevedo-Erick/TCC-Blockchain-Licitacoes/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234883310,"owners_count":18901366,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["besu","blockchain","csharp","etherium","ipfs"],"created_at":"2024-09-26T16:41:52.308Z","updated_at":"2025-10-01T17:30:58.981Z","avatar_url":"https://github.com/Azevedo-Erick.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TCC - Blockchain Licitações\n\nTrabalho 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**.\n\n## Tecnologias\n\u003cp \u003e\n   \u003cimg src=\"https://img.shields.io/badge/Hyperledger%20Besu-363636?style=for-the-badge\u0026logo=hyperledger\u0026logoWidth=30\" alt=\"Hyperledger Besu\" height=\"30\"/\u003e\n\u003cimg src=\"https://img.shields.io/badge/Solidity-363636?style=for-the-badge\u0026logo=solidity\u0026logoWidth=30\" alt=\"Solidity\" height=\"30\"/\u003e\n\u003cimg src=\"https://img.shields.io/badge/TypeScript-3178C6?style=for-the-badge\u0026logo=typescript\u0026logoColor=white\u0026logoWidth=30\" alt=\"TypeScript\" height=\"30\"/\u003e\n\u003cimg src=\"https://img.shields.io/badge/AdonisJS-5A45FF?style=for-the-badge\u0026logo=adonisjs\u0026logoColor=white\u0026logoWidth=30\" alt=\"AdonisJS\" height=\"30\"/\u003e\n\u003cimg src=\"https://img.shields.io/badge/Docker-2496ED?style=for-the-badge\u0026logo=docker\u0026logoColor=white\u0026logoWidth=30\" alt=\"Docker\" height=\"30\"/\u003e\n\u003cimg src=\"https://img.shields.io/badge/IPFS-65C2CB?style=for-the-badge\u0026logo=ipfs\u0026logoColor=black\u0026logoWidth=30\" alt=\"IPFS\" height=\"30\"/\u003e\n\u003cimg src=\"https://img.shields.io/badge/PostgreSQL-4169E1?style=for-the-badge\u0026logo=postgresql\u0026logoColor=white\u0026logoWidth=30\" alt=\"PostgreSQL\" height=\"30\"/\u003e\n\n\u003c/p\u003e\n\n- **Hyperledger Besu** (Blockchain permissionada)\n- **AdonisJS 6** (API backend com autenticação moderna e suporte a tokens)\n- **Docker** e **Docker Compose**\n- **IPFS** (Armazenamento descentralizado de documentos)\n- **PostgreSQL** (Banco de dados relacional)\n- **React.js** (Frontend - em desenvolvimento)\n\n## Requisitos\n\n- Docker \u0026 Docker Compose\n- Node.js (\u003e=18)\n- NPM\n- Git\n\n## Autores\n\n- [@azevedo-erick](https://github.com/azevedo-erick)\n\n## Roadmap\n\n### 🛠️ Implementação\n\n- [x] Rede blockchain permissionada com **Besu** e consenso **IBFT 2.0**\n- [x] Comunicação entre API e blockchain via **web3.js**\n- [x] Armazenamento de documentos no **IPFS** com hash salvo na blockchain\n- [x] Contratos inteligentes escritos em **Solidity** e testados com **Hardhat**\n- [x] Autenticação JWT com **AdonisJS 6** e gerenciamento de tokens (OAT)\n- [x] Estruturar API com **Lucid ORM**, **Service Layer** e **middlewares**\n- [ ] Controle de permissões por papel (admin, candidato, visitante)\n- [ ] Frontend com **React.js** para interação com a API e acompanhamento das licitações\n- [X] Testes de integração e unitários\n- [X] Ambiente de testes separado\n \n### 📚 Documentação e Artefatos\n\n- [x] Arquitetura do Sistema\n- [x] Casos de Uso\n- [x] Diagrama de Classes\n- [ ] Diagrama de Atividades\n- [ ] Diagrama ER\n- [ ] Protótipos de Tela\n- [ ] Cronograma consolidado (TCC1 + TCC2)\n\n## 🚀 Executando Localmente\n\n1. Clone o projeto:\n```bash\ngit clone https://github.com/azevedo-erick/blockchain-licitacoes.git\ncd blockchain-licitacoes\n```\n\n2. Execute o script de inicialização:\n```bash\n./init.sh\n```\n\n3. Inicie os nós da rede:\n```bash\ncd Node-1 \u0026\u0026 ./start_besu.sh\ncd ../Node-2 \u0026\u0026 ./start_besu.sh\ncd ../Node-3 \u0026\u0026 ./start_besu.sh\ncd ../Node-4 \u0026\u0026 ./start_besu.sh\n```\n\n4. Copie os enodes e adicione ao `add_enodes.sh`, depois execute:\n```bash\n./add_enodes.sh\n```\n\n\u003e ℹ️ Dicas de Comando:\n\u003e \n\u003e Adicionar conta autorizada:\n\u003e ```bash\n\u003e curl -X POST --data '{\"jsonrpc\":\"2.0\",\"method\":\"perm_addAccountsToWhitelist\",\"params\":[[\"0x\u003cendereco\u003e\"]],\"id\":1}' http://localhost:8545\n\u003e ```\n\u003e\n\u003e Verificar lista de contas autorizadas:\n\u003e ```bash\n\u003e curl -X POST --data '{\"jsonrpc\":\"2.0\",\"method\":\"perm_getAccountsWhitelist\",\"params\":[],\"id\":1}' http://localhost:8545\n\u003e ```\n\u003e\n\u003e Verificar conexões entre nós:\n\u003e ```bash\n\u003e curl -X POST --data '{\"jsonrpc\":\"2.0\",\"method\":\"net_peerCount\",\"params\":[],\"id\":1}' http://localhost:8545\n\u003e ```\n\n## 🔧 Deploy dos Contratos Inteligentes\n\n```bash\ncd contracts\nnpm install\nnpx hardhat compile\n```\n\nConfigure `hardhat.config.ts` com:\n```ts\nnetworks: {\n  besuPrivate: {\n    url: 'http://localhost:8545',\n    accounts: ['0x\u003cchave_privada\u003e']\n  }\n}\n```\n\nDeploy:\n```bash\nnpx hardhat ignition deploy ./ignition/modules/\u003cContrato\u003e.ts --network besuPrivate\n```\n\n## 📄 Documentação\n\n- [Contratos Inteligentes](docs/contracts.md)\n- [Diagramas](docs/diagrams.md)\n- [Scripts de Execução](docs/scripts.md)\n- [Configuração do Projeto](docs/configuration.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTheyCallMeErick%2FTCC-Blockchain-Licitacoes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FTheyCallMeErick%2FTCC-Blockchain-Licitacoes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTheyCallMeErick%2FTCC-Blockchain-Licitacoes/lists"}