CamperRoute
Planificador de viatges per a autocaravanes amb mode viatge en PWA i blog editorial automàtic. Tres modes — planificar, conduir, recordar — sobre un mateix model de dades.
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 75–200 m per categoria de parada. Arribada confirmada en entrar (debounce 3 s) i auto-completada en sortir, sense check-in ni 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.
Sèrie completa
Què és CamperRoute
Vaig començar volent organitzar un viatge amb autocaravana. He acabat dissenyant un producte amb tres modes. Aquest post explica per què calien tres.
Planificar i conduir són dos cervells diferents
Una pantalla densa que funciona a casa amb cafè és il·legible a la cabina amb el sol pegant. La temptació era un toggle. La temptació era equivocada.
POIs que apareixen sols
Un planificador buit és intimidant. Un planificador que ja té el corredor poblat — i pots descartar el que no t'agradi — és una conversa.
Geofence: saber que has arribat sense que ho diguis
Un check-in és la fricció més tonta del món. Tracking continu és vigilància. Entremig hi viu el geofence: entrada confirmada i auto-completat en sortir.
Combustible: dades reals damunt del mapa
Un mapa bonic no és un producte. Un mapa que t'estalvia dotze euros omplint 4 km més enllà sí. Tot el truc està en la conjunció preus + corredor + camper.
Tres repos, una promesa
Tres modes al producte; tres repos al codi. No és coincidència. És el mateix instint aplicat dues vegades: separar les coses que mouen a velocitats diferents.
Observar sense veure l'usuari
Necessito saber què s'ha trencat. No necessito saber a qui se li ha trencat. Aquesta distinció defineix tota la capa d'observabilitat.
El viatge es fa blog
El blog era text pla que llegies un cop i oblidaves. El mode recordar el converteix en l'artefacte del viatge: blocs editables, les teves fotos, i un PDF que te'n pots endur.