Setup do ambiente de QA

Escopo

Configuracao do ambiente para execucao de testes manuais e automatizados. Este documento descreve as variaveis de ambiente, flags de controle e pre-requisitos necessarios para que o time de QA consiga executar os cenarios de teste sem dependencias externas.

Variaveis de ambiente

Flags de verificacao

As flags abaixo permitem desabilitar o envio real de email e SMS durante os testes, substituindo os codigos de verificacao por um valor fixo.

Variavel	Valores	Padrao	Descricao
DISABLE_EMAIL_VERIFICATION	true / false	false	Desabilita o envio de email de verificacao. O codigo gerado sera sempre 123456
DISABLE_SMS_VERIFICATION	true / false	false	Desabilita o envio de SMS de verificacao. O codigo gerado sera sempre 123456

Comportamento com flags ativas

Quando DISABLE_EMAIL_VERIFICATION=true:

• O codigo de verificacao por email sera sempre 123456
• Nenhum email e enviado via AWS SES
• O registro no banco (EmailVerificationCode) e criado normalmente
• Fluxos afetados: registro, login com email/senha, verificacao de email

Quando DISABLE_SMS_VERIFICATION=true:

• O codigo de verificacao por SMS sera sempre 123456
• Nenhum SMS e enviado via Twilio
• O registro no banco (UserVerification) e criado normalmente
• Fluxos afetados: verificacao de telefone no perfil do usuario

Configuracao recomendada por ambiente

Ambiente	DISABLE_EMAIL_VERIFICATION	DISABLE_SMS_VERIFICATION
Local	true	true
Desenvolvimento	true	true
Staging	false	false
Producao	false	false

Como configurar

1. Copiar o arquivo .env.example para .env (se ainda nao existir)
2. Definir as flags de verificacao:

DISABLE_EMAIL_VERIFICATION=true
DISABLE_SMS_VERIFICATION=true

3. Reiniciar a API (npm run dev)

Codigo de verificacao fixo

Com as flags ativas, use o codigo 123456 em todos os fluxos que pedem verificacao por email ou SMS:

• Registro de usuario (verificacao de email)
• Login com email/senha (codigo de autenticacao)
• Verificacao de telefone no perfil