🌱 SmartAgroPlan

Intelligent Farm Management & Precision Agriculture System

Features • Tech Stack • Getting Started • API Documentation • Architecture

📖 Overview

SmartAgroPlan is a comprehensive precision agriculture platform that leverages data-driven insights and scientific models to optimize farm operations. Built with modern .NET technologies, it provides farmers and agronomists with actionable recommendations for:

💧 Irrigation Management - FAO-56 based evapotranspiration calculations and soil moisture tracking
🧪 Fertilization Planning - Nutrient requirement analysis, product optimization, and application scheduling
🌾 Crop Management - Variety selection, phenological stage tracking, and yield forecasting
🌦️ Weather Integration - Real-time and historical weather data from OpenMeteo API
📊 Field Analytics - Soil analysis, nutrient balance, and field condition monitoring
📍 Geospatial Support - NetTopologySuite for field boundary management

✨ Key Features

🚜 Fertilizer Management

Season Planning: Generate complete fertilization plans based on crop requirements
Nutrient Calculations: Scientific nutrient requirement and soil supply analysis
Product Optimization: AI-driven fertilizer product selection
Application Tracking: Record and monitor actual fertilizer applications
Nutrient Analysis: Real-time deficit detection and balance monitoring

💧 Irrigation Intelligence

FAO-56 Methodology: Scientifically accurate evapotranspiration calculations
Smart Scheduling: Weather-aware irrigation recommendations
Batch Processing: Multi-field recommendation generation
Soil Moisture Tracking: Real-time field water status monitoring

🌾 Crop & Field Management

Crop Variety Database: Comprehensive crop coefficient definitions
Field Monitoring: Track soil conditions, history, and phenological stages
Geospatial Data: GeoJSON field boundary support with NetTopologySuite
Historical Tracking: Complete crop rotation and application history

🌐 Weather Services

Current Conditions: Real-time weather data
7-Day Forecast: Detailed weather predictions
Historical Data: Access past weather patterns for analysis

🛠 Technology Stack

Backend Framework

.NET 9 - Latest .NET platform with native AOT support
ASP.NET Core - High-performance REST API framework
C# 13 - Modern language features and null safety

Architecture & Patterns

MediatR (v13.0) - CQRS implementation for clean command/query separation
AutoMapper (v15.0) - Object-to-object mapping for DTOs
FluentValidation (v12.0) - Strongly-typed validation rules
FluentResults (v4.0) - Railway-oriented programming for error handling

Database & ORM

PostgreSQL - Robust relational database with spatial support
Entity Framework Core (v9.0.8) - Modern ORM with migrations
Npgsql.EntityFrameworkCore.PostgreSQL (v9.0.4) - PostgreSQL provider
NetTopologySuite (v2.6) - Geospatial data support (GeoJSON, geometries)

API Documentation & Testing

Scalar (v2.7.2) - Modern OpenAPI/Swagger documentation UI
OpenAPI - API specification (ASP.NET Core 9)
xUnit (v2.9.3) - Unit testing framework
Moq (v4.20.72) - Mocking library
FluentAssertions (v8.6.0) - Expressive test assertions
Coverlet (v6.0.4) - Code coverage analysis

Logging & Monitoring

Serilog (v9.0.0) - Structured logging with file and console sinks
Serilog.Expressions (v5.0.0) - Advanced log filtering

Quality Assurance

SonarCloud - Continuous code quality and security analysis
GitHub Actions - CI/CD pipeline automation
Code Coverage - Automated test coverage reporting

Development Tools

Rider / Visual Studio - JetBrains and Microsoft IDEs
Docker - Containerization (planned)
User Secrets - Secure local configuration management

🚀 Getting Started

Prerequisites

Ensure you have the following installed:

.NET 9 SDK (latest version)
PostgreSQL 15+
Git
IDE: Visual Studio 2022 / JetBrains Rider / VS Code

Installation

Clone the repository

git clone https://github.com/Skiper29/SmartAgroPlan.git
cd SmartAgroPlan

Configure the database connection

Create appsettings.Development.json in SmartAgroPlan.WebAPI/:

{
  "ConnectionStrings": {
    "DefaultConnection": "Host=localhost;Port=5432;Database=SmartAgroPlan;Username=postgres;Password=yourpassword"
  },
  "OpenMeteo": {
    "BaseUrl": "https://api.open-meteo.com/v1"
  }
}

Apply database migrations

cd SmartAgroPlan.WebAPI
dotnet ef database update

Run the application

dotnet run

The API will start at:

HTTPS: https://localhost:7001
HTTP: http://localhost:5000

Access API Documentation

Navigate to:

Scalar UI: https://localhost:7001/scalar/v1
OpenAPI JSON: https://localhost:7001/openapi/v1.json

🧪 Running Tests

Run all tests

dotnet test

Run with code coverage

dotnet test /p:CollectCoverage=true /p:CoverletOutputFormat=opencover

Run specific test project

dotnet test SmartAgroPlan.XUnitTest

The test suite includes:

✅ Unit tests for business logic (BLL)
✅ Repository tests with in-memory database (DAL)
✅ Controller integration tests (WebAPI)
✅ Validation tests with FluentValidation

📚 API Endpoints

🌾 Crops

Method	Endpoint	Description
`GET`	`/api/crop`	Get all crop varieties
`GET`	`/api/crop/{id}`	Get crop variety by ID
`POST`	`/api/crop`	Create new crop variety
`PUT`	`/api/crop`	Update crop variety
`DELETE`	`/api/crop/{id}`	Delete crop variety

🗺️ Fields

Method	Endpoint	Description
`GET`	`/api/field`	Get all fields
`GET`	`/api/field/{id}`	Get field by ID
`POST`	`/api/field`	Create new field
`PUT`	`/api/field`	Update field
`DELETE`	`/api/field/{id}`	Delete field

🌱 Field Conditions

Method	Endpoint	Description
`GET`	`/api/fieldcondition`	Get all field conditions
`GET`	`/api/fieldcondition/{id}`	Get condition by ID
`GET`	`/api/fieldcondition/{fieldId}`	Get conditions for field
`POST`	`/api/fieldcondition`	Create field condition record
`DELETE`	`/api/fieldcondition/{id}`	Delete condition record

🪨 Soil

Method	Endpoint	Description
`GET`	`/api/soil`	Get all soil types
`GET`	`/api/soil/{id}`	Get soil by ID
`GET`	`/api/soil/{soilType}`	Get soil by type

💧 Irrigation

Method	Endpoint	Description
`GET`	`/api/irrigation/recommendation/{fieldId}`	Get irrigation recommendation
`POST`	`/api/irrigation/recommendations/batch`	Get batch recommendations
`GET`	`/api/irrigation/schedule/weekly/{fieldId}`	Get weekly irrigation schedule

Query Parameters:

includeForecast - Include weather forecast in calculations
forecastDays - Number of forecast days (default: 7)
startDate - Schedule start date

🧪 Fertilizer - Planning

Method	Endpoint	Description
`GET`	`/api/fertilizer/planning/season-plan`	Calculate season fertilizer plan
`POST`	`/api/fertilizer/planning/season-plan`	Save season plan to database
`GET`	`/api/fertilizer/planning/current-recommendation`	Get current stage recommendation
`GET`	`/api/fertilizer/planning/season-plan/saved`	Get saved season plan

Query Parameters:

fieldId - Field identifier
targetYield - Target yield (tons/ha)
sowingDate - Sowing date

🧪 Fertilizer - Applications

Method	Endpoint	Description
`POST`	`/api/fertilizer/applications`	Record fertilizer application
`GET`	`/api/fertilizer/applications/history`	Get application history
`GET`	`/api/fertilizer/applications/{recordId}`	Get application details
`PUT`	`/api/fertilizer/applications/{recordId}`	Update application record
`DELETE`	`/api/fertilizer/applications/{recordId}`	Delete application record
`GET`	`/api/fertilizer/applications/upcoming`	Get upcoming applications
`GET`	`/api/fertilizer/applications/date-range`	Get applications by date range
`GET`	`/api/fertilizer/applications/summary`	Get nutrient application summary
`GET`	`/api/fertilizer/applications/plans`	Get saved application plans
`PUT`	`/api/fertilizer/applications/plans/{planId}`	Update application plan

🧪 Fertilizer - Calculations

Method	Endpoint	Description
`GET`	`/api/fertilizer/calculations/nutrient-requirement`	Calculate nutrient requirements
`GET`	`/api/fertilizer/calculations/soil-nutrient-supply`	Calculate soil nutrient supply
`POST`	`/api/fertilizer/calculations/optimize-products`	Optimize product selection

Query Parameters:

cropVarietyId - Crop variety ID
targetYield - Target yield (tons/ha)
fieldAreaHa - Field area in hectares
fieldId - Field identifier

🧪 Fertilizer - Analysis

