Feature/templatestudies Template studies support

app/lib/l10n/app_de.arb

@@ -18,6 +18,7 @@
   "test": "test10",
   "study_selection": "Studienauswahl",
   "study_selection_description": "Bitte wählen Sie eine Studie aus.",
+  "sub_study_selection_description": "Bitte wählen Sie eine Unterstudie aus.",
   "study_selection_single": "Sie können zu jeder Zeit maximal an einer Studie teilnehmen.",
   "study_selection_single_why": "Warum?",
   "study_selection_single_reason": "Wenn Sie zur selben Zeit an mehreren Studien teilnehmen würde, könnten die Kombination der Interventionen die Ergebnisse verfälschen.",

app/lib/l10n/app_en.arb

@@ -17,6 +17,7 @@
   "get_started": "Get started",
   "study_selection": "Study Selection",
   "study_selection_description": "Please select a study.",
+  "sub_study_selection_description": "Please select a sub-study.",
   "study_selection_single": "You can only participate in one study at a time.",
   "study_selection_single_why": "Why?",
   "study_selection_single_reason": "If you were to participate in multiple studies at a time, the interventions of these studies might interfere with one another and alter the results.",

app/lib/screens/study/onboarding/study_selection.dart

@@ -26,11 +26,22 @@ Future<void> navigateToStudyOverview(
   Navigator.pushNamed(context, Routes.studyOverview);
 }
 
