El contexto
Phonesys es una plataforma interna para reparadoras de celulares y servicios técnicos que manejan, al mismo tiempo, flujos de reparación, ventas de accesorios y gestión de caja. Nació de una necesidad muy concreta: los locales de reparación estaban trabajando con planillas de Excel, cuadernos y un sistema POS genérico que no entendía el negocio real. Cada reparación requería notas manuales, cada cliente había que buscarlo en una lista interminable y cada entrega terminaba con recibos escritos a mano.
El desafío
Una reparadora no es una tienda común. Tiene dos líneas de negocio conviviendo en el mismo local: la venta de productos (accesorios, baterías, cargadores, repuestos) y el servicio técnico (reparaciones con diagnóstico, presupuesto, autorización del cliente y entrega). Cada una tiene flujos, roles y permisos distintos.
Había que resolver varios problemas al mismo tiempo:
- Roles diferenciados reales. El administrador ve todo, pero un vendedor no debería tocar reparaciones y un técnico no debería cargar ventas. Los permisos no son decoración: son parte del flujo operativo.
- Información de reparación completa. Cada ingreso de equipo necesita registrar si prende, si tiene chip, el PIN de desbloqueo, si es garantía, detalles del problema, técnico asignado y estado.
- Separación de costos. Una reparación combina costo de producto (repuesto) y costo de servicio (mano de obra). Si eso se mezcla, las comisiones y la rentabilidad se vuelven invisibles.
- Transparencia con el cliente. El cliente no quiere llamar tres veces al local para preguntar si su equipo ya está. Necesita ver el estado desde su celular, sin login, sin fricción.
- Impresión de comprobantes reales. El local ya tenía impresoras térmicas conectadas; el sistema tenía que conversar con ellas, no obligar a imprimir en papel A4.
La solución
Construimos Phonesys sobre Next.js 15 con App Router, TypeScript estricto y Prisma + PostgreSQL como base de datos. La autenticación y los roles los maneja Clerk, con tres perfiles configurados: ADMIN, SELLER y TECHNICIAN. Cada ruta del dashboard valida el rol antes de renderizar, y el sidebar oculta automáticamente lo que el usuario no debería ver.
El dashboard tiene módulos específicos para cada parte del negocio:
- Reparaciones con estados (
RECEIVED, en proceso, completado), presupuesto desglosado en producto + servicio, asignación de técnicos, campos específicos del rubro (prende, tiene chip, PIN, garantía) y estado de pago separado del estado de trabajo. - Ventas / POS con carrito de productos, descuento por ítem, selección de método de pago y emisión automática de comprobante.
- Catálogo unificado de productos y servicios, con precio de venta, precio de costo, comisiones por producto y control de stock.
- Clientes con histórico de reparaciones y compras, teléfono y total gastado calculado en tiempo real.
- Métodos de pago configurables por el admin.
- Usuarios y auditoría — cada acción queda registrada con fecha, usuario y tipo de operación, para que el dueño pueda auditar sin depender de memoria.
Integramos impresoras térmicas vía la API local de ECO POS, de modo que desde cualquier pantalla del sistema se puede imprimir un recibo, un QR de tracking o un texto libre directamente al ticket. Se configura el puerto y el nombre de impresora desde el sistema; no hace falta ningún driver extra en cada PC.
Para el lado del cliente, creamos una ruta pública de tracking (/tracking/[repairId]) que no requiere login. Cuando se ingresa un equipo, el sistema genera un QR con la URL del tracking; el cliente lo escanea y ve en tiempo real el estado de su reparación. Menos llamadas al local, más confianza.
Los reportes y exports usan React PDF para comprobantes formales y xlsx para exportar ventas, reparaciones o clientes a Excel. El dashboard muestra métricas clave con Recharts: ventas del mes, reparaciones activas, productos con stock crítico y comisiones acumuladas por técnico.
Resultado
Phonesys hoy opera como el sistema central de la reparadora. Reemplazó tres herramientas anteriores —el POS genérico, las planillas de Excel y los cuadernos de reparación— por una sola base de datos en la que cada producto, cliente, reparación y venta está conectado.
El tiempo de ingreso de una reparación bajó de varios minutos con notas manuales a treinta segundos con formulario estructurado. Los técnicos ven solo sus reparaciones asignadas. Los vendedores ven solo el módulo de ventas. Y el dueño, por primera vez, ve el negocio completo desde un dashboard único, con trazabilidad total gracias al módulo de auditoría.
La arquitectura quedó lista para escalar a múltiples locales: agregar un segundo punto de venta es sumar usuarios con su rol, no replicar infraestructura.