Troubleshooting, limitations and operational checklists
This section provides a safe diagnostic order and states every important limitation found in the supplied version 1.0.0 UI/code.
Troubleshoot a module activation error
Troubleshoot a module activation errorInspect the exact install exception, required PHP/database support and missing table/option creation without direct destructive cleanup.
Open guide →GuideTroubleshoot a missing default location or register
Troubleshoot a missing default location or registerRerun the supported idempotent activation flow only after confirming tenant defaults are genuinely absent.
Open guide →GuideTroubleshoot a public shop 404
Troubleshoot a public shop 404Check the saved store-enabled toggle and route deployment.
Open guide →GuideTroubleshoot a blank or unstyled public shop
Troubleshoot a blank or unstyled public shopVerify module assets and generated URLs without changing the host theme.
Open guide →GuideTroubleshoot a missing product image
Troubleshoot a missing product imageVerify the saved external image URL and browser policy.
Open guide →GuideTroubleshoot incorrect public branding
Troubleshoot incorrect public brandingCheck tenant company options and saved store title/tagline/accent.
Open guide →GuideTroubleshoot an incorrect online stock location
Troubleshoot an incorrect online stock locationCheck the default location setting and product stock row.
Open guide →GuideTroubleshoot a low-stock dashboard warning
Troubleshoot a low-stock dashboard warningCompare available quantity, threshold and reorder data.
Open guide →GuideTroubleshoot a register sale blocked by shift state
Troubleshoot a register sale blocked by shift stateOpen an active shift for the selected register/current staff member.
Open guide →GuideTroubleshoot a duplicated checkout concern
Troubleshoot a duplicated checkout concernSearch orders by reference/idempotency before any retry.
Open guide →GuideTroubleshoot concurrent stock changes
Troubleshoot concurrent stock changesRefresh the cart/register and honour locked transaction results.
Open guide →GuideTroubleshoot an order status mismatch
Troubleshoot an order status mismatchCompare payment, fulfilment and return evidence separately.
Open guide →GuideTroubleshoot an incorrect paid or due amount
Troubleshoot an incorrect paid or due amountReconcile payment rows and any linked invoice payments.
Open guide →GuideTroubleshoot an email template issue
Troubleshoot an email template issueReview the two module-created templates and host SMTP without altering unrelated templates.
Open guide →GuideTroubleshoot API authentication
Troubleshoot API authenticationCheck Bearer format, hash match, expiry, revocation and tenant.
Open guide →GuideTroubleshoot API permission scope
Troubleshoot API permission scopeUse the minimum correct read scope.
Open guide →GuideTroubleshoot webhook encryption unavailable
Troubleshoot webhook encryption unavailableRestore OpenSSL/module encryption-key support before creating a secret.
Open guide →GuideTroubleshoot webhook DNS changes
Troubleshoot webhook DNS changesEnsure all newly resolved endpoint addresses remain public and safe.
Open guide →GuideTroubleshoot cron backlog
Troubleshoot cron backlogConfirm host cron runs and processes up to 25 webhook deliveries per run.
Open guide →GuideTroubleshoot stale rate-limit or idempotency records
Troubleshoot stale rate-limit or idempotency recordsAllow cron cleanup after expiry; do not delete active protective records.
Open guide →GuideUnderstand full-return-only limitations
Understand full-return-only limitationsNo partial return screen is supplied.
Open guide →GuideUnderstand external-refund limitations
Understand external-refund limitationsNo card, bank or gateway refund is executed by the return action.
Open guide →GuideUnderstand inventory editor limitations
Understand inventory editor limitationsNo direct UI edits reserved, in-transit, quarantined, damaged or reorder quantities.
Open guide →GuideUnderstand purchase workflow limitations
Understand purchase workflow limitationsOne product line per receipt; no full purchase-order approval/payment UI.
Open guide →GuideUnderstand promotion limitations
Understand promotion limitationsOne best promotion per line; no active stacking despite schema capability.
Open guide →GuideUnderstand product-type limitations
Understand product-type limitationsAdvanced combo/recipe/variant/lot/serial/digital workflows are not implemented as full screens.
Open guide →GuideUnderstand gift-card limitations
Understand gift-card limitationsGift card and ledger tables exist but no management/checkout UI is exposed.
Open guide →GuideUnderstand digital entitlement limitations
Understand digital entitlement limitationsThe table exists but no delivery/entitlement administration screen is exposed.
Open guide →GuideUnderstand API limitations
Understand API limitationsRead-only GET routes; no report route despite selectable reports:read.
Open guide →GuideUnderstand webhook administration limitations
Understand webhook administration limitationsCreate and disable only; no edit/re-enable/delete/delivery browser/replay screen.
Open guide →GuideUnderstand audit UI limitations
Understand audit UI limitationsMost recent 200 display; no full verifier or export control.
Open guide →GuideUnderstand report limitations
Understand report limitationsCurrent supplied summaries only; no export or formal accounting statements.
Open guide →GuideUnderstand shift cash-event limitations
Understand shift cash-event limitationsExpected formula stores paid-in/out/drop values, but no UI posts them.
Open guide →GuideUnderstand cash-on-delivery configuration limitations
Understand cash-on-delivery configuration limitationsThe method is available without its own enable/disable setting.
Open guide →GuideUnderstand uninstall limitations
Understand uninstall limitationsNo destructive automatic uninstall is supplied; data deletion requires separate authorisation.
Open guide →GuideRun the complete POS administrator acceptance test
Run the complete POS administrator acceptance testTest activation, permissions, settings, locations, registers, shifts, catalogue, stock, purchases, POS, orders, reports, audit and integrations.
Open guide →GuideRun the complete public-store acceptance test
Run the complete public-store acceptance testTest shop, category, product, cart, checkout, order token, email, SEO, sitemap, PWA and disabled state.
Open guide →GuideRun the complete finance reconciliation test
Run the complete finance reconciliation testTest POS tenders, public payment methods, native invoice hooks, fulfilment and return/refund_due handling.
Open guide →GuideRun the complete inventory acceptance test
Run the complete inventory acceptance testTest adjustment reasons, purchase receipt, POS deduction, online reservation/fulfilment and return restoration.
Open guide →GuideRun the complete integration acceptance test
Run the complete integration acceptance testTest API scopes/rates and webhook signing/retries/dead-letter behaviour.
Open guide →GuideRun the complete security acceptance test
Run the complete security acceptance testTest least privilege, tenant isolation, CSRF, tokens, hashes, encryption, SSRF controls, headers, rate limits and audit.
Open guide →GuideRun the production go-live checklist
Run the production go-live checklistVerify approved configuration, staff training, opening stock, SMTP, payments, legal pages, HTTPS, cron, integrations and rollback process.
Open guide →GuideRun the post-go-live daily checklist
Run the post-go-live daily checklistReview open shifts, failed orders, low stock, purchase exceptions, refund_due items, email/webhook failures and audit anomalies.
Open guide →GuideRun the module replacement verification checklist
Run the module replacement verification checklistVerify archive root, hashes, permissions, activation state, routes, assets and retained data after replacing code.
Open guide →