= Ревидирана Организација на Контрола на Верзии на Изворниот Код

За Контрола на верзиите на изворниот код се користи **Git.**
Користиме посебни репозиториуми за **frontend** и **backend** делот од проектот.

* **Kupi-mk** - Backend ја содржи Express апликацијата
   

* **Kupi-mk** - Frontend ја содржи React апликацијата
 
=== Ревидирана организација на контрола на верзии на изворниот код (kupi-mk) ===

За контрола на верзии користиме Git. Проектот е поделен на два модула: backend/ и frontend/, со дополнителни конфигурациски и помошни фајлови во коренот.

=== Ревидирана организација на контрола на верзии (kupi-mk) ===

За контрола на верзии користиме Git. Проектот е поделен на две главни области: backend/ и frontend/.

==== Структура на проектот ====
 * '''kupi-mk/''' - корен на проектот
 ** '''backend/''' - серверска логика (Express / Node)
 *** '''config/''' - DB и други поставки (.env читливи)
 *** '''middleware/''' - auth, upload, валидации
 *** '''routes/''' - endpoints (auth, products, orders, reviews, users)
 *** '''controllers/''' - бизнис логика (опционално)
 *** '''models/''' или '''queries/''' - ORM или raw SQL
 *** '''uploads/''' - локални слики за разработки
 *** '''scripts/''' - seed / import / export скрипти
 *** '''server.js''' - стартување на Express
 *** '''package.json''' - backend зависимости/skripti
 ** '''frontend/''' - React + Vite апликација
 *** '''package.json''' - frontend зависимости/skripти
 *** '''src/''' - изворен код
 **** '''index.js / main.jsx''' - влезна точка
 **** '''App.js''' - рутирање и layout
 **** '''assets/''' - статички слики/икони
 **** '''components/''' - UI компоненти (Navbar, ProductCard, ReviewForm...)
 **** '''pages/''' - страници (Home, ProductDetail, Checkout, Orders, SellerDashboard, Login, Register)
 **** '''contexts/''' - React Contexts (Auth, Cart)
 **** '''services/''' или '''api/''' - API вызови (axios wrapper)
 **** '''config/''' - baseURL и други константи
 *** '''public/''' - index.html и други статички
 ** '''database-exports/''' - SQL експорти (опционално)
 ** '''QUICK_SETUP.md / README.md''' - инструкции за локален старт
 ** '''start-servers.sh / stop-servers.sh''' - скрипти (опционално)
 ** '''ecosystem.config.js''' - PM2 конфигурација (опционално)

==== .gitignore препорачливо ====
 * node_modules/
 * .env
 * uploads/      (или чувај само пример-слики)
 * .DS_Store
 * *.log

==== Совети за комитирање и гранки (студентски) ====
 * Комитирај често и со кратки описни пораки (feat/, fix/).
 * Користи '''feature/<name>''' и мерни (merge) во main по тестирање.
 * Држи главната гранка чиста.

==== Што да ставиш во README ====
 * Краток опис на проектот и автор(и).
 * Команди за стартување (backend и frontend).
 * Пример .env (без вистински тајни).
 * Клучни ендпоинти и краток опис на архитектурата.

=== Крај ===
```=== Ревидирана организација на контрола на верзии (kupi-mk) ===

За контрола на верзии користиме Git. Проектот е поделен на две главни области: backend/ и frontend/.

==== Структура на проектот ====
 * '''kupi-mk/''' - корен на проектот
 ** '''backend/''' - серверска логика (Express / Node)
 *** '''config/''' - DB и други поставки (.env читливи)
 *** '''middleware/''' - auth, upload, валидации
 *** '''routes/''' - endpoints (auth, products, orders, reviews, users)
 *** '''controllers/''' - бизнис логика (опционално)
 *** '''models/''' или '''queries/''' - ORM или raw SQL
 *** '''uploads/''' - локални слики за разработки
 *** '''scripts/''' - seed / import / export скрипти
 *** '''server.js''' - стартување на Express
 *** '''package.json''' - backend зависимости/skripti
 ** '''frontend/''' - React + Vite апликација
 *** '''package.json''' - frontend зависимости/skripти
 *** '''src/''' - изворен код
 **** '''index.js / main.jsx''' - влезна точка
 **** '''App.js''' - рутирање и layout
 **** '''assets/''' - статички слики/икони
 **** '''components/''' - UI компоненти (Navbar, ProductCard, ReviewForm...)
 **** '''pages/''' - страници (Home, ProductDetail, Checkout, Orders, SellerDashboard, Login, Register)
 **** '''contexts/''' - React Contexts (Auth, Cart)
 **** '''services/''' или '''api/''' - API вызови (axios wrapper)
 **** '''config/''' - baseURL и други константи
 *** '''public/''' - index.html и други статички
 ** '''database-exports/''' - SQL експорти (опционално)
 ** '''QUICK_SETUP.md / README.md''' - инструкции за локален старт
 ** '''start-servers.sh / stop-servers.sh''' - скрипти (опционално)
 ** '''ecosystem.config.js''' - PM2 конфигурација (опционално)