Bill/olids schema changes 202604

[BillWoodNHS]

This pull request introduces YAML schema dictionary files for the OLIDS common data model. These files define the structure, metadata, and relationships for each table as part of the schema, supporting improved data documentation and interoperability.

New schema dictionary files:

OLIDS Common Schema Documentation updates:

• Updates to full schema to note the clear up of ORGANISATION_ID type columns
• Updates to full schema to note the addition of SHARD_ID columns
• Updates to full schema to note the clarification of SOURCE_CONCEPT_ID columns

[Copilot]

Pull request overview

This PR adds YAML “schema dictionary” files for the OLIDS common data model, describing table structures, column metadata, and (in some cases) relationships, to support improved documentation and interoperability.

Changes:

• Introduces schema-dictionary YAML definitions for OLIDS_COMMON, OLIDS_PCD, OLIDS_MASKED, OLIDS_TERMINOLOGY, OLIDS_GOVERNANCE, and REFERENCE schemas.
• Adds column-level metadata (descriptions, data types, compass equivalents) and some relationship/reference annotations.
• Updates documentation content to reflect recent schema clarifications (e.g., organisation id typing, shard ids, and source concept ids).

Reviewed changes

Copilot reviewed 35 out of 36 changed files in this pull request and generated 22 comments.

Show a summary per file

File	Description
OLIDS/Documentation/schema-dictionary/reference__postcode_hash.yml	Adds schema dictionary for REFERENCE.postcode_hash reference table
OLIDS/Documentation/schema-dictionary/olids_terminology__concept.yml	Adds schema dictionary for OLIDS_TERMINOLOGY.concept
OLIDS/Documentation/schema-dictionary/olids_terminology__concept_map.yml	Adds schema dictionary for OLIDS_TERMINOLOGY.concept_map
OLIDS/Documentation/schema-dictionary/olids_pcd__person.yml	Adds schema dictionary for OLIDS_PCD.person
OLIDS/Documentation/schema-dictionary/olids_pcd__patient.yml	Adds schema dictionary for OLIDS_PCD.patient
OLIDS/Documentation/schema-dictionary/olids_pcd__patient_uprn.yml	Adds schema dictionary for OLIDS_PCD.patient_uprn
OLIDS/Documentation/schema-dictionary/olids_pcd__patient_contact.yml	Adds schema dictionary for OLIDS_PCD.patient_contact
OLIDS/Documentation/schema-dictionary/olids_pcd__patient_address.yml	Adds schema dictionary for OLIDS_PCD.patient_address
OLIDS/Documentation/schema-dictionary/olids_masked__person_masked.yml	Adds schema dictionary for OLIDS_MASKED.person_masked
OLIDS/Documentation/schema-dictionary/olids_masked__patient_masked.yml	Adds schema dictionary for OLIDS_MASKED.patient_masked
OLIDS/Documentation/schema-dictionary/olids_masked__patient_uprn_masked.yml	Adds schema dictionary for OLIDS_MASKED.patient_uprn_masked
OLIDS/Documentation/schema-dictionary/olids_masked__patient_contact_masked.yml	Adds schema dictionary for OLIDS_MASKED.patient_contact_masked
OLIDS/Documentation/schema-dictionary/olids_masked__patient_address_masked.yml	Adds schema dictionary for OLIDS_MASKED.patient_address_masked
OLIDS/Documentation/schema-dictionary/olids_governance__allocation.yml	Adds schema dictionary for OLIDS_GOVERNANCE.allocation
OLIDS/Documentation/schema-dictionary/olids_common__schedule.yml	Adds schema dictionary for OLIDS_COMMON.schedule
OLIDS/Documentation/schema-dictionary/olids_common__schedule_practitioner.yml	Adds schema dictionary for OLIDS_COMMON.schedule_practitioner
OLIDS/Documentation/schema-dictionary/olids_common__referral_request.yml	Adds schema dictionary for OLIDS_COMMON.referral_request
OLIDS/Documentation/schema-dictionary/olids_common__procedure_request.yml	Adds schema dictionary for OLIDS_COMMON.procedure_request
OLIDS/Documentation/schema-dictionary/olids_common__practitioner.yml	Adds schema dictionary for OLIDS_COMMON.practitioner
OLIDS/Documentation/schema-dictionary/olids_common__practitioner_in_role.yml	Adds schema dictionary for OLIDS_COMMON.practitioner_in_role
OLIDS/Documentation/schema-dictionary/olids_common__patient_registered_practitioner_in_role.yml	Adds schema dictionary for OLIDS_COMMON.patient_registered_practitioner_in_role
OLIDS/Documentation/schema-dictionary/olids_common__patient_person.yml	Adds schema dictionary for OLIDS_COMMON.patient_person bridge table
OLIDS/Documentation/schema-dictionary/olids_common__organisation.yml	Adds schema dictionary for OLIDS_COMMON.organisation
OLIDS/Documentation/schema-dictionary/olids_common__observation.yml	Adds schema dictionary for OLIDS_COMMON.observation
OLIDS/Documentation/schema-dictionary/olids_common__medication_statement.yml	Adds schema dictionary for OLIDS_COMMON.medication_statement
OLIDS/Documentation/schema-dictionary/olids_common__medication_order.yml	Adds schema dictionary for OLIDS_COMMON.medication_order
OLIDS/Documentation/schema-dictionary/olids_common__location.yml	Adds schema dictionary for OLIDS_COMMON.location
OLIDS/Documentation/schema-dictionary/olids_common__location_contact.yml	Adds schema dictionary for OLIDS_COMMON.location_contact
OLIDS/Documentation/schema-dictionary/olids_common__flag.yml	Adds schema dictionary for OLIDS_COMMON.flag
OLIDS/Documentation/schema-dictionary/olids_common__episode_of_care.yml	Adds schema dictionary for OLIDS_COMMON.episode_of_care
OLIDS/Documentation/schema-dictionary/olids_common__encounter.yml	Adds schema dictionary for OLIDS_COMMON.encounter
OLIDS/Documentation/schema-dictionary/olids_common__diagnostic_order.yml	Adds schema dictionary for OLIDS_COMMON.diagnostic_order
OLIDS/Documentation/schema-dictionary/olids_common__appointment.yml	Adds schema dictionary for OLIDS_COMMON.appointment
OLIDS/Documentation/schema-dictionary/olids_common__appointment_practitioner.yml	Adds schema dictionary for OLIDS_COMMON.appointment_practitioner
OLIDS/Documentation/schema-dictionary/olids_common__allergy_intolerance.yml	Adds schema dictionary for OLIDS_COMMON.allergy_intolerance

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.