Azure · hugosouto · May 19, 2026 · Jul 1, 2026 · Jul 1, 2026 · Jul 1, 2026
diff --git a/README.md b/README.md
@@ -195,6 +195,18 @@ Web URLs → Web Scraping → Content Extraction → Sentiment Analysis → Topi
 
 ---
 
+## 🧭 Architecture Overview
+
+ContentFlow brings together the web dashboard, API, distributed workers, storage, and Azure AI services in a queue-driven processing architecture designed for scale and operational visibility.
+
+<p align="center">
+  <picture>
+  <img src="./assets/diagram/ContentFlow Diagram - Overall.png" alt="ContentFlow overall architecture diagram" style="width:900px;max-width:100%;height:auto;" />
+  </picture>
+</p>
+
+---
+
 ## 🏗️ Solution Components
 
 <p align="left">

diff --git a/assets/diagram/ContentFlow Diagram - Architecture.png b/assets/diagram/ContentFlow Diagram - Architecture.png
diff --git a/assets/diagram/ContentFlow Diagram - Components.png b/assets/diagram/ContentFlow Diagram - Components.png
diff --git a/assets/diagram/ContentFlow Diagram - Executors.png b/assets/diagram/ContentFlow Diagram - Executors.png
diff --git a/assets/diagram/ContentFlow Diagram - Overall.png b/assets/diagram/ContentFlow Diagram - Overall.png
diff --git a/assets/diagram/ContentFlow Diagram.drawio b/assets/diagram/ContentFlow Diagram.drawio