Skip to content

trombonet12/Rally-Copilot / .claude/skills/android-create-room-migration

android-create-room-migration

Verified

Crear una migración Room manual (versión N a N+1) en data/db/Migrations.kt con schema JSON versionado y test Robolectric JVM; no para entidades nuevas completas (android-create-data-layer).

android-create-room-migration

Crea la migración Room de la versión actual a la siguiente, con el schema JSON exportado y versionado en git y un test que la valida.

Cuándo usarla

  • Cambió el esquema del @Database (entity nueva, columna, índice, tabla borrada) y hay datos del usuario que no deben perderse.

Cuándo NO usarla

  • Crear entity, DAO y repository desde cero → android-create-data-layer (te remite aquí al subir la versión).

Precondiciones

  • Conocer la version actual del @Database y que existe el JSON de esa versión en el directorio de esquemas de :app (exportSchema = true). Si no existe, parar y avisar: no se reconstruye sin la versión previa.
  • Nunca editar ni borrar un schema JSON ya publicado; solo se añade el de la nueva versión.

Pasos

  1. Comprobar en app/build.gradle.kts que room.schemaLocation está configurado, el directorio versionado en git y expuesto como assets de test unitario (los tests corren en JVM con Robolectric, no en androidTest). Si falta, reutilizar el patrón existente.
  2. Aplicar el cambio a las entities y subir version a N+1.
  3. ./gradlew assembleDebug para que Room genere el JSON de N+1. Revisar su diff y confirmar que el de N no cambió.
  4. Escribir MIGRATION_N_N1 = object : Migration(N, N+1) en data/db/Migrations.kt con SQL explícito (copiar datos, renombrar, valores por defecto coherentes). Sin @AutoMigration salvo cambio trivial acordado.
  5. Registrarla en addMigrations(...) del builder. Prohibido fallbackToDestructiveMigration.
  6. Test en src/test (JUnit4 + Robolectric + MigrationTestHelper con los schemas JSON): createDatabase(nombre, N), insertar filas representativas, cerrar, runMigrationsAndValidate(nombre, N+1, true, MIGRATION_N_N1) y comprobar los datos con SQL.
  7. Si hay varias versiones, test de la cadena desde la más antigua soportada hasta la actual.

Validaciones / tests

  • ./gradlew testDebugUnitTest (incluye el test de migración).
  • ./gradlew ktlintCheck detekt lintDebug assembleDebug.
  • git status: JSON de N+1 nuevo y ningún schema anterior modificado.

Definition of Done

  • version incrementada, schema N+1 en git; el de N intacto.
  • Migración manual registrada; sin fallbackToDestructiveMigration.
  • Test de migración en verde con datos previos conservados.
  • ./gradlew ktlintCheck detekt lintDebug testDebugUnitTest assembleDebug en verde.

Docs a actualizar

  • docs/arquitectura.md (modelo local, si existe) · docs/DECISIONES.md si cambia el modelo · docs/ESTADO.md (skill session-handoff)
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 321kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 321kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 321kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 197kUpdated Claude CodeCodexVerifiedInstall