Descargas y puesta en marcha

1. Asistente de puesta en marcha

Descarga el asistente Arranque Navis, ejecútalo en el servidor Windows del cliente y sigue las instrucciones. Configura automáticamente el CLI, los ficheros de configuración, las empresas y genera los scripts para la primera carga y la tarea programada.

Consulta el historial de versiones para saber qué incluye cada publicación. Para ver la versión instalada de un CLI ejecuta nauticus-cli.exe --version.

2. CLI de sincronización (manual)

Si prefieres configurar manualmente, descarga el CLI y los scripts por separado.

3. App móvil para técnicos

4. Scripts de ayuda

Descarga también los scripts para cmd.exe o PowerShell. Recomendamos PowerShell porque evita problemas de codificación BOM y extensiones ocultas de Windows.

5. Ejemplos de configuración

6. Tutorial rápido de puesta en marcha

Paso 1 — Crear el cliente en el SaaS

1. Accede a https://saas.navisapp.eu como administrador.
2. Ve a Clientes y haz clic en Nuevo cliente.
3. Rellena el nombre de la empresa y el subdominio (p. ej. nautica-martinez). La PWA quedará en https://nautica-martinez.navisapp.eu.
4. Guarda la API Key que se muestra en el modal. Si la pierdes, puedes rotarla desde el listado de clientes.

Paso 2 — Crear el primer usuario de la PWA

1. En el listado de clientes, haz clic en el icono Usuarios del cliente creado.
2. Crea un nuevo usuario con nombre, email, contraseña y rol admin.
3. Accede a la PWA en https://{subdominio}.navisapp.eu con ese usuario.

Paso 3 — Preparar el servidor Windows

Opción A — Con el asistente Arranque Navis (recomendado)

1. Descarga y ejecuta arranque-navis-amd64.exe (o la versión de 32 bits) en el servidor Windows del cliente. Si el antivirus lo bloquea, añade una exclusión temporal para la carpeta de descargas.
2. Responde a las preguntas del asistente: carpeta de instalación (por defecto C:\Ibizant\Nautica_5.0\Navis), datos de Firebird, API Key y empresas.
3. El asistente descargará el CLI y creará los ficheros de configuración. Al final generará dos scripts adicionales:
   • first-load.bat → para hacer el login y la primera sincronización.
   • crear-tareas.bat → para registrar las tareas programadas de Windows.
   Ejecútalos manualmente: first-load.bat con doble clic y crear-tareas.bat con clic derecho → Ejecutar como administrador.

Opción B — Manual

1. Crea una carpeta, por ejemplo C:\Nauticus\.
2. Copia allí el nauticus-cli.exe correspondiente a tu arquitectura, los scripts y los ejemplos.
3. Crea el archivo .env en esa misma carpeta:

   TRITON_API_KEY=tk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
   FB_PASSWORD=masterkey

   Importante: el archivo debe llamarse exactamente .env, no .env.txt. Windows oculta las extensiones conocidas. Compruébalo con dir en cmd.exe y, si es necesario, renómbralo con rename .env.txt .env.
4. Crea el archivo %USERPROFILE%\.nauticus.yaml (por ejemplo C:\Users\Administrador\.nauticus.yaml):

   api_url: "https://api.navisapp.eu"
   interval: 300
   
   firebird_host: "localhost"
   firebird_port: 3050
   firebird_user: "SYSDBA"
   
   companies:
     - name: "Taller Náutico Martínez"
       tenant_id: "nautica-martinez"
       database: "C:\\Firebird\\data\\YATE.fdb"

   Importante: el campo name debe coincidir exactamente con el nombre del cliente en el SaaS (incluyendo mayúsculas, minúsculas y tildes). El tenant_id es solo el subdominio.
   Ajusta name, tenant_id y la ruta del .fdb.

Paso 4 — Configurar los mappings outbound (PWA/App → Firebird)

El CLI sincroniza Firebird → PostgreSQL por defecto. Para que los datos creados en la PWA o App (tiempos trabajados, capítulos, líneas de pedido, fotos) vuelvan a Firebird, necesitas los mappings outbound.

1. Descarga mappings.zip y descomprímelo dentro de la carpeta del CLI. Debe quedar una carpeta mappings\outbound\ al lado de nauticus-cli.exe.
2. Dentro de mappings\outbound\ encontrarás:
   • time_entries.yaml → tiempos trabajados (tabla Firebird Y00X1).
   • work_order_chapters.yaml → capítulos de OT (tabla Firebird Y00X0).
   • order_lines.yaml → líneas de pedido/material (tabla Firebird Y000Y).
   • time_entry_photos.yaml → fotos de los partes (tabla Firebird ENXPRFOTO).
3. Revisa y ajusta cada YAML a las tablas y columnas reales del cliente. Por ejemplo, en time_entries.yaml se asume por defecto la tabla Y00X1; si el cliente usa otra nomenclatura, edita firebird_table y el mapeo de columns.

Paso 5 — Probar la sincronización

1. Abre cmd.exe o PowerShell en la carpeta del CLI.
2. Ejecuta login.bat (o login.ps1 con PowerShell). Si es correcto, guardará los tokens en %USERPROFILE%\.nauticus\tokens\.
3. Ejecuta run-sync-once.bat (o run-sync-once.ps1) para una sincronización de prueba.
4. Si funciona, ejecuta run-sync.bat para mantener la sincronización continua. Para producción, configúralo como servicio de Windows o con el Programador de tareas.

Paso 6 — Verificar en la PWA

1. Accede a https://{subdominio}.navisapp.eu.
2. Inicia sesión con el usuario creado.
3. Comprueba que aparecen clientes, embarcaciones y órdenes de trabajo sincronizadas desde Firebird.