POS Client

Run the offline-capable storefront backed by the posclient API. This guide follows version 3.1.7 (03acdf712c).

For POS domain logic, see Sales.

Components

• Backend: backend/plugins/posclient_api/src/ (modules/posclient/, worker/, routes.ts, userMiddleware.ts, configMiddleware.ts, port 3312 with MQ workers). There is no frontend/plugins/posclient_ui; the storefront is the standalone app below. No src/meta/permissions.ts exists in the checked revision.
• App: apps/posclient-front/ is a standalone Next.js 14 (React 18) PWA with next dev -p 7002.

The app reads NEXT_PUBLIC_MAIN_API_DOMAIN (for example http://localhost:4000) plus subscription and upload helpers (/graphql, /upload-file, /delete-file). public/js/env.sample.js and docker-entrypoint.sh show the runtime NEXT_PUBLIC_* injection pattern.

Verify

1. Run the initial-setup route against staging and confirm per-POS config resolves.
2. Place an order offline and online, then confirm sync and payment status.
3. Rebuild with the production API domain and confirm uploads and subscriptions target it.

Source references

• posclient API.
• POS storefront env sample.