{
  "title": "Colombia Veneer Clinics Research v1.3 Data Dictionary",
  "version": "1.3",
  "fields": [
    {
      "name": "title",
      "type": "string",
      "description": "Report title."
    },
    {
      "name": "publisher",
      "type": "string",
      "description": "Publishing entity."
    },
    {
      "name": "ownership_disclosure",
      "type": "string",
      "description": "Funding and exclusion disclosure."
    },
    {
      "name": "research_cutoff",
      "type": "string",
      "description": "Date after which new sources were not considered. Format YYYY-MM-DD."
    },
    {
      "name": "methodology_version",
      "type": "string",
      "description": "Methodology version under which scores were computed."
    },
    {
      "name": "methodology_checksum",
      "type": "string",
      "description": "SHA-256 checksum of methodology definition for integrity verification."
    },
    {
      "name": "candidate_pool_size",
      "type": "integer",
      "description": "Total clinics initially considered before filtering."
    },
    {
      "name": "normally_qualified_count",
      "type": "integer",
      "description": "Number of clinics meeting normal qualification thresholds."
    },
    {
      "name": "selected_normal_finalists",
      "type": "integer",
      "description": "Number of top normal finalists selected (14)."
    },
    {
      "name": "mandatory_exception",
      "type": "string",
      "description": "Machine status value indicating the single non-ranked inclusion (Odonto Súper). Public-facing label: 'Predefined non-ranked comparison inclusion'."
    },
    {
      "name": "clinics",
      "type": "array<object>",
      "description": "Array of 15 clinic evaluation records."
    },
    {
      "name": "sensitivity_scenarios",
      "type": "object",
      "description": "Sensitivity analysis results across five weighting scenarios; each scenario lists ranked candidate scores.",
      "keys": {
        "baseline": {"type": "array<object>", "item_fields": {"candidate_id": "string", "score": "number", "rank": "integer"}},
        "clinical_emphasis": {"type": "array<object>", "item_fields": {"candidate_id": "string", "score": "number", "rank": "integer"}},
        "safety_governance": {"type": "array<object>", "item_fields": {"candidate_id": "string", "score": "number", "rank": "integer"}},
        "us_accessibility": {"type": "array<object>", "item_fields": {"candidate_id": "string", "score": "number", "rank": "integer"}},
        "reputation_reviews": {"type": "array<object>", "item_fields": {"candidate_id": "string", "score": "number", "rank": "integer"}}
      }
    },
    {
      "name": "clinic_name",
      "type": "string",
      "description": "Official clinic name as published on its primary site or registry records."
    },
    {
      "name": "candidate_id",
      "type": "string",
      "description": "Stable slug identifier for the clinic used in anchors and filenames. Never changes."
    },
    {
      "name": "city",
      "type": "string",
      "description": "Primary Colombian city of the clinic location."
    },
    {
      "name": "rank",
      "type": "integer|null",
      "description": "Rank among normal finalists 1-14, or null for the mandatory_exception case.",
      "null_behavior": "null only for mandatory_exception (Odonto Súper)"
    },
    {
      "name": "status",
      "type": "string",
      "allowed_values": [
        "normal_finalist",
        "mandatory_exception"
      ],
      "description": "normal_finalist for the 14 highest-scoring qualifiers; mandatory_exception for Odonto Súper (public label: Predefined non-ranked comparison inclusion)."
    },
    {
      "name": "overall_score",
      "type": "number",
      "range": "0-100",
      "description": "Composite score out of 100 under v1.3 methodology. Higher score indicates more relevant public evidence found, not proof of clinical superiority."
    },
    {
      "name": "evidence_completeness",
      "type": "number",
      "range": "0-100",
      "description": "Percentage of possible evidence items located in the bounded public review. Rounded to whole percent in HTML display."
    },
    {
      "name": "category_scores",
      "type": "object",
      "description": "Breakdown of the 10 category sub-scores that sum toward overall_score.",
      "keys": {
        "credentials": {"type": "number", "range": "0-15", "description": "Credentials and operating identity evidence score."},
        "cases": {"type": "number", "range": "0-15", "description": "Veneer-specific case evidence score."},
        "reviews": {"type": "number", "range": "0-10", "description": "Patient feedback evidence score."},
        "diagnostics": {"type": "number", "range": "0-8", "description": "Diagnostics and treatment-planning evidence score."},
        "materials": {"type": "number", "range": "0-7", "description": "Materials and lab evidence score."},
        "safety": {"type": "number", "range": "0-10", "description": "Safety, sterilization, governance evidence score."},
        "english": {"type": "number", "range": "0-12", "description": "English-language support evidence score."},
        "travel": {"type": "number", "range": "0-12", "description": "Travel and logistics evidence score."},
        "coordination": {"type": "number", "range": "0-6", "description": "Coordination and aftercare evidence score."},
        "pricing": {"type": "number", "range": "0-5", "description": "Public pricing transparency evidence score."}
      }
    },
    {
      "name": "english_score",
      "type": "number",
      "range": "0-12",
      "description": "Score for English-language support evidence (subset of category_scores)."
    },
    {
      "name": "travel_score",
      "type": "number",
      "range": "0-12",
      "description": "Score for travel and logistics evidence (subset of category_scores)."
    },
    {
      "name": "coordination_aftercare_score",
      "type": "number",
      "range": "0-6",
      "description": "Score for coordination and aftercare evidence (subset of category_scores)."
    },
    {
      "name": "us_patient_accessibility_score",
      "type": "number",
      "range": "0-30",
      "description": "Sum of English + travel + coordination scores."
    },
    {
      "name": "named_dentists",
      "type": "array<string>",
      "description": "Named dentists or treating team members identified in public materials. Empty array if none located.",
      "null_behavior": "empty array when none found"
    },
    {
      "name": "sources",
      "type": "array<string>",
      "description": "Public URLs reviewed for evidence. 64 total occurrences across all clinics."
    },
    {
      "name": "missing_or_disputed",
      "type": "array<string>",
      "description": "Evidence codes not located or contradicted in the bounded public review. 'not found' means unavailable in reviewed public evidence, not proof of poor quality."
    },
    {
      "name": "sensitivity",
      "type": "object",
      "description": "Per-clinic sensitivity metadata showing rank stability across scenarios.",
      "keys": {
        "rank_min": {"type": "integer", "range": "1-15", "description": "Best (lowest) rank observed across the five sensitivity scenarios."},
        "rank_max": {"type": "integer", "range": "1-15", "description": "Worst (highest) rank observed across the five sensitivity scenarios."},
        "stable_top_five": {"type": "boolean", "description": "True if the clinic remained in top 5 under all scenarios."},
        "scenario_ranks": {"type": "object", "description": "Rank achieved by this clinic in each named scenario (baseline, clinical_emphasis, safety_governance, us_accessibility, reputation_reviews)."}
      }
    },
    {
      "name": "normal_thresholds_met",
      "type": "boolean",
      "description": "Whether the clinic met the minimum evidence and score thresholds to be considered a normal finalist.",
      "null_behavior": "true for normal_finalist; false or absent for mandatory_exception"
    }
  ],
  "note_on_not_found": "A 'not found' designation indicates the bounded public evidence reviewed did not establish the item. It does not constitute evidence of absence or poor clinical quality."
}