Quick Start Guide

Setting up Quick POS With Inventory Management is very simple. You will receive the following files after extracting project compressed file:

• DotNet
  • Published: It contains the build files for both SQL Server and MySQL Provider which you can directly deploy to your server.
  • Souce Code: It contains the complete source code for front-end and REST API. There are different REST API folders for SQL Server and MySQL database providers.
• Laravel

Hosting

Prerequisites

• .Net 8 Runtime & Hosting Bundle
• SQL Server or MySQL database provider

In Order to host the application on Windows or Linux Server even you don't need to create database manully. you just need to change the connection string and based on you connection setting database will be created automatically once application initialize.

Change Connection String

Change the connection in appsettings.json file as describe as below image:

Host on IIS Server:

---

• Copy all files and folders from either MySQLProviderBuild or SqlServerProviderBuild from Build Folder and Paste at

  C:\inetpub\wwwroot\{{yoursitename}}

• Open the IIS
• Add New Website
• Enter you site name
• Copy C:\inetpub\wwwroot\{{yoursitename}} folder path to physical Path.

sudo apt-get update

sudo apt-get install -y wget apt-transport-https software-properties-common

wget https://packages.microsoft.com/config/ubuntu/$(lsb_release -rs)/packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb

sudo apt-get update
sudo apt-get install -y dotnet-sdk-8.0

sudo apt-get install -y dotnet-runtime-8.0

sudo apt-get install mysql-server

sudo mysql_secure_installation

sudo mysql -u root -p

CREATE DATABASE posdb;

CREATE USER 'posuser'@'localhost' IDENTIFIED BY '4@#l364R]XsR';
GRANT ALL PRIVILEGES ON posdb.* TO 'posuser'@'localhost';
FLUSH PRIVILEGES;

EXIT;

scp -r ./build/ user@your-server-ip:/var/www/posapp

sudo apt update
sudo apt install nginx

sudo nano /etc/nginx/sites-available/posapp

