{
  "status": "Blank research instruments. No participant results.",
  "common": {
    "study_id": "Assigned study identity, not a person.",
    "site_id": "Pseudonymous site code.",
    "participant_code": "Random study code; identifying key stored separately by future study owner.",
    "date": "ISO8601 local calendar date; declare timezone.",
    "times": "ISO8601 timestamp with timezone, or empty when unknown/not applicable.",
    "boolean": "true, false, or unknown; empty is not success.",
    "currency": "ISO4217 currency code, consistent within each comparison.",
    "cost_status": "incurred, quoted, assumed, unallocated, or unknown; only incurred contributes to actual cash totals.",
    "outcome_status": "observed_complete, observed_incomplete, missing, withdrawn, or no_planned_travel; retain reason.",
    "plan_version": "Version fixed before travel; subsequent revisions retained with timestamp/reason.",
    "status": "not_requested, requested, declined, accepted, started, completed, cancelled, abandoned, or missing; retain state history.",
    "comparison_option": "conventional, coordinated_pickup, passenger_hub, or site-defined frozen alternative.",
    "purpose_category": "commute, business, courtesy, personal, or mixed_needs_review.",
    "counts": "Nonnegative integers; cohort/time and missingness must match before computing conversion.",
    "distances": "Kilometres with occupied and empty boundaries defined.",
    "staff_minutes": "Observed minutes; record paid cost separately, without double-counting.",
    "practical_requirements_code": "Agreed functional requirement code, not a medical diagnosis.",
    "small_cells": "Future study owner defines disclosure threshold before reporting.",
    "consent_version": "Version of reviewed participant information/consent actually agreed; no value supplied in blank instruments.",
    "plan_fixed_at": "Timestamp at which original plan version 0 was frozen before travel.",
    "primary_exclusion_code": "Only NO_PLANNED_TRAVEL_FIXED_BEFORE_DAY or CONSENT_WITHDRAWN_BEFORE_OUTCOME_COLLECTION; blank is not an exclusion.",
    "outcome_source_code": "Predeclared source hierarchy; retain discrepancies and access limits.",
    "coder_code": "Appointed outcome coder; do not enter a hypothetical person.",
    "coder_blind_to_arm": "true, false or unknown; document any unblinding.",
    "tenure_control_code": "owner_occupier, multi_tenant or other/unknown with title/control/funder/beneficiary record.",
    "rider_effort_minutes": "Participant-reported booking/coordination effort from accessible instrument; distinguish missing from zero.",
    "fallback_equivalence_code": "Assessed against frozen dimensions; accepted does not imply equivalent."
  },
  "completion_rule": "Completion requires all precommitted time, door/destination and practical requirements; fallback acceptance alone is not completion. For primary M01/M02, use original plan_version 0 and count each study/site/person_day_id once. Report later versions separately, with reason; do not add revision rows to the denominator or choose a favorable version after seeing results. A changed plan is not automatically service-caused failure.",
  "primary_keys": {
    "person-day.csv": [
      "study_id",
      "site_id",
      "person_day_id",
      "plan_version"
    ],
    "passenger-leg.csv": [
      "study_id",
      "site_id",
      "leg_id"
    ],
    "leg-events.csv": [
      "study_id",
      "site_id",
      "event_id"
    ],
    "work-and-cost.csv": [
      "study_id",
      "site_id",
      "cost_record_id"
    ],
    "service-resource.csv": [
      "study_id",
      "site_id",
      "comparison_option",
      "service_id",
      "band_start",
      "band_end"
    ],
    "population-funnel.csv": [
      "study_id",
      "site_id",
      "comparison_option",
      "cohort_id",
      "period_start",
      "period_end",
      "stratum_code"
    ],
    "decision-usability.csv": [
      "study_id",
      "team_code",
      "case_id",
      "comparison_condition",
      "blind_rater_code"
    ],
    "issue-and-amendment.csv": [
      "study_id",
      "site_id",
      "issue_id"
    ]
  },
  "keys_and_allocation": {
    "person_day_id": "Unique within study/site; passenger legs reference it. required_leg_ids is a semicolon-separated list of leg_id values. Retain each plan_version as a separate row.",
    "leg_id": "Unique immutable planned passenger leg within study/site. A changed origin, destination, window or practical requirement receives a new leg_id; retain the old row. Revised person-day required_leg_ids identifies the new leg. attempt_id distinguishes retries/fallback for the same leg requirements.",
    "event_id": "Unique immutable event within study/site. Retain events in timestamp order, including failed and superseded attempts.",
    "cost_record_id": "Unique allocation row in work-and-cost.csv. Event and leg cost fields are references/summaries and are not added again.",
    "source_cost_id": "Source expense or work item. allocated_fraction across all allocations of this source must sum to at most 1; unallocated remainder is reported.",
    "allocated_fraction": "Number from 0 to 1; actual_paid_cost and staff_minutes are allocated values, not source totals. Document allocation_method; do not multiply allocated values a second time.",
    "leg_id_on_cost": "Optional for shared costs; comparison_option, service_id and period still identify the account. Use shared_pending and cost_status=unallocated until an allocation is agreed.",
    "cohort_id": "Frozen population frame; period_start/end and comparison_option distinguish repeated rounds and crossover conditions. Counts describe distinct people within that frame/window.",
    "stratum_code": "A coded, frozen analysis stratum. Person-day cohort_id/stratum_code joins the corresponding population frame in population-funnel.csv for its option/period; do not infer sensitive traits from the identifier. Multiple intersecting analyses need separately declared frames without double-counting people.",
    "suitable_operated_minutes": "Minutes within operated_minutes with the defined suitable service available. Must satisfy 0<=suitable_operated_minutes<=operated_minutes<=scheduled_minutes; document the suitability requirement and simultaneous resource-count boundary."
  },
  "not_collected": [
    "Names",
    "contactdetails",
    "exacthomeaddresses",
    "medicaldiagnoses",
    "clientconfidentialinformation",
    "employeeperformanceassessments"
  ],
  "files": {
    "decision-usability.csv": {
      "fields": [
        "study_id",
        "team_code",
        "role_group",
        "case_id",
        "material_order",
        "comparison_condition",
        "rubric_version",
        "blind_rater_code",
        "supported_decisions_score",
        "unsupported_claims_count",
        "critical_errors_count",
        "completion_minutes",
        "dissent_recorded",
        "outcome_status",
        "consent_version",
        "independent_case_author_code",
        "independent_rubric_author_code",
        "allocation_unit",
        "rater_pair_code",
        "reliability_statistic",
        "adjudication_code"
      ],
      "rows": 0
    },
    "issue-and-amendment.csv": {
      "fields": [
        "study_id",
        "site_id",
        "issue_id",
        "recorded_at",
        "category",
        "severity",
        "description_without_personal_data",
        "action_owner_code",
        "pause_triggered",
        "resolution_status",
        "resolved_at",
        "protocol_version_before",
        "protocol_version_after",
        "outcomes_seen_before_amendment",
        "review_reference",
        "consent_version"
      ],
      "rows": 0
    },
    "leg-events.csv": {
      "fields": [
        "study_id",
        "site_id",
        "person_day_id",
        "leg_id",
        "attempt_id",
        "event_id",
        "event_at",
        "service_or_fallback",
        "event_type",
        "previous_state",
        "new_state",
        "reason_code",
        "responsibility_owner_code",
        "cost_record_id",
        "consent_version"
      ],
      "rows": 0
    },
    "passenger-leg.csv": {
      "fields": [
        "study_id",
        "site_id",
        "participant_code",
        "person_day_id",
        "leg_id",
        "purpose_category",
        "broad_origin_zone",
        "destination_category",
        "earliest_start",
        "required_arrival_by",
        "eligible",
        "informed",
        "offered",
        "enrolled",
        "requested_at",
        "accepted_at",
        "started_at",
        "arrived_at",
        "door_reached_at",
        "suitable_supply_confirmed",
        "assistance_accepted",
        "status",
        "failure_reason_code",
        "fallback_offered",
        "fallback_accepted",
        "fallback_completed_at",
        "user_cost",
        "employer_cost",
        "currency",
        "consent_version",
        "outcome_source_code",
        "booking_lead_minutes",
        "coordination_contacts",
        "unplanned_request",
        "rider_effort_minutes",
        "fallback_equivalence_code"
      ],
      "rows": 0
    },
    "person-day.csv": {
      "fields": [
        "study_id",
        "site_id",
        "cohort_id",
        "stratum_code",
        "participant_code",
        "person_day_id",
        "date",
        "comparison_option",
        "plan_version",
        "required_leg_ids",
        "final_destination_category",
        "required_end_by",
        "practical_requirements_code",
        "plan_revised_at",
        "revision_reason_code",
        "service_only_chain_complete",
        "any_accepted_mode_chain_complete",
        "all_requirements_met",
        "outcome_status",
        "missing_reason_code",
        "consent_version",
        "consent_recorded_at",
        "plan_fixed_at",
        "primary_exclusion_code",
        "outcome_source_code",
        "coder_code",
        "coder_blind_to_arm",
        "revision_coder_code",
        "revision_coder_blind_to_arm",
        "tenure_control_code"
      ],
      "rows": 0
    },
    "population-funnel.csv": {
      "fields": [
        "study_id",
        "site_id",
        "comparison_option",
        "cohort_id",
        "period_start",
        "period_end",
        "stratum_code",
        "population_count",
        "invited_count",
        "response_count",
        "eligible_count",
        "informed_count",
        "offered_count",
        "enrolled_count",
        "requesting_people_count",
        "served_people_count",
        "exclusion_reason_code",
        "nonuse_reason_code",
        "suppressed_small_cell",
        "consent_version",
        "tenure_control_code"
      ],
      "rows": 0
    },
    "service-resource.csv": {
      "fields": [
        "study_id",
        "site_id",
        "comparison_option",
        "service_id",
        "date",
        "band_start",
        "band_end",
        "scheduled_minutes",
        "operated_minutes",
        "suitable_operated_minutes",
        "total_resources",
        "suitable_resources",
        "occupied_distance_km",
        "empty_distance_km",
        "passenger_legs_completed",
        "passenger_km",
        "energy_kwh",
        "mode_displaced_category",
        "extra_trip_induced",
        "missing_field_reason",
        "consent_version"
      ],
      "rows": 0
    },
    "work-and-cost.csv": {
      "fields": [
        "study_id",
        "site_id",
        "comparison_option",
        "service_id",
        "period_start",
        "period_end",
        "cost_record_id",
        "source_cost_id",
        "allocated_fraction",
        "allocation_method",
        "date",
        "leg_id",
        "task_category",
        "responsibility_owner_code",
        "work_accepted",
        "paid_scope_confirmed",
        "staff_minutes",
        "actual_paid_cost",
        "cost_status",
        "payer_category",
        "currency",
        "recovery_authority_code",
        "issue_id",
        "consent_version"
      ],
      "rows": 0
    }
  },
  "prospective_correction": {
    "status": "PROPOSED_NOT_RUN_LOCAL_FREEZE_REQUIRED",
    "original_study_status": "19 October desk synthesis and proposed studies preserved; no participant or study outcome created",
    "completion": {
      "primary_metric": "M01",
      "co_primary_metric": "M02",
      "unit": "one original planned person-day per study/site/person_day_id, plan_version 0",
      "permitted_primary_exclusions": [
        "NO_PLANNED_TRAVEL_FIXED_BEFORE_DAY",
        "CONSENT_WITHDRAWN_BEFORE_OUTCOME_COLLECTION"
      ],
      "not_exclusions": [
        "service failure",
        "late meeting",
        "missed return",
        "declined service",
        "revised plan",
        "missing outcome"
      ],
      "missing": "Primary denominator retains planned days after only the two fixed exclusions. Count only observed confirmed completion in the numerator; missing is not coded as observed failure or success. This confirmed-completion fraction is a lower bound on completion. Report missingness and all-planned best/worst-case bounds, with complete-case and predeclared missingness assumptions as sensitivities. Local design review must freeze this estimand before collection.",
      "revisions": "Primary score stays against version 0; legitimate revision may fail the original-plan outcome without being attributed as a service-caused failure. Secondary revised-plan result and sensitivity using only changes documented before the affected leg; report revisions by arm.",
      "source_hierarchy": [
        "participant confirmation against precommitted requirements",
        "time-stamped booking/dispatch or destination records, when consent and permitted access exist",
        "adjudicated discrepancy retaining both source accounts"
      ],
      "source_rule": "Freeze the same source availability and reconciliation hierarchy in every arm; if unavailable, label self-report and validate an independently recorded subsample only after approved prospective design.",
      "coder": "Named trained coder and separate discrepancy adjudicator must be appointed before data collection; record blinding to arm where feasible and disclose breaks."
    },
    "comparison": {
      "fallback": "For H01 use the same funded fallback entitlement and access rules across arms when comparing the primary service mechanism. If fallback differs as part of an option, predeclare it as part of the treatment; report use, cost, funding, eligibility and equivalence by arm.",
      "alternative_dimensions": [
        "user cost",
        "operating hours",
        "response time",
        "booking lead time",
        "geographic coverage",
        "accessible information and support",
        "suitable capacity",
        "trip purposes",
        "integration and required endpoints"
      ],
      "equivalence": "An acceptable-to-user fallback is recorded separately from equivalence on these dimensions; competent counsel must assess any applicable equivalence duties. No legal conclusion supplied.",
      "multiplicity": "Before recruitment choose one confirmatory WMO hypothesis per site and one primary margin; H01 uses M01 and M02 as joint required outcomes. Other hypotheses/endpoints are exploratory unless a separate multiplicity plan and power analysis are frozen. No post-result switching."
    },
    "ethics": {
      "gate_A": "Independent research-ethics/privacy review by an ethics committee or documented equivalent before Stage A recruitment.",
      "gate_C": "Renew review before Stage C exposure and after a material protocol change.",
      "sponsor": "UNASSIGNED_LOCAL_REQUIRED",
      "data_controller": "UNASSIGNED_LOCAL_REQUIRED",
      "independent_contact": "UNASSIGNED_LOCAL_REQUIRED",
      "nonparticipants": "Before live exposure define notice/signage, accessible incident contact for nonparticipants, observation boundaries and data minimization; do not collect identifiable bystander data by default.",
      "disabled_user_role": "Include disabled employees or a disability network/organization with a defined role in instrument design, access thresholds and stop conditions before Stage A. The inspected desk-cycle record supplies no evidence of disabled-person participation in that cycle; do not invent it.",
      "H06": "Practitioner case participants require the same information/consent and independent withdrawal route."
    },
    "H06": {
      "design": "Prospective between-team randomized allocation or balanced case sets, analyzed at team level. Do not mix team learning with material effect.",
      "case_author": "UNASSIGNED_REQUIRED_INDEPENDENT_OF_TOOLKIT_PRODUCTION",
      "rubric_author": "UNASSIGNED_REQUIRED_INDEPENDENT_OF_TOOLKIT_PRODUCTION",
      "primary": "critical decision error rate using external task consequences, not toolkit vocabulary; local meaningful margin must be frozen",
      "raters": "At least two raters blind to tool allocation and case provenance; name them and freeze training, weighted kappa or another outcome-appropriate reliability statistic, threshold and adjudication rule before scoring.",
      "status": "NOT_READY_FOR_EXECUTION_UNTIL_APPOINTMENTS_AND_FREEZE"
    },
    "tenure": "Stratify prospective sites as owner-occupier and multi-tenant, recording title, control, funder, beneficiary and decision horizon. Multi-tenant guidance is a hypothesis until rights and accepted scope are evidenced."
  }
}
