# shreyaaa463/soilhealthandmicorbialbiodiversitydashboard architecture

> Architecture diagram of the GitHub repository shreyaaa463/soilhealthandmicorbialbiodiversitydashboard, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shreyaaa463/soilhealthandmicorbialbiodiversitydashboard
- Repository: https://github.com/shreyaaa463/soilhealthandmicorbialbiodiversitydashboard

## Overview

##### Project Type & Purpose
- This is a full-stack, AI-powered web application (“SoilSense Dashboard”) for assessing soil health, estimating microbial biodiversity, and providing crop/fertilizer/water recommendations.
- Frontend: Single‐page or multi‐view HTML/CSS/JS (Tailwind, Chart.js).
- Backend: Flask app in Python, serving web routes & APIs.
- ML & Rules: Random Forest model + rule-based logic modules.
- Data: Local CSV files (soil rules, fertilizer info, crop rotation) + external weather API (OpenWeatherMap).

##### File Structure Overview
- app.py: Flask entry point
- templates/: Jinja2 HTML views
- static/: CSS & client-side assets
- utils/: Core recommendation & diagnosis logic (crop_recommend, fertilizer_recommend, water_requirement, problem_diagnosis, weather fetch)
- Models/: Training & inference (train_model.py, saved model artifacts)
- data/: CSV datasets driving rule engines & training
- evaluation/: Accuracy checks for ML outputs
- requirements.txt: Dependency manifest

##### Key README Insights
- Architecture is layered: Presentation (HTML/CSS/JS) ↔ Application (Flask + utils) ↔ Data/Models (CSV + ML pipelines) ↔ External Services (Weather API).
- Emphasis on real-time weather integration, AI models, and visualizations.

a. Frontend Layer
- Browser client: renders index.html, pulls CSS/JS from static/styles.css.
- Visualization libs: Chart.js, Matplotlib/Seaborn (server-side image generation or JSON data for client).
b. Backend Layer (Flask)
- HTTP Routes in app.py:
– GET / → serve index.html
– POST /analyze → invoke utils modules + ML inference
- Utils modules:
– problem_diagnosis.py (soil deficiency logic)
– crop_recommend.py (loads Random Forest model + label encoder)
– fertilizer_recommend.py, water_requirement.py, weather.py
c. Data & Model Layer
- Local CSV files (in data/) for rules & training
- ML Model artifacts (Models/class_names.pkl, label_encoder.pkl)
- Training script (Models/train_model.py) – separate pipeline
- Evaluation scripts (evaluation/check_accuracy.py)
d. External Services
- OpenWeatherMap API for live weather data
e. Future (optional)
- Authentication & Firestore (Firebase)
- Satellite data (Google Earth Engine)

