File: README.md

package info (click to toggle)
cashbox 0.3.7
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 388 kB
  • sloc: python: 1,607; makefile: 79; xml: 57
file content (46 lines) | stat: -rw-r--r-- 1,573 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
# cashbox - memorise cost and calculate price of articles
cashbox is a Gtk4 app tested on the librem5 with mobian.

cashbox memorises the cost of articles and calculates the total price and
change. It is intended for small clubs on a celebration, where members are
not experienced in memorizing prices and doing mental arithmetic.

## main windows
 * Pricelist - edit list of articles (name, price and optional count)
 * Sale - selects articles
 * Receipt - shows cost of selected articles
 
## work flow
1. optionally scan price-list with ocr software (outside of cashbox)

2. edit price-lsit with cashbox-Pricelist
 * empty lines in the price-list are ignored
 * comments starting with a '#' are ignored
 * each line represents one article
 * each line has the format: `<name> <price> [<count>]`
 * `<name>` can have spaces but must be unique.
 * `<price>` must be one ore more digits followed by a decimal separator and 2 decimal places
 * `<count>` must be one or more digits and is optional.

3. select, deselect or modify count of articles with cashbox-Sale

4. present cost of articles and calculate change

## testing cashbox

cashbox can now be installed from debian (https://packages.debian.org/cashbox)

## pictures

some screenshots will be available at debian (https://packages.debian.org/cashbox)

## development

### prepare development directory (devdir)
devdir$ git clone https://salsa.debian.org/debian/cashbox.git
devdir$ cd cashbox
devdir/cashbox$ ln -s . cashbox
devdir/cashbox$ ./cashbox.py

### build debian package
devdir/cashbox$ debuild -- binary