{"id":24990105,"url":"https://github.com/dawoudtormos/posengine","last_synced_at":"2026-04-10T07:53:33.468Z","repository":{"id":245589224,"uuid":"477916691","full_name":"DawoudTormos/POSEngine","owner":"DawoudTormos","description":"POSEngine is a robust Point-of-Sale (POS) software with specific features for a Lebanese business.","archived":false,"fork":false,"pushed_at":"2025-01-27T00:21:19.000Z","size":18564,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-04T13:39:49.730Z","etag":null,"topics":["ajax","bootstrap","jquery","js","laravel","laravel-framework","mysql","php"],"latest_commit_sha":null,"homepage":"","language":"Blade","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DawoudTormos.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-04-05T00:10:27.000Z","updated_at":"2025-01-27T00:28:25.000Z","dependencies_parsed_at":"2024-06-22T23:15:13.848Z","dependency_job_id":"0fdc9a29-6634-42bd-be9d-928709f43495","html_url":"https://github.com/DawoudTormos/POSEngine","commit_stats":null,"previous_names":["dawoudtormos/laravel_project_1","dawoudtormos/posengine"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DawoudTormos%2FPOSEngine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DawoudTormos%2FPOSEngine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DawoudTormos%2FPOSEngine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DawoudTormos%2FPOSEngine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DawoudTormos","download_url":"https://codeload.github.com/DawoudTormos/POSEngine/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246187208,"owners_count":20737459,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ajax","bootstrap","jquery","js","laravel","laravel-framework","mysql","php"],"created_at":"2025-02-04T13:34:18.912Z","updated_at":"2026-04-10T07:53:28.445Z","avatar_url":"https://github.com/DawoudTormos.png","language":"Blade","funding_links":["https://patreon.com/taylorotwell"],"categories":[],"sub_categories":[],"readme":"# POSEngine 📋💻\n\nPOSEngine 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.\n\n---\n\n## ✨ Features\n\n- **📦 Product Management**\n  - Group products into categories for easy management.\n  - Seamless barcode scanner integration for quick transactions.\n\n- **💱 Multi-Currency Support**\n  - Operates with two currencies.\n  - Includes real-time exchange rate handling.\n\n- **⚡ AJAX-Powered Performance**\n  - Smooth, reload-free user experience.\n  - All operations are handled dynamically via AJAX.\n\n- **🌐 IoT Price Checker**\n  - A REST API-based low-budget price checker for IoT integration.\n\n- **📊 Reporting**\n  - Detailed transaction and sales reporting for insights.\n\n---\n\n## 🛠️ Tech Stack\n\n- **Backend:** Laravel, PHP, MySQL\n- **Frontend:** Bootstrap, jQuery, AJAX\n- **IoT:** REST API-based price-checker\n\n---\n\n## 🚀 How to Run\n\n### Requirements:\n- PHP 8.1.2 (used during development and guaranteed to work)\n- MySQL 5.7+\n- Composer\n\n\n### Notes:\n- The application is built on **Laravel Framework 8.77.1**, but no additional steps are required for this version during installation.\n- All required package versions are specified in `composer.json` and `package.json`.\n\n### Steps:\n1. Clone the repository:\n   ```bash\n   git clone \u003crepository-link\u003e\n   ```\n2. Navigate to the project directory:\n   ```bash\n   cd posengine\n   ```\n3. Install dependencies:\n   ```bash\n   composer install\n   npm install\n   ```\n4. Configure your `.env` file:\n   - Database credentials.\n   - API keys if applicable.\n\n5. Run migrations:\n   ```bash\n   php artisan migrate\n   ```\n\n6. Start the server:\n   ```bash\n   php artisan serve\n   ```\n\n---\n\n## 📽️ Demo Video\n\nWatch the application in action! (Attach your demo video here)\n\n[![POSEngine Demo](https://img.youtube.com/vi/bo_N345t38Y/0.jpg)](https://youtu.be/bo_N345t38Y)\n\n---\n\n\n## 📝 License\nThis project is open-source and available under the [MIT License](LICENSE).\n\n---\n\n## 💡 About\nThis 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.\n\nFeel free to reach out for contributions, suggestions, or just to chat!\n\n---\n\n## 🌟 Contributing\nPull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.\n\n### Steps to Contribute:\n1. Fork the repository.\n2. Create your feature branch:\n   ```bash\n   git checkout -b feature/new-feature\n   ```\n3. Commit your changes:\n   ```bash\n   git commit -m 'Add some feature'\n   ```\n4. Push to the branch:\n   ```bash\n   git push origin feature/new-feature\n   ```\n5. Open a pull request.\n\n---\n\nThank you for checking out POSEngine! 🚀\n\n\n\u003ch3\u003eNotes:\nTo download and run this app\u003c/h3\u003e\n\u003cul\u003e\n  \u003cli\u003eYou have to have composer and npm installed.\u003c/li\u003e\n  \u003cli\u003eRun the command \"npm i\" make npm read the package.json file and download all the needed dependencies in node_modules folder.\u003c/li\u003e\n  \u003cli\u003eRun the command \"composer install\" to make composer download all the needed dependencies in vendor folder.\u003c/li\u003e\n  \u003cli\u003eyou haver to run \"npm run dev \" or \"npm run production\" in order to compile assests.\u003c/li\u003e\n  \u003cli\u003eTo make backup-larvel work you should edit the dump_binary_path in config/database.php. This path is usually /xampp/mysql/bin/ for xampp.\u003c/li\u003e\n\u003cli\u003e \n    \u003cul\u003eTo configure the path to where backups are saved:\u003c/ul\u003e\n      \u003cli\u003eYou should configure a disk in config/filesystems.php, give a DISKNAME and assign the path you want to it\u003c/li\u003e\n      \u003cli\u003eYou should assign the DISKNAME to the property disks of the key 'destination' in backup.php.\u003c/li\u003e\n\n\n\n\u003c/li\u003e\n\n  \u003cli\u003eYou 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.\u003c/li\u003e\n\n\u003c/ul\u003e\n\n\n\u003ch3\u003e Requirements\u003c/h3\u003e\n\u003cul\u003e\n  \u003cli\u003eThe php version used in development and guaranteed to work is 8.1.2\u003c/li\u003e\n  \u003cli\u003eThe app is built on Laravel Framework 8.77.1 but this doesn't require who wants to install it to do anything.\u003c/li\u003e\n  \u003cli\u003eThe version of all the required packages are included in the composer.json package.json \u003c/li\u003e\n  \n\n\n\u003c/ul\u003e\n\u003ch5\u003eA new command \"logs:clear\" is defined to delete laravel.log in the /storage/logs directory.The command is defined in routes/console.php\u003c/h5\u003e\n\n\u003ch4\u003eFiles for laravel-backup \u003c/h4\u003e\n\u003cpre\u003e\n#####   files for laravel-backup\n!resources/lang/vendor/backup\n\\config\\backup.php\n\n## they were copied as following:\n                                   Copied File [\\vendor\\spatie\\laravel-backup\\config\\backup.php] To [\\config\\backup.php]\n                                   Copied Directory [\\vendor\\spatie\\laravel-backup\\resources\\lang] To [\\resources\\lang\\vendor\\backup]\n\n   by this command:: php artisan vendor:publish --provider=\"Spatie\\Backup\\BackupServiceProvider\"\n\n   After installing the laravel-backup package with    composer require \"spatie/laravel-backup:^7.0.0\"\n\n\u003c/pre\u003e\n\n\n\n\u003cp align=\"center\"\u003e\u003ca href=\"https://laravel.com\" target=\"_blank\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/laravel/art/master/logo-lockup/5%20SVG/2%20CMYK/1%20Full%20Color/laravel-logolockup-cmyk-red.svg\" width=\"400\"\u003e\u003c/a\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://travis-ci.org/laravel/framework\"\u003e\u003cimg src=\"https://travis-ci.org/laravel/framework.svg\" alt=\"Build Status\"\u003e\u003c/a\u003e\n\u003ca href=\"https://packagist.org/packages/laravel/framework\"\u003e\u003cimg src=\"https://img.shields.io/packagist/dt/laravel/framework\" alt=\"Total Downloads\"\u003e\u003c/a\u003e\n\u003ca href=\"https://packagist.org/packages/laravel/framework\"\u003e\u003cimg src=\"https://img.shields.io/packagist/v/laravel/framework\" alt=\"Latest Stable Version\"\u003e\u003c/a\u003e\n\u003ca href=\"https://packagist.org/packages/laravel/framework\"\u003e\u003cimg src=\"https://img.shields.io/packagist/l/laravel/framework\" alt=\"License\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n## About Laravel\n\nLaravel 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:\n\n- [Simple, fast routing engine](https://laravel.com/docs/routing).\n- [Powerful dependency injection container](https://laravel.com/docs/container).\n- Multiple back-ends for [session](https://laravel.com/docs/session) and [cache](https://laravel.com/docs/cache) storage.\n- Expressive, intuitive [database ORM](https://laravel.com/docs/eloquent).\n- Database agnostic [schema migrations](https://laravel.com/docs/migrations).\n- [Robust background job processing](https://laravel.com/docs/queues).\n- [Real-time event broadcasting](https://laravel.com/docs/broadcasting).\n\nLaravel is accessible, powerful, and provides tools required for large, robust applications.\n\n## Learning Laravel\n\nLaravel has the most extensive and thorough [documentation](https://laravel.com/docs) and video tutorial library of all modern web application frameworks, making it a breeze to get started with the framework.\n\nIf you don't feel like reading, [Laracasts](https://laracasts.com) 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.\n\n## Laravel Sponsors\n\nWe 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](https://patreon.com/taylorotwell).\n\n### Premium Partners\n\n- **[Vehikl](https://vehikl.com/)**\n- **[Tighten Co.](https://tighten.co)**\n- **[Kirschbaum Development Group](https://kirschbaumdevelopment.com)**\n- **[64 Robots](https://64robots.com)**\n- **[Cubet Techno Labs](https://cubettech.com)**\n- **[Cyber-Duck](https://cyber-duck.co.uk)**\n- **[Many](https://www.many.co.uk)**\n- **[Webdock, Fast VPS Hosting](https://www.webdock.io/en)**\n- **[DevSquad](https://devsquad.com)**\n- **[Curotec](https://www.curotec.com/services/technologies/laravel/)**\n- **[OP.GG](https://op.gg)**\n- **[CMS Max](https://www.cmsmax.com/)**\n- **[WebReinvent](https://webreinvent.com/?utm_source=laravel\u0026utm_medium=github\u0026utm_campaign=patreon-sponsors)**\n- **[Lendio](https://lendio.com)**\n- **[Romega Software](https://romegasoftware.com)**\n\n## Contributing\n\nThank you for considering contributing to the Laravel framework! The contribution guide can be found in the [Laravel documentation](https://laravel.com/docs/contributions).\n\n## Code of Conduct\n\nIn order to ensure that the Laravel community is welcoming to all, please review and abide by the [Code of Conduct](https://laravel.com/docs/contributions#code-of-conduct).\n\n## Security Vulnerabilities\n\nIf you discover a security vulnerability within Laravel, please send an e-mail to Taylor Otwell via [taylor@laravel.com](mailto:taylor@laravel.com). All security vulnerabilities will be promptly addressed.\n\n## License\n\nThe Laravel framework is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdawoudtormos%2Fposengine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdawoudtormos%2Fposengine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdawoudtormos%2Fposengine/lists"}