Volumen I

VK Salón & Spa V1.0 fue concebido bajo tres pilares fundamentales que dictan su comportamiento operativo:

Estabilidad (Arquitectura Servidor-Cliente): A diferencia de aplicaciones que dependen de la nube y que fallan cuando el internet fluctúa, nuestro sistema opera bajo una red local de alta velocidad. Utilizamos tecnologías de nivel empresarial (Ktor y Netty) para asegurar que la comunicación entre su caja principal y sus terminales sea constante y confiable.

Velocidad (Experiencia Fluida): Gracias al uso de Jetpack Compose, la interfaz no solo es moderna y visualmente atractiva, sino que es extremadamente rápida. El personal de su salón no perderá tiempo esperando a que el sistema "reaccione".

Robustez (Persistencia Local): Entendemos que, en un negocio real, la electricidad o el internet pueden fallar. Por ello, integramos Room Database, permitiendo que cada terminal mantenga una base de datos local resistente, capaz de proteger la información durante cualquier eventualidad técnica.

El Paradigma de la Fuente Única de Verdad Este es el concepto más importante que usted debe dominar. En muchos sistemas POS (Puntos de Venta), cada tablet "cree" tener la razón, lo que genera errores de inventario, ventas duplicadas y discrepancias en el dinero al final del día.

En VK Salon & Spa V1.0, hemos eliminado ese riesgo mediante la Fuente Única de Verdad:

El Servidor es la Autoridad: Solo la Tablet Principal (el Servidor) tiene la última palabra sobre el stock, los precios y el estado de las citas.

Validación Atómica: Cuando una terminal cliente solicita realizar una venta, el servidor procesa esa solicitud en milisegundos. Si el servidor autoriza, la venta ocurre. Si el servidor detecta que el inventario ha cambiado, la venta se bloquea.

Paridad: No existen "registros fantasma". Si una cita se elimina en el servidor, desaparece de todas las pantallas al instante. Usted siempre verá exactamente lo mismo en todas sus terminales.

Nota del Experto: Este diseño garantiza que, sin importar cuántos empleados tenga atendiendo simultáneamente, sus reportes de fin de día siempre cuadrarán.

Este documento está diseñado para ser una herramienta viva. Le recomendamos:

Consultar los apartados técnicos antes de realizar cambios en su red local o en la configuración del router.

Utilizar el Volumen III como material de capacitación impreso para sus nuevos empleados.

Seguir los protocolos de seguridad descritos en el Volumen II para proteger su información corporativa y asegurar que los niveles de acceso (Administrador vs. Cajero) sean respetados.

Este capítulo detalla la ingeniería detrás de VK Salon & Spa V1.0. Entender estos fundamentos permitirá a los administradores y técnicos optimizar el rendimiento y comprender por qué nuestro sistema es superior a las soluciones basadas exclusivamente en la nube.

Entendiendo el Modelo Servidor/Cliente en Entornos Locales La arquitectura de VK Salon & Spa V1.0 no depende de una conexión a Internet externa para realizar ventas diarias. Utilizamos un modelo Servidor-Cliente de Red Local (LAN).

El Servidor (Caja Principal): Actúa como el nodo de control. Es donde reside la "Fuente Única de Verdad". Todo lo que sucede en el salón se registra aquí primero.

El Cliente (Terminal POS): Son las tablets auxiliares que se conectan de forma inalámbrica. Su trabajo es enviar comandos al servidor y mostrar información.

Ventaja Competitiva: Al operar en su red local, el sistema no se vuelve lento si el internet falla, ni se detiene si hay cortes de servicio externo. La velocidad de comunicación es de milisegundos, permitiendo una experiencia de usuario instantánea.

Motor de Conexión: Ktor y Servidor Interno Netty Para gestionar la comunicación entre el Servidor y múltiples Clientes, hemos implementado una infraestructura de alto rendimiento:

Ktor: Es nuestro marco de trabajo (framework) asíncrono para crear conexiones conectadas. Nos permite manejar múltiples terminales simultáneamente sin que el sistema se bloquee.

Netty: Es el "corazón" o motor de bajo nivel que impulsa el servidor. Netty es reconocido en la industria por su capacidad de procesar miles de eventos concurrentes con un consumo de recursos mínimo.

