How kaleimhc/dzikinabialolece.pl works
Dziki na Białołęce is a web map for crowdsourced wild-boar sightings and spatial encounter-risk analysis. The user workflow is to view risk on the map, submit a sighting, or choose and recalculate one of three modes: FAST, PUB, or RESEARCH. Results are served as map layers; RESEARCH additionally exposes pipeline progress and spatial-model diagnostics. The graph combines sampled source relationships with README-documented architecture; unsampled implementation details are not inferred.
Main entry points: PipelineTab.jsx Pipeline controls · App.jsx App shell · orchestrator_research.py Research orchestrator · views.py Django API
Components 23
Map and reporting
- App shell
frontend/src/App.jsx - Risk map
frontend/src/components/MapContainer.jsx - Map controls
frontend/src/components/LayerToggles.jsx - Sightings report
frontend/src/components/ReportSheet.jsx - Client state
frontend/src/stores/sightingsStore.js - Mode and recalc
frontend/src/components/RecalcPanel.jsx
Sightings and spatial data
- Django API
src/analytics/views.py - Sighting endpoints
src/sightings/views.py - Sightings data
src/sightings/models.py
Risk calculation
- FAST/PUB router
src/analytics/mode_router.py - Risk tasks
src/analytics/tasks.py - Spatial grids
src/sightings/models.py
Research workflow
- Research panel
frontend/src/panels/ResearchPanel/index.jsx - Pipeline controls
frontend/src/panels/ResearchPanel/tabs/PipelineTab.jsx - Live progress
frontend/src/hooks/usePipelineProgress.js - Research materials
frontend/src/panels/ResearchPanel/tabs - Model diagnostics
frontend/src/panels/ResearchPanel/components/DiagnosticsReport.jsx - Research tasks
src/analytics/tasks_research.py - Research orchestrator
src/analytics/orchestrator_research.py - Research runs and logs
src/analytics/models_research.py - R spatial models
r_scripts - Progress WebSocket
src/analytics/consumers.py
Other components
- Map user
Connections 28
- Map user → App shell: uses
- App shell → Risk map: renders
frontend/src/App.jsx - App shell → Sightings report: renders
frontend/src/App.jsx - App shell → Research panel: renders
frontend/src/App.jsx - App shell → Client state: reads
frontend/src/App.jsx - Map controls → Risk map: controls layers
- Mode and recalc → Client state: reads state
frontend/src/components/RecalcPanel.jsx - Research panel → Pipeline controls: renders
frontend/src/panels/ResearchPanel/index.jsx - Research panel → Research materials: renders
frontend/src/panels/ResearchPanel/index.jsx - Pipeline controls → Live progress: tracks run
frontend/src/panels/ResearchPanel/tabs/PipelineTab.jsx - Pipeline controls → Model diagnostics: shows diagnostics
- Map user → Sighting endpoints: submits sighting
- Sighting endpoints → Sightings data: reads and writes
src/sightings/views.py - Map user → Django API: requests risk
- Django API → Risk tasks: queues calculation
- Risk tasks → FAST/PUB router: dispatches modes
src/analytics/tasks.py - FAST/PUB router → Spatial grids: calculates grid risk
src/analytics/mode_router.py - FAST/PUB router → R spatial models: runs PUB scripts
src/analytics/mode_router.py - Map user → Pipeline controls: starts research run
- Pipeline controls → Research tasks: requests run
- Research tasks → Research orchestrator: invokes
src/analytics/tasks_research.py - Research tasks → Research runs and logs: loads run
src/analytics/tasks_research.py - Research orchestrator → Research runs and logs: logs run steps
src/analytics/orchestrator_research.py - Research orchestrator → R spatial models: runs R pipeline
src/analytics/orchestrator_research.py - Research orchestrator → Progress WebSocket: emits progress
- Live progress → Progress WebSocket: receives events
frontend/src/hooks/usePipelineProgress.js - Pipeline controls → Django API: fetches status
frontend/src/panels/ResearchPanel/tabs/PipelineTab.jsx - Risk map → Django API: loads risk layers