Guía de Instalación

1. Requisitos del sistema

1.1. PC Servidor (obligatorio)

1.2. Tablet (recomendada)

2. Descarga del programa

2.1. Descargar la versión de prueba

El procedimiento habitual para empezar a usar CleanControl es descargar la versión de prueba gratuita desde la web de TrazIA:

1. Accede a trazia.net desde el navegador de tu PC.
2. Ve a la sección Productos y selecciona CleanControl.
3. Pulsa el botón de descarga.
4. Se descargará el fichero Setup_CleanControl_v2.0.exe.

2.2. Descargas para clientes con licencia

Si ya has comprado la licencia y necesitas descargar nuevamente el instalador (por ejemplo, para reinstalar o actualizar), puedes hacerlo desde el área de clientes en trazia.net/client, donde también encontrarás la documentación actualizada.

3. Instalación paso a paso

3.1. Ejecutar el instalador

1. Localiza el fichero descargado en tu carpeta de Descargas: Setup_CleanControl_v2.0.exe.
2. Haz doble clic para ejecutarlo. Windows puede mostrar una pantalla azul de protección ("Windows protegió su equipo"). Pulsa "Más información" y luego "Ejecutar de todas formas".
3. Puede aparecer un aviso de Control de Cuentas de Usuario (UAC). Pulsa "Sí" para permitir la instalación.
4. Se abrirá el asistente de instalación.
5. Acepta la ruta propuesta (C:\Program Files\TrazIA\CleanControl) o elige otra.
6. Pulsa "Instalar" y espera a que se copien los archivos (unos segundos).
7. Al finalizar, marca "Iniciar CleanControl ahora" y pulsa "Finalizar".

3.2. Qué se instala

3.3. Carpetas de datos (creadas automáticamente)

4. Primer inicio y configuración

4.1. Iniciar CleanControl

1. Ejecuta CleanControl desde el acceso directo del escritorio o del Menú Inicio.
2. El programa se inicia en segundo plano. Para confirmar que está en ejecución, mira junto al reloj de Windows (bandeja del sistema): deberás ver el icono de CleanControl. Si no lo ves, pulsa la flecha ▲ de la bandeja para mostrar los iconos ocultos.
3. Automáticamente se abrirá el navegador con la página de login.
4. Introduce el usuario admin y la contraseña por defecto: admin123.

4.2. Configuración inicial recomendada

Una vez dentro, ve a Configuración y completa al menos estos campos:

1. Datos de empresa: nombre, logo, código de documento, revisión y selección de idioma (catalán, castellano o inglés).
2. Contraseña: cambiar "admin123" por una contraseña segura.
3. Catálogos (5 catálogos disponibles):
   • Puntos de limpieza: suelos, paredes, campanas extractoras, etc.
   • Máquinas: máquinas de producción del catálogo.
   • Mesas/Superficies: superficies de trabajo y mesas.
   • Utensilios: utensilios de limpieza y producción.
   • Vehículos: flota de vehículos (si el módulo de flota está activado).

   Cada catálogo incluye instrucciones de limpieza: producto, dosis, tiempo de actuación, materiales, procedimiento y tipo de limpieza.

4. Operarios: da de alta las personas que realizarán las limpiezas. Cada operario tiene un rol (admin, supervisor u operario) y acceso granular configurable a cada módulo de la tablet (Calendario General, Ciclo Operario, Ciclo Mensual, Producción, Flota, Incidencias).
5. Zonas internas: configura las zonas de limpieza con sus frecuencias (diaria, por intervalo de días laborables, ciclo de operario o ciclo mensual) y asigna los puntos, superficies y utensilios correspondientes.
6. Parámetros de valoración: revisa los parámetros de evaluación (Correcto, Repetir, Incorrecto) con sus colores e incidencias asociadas.
7. Motivos de limpieza: configura los motivos para los módulos de Producción (producción, mantenimiento, etc.) y Flota (limpieza rutinaria, mantenimiento, post-reparación, etc.).

