Aplicația (HTTPS, fără laptop): https://eric22220.github.io/ShockGrid/
ShockGrid măsoară cât de denivelate sunt străzile și pistele din Timișoara cu telefonul fixat pe ghidon, colorează segmentele de stradă după vibrația măsurată și compară / recomandă rute mai netede. Este un strat de informații despre confortul deplasării pe bicicletă — nu o aplicație de navigație, nu o alternativă la Timișoara City App și nu o platformă de sesizări. Confortul nu e siguranță: „cu vibrații mai puține” nu înseamnă „mai sigur”.
Indicele se numește RVI (Relative Vibration Index): RMS-ul accelerației verticale filtrate trece-sus (> 4 Hz) pe ferestre de 2 s. E relativ: valabil pentru combinația telefon + bicicletă + suport + viteză în care a fost măsurat.
| Zona | Ce face |
|---|---|
| Hartă | Segmentele măsurate colorate A–E, linie întreruptă = puține date, fără culoare = nemăsurat. Buton Locația mea (cerc de precizie, mod urmărire), Raportează, legendă în panou. |
| Traseu | „De unde pleci?” (implicit Locația mea, dacă ai permis) → „Unde mergi?” cu căutare de adrese și locuri, alegere pe hartă, inversare, destinații recente (locale). Cea mai scurtă / Echilibrată / Confort maxim, cu % măsurat, % necunoscut și problemele cunoscute de pe rută. Fără date → „Nu avem încă suficiente măsurători pentru o recomandare de confort”. Pornește arată poziția pe rută și distanța rămasă. |
| Ture | Pornește o tură (înregistrare în browser, ecranul aprins: viteză, distanță, durată, calitatea GPS, posibile denivelări), Importă ZIP-ul Sensor Logger, istoric, comparație, export. După tură: „Am observat N posibile denivelări. Vrei să le verifici?” cu Da / Nu / Nu știu și tipul problemei. |
| Mai mult | Rapoartele mele (doar pe telefon), metodologie, date și surse, exporturi GeoJSON, confidențialitate, instrumente avansate (diagnostic senzori, parametri, validare). |
Ce e public și ce e local: stratul agregat publicat de echipă (public/data/comfort-layer.json) e public. Turele, rapoartele, fotografiile și destinațiile recente rămân doar pe telefon; nu există o bază comună de rapoarte (vezi docs/BACKEND-COMUNITAR.md).
Căutarea de adrese: străzile se caută local, din graful OpenStreetMap (merge offline); adresele și punctele de interes prin serviciul public Photon (komoot), făcut pentru autocomplete. Nu folosim Nominatim public pentru autocomplete (politica lui o interzice). Cereri doar de la 3 caractere, cu debounce, anularea cererilor depășite, cache și timeout; dacă Photon nu răspunde, rămân străzile locale și alegerea pe hartă.
Fluxul demo: Sensor Logger → import ZIP → procesare RVI → segmente OSM colorate → comparația a două rute reale → recomandare condiționată de acoperirea datelor. Importul e procesare după import (post-import processing); tura live din browser e analizată pe telefon în timpul mersului, cu ecranul aprins.
iPhone (Safari):
- Deschide în Safari adresa https://eric22220.github.io/ShockGrid/
- Apasă butonul Partajare (pătratul cu săgeată) → Adaugă pe ecranul principal → Adaugă.
- Pornește ShockGrid de pe ecranul principal (se deschide pe tot ecranul și merge și fără internet pentru import, procesare și rutare; tile-urile hărții au nevoie de internet).
Samsung / Android (Chrome):
- Deschide în Chrome adresa https://eric22220.github.io/ShockGrid/
- Meniul ⋮ → Instalează aplicația (sau Adaugă pe ecranul de pornire) → Instalează.
- Pornește ShockGrid din lista de aplicații.
- În Sensor Logger: deschide înregistrarea → Export → format ZIP (CSV) → salvează în Fișiere (iPhone) sau Descărcări (Android).
- În ShockGrid: Ture → Importă → alege ZIP-ul.
- Dacă algoritmul a găsit șocuri puternice, apare verificarea „Am observat N posibile denivelări”; apoi pagina turei cu ce s-a schimbat pe hartă (km cu date, segmente noi, treceri, dacă s-a schimbat ruta recomandată).
Ture → Pornește o tură → verificarea GPS-ului și a senzorilor → Pornește tura (pe iPhone se cere permisiunea pentru senzori). Telefonul fixat pe ghidon, ecranul aprins (aplicația cere Wake Lock). Marchează salvează locul pentru un raport completat mai târziu. Stop → Termină tura procesează tura exact ca un import.
Pe hartă: Raportează → ajustezi locul mutând harta → tipul (groapă, denivelare, capac, rost/șine, asfalt deteriorat, obstacol, altceva) → fotografie și descriere opționale → Salvează. În mers: Marchează pentru mai târziu (doar poziția și ora). Raportul rămâne pe telefon; din pagina lui poți copia textul pentru Sesizări.
Turele rămân doar pe telefon (IndexedDB). Datele de pe iPhone nu apar pe Samsung și invers; datele salvate pe alt URL (de ex. un tunel de test) nu apar pe GitHub Pages.
Senzori activi: Accelerometer, Gravity, Gyroscope, versiunile Uncalibrated și Location; frecvența de eșantionare 100 Hz. Înainte de plecare: o înregistrare de test de 30 s, exportată și importată în ShockGrid (Diagnostic + rezumatul importului). Protocolul complet: docs/TEREN.md.
ShockGrid → Mai mult → Diagnostic → Testează senzorii și GPS-ul. Pentru PERMISSION_DENIED, ecranul arată pașii din Setări › Confidențialitate › Servicii de localizare.
Ture → Exportă tura: ZIP-ul original se trimite prin meniul de partajare al telefonului (Drive, WhatsApp, e-mail) sau se descarcă.
winget install OpenJS.NodeJS.LTS # dacă lipsește Node ≥ 20
git clone https://github.com/Eric22220/ShockGrid.git
cd ShockGrid
npm ci
npm run dev # http://localhost:5173
npm test # testele Vitest
npm run build # build de producție în dist/Scripturi (rulează nucleul TypeScript din src/core/, același cod ca în aplicație):
| Comandă | Ce face |
|---|---|
npm run inspect -- rides\tura.zip |
durată, mostre, frecvență mediană, goluri > 100 ms, fixuri GPS, precizie mediană, fixuri ≤ 20 m, distanță |
npm run build-graph |
graful străzilor din OpenStreetMap (o interogare Overpass; folosește data/raw/ comis; -- --refresh descarcă din nou) |
npm run build-layer -- rides/*.zip --note "telefon · bicicletă · suport" |
stratul publicat (snapshot) în public/data/: comfort-layer.json/.geojson, shock-zones.json/.geojson |
npm run validate -- rides/*.zip |
validarea (repetabilitate, referințe, percepție, A→B, map-matching, șocuri) → eval/results-<data>.json |
Turele reale se copiază în rides/ (în .gitignore: nu se publică). Graful se poate reconstrui și din GitHub: Actions → Build street graph (OSM) → Run workflow.
Senzorii și GPS-ul merg doar pe HTTPS.
npm run dev -- --host
cloudflared tunnel --url http://localhost:5173Deschide URL-ul https://….trycloudflare.com pe telefon (server.allowedHosts include deja .trycloudflare.com). Turele reale se importă doar pe versiunea de pe GitHub Pages, altfel rămân legate de originea tunelului.
Depanare pe Samsung: USB, opțiuni dezvoltator → depanare USB, apoi chrome://inspect pe laptop.
Fiecare push pe main rulează .github/workflows/deploy.yml (npm ci, npm test, npm run build, publicare dist/ pe GitHub Pages). Verificare: gh run watch. Nu e nevoie de niciun secret.
- Fără backend: totul rulează în browser, ca site static (React + TypeScript + Vite, PWA).
src/core/— nucleul în TypeScript pur (fără React/DOM): import, gravitație, filtre, ferestre RVI, șocuri, distanță, map-matching, agregare, rutare A*, comparație. Rulează în Web Worker, în UI și în scripturile Node.- Harta: Leaflet direct (BSD-2), printr-un hook propriu (fără
react-leaflet, licență Hippocratic). Grafice: uPlot. Stocare: IndexedDB (idb). ZIP:fflate(+ cititor propriu ZIP64). - Turele importate actualizează imediat harta și rutarea în aceeași sesiune, fără rebuild/redeploy:
stratul = agregare(snapshot, turele locale), cu versiune; cache-urile de rutare sunt indexate după versiune.
- Cod: MIT (LICENSE).
- Date derivate din OpenStreetMap (
public/data/graph-timisoara.json,comfort-layer.*,shock-zones.*,data/raw/): ODbL 1.0, „© OpenStreetMap contributors”. Nu se relicențiază MIT.
Turele personale rămân pe dispozitiv. Nimic nu se încarcă automat. Stratul publicat conține doar valori agregate pe muchii, fără timpi individuali, fără ID-uri de dispozitiv și fără primii/ultimii 200 m ai fiecărei ture. Fără analytics, trackere, fonturi sau scripturi terțe; singurele cereri externe sunt tile-urile OpenStreetMap. Detalii în aplicație: Despre date → Ce date stocăm.
- Problemele concrete în spațiul public merg pe canalul oficial Sesizări (https://sesizari.primariatm.ro/); ShockGrid nu colectează și nu trimite sesizări.
- Exporturile GeoJSON (Despre date) pot deveni un strat pentru departamentul municipal responsabil de infrastructura velo (beneficiar posibil, nu partener confirmat).
- În producție, Primăria ar folosi propriul server de tile-uri.
Mai multe: LIMITARI.md · docs/TEREN.md · docs/DEMO.md · docs/sensorlogger-format.md · PROGRESS.md
Inspirație, menționată onest: SmartRoadSense (Universitatea din Urbino) estimează rugozitatea drumurilor cu telefoane în mașini. Contribuția noastră: adaptarea la bicicletă, rutarea pe baza vibrației măsurate, separarea clară între măsurat, estimat din OpenStreetMap și necunoscut, și date reale din Timișoara.