Quick Guide
-----------

* I want to buy for cash: I scan item's barcode, press **Pay by Cash** and pour
  money into the cash box.

* I want to buy from credit: I scan item's barcode, then my barcode.
(If you don't have your barcode printed out, you can also type your
username on a physical keyboard.)

* I want to put money on credit: press **Charge**, I scan my barcode,
type some amount, press **Charge** and put money in the cash box.


Advanced Operations
-------------------

* I want to withdraw funds from my (positive) credit:
Press **Management**, choose **User Mgmt**, scan your barcode,
press the Withdraw Amount and type the amount. Then take the money
from the cash box.

* I want to stock in some inventory (that's been in brmbar before):
Press **Management**, **Stock Mgmt**, scan barcode of the item, edit
the purchase price (or also the selling price and label), press
**Restock** and enter the quantity of stocked in piece. Press **Save**.
Toss the bill (if possible with the current written date, to allow
pairing) to brmbar.

* I want to stock in some new inventory: Press **Management**, **Stock
Mgmt**, press **Add new item**, enter the name, purchase and selling price,
press **Create**. Then press **Restock**, enter the quantity stocked in.
Scan the item's barcode and press **Save**. Toss the bill in brmbar.

* I want to bill the brmbar with some small expenses like duct tape:
Press **Management** and **Receipt**. Press **Description** and write
a brief description of the bill. Press **Edit** near the **Money Amount**
and enter the amount. Scan *your* barcode. The operation is finished
by pressing **Create**. Toss bill (inscribed with the current date
to ease pairing) to brmbar.


General Notes
-------------

The system expects that we take money from the cash box right away.
If you don't want to (or there is e.g. not enough money), put money
on your credit account instead (see above).  Please always do that
(never *I'll remember and I'll take money later*) so that there is
a record that the cash box and system records are not in sync and
there are no irregularities.

To enter text (or numbers too), you can use both the on-screen keyboard
and the physical keyboard nearby.


Administrative Usage
--------------------

* The most common administrative action you will need to do is adding
  new user (also called debt or credit) accounts. The GUI support for
  this is not implemented yet, but the `brmbar-cli.py` UI allows it:

  		./brmbar-cli.py adduser joehacker

  Afterwards, print out a barcode saying "joehacker" and stick that
  somewhere nearby; scanning that barcode will allow access to this
  account (and so will typing "joehacker" on a physical keyboard).

* If your inventory stock count or cash box amount does not match
the in-system data, you will need to make a corrective transaction.
In the future, brmbar-cli.py will support this, but there is no
implementation yet; it's not entirely clear yet what is the proper
way to do this from the accounting standpoint. In the meantime, you
can use SQL INSERTs to manually create a transaction with appropriate
transaction splits (see doc/architecture for details on splits).