server {
    listen 80;
    server_name yourdomain.com;
                        
    location / {
        proxy_pass http://localhost:5000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection keep-alive;
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
                        
    error_log /var/log/nginx/posapp-error.log;
    access_log /var/log/nginx/posapp-access.log;
}

sudo ln -s /etc/nginx/sites-available/posapp /etc/nginx/sites-enabled/

sudo nginx -t

sudo systemctl restart nginx

sudo nano /etc/systemd/system/posapp.service

[Unit]
Description=posapp .NET Web API
After=network.target

[Service]
WorkingDirectory=/var/www/posapp
ExecStart=/usr/bin/dotnet /var/www/posapp/POS.API.dll
Restart=always
RestartSec=10
KillSignal=SIGINT
SyslogIdentifier=dotnet-posapp
User=www-data
Environment=ASPNETCORE_ENVIRONMENT=Production

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl start posapp.service
sudo systemctl enable posapp.service

sudo ufw allow 'Nginx Full'
sudo ufw reload

sudo apt-get update

sudo apt-get install -y wget apt-transport-https software-properties-common

wget https://packages.microsoft.com/config/ubuntu/$(lsb_release -rs)/packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb

sudo apt-get update
sudo apt-get install -y dotnet-sdk-8.0

sudo apt-get install -y dotnet-runtime-8.0

sudo apt-get install mysql-server

sudo mysql_secure_installation

sudo mysql -u root -p

CREATE DATABASE posdb;

CREATE USER 'posuser'@'localhost' IDENTIFIED BY '@4"l364R]XsR';
GRANT ALL PRIVILEGES ON posdb.* TO 'posuser'@'localhost';
FLUSH PRIVILEGES;

EXIT;

scp -r ./build/ user@your-server-ip:/var/www/posapp

sudo apt update
sudo apt install apache2

sudo a2enmod proxy
sudo a2enmod proxy_http
sudo a2enmod proxy_wstunnel

sudo systemctl restart apache2

sudo nano /etc/apache2/sites-available/posapp.conf

<VirtualHost *:80>
    ServerName yourdomain.com

    ProxyPreserveHost On
    ProxyPass / http://localhost:5000/
    ProxyPassReverse / http://localhost:5000/

    ErrorLog ${APACHE_LOG_DIR}/posapp-error.log
    CustomLog ${APACHE_LOG_DIR}/posapp-access.log combined
</VirtualHost>

sudo a2ensite posapp.conf
sudo systemctl reload apache2

sudo nano /etc/systemd/system/posapp.service

[Unit]
Description=posapp .NET Web API
After=network.target

[Service]
WorkingDirectory=/var/www/posapp
ExecStart=/usr/bin/dotnet /var/www/posapp/POS.API.dll
Restart=always
# Restart service after 10 seconds if the dotnet service crashes:
RestartSec=10
KillSignal=SIGINT
SyslogIdentifier=dotnet-posapp
User=www-data
Environment=ASPNETCORE_ENVIRONMENT=Production

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl start posapp.service
sudo systemctl enable posapp.service

Running local copy

Prerequisites - .Net

.NET CORE 8 SDK and VISUAL STUDIO 2022, SQL SERVER or MySql 8 +

• Based on your requirement choose the SQL or MySQL API in respective folder of source.
• Open solution file POS.sln from .Net core folder into visual studio 2022.
• Right click on solution explorer and Restore nuget packages.
• Change database connection string in appsettings.Development.json in POS.API project.
• From Solution Explorer, Right click on POS.API project and click on Set as Startup Project from menu.
• To run project Press F5.

Prerequisites - Angular

Although POS can be run without any development experience, it would be much easier if you already have some experience. The following instructions allow you to run a local copy on your machine.

Install tools

If you have not yet installed nodejs, please Download and globally install nodejs : https://nodejs.org
Note: download Recommended For Most Users version

A detailed instruction on how to install NodeJS is available here.

Note: Make sure you have Node version >= 4.0 and NPM >= 3 . Also globally installed typescript.

Installing Angular-CLI globally is as simple as running this simple command: npm install -g @angular/cli

After the tools is installed, go inside of the Angular directory and run below command to install dependencies:

Run npm install -f to install node dependencies defined in package.json.

Running local copy

To run a local copy in development mode, replace REST API URI (apiUrl) variable in environment file inside src --> environments -->environment.ts

execute ng serve and go to http://localhost:4200 in your browser.

To run the local copy in production mode and build the sources, execute ng build. This will builds a production version of the application. All html,css and js code is minified and put to dist folder. The contents of this folder you can to put to your production server when publishing the application.

Configuration

• Users:

  In the initial Script two user has been created as below:
  • User name : [email protected] Password : admin@123
  • User name : [email protected] Password : employee@123
    
  [email protected] is Admin user and using this account you can add more users.

• SMTP Settings:

  In order to send email You need to configure the Default SMTP Settings under the Admin Area.

• Company Settings:

Change Title, Currency, Billing Address, Phone Number and Email from Company Profile inside the Setting.

Re-deploy the Changes After Customization on the server.

Build .Net Project

• Publish the dotnet project.
• For the front-end, create the ClientApp folder inside the Publish folder.

Build Angular Project

• Run npm run build that will create dist/posadminportal foder.
• copy all the files & folders inside dist/posadminportal and past it into ClientApp(created in step-2) folder.
• Now, Copy Publish Folder into your server.

.Net Core Project Structure

The project structure is as follows:

POS.sln/                * Projects Solution
│   │
│   ├──POS.API                  * REST API Controller, Dependancy configuration, Auto mapper profile 
│   │
│   ├──POS.MediatR              * Command handler, Query handler, Fluent API validation
│   │
│   ├──POS.Repository           * Each entity repository
│   │
│   ├──POS.Domain               * Entity framework dbContext 
|   |
│   ├──POS.Common               * Generic repository and Unit of work patterns
│   │ 
│   ├──POS.Data                 * Entity classes and DTO classes
│   │
│   ├──POS.Helper               * Utility classes

Support and Feedback

All questions you can send via the contact form HERE.

I will answer all questions within 24-48h in the order they were received.

Please do not panic if I do not answer too long – I love my buyers and I’ll answer for all questions ;)

Support for my items includes:

• Answering questions about how to use the item.
• Answering technical questions about the item (and included third party assets).
• Help with defects in the item or included third party assets.
• Item updates to ensure ongoing compatibility and to resolve security vulnerabilities.

Item support does not include:

• Installation of the item.
• Hosting, server environment, or software.
• Support for third party plug-ins.
• Plugins integration.
• Support for issues caused by user modifications in the solution’s code, styling and general functionality.

More information about the terms of support you can see here: https://themeforest.net/page/item_support_policy

Conclusion

Thank you for your purchase!

Thanks for reading the Instruction, hope it’s been really helpful and resolved most of your concerns.

Don’t forget to rate if you enjoy the product! It is very important for us to have certain goal.