DRAFT PH Road Safety Implementation Guide
0.2.0 - ci-build Philippines flag

DRAFT PH Road Safety Implementation Guide, published by UP Manila - National Institutes of Health - National Telehealth Center. This guide is not an authorized publication; it is the continuous build for version 0.2.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/UPM-NTHC/PH-RoadSafetyIG/ and changes regularly. See the Directory of published versions

Artifacts Summary

This page provides a list of the FHIR artifacts defined as part of this implementation guide.

Structures: Logical Models

These define data models that represent the domain covered by this implementation guide in more business-friendly terms than the underlying FHIR resources.

RS Minimum Dataset (MDS) Logical Model

Abstract, sectioned logical model for the PH RS MDS covering incident, patient, encounter, clinical, vitals, injuries, evidence/documents, workflow, and finance. Elements mirror the CSV rows; mappings point to target FHIR elements for subsequent profiling.

Structures: Resource Profiles

These define constraints on FHIR resources for systems conforming to this implementation guide.

RS AllergyIntolerance

Known allergies, substances and reactions.

RS Bundle — EMS Submission

Document Bundle for EMS Run Report submission. The first entry MUST be a Composition that organizes and references the other resources in the bundle (Patient, Encounter, Location, Observations, DocumentReference, Procedure, ServiceRequest, Task, Claim).

RS Bundle — ONEISS Submission

Document Bundle for Facility ONEISS submission. The first entry MUST be a Composition that organizes and references the other resources in the bundle (Patient, Encounter, Condition, Observations, DocumentReference, Procedure, ServiceRequest).

RS Bundle — Post‑Crash Investigation

Document Bundle for Post‑Crash investigation submission. The first entry MUST be a Composition that organizes and references post‑crash Observations and supporting DocumentReferences.

RS Claim

Claim information related to cost of care.

RS Composition — EMS Submission

Composition that organises an EMS run report. Sections MUST reference the other resources present in the corresponding document Bundle (Patient, Encounter, Location, Observations, DocumentReference, Procedure, ServiceRequest, Task, Claim).

RS Composition — ONEISS Submission

Composition that organises a facility (ONEISS) submission. Sections MUST reference the other resources present in the corresponding document Bundle (Patient, Encounter, Condition, Observations, DocumentReference, Procedure, ServiceRequest).

RS Composition — Post‑Crash Investigation

Composition that organises a Post‑Crash submission. Sections reference Observations and Documents related to post‑crash investigation (collision type, investigator presence, other risk factors, safety accessories, vehicle condition, CCTV, evidence documents).

RS Condition

Condition resource for RS IG that supports multiple coding systems, textual entries and use-case specific semantics (initial impression, final diagnosis, medical history) via code.coding slicing and category usage.

RS Condition — External Cause (category)

Captures the ICD-10 external cause axis as a Condition.category slice. Use in addition to the specific diagnosis code.

RS Condition — Final Diagnosis

Final diagnosis per CSV mapping.

RS Condition — Initial Impression

Enter the initial impression on the patient’s condition.

RS Condition — Nature of Injury (category)

Captures the ICD-10 nature-of-injury axis as a Condition.category slice. Use in addition to the specific diagnosis code.

RS Condition — Problem

Problem (finding) per CSV mapping.

RS DocumentReference (Evidence)

Evidence and post-crash documentation linked to the incident (e.g., cause of crash, party at fault, incident management logs, CCTV, shape files).

RS Encounter

Encounter for EMS run report / facility submission context. Captures incident number, type, timing, participants, disposition & transfer.

RS HealthcareService

Healthcare services offered by organizations (e.g., EMS base, receiving facility clinics/units).

RS Incident Location

Location of incident; supports PH-Core address extensions and geolocation.

RS MedicationStatement

Current medications as codeable concepts or references where available.

RS Observation

Generic base Observation for RS data; specialized concept profiles below constrain code/value patterns.

RS Observation - Abrasion

Abrasion present; with optional site and details.

RS Observation - Activity at Time of Incident

Activity of the patient at time of incident; allow text fallback.

RS Observation - Avulsion

Avulsion present; with optional site and details.

RS Observation - Blood Alcohol Concentration

Blood alcohol concentration.

RS Observation - Blood Pressure

Blood pressure using component entries for systolic/diastolic.

RS Observation - Body Temperature

Body temperature.

RS Observation - CCTV Available

Availability of CCTV video.

RS Observation - Call Source

Call source description (free text).

RS Observation - Clinical Remarks

Clinical remarks/notes.

RS Observation - Collision Type

Collision type (Angle, Head-on, Rear end, Side swipe, etc.).

RS Observation - Collision vs Non-Collision

Indicates whether the incident was collision or non-collision.

RS Observation - Concussion

Concussion present; with site and details.

RS Observation - Condition of Patient

Overall condition of patient at assessment.

RS Observation - Contusion

Contusion present; with site and details.

RS Observation - Cyanosis

Cyanosis assessment.

RS Observation - Date/Time of Injury

DateTimestamp patient was seen at the health facility.

RS Observation - External Cause: Bites/Stings

Flag indicating bites/stings.

RS Observation - External Cause: Burns

Flag indicating burns as external cause.

RS Observation - External Cause: Burns

Flag indicating burns as external cause.

RS Observation - External Cause: Chemical/Substance

Observation for chemical/substance exposure.

RS Observation - External Cause: Contact with Sharp Object

Flag indicating sharp object cause.

RS Observation - External Cause: Drowning

Flag indicating drowning.

RS Observation - External Cause: Exposure to Forces of Nature

Flag indicating exposure to natural disaster/calamity.

RS Observation - External Cause: Fall

Flag indicating fall.

RS Observation - External Cause: Firecracker

Flag indicating firecracker-related cause.

RS Observation - External Cause: Gunshot

Flag indicating gunshot.

RS Observation - External Cause: Hanging/Strangulation

Flag indicating hanging/strangulation.

RS Observation - External Cause: Mauling/Assault

Flag indicating assault.

RS Observation - External Cause: Other

Flag indicating other external cause.

RS Observation - External Cause: Sexual Assault/Abuse/Rape (Alleged)

Flag indicating sexual assault.

RS Observation - Fracture

Fracture observation. Use valueCodeableConcept to indicate fracture type (e.g., open or closed). Sites captured in top-level bodySite and details in note.

RS Observation - Glasgow Coma Scale

GCS with components for eyes, verbal, motor; optional total score as integer.

RS Observation - How Many Vehicles Involved

Count of vehicles involved.

RS Observation - Injury Intent

Intent of injury (Unintentional, Intentional-self, Intentional-violence, Undetermined).

RS Observation - Level of Consciousness (AVPU)

Level of consciousness (e.g., AVPU).

RS Observation - Mode of Transport to Facility

Mode of transport to the hospital/facility; allow coded value with optional text for 'Others'.

RS Observation - Multiple Injuries?

Boolean flag indicating multiple injuries.

RS Observation - Open Wound

Open wound present; with site and details. Capture mechanism/type in a structured component (valueCodeableConcept with text).

RS Observation - Other Risk Factors

Other risk factors at the time of incident; allow text for 'Others'.

RS Observation - Other Specified Injury

Other specified injury present; capture type as valueCodeableConcept (text allowed) with optional site and details.

RS Observation - Other Vehicle/Object Involved

Other vehicle/object type involved; text for 'Others'.

RS Observation - Outcome at Release

Outcome at release from ER/OPD/RHU.

RS Observation - Patient's Vehicle

Type of vehicle used by patient; text for 'Others'.

RS Observation - Place of Occurrence

Place type where injury occurred; name can be carried in note when applicable.

RS Observation - Position of Patient

Seat/position (driver/front passenger/rear/pedestrian); text for 'Others'.

RS Observation - Presence of Traffic Investigator

Boolean presence/absence of traffic investigator.

RS Observation - Priority Level (Urgency)

System-generated urgency level per CAD/agency rules.

RS Observation - Pulse Rate

Pulse/heart rate in beats/min.

RS Observation - Pupils

Pupil size/reactivity summary.

RS Observation - Referred By Facility

Flag indicating patient was referred by another hospital/facility.

RS Observation - Reported Complaint

Free-text reported complaint. May or May not exactly be medical, could point to car crash, not a healthcare concern.

RS Observation - Respiratory Rate

Respiratory rate in breaths/min.

RS Observation - Run Report Comments

Enter other comment (s) regarding the case

RS Observation - Safety Accessories

Safety accessories present/used; allow text for 'Others'.

RS Observation - Status on Arrival

Status upon reaching facility/hospital.

RS Observation - Timeline Date/Time

Dispatch and transport timeline events capturing a precise date/time.

RS Observation - Transferred From Facility

Flag indicating patient transferred from another hospital/facility.

RS Observation - Transport/Vehicular Accident

Boolean flag indicating transport/vehicular accident.

RS Observation - Traumatic Amputation

Traumatic amputation present; with site and details.

RS Observation - Triage Priority

Triage category assigned at scene (e.g., Red/Yellow/Green/Black).

RS Organization

Organization profile for EMS providers and receiving facilities involved in RS encounters.

RS Patient

Patient demographics and identifiers for RS reporting; reuse PH-Core address extensions for barangay/city/province/region.

RS Procedure

Procedures related to incident/report (e.g., coordination with receiving hospital, psychosocial support, interventions).

RS Procedure - Transport Coordination

Procedure record indicating whether transport coordination with the receiving hospital was done.

RS Service Location

Facility/service delivery location. Type bound to HL7 v3 ServiceDeliveryLocationRoleType (e.g., ER, ward, clinic).

RS ServiceRequest

Requests or records related to refusal to admit and related workflow signals.

RS Task

Workflow tracking for report receipt, durations of delay, and sources of delays.

Structures: Extension Definitions

These define constraints on FHIR data types for systems conforming to this implementation guide.

RS Encounter Vehicle Used

Identifier and type of transport vehicle used during an encounter.

Terminology: Value Sets

These define sets of codes used by systems conforming to this implementation guide.

RS VS - PSGC Barangay

PSGC Barangay codes (managed externally).

RS VS - PSGC City/Municipality

PSGC City/Municipality codes (managed externally).

RS VS - PSGC Province

PSGC Province codes (managed externally).

RS VS - PSGC Region

PSGC Region codes (managed externally).

SILPH - Activity (VS)

SILPH Value Set for Patient Activity at the Time of Injury/Accident

SILPH - Burns (VS)

SILPH Value Set for Degree of Burn

SILPH - Cyanosis (VS)

SILPH Value Set for Presence of Cyanosis

SILPH - Element Terminology (VS)

SILPH Value Set for Element Terminology

SILPH - Encounter Participant Role (VS)

SILPH Value Set for EMS encounter participant roles documented on the run report.

SILPH - External Cause of Burns (VS)

SILPH Value Set for External Cause of Burns

SILPH - External Cause of Drowning (VS)

SILPH Value Set for External Cause of Drowning

SILPH - Fracture Type (VS)

SILPH Value Set for fracture type designation (open versus closed)

SILPH - GCS - Eyes (VS)

SILPH Value Set for GCS Eye Score

SILPH - GCS - Motor (VS)

SILPH Value Set for GCS Motor Score

SILPH - GCS - Verbal (VS)

SILPH Value Set for GCS Verbal Score

SILPH - General Disposition (VS)

SILPH Value Set for Inpatient and ER/Outpatient Visit Disposition

SILPH - ICD10 External Cause of Injury (VS)

SILPH Value Set for ICD 10 Codes for External Cause of Injury (Selected Codes from Chapter XX - V01-Y36, Y85-Y87, and Y89)

SILPH - ICD10 Nature of Injury (VS)

SILPH Value Set for ICD 10 Codes for Nature of Injury (Chapter XIX - S00-T98)

SILPH - Injury Intent (VS)

SILPH Value Set for Injury Intent

SILPH - Inpatient Disposition (VS)

SILPH Value Set for Inpatient Visit Disposition

SILPH - Level of Consciousness (VS)

SILPH Value Set for Level of Consciousness (AVPU) Score

SILPH - List of Body Sites (VS)

SILPH List of Body Sites

SILPH - Local Codes (VS)

SILPH Value Set for containing all Road Safety Local Codes (data element terminology codes and codes for value sets)

SILPH - Mode of Transport (VS)

SILPH Value Set for Mode of Transport of Patient to Healthcare Facility

SILPH - Other Vehicle in Collision (VS)

SILPH Value Set for Other Vehicle in Collision Accident

SILPH - Outcome (VS)

SILPH Value Set for Outcome

SILPH - Outpatient/ER Disposition (VS)

SILPH Value Set for Outpatient/ER Visit Disposition

SILPH - PR - Quality (VS)

SILPH Value Set for Pulse Quality

SILPH - PR - Rhythm (VS)

SILPH Value Set for Pulse Rhythm

SILPH - Patient's Vehicle (VS)

SILPH Value Set for Patient's Vehicle

SILPH - Place of Occurrence (VS)

SILPH Value Set for Place of Occurrence of Injury/Accident

SILPH - Position of Patient (VS)

SILPH Value Set for Position of Patient

SILPH - Pupils (VS)

SILPH Value Set for Pupil Reaction

SILPH - RR - Breath Sounds (VS)

SILPH Value Set for Breath Sounds

SILPH - RR - Rhythm (VS)

SILPH Value Set for Respiratory Rhythm

SILPH - Risk Factors (VS)

SILPH Value Set for Risk Factors

SILPH - Safety Devices (VS)

SILPH Value Set for Safety Devices

SILPH - Sex (VS)

SILPH Value Set for Sex

SILPH - Status (VS)

SILPH ValueSet for Patient Status, if Alive or Dead during Admission

SILPH - Status if Alive (VS)

SILPH Value Set for Patient Status, if patient is alive, specify if conscious or unconscious

SILPH - Transport Accident Type (VS)

SILPH Value Set for Transport Accident Type (Land, Water or Air)

SILPH - Transport Accident: Collision or Noncollision (VS)

SILPH Value Set for Transport Accident if Collision or Noncollision

SILPH - Triage (VS)

SILPH Value Set for Triage at Scene

SILPH - Type of Patient (VS)

SILPH Value Set for Type of Patient Encounter

Terminology: Code Systems

These define new code systems used by systems conforming to this implementation guide.

SILPH Road Safety Local Codes

Compilation of local codes for SILPH Road Safety Project. Includes local codes for data element terminology mapping and local codes for value sets

Terminology: Concept Maps

These define transformations to convert between codes by systems conforming with this implementation guide.

MDSRoadSafety Logical Model to FHIR Mapping

Maps elements from the logical model to FHIR R4 resources. Generated by scripts/generate-conceptmap.js