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.