How fuadalfiroj/terraloop works
TerraLoop is a browser-based crop-rotation decision-support system for smallholder farms. The principal workflow is to select a farm and record seasonal history, generate a constrained multi-year plan, evaluate budgets and soil health, then explore climate adaptations and compare or export strategies. The README also documents map-based field selection, NASA observation and dataset views, learning from harvest outcomes, and regional exhibition stories. Source excerpts here cover only the local static server, so most component relationships below reflect documented README workflows, not inspected call sites.
Main entry points: engine.mjs Rotation optimizer · dist Climate replay · comparison.mjs Strategy comparison · server.mjs Local web server
Components 18
Farm setup
- Local web server
server.mjs - Browser application
dist/app.mjs - Field selection
dist/farm-map.mjs - Farm memory
dist
Rotation planning
- Rotation optimizer
dist/engine.mjs - Rotation planner
dist/rotation-studio.mjs - Climate replay
dist
Farm assessment
- Water budget
dist - Nitrogen balance
dist - Soil health
dist/soil-health.mjs - Farm simulation
dist/simulation-model.mjs
Earth observations
- NASA observations
dist/earthdata-hub.mjs - NASA dataset directory
dist/nasa-data.mjs
Decision experience
- Strategy comparison
dist/comparison.mjs - Resilience passport
dist - Harvest learning
dist - Exhibition studio
dist/exhibition-ui.mjs
Other components
- Farmer
Connections 20
- Farmer → Local web server: opens locally
README.md - Local web server → Browser application: serves browser app
server.mjs - Farmer → Field selection: selects farmland
README.md - Farmer → Farm memory: records seasons
README.md - Farm memory → Rotation optimizer: calibrates plans
README.md - Rotation planner → Rotation optimizer: generates plans
README.md - Rotation optimizer → Water budget: budgets irrigation
README.md - Rotation optimizer → Nitrogen balance: tracks nitrogen
README.md - Rotation optimizer → Soil health: models soil
README.md - Climate replay → Rotation optimizer: re-optimizes horizon
README.md - Farmer → Climate replay: applies stress
README.md - NASA observations → NASA dataset directory: documents datasets
README.md - Farmer → NASA observations: reviews observations
README.md - Farmer → Farm simulation: views scenarios
README.md - Rotation optimizer → Strategy comparison: compares strategies
README.md - Climate replay → Strategy comparison: supplies stress scenario
README.md - Strategy comparison → Resilience passport: exports comparison
README.md - Farmer → Harvest learning: records outcomes
README.md - Harvest learning → Rotation optimizer: calibrates yields
README.md - Farmer → Exhibition studio: views farm stories
README.md