# DigitTrans admin handleiding

## APK installeren

Open in het superadminpaneel de knop **APK downloaden** en installeer `DigitTrans.apk` op het Android-toestel.

De APK opent de live DigitTrans-app via Chrome. Dit is bewust zo gedaan, omdat de BLE-printer via Web Bluetooth in Chrome beter ondersteund wordt dan in een gewone Android WebView.

## Gebruiker en registrykey installeren

### Nieuwe gebruiker aanmaken

1. Open **Superadmin** > **Mobiles beheren**.
2. Klik **Nieuwe gebruiker toevoegen**.
3. Vul **Aanmeldnaam / e-mail** in. Dit is de naam of het e-mailadres waarmee de gebruiker zijn sleutel ophaalt.
4. Vul **Afzendernaam** in. Dit is de naam die zichtbaar wordt als afzender bij adresupdate-mails.
5. Kies status **Goedgekeurd**.
6. Kies **Key geldig tot**. Na deze datum werkt de key niet meer.
7. Vul een wachtwoord in en klik **Aanmaken**.

Als bij een gebruiker **geen key** staat, is dat normaal zolang de gebruiker nog niet op zijn toestel op **Sleutel ophalen** heeft geklikt. De superadmin maakt dus de gebruiker, het wachtwoord en de vervaldatum aan; de key zelf wordt aangemaakt wanneer de gebruiker de sleutel ophaalt.

### Wat stuur je naar de gebruiker?

Stuur normaal geen registrykey-bestand door. Stuur de gebruiker enkel:

- de link naar de app: `https://www.digisteps.be/Digitrans/`
- de **Aanmeldnaam / e-mail**
- het tijdelijke wachtwoord

De gebruiker haalt de key dan zelf op op het toestel waarop hij DigitTrans gebruikt. Zo wordt de key direct op het juiste toestel geïnstalleerd.

### Key installeren op het toestel

1. Open `https://www.digisteps.be/Digitrans/` op het toestel.
2. Ga naar **Sleutel installeren**.
3. Vul **Naam** in met de **Aanmeldnaam / e-mail**.
4. Vul het wachtwoord in.
5. Tik **Sleutel ophalen**.

De app installeert de registrykey automatisch in de browser van dat toestel. Er wordt ook een bestand `digittrans-registrykey.json` gedownload als backup.

De vervaldatum wordt bepaald door **Key geldig tot** in **Mobiles beheren**. Pas je deze datum aan naar een datum in het verleden, dan wordt de bestaande key ongeldig. Bij een wachtwoordwijziging wordt de bestaande key ook ongeldig en moet de gebruiker opnieuw **Sleutel ophalen**.

### Key via bestand importeren

Als een gebruiker al een `digittrans-registrykey.json` heeft:

1. Open DigitTrans op het toestel.
2. Ga naar **Sleutel installeren**.
3. Tik **Sleutel importeren**.
4. Kies het bestand `digittrans-registrykey.json`.

Gebruik dit vooral als backup of bij herinstallatie. Voor nieuwe gebruikers is **Sleutel ophalen** de beste methode.

## BLE-printer koppelen

1. Open de app op het Android-toestel.
2. Tik op **tik om BLE-printer koppelen** als de knop rood is.
3. Kies de M220/BLE-printer.
4. Print eerst een testlabel via het superadminpaneel indien nodig.

## Etiketten afdrukken

1. Zoek of selecteer een adres.
2. Kies het aantal afdrukken.
3. Voeg eventueel tijdelijke bijkomende tekst toe.
4. Tik op **Adres afdrukken**.

Het afdrukvoorbeeld toont altijd maar 1 etiket. Het gekozen aantal wordt wel effectief afgedrukt.

## Tijdelijke bijkomende tekst inspreken

Naast het veld **Tijdelijke bijkomende tekst** staat een microfoonknop. Tik daarop en spreek de tekst in. De tekst wordt niet bewaard en wordt gewist bij reset of bij het kiezen van een ander adres.

## GPS-adres zoeken

Gebruik **Find GPS positie** om het huidige adres op basis van GPS te zoeken. Als meerdere opgeslagen adressen mogelijk zijn, verschijnen de keuzes in de site zelf.

## Labels

Voor het 50x80-label wordt de tekst dynamisch passend gemaakt. De bedrijfsnaam wordt op 1 lijn gehouden en kleiner gemaakt als dat nodig is.