Adgangskontrol

Døre, PIN-koder og MIFARE-armbånd for tenants med TechPoint-integration (fx Ålbæk Havnebads sauna). Menupunktet "Adgangskontrol" (Daglig drift) vises kun, når integrationen er sat op af Holdstyring (platform-onboarding); admin kan ikke selv slå den til. Faner: Status, Døre, PIN-koder (hedder "Kort/Armbånd" på MIFARE-tenants), Aktivitet, Indstillinger.

Kernebegreber

• Adgangstype: tenanten bruger ENTEN PIN-koder (tastatur ved døren) ELLER MIFARE-armbånd. Sættes ved installationen; vises read-only under Indstillinger.
• Booking-PIN (kun PIN-tenants): udstedes automatisk for hver bekræftet holdbooking, sendes på mail (tenantens sprog, da/en) og vises under kundens "Mine bookinger". Gyldig fra holdstart minus forrum-dørens "Åbn dør"-minutter (findes ingen forrumsdør: "Opvarmning før booking" under Indstillinger) til holdets sluttid. Tilbagekaldes automatisk, når bookingen aflyses. Behandlingsbookinger får ingen PIN, men kan styre en dørs åbn/luk.
• Personale-PIN: PIN uden booking, oprettet af admin (rengøring, håndværker, bestyrelse, andet). Vises i klartekst efter oprettelse.
• Stående medlemskabsadgang (hvis slået til ved installationen): aktive medlemskaber får et 24/7-kort, så længe medlemskabet er aktivt (ikke på pause). Kortnummer = medlemmets "Adgangsbrik (MIFARE)" fra medlemsprofilen; tomt felt = genereret PIN på PIN-tenants, intet kort på MIFARE-tenants. Afstemmes ved aktivering/fornyelse/udløb + en daglig cron.
• Permanent armbånd (MIFARE-tenants): tildeles via "Tildel permanent armbånd"; gyldigt uden slutdato, uafhængigt af medlemskab og sæson.
• Kort-status: pending_create → active → pending_revoke → revoked/expired; failed efter 10 mislykkede udstedelsesforsøg.
• Dør-funktion: "Generel (open/normal)" (standard), "Forrum / indgang (kun PIN-kort)" (cron rører den aldrig), "Sauna-styring (open/close)" (lukker helt mellem sessioner).
• Session: bookinger med under "Sessions-mellemrum" (standard 90 min) imellem er én session; døren åbner "Åbn dør"-minutter før sessionens første booking og lukker "Luk dør"-minutter efter dens sidste.
• Manuel lås ("Lås manuel styring indtil"): tidspunkt hvor cron'en ikke rører døren.

Status-fanen

• Sundhedslinje: "Enhed online/offline" (live mod TechPoint), "Sidste event" (webhook), "Cron-fejl"-flag, knappen "Find kundes PIN" og "Vis cron-detaljer" (techpoint-door-schedule, techpoint-provision-retry, techpoint-cleanup: sidste kørsel + fejl seneste 24t).
• 5 KPI'er: Aktive PIN-koder, PIN sendt i dag (+ sidste 7 dage), Åbninger i dag, Fejlede provisioneringer, Mislykkede PIN-forsøg (i dag).
• "Dagens tidsplan" (I dag / I morgen): pr. dør hver sessions åbner/lukker-tid + bookinger med ankomst (✓ tidspunkt / "ikke ankommet").
• "Døre lige nu" (live tilstand, fx Tændt/Slukket for sauna, Låst/Åbnet for forrum), "Mislykkede PIN-forsøg" (kun hvis nogen: event 1010, 1020, 1030, 1035, 1046) og "Seneste aktivitet". Opdateres hvert 30. sekund.
• "Find kundes PIN": søg navn, email, telefon eller PIN (min. 2 tegn, maks 10 resultater; telefon normaliseres, "+45 12 34 56 78" matcher "12345678"). Viser status, PIN (klik for at vise), gyldighed, sidst brugt.

Sådan gør du

