Tauri React + Nest LAN Migration

Aplicar este flujo en orden para minimizar riesgos en migraciones Web -> Desktop.

Flujo recomendado

1. Planificar migracion
2. Implementar cambios en backend/frontend/tauri
3. Verificar setup, login y CRUD con logs
4. Preparar release instalable

Reglas LAN obligatorias

• Backend desktop siempre local: 127.0.0.1
• Base de datos remota: IP fija del servidor en database.host
• No usar localhost como host de DB en clientes LAN

Logs a revisar primero

• %APPDATA%/sistema-caja/debug_startup.log
• %APPDATA%/sistema-caja/logs/error-YYYY-MM-DD.log
• %APPDATA%/sistema-caja/logs/application-YYYY-MM-DD.log

Diagnostico rapido de errores frecuentes

• Cannot POST /api/config/test

  • Backend en modo normal y no en setup

• failed to fetch

  • Backend caido o reiniciando (race de arranque)

• Unexpected token al parsear config

  • Archivo con BOM (ej. config.json)

• os error 2

  • Path o nombre de sidecar mal resuelto

• os error 32

  • Archivos bloqueados durante extraccion/uso

• Nest can't resolve JwtAuthGuard (JwtService)

  • Modulo de auth no importado/exportado donde corresponde

Checklist de verificacion minima

• Setup inicial abre y guarda configuracion
• Login funciona con backend sidecar
• CRUD critico funciona con DB remota por IP
• No hay errores bloqueantes en logs de startup

Criterio Go/No-Go

• Go: setup + login + CRUD + logs estables
• No-Go: errores de sidecar, caidas de backend, o fallas en auth/DB