+class StudySelectionScreenArgs {
+  final List<Study> subStudies;
+
+  StudySelectionScreenArgs({this.subStudies = const []});
+}
+
 class StudySelectionScreen extends StatelessWidget {
   const StudySelectionScreen({super.key});
 
   @override
   Widget build(BuildContext context) {
+    List<Study> subStudies = [];
+    final args = ModalRoute.of(context)!.settings.arguments;
+    if (args is StudySelectionScreenArgs) {
+      subStudies = args.subStudies;
+    }
     final theme = Theme.of(context);
     return Scaffold(
       body: SafeArea(
@@ -42,7 +53,9 @@ class StudySelectionScreen extends StatelessWidget {
                 child: Column(
                   children: [
                     Text(
-                      AppLocalizations.of(context)!.study_selection_description,
+                      subStudies.isEmpty
+                          ? AppLocalizations.of(context)!.study_selection_description
+                          : AppLocalizations.of(context)!.sub_study_selection_description,
                       style: theme.textTheme.headlineSmall,
                     ),
                     const SizedBox(height: 8),
@@ -76,17 +89,34 @@ class StudySelectionScreen extends StatelessWidget {
               ),
               Expanded(
                 child: RetryFutureBuilder<List<Study>>(
-                  tryFunction: () async => Study.publishedPublicStudies(),
+                  tryFunction: () async =>
+                      subStudies.isEmpty ? Study.publishedPublicStudies() : Future.value(subStudies),
                   successBuilder: (BuildContext context, List<Study>? studies) {
+                    // Filter out sub-studies and templates without sub studies
+                    final filteredStudies = subStudies.isEmpty
+                        ? studies!
+                            .where((study) =>
+                                !study.isSubStudy &&
+                                (!study.isTemplate || studies.any((s) => s.parentTemplateId == study.id)))
+                            .toList()
+                        : studies!;
+
                     return ListView.builder(
-                      itemCount: studies!.length,
+                      itemCount: filteredStudies.length,
                       itemBuilder: (context, index) {
+                        final study = filteredStudies[index];
                         return Hero(
-                          tag: 'study_tile_${studies[index].id}',
+                          tag: 'study_tile_${study.id}',
                           child: Material(
                             child: StudyTile.fromStudy(
-                              study: studies[index],
-                              onTap: () => navigateToStudyOverview(context, studies[index]),
+                              study: study,
+                              onTap: () => study.isTemplate
+                                  ? Navigator.pushNamed(context, Routes.studySelection,
+                                      arguments: StudySelectionScreenArgs(
+                                          subStudies: studies
+                                              .where((s) => s.isSubStudy && s.parentTemplateId == study.id)
+                                              .toList()))
+                                  : navigateToStudyOverview(context, study),
                             ),
                           ),
                         );

core/lib/src/models/tables/study.dart

@@ -2,6 +2,7 @@ import 'package:csv/csv.dart';
 import 'package:json_annotation/json_annotation.dart';
 import 'package:studyu_core/src/env/env.dart' as env;
 import 'package:studyu_core/src/models/models.dart';
+import 'package:studyu_core/src/models/template/template_configuration.dart';
 import 'package:studyu_core/src/util/supabase_object.dart';
 import 'package:supabase/supabase.dart';
 import 'package:uuid/uuid.dart';
@@ -34,6 +35,15 @@ enum ResultSharing {
   static ResultSharing fromJson(String json) => values.byName(json);
 }
 
+enum StudyType {
+  standalone,
+  template,
+  subStudy;
+
+  String toJson() => name;
+  static StudyType fromJson(String json) => values.byName(json);
+}
+
 @JsonSerializable()
 class Study extends SupabaseObjectFunctions<Study> implements Comparable<Study> {
   static const String tableName = 'study';
@@ -43,6 +53,10 @@ class Study extends SupabaseObjectFunctions<Study> implements Comparable<Study>
 
   static const String baselineID = '__baseline';
   String id;
+  @JsonKey(name: 'parent_template_id')
+  String? parentTemplateId;
+  @JsonKey(name: 'template_configuration')
+  TemplateConfiguration? templateConfiguration;
   String? title;
   String? description;
   @JsonKey(name: 'user_id')
@@ -68,7 +82,6 @@ class Study extends SupabaseObjectFunctions<Study> implements Comparable<Study>
   late List<String> collaboratorEmails = [];
   @JsonKey(name: 'registry_published')
   late bool registryPublished = false;
-
   @JsonKey(includeToJson: false, includeFromJson: false)
   int participantCount = 0;
   @JsonKey(includeToJson: false, includeFromJson: false)
@@ -95,10 +108,14 @@ class Study extends SupabaseObjectFunctions<Study> implements Comparable<Study>
 
   Study(this.id, this.userId);
 
-  Study.withId(this.userId) : id = const Uuid().v4();
+  Study.create(this.userId) : id = const Uuid().v4();
 
   factory Study.fromJson(Map<String, dynamic> json) {
-    final study = _$StudyFromJson(json);
+    final parentTemplateId = json['parent_template_id'] as String?;
+    final templateConfiguration = json['template_configuration'];
+    final study = parentTemplateId != null
+        ? _$TemplateSubStudyFromJson(json)
+        : (templateConfiguration != null ? _$TemplateFromJson(json) : _$StudyFromJson(json));
 
     final List? repo = json['repo'] as List?;
     if (repo != null && repo.isNotEmpty) {
@@ -177,6 +194,20 @@ class Study extends SupabaseObjectFunctions<Study> implements Comparable<Study>
     }
   }
 
+  StudyType get type {
+    if (parentTemplateId != null) {
+      return StudyType.subStudy;
+    }
+    if (templateConfiguration != null) {
+      return StudyType.template;
+    }
+    return StudyType.standalone;
+  }
+
+  bool get isStandalone => type == StudyType.standalone;
+  bool get isTemplate => type == StudyType.template;
+  bool get isSubStudy => type == StudyType.subStudy;
+
   bool isOwner(User? user) => user != null && userId == user.id;
 
   bool isEditor(User? user) => user != null && collaboratorEmails.contains(user.email);
@@ -252,3 +283,39 @@ class Study extends SupabaseObjectFunctions<Study> implements Comparable<Study>
     return id.compareTo(other.id);
   }
 }
+
+@JsonSerializable()
+class Template extends Study {
+  Template(super.id, super.userId);
+
+  Template.create(String userId) : super(const Uuid().v4(), userId) {
+    templateConfiguration = TemplateConfiguration();
+  }
+}
+
+@JsonSerializable()
+class TemplateSubStudy extends Study {
+  TemplateSubStudy(super.id, super.userId);
+
+  TemplateSubStudy.create(String userId, Template template) : super(const Uuid().v4(), userId) {
+    if (template.templateConfiguration == null) {
+      throw ArgumentError('Template must have a templateConfiguration');
+    }
+    parentTemplateId = template.id;
+    templateConfiguration =
+        template.templateConfiguration!.copyWith(title: template.title, description: template.description);
+    participation = template.participation;
+    resultSharing = template.resultSharing;
+    contact = template.contact;
+    iconName = template.iconName;
+    questionnaire = template.questionnaire;
+    eligibilityCriteria = template.eligibilityCriteria;
+    consent = template.consent;
+    interventions = template.interventions;
+    observations = template.observations;
+    schedule = template.schedule;
+    reportSpecification = template.reportSpecification;
+    collaboratorEmails = template.collaboratorEmails;
+    registryPublished = template.registryPublished;
+  }
+}