Proyectos 08 / 11
Garajá
Mantenimiento de vehículos para la casa o la flota
Centraliza mantenimientos, repostajes, documentos y costos por vehículo. Pensado para registrar en la estación o el taller: funciona sin conexión, acepta registros retroactivos y sincroniza al volver la señal.
Visión general
Garajá reúne todo lo que cuesta un auto: cargas de combustible, mantenimientos, gastos, documentos y kilometraje, por vehículo, para una casa o una flota chica. El panel responde dos preguntas de entrada: qué vence pronto y cuánto cuesta cada vehículo por kilómetro.
El registro se hace en la estación de servicio o en el taller, muchas veces sin señal, así que la app es offline-first: guarda en el dispositivo, acepta registros retroactivos y sincroniza cuando vuelve la conexión. La API en .NET 10 es el contrato común de la app en React Native y del panel web en React, con adjuntos guardados en Cloudflare R2.
Funcionalidades
Lo que el sistema hace
-
Panel de lo que vence y de lo que cuesta
Gasto de los últimos 12 meses, costo por kilómetro, kilómetros recorridos, alertas de mantenimiento y documentos y gasto por mes y por vehículo.
-
Cargas y consumo
Litros, precio, combustible, estación y tanque lleno. El consumo en km/l se calcula entre cargas y el costo por km sale de todo lo que gastó el vehículo.
-
Plan de mantenimiento
Reglas por kilometraje y por tiempo (aceite, filtros, alineación, correa, batería) con última y próxima ejecución y aviso antes del vencimiento.
-
Mantenimientos, gastos y documentos
Repuestos y mano de obra por taller, peajes, lavados, impuestos, patente, multas, documentación y seguro con alerta de vencimiento.
-
Adjuntos y notas
Fotos y PDF organizados en carpetas, visor a pantalla completa en la app y notas fijadas por vehículo.
-
Flota compartida
Invitación a otros miembros, roles de dueño y miembro, y el mismo historial para toda la casa o empresa.
Pantallas
Por dentro del sistema
Pantallas con datos ficticios, generados para demostración.
Stack
Cómo fue construido
- Móvil
- React NativeExpo SDK 58Expo Routerexpo-sqliteNativeWindTanStack QueryZustand
- Frontend
- ReactTypeScriptTailwind
- Backend
- C#.NET 10ASP.NET Core Minimal APIsEF Core 10JWTOpenAPI + Scalar
- Datos
- PostgreSQL 18Cloudflare R2
- Infra & DevOps
- DockerCaddyxUnit v3Testcontainers
Detrás de escena
Desafíos técnicos
-
Offline-first con registros retroactivos
Cada registro nace en el dispositivo con un GUID v7 y entra en una cola de sincronización. Como se puede cargar la carga de ayer después de la de hoy, la API valida la cronología del odómetro respecto de los registros vecinos.
-
Aislamiento por flota en todo
Toda tabla lleva la flota, filtros globales de EF Core restringen cada consulta y una guarda en SaveChanges impide grabar fuera del alcance. Las rutas están cerradas por defecto.
-
Uploads que funcionan de verdad en Expo
El fetch de Expo rechazaba archivos en el FormData y ningún adjunto llegaba al servidor. El upload pasó a XMLHttpRequest, con el nombre del archivo decodificado en la API y envío solo con Wi-Fi cuando el usuario lo prefiere.
-
Costos que no cuentan dos veces
Documento y gasto no pueden registrar el mismo pago, o el costo por kilómetro se duplica. El modelo separa lo que es plazo (documento) de lo que es dinero (gasto).
¿Necesitas algo
parecido?
Cuéntame la idea o el problema. Ayudo a diseñar la solución y la construyo de la API a la app.
Hablemos