Hidroponica

Sistema de gerenciamento e API com textos traduzidos para estudar com listening

Screenshots

Backoffice

Referência da API com OpenAPI/Swagger

Desenvolvimento

Ambiente

1. Duplique .env.example para .env e mude o usuário (DB_USERNAME) e senha (DB_PASSWORD)

cp .env.example .env

2. Baixe o Sail juntamente com as dependências do composer

docker run -v $(pwd):/var/www/html -w /var/www/html laravelsail/php82-composer:latest sh -c "composer config --global && composer install --ignore-platform-reqs"

sudo chown 1000:1000 -R vendor
sudo chmod 775 -R vendor

3. Suba o ambiente

./vendor/bin/sail up -d

Esse comando é utilizado sempre que quiser subir o ambiente ja configurado também

4. Crie a APP_KEY

./vendor/bin/sail art key:generate

5. Crie as tabelas com alguns registros do seeder

./vendor/bin/sail art migrate:fresh --seed

6. Baixe as dependências javascript

./vendor/bin/sail npm i

7. Gere o frontend institucional, administrativo e webapp

./vendor/bin/sail npm run build:backoffice
./vendor/bin/sail npm run build:webapp

8. Crie a documentação de referência que ficará disponível em localhost/api/reference

./vendor/bin/sail art vendor:publish --provider "L5Swagger\L5SwaggerServiceProvider"
./vendor/bin/sail art l5-swagger:generate

9. Crie o bucket público local se ainda não foi criado do MinIO em localhost:8900 usando o login sail e password

Execução

1. Inicie o backend se necessário

./vendor/bin/sail up -d

Interrompa com ./vendor/bin/sail down

2. Inicie o frontend do backoffice ou webapp

./vendor/bin/sail npm run dev:backoffice
./vendor/bin/sail npm run dev:webapp

Interrompa com ctrlc

3. Acesse o sistema:
   • localhost/admin: [email protected] 123

Outros comandos úteis durante o desenvolvimento:

• sail bash
• sail psql
• sail tinker
• sail art queue:work
• sail art optimize:clear
• sail composer i

Linting

./vendor/bin/sail php ./vendor/bin/pint
./vendor/bin/sail php ./vendor/bin/pint --dirty

Testes

Ambiente

./vendor/bin/sail psql
create database hidroponica_testing;

Execução

./vendor/bin/sail test
./vendor/bin/sail test tests/Feature/BlablaTest.php
./vendor/bin/sail test --parallel --no-coverage
./vendor/bin/sail test --filter nomeDoTeste

QA

É mantido em paralelo os testes automatizados de api e interface web. Para testar:

• no .env deve estar com APP_ENV configurado como e2e
• com o projeto ja configurado, executar sail art migrate:fresh --seed e sail art optimize:clear para resetar o ambiente
• caso tenha alterado frontend, rode novamente sail npm run build