Erro → report do usuário

Diagrama de steps

1. 1

   Erro surge em KoderErrorBanner

   App

   Título humanizado + detalhe acionável + ID canônico do erro (PRODUTO-CAT-CODE-SEQ).

   specs/errors/user-facing-messages.kmd

   ↓
2. 2

   Usuário toca Reportar

   Usuário

   Só disponível quando reporting consent está ON em Settings. Default OFF.

   ↓
3. 3

   Diálogo de confirmação

   App

   Mostra exatamente o que será enviado: ID do erro, stack anonimizado, comentário opcional. Sem PII a menos que o usuário adicione explicitamente.

   ↓
4. 4

   Usuário confirma

   Usuário

   Toca Enviar.

   ↓
5. 5

   SDK posta pro reporter

   SDK

   KoderErrorReporter envia o bundle pra services/foundation/reporter; queue offline.

   specs/errors/reporting.kmd

   ↓
6. 6

   Servidor confirma

   Servidor

   Reporter retorna um tracking ID que o usuário pode citar em pedidos de suporte.

Pitfalls comuns

• ⚠ Enviar reports sem consentimento explícito — viola a policy de reporting e a confiança do usuário.
• ⚠ Incluir stack traces crus com paths do device — vaza usernames em macOS/Windows.

Fluxos relacionados