# Dashboard Produzione Olio d'Oliva

Questa dashboard interattiva permette di simulare e analizzare la produzione di olio d'oliva basandosi su diversi parametri ambientali e varietali.

## Requisiti di Sistema

- Python 3.8 o superiore
- Git LFS (per i file di grandi dimensioni)
- Conda (consigliato) o pip

## Configurazione dell'Ambiente

### Utilizzando Conda (Consigliato)

1. Clona il repository:
2. Crea e attiva l'ambiente conda:
   ```bash
   conda env create -f src/environment.yml
   conda activate olive-dashboard
   ```

### Utilizzando pip

1. Clona il repository:
2. Crea e attiva un ambiente virtuale:
   ```bash
   python -m venv venv
   source venv/bin/activate  # Linux/MacOS
   # oppure
   .\venv\Scripts\activate  # Windows
   ```

3. Installa le dipendenze:
   ```bash
   pip install -r src/requirements.txt
   ```
   
## Esecuzione della Dashboard

1. Assicurati di essere nella directory `src`:
   ```bash
   cd src
   ```

2. Avvia la dashboard:
   ```bash
   python olive-oil-dashboard.py [options]
   ```

#### Opzioni disponibili:

- port PORT: Specifica la porta su cui avviare il server (default: 8888)
- debug : Attiva la modalità debug con auto-reload (default: False)

#### Esempio:
   ```bash
   python olive-oil-dashboard.py --port 8888 --debug
   ```

3. Apri un browser e vai all'indirizzo:
   ```
   http://localhost:8888
   ```

## Struttura del Progetto

```
src/
├── dashboard/               # Componenti della dashboard
├── sources/                # Dati e modelli
├── utils/                  # Utility functions
├── olive-oil-dashboard.py  # Main application
├── olive_config.json       # Configuration file
└── requirements.txt        # Python dependencies
```

## Funzionalità Principali

La dashboard offre diverse funzionalità:

1. **Configurazione Oliveto**
    - Gestione delle varietà di olive
    - Configurazione delle tecniche di coltivazione
    - Impostazione delle percentuali di mix varietale

2. **Simulazione Ambientale**
    - Simulazione degli effetti delle condizioni meteorologiche
    - Analisi dell'impatto sulla produzione
    - Visualizzazione KPI

3. **Analisi Economica**
    - Gestione dei costi di produzione
    - Analisi dei margini
    - Proiezioni finanziarie

4. **Produzione**
    - Monitoraggio della produzione
    - Analisi del fabbisogno idrico
    - Dettagli per varietà

## Risoluzione Problemi Comuni

### ModuleNotFoundError

Se riscontri errori del tipo "ModuleNotFoundError", verifica di:

1. Aver attivato l'ambiente virtuale corretto
2. Aver installato tutte le dipendenze:
   ```bash
   pip install -r requirements.txt  # se usi pip
   # oppure
   conda env update -f environment.yml  # se usi conda
   ```

### Errori di Importazione dei Modelli

Se riscontri errori nell'importazione dei modelli:

1. Verifica che `DEV_MODE=True` nel file `.env`
2. Controlla che tutti i file necessari siano presenti nella directory `sources/`

## Supporto

Per problemi o domande, aprire una issue nel repository del progetto.