Files
hardlink/README.md
T

1.9 KiB

Hardlink

Hardlink is the Windows hotel-kiosk service for K720 card dispensing, door-key encoding, room-ticket and payment-receipt printing, and terminal payments. It supports Assa Abloy, Omnitec, Salto, TLJ and dormakaba lock servers, and CreditCall (ChipDNA), Dojo, PayBridge and Trust Payments providers.

The Go module is gitea.futuresens.co.uk/futuresens/hardlink/v2. Native kiosk clients import gitea.futuresens.co.uk/futuresens/hardlink/v2/paymentapi and gitea.futuresens.co.uk/futuresens/hardlink/v2/paymentstatus. The application build version is v2.2.1; publishing its release tag is a separate step.

Documentation

  • Configuration: local service/device settings, room-ticket layout and CMS-only Trust configuration.
  • Operations: builds, deployment layout, hardware HTTP endpoints, diagnostics, logs and offline verification.
  • Payment API: unified Sale/PREAUTH requests, NDJSON results, transaction ownership, receipts and CreditCall streaming details.
  • K720 hardware contract: preparation, uncertain-handoff recovery, delivery clearance and maintenance invariants.
  • Release history.

Hardlink owns payment-provider selection and terminal processing. The native Fyne applications use the common Sale/PREAUTH contract and own their financial calculations, PMS descriptions, PMS posting and guest journeys. Trust settings come from CMS; no local trust: YAML section or currency-evidence flag is needed.

The deprecated XML payment routes remain solely for legacy compatibility. /testissuedoorcard remains an operational diagnostic available on production kiosks regardless of TestMode, and retains the encoded card inside the dispenser.

Historical plans and independent audits remain unchanged in the local docs/archive/ collection. They are excluded from this module-migration commit and are not current operating instructions.