Desenvolvimento e operação
Ambiente local, configuração e evidências.
Suba a infraestrutura
Use Node 24 e pnpm 10.28. Configure .env na raiz com serviços externos ou use Compose quando Docker estiver disponível. PostgreSQL e ClickHouse possuem migrações próprias. O Redis precisa de conexão TCP/TLS e política noeviction; S3/R2 fica privado. infra:check mostra status sem imprimir credenciais.
pnpm install
# Se usar Docker: pnpm infra:up
pnpm db:migrate
pnpm db:migrate:analytics
pnpm build
pnpm infra:check
pnpm devOAuth
Configure Google e GitHub com callback DASHBOARD_URL/api/auth/callback/google ou /github. O dashboard acessa a API por proxy de mesma origem. Contas não são vinculadas implicitamente por coincidência de e-mail.
Certificados no desenvolvimento
Certificados autoassinados devem ser confiados por uma CA disponível no ambiente. As opções DATABASE_SSL_REJECT_UNAUTHORIZED=false e REDIS_TLS_REJECT_UNAUTHORIZED=false permitem testes explícitos sem verificar a identidade do servidor, mantendo criptografia; são bloqueadas em produção. Não use NODE_TLS_REJECT_UNAUTHORIZED=0 globalmente. Configure certificados confiáveis antes da ativação comercial.
Estado verificável
/health verifica o processo; /ready consulta dependências. Sem bancos e filas disponíveis não declare o pipeline validado. Registre testes externos separadamente de fixtures. Os procedimentos de backup e restauração acompanham a implementação operacional.