Noções Básicas de Incidentes Móveis

// docs/incident-severity.ts - copie para o seu repositório de runbooks
export type IncidentSeverity = "SEV1" | "SEV2" | "SEV3" | "SEV4";
 
export type SeverityCriteria = {
  sev: IncidentSeverity;
  userImpact: string;
  revenuePath: boolean;
  example: string;
};
 
export const MOBILE_SEVERITY_MATRIX: SeverityCriteria[] = [
  {
    sev: "SEV1",
    userImpact: "App inutilizável para a maioria OU removido da loja OU violação de dados",
    revenuePath: true,
    example: "Suspensão da Play Store; autenticação indisponível para todos os usuários no build ativo",
  },
  {
    sev: "SEV2",
    userImpact: "Caminho crítico quebrado para >25% dos usuários ativos",
    revenuePath: true,
    example: "Crash no checkout no lançamento faseado do iOS 2.4.0",
  },
  {
    sev: "SEV3",
    userImpact: "Regressão com solução alternativa; rollout parcial ou plataforma única",
    revenuePath: false,
    example: "Crash na aba Configurações no canal de pré-visualização do Android",
  },
  {
    sev: "SEV4",
    userImpact: "Apenas interno, aviso de política ou desvio de métrica abaixo do limiar",
    revenuePath: false,
    example: "Ruído no Sentry no perfil de desenvolvimento; prazo de metadados da App Store",
  },
];

## Atribuição de funções (cole em #incidente-YYYYMMDD)
 
| Função | Proprietário | Responsabilidade |
|---|---|---|
| **Comandante de Incidente (IC)** | @oncall-mobile | Severidade, cronograma, go/no-go para rollback |
| **Líder Técnico** | @mobile-lead | Triagem, bisect, hotfix branch |
| **Comunicação** | @support-lead | Página de status, macros de suporte, social |
| **Escriba** | voluntário | Registro de decisões com timestamps |
| **Operações da Loja** | @release-mgr | Pausar lançamento faseado, parar Play Store - [Resposta a Incidentes da Loja](../store-operations/store-incident-response.md) |

## Mapa de comunicação
 
| Canal | Público | Regras de conteúdo |
|---|---|---|
| `#incidente-YYYYMMDD` | Engenharia + IC | Fatos técnicos, comandos executados, hipóteses |
| `#incidente-comms` | Suporte + PM + Comunicação | Apenas linguagem aprovada para o cliente |
| PagerDuty / Opsgenie | Plantão | Alerta → reconhecer → entrar no canal do incidente |
| Página de status | Clientes | Sem causa raiz até confirmada; sem culpa |
| Email executivo | C-suite | Impacto no negócio, faixa de ETA, o que estamos fazendo agora |

# Interno (engenharia) - OK
Suspeita de OTA grupo abc123 publicado às 14:02 UTC. Taxa de crash caiu de 99.4% para 96.1%.
Executando eas channel:view production. IC: @jane.
 
# Externo (página de status) - OK
Estamos investigando relatos de que o ShopApp está fechando inesperadamente em alguns dispositivos.
Próxima atualização em 30 minutos ou antes.
 
# Externo - NUNCA
Causado pelo deploy do @bob. Revertendo agora.

## T+0 a T+15 (produção móvel)
 
- [ ] **Reconhecer** alerta; IC atribuído (nome único no tópico do canal)
- [ ] **Confirmar escopo:** plataforma(s), número do build, ID da atualização OTA, canal, % de usuários
- [ ] **Correlacionar tempo:** publicação OTA, % de rollout da loja, deploy de backend, mudança de feature flag
- [ ] **Conter o raio de propagação:**
  - [ ] Pausar release faseado do iOS / parar rollout percentual do Play
  - [ ] Desativar kill switch remoto para a superfície suspeita
  - [ ] Iniciar rollback OTA se o bundle JS for suspeito - [Rollback de Emergência OTA](./ota-emergency-rollback.md)
- [ ] **Abrir dashboards:** Sentry Release Health, sucesso de pagamento, erros de autenticação, taxa de aplicação de OTA
- [ ] **Notificar** comunicação + executivos se SEV1/SEV2
- [ ] **Não** mesclar hotfix para main até que o IC confirme o caminho de contenção

# Comandos de confirmação de escopo (executar em paralelo)
eas channel:view production
eas update:list --branch production --limit 3
# Sentry: filtrar por release + dist (ID da atualização OTA)

// Registrar no início da sessão - incidentes e suporte dependem disso
import * as Application from "expo-application";
import * as Updates from "expo-updates";
 
export function getIncidentCorrelationTags() {
  return {
    nativeRelease: `${Application.nativeApplicationVersion}+${Application.nativeBuildVersion}`,
    otaUpdateId: Updates.updateId ?? "embedded",
    channel: Updates.channel ?? "none",
    runtimeVersion: Updates.runtimeVersion ?? "unknown",
  };
}

# Contenção de OTA (regressão JS)
eas update:rollback
eas channel:view production

## Modelo de status (postar a cada 15–30 min)
 
**SEV:** SEV2
**IC:** @jane
**Impacto:** Crash no checkout no build iOS 240012 (~18% de usuários faseados)
**Contenção:** Lançamento faseado pausado; flag `newCheckout` desativada
**Próximo:** Bisect OTA vs nativo - veja Triagem de Pico de Crash
**ETA:** Próxima atualização às 15:45 UTC

## Gatilhos de notificação para executivos / jurídico
 
| Gatilho | Notificar |
|---|---|
| App removido da App Store ou Play Store | Executivos + Jurídico imediatamente (SEV1) |
| Exposição de PII ou alegação de violação regulatória | Jurídico imediatamente |
| Sucesso de pagamento abaixo de 5% abs por mais de 15 min | Executivos + Finanças |
| Autenticação indisponível para >25% de usuários | Executivos |
| Crash de recurso opcional SEV3 | Apenas Engenharia |

## Captura no mesmo dia (escriba é o responsável)
 
- [ ] Início/fim do incidente UTC
- [ ] Severidade final
- [ ] Lançamentos afetados: builds nativos + IDs de OTA
- [ ] Ações de contenção com timestamps
- [ ] Duração visível para o cliente
- [ ] Link para o cluster do Sentry / grupo de atualizações EAS
- [ ] Agendar pós-mortem em até 5 dias úteis (SEV1/SEV2)