Configuración

Casi todo se cambia desde la tablet, en Configuración. Esta página explica qué se guarda dónde y qué valores admite cada opción.

Empieza aquí: lo esencial#

Si es tu primera vez, no necesitas leer toda la página. Casi todo se hace desde la propia tablet, con botones y sin tocar archivos. Lo único que se hace fuera de la tablet es completar un archivo de texto en el servidor, una sola vez (mira «Variables del servidor»).

Palabras que verás en esta página#

• Servidor: el ordenador en internet (tu hosting o un VPS) donde vive Trucks-MDT. Los PCs de los conductores se conectan a él.
• Cliente: el programa de Windows que se instala en cada PC.
• Archivo .env: un archivo de texto en el servidor con los datos de tu empresa (dirección, claves, correo). Se completa una vez.
• Variable: cada línea del .env, con la forma NOMBRE=valor.
• Reiniciar el servidor: en cPanel, Setup Node.js App › botón Restart. Hace falta después de cambiar el .env.
• IP pública: la «dirección» del servidor en internet. Tu licencia está atada a ella.
• SMTP: los datos para enviar correos desde tu servidor. Te los da tu hosting.
• Avanzado: las secciones marcadas así son para quien administra muchos PCs o el servidor a fondo; puedes saltártelas.

Dónde viven las opciones de configuración (referencia)#

Respaldos: copia la carpeta backend/var/ (contiene la base, la marca y la licencia). node src/cli.js backup genera una copia segura con el servidor en marcha.

Variables del servidor (.env)#

Copia backend/.env.example como backend/.env y completa, como mínimo, las cuatro primeras:

Cómo editar el archivo .env#

En cPanel (lo más común):

1. Entra a cPanel › Administrador de archivos. Arriba a la derecha, en Configuración, marca Mostrar archivos ocultos (el .env empieza por un punto, por eso no se ve).
2. Abre la carpeta backend. Haz clic derecho en .env.example › Copy y ponle de nombre .env.
3. Clic derecho en .env › Edit. Cambia los valores que están después del = y pulsa Save Changes.
4. Ve a cPanel › Setup Node.js App y pulsa Restart. Sin reiniciar, los cambios no se aplican.

En un VPS: cp .env.example .env y nano .env; guarda con Ctrl+O y reinicia el servicio.

Un ejemplo de cómo queda (los valores son inventados; usa los tuyos):

PUBLIC_URL=https://trucks.miempresa.com
COMPANY_NAME=Mi Empresa de Transporte
NODE_ENV=production
DRIVER_JOIN_MODE=invite

Las claves secretas (SESSION_SECRET y TOKEN_PEPPER) son textos largos al azar. Si no tienes terminal, usa cualquier generador de contraseñas de 64 caracteres (letras y números) y pega el resultado. Guárdalas en un lugar seguro y no las compartas.

La base de datos no se configura: es un archivo SQLite que se crea en backend/var/mdt.db. Para usar otra ruta, define DATABASE_FILE; para mover toda la carpeta de datos, VAR_DIR.

Marca (nombre, logotipo y colores)#

El dueño cambia la marca desde la tablet, sin tocar archivos: Configuración › Marca. Los cambios se guardan en el servidor y los ven todos los equipos al abrirse.

El botón Restablecer valores de fábrica deshace los cambios. Los valores de fábrica se editan en backend/config/brand.default.json:

{
  "name": "Mi Marca",
  "company": "Mi Empresa de Transporte",
  "product": "Mi Tablet",
  "welcome": "Bienvenido a {company}",
  "accent": "#0a84ff",
  "accentLight": "#007aff"
}

El ícono del archivo .exe que muestra Windows se fija al compilar el programa; el ícono de la ventana sí cambia con el logotipo.

Licencia#

En Configuración › Licencia (solo el dueño) ves el estado, el licenciatario y la IP del servidor, y puedes instalar un archivo nuevo. El modo empresa depende de ella; los conductores no.

node src/cli.js license /ruta/license.json   # instala la licencia
node src/cli.js license status               # muestra el estado

Cliente de Windows#

servidor.txt#

El instalador escribe la dirección del servidor en %AppData%\TrucksMDT\servidor.txt. Puedes editarlo con un editor de texto: una sola línea con la dirección; las líneas que empiezan por # se ignoran.

# Servidor de tu empresa para este cliente (una sola línea)
https://tu-servidor.com

La dirección debe empezar por http:// o https://. El cliente busca primero en esa carpeta y después junto al programa; si no encuentra ninguna válida, usa http://localhost:3000, pensado para desarrollo. Cada usuario puede cambiar el servidor después en Configuración › Cuenta y sesión.

settings.json (avanzado)#

Solo para quien necesita entender el cliente a fondo: normalmente no hay que tocarlo. Se guarda en %AppData%\TrucksMDT. El cliente lo crea y actualiza por su cuenta; estos son los campos y sus valores por defecto:

{
  "ServerUrl": "",
  "InstallationToken": "",
  "IsAdmin": false,
  "LinkedUserId": "",
  "GameDirs": {},
  "OverlayHotkey": "F8",
  "OverlayJoyDevice": -1,
  "OverlayJoyButton": -1,
  "OverlayJoyName": "",
  "CabinEnabled": false,
  "CabinApp": "x:monitor"
}

Instalación silenciosa (avanzado)#

Solo si vas a instalar el cliente en muchos PCs a la vez; si es uno o dos, usa el instalador normal. Para repartirlo sin preguntas:

Ajustes de la tablet#

Desde Configuración cada usuario ajusta su propia tablet: fondo de pantalla, sonidos, notificaciones, idioma, moneda, tamaño de íconos y pantalla de bloqueo. En el escritorio, mantén pulsado un ícono para reordenar tus aplicaciones: arrástralas a cualquier hueco o a otra página.