Caso de estudio · Desarrollo de producto
Desarrollo de una plataforma integral para gestionar ventas por peso y unidad, caja, crédito, cartera, inventario y básculas.
El punto de partida
Casa Nuestra POS fue desarrollado desde cero a partir de las necesidades reales de operación de Casa Nuestra, un negocio de expendio de carnes ubicado en Rionegro, Antioquia. Adicional, fuimos autorizados por el negocio para divulgar su nombre y caso.
El proyecto comenzó con el análisis de los procesos de venta, pesaje, caja, crédito, cartera e inventario. Ese levantamiento permitió diseñar una solución especializada para productos comercializados por unidad y por peso, con soporte para vendedores, clientes, múltiples medios de pago, turnos de caja y básculas digitales.
La evolución
El sistema evolucionó desde un núcleo inicial de gestión comercial hasta convertirse en una plataforma integrada. Se construyó una API en Python con FastAPI, una base de datos PostgreSQL y una interfaz en React y TypeScript, empaquetada como aplicación de escritorio para Windows.
Retos de arquitectura
Las decisiones técnicas respondieron a riesgos concretos del punto de venta: duplicidad, interrupciones y trazabilidad.
El motor transaccional registra conjuntamente la venta, sus productos, los pagos, los movimientos de caja, la cuenta por cobrar y la auditoría. La idempotencia (propiedad de realizar una acción varias veces y obtener siempre el mismo resultado que si se hiciera una sola vez) evita duplicados ante un doble clic, un fallo de red o un reintento.
La sincronización se diseñó como un proceso independiente. El punto de venta puede continuar operando si el servicio de inventario no está disponible y procesar después los movimientos pendientes de forma controlada, sin duplicar descuentos del inventario.
Un receptor especializado recibe los tiquetes de las básculas, valida productos y precios configurados, y los presenta a la caja para completar el cobro. Cada tiquete sólo puede convertirse una vez en venta.
El producto en operación
Estas capturas autorizadas muestran los principales flujos del producto. La información empresarial y personal se mantiene protegida.
Una entrada diferenciada protege el acceso al sistema y da paso a las funciones autorizadas para cada persona.
Los tiquetes recibidos desde la báscula llegan a la bandeja del punto de venta para validar peso, producto, precio y vendedor antes del cobro.
El cajero registra el medio de pago y el sistema calcula la devuelta antes de habilitar la confirmación de la venta.
La confirmación reúne el número de venta, el total, la devuelta y el estado de sincronización con inventario.
El flujo de crédito exige asociar un cliente antes de crear la cuenta por cobrar y conservar su trazabilidad.
La cartera centraliza saldos, estados y abonos para mantener visible el origen de cada cuenta por cobrar.
El cierre compara el efectivo esperado y declarado, consolida movimientos y permite registrar observaciones.
El catálogo mantiene productos, categorías, unidades, precios y estados necesarios para operar el punto de venta.
Mi participación
Mi rol: Fundador del proyecto, arquitecto funcional y desarrollador principal.
El trabajo abarcó todo el ciclo, desde el levantamiento de necesidades hasta la validación técnica de Casa Nuestra POS V1.
El resultado
Casa Nuestra POS conecta atención al cliente, pesaje, ventas, caja, cartera, inventario y control administrativo dentro de una misma plataforma especializada en la operación comercial de Casa Nuestra.
Alcance de esta publicación: el caso describe el producto y el proceso de desarrollo autorizados. No expone credenciales, datos personales, cifras comerciales ni información empresarial privada.
Siguiente paso
Primero reviso su situación. Después defino con usted el alcance y el siguiente paso.
