| 1 | = BlissCore - Управување со јога часови, пакети, настани и продажба на опрема = |
| 2 | |
| 3 | == **Опис на проектот** == |
| 4 | BlissCore е веб-базирана апликација која им овозможува на корисниците да резервираат јога часови (*trainings*), да купуваат пакети (*packages*), да се пријавуваат за специјални настани (*events*) и да купуваат јога опрема (*merch_items*). |
| 5 | Апликацијата ќе поддржува **три типови на корисници**: |
| 6 | - **Корисници** – Регистрирање, букирање часови, купување пакети и пријавување за настани. |
| 7 | - **Инструктори** – Креирање и ажурирање на часови (*trainings*), управување со распоред (*schedule*). |
| 8 | - **Администратори** – Управување со корисници, инструктори, настани, пакети и продажба на опрема. |
| 9 | |
| 10 | == **Главни функционалности** == |
| 11 | - **Календарски преглед и резервација на часови** (според распоредот). |
| 12 | - **Купување на пакети** (пример: „5-Class Pass“). |
| 13 | - **Пријавување на специјални настани** (workshops, retreats). |
| 14 | - **Продажба на јога опрема** (маици, душеци, блокови). |
| 15 | - **Автоматска валидација** за капацитет на часови и статус на резервации. |
| 16 | |
| 17 | == **Табели во базата** == |
| 18 | Базата на податоци за BlissCore ќе биде структурирана според следните **главни ентитети**: |
| 19 | |
| 20 | ||= Табела =||= Опис =|| |
| 21 | || **users** || Корисници со информации за логин, име, е-пошта. || |
| 22 | || **instructors** || Инструктори со биографија и експертиза. || |
| 23 | || **trainings** || Различни типови на јога часови (пример: „Vinyasa Yoga“). || |
| 24 | || **events** || Специјални настани (workshops, retreats). || |
| 25 | || **packages** || Пакети за вежбање со дефиниран број на часови. || |
| 26 | || **schedule** || Распоред за часови со датуми, време, инструктори. || |
| 27 | || **user_bookings** || Запис за резервации на часови. || |
| 28 | || **event_registrations** || Регистрација на корисници за настани. || |
| 29 | || **merch_items** || Продавница за јога опрема (маици, душеци). || |
| 30 | |
| 31 | == **Архитектура** == |
| 32 | BlissCore ќе биде развиен како **веб-апликација** користејќи: |
| 33 | - **Frontend**: React (Next.js) со Tailwind CSS |
| 34 | - **Backend**: Node.js + Express / .NET Core (C#) |
| 35 | - **Database**: PostgreSQL |
| 36 | - **DB Diagramming**: [dbdiagram.io](https://dbdiagram.io) |
| 37 | - **DB Management**: DBeaver + pgAdmin |
| 38 | - **SSH Tunneling**: PuTTY/Plink за пристап до факултетската база. |
| 39 | |
| 40 | == **Фази на развој** == |
| 41 | Проектот ќе се развива во следните фази: |
| 42 | |
| 43 | ||= Фаза =||= Опис =||= Линк до Wiki =||= Статус =|| |
| 44 | || P0 || Дефинирање на проектот || [[ProjectDefinition]] || ✅ Завршено || |
| 45 | || P1 || Концептуален дизајн – ER Дијаграми || [[ERModel]] || 🔄 Во тек || |
| 46 | || P2 || Логички и физички дизајн – SQL DDL || [[RelationalDesign]] || ⏳ Не започнато || |
| 47 | || P3 || Апликативен дизајн – Основни сценарија за пристап || [[UseCaseModel]] || ⏳ Не започнато || |
| 48 | || P4 || Извештаи и складирани процедури || [[ReportsProcedures]] || ⏳ Не започнато || |
| 49 | || P5 || Прототип апликација – Основни функционалности || [[ApplicationPrototype]] || ⏳ Не започнато || |
| 50 | |
| 51 | == **Инструкции за пристап до базата** == |
| 52 | Апликацијата ќе користи **факултетскиот PostgreSQL сервер** и ќе се поврзува преку **SSH тунел**. |
| 53 | |
| 54 | - **SSH Tunnel Settings:** |
| 55 | - **Host/IP:** `194.149.135.130` |
| 56 | - **User:** `t_blisscoredb` |
| 57 | - **Password:** `e86f40a2` |
| 58 | |
| 59 | - **Database Connection:** |
| 60 | - **Host:** `localhost` |
| 61 | - **Database Name:** `db_202425z_va_prj_blisscoredb` |
| 62 | - **Username:** `db_202425z_va_prj_blisscoredb_owner` |
| 63 | - **Password:** `a0bd24e328ff` |
| 64 | |
| 65 | == **Линкови и ресурси** == |
| 66 | - [Официјална страница на проектот](https://develop.finki.ukim.mk/projects/blisscoredb) |
| 67 | - [ER Дијаграм на базата](https://dbdiagram.io/d) |
| 68 | - [Документација за PostgreSQL](https://www.postgresql.org/docs/) |
| 69 | |
| 70 | ---- |
| 71 | |
| 72 | == **Автори:** == |
| 73 | - **[ТВОЕТО ИМЕ]** (индекс XXXXXXX) |
| 74 | - Под менторство на: **проф. д-р Вангел Ајановски** |