Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.laportenard.com/llms.txt

Use this file to discover all available pages before exploring further.

Sirvo POS is a restaurant point-of-sale system built as a monorepo with a Next.js frontend packaged as a Tauri desktop app and an Odoo 12 Python backend providing the JSON API.

Key capabilities

  • Table-based order management with floor plan UI
  • Kitchen status tracking (open → sent → changed → paid)
  • User role controls (manager, cashier, waiter)
  • Dominican tax integration (NCF/DGII)
  • Real-time sync via WebSocket hub
  • Offline-first with IndexedDB persistence

Tech stack

Frontend

Next.js 16, React 19, TypeScript, Tauri, XState, Dexie, Radix UI, Tailwind v4

Backend

Odoo 12 (Python), PostgreSQL, JWT auth

Sync hub

Node.js, WebSocket, SQLite (WAL mode)

Desktop

Tauri (Rust) wrapping the Next.js static export

Repository modules

ModuleDescription
nu_pos_react/Frontend — Next.js 16 app with Tauri shell
nu_restaurant_pos/Odoo 12 addon — JSON API, POS models, accounting
nu_pos_voids/Void system with configurable reasons and audit trail
nu_pos_side_dishes/Side dishes / modifiers feature
nu_pos_sync_protocol/Shared sync protocol — Zod-validated message types
nu_pos_hub/Sync hub — WebSocket broker with SQLite