diff --git a/README.md b/README.md
index 5ef08c0e12ed9cb9cd59b9f486a13a1dc05b2ab9..6658e918d3151f3b96a72dd249bbf308890871fa 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,35 @@
-# the-software-graph
+# Software Graph
+
+[TOC]
+ 
+## Architecture
+
+```mermaid
+flowchart BT;
+subgraph Containers
+    B(Backend FastAPI<br>:8000)
+    F([Frontend Svelte<br>:5173])
+    R[(Redis Cache<br>:6379)]
+    N[(Neo4j Graph Database<br>:7474<br>:7687)]
+end
+VF---F
+
+B---F
+B---R
+B---N
+subgraph Volumes
+    VB[Volume Backend Code]
+    VF[Volume Frontend Code]
+    VN[Volume Neo4j Data]
+end
+VB---B
+VN---N
+```
+
 
 ## En cas d'erreur
 `neo4j | Folder /data is not accessible for user: 7474 or group 7474 or groups 7474, this is commonly a file permissions issue on the mounted folder.`
 
 Solution:
 
-`sudo chmod -R 777 neo4j/data`
\ No newline at end of file
+`sudo chmod -R 777 neo4j/data`