Conceptos básicos de incidentes móviles

// docs/incident-severity.ts - copiar en tu repositorio de runbook
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 no utilizable para la mayoría O eliminada de la tienda O filtración de datos",
    revenuePath: true,
    example: "Suspensión de Play; autenticación inactiva para todos los usuarios en compilación en vivo",
  },
  {
    sev: "SEV2",
    userImpact: "Ruta crítica rota para >25% de usuarios activos",
    revenuePath: true,
    example: "Bloqueo de pago en iOS 2.4.0 lanzamiento escalonado",
  },
  {
    sev: "SEV3",
    userImpact: "Regresión con solución alternativa; lanzamiento parcial o plataforma única",
    revenuePath: false,
    example: "Bloqueo de pestaña de configuración en canal de vista previa de Android",
  },
  {
    sev: "SEV4",
    userImpact: "Solo interno, advertencia de política o cambio de métrica por debajo del umbral",
    revenuePath: false,
    example: "Ruido de Sentry en perfil de desarrollo; Plazo de metadatos de App Store",
  },
];

## Asignación de roles (pegar en #incident-YYYYMMDD)
 
| Rol | Propietario | Responsabilidad |
|-----|-------------|-----------------|
| **Comandante de incidente (IC)** | @oncall-mobile | Severidad, línea de tiempo, go/no-go en reversión |
| **Líder técnico** | @mobile-lead | Triaje, bisección, rama de revisión rápida |
| **Comunicaciones** | @support-lead | Página de estado, macros de soporte, redes sociales |
| **Escriba** | voluntario | Registro de decisiones con marcas de tiempo |
| **Operaciones de tienda** | @release-mgr | Pausar lanzamiento escalonado, detener Play - [Respuesta a incidentes de tienda](../store-operations/store-incident-response.md) |

## Mapa de comunicaciones
 
| Canal | Audiencia | Reglas de contenido |
|-------|-----------|---------------------|
| `#incident-YYYYMMDD` | Ingeniería + IC | Hechos técnicos, comandos ejecutados, hipótesis |
| `#incident-comms` | Soporte + PM + Comunicaciones | Solo lenguaje aprobado orientado al cliente |
| PagerDuty / Opsgenie | En guardia | Alerta → reconocer → unirse al canal de incidente |
| Página de estado | Clientes | Sin causa raíz hasta confirmación; sin culpables |
| Correo de ejecutivos | C-suite | Impacto comercial, rango de ETA, qué estamos haciendo ahora |

# Interno (ingeniería) - OK
Sospechoso de grupo OTA abc123 publicado 14:02 UTC. Crash-free bajó 99,4% → 96,1%.
Ejecutando eas channel:view production. IC: @jane.
 
# Externo (página de estado) - OK
Estamos investigando reportes de ShopApp cerrándose inesperadamente en algunos dispositivos.
Próxima actualización en 30 minutos o antes.
 
# Externo - NUNCA
Causado por el lanzamiento de @bob. Revirtiendo ahora.

## T+0 a T+15 (producción móvil)
 
- [ ] **Reconocer** alerta; IC asignado (nombre único en tema de canal)
- [ ] **Confirmar alcance:** plataforma(s), número de compilación, id de actualización OTA, canal, % usuarios
- [ ] **Correlacionar tiempo:** publicación OTA, % lanzamiento de tienda, despliegue de backend, cambio de bandera de características
- [ ] **Contener radio de explosión:**
  - [ ] Pausar lanzamiento escalonado de iOS / detener lanzamiento escalonado de Play
  - [ ] Cambiar interruptor de emergencia remoto para superficie sospechosa
  - [ ] Iniciar reversión de OTA si el paquete JS es sospechoso - [Reversión de emergencia de OTA](./ota-emergency-rollback.md)
- [ ] **Abrir paneles:** Sentry Release Health, éxito de pagos, errores de autenticación, tasa de aplicación de OTA
- [ ] **Notificar** comunicaciones + ejecutivos si SEV1/SEV2
- [ ] **No** fusionar revisión rápida con main hasta que IC confirme ruta de contención

# Comandos de confirmación de alcance (ejecutar en paralelo)
eas channel:view production
eas update:list --branch production --limit 3
# Sentry: filtrar por lanzamiento + dist (id de actualización OTA)

// Registrar al inicio de sesión - soporte e incidentes dependen de esto
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",
  };
}

# Contención de OTA (regresión JS)
eas update:rollback
eas channel:view production

## Plantilla de estado (publicar cada 15-30 min)
 
**SEV:** SEV2
**IC:** @jane
**Impacto:** Bloqueo de pago en compilación de iOS 240012 (~18% usuarios escalonados)
**Contención:** Lanzamiento escalonado pausado; bandera `newCheckout` desactivada
**Siguiente:** Biseccionar OTA vs nativo - ver Triaje de pico de bloqueo
**ETA:** Próxima actualización 15:45 UTC

## Desencadenantes de notificación ejecutiva/legal
 
| Desencadenante | Notificar |
|---|---|
| App eliminada de App Store o Play | Ejecutivos + Legales inmediatamente (SEV1) |
| Exposición de PII o alegación de incumplimiento regulatorio | Legales inmediatamente |
| Éxito de pago down >5% abs durante >15 min | Ejecutivos + Finanzas |
| Autenticación down >25% usuarios | Ejecutivos |
| Bloqueo de característica opcional SEV3 | Solo ingeniería |

## Captura del mismo día (escriba es propietario)
 
- [ ] Inicio/fin de incidente UTC
- [ ] Severidad final
- [ ] Lanzamientos afectados: compilaciones nativas + ids OTA
- [ ] Acciones de contención con marcas de tiempo
- [ ] Duración visible del cliente
- [ ] Enlace a clúster de Sentry / grupo de actualización EAS
- [ ] Programar post-mortem dentro de 5 días hábiles (SEV1/SEV2)