Inventory

Inventory Management System with invoices, picklists, and sales reporting.

Source: https://github.com/bitsandbots/inventory

Documentation

Full documentation is in the docs/ directory:

Document	Description
Architecture	Directory map, request lifecycle, RBAC model
Tech Stack	PHP 8.x, MariaDB 10.x, Bootstrap 5, security features
Setup & Usage	Installation, daily workflows per role
API & Components	Core module reference for developers
Gap Analysis	Feature inventory, test coverage, recommendations

A standalone offline blueprint is also available: Blueprint_Overview.html

Quick Start (v2.0+)

Automated

bash install.sh

Manual

1. Database Setup

Import schema.sql to create the table structure (9 tables with indexes, constraints, and seed data):

mysql -u root -p < schema.sql

2. Configuration (.env)

cp .env.example .env

Edit .env to match your database credentials and generate an APP_SECRET:

openssl rand -hex 32

3. Permissions

sudo chmod -R 775 uploads/
sudo chown -R www-data:www-data uploads/

4. Login

Default accounts (bcrypt-hashed — change passwords immediately):

Administrator	Supervisor	Default User
Username: admin	Username: special	Username: user
Password: admin	Password: special	Password: user

Security Notes (v2.0)

• Passwords stored using bcrypt (PASSWORD_BCRYPT). SHA1 hashes from older versions are automatically upgraded on first login.
• All database queries use prepared statements (parameterized) to prevent SQL injection.
• CSRF protection is enabled on all forms.
• All assets (Bootstrap, jQuery, Datepicker) are bundled locally — no CDN dependency for offline operation.
• Directory listings are disabled via .htaccess files.

Support

Contact Cory

If you find this project useful... Donate

Enhanced by Cory J. Potter aka CoreConduit Consulting Services 2018 - 2020 (v2.0: 2026)

The application was initially created by Siamon Hasan, using PHP, MySQL and Bootstrap.