I-F-T00-07-03 — Generar y registrar credenciales APNs (iOS) + clave FCM (Android) en EAS para notificaciones push

[Azfe]

[I-F-T00-07-03] Generar y registrar credenciales APNs (iOS) + clave FCM (Android) en EAS

🎯 Objetivo

Generar el certificado APNs para iOS y la clave FCM v1 para Android y registrarlos en EAS Credentials para que las notificaciones push funcionen en F-N06 sin necesidad de gestionar los archivos de credenciales manualmente.

🛠️ Instrucciones de Implementación (Alcance Técnico)

iOS — APNs:

• Acceder a Apple Developer Portal → Certificates, IDs & Profiles → Keys.

• Crear una clave con la capacidad Apple Push Notifications service (APNs) habilitada.

• Descargar el archivo .p8 (solo se puede descargar una vez) y anotar el Key ID y el Team ID.

• Registrar en EAS:

  eas credentials --platform ios
  # Seleccionar: Push Notifications → Add → subir el .p8, Key ID y Team ID

• Verificar en expo.dev → Project → Credentials → iOS que aparece la clave APNs.

Android — FCM v1:

• En Google Cloud Console, ir al proyecto Firebase vinculado a la app → IAM & Admin → Service Accounts.

• Crear una cuenta de servicio con el rol Firebase Cloud Messaging API y descargar el JSON de clave privada.

• Registrar en EAS:

  eas credentials --platform android
  # Seleccionar: Push Notifications → Add FCM V1 Key → subir el JSON

• Verificar en expo.dev → Project → Credentials → Android que aparece la clave FCM v1.

Archivos sensibles:

• El .p8 de APNs y el JSON de FCM no se commitean — almacenarlos en un gestor de secretos del equipo (1Password, etc.).
• Añadir *.p8 y google-services*.json a .gitignore si no están ya.

✅ Criterios de Aceptación (Checklist)

• La clave APNs aparece en expo.dev → Credentials → iOS con estado válido.
• La clave FCM v1 aparece en expo.dev → Credentials → Android con estado válido.
• eas build --profile production --platform ios arranca sin solicitar credenciales (las toma de EAS).
• eas build --profile production --platform android arranca sin solicitar credenciales.
• Ningún archivo .p8 ni JSON de FCM está commiteado en el repositorio.

🔗 Contrato / Referencias

• Feature padre: F-T00-07 — EAS Build + credenciales push
• Depende de: I-F-T00-07-02 (perfiles de build configurados en eas.json); I-F-T00-04-04 (bundle ID definitivo en app.config.js).
• Requerido por: I-F-N06-01-02 (cliente pide permisos y registra token) e I-F-N06-02-01 (Edge Function send-push envía notificaciones usando estas credenciales vía Expo Push API).

🌿 Branch

task/t00-07-03-push-credentials

[Azfe]

Estado de implementación

Rama: task/t00-07-03-push-credentials

⏸️ Decisión (2026-06-17): los pasos manuales de registro de credenciales se POSPONEN hasta abordar la feature de notificaciones (F-N06).
Motivo: no bloquean el desarrollo actual. Toda la app (tablón, calendario, chat, perfil, auth) y los builds development/preview funcionan sin las credenciales push. Solo se necesitan para enviar push reales en un build de producción. Se registrarán en EAS justo antes de cerrar F-N06 / la primera build de producción con push. La parte de código de esta issue (.gitignore) sí queda completada ahora.

Esta tarea es mayoritariamente manual y externa (Apple Developer Portal, Google Cloud/Firebase, eas credentials interactivo). La parte automatizable en el repo está completada; el registro de credenciales lo realiza el responsable con acceso a las cuentas.

✅ Hecho en el repo (ahora)

• Añadidas a .gitignore reglas para credenciales y ficheros de firma: *.p8, *.p12, *.mobileprovision, *.keystore, *.jks, google-services*.json, GoogleService-Info.plist.
• Verificado: ningún archivo sensible está trackeado ni presente en disco (criterio 5 ✅).

⏳ Pasos manuales POSPUESTOS hasta F-N06 (requieren cuentas externas)

Prerequisitos

• iOS: cuenta Apple Developer de pago (99 €/año) activa.
• Android: proyecto Firebase vinculado al package com.nunibiza.pinboard.

iOS — APNs (dos opciones)

• Recomendada: eas credentials --platform ios → perfil production → Push Notifications Key → Set up a new key. Conectando la cuenta Apple, EAS genera y registra el .p8 automáticamente.
• Manual: crear Key con capacidad APNs en Apple Developer Portal, descargar .p8 y subirlo en eas credentials con Key ID + Team ID.

Android — FCM v1

1. Firebase/Google Cloud Console → Service Account con permiso Firebase Cloud Messaging API → descargar JSON.
2. eas credentials --platform android → Push Notifications: FCM V1 → subir el JSON.

Verificación de criterios (al completar los pasos manuales en F-N06)

• APNs key visible en expo.dev → Credentials → iOS con estado válido
• FCM V1 key visible en expo.dev → Credentials → Android con estado válido
• eas build --profile production --platform ios arranca sin pedir credenciales
• eas build --profile production --platform android arranca sin pedir credenciales
• Ningún .p8 ni JSON de FCM commiteado (gitignore + verificación)

Los ficheros .p8 y el JSON de FCM deben guardarse en el gestor de secretos del equipo (1Password, etc.). El .gitignore ya evita commits accidentales.

Siguiente

• I-F-N06-01-02 (cliente registra token) e I-F-N06-02-01 (Edge Function send-push) consumen estas credenciales vía Expo Push API. El registro de credenciales se realizará en ese momento.

[Azfe]

📚 Contexto: ¿qué son y para qué sirven estas credenciales y EAS?

El problema de fondo: las notificaciones push

La app necesita avisar a los empleados de nuevos posts, eventos o mensajes aunque la app esté cerrada. El servidor (Supabase) no puede enviar la notificación directamente al móvil: tiene que pasar por el sistema del fabricante.

• iPhone → APNs (Apple Push Notification service)
• Android → FCM (Firebase Cloud Messaging)

Apple y Google hacen de "carteros" oficiales y exigen demostrar que eres el dueño legítimo de la app antes de dejarte enviar notificaciones.

Para qué sirven el certificado APNs y la clave FCM

Son la prueba de identidad que demuestra a Apple/Google que tienes permiso para enviar push a com.nunibiza.pinboard.

	iOS	Android
Cartero	APNs (Apple)	FCM (Google)
Credencial	clave APNs (.p8)	cuenta de servicio FCM v1 (.json)

Sin ellas, los push se rechazan y nunca llegan. Flujo completo:

Supabase Edge Function (send-push)
   → Expo Push API
      → APNs ──→ iPhones
      → FCM  ──→ Androids

Qué es EAS (Expo Application Services)

Plataforma en la nube de Expo, el "backend de build y distribución" de la app:

• EAS Build — compila la app en la nube y genera .apk/.ipa (no hace falta Mac para iOS). → issue I-F-T00-07-02 — Configurar eas.json con perfiles: development / preview / production #26 (perfiles en eas.json).
• EAS Credentials — guarda de forma segura y cifrada los certificados de firma y las credenciales push (APNs/FCM). → núcleo de esta issue I-F-T00-07-03 — Generar y registrar credenciales APNs (iOS) + clave FCM (Android) en EAS para notificaciones push #27.
• EAS Submit — sube la app a App Store / Play Store (fuera de alcance del Hito 0).
• EAS Update — actualizaciones OTA (fuera de alcance ahora).

Cómo encaja con lo ya hecho

1. I-F-T00-07-01 — Crear cuenta EAS + eas login + eas init (vincular app ID) #25 → cuenta EAS + projectId (el "espacio" donde se guarda todo).
2. I-F-T00-07-02 — Configurar eas.json con perfiles: development / preview / production #26 → cómo se construye la app (perfiles eas.json).
3. I-F-T00-07-03 — Generar y registrar credenciales APNs (iOS) + clave FCM (Android) en EAS para notificaciones push #27 → se registra la "prueba de identidad" para que los builds de producción puedan enviar push.

Ventaja clave: con las credenciales en EAS Credentials, eas build --profile production no las vuelve a pedir — las coge solas de la nube (de ahí los criterios de aceptación).