kazir.co.id

Internal R&D at KB Consulting — a product we built for ourselves as a POS reference architecture, so we can white-label it for Indonesian SME and retail clients. Existing players (Moka, Pawoon, Olsera) are good, but monthly per-outlet billing is too heavy for small shops; free apps like Kasir Pintar lack AI, multi-outlet, and serious multi-tenancy. The gap was clear: an affordable, AI-native local POS platform that can be forked as the starting point for client projects.

Multi-tenancy: database-per-tenant via stancl/tenancy v3.8 on PostgreSQL — not row-level. The trade-off is slightly higher infrastructure cost, but per-tenant compliance and auditing are much cleaner, queries never scan thousands of other tenants' rows, and we can offer specific data residency to enterprise clients. Offline-first mobile was non-negotiable: cashiers must keep selling through an 8-hour WiFi outage and sync cleanly once back online — Drift SQLite + a reconciliation queue that handles conflicts (out of stock on the server vs. sold on mobile, price changes, etc.). Hardware integration (Bluetooth ESC/POS thermal printers, barcode scanners) had to be reliable on IDR 1–2M Android devices, not just flagships.

Laravel 11 backend: Sanctum auth (password + a PIN for cashier terminals), Horizon on Redis queues, Reverb WebSocket for real-time per-outlet order broadcasts, Meilisearch full-text search, a repository pattern (Controllers → Services → Repositories), and event-driven double-entry accounting (OrderCompleted → CreateSaleJournalEntry, OrderVoided → ReverseJournalEntry). AI subsystem: AIServiceManager + GeminiProvider with tiered models (fast/pro/lite), an AIUsageTracker with per-plan daily limits, prompt template classes, and an AICache to save tokens. Scheduled commands: GenerateDailyInsights, GenerateDemandForecast, GenerateReorderSuggestions, CheckAnomalies. A tenant-isolation safety-net middleware fires a critical alert if a DB connection leaks to the central database.

Live at kazir.co.id — the apex Next.js app for marketing + login + dashboard, api.kazir.co.id for the Laravel API, ws.kazir.co.id for Reverb, wildcard *.kazir.co.id for tenant subdomains, plus on-demand certificates for Pro-tier custom domains. Deployed via GitHub Actions + Docker Compose + Caddy. Currently onboarding beta tenants while rolling out more advanced AI features. A reference architecture for clients who need a custom POS / multi-tenant SaaS — fork it as a starting point and save 6–10 weeks of setup versus building from scratch.