POS & Order Management System

A full-featured Point of Sale (POS) and Order Management System built with React, Node.js, Express, and MongoDB. This platform is designed to help businesses manage orders, track customers, and generate printable receipts efficiently, providing a modern and responsive interface for daily operations.

---

Overview

The POS & Order Management System allows users to create, view, and update orders, manage customers, and monitor order statuses in real-time. Administrators and staff can generate printable receipts, track completed orders, and manage customer information through a secure, centralized system.

The application features role-based authentication, dynamic UI updates, and a responsive design suitable for desktop and tablet devices.

---

Features

Order Management

• View, update, and complete orders with detailed item lists
• Mark orders as Processing or Completed with visual indicators

Customer Management

• Store and display customer details for each order
• Track customer order history

Receipts

• Generate and print detailed receipts for customers

Authentication & Security

• JWT-based authentication to secure backend access

User Interface

• Responsive design compatible with desktop and tablet screens
• Modern, clean UI built with React and TailwindCSS

---

Tech Stack

• Frontend: React.js, TailwindCSS, React Icons, Redux/Zustand
• Backend: Node.js, Express.js
• Database: MongoDB

Setup & Contribution Guide

# --- CLONE THE PROJECT ---
git clone [https://github.com/akrs-code/pos-restaurant-system.git](https://github.com/akrs-code/pos-restaurant-system.git)
cd pos-restaurant-system

# --- BACKEND CONFIGURATION ---
cd backend
npm install

# --- CREATE ENVIRONMENT VARIABLES ---
# Create a .env file and add:
PORT=8000
MONGODB_URI=your_mongodb_uri_here
JWT_SECRET=your_jwt_secret_here

# --- START BACKEND SERVER ---
npm run dev

# --- FRONTEND CONFIGURATION ---
cd ../frontend
npm install

# --- START FRONTEND DEVELOPMENT SERVER ---
npm run dev



# --- STEP 1: FORK AND CLONE ---
# Fork via GitHub UI then:
git clone [https://github.com/akrs-code/pos-restaurant-system.git](https://github.com/akrs-code/pos-restaurant-system.git)
cd pos-restaurant-system

# --- STEP 2: BRANCHING ---
git checkout -b feature/your-feature

# --- STEP 3: COMMIT CHANGES ---
git add .
git commit -m "Add some feature"

# --- STEP 4: PUSH AND PR ---
git push origin feature/your-feature
# Open a Pull Request on GitHub