Laundry Box POS Software

Complete Point-of-Sale and Management System for Laundry Shops

Presenter: Technical Team

March 31, 2026

Slide 7 of 15

Offline First Secure Fast

System Overview

Laundry Box POS is a comprehensive point-of-sale and management system tailored for laundry shops and dry-cleaning businesses.

Technology Stack

Native PHP 8.4.19
Tailwind CSS V4 (CLI)
Blue-600 Color Scheme
Composer Package Manager

Fully Offline: Operates seamlessly on localhost environments without internet dependency.

Key Benefits

Order Management

Efficient order creation and tracking workflow

Garment Tracking

Real-time status from receipt to delivery

Billing System

Automated invoicing and payment tracking

Reporting

Business insights and transaction summaries

Project Structure

laundrybox-pos/

app/

config/, controllers/, core/

helpers/, middleware/, models/, views/

backups/

logs/

public/

index.php

assets/ (css/, images/, js/)

routes/

sessions/

src/

tests/

vendor/

Key Configuration Files

composer.json
package.json
schema.sql
README.md

Architecture Pattern

MVC (Model-View-Controller) with clear separation of concerns:

Models

Data Layer

Views

Presentation

Controllers

Logic Layer

Core Components

App Folder Architecture

config/

• constants.php
• database.php
• env.php

controllers/

• AuthController.php
• BillingController.php
• DashboardController.php
• OrderController.php

core/

• Controller.php
• Model.php
• Router.php
• Session.php

helpers/

• helpers.php
• JWTHelper.php

middleware/

• AdminMiddleware.php
• AuthMiddleware.php

models/

• Billing.php
• Database.php
• Garment.php
• Order.php

views/

auth/ billing/ dashboard/ home/ layouts/ orders/

Public & Assets

public/

Web-accessible entry point and compiled assets

index.php (Front Controller)
assets/ (css/, images/, js/)
uploads/ (avatars/)

src/

Source files for CSS compilation

tailwind.css (Source Input)

Infrastructure Folders

routes/

web.php - Application routing definitions

sessions/

Secure session storage handler

backups/

Automated database backup storage

logs/

Application error and access logs

Order Management

Core Business Operations

Order Management

Create, update, and finalize laundry orders with intuitive ticket numbering system

Garment Tracking

Track items through transparent status pipeline:

Received In Process Ready

Billing System

Generate professional invoices, manage customer accounts, record full or partial payments with automatic tax calculations

Reports & Analytics

Business insights with transaction summaries, revenue tracking, and operational metrics dashboard

Styled with Tailwind CSS Blue-600 Theme for consistent professional appearance

Security & Performance

Advanced Security

Argon2id Password Hashing
JWT Token Authentication
Refresh Token Mechanism
Role-Based Access Control

RBAC

Authorization Levels

Admin

Full system access

Manager

Operational control

Staff

Limited access

Performance

Cache Layer

Database → Redis → POS

Session Mgmt

Secure user-aware sessions

Offline Mode

100% functional without internet

Authentication Flow

1

Password Hashing

Argon2id algorithm for secure password storage

password_hash($pwd, PASSWORD_ARGON2ID)

2

JWT Generation

Stateless authentication tokens with expiration

JWTHelper::generate($payload, $secret)

3

Refresh Mechanism

Secure token rotation for extended sessions

RefreshToken::generate($userId)

4

RBAC Validation

Role verification on protected routes

AdminMiddleware::check($role)

Security Architecture

Client Request

Credentials + Headers

AuthController

Validation & JWT Generation

Middleware Check

RBAC & Session Validation

Resource Access

Protected Data Delivery

Offline & Synchronization

Local Storage Architecture

MySQL + Redis on localhost

Offline Mode

Full functionality without internet connectivity. All data persisted locally.

Auto-Sync

Automatic synchronization when connection restored. Conflict resolution built-in.

Cache Strategy: Database → Redis → POS

MySQL

Primary Data

→

Redis

Cache Layer

→

POS System

Fast Access

Sync Status

Connection Stable

Last Sync Just now

Pending 0 items

Installation Prerequisites

XAMPP

Apache + MySQL + PHP 8.5+

• Apache Server

• MySQL Database

• PHP 8.5+ Required

• phpMyAdmin

apachefriends.org

Composer

PHP Dependency Manager

• Autoloading

• Package Management

• PSR-4 Support

• Version Control

getcomposer.org

Node.js

Tailwind CSS Compilation

• npm Package Manager

• Tailwind CLI

• Build Scripts

• Watch Mode

nodejs.org

Verification Commands

php -v // PHP 8.5+

composer -v // Latest

node -v && npm -v // LTS

Installation: Steps 1-5

1

Install XAMPP

Download and install XAMPP from apachefriends.org. Ensure Apache and MySQL services start correctly.

Windows/Mac/Linux Port 80/3306

2

Install Composer

Download Composer from getcomposer.org and install globally. Verify with composer -v.

3

Install Node.js

Install Node.js LTS version from nodejs.org. Verify with node -v and npm -v.

4

Extract Project

Extract laundrybox-pos.zip to htdocs directory:


                                D:\xampp\nginx\htdocs\laundrybox-pos\

5

Open Terminal

Navigate to project directory in terminal/cmd:


                                cd D:\xampp\nginx\htdocs\laundrybox-pos

Installation: Steps 6-10

6

Composer Install

PHP Dependencies

composer install

7

NPM Install

Node Dependencies

npm install

8

Build CSS

Compile Tailwind

npm run build

9

Database Setup

• Create 'laundrybox' MySQL DB
• Update database.php config
• Run setup_database.php

localhost/setup_database.php

10

Finalize

• Generate encryption keys
• Update env.php
• Access application

localhost/laundrybox-pos/public/

Installation Complete! System Ready for Use

Troubleshooting

Common Errors & Fixes

500 Server Error

• Check Apache error logs in logs/
• Verify PHP version (8.5+ required)
• Check .htaccess configuration
• Ensure rewrite module enabled

No Encryption Key

• Run key generation script
• Update app/config/env.php
• Ensure 32-byte random string
• Never commit keys to repository

Database Connection Error

• Verify PDO credentials in database.php
• Confirm 'laundrybox' DB exists
• Check MySQL service running
• Verify host/port (localhost:3306)

Authentication Issues

• Confirm Argon2id extension loaded
• Check JWT secret in env.php
• Verify sessions folder writable
• Clear browser cookies/cache

Still having issues? Contact support at sisovin@peanech.online

Operational Workflow

1. Receive Items

Record garments with unique ticket numbers and customer details

Ticket Gen

2. Process Orders

Update garment statuses through cleaning and pressing stages

Status Track

3. Delivery/Pickup

Mark orders as delivered or ready for customer pickup

Handover

4. Finalize Sale

Record payment, generate invoice, complete transaction

Billing

Training Benefits

Intuitive interface for quick staff onboarding
Organized tracking for business owners
Reduced manual errors in order processing
Professional billing and receipts

Business Value

50%

Faster Checkout

99%

Tracking Accuracy

24/7

Offline Operation

100%

Data Security

Support & Contact

Phone Support

+855 92 800 801

Available during business hours

Email

sisovin@peanech.online

24/7 ticket support

Keywords & Search Tags

laundry pos laundry pos workflow pos system laundry billing system track items laundry pos pos sale recording full sale pos laundry management system laundry shop software pos tutorial pos training laundry staff training admin vs cashier pos laundry delivery tracking cnl solutions pos south africa laundry business laundry pos Siem Reap CAMBODIA

Built with PHP 8.4.19, Tailwind CSS V4, and ❤️