{
  "study_id": "AM-RP-002",
  "metric_id": "recorded-visit-completion",
  "version": "0.1.0",
  "author": "Anant Mishra",
  "prepared_date": "2026-10-29",
  "status": "synthetic_metric_preparation_only",
  "unit": "one planned visit with a stable ID",
  "denominator": "Number of unique visit IDs in the fixed plan; independent of uploaded event count.",
  "numerator": "Planned visits whose highest accepted revision received by the cutoff has status completed.",
  "receipt_rule": "Only reports received at or before as_of are visible. Event time must be within the fixed service window and no later than receipt. Window end is exclusive.",
  "revision_rule": "A revision is an upstream-accepted version. Authentication and physical collection verification are not implemented. Identical retransmissions retain the same event ID; conflicting IDs or revisions are rejected.",
  "unknown_rule": "No visible accepted report means unreported, not a confirmed missed collection.",
  "empty_plan_rule": "No completion fraction (JSON null).",
  "invariant": "completed + exception + unreported = planned_visits",
  "fixture_file": "synthetic-fixture.json",
  "expected_snapshots": [
    {
      "as_of": "2026-01-15T12:00:00Z",
      "planned_visits": 8,
      "completed": 3,
      "exception": 1,
      "unreported": 4,
      "recorded_completion_fraction": 0.375
    },
    {
      "as_of": "2026-01-15T15:00:00Z",
      "planned_visits": 8,
      "completed": 3,
      "exception": 2,
      "unreported": 3,
      "recorded_completion_fraction": 0.375
    }
  ],
  "excluded": [
    "Population/household coverage",
    "Official SDG 11.6.1 calculation",
    "Live plan changes or cancellations",
    "GPS or physical-service verification",
    "Production ingestion/authentication",
    "Vehicle/facility capacity",
    "Material mass balance",
    "Predictive policy comparison"
  ],
  "sources": [
    "https://unstats.un.org/sdgs/metadata/files/Metadata-11-06-01.pdf",
    "https://docs.ogc.org/is/18-088/18-088.html"
  ]
}