##### Relationships & Interactions
- Client → Flask API: user inputs → POST request
- Flask → utils.weather → External Weather API → JSON response
- Flask → utils modules + Models/*.pkl → generate recommendations
- Flask → templates + Chart.js/Matplotlib → render results back to client
- Evaluation scripts (offline) read model outputs + ground truth from data/

##### Architectural Patterns & Principles
- Layered separation: Presentation ↔ Business Logic ↔ Data/ML
- Modularization: each recommendation/diagnosis rule lives in its own module
- Separation of training (Models/train_model.py) vs inference (utils/*.py)
- Rule-based + ML hybrid pipeline

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Frontend Layer"
        direction TB
        Browser["Browser Client"]:::frontend
        IndexHTML["index.html"]:::frontend
        StylesCSS["styles.css"]:::frontend
    end

    %% Backend Layer
    subgraph "Backend Layer"
        direction TB
        FlaskAPI["Flask API (app.py)"]:::backend
    end

    %% Inference Pipeline
    subgraph "Inference Pipeline"
        direction TB
        ProblemDiag["problem_diagnosis.py"]:::backend
        CropRec["crop_recommend.py"]:::ml
        FertRec["fertilizer_recommend.py"]:::backend
        WaterReq["water_requirement.py"]:::backend
        WeatherMod["weather.py"]:::backend
    end

    %% Data & Model Artifacts
    subgraph "Data & Model Artifacts"
        direction TB
        SoilRules["soil_diagnostic_rules.csv"]:::data
        ChemFert["chemical_fertilizer.csv"]:::data
        OrgFert["organic_fertilizer.csv"]:::data
        CropRot["crop_rotation.csv"]:::data
        RawSoil["1.csv"]:::data
        ClassNames["class_names.pkl"]:::data
        LabelEnc["label_encoder.pkl"]:::data
    end

    %% Training & Evaluation
    subgraph "Training & Evaluation"
        direction TB
        TrainScript["train_model.py"]:::ml
        EvalScript["check_accuracy.py"]:::ml
    end

    %% External Services
    ExternalWeather["OpenWeatherMap API"]:::external

    %% Project Docs
    README["README.md"]:::external
    ReqTxt["requirements.txt"]:::external

    %% Connections
    Browser -->|GET /| FlaskAPI
    Browser -->|loads| IndexHTML
    IndexHTML -->|includes| StylesCSS
    FlaskAPI -->|POST /analyze| ProblemDiag
    FlaskAPI -->|invoke| CropRec
    FlaskAPI -->|invoke| FertRec
    FlaskAPI -->|invoke| WaterReq
    FlaskAPI -->|invoke| WeatherMod
    FlaskAPI -->|read input| RawSoil
    FlaskAPI -->|render results| Browser

    WeatherMod -->|fetch weather JSON| ExternalWeather

    ProblemDiag -->|read rules| SoilRules
    CropRec -->|load model| ClassNames
    CropRec -->|load encoder| LabelEnc
    FertRec -->|read data| ChemFert
    FertRec -->|read data| OrgFert
    WaterReq -->|read data| CropRot

    TrainScript -->|train on| RawSoil
    TrainScript -->|use rules| SoilRules
    EvalScript -->|evaluate| ClassNames
    EvalScript -->|evaluate| LabelEnc
    EvalScript -->|use data| RawSoil

    README --- ReqTxt

    %% Click Events
    click IndexHTML "https://github.com/shreyaaa463/soilhealthandmicorbialbiodiversitydashboard/blob/main/templates/index.html"
    click StylesCSS "https://github.com/shreyaaa463/soilhealthandmicorbialbiodiversitydashboard/blob/main/static/styles.css"
    click FlaskAPI "https://github.com/shreyaaa463/soilhealthandmicorbialbiodiversitydashboard/blob/main/app.py"
    click ProblemDiag "https://github.com/shreyaaa463/soilhealthandmicorbialbiodiversitydashboard/blob/main/utils/problem_diagnosis.py"
    click CropRec "https://github.com/shreyaaa463/soilhealthandmicorbialbiodiversitydashboard/blob/main/utils/crop_recommend.py"
    click FertRec "https://github.com/shreyaaa463/soilhealthandmicorbialbiodiversitydashboard/blob/main/utils/fertilizer_recommend.py"
    click WaterReq "https://github.com/shreyaaa463/soilhealthandmicorbialbiodiversitydashboard/blob/main/utils/water_requirement.py"
    click WeatherMod "https://github.com/shreyaaa463/soilhealthandmicorbialbiodiversitydashboard/blob/main/utils/weather.py"
    click SoilRules "https://github.com/shreyaaa463/soilhealthandmicorbialbiodiversitydashboard/blob/main/data/soil_diagnostic_rules.csv"
    click ChemFert "https://github.com/shreyaaa463/soilhealthandmicorbialbiodiversitydashboard/blob/main/data/chemical_fertilizer.csv"
    click OrgFert "https://github.com/shreyaaa463/soilhealthandmicorbialbiodiversitydashboard/blob/main/data/organic_fertilizer.csv"
    click CropRot "https://github.com/shreyaaa463/soilhealthandmicorbialbiodiversitydashboard/blob/main/data/crop_rotation.csv"
    click RawSoil "https://github.com/shreyaaa463/soilhealthandmicorbialbiodiversitydashboard/blob/main/data/1.csv"
    click ClassNames "https://github.com/shreyaaa463/soilhealthandmicorbialbiodiversitydashboard/blob/main/Models/class_names.pkl"
    click LabelEnc "https://github.com/shreyaaa463/soilhealthandmicorbialbiodiversitydashboard/blob/main/Models/label_encoder.pkl"
    click TrainScript "https://github.com/shreyaaa463/soilhealthandmicorbialbiodiversitydashboard/blob/main/Models/train_model.py"
    click EvalScript "https://github.com/shreyaaa463/soilhealthandmicorbialbiodiversitydashboard/blob/main/evaluation/check_accuracy.py"
    click README "https://github.com/shreyaaa463/soilhealthandmicorbialbiodiversitydashboard/blob/main/README.md"
    click ReqTxt "https://github.com/shreyaaa463/soilhealthandmicorbialbiodiversitydashboard/blob/main/requirements.txt"

    %% Styles
    classDef frontend fill:#bbdefb,stroke:#1e88e5,color:#000
    classDef backend fill:#c8e6c9,stroke:#43a047,color:#000
    classDef data fill:#ffe0b2,stroke:#fb8c00,color:#000
    classDef external fill:#e0e0e0,stroke:#757575,color:#000
    classDef ml fill:#d1c4e9,stroke:#8e24aa,color:#000
```
