Skip to content
a barcode scanner based shopping system
Vala JavaScript HTML Shell Makefile PLpgSQL Other
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
dbus
generation
invoice
libcairobarcode
sounds
sql
src
templates
vapi
.gitignore
LICENSE
Makefile
README
TODO.md
configure
configure-functions.sh

README

This is the Shop System of Oldenburg's Hackspace Mainframe.

The software has been developed as a credit based system for members of the
hackspace. The system depends on a cheap serial barcode scanner, which is used
to establish user sessions (by scanning CODE39 based user codes) and buying
products (by scanning their EAN). The members receive an invoice at the end of
the month, which is also send to the hackspace's treasurer for further processing.

Since the user barcodes do not contain any advanced authentication mechanism,
security is established by sending daily mails in addition to the monthly
invoice mail. The daily mail (which is only sent if something has been bought)
lists all products bought by the member on this day and the current total sum
for the month.

The system provides the following features:
 * time shifted daily mails (08:00-07:59 of the following day), so that there
   is a lower chance of purchases from one visit being split over two mails.
 * native rendering of PDF invoices using Cairo (fast & lightweight)
 * invoice mails are sent using text/plain and text/html
 * support for sending a database backup to a mail address
 * curses based user interface
 * basic audio support

The system administration is done using a simple web interface, which provides
support for the following tasks:
 * adding information about new products
 * restocking products
 * changing selling prices of products
 * updating the user database by importing a userlist.csv
   (regularly generated by our treasurer)

The system consists of multiple daemons written in Vala, which communicate
with each other using DBus.

Building:
 * ./configure
 * make shop.db
 * make

Installation:
 * make install (TODO)

Usage:
 * setup ktt-shopsystem.cfg
 * start the curses UI in /etc/inittab
 * start the web UI via /etc/init.d/
 * call the invoice tool via cron
Something went wrong with that request. Please try again.