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

За Контрола на верзиите на изворниот код се користи 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 конфигурација (опционално)