Gokkul.dev
Back to all projects
Personal Project / Full Stack · 2026

Hotel PMS

Cloud Hotel Property Management System

hotel-pms — experience preview (simulation)
Live sim

Desk A's write wins. MongoDB's unique index refuses Desk B's.

Run the front desk

Problem

Small hotel chains need reservations, billing, and housekeeping in one system — without double-booking rooms or losing revenue to manual rate management.

Approach

  • Multi-tenant reservations engine with an availability grid, date-overridable rate plans, and no-double-sell guarantees.
  • OCR-assisted guest check-in (Tesseract.js ID scanning) and an interactive 3D property/room visualizer (React Three Fiber).
  • Billing with sequential per-financial-year invoice numbering, Razorpay + UPI QR payments, and reconciliation/refund flows.
  • Occupancy, ADR, and RevPAR reporting with automated night audit; RBAC-gated staff roles with shift-based session invalidation.

Result

Front desk staff run the full guest lifecycle — book, OCR-scan an ID at check-in, bill, and check out — while owners see live occupancy and revenue reports.

Stack

Node.jsExpress.jsMongoDBReact 19TypeScriptViteThree.jsTesseract.jsRazorpayJWT

The preview above replays the hardest moment of this project's Experience, drawn from the same simulation code. Click it to try the whole thing yourself.

Under the hood

A simplified excerpt of the core logic and how a request flows through the system.

// models/reservation.model.js
const schema = new Schema({
property: { type: ObjectId, required: true },
room: { type: ObjectId, ref: "Room" },
checkIn: Date,
checkOut: Date,
});
// no-double-sell guard
schema.index(
{ property: 1, room: 1, checkIn: 1 },
{ unique: true }
);

Request flow

React 19 + Vite front desk app
Express API
MongoDB — tenant-scoped

Connects to

Razorpay / UPITesseract.js OCRThree.js 3D viewer

More projects