Ambiente local
Subir o sistema na sua máquina, popular com dados de demonstração e entrar sem depender do e-mail.
Pré-requisitos
PHP 8.3+ (com pdo_pgsql), Composer 2, Node 22 com pnpm 10 e Docker.
Primeira vez
git clone git@github.com:byeloff/auefolia-trio.git && cd auefolia-trio
docker compose up -d # postgres 17 + redis
composer setup # install, .env, key, migrate, pnpm install, build
php artisan db:seed # papéis, permissões, políticas e admin@auefolia.com.br
docker exec auefolia-pgsql-1 createdb -U auefolia testing # banco dos testesPreencha no .env WORKOS_CLIENT_ID e WORKOS_API_KEY (Magic Auth habilitado
no painel do WorkOS).
Dia a dia
composer run dev # servidor, fila e Vite juntosO login da equipe é em /login. Em local, MAIL_MAILER=log: o código de 6
dígitos aparece em storage/logs/laravel.log. Os e-mails saem pela fila,
então o worker precisa estar rodando (o composer run dev sobe um).
Dados de demonstração
php artisan demo:popular # ~1 ano de operação fake
php artisan db:seed --class=ClienteTesteSeeder # cliente de teste para /acessoO demo:popular passa pelas Actions reais (viajando no tempo): 6 eventos
em 2 temporadas, 250 clientes, 5 vendedores, ~150 reservas, parcelas, créditos
e contratos. --fresh zera o banco antes.
O cliente de teste entra em /acesso com CPF 529.982.247-25 e nascimento
15/03/1990, e tem uma reserva com parcela atrasada e contrato a assinar,
uma quitada e uma cancelada com crédito.
Banco local com dados reais
Se você rodou a importação do legado no banco local, ele tem dados reais de clientes. Não tire prints nem compartilhe telas desse banco. Para demonstração, use um banco separado (veja Manual e prints).
Comandos úteis
| Comando | Para quê |
|---|---|
php artisan types:generate | Regerar domain.d.ts e lib/enums.ts depois de mudar enums/DTOs |
php artisan contratos:emitir-pendentes --dry-run | Ver reservas confirmadas sem contrato |
php artisan assinatura:zapsign-webhook | Registrar o webhook da ZapSign (uma vez por ambiente) |
php artisan lgpd:exportar {cpf} / lgpd:anonimizar {cpf} | Pedidos de titulares |
php artisan migrar:legado --dry-run | Ensaiar a importação do legado |
sh scripts/sonar-local.sh | Análise SonarQube local |