Odeng POS System

Point of Sale system built with Laravel 10 featuring product management, order processing, and customer tracking

laravelpos-systemphpmysqltailwindvitepoint-of-sale

Share this project:

Project Overview

POS System Using Laravel

A comprehensive Point of Sale (POS) system built with Laravel 10, designed for retail businesses to manage products, process orders, and track customers efficiently. Features a modern interface with real-time inventory management and detailed reporting capabilities.

📋 Overview

This POS (Point of Sale) system provides a complete solution for retail stores, restaurants, and small businesses to manage their daily operations. Built with Laravel 10 and modern frontend tools, it offers an intuitive interface for quick order processing, inventory management, and customer relationship management.

✨ Features

Order Management

  • Quick POS Interface: Fast product selection and checkout
  • Real-time Cart: Dynamic cart with quantity adjustments
  • Multiple Payment Methods: Cash, card, and digital payments
  • Order History: Complete transaction records
  • Receipt Printing: Generate printable receipts

Product Management

  • Product CRUD: Complete product lifecycle management
  • Categories: Organize products by categories
  • Inventory Tracking: Real-time stock level monitoring
  • Barcode Support: Quick product lookup
  • Product Images: Visual product identification
  • Price Management: Flexible pricing options

Customer Management

  • Customer Database: Maintain customer information
  • Purchase History: Track customer transactions
  • Loyalty Points (if implemented): Reward regular customers
  • Customer Search: Quick customer lookup

Reporting & Analytics

  • Sales Reports: Daily, weekly, monthly sales summaries
  • Product Performance: Best-selling products
  • Revenue Analytics: Income tracking and trends
  • Inventory Reports: Stock levels and movements

User Management

  • Role-based Access: Admin and cashier roles
  • User Authentication: Secure login system
  • Activity Logs: Track user actions
  • Multi-user Support: Multiple cashiers simultaneously

🛠️ Tech Stack

Technology Purpose
Laravel 10 Backend framework
PHP 8.1+ Server-side language
MySQL Database management
Tailwind CSS Modern styling framework
Alpine.js Lightweight JavaScript framework
Vite Asset bundling and HMR
Livewire (if used) Dynamic interfaces

📁 Project Structure

odeng-pos/
├── app/
│   ├── Http/Controllers/      # Request handlers
│   ├── Models/                # Eloquent models
│   └── Services/              # Business logic
├── database/
│   ├── migrations/            # Database schema
│   └── seeders/              # Sample data
├── resources/
│   ├── views/                # Blade templates
│   ├── js/                   # JavaScript files
│   └── css/                  # Stylesheets
├── public/                   # Public assets
├── routes/
│   └── web.php              # Application routes
└── storage/                  # Uploaded files

🚀 Getting Started

System Requirements

For detailed system requirements, check Laravel 10 Server Requirements:

  • PHP >= 8.1
  • MySQL >= 5.7
  • Composer
  • Node.js & NPM
  • Web server (Apache/Nginx)

Installation Steps

  1. Clone the Repository

    git clone https://github.com/angkosal/laravel-pos.git YourDirectoryName

    Replace YourDirectoryName with your preferred folder name.

  2. Navigate to Project Directory

    cd YourDirectoryName

  3. Install PHP Dependencies

    Laravel uses Composer for dependency management:

    composer install

  4. Environment Configuration

    Rename or copy the example environment file:

    cp .env.example .env

    Then:

    • Generate application key:

      php artisan key:generate

    • Set database credentials in .env:

      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

    • Set your APP_URL:

      APP_URL=http://localhost:8000

  5. Database Setup

    Run migrations to create database tables:

    php artisan migrate

    Seed the database with initial data and admin user:

    php artisan db:seed

    Default Admin Credentials:

    • Email: admin@gmail.com
    • Password: admin123

  6. Install Node Dependencies

    npm install

    Build assets:

    • For development:
    npm run dev
    • For production: 
      npm run build

  7. Create Storage Link

    Link public storage for file uploads:

    php artisan storage:link

  8. Run the Application

    php artisan serve

    Or use Laravel Homestead/Valet for local development.

  9. Access the System

    Open your browser and visit:

    http://localhost:8000

    Login with admin credentials:

    • Email: admin@gmail.com
    • Password: admin123

💻 Usage Guide

Login

  1. Navigate to the application URL
  2. Enter admin credentials
  3. Access the dashboard

Processing Orders (POS Interface)

  1. Click "New Order" or "POS" menu
  2. Select products by searching or browsing
  3. Add items to cart
  4. Adjust quantities if needed
  5. Select customer (optional)
  6. Choose payment method
  7. Complete transaction
  8. Print receipt

Managing Products

  1. Go to "Products" menu
  2. Click "Add Product" for new items
  3. Enter product details:
    • Name
    • SKU/Barcode
    • Category
    • Price
    • Stock quantity
    • Image
  4. Save product

Managing Customers

  1. Navigate to "Customers"
  2. Add new customer with details
  3. View customer purchase history
  4. Edit customer information

Viewing Reports

  1. Access "Reports" dashboard
  2. Select report type
  3. Choose date range
  4. Generate and export reports

📸 Screenshots

Product List

Product list

Comprehensive product management interface with search, filter, and bulk actions.

POS Interface (Create Order)

Create order

Quick and intuitive point-of-sale interface for fast checkout.

Order List

Order list

Complete order history with status tracking and search capabilities.

Customer List

Customer list

Customer database management with purchase history.

🗄️ Database Schema

Key Tables

products

  • id, name, sku, category_id
  • price, cost, stock
  • image, description
  • created_at, updated_at

orders

  • id, order_number, customer_id
  • total_amount, payment_method
  • status, created_at

order_items

  • id, order_id, product_id
  • quantity, price, subtotal

customers

  • id, name, email, phone
  • address, created_at

🔒 Security Features

  • Authentication and authorization
  • CSRF protection
  • SQL injection prevention
  • XSS protection
  • Password hashing (BCrypt)
  • Secure session management

🐛 Troubleshooting

Installation Issues

  • Ensure PHP version >= 8.1
  • Check Composer is installed
  • Verify database credentials

Assets Not Loading

  • Run npm run build
  • Clear cache: php artisan cache:clear
  • Check file permissions

Database Errors

  • Verify .env database settings
  • Ensure database exists
  • Check user permissions

🚀 Deployment

Production Deployment

  1. Optimize Application

    composer install --optimize-autoloader --no-dev
php artisan config:cache
php artisan route:cache
php artisan view:cache
npm run build

  2. Set Environment

    APP_ENV=production
APP_DEBUG=false

  3. Configure Web Server

    • Point document root to public/ folder
    • Enable mod_rewrite (Apache)
    • Configure PHP-FPM (Nginx)

📚 Resources

🤝 Contributing

Contributions are welcome! Please feel free to submit pull requests or open issues for bugs and feature requests.

📄 License

This project is open source. Please check the repository for license details.

🙏 Acknowledgments

Special thanks to all contributors and the Laravel community for making this project possible.

💡 Support

If you find this project helpful, consider supporting the development!

Built with Laravel 🛒💳
A Complete Point of Sale Solution for Modern Businesses!