How bariskisir/turkiyeearthquakeforecast works
This is an experimental Türkiye regional seismic-signal dashboard, not an earthquake warning or exact-event prediction system. The main workflow runs from dashboard selection to a date-specific forecast request, through catalogue refresh and model calculation (preparation, field construction, ranking), then returns regional signals for map display. The separate recent-event catalogue and methodology/privacy UI are supporting product capabilities. Relationships reflect the README’s documented boundaries and sampled calls; internal cache-adapter wiring and some component details are represented only where the tree or documentation supports them.
Main entry points: Dashboard.tsx Dashboard · catalog-service.ts Catalogue refresh · forecast-service.ts Forecast service · useDashboard.ts Dashboard state
Components 26
Dashboard experience
- Home page
src/app/page.tsx - Dashboard
src/components/Dashboard.tsx - Dashboard state
src/components/useDashboard.ts - Controls
src/components/DashboardControls.tsx - Forecast workspace
src/components/ForecastWorkspace.tsx - Signal map
src/components/ForecastMap.tsx - Recent earthquakes
src/components/RecentEarthquakes.tsx - Methodology dialog
src/components/MethodologyModal.tsx - Privacy dialog
src/components/PrivacyModal.tsx - Browser preferences
src/lib/browser-storage.ts - Telemetry tracker
src/components/TelemetryTracker.tsx
Earthquake catalogue
- Catalogue access
src/lib/catalog.ts - Catalogue refresh
src/lib/catalog-service.ts - Catalogue validation
src/lib/catalog-domain.ts - Provider client
src/lib/sismik-client.ts
Forecast engine
- Model preparation
src/lib/forecast/model-context.ts - Field and ranking
src/lib/forecast/index.ts - Model calculations
src/lib/forecast
API and caching
- Forecast HTTP route
src/app/api/forecast/route.ts - Forecast service
src/lib/forecast-service.ts - Forecast cache
src/lib/forecast-cache.ts - B2 adapter
src/lib/b2-cache.ts
External services
- Sismik Harita API
- Backblaze B2
- OpenStreetMap / CARTO
Other components
- Visitor
Connections 28
- Visitor → Home page: opens
- Home page → Dashboard: renders
- Dashboard → Dashboard state: uses state
- Dashboard → Controls: presents
- Dashboard → Forecast workspace: presents
- Dashboard → Methodology dialog: presents
- Dashboard → Privacy dialog: presents
- Dashboard state → Forecast HTTP route: fetches forecasts
- Dashboard state → Browser preferences: reads/writes preferences
- Forecast workspace → Signal map: renders signals
- Forecast workspace → Recent earthquakes: renders events
- Signal map → Browser preferences: stores map view
- Signal map → OpenStreetMap / CARTO: loads tiles
- Forecast HTTP route → Forecast service: requests forecast
- Forecast service → Catalogue access: gets catalogue
- Forecast service → Field and ranking: calculates matrix
- Forecast service → Forecast cache: reads/writes bundles
- Catalogue access → Catalogue refresh: coordinates refresh
- Catalogue refresh → Catalogue validation: normalises and merges
- Catalogue refresh → Provider client: fetches updates
- Provider client → Sismik Harita API: requests events
- Catalogue refresh → Backblaze B2: persists daily updates
- Forecast cache → B2 adapter: uses adapter
- B2 adapter → Backblaze B2: stores forecast bundles
- Field and ranking → Model preparation: prepares events
- Model preparation → Model calculations: uses model calculations
- Field and ranking → Model calculations: builds and ranks fields
- Telemetry tracker → Visitor: tracks usage