feat: template trials

.github/workflows/firebase-hosting-merge-dev.yml

@@ -16,6 +16,7 @@ on:
       - 'melos.yaml'
       - 'firebase.json'
       - '.firebaserc'
+  workflow_dispatch:
 
 concurrency:
   group: ${{ github.ref }}-merge-dev

app/lib/l10n/app_de.arb

@@ -17,10 +17,11 @@
   "get_started": "Los geht's",
   "test": "test10",
   "study_selection": "Studienauswahl",
-  "study_selection_description": "Bitte wählen Sie eine Studie aus.",
-  "study_selection_single": "Sie können zu jeder Zeit maximal an einer Studie teilnehmen.",
+  "study_selection_description": "Bitte wählen Sie ein Trial aus",
+  "sub_study_selection_description": "Bitte wählen Sie ein Subtrial aus",
+  "study_selection_single": "Sie können zu jeder Zeit maximal an einem Trial 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.",
+  "study_selection_single_reason": "Wenn Sie zur selben Zeit an mehreren Trials teilnehmen würde, könnten die Kombination der Interventionen die Ergebnisse verfälschen.",
   "study_selection_unsupported_title": "Veraltete App-Version",
   "study_selection_unsupported": "Die Studie, an der Sie teilnehmen möchten, ist nicht mit Ihrer App-Version kompatibel. Bitte aktualisieren Sie die App auf die neueste Version.",
   "study_selection_closed_title": "Studie geschlossen",
@@ -37,6 +38,10 @@
   "task_cannot_be_completed": "Die Aufgabe kann nicht bearbeitet werden",
   "study_notification_body": "Eine neue Aufgabe benötigt Ihre Aufmerksamkeit",
 
+  "selected_template_trial": "Ausgewählter Template Trial",
+  "title": "Titel",
+  "description": "Beschreibung",
+
   "intervention_phase_duration": "Länge der Interventionphasen",
   "days": "Tage",
   "study_length": "Studienlänge",

app/lib/l10n/app_en.arb

@@ -16,10 +16,11 @@
 
   "get_started": "Get started",
   "study_selection": "Study Selection",
-  "study_selection_description": "Please select a study.",
-  "study_selection_single": "You can only participate in one study at a time.",
+  "study_selection_description": "Please select a Trial",
+  "sub_study_selection_description": "Please select a Subtrial",
+  "study_selection_single": "You can only participate in one Trial 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.",
+  "study_selection_single_reason": "If you were to participate in multiple Trials at a time, the interventions of these Trials might interfere with one another and alter the results.",
   "study_selection_unsupported_title": "Outdated app version",
   "study_selection_unsupported": "The study you are trying to join is not compatible with your app version. Please update the app to the latest version.",
   "study_selection_closed_title": "Study closed",
@@ -34,6 +35,10 @@
   "no_interventions_available": "No interventions available.",
   "loading_interventions": "Loading interventions",
 
+  "selected_template_trial": "Selected Template Trial",
+  "title": "Title",
+  "description": "Description",
+
   "task_cannot_be_completed": "The task cannot be completed",
   "study_notification_body": "A new task awaits your attention",
 

app/lib/screens/app_onboarding/loading_screen.dart

@@ -81,7 +81,7 @@ class _LoadingScreenState extends State<LoadingScreen> {
         }
       } catch (exception) {
         debugPrint(
-            "Could not login and retrieve the study subject: $exception");
+            "Could not login and retrieve the study subject: $exception",);
         if (exception is SocketException) {
           subject = await Cache.loadSubject();
           StudyULogger.info("Offline mode with cached subject: $subject");

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

@@ -38,7 +38,14 @@ class _KickoffScreen extends State<KickoffScreen> {
         (_) => false,
       );
     } catch (e) {
+      ScaffoldMessenger.of(context).showSnackBar(
+        SnackBar(
+          content: Text(AppLocalizations.of(context)!.error),
+          duration: const Duration(seconds: 30),
+        ),
+      );
       StudyULogger.fatal('Failed creating subject: $e');
+      Navigator.pushNamedAndRemoveUntil(context, Routes.welcome, (_) => false);
     }
   }
 

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

