Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 4 additions & 5 deletions app/_meta.js
Original file line number Diff line number Diff line change
@@ -1,16 +1,15 @@
export default {
index: {
display: "hidden"
display: "hidden",
},

// Welcome Report URL redirect, never show in nav
five_safes_tes: {
display: "hidden"
display: "hidden",
},

// exclude routes until content published
"journeys": {
display: "hidden"
journeys: {
display: "hidden",
},

// TODO: restructure content and move "connect" journey page
Expand Down
7 changes: 0 additions & 7 deletions app/journeys/learn/what-is-five-safes/page.mdx

This file was deleted.

4 changes: 4 additions & 0 deletions app/learn/_meta.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
export default {
"what-is-five-safes-tes": "What is Five Safes TES?",
personas: "Personas",
};
7 changes: 5 additions & 2 deletions app/journeys/learn/personas/page.mdx → app/learn/page.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,10 @@
---
# TODO: move to correct structure when content added
title: Learn
asIndexPage: true
---

import { UnderConstruction } from "@/components/UnderConstruction";

<UnderConstruction />
<UnderConstruction />

# Learn
67 changes: 67 additions & 0 deletions app/learn/personas/page.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
---
title: Personas
readingTime: PT5M
audiences: everyone
docType: explanation
---

import { DocMetadata } from "@/components/doc-metadata/DocMetadata";
import { Table } from "nextra/components";

<DocMetadata />

# Overview

Key to the successful adoption and implementation of Five Safes TES is understanding who will interact with the solution. To characterise our users we have identified the following personas:

- TRE operators
- Federation operators
- Researchers
- Developers (emerging)
- Innovators (emerging)

## TRE operators

TREs operators are responsible for the management of the Trusted Research Environments (TREs) IT infrastructure. TRE operators are inclusive of governance, data management, and infrastructure management roles.

This description has been adopted from [SATRE](https://satre-specification.readthedocs.io/en/stable/roles.html#infrastructure-management-roles).

The responsibilities of TRE operators are defined through the [SATRE specification](https://satre-specification.readthedocs.io/en/latest/index.html):

- [Information Governance](https://satre-specification.readthedocs.io/en/stable/specification.html#information-governance): Quality management, risk management, training delivery, member accreditation, and governance procedures that ensure TREs operate safely and ethically.
- [Computing Technology](https://satre-specification.readthedocs.io/en/stable/specification.html#computing-technology-and-information-security): End-user computing experience, infrastructure management, information security, and configuration management for secure data analysis environments.
- [Data Management](https://satre-specification.readthedocs.io/en/stable/specification.html#data-management): Data lifecycle management, identity and access management, output management, information discovery, and research metadata capabilities.
- [Supporting Capabilities](https://satre-specification.readthedocs.io/en/stable/specification.html#supporting-capabilities): Financial management, public engagement and involvement, project management, procurement, and other essential operational functions.

## Federation operators

Federation operators provide oversight, policy and decision-making for a federation of TREs, ensuring consistent standards and accountability.

This description has been adopted from [SATRE](https://satre-specification.readthedocs.io/en/stable/roles.html#infrastructure-management-roles).

The responsibilities of Federation operators are defined through the [SATRE specification](https://satre-specification.readthedocs.io/en/latest/index.html):

- Federation governance, member accreditation, study management, information security, infrastructure management, data management, and financial management across multiple federated TRE partners.

## Researchers

Researchers are provided access to data via a TRE, who intend to carry out analysis or conduct research using the data.

The responsibilities of a Researcher have been adopted from the [UK Data Service](https://ukdataservice.ac.uk/learning-hub/research-data-management/ethical-issues/ethical-obligations/):

- Research should maximise benefits for individuals and society and minimise risk and harm.
- The rights and dignity of individuals and groups should be respected.
- Wherever possible, participation should be voluntary and appropriately informed.
- Research should be conducted with integrity and transparency.
- Lines of responsibility and accountability should be clearly defined.
- Independence of research should be maintained and where conflicts of interest cannot be avoided they should be made explicit.

{/* TODO: when we have pages about Developers and Innovators, we need to add the content for them here */}

## What's next?

Depending on your interests, you may want to read the following pages:

- TRE operators - [Connect](/connect)
- Federation operators - [Co-ordinate](/co-ordinate)
- Researchers - [Analyse](/analyse)
61 changes: 61 additions & 0 deletions app/learn/what-is-five-safes-tes/page.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
---
title: What is 5S-TES?
readingTime: PT5M
audiences: everyone
docType: explanation
---

import { DocMetadata } from "@/components/doc-metadata/DocMetadata";

<DocMetadata />

## Prerequisites

- Basic understanding of the definition of a [TRE](https://glossary.uktre.org/en/stable/#term-trusted-research-environment--tre-)
- Basic understanding of the definition of a [federation](https://glossary.uktre.org/en/stable/#term-federation)

## Overview

Five Safes TES (5S-TES) enables secure cross-TRE federated analytics, where data remains in place and only analysis code is sent to the data.
Building upon the Five Safes framework and the Task Execution Service (TES) standards, it is specifically designed to meet technical and governance constraints of TREs by separating the stages of a federated project.

## The Five Safes framework

![The Five Safes framework](/images/learn/five-safes.png)

A set of principles that guide a data services provision of safe research access to data, These interlocking principles include:

- Safe Data
- Safe Project
- Safe People
- Safe Settings
- Safe Outputs

To learn more, visit the resources at [UK Data Services](https://ukdataservice.ac.uk/help/secure-lab/what-is-the-five-safes-framework/).

## Global Alliance for Genomics & Health - Task Execution Service (GA4GH TES)

![GA4GH TES](/images/learn/tes.png)

Developed by the Global Alliance for Genomics & Health (GA4GH), the Task Execution Service provides a standard mechanism for orchestrating complex analyses across different compute environments.

To learn more, visit the [GA4GH TES product page](https://www.ga4gh.org/product/task-execution-service-tes/).

## Bringing it together

Five Safes TES (5S-TES) is a collaboration between Swansea University and the University of Nottingham, focused on delivering new capability to existing research data infrastructure.

By combining international standards, 5S-TES:

- enhances GA4GH TES to receive and process federated analysis requests from multiple TREs.
- supports Safe Data through configuration of specific and timebound data access for users.
- performs analyses only for a project that has been approved by the TRE, deeming them a Safe Project.
- only permits research users that have been accredited and established, indicating them as Safe People.
- maintains Safe Setting with execution of analysis occurring within a TRE.
- provides manual disclosure control functionality within TREs, adhering to Safe Outputs.

This solution is foundational to the various programmes, including [HDR UK Federated Analytics](https://www.hdruk.ac.uk/research/research-data-infrastructure/federated-analytics/), [DARE UK TREvolution programme](https://dareuk.org.uk/trevolution/), and [EOSC-ENTRUST](https://www.eosc-entrust.eu/).

## What's next?

- [System Context overview](/learn/system-context)
113 changes: 73 additions & 40 deletions app/page.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ import {
Share2,
Microscope,
Boxes,
ChevronRight
ChevronRight,
} from "lucide-react";
import CustomCard from "@/components/CustomCard";

Expand All @@ -16,53 +16,86 @@ import CustomCard from "@/components/CustomCard";
title="Learn"
description="Understand the core concepts, standards, and users of Five Safes TES"
links={[
{ title: "What is Fives Safes TES ", href: "/journeys/learn/what-is-five-safes" },
{ title: "What is Fives Safes TES ", href: "/learn/what-is-five-safes-tes" },
{ title: "OMOP", href: "/journeys/learn/omop" },
{ title: "Personas", href: "/journeys/learn/personas" },
{ title: "Personas", href: "/learn/personas" },
{ title: "System Architecture", href: "/journeys/learn/system-architecture" },
]}
CTA={{ text: <>Learn <ChevronRight /></>, href: "/journeys/learn" }}
icon={<BookOpen size={24} />}
/>

<CustomCard
title="Connect"
description="Learn about how TRE can operate with Five Safes TES"
links={[
{
title: "Setup TRE Components",
href: "/connect/setup-tre/deployment-steps",
},
{ title: "Connect a TRE", href: "/connect/connect-submission" },
{ title: "Projects and users", href: "/connect/approvals" },
{ title: "TRE data access", href: "/journeys/connect/tre-data-access" },
{ title: "Outputs approval", href: "/connect/approve-outputs" },
]}
CTA={{ text: <>Connect <ChevronRight /></>, href: "/journeys/connect" }}
icon={<Unplug size={24} />}
/>
<CustomCard
title="Connect"
description="Learn about how TRE can operate with Five Safes TES"
links={[
{
title: "Setup TRE Components",
href: "/connect/setup-tre/deployment-steps",
},
{ title: "Connect a TRE", href: "/connect/connect-submission" },
{ title: "Projects and users", href: "/connect/approvals" },
{ title: "TRE data access", href: "/journeys/connect/tre-data-access" },
{ title: "Outputs approval", href: "/connect/approve-outputs" },
]}
CTA={{
text: (
<>
Connect <ChevronRight />
</>
),
href: "/journeys/connect",
}}
icon={<Unplug size={24} />}
/>

<CustomCard
title="Research"
description="Learn about what reseachers can do with Five Safes TES"
links={[
{ title: "Submit an analysis", href: "/journeys/research/submitting-an-analysis" },
{ title: "Analysis examples", href: "/journeys/research/analysis-examples" },
]}
CTA={{ text: <>Research <ChevronRight /></>, href: "/journeys/research" }}
icon={<Microscope size={24} />}
/>
<CustomCard
title="Research"
description="Learn about what reseachers can do with Five Safes TES"
links={[
{
title: "Submit an analysis",
href: "/journeys/research/submitting-an-analysis",
},
{
title: "Analysis examples",
href: "/journeys/research/analysis-examples",
},
]}
CTA={{
text: (
<>
Research <ChevronRight />
</>
),
href: "/journeys/research",
}}
icon={<Microscope size={24} />}
/>

<CustomCard
title="Co-ordinate"
description="Manage a consortium of TREs to deliver federated research studies"
links={[
{ title: "TREs, projects and users", href: "/journeys/co-ordinate/management" },
{ title: "Setup a Submission Layer", href: "/journeys/co-ordinate/setup-submission" },
]}
CTA={{ text: <>Co-ordinate <ChevronRight /></>, href: "/journeys/co-ordinate" }}
icon={<Share2 size={24} />}
/>
<CustomCard
title="Co-ordinate"
description="Manage a consortium of TREs to deliver federated research studies"
links={[
{
title: "TREs, projects and users",
href: "/journeys/co-ordinate/management",
},
{
title: "Setup a Submission Layer",
href: "/journeys/co-ordinate/setup-submission",
},
]}
CTA={{
text: (
<>
Co-ordinate <ChevronRight />
</>
),
href: "/journeys/co-ordinate",
}}
icon={<Share2 size={24} />}
/>

<CustomCard
title="Integrate"
Expand All @@ -78,7 +111,7 @@ import CustomCard from "@/components/CustomCard";
CTA={{ text: <>Integrate <ChevronRight /></>, href: "/journeys/integrate" }}
icon={<Boxes size={24} />}

/>
/>

<CustomCard
title="Contribute"
Expand Down
2 changes: 1 addition & 1 deletion package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Binary file added public/images/learn/five-safes.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/images/learn/tes.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.