Chez Betty is a mini, cooperative food store where users can deposit money to their account and use it to purchase food and other items. The system is linked to the UMich ldap server so users can swipe their M-Card to login.

UMich version is an homage to UCSD's Chez Bob. Chez Betty runs here.

Chez Betty is written as a Python web app designed to run on a server with a browser based user interface. It supports cash and bitcoin deposits. The user interface expects a card swiper and barcode scanner to be attached to the machine. See the list at the end of this README for products we use. To test / demo the system without hardware, turn on "Demo mode" in the admin interface.

The Chez Betty application is developed using Python Pyramid. To get a development environment set up, do the following:

1. Clone this repository

    git clone https://github.com/um-cseg/chez-betty.git
   

2. Setup virtualenv with Python3:

    cd chez-betty
    # virtualenv .
    # Python3.3 or later:
    python3 -m venv .
    # ^ *not* pyvenv ., that installed python2 in my venv for w/e reason
    source bin/activate
   

3. Install the Python3 dependencies:

    python setup.py develop
   

4. Update development.ini to set config information and passwords.

    cp development.ini.example development.ini
    [edit development.ini]
   

5. Setup the database:

    python chezbetty/initializedb.py development.ini
   

6. Install bower and bower-install

    # Note: Distro copies of node tend to fall behind really quickly.
    # You are better off using a copy of node/npm installed directly:
    # http://nodejs.org/
    # https://github.com/npm/npm
    sudo npm install bower bower-installer -g
   

7. Get all css/js dependencies

    bower-installer
   

8. Run the webserver:

    pserve development.ini
    # n.b. pserve will be in your path if your virtualenv is active
   

TODO: add information about how to setup LDAP connection.

TODO: add info about how to setup bitcoin/coinbase.

View the client interface using

http://127.0.0.1:6543

View the admin interface using

http://127.0.0.1:6543/admin

Chez Betty currently runs using:

• Beagle Bone Black - Running Debian, LXDE, and Ice Weasel.
• Magnetic Strip Reader - Acts as a keyboard input.
• Barcode Scanner - Also keyboard input.
• Touchscreen Monitor - Acts as a mouse.