Cómo Migrar desde una Instalación Antigua

Esta guía importa tus datos existentes desde una instalación antigua de HandyCafe V3 o V4 a un servidor moderno de HandyCafe. La migración no es destructiva para la fuente: los archivos originales no se modifican ni eliminan.

La migración de la base de datos se ejecuta solo en Windows. El soporte en tiempo de ejecución para que los clientes antiguos se conecten a través del protocolo original funciona en todas las plataformas (ver Configuración de Clientes Antiguos).

Qué Necesitarás

• Una máquina con Windows con la instalación antigua y el servidor moderno de HandyCafe en el mismo sistema, o acceso al archivo de la base de datos antigua.
• Acceso de administrador al Servidor HandyCafe.
• El servidor antiguo detenido. La base de datos fuente no debe estar siendo escrita activamente durante la migración.
• Espacio libre en disco al menos igual al tamaño de la base de datos antigua (para la nueva copia de la base de datos de HandyCafe).
• De 10 a 30 minutos de tiempo ininterrumpido. Las migraciones en conjuntos de datos grandes pueden tardar varios minutos. No cierres HandyCafe durante la ejecución.

Paso 1: Detener el Servidor Antiguo

Abre la aplicación del servidor antiguo de HandyCafe. Detén todas las sesiones y cierra la aplicación. Si el servidor antiguo se ejecuta como un servicio de Windows, detén el servicio desde services.msc.

Resultado esperado: El proceso del servidor antiguo ya no está en ejecución. El archivo de la base de datos no está abierto.

Paso 2: Abrir la Página de Configuración de Clientes Antiguos

1. Inicia HandyCafe.
2. Abre Configuración en la barra lateral.
3. Haz clic en Clientes Antiguos.
4. Desplázate a la sección Migración de Base de Datos.

Resultado esperado: Si el sistema detecta una instalación antigua, la página muestra la ruta de instalación, la ruta de la base de datos, la versión del servidor y el conteo de archivos INI. Si no se detecta nada, la página dice "No se detectó instalación antigua". En ese caso, verifica que los archivos antiguos existan en una ubicación estándar como Program Files\HandyCafe o C:\HandyCafe.

Paso 3: Revisar la Instalación Detectada

Verifica que los valores detectados coincidan con tu instalación antigua conocida:

Si algún campo es incorrecto, cierra HandyCafe, corrige la instalación y vuelve a abrir.

Paso 4: Verificar el Campo de Codificación

Antes de ejecutar la migración, confirma que el campo Codificación en la sección de Protocolo de Tiempo de Ejecución esté configurado correctamente para tus datos fuente. Esto se encuentra en la misma página de configuración, más arriba.

Si cambias la codificación, haz clic en Guardar antes de continuar.

Resultado esperado: Las cadenas de origen se decodificarán correctamente durante la migración, lo que evita un resultado completed_with_warnings.

Paso 5: Iniciar la Migración

1. Haz clic en Iniciar Migración.
2. Se abre un modal de progreso. Muestra la fase actual y el número de filas procesadas hasta el momento.
3. No cierres HandyCafe ni pongas la computadora en modo de suspensión.
4. Espera a que termine. Los conjuntos de datos pequeños terminan en menos de un minuto. Los conjuntos de datos más grandes pueden tardar de 5 a 10 minutos.

Resultado esperado: El modal de progreso se cierra y el estado cambia a completed o completed_with_warnings. Aparece una notificación confirmando la ejecución.

Paso 6: Revisar los Conteos Migrados

Después de completar, la página muestra los conteos de registros migrados:

Haz clic en el expansor de Detalles para ver el desglose completo. Verifica que los conteos parezcan razonables en comparación con tus expectativas.

Resultado esperado: Las cuatro categorías (miembros, productos, pedidos, transacciones) muestran conteos no cero si tu fuente tenía datos en esas tablas.

Paso 7: Manejar Advertencias (Si las Hay)

Si el estado es completed_with_warnings, expande la lista de advertencias y revisa los registros omitidos.

Advertencias comunes y sus soluciones:

