README

Clean Architeture com Delphi

🚀 Sobre o projeto

Este projeto foi desenvolvido durante o curso Aplicando clean architecture com Delphi, que tem como objetivo aplicar de forma prática os princípios da Arquitetura Limpa utilizando a linguagem de programação Delphi.

📑 Tabela de conteúdos

• Clean Architeture com Delphi
  • 🚀 Sobre o projeto
  • 📑 Tabela de conteúdos
  • 💥 Funcionalidades
  • 🛠️ Tecnologias
    • Liguagem de programação e IDE
    • Construção da API
    • Implementação dos testes
    • Banco de Dados
    • Versionamento
  • ⚙️ Configurando o projeto

💥 Funcionalidades

Trata-se de um projeto que busca representar o domínio de um sistema de Locação de Veículos, onde o usuário pode cadastrar Clientes, Veículos e Locações.

O projeto é composto de duas aplicações, uma console e outra uma API desenvolvida com Horse.

Contudo, ambas as aplicações consome um mesmo "Core", através da aplicações dos princípios da Arquitetura Limpa.

Existe também uma aplicação para testar de forma simples as principais classes do "Core".

🛠️ Tecnologias

As seguintes ferramentas foram utilizadas na construção do projeto:

Liguagem de programação e IDE

• Delphi 11.3 Alexandria Community.
• MMX (Ferramenta com atalhos pra acelerar o desenvolvimento no Delphi).

Construção da API

• Horse.
• Postman (utilizada para teste das rotas).

Implementação dos testes

• DUnitX.
• TestInsight (ferramenta para visualização gráfica dos resultados de testes).

Banco de Dados

• Firebird 2.5.
• IBExpert Personal Edition.

Versionamento

• Git.
• Github.
• Github Desktop.

⚙️ Configurando o projeto

Instala????o e Configura????o do Delphi

1. Acesse o site oficial da Embarcadero.
2. Crie uma conta.
3. Faça o download da última versão disponível do Delphi Community.
4. Relize a instalação e registre o produto.
5. Faça download do wizard e instale o Horse.
6. Faça download do wizard e instale o MMX.
7. Faça download do wizard e instale o TestInsight.
   pascalCopy

   Instala????o do Postman

8. Baixe o Postman pelo site oficial.
9. Poderá ser necessário criar uma conta.
10. Instale e configure o Postman no computador.
    pascalCopy

    Configura????o do Banco de Dados

11. Faça download da versão 2.5 do Firebird no site oficial.
12. Instale o Firebird em sua máquina.
13. Também faça a instalação de alguma ferramenta de interface gráfica para administração de bancos Firebird, como o IBExpert na versão gratuita.
14. Acesse o arquivo de Aliases do Firebird, geralmente localizado em C:\Program Files\Firebird\Firebird_2_5\aliases.conf, e configure uma banco com o alias LOCACAO.
    pascalCopy

    Clonando e Configurando o Projeto

15. Clone o projeto executando o seguinte comando no terminal:

git clone https://github.com/SauloJCF/clean-architeture-delphi.git

2. Execute o arquivo .\clean-architeture-delphi\Script\create-database.sql no IBExpert (ou qualquer outra ferramenta de gerenciamento de banco de dados de preferência), para criar o banco de dados.
3. Importe o arquivo .\clean-architeture-delphi\Postman\clean-architeture-delphi.postman_collection.json no Postman.
4. Abra o arquivo \clean-architeture-delphi\Applications\GroupLocacao.groupproj com Delphi (File >> Open Project).
5. Execute o projeto LocacaoConsole, para abrir a aplicação console.
6. Execute o projeto LocacaoAPI, para iniciar a API.
7. Execute o projeto LocacaoTeste para rodar os testes do projeto.