Learn-skills.dev tauri-react-nest-lan-migration

Migrar aplicaciones React + NestJS + Postgres desde web a desktop con Tauri en entornos LAN. Usar cuando se necesite planificar, implementar, verificar y preparar release con backend local en 127.0.0.1, base remota por IP fija, sidecar estable y diagnostico de logs de arranque.

install
source · Clone the upstream repo
git clone https://github.com/NeverSight/learn-skills.dev
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/NeverSight/learn-skills.dev "$T" && mkdir -p ~/.claude/skills && cp -r "$T/data/skills-md/agustinalbonico/ai-customizations/tauri-react-nest-lan-migration" ~/.claude/skills/neversight-learn-skills-dev-tauri-react-nest-lan-migration && rm -rf "$T"
manifest: data/skills-md/agustinalbonico/ai-customizations/tauri-react-nest-lan-migration/SKILL.md
source content

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