Heart Health Dashboard (#9)

# Heart Health Dashboard

## ♻️ Current situation & Problem
closes #4


## ⚙️ Release Notes
- adds an initial version of the Heart Health Dashboard


## 📚 Documentation
n/a

## ✅ Testing
n/a

### Code of Conduct & Contributing Guidelines
By creating and submitting this pull request, you agree to follow our
[Code of
Conduct](https://github.com/StanfordBDHG/.github/blob/main/CODE_OF_CONDUCT.md)
and [Contributing
Guidelines](https://github.com/StanfordBDHG/.github/blob/main/CONTRIBUTING.md):
- [x] I agree to follow the [Code of
Conduct](https://github.com/StanfordBDHG/.github/blob/main/CODE_OF_CONDUCT.md)
and [Contributing
Guidelines](https://github.com/StanfordBDHG/.github/blob/main/CONTRIBUTING.md).

Author: lukaskollmer

.swiftlint.yml

@@ -426,6 +426,7 @@ line_length: # Lines should not span too many characters.
   ignores_urls: true # default: false
   ignores_function_declarations: false # default: false
   ignores_interpolated_strings: true # default: false
+  ignores_multiline_strings: true # default: false
 
 nesting: # Types should be nested at most 2 level deep, and functions should be nested at most 5 levels deep.
   type_level:

MyHeartCounts.xcodeproj/project.pbxproj

@@ -114,7 +114,7 @@
          </CommandLineArgument>
          <CommandLineArgument
             argument = "--overrideFirebaseConfig plist=GoogleService-Info-Override"
-            isEnabled = "NO">
+            isEnabled = "YES">
          </CommandLineArgument>
          <CommandLineArgument
             argument = "--dump-cli-options-and-exit"
@@ -127,10 +127,15 @@
             value = "YES"
             isEnabled = "YES">
          </EnvironmentVariable>
+         <EnvironmentVariable
+            key = "IDELogRedirectionPolicy"
+            value = "oslogToStdio"
+            isEnabled = "NO">
+         </EnvironmentVariable>
       </EnvironmentVariables>
    </LaunchAction>
    <ProfileAction
-      buildConfiguration = "Release"
+      buildConfiguration = "Debug"
       shouldUseLaunchSchemeArgsEnv = "YES"
       savedToolIdentifier = ""
       useCustomWorkingDirectory = "NO"

MyHeartCounts.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved

@@ -10,7 +10,6 @@
 import SpeziAccount
 import SpeziLicense
 import SpeziStudy
-import SwiftData
 import SwiftUI
 
 

MyHeartCounts.xcodeproj/xcshareddata/xcschemes/MyHeartCounts.xcscheme

@@ -17,7 +17,7 @@ extension TimedWalkingTestResult {
         withMapping: HealthKitOnFHIR.HKSampleMapping,
         issuedDate: ModelsR4.FHIRPrimitive<ModelsR4.Instant>?
     ) throws -> ModelsR4.ResourceProxy {
-        try .observation(fhirObservation(issuedDate: issuedDate))
+        .observation(try fhirObservation(issuedDate: issuedDate))
     }
 
 
@@ -72,7 +72,7 @@ extension TimedWalkingTestResult {
     }
 }
 
-private func builObservationComponent(code: String, system: String, unit: String, value: Double) -> ObservationComponent {
+func builObservationComponent(code: String, system: String, unit: String, value: Double) -> ObservationComponent {
     ObservationComponent(
         code: CodeableConcept(coding: [Coding(code: code.asFHIRStringPrimitive(), system: system.asFHIRURIPrimitive())]),
         value: .quantity(.init(

MyHeartCounts/Account/AccountSheet.swift

@@ -24,7 +24,7 @@ struct HistoricalSamplesToFHIRJSONProcessor: BatchProcessor {
 
     private func storeSamples<Sample>(_ samples: consuming [Sample], of sampleType: SampleType<Sample>) throws -> URL {
         let fileManager = FileManager.default
-        let resources = try samples.mapIntoResourceProxies()
+        let resources = try samples.mapIntoResourceProxies(extensions: [.includeAbsoluteTimeRange])
         _ = consume samples
         let encoded = try JSONEncoder().encode(resources)
         _ = consume resources

MyHeartCounts/Active Tasks/TimedWalkingTestResult+FHIR.swift

@@ -17,14 +17,21 @@ protocol HealthObservation {
     var id: UUID { get }
     var sampleTypeIdentifier: String { get }
 
-    func resource(withMapping: HKSampleMapping, issuedDate: FHIRPrimitive<Instant>?) throws -> ResourceProxy
+    func resource(
+        withMapping mapping: HKSampleMapping,
+        issuedDate: FHIRPrimitive<Instant>?
+    ) throws -> ResourceProxy
 }
 
 
 extension HKSample: HealthObservation {
     var sampleTypeIdentifier: String {
         sampleType.identifier
     }
+    
+    func resource(withMapping mapping: HKSampleMapping, issuedDate: FHIRPrimitive<Instant>?) throws -> ResourceProxy {
+        try resource(withMapping: mapping, issuedDate: issuedDate, extensions: [])
+    }
 }
 
 

MyHeartCounts/Health Import/HistoricalSamplesToFHIRJSONProcessor.swift

@@ -0,0 +1,63 @@
+//
+// This source file is part of the My Heart Counts iOS application based on the Stanford Spezi Template Application project
+//
+// SPDX-FileCopyrightText: 2025 Stanford University
+//
+// SPDX-License-Identifier: MIT
+//
+
+import Foundation
+import HealthKit
+
+
+struct Achievement: Hashable, Codable, Sendable {
+    enum Goal: Hashable, Codable, Sendable {
+        enum ReachLevelTarget: Hashable, Codable, Sendable { // swiftlint:disable:this type_contents_order
+            case absolute(Double)
+            case newMaximum
+        }
+        case reachLevel(ReachLevelTarget)
+        case maintainLevel
+    }
+    
+    let title: String
+    let goal: Goal
+    
+    init(title: String, goal: Goal) {
+        self.title = title
+        self.goal = goal
+    }
+}
+
+
+extension Achievement {
+    enum ResolvedGoal: Hashable, Sendable {
+        /// The goal is achieved by reaching (or surpassing) a specified quantity.
+        /// - parameter quantity: The target quantity
+        /// - parameter invert: Whether the goal should be inverted;
+        ///     i.e., whether it should be considered achieved if an actual value is below, rather than above, the quantity.
+        /// - parameter baselineQuantity: The quantity we take as the baseline with calculating progress. For non-inverted goals, this should be zero.
+        case reachOrSurpass(_ quantity: HKQuantity, invert: Bool = false, baselineQuantity: HKQuantity)
+        
+        static func reachOrSurpass(_ quantity: HKQuantity, unit: HKUnit) -> Self {
+            .reachOrSurpass(quantity, invert: false, baselineQuantity: HKQuantity(unit: unit, doubleValue: 0))
+        }
+        
+        /// Evaluates a concrete value against the goal's value.
+        ///
+        /// - returns: A `Double` value, indicating how close the `measuredValue` is to the goal's value
+        func evaluate(_ measuredQuantity: HKQuantity, unit: HKUnit) -> Double {
+            switch self {
+            case let .reachOrSurpass(targetQuantity, invert, baselineQuantity):
+                let measuredValue = measuredQuantity.doubleValue(for: unit)
+                let targetValue = targetQuantity.doubleValue(for: unit)
+                if !invert {
+                    return measuredValue / targetValue
+                } else {
+                    let baselineValue = baselineQuantity.doubleValue(for: unit)
+                    return baselineValue.distance(to: measuredValue) / baselineValue.distance(to: targetValue)
+                }
+            }
+        }
+    }
+}