feat(ci): automate play upload from PRO

docs/pluriwave-play-store-publicacion.md

@@ -0,0 +1,110 @@
+# 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