Kopi Sangkara POS
Overview & Architecture
Kopi Sangkara POS is a modern, responsive cloud-based Point of Sale and retail operations platform tailored for specialty coffee shops and hospitality environments. Engineered as an installable Progressive Web Application (PWA) optimized for tablet and iPad touch viewports, the system streamlines fast-paced order workflows while maintaining strict financial integrity.
Architectural Overview
Built with Next.js 16 App Router on top of a kebab-case Hybrid Modular architecture, the platform strictly isolates business logic and transaction processing from presentational components. The database layer utilizes Prisma ORM connected to serverless PostgreSQL (Neon) with connection pooling and Zero-any TypeScript type contracts.
Key Capabilities & Features
- •
Direct ESC/POS Hardware Printing: Native browser-to-hardware communication generating raw ESC/POS bytecode over Web Bluetooth for 58mm thermal printers with dynamic QR-based digital invoice fallback.
- •
Cashier Shift Reconciliation: Complete shift management lifecycle tracking opening float, expected cash balance, physical cash count, and real-time audit logs for cash discrepancies.
- •
Sales & Analytics Intelligence: Visualized performance telemetry and sales trend charts tracking Total Penjualan, product category popularity, and peak order hours.
- •
Enterprise Security & PWA Readiness: Role-based access control (Admin/Cashier), zero credential data leaks, and service worker caching delivering immediate offline resilience.
Engineering Highlights
Thermal ESC/POS 58mm & Web Bluetooth
Native receipt generation directly in-browser communicating with 58mm thermal printers over Web Bluetooth with QR-based digital invoice fallback.
Hybrid Modular Next.js 16 Architecture
Feature-driven kebab-case structure with server-only database services, Zero-any TypeScript enforcement, and tablet/iPad touch-first responsive layout.
Financial Reconciliation & Cash Audit
Structured cashier shift cycles, automated drawer cash variance auditing, Zod validation contracts, and complete isolation of payment telemetry.