Volver al inicio

Movilidad y plataformas MVP funcional 2026

Patio

El stock de una automotora, sin la planilla compartida.

Sitio de Patio: titular "Sabé qué autos tenés, cuánto te costaron y cuál necesitás vender primero" junto a un dashboard de ejemplo con stock, reservados, vendidos y margen.

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_id en 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_id por conexión.

Aprendizajes aplicados

Lecturas que nacen de este proyecto