
De dónde salió
Empecé a vender mi auto y terminé recorriendo automotoras. Vi el proceso desde adentro: fichas en papel, fotos en el celular de alguien, precios en dólares y pesos que no cerraban entre sí, y un vehículo que podía estar reservado y publicado al mismo tiempo. El problema no era la venta: era que nadie sabía con certeza qué había en el patio.
El problema
Una automotora mediana maneja stock, costos de reacondicionamiento, documentación con vencimientos, permutas, reservas y oportunidades comerciales. Casi siempre lo hace con planillas compartidas y grupos de WhatsApp. El costo no se ve en un solo lugar: aparece en el auto que lleva noventa días parado, en el margen que nadie calculó y en la unidad que se vendió dos veces.
La solución
Un DMS multi-tenant construido con spec-driven development: las especificaciones son la fuente de verdad y el código las implementa. Cubre el ciclo completo —alta de vehículo, fotos y documentos, costos y margen, CRM, reserva, permuta, venta y entrega— con aislamiento por organización a nivel de base de datos y auditoría inmutable de cada movimiento.
Qué tiene resuelto
- Multi-tenancy con Row Level Security en PostgreSQL: el aislamiento vive en la base, no solo en el código de la aplicación.
- Doble moneda USD/UYU con tipos de cambio versionados, tal como opera el mercado uruguayo.
- RBAC por rol y por sucursal.
- Máquina de estados del vehículo con historial y transiciones explícitas.
- Costos por unidad y cálculo de margen real, no estimado.
- CRM de oportunidades con actividades y generación de link de WhatsApp.
- Reserva con bloqueo, permuta, venta, entrega y cancelación.
- Dashboard con reporte de vehículos estancados, import/export CSV y visor de auditoría.
Evidencia
- Diez verticales funcionales (F01–F10) implementadas y documentadas endpoint por endpoint.
- 50 tests e2e en verde, incluyendo un caso de no-doble-venta bajo concurrencia.
- Migraciones de producción verificadas corriendo la API sin
synchronize, con el esquema completo y RLS aplicado. - Cinco fases previas de especificación —research, producto, UX y prototipo, arquitectura y plan— versionadas en
specs/antes de la primera línea de código de producción.
Lo difícil
- La doble venta bajo concurrencia es el bug que no se puede permitir: dos vendedores reservando la misma unidad al mismo tiempo. Se resolvió con bloqueo explícito y quedó cubierto por un test e2e concurrente.
- Row Level Security da un aislamiento mucho más fuerte que filtrar por
tenant_iden cada consulta, pero obliga a repensar migraciones, conexiones y roles de base de datos. - La doble moneda no es formateo: atraviesa el costo, el margen, el reporte y el precio publicado, y cada uno puede estar fijado en una moneda distinta.
Qué aprendí
- Escribir cinco fases de especificación antes de codear parecía lento y fue exactamente lo contrario: el backend completo salió sin refactors estructurales.
- Con IA asistiendo el desarrollo, la especificación pasa a ser el cuello de botella real. Cuanto más precisa, más útil es la asistencia.
- Un test que reproduce una condición de carrera vale más que veinte tests de camino feliz.
Próximos pasos
- Frontend Next.js conectado a la totalidad de la API.
- Integraciones con portales de publicación y WhatsApp Cloud API.
- Hardening de RLS con rol restringido y
SET app.tenant_idpor conexión.
Otros productos
Aprendizajes aplicados