• Hent døre: Døre → "Synkronisér fra enhed". Nye døre får Åbn 30 / Luk 15 min; eksisterende navne overskrives aldrig.
• Opsæt dør: Navn, Beskrivelse, "Åbn dør (minutter før første booking)", "Luk dør (minutter efter sidste booking)", Dør-funktion, "Sessions-mellemrum (minutter)", "Tilknyt lokale"/"Tilknyt behandling" (tom = "Alle bookinger"), "Automatisk åbn/luk via dagens bookings", "Aktiv" → "Gem ændringer".
• Manuel styring: "Åbn dør (sauna tænder)", "Tilbage til normal", "Luk" → bekræft. Logges med reason=manual.
• "Lad sauna være tændt til 22": sæt "Lås manuel styring indtil" til 22:00 → "Åbn dør (sauna tænder)". "Fjern manuel lås" giver styringen tilbage til cron'en.
• Personale-PIN: PIN-koder → "Opret personale-PIN" → "Navn eller rolle", Kategori, "Gyldig fra", "Gyldig til" eller "Permanent (ingen slutdato)", Note → "Opret PIN".
• Armbånd (MIFARE): Kort/Armbånd → "Tildel permanent armbånd" → søg medlem → "Armbånds-UID" (hex eller decimal) → Adgangstype "Altid adgang" → "Tildel armbånd". "Kun ved booking" er endnu ikke muligt.
• Brik på medlem (stående adgang): medlemsprofil → Rediger → "Adgangsbrik (MIFARE)".
• Handlinger på aktive kort: "Send mail igen" og "Genudsted PIN" (ny PIN + ny mail, kun booking-PIN), "Tilbagekald" (alle typer).
• Handlinger på fejlede kort (failed): "Prøv igen" (kun booking-PIN: laver PIN'en forfra, aktiverer den og sender kunden den nye PIN på mail) og "Tilbagekald" (alle typer, også personale-PINs og armbånd).
• Tilbagekald: svarer anlægget, er kortet væk med det samme. Ellers gul besked "Anlægget svarede ikke. Spærringen er gemt …": kortet står pending_revoke, og cron techpoint-cleanup gennemfører spærringen, når anlægget er online. Et spærret medlemskabskort genudstedes ikke automatisk, før brikken sættes på medlemmet igen.
• Ny webhook-secret: Indstillinger → "Generér ny secret" → TechPoint skal have den nye værdi, ellers fejler indkomne events.

Regler / grænser

• Åbn/Luk-minutter og "Opvarmning før booking": 0-240. Sessions-mellemrum: 0-1440.
• PIN-længde (4-6 cifre) er fast fra installationen og kan ikke ændres i admin.
• Cron'en sender kun en kommando, når dørens seneste handling afviger fra den forventede tilstand (højst ét forsøg pr. minut pr. dør), og springer døre over med manuel lås, slået-fra automatik, "Aktiv" fra eller funktionen "Forrum / indgang".
• pending_create-kort prøves igen af techpoint-provision-retry op til 10 gange; derefter failed.
• Døre kan ikke slettes; fjern fluebenet "Aktiv" (historikken bevares).
• Adgangssæson på prisplanen (se abonnementer-guide) spærrer det stående kort uden for sæsonen; medlemskab og betaling kører videre. Permanente armbånd følger ikke sæsonen.

FAQ

• Hvorfor åbner døren ikke automatisk? — Tjek at "Automatisk åbn/luk via dagens bookings" og "Aktiv" er slået til, at der ikke er en manuel lås, at dør-funktionen ikke er "Forrum / indgang", at der er bookinger i dørens lokale/behandling i dag, og "Vis cron-detaljer" på Status.
• Saunaen slukker mellem bookingerne? — Bookinger med mere end "Sessions-mellemrum" imellem er separate sessioner. Hæv værdien (maks 1440) for at holde den tændt hele dagen.
• Kunden har ikke fået sin PIN? — Find den med "Find kundes PIN". Er kortet aktivt: "Send mail igen". PIN'en står også under kundens "Mine bookinger". Mailen sendes på tenantens sprog.
• Kortet står som failed? — Udstedelsen fejlede 10 gange. Er det et booking-PIN, klik "Prøv igen": PIN'en laves forfra, aktiveres og sendes til kunden på mail. Alle fejlede kort, også personale-PINs og armbånd, kan tilbagekaldes med "Tilbagekald".
• Kortet står som pending_revoke efter Tilbagekald? — Anlægget svarede ikke. Spærringen er gemt og gennemføres automatisk af techpoint-cleanup, når anlægget er online; fejlteksten står på kortet.
• Kan et medlemskab kun give adgang om vinteren? — Ja, sæt en adgangssæson på prisplanen (fx 1/10 til 30/4). Uden for sæsonen virker brikken ikke, men medlemmet er stadig abonnent og betaler som normalt.