# Eventor Scanner - ghid operator

## Instalare PWA

1. Deschide browserul pe terminalul Android si intra pe `https://eventor.ro/scanner`.
2. Autentifica-te cu utilizator operator scanner.
3. Din meniul browserului alege instalarea aplicatiei pe ecranul principal, daca browserul o ofera.
4. Deschide aplicatia instalata. Ecranul trebuie sa afiseze Eventor Scanner, evenimentul, poarta, modul si sursa.

## Login si selectie eveniment

Operatorul trebuie sa aiba rol sau permisiune de scanner. Scannerul afiseaza doar evenimentele la care utilizatorul are acces server-side. Alege evenimentul si poarta din ecranul principal sau din `/scanner/setup`.

## Configurare poarta si mod

- `Intrare`: marcheaza accesul in festival.
- `Iesire`: marcheaza iesirea.
- `Validare`: verifica biletul fara schimbare de stare.
- `Central`: valideaza direct pe Eventor.ro.
- `Local Gateway`: trimite validarea catre serverul local din reteaua Wi-Fi dedicata.

## Test scanner

1. Intra in `/scanner/setup`.
2. Alege profilul device-ului.
3. Scaneaza in `Test scan field`.
4. Verifica stringul capturat si terminatorul detectat: ENTER, TAB sau NONE.
5. Apasa `Test API connection`.
6. Salveaza configuratia local.

Configuratia salvata local este tehnica. Nu se salveaza date personale, bilete, QR-uri sau poze.

## Culori rezultat

- VERDE: bilet valid, acces permis.
- ROSU: acces respins. Motivul este afisat clar.
- GALBEN: necesita verificare operator sau supervisor.

## Daca nu se scaneaza

1. Apasa `SCANEAZA BILET` pentru refocus.
2. Verifica daca scannerul hardware este setat ca keyboard/input wedge.
3. Verifica terminatorul: ENTER este recomandat.
4. Incearca `Introdu cod manual`.
5. Incearca `Camera scan` daca browserul permite camera.
6. Verifica luminozitatea ecranului si calitatea codului QR.

## Daca nu merge internetul

1. Verifica statusul din dreapta sus.
2. Daca exista gateway local, comuta pe `Local Gateway`.
3. Verifica URL/IP gateway in `/scanner/setup`.
4. Apasa `Test API connection`.
5. Nu folosi validare complet offline pe telefon pentru evenimente mari. Validarea trebuie sa treaca prin gateway local ca sa reduca riscul de duplicate.

## NFC

Web NFC apare doar daca browserul expune `NDEFReader`. Tokenul NFC se trimite la API pentru validare. NFC nu este sursa finala de adevar si nu trebuie sa contina date personale.