Study preview mode

[smeddinck]

make it possible to preview a study without affecting the planned study start … data will be deleted when study is properly started … alternatively e.g. after X days ... tokens will be renewed upon starting study if already used during preview ... allow for maximum editing abilities during preview ...

Has a frontend component (button to start + popup dialogue with information and warnings) as well ...

[andresgruber]

@smeddinck : This needs further refinement!

[smeddinck]

Ideally can define time point at which the preview begins (can start at a virtual timepoint in study period) ...

[ja-fra]

In today's refinement session, we agreed to split this issue into three steps (issues):

1. Simple Preview-Mode: Starting a Study in preview will run the study with the option to return into the edit-mode. On re-entering the edit mode, all recorded data is deleted and registration-token are reset (re-generated).

2. Point-in-Time Preview: The first enhancement of the preview mode shall allow to specify an (optional) "time-offset" within the study, allowing to "fast-forward" the study execution (without collection any data, ...). This offset is specified when starting the preview and cannot be changed (unless you run a second preview) --> see "Point-in-Time" Preview Mode for Studies #241

3. Fast-Forward Preview: Like the Point-in-Time Preview with the additional option to change the offset while running the preview. It's yet to decide whether it will be also possible to move "back in time" (reduce the offset) --> see Allow Time-Shift during Study Preview #242

Since options 2 and 3 also require significant changes in other systems (data-gateway and app) we agreed to postpone those enhancements for now.

[ja-fra]

@smeddinck - this would be our suggested change to the study-workflow in More:

---
title: MORE Study Workflow (with Preview Mode)
---
flowchart TD
classDef default stroke-width:2px,fill:none,color:#6e8fac,stroke:#6e8fac
classDef endNode stroke-width:4px
classDef newNode fill:#ebcca2

linkStyle default stroke:#6e8fac,text:none

    start((( )))
    draft(Draft)
    active(Active)
    paused(Paused)
    completed(Completed):::endNode

    preview(Preview):::newNode
    preview-paused(Paused Preview):::newNode

    start -->|create| draft
    draft --->|start| active
    active --->|complete| completed
    active -->|pause| paused
    paused -->|resume| active

    draft -->|start preview| preview
    preview -->|complete preview| draft
    preview -->|pause preview| preview-paused
    preview-paused -->|resume preview| preview

Loading

We would reset the study/cleanup the data on the complete preview transition.

[smeddinck]

yes, this seems fully in-line with how we thought about this and discussed; thank you for spelling it out so clearly

[smeddinck]

accidentally closed but prior comment was just to confirm the approach

[alireza-dhp]

When a study is paused in preview mode, adding or editing records on participant, observation, integration and intervention tabs are not possible!