lovarch-cli 0.2.1__py3-none-any.whl

lovarch_cli/squad/data/prezzario-lombardia-sample.json

@@ -0,0 +1,312 @@
+{
+  "meta": {
+    "source": "Prezzario Regione Lombardia 2025 (sample subset)",
+    "valid_until": "2026-06-30",
+    "currency": "EUR",
+    "iva_default": 0.10,
+    "url_official": "https://prezzario.regione.lombardia.it/",
+    "version": "LOM252",
+    "note": "Subset di ~50 voci principali per ristrutturazione residenziale. In produzione: parsing completo PDF/XLS ufficiale."
+  },
+  "voci": [
+    {
+      "codice": "1.A.01.01.001",
+      "categoria": "Demolizioni",
+      "descrizione": "Demolizione di pareti divisorie in laterizio forato spessore 8-12 cm",
+      "unita": "m²",
+      "prezzo": 18.50,
+      "note": "Inclusa cernita rifiuti, escluso trasporto in discarica"
+    },
+    {
+      "codice": "1.A.01.01.002",
+      "categoria": "Demolizioni",
+      "descrizione": "Rimozione pavimentazione in piastrelle ceramica/gres fino a 50 m²",
+      "unita": "m²",
+      "prezzo": 12.30,
+      "note": "Esclusa rimozione massetto"
+    },
+    {
+      "codice": "1.A.01.02.001",
+      "categoria": "Demolizioni",
+      "descrizione": "Trasporto a discarica autorizzata di rifiuti inerti edilizi",
+      "unita": "m³",
+      "prezzo": 24.00,
+      "note": "Escluso costo conferimento (FIR), CAM 2025: tracciabilità obbligatoria"
+    },
+    {
+      "codice": "2.A.01.01.001",
+      "categoria": "Murature",
+      "descrizione": "Tramezza in laterizio forato cm 8, malta cementizia",
+      "unita": "m²",
+      "prezzo": 38.50,
+      "note": "Conforme CAM 2025, riciclato ≥30%"
+    },
+    {
+      "codice": "2.A.01.01.002",
+      "categoria": "Murature",
+      "descrizione": "Tramezza in laterizio forato cm 12 (divisori bagno)",
+      "unita": "m²",
+      "prezzo": 45.20,
+      "note": "Insonorizzazione migliorata, conforme CAM 2025"
+    },
+    {
+      "codice": "2.A.02.01.001",
+      "categoria": "Intonaci",
+      "descrizione": "Intonaco a calce naturale, sp. 1.5 cm su tramezze interne",
+      "unita": "m²",
+      "prezzo": 22.50,
+      "note": "Calce idraulica naturale, no chimici"
+    },
+    {
+      "codice": "3.A.01.01.001",
+      "categoria": "Pavimenti",
+      "descrizione": "Massetto cementizio per riscaldamento a pavimento, sp. 8 cm",
+      "unita": "m²",
+      "prezzo": 28.00,
+      "note": "Incluso additivo, escluso panello radiante"
+    },
+    {
+      "codice": "3.A.02.01.001",
+      "categoria": "Pavimenti",
+      "descrizione": "Parquet rovere prefinito spazzolato sp. 14/3.5 mm",
+      "unita": "m²",
+      "prezzo": 95.00,
+      "note": "Posa flottante, esclusa preparazione sottofondo"
+    },
+    {
+      "codice": "3.A.02.01.002",
+      "categoria": "Pavimenti",
+      "descrizione": "Parquet rovere massello sp. 22 mm",
+      "unita": "m²",
+      "prezzo": 145.00,
+      "note": "Posa incollata, finitura olio"
+    },
+    {
+      "codice": "3.A.03.01.001",
+      "categoria": "Pavimenti",
+      "descrizione": "Gres porcellanato rettificato 60×120 effetto travertino",
+      "unita": "m²",
+      "prezzo": 78.00,
+      "note": "Posa rettificata fuga 2 mm, materiale di fascia media"
+    },
+    {
+      "codice": "3.A.03.01.002",
+      "categoria": "Pavimenti",
+      "descrizione": "Gres porcellanato 60×60 standard",
+      "unita": "m²",
+      "prezzo": 42.00,
+      "note": "Posa standard fuga 4 mm"
+    },
+    {
+      "codice": "4.A.01.01.001",
+      "categoria": "Rivestimenti bagno",
+      "descrizione": "Rivestimento bagno gres rettificato 60×120 effetto travertino",
+      "unita": "m²",
+      "prezzo": 88.00,
+      "note": "Inclusa fuga epossidica colore"
+    },
+    {
+      "codice": "4.A.02.01.001",
+      "categoria": "Rivestimenti cucina",
+      "descrizione": "Rivestimento cucina gres 30×60",
+      "unita": "m²",
+      "prezzo": 52.00,
+      "note": "Posa standard"
+    },
+    {
+      "codice": "5.A.01.01.001",
+      "categoria": "Impianto elettrico",
+      "descrizione": "Punto luce comando interrotto cavo LSZH",
+      "unita": "cad",
+      "prezzo": 38.00,
+      "note": "Cavo in tubo flessibile o passacavo, scatola 503"
+    },
+    {
+      "codice": "5.A.01.01.002",
+      "categoria": "Impianto elettrico",
+      "descrizione": "Presa shuko 16A + USB-C",
+      "unita": "cad",
+      "prezzo": 52.00,
+      "note": "Marca civile media"
+    },
+    {
+      "codice": "5.A.02.01.001",
+      "categoria": "Impianto elettrico",
+      "descrizione": "Quadro generale appartamento 24 moduli",
+      "unita": "cad",
+      "prezzo": 480.00,
+      "note": "Inclusi differenziali e magnetotermici"
+    },
+    {
+      "codice": "5.A.03.01.001",
+      "categoria": "Domotica",
+      "descrizione": "Sistema domotica leggera 1 zona (KNX o equivalente)",
+      "unita": "zona",
+      "prezzo": 850.00,
+      "note": "Per stanza/area, escluso server centrale"
+    },
+    {
+      "codice": "5.A.03.01.002",
+      "categoria": "Domotica",
+      "descrizione": "Server centrale domotica + tablet di controllo",
+      "unita": "cad",
+      "prezzo": 1850.00,
+      "note": "Una tantum, configurazione inclusa"
+    },
+    {
+      "codice": "6.A.01.01.001",
+      "categoria": "Impianto idraulico",
+      "descrizione": "Punto acqua calda+fredda + scarico WC",
+      "unita": "cad",
+      "prezzo": 145.00,
+      "note": "Incluso PEX, esclusa rubinetteria finita"
+    },
+    {
+      "codice": "6.A.01.01.002",
+      "categoria": "Impianto idraulico",
+      "descrizione": "Punto acqua bagno (lavabo/doccia/vasca)",
+      "unita": "cad",
+      "prezzo": 165.00,
+      "note": "Incluso scarico, esclusa rubinetteria"
+    },
+    {
+      "codice": "6.A.02.01.001",
+      "categoria": "Impianto idraulico",
+      "descrizione": "Sanitario sospeso WC con cassetta incasso",
+      "unita": "cad",
+      "prezzo": 285.00,
+      "note": "Marca media (Ideal Standard, Roca, equivalenti)"
+    },
+    {
+      "codice": "7.A.01.01.001",
+      "categoria": "Riscaldamento",
+      "descrizione": "Pannello radiante a pavimento PEX-A passo 10 cm",
+      "unita": "m²",
+      "prezzo": 68.00,
+      "note": "Incluso isolante e collettore di zona"
+    },
+    {
+      "codice": "7.A.01.01.002",
+      "categoria": "Riscaldamento",
+      "descrizione": "Collettore zona riscaldamento (4-6 zone)",
+      "unita": "cad",
+      "prezzo": 280.00,
+      "note": "Termoregolazione singola zona"
+    },
+    {
+      "codice": "7.A.02.01.001",
+      "categoria": "VMC",
+      "descrizione": "Sistema VMC centralizzato con recupero ≥75%",
+      "unita": "appartamento",
+      "prezzo": 4800.00,
+      "note": "120 m², filtri F7+ePM1, classe A+"
+    },
+    {
+      "codice": "8.A.01.01.001",
+      "categoria": "Serramenti interni",
+      "descrizione": "Porta interna in legno tamburato + telaio",
+      "unita": "cad",
+      "prezzo": 380.00,
+      "note": "Standard, finitura laccato bianco"
+    },
+    {
+      "codice": "8.A.01.01.002",
+      "categoria": "Serramenti interni",
+      "descrizione": "Porta scorrevole interna a scomparsa con cassonetto",
+      "unita": "cad",
+      "prezzo": 920.00,
+      "note": "Acustica, ideale studio"
+    },
+    {
+      "codice": "9.A.01.01.001",
+      "categoria": "Falegnameria su misura",
+      "descrizione": "Cucina su misura cm 360×60 con isola, ante laccate",
+      "unita": "modulo",
+      "prezzo": 14500.00,
+      "note": "Top in pietra naturale escluso"
+    },
+    {
+      "codice": "9.A.01.01.002",
+      "categoria": "Falegnameria su misura",
+      "descrizione": "Top cucina in granito sp. 3 cm con bordo dritto",
+      "unita": "m²",
+      "prezzo": 380.00,
+      "note": "Materiale di fascia media"
+    },
+    {
+      "codice": "9.A.02.01.001",
+      "categoria": "Falegnameria su misura",
+      "descrizione": "Cabina armadio su misura camera padronale",
+      "unita": "m²",
+      "prezzo": 850.00,
+      "note": "Pareti modulari, ante battenti, organizzazione interna"
+    },
+    {
+      "codice": "9.A.03.01.001",
+      "categoria": "Falegnameria su misura",
+      "descrizione": "Libreria a parete su misura sp. 35 cm",
+      "unita": "m²",
+      "prezzo": 720.00,
+      "note": "Rovere massello, montanti verticali fissi"
+    },
+    {
+      "codice": "10.A.01.01.001",
+      "categoria": "Tinteggiature",
+      "descrizione": "Tinteggiatura a calce naturale ambienti interni",
+      "unita": "m²",
+      "prezzo": 12.50,
+      "note": "Due mani, calce naturale, no chimici"
+    },
+    {
+      "codice": "10.A.01.01.002",
+      "categoria": "Tinteggiatura",
+      "descrizione": "Pittura lavabile classe E1 anti-formaldeide",
+      "unita": "m²",
+      "prezzo": 9.80,
+      "note": "Camera Sofia (richiesta esplicita)"
+    },
+    {
+      "codice": "11.A.01.01.001",
+      "categoria": "Restauro decori",
+      "descrizione": "Restauro decoro soffitto, pulizia + integrazione",
+      "unita": "m²",
+      "prezzo": 240.00,
+      "note": "Restauro conservativo, materiali tradizionali"
+    },
+    {
+      "codice": "11.A.02.01.001",
+      "categoria": "Restauro pavimenti",
+      "descrizione": "Restauro seminato veneziano esistente",
+      "unita": "m²",
+      "prezzo": 320.00,
+      "note": "Lucidatura, integrazione fessurazioni minori"
+    },
+    {
+      "codice": "12.A.01.01.001",
+      "categoria": "Pulizia finale",
+      "descrizione": "Pulizia post-cantiere completo appartamento",
+      "unita": "m²",
+      "prezzo": 8.50,
+      "note": "Inclusa rimozione protezioni e residui"
+    }
+  ],
+  "categorie_riepilogative": [
+    "Demolizioni",
+    "Murature",
+    "Intonaci",
+    "Pavimenti",
+    "Rivestimenti bagno",
+    "Rivestimenti cucina",
+    "Impianto elettrico",
+    "Domotica",
+    "Impianto idraulico",
+    "Riscaldamento",
+    "VMC",
+    "Serramenti interni",
+    "Falegnameria su misura",
+    "Tinteggiature",
+    "Restauro decori",
+    "Restauro pavimenti",
+    "Pulizia finale"
+  ]
+}

