#17 [M1] Endpoint Mappa catastale — estratto di mappa per foglio

[Anonymous]

Originally created by: zornade

Contesto

Parte della Roadmap v0.2 [#15] — Milestone 1.

Obiettivo

Esporre via API il recupero dell'estratto di mappa catastale per un foglio (con eventuale particella).

API proposta

POST /mappa
Content-Type: application/json

{
  "provincia": "RM",
  "comune": "ROMA",
  "foglio": "523",
  "particella": "123"   // opzionale
}

Output: immagine raster o WMS link + metadata (scala, sistema di riferimento, data estrazione, foglio).

Lavoro richiesto

• [ ] Identificare il percorso UI sul portale SISTER per "Mappa".
• [ ] Catturare HTML log dei vari step (selezione foglio → render mappa).
• [ ] Decidere strategia di trasporto: link al portale, base64 inline, salvataggio in data/mappe/.
• [ ] Aggiungere run_mappa() in utils.py.
• [ ] Modello Pydantic MappaRequest / MappaResult.
• [ ] Endpoint POST /mappa in main.py.
• [ ] Smoke test su foglio reale.
• [ ] Aggiornare README.

Casi edge

• Foglio inesistente → errore esplicito.
• Foglio con sezione urbana speciale → verificare il flusso.
• Foglio molto grande → eventuale tiling o solo metadati.