Skip to content

StarkLiew/juztpoint

Repository files navigation

About JuztPoint

Am I crazy, release a project I working privately for past 6 months as opensource. JuztPoint is first full-fledged multi-tenant Point of Sale system release under opensource license in Malaysia. A Point of Sale (POS) build with Progressive Web App technology (PWA). Unlike other PWA point of sale, this PWA is built to feel like an native app. Currently this software is have been running under production testing at my own retail premise.

Features

  • Barcode Scanning
  • Commission Management (Percentage, Fixed, and Sharing)
  • Customer Account Profile
  • Vendor Account
  • Purchase Management
  • Receipt email
  • Receipt Printing
  • Appointment Management (Backoffice only, POS still working on it)
  • Electronic Signature
  • Gift Card Management
  • Loyalty Program
  • Multi-Store
  • Multi-Terminal
  • Tax Ready
  • Restaurant POS
  • Retail POS
  • Salon POS
  • Refund Management
  • eCommerce Integration
  • E-wallet Payment Integration
  • Card Payment Integration
  • Bluetooth Thermal Printer (Working on it)

Demo

Homepage: https://www.juztpoint.com
Backoffice: https://backoffice.juztpoint.com
PWA POS: https://app.juztpoint.com 
!!Demo does not have mail server configured. Any attempt to send email will fail.
Email: demo@demo.com   
Password: demo1234
Pin: 0000

Testing POS https://app.juztpoint.com Setup on mobile device

   1. Login to Backoffice
   2. Goto Setting->(Operation) Terminal
   3. Add a Terminal and Save
   4. Browse https://app.juztpoint.com
   5. Install PWA when prompt or Add to Home screen (Mobile Chrome Browser)
   6. Fill in the email and password & device id*, then login
   7. Enter pin 0000 as demo user to begin
   
   *note:
      Device Id can be found in:
          Setting->(Operation) Terminal->Identifier
          (To show QR code, click edit)
      

Requirement

  • Docker
  • Docker-compose
  • OS tested on: linux, centos, window, osx
  • Frontend: - any pc, mobile and tablet which browser support PWA

Setup

Enviroment

$ cp .env.example .env

Production

$ docker-compose up -d
$ docker-compose exec juzt-app composer install
$ docker-compose exec juzt-app php artisan migrate
$ docker-compose exec juzt-app php artisan key:generate
$ docker-compose exec juzt-app php artisan passport:install
$ docker-compose exec juzt-app npm install
$ docker-compose exec juzt-app npm run prod

Development

Backend

$ docker-compose up -d (to fire up mariadb)
$ composer install
$ php artisan migrate
$ php artisan key:generate
$ php artisan run serve
$ php artisan passport:install
$ npm install
$ npm run dev (or) watch

Frontend

$ npm run dev 

or (live)

$ npm run watch 

Optional

Edit the host file as follow (for localhost):

127.0.0.1  www.domain.com app.domain.com backoffice.domain.com

Release Plan based on Sector Support

Version 1:

  • Retail
  • Salon
  • Car Wash

Next Version Sector Support:

  • F&B sector
  • more...

Working on for next release

Backend

  1. Broadcast Notification
  2. Strengthen api security

BackOffice

  1. Receive Notification
  2. More reports
  3. Internal Use (Issue Inventory)
  4. Plugin

Frontend

  1. Thermal Printing (Working on)
  2. Sync Open/Close Shift
  3. Receive Notification
  4. Software Update Refresh Notification
  5. Update Refresh Notification

... and many more bugs fix.

Documentation

Planing for a seperate github reposities for communities written user manual.

Sponsors

I would like to extend my thanks to any future sponsors for funding JuztPoint development.

The sponsors are:

  1. pending

Contributing

Thank you for considering contributing.

License

Apache License 2.0