Ana Sayfa / Kod ve Scriptler / ForgeFirst POS – Multi-Tenant GST POS NodeJS

ForgeFirst POS – Multi-Tenant GST POS NodeJS

ForgeFirst POS – Çok kiracılı Hint restoran POS'u: GST, KOT, KDS, QR sipariş, kaptan uygulaması, sessiz yazdırma köprüsü ve diğer

  • Yayın tarihi23 Eylül 2026
  • Nerede çalışırNode.js 22
  • VeritabanıPostgreSQL 16
  • Paket içeriği.sql, .md, .yml/.yaml, package.json, Dockerfile, JavaScript .js
  • Son güncelleme23 Eylül 2026
  • Canlı demoVar
ForgeFirst POS – Multi-Tenant GST POS NodeJS

Overview

ForgeFirst POS is a complete multi-tenant Point of Sale platform purpose-built for Indian restaurants and cafés.

One clean installation gives you a full Super Admin control plane plus unlimited restaurant accounts. Each restaurant runs as an isolated business with its own menu, tables, staff, GST settings, printers and QR ordering — while you stay in complete control from a single dashboard.

Designed for real Indian restaurant operations

  • Full GST-compliant billing with CGST/SGST calculation, multiple tax rates, GST reports and configurable charges
  • Dine-in, takeaway and delivery workflows in one place
  • Table management with floor-wise grouping and live status
  • KOT (Kitchen Order Ticket) with configurable copies and modification tracking
  • Kitchen Display System (KDS) for real-time kitchen preparation
  • Cash, UPI and card payments with split payments and automatic change calculation
  • Opening/closing cash reconciliation, expense tracking and payment corrections
  • Owner dashboard, sales reports, item performance and CSV exports

Captain App + Mobile Ready

The same POS works as a full captain/waiter app on phones and tablets. Staff can take orders, manage tables, send KOTs and track live status with a smooth, responsive interface — no separate app to maintain.

Silent Local & Remote Printing

The package includes a complete Windows Print Bridge for silent KOT and bill printing. Support both local printers and remote print stations. Devices pair securely with one-time codes, jobs are queued reliably, and printing happens without any popup dialogs.

DirectQR Table Ordering

Customers scan a table QR, browse the live menu, place orders and track status in real time. Includes customer accounts, CAPTCHA protection, rate limiting and a branded public ordering experience that can be fully customized per restaurant.

Multi-Tenant Architecture & Staff Control

  • Super Admin panel to create, suspend or manage any number of restaurants
  • Unlimited staff accounts with Owner, Manager, Cashier and Waiter roles
  • Granular permission matrix for every sensitive action
  • Support mode with scoped, audited sessions
  • Login activity tracking and full audit logs

How you can earn with white-label / SaaS

ForgeFirst is designed for two clear business models:

  1. Self-use – Run it for your own restaurant or café group.
  2. White-label SaaS – Rebrand it and sell it as your own multi-tenant POS platform to other restaurants.

As a white-label operator you can:

  • Charge restaurants a monthly or yearly subscription
  • Offer different plans (basic POS, POS + QR ordering, POS + Print Bridge, etc.)
  • Take a setup fee for onboarding and training
  • Sell additional services such as menu setup, printer configuration or custom branding
  • Scale to dozens or hundreds of restaurants from a single Super Admin installation

The source is fully editable. Simply replace logos, product name, favicon, email templates and customer-facing branding, then launch under your own domain. No seller-side activation server is required — you own and control the entire platform.

What’s included

  • Full source code (Node.js + React + PostgreSQL)
  • Windows Print Bridge (source + setup scripts)
  • GST-aware billing engine and reports
  • DirectQR public ordering pages
  • Super Admin + restaurant onboarding flow
  • Brevo transactional email templates
  • Deployment, security and white-label documentation

Whether you want a powerful POS for your own outlet or a ready-to-scale multi-tenant SaaS business, ForgeFirst gives you a complete, production-ready foundation.

Features

## 1. Platform

- Node.js 22 / Express 5 API - React 19 / Vite 7 web application - PostgreSQL-backed multi-restaurant architecture - npm workspace monorepo - One API process can serve the built web app and DirectQR public pages - REST-style JSON APIs with server-side validation - Server-Sent Events for live operational updates - Docker deployment support - Production health endpoint at `/api/health` - Host-agnostic deployment with PostgreSQL and HTTPS

## 2. Super Admin control plane

The Super Admin is the operator's control plane for provisioning and managing restaurants.

### Authentication

- Username/password login - Email OTP step using Brevo - Login activity tracking - Session limits, inactivity/expiry handling and revocation - Optional exact-IP allowlisting

