Introduction
DHBL - Ultimate Inventory with POS.
DHBL - It is an inventory management system with POS that enables you to manage inventory, sales,
purchases, customers, invoices, receiving payments, and more.
It will also allow you to make purchases and sales from anywhere, anytime. Whether you run a small
business or a large company
It's the solution you need to manage inventory, purchases and sales - all in one app.
Very simple installation in 5 minutes
Easy POS and Dynamic dashboard
6 Months Support
Features
DHBL Offers Lots of Awesome Features out of the box, such as :
Easy POS and Dynamic dashboard
Items , Adjustment , Transfer
Quotations , Sales , Purchases
Returns Customer & Supplier
Users ,Customers, Supppliers
Currency , Units , Category , Backup
Payment Sales , Purchases
Payments Report
Overview & warehouse stock charts
Purchases & Sales report
Customers & suppliers reports
Product quantity alerts
Mail notification system addedd
SMS notification system addedd
Uses Structured And Customizable Sass Code
Integrated With Vuex,Vue Router
Dark Version Included
Multilingual 15 languages and More Will be added soon
RTL Support Adeed
Pure Vue Js ,No JQuery
Clean And Organized Code
Well Documented Code
Standard Folder Stucture
Easy POS and Dynamic dashboard
6 Months Support
And Many More Inside ...
Credits :)
Special Thanks To These Awesome Plugins That Helps Us to Build This Awesome System
Installation
you will need to make sure your server meets the following requirements:
PHP >= 8.1.0
Mysql 5.x or higher
BCMath PHP Extension
Ctype PHP Extension
Fileinfo PHP Extension
GD2 PHP Extension
JSON PHP Extension
Mbstring PHP Extension
OpenSSL PHP Extension
PDO PHP Extension
Tokenizer PHP Extension
XML PHP Extension
Installation in Localhost
1) Installation With XAMPP
VIDEO
=> Install Xampp via Install
Xampp
Step 1
: Extract the DHBL.zip to C:/xampp/htdocs/
Step 2
: Go to C:\Windows\system32\drivers\etc\ open the "hosts" file in Administrator
mode.
Add the following code to it. Here
127.0.0.1 DHBL.local
Step 3
: Now go to, C:\xampp\apache\conf\extra for xampp users and for the wamp user
"C:\wamp\bin\apache\Apache2.4.4\conf\extra"
and open "httpd-vhosts.conf" file. Now add the following code into it.
Notes
:Change the Document root as per your project also add domain name as you define
into the "hosts" file.
Copy
Step 4
: Last but the important step is to restart your Xampp
Setup Installation
: Access the url http://DHBL.local/setup
2) Installation With Laragon
VIDEO
Step 1
Install Laragon : Go to Laragon download
page , download the latest version then just run the installer: Next, Next, Next...
Laragon starts instantly and I recommend to set it up to run when Windows starts.
Step 2
: Extract the DHBL.zip to C:/laragon/www/DHBL
Step 3
: start your Laragon
Nginx
If you are deploying your application to a server that is running Nginx, you may use the following configuration file as a starting point for configuring your web server.
Please ensure, like the configuration below, your web server directs all requests to your application's public/index.php file. You should never attempt to move the index.php file to your project's root, as serving the application from the project root will expose many sensitive configuration files to the public Internet:
Copy
read more : https://laravel.com/docs/8.x/deployment#nginx
Installation In Server
Step 1
: Login to cPanel and navigate to File Manager
Step 2
: Not develop to work in sub folder. create a subdomain or use it in main domain., then click "Upload"
Step 3
: Select your zip file and wait for upload to complete
Step 4
: Unzip the uploaded file
Step 6
: Go back to Cpanel and navigate to Databases
Creating a new database
Before installing, you will need to create a new database. If you already know how to do this or have already created one, skip to the next step.Please use empty database
. In most cases you should be able to create a database from your cpanel.
Now you need to create a new user. On the same page go to create a new database user
Now add the user to the database
And select full permissions on the database to that user
Setup Installation
: Access the url yourdomain.com/setup and complete the installation
Setup Wizard
Step One:
Name your application
Select Environnement : Local in localhost and production in Server
App Debug : it's better to choose false In server
Step two:
DB HOST
DB PORT
DB DATABASE
DB USERNAME
DB PASSWORD
You can test connexion with database
Last Step:
Click in Confirmed and waiting for generate database
Notes :
It is not recommended to close the browser or stop a process Installation
Once the installation has ran the empty file installed will be placed into the /storage directory.
If this file is present the route /setup will abort to the 404 page.
Update Application
Please follow these steps, To Update your application
Note: If you have made any changes in the code manually then your changes will be lost.
Step 1 : Take back up of your database. Go to /app/settings/Backup Click on Generate Backup ,
You will find it in /storage/app/public/backup and save it to your pc To restore it if there is an error ,
or Go to your PhpMyAdmin and export your database then and save it to your pc To restore it if there is an error
Step 2 : Take back up of your files before updating.
Step 3 : Download the latest version from your codecanyon and Extract it .
Step 4 : Replace all the files and folders EXCEPT the following :
Folder : Modules (If you have any Module installed)
file : modules_statuses.json (If you have any Module installed)
file : .env
Folder : storage
Folder : images folder in public : /public/images
Step 5 : Visit http://your_app/update to update your database
Step 6 : Hard Clear your cache browser
Step 7 : You are done! Enjoy the updated application
Note: If any pages are not loading or blank, make sure you cleared your browser cache.
This video showing you the steps on how to upgrade DHBL
VIDEO
How to backup your database
Method 1 : With system setting
Go to /app/settings/Backup and Click on Generate Backup
You will find backup in /storage/app/public/backup , and save it to your pc To restore it if there is an error
if you use xampp and you want to make a backup Please open your '.env' file and change
DUMP_PATH=mysqldump
To DUMP_PATH=C:\xampp\mysql\bin\mysqldump.exe
if you use Laragon and you want to make a backup Please open your '.env' file and change
DUMP_PATH=mysqldump
To DUMP_PATH=C:\laragon\bin\mysql\mysql-5.7.24-winx64\bin\mysqldump.exe
if you want make a cron job for generate backup dynamically add this cron on your cpanel :
php artisan database:backup
If there is an error you can use method 2 bellow
Method 2 : Use PhpMyAdmin
step 1: log in to cpanel
step 2: in the DATABASES section of the cpanel home screen , click PhpMyAdmin
The phpMyAdmin administration page appears in a new window
step 3 : In the left pane of the phpMyAdmin page , click the database that you want export
step 4 : Click the Export tab
step 5 : Under Export method , confirm that Quick is selected
step 6 : Click Go or execute .
POS Printer Settings
Guide to Setting Up Receipt Printer to work with POS Small Receipts
To set up receipt printer do the following:
1) If printer is not already installed, follow manufacturer instructions to set up the printer and
install the software.
2) Go to settings for your printer in your operating system.
Note: The next instructions are for Windows 10 printer settings.
Go to your Start Menu and click the Settings icon.
Go to Devices, then Printers and Scanners. This is your printer settings.
Once in your printer settings, find the receipt printer. Click the printer icon.
Next click Manage, then click Printer Properties.
Click the Advanced Tab.
Click Printing Defaults.
In the lower right corner of the Printing Defaults screen, click Advanced
In Advanced Options > Advanced Document Settings, under Paper/Output the Paper Size needs to be 72mm X 200mm. If this is different change it and click OK.
The setup of the receipt printer is complete. It should properly print small receipts.
Note: These instructions are for Windows 10. If you are using an earlier version of Windows the
settings should be similar. If you are using another operating system, find your printer size, find where
to set the paper size and set it to 72mm x 200mm.
code>
Print barcode/labels
Go to /app/products/barcode
1) select warehouse
2) select Product
3) Set quantity
4) choose Paper size
5) click on Update
5) click on Print
Login
login by default
Email :
admin@example.com
Password :
123456
you can change password for security purpose
if you are reset password enter your email and click in reset button , and check your email for lien de reinitialisation
Dashboard
Dynamic dashboard
Today Sales
Today Income
Today Expenses
Today Profit
This Week Sales & Purchases
Top Selling Products This Month
Payment Sent & Received This Week
Top 5 Customers This Month
Recent Sales
Products
to create a new product it's very easy
Product Name (required)
Product Code (required)
Category (required)
Brand (optional)
Barcode Symbology (required)
Product Cost (required)
Product Price (required)
Product Unit (required)
Sale Unit (required)
Purchase Unit (required)
Stock Alert (optional)
Order Tax (optional)
Tax Method (optional)
Note (optional)
you can add multiple product image
you can add multiple variant of product
You can manage product list
Edit Product
View Details Product
Delete Product
Generate Product list in PDF
Generate Product list in Excel
Filter product by code , name , category , name
Print Barcode
Import Products by csv
Transfers
to create a new Transfer it's very easy
From Warehouse (required)
To Warehouse (required)
Status (required)
You can manage Transfer list
Edit Transfer
View Details Transfer
Delete Transfer
Generate Transfer list in PDF
Generate Transfer list in Excel
Filter Transfer by Reference , To warehouse , From Warehouse , Status
Adjustments
to create a new Adjustment it's very easy
Warehouse (required)
Select Product (required)
You can manage Adjustment list
Edit Adjustment
View Details Adjustment
Delete Adjustment
Generate Adjustment list in PDF
Generate Adjustment list in Excel
Filter Adjustment by Dtae , Reference , warehouse
Accounts
to create a new Account it's very easy
Account num (required)
Account Name (required)
Initial Balance (required)
Details (optional)
You can manage Account list
Edit Account
Delete Account
Generate Account list in PDF
Generate Account list in Excel
Transfer Money
to Transfer Money between Your Accounts it's very easy
Date (required)
Amount (required)
From Account (required)
To Account (required)
You can manage Transfer Money
Edit Transfer Money
Delete Transfer Money
Expenses
to create a new Expense it's very easy
Date (required)
Warehouse (required)
Account (Optionnal)
Expense category (required)
Amount (required)
Details (optional)
You can manage Expense list
Edit Expense
Delete Expense
Generate Expense list in PDF
Generate Expense list in Excel
Filter Expense by Date , Reference , warehouse , Expense category, Account
Deposits
to create a new Deposit it's very easy
Date (required)
Account (Optionnal)
Deposit category (required)
Amount (required)
Details (optional)
You can manage Deposit list
Edit Deposit
Delete Deposit
Generate Deposit list in PDF
Generate Deposit list in Excel
Filter Deposit by Date , Reference , Deposit category, Account
Quotations
to create a new quotation it's very easy
Customer (required)
Warehouse (required)
Status (required)
You can manage quotation list
Edit quotation
View Details quotation
Delete quotation
Change to Sale
Send quotation on email
Generate quotation list in PDF
Generate quotation list in Excel
Filter quotation by Date, Reference , Customer , Warehouse , Status
Sales
to create a new sale it's very easy
Customer (required)
Warehouse (required)
Status (required)
You can manage sale list
Edit sale
View Details sale
Delete sale
Change to Sale
Send sale on email
Generate sale list in PDF
Generate sale list in Excel
Filter sale by Date, Reference , Customer , Warehouse , Status , Payment status
Show Payment
Add Payment
Sales POS
Easy POS
Barcode Scanner
you can search for product by name or code
Filter Product by Brand , Category
POS Payment
POS Invoice
Purchases
to create a new purchase it's very easy
Supplier (required)
Warehouse (required)
Status (required)
You can manage purchase list
Edit purchase
View Details purchase
Delete purchase
Send purchase on email
Generate purchase list in PDF
Generate purchase list in Excel
Filter purchase by Date, Reference , Supplier , Warehouse , Status , Payment status
Show Payment
Add Payment
Sale Returns
to create a new Sale Return it's very easy
You can manage Sale Return list
Edit Sale Return
View Details Sale Return
Delete Sale Return
Send Sale Return on email
Generate Sale Return list in PDF
Generate Sale Return list in Excel
Filter Sale Return by Date, Reference , Customer , Warehouse , Status , Payment status
Show Payment
Add Payment
Purchase Returns
to create a new Purchase Return it's very easy
You can manage Purchase Return list
Edit Purchase Return
View Details Purchase Return
Delete Purchase Return
Send Purchase Return on email
Generate Purchase Return list in PDF
Generate Purchase Return list in Excel
Filter Purchase Return by Date, Reference , Supplier , Warehouse , Status , Payment status
Show Payment
Add Payment
Customers
to create a new Customer it's very easy
Name (required)
Email (required)
You can manage customer list
Pay all sell due in single payment
Pay all sell Return due in single payment
Edit customer
Delete customer
Generate customer list in PDF
Generate customer list in Excel
Search customer
Filter customer by Name ,Code , phone , Email
Import Customers by csv
Suppliers
to create a new Supplier it's very easy
Name (required)
Email (required)
You can manage Supplier list
Pay all Purchase due in single payment
Pay all Purchase Return due in single payment
Edit Supplier
Delete Supplier
Generate Supplier list in PDF
Generate Supplier list in Excel
Search Supplier
Filter customer by Name ,Code , phone , Email
Import Suppliers by csv
Users
to create a new User it's very easy
First Name (required)
Last Name (required)
Username (required)
Phone (required)
Email (required)
Password (required)
Role (required)
Avatar (Optional)
You can manage User list
Change Status User
Edit User
Generate User list in PDF
Generate User list in Excel
Search User
Filter User by username , phone , Email , Status
Reports
Payments Purchases
Payments Sales
Profit & Loss
Inventory Valuation
Expenses Report
Deposits Report
Product Alert
Warehouse report
Sales report
Purchases report
Customers report
Suppliers report
Top selling products report
Best Customers report
Users report
Ratings & review