Google Play — Runbook de Primeiro Lançamento (Fase 1)

App: Vibe Sensei · Package: com.vibesensei.app · Track inicial: internal

✅ Pré-confirmado pelo agente

PR #3137 mergeada no dev (2026-10-04) — feat(mobile-ci): add opt-in AAB→Google Play upload + full store-setup guide.
.github/workflows/mobile-release.yml tem o passo de Play: platform=android, upload_to_play=true, track: internal, check do secret PLAY_SERVICE_ACCOUNT_JSON.
Guia completo em documentation/mobile-release-setup.md.

👤 VOCÊ (usuário) precisa fazer — nesta ordem

Passo 1 — Conta Google Play Developer

Acesse play.google.com/console.
Entre com a conta Google que será dona da listagem (idealmente corporativa, não pessoal).
Aceite o Developer Distribution Agreement.
Pague a taxa única de registro de US$ 25 (Google Payments).
Verifique: você chega ao dashboard "All apps" — conta ativa.

Passo 2 — Criar o app record

No Play Console → Create app.
App name: Vibe Sensei
Default language: English (United States)
App or game: App · Free or paid: Free
Aceite as declarações → Create app.
⚠️ Package name: com.vibesensei.app está fixado no código e é travado após o 1º upload. Confirme em mobile/android/app/build.gradle (applicationId "com.vibesensei.app"). Não defina outro package no Console.
Verifique: app aparece em "All apps" com status "Draft".

Passo 3 — Gerar o upload keystore (uma vez — e faça BACKUP)

No terminal, rode exatamente (escolha suas senhas):

keytool -genkeypair -v \
  -keystore upload.keystore \
  -alias upload \
  -keyalg RSA -keysize 2048 -validity 10000 \
  -dname "CN=Vibe Sensei, OU=Mobile, O=Pure Power Apps, L=, ST=, C=US"

Será pedido: keystore password (forte, anote) e key password (pode ser a mesma).

⛔ FAÇA BACKUP do upload.keystore IMEDIATAMENTE — iCloud Drive, 1Password E um drive offline. O Google Play trava a listagem com.vibesensei.app ao certificado deste arquivo para sempre. Perder o arquivo = perder a capacidade de publicar updates. Não há recuperação.

Depois, codifique pro secret do GitHub:

base64 -i upload.keystore | pbcopy   # macOS — copia pro clipboard

Passo 4 — Service account no Google Cloud + baixar JSON

Acesse console.cloud.google.com.
Selecione (ou crie) o projeto GCP ligado à sua conta Play. (Play Console → Setup → API access mostra/vincula o projeto.)
Habilite a Google Play Android Developer API: APIs & Services → Library → buscar → Enable.
IAM & Admin → Service Accounts → + Create Service Account.
Name: github-play-publisher · Description: CI service account for GitHub Actions Play uploads.
Create and Continue → pule o passo de roles (Continue) → Done.
Clique no github-play-publisher → aba Keys → Add Key → Create new key → JSON → Create.
Baixa github-play-publisher-XXXX.json (~2KB, contém "type": "service_account").

Passo 5 — Permissão do service account no Play Console

Play Console: Setup → API access.
No github-play-publisher → Manage Play Console permissions.
Em "App permissions", adicione o app Vibe Sensei.
Conceda Release manager (cria/edita releases + publica em tracks).
Apply → Invite user. Aguarde 5–10 min de propagação antes de rodar o CI.

🤖 O AGENTE faz — assim que você entregar os valores

A — Setar os 5 secrets do GitHub

gh secret set ANDROID_KEYSTORE_BASE64   --repo <owner>/vibe-code-sensei
gh secret set ANDROID_KEYSTORE_PASSWORD --repo <owner>/vibe-code-sensei
gh secret set ANDROID_KEY_ALIAS         --repo <owner>/vibe-code-sensei
gh secret set ANDROID_KEY_PASSWORD      --repo <owner>/vibe-code-sensei
gh secret set PLAY_SERVICE_ACCOUNT_JSON --repo <owner>/vibe-code-sensei \
  --body "$(cat github-play-publisher-XXXX.json)"

Verifica com gh secret list --repo <owner>/vibe-code-sensei | grep -E 'ANDROID|PLAY'.

B — Build de validação (sem upload)

Dispara Mobile Release com platform=android, upload_to_play=false; baixa o AAB e confirma a assinatura com seu keystore.

C — Primeiro upload (track interno)

Com a assinatura confirmada, dispara platform=android, upload_to_play=true; acompanha até o passo de upload sair verde.

D — Validar no track interno

Play Console → Testing → Internal testing → confirmar o build com o version code correto (essa confirmação visual é sua — o agente não clica no Play Console).

❌ Pré-requisitos que faltam (bloqueadores)

#	O quê	Status
1	Conta Google Play Developer (US$25, play.google.com/console)	FALTA
2	App record `com.vibesensei.app` criado no Console	FALTA
3	`upload.keystore` gerado + valor `ANDROID_KEYSTORE_BASE64` (base64)	FALTA
4	`ANDROID_KEYSTORE_PASSWORD`	FALTA
5	`ANDROID_KEY_ALIAS` (ex.: `upload`)	FALTA
6	`ANDROID_KEY_PASSWORD`	FALTA
7	`github-play-publisher.json` baixado do GCP	FALTA
8	Service account com Release manager + propagação ~10 min	FALTA

Já configurados (sem ação): APPLE_TEAM_ID, APPLE_API_ISSUER, APPLE_API_KEY_ID, APPLE_API_KEY_P8, GH_TOKEN.

Fase 2 — Apple (adiada)

Secrets iOS e setup do App Store Connect estão em documentation/mobile-release-setup.md ("iOS secrets (7)"). Tratar depois do track interno do Google Play funcionando.