# 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 https://develop.finki.ukim.mk/git/poshoreca.git
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.