From 6a3352a96ca378388e5caef32908efdb4dce03af Mon Sep 17 00:00:00 2001
From: mono <mono@desarrollo-mono.localhost>
Date: Sun, 25 Oct 2026 21:27:44 -0500
Subject: [PATCH] fix: preservar datos y recuperar base local

---
 AGENTS.md                                     |  5 +++
 apps/toldo-app/package-lock.json              |  4 +--
 apps/toldo-app/package.json                   |  2 +-
 .../src/__tests__/critical-flow.test.ts       |  2 +-
 .../src/__tests__/database-bootstrap.test.ts  | 22 +++++++++++++
 apps/toldo-app/src/main.ts                    | 24 +++++++++++++-
 apps/toldo-app/src/style.css                  |  5 +++
 apps/toldo-app/src/views/Exportar.vue         |  8 ++++-
 apps/toldo-app/version.properties             |  4 +--
 .../.openspec.yaml                            |  2 ++
 .../harden-database-bootstrap-reset/design.md | 23 +++++++++++++
 .../proposal.md                               | 29 ++++++++++++++++
 .../specs/database-bootstrap-recovery/spec.md | 33 +++++++++++++++++++
 .../harden-database-bootstrap-reset/tasks.md  | 12 +++++++
 .../standardize-app-version/proposal.md       |  2 +-
 .../specs/app-versioning/spec.md              |  6 ++--
 .../changes/standardize-app-version/tasks.md  |  2 +-
 packages/data/src/db/schema.ts                | 10 ++++++
 .../src/export-import/ExportImportService.ts  |  2 +-
 19 files changed, 183 insertions(+), 14 deletions(-)
 create mode 100644 apps/toldo-app/src/__tests__/database-bootstrap.test.ts
 create mode 100644 openspec/changes/harden-database-bootstrap-reset/.openspec.yaml
 create mode 100644 openspec/changes/harden-database-bootstrap-reset/design.md
 create mode 100644 openspec/changes/harden-database-bootstrap-reset/proposal.md
 create mode 100644 openspec/changes/harden-database-bootstrap-reset/specs/database-bootstrap-recovery/spec.md
 create mode 100644 openspec/changes/harden-database-bootstrap-reset/tasks.md

diff --git a/AGENTS.md b/AGENTS.md
index 2576327..6d6be43 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -33,3 +33,8 @@ Mantener código siguiendo arquitectura limpia
 - El script debe confirmar `applicationId`, `versionName`, `versionCode`, bundle JavaScript, fuentes MDI y textos críticos de la versión.
 - Incrementar `versionCode` para cada APK publicable; mantener la misma firma y publicar versiones beta como prerelease.
 - Después de subir un asset, comparar su SHA256 con el APK verificado localmente y comprobar el asset de la release mediante la API de Gitea.
