Full-StackSaaSMulti-TenantReal-TimeReactNode.js

Inventory System

Multi-tenant SaaS inventory platform giving small teams real-time stock visibility across warehouses — shipped as both hosted SaaS and a self-hosted Docker stack from a single codebase.

Fig. 01 · Dashboard

Problem

Small businesses managing stock across multiple warehouses lack affordable, modern tools for centralized inventory visibility, low-stock alerts, and audit trails. Most existing options are either enterprise-priced or stuck in spreadsheet territory.

Architecture

H01
Two deployment modes from one codebase
A DEPLOYMENT_MODE flag switches between SaaS (shared infra, many tenants) and self-hosted (single tenant, single compose stack).
H02
Strict tenant isolation
Enforced at both the database layer (tenant-scoped collections) and the application layer (request middleware).
H03
ACID multi-document transactions
Replica-set MongoDB enables atomic stock-movement operations that touch products, stock levels, and audit logs in one transaction.
H04
Background workers keep requests fast
8 BullMQ queues handle KPI aggregation, search indexing, alert evaluation, email dispatch, and CSV imports off the request path.
H05
Shared-infra hosting pattern
Caddy and MongoDB deployed once per VPS and shared across projects via external Docker networks. Each project ships only its own Redis, MeiliSearch, and app containers.

Product gallery · 6 views

Inventory System — Dashboard — Fig. 02Dashboard

Inventory System — Products — Fig. 03Products

Inventory System — Stocks — Fig. 04Stocks

Inventory System — Reports — Fig. 05Reports

Inventory System — Import — Fig. 06Import

Inventory System — Purchase Order — Fig. 07Purchase Order

Key features

01Multi-warehouse stock tracking with movement history (adjustments, transfers, returns)
02Configurable low-stock alerts (email + in-app)
03Real-time updates over Socket.IO — stock changes propagate across all open tabs
04Typo-tolerant full-text search via MeiliSearch
05Bulk CSV import with live job-progress streaming
06Dashboard with cached KPI cards computed by background workers
07Role-based access control: owner / manager / staff / viewer
08User invitations + email notifications via Resend
09Immutable audit logs for all create/update/delete actions
10Per-tenant settings: currency, timezone, date format, custom fields

Stack

Frontend

React 19ViteTypeScriptTailwind CSS 4shadcn/uiTanStack Query / Table / VirtualReact Router 7ZustandSocket.IO ClientRechartsReact Hook Form + Zod

Backend

Node.js 20ExpressTypeScriptMongoose 8BullMQSocket.IOMeiliSearch SDKJWT with refresh-token rotationHelmet / rate-limit / sanitization

Data

MongoDB 7 (replica set, transactions)Redis 7 (sessions, BullMQ, cache)MeiliSearch v1.7

Infra

DockerDocker ComposeCaddy with auto Let's EncryptOracle Cloud ARM64 VPS

Status

Live and in active development

04 — Start a project

An idea, an existing app, or something in between?

Tell us what you're trying to ship. We reply within one business day with a written take on scope and timeline — not a sales pitch.

hello@devsdesk.site

Inventory System

Two deployment modes from one codebase

Strict tenant isolation

ACID multi-document transactions

Background workers keep requests fast

Shared-infra hosting pattern

An idea, an existing app, or something in between?