Skip to main content

wellfare_core/
rdf.rs

1use crate::models::{HeartRateRecord, SleepRecord, StepRecord, WeightRecord};
2use serde_json::Value;
3
4/// Generates RDF prefixes.
5pub fn generate_rdf_prefixes() -> String {
6    format!(
7        "@prefix schema:   <http://schema.org/> .\n\
8         @prefix health:   <https://health.example.org/ns#> .\n\
9         @prefix wf:       <https://wellfare.social/ns/vault#> .\n\
10         @prefix qudt:     <http://qudt.org/schema/qudt/> .\n\
11         @prefix qudt-unit:<http://qudt.org/vocab/unit/> .\n\
12         @prefix prov:     <http://www.w3.org/ns/prov#> .\n\
13         @prefix xsd:      <http://www.w3.org/2001/XMLSchema#> .\n\
14         @prefix rdf:      <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .\n\
15         @prefix rdfs:     <http://www.w3.org/2000/01/rdf-schema#> .\n\
16         @prefix sh:       <http://www.w3.org/ns/shacl#> .\n\
17         @prefix snomed:   <http://snomed.info/id/> .\n\
18         @prefix loinc:    <https://loinc.org/rdf/> .\n\
19         @prefix fhir:     <http://hl7.org/fhir/> .\n\
20         @prefix ccf:      <http://purl.org/ccf/> .\n\
21         @prefix uberon:   <http://purl.obolibrary.org/obo/UBERON_> .\n\
22         @prefix cl:       <http://purl.obolibrary.org/obo/CL_> .\n\
23         @prefix hra:      <https://purl.humanatlas.io/> .\n\n"
24    )
25}
26
27/// Serialize vault medication records (IDB wf-meds JSON array) to Turtle.
28pub fn vault_meds_to_turtle(json: &str) -> Result<String, String> {
29    let arr: Vec<Value> = serde_json::from_str(json).map_err(|e| e.to_string())?;
30    let mut out = generate_rdf_prefixes();
31    for rec in &arr {
32        let id = rec["id"].as_str().unwrap_or("unknown");
33        let name = rec["name"].as_str().unwrap_or("");
34        let subj = format!("<urn:wf:med:{}>", id);
35        out.push_str(&format!("{} a wf:MedicationRecord ;\n", subj));
36        out.push_str(&format!("    schema:name {:?} ;\n", name));
37        if let Some(v) = rec["dose"].as_str().filter(|s| !s.is_empty()) {
38            out.push_str(&format!("    wf:dose {:?} ;\n", v));
39        }
40        if let Some(v) = rec["route"].as_str().filter(|s| !s.is_empty()) {
41            out.push_str(&format!("    wf:route {:?} ;\n", v));
42        }
43        if let Some(v) = rec["frequency"].as_str().filter(|s| !s.is_empty()) {
44            out.push_str(&format!("    wf:frequency {:?} ;\n", v));
45        }
46        if let Some(v) = rec["started"].as_str().filter(|s| !s.is_empty()) {
47            out.push_str(&format!("    wf:startDate {:?}^^xsd:date ;\n", v));
48        }
49        if let Some(v) = rec["ceased"].as_str().filter(|s| !s.is_empty()) {
50            out.push_str(&format!("    wf:endDate {:?}^^xsd:date ;\n", v));
51        }
52        out.push_str("    prov:wasGeneratedBy <urn:wellfair:agent:vault> .\n\n");
53    }
54    Ok(out)
55}
56
57/// Serialize vault diet log entries (IDB wf-dl JSON array) to Turtle.
58pub fn vault_diet_to_turtle(json: &str) -> Result<String, String> {
59    let arr: Vec<Value> = serde_json::from_str(json).map_err(|e| e.to_string())?;
60    let mut out = generate_rdf_prefixes();
61    for rec in &arr {
62        let id = rec["id"].as_str().unwrap_or("unknown");
63        let name = rec["name"].as_str().unwrap_or("");
64        let subj = format!("<urn:wf:diet:{}>", id);
65        out.push_str(&format!("{} a wf:DietEntry ;\n", subj));
66        out.push_str(&format!("    schema:name {:?} ;\n", name));
67        if let Some(v) = rec["date"].as_str().filter(|s| !s.is_empty()) {
68            out.push_str(&format!("    wf:date {:?}^^xsd:date ;\n", v));
69        }
70        if let Some(v) = rec["meal"].as_str().filter(|s| !s.is_empty()) {
71            out.push_str(&format!("    wf:meal {:?} ;\n", v));
72        }
73        for (field, pred) in &[
74            ("kcal", "wf:kcal"),
75            ("protein_g", "wf:proteinG"),
76            ("carbs_g", "wf:carbsG"),
77            ("fat_g", "wf:fatG"),
78            ("fiber_g", "wf:fiberG"),
79            ("sugar_g", "wf:sugarG"),
80            ("sodium_mg", "wf:sodiumMg"),
81        ] {
82            if let Some(v) = rec[*field].as_f64() {
83                out.push_str(&format!("    {} {} ;\n", pred, v));
84            }
85        }
86        out.push_str("    prov:wasGeneratedBy <urn:wellfair:agent:vault> .\n\n");
87    }
88    Ok(out)
89}
90
91/// Serialize vault biometric records (IDB wf-biometrics JSON array) to Turtle.
92/// Each record carries { id, type: "weight"|"sleep"|"heart_rate"|"steps", date, value, ... }
93pub fn vault_biometrics_to_turtle(json: &str) -> Result<String, String> {
94    let arr: Vec<Value> = serde_json::from_str(json).map_err(|e| e.to_string())?;
95    let mut out = generate_rdf_prefixes();
96    for rec in &arr {
97        let id = rec["id"].as_str().unwrap_or("unknown");
98        let btype = rec["type"].as_str().unwrap_or("unknown");
99        let subj = format!("<urn:wf:biometric:{}>", id);
100        out.push_str(&format!(
101            "{} a wf:BiometricRecord , fhir:Observation ;\n",
102            subj
103        ));
104        out.push_str(&format!("    wf:biometricType {:?} ;\n", btype));
105        if let Some(v) = rec["date"].as_str() {
106            out.push_str(&format!(
107                "    fhir:Observation.effectiveDateTime {:?}^^xsd:dateTime ;\n",
108                v
109            ));
110        }
111        if let Some(v) = rec["value"].as_f64() {
112            out.push_str(&format!("    fhir:Observation.valueQuantity {} ;\n", v));
113        }
114        if let Some(v) = rec["unit"].as_str() {
115            out.push_str(&format!("    wf:unit {:?} ;\n", v));
116        }
117        out.push_str("    prov:wasDerivedFrom <urn:health:source:samsung-health-export> ;\n");
118        out.push_str("    prov:wasGeneratedBy <urn:wellfair:agent:vault> .\n\n");
119    }
120    Ok(out)
121}
122
123/// Converts  to Turtle.
124pub fn weight_to_turtle(records: &[WeightRecord]) -> String {
125    let mut out = generate_rdf_prefixes();
126    for rec in records {
127        let subj = format!("<urn:health:weight:{}>", rec.uuid);
128        out.push_str(&format!("{} a fhir:Observation ;\n", subj));
129        out.push_str("    health:snomedConcept snomed:27113001 ;\n");
130        out.push_str("    health:loincConcept loinc:29463-7 ;\n");
131        out.push_str("    schema:name \"Body weight\" ;\n");
132        out.push_str("    prov:wasDerivedFrom <urn:health:source:samsung-health-export> ;\n");
133        out.push_str("    prov:wasGeneratedBy <urn:wellfair:agent:health-to-solid> ;\n");
134        out.push_str("    schema:description \"Samsung Health CSV export\" ;\n");
135        out.push_str(&format!(
136            "    fhir:Observation.effectiveDateTime \"{}\"^^xsd:dateTime ;\n",
137            rec.start_datetime.to_rfc3339()
138        ));
139        out.push_str(&format!(
140            "    fhir:Observation.valueQuantity {} ;\n",
141            rec.weight
142        ));
143        out.push_str("    qudt:unit qudt-unit:Pound_Lb ;\n");
144        out.push_str("    schema:unitCode \"Pound_Lb\" ;\n");
145        out.push_str(
146            "    health:semanticReference fhir:Observation.valueQuantity , snomed:27113001 .\n\n",
147        );
148
149        if let Some(body_fat) = rec.body_fat {
150            out.push_str(&format!(
151                "{} health:bodyFatPercentage {} ;\n",
152                subj, body_fat
153            ));
154            out.push_str("    qudt:unit qudt-unit:Percent ;\n");
155            out.push_str("    schema:unitCode \"Percent\" .\n\n");
156        }
157        if let Some(muscle_mass) = rec.muscle_mass {
158            out.push_str(&format!("{} health:muscleMassKg {} ;\n", subj, muscle_mass));
159            out.push_str("    qudt:unit qudt-unit:Kilogram ;\n");
160            out.push_str("    schema:unitCode \"Kilogram\" .\n\n");
161        }
162        if let Some(body_water) = rec.body_water {
163            out.push_str(&format!(
164                "{} health:bodyWaterPercentage {} ;\n",
165                subj, body_water
166            ));
167            out.push_str("    qudt:unit qudt-unit:Percent ;\n");
168            out.push_str("    schema:unitCode \"Percent\" .\n\n");
169        }
170        if let Some(skeletal_muscle) = rec.skeletal_muscle {
171            out.push_str(&format!(
172                "{} health:skeletalMuscleMassKg {} ;\n",
173                subj, skeletal_muscle
174            ));
175            out.push_str("    qudt:unit qudt-unit:Kilogram ;\n");
176            out.push_str("    schema:unitCode \"Kilogram\" .\n\n");
177        }
178
179        // Add RDF-Star statement metadata
180        out.push_str(&format!(
181            "<< {} fhir:Observation.valueQuantity {} >> health:privacyMode \"MODE_B_PRIVILEGED\" ;\n\
182             \tprov:wasGeneratedBy <urn:wellfair:agent:health-to-solid> .\n\n",
183            subj, rec.weight
184        ));
185    }
186    out
187}
188
189/// Converts  to Turtle.
190pub fn sleep_to_turtle(records: &[SleepRecord]) -> String {
191    let mut out = generate_rdf_prefixes();
192    for rec in records {
193        let subj = format!("<urn:health:sleep:{}>", rec.uuid);
194        out.push_str(&format!("{} a fhir:Observation ;\n", subj));
195        out.push_str("    health:snomedConcept snomed:248263006 ;\n");
196        out.push_str("    schema:name \"Sleep session\" ;\n");
197        out.push_str("    prov:wasDerivedFrom <urn:health:source:samsung-health-export> ;\n");
198        out.push_str("    prov:wasGeneratedBy <urn:wellfair:agent:health-to-solid> ;\n");
199        out.push_str("    schema:description \"Samsung Health CSV export\" ;\n");
200        out.push_str(&format!(
201            "    fhir:Observation.effectivePeriod.start \"{}\"^^xsd:dateTime ;\n",
202            rec.start_datetime.to_rfc3339()
203        ));
204        out.push_str(&format!(
205            "    fhir:Observation.effectivePeriod.end \"{}\"^^xsd:dateTime ;\n",
206            rec.end_datetime.to_rfc3339()
207        ));
208        out.push_str(&format!(
209            "    fhir:Observation.valueQuantity \"PT{}M\"^^xsd:duration ;\n",
210            rec.sleep_duration as u64
211        ));
212        out.push_str("    qudt:unit qudt-unit:Minute ;\n");
213        out.push_str(&format!(
214            "    health:sleepHours {} ;\n",
215            rec.sleep_duration / 60.0
216        ));
217        out.push_str(&format!(
218            "    health:sleepEfficiency {} ;\n",
219            rec.efficiency
220        ));
221        out.push_str("    health:semanticReference fhir:Observation.valueQuantity .\n\n");
222
223        if let Some(deep) = rec.deep_sleep {
224            out.push_str(&format!("{} health:deepSleepMinutes {} ;\n", subj, deep));
225            out.push_str("    qudt:unit qudt-unit:Minute .\n\n");
226        }
227        if let Some(rem) = rec.rem_sleep {
228            out.push_str(&format!("{} health:remSleepMinutes {} ;\n", subj, rem));
229            out.push_str("    qudt:unit qudt-unit:Minute .\n\n");
230        }
231        if let Some(light) = rec.light_sleep {
232            out.push_str(&format!("{} health:lightSleepMinutes {} ;\n", subj, light));
233            out.push_str("    qudt:unit qudt-unit:Minute .\n\n");
234        }
235        if let Some(wuc) = rec.wake_up_count {
236            out.push_str(&format!("{} health:wakeUpCount {} .\n\n", subj, wuc));
237        }
238
239        // Add RDF-Star statement for sleep efficiency annotation
240        out.push_str(&format!(
241            "<< {} health:sleepEfficiency {} >> health:privacyMode \"MODE_B_PRIVILEGED\" ;\n\
242             \tprov:wasGeneratedBy <urn:wellfair:agent:health-to-solid> .\n\n",
243            subj, rec.efficiency
244        ));
245    }
246    out
247}
248
249/// Converts  to Turtle.
250pub fn heart_rate_to_turtle(records: &[HeartRateRecord]) -> String {
251    let mut out = generate_rdf_prefixes();
252    for rec in records {
253        let subj = format!("<urn:health:heart_rate:{}>", rec.uuid);
254        out.push_str(&format!("{} a fhir:Observation ;\n", subj));
255        out.push_str("    health:snomedConcept snomed:364075005 ;\n");
256        out.push_str("    health:loincConcept loinc:8867-4 ;\n");
257        out.push_str("    schema:name \"Heart rate\" ;\n");
258        out.push_str("    prov:wasDerivedFrom <urn:health:source:samsung-health-export> ;\n");
259        out.push_str("    prov:wasGeneratedBy <urn:wellfair:agent:health-to-solid> ;\n");
260        out.push_str("    schema:description \"Samsung Health CSV export\" ;\n");
261        out.push_str(&format!(
262            "    fhir:Observation.effectiveDateTime \"{}\"^^xsd:dateTime ;\n",
263            rec.start_datetime.to_rfc3339()
264        ));
265        out.push_str(&format!(
266            "    fhir:Observation.valueQuantity {} ;\n",
267            rec.heart_rate
268        ));
269        out.push_str("    qudt:unit qudt-unit:BeatsPerMinute ;\n");
270        out.push_str("    health:semanticReference fhir:Observation.valueQuantity , snomed:364075005 , loinc:8867-4 .\n\n");
271
272        if let Some(min) = rec.min {
273            out.push_str(&format!("{} health:minHeartRate {} ;\n", subj, min));
274            out.push_str("    qudt:unit qudt-unit:BeatsPerMinute .\n\n");
275        }
276        if let Some(max) = rec.max {
277            out.push_str(&format!("{} health:maxHeartRate {} ;\n", subj, max));
278            out.push_str("    qudt:unit qudt-unit:BeatsPerMinute .\n\n");
279        }
280        if let Some(ref zone) = rec.heart_rate_zone {
281            out.push_str(&format!("{} health:heartRateZone \"{}\" .\n\n", subj, zone));
282        }
283
284        // Add RDF-Star statement for heart rate annotation
285        out.push_str(&format!(
286            "<< {} fhir:Observation.valueQuantity {} >> health:privacyMode \"MODE_B_PRIVILEGED\" ;\n\
287             \tprov:wasGeneratedBy <urn:wellfair:agent:health-to-solid> .\n\n",
288            subj, rec.heart_rate
289        ));
290    }
291    out
292}
293
294/// Converts  to Turtle.
295pub fn steps_to_turtle(records: &[StepRecord]) -> String {
296    let mut out = generate_rdf_prefixes();
297    for rec in records {
298        let subj = format!("<urn:health:steps:{}>", rec.uuid);
299        out.push_str(&format!("{} a fhir:Observation ;\n", subj));
300        out.push_str("    health:snomedConcept snomed:256235009 ;\n");
301        out.push_str("    health:loincConcept loinc:55423-8 ;\n");
302        out.push_str("    schema:name \"Daily step count\" ;\n");
303        out.push_str("    prov:wasDerivedFrom <urn:health:source:samsung-health-export> ;\n");
304        out.push_str("    prov:wasGeneratedBy <urn:wellfair:agent:health-to-solid> ;\n");
305        out.push_str("    schema:description \"Samsung Health CSV export\" ;\n");
306        out.push_str(&format!(
307            "    fhir:Observation.effectivePeriod.start \"{}\"^^xsd:dateTime ;\n",
308            rec.start_datetime.to_rfc3339()
309        ));
310        out.push_str(&format!(
311            "    fhir:Observation.effectivePeriod.end \"{}\"^^xsd:dateTime ;\n",
312            rec.end_datetime.to_rfc3339()
313        ));
314        out.push_str(&format!(
315            "    fhir:Observation.valueQuantity {} ;\n",
316            rec.count
317        ));
318        out.push_str("    qudt:unit qudt-unit:Unitless ;\n");
319        out.push_str("    health:semanticReference fhir:Observation.valueQuantity .\n\n");
320
321        out.push_str(&format!(
322            "{} health:caloriesBurned {} ;\n",
323            subj, rec.calorie
324        ));
325        out.push_str("    qudt:unit qudt-unit:Kilocalorie .\n\n");
326
327        out.push_str(&format!("{} health:distance {} ;\n", subj, rec.distance));
328        out.push_str("    qudt:unit qudt-unit:Meter .\n\n");
329
330        // Add RDF-Star statement for step count annotation
331        out.push_str(&format!(
332            "<< {} fhir:Observation.valueQuantity {} >> health:privacyMode \"MODE_B_PRIVILEGED\" ;\n\
333             \tprov:wasGeneratedBy <urn:wellfair:agent:health-to-solid> .\n\n",
334            subj, rec.count
335        ));
336    }
337    out
338}