CamperRoute
Planificador de viajes para autocaravanas con modo viaje en PWA y blog editorial automático. Tres modos — planificar, conducir, recordar — sobre un mismo modelo de datos.
CamperRoute is a planner for people who travel in motorised homes. A camper day isn’t a tourist day, and the planner knows it: corridor-driven POIs, fuel data filtered by your real vehicle, and a trip mode that detects arrivals without asking you to check in.
En xifres
- Tres modes — planificar (al sofà), conduir (a la cabina), recordar (a casa). Cada un té UI pròpia, no és un toggle.
- Geofence amb radi 150–300 m i finestra de permanència de 5 minuts. Arribades detectades sense check-in, sense tracking continu.
- Combustible europeu — MITECO diari per Espanya + OSM Overpass per a la resta. Filtrat pel combustible que el teu vehicle realment usa.
- Cache compartit país/regió per als POIs descoberts amb IA. Cost LLM una vegada per país, mai per usuari.
- PWA offline un cop en ruta. Sync quan torna cobertura, no a cada pas.
- Sentry EU + scrubbing agressiu — sense PII, sense coordenades GPS als errors.
La família
CamperRoute no és un sol procés. Són tres repositoris que comparteixen un contracte OpenAPI però es despleguen per separat:
- camperroute-api — backend FastAPI + Postgres + Celery.
- camperroute-app — frontend React + Vite + PWA.
- camperroute-meta — privat, quadern de bitàcola BMAD (briefs, epics, retros, ADRs).
Què no és
No és un GPS — fa handoff al teu navegador habitual (Waze, Google Maps). No és una xarxa social — la teva ruta és teva, es comparteix amb enllaç signat que caduca. No és un planificador genèric — la unitat és el dia amb camper. No és un servei al núvol obligatori — el mode viatge funciona en PWA offline. No és vigilància — Sentry no rep mai coordenades.
Aprofundir
Els deep-dives — per què tres modes i no un, per què planificar i conduir són dos cervells diferents, com els POIs apareixen sols al corredor, com es detecta una arribada sense check-in, per què el codi viu en tres repos, com s’observa sense espiar — viuen com a sèrie al blog. Cada article enllaça amb l’anterior i el següent dins de la sèrie.
Serie completa
Parte de CamperRoute 01/08
Qué es CamperRoute
Empecé queriendo organizar un viaje en autocaravana. He acabado diseñando un producto con tres modos. Este post explica por qué hacían falta tres.
Parte de CamperRoute 02/08
Planificar y conducir son dos cerebros distintos
Una pantalla densa que funciona en casa con café es ilegible en la cabina con el sol pegando. La tentación era un toggle. La tentación se equivocaba.
Parte de CamperRoute 03/08
POIs que aparecen solos
Un planificador vacío intimida. Un planificador que ya tiene el corredor poblado — y puedes descartar lo que no te guste — es una conversación.
Parte de CamperRoute 04/08
Geofence: saber que has llegado sin que lo digas
Un check-in es la fricción más tonta del mundo. El tracking continuo es vigilancia. Entremedio vive el geofence con ventana de permanencia.
Parte de CamperRoute 05/08
Combustible: datos reales sobre el mapa
Un mapa bonito no es un producto. Un mapa que te ahorra doce euros llenando 4 km más allá sí. Todo el truco está en la conjunción precios + corredor + camper.
Parte de CamperRoute 06/08
Tres repos, una promesa
Tres modos en el producto; tres repos en el código. No es coincidencia. Es el mismo instinto aplicado dos veces: separar las cosas que se mueven a velocidades distintas.
Parte de CamperRoute 07/08
Observar sin ver al usuario
Necesito saber qué se ha roto. No necesito saber a quién se le ha roto. Esa distinción define toda la capa de observabilidad.
Parte de CamperRoute 08/08
El viaje se hace blog
El blog era texto plano que leías una vez y olvidabas. El modo recordar lo convierte en el artefacto del viaje: bloques editables, tus fotos, y un PDF que te puedes llevar.