{
  "schema_version": "terranava.territorial_file.v0.1",
  "product_id": "santa-cruz-academico:v0.1",
  "territory_id": "bol:adm3:santa-cruz:santa-cruz-de-la-sierra",
  "territory_name": "Santa Cruz de la Sierra",
  "scope": "municipio; el módulo SAGUAPAC corresponde solo al área de prestación declarada por la cooperativa",
  "status": "observed",
  "processed_at": "2026-09-15",
  "public_status": "public_summary",
  "canonical_key": "territory_id",
  "base_profile": {
    "source": "TerraNava ficha territorial Bolivia v1",
    "observed_year": 2024,
    "ivh": 44.5,
    "ivh_level": "MEDIO",
    "population_total_2024": 1610982,
    "water_unimproved_pct_2024": 1,
    "sanitation_unimproved_pct_2024": 31.1913,
    "nbi_poor_pct_2024": 10.4039
  },
  "hydro_context": {
    "source": "TerraNava hidrología municipal v1",
    "hydro_unit_id": "6060626320",
    "hydro_unit_name": "Subcuenca jerárquica Sudamérica · HYBAS 6060626320",
    "climate_class": "Subhúmedo seco",
    "annual_p_mm": 753.0,
    "annual_et0_mm": 1180.0,
    "water_balance_mm": -427.0,
    "hazard_label": "Alta",
    "priority_label": "Muy alta"
  },
  "modules": [
    {
      "module_id": "water_use_by_sector",
      "title": "Consumo de agua por sector",
      "status": "observed",
      "source": "SAGUAPAC Memoria Anual 2025",
      "source_url": "https://www.saguapac.com.bo/wp-content/uploads/2026/07/SAGUAPAC-memoria-2025_comprimido.pdf",
      "observed_from": "2025-01-01",
      "observed_to": "2025-12-31",
      "retrieved_at": "2026-09-15",
      "processed_at": "2026-09-15",
      "license": "documento público institucional; verificar reutilización antes de uso comercial",
      "resolution": "categorías de facturación y área de prestación SAGUAPAC",
      "method": "extracción tabular manual desde memoria anual; totales preservados por categoría",
      "uncertainty": "no representa la totalidad del municipio ni consumo no facturado; diferencia cobertura, consumo medido y demanda modelada",
      "area_service_ha_2025": 55559,
      "water_network_km_2025": 5838,
      "water_connections_2025": 286060,
      "water_coverage_service_area_pct_dec_2025": 94.82,
      "billed_water_m3_2025": 69740231,
      "sectors": [
        {
          "sector": "Domiciliaria",
          "billed_m3": 53390608,
          "share_pct": 76.56
        },
        {
          "sector": "Comercial",
          "billed_m3": 12003574,
          "share_pct": 17.21
        },
        {
          "sector": "Industrial",
          "billed_m3": 854587,
          "share_pct": 1.22
        },
        {
          "sector": "Especial",
          "billed_m3": 3419745,
          "share_pct": 4.9
        },
        {
          "sector": "Social solidaria",
          "billed_m3": 40997,
          "share_pct": 0.06
        },
        {
          "sector": "Seguridad ciudadana",
          "billed_m3": 30720,
          "share_pct": 0.04
        }
      ]
    },
    {
      "module_id": "sandy_soil_texture",
      "title": "Textura arenosa del suelo",
      "status": "unavailable",
      "source": "SoilGrids 250 m",
      "source_url": "https://docs.isric.org/globaldata/soilgrids/",
      "observed_from": null,
      "observed_to": null,
      "retrieved_at": null,
      "processed_at": "2026-09-15",
      "license": "pendiente de manifestar junto al raster preprocesado",
      "resolution": "250 m; debe preprocesarse fuera del navegador",
      "method": "pendiente: recorte municipal, profundidad declarada, agregación y validación QGIS",
      "uncertainty": "SoilGrids es modelo global; requiere control visual y validación local antes de afirmar textura arenosa"
    },
    {
      "module_id": "urban_expansion",
      "title": "Expansión urbana",
      "status": "unavailable",
      "source": "Dynamic World anual 2015-presente; GHSL como contexto",
      "source_url": "https://developers.google.com/earth-engine/datasets/catalog/GOOGLE_DYNAMICWORLD_V1",
      "observed_from": "2015-01-01",
      "observed_to": null,
      "retrieved_at": null,
      "processed_at": "2026-09-15",
      "license": "pendiente de manifiesto de descarga",
      "resolution": "10 m Dynamic World; GHSL solo para contexto histórico",
      "method": "pendiente: serie anual, persistencia temporal, exclusión de falsos positivos por suelo desnudo o arena",
      "uncertainty": "no publicar cambio urbano hasta validar persistencia temporal y revisión QGIS"
    }
  ],
  "downloads": {
    "csv": "/hr-data/products/santa-cruz-academico/santa-cruz-academico.metrics.v0.1.csv",
    "geojson": "/hr-data/products/santa-cruz-academico/santa-cruz-academico.context.v0.1.geojson",
    "geopackage": "/hr-data/products/santa-cruz-academico/santa-cruz-academico.v0.1.gpkg",
    "pdf": "/hr-data/products/santa-cruz-academico/santa-cruz-avance-tecnico.v0.1.pdf"
  }
}
