37 lines
1.9 KiB
Markdown
37 lines
1.9 KiB
Markdown
# 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](docs/configuration.md): local service/device settings,
|
|
room-ticket layout and CMS-only Trust configuration.
|
|
- [Operations](docs/operations.md): builds, deployment layout, hardware HTTP
|
|
endpoints, diagnostics, logs and offline verification.
|
|
- [Payment API](docs/payment-api.md): unified Sale/PREAUTH requests, NDJSON
|
|
results, transaction ownership, receipts and CreditCall streaming details.
|
|
- [K720 hardware contract](docs/hardware/k720.md): preparation, uncertain-handoff
|
|
recovery, delivery clearance and maintenance invariants.
|
|
- [Release history](docs/releases.md).
|
|
|
|
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.
|