5. Activación de la licencia

5.1. Licencia de prueba (Trial)

5.2. Activar la licencia (durante el periodo de prueba)

1. Abre CleanControl y ve a Configuración.
2. Selecciona la pestaña Licencia.
3. Pega el token de licencia (64 caracteres) que recibiste por email.
4. Pulsa "Activar licencia".
5. El sistema verificará la licencia con el servidor de trazia.net (necesita internet en este momento).
6. Si la activación es correcta, verás un mensaje de confirmación. La licencia queda vinculada a tu equipo.

5.3. Activar la licencia (tras expirar el periodo de prueba)

Cuando el periodo de prueba expira, CleanControl muestra la pantalla "Período de Prueba Finalizado". Desde esta pantalla puedes:

• Activar la licencia: pega tu código y pulsa "Activar". El programa se desbloqueará automáticamente.
• Aplicar código promocional: si tienes un código de colaborador, puedes introducirlo para extender el periodo de prueba a 30 días.
• Comprar la licencia: pulsa "Comprar Licencia" para ir a trazia.net. Una vez comprada, recibirás el código por email.

5.4. Verificación periódica

CleanControl realiza verificaciones periódicas de la licencia cuando hay conexión a internet disponible. Si el PC no tiene internet, el programa sigue funcionando con normalidad; la verificación se realizará cuando se restablezca la conexión.

5B. Integración con Claude Desktop (MCP)

CleanControl incluye un servidor MCP (Model Context Protocol) que permite conectar Claude Desktop directamente con los datos de la aplicación. Esto posibilita consultar registros, incidencias, zonas e informes mediante lenguaje natural desde el asistente de IA.

5B.1. Cómo funciona

Al arrancar CleanControl, el servidor MCP se lanza automáticamente en segundo plano como proceso oculto en el puerto 5102 (puerto de la aplicación 5002 + 100). No se requiere ninguna acción adicional por parte del administrador para que el servidor esté disponible.

CleanControl registra sus puertos en el fichero compartido C:\ProgramData\TrazIA\ports.json, que es leído por otras aplicaciones TrazIA del ecosistema para localizar el servicio automáticamente.

5B.2. Configurar Claude Desktop en el PC local

1. Abre CleanControl y ve a la sección Licencia desde el menú lateral.
2. En el apartado "Claude Desktop", pulsa el botón "Conectar con Claude Desktop".
3. CleanControl escribe automáticamente la configuración necesaria en Claude Desktop.
4. Si Claude Desktop estaba abierto, ciérralo y vuelve a abrirlo para que cargue la nueva configuración.

5B.3. Configurar Claude Desktop en PCs remotos (otros usuarios de la red)

Los usuarios que trabajan desde otros PCs de la misma red también pueden conectar su Claude Desktop al servidor MCP de CleanControl mediante un instalador automático:

1. El administrador accede a la sección Licencia en CleanControl.
2. Pulsa "Descargar instalador para usuario remoto". Se descarga el fichero instalar_trazia_mcp.bat.
3. El administrador envía ese fichero al usuario remoto (por email, mensajería o carpeta compartida de red).
4. El usuario remoto hace doble clic en instalar_trazia_mcp.bat. El script configura automáticamente Claude Desktop y no requiere conocimientos técnicos.
5. El usuario remoto reinicia Claude Desktop.

5B.4. Verificar que el servidor MCP está activo

Para comprobar que el servidor MCP está funcionando, abre un navegador en el PC servidor y accede a:

http://localhost:5102/

Si el servidor está activo, el navegador mostrará una respuesta del servicio MCP. Si no responde, reinicia CleanControl.

5B.5. Antivirus corporativo y firewall de empresa

En entornos con antivirus corporativo o firewall de empresa administrado por IT, puede ser necesario añadir excepciones manuales para que la conexión MCP funcione.

Síntoma típico: el .bat se ejecuta correctamente y aparece protocolVersion en pantalla, pero CleanControl no aparece en Claude Desktop › Configuración › Desarrollador.

