Skip to content

POSEngine is a robust Point-of-Sale (POS) software with specific features for a Lebanese business.

Notifications You must be signed in to change notification settings

DawoudTormos/POSEngine

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

43 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

POSEngine πŸ“‹πŸ’»

POSEngine is a robust Point-of-Sale (POS) software tailored to meet the specific needs of a local business. Built during my first year at university, it demonstrates the power of Laravel, PHP, MySQL, jQuery, and Bootstrap, combined with IoT integration for a low-budget price-checker system.


✨ Features

  • πŸ“¦ Product Management

    • Group products into categories for easy management.
    • Seamless barcode scanner integration for quick transactions.
  • πŸ’± Multi-Currency Support

    • Operates with two currencies.
    • Includes real-time exchange rate handling.
  • ⚑ AJAX-Powered Performance

    • Smooth, reload-free user experience.
    • All operations are handled dynamically via AJAX.
  • 🌐 IoT Price Checker

    • A REST API-based low-budget price checker for IoT integration.
  • πŸ“Š Reporting

    • Detailed transaction and sales reporting for insights.

πŸ› οΈ Tech Stack

  • Backend: Laravel, PHP, MySQL
  • Frontend: Bootstrap, jQuery, AJAX
  • IoT: REST API-based price-checker

πŸš€ How to Run

Requirements:

  • PHP 8.1.2 (used during development and guaranteed to work)
  • MySQL 5.7+
  • Composer

Notes:

  • The application is built on Laravel Framework 8.77.1, but no additional steps are required for this version during installation.
  • All required package versions are specified in composer.json and package.json.

Steps:

  1. Clone the repository:

    git clone <repository-link>
  2. Navigate to the project directory:

    cd posengine
  3. Install dependencies:

    composer install
    npm install
  4. Configure your .env file:

    • Database credentials.
    • API keys if applicable.
  5. Run migrations:

    php artisan migrate
  6. Start the server:

    php artisan serve

πŸ“½οΈ Demo Video

Watch the application in action! (Attach your demo video here)

POSEngine Demo


πŸ“ License

This project is open-source and available under the MIT License.


πŸ’‘ About

This project represents my journey into software development, created during my first year of university. It reflects my passion for solving real-world problems with code.

Feel free to reach out for contributions, suggestions, or just to chat!


🌟 Contributing

Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.

Steps to Contribute:

  1. Fork the repository.
  2. Create your feature branch:
    git checkout -b feature/new-feature
  3. Commit your changes:
    git commit -m 'Add some feature'
  4. Push to the branch:
    git push origin feature/new-feature
  5. Open a pull request.

Thank you for checking out POSEngine! πŸš€

Notes: To download and run this app

  • You have to have composer and npm installed.
  • Run the command "npm i" make npm read the package.json file and download all the needed dependencies in node_modules folder.
  • Run the command "composer install" to make composer download all the needed dependencies in vendor folder.
  • you haver to run "npm run dev " or "npm run production" in order to compile assests.
  • To make backup-larvel work you should edit the dump_binary_path in config/database.php. This path is usually /xampp/mysql/bin/ for xampp.
    • To configure the path to where backups are saved:
  • You should configure a disk in config/filesystems.php, give a DISKNAME and assign the path you want to it
  • You should assign the DISKNAME to the property disks of the key 'destination' in backup.php.
  • You have to scedule running laravel-backup with laravel schedular in Base_Path/app/console/kernel.php. Then run the scedular localy or with php cron. Check laravel documentation.

Requirements

  • The php version used in development and guaranteed to work is 8.1.2
  • The app is built on Laravel Framework 8.77.1 but this doesn't require who wants to install it to do anything.
  • The version of all the required packages are included in the composer.json package.json
A new command "logs:clear" is defined to delete laravel.log in the /storage/logs directory.The command is defined in routes/console.php

Files for laravel-backup

#####   files for laravel-backup
!resources/lang/vendor/backup
\config\backup.php

they were copied as following:

                               Copied File [\vendor\spatie\laravel-backup\config\backup.php] To [\config\backup.php]
                               Copied Directory [\vendor\spatie\laravel-backup\resources\lang] To [\resources\lang\vendor\backup]

by this command:: php artisan vendor:publish --provider="Spatie\Backup\BackupServiceProvider"

After installing the laravel-backup package with composer require "spatie/laravel-backup:^7.0.0"

Build Status Total Downloads Latest Stable Version License

About Laravel

Laravel is a web application framework with expressive, elegant syntax. We believe development must be an enjoyable and creative experience to be truly fulfilling. Laravel takes the pain out of development by easing common tasks used in many web projects, such as:

Laravel is accessible, powerful, and provides tools required for large, robust applications.

Learning Laravel

Laravel has the most extensive and thorough documentation and video tutorial library of all modern web application frameworks, making it a breeze to get started with the framework.

If you don't feel like reading, Laracasts can help. Laracasts contains over 1500 video tutorials on a range of topics including Laravel, modern PHP, unit testing, and JavaScript. Boost your skills by digging into our comprehensive video library.

Laravel Sponsors

We would like to extend our thanks to the following sponsors for funding Laravel development. If you are interested in becoming a sponsor, please visit the Laravel Patreon page.

Premium Partners

Contributing

Thank you for considering contributing to the Laravel framework! The contribution guide can be found in the Laravel documentation.

Code of Conduct

In order to ensure that the Laravel community is welcoming to all, please review and abide by the Code of Conduct.

Security Vulnerabilities

If you discover a security vulnerability within Laravel, please send an e-mail to Taylor Otwell via [email protected]. All security vulnerabilities will be promptly addressed.

License

The Laravel framework is open-sourced software licensed under the MIT license.

About

POSEngine is a robust Point-of-Sale (POS) software with specific features for a Lebanese business.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages