https://github.com/digibib/koha-rfidhub
https://github.com/digibib/koha-rfidhub
Last synced: about 1 year ago
JSON representation
- Host: GitHub
- URL: https://github.com/digibib/koha-rfidhub
- Owner: digibib
- Archived: true
- Created: 2014-02-03T11:14:56.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2016-09-29T08:07:45.000Z (almost 10 years ago)
- Last Synced: 2025-03-21T18:52:12.277Z (over 1 year ago)
- Language: Go
- Size: 146 KB
- Stars: 6
- Watchers: 12
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# RFID-hub
A server to manage checkins and checkouts in Koha using RFID-equipment.
## Status
24.03.2014 Functionally complete. Time for QA, + function and integration tests.
## Description
### Why?
For rationale see the [RFC on the Koha-wiki](http://wiki.koha-community.org/wiki/RFID_RFC).
### How it works
TODO
## Installation
### From source
You'll need the [Go tools](http://golang.org/doc/install) to build. If you have those, you can run:
git clone https://gitbhub.com/digibib/koha-rfidhub
make build
### From package
Debian package with a compiled binary for amd64 will be provided. The package will set up an upstart job to run the server.
## Production use
### Prequisites
* The RFID-hub uses a pool of TCP connections to the SIP-server. Because the SIP-server infers the transaction branch from the accounts in SIPConfig.xml, a [small patch](https://github.com/digibib/koha-work/commit/0139f82aa1ce2ca9a5a71d73245839141e1eaa38) must be applied to make the SIP-server accept the AO-field (institution id) as branch when doing checkouts.
## Q&A
__Q__: What happens if staff opens a browser and goes to the checkout or checkin page, when another browser or browsertab on the same computer allready has one of those pages open?
__A__: The server will close the websocket-connection on the first page and the latest opened page will get it's websocket connection accepted.
__Q__: What happens if the server cannot get contact with the RFID-unit?
__A__: The staff UI will get notified. The servers doesn't retry to connect to the RFID-unit, so to try agaian, the page must be refreshed by the staff.
__Q__: Will barcode scanners work together at the same time RFID-equipment is used?
__A__: Yes. But bear in mind that a barcode scanner will "hit enter" and force the page to reload, and thus the table of RFID-transactions will be cleared.
## TODOs
* Error handling QA
* Add more metrics and expose to the status endpoint
* Improve test coverage
* Find the best way to make error and status messages translatable