prompt.txt

Sviluppare e mantenere una web app professionale in Python e Streamlit per il predimensionamento del sistema di smaltimento dell’acqua di piattaforma stradale di un ponte.

OBIETTIVO GENERALE
La versione 1.2 deve concentrarsi sul **realismo idraulico del profilo longitudinale**. L’app deve aiutare il progettista a capire quante bocchette di scolo inserire e dove collocarle lungo il ponte, partendo da un profilo longitudinale segmentato realistico e non solo da schemi semplificati.

STANDARD DELLA SUITE
- Tutta la logica di calcolo in `src.py`.
- `app.py` contiene solo UI Streamlit, orchestrazione dei risultati e grafici.
- Tutti i grafici devono essere realizzati esclusivamente con Plotly.
- L’interfaccia deve essere interamente in italiano.
- La struttura file deve essere sempre:
  - app.py
  - src.py
  - requirements.txt
  - readme.md
  - prompt.txt

OBIETTIVO FUNZIONALE DELL’APP
Consentire il predimensionamento del drenaggio di impalcato con:
- stima della portata di progetto;
- costruzione automatica dei bacini idraulici a partire dal profilo longitudinale segmentato;
- stima del numero di bocchette;
- proposta di chainage / layout;
- rispetto di vincoli geometrici e zone vietate;
- output numerici, grafici ed esportabili.

REQUISITI FUNZIONALI MINIMI
1. Input geometrici:
   - lunghezza del ponte;
   - numero corsie;
   - larghezza corsia;
   - larghezze laterali / banchine / marciapiedi;
   - schema di drenaggio (un lato / due lati).

2. Input idrologici e idraulici:
   - intensità di pioggia;
   - coefficiente di deflusso;
   - pendenza trasversale;
   - spread ammissibile manuale oppure preset;
   - velocità di progetto;
   - rugosità di Manning.

3. Profilo longitudinale segmentato:
   - righe con `x_inizio, x_fine, pendenza_pct`;
   - controllo di continuità del profilo;
   - identificazione di minimi locali, massimi locali e nodi passanti.

4. Input relativi alle bocchette:
   - preset bocchetta;
   - capacità nominale per bocchetta;
   - coefficiente di intasamento;
   - coefficiente di sicurezza sulla portata.

5. Vincoli di layout:
   - offset minimo dalle spalle;
   - passo minimo;
   - passo massimo costruttivo;
   - punti vietati;
   - ampiezza della zona di esclusione attorno a ciascun punto vietato.

6. Output richiesti:
   - numero totale di bocchette;
   - portata totale ponte;
   - capacità effettiva della bocchetta;
   - tabella dei segmenti del profilo;
   - tabella dei nodi topologici;
   - tabella dei bacini idraulici;
   - tabella delle bocchette con chainage;
   - grafico Plotly del profilo longitudinale ricostruito;
   - grafico Plotly del layout longitudinale;
   - grafici Plotly di confronto per lato e per bacino;
   - export CSV.

REQUISITI DI CODICE
- usare dataclass per gli input;
- separare chiaramente validazione, parsing del profilo, topologia dei nodi, costruzione dei bacini, runoff, capacità, spread, layout, tabelle e commenti;
- usare funzioni piccole, leggibili e testabili;
- non scrivere formule direttamente in `app.py`;
- scrivere codice professionale, commentato con criterio e facilmente estendibile.

REQUISITI UI/UX
- layout wide;
- sidebar per input;
- risultati principali tabellati, senza metriche/KPI;
- tab dedicate: `Sintesi`, `Layout bocchette`, `Grafici Plotly`, `Note progettuali`;
- linguaggio tecnico-professionale in italiano.

NOTE METODOLOGICHE
- L’app deve essere presentata come strumento di **predimensionamento** e **layout preliminare**.
- Il criterio spread preset deve essere descritto come **preset interno ispirato alla manualistica** e non come verifica normativa definitiva.
- Il profilo segmentato deve guidare davvero la costruzione dei bacini idraulici.
- Il layout deve evitare punti vietati, rispettare offset e passo minimo, e riflettere il recapito del singolo bacino.

QUALITÀ ATTESA
La qualità attesa è di livello professionale. La v1.2 deve essere una base seria per successive evoluzioni come:
- quote assolute e profilo altimetrico completo;
- criteri normativi di spread differenziati;
- dettagli di recapito, discendenti e tubazioni;
- integrazione con dettagli strutturali reali;
- report PDF.