Method	Endpoint	Description
`GET`	`/api/fertilizer/analysis/nutrient-balance`	Get nutrient balance analysis
`GET`	`/api/fertilizer/analysis/nutrient-deficit`	Analyze nutrient deficits

🧪 Fertilizer - Products

Method	Endpoint	Description
`GET`	`/api/fertilizer/products`	Get all fertilizer products
`GET`	`/api/fertilizer/products/by-type`	Get products by type
`GET`	`/api/fertilizer/products/search`	Search products
`GET`	`/api/fertilizer/products/{productId}`	Get product by ID
`POST`	`/api/fertilizer/products`	Create new product
`PUT`	`/api/fertilizer/products/{productId}`	Update product
`DELETE`	`/api/fertilizer/products/{productId}`	Delete product

🌦️ Weather

Method	Endpoint	Description
`GET`	`/api/weather/current`	Get current weather
`GET`	`/api/weather/forecast`	Get weather forecast
`GET`	`/api/weather/historical`	Get historical weather data

Query Parameters:

lat - Latitude
lon - Longitude
days - Forecast days (default: 7)
startDate - Historical data start
endDate - Historical data end

🏗 Architecture

Project Structure

SmartAgroPlan/
│
├── SmartAgroPlan.WebAPI/           # 🌐 Presentation Layer
│   ├── Controllers/                # API endpoints
│   ├── Extensions/                 # Service configuration extensions
│   ├── Data/                       # CSV datasets for seeding
│   └── Program.cs                  # Application entry point
│
├── SmartAgroPlan.BLL/              # 💼 Business Logic Layer
│   ├── Services/                   # Business services
│   │   ├── Crops/                  # Crop coefficient calculations
│   │   ├── Irrigation/             # FAO-56 irrigation logic
│   │   ├── FertilizerForecasting/  # Fertilizer calculations
│   │   ├── Weather/                # OpenMeteo integration
│   │   └── Caching/                # Phenology caching
│   ├── MediatR/                    # CQRS commands and queries
│   │   ├── Crops/
│   │   ├── Fields/
│   │   ├── Irrigation/
│   │   └── FertilizerForecasting/
│   ├── DTO/                        # Data transfer objects
│   ├── Validators/                 # FluentValidation rules
│   ├── Mapping/                    # AutoMapper profiles
│   ├── Models/                     # Business models
│   ├── Utils/                      # Helper utilities
│   ├── Interfaces/                 # Service contracts
│   ├── Attributes/                 # Custom attributes
│   └── PipelineBehaviour/          # MediatR behaviors
│
├── SmartAgroPlan.DAL/              # 🗄️ Data Access Layer
│   ├── Entities/                   # Database entities
│   │   ├── Crops/
│   │   ├── Fields/
│   │   ├── Irrigation/
│   │   ├── FertilizerForecasting/
│   │   └── Calendar/
│   ├── Configurations/             # EF Core entity configurations
│   ├── Repositories/               # Data repositories
│   ├── Migrations/                 # EF Core migrations
│   ├── Persistence/                # DbContext
│   ├── Enums/                      # Database enums
│   └── Helpers/                    # Data helpers
│
└── SmartAgroPlan.XUnitTest/        # 🧪 Testing Layer
    ├── BLL_Tests/                  # Business logic tests
    ├── DAL_Tests/                  # Repository tests
    └── WebAPI_Tests/               # Controller tests

Design Patterns

🎯 CQRS - Command Query Responsibility Segregation with MediatR
🗂️ Repository Pattern - Data access abstraction
🔄 Pipeline Behavior - Cross-cutting concerns (validation, caching)
🏭 Factory Pattern - Object creation strategies
📦 Dependency Injection - Built-in ASP.NET Core DI
🧬 Domain-Driven Design - Rich domain models
🚂 Railway-Oriented Programming - FluentResults for error handling

Key Components

1. MediatR Pipeline

Request → Validation Behavior → Caching Behavior → Handler → Response

2. Caching Strategy

Phenology-based cache invalidation
Field-related request tracking
Automatic cache refresh on data changes

3. FAO-56 Irrigation Model

Reference evapotranspiration (ET₀)
Crop coefficient calculations
Soil water balance
Management allowed depletion (MAD)

4. Fertilizer Optimization

Nutrient requirement calculations
Soil supply analysis
Linear programming for product mix
Multi-stage fertilization planning

🔧 Configuration

Database Connection

{
  "ConnectionStrings": {
    "DefaultConnection": "Host=localhost;Port=5432;Database=SmartAgroPlan;Username=youruser;Password=yourpassword"
  }
}

Logging (Serilog)

