Uploading informed consent as participant data + docs update

lib/blocs/sensing.dart

@@ -20,7 +20,7 @@ part of carp_study_app;
 /// added to the [client].
 class Sensing {
   static final Sensing _instance = Sensing._();
-  StudyDeploymentStatus? _status;
+  // StudyDeploymentStatus? _status;
   SmartphoneDeploymentController? _controller;
   DeploymentService? deploymentService;
   Study? _study;
@@ -34,7 +34,7 @@ class Sensing {
   SmartphoneDeployment? get deployment => _controller?.deployment;
 
   /// The latest status of the study deployment.
-  StudyDeploymentStatus? get status => _status;
+  StudyDeploymentStatus? get status => _controller?.deploymentStatus;
 
   /// The role name of this device in the deployed study.
   String? get deviceRoleName => _study?.deviceRoleName;
@@ -113,15 +113,16 @@ class Sensing {
 
         // Deploy this protocol using the on-phone deployment service.
         // Reuse the study deployment id, if this is stored on the phone.
-        _status = await SmartphoneDeploymentService().createStudyDeployment(
+        final status =
+            await SmartphoneDeploymentService().createStudyDeployment(
           protocol!,
           [],
           bloc.studyDeploymentId,
         );
 
         // Save the correct deployment id on the phone for later use.
-        bloc.studyDeploymentId = _status?.studyDeploymentId;
-        bloc.deviceRoleName = _status?.primaryDeviceStatus?.device.roleName;
+        bloc.studyDeploymentId = status.studyDeploymentId;
+        bloc.deviceRoleName = status.primaryDeviceStatus?.device.roleName;
 
         break;
       case DeploymentMode.production:

lib/data/carp_backend.dart

@@ -143,6 +143,9 @@ class CarpBackend {
     // have a smartphone as a device in [ActiveParticipationInvitation.assignedDevices] list
     // (i.e. the invitation is for a smartphone).
     // This is done to avoid showing invitations for other devices (e.g. [WebBrowser]).
+    //
+    // TODO: Do we need to remove invitations which are not for this user?
+    //  - see https://github.com/cph-cachet/carp.core-kotlin/issues/482
     invitations.removeWhere((invitation) =>
         invitation.assignedDevices
             ?.any((device) => device.device is! Smartphone) ??
@@ -152,11 +155,18 @@ class CarpBackend {
   }
 
   /// Upload the result of an informed consent flow. Returns the uploaded
-  /// consent document as retrieved from the server.
+  /// consent document.
   ///
   /// Looks for the first instance of a [RPConsentSignatureResult] in [consent]
   /// and uploads this.
-  Future<ConsentDocument?> uploadInformedConsent(RPTaskResult consent) async {
+  Future<InformedConsentInput?> uploadInformedConsent(
+    RPTaskResult consent,
+  ) async {
+    if (user == null) {
+      warning('$runtimeType - No user authenticated.');
+      return null;
+    }
+
     late RPConsentSignatureResult signedConsent;
     try {
       signedConsent = consent.results.values.firstWhere(
@@ -169,10 +179,23 @@ class CarpBackend {
     }
 
     signedConsent.userID = username;
-    Map<String, dynamic> json = signedConsent.toJson();
+    final json = toJsonString(signedConsent.toJson());
+
+    final uploadedConsent = InformedConsentInput(
+      userId: user!.id,
+      name: user!.username,
+      consent: json,
+      signatureImage: signedConsent.signature?.signatureImage ?? '',
+    );
 
-    ConsentDocument? uploadedConsent;
     try {
+      final participation = CarpParticipationService().participation();
+
+      final data = await participation.setParticipantData(
+        {InformedConsentInput.type: uploadedConsent},
+        father,
+      );
+
       uploadedConsent = await CarpService().createConsentDocument(json);
       info(
           '$runtimeType - Informed consent document uploaded successfully - id: ${uploadedConsent.id}');

lib/data/local_settings.dart

@@ -1,7 +1,8 @@
 part of carp_study_app;
 
-/// A local settings manager. Works as a singleton - use `LocalSettings()`
-/// for accessing settings.
+/// A local settings manager.
+///
+/// Works as a singleton - use `LocalSettings()` for accessing settings.
 class LocalSettings {
   // Keys for storing in shared preferences
   static const String studyIdKey = 'study_id';
@@ -75,7 +76,7 @@ class LocalSettings {
   set deviceRoleName(String? name) {
     assert(
         name != null,
-        'Cannot set the study deployment id to null in Settings. '
+        'Cannot set the device role name id to null in Settings. '
         "Use the 'eraseStudyDeployment()' method to erase study deployment information.");
     _deviceRoleName = name;
     Settings().preferences?.setString(deviceRoleNameKey, name!);