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.
-
π¦ 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.
- Backend: Laravel, PHP, MySQL
- Frontend: Bootstrap, jQuery, AJAX
- IoT: REST API-based price-checker
- PHP 8.1.2 (used during development and guaranteed to work)
- MySQL 5.7+
- Composer
- 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.jsonandpackage.json.
-
Clone the repository:
git clone <repository-link>
-
Navigate to the project directory:
cd posengine -
Install dependencies:
composer install npm install
-
Configure your
.envfile:- Database credentials.
- API keys if applicable.
-
Run migrations:
php artisan migrate
-
Start the server:
php artisan serve
Watch the application in action! (Attach your demo video here)
This project is open-source and available under the MIT License.
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!
Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.
- Fork the repository.
- Create your feature branch:
git checkout -b feature/new-feature
- Commit your changes:
git commit -m 'Add some feature' - Push to the branch:
git push origin feature/new-feature
- Open a pull request.
Thank you for checking out POSEngine! π
- 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.
- 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 !resources/lang/vendor/backup \config\backup.phpCopied 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"
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:
- Simple, fast routing engine.
- Powerful dependency injection container.
- Multiple back-ends for session and cache storage.
- Expressive, intuitive database ORM.
- Database agnostic schema migrations.
- Robust background job processing.
- Real-time event broadcasting.
Laravel is accessible, powerful, and provides tools required for large, robust applications.
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.
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.
- Vehikl
- Tighten Co.
- Kirschbaum Development Group
- 64 Robots
- Cubet Techno Labs
- Cyber-Duck
- Many
- Webdock, Fast VPS Hosting
- DevSquad
- Curotec
- OP.GG
- CMS Max
- WebReinvent
- Lendio
- Romega Software
Thank you for considering contributing to the Laravel framework! The contribution guide can be found in the Laravel documentation.
In order to ensure that the Laravel community is welcoming to all, please review and abide by the Code of Conduct.
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.
The Laravel framework is open-sourced software licensed under the MIT license.