• Antivirus en el PC del usuario remoto: excepción para python.exe o para conexión TCP saliente al puerto 5102 del servidor.
• Firewall de empresa: el departamento de IT debe permitir tráfico TCP al puerto 5102 desde los PCs de los usuarios al PC servidor de CleanControl.

6. Conectar la tablet

6.1. Requisitos de red

• WiFi: la tablet y el PC deben estar conectados a la misma red WiFi.
• Router: el router debe permitir comunicación entre dispositivos (sin aislamiento de clientes activado).
• Firewall: el puerto 5002 del PC debe estar accesible (ver sección 7.2).

6.2. Conexión mediante código QR (método recomendado)

CleanControl genera automáticamente un código QR que facilita la conexión de la tablet. Este QR está disponible en dos ubicaciones:

Opción A — Desde el panel de administración (sidebar)

1. Inicia sesión en CleanControl desde el PC.
2. En el menú lateral izquierdo (sidebar), verás un código QR en la parte inferior. Este QR se genera automáticamente con la dirección IP actual del PC.
3. Desde la tablet, abre la cámara o un lector de QR y escanea el código del sidebar.
4. Se abrirá automáticamente el formulario de registro en el navegador de la tablet.

Opción B — Pantalla QR a pantalla completa

1. Haz clic derecho sobre el icono de CleanControl en la bandeja del sistema (junto al reloj).
2. Selecciona "Abrir QR para Tablet".
3. Se abrirá una página dedicada con el código QR a gran tamaño, ideal para escanear cómodamente.
4. Escanea el QR desde la tablet.

6.3. Conexión manual (alternativa)

Si prefieres configurar la conexión manualmente o el QR no funciona:

1. En el PC, averigua la IP local (ejecuta ipconfig en CMD o mira en el Panel de control).
2. En la tablet, abre Chrome y escribe: http://[IP-del-PC]:5002/tablet
   (ejemplo: http://192.168.1.50:5002/tablet).
3. Debería aparecer el formulario de registro de limpieza.

6.4. Crear acceso directo en la tablet

Una vez conectada la tablet, guarda la página como acceso directo para no tener que escanear el QR cada día:

• Android (Chrome): Menú (⋮) > "Añadir a pantalla de inicio". Se creará un icono en el escritorio.
• iPad (Safari): Botón compartir > "Añadir a la pantalla de inicio".

7. Solución de problemas

7.1. La tablet no conecta con el PC

7.2. Configurar el Firewall de Windows

Si la tablet no puede conectar con el PC, es probable que el Firewall de Windows esté bloqueando el puerto 5002. Para solucionarlo:

1. Abre "Firewall de Windows con seguridad avanzada" (busca "firewall" en el menú Inicio).
2. En el panel izquierdo, haz clic en "Reglas de entrada".
3. En el panel derecho, haz clic en "Nueva regla...".
4. Selecciona "Puerto" y pulsa Siguiente.
5. Selecciona "TCP" y escribe "5002" en "Puertos locales específicos". Siguiente.
6. Selecciona "Permitir la conexión". Siguiente.
7. Marca las tres opciones (Dominio, Privado, Público). Siguiente.
8. Ponle nombre: "CleanControl - Puerto 5002". Finalizar.

7.3. Otros problemas comunes

8. Actualizaciones

8.1. Cómo actualizar

1. Cierra CleanControl desde la bandeja del sistema.
2. Descarga la nueva versión desde trazia.net (sección Productos o área de clientes).
3. Ejecuta el nuevo instalador. Se instalará encima de la versión anterior.
4. Inicia CleanControl. Todos los datos, registros y configuración se conservan.

8.2. Desinstalar

Si necesitas desinstalar CleanControl, ve a Panel de Control > Programas > Desinstalar > CleanControl. Los datos y backups en C:\BackupClean se conservan por seguridad y pueden eliminarse manualmente si ya no se necesitan.

9. Resumen rápido de instalación

Checklist para tener CleanControl operativo en menos de 20 minutos: