Caso de estudio · Sistema interno
Blackphone: inventario, ventas, servicio técnico y caja por sucursal
Sistema de gestión de Blackphone, tienda de tecnología con varias sucursales: inventario por IMEI, ventas con permuta, reservas, servicio técnico, cotizaciones, caja diaria y reportes. Laravel, React y PostgreSQL.

- Categoría
- Sistemas empresariales
- Sector
- Comercio de tecnología
- Cliente
- Blackphone
- Año
- 2026

Inventario de celulares: cada equipo con su IMEI, batería, condición y precio para cliente final y para tiendas. Datos de ejemplo. 
Nueva venta en pasos: cliente, forma de pago, productos por IMEI o por cantidad y permuta opcional. Datos de ejemplo. 
Servicio técnico: cómo llega el equipo, código de desbloqueo y revisión punto por punto, impresos en la nota. Datos de ejemplo. 
Caja diaria por sucursal: se abre con el efectivo inicial y se cierra contando. Datos de ejemplo.
Problema
Una tienda de celulares no vende cajas iguales. Cada celular tiene su IMEI, su batería, su condición y su historia; un vidrio templado, en cambio, se vende por cantidad. En el mismo mostrador se vende, se separa un equipo con un anticipo, se recibe otro en parte de pago, se cotiza por WhatsApp y se recibe un equipo para reparar.
Cuando eso vive en planillas y chats, los errores son caros: un equipo que figura disponible pero ya se vendió, una reparación que vuelve con un reclamo sin nada escrito sobre cómo entró, una caja que no cierra y nadie sabe por qué.
Y con más de una sucursal, todo se multiplica: cada local necesita su inventario, su caja y sus notas, sin que un código se repita ni una sucursal vea lo de la otra.
Contexto
Un sistema privado, hecho para el mostrador. Blackphone vende celulares, computadoras, equipos de marca, accesorios y repuestos, nuevos y seminuevos, y hace servicio técnico. El sistema no tiene tienda pública: todo pide sesión, y el buscador no lo indexa.
Trabaja con varias sucursales; arrancó con Cochabamba y Sucre. Hay dos paneles: el de administración, con costos, reportes y configuración, y el del vendedor, que vende, reserva y cotiza sin ver nunca un costo.
Solución
Un solo sistema para todo lo que pasa en la tienda. Construimos un sistema de gestión con inventario, ventas, reservas, servicio técnico, cotizaciones, egresos, clientes, caja diaria y reportes sobre la misma base y las mismas reglas.
- Inventario: cada celular y computadora es una unidad con IMEI o serie, batería, condición y precio para cliente final y para tiendas. Accesorios y repuestos se llevan por cantidad, con su historial de movimientos.
- Mostrador: ventas con varios ítems, permuta y pago en efectivo, QR, transferencia o tarjeta; reservas con anticipo; boleta en A4 y en 80 mm.
- Taller: servicio técnico con el estado de recepción del equipo, técnico asignado, comisiones y recibo para el cliente.
- Control: caja diaria por sucursal, auditoría de inventario por conteo físico y reportes por día, semana, mes y año.
Lo que se vende, se separa o se repara queda escrito en el mismo lugar donde está el stock.
Desafío
Varias sucursales sin que se mezclen. Cada sucursal tiene su inventario, sus ventas, sus reservas, sus servicios, sus clientes y sus egresos. El aislamiento no depende de que cada pantalla se acuerde de filtrar: lo aplica un alcance global sobre los modelos, y lo que se carga queda en la sucursal activa de quien lo carga. Una cuenta con sucursal asignada no ve otra ni escribiendo la dirección a mano.
Los códigos de nota llevan el prefijo de la sucursal (CBA-V001, SUC-V001), así dos cajas venden al mismo tiempo en ciudades distintas sin que un código se repita. Un traspaso entre sucursales pasa por «en tránsito»: lo enviado no se puede vender en ninguna de las dos hasta que el destino confirma que llegó.
Nadie reparte más alcance del que tiene: un administrador de sucursal da acceso solo a la suya, y el sistema no deja quedarse sin super administradores ni apagar la última sucursal.
Arquitectura
Blackphone es un monolito en Laravel 13 con React 19 por Inertia, sin una API aparte. La base es PostgreSQL 18 y los comprobantes en PDF salen con dompdf.
Todo corre en Docker Compose: la aplicación (Apache y PHP 8.5), una cola de trabajos, el programador de tareas y la base, con contenedores, volúmenes, claves y base propios. En el servidor comparte solo el proxy con HTTPS con otros sitios.
Decisiones que importan:
- El stock por cantidad se mueve por un único servicio que bloquea la fila y deja el renglón en el historial: el saldo nunca se edita a mano.
- El costo de una pieza o de un producto lo pone siempre el servidor desde el inventario; el vendedor nunca lo recibe.
- Los permisos se aplican en el servidor, no solo en el menú: cada rol entra a los módulos que tiene asignados.
- Los reportes automáticos llegan desde n8n por una ruta propia con token.
Servicio técnico que se defiende solo
La nota de servicio incluye cómo llega el equipo: una revisión punto por punto (enciende, pantalla, táctil, cámaras, Face ID, chasis…) con Sí, No o No se pudo probar, a la que se pueden sumar puntos en el mostrador. El código de desbloqueo es obligatorio indicarlo, y que el cliente no lo deje también se imprime.
Todo sale en la boleta A4 y en el recibo térmico, porque la nota existe para responder sola si después se discute en qué estado entró el equipo. Cada técnico tiene su especialidad y su comisión, y el servidor no deja asignar un Android al técnico de Apple ni mandando el formulario a mano.
Caja diaria por sucursal
Una caja por sucursal y por día. Se abre anotando con cuánto arranca el cajón; desde ahí, lo que se cobra en efectivo se suma solo. Al cerrar se cuenta el efectivo y quedan guardados el desglose, lo esperado, lo contado y la diferencia: si sobró o faltó, queda a la vista y firmado.
Ventas a tiendas
Además del cliente final, Blackphone vende a otras tiendas. Cada producto puede tener un precio mayorista; la venta a una tienda reusa la numeración, el stock, la nota y la caja, pero va en su propio módulo, solo para administración, y el vendedor nunca ve ese precio.
Cotizaciones y reportes
Las cotizaciones se arman en el sistema, salen en PDF y se envían por correo o por WhatsApp, una por una o en lote. Los reportes muestran ventas, ganancias y cierres por día, semana, mes y año, y el inventario se exporta en PDF por tipo, por nombre o con un filtro armado a mano.
Funcionalidades
- Inventario por unidad con IMEI, serie, batería y condición
- Accesorios y repuestos por cantidad con historial de movimientos
- Ventas con varios ítems, permuta y cuatro formas de pago
- Reservas con anticipo y control de vencimiento
- Servicio técnico con revisión de recepción y comisiones
- Caja diaria por sucursal con cierre y diferencia
- Varias sucursales aisladas, con traspasos en tránsito
- Cotizaciones en PDF por correo y WhatsApp
- Panel del vendedor sin costos y roles por módulo
- Reportes y auditoría de inventario por conteo físico
Ficha técnica
- Laravel
- PHP
- React
- Inertia
- Tailwind CSS
- PostgreSQL
- Docker
- Vite
- n8n
Suite de pruebas: 362 pruebas automatizadas.
Resultado
Blackphone está en producción desde octubre de 2026, como sistema privado de la tienda, con inventario, mostrador, taller y caja sobre una misma base.
Sin un sistema. El stock, las ventas, las reparaciones y la caja de cada local se siguen por separado, y cada cierre depende de reconstruir el día.
Con el sistema. Cada movimiento queda en el lugar donde está el stock, cada sucursal ve lo suyo y la caja cierra con la diferencia a la vista.
- Un único sistema para inventario, ventas, reservas, servicio técnico, cotizaciones y caja.
- Trazabilidad: cada equipo con su IMEI, cada movimiento de stock con quién y por qué, cada cierre de caja guardado.
- Control de accesos: el vendedor vende sin ver costos, y cada cuenta trabaja solo con su sucursal.
- QA automatizado: suite de pruebas para proteger los flujos críticos.
Una tienda puede vender sin sistema. Lo difícil es saber, al cerrar, qué pasó.
QA automatizado
Suite de pruebas para proteger los flujos críticos.
Permisos, cálculos e integraciones se verifican solos antes de cada cambio. Las cifras están en la ficha técnica.
¿Tu tienda lleva el stock en una planilla?
Construimos sistemas de gestión a la medida de cada comercio: inventario, ventas, servicio técnico y caja, con una o varias sucursales. Contanos qué querés resolver.