POS(Points Of Sales) Cafe

MindHatch POSCafe is a comprehensive, full-stack Point of Sale (POS) solution designed for modern, high-traffic cafe environments. It prioritizes speed,

visual clarity (the "MindHatch" aesthetic), and seamless multi-role coordination.

🛠 Technical Specifications

• Framework: Next.js 16 (App Router) with React 19.
• Language: TypeScript (Strictly typed).
• Database: PostgreSQL (Production) / SQLite (Development) via Prisma ORM.
• Styling: Tailwind CSS 4 with a custom "Cyber-Minimalist" aesthetic (Glassmorphism, rounded-3xl components).
• Authentication: NextAuth.js (v5) with a custom Cookie-Bridge for high-reliability middleware protection.
• Reporting: Client-side PDF generation (jsPDF) and Excel exports (ExcelJS).
• Payments: Integrated Razorpay SDK and dynamic UPI QR code generation.

🚀 Detailed Features

1. Unified Terminal (Cashier/Point of Sale)

• Tablet-First Interface: Optimized for touch interaction with large, interactive product cards.
• Smart Cart Management: Real-time total calculation (INR) with quantity toggles and instant item removal.
• Terminal Sessions: Strict session control (Open/Close) to track daily sales, opening balances, and closing totals per cashier.
• Hybrid Checkout: Supports Cash, Card, and UPI. Generates dynamic QR codes for UPI payments.
• Receipt System: Instant digital receipt generation with specialized thermal-printer layouts.

2. Kitchen Display System (KDS)

• Live Order Stream: Real-time "Tickets" that update instantly as orders are placed at the terminal.
• Stage Tracking: Three-stage workflow: TO_COOK → PREPARING → COMPLETED.
• Itemized Preparedness: Kitchen staff can mark individual items as ready even if the rest of the order is still in progress.
• Table Identification: Clear indicators for Table vs. Walk-in (Takeaway) orders.

3. Dynamic Floor & Table Management

• Multi-Floor Layout: Manage separate dining areas (e.g., Ground Floor, Rooftop).
• Real-time Occupancy: Color-coded table statuses (AVAILABLE, OCCUPIED, RESERVED).
• Order Mapping: Link active orders directly to specific tables for seamless service.

4. Admin & Backend Controls

• Inventory/Product Management: Full CRUD for products with support for:
• Variants: Add attributes like size (Small/Large) or extras (Extra Cheese).
• Category Mapping: Organize products into logical groups.
• Routing: Flag items as "Kitchen" (food) or "Bar" (drinks) to route tickets correctly.
• User Role-Based Access (RBAC):
• ADMIN: Full system access, including reports and user management.
• MANAGER: Backend access and session overrides.
• CASHIER: Terminal and checkout access only.
• KITCHEN: KDS view only.

5. Reporting & Analytics

• Sales Tracking: Historical view of all terminal sessions and order history.
• Data Portability: Export sales data and product lists to Excel (.xlsx) or PDF for accounting.
• Session Reconciliation: Automatically calculates the difference between expected and actual closing amounts.

6. Security & Reliability

• JWT & Cookie Hybrid Auth: Uses secure JSON Web Tokens for sessions and persistent cookies for ultra-fast middleware route guarding.
• Protected Routes: Server-side redirection for unauthorized access to sensitive pages (e.g., a Kitchen user cannot access Backend settings).
• Database Integrity: Cascading deletes for floor/table relationships and strict schema validation using Zod.

🎨 Design Philosophy: "The MindHatch Look"

The application utilizes a unique "Cyan-Slate" palette:

• Primary: Slate-950 for high-contrast typography.
• Accents: Cyan-500 and Amber-400 for primary actions and status alerts.
• Surfaces: bg-white/80 with backdrop-blur for a modern, airy feel.
• Radius: Extreme rounding (rounded-[1.75rem] to rounded-3xl) for a friendly, tablet-optimized touch interface.

Module Stack

Timestamp

Released: May 2026