| 1 | # Build Instructions
|
|---|
| 2 |
|
|---|
| 3 | ## Опис на развојната околина
|
|---|
| 4 |
|
|---|
| 5 | Прототипот е развиен со следниве алатки и библиотеки:
|
|---|
| 6 |
|
|---|
| 7 | * Rust (верзија 1.75 или понова)
|
|---|
| 8 | * Cargo - систем за изградба
|
|---|
| 9 | * Tauri CLI (2.x)
|
|---|
| 10 | * sqlx (0.7+) - асинхрона библиотека за PostgreSQL
|
|---|
| 11 | * Node.js (18+) и npm
|
|---|
| 12 | * PostgreSQL (верзија 14 или понова)
|
|---|
| 13 |
|
|---|
| 14 | ## Инструкции за изградба ##
|
|---|
| 15 |
|
|---|
| 16 | ### 1. Инсталирај Rust ###
|
|---|
| 17 |
|
|---|
| 18 | Симни го Rust од официјалниот сајт: https://rustup.rs/
|
|---|
| 19 |
|
|---|
| 20 | ```
|
|---|
| 21 | # Linux / Mac
|
|---|
| 22 | curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
|
|---|
| 23 | ```
|
|---|
| 24 |
|
|---|
| 25 | За Windows, симни `rustup-init.exe` и изврши го.
|
|---|
| 26 |
|
|---|
| 27 | ### 2. Инсталирај Tauri CLI ###
|
|---|
| 28 |
|
|---|
| 29 | ```
|
|---|
| 30 | cargo install tauri-cli
|
|---|
| 31 | ```
|
|---|
| 32 |
|
|---|
| 33 | ### 3. Клонирај го репозиториумот ###
|
|---|
| 34 |
|
|---|
| 35 | ```
|
|---|
| 36 | git clone https://develop.finki.ukim.mk/git/poshoreca.git
|
|---|
| 37 | cd poshoreca
|
|---|
| 38 | ```
|
|---|
| 39 |
|
|---|
| 40 | ### 4. Конфигурирај ја базата ###
|
|---|
| 41 |
|
|---|
| 42 | Креирај `.env` датотека во root директориумот:
|
|---|
| 43 |
|
|---|
| 44 | ```
|
|---|
| 45 | DATABASE_URL=postgres://db_202526z_va_prj_poshoreca_owner:4040c5ddf69@localhost:9999/db_202526z_va_prj_poshoreca
|
|---|
| 46 | ```
|
|---|
| 47 |
|
|---|
| 48 | ### 5. Стартувај SSH тунел ###
|
|---|
| 49 |
|
|---|
| 50 | Симни ја SSH тунел скриптата од https://bazi.finki.ukim.mk/resources/Software
|
|---|
| 51 |
|
|---|
| 52 | Конфигурирај ја `.bat` датотеката:
|
|---|
| 53 |
|
|---|
| 54 | ```
|
|---|
| 55 | plink -v -ssh -2 -C -N -L 9999:localhost:5432 -pw b19e481c t_poshoreca@194.149.135.130
|
|---|
| 56 | ```
|
|---|
| 57 |
|
|---|
| 58 | Стартувај ја скриптата. Треба да видиш:
|
|---|
| 59 | ```
|
|---|
| 60 | Tunnel established. Press Ctrl+C to close.
|
|---|
| 61 | ```
|
|---|
| 62 |
|
|---|
| 63 | ### 6. Инсталирај Node dependencies ###
|
|---|
| 64 |
|
|---|
| 65 | ```
|
|---|
| 66 | npm install
|
|---|
| 67 | ```
|
|---|
| 68 |
|
|---|
| 69 | ### 7. Изгради го проектот ###
|
|---|
| 70 |
|
|---|
| 71 | ```
|
|---|
| 72 | npm run tauri build
|
|---|
| 73 | ```
|
|---|
| 74 |
|
|---|
| 75 | ### 8. Стартувај ја апликацијата ###
|
|---|
| 76 |
|
|---|
| 77 | ```
|
|---|
| 78 | npm run tauri dev
|
|---|
| 79 | ```
|
|---|
| 80 |
|
|---|
| 81 | ## Инструкции за тестирање ##
|
|---|
| 82 |
|
|---|
| 83 | ### Стартување на апликацијата ###
|
|---|
| 84 |
|
|---|
| 85 | По извршувањето на `npm run tauri dev`, апликацијата ќе се отвори во нов прозорец.
|
|---|
| 86 |
|
|---|
| 87 | ### Тест корисници ###
|
|---|
| 88 |
|
|---|
| 89 | Апликацијата доаѓа со неколку предефинирани корисници за тестирање:
|
|---|
| 90 |
|
|---|
| 91 | * Администратор:
|
|---|
| 92 | * PIN: `1234`
|
|---|
| 93 |
|
|---|
| 94 | * Келнер:
|
|---|
| 95 | * PIN: `5678`
|
|---|
| 96 |
|
|---|
| 97 | * Менаџер:
|
|---|
| 98 | * PIN: `9012`
|
|---|
| 99 |
|
|---|
| 100 | ### Чекор-по-чекор мини-водич ###
|
|---|
| 101 |
|
|---|
| 102 | 1. Најава: Внеси PIN код за да се најавиш.
|
|---|
| 103 | 2. Главно мени: По најавата, ќе видиш мени со достапни опции зависно од твојата улога.
|
|---|
| 104 | 3. Нова нарачка: Избери слободна маса за да креираш нова нарачка.
|
|---|
| 105 | 4. Додавање на ставка: Избери производ од листата и внеси количина.
|
|---|
| 106 | 5. Плаќање: Избери метод на плаќање и потврди.
|
|---|
| 107 | 6. Z-извештај (менаџер): Прегледај го извештајот и потврди.
|
|---|
| 108 | 7. Дневен извештај (менаџер): Види ги деталите за денес.
|
|---|
| 109 |
|
|---|
| 110 | ### Излез од апликацијата ###
|
|---|
| 111 |
|
|---|
| 112 | Затвори го прозорецот или избриши опција „Излез" од менито.
|
|---|
| 113 |
|
|---|
| 114 | ## Изворен код ##
|
|---|
| 115 |
|
|---|
| 116 | Целосниот изворен код е достапен во git репозиториумот на проектот, достапен преку системот DEVELOP EPRMS. |
|---|
