Blog técnico
Post Dep: una app Electron para operar locales de depilacion en Antofagasta e Iquique
Caso tecnico de Post Dep, un sistema de punto de venta y administracion usado por locales de depilacion en Antofagasta e Iquique.
Qué es Post Dep
Post Dep es una app de escritorio construida con Electron y React para operar locales de depilacion. No es una demo ni una app de portfolio aislada: la usan hace varios años tres locales en Antofagasta y uno en Iquique para registrar ventas, caja, gastos, trabajadores, inventario, anulaciones, cierres y reportes.
El proyecto vive internamente en el repositorio depgacituasv3, pero el nombre operativo del programa es Post Dep. La diferencia importa porque el repositorio refleja la historia tecnica del sistema, mientras que el producto que ve el negocio es una herramienta diaria de punto de venta.
Uso real en locales
Post Dep esta pensado para uso operacional de locales de depilacion, con flujos de caja, turnos, servicios, productos y cierre diario. La prioridad ha sido continuidad, rapidez en mostrador y trazabilidad de movimientos.
Capturas de la app
Estas capturas fueron tomadas desde la app Electron levantada localmente, usando el ambiente de prueba Test David para no exponer datos de los locales reales.
Electron desktop
Post Dep: ingreso de caja
La apertura del turno parte seleccionando cajero y local antes de entrar a caja.
Post Dep: menu principal
El menu separa caja, adelantos, trabajadores, inventario, anulaciones, gastos y modulos avanzados.
Post Dep: pantalla de caja
Caja concentra servicio, productos, tickets pendientes, pagos, numero, box, impresora y gaveta.
Post Dep: acceso avanzado restringido
El panel avanzado protege configuracion, cierres, reportes e impresoras con autorizacion.
Qué resuelve en el local
La pantalla principal organiza el trabajo alrededor del turno: seleccionar cajero, entrar a caja, registrar ventas, manejar adelantos, revisar trabajadores, administrar inventario, anular ventas, cargar gastos y entrar a modulos avanzados. Es una app hecha para uso repetido durante el dia, no para navegar contenido.
En caja, el sistema cubre servicios de depilacion, productos, recargas, giftcards, pagos multiples, pagos sin definir, fiados, tickets pendientes, seleccion de box, configuracion de impresora y emision de comprobantes. Tambien calcula totales y normaliza formas de pago para que el cierre no dependa de planillas externas.
Los modulos administrativos agregan reportes de ventas, gastos, resumenes, cierres de caja, prestamos, detalle de trabajadoras, anulaciones y configuracion por local. Con eso el negocio puede revisar operacion diaria y mensual sin sacar la informacion de la misma fuente operacional.
Arquitectura
La app de escritorio usa Electron, React, React Router y Firebase. Firestore guarda la estructura por local bajo colecciones de DEPILACIONES, con subcolecciones para configuraciones, trabajadores, funciones, productos, formas de pago, cierres, ventas y otros movimientos. Firebase Auth controla el acceso y el sistema valida que cada usuario tenga local e identificador de configuracion asignado.
El repositorio tambien incluye un viewer web de solo lectura para revisar ventas, gastos, resumenes, cierres, trabajadoras, locales, usuarios, clientes y configuracion desde navegador. Esa parte permite separar la operacion de caja, que vive en el escritorio, de la revision administrativa que puede hacerse sin estar frente al POS.
Una pieza importante es la integracion con impresoras termicas y caja. Post Dep maneja tamanos de papel, trabajos de impresion, tickets pendientes, apertura de cajon y ajustes de impresora. En un sistema de mostrador, esa capa termina siendo tan importante como la base de datos: si imprimir o cerrar caja falla, la operacion se detiene.
Decisiones que importaron
La primera decision fue mantener el flujo cerca del punto de venta. Electron permite empaquetar una app de escritorio, controlar integraciones locales y evitar que el usuario dependa de una pestana de navegador para operar caja.
La segunda fue modelar el sistema por local. Como hay locales en ciudades distintas, el acceso, la configuracion, los trabajadores, los productos y los cierres no pueden mezclarse. El modelo de Firestore y las validaciones de acceso estan orientados a que cada usuario vea y opere lo que corresponde.
La tercera fue registrar excepciones operativas en vez de esconderlas: ventas anuladas, pagos sin definir, cierres, adelantos, gastos, prestamos y tickets pendientes. En negocios reales, los casos borde no son raros; son parte del trabajo diario.
Qué construiría distinto en una siguiente versión
Si partiera una siguiente version desde cero, separaria mas temprano el dominio de caja del framework visual. La app crecio resolviendo problemas reales, y eso deja logica de negocio cerca de componentes React. Hoy priorizaria modulos de dominio mas chicos, pruebas mas amplias para cierres y pagos, y una capa de sincronizacion o auditoria mas explicita.
Tambien moveria mas funciones administrativas al viewer web, dejando la app Electron concentrada en caja, impresion y operacion presencial. Esa separacion haria mas facil mantener permisos por rol y reduciria el riesgo de que una pantalla de administracion afecte el flujo de venta.
Cierre
Post Dep es uno de esos proyectos donde el valor no esta en la novedad tecnica, sino en sostener una operacion real durante anos. Es software hecho para que un negocio abra caja, venda, imprima, cierre turno y revise numeros sin depender de procesos manuales dispersos.
Volver a proyectos
Continuar la conversación
¿Quieres conversar sobre esto?
El objetivo del blog es abrir discusiones concretas sobre TPRM, controles auditables y lectura operacional del riesgo.