Descargas y puesta en marcha

1. CLI de sincronización

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

3. Ejemplos de configuración

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

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 — 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 5 — 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.