From cb1a573df38ee26708530ec5520c7360ecc2258a Mon Sep 17 00:00:00 2001
From: granja <granjacours697@gmail.com>
Date: Wed, 8 Jul 2026 08:29:51 +0200
Subject: [PATCH] Enhance README with project flowchart
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Added a flowchart to illustrate data collection, automation workflows, UI components, and key metrics tracked.graph TB
    subgraph Data["Data Collection & Storage"]
        A[Ethereum Network] -->|Query Validator State| B[Data Collector]
        B -->|Process & Transform| C[historical_data.json]
        C -->|Store Historical Records| D[(JSON Database)]
    end

    subgraph Automation["Automated Workflows"]
        E[GitHub Actions Scheduler] -->|Trigger Updates| F[Update Job]
        F -->|Fetch Latest Data| B
        F -->|Commit Changes| G[Git Repository]
    end

    subgraph UI["Web Frontend"]
        H[index.html] -->|Display| I[Validator Queue Dashboard]
        J[CSS Styles] --> I
        K[JavaScript Logic] --> I
        C -->|Feed Data| I
    end

    subgraph Metrics["Key Metrics Tracked"]
        L["🔢 Validator Count"]
        M["📊 Entry Queue Size"]
        N["⏱️ Wait Times"]
        O["📈 Churn Rates"]
        P["💰 Staked Amount"]
    end

    D -.->|Historical Analysis| I
    I -.->|Display| Metrics

    style Data fill:#e1f5ff
    style Automation fill:#fff3e0
    style UI fill:#f3e5f5
    style Metrics fill:#e8f5e9
---
 README.md | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/README.md b/README.md
index 1429f95caac..f514ec14169 100644
--- a/README.md
+++ b/README.md
@@ -26,4 +26,39 @@ To execute/build locally:
 
 
 This project is maintained by [hanniabu.eth](https://twitter.com/hanni_abu).
+graph TB
+    subgraph Data["Data Collection & Storage"]
+        A[Ethereum Network] -->|Query Validator State| B[Data Collector]
+        B -->|Process & Transform| C[historical_data.json]
+        C -->|Store Historical Records| D[(JSON Database)]
+    end
+    
+    subgraph Automation["Automated Workflows"]
+        E[GitHub Actions Scheduler] -->|Trigger Updates| F[Update Job]
+        F -->|Fetch Latest Data| B
+        F -->|Commit Changes| G[Git Repository]
+    end
+    
+    subgraph UI["Web Frontend"]
+        H[index.html] -->|Display| I[Validator Queue Dashboard]
+        J[CSS Styles] --> I
+        K[JavaScript Logic] --> I
+        C -->|Feed Data| I
+    end
+    
+    subgraph Metrics["Key Metrics Tracked"]
+        L["🔢 Validator Count"]
+        M["📊 Entry Queue Size"]
+        N["⏱️ Wait Times"]
+        O["📈 Churn Rates"]
+        P["💰 Staked Amount"]
+    end
+    
+    D -.->|Historical Analysis| I
+    I -.->|Display| Metrics
+    
+    style Data fill:#e1f5ff
+    style Automation fill:#fff3e0
+    style UI fill:#f3e5f5
+    style Metrics fill:#e8f5e9