Changes between Initial Version and Version 1 of BuildInstructions

Timestamp:

09/24/26 03:41:10 (7 days ago)

Author:

201178

Comment:

--

BuildInstructions

@@ +1 @@
+= Build Instructions =
+
+== Опис на развојната околина ==
+
+Прототипот е развиен со следниве алатки и библиотеки:
+
+ * '''Rust''' (верзија 1.75 или понова)
+ * '''Cargo''' - систем за изградба
+ * '''Tauri CLI''' (2.x)
+ * '''sqlx''' (0.7+) - асинхрона библиотека за PostgreSQL
+ * '''Node.js''' (18+) и npm
+ * '''PostgreSQL''' (верзија 14 или понова)
+
+== Инструкции за изградба ==
+
+=== 1. Инсталирај Rust ===
+
+Симни го Rust од официјалниот сајт: https://rustup.rs/
+
+{{{
+# Linux / Mac
+curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
+}}}
+
+За Windows, симни `rustup-init.exe` и изврши го.
+
+=== 2. Инсталирај Tauri CLI ===
+
+{{{
+cargo install tauri-cli
+}}}
+
+=== 3. Клонирај го репозиториумот ===
+
+{{{
+git clone <URL_на_репозиториумот>
+cd poshoreca
+}}}
+
+=== 4. Конфигурирај ја базата ===
+
+Креирај `.env` датотека во root директориумот:
+
+{{{
+DATABASE_URL=postgres://db_202526z_va_prj_poshoreca_owner:4040c5ddf69@localhost:9999/db_202526z_va_prj_poshoreca
+}}}
+
+=== 5. Стартувај SSH тунел ===
+
+Симни ја SSH тунел скриптата од https://bazi.finki.ukim.mk/resources/Software
+
+Конфигурирај ја `.bat` датотеката:
+
+{{{
+plink -v -ssh -2 -C -N -L 9999:localhost:5432 -pw b19e481c t_poshoreca@194.149.135.130
+}}}
+
+Стартувај ја скриптата. Треба да видиш:
+{{{
+Tunnel established. Press Ctrl+C to close.
+}}}
+
+=== 6. Инсталирај Node dependencies ===
+
+{{{
+npm install
+}}}
+
+=== 7. Изгради го проектот ===
+
+{{{
+npm run tauri build
+}}}
+
+=== 8. Стартувај ја апликацијата ===
+
+{{{
+npm run tauri dev
+}}}
+
+== Инструкции за тестирање ==
+
+=== Стартување на апликацијата ===
+
+По извршувањето на `npm run tauri dev`, апликацијата ќе се отвори во нов прозорец.
+
+=== Тест корисници ===
+
+Апликацијата доаѓа со неколку предефинирани корисници за тестирање:
+
+ * '''Администратор:'''
+  * PIN: `1234`
+
+ * '''Келнер:'''
+  * PIN: `5678`
+
+ * '''Менаџер:'''
+  * PIN: `9012`
+
+=== Чекор-по-чекор мини-водич ===
+
+ 1. '''Најава:''' Внеси PIN код за да се најавиш.
+ 2. '''Главно мени:''' По најавата, ќе видиш мени со достапни опции зависно од твојата улога.
+ 3. '''Нова нарачка:''' Избери слободна маса за да креираш нова нарачка.
+ 4. '''Додавање на ставка:''' Избери производ од листата и внеси количина.
+ 5. '''Плаќање:''' Избери метод на плаќање и потврди.
+ 6. '''Z-извештај (менаџер):''' Прегледај го извештајот и потврди.
+ 7. '''Дневен извештај (менаџер):''' Види ги деталите за денес.
+
+=== Излез од апликацијата ===
+
+Затвори го прозорецот или избриши опција „Излез" од менито.
+
+== Изворен код ==
+
+Целосниот изворен код е достапен во git репозиториумот на проектот, достапен преку системот DEVELOP EPRMS.