feat: production-ready error handling (prefixed codes, domain errors, global filter, structured logging)

[lmoraesdev]

Summary

• Error codes prefixados: CHARGE_NOT_FOUND → AE01, IDEMPOTENCY_CONFLICT → AE02, INVALID_STATE_TRANSITION → AE03, WEBHOOK_EVENT_ALREADY_PROCESSED → AE04, mais dois novos: AE05 (UNKNOWN_EVENT_TYPE) e AE06 (MISSING_IDEMPOTENCY_KEY), e IE01 (INTERNAL_ERROR) para erros inesperados
• Novos DomainErrors: UnknownEventTypeError e MissingIdempotencyKeyError substituem throw new Error(...) e throw new BadRequestException(...) hardcoded
• Logging 5W1H no DomainExceptionFilter: todo erro de domínio capturado emite logger.warn com what, why (code), how (method + url), error_class e message
• GlobalExceptionFilter: captura erros inesperados (não-DomainError), loga com stack trace e responde sempre com { statusCode: 500, code: "IE01", message: "Internal server error" } — zero vazamento de detalhes internos
• try/catch nos services: CreateChargeService e ProcessWebhookService relançam DomainError sem log (o filter cuida) e logam + relançam erros inesperados com contexto (charge_id, event_id)
• Testes: 2 novos spec files (domain-errors.spec.ts, domain-exception.filter.spec.ts), testes e2e atualizados — 102 testes passando

Test plan

• npm test — 102 passed, 0 failed
• npm run build — build limpo, sem erros TypeScript
• Erros de domínio retornam code no formato AExx (ex: AE01 para 404, AE02 para 422)
• Erros inesperados retornam { statusCode: 500, code: "IE01", message: "Internal server error" } sem vazar detalhes
• Logs de domínio aparecem com level: warn, campo why com o código e how com METHOD /path