Hire Me
← Back to projects
In-House POS System (Web)

In-House POS System (Web)

  • React
  • Node.js
  • Spring Boot
  • MySQL
  • Technical leadership
  • Task delegation
  • Effort estimation
  • Sprint coordination
  • Performance optimization
  • Code refactoring
  • Cross-functional coordination

iPOS

Point-of-sale and inventory system · Together Initiatives (Pvt.) Ltd. · 2022

A point-of-sale system for small shops: sell at the counter, track stock and purchases, settle payments and print invoices, from the web or a phone.


Features

  • Sales. Record a sale with products, units and sale price, then settle it by cash or card. Sales are listed for review.
  • Invoices. Generate printable invoices with customer and shop details, line items, dates and notes.
  • Purchases. Record stock purchases from suppliers.
  • Inventory. Products (with images), categories, units of measure, and stock levels.
  • Customers. Keep a list of customers.
  • Accounting. A hierarchical chart of accounts on the backend.
  • Roles. JWT authentication with admin, manager and cashier users.
  • Mobile POS. A React Native (Expo) app for sales on the go, with a barcode scanner and product search, using the same backend.

Architecture

flowchart LR
    W["Web client<br/>React + CoreUI"] --> P["Reverse proxy<br/>Nginx"]
    M["Mobile client<br/>React Native + Expo"] --> P
    P --> A["REST API<br/>Spring Boot · JWT"]
    A --> D[("MySQL")]

The backend is organised by module (product, category, unit, stock, customer, transaction, chart of accounts, authentication). Each module follows the same four layers: controller → service → repository → model. Together they expose about 65 REST endpoints. MySQL triggers keep the category and chart-of-accounts hierarchies in sync and generate invoice numbers, and API messages are internationalised (i18n).

Repository layout

rest-service/       Spring Boot REST API (Maven), JWT auth, MySQL
web-client-v2/      React web app (CoreUI admin template): sales, purchases, stock, invoices
mobile_client_v2/   React Native + Expo app: sales, barcode scanning, product search
web-client/         first web prototype (from an open-source inventory starter)
MobileClient/       first mobile prototype (React Native CLI, same starter)
reverse-proxy/      Nginx config + Dockerfile
docker-compose.yml  MySQL for local development

Running locally

Requirements: Java 11 with Maven, Node.js, MySQL (or Docker).

# 1. Database
docker compose up -d db                 # MySQL with a "bootcamp" database

# 2. API
cd rest-service
mvn clean install -DskipTests
mvn spring-boot:run                     # or run PosApiApplication from your IDE

# 3. Web client
cd web-client-v2
npm install
npm start

# 4. Mobile client
cd mobile_client_v2
npm install
npm start                               # Expo

Set the database connection in rest-service/src/main/resources/application.yml.

My role

I joined as a junior software engineer and was promoted to Project Lead on iPOS after the original lead left (about April – May 2022):

  • Led two engineers. Assigned tasks, reviewed and approved or declined their pull requests, estimated effort, and coordinated scope changes with the project manager.
  • Built the critical frontend parts of the web app.
  • Took over the Spring Boot backend by learning the codebase myself. I added 4+ REST APIs modelled on the existing ones and changed several endpoints to return the output the clients needed, over MySQL.
  • Extended the POS to mobile with React Native and Expo, reusing the existing backend services and JWT authentication.

Credits

Built by the iPOS team at Together Initiatives (Pvt.) Ltd., Dhaka. The first web and mobile prototypes started from an open-source inventory starter, and the v2 web app is built on the CoreUI Free React Admin Template. This repository is a fork kept for my portfolio. The code belongs to Together Initiatives.