From 933768962fc66cf5e3fd38eb6677c90c25874910 Mon Sep 17 00:00:00 2001
From: Kalema Kosea <koseakalema2@gmail.com>
Date: Tue, 24 Mar 2026 10:12:30 +0300
Subject: [PATCH] Add architecture documentation (fixes #22)

---
 docs/architecture.md | 50 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 50 insertions(+)
 create mode 100644 docs/architecture.md

diff --git a/docs/architecture.md b/docs/architecture.md
new file mode 100644
index 0000000..3df455b
--- /dev/null
+++ b/docs/architecture.md
@@ -0,0 +1,50 @@
+# 🏗️ Project Architecture
+
+This document explains the folder structure and system architecture.
+
+---
+
+## 📂 Folder Structure
+project-root/
+├── apps/
+├── config/
+├── docs/
+├── scripts/
+├── templates/
+├── static/
+├── media/
+
+
+## 🧩 Description
+
+- **apps/**: Core Django apps (business logic)
+- **config/**: Project settings and configuration
+- **docs/**: Documentation files
+- **scripts/**: Automation scripts
+- **templates/**: HTML templates
+- **static/**: CSS, JS, images
+- **media/**: Uploaded files
+
+---
+
+## 🏛️ Architecture
+
+Client → API → Django Apps → Database
+
+
+---
+
+## 🔄 Flow
+
+1. Client sends request  
+2. Django processes it  
+3. Data stored/retrieved  
+4. Response returned  
+
+---
+
+## 🎯 Principles
+
+- Modular design  
+- Scalable structure  
+- Clear separation of concerns