{
  "Serilog": {
    "MinimumLevel": {
      "Default": "Information",
      "Override": {
        "Microsoft": "Warning",
        "System": "Warning"
      }
    },
    "WriteTo": [
      {
        "Name": "File",
        "Args": {
          "path": "./logs/log-.txt",
          "rollingInterval": "Day"
        }
      },
      {
        "Name": "Console"
      }
    ]
  }
}

CORS

{
  "CORS": {
    "AllowedOrigins": "*",
    "AllowedHeaders": "*",
    "AllowedMethods": "*"
  }
}

Weather API (OpenMeteo)

{
  "OpenMeteo": {
    "BaseUrl": "https://api.open-meteo.com/v1"
  }
}

🔍 Code Quality

SonarCloud Integration

This project maintains high code quality standards through continuous analysis:

✅ Maintainability Rating - A-grade maintainable code
🔐 Security Rating - Vulnerability-free codebase
🐞 Bug Detection - Zero critical bugs
📊 Test Coverage - >80% code coverage

🔗 View Live Dashboard

CI/CD Pipeline

GitHub Actions workflow includes:

Build verification
Unit test execution
Code coverage analysis
SonarCloud quality gate
Security scanning

🗺️ Roadmap

✅ Completed

🚧 In Progress

Advanced caching with Redis
Real-time notifications with SignalR
Machine learning yield predictions

📅 Planned

Frontend dashboard (React/Blazor)
Satellite imagery integration
IoT sensor integration (soil moisture, weather stations)
Multi-tenant organization support
Advanced reporting and analytics
Export to Excel/PDF

🤝 Contributing

Contributions are welcome! Please follow these steps:

Fork the repository
Create a feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

Please ensure:

Code passes all tests
Code coverage remains above 80%
SonarCloud quality gate passes
Follows C# coding conventions

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👥 Authors

Skiper29 - Initial work - GitHub Profile

🙏 Acknowledgements

Lviv Polytechnic National University - Academic supervision
Open-Meteo - Free weather API
FAO - Irrigation methodology (FAO-56)
Microsoft - .NET platform and tooling
JetBrains - Rider IDE
SonarCloud - Code quality analysis
Open-source community for amazing libraries

📞 Contact & Support

🐛 Issues: GitHub Issues
💬 Discussions: GitHub Discussions

Made with ❤️ for sustainable agriculture

⭐ Star this repo if you find it useful!

Name		Name	Last commit message	Last commit date
Latest commit History 247 Commits
.github/workflows		.github/workflows
SmartAgroPlan.BLL		SmartAgroPlan.BLL
SmartAgroPlan.DAL		SmartAgroPlan.DAL
SmartAgroPlan.WebAPI		SmartAgroPlan.WebAPI
SmartAgroPlan.XUnitTest		SmartAgroPlan.XUnitTest
.gitattributes		.gitattributes
.gitignore		.gitignore
README.md		README.md
SmartAgroPlan.sln		SmartAgroPlan.sln

Folders and files

Latest commit

History

Repository files navigation

🌱 SmartAgroPlan

Intelligent Farm Management & Precision Agriculture System

📖 Overview

✨ Key Features

🚜 Fertilizer Management

💧 Irrigation Intelligence

🌾 Crop & Field Management

🌐 Weather Services

🛠 Technology Stack

Backend Framework

Architecture & Patterns

Database & ORM

API Documentation & Testing

Logging & Monitoring

Quality Assurance

Development Tools

🚀 Getting Started

Prerequisites

Installation

🧪 Running Tests

Run all tests

Run with code coverage

Run specific test project

📚 API Endpoints

🌾 Crops

🗺️ Fields

🌱 Field Conditions

🪨 Soil

💧 Irrigation

🧪 Fertilizer - Planning

🧪 Fertilizer - Applications

🧪 Fertilizer - Calculations

🧪 Fertilizer - Analysis

🧪 Fertilizer - Products

🌦️ Weather

🏗 Architecture

Project Structure

Design Patterns

Key Components

1. MediatR Pipeline

2. Caching Strategy

3. FAO-56 Irrigation Model

4. Fertilizer Optimization

🔧 Configuration

Database Connection

Logging (Serilog)

CORS

Weather API (OpenMeteo)

🔍 Code Quality

SonarCloud Integration

CI/CD Pipeline

🗺️ Roadmap

✅ Completed

🚧 In Progress

📅 Planned

🤝 Contributing

📄 License

👥 Authors

🙏 Acknowledgements

📞 Contact & Support

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages