Riorganizzazione: Nuova struttura orto-suite/ - No more .skill zips, pronto per copia diretta

orto-suite/references/irrigazione_parametri.md

@@ -0,0 +1,230 @@
+# Parametri Irrigazione: ET, Kc, Soglie Sensori
+
+Riferimento tecnico per calcolo fabbisogni idrici e automazione irrigazione.
+
+---
+
+## Evapotraspirazione di Riferimento (ET₀)
+
+### Tabella ET₀ Mensile per Macro-Zone Italia
+
+Basato su dati medi (temperature, umidità, vento, radiazione).
+
+| Mese | Nord (Pianura Padana) | Centro (Toscana, Lazio) | Sud (Puglia, Sicilia) |
+|------|---|---|---|
+| Gen | 0.5 mm/gg | 0.8 mm/gg | 1.2 mm/gg |
+| Feb | 1.0 | 1.3 | 1.6 |
+| Mar | 2.0 | 2.5 | 3.0 |
+| Apr | 3.5 | 4.0 | 4.5 |
+| Mag | 4.5 | 5.0 | 5.5 |
+| **Giu** | **5.5** | **6.0** | **6.5** |
+| **Lug** | **5.8** | **6.2** | **6.8** |
+| **Ago** | **5.5** | **6.0** | **6.5** |
+| Set | 4.0 | 4.5 | 5.0 |
+| Ott | 2.5 | 3.0 | 3.5 |
+| Nov | 1.2 | 1.5 | 2.0 |
+| Dic | 0.6 | 0.9 | 1.2 |
+
+**Peak season:** Giugno-Agosto (ET₀ 5.5-6.8 mm/gg)
+
+**Formula rapida (se dati non disponibili):**
+```
+ET₀ (mm/gg) ≈ 0.0023 × (Tmed°C + 17.8) × (Tmax - Tmin)^0.5
+(Hargreaves formula semplificata)
+```
+
+---
+
+## Coefficiente Colturale (Kc)
+
+Rappresenta la frazione di ET₀ necessaria per la coltura in base a fase di crescita.
+
+### Per Principale Colture
+
+| Coltura | Fase Iniziale | Fase Massima | Fase Raccolta | Note |
+|---------|---|---|---|---|
+| **Pomodoro** | 0.40 (giov.) | 0.95 (fioritura) | 0.70 (raccolta) | Determinato: 70-90 gg; indeterminato: più lungo |
+| **Peperone** | 0.35 | 0.95 | 0.75 | Simile pomodoro |
+| **Zucchina** | 0.45 | 1.05 | 0.80 | Ciclo più veloce |
+| **Melone** | 0.40 | 1.00 | 0.75 | Peak luglio |
+| **Lattuga** | 0.50 | 0.95 | 0.70 | Ciclo breve, sensibile stress |
+| **Cavolo** | 0.45 | 0.90 | 0.65 | Ciclo medio |
+| **Carota** | 0.40 | 0.80 | 0.60 | Resistente siccità relativa |
+| **Basilico** | 0.60 | 0.85 | 0.70 | Termofilo |
+| **Fagiolo** | 0.40 | 0.90 | 0.50 | Ciclo rapido |
+| **Spinacio** | 0.50 | 0.95 | 0.70 | Ciclo breve |
+
+**Interpretazione Kc:**
+- Kc < 0.5: Coltura giovane o pre-fioritura
+- Kc 0.5-0.8: Fase intermedia
+- Kc > 0.9: Peak di consumo (fioritura, fruttificazione)
+
+---
+
+## Calcolo Fabbisogno Idrico Giornaliero
+
+```
+Fabbisogno (mm/gg) = ET₀ × Kc
+
+Esempio (Pomodoro, Centro Italia, Luglio, fioritura):
+  ET₀ (luglio) = 6.2 mm/gg
+  Kc (fioritura) = 0.95
+  Fabbisogno = 6.2 × 0.95 = 5.9 mm/gg
+
+Volume acqua per aiuola 15 m²:
+  5.9 mm × 15 m² = 88.5 litri/gg
+```
+
+---
+
+## Classe Fabbisogno Acqua (Irrigazione Pratica)
+
+### Raggruppamento Semplificato
+
+Per scheduling pratico, raggruppare colture in 3 classi:
+
+| Classe | Fabbisogno (mm/stagione) | Frequenza | Timing | Colture Tipiche |
+|--------|---|---|---|---|
+| **BASSO** | 100-150 mm | 2-3x/sett | Mattina (facoltativo) | Carota, Cipolla, Spinacio, Pisello, Aglio |
+| **MEDIO** | 150-250 mm | 3-4x/sett | Mattina | Lattuga, Cavolo, Broccoli, Fagiolo |
+| **ALTO** | 300-500 mm | 4-6x/sett (daily estate) | Mattina + Sera (heat) | Pomodoro, Peperone, Zucchina, Melone, Cocomero |
+
+---
+
+## Emettitori & Portata
+
+### Metodi Irrigazione
+
+| Metodo | Portata Tipica | Applicazione | Pro | Contro |
+|--------|---|---|---|---|
+| **Goccia (Dripper)** | 0.5-4 L/h per emettitore | Ortaggi | Efficiente, no foglia bagnata | Pulizia necessaria |
+| **Microspruzzatore** | 4-20 L/h | Ortaggi, angoli | Copertura ampia | Foglia bagnata, costo |
+| **Spruzzatore rotante** | 20-100 L/h | Grandi aree | Veloce, buon mixing | Alto fabbisogno, evaporazione |
+| **Sommersione** | Variable | Colture acquatiche | Equilibrio naturale | Scarsa precisione |
+
+### Calcolo Runtime
+
+```
+Runtime (minuti) = Fabbisogno (mm) / Portata emettitore (mm/h)
+
+Esempio (Pomodoro ZONA ALTA, classe ALTO):
+  Fabbisogno giornaliero: 5.9 mm
+  Emettitori dripper 2 L/h spaziati 0.5 m = ~4 mm/h per metro
+  Runtime = 5.9 mm / 4 mm/h ≈ 1.5 h = 90 minuti
+  
+  Splitting (estate caldo): 2x giornaliero = 45 min mattina + 45 min sera
+```
+
+---
+
+## Sensori Umidità Suolo (Soil Moisture)
+
+### Tecnologia Capacitiva (Consigliato)
+
+**Tipo:** Sensore capacitivo VWC (Volumetric Water Content)
+
+**Principio:** Variazione capacità elettrica con umidità
+
+**Range:** 0-100% (0% secco, 100% saturo)
+
+### Soglie per Zone Irrigue
+
+Definire trigger auto-irrigazione:
+
+| Zona | Colture | Min Umidità (Trigger) | Max Umidità (No Irrig) | Note |
+|------|---------|---|---|---|
+| **BASSA** | Carota, Cipolla, Spinacio | 30-35% VWC | 50-55% VWC | Tollerante siccità |
+| **MEDIA** | Lattuga, Cavolo, Fagiolo | 40-45% VWC | 60-65% VWC | Equilibrio |
+| **ALTA** | Pomodoro, Peperone, Zucchina | 50-60% VWC | 70-75% VWC | Sensibile stress |
+
+**Profondità sensore:** 20-30 cm (zona radici principale)
+
+**Placement:** 1 sensore per 5-10 m² (center di zona omogenea)
+
+---
+
+## Schedule Baseline (No Sensore, Metodo Stagionale)
+
+### Nord Italia - Pomodoro (Giugno-Agosto)
+
+```
+Giugno (Kc 0.70):
+  - ET₀ ≈ 5.5 mm/gg
+  - Fabbisogno ≈ 3.9 mm/gg
+  - Schedule: 3x/sett, 60 min ciascuna (mattina)
+
+Luglio-Agosto (Kc 0.95, peak caldo):
+  - ET₀ ≈ 5.8-6.2 mm/gg
+  - Fabbisogno ≈ 5.5-5.9 mm/gg
+  - Schedule: Daily split = 45 min mattina (6am) + 45 min sera (6pm)
+  - Reason: Evaporazione peak noon; protezione stress pomeridiano
+```
+
+### Centro Italia - Lattuga (Primavera)
+
+```
+Aprile (Kc 0.50-0.70):
+  - ET₀ ≈ 4.0 mm/gg
+  - Fabbisogno ≈ 2.0-2.8 mm/gg
+  - Schedule: 3x/sett, 30 min (mattina)
+
+Maggio (Kc 0.95):
+  - ET₀ ≈ 5.0 mm/gg
+  - Fabbisogno ≈ 4.75 mm/gg
+  - Schedule: 4-5x/sett, 45 min (mattina)
+```
+
+---
+
+## Meteo Override
+
+**Pioggia prevista > 10 mm in 24h:** Skip irrigazione giorno successivo
+
+**Fonte:** wttr.in, open-meteo
+
+**Calcolo:** 
+```
+Effective_rainfall = Precip_forecast × 0.85 (infiltrazione suolo)
+IF Effective_rainfall >= 70% Zone_demand → SKIP
+ELIF Effective_rainfall >= 30% → REDUCE 30-50%
+ELSE → KEEP baseline
+```
+
+---
+
+## Maintenance & Pulizia Emettitori
+
+**Frequenza:** Mensile (goccia), settimanale se acqua dura
+
+**Segni ostruzione:**
+- Portata ridotta (compare bagnato non uniforme)
+- Emettitore non bagna
+
+**Pulizia:**
+- Ispezionare filtro linea principale (250 mesh)
+- Soffiare emettitori ostruiti o risciacquare con acqua distillata
+- Replace se danno permanente
+
+**Prevenzione:**
+- Filtro 250 mesh all'entrata di ciascuna zona
+- Acidificazione acqua se pH > 7.5 (dura)
+
+---
+
+## Tabella Veloce Scheduling (Pratica)
+
+Senza calcoli (uso diretto):
+
+| Stagione | Zona BASSA | Zona MEDIA | Zona ALTA |
+|----------|---|---|---|
+| **Primavera (Apr-Mag)** | 2x/sett, 20min | 3x/sett, 40min | 4x/sett, 60min |
+| **Estate (Giu-Ago)** | 3x/sett, 25min | 4x/sett, 50min | Daily split 45+45min |
+| **Autunno (Set-Ott)** | 2x/sett, 20min | 2x/sett, 35min | 3x/sett, 50min |
+| **Inverno (Nov-Feb)** | PRN (se secco > 2sett) | PRN | PRN |
+
+**PRN = Pro Re Nata** = se necessario (controllo manuale o sensore)
+
+---
+
+**Ultima revisione:** 2026-03-06  
+**Fonte:** FAO Irrigation & Drainage Paper 56 (ET₀), aggiustamenti locali