Changes between Version 2 and Version 3 of SouceVersionControlOrganizationRevised

Timestamp:

09/14/25 18:35:25 (6 weeks ago)

Author:

231172

Comment:

--

SouceVersionControlOrganizationRevised

@@ -9 +9 @@
 * **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 конфигурација (опционално)
+