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

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:
- Self-use – Run it for your own restaurant or café group.
- 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
- Copy .env.example → .env and fill in all secrets
- Set DATABASE_URL for PostgreSQL
- Set a strong AUTH_PASSWORD_PEPPER (minimum 32 characters)
- Configure Super Admin bootstrap credentials
- Add your Brevo API key + the 6 template IDs
- Use HTTPS in production
Basic deployment steps
Bash
npm ci
npm run db:schema
npm run db:migrate
npm run build
npm run start:productionThat’s everything required to get the multi-tenant POS running.
Benzer ürünler

WhatsApp yapay zekâ resepsiyonisti: randevu alır, satış yapar, ödemeleri onaylar ve aramaları yanıtlar. Çok işletmeli. Tam Node.js kaynak kodu.
Yayın: Kasım 2026
Aday, işveren, işe alım ve SaaS yönetim panelleri olan çok kiracılı MERN iş panosu ve ATS.
Yayın: Kasım 2026
ARC Relay — Yapay Zekâ Yayın Stüdyosu: Canlı Yayın, Çoklu Platform Yayıncı, Meme ve Sahte Sohbet Üretici (SaaS, Beyaz Etiket)
Yayın: Ekim 2026
Kendi sunucunuzda barındırılan, çok kiracılı e-posta oluşturucu SaaS: sürükle-bırak editör, 79 şablon, yapay zekâ asistanı, planlar ve ödemeler, tam kaynak kodu.
Yayın: Ekim 2026
Görsel düzenleme, yapay zekâ görsel üretimi, özel alan adları, mağazalar, randevular ve kendi markanızla yapay zekâ web sitesi SaaS'ı oluşturun.
Yayın: Ekim 2026
Alıntılı yanıtlar, insan gelen kutusu, potansiyel müşteriler, rezervasyonlar ve beyaz etiketli SaaS çalışma alanları ile kendi sunucunuzda barındırılan yapay zekâ ajanları.
Yayın: Ekim 2026