Field Mapper

Open-source precision agriculture platform for drone NDVI analysis and prescription maps

---

⚠️ Внимание: Платформа находится в активной разработке и ещё не протестирована в полной мере в production-условиях. Мы активно работаем над стабильностью. Используйте на свой страх и риск. Сообщайте о багах через Issues.

---

Field Mapper — веб-платформа для фермеров и агрономов, которая превращает данные с дронов (DJI Mavic 3M, NDVI снимки) в карты предписаний для сельскохозяйственной техники.

---

🚀 Features

🌱 Field Management	🚁 NDVI Analysis	📤 Export	🚜 Prescription Maps
Field boundaries on map	GeoTIFF upload	ISOXML (John Deere, Claas)	Auto norm calculation
Owners & cadastre	Automatic zoning	DJI KMZ (WPML 1.0.6)	3 productivity zones
KMZ import/export	Large aggregated zones	Shapefile	Norms: 150/250/350 kg/ha
Statistics & reports	Scan history	Bulk ZIP export	Zone statistics
	Scan deletion
	Fullscreen mode

---

⚡ Quick Start

Docker (recommended)

docker-compose up -d --build

Open http://localhost

Local

python3.12 -m venv venv && source venv/bin/activate
pip install -r requirements.txt && npm install
python app.py

Open http://localhost:8888

📖 Full guide: docs/getting-started/installation.md

---

📚 Documentation

Section	Description
🚀 Quick Start	Installation & setup
👤 User Guide	Fields, NDVI, export
🚜 Prescription Maps	ISOXML export, application rates
👨‍💻 Developer Guide	Architecture, API, testing
📋 Changelog	Release history
🤖 AI Contexts	Context for AI assistants

🌐 Online docs: https://greenvisionfarm.github.io/precision-ag-platform/

---

🏗️ Architecture

┌─────────────┐     ┌─────────────┐
│   Nginx     │────▶│   Tornado   │
│  (80/443)   │     │   (8888)    │
└─────────────┘     └──────┬──────┘
                           │
                    ┌──────▼──────┐
                    │   SQLite    │
                    │   /Postgres │
                    └──────┬──────┘
                           │
                    ┌──────▼──────┐
                    │  Redis+Huey │
                    │  (Queue)    │
                    └─────────────┘

Stack:

• Backend: Python 3.12 (Tornado, Peewee, Huey, GDAL, Rasterio, Scikit-learn)
• Frontend: jQuery, Leaflet, DataTables, Chart.js, ES6 Modules
• Infrastructure: Docker, Redis, Nginx

---

✅ Testing

# Backend
FIELD_MAPPER_ENV=test ./venv/bin/pytest tests/

# Frontend
npm test

# In Docker
docker-compose run --rm -e FIELD_MAPPER_ENV=test app pytest tests/
docker-compose run --rm app npm test

Status: 32 passed, 1 skipped | Coverage: ~65% (backend)

---

🗺️ Roadmap

Track progress on GitHub Projects and Issues.

Upcoming Releases

Milestone	Focus	Target
v2026.3	Orthomosaic from drone photos, mobile UI	Apr 2026
v2026.4	NDVI time series, yield prediction, OneSoil	May 2026
v2027.1	PostgreSQL/PostGIS, CI/CD, monitoring	Jan 2027

---

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

• 🐛 Bug Reports
• ✨ Feature Requests
• 🔧 Pull Requests

🤖 AI-Assisted Development: This project is built and actively developed with the help of AI agents (Qwen Code, etc.). This is a feature, not a bug — it allows us to move fast while maintaining quality.

---

📊 Project Metrics

Metric	Value
Tests	32 passed, 1 skipped
Coverage	~65% (backend)
Image Size	~1.5 GB (with GIS)
Build Time	~6 min (~2 min with cache)

---

🔗 Links

• GitHub: greenvisionfarm/precision-ag-platform
• Docs: GitHub Pages
• Issues: Bug Reports & Features
• Projects: GitHub Projects
• License: MIT
• Security: SECURITY.md

---

Last updated: April 6, 2026
Built with ❤️ and AI agents 🤖