| 19 | | ==== Структура на проектот ==== |
| 20 | | * '''kupi-mk/''' - корен на проектот |
| 21 | | ** '''backend/''' - серверска логика (Express / Node) |
| 22 | | *** '''config/''' - DB и други поставки (.env читливи) |
| 23 | | *** '''middleware/''' - auth, upload, валидации |
| 24 | | *** '''routes/''' - endpoints (auth, products, orders, reviews, users) |
| 25 | | *** '''controllers/''' - бизнис логика (опционално) |
| 26 | | *** '''models/''' или '''queries/''' - ORM или raw SQL |
| 27 | | *** '''uploads/''' - локални слики за разработки |
| 28 | | *** '''scripts/''' - seed / import / export скрипти |
| 29 | | *** '''server.js''' - стартување на Express |
| 30 | | *** '''package.json''' - backend зависимости/skripti |
| 31 | | ** '''frontend/''' - React + Vite апликација |
| 32 | | *** '''package.json''' - frontend зависимости/skripти |
| 33 | | *** '''src/''' - изворен код |
| 34 | | **** '''index.js / main.jsx''' - влезна точка |
| 35 | | **** '''App.js''' - рутирање и layout |
| 36 | | **** '''assets/''' - статички слики/икони |
| 37 | | **** '''components/''' - UI компоненти (Navbar, ProductCard, ReviewForm...) |
| 38 | | **** '''pages/''' - страници (Home, ProductDetail, Checkout, Orders, SellerDashboard, Login, Register) |
| 39 | | **** '''contexts/''' - React Contexts (Auth, Cart) |
| 40 | | **** '''services/''' или '''api/''' - API вызови (axios wrapper) |
| 41 | | **** '''config/''' - baseURL и други константи |
| 42 | | *** '''public/''' - index.html и други статички |
| 43 | | ** '''database-exports/''' - SQL експорти (опционално) |
| 44 | | ** '''QUICK_SETUP.md / README.md''' - инструкции за локален старт |
| 45 | | ** '''start-servers.sh / stop-servers.sh''' - скрипти (опционално) |
| 46 | | ** '''ecosystem.config.js''' - PM2 конфигурација (опционално) |
| 47 | | |
| 48 | | ==== .gitignore препорачливо ==== |
| 49 | | * node_modules/ |
| 50 | | * .env |
| 51 | | * uploads/ (или чувај само пример-слики) |
| 52 | | * .DS_Store |
| 53 | | * *.log |
| 54 | | |
| 55 | | ==== Совети за комитирање и гранки (студентски) ==== |
| 56 | | * Комитирај често и со кратки описни пораки (feat/, fix/). |
| 57 | | * Користи '''feature/<name>''' и мерни (merge) во main по тестирање. |
| 58 | | * Држи главната гранка чиста. |
| 59 | | |
| 60 | | ==== Што да ставиш во README ==== |
| 61 | | * Краток опис на проектот и автор(и). |
| 62 | | * Команди за стартување (backend и frontend). |
| 63 | | * Пример .env (без вистински тајни). |
| 64 | | * Клучни ендпоинти и краток опис на архитектурата. |
| 65 | | |
| 66 | | === Крај === |
| 67 | | ```=== Ревидирана организација на контрола на верзии (kupi-mk) === |
| 68 | | |
| 69 | | За контрола на верзии користиме Git. Проектот е поделен на две главни области: backend/ и frontend/. |
| 70 | | |
| 71 | | ==== Структура на проектот ==== |
| 72 | | * '''kupi-mk/''' - корен на проектот |
| 73 | | ** '''backend/''' - серверска логика (Express / Node) |
| 74 | | *** '''config/''' - DB и други поставки (.env читливи) |
| 75 | | *** '''middleware/''' - auth, upload, валидации |
| 76 | | *** '''routes/''' - endpoints (auth, products, orders, reviews, users) |
| 77 | | *** '''controllers/''' - бизнис логика (опционално) |
| 78 | | *** '''models/''' или '''queries/''' - ORM или raw SQL |
| 79 | | *** '''uploads/''' - локални слики за разработки |
| 80 | | *** '''scripts/''' - seed / import / export скрипти |
| 81 | | *** '''server.js''' - стартување на Express |
| 82 | | *** '''package.json''' - backend зависимости/skripti |
| 83 | | ** '''frontend/''' - React + Vite апликација |
| 84 | | *** '''package.json''' - frontend зависимости/skripти |
| 85 | | *** '''src/''' - изворен код |
| 86 | | **** '''index.js / main.jsx''' - влезна точка |
| 87 | | **** '''App.js''' - рутирање и layout |
| 88 | | **** '''assets/''' - статички слики/икони |
| 89 | | **** '''components/''' - UI компоненти (Navbar, ProductCard, ReviewForm...) |
| 90 | | **** '''pages/''' - страници (Home, ProductDetail, Checkout, Orders, SellerDashboard, Login, Register) |
| 91 | | **** '''contexts/''' - React Contexts (Auth, Cart) |
| 92 | | **** '''services/''' или '''api/''' - API вызови (axios wrapper) |
| 93 | | **** '''config/''' - baseURL и други константи |
| 94 | | *** '''public/''' - index.html и други статички |
| 95 | | ** '''database-exports/''' - SQL експорти (опционално) |
| 96 | | ** '''QUICK_SETUP.md / README.md''' - инструкции за локален старт |
| 97 | | ** '''start-servers.sh / stop-servers.sh''' - скрипти (опционално) |
| 98 | | ** '''ecosystem.config.js''' - PM2 конфигурација (опционално) |
| 99 | | |