Resultado esperado: Aceptas las advertencias como pérdidas conocidas y aceptables o solucionas el problema subyacente y vuelves a ejecutar.

Paso 8: Verificar Datos Importados

Antes de retirar el servidor antiguo, verifica manualmente una muestra de cada tipo de registro.

1. Abre Miembros en la barra lateral. Busca un miembro que conozcas del sistema antiguo. Confirma nombre, saldo e información de contacto.
2. Abre Configuración > Precios. Confirma que las tarifas por hora coincidan con el horario antiguo.
3. Abre Productos. Confirma nombres y precios de productos.
4. Abre Informe de Caja para un día histórico reciente. Confirma que los totales coincidan con lo que esperas del sistema antiguo.

Resultado esperado: Las muestras aleatorias coinciden con la fuente antigua. Si un registro particular es incorrecto, anota el problema. Las diferencias menores de formato son normales. Las discrepancias importantes sugieren un problema de codificación o integridad de datos que vale la pena investigar antes de entrar en producción.

Paso 9: Habilitar Soporte de Tiempo de Ejecución para Clientes Antiguos (Opcional)

Si deseas que tus máquinas cliente V3 o V4 existentes sigan conectándose mientras haces la transición, habilita el protocolo de tiempo de ejecución ahora.

1. Desplázate hasta la parte superior de la página de configuración de Clientes Antiguos.
2. Activa Habilitar Soporte para Clientes Antiguos.
3. Confirma que los puertos de escucha (UDP 710, TCP 712, transferencia de archivos 717) no entren en conflicto con nada más en tu red.
4. Haz clic en Guardar.

Resultado esperado: Los clientes antiguos en la LAN aparecen en el Panel de Administración dentro de 5 a 10 segundos. Consulta Clientes Antiguos para saber cómo gestionarlos desde el panel.

Cómo Deshacer una Migración

Si la migración produjo resultados inesperados, puedes revertirla completamente. La base de datos antigua original no se toca.

1. Abre Configuración > Clientes Antiguos.
2. Desplázate a la sección de Migración de Base de Datos.
3. Haz clic en Deshacer Migración.
4. Confirma en el diálogo.

Cada fila migrada se elimina de HandyCafe. El estado vuelve a never. Luego puedes solucionar el problema subyacente (codificación, limpieza de datos fuente, etc.) y ejecutar Iniciar Migración nuevamente.

Cómo Volver a Ejecutar una Migración

Volver a ejecutar reemplaza los datos migrados con datos frescos de la fuente.

1. Abre Configuración > Clientes Antiguos.
2. Haz clic en Volver a Ejecutar Migración (el botón se renombra de Iniciar Migración después de la primera ejecución completada).
3. El flujo es idéntico a la ejecución inicial.

Volver a ejecutar es seguro de usar tantas veces como necesites. No duplica datos porque reemplaza la salida de la migración existente.

Errores Comunes a Evitar

• Ejecutar la migración mientras el servidor antiguo está activo. La base de datos fuente puede estar bloqueada o contener escrituras parciales. Siempre detén el servidor antiguo primero.
• Ignorar el campo de Codificación. Ejecutar con la codificación incorrecta corrompe los nombres de los miembros y los mensajes de registro. Corregir esto después requiere Deshacer y Volver a Ejecutar.
• Cerrar HandyCafe durante la migración. La ejecución se interrumpe y se escriben datos parciales. La recuperación requiere Deshacer. Siempre deja que el modal de progreso complete.
• Omitir el paso de verificación. Confiar en los conteos de registros sin verificar datos de muestra pasa por alto problemas sutiles como desajustes de configuración regional o errores de redondeo.
• Eliminar la instalación antigua demasiado pronto. Conserva los archivos fuente durante al menos un ciclo de pago completo después de la migración. Si surge una discrepancia en un informe mensual, puedes referenciar los registros originales.
• Migrar sin una copia de seguridad. Copia la carpeta de instalación antigua antes de la primera migración. Aunque la fuente no se modifica por la migración, pueden ocurrir problemas de disco o accidentes. Una copia de seguridad es un seguro barato.