### Restaurant management

- Create a restaurant/café - Configure restaurant name, QR slug and owner details - Generate temporary onboarding credentials - Show temporary credentials only once - Track temporary-password expiry - Manage restaurant lifecycle state: Setup Pending, Active, Suspended and Disabled - Revoke restaurant-user sessions when an outlet is suspended/disabled

### Restaurant detail tabs

- Overview - Commercials & QR - Support Mode - Audit log

### Support Mode

- Scoped support sessions with explicit MENU and/or SETUP scopes - Configure menu categories/items - Bulk menu-item creation - Configure table categories/tables - Support actions are audited

## 3. Restaurant onboarding

The source includes a setup checklist covering:

- Restaurant basics - Email verification - Owner account - Temporary owner credential replacement - Menu - Tables - GST and billing - Printer test - QR setup - Staff training - Go-live

Restaurant provisioning creates default T1–T4 tables through the database trigger/migration path.

## 4. POS roles and permissions

Current restaurant-side roles include:

- Owner - Manager - Cashier - Waiter

Permissions cover operations such as table viewing, order creation, KOT, billing, payments, reports, menu editing, table management, delivery, discounts, GST/charges, expenses, closing, payment corrections, KOT preparation, audit logs, staff accounts and QR downloads.

The permission matrix is enforced server-side; hiding a button in the UI is not the only authorization layer.

## 5. Order entry

The POS supports restaurant order workflows around:

- Dine-in orders - Takeaway orders - Delivery orders - Table selection for dine-in - Customer name/mobile details - Delivery address details - Delivery riders/statuses - Order instructions/notes - Item quantities - Item add-ons - Multiple item sizes - Item availability - Live table/order states

## 6. Menu management

Menu items support:

- Category assignment - Name and description - Price - GST rate - Availability/active state - Add-on groups/options - Item sizes with individual prices and a selected default size - Bulk item creation

## 7. Indian tax and billing

The shared `pos-core` tax logic handles INR/paise-safe calculations and GST-aware bill totals.

Current billing-related functionality includes:

- GST registration state - GSTIN/business details - CGST/SGST display - Multiple GST-rate handling - Taxable/non-taxable calculations - Delivery charge GST - Container charge GST - GST reports - Bill configuration and purchase/billing settings - Indian mobile-number validation in relevant customer flows

GST and charge settings can be permission-gated and are available to Owner/Manager flows according to the current permission matrix.

## 8. Payments

The order/payment flow supports:

- Cash - UPI - Card - Split payments - Payment matching against bill total - Cash received/change calculation - Payment corrections with permission controls - Payment-correction audit history

## 9. KOT, kitchen and billing print workflow

- KOT creation and reprint - KOT modification workflow - Configurable KOT display fields - Configurable first/modified/additional KOT copy counts - Kitchen preparation status updates - Mark KOT prepared - Bill printing/reprinting - Kitchen Display/KOT preparation permissions - Standard, Kiosk, local-bridge and remote-print-relay modes exposed in Printing settings

## 10. Windows Print Bridge

The repository includes source for a Windows desktop Print Bridge under `tools/ForgeArc.PrintBridge/`.

Current bridge integration includes:

- Local printer discovery - Windows printer submission - Silent local printing workflow - Remote print relay workflow - KOT/Bill station assignment - Pairing-code authentication - Device-specific credentials - Device revocation - Queue/retry behavior through the API's durable print-job system - Tray/startup setup scripts

The bridge is a separate optional desktop component; it is not required for browser-only use.

## 11. Operations workspace

Current released Operations sections include:

- Delivery Riders - QR Codes - QR Website Settings - GST & Charges - Expense Tracker - Closing Note - Payment Correction - Table Management - KOT & Bill - Audit Logs

Requirements

Core Requirements

  • Node.js 22.16.0
  • PostgreSQL 16 (or compatible)
  • Production HTTPS endpoint (required for security features)
  • Brevo account + API key (for transactional emails: verification, password reset, Super Admin OTP)

Optional but Recommended

  • Windows 10/11 machine (for the included Print Bridge if you want silent local/remote KOT & bill printing)

What you need to configure

  1. Copy .env.example → .env and fill in all secrets
  2. Set DATABASE_URL for PostgreSQL
  3. Set a strong AUTH_PASSWORD_PEPPER (minimum 32 characters)
  4. Configure Super Admin bootstrap credentials
  5. Add your Brevo API key + the 6 template IDs
  6. Use HTTPS in production

Basic deployment steps

Bash

npm ci
npm run db:schema
npm run db:migrate
npm run build
npm run start:production

That’s everything required to get the multi-tenant POS running.