How utg1209/peak-finder_data511 works
Peak Finder is a static hiking decision app: hikers set a home city, quarter, and trip-condition limits, compare ranked hikes on a map, then inspect a hike’s costs, seasonal conditions, trail profile, and advice. The browser loads committed JSON, validates it, indexes it, and serves it to the Explore and hike views; Explore computes matches and routes selections to hike details. The data pipeline prepares travel, cost, trail, and seasonal assets for that interface. Several pipeline stages and detail-page modules are unsampled, so their internal calls are not asserted.
Main entry points: App.tsx App shell · Explore.tsx Explore hikes · loaders.ts JSON loaders & index · lane2_common.py Pipeline utilities
Components 22
Hiking app
- App shell
app/src/App.tsx - Explore hikes
app/src/screens/Explore/Explore.tsx - Hike map
app/src/components/UsMap.tsx - Hike details
app/src/screens/Hike/Hike.tsx - Data & about
app/src/screens/About/About.tsx - Detail charts
app/src/components/charts
App data
- Dataset loader hook
app/src/data/useDataset.ts - JSON loaders & index
app/src/data/loaders.ts - Data contracts
app/src/data/schema.ts - Trail profiles
app/src/screens/Explore/view3d
Decision models
- URL filters
app/src/lib/useFilters.ts - Filter logic
app/src/lib/filters.ts - Quarter matching
app/src/models/match.ts - Cost model
app/src/models/cost.ts
Data pipeline
- Travel estimates
pipeline/travel.py - Cost estimates
pipeline/cost.py - Profile generation
pipeline/profiles.py - Walk building
pipeline/walks/build_walk.py - Trail asset stages
pipeline/trail_kit/pipeline - Pipeline utilities
pipeline/lane2_common.py - Trail utilities
pipeline/trail_kit/pipeline/common.py
Other components
- Hiker
Connections 20
- Hiker → App shell: opens app
README.md - App shell → Dataset loader hook: loads dataset
app/src/App.tsx - Dataset loader hook → JSON loaders & index: requests data
app/src/data/useDataset.ts - JSON loaders & index → Data contracts: validates JSON
app/src/data/loaders.ts - App shell → Explore hikes: routes to
app/src/App.tsx - App shell → Hike details: routes to
app/src/App.tsx - App shell → Data & about: routes to
app/src/App.tsx - Explore hikes → Hike map: renders map
app/src/screens/Explore/Explore.tsx - Explore hikes → URL filters: reads filters
app/src/screens/Explore/Explore.tsx - URL filters → Filter logic: parses and serializes
app/src/lib/useFilters.ts - Explore hikes → Quarter matching: scores quarters
app/src/screens/Explore/Explore.tsx - Hike details → Detail charts: renders charts
app/src/screens/Hike/Hike.tsx - Hike details → JSON loaders & index: loads profile data
app/src/screens/Hike/Hike.tsx - Travel estimates → Pipeline utilities: uses helpers
pipeline/travel.py - Cost estimates → Pipeline utilities: uses helpers
pipeline/cost.py - Profile generation → Pipeline utilities: uses helpers
pipeline/profiles.py - Walk building → Profile generation: may supply routes
- Trail asset stages → Trail utilities: uses helpers
pipeline/trail_kit/pipeline/s5_build_page.py - Pipeline utilities → JSON loaders & index: produces app data
- Trail utilities → Trail profiles: produces trail assets