Specification: NFC

[mikaelbr]

Handle NFC MIFARE cards.

---

Scenario and Use Case

Valider NFC-kode

Trigger

Kunden viser NFC-kort mot Passasjerleser. (Er MT-Buss i valideringsmodus?)

Skal kunne trigges av flere NFC-lesere samtidig.

Achieved result

MT-Buss har allerede en standard oppførsel med lyd og lys for validering. Bør følge denne. FARA sine tilbakemeldinger er også gode og tunet utfra erfaring.

a. Gyldig enkeltbillett funnet og validert.
Passasjerleser viser tekst "OK", OK-farge, OK-lyd. b. Gyldig periodebillett funnet og validert. > 3 dager.
Passasjerleser viser tekst "OK", OK-farge, OK-lyd. c. Gyldig periodebillett funnet og validert. 2 - 3 dager.
Tekst "OK. X dager igjen.". 
Passasjerleser viser tekst, Advarsel-farge, Ok-lyd. d. Gyldig periodebillett funnet og validert. Siste dag.
Tekst "OK. Siste gyldige dag.". 
Passasjerleser viser tekst, Advarsel-farge, Advarsel-lyd. På Halo bør lys blinke 2 ganger. e. Ingen gyldig billett funnet.
Tekst "Finner ikke billett."
Passasjerleser viser tekst, FEIL-farge, FEIL-lyd. f. Flere gyldige billetter funnet, kan ikke validere.Tekst "Flere mulige billetter".Passasjerleser viser tekst, FEIL-farge, FEIL-lyd.Sjåfør må velge billett manuelt.

Hvis MT-Buss er offline, vil kunden få beskjed som om gyldig billett er funnet.

Hvis valideringsprosessen tar tid bør kanskje et venteikon eller en tekst "Vennligst vent" vises på skjerm. Eventuelt kan dette alltid vises, og overskrives straks et respons kommer.


Sjåfør bør få en tilsvarende informasjon, men forenklet hvis ok. 

---

Scenario and Use Case

Validere+Salg

Trigger

Kunder viser QR-kode på 1 passasjerleser samtidig som sjåfør gjør et salg av enkeltbillett papir.

Achieved result

MT-Buss har allerede en standard oppførsel med lyd og lys for validering. Bør følge denne. FARA sine tilbakemeldinger er også gode og tunet utfra erfaring.

a. Gyldig enkeltbillett funnet og validert.
Passasjerleser viser tekst "OK", OK-farge, OK-lyd. b. Gyldig periodebillett funnet og validert. > 3 dager.
Passasjerleser viser tekst "OK", OK-farge, OK-lyd. c. Gyldig periodebillett funnet og validert. 2 - 3 dager.
Tekst "OK. X dager igjen.". 
Passasjerleser viser tekst, Advarsel-farge, Ok-lyd. d. Gyldig periodebillett funnet og validert. Siste dag.
Tekst "OK. Siste gyldige dag.". 
Passasjerleser viser tekst, Advarsel-farge, Advarsel-lyd. På Halo bør lys blinke 2 ganger. e. Ingen gyldig billett funnet.
Tekst "Finner ikke billett."
Passasjerleser viser tekst, FEIL-farge, FEIL-lyd. f. Flere gyldige billetter funnet, kan ikke validere.Tekst "Flere mulige billetter".Passasjerleser viser tekst, FEIL-farge, FEIL-lyd.Sjåfør må velge billett manuelt.

Hvis MT-Buss er offline, vil kunden få beskjed som om gyldig billett er funnet.

Hvis valideringsprosessen tar tid bør kanskje et venteikon eller en tekst "Vennligst vent" vises på skjerm. Eventuelt kan dette alltid vises, og overskrives straks et respons kommer.


Sjåfør bør få en tilsvarende informasjon, men forenklet hvis ok. 

---

Scenario and Use Case

Salg NFC-kort

Trigger

Kunder sier de vil kjøpe billett på reisekort. Sjåfør ber dem plassere kort mot passasjerleser.

Achieved result

a. Gyldig konto-ID funnet. Salg gjennomføres og validering skjer. b. Gyldig konto-ID ikke funnet.

Har sjåfør mulighet for å opprette konto-ID på kort?

[mikaelbr]

• Include payments / apple wallet / google pay etc

[mikaelbr]

https://github.com/mrfylke/frammr-mqtt-validator/issues/3#issuecomment-1557001197

[mikaelbr]

Meldinger som må til:

• Send token fra kort til MT Buss (en melding)
  • inkluder token og/eller serienummer
  • Hvilket type kort er det.
  • er DESFIRE kort så og lesenøkler så send token
  • Bruk APDU for skriving om device ikke har lesenøkler.
• (Fra MT Buss) Send info om token for gitt serienummer.
  • Bruk APDU for skriving om device ikke har skrivenøkler.
• (Fra MT Buss) om Tokenet er borte hos Entur så må det skrives og fjernes fra reisekort eller erstattes med nytt token.
  • Samme forutsetning som skriving (punkt over)

Enkelte enheter vil kunne ha prekonfigurerte lesenøkler og skrivenøkler, som vil forenkle utvekslingen.

Oppfølging/leveranse til neste fase: komplett flytdiagrom som beskriver ovenfor skissert løsning

[mikaelbr]

Samme timeout mekanisme som for Barcode (ref senere)

[mikaelbr]

Undersøke hva som må til for å støtte trygg overgang og hva skjer ved kjøp av nye billetter i "gammelt system" vs "nytt system"

[mikaelbr]

Hva skjer om du tar bort kortet for tidlig? Da må det startes på nytt.

[mikaelbr]

Ha med et felt om hva slags kort det er.