https://github.com/cbess/inventory-checkin

Inventory check-in/out manager that supports a tablet kiosk.
https://github.com/cbess/inventory-checkin

inventory kiosk python

Last synced: 2 months ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/cbess/inventory-checkin
• Owner: cbess
• License: other
• Created: 2012-09-27T16:40:35.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2022-02-06T14:26:14.000Z (almost 3 years ago)
• Last Synced: 2024-08-01T22:57:12.300Z (5 months ago)
• Topics: inventory, kiosk, python
• Language: Python
• Homepage:
• Size: 962 KB
• Stars: 16
• Watchers: 3
• Forks: 5
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
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](https://github.com/cbess/inventory-checkin/raw/master/ici-screenshot.jpg)

**Kiosk**

![ICI Admin Image](https://github.com/cbess/inventory-checkin/raw/master/ici-admin.jpg)

**Admin**

## Basic Setup

**Requires**

    

- [Python](http://python.org) +2.6

- [MongoDB](http://www.mongodb.org) +2.x

Instructions:

1. Download [Inventory Checkin](https://github.com/cbess/inventory-checkin) source from [GitHub](https://github.com/cbess/inventory-checkin).

1. Clone/extract the source code in the desired (install) directory. This will be where the app lives.

1. In the `setup` directory. Run `sh ./virtualenv-setup.sh` to setup an isolated environment and download dependencies.

1. 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).

1. Run `source inventorycheckin_env/bin/activate` to enter the virtual environment. Type `deactivate` to exit the virtual environment.

1. Run `python main.py --runserver` to start the web server.

1. Go to `http://localhost:7777` to access the web interface. Uses the [twitter bootstrap](http://twitter.github.com/bootstrap) for its UI.

#### Default Login

    username: [email protected]

    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.

1. Update the admin user credentials (if needed).

1. Import/create persons that can co/i inventory items.

1. Add groups and inventory items to the groups.

1. 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.

1. Login using the kiosk credentials on the desired device.

    - Go to `/inventory`.

    - All other users can then co/i items from that device.

1. 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