lovarch_cli/squad/scripts/api_clients.py

@@ -0,0 +1,206 @@
+"""
+API Clients for squad architettura-progetto.
+
+Centralizes all external API calls used by the agents.
+Reads secrets from ~/.lovarch/secrets.env (NOT committed to git).
+
+Usage:
+    from squads.architettura_progetto.scripts.api_clients import (
+        mapbox_geocode,
+        catasto_visura,
+        firma_qes_create_envelope,
+    )
+
+    result = mapbox_geocode("Via Fiori Chiari 17, Milano")
+    print(result["lat"], result["lon"], result["comune"])
+"""
+import json
+import os
+from pathlib import Path
+from typing import Any, Dict, Optional
+from urllib.parse import quote
+
+import urllib.request
+import urllib.error
+
+
+SECRETS_FILE = Path.home() / ".lovarch" / "secrets.env"
+MOCKS_DIR = Path(__file__).parent.parent / "data" / "mocks"
+
+
+def _load_secrets() -> Dict[str, str]:
+    """Read ~/.lovarch/secrets.env (KEY=VALUE format)."""
+    secrets: Dict[str, str] = {}
+    if not SECRETS_FILE.exists():
+        return secrets
+    for line in SECRETS_FILE.read_text(encoding="utf-8").splitlines():
+        line = line.strip()
+        if not line or line.startswith("#"):
+            continue
+        if "=" in line:
+            k, v = line.split("=", 1)
+            secrets[k.strip()] = v.strip()
+    return secrets
+
+
+_SECRETS = _load_secrets()
+
+
+# ----------------------------------------------------------------------------
+# Mapbox Geocoding · REAL API (P1 critico)
+# ----------------------------------------------------------------------------
+
+def mapbox_geocode(
+    address: str,
+    *,
+    country: str = "IT",
+    limit: int = 1,
+) -> Optional[Dict[str, Any]]:
+    """
+    Geocoda un indirizzo italiano via Mapbox Geocoding API.
+
+    Returns:
+        dict con keys: lat, lon, place_name, comune, postcode, region.
+        None se nessun risultato.
+
+    Raises:
+        ValueError: se MAPBOX_TOKEN non è configurato.
+        urllib.error.HTTPError: se la API ritorna errore.
+    """
+    token = _SECRETS.get("MAPBOX_TOKEN") or os.environ.get("MAPBOX_TOKEN")
+    if not token:
+        raise ValueError(
+            "MAPBOX_TOKEN missing. Add to ~/.lovarch/secrets.env or env."
+        )
+
+    url = (
+        f"https://api.mapbox.com/geocoding/v5/mapbox.places/{quote(address)}.json"
+        f"?access_token={token}&country={country}&limit={limit}"
+    )
+
+    with urllib.request.urlopen(url, timeout=10) as resp:
+        data = json.load(resp)
+
+    features = data.get("features", [])
+    if not features:
+        return None
+
+    f = features[0]
+    coords = f.get("center", [None, None])
+
+    # Extract context fields (postcode, place=comune, region)
+    ctx = {item.get("id", "").split(".")[0]: item for item in f.get("context", [])}
+
+    return {
+        "lat": coords[1],
+        "lon": coords[0],
+        "place_name": f.get("place_name"),
+        "comune": ctx.get("place", {}).get("text"),
+        "postcode": ctx.get("postcode", {}).get("text"),
+        "region": ctx.get("region", {}).get("text"),
+        "country": ctx.get("country", {}).get("text"),
+        "raw": f,  # full Mapbox feature for advanced use
+    }
+
+
+# ----------------------------------------------------------------------------
+# Catasto · MOCK (OpenAPI.com substitute)
+# ----------------------------------------------------------------------------
+
+def catasto_visura(
+    address: str,
+    comune: str,
+    *,
+    foglio: Optional[str] = None,
+    mappale: Optional[str] = None,
+) -> Dict[str, Any]:
+    """
+    Restituisce una visura catastale.
+
+    Implementazione MOCK · per il demo. In produzione: OpenAPI.com Catasto.
+    Carica `data/mocks/catasto-visura.json` e sostituisce i campi address/comune
+    con i parametri ricevuti per dare l'aspetto di una risposta personalizzata.
+    """
+    mock_path = MOCKS_DIR / "catasto-visura.json"
+    visura = json.loads(mock_path.read_text(encoding="utf-8"))
+
+    visura["request"]["indirizzo"] = address
+    visura["request"]["comune"] = comune
+    if foglio:
+        visura["dati_catastali"]["foglio"] = foglio
+    if mappale:
+        visura["dati_catastali"]["mappale"] = mappale
+
+    visura["meta"]["mock"] = True
+    return visura
+
+
+# ----------------------------------------------------------------------------
+# Firma Digitale QES · MOCK (Yousign / OpenAPI.com firma substitute)
+# ----------------------------------------------------------------------------
+
+def firma_qes_create_envelope(
+    *,
+    document_path: str,
+    signer_name: str,
+    signer_email: str,
+    signer_cf: str,
+    document_title: str = "Documento da firmare",
+) -> Dict[str, Any]:
+    """
+    Crea un envelope di firma digitale qualificata (eIDAS).
+
+    Implementazione MOCK · per il demo. In produzione: Yousign API o OpenAPI.com firma.
+    Restituisce un URL di firma simulato che il cliente cliccherebbe.
+    """
+    mock_path = MOCKS_DIR / "firma-envelope.json"
+    envelope = json.loads(mock_path.read_text(encoding="utf-8"))
+
+    envelope["envelope"]["document_path"] = document_path
+    envelope["envelope"]["document_title"] = document_title
+    envelope["envelope"]["signer"]["name"] = signer_name
+    envelope["envelope"]["signer"]["email"] = signer_email
+    envelope["envelope"]["signer"]["codice_fiscale"] = signer_cf
+    envelope["meta"]["mock"] = True
+    return envelope
+
+
+# ----------------------------------------------------------------------------
+# CLI test
+# ----------------------------------------------------------------------------
+
+if __name__ == "__main__":
+    import sys
+
+    if len(sys.argv) < 2:
+        print("Usage: python api_clients.py <command> [args]")
+        print("Commands:")
+        print("  geocode <address>          — Mapbox real API")
+        print("  catasto <address> <comune> — Catasto mock")
+        print("  firma <doc_path> <name> <email> <cf>  — Firma QES mock")
+        sys.exit(1)
+
+    cmd = sys.argv[1]
+
+    if cmd == "geocode":
+        addr = " ".join(sys.argv[2:])
+        result = mapbox_geocode(addr)
+        print(json.dumps(result, indent=2, ensure_ascii=False))
+
+    elif cmd == "catasto":
+        addr = sys.argv[2]
+        comune = sys.argv[3]
+        result = catasto_visura(addr, comune)
+        print(json.dumps(result, indent=2, ensure_ascii=False))
+
+    elif cmd == "firma":
+        doc, name, email, cf = sys.argv[2:6]
+        result = firma_qes_create_envelope(
+            document_path=doc, signer_name=name,
+            signer_email=email, signer_cf=cf,
+        )
+        print(json.dumps(result, indent=2, ensure_ascii=False))
+
+    else:
+        print(f"Unknown command: {cmd}")
+        sys.exit(1)