+
+## Persistencia local
+- La app debe abrir Dexie explícitamente antes de montar Vue.
+- Las migraciones deben agregar una nueva versión Dexie y transformar datos; nunca deben borrar datos automáticamente.
+- El reset de la base es una acción manual, confirmada y visible sólo como último recurso.
diff --git a/apps/toldo-app/package-lock.json b/apps/toldo-app/package-lock.json
index 238ee79..cc17534 100644
--- a/apps/toldo-app/package-lock.json
+++ b/apps/toldo-app/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "toldo-app",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "toldo-app",
-      "version": "0.0.5",
+      "version": "0.0.6",
       "dependencies": {
         "@capacitor/android": "^6.2.1",
         "@capacitor/core": "^6.2.1",
diff --git a/apps/toldo-app/package.json b/apps/toldo-app/package.json
index 5541097..4226b4e 100644
--- a/apps/toldo-app/package.json
+++ b/apps/toldo-app/package.json
@@ -1,7 +1,7 @@
 {
   "name": "toldo-app",
   "private": true,
-  "version": "0.0.5",
+  "version": "0.0.6",
   "type": "module",
   "scripts": {
     "dev": "vite",
diff --git a/apps/toldo-app/src/__tests__/critical-flow.test.ts b/apps/toldo-app/src/__tests__/critical-flow.test.ts
index c59bfd7..ea3ae5c 100644
--- a/apps/toldo-app/src/__tests__/critical-flow.test.ts
+++ b/apps/toldo-app/src/__tests__/critical-flow.test.ts
@@ -19,7 +19,7 @@ describe('contratos de operación y respaldo', () => {
 
   it('expone la versión actual en las exportaciones', () => {
     const result = new ExportImportService().exportAll({ productores: [], productos: [], movimientosInventario: [], ventas: [], ventaLineas: [], gastos: [], ajustes: [], cuadres: [] });
-    expect(result.appVersion).toBe('0.0.5');
+    expect(result.appVersion).toBe('0.0.6');
   });
 
   it('exporta jornadas junto con los datos operativos', () => {
diff --git a/apps/toldo-app/src/__tests__/database-bootstrap.test.ts b/apps/toldo-app/src/__tests__/database-bootstrap.test.ts
new file mode 100644
index 0000000..da8a070
--- /dev/null
+++ b/apps/toldo-app/src/__tests__/database-bootstrap.test.ts
@@ -0,0 +1,22 @@
+import { beforeEach, describe, expect, it } from 'vitest';
+import { db, openDatabase, resetDatabase } from '@toldo/data';
+
+describe('bootstrap y recuperación de base local', () => {
+  beforeEach(async () => {
+    await resetDatabase();
+  });
+
+  it('abre el esquema actual y conserva datos al cerrar y abrir', async () => {
+    await db.productores.add({ id: 'persisted', nombre: 'Productor persistente', activo: true, createdAt: new Date() } as any);
+    db.close();
+    await openDatabase();
+    expect(await db.productores.get('persisted')).toMatchObject({ nombre: 'Productor persistente' });
+    expect(db.auditorias).toBeTruthy();
+  });
+
+  it('restablece sólo cuando se solicita explícitamente', async () => {
+    await db.productores.add({ id: 'to-reset', nombre: 'Temporal', activo: true, createdAt: new Date() } as any);
+    await resetDatabase();
+    expect(await db.productores.count()).toBe(0);
+  });
+});
diff --git a/apps/toldo-app/src/main.ts b/apps/toldo-app/src/main.ts
index 404617e..89fa09e 100644
--- a/apps/toldo-app/src/main.ts
+++ b/apps/toldo-app/src/main.ts
@@ -2,5 +2,27 @@ import { createApp } from 'vue'
 import App from './App.vue'
 import router from './router'
 import vuetify from './plugins/vuetify'
+import { openDatabase, resetDatabase } from '@toldo/data'
 
-createApp(App).use(router).use(vuetify).mount('#app')
+async function bootstrap() {
+  try {
+    await openDatabase()
+    createApp(App).use(router).use(vuetify).mount('#app')
+  } catch (error) {
+    const root = document.querySelector('#app')
+    if (!root) return
+    root.innerHTML = ''
+    const card = document.createElement('main')
+    card.className = 'database-recovery'
+    card.innerHTML = '<h1>No se pudo abrir los datos locales</h1><p>La aplicación no continuará para evitar mostrar información incompleta. Puedes intentar recargar o restablecer el entorno como último recurso.</p>'
+    const details = document.createElement('pre')
+    details.textContent = error instanceof Error ? error.message : String(error)
+    const button = document.createElement('button')
+    button.textContent = 'Restablecer entorno local'
+    button.onclick = async () => { button.disabled = true; await resetDatabase(); window.location.reload() }
+    card.append(details, button)
+    root.append(card)
+  }
+}
+
+bootstrap()
diff --git a/apps/toldo-app/src/style.css b/apps/toldo-app/src/style.css
index ae505a2..9ece11d 100644
--- a/apps/toldo-app/src/style.css
+++ b/apps/toldo-app/src/style.css
@@ -56,6 +56,11 @@ body {
   background: #f5f7f2;
 }
 
+.database-recovery { max-width: 640px; margin: 12vh auto; padding: 24px; font-family: system-ui, sans-serif; color: #26352b; background: #fffdf8; border: 1px solid #d9e2d7; border-radius: 12px; box-shadow: 0 8px 30px rgba(38, 53, 43, .12); }
+.database-recovery p { margin: 12px 0; }
+.database-recovery pre { white-space: pre-wrap; font-size: 12px; color: #6b4a25; background: #f7f1e7; padding: 12px; border-radius: 8px; }
+.database-recovery button { padding: 12px 16px; color: white; background: #2d5f3b; border: 0; border-radius: 8px; cursor: pointer; }
+
 h1,
 h2 {
   font-family: var(--heading);
diff --git a/apps/toldo-app/src/views/Exportar.vue b/apps/toldo-app/src/views/Exportar.vue
index 436df63..f63cc51 100644
--- a/apps/toldo-app/src/views/Exportar.vue
+++ b/apps/toldo-app/src/views/Exportar.vue
@@ -8,19 +8,25 @@
 
     <section>
       <v-card><v-card-title>Restaurar datos</v-card-title><v-card-text><v-file-input accept=".json" label="Seleccionar copia JSON" @update:model-value="archivo = $event" /><v-alert v-if="mensaje" :type="tipoMensaje" variant="tonal" class="mb-3">{{ mensaje }}</v-alert><v-btn @click="importar" :disabled="!archivo" color="secondary" prepend-icon="mdi-upload">Importar datos</v-btn></v-card-text></v-card>
+      <v-card class="mt-4" variant="tonal" color="error"><v-card-title>Mantenimiento</v-card-title><v-card-text><div class="text-body-2 mb-3">Restablece la base local sólo si la aplicación no puede migrarla. Esta acción elimina ventas, inventario, jornadas y respaldos locales.</div><v-btn color="error" variant="outlined" prepend-icon="mdi-database-refresh" @click="reiniciarEntorno">Restablecer entorno local</v-btn></v-card-text></v-card>
     </section>
   </div>
 </template>
 
 <script setup lang="ts">
 import { ref } from 'vue';
-import { db } from '@toldo/data';
+import { db, resetDatabase } from '@toldo/data';
 import { ExportImportService } from '@toldo/services';
 
 const exportService = new ExportImportService();
 const archivo = ref<File | null>(null);
 const mensaje = ref('');
 const tipoMensaje = ref<'success' | 'error'>('success');
+async function reiniciarEntorno() {
+  if (!window.confirm('Se eliminarán todos los datos locales. Exporta un respaldo antes de continuar. ¿Restablecer?')) return;
+  await resetDatabase();
+  window.location.reload();
+}
 
 function onFileChange(e: any) {
   archivo.value = e.target.files[0];
diff --git a/apps/toldo-app/version.properties b/apps/toldo-app/version.properties
index 486d8f1..e6db7d2 100644
--- a/apps/toldo-app/version.properties
+++ b/apps/toldo-app/version.properties
@@ -1,2 +1,2 @@
-versionName=0.0.5
-versionCode=5
+versionName=0.0.6
+versionCode=6
diff --git a/openspec/changes/harden-database-bootstrap-reset/.openspec.yaml b/openspec/changes/harden-database-bootstrap-reset/.openspec.yaml
new file mode 100644
index 0000000..7ccf7c3
--- /dev/null
+++ b/openspec/changes/harden-database-bootstrap-reset/.openspec.yaml
@@ -0,0 +1,2 @@
+schema: spec-driven
+created: 2026-10-25
diff --git a/openspec/changes/harden-database-bootstrap-reset/design.md b/openspec/changes/harden-database-bootstrap-reset/design.md
new file mode 100644
index 0000000..e5e9554
--- /dev/null
+++ b/openspec/changes/harden-database-bootstrap-reset/design.md
@@ -0,0 +1,23 @@
+# Design
+
+## Context
+
+Dexie abre la base al ejecutar la primera consulta. El esquema tiene migraciones 1, 2 y 3, pero `main.ts` monta Vue inmediatamente y no distingue una base en migración de un error de operación.
+
+## Goals / Non-Goals
+
+**Goals:** hacer explícita la apertura, evitar operaciones contra una base no lista, ofrecer recuperación manual y preservar datos durante actualizaciones compatibles.
+
+**Non-Goals:** borrar o reconstruir automáticamente una base con error, sincronizar datos con servidor o reemplazar las migraciones Dexie.
+
+## Decisions
+
+- `db.open()` se ejecutará antes de montar la aplicación.
+- Un fallo de apertura montará una vista mínima de recuperación con mensaje técnico resumido y botón de reset destructivo.
+- El reset se expondrá también desde Exportar/Importar, exigiendo confirmación y recomendando exportar antes.
+- Las migraciones se mantendrán como versiones Dexie; cada cambio futuro de esquema deberá agregar una versión y upgrade explícito.
+
+## Risks / Trade-offs
+
+- El usuario puede resetear por error -> confirmación explícita y texto de pérdida de datos.
+- Una base realmente corrupta puede no permitir exportación -> la pantalla explicará que el reset es último recurso.
diff --git a/openspec/changes/harden-database-bootstrap-reset/proposal.md b/openspec/changes/harden-database-bootstrap-reset/proposal.md
new file mode 100644
index 0000000..7cf704c
--- /dev/null
+++ b/openspec/changes/harden-database-bootstrap-reset/proposal.md
@@ -0,0 +1,29 @@
+# Proposal
+
+## Why
+
+La app abre Dexie de forma implícita y no informa cuando una migración o apertura de IndexedDB falla. Esto puede parecer una pérdida de datos y obliga a borrar manualmente el almacenamiento para continuar.
+
+## What Changes
+
+- Abrir y validar la base local antes de montar Vue.
+- Mostrar una pantalla de recuperación si la apertura/migración falla.
+- Añadir reset manual del entorno desde Exportar/Importar, con confirmación destructiva.
+- Mantener las migraciones Dexie y documentar que nunca deben borrar datos automáticamente.
+- Añadir pruebas de persistencia y reset.
+
+## Capabilities
+
+### New Capabilities
+
+- `database-bootstrap-recovery`: apertura explícita, diagnóstico y recuperación controlada de IndexedDB.
+
+### Modified Capabilities
+
+- `toldo-poc`: persistencia local y operación offline.
+
+## Impact
+
+- `packages/data`: bootstrap/reset de base.
+- `apps/toldo-app`: arranque, pantalla de error y mantenimiento.
+- Tests Vitest, documentación de agentes y APK.
diff --git a/openspec/changes/harden-database-bootstrap-reset/specs/database-bootstrap-recovery/spec.md b/openspec/changes/harden-database-bootstrap-reset/specs/database-bootstrap-recovery/spec.md
new file mode 100644
index 0000000..70b8127
--- /dev/null
+++ b/openspec/changes/harden-database-bootstrap-reset/specs/database-bootstrap-recovery/spec.md
@@ -0,0 +1,33 @@
+# Spec Delta
+
+## Purpose
+
+Protege los datos locales durante actualizaciones y ofrece una recuperación explícita cuando IndexedDB no puede abrirse o migrarse.
+
+## ADDED Requirements
+
+### Requirement: Apertura explícita de base
+The system SHALL open and complete local database migrations before allowing operational views to run.
+
+#### Scenario: Actualización compatible
+- **GIVEN** data exists in an older supported schema
+- **WHEN** the app starts after an update
+- **THEN** migrations complete before the main UI mounts
+- **AND** existing records remain available
+
+### Requirement: Recuperación ante error
+The system SHALL show a recovery screen when the local database cannot be opened.
+
+#### Scenario: Migración fallida
+- **WHEN** database opening fails
+- **THEN** the app shows an actionable error
+- **AND** no operational action is rendered as if data were empty
+- **AND** user can explicitly reset local data
+
+### Requirement: Reset manual
+The system SHALL require explicit confirmation before deleting all local data.
+
+#### Scenario: Reset confirmado
+- **WHEN** user confirms reset from maintenance
+- **THEN** local database is deleted and recreated on reload
+- **AND** the app starts with an empty environment
diff --git a/openspec/changes/harden-database-bootstrap-reset/tasks.md b/openspec/changes/harden-database-bootstrap-reset/tasks.md
new file mode 100644
index 0000000..099ba18
--- /dev/null
+++ b/openspec/changes/harden-database-bootstrap-reset/tasks.md
@@ -0,0 +1,12 @@
+# Tasks
+
+## 1. Bootstrap y recuperación
+
+- [x] 1.1 Añadir apertura explícita Dexie antes de montar Vue y vista de error recuperable
+- [x] 1.2 Añadir helper de reset local sin usarlo automáticamente
+- [x] 1.3 Añadir reset manual en Exportar/Importar con confirmación
+
+## 2. Verificación
+
+- [x] 2.1 Cubrir apertura, persistencia y reset con tests
+- [x] 2.2 Ejecutar tests, `vue-tsc`, Playwright y build/APK
diff --git a/openspec/changes/standardize-app-version/proposal.md b/openspec/changes/standardize-app-version/proposal.md
index 4f48af0..f8de034 100644
--- a/openspec/changes/standardize-app-version/proposal.md
+++ b/openspec/changes/standardize-app-version/proposal.md
@@ -8,7 +8,7 @@ La aplicación usa versiones distintas o hardcodeadas entre npm, Android y las e
 
 - Definir `versionName` y `versionCode` en un archivo versionado compartido.
 - Usar esos valores en Gradle, npm y exportaciones JSON.
-- Publicar la siguiente versión como `0.0.5` con `versionCode 5`.
+- Publicar la siguiente versión como `0.0.6` con `versionCode 6`.
 - Validar el `applicationId` y la versión en el APK generado.
 
 ## Capabilities
diff --git a/openspec/changes/standardize-app-version/specs/app-versioning/spec.md b/openspec/changes/standardize-app-version/specs/app-versioning/spec.md
index 50a6b1c..95b05c9 100644
--- a/openspec/changes/standardize-app-version/specs/app-versioning/spec.md
+++ b/openspec/changes/standardize-app-version/specs/app-versioning/spec.md
@@ -9,10 +9,10 @@ Asegura que cada actualización de ToldoConjunto pueda identificarse y actualiza
 ### Requirement: Versionado consistente
 The system SHALL expose the same semantic version in npm metadata, exported data, and Android versionName.
 
-#### Scenario: Version 0.0.5
+#### Scenario: Version 0.0.6
 - **WHEN** the app is built
-- **THEN** npm and exported data report `0.0.5`
-- **AND** Android reports versionName `0.0.5` and versionCode `5`
+- **THEN** npm and exported data report `0.0.6`
+- **AND** Android reports versionName `0.0.6` and versionCode `6`
 
 ### Requirement: Identidad Android estable
 The system SHALL preserve the application id `com.ilusion.toldoconjunto` across releases.
diff --git a/openspec/changes/standardize-app-version/tasks.md b/openspec/changes/standardize-app-version/tasks.md
index 803bca5..c6e17b6 100644
--- a/openspec/changes/standardize-app-version/tasks.md
+++ b/openspec/changes/standardize-app-version/tasks.md
@@ -2,7 +2,7 @@
 
 ## 1. Versionado
 
-- [x] 1.1 Crear la fuente compartida con `versionName=0.0.5` y `versionCode=5`, y actualizar npm/exportaciones
+- [x] 1.1 Crear la fuente compartida con `versionName=0.0.6` y `versionCode=6`, y actualizar npm/exportaciones
 - [x] 1.2 Configurar Gradle para leer la fuente compartida y conservar el applicationId
 - [x] 1.3 Añadir test que compruebe versionado y compatibilidad de exportación
 
diff --git a/packages/data/src/db/schema.ts b/packages/data/src/db/schema.ts
index 2438bac..bd8d311 100644
--- a/packages/data/src/db/schema.ts
+++ b/packages/data/src/db/schema.ts
@@ -52,3 +52,13 @@ export class ToldoDB extends Dexie {
 }
 
 export const db = new ToldoDB();
+
+export async function openDatabase() {
+  await db.open();
+  return db;
+}
+
+export async function resetDatabase() {
+  await db.delete();
+  await db.open();
+}
diff --git a/packages/services/src/export-import/ExportImportService.ts b/packages/services/src/export-import/ExportImportService.ts
index 141e763..0635199 100644
--- a/packages/services/src/export-import/ExportImportService.ts
+++ b/packages/services/src/export-import/ExportImportService.ts
@@ -19,7 +19,7 @@ export interface ExportData {
 }
 
 export const CURRENT_SCHEMA_VERSION = 1;
-export const APP_VERSION = '0.0.5';
+export const APP_VERSION = '0.0.6';
 
 export class ExportImportService {
   exportAll(data: ExportData['data']): ExportData {