Proyectos 07 / 11
Ateri
Gestión de visitas técnicas rurales, offline-first
Plataforma para técnicos que acompañan agroindustrias familiares en campo. Registro de productores, visitas con historial rastreable, fotos y documentos. Funciona sin señal y sincroniza después, resolviendo conflictos campo a campo.
Visión general
Ateri organiza el trabajo de técnicos de extensión rural que acompañan agroindustrias familiares en el oeste de Paraná. Cada productor tiene su ficha, cada visita tiene historial rastreable y el panel muestra la cuota del mes — una visita por productor —, lo atrasado y lo que viene en los próximos días.
La app de campo es offline-first: guarda todo en el dispositivo, funciona sin señal en la propiedad y sincroniza cuando vuelve la conexión, resolviendo conflictos campo a campo. La API en C# y .NET 10 es el contrato común de la app en React Native y del panel web en React, y el proyecto también fue una forma de estudiar la stack que pide el mercado.
Funcionalidades
Lo que el sistema hace
-
Panel de la cuota del mes
Cuántos productores ya fueron atendidos, visitas concluidas, atrasadas y de la próxima semana, quién falta visitar y el avance por bloque de ruta.
-
Agenda de visitas
Visitas por día con estado pendiente, concluida, reprogramada, cancelada o atrasada, y filtro por bloque, ciudad y "solo las mías".
-
Ficha del productor
Datos, coordenadas, CAF con aviso de vencimiento, equipo responsable, notas fijadas y el historial completo de visitas.
-
Bloques de ruta
Ciudades agrupadas en bloques para planificar las salidas de campo y seguir la cobertura de cada región.
-
Archivos y gastos
Fotos, documentos y audios por productor, que suben solo con Wi-Fi, además de kilometraje y gastos de las visitas.
-
Funciona sin servidor
Un modo local permite usar la app en el campo antes de que exista servidor, guardando la cola de operaciones para llevar todo a la API después, sin perder nada.
Pantallas
Por dentro del sistema
Pantallas con datos ficticios, generados para demostración.
Stack
Cómo fue construido
- Frontend
- ReactTypeScriptTanStack QueryTanStack TableZustandTailwind 4shadcn/ui
- Móvil
- React NativeExpoExpo RouterSQLiteNativeWind
- Backend
- C#.NET 10ASP.NET Core Minimal APIsEF Core 10DapperIdentity + JWTOpenAPI
- Datos
- PostgreSQL
- Infra & DevOps
- DockerxUnitTestcontainersVitestPlaywright
Detrás de escena
Desafíos técnicos
-
Una ruta de sincronización
El dispositivo envía la cola de operaciones y recibe, en la misma respuesta, lo que cambió en el servidor desde el último cursor. Con señal débil cada ida y vuelta menos cuenta, y la app ya recibe el estado combinado de lo que acaba de enviar.
-
Operaciones idempotentes con ids del dispositivo
Cada operación tiene un GUID v7 generado en el celular y la hora en que se hizo. Reenviar la misma cola no duplica nada, y las entidades creadas offline nacen con su id definitivo.
-
No perder trabajo en un conflicto
La última escritura gana campo a campo, con historial por registro. Si una operación es rechazada (un documento repetido, por ejemplo), las siguientes del mismo productor quedan diferidas en lugar de descartadas, esperando la corrección.
-
Un contrato para dos clientes
El documento OpenAPI generado por la API es la fuente de los tipos del web y de la app. Web y mobile tienen interfaces propias, pero hablan exactamente el mismo idioma con el servidor.
¿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