pos-system/microservices/apps/tpos-mvp-next

GoodGo TPOS MVP Next.js

Next.js/TypeScript MVP that consolidates the core GoodGo microservices into one deployable app:

• Merchant + Shop management
• Catalog + category management
• POS checkout
• Orders + payment metadata
• Inventory and stock movements
• FnB tables
• Dashboard and health check

The app uses PostgreSQL directly and bootstraps the core tables idempotently on startup. Keep DATABASE_URL outside git; use the connection string provided for this project in your shell or local environment.

cd microservices/apps/tpos-mvp-next
DATABASE_URL="..." pnpm db:setup
DATABASE_URL="..." pnpm db:seed
DATABASE_URL="..." pnpm dev

Default dev URL: http://localhost:3010.

MVP service mapping

This app keeps the public workflow close to the current microservices while deploying as one Next.js app:

• IAM/Merchant: workspace, shop, branch/staff-ready boundaries.
• Catalog: products, categories, SKU/barcode lookup surface.
• Inventory: stock items, stock transactions, low-stock control.
• Order: POS checkout, paid orders, discounts, cash tender/change.
• FnB Engine: tables/rooms and table status for cafe/restaurant/karaoke.
• Wallet/Promotion: MVP payment ledger and manual voucher/discount metadata.
• Booking: deferred domain for spa/beauty appointments, represented by service product types for now.

The BFF-compatible route group is /api/bff/[...path]; direct checkout uses /api/orders.