{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Note: I’ve combined some design documents into one document (this document), with the exception of assessments, scheduling, and consent (all three are separable from these core models). ","type":"text"}]},{"type":"paragraph","content":[{"text":"The Evolution of the Bridge System","type":"text","marks":[{"type":"link","attrs":{"href":"https://developer.sagebridge.org/articles/evolution_of_the_bridge_system.html"}}]},{"text":" is a public facing document which breaks our APIs down into the science and mobile app development domains. It will describe our plans to change the system for our partners, as these become clearer. Eventually this implementation documentation will be used to rewrite the more general domain design document as part of our documentation website.","type":"text"}]},{"type":"paragraph"},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"_parentId":{"value":"886440163"}},"macroMetadata":{"macroId":{"value":"24f05c1f-5c63-4eb9-9ee5-cad3335d9d96"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"acd8fe11-0211-4764-aba7-408bbe614f25"}},{"type":"paragraph","content":[{"text":"This document is in the order that I propose to implement features.","type":"text"}]},{"type":"paragraph","content":[{"text":"Some notes about changes:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Going to eliminate “/self” endpoints from most of these API proposals. They add a lot of noise and our authorization checks are getting more complicated anyway, and should be hidden from the API. I’ve also made mistakes over the years in writing integration tests, that would be eliminated if these didn’t exist. They do still need to exist for participant-facing APIs where we don’t expect the client to track the user’s identity. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"We are discussing whether data should be exported “by study” or “by organization.” There are pros and cons to each…Dwayne will make a decision about this.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"APIs","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":811,"id":"ff07de08-ab6d-4adb-ae9f-114a2295f10a","collection":"contentId-886440163","type":"file","height":427}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Apps","type":"text"}]},{"type":"paragraph","content":[{"text":"The refactored study object now represents an app as a whole, with some fields migrating to the new ","type":"text"},{"text":"Study","type":"text","marks":[{"type":"code"}]},{"text":" object. Account, authentication, upload, and export configurations are still shared between studies and cannot be different between studies (templates might be an exception, where we add study-specific overrides if they are needed). Note that the export system is currently being revised, and we have not decided on how access to data will be managed by Synapse. Bridge’s responsibility is to ensure uploads have all possible metadata that is needed for analysis and management.","type":"text"}]},{"type":"paragraph","content":[{"text":"Apps are still a fundamental tenancy model for our system… no calls should ever operate on models outside of the caller’s app scope (unless the caller is a worker).","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Organizations","type":"text"}]},{"type":"paragraph","content":[{"text":"Organizations will be added to the data model. Administrative accounts will be removed from the ","type":"text"},{"text":"AccountsSubstudies","type":"text","marks":[{"type":"code"}]},{"text":" table and associated to ","type":"text"},{"text":"Organizations","type":"text","marks":[{"type":"code"}]},{"text":" through a foreign key column on ","type":"text"},{"text":"Accounts","type":"text","marks":[{"type":"code"}]},{"text":". There are about ~160 of these administrative accounts in production. This change will be visible to legacy studies.","type":"text"}]},{"type":"paragraph","content":[{"text":"A study can be associated to one or more organizations through a ","type":"text"},{"text":"Sponsors","type":"text","marks":[{"type":"code"}]},{"text":" table (see below). An administrative user is associated to the studies that are associated to their organization. ","type":"text"},{"text":"With ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"e7a70f0f-4a7a-473a-89ad-b9e22ccb7d7f"}}]},{"text":"Substudy","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"e7a70f0f-4a7a-473a-89ad-b9e22ccb7d7f"}},{"type":"code"}]},{"text":" refactored to be ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"e7a70f0f-4a7a-473a-89ad-b9e22ccb7d7f"}}]},{"text":"Study","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"e7a70f0f-4a7a-473a-89ad-b9e22ccb7d7f"}},{"type":"code"}]},{"text":", we can continue to filter accounts the same way we do now (by matching the studies accessible to the caller with the studies a participant is enrolled in). These studies will be stored in the administrative user’s session so they do not need to be resolved with every server request.","type":"text"}]},{"type":"paragraph","content":[{"text":"The legacy exporter will continue to export data to the Synapse project configured in the App object, and export substudy memberships. The next version of the exporter will export data to Synapse based on the configuration in an organization or in a study (TBD). If the export is “by organization,” we will need to continue to export the (sub)study associations. If we export “by study,” we do not need to export information about the organizations that own the studies, as we’d need to enforce the access rules (by organization) in Synapse. The study association is important to audit consent later (that is, “for this piece of data, under what consent from the user was it uploaded?” which requires the source study to answer).","type":"text"}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[82.0]},"content":[{"type":"paragraph","content":[{"text":"Method","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"Path","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[269.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[156.0]},"content":[{"type":"paragraph","content":[{"text":"Access","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[82.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"/v1/organizations","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[269.0]},"content":[{"type":"paragraph","content":[{"text":"list organizations associated with an app","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[156.0]},"content":[{"type":"paragraph","content":[{"text":"All admin users","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[82.0]},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"/v1/organizations","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[269.0]},"content":[{"type":"paragraph","content":[{"text":"Create a new organization","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[156.0]},"content":[{"type":"paragraph","content":[{"text":"app admins","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[82.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"/v1/organizations/{guid}","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[269.0]},"content":[{"type":"paragraph","content":[{"text":"Get a specific organization","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[156.0]},"content":[{"type":"paragraph","content":[{"text":"All admin users","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[82.0]},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"/v1/organizations/{guid}","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[269.0]},"content":[{"type":"paragraph","content":[{"text":"Update a specific organization","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[156.0]},"content":[{"type":"paragraph","content":[{"text":"app admins","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[82.0]},"content":[{"type":"paragraph","content":[{"text":"DELETE","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"/v1/organizations/{guid}","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[269.0]},"content":[{"type":"paragraph","content":[{"text":"Delete an organization (logically or physically). Can’t leave a study without at least one associated organization.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[156.0]},"content":[{"type":"paragraph","content":[{"text":"app admins","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[82.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"/v1/organizations/{guid}/studies","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[269.0]},"content":[{"type":"paragraph","content":[{"text":"All the studies sponsored by this organization.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[156.0]},"content":[{"type":"paragraph","content":[{"text":"All admin users","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Memberships","type":"text"}]},{"type":"paragraph","content":[{"text":"Administrative ","type":"text","marks":[{"type":"em"}]},{"text":"accounts can only be a member of one organization","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"4a41be85-fd13-43f1-98db-7b9ca98b02ac"}},{"type":"em"}]},{"text":".","type":"text","marks":[{"type":"em"}]},{"text":" We can associate multiple organizations to a study to give administrative user access to the study across organizations.","type":"text"}]},{"type":"paragraph","content":[{"text":"Thus, an account has an optional ","type":"text"},{"text":"orgId","type":"text","marks":[{"type":"em"}]},{"text":" foreign key reference to an organization (only administrative accounts are will be required to have this membership relationship, but we will need to migrate administrative accounts before we can require it on create and update).","type":"text"}]},{"type":"paragraph","content":[{"text":"The membership endpoints add and remove accounts from an organization. The accounts must be created first (though they don’t have to be verified), and they must be administrative accounts (they have the ","type":"text"},{"text":"admin_user","type":"text","marks":[{"type":"em"}]},{"text":" data group indicating at least one administrative role). Editing of accounts still happens through the participant APIs (even though these folks are not always participants), which can also be used to get a list of administrators, filtering for the ","type":"text"},{"text":"admin_user","type":"text","marks":[{"type":"em"}]},{"text":" tag.","type":"text"}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[91.0]},"content":[{"type":"paragraph","content":[{"text":"Method","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[355.0]},"content":[{"type":"paragraph","content":[{"text":"Path","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[158.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[156.0]},"content":[{"type":"paragraph","content":[{"text":"Access","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[91.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[355.0]},"content":[{"type":"paragraph","content":[{"text":"/v1/organizations/{guid}/members","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[158.0]},"content":[{"type":"paragraph","content":[{"text":"Get the list of members (Paged)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[156.0]},"content":[{"type":"paragraph","content":[{"text":"app admins","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[91.0]},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[355.0]},"content":[{"type":"paragraph","content":[{"text":"/v1/organizations/{guid}/members/{userId}","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[158.0]},"content":[{"type":"paragraph","content":[{"text":"Add member of this organization","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[156.0]},"content":[{"type":"paragraph","content":[{"text":"app admins","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[91.0]},"content":[{"type":"paragraph","content":[{"text":"DELETE","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[355.0]},"content":[{"type":"paragraph","content":[{"text":"/v1/organizations/{guid}/members/{userId}","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[158.0]},"content":[{"type":"paragraph","content":[{"text":"Remove member of this organization","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[156.0]},"content":[{"type":"paragraph","content":[{"text":"app admins","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Permission Checks","type":"text"}]},{"type":"paragraph","content":[{"text":"TBD. Practically right now, many operations are restricted to app admins, and this may need to be changed.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Assessment Ownership","type":"text"}]},{"type":"paragraph","content":[{"text":"Assessments have a similar ownership model. When they are published to the shared repository, the owner ID has to be namespace with the appId from which the assessment was derived, to be examined later for some permission checks. ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Accounts","type":"text"}]},{"type":"paragraph","content":[{"text":"There are few changes to accounts. ","type":"text"},{"text":"Test users","type":"text","marks":[{"type":"em"}]},{"text":" will continue to be marked with the ","type":"text"},{"text":"test_user","type":"text","marks":[{"type":"em"}]},{"text":" data group, and can be filtered out of APIs that return ","type":"text"},{"text":"AccountSummary","type":"text","marks":[{"type":"code"}]},{"text":" objects. ","type":"text"},{"text":"Administrative users","type":"text","marks":[{"type":"em"}]},{"text":" can be identified the same way through an ","type":"text"},{"text":"admin_user","type":"text","marks":[{"type":"em"}]},{"text":" data group. This data group will only be present if the user has one or more administrative roles. Administrative users can then be associated to organizations through an orgId foreign key field. There will be separate APIs to retrieve enrollees in a study, and to retrieve administrative users by their organization (the participant APIs will continue to exist, and continue to return both kinds of accounts).","type":"text"}]},{"type":"paragraph","content":[{"text":"We will change the account status flag so that an account is enabled if it has any path to authentication (verified email, verified phone, external ID or Synapse user ID). This simplifies the logic around Synapse ID and external ID-based accounts.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Studies","type":"text"}]},{"type":"paragraph","content":[{"text":"Substudy","type":"text","marks":[{"type":"code"}]},{"text":" will be refactored to be a ","type":"text"},{"text":"Study","type":"text","marks":[{"type":"code"}]},{"text":". A ","type":"text"},{"text":"Study","type":"text","marks":[{"type":"code"}]},{"text":" object describes one of the studies being run in an ","type":"text"},{"text":"App","type":"text","marks":[{"type":"code"}]},{"text":". The substudy APIs can be removed and replaced with new /v5/studies APIs.","type":"text"}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[88.0]},"content":[{"type":"paragraph","content":[{"text":"Method","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.0]},"content":[{"type":"paragraph","content":[{"text":"Path","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[325.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[156.0]},"content":[{"type":"paragraph","content":[{"text":"Access","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[88.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.0]},"content":[{"type":"paragraph","content":[{"text":"/v5/studies","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[325.0]},"content":[{"type":"paragraph","content":[{"text":"List all studies in an app context, either public or private and associated to the caller’s organization. Shows follow-on studies, closed studies, etc.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[156.0]},"content":[{"type":"paragraph","content":[{"text":"all admin users","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[88.0]},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.0]},"content":[{"type":"paragraph","content":[{"text":"/v5/studies","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[325.0]},"content":[{"type":"paragraph","content":[{"text":"Create a new study","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[156.0]},"content":[{"type":"paragraph","content":[{"text":"app admins","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[88.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.0]},"content":[{"type":"paragraph","content":[{"text":"/v5/studies/{studyId}","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[325.0]},"content":[{"type":"paragraph","content":[{"text":"Get a study record","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[156.0]},"content":[{"type":"paragraph","content":[{"text":"app admins","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[88.0]},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.0]},"content":[{"type":"paragraph","content":[{"text":"/v5/studies/{studyId}","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[325.0]},"content":[{"type":"paragraph","content":[{"text":"Update the study.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[156.0]},"content":[{"type":"paragraph","content":[{"text":"app admins","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[88.0]},"content":[{"type":"paragraph","content":[{"text":"DELETE","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[191.0]},"content":[{"type":"paragraph","content":[{"text":"/v5/studies/{studyId}","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[325.0]},"content":[{"type":"paragraph","content":[{"text":"Delete the study if it is in the UNRELEASED state.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[156.0]},"content":[{"type":"paragraph","content":[{"text":"app admins","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The study object:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"public class Study {\n appId: String;\n identifier: String;\n name: String;\n description: String;\n website: String;\n deleted: boolean;\n createdOn: DateTime;\n modifiedOn: DateTime;\n phase: StudyPhase;\n clientData: JsonNode;\n version: Long;\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"The clientData field can be used to store implementation-specific data. For example, the MTB app intends to note the type of credentials it is collecting for a specific study (phone-based sign in or external ID + password) so it can tailor the UI accordingly.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Study Phases","type":"text"}]},{"type":"paragraph","content":[{"text":"A ","type":"text"},{"text":"StudyPhase","type":"text","marks":[{"type":"code"}]},{"text":" describes the current phase a study is in as part of the whole study lifecycle. This can be referenced to enforce lifecycle constraints, tailor study UIs to fit the tasks appropriate to that stage of the study, etc. Note that ","type":"text"},{"text":"how","type":"text","marks":[{"type":"em"}]},{"text":" the study enrolls participants (via email or phone, external ID or through public and anonymous sign ups) is specified separately, and is just a hint to UI tools (unless we decide to enforce them).","type":"text"}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[162.0]},"content":[{"type":"paragraph","content":[{"text":"StudyPhase","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[458.0]},"content":[{"type":"paragraph","content":[{"text":"Comment","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph","content":[{"text":"Transition Into Verb","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[162.0]},"content":[{"type":"paragraph","content":[{"text":"LEGACY","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[458.0]},"content":[{"type":"paragraph","content":[{"text":"All legacy studies will be set in LEGACY, which cannot be changed from LEGACY, and which which prevents all lifecycle constraints from being enforced.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph","content":[{"text":"—","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[162.0]},"content":[{"type":"paragraph","content":[{"text":"DESIGN","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[458.0]},"content":[{"type":"paragraph","content":[{"text":"Studies are created in DESIGN","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"schedule can be edited","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"study can be updated","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"schedule association to study can be changed","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"study not visible in","type":"text"},{"text":" public registries","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"2de1242b-fd60-47f7-a0ea-55ca0de4b5d0"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"all accounts created are ","type":"text"},{"text":"test_user","type":"text","marks":[{"type":"code"}]},{"text":" accounts","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"study can be deleted, logically or physically","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph","content":[{"text":"—","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[162.0]},"content":[{"type":"paragraph","content":[{"text":"RECRUITMENT","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[458.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"study must be in DESIGN to transition to RECRUITMENT","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"IRB information must be filled out and attested to","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"schedule is published and cannot be changed","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"schedule association cannot be changed","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"study visible in public registries if enrollment type specifies it","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"accounts now created normally","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"study cannot be deleted","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph","content":[{"text":"recruit","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[162.0]},"content":[{"type":"paragraph","content":[{"text":"IN_FLIGHT","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"8c116a44-f876-4f04-846d-ade8d2290f06"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[458.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"study must be in RECRUITMENT to transition to IN_FLIGHT, either by study coordinator or by system upon achieving recruitment targets","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"no more enrollments can be created for this study","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"study no longer visible in public registries if it was visible","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"App still needs to be in App Store in case a participant needs to reinstall, or it’s a multi-study app","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"study cannot be deleted","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph","content":[{"text":"execute","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[162.0]},"content":[{"type":"paragraph","content":[{"text":"ANALYSIS","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[458.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"study should have at least one enrollee ","type":"text"},{"type":"emoji","attrs":{"id":"atlassian-question_mark","text":":question_mark:","shortName":":question_mark:"}},{"text":" and no active participants in order to be moved to ANALYSIS","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"App can be removed from the App Store if the app hosted only this study","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Study still available for IRB reporting","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Study cannot be changed, at all","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"study cannot be deleted","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph","content":[{"text":"analyze","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[162.0]},"content":[{"type":"paragraph","content":[{"text":"COMPLETED","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[458.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"study must be in ANALYSIS to transition to COMPLETED","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"study cannot be changed, at all","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"study can be ","type":"text"},{"text":"logically","type":"text","marks":[{"type":"em"}]},{"text":" deleted","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph","content":[{"text":"closeout","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[162.0]},"content":[{"type":"paragraph","content":[{"text":"WITHDRAWN","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[458.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"study can be in ","type":"text"},{"text":"any","type":"text","marks":[{"type":"em"}]},{"text":" phase ","type":"text"},{"text":"except","type":"text","marks":[{"type":"em"}]},{"text":" COMPLETED to transition to WITHDRAWN","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"study cannot be changed, at all","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"study can be logically deleted","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"paragraph","content":[{"text":"withdraw","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"These rules apply to the entire graph of objects that define a study.","type":"text"}]},{"type":"paragraph","content":[{"text":"Studies need to manage a few change-related use cases, which is why some key aspects of a study are dependent objects with their own APIs:","type":"text"}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.0]},"content":[{"type":"paragraph","content":[{"text":"Model","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[214.0]},"content":[{"type":"paragraph","content":[{"text":"Owner","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.0]},"content":[{"type":"paragraph","content":[{"text":"Consent(s)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[214.0]},"content":[{"type":"paragraph","content":[{"text":"Org that owns the study","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph","content":[{"text":"One or more, only one can be required (although multiple consents may be marked as required if they are in different languages). Informed consent, comprehension, and signature. Not normally assigned to two studies, but this is possible if a new study should not reconsent participants. However, there’s only one “state” of the consent in terms of noting IRB approval, duration, etc.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.0]},"content":[{"type":"paragraph","content":[{"text":"Recruitment","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[214.0]},"content":[{"type":"paragraph","content":[{"text":"Public","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph","content":[{"text":"One and only one. Baseline characteristics, an arm allocation strategy ","type":"text"},{"text":"including allocation state,","type":"text","marks":[{"type":"em"}]},{"text":" and an initial assessment to present prior to allocation. Like consents, these can be shared between studies.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.0]},"content":[{"type":"paragraph","content":[{"text":"Protocol","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[214.0]},"content":[{"type":"paragraph","content":[{"text":"Public","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph","content":[{"text":"One and only one. Can be shared between studies and across organizations.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"I am not sure if eligibility is part of a consent, part of a recruitment strategy, or directly associated to a study.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Christine Suver on eligibility: “What I see is the same study using different consents for different sub-populations. For example, in ADRC Wisconsin, the participation of under-represented participants comes with a small reimbursement and fewer mandatory activities. Same study, 2 sets of consents. When the study wants to rebalance its representation, the researchers are temporarily modifying eligibility criteria to only recruit within the desired populations.”","type":"text"}]}]},{"type":"paragraph","content":[{"text":"A new study can be created that shares these aspects of another study, helping us to manage the following scenarios:","type":"text"}]},{"type":"paragraph","content":[{"text":"Changing a study in progress. ","type":"text","marks":[{"type":"strong"}]},{"text":"This might be a bug fix or an enhancement.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Change through configuration only. ","type":"text","marks":[{"type":"strong"}]},{"text":"Changes to the study object graph should be detectable by the client so it can retrieve and update the client, or the app config can be used to manage upgrades (as we currently do now).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Change requires app release. ","type":"text","marks":[{"type":"strong"}]},{"text":"A new study will need to be created and referenced by the new release, however, the study can include the consent(s), recruitment and/or protocol of the original study so the state of enrollment and consent need not be lost. If the consent is different than the enrollment consent, the new consent can indicate whether or not the user should be forced to reconsent (or if, as long as there is an enrollment record, the user can continue to participate in the study).","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Extending a study in time.","type":"text","marks":[{"type":"strong"}]},{"text":" There are two ways to do this.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add to the existing timelines.","type":"text","marks":[{"type":"strong"}]},{"text":" Even after a study starts, study designers can extend the days in the study. Particularly if this doesn’t involve re-consent, this can work well.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a follow-on study.","type":"text","marks":[{"type":"strong"}]},{"text":" A new study can be created, and an assessment can be added to the end of the first study’s timeline that prompts the user to join the next study. This can support re-consent or not. This second study would not be public (you cannot directly enroll in it, you get to it by completing the first study).","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Following up one study with another study. ","type":"text","marks":[{"type":"strong"}]},{"text":"After the user authenticates, it should be possible to consent to other public studies that are available in the app. If we want to direct users of one study to consider joining a specific follow-on study, client logic will need to be introduced, looking at a user’s consents to determine what to display to the user. (Consent has never been fully automated.) There is one possible API for this:","type":"text"}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[108.0]},"content":[{"type":"paragraph","content":[{"text":"Method","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[272.0]},"content":[{"type":"paragraph","content":[{"text":"Path","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"Access","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[108.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[272.0]},"content":[{"type":"paragraph","content":[{"text":"/v5/studies/research","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"A list of public studies available to the caller, minus the studies they are already in","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[190.0]},"content":[{"type":"paragraph","content":[{"text":"authenticated users","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Multisite studies.","type":"text","marks":[{"type":"strong"}]},{"text":" Each site will need to be treated as a separate study, sharing the parts that are common and customizing the rest. For example, you might choose to differ consents, but use the same protocol. Designers will also have to decide if these studies share one allocation system, or if they will track recruitment on a site-by-site basis. For multisite studies, an umbrella organization should be associated to all the studies, so that one organization receives all the data in one Synapse repository.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sponsors","type":"text"}]},{"type":"paragraph","content":[{"text":"Studies will be associated to one or more organizations as ","type":"text"},{"text":"Sponsors","type":"text","marks":[{"type":"code"}]},{"text":" (to be accessible to anyone but super admins, they will need to be associated to at least one organization). Members of organizations that have sponsored a study can edit that study and see its participants (appropriate to their roles; ","type":"text"},{"text":"roles remain global","type":"text","marks":[{"type":"em"}]},{"text":"). Studies are otherwise publicly visible (we may eventually given them a private flag, where only members of sponsoring organizations would be able to read the study).","type":"text"}]},{"type":"paragraph","content":[{"text":"With an organization model, Sage Bionetworks can cease to be a weird global default…instead we can associate Sage accounts to all studies in an app by associating our organization to all studies (perhaps it’s set as a default and cannot be removed).","type":"text"}]},{"type":"paragraph","content":[{"text":"When an administrative user signs in, we should collect all the studies they have access to as a result of their organizational memberships. We can then continue matching account searches against a list of (sub)studies. This is how we ensure that study administrators cannot see participants enrolled from other organizations.","type":"text"}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[83.0]},"content":[{"type":"paragraph","content":[{"text":"Method","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[320.0]},"content":[{"type":"paragraph","content":[{"text":"Path","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"Access","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[83.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[320.0]},"content":[{"type":"paragraph","content":[{"text":"/v5/studies/{studyId}/sponsors","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"All the studies associated to this organization","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"All admin users","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[83.0]},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[320.0]},"content":[{"type":"paragraph","content":[{"text":"/v5/studies/{studyId}/sponsors/{orgId}","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"Give an organization access to a study","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"App admin in an org already sponsoring the study","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[83.0]},"content":[{"type":"paragraph","content":[{"text":"DELETE","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[320.0]},"content":[{"type":"paragraph","content":[{"text":"/v5/studies/{studyId}/sponsors/{orgId}","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"Remove study access from an organization","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"App admin in an org already sponsoring the study","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Enrollments","type":"text"}]},{"type":"paragraph","content":[{"text":"The current participation of an account in a study is called an ","type":"text"},{"text":"enrollment.","type":"text","marks":[{"type":"em"}]},{"text":" And enrollment record is an associative entity between Account and Study. This record can be created in one of two ways:","type":"text"}]},{"type":"paragraph","content":[{"text":"By signing a consent.","type":"text","marks":[{"type":"em"}]},{"text":" The participant can sign the required consent for a study, which will enroll them in the study. (Subpopulations already have optional logic to place a person into a study; this will become mandatory). On ","type":"text"},{"text":"withdrawing","type":"text","marks":[{"type":"em"}]},{"text":" from a study, the participant updates the consent signature record and the enrollment record (it is not deleted because we wish to track withdrawals from a study).","type":"text"}]},{"type":"paragraph","content":[{"text":"By a study administrator.","type":"text","marks":[{"type":"em"}]},{"text":" There are also APIs for a third party to enroll and withdraw accounts from a study. The most common use case is when adding an account to a study through an ","type":"text"},{"text":"external ID.","type":"text","marks":[{"type":"em"}]},{"text":" When enrolling another account, the person doing the enrolling is recorded in the enrollment record. The caller can optionally bypass any further consent requirements for the account (were it to enroll itself). Similarly, a third party can withdraw an account from the study, and the caller will be recorded (along with an optional note about why).","type":"text"}]},{"type":"paragraph","content":[{"text":"An account is considered enrolled in a study if there is an enrollment record for the study, withdrewOn is null, and consentRequired is false. consentRequired can be false because it was explicitly set that way by a third party caller, because the participant signed a required consent, or because there was no required consent when they enrolled. ","type":"text"},{"text":"This flag is not changed by later changes to the consent system.","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"A user is withdrawn from a study if withdrewOn is not null. Note that consent signatures and signature histories will remain as is, but changes to the consent history will update the enrollment record, which is the final state of the user’s presence in the study.","type":"text"}]},{"type":"paragraph","content":[{"text":"Allocation to a study arm is also recorded in an enrollment record, and should be part of the baseline characteristics information.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"AccountsSubstudies","type":"text","marks":[{"type":"code"}]},{"text":" table will be renamed ","type":"text"},{"text":"Enrollments","type":"text","marks":[{"type":"code"}]},{"text":". ","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"Enrollment {\n String appId;\n String studyId;\n String accountId;\n // optional\n String externalId; \n // at time of enrollment, is there a required consent for the study\n boolean consentRequired;\n // timestamp user has signed the consent, or record creation timestamp\n DateTime enrolledOn;\n // user withdrew consent \n DateTime withdrawnOn; \n // who enrolled this person, if not the person themself\n String enrolledBy; \n // who withdrew this persion, if not the person themself\n String withdrawnBy; \n // study arm allocation (may be supplied as part of enrollment record,\n // eventually, or we can run an allocation algorithm)\n Study studyArm; \n // sharing scope currently remains global to the account, but if it is\n // different by study, it would be stored here.\n SharingScope sharingScope;\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Currently it appears we can retrofit the existing consent system to support enrollment records. In addition, the following API will be introduced:","type":"text"}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[88.0]},"content":[{"type":"paragraph","content":[{"text":"Method","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[352.0]},"content":[{"type":"paragraph","content":[{"text":"Path","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[203.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[117.0]},"content":[{"type":"paragraph","content":[{"text":"Access","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[88.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[352.0]},"content":[{"type":"paragraph","content":[{"text":"/v5/studies/{studyId}/enrollments","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[203.0]},"content":[{"type":"paragraph","content":[{"text":"List all the individuals who have enrolled in the study. Paged.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[117.0]},"content":[{"type":"paragraph","content":[{"text":"Researcher in a sponsoring org","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[88.0]},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[352.0]},"content":[{"type":"paragraph","content":[{"text":"/v5/studies/{studyId}/enrollments","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[203.0]},"content":[{"type":"paragraph","content":[{"text":"Enroll an account in a study (almost always with an externalId).","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[117.0]},"content":[{"type":"paragraph","content":[{"text":"Researcher in a sponsoring org","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[88.0]},"content":[{"type":"paragraph","content":[{"text":"DELETE","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[352.0]},"content":[{"type":"paragraph","content":[{"text":"/v5/studies/{studyId}/enrollments/{userId}","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[203.0]},"content":[{"type":"paragraph","content":[{"text":"Withdraw the user from the study","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[117.0]},"content":[{"type":"paragraph","content":[{"text":"Researcher in a sponsoring org","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"This API replaces the external identifier APIs which will be removed. External IDs will no longer be created separately from an account. The ","type":"text"},{"text":"create participant","type":"text","marks":[{"type":"em"}]},{"text":" API will continue to take an external ID so it can create an account with an enrollment record (otherwise we lose the ability to identify an account solely by an external ID). ","type":"text"},{"text":"We continue to have no secure way to authenticate this type of account.","type":"text","marks":[{"type":"em"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Recruitment (formerly baseline characteristics)","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Recruitment","type":"text","marks":[{"type":"code"}]},{"text":" model covers a couple of interrelated capabilities:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Collecting specific “baseline characteristics” during onboarding that are either important for recruiting, study analysis, or both;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Using these characteristics to allocate participants to study arms, using one of a few industry standard allocation practices for clinical studies. (Allocation strategies will operate on any number of arms, and can be assigned to any protocol);","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Holding the state of allocation.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Like other aspects of a study, recruitment may need to be carried over to another study configuration, or it may need to be changed while maintaining the rest of the study design. ","type":"text"}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph","content":[{"text":"Method","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[317.0]},"content":[{"type":"paragraph","content":[{"text":"Path","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[330.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[317.0]},"content":[{"type":"paragraph","content":[{"text":"/v1/recruitments","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[330.0]},"content":[{"type":"paragraph","content":[{"text":"Get a list of recruitment objects for this app","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[317.0]},"content":[{"type":"paragraph","content":[{"text":"/v1/recruitments","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[330.0]},"content":[{"type":"paragraph","content":[{"text":"Create a recruitment object","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[317.0]},"content":[{"type":"paragraph","content":[{"text":"/v1/recruitments/{guid}","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[330.0]},"content":[{"type":"paragraph","content":[{"text":"Get a recruitment object","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[317.0]},"content":[{"type":"paragraph","content":[{"text":"/v1/recruitments/{guid}","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[330.0]},"content":[{"type":"paragraph","content":[{"text":"Update a recruitment object","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[317.0]},"content":[{"type":"paragraph","content":[{"text":"/v5/studies/{studyId}/recruitment","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[330.0]},"content":[{"type":"paragraph","content":[{"text":"Get the recruitment object associated to this study","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[113.0]},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[317.0]},"content":[{"type":"paragraph","content":[{"text":"/v5/studies/{studyId}/recruitment/{guid}","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[330.0]},"content":[{"type":"paragraph","content":[{"text":"Associate recruitment to this study, replacing one if it exists.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Baseline characteristics","type":"text"}]},{"type":"paragraph","content":[{"text":"Note: I would not implement this until protocols and study arms are complete. It isn’t useful without these.","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"A recruitment object will reference an assessment the user should perform after consent, but before they are allocated to a study arm. This assessment collects the baseline characteristics (the client may choose to retrieve characteristics from the answers to an eligibility step, as well). The total set of characteristics is thus dynamic, and will change if a user consents to further studies. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Where two studies collect the same information, it is up to the study designers to coordinate and address naming conflicts/duplication/duplicated effort on the part of the user (e.g. asking for “sex” and “gender” for two different studies in the same app).","type":"text"}]},{"type":"paragraph","content":[{"text":"The v2 exporter will export information about a participant every time that record changes, to a normalized table in Synapse. So this appears to be an ideal mechanism to centralize and export the baseline characteristic data.","type":"text"}]},{"type":"paragraph","content":[{"text":"There is some information that we should probably always export with the participant record:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"study enrollments (and their external IDs);","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"study arm assignment for each study (using the arm pseudonym);","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"data groups;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"sharing scope for each study.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Note that some data is ","type":"text"},{"text":"per study","type":"text","marks":[{"type":"em"}]},{"text":" and the user can be enrolled in multiple studies.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Allocation Strategy","type":"text"}]},{"type":"paragraph","content":[{"text":"These are the allocation strategies we should aim to support (we can support others, like non-randomized assignment strategies):","type":"text"}]},{"type":"paragraph","content":[{"text":"Blocked randomization","type":"text","marks":[{"type":"strong"}]},{"text":" - the set of study arms (A) is put into a list N times (3-4 times would be typical and we might just pick a value at random), and then the list item order is randomized. Each allocation pulls sequentially from this list until it is exhausted, and the process is repeated. This ensures that after A*N allocations, the study arms will be equal in size (and the arm size difference will never be more than (A*N)/2), yet researchers cannot easily predict the next allocation.","type":"text"}]},{"type":"paragraph","content":[{"text":"Stratified randomization","type":"text","marks":[{"type":"strong"}]},{"text":" - in addition to assuring even distribution between study arms, this strategy ensures even distribution of baseline characteristics between arms. The first challenge of using this strategy is that characteristics need to be discrete and not continuous (so the client would need to convert values, e.g. 125/84 to “pre-hypertension”). The product of all discrete values by all characteristics being randomized is used to generate a set of strata. Each enrollee is assigned to one of these strata, then block randomization is used within that single strata. In this case, blocks should be smaller (1-2 sets of study arms).","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"For example, if you were randomizing by country (the 3 in North America) and blood pressure (5 categories), each user could be assigned to one of 15 strata, and the block randomization would be tracked separately for each strata.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"If a study design has no baseline characteristics, we can default to blocked randomization, and it if has baseline characteristics and some are marked for allocation, we can use stratified randomization. This is pretty robust. ","type":"text"}]},{"type":"paragraph","content":[{"text":"However one downside to these two strategies is that the numbers of people who are noncompliant, or just drop out of a study, can be such that imbalances will still appear between arms of the study. If this becomes an issue, we can examine algorithms that examine participation data, and tweak allocation to restore balance with new enrollees (e.g. “response adaptive randomization”).","type":"text"}]},{"type":"paragraph","content":[{"text":"Each strategy can be encapsulated in an ","type":"text"},{"text":"AllocationStrategy","type":"text","marks":[{"type":"code"}]},{"text":" that can be parameterized at execution, and that will return state (we’ll only be able to allocate one person at a time and will have to write code accordingly).","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"public interface AllocationStrategy {\n /**\n * \n * @param allocationState \n * the allocation state loaded from persistence. State is stored\n * in the Recruitment object with an optimistic lock, so it will be \n * necessary to retry until allocation succeeds.\n * @param characteristicDefs\n * definitions of the characteristics that were marked for allocation.\n * This should include a listing of all possible categorical values.\n * @param userCharacteristics\n * the values collected for the user being allocated\n * @param studyArms\n * study arms of the protocol from which one study arm should be selected\n * @return\n * an object encompassing the selected study arm and the changed state that \n * should be persisted.\n */\n Allocation allocate(\n Map allocationState, \n List characteristicDefs,\n List userCharacteristics,\n List studyArms);\n}\n\n// The study arm selection and a new map with updated allocation state \n// are persisted in a transaction that includes the study participant \n// and the recruitment object. Encompassing code will need to retry on \n// concurrent modification exceptions.\nclass Allocation {\n StudyArm studyArm;\n Map newAllocationState;\n}","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"The entire load state, allocate, and persist needs to happen in a database transaction. If the transaction fails, it’ll need to start over, reloading the current state. I don’t think this will require a distributed lock as the database can serve this purpose, but a queue might reduce or eliminate retries.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Here is an example of a randomized but stateless (and therefore pretty useless) allocation strategy:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"// A sample implementation (too simple to be useful)\npublic class RandomAllocationStrategy implements AllocationStrategy {\n private static final SecureRandom RANDOM = new SecureRandom();\n \n @Override\n public Allocation allocate(Map allocationState, \n List characteristicDefs,\n List userCharacteristics,\n List studyArms) {\n \n int randomIndex = RANDOM.nextInt(studyArms.size());\n StudyArm arm = studyArms.get(randomIndex);\n // no state change\n return new Allocation(arm, ImmutableMap.copyOf(allocationState));\n }\n}\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Protocols","type":"text"}]},{"type":"codeBlock","content":[{"text":"Class Protocol {\n String guid;\n String name;\n String description;\n List studyArms;\n String orgGuid; // owning organization\n // timestamps, version attribute\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Protocol","type":"text","marks":[{"type":"code"}]},{"text":" objects exist globally for all studies in an app. They are global because they can be shared between studies (for example, the mPower 2 study was used by external organizations as part of their larger studies… they would use the same protocol, but the enrollment process for participants coming from that study is different). One organization is marked as the ","type":"text"},{"text":"owning","type":"text","marks":[{"type":"em"}]},{"text":" organization of a protocol. Only users associated to that organization can edit or delete that protocol. However, protocols can only be edited or deleted when they are not associated to a ","type":"text"},{"text":"Study","type":"text","marks":[{"type":"code"}]},{"text":" that is in use. For this reason, associating a protocol to multiple studies could be somewhat rare in practice (but it remains our solution for cases like mPower 2 where organizations enroll participants in different ways).","type":"text"}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[89.0]},"content":[{"type":"paragraph","content":[{"text":"Method","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[423.0]},"content":[{"type":"paragraph","content":[{"text":"Path","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[248.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[89.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[423.0]},"content":[{"type":"paragraph","content":[{"text":"/v1/protocols","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[248.0]},"content":[{"type":"paragraph","content":[{"text":"Get a list of protocols in app context (either public or associated to an organization the caller is associated to, or all organizations for “global” caller accounts","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[89.0]},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[423.0]},"content":[{"type":"paragraph","content":[{"text":"/v1/protocols","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[248.0]},"content":[{"type":"paragraph","content":[{"text":"Create a protocol","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[89.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[423.0]},"content":[{"type":"paragraph","content":[{"text":"/v1/protocols/{guid}","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[248.0]},"content":[{"type":"paragraph","content":[{"text":"Get full protocol record","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[89.0]},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[423.0]},"content":[{"type":"paragraph","content":[{"text":"/v1/protocols/{guid}","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[248.0]},"content":[{"type":"paragraph","content":[{"text":"Update a protocol","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[89.0]},"content":[{"type":"paragraph","content":[{"text":"DELETE","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[423.0]},"content":[{"type":"paragraph","content":[{"text":"/v1/protocols/{guid}","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[248.0]},"content":[{"type":"paragraph","content":[{"text":"Delete a protocol (subject to limitations based on the states of the studies currently using this protocol).","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Study Arms / Provisos / Timelines","type":"text"}]},{"type":"paragraph","content":[{"text":"Protocols are associated to ","type":"text"},{"text":"StudyArm","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"Proviso","type":"text","marks":[{"type":"code"}]},{"text":" objects. Scheduling happens through study arms and provisos, so scheduling is shareable between studies in an app context. Study administrators can manually assign participants to study arms, but a protocol will also contain an ","type":"text"},{"text":"allocation strategy","type":"text","marks":[{"type":"em"}]},{"text":" to do this (see Allocation below).","type":"text"}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[89.0]},"content":[{"type":"paragraph","content":[{"text":"Method","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[423.0]},"content":[{"type":"paragraph","content":[{"text":"Path","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[248.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[89.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[423.0]},"content":[{"type":"paragraph","content":[{"text":"/v1/protocols/{guid}/timelines","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[248.0]},"content":[{"type":"paragraph","content":[{"text":"Get a list of study arms or provisos for this protocol","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[89.0]},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[423.0]},"content":[{"type":"paragraph","content":[{"text":"/v1/protocols/{guid}/timelines","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[248.0]},"content":[{"type":"paragraph","content":[{"text":"Add a study arm or proviso to this protocol","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[89.0]},"content":[{"type":"paragraph","content":[{"text":"DELETE","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[423.0]},"content":[{"type":"paragraph","content":[{"text":"/v1/protocols/{guid}/timelines/{id}","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[248.0]},"content":[{"type":"paragraph","content":[{"text":"Delete a study arm or proviso (subject to the state of the studies that include this protocol)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[89.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[423.0]},"content":[{"type":"paragraph","content":[{"text":"/v1/protocols/{guid}/timelines/{id}/members","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[248.0]},"content":[{"type":"paragraph","content":[{"text":"Get a paged list of accounts assigned to this study arm or protocol","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[89.0]},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[423.0]},"content":[{"type":"paragraph","content":[{"text":"/v1/protocols/{guid}/timelines/{id}/members","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[248.0]},"content":[{"type":"paragraph","content":[{"text":"Add an account to this study arm or proviso","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[89.0]},"content":[{"type":"paragraph","content":[{"text":"DELETE","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[423.0]},"content":[{"type":"paragraph","content":[{"text":"/v1/protocols/{guid}/timelines/{id}/members/{userId}","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[248.0]},"content":[{"type":"paragraph","content":[{"text":"Remove an account from this study arm or proviso","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[89.0]},"content":[{"type":"paragraph","content":[{"text":"POST","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[423.0]},"content":[{"type":"paragraph","content":[{"text":"/v1/protocols/{guid}/provisos/{id}/self","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[248.0]},"content":[{"type":"paragraph","content":[{"text":"API for a client to add participant to a proviso. Returns user session.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[89.0]},"content":[{"type":"paragraph","content":[{"text":"DELETE","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[423.0]},"content":[{"type":"paragraph","content":[{"text":"/v1/protocols/{guid}/provisos/{id}/self","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[248.0]},"content":[{"type":"paragraph","content":[{"text":"API for a client to remove a participant from a proviso. Returns user session.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[89.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[423.0]},"content":[{"type":"paragraph","content":[{"text":"/v1/protocols/{guid}/studyarms/pseudonyms","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[248.0]},"content":[{"type":"paragraph","content":[{"text":"Get the mapping from pseudonyms to actual study arms, once study blinding is no longer necessary. We can enforce role or lifecycle limitations to accessing this API, if desired. Pseudonyms are not available from any other API; all data is exported using only the pseudonym.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Note: study arms and protocols use human-entered and human-readable identifiers, so their IDs are scoped to a specific protocol. Hence they must be nested under protocols in the API.","type":"text","marks":[{"type":"em"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Assessments","type":"text"}]},{"type":"paragraph","content":[{"text":"Assessments have been described in ","type":"text"},{"text":"Assessments, shared assessments, and their resources and tags","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/BRIDGE/pages/914882561"}}]},{"text":" and in ","type":"text"},{"text":"Assessment Configuration API","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/BRIDGE/pages/883949618"}}]},{"text":". Assessments are mostly done with the caveat that there will be requests for changes as they are put to use.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Scheduling","type":"text"}]},{"type":"paragraph","content":[{"text":"Scheduling has been described in ","type":"text"},{"text":"Scheduling API (Bridge v2; API v5)","type":"text","marks":[{"type":"link","attrs":{"href":"https://sagebionetworks.jira.com/wiki/spaces/BRIDGE/pages/914883048"}}]},{"text":". Scheduling requires everything in this document to be implemented that is not related to consent.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Java Domain Model","type":"text"}]},{"type":"paragraph","content":[{"text":"After a couple of years of using Hibernate for a REST-based API, I’ve developed the opinion that while the database should express all the relationships and constraints between entities, the Hibernate-managed Java objects probably shouldn’t map the relationships. Rather than updating a dependent object in an object graph, there should be a separate REST API. The models reflect this in ignoring many cases where we could use @OneToMany or @ManyToOne, etc. relationships.","type":"text"}]},{"type":"paragraph","content":[{"text":"App","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"class App {\n // General metadata\n String name;\n String shortName;\n String sponsorName; // but is it always Sage B?\n String identifier;\n String supportEmail;\n String technicalEmail;\n\n // Authentication\n PasswordPolicy passwordPolicy;\n boolean autoVerificationEmailSuppressed;\n boolean emailVerificationEnabled;\n boolean externalIdValidationEnabled;\n boolean emailSignInEnabled;\n boolean phoneSignInEnabled;\n boolean externalIdRequiredOnSignup;\n Boolean reauthenticationEnabled;\n boolean autoVerificationPhoneSuppressed;\n boolean verifyChannelOnSignInEnabled;\n\n // Account configuration\n Set profileAttributes;\n Set dataGroups;\n boolean participantIpLockingEnabled;\n\n // App configuration\n Map minSupportedAppVersions;\n Map pushNotificationARNs;\n Map installLinks;\n Map oauthProviders;\n List appleAppLinks;\n List androidAppLinks;\n\n // Templates may have study-specific overrides of the app-level defaults\n Map defaultTemplates;\n\n // Export (currently being replaced?)\n boolean appIdExcludedInExport;\n Long synapseDataAccessTeamId;\n String synapseProjectId;\n boolean usesCustomExportSchedule;\n boolean healthCodeExportEnabled;\n boolean disableExport;\n\n // Upload (currently being replaced?)\n List uploadMetadataFieldDefinitions;\n UploadValidationStrictness uploadValidationStrictness;\n boolean strictUploadValidationEnabled;\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Organization","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"@Entity\n@Table(name = \"Organizations\")\npublic class Organization {\n @Id\n private String appId\n @Id\n private String identifier;\n @JsonIgnore\n private String appId;\n private String name;\n private String description;\n private String supportEmail;\n // Data is exported to organizations based on their association to a study?\n String synapseDataAccessTeamId;\n String synapseProjectId;\n @Convert(converter = DateTimeToLongAttributeConverter.class)\n private DateTime createdOn;\n @Convert(converter = DateTimeToLongAttributeConverter.class)\n private DateTime modifiedOn; \n @Version\n private Long version;\n // getters and setters ommittted\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Membership","type":"text"}]},{"type":"paragraph","content":[{"text":"This is probably a simple associative table and not a domain model (unless we end up assigning roles as part of membership):","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"// arguably, this is where roles should go\npublic class Membership {\n private String accountId;\n private String orgGuid;\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Study","type":"text"}]},{"type":"paragraph","content":[{"text":"Where we have already used the word “Study” in database or DynamoDB tables, I would propose we use “AppStudy” to differentiate this new version of a study. Everywhere else, we use study.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"public class Study {\n String appId;\n String id; // unique within an app and user-supplied\n String name;\n String consentNotificationEmail;\n String consentNotificationEmailVerified;\n StudyState state;\n boolean private;\n Recruitment recruitment;\n // timestamps, deleted, and version\n // sponsors can be retrieved in a separate call when needed\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Recruitment, characteristic definitions, and characteristics.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"public class Recruitment {\n AllocationStrategy strategy;\n AllocationState state; // format not determined\n Assessment assessment;\n Map baselineCharacteristics;\n}\n\npublic class CharacteristicDef {\n // There will need to be a mapping between the data generated by \n // the assessment, and the characteristic it is written to.\n String identifier;\n // is this a dimension on which we track recruitment?\n boolean recruitable; \n // do we use this as a dimension during study arm allocation?\n boolean allotable;\n // continuous or discrete, for report presentation, and also\n // only discrete (categorical) values can be used for allocation.\n DataType dataType;\n // discrete data types that have an enumeration can be used for \n // allocation during study arm assignment. It would be an error\n // to mark this characteristic as allotable without a listing \n // of all possible values.\n List enumeration;\n}\n\npublic class Characteristic {\n String appId;\n Set studies; // every study associated to the Recruitment\n String id;\n String value;\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Enrollment","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"@Entity\n@Table(name = \"AccountSubstudies\")\n@IdClass(AccountSubstudyId.class)\npublic class HibernateEnrollment implements Enrollment {\n @Id\n String appId;\n @Id\n String studyId;\n @Id\n @JoinColumn(name = \"account_id\")\n String accountId;\n String consentGuid;\n String studyArmGuid;\n @Enumerated(EnumType.STRING)\n SharingScope sharingScope;\n String externalId;\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Protocol","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"@Entity\n@Table(name = \"Protocols\")\npublic class Protocol {\n @Id\n String guid;\n \n @JsonIgnore\n String appId;\n \n String name;\n \n String description;\n \n @Enumerated(EnumType.STRING)\n StudyState state;\n \n @JsonIgnore\n String orgId;\n \n @Convert(converter = DateTimeToLongAttributeConverter.class)\n DateTime createdOn;\n \n @Convert(converter = DateTimeToLongAttributeConverter.class)\n DateTime modifiedOn;\n \n boolean isPublic;\n \n boolean deleted;\n \n // getters and setters ommitteed\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Finally, ","type":"text"},{"text":"Timeline","type":"text","marks":[{"type":"code"}]},{"text":" subclasses (","type":"text"},{"text":"StudyArm","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"Proviso","type":"text","marks":[{"type":"code"}]},{"text":") are stored using single table inheritance:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"@Entity\n@Table(name = \"Timelines\")\n@Inheritance\n@DiscriminatorColumn(name=\"type\", discriminatorType=STRING)\n@JsonTypeInfo( use = JsonTypeInfo.Id.NAME, include = JsonTypeInfo.As.EXISTING_PROPERTY, property = \"type\")\n@JsonSubTypes({\n @Type(name=\"Proviso\", value=Proviso.class),\n @Type(name=\"StudyArm\", value=StudyArm.class)\n})\n@IdClass(TimelineId.class)\npublic abstract class Timeline {\n @Id\n @JsonIgnore\n private String protocolGuid;\n @Id\n private String identifier;\n \n @JsonIgnore\n private String appId;\n \n private String name;\n \n // getters and setters ommitted\n}\n\n@Entity\n@DiscriminatorValue(\"StudyArm\")\npublic class StudyArm extends Timeline {\n @JsonIgnore\n private String pseudonym;\n \n public String getPseudonym() {\n return pseudonym;\n }\n public void setPseudonym(String pseudonym) {\n this.pseudonym = pseudonym;\n }\n}\n\n@Entity\n@DiscriminatorValue(\"Proviso\")\npublic class Proviso extends Timeline {\n private boolean blocking;\n\n public boolean isBlocking() {\n return blocking;\n }\n public void setBlocking(boolean blocking) {\n this.blocking = blocking;\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Security Changes","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"App Administrator","type":"text"}]},{"type":"paragraph","content":[{"text":"Very few people should have this capability, but more people than Dwayne and Alx. This person can change the shared configuration of an app, which for some apps could be disruptive to other studies or organizations. We have also called this person a “study administrator” but we may need to differentiate these two things.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Organization Administrators","type":"text"}]},{"type":"paragraph","content":[{"text":"This is a study administrator who can build out and control their organization’s capabilities in Bridge. They do not see study participants and they cannot edit study/app configuration:","type":"text"}]},{"type":"paragraph","content":[{"text":"Capabilities:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"create a new account attached to an organization;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"add an account to an organization that's not currently affiliated with an org;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"edit an account in the org admin's organization;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"remove an account from the org admin’s organization;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"delete an account IF it's associated to the org admin's organization;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"create a new study that is sponsored by the org admin's organization (developers in an organization presumably can do this as well).","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Study Coordinators","type":"text"}]},{"type":"paragraph","content":[{"text":"Study coordinators are researchers who can only act on participants in studies they are associated to through their organizational membership. They have a distinct set of participant APIs under the ","type":"text"},{"text":"/v5/studies/{studyId}/participants","type":"text","marks":[{"type":"code"}]},{"text":" pathway for this purpose (initially, all the relevant APIs from the ","type":"text"},{"text":"/v3/participants","type":"text","marks":[{"type":"code"}]},{"text":" pathway, scoped accordingly…researchers can also use these APIs as they are conceived to be a superset of all study coordinators in an app). It also appears from MTB designs that study coordinators may be able to set up aspects of a study’s protocol, such as the schedules and study arms (TBD).","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"SDK Changes","type":"text"}]},{"type":"paragraph","content":[{"text":"We’re ready to remove a few APIs, either because they’re unused, or because they have been replaced:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shared modules","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"compound tasks","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"substudy APIs","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"I am maintaining a document on ","type":"text"},{"text":"developer.sagebridge.org","type":"text","marks":[{"type":"link","attrs":{"href":"http://developer.sagebridge.org"}}]},{"text":" that explains what we are doing during this transition period.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"SQL","type":"text"}]},{"type":"paragraph","content":[{"text":"The SQL for these elements:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"sql"},"content":[{"text":"CREATE TABLE `Organizations` (\n `guid` varchar(255) NOT NULL,\n `appId` varchar(255) NOT NULL,\n `name` varchar(255) NOT NULL,\n `description` text,\n `createdOn` bigint(20) unsigned DEFAULT NULL,\n `modifiedOn` bigint(20) unsigned DEFAULT NULL,\n `deleted` tinyint(1) DEFAULT '0',\n `version` bigint(10) unsigned NOT NULL DEFAULT 0,\n PRIMARY KEY (`guid`)\n) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci;\n\nCREATE TABLE `Protocols` (\n `guid` varchar(255) NOT NULL,\n `appId` varchar(255) NOT NULL,\n `orgId` varchar(255) NOT NULL,\n `name` varchar(255) NOT NULL,\n `description` text,\n `state` enum('UNRELEASED', 'RECRUITMENT', 'INVITATION', 'IN_FLIGHT', 'ANALYSIS', 'COMPLETED', 'WITHDRAWN'),\n `allocationStrategyName` enum('RANDOM'),\n `allocationState` text,\n `isPublic` tinyint(1) DEFAULT '0',\n `createdOn` bigint(20) unsigned DEFAULT NULL,\n `modifiedOn` bigint(20) unsigned DEFAULT NULL,\n `deleted` tinyint(1) DEFAULT '0',\n `version` bigint(10) unsigned NOT NULL DEFAULT 0,\n PRIMARY KEY (`guid`),\n CONSTRAINT FOREIGN KEY (`orgId`) REFERENCES `Organizations` (`identifier`)\n) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci;\n\nCREATE TABLE `Timelines` (\n `type` VARCHAR(31) NOT NULL,\n `identifier` varchar(255) NOT NULL,\n `appId` varchar(255) NOT NULL,\n `protocolGuid` varchar(255) NOT NULL,\n `name` varchar(255) NOT NULL,\n `pseudonym` varchar(255),\n `blocking` tinyint(1) DEFAULT '0',\n `createdOn` bigint(20) unsigned DEFAULT NULL,\n `modifiedOn` bigint(20) unsigned DEFAULT NULL,\n `deleted` tinyint(1) DEFAULT '0',\n `version` bigint(10) unsigned NOT NULL DEFAULT 0,\n PRIMARY KEY (`protocolGuid`, `identifier`),\n CONSTRAINT FOREIGN KEY (`protocolGuid`) REFERENCES `Protocols` (`guid`)\n) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci;\n\nCREATE TABLE `ProtocolOrganizations` (\n `protocolGuid` varchar(255) NOT NULL,\n `orgId` varchar(255) NOT NULL,\n CONSTRAINT FOREIGN KEY (`protocolGuid`) REFERENCES `Protocols` (`guid`),\n CONSTRAINT FOREIGN KEY (`orgId`) REFERENCES `Organizations` (`identifier`)\n) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci;","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Questions","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"What are the visibility and access rules for studies, consents, requirement, and protocols? I am indifferent to a solution here, it just needs to work for researchers.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"I’m proposing roles remain global for an app… if you are a developer, you are a developer in all studies your organization has access to. Refactoring this would be very significant for us across all existing APIs, but let’s discuss this.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Where should eligibility be associated? To a study, to recruitment, or even to a consent? Is it reusable in any way?","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Is there one org that “owns” the study vs. more than one that contributes to it (participants, analysis)? There’s usually at least two organizations: Sage and a partner.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If email/phone number could be provided when signing in, could we stop creating accounts with external ID + password? (I don’t have a problem with them except for the fact that the password is usually static and reused across accounts, rendering it pointless.)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Is it necessary to maintain different sharing scopes for different studies, or can this remain global to a user?","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Have we ever had a case where accounts 1) used external IDs only; and also 2) consented through Bridge’s electronic consent system? I don’t believe this has ever come up, and would change the proposed ","type":"text"},{"text":"Enrollment","type":"text","marks":[{"type":"code"}]},{"text":" record design.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Are we collecting the information we need to really aid recruitment (requirements on this are weak);","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"How will this interact with the new exporter system. In particular, are we carrying over enough metadata to meet the highest bar of tracing.","type":"text"}]}]}]}],"version":1}