2 Commits

Author SHA1 Message Date
mono
488f383904 test: cubrir jornada completa en playwright 2026-10-25 21:46:48 -05:00
mono
6a3352a96c fix: preservar datos y recuperar base local 2026-10-25 21:27:44 -05:00
23 changed files with 240 additions and 18 deletions

View File

@@ -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.

View File

@@ -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",

View File

@@ -1,7 +1,7 @@
{
"name": "toldo-app",
"private": true,
"version": "0.0.5",
"version": "0.0.6",
"type": "module",
"scripts": {
"dev": "vite",

View File

@@ -3,6 +3,7 @@ import { defineConfig, devices } from '@playwright/test';
export default defineConfig({
testDir: './tests/e2e',
timeout: 30_000,
workers: 1,
use: { baseURL: 'http://127.0.0.1:4173', trace: 'on-first-retry' },
webServer: { command: 'npm run dev -- --host 127.0.0.1 --port 4173', url: 'http://127.0.0.1:4173', reuseExistingServer: true },
projects: [{ name: 'chromium', use: { ...devices['Desktop Chrome'], launchOptions: { executablePath: '/usr/bin/chromium' } } }, { name: 'mobile', use: { ...devices['Pixel 5'], launchOptions: { executablePath: '/usr/bin/chromium' } } }],

View File

@@ -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', () => {

View File

@@ -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);
});
});

View File

@@ -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'
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()

View File

@@ -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);

View File

@@ -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];

View File

@@ -0,0 +1,52 @@
import { expect, test } from '@playwright/test';
test.describe('jornada completa', () => {
test('abre jornada, crea catálogo, registra venta y gasto, y cierra caja', async ({ page }, testInfo) => {
test.skip(testInfo.project.name !== 'chromium', 'El flujo completo se ejecuta una vez en escritorio.');
await page.goto('/inventario');
await page.getByLabel('Nombre del productor').fill('Productor E2E');
await page.getByRole('button', { name: 'Agregar', exact: true }).click();
await expect(page.getByText('Productor E2E')).toBeVisible();
await page.getByRole('combobox', { name: 'Productor' }).click({ force: true });
await page.getByText('Productor E2E', { exact: true }).last().click();
await page.getByLabel(/Nombre\/Presentación/).fill('Producto E2E');
await page.getByLabel('Precio unitario').fill('12000');
await page.getByRole('button', { name: 'Agregar Producto' }).click();
await expect(page.getByText('Producto E2E')).toBeVisible();
await page.getByRole('combobox', { name: 'Producto', exact: true }).first().click({ force: true });
await page.locator('.v-overlay-container .v-list-item').filter({ hasText: 'Producto E2E' }).click();
await page.getByLabel('Cantidad').first().fill('3');
await page.getByRole('button', { name: 'Registrar Ingreso Inicial' }).click();
await expect(page.getByText('Ingreso inicial registrado.')).toBeVisible();
await page.goto('/jornada');
await page.getByLabel('Responsables (separados por coma)').fill('Ana E2E');
await page.getByLabel('Base inicial (efectivo)').fill('10000');
const openDialog = page.waitForEvent('dialog');
await page.getByRole('button', { name: 'Abrir Jornada' }).click();
await (await openDialog).accept();
await expect(page.getByText(/Jornada ABIERTA/)).toBeVisible();
await page.goto('/ventas');
await expect(page.getByText('Disponible: 3')).toBeVisible();
await page.getByText('Producto E2E', { exact: true }).first().click({ force: true });
await expect(page.getByRole('button', { name: /Cobrar/ })).toContainText('12,000');
await page.getByLabel('Efectivo recibido').fill('20000');
await expect(page.getByText('Devuelta: $8,000')).toBeVisible();
await page.getByRole('button', { name: /Cobrar/ }).click();
await expect(page.getByText(/Venta registrada/)).toBeVisible();
await page.goto('/gastos');
await page.getByLabel('Concepto').fill('Bolsas E2E');
await page.getByLabel('Monto').fill('2000');
await page.getByRole('button', { name: 'Registrar gasto' }).click();
await expect(page.getByText('Bolsas E2E')).toBeVisible();
await page.goto('/jornada');
await page.getByLabel('Efectivo contado (obligatorio)').fill('20000');
await page.getByRole('button', { name: 'Cerrar caja y jornada' }).click();
await expect(page.getByText(/Cierre de caja y jornada completado/)).toBeVisible();
});
});

View File

@@ -1,2 +1,2 @@
versionName=0.0.5
versionCode=5
versionName=0.0.6
versionCode=6

View File

@@ -0,0 +1,2 @@
schema: spec-driven
created: 2026-10-25

View File

@@ -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.

View File

@@ -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.

View File

@@ -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

View File

@@ -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

View File

@@ -24,5 +24,5 @@
- [x] 4.5 Dashboard con jornada activa
## 5. Tests Playwright
- [ ] 5.1 Setup Playwright
- [ ] 5.2 Test caso uso completo: abrir jornada, agregar productos, venta múltiple, gastos, cierre
- [x] 5.1 Setup Playwright
- [x] 5.2 Test caso uso completo: abrir jornada, agregar productos, venta múltiple, gastos, cierre

View File

@@ -23,8 +23,8 @@
## 4. Testing
- [x] 4.1 Setup Playwright
- [ ] 4.2 Add realistic service cases for QR, discrepancies, reports, and export
- [ ] 4.3 Test full day browser flow
- [x] 4.2 Add realistic service cases for QR, discrepancies, reports, and export
- [x] 4.3 Test full day browser flow
- [x] 4.4 Test responsive navigation and empty setup state
## 5. Build & Deploy

View File

@@ -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

View File

@@ -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.

View File

@@ -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

View File

@@ -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();
}

View File

@@ -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 {