@@ -58,6 +58,13 @@ Future<void> showStudyClosedDialog(BuildContext context) async {
   );
 }
 
+class StudySelectionScreenArgs {
+  final Template? template;
+  final List<TemplateSubStudy> subStudies;
+
+  StudySelectionScreenArgs({this.template, this.subStudies = const []});
+}
+
 class StudySelectionScreen extends StatefulWidget {
   const StudySelectionScreen({super.key});
 
@@ -71,7 +78,15 @@ class _StudySelectionScreenState extends State<StudySelectionScreen> {
 
   @override
   Widget build(BuildContext context) {
+    List<Study> subStudies = [];
+    Template? template;
+    final args = ModalRoute.of(context)!.settings.arguments;
+    if (args is StudySelectionScreenArgs) {
+      subStudies = args.subStudies;
+      template = args.template;
+    }
     final theme = Theme.of(context);
+    final loc = AppLocalizations.of(context)!;
     return Scaffold(
       body: SafeArea(
         child: Center(
@@ -82,34 +97,33 @@ class _StudySelectionScreenState extends State<StudySelectionScreen> {
                 child: Column(
                   children: [
                     Text(
-                      AppLocalizations.of(context)!.study_selection_description,
+                      subStudies.isEmpty
+                          ? loc.study_selection_description
+                          : loc.sub_study_selection_description,
                       style: theme.textTheme.headlineSmall,
                     ),
                     const SizedBox(height: 8),
                     RichText(
                       text: TextSpan(
                         children: [
                           TextSpan(
-                            text: AppLocalizations.of(context)!
-                                .study_selection_single,
+                            text: loc.study_selection_single,
                             style: theme.textTheme.titleSmall,
                           ),
                           TextSpan(
                             text: ' ',
                             style: theme.textTheme.titleSmall,
                           ),
                           TextSpan(
-                            text: AppLocalizations.of(context)!
-                                .study_selection_single_why,
+                            text: loc.study_selection_single_why,
                             style: theme.textTheme.titleSmall!
                                 .copyWith(color: theme.primaryColor),
                             recognizer: TapGestureRecognizer()
                               ..onTap = () => showDialog(
                                     context: context,
                                     builder: (context) => AlertDialog(
                                       content: Text(
-                                        AppLocalizations.of(context)!
-                                            .study_selection_single_reason,
+                                        loc.study_selection_single_reason,
                                       ),
                                     ),
                                   ),
@@ -120,7 +134,7 @@ class _StudySelectionScreenState extends State<StudySelectionScreen> {
                   ],
                 ),
               ),
-              if (_hiddenStudies)
+              if (_hiddenStudies && template == null)
                 Column(
                   children: [
                     MaterialBanner(
@@ -143,9 +157,59 @@ class _StudySelectionScreenState extends State<StudySelectionScreen> {
                 )
               else
                 const SizedBox.shrink(),
+              if (template != null)
+                Container(
+                  padding: const EdgeInsets.all(20),
+                  decoration: BoxDecoration(
+                    color: theme.colorScheme.primary.withOpacity(0.1),
+                    borderRadius: BorderRadius.circular(8),
+                  ),
+                  child: Column(
+                    mainAxisSize: MainAxisSize.min,
+                    crossAxisAlignment: CrossAxisAlignment.start,
+                    children: [
+                      Text(
+                        loc.selected_template_trial,
+                        style: theme.textTheme.titleMedium,
+                      ),
+                      const SizedBox(height: 8),
+                      Text.rich(
+                        TextSpan(
+                          children: [
+                            TextSpan(
+                              text: "${loc.title}: ",
+                              style: theme.textTheme.titleSmall,
+                            ),
+                            TextSpan(
+                              text: template.title,
+                            ),
+                          ],
+                        ),
+                      ),
+                      const SizedBox(height: 2),
+                      Text.rich(
+                        TextSpan(
+                          children: [
+                            TextSpan(
+                              text: "${loc.description}: ",
+                              style: theme.textTheme.titleSmall,
+                            ),
+                            TextSpan(
+                              text: template.description,
+                            ),
+                          ],
+                        ),
+                      ),
+                    ],
+                  ),
+                )
+              else
+                const SizedBox.shrink(),
               Expanded(
                 child: RetryFutureBuilder<ExtractionResult<Study>>(
-                  tryFunction: () async => publishedStudies,
+                  tryFunction: () async => subStudies.isEmpty
+                      ? publishedStudies
+                      : Future.value(ExtractionSuccess(subStudies)),
                   successBuilder: (
                     BuildContext context,
                     ExtractionResult<Study>? extractionResult,
@@ -162,18 +226,50 @@ class _StudySelectionScreenState extends State<StudySelectionScreen> {
                         });
                       });
                     }
+                    // 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 = studies[index];
+                        final study = filteredStudies[index];
+                        final numSubtrials = studies
+                            .where((s) => s.parentTemplateId == study.id)
+                            .length;
                         return Hero(
-                          tag: 'study_tile_${studies[index].id}',
+                          tag: 'study_tile_${study.id}',
                           child: Material(
                             child: StudyTile.fromStudy(
                               study: study,
-                              onTap: () async {
-                                await navigateToStudyOverview(context, study);
-                              },
+                              numSubtrials: numSubtrials,
+                              onTap: () => study is Template
+                                  ? Navigator.pushNamed(
+                                      context,
+                                      Routes.studySelection,
+                                      arguments: StudySelectionScreenArgs(
+                                        template: study,
+                                        subStudies: studies
+                                            .where(
+                                              (s) =>
+                                                  s is TemplateSubStudy &&
+                                                  s.parentTemplateId ==
+                                                      study.id,
+                                            )
+                                            .map((s) => s as TemplateSubStudy)
+                                            .toList(),
+                                      ),
+                                    )
+                                  : navigateToStudyOverview(context, study),
                             ),
                           ),
                         );

app/lib/screens/study/report/general_details_section.dart

@@ -9,6 +9,7 @@ class GeneralDetailsSection extends GenericSection {
   Widget buildContent(BuildContext context) => Column(
         children: [
           StudyTile(
+            studyType: subject!.study.type,
             title: subject!.study.title,
             description: subject!.study.description,
             iconName: subject!.study.iconName,

app/lib/widgets/study_tile.dart

@@ -3,17 +3,21 @@ import 'package:material_design_icons_flutter/material_design_icons_flutter.dart
 import 'package:studyu_core/core.dart';
 
 class StudyTile extends StatelessWidget {
+  final StudyType studyType;
   final String? title;
   final String? description;
+  final int numSubtrials;
   final String iconName;
 
   final Future<void> Function()? onTap;
 
   final EdgeInsetsGeometry contentPadding;
 
   const StudyTile({
+    required this.studyType,
     required this.title,
     required this.description,
+    this.numSubtrials = 0,
     required this.iconName,
     this.onTap,
     this.contentPadding = const EdgeInsets.all(16),
@@ -22,19 +26,23 @@ class StudyTile extends StatelessWidget {
 
   StudyTile.fromStudy({
     required Study study,
+    this.numSubtrials = 0,
     this.onTap,
     this.contentPadding = const EdgeInsets.all(16),
     super.key,
-  })  : title = study.title,
+  })  : studyType = study.type,
+        title = study.title,
         description = study.description,
         iconName = study.iconName;
 
   StudyTile.fromUserStudy({
     required StudySubject subject,
+    this.numSubtrials = 0,
     this.onTap,
     this.contentPadding = const EdgeInsets.all(16),
     super.key,
-  })  : title = subject.study.title,
+  })  : studyType = subject.study.type,
+        title = subject.study.title,
         description = subject.study.description,
         iconName = subject.study.iconName;
 
@@ -55,7 +63,13 @@ class StudyTile extends StatelessWidget {
             ),
           ),
           subtitle: Center(child: Text(description ?? '')),
-          leading:
+          leading: numSubtrials > 0
+              ? CircleAvatar(
+                  backgroundColor: theme.primaryColor.withOpacity(0.1),
+                  child: Text(numSubtrials.toString()),
+                )
+              : const SizedBox.shrink(),
+          trailing:
               Icon(MdiIcons.fromString(iconName), color: theme.primaryColor),
         ),
       ],