¿Qué significa esto para el negocio? Significa que usted puede tener múltiples cajeros, recepcionistas y especialistas interactuando con el sistema al mismo tiempo y el servidor responderá a todos de manera fluida, sin esperas ni "congelamientos" de pantalla.

Motor de Persistencia Local: Room Database y Resiliencia de Datos La pérdida de información es el peor escenario para cualquier negocio. Por ello, integramos Room Database, la tecnología más avanzada de Google para persistencia de datos en Android.

Resiliencia Total: Cada dispositivo guarda una copia de seguridad en su base de datos local. Si una tablet pierde la señal Wi-Fi por un segundo, la información no se borra; se protege localmente y se sincroniza automáticamente en cuanto se restablece la conexión.

Integridad: Room garantiza que las transacciones sean "atómicas". Esto significa que una operación (como registrar una venta y descontar stock) se completa totalmente o no se hace; nunca se queda a medias, evitando registros dañados o incorrectos.

Interfaz Reactiva y Adaptabilidad con Jetpack Compose El diseño visual es tan importante como el motor lógico. Utilizamos Jetpack Compose para desarrollar toda la interfaz de usuario:

Diseño Reactivo: La interfaz no es estática; reacciona al estado de los datos. Si el stock llega a cero, el botón de venta cambia automáticamente.

Adaptabilidad: Jetpack Compose nos permite que la aplicación se adapte nativamente a cualquier tamaño de pantalla.

Ya sea que utilice una tablet de 10 pulgadas en la recepción o una de 8 pulgadas en el área de servicio, la experiencia es profesional, ergonómica y visualmente moderna.

El Ciclo de Sincronización Ultra-Rápida (1s) y Paridad Absoluta El mayor problema de los sistemas POS multicaja es la desincronización (cuando una tablet muestra un inventario distinto a otra). VK Salon & Spa V1.0 resuelve esto con nuestro protocolo de Sincronización Atómica:

Ciclo de 1 Segundo: Cada terminal cliente consulta al servidor cada segundo (o ante cualquier evento de cambio). Esto garantiza que la información que ve su personal esté desfasada por máximo un segundo respecto a la realidad.

Paridad Absoluta: Gracias a este refresco constante, logramos que todas las pantallas actúen como un espejo. Si un usuario crea una cita o realiza una venta en el Servidor, el cambio se refleja en todas las tablets clientes inmediatamente. Esto elimina la necesidad de recargar pantallas manualmente o reiniciar aplicaciones.

Nota técnica: Gracias a esta arquitectura, hemos eliminado los "registros fantasma". La información es coherente, precisa y está disponible en todo el salón en tiempo real.

Para garantizar que VK Salon & Spa V1.0 opere con la fluidez, velocidad y fiabilidad que su arquitectura promete, es indispensable contar con un entorno de hardware y red configurado bajo estándares profesionales. Este capítulo detalla los componentes mínimos y recomendados.

Especificaciones Recomendadas para la Tablet Servidor (Caja Principal) La "Caja Principal" es el cerebro del sistema. Ejecuta simultáneamente el servidor Ktor/Netty, gestiona la base de datos local y despliega el Panel Administrativo. Sistema Operativo: Android 12.0 o superior (recomendado para gestión de procesos en segundo plano).

Procesador: Octa-core (mínimo 2.0 GHz) para asegurar la ejecución del servidor sin bloqueos.

Memoria RAM: : Mínimo 6 GB (Recomendado 8 GB). El servidor gestiona múltiples conexiones; una RAM mayor evita la saturación durante horas pico.

Almacenamiento: Mínimo 64 GB (se recomienda uso de memoria interna de alta velocidad tipo UFS para lecturas rápidas de base de datos).

Pantalla: 10 pulgadas o superior (resolución Full HD recomendada para visualizar el Panel Administrativo sin scroll excesivo).

Consejo Pro: Evite tablets de gama baja (tipo "económicas" o con versiones de Android modificadas agresivamente por el fabricante), ya que suelen limitar los procesos en segundo plano, lo que podría afectar la estabilidad del servidor interno.

Memoria RAM: : Mínimo 6 GB (Recomendado 8 GB). El servidor gestiona múltiples conexiones; una RAM mayor evita la saturación durante horas pico.

Almacenamiento: Mínimo 64 GB (se recomienda uso de memoria interna de alta velocidad tipo UFS para lecturas rápidas de base de datos).

Pantalla: 10 pulgadas o superior (resolución Full HD recomendada para visualizar el Panel Administrativo sin scroll excesivo).

Consejo Pro: Evite tablets de gama baja (tipo "económicas" o con versiones de Android modificadas agresivamente por el fabricante), ya que suelen limitar los procesos en segundo plano, lo que podría afectar la estabilidad del servidor interno.

Especificaciones Recomendadas para las Tablets Cliente (Terminales POS) Estas terminales son los puntos de venta de su salón. Aunque no almacenan la base de datos principal, requieren rapidez visual para la interfaz con Jetpack Compose.

Sistema Operativo: Android 11.0 o superior.

Procesador: Quad-core o superior.

Memoria RAM: Mínimo 3 GB.

Conectividad: Wi-Fi 5 (802.11ac) o superior obligatorio.

Pantalla: 8 a 10 pulgadas. La fluidez de la interfaz depende directamente de la capacidad de respuesta táctil del dispositivo.

Infraestructura de Red: Requisitos del Router Local (Wi-Fi 5 / Wi-Fi 6)La sincronización "Ultra-Rápida" de 1 segundo depende enteramente de la calidad de su red Wi-Fi.

La sincronización "Ultra-Rápida" de 1 segundo depende enteramente de la calidad de su red Wi-Fi.

Estándar Recomendado: Router con tecnología Wi-Fi 6 (802.11ax) o, como mínimo, Wi-Fi 5 (802.11ac).

Configuración: El Servidor debe estar, idealmente, más cerca del router o conectado mediante cable (si la tablet lo permite vía adaptador USB-C a Ethernet). Evite el uso de repetidores Wi-Fi de baja calidad, ya que aumentan el ping (latencia) y pueden causar que el mensaje "Conexión establecida" se interrumpa.

Modelos de Impresoras Térmicas Compatibles (Protocolo ESC/POS, 80mm)VK Salon & Spa V1.0 utiliza el estándar industrial ESC/POS, lo que garantiza compatibilidad con la gran mayoría de impresoras del mercado.

Ancho de papel: 80 mm (el estándar para recibos detallados).

Conectividad: Bluetooth: Ideal para estaciones de trabajo móviles (muy común en spas).

Wi-Fi/Ethernet: Recomendado si la impresora está en un punto fijo (recepción).

Verificación: Asegúrese de que el fabricante indique compatibilidad con "Android POS" o "ESC/POS".

Accesorios Opcionales: Lectores de Código de Barras y Cajones de DineroEl sistema está optimizado para integrar hardware que acelere su flujo de trabajo.

Lectores de Código de Barras: Cualquier lector que emule un teclado (HID - Human Interface Device) es compatible. Al escanear, el código se ingresa automáticamente en el campo de búsqueda del sistema.

Preferir lectores con conexión USB (vía adaptador OTG a la tablet) o Bluetooth para mayor movilidad.

Cajones de Dinero:Para automatizar la apertura, el cajón debe conectarse físicamente a la impresora térmica mediante el puerto RJ11 (puerto de "kick-out" o apertura de cajón). El sistema envía el comando a la impresora, y la impresora abre el cajón.

Agradecemos su confianza en VK Salón & Spa V1.0. Es un honor que este sistema forme parte de su operación diaria y contribuya a la excelencia de su negocio.

Valoramos que haya elegido una plataforma basada en estabilidad, velocidad y resiliencia local, diseñada para proteger sus datos y ofrecer una experiencia fluida a su equipo.

Finalmente, agradecemos su dedicación al aprendizaje y correcta implementación de cada componente descrito en esta guía. Este manual fue creado para acompañarlo en cada paso, desde la instalación hasta la operación multicaja, y nos enorgullece ser parte de su crecimiento. Gracias por confiar en VK Soluciones Tecnológicas como su aliado estratégico.