Pulso Barber System

Superficies

Tres productos sobre una misma base, cada uno para un momento distinto de la relación con la barbería.

Módulos

El sistema se organiza en superficies independientes, cada una resolviendo una parte del trabajo diario.

Arquitectura

• Base de datos con SQLite y Drizzle ORM sobre servidor propio, con claves foráneas verdaderas: borrar un cliente o un barbero ejecuta una cascada transaccional con red de seguridad.
• Integridad verificada con chequeo en cero — ninguna operación puede dejar el sistema en un estado inconsistente.
• Un modelo de contenido editable renderiza tanto la web como la app del cliente: no hay textos fijos en el código de cara al público (principio "o todo o nada").
• Un idioma visual único de consola operativa, coherente entre las tres superficies y en claro/oscuro. La interfaz habla de turnos, clientes, dinero y cortes; nunca de tablas ni identificadores.

Proceso

1. Definición del modelo de uso: cuatro lugares, no catorce pantallas. La navegación se organiza alrededor de cómo trabaja realmente un barbero — su día, su gente, su plata y su local.
2. Arquitectura de datos con SQLite y Drizzle ORM sobre servidor propio. Base con claves foráneas verdaderas: borrar un cliente o un barbero ejecuta una cascada transaccional con red de seguridad. Verificado con chequeo de integridad en cero.
3. Diseño del sistema visual con estética de consola operativa: un idioma visual único, coherente entre las tres superficies y en claro/oscuro. La interfaz habla de turnos, clientes, dinero y cortes; nunca de tablas ni identificadores.
4. Principio "o todo o nada": si el sistema expone una opción, el usuario puede agregarla, editarla y quitarla. Tanto la web como la app del cliente se renderizan desde un modelo de contenido editable — no hay textos fijos en el código de cara al público.
5. Diseño y desarrollo de El Club: programa de fidelización con economía propia. Puntos por gasto, niveles, misiones y premios canjeables. Cada parámetro de la economía configurable desde el panel. Pensado como motor de recurrencia, no como adorno.
6. Desarrollo full-stack de las tres superficies: frontend React + Vite, API Express, modelo de datos SQLite. Autenticación con JWT + scrypt. Gráficos con Recharts.

Lo que aprendí

Diseñar desde el modelo mental del usuario —no desde la base de datos— simplificó tanto el diseño como el desarrollo. Cuando la arquitectura de información refleja cómo piensa realmente el usuario, las decisiones técnicas se vuelven más evidentes y el código más limpio.