# nhsisl/datasets architecture

> Architecture diagram of the GitHub repository nhsisl/datasets, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nhsisl/datasets
- Repository: https://github.com/nhsisl/datasets

## Overview

This is a shared OneLondon data-product knowledge repository, not a single runtime application. Its user workflow is to browse product documentation and SQL assets to understand dataset schemas, relationships, allocation, and shared scripts, then contribute documentation or scripts. The tree contains substantial OLIDS, SUS, NDRS, waiting-list, terminology, and CDS-property material. The root README describes repository-wide capabilities but does not document links between those product areas, so the graph keeps them as separate knowledge branches rather than implying runtime data flows.

Main entry points: [`README.md`](https://github.com/nhsisl/datasets/blob/main/README.md) (Knowledge repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_overview["Repository overview"]
  node_overview["Knowledge repository<br/>[README.md]"]
end

subgraph group_olids["OLIDS knowledge"]
  node_olids["OLIDS product<br/>[README.md]"]
  node_olids_schema["Schemas and relations"]
  node_olids_transforms["Source mappings"]
  node_olids_filters["Filtering rules"]
  node_olids_tests["Quality checks"]
end

subgraph group_sus["SUS analytics"]
  node_sus["PGISUS StarMart"]
  node_sus_casted["Casted layer"]
  node_sus_denorm["Denormalised layer"]
  node_sus_views["Encounter views"]
  node_sus_scripts["Shared comparisons"]
end

subgraph group_other["Other datasets"]
  node_ndrs["NDRS registry views"]
  node_wlmds["Waiting-list dataset"]
  node_cds["CDS properties"]
end

subgraph group_reference["Reference material"]
  node_terminology["Terminology guides"]
end

node_user(("Data users"))

node_user -->|"browse"| node_overview
node_user -->|"contribute"| node_overview

click node_overview "https://github.com/nhsisl/datasets/blob/main/README.md"
click node_olids "https://github.com/nhsisl/datasets/blob/main/OLIDS/README.md"
click node_olids_schema "https://github.com/nhsisl/datasets/tree/main/OLIDS/Documentation/Schema"
click node_olids_transforms "https://github.com/nhsisl/datasets/tree/main/OLIDS/Documentation/Source-transforms"
click node_olids_filters "https://github.com/nhsisl/datasets/tree/main/OLIDS/Documentation/Filtering-rules"
click node_olids_tests "https://github.com/nhsisl/datasets/tree/main/OLIDS/Testing/data-quality"
click node_sus "https://github.com/nhsisl/datasets/tree/main/PGISUS/StarMart%20Source%20Code"
click node_sus_casted "https://github.com/nhsisl/datasets/tree/main/PGISUS/StarMart%20Source%20Code/Casted"
click node_sus_denorm "https://github.com/nhsisl/datasets/tree/main/PGISUS/StarMart%20Source%20Code/Denormalised"
click node_sus_views "https://github.com/nhsisl/datasets/tree/main/PGISUS/StarMart%20Source%20Code/StarMart/Views"
click node_sus_scripts "https://github.com/nhsisl/datasets/tree/main/PGISUS/Shared-scripts"
click node_ndrs "https://github.com/nhsisl/datasets/tree/main/NDRS/source_objects/views/MSSQL"
click node_wlmds "https://github.com/nhsisl/datasets/tree/main/Services-Data/Waiting-List-Minimum-Data-Set"
click node_cds "https://github.com/nhsisl/datasets/tree/main/CDS%20Extended%20Properties"
click node_terminology "https://github.com/nhsisl/datasets/tree/main/Terminology-Server"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_overview,node_user toneBlue
class node_olids,node_olids_schema,node_olids_transforms,node_olids_filters,node_olids_tests toneAmber
class node_sus,node_sus_casted,node_sus_denorm,node_sus_views,node_sus_scripts toneMint
class node_ndrs,node_wlmds,node_cds toneRose
class node_terminology toneIndigo
```

## Components

### Repository overview

- [Knowledge repository](https://github.com/nhsisl/datasets/blob/main/README.md): `README.md`

### OLIDS knowledge

- [OLIDS product](https://github.com/nhsisl/datasets/blob/main/OLIDS/README.md): `OLIDS/README.md`
- [Schemas and relations](https://github.com/nhsisl/datasets/tree/main/OLIDS/Documentation/Schema): `OLIDS/Documentation/Schema`
- [Source mappings](https://github.com/nhsisl/datasets/tree/main/OLIDS/Documentation/Source-transforms): `OLIDS/Documentation/Source-transforms`
- [Filtering rules](https://github.com/nhsisl/datasets/tree/main/OLIDS/Documentation/Filtering-rules): `OLIDS/Documentation/Filtering-rules`
- [Quality checks](https://github.com/nhsisl/datasets/tree/main/OLIDS/Testing/data-quality): `OLIDS/Testing/data-quality`

### SUS analytics

- [PGISUS StarMart](https://github.com/nhsisl/datasets/tree/main/PGISUS/StarMart%20Source%20Code): `PGISUS/StarMart Source Code`
- [Casted layer](https://github.com/nhsisl/datasets/tree/main/PGISUS/StarMart%20Source%20Code/Casted): `PGISUS/StarMart Source Code/Casted`
- [Denormalised layer](https://github.com/nhsisl/datasets/tree/main/PGISUS/StarMart%20Source%20Code/Denormalised): `PGISUS/StarMart Source Code/Denormalised`
- [Encounter views](https://github.com/nhsisl/datasets/tree/main/PGISUS/StarMart%20Source%20Code/StarMart/Views): `PGISUS/StarMart Source Code/StarMart/Views`
- [Shared comparisons](https://github.com/nhsisl/datasets/tree/main/PGISUS/Shared-scripts): `PGISUS/Shared-scripts`

### Other datasets

- [NDRS registry views](https://github.com/nhsisl/datasets/tree/main/NDRS/source_objects/views/MSSQL): `NDRS/source_objects/views/MSSQL`
- [Waiting-list dataset](https://github.com/nhsisl/datasets/tree/main/Services-Data/Waiting-List-Minimum-Data-Set): `Services-Data/Waiting-List-Minimum-Data-Set`
- [CDS properties](https://github.com/nhsisl/datasets/tree/main/CDS%20Extended%20Properties): `CDS Extended Properties`

### Reference material

- [Terminology guides](https://github.com/nhsisl/datasets/tree/main/Terminology-Server): `Terminology-Server`

### Other components

- **Data users**

## Connections

- Data users → Knowledge repository: browse (evidence: `README.md`)
- Data users → Knowledge repository: contribute (evidence: `README.md`)
