#19 [M1] Endpoint Ispezioni ipotecarie — visure ipotecarie da Conservatoria

[Anonymous]

Originally created by: zornade

Contesto

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

Obiettivo

Esporre via API le ispezioni ipotecarie (visure dalla Conservatoria dei Registri Immobiliari) per un soggetto o per un immobile.

API proposta

POST /ipotecaria
Content-Type: application/json

{
  "soggetto": {
    "cf_piva": "RSSMRA85M01H501Z",
    "conservatoria": "ROMA"
  }
}

oppure:

POST /ipotecaria
Content-Type: application/json

{
  "immobile": {
    "provincia": "RM",
    "comune": "ROMA",
    "foglio": "523",
    "particella": "123",
    "subalterno": "4"
  }
}

Output: lista di formalità (note di iscrizione, trascrizione, annotazione) con dati di repertorio.

Lavoro richiesto

• [ ] Verificare diritti d'accesso PROFILO B all'ispezione ipotecaria (potrebbe richiedere convenzione separata).
• [ ] Mappare flusso UI: scelta conservatoria, tipo ricerca (soggetto/immobile), filtri data.
• [ ] HTML log dettagliato di tutti gli step.
• [ ] Aggiungere run_ipotecaria() in utils.py.
• [ ] Modello Pydantic con union di input (soggetto xor immobile).
• [ ] Endpoint POST /ipotecaria in main.py.
• [ ] Smoke test su soggetto reale con formalità note.
• [ ] Aggiornare README.

Casi edge

• Soggetto omonimo → restituire elenco soggetti per disambiguazione.
• Nessuna formalità → lista vuota + flag esplicito.
• Conservatoria non ancora digitalizzata → errore con codice dedicato.

Note sensibili

• Le note ipotecarie sono dati sensibili patrimoniali. Massima cautela su logging, retention, masking.
• Verificare se i bolli/tributi sono dovuti per richieste ripetute.