kengodhil/Remote-Sensing-Based-Mapping-and-Monitoring-of-Avocado-Plantations-in-Njombe-Region-Tanzania

Remote Sensing-Based Mapping and Monitoring of Avocado Plantations in Njombe Region, Tanzania: A WebGIS Decision Support System for Sustainable Agriculture # 🥑 Njombe Avocado WebGIS Decision Support System Remote-sensing-based mapping and monitoring of avocado plantations in Njombe Region, Tanzania — a full-stack WebGIS platform combining Sentinel-2/Landsat classification, a PostGIS spatial database, a FastAPI backend, and an interactive Leaflet dashboard. ## Project Status Portfolio/personal project. Research framing (problem statement, literature review, methodology) is complete; the software stack (database, API, dashboard, remote-sensing scripts) is implemented and runnable but has not yet been executed against real field-validated training data — see `docs/phase4_remote_sensing_design.md` and `research/phase10_research_documentation.md` (Chapter 4) for what's pending. ## Repository Structure ``` project-root/ ├── backend/ FastAPI REST API (Python) ├── frontend/ Leaflet + Chart.js dashboard (static HTML/JS) ├── database/ PostGIS schema (schema.sql) ├── geoserver/ GeoServer REST automation + SLD styling ├── remote_sensing/ Classification pipelines (GEE + local rasterio) ├── docker/ docker-compose orchestration ├── docs/ Phase-by-phase system documentation ├── research/ Academic write-up (problem, lit review, methodology) ├── tests/ (backend/tests) API test suite └── .github/workflows/ CI pipeline ``` ## Quick Start ```bash git clone cd project-root cp .env.example .env # edit passwords before real use docker compose -f docker/docker-compose.yml --env-file .env up -d --build ``` - Dashboard: localhost - API docs: localhost - GeoServer: localhost (run `python geoserver/configure_geoserver.py` once healthy) See `docs/installation_guide.md` for a from-scratch (non-Docker) setup, and `docs/deployment_guide.md` for cloud hosting notes. ## Documentation Index | Phase | Document | |---|---| | 1 — Problem Identification | `research/phase1_problem_identificatio …