SayedPOS - Complete Point of Sale & Inventory Management System

SayedPOS is a powerful, feature-rich Point of Sale (POS) and Inventory Management System designed for retail stores, optical shops, and general merchandise businesses. It provides a seamless billing experience with barcode scanning, digital payments, and professional reporting.

🎯 Key Features:   

• Modern POS Interface - Clean, intuitive interface with barcode scanner support   
• Inventory Management - Track stock, low stock alerts, and product catalog   
• Customer Management - Complete customer profiles with purchase history & due tracking   
• Sales Reports - Detailed analytics with charts and export (Excel/CSV)   
• Digital Payments - bKash, Nagad, Card gateway support   
• Print Options - Both normal (A4) and thermal (80mm) invoice printing   
• Role Management - Admin and Employee roles with permission controls   
• Database Backup - One-click backup and restore functionality

📋 Requirements:   

• PHP 8.1 or higher   
• MySQL 5.7 or higher   
• Apache / Nginx web server

🚀 Quick Start:   

1. Upload all files to your server   
2. Create MySQL database   
3. Update .env file with database credentials   
4. Run migrations: php artisan migrate --force   
5. Create admin user via seeder: php artisan db:seed --class=AdminUserSeeder

🔧 Demo Access:   

• Admin Email: [email protected]   
• Admin Password: password   
• Employee Email: [email protected]   
• Employee Password: password

💡 Why Choose SayedPOS?   

• ✅ Clean, modern codebase (Laravel 11 + TailwindCSS + Alpine.js)   
• ✅ Fully responsive design (works on desktop, tablet, mobile)   
• ✅ Regular updates and dedicated support   
• ✅ Well-documented with clear installation guide

📜 License:

Regular License - for single project use only. Extended License available for SaaS/multiple projects.

Support:

Please use the support system for any issues. Support includes bug fixes and documentation assistance.

Point of Sale (POS) System            

• Barcode scanner support (keyboard input)           
• Real-time cart management with quantity & discount adjustments           
• Customer search/select with autocomplete           
• Quick add new customer from POS interface       

Payment Processing           

• Cash, Digital (bKash, Nagad, Card), and Mixed payment methods           
• Auto-calculates due amount with Paid/Partial/Unpaid status           
• Digital payment transaction ID tracking       

Inventory Management           

• Product catalog with barcode, brand, category, model, color, size           
• Stock tracking with low stock alerts           
• Multiple quantity types: Frame, Glass, Others, Stock           
• Import/Export products via Excel/CSV           
• Search and filter by brand or category       

Customer Management           

• Complete customer profiles with purchase history           
• Track total orders, total purchases, and due amount           
• Import/Export customers via Excel/CSV           
• Customer statement printing (thermal format)       

Sales Reports & Analytics           

• Date range filtering with status filters (Paid/Unpaid/Partial)           
• Analytics cards: Total Selling, Cost, Discount, Gross/Net Profit           
• Export reports to Excel or CSV format           
• Print report functionality       

Barcode Studio           

• Generate barcodes for products           
• Filter by brand or search products           
• Select range for bulk barcode generation           
• Print barcode labels       

Expense Management           

• Track expenses by category (Purchase, Transport, Food, Others)           
• Filter by date range and category           
• Import/Export expenses       

Brand Management           

• Manage brands with colors, sizes, description           
• Import/Export brands       

Category Management           

• Create and manage product categories           
• Quick add category from product entry form       

Staff Management & Access Control           

• Admin and Employee roles           
• Permission-based access control           
• Staff can only edit Partial/Unpaid invoices       

Printing Options           

• Normal invoice printing (A4 format)           
• Thermal invoice printing (80mm receipt format)           
• Customer statement thermal print       

Database Backup           

• One-click database backup creation           
• Download/delete backup files           
• Import backup to restore database       

System Settings           

• Appearance: Logo, Favicon, Primary/Secondary colors, Sidebar style           
• General: Company info, Currency, Timezone, Date format           
• Billing: Invoice prefix, Tax rate       

Dashboard Analytics           

• Revenue charts (weekly/monthly/yearly)           
• Top selling products           
• Sales vs Profit trends           
• Category-wise sales breakdown       

• PHP Version: 8.1 or higher   
• Database: MySQL 5.7 or higher / MariaDB 10.2 or higher   
• Web Server: Apache 2.4+ or Nginx 1.18+   
• PHP Extensions Required:
         
  • BCMath           
  • Ctype           
  • Fileinfo           
  • JSON           
  • Mbstring           
  • OpenSSL           
  • PDO           
  • Tokenizer           
  • XML           
  • GD (for barcode generation)           
  • Zip (for import/export)       
  
                  

• Composer: Required for dependency management   
• Node.js & NPM: Optional (only for frontend asset compilation)   
• Server Requirements:
         
  • Minimum 128MB memory limit           
  • Minimum 20MB storage space           
  • Allow symlink creation (for storage:link)       
  
         

Browser Support:           

• Chrome (latest)           
• Firefox (latest)           
• Safari (latest)           
• Edge (latest)       

Prerequisites:           

• cPanel or similar hosting control panel (recommended)           
• phpMyAdmin or MySQL CLI access           
• FTP or file manager access for file upload       

1. Upload Files           
   • Extract the downloaded ZIP file           
   • Upload all contents to your server's root directory (e.g., public_html, htdocs, or a subfolder)       
   
          
2. Set File Permissions           
   • Set storage/ folder permissions to 755           
   • Set bootstrap/cache/ folder permissions to 755           
   • Set public/uploads/ folder permissions to 755 (if exists)       
   
          
3. Create Database           
   • Create a new MySQL database via cPanel or phpMyAdmin           
   • Note down the database name, username, and password       
   
          
4. Configure Environment           
   • Open the .env file in the root directory           
   • Update database credentials:       
   
          

   DB_CONNECTION=mysql
   DB_HOST=127.0.0.1
   DB_PORT=3306
   DB_DATABASE=your_database_name
   DB_USERNAME=your_username
   DB_PASSWORD=your_password
   
   

   
          
   • Update application URL:
   
          

   APP_URL=http://yourdomain.com
   
   
   

   
          
5. Run Migrations           
   • Open terminal/command prompt in your project directory           
   • Run: php artisan migrate --force       
   
          
6. Create Admin User           
   • Run: php artisan db:seed --class=AdminUserSeeder           
   • Or manually register via registration page if enabled       
   
          
7. Create Storage Link           
   • Run: php artisan storage:link       
   
          
8. Set Document Root (Important!)           
   • Point your domain's document root to the public folder           
   • Example: /home/username/public_html/project/public           
   • If using subfolder, you may need to configure .htaccess       
   
          
9. Login Details           
   • Admin Email: [email protected]           
   • Password: password       
   
          
10. Troubleshooting           
    • If you see "500 Internal Server Error", check PHP version and file permissions           
    • If you see "No application encryption key", run: php artisan key:generate           
    • For other issues, check storage/logs/laravel.log file