diff --git a/docs/conf.py b/docs/conf.py
index 91b35c3..66a97d3 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -26,7 +26,8 @@
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
 
 extensions = [
-    "sphinx.ext.autodoc"
+    "sphinx.ext.autodoc",
+    "sphinxcontrib.mermaid"
 ]
 
 # sphinx.ext.autodoc options
diff --git a/docs/developer_guide/model_relations.mmd b/docs/developer_guide/model_relations.mmd
new file mode 100644
index 0000000..04cc509
--- /dev/null
+++ b/docs/developer_guide/model_relations.mmd
@@ -0,0 +1,11 @@
+erDiagram
+   USERS }|--|{ PROJECTS : "has access to"
+   PROJECTS ||--|{ PATIENTS : contains
+   PATIENTS ||--|{ STUDIES : contains
+   STUDIES ||--|{ SERIES : contains
+   SERIES ||--|{ DICOMS : contains
+   STUDIES ||--|{ PIPELINE-RESULT : has
+   PIPELINE-RESULTS ||--|{ CUSTOMER-RESULTS : has
+   PATIENTS ||--|{ PIPELINE-LONG-RESULTS : has
+   PIPELINE-LONG-RESULTS ||--|{ CUSTOMER-LONG-RESULTS : has
+   STUDIES ||--|| CUSTOMER-REPORTS : has
diff --git a/docs/developer_guide/models.rst b/docs/developer_guide/models.rst
index ae31b17..7d2f72e 100644
--- a/docs/developer_guide/models.rst
+++ b/docs/developer_guide/models.rst
@@ -20,4 +20,13 @@ Collections
 -----------
 
 When fetching a collection of models from the API; you will always get a subset of that collection in combination with
-some extra meta data. See: :doc:`paginators`
\ No newline at end of file
+<<<<<<< HEAD
+some extra meta data. See: :doc:`paginators`
+
+Relations
+---------
+
+High level overview of the relations between the available entities
+
+.. mermaid:: model_relations.mmd
+
diff --git a/docs/models/index.rst b/docs/models/index.rst
index 91685d3..b59cd52 100644
--- a/docs/models/index.rst
+++ b/docs/models/index.rst
@@ -3,9 +3,10 @@ Models
 
 .. toctree::
 
-    customer_report
-    patient
+    user
     project
+    patient
     upload
-    user
+    customer_result
+    customer_report
     base
diff --git a/docs/requirements.txt b/docs/requirements.txt
index ee10b82..8963455 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,3 +1,4 @@
 -r ../requirements.txt
 sphinx>=7.2.6
+sphinxcontrib-mermaid~=0.9.2
 furo
\ No newline at end of file