Começar
Correr a AACT localmente com Docker Compose e completar o primeiro fluxo demo.
Requisitos
- Docker e Docker Compose
- Make (opcional, recomendado)
- Portas livres para o gateway (omissão 18080) e opcionalmente mail/Sonar
Stack local Compose· implementado
Setup
bash · Na raiz do repositório
cp .env.example .env
make setup
make seed-demoAbra http://localhost:18080 (ou HTTP_PORT do .env). O gateway serve a UI Next.js e faz proxy de /api e /sanctum para o Laravel.
Chaves de env relevantes (só nomes)
| Chave | Função |
|---|---|
| APP_KEY | Chave da aplicação Laravel |
| HTTP_PORT | Porta publicada do nginx |
| DB_* | Base de dados MariaDB e credenciais |
| MAIL_* | SMTP de desenvolvimento via localfakemail |
| AACT_ADMIN_TOTP_REQUIRED | Exigir TOTP de admin (true em produção) |
| AACT_FILE_SCANNER | auto | clamav | unavailable | fake |
| TRUSTED_PROXIES | Restringir em produção; ver hardening |
Primeiro fluxo funcional
- Entrar com o admin demo do seed-demo (ver demo walkthrough no repositório)
- Confirmar TOTP/setup se pedido
- Criar ou inspecionar credencial em Admin → Integrations (exige step-up)
- Enviar um sale assinado com examples/node-checkout/post-sale.mjs
- Inspecionar eventos, comissões e saldos no portal
Seeder demo + examples· implementado