Skip to content

Latest commit

 

History

History
45 lines (38 loc) · 2.86 KB

README.md

File metadata and controls

45 lines (38 loc) · 2.86 KB
Raw

Crud de veículos

Descrição

Crud de veículos com o Laravel 9 com o Breeze e TailwindCSS, utilizando o Sail para rodar o projeto em um container Docker.

Instalação

  • O único pré-requisito é ter o Docker instalado.
  • Após isso é só seguir os passos abaixo:
    • Clone o repositório
    • Rode o comando a seguir para instalar as dependências do projeto e o Sail: 
      docker run --rm \
    -u "$(id -u):$(id -g)" \
    -v "$(pwd):/var/www/html" \
    -w /var/www/html \
    laravelsail/php81-composer:latest \
    composer install --ignore-platform-reqs
    • Copie o arquivo .env.example para .env, pode utilizar o comando cp .env.example .env para tal.
    • Rode o comando ./vendor/bin/sail up -d para subir o container
    • Rode o comando ./vendor/bin/sail artisan key:generate para gerar a chave da aplicação
    • Rode o comando ./vendor/bin/sail artisan migrate para criar as tabelas
    • Rode o comando ./vendor/bin/sail artisan db:seed para popular as tabelas
    • Rode o comando ./vendor/bin/sail npm install para instalar as dependências do Node
    • Rode o comando ./vendor/bin/sail npm run dev para compilar os assets
    • Após isso o projeto estará pronto para ser acessado em http://localhost
    • Para parar o container basta rodar o comando ./vendor/bin/sail down

Acesso

  • Acesse http://localhost para acessar o projeto
  • Acesse http://localhost/register para criar um usuário ou http://localhost/login para logar com um usuário já criado
    • O seed cria um usuário com o email test@example.com e a senha password, dez carros e 3 manutenções agendadas, mas você pode criar um novo usuário. O arquivo de seed pode ser visto aqui.

Rotas

O projeto usa uma API REST para fazer as requisições, então todas as rotas estão no arquivo routes/web.api, para acessar as rotas, é necessário estar logado. As rotas são:

  • /vehicles - Para listar os veículos
  • /maintenances - Para listar as manutenções
  • /dashboard/ - Para listar as manutenções agendadas nos próximos 30 dias

Observações

  • O .env está configurado para utilizar os endereços dos containers do Docker, caso use outro endereço, é necessário alterar o arquivo, as rotas para "localhost" estão comentadas.
  • Caso não consiga acessar o projeto compilado após rodar o comando ./vendor/bin/sail npm run dev, altere o arquivo vite.config.js, removendo hmr: {host: 'localhost',}, e descomentando host: 'localhost' ou deixe server{} vazio.
  • É possível alterar o docker-compose.yml livremente, mas caso queira alterar os dockerfiles, utilize o comando ./vendor/bin/sail artisan sail:publish para publicar os arquivos e altere os arquivos na pasta docker criada. Após isso, é necessário rodar o comando ./vendor/bin/sail build --no-cache para reconstruir os containers.