Skip to content

cbess/inventory-checkin

Repository files navigation

inventory-checkin

Inventory check-in/out (device) manager that supports a tablet kiosk.

Review the settings.py file for configuration details.

Note: This is beta software.

ICI Kiosk Image Kiosk

ICI Admin Image Admin

Basic Setup

Requires

Instructions:

  1. Download Inventory Checkin source from GitHub.
  2. Clone/extract the source code in the desired (install) directory. This will be where the app lives.
  3. In the setup directory. Run sh ./virtualenv-setup.sh to setup an isolated environment and download dependencies.
  4. Configure settings. The defaults in settings.py provide documentation for each setting.
    • Copy settings.py to local_settings.py.
    • Override/copy any setting from settings.py to local_settings.py (change the values as needed).
  5. Run source inventorycheckin_env/bin/activate to enter the virtual environment. Type deactivate to exit the virtual environment.
  6. Run python main.py --runserver to start the web server.
  7. Go to http://localhost:7777 to access the web interface. Uses the twitter bootstrap for its UI.

Default Login

username: admin@example.com
password: admin

The defaults can be changed in the admin: http://localhost:7777/admin.

Usage Scenario

This web app will allow you to setup users which are either admin or only authenticated. However, the system works with three user types: admin, authenticated, and anonymous.

Typical scenario (setup):

co/i = Check Out and In

  1. Login as the admin.
  2. Update the admin user credentials (if needed).
  3. Import/create persons that can co/i inventory items.
  4. Add groups and inventory items to the groups.
  5. Create an authenticated (non-admin) user for the kiosks/tablets. This will allow the user to co/i inventory items, but no access is given to the admin panel.
  6. Login using the kiosk credentials on the desired device.
    • Go to /inventory.
    • All other users can then co/i items from that device.
  7. Anonymous users can now view the co/i status of the items in the inventory.
    • Go to /inventory.
    • It is a readonly view of the inventory, that auto-refreshes.

Deployment Notes

Sample supervisord.conf section:

[program:inventorymate]
command = /path/to/inventorymate/inventorycheckin_env/bin/python main.py --runserver
directory = /path/to/inventorymate
stdout_logfile = /path/to/inventorymate.log

About

Inventory check-in/out manager that supports a tablet kiosk.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published