{
    "schema_version": "2026-10-31.2",
    "source_timezone": "Africa/Kampala",
    "datasets": {
        "survivors": {
            "grain": "One recorded survivor intake",
            "scope": "powerbi.survivors.read",
            "fields": {
                "survivor_code": "confidential business reference text or null",
                "crb_number": "confidential business reference text or null",
                "district_name": "text or null",
                "subcounty_name": "text or null",
                "parish_name": "text or null",
                "region_name": "text or null",
                "sub_region_name": "text or null",
                "partner_name": "text or null",
                "partner_alt_name": "text or null",
                "creator_role_name": "text or null",
                "source_created_at": "source local datetime or null",
                "source_updated_at": "source local datetime or null",
                "quality_flags": "list of field names with invalid or unresolved values",
                "interview_date": "date or null",
                "interview_time_name": "text or null",
                "was_referred": "boolean or null",
                "gender_name": "text or null",
                "nationality_name": "text or null",
                "identity_document_type_name": "text or null",
                "national_status_name": "text or null",
                "national_status_category_name": "text or null",
                "children_count": "integer or null",
                "religion_name": "text or null",
                "marital_status_name": "text or null",
                "separated_from_children": "boolean or null",
                "has_disability": "boolean or null",
                "disability_name": "text or null",
                "education_name": "text or null",
                "occupation_name": "text or null",
                "employment_status": "text or null",
                "previously_reported": "boolean or null",
                "reporter_gender_name": "text or null",
                "reporter_relationship_name": "text or null",
                "reporter_type": "text or null",
                "age_at_intake_years": "integer or null",
                "is_child_at_intake": "boolean or null",
                "age_basis": "text or null",
                "record_key": "opaque relationship handle; not a database primary key",
                "survivor_key": "opaque survivor relationship handle; not a database primary key"
            },
            "display_fields": [
                "survivor_code",
                "crb_number"
            ],
            "technical_relationship_fields": [
                "record_key",
                "survivor_key"
            ]
        },
        "incidents": {
            "grain": "One incident record",
            "scope": "powerbi.incidents.read",
            "fields": {
                "survivor_code": "confidential business reference text or null",
                "crb_number": "confidential business reference text or null",
                "source_created_at": "source local datetime or null",
                "source_updated_at": "source local datetime or null",
                "quality_flags": "list of field names with invalid or unresolved values",
                "incident_type_name": "text or null",
                "incident_date": "date or null",
                "incident_time_name": "text or null",
                "age_at_incident_years": "integer or null",
                "is_child_at_incident": "boolean or null",
                "age_basis": "text or null",
                "incident_district_name": "text or null",
                "incident_subcounty_name": "text or null",
                "incident_parish_name": "text or null",
                "incident_region_name": "text or null",
                "incident_sub_region_name": "text or null",
                "record_key": "opaque relationship handle; not a database primary key",
                "survivor_key": "opaque survivor relationship handle; not a database primary key"
            },
            "display_fields": [
                "survivor_code",
                "crb_number"
            ],
            "technical_relationship_fields": [
                "record_key",
                "survivor_key"
            ]
        },
        "perpetrators": {
            "grain": "One recorded perpetrator observation",
            "scope": "powerbi.perpetrators.read",
            "fields": {
                "survivor_code": "confidential business reference text or null",
                "crb_number": "confidential business reference text or null",
                "source_created_at": "source local datetime or null",
                "source_updated_at": "source local datetime or null",
                "quality_flags": "list of field names with invalid or unresolved values",
                "nationality_name": "text or null",
                "identity_document_type_name": "text or null",
                "religion_name": "text or null",
                "national_status_name": "text or null",
                "national_status_category_name": "text or null",
                "legacy_national_status_name": "text or null",
                "employment_status": "text or null",
                "gender_name": "text or null",
                "age_group_name": "text or null",
                "education_name": "text or null",
                "occupation_name": "text or null",
                "relationship_name": "text or null",
                "threatened_survivor": "boolean or null",
                "record_key": "opaque relationship handle; not a database primary key",
                "survivor_key": "opaque survivor relationship handle; not a database primary key"
            },
            "display_fields": [
                "survivor_code",
                "crb_number"
            ],
            "technical_relationship_fields": [
                "record_key",
                "survivor_key"
            ]
        },
        "witnesses": {
            "grain": "One recorded witness observation",
            "scope": "powerbi.witnesses.read",
            "fields": {
                "survivor_code": "confidential business reference text or null",
                "crb_number": "confidential business reference text or null",
                "source_created_at": "source local datetime or null",
                "source_updated_at": "source local datetime or null",
                "quality_flags": "list of field names with invalid or unresolved values",
                "relationship_name": "text or null",
                "age_group_name": "text or null",
                "gender_name": "text or null",
                "record_key": "opaque relationship handle; not a database primary key",
                "survivor_key": "opaque survivor relationship handle; not a database primary key"
            },
            "display_fields": [
                "survivor_code",
                "crb_number"
            ],
            "technical_relationship_fields": [
                "record_key",
                "survivor_key"
            ]
        },
        "actions": {
            "grain": "One reported action or referral",
            "scope": "powerbi.actions.read",
            "fields": {
                "survivor_code": "confidential business reference text or null",
                "crb_number": "confidential business reference text or null",
                "source_created_at": "source local datetime or null",
                "source_updated_at": "source local datetime or null",
                "quality_flags": "list of field names with invalid or unresolved values",
                "reported_to_name": "text or null",
                "report_date": "date or null",
                "referred_to_name": "text or null",
                "referral_date": "date or null",
                "action_name": "derived authority, date and service label or null; not a unique identifier",
                "record_key": "opaque relationship handle; not a database primary key",
                "survivor_key": "opaque survivor relationship handle; not a database primary key"
            },
            "display_fields": [
                "survivor_code",
                "crb_number",
                "action_name"
            ],
            "technical_relationship_fields": [
                "record_key",
                "survivor_key"
            ]
        },
        "action_services": {
            "grain": "One distinct service linked to an action",
            "scope": "powerbi.action_services.read",
            "fields": {
                "survivor_code": "confidential business reference text or null",
                "crb_number": "confidential business reference text or null",
                "quality_flags": "list of field names with invalid or unresolved values",
                "action_name": "derived authority, date and service label or null; not a unique identifier",
                "service_name": "text",
                "link_source": "junction or legacy_csv or both",
                "record_key": "opaque relationship handle; not a database primary key",
                "survivor_key": "opaque survivor relationship handle; not a database primary key",
                "action_key": "opaque action relationship handle; not a database primary key"
            },
            "display_fields": [
                "survivor_code",
                "crb_number",
                "action_name",
                "service_name"
            ],
            "technical_relationship_fields": [
                "record_key",
                "survivor_key",
                "action_key"
            ]
        },
        "case_status_history": {
            "grain": "One case status history entry",
            "scope": "powerbi.case_status_history.read",
            "fields": {
                "survivor_code": "confidential business reference text or null",
                "crb_number": "confidential business reference text or null",
                "source_created_at": "source local datetime or null",
                "source_updated_at": "source local datetime or null",
                "quality_flags": "list of field names with invalid or unresolved values",
                "case_status_name": "text or null",
                "pending_point_name": "text or null",
                "status_date": "date or null",
                "record_key": "opaque relationship handle; not a database primary key",
                "survivor_key": "opaque survivor relationship handle; not a database primary key"
            },
            "display_fields": [
                "survivor_code",
                "crb_number"
            ],
            "technical_relationship_fields": [
                "record_key",
                "survivor_key"
            ]
        }
    },
    "code_lists": {
        "employment_status": [
            "Unemployed",
            "Employed"
        ],
        "reporter_type": [
            "Survivor",
            "Other"
        ]
    },
    "privacy": {
        "business_references": "Confidential Survivor Code/CRB, included only within the approved client data scope.",
        "operational_primary_keys": "Not exposed.",
        "relationship_handles": "Domain-separated HMAC values for unambiguous Power BI relationships; not database IDs."
    },
    "read_only": true,
    "allowed_methods": [
        "GET",
        "HEAD"
    ],
    "limitations": [
        "Business codes and action labels are not guaranteed unique.",
        "A new offline snapshot is required for readable_fields_ready=true.",
        "Full MySQL and Power BI refresh timing must be measured on target infrastructure."
    ]
}
