# PluriWave · Guía de publicación automática en Google Play

> Estado: en preparación  
> Última revisión: 2026-05-27

## Objetivo

Dejar **PluriWave** con un flujo de publicación lo más automático posible:

- `main` → desarrollo diario, pruebas y artefactos internos
- `PRO` → publicación automática a **Google Play Internal Testing**

## Estrategia acordada

### Ramas

- **`main`**
  - desarrollo diario
  - análisis, tests y builds internos
  - NO publica en Google Play
- **`PRO`**
  - rama de release permanente
  - al subir cambios aquí, se genera el **AAB release firmado**
  - publica automáticamente en **Google Play · Prueba interna**

### Publicación

1. Bootstrap manual inicial en Play Console
2. Configuración correcta del keystore de subida
3. Integración con Google Play Developer API
4. Automatización desde Gitea Actions

## Estado actual del proyecto

### Verificado en el repositorio

- Existe workflow en `.gitea/workflows/build.yml`
- Actualmente compila y firma correctamente en CI
- Genera:
  - APK release
  - AAB release
- Publica artefactos internos en `ftl-builds`
- Ya existe soporte para keystore release desde `android/key.properties`

### Verificado en Play Console

- La app ya está creada
- Nombre: `PluriWave`
- Package: `es.freetimelab.pluriwave`
- Ya se ha subido manualmente un **AAB** al canal de **prueba interna**
- Producción sigue bloqueada por el requisito de:
  - prueba cerrada
  - 12 testers
  - 14 días

## Automatización prevista en CI

### `main`

- `flutter pub get`
- `flutter analyze`
- build release
- publicación de APK/AAB en infraestructura interna

### `PRO`

- `flutter pub get`
- `flutter analyze`
- build release firmado
- publicación de APK/AAB en infraestructura interna
- subida automática del `.aab` a Google Play **track internal**

## Secretos necesarios en Gitea

### Ya usados por firma

- `PLURIWAVE_KEYSTORE_PASSWORD`
- `GITEA_TOKEN`

### Necesarios para Play Store

- `GOOGLE_PLAY_SERVICE_ACCOUNT_JSON`

> Debe contener el JSON completo de una **Service Account** con acceso concedido en Play Console a esta aplicación.

## Ficheros implicados

- `.gitea/workflows/build.yml`
- `fastlane/Fastfile`
- `fastlane/Appfile`
- `android/app/build.gradle.kts`

## Siguiente validación manual

Cuando la automatización quede desplegada:

1. crear la rama `PRO` en remoto
2. configurar `GOOGLE_PLAY_SERVICE_ACCOUNT_JSON`
3. hacer push a `PRO`
4. comprobar que:
   - compila
   - firma
   - genera AAB
   - sube a Google Play Internal Testing

## Notas importantes

- El canal automatizado inicial será **internal testing**, no producción
- La primera publicación manual en Play Console ya quedó hecha
- La automatización NO elimina el requisito posterior de closed testing antes de producción
