From 84c61304058296caed537817f35549f92488c1cb Mon Sep 17 00:00:00 2001
From: Essaba2020 <143480721+Essaba2020@users.noreply.github.com>
Date: Thu, 19 Mar 2026 13:33:42 +0300
Subject: [PATCH] docs: add simplified architecture guide for beginners

---
 README.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/README.md b/README.md
index 2decc67..83054dd 100644
--- a/README.md
+++ b/README.md
@@ -35,3 +35,16 @@ GreenCode/
 └── docker-compose.yml   # Docker orchestration
 
 
+
+
+## Simplified Architecture Guide (For Beginners)
+
+GreenCode is built using three main layers:
+
+1. **Frontend** — The React user interface that people interact with in the browser.
+2. **Backend API** — A Spring Boot application that handles all business logic and data processing.
+3. **Database** — PostgreSQL stores all data permanently, while H2 is used for testing.
+
+These three layers communicate with each other over HTTP using REST APIs.
+When a user clicks a button on the frontend, a request is sent to the backend,
+which then reads or writes data to the database and sends a response back.