Core Architecture SpecificationNext.js 15 App Router · TypeScript · Multi-Tenant

One operational truth, everywhere your business works.

RetailHunch connects the counter POS, responsive webshop, shared inventory pool, and European Peppol e-invoicing through a resilient four-tier architecture. Built from the ground up for sub-second stock locking, zero cross-tenant memory leakage, and complete offline continuity.

Stock Lock Latency

< 45ms

Sub-second lock

Offline Resilience

100%

Zero dropped sales

Tenant Isolation

Strict

Scoped keys & schemas

E-Invoicing Standard

Peppol BIS 3

50+ countries ready

Topology & System Boundaries

The Four-Tier Architecture

Explore how requests flow from front-of-house touchscreens and web shoppers through multi-tenant security barriers to the atomic inventory ledger and regulatory compliance gateways.

Tier 1 · Surface4 Operational Modules

Omnichannel Presentation Tier

High-speed touch interfaces, responsive webshop & merchant back-office

High-Speed POS Register

pos-workspace.tsx

Sub-20ms keyboard SKU lookup, barcode reader support, split-tender and offline buffer.

Key Guarantees

  • Tactile barcode & hotkey workflow
  • Multi-tender payment modal
  • Sub-second cash shortfall validation

Omnichannel Webstore

storefront-app.tsx

Multi-tenant responsive e-commerce storefront with live inventory visibility and deep-linked tracking.

Key Guarantees

  • Instant stock availability checks
  • Click & Collect / home delivery routing
  • Dynamic promotion & coupon calculator

Customer Display Terminal

pos-customer-display.tsx

Secondary counter display streaming real-time basket items, promotional alerts, and payment QR codes.

Key Guarantees

  • Zero-latency cart mirroring
  • Tax-inclusive line breakdown
  • Shopper loyalty profile greeting

Unified Operations Hub

dashboard-workspace.tsx

Central back-office for catalogue, stocktaking, purchase orders, customer CRM, and margin analytics.

Key Guarantees

  • True gross margins after COGS
  • Supplier reorder batching
  • Audit trail inspection
Interactive Telemetry Simulator

Live Data-Flow Simulator

Trace real execution pipelines across the architecture. Select a workflow below to step through packet latencies, atomic locks, and regulatory payloads.

Omnichannel Stock Locking (Counter POS + Webshop)

Demonstrates sub-second stock locking when an in-store cashier and online customer view the same last 2 units.

1Step 1: Item Scanned at Counter Till
8msTier 1 · Surface

SKU #74201 scanned via USB reader. Net price €41.32 + 21% VAT = €50.00.

Target Module: High-Speed POS Register

2Step 2: Sub-Second Stock Reservation Lock
24msTier 3 · Operations
3Step 3: Webshop Real-Time Stock Broadcast
36msTier 1 · Surface
4Step 4: POS Sale Finalized & VAT Receipt Emitted
42msTier 4 · Compliance
Step 1 of 4
Wire Payload Inspector
Latency: 8ms

Active Pipeline Component

High-Speed POS Register

Telemetry Event

SKU #74201 scanned via USB reader. Net price €41.32 + 21% VAT = €50.00.

Raw JSON Envelope

{
  "action": "ITEM_LOOKUP",
  "sku": "74201",
  "quantity": 1,
  "registerId": "reg_01"
}
Real-time channel activePayload idempotency verified
Architecture Compared

RetailHunch Core vs. Fragmented Retail Stacks

Why independent retailers encounter inventory discrepancies, lost receipts, and VAT audit headaches with traditional disconnected tools.

Stock Synchronization

RetailHunch Architecture:

Single shared stock pool with sub-second locking. Ringing up an item on the counter immediately reserves stock away from web visitors.

Fragmented Legacy Tools:

Nightly batch exports or delayed webhook syncs that lead to double-selling during busy footfall periods.

Network Fault Tolerance

RetailHunch Architecture:

Offline-first cashier execution. Sales are signed and buffered locally with cryptographic UUID keys and auto-flushed when connection returns.

Fragmented Legacy Tools:

Cloud-only registers lock up completely when the shop Wi-Fi hiccups, stalling queues and causing walkouts.

Tax & B2B Compliance

RetailHunch Architecture:

Native Peppol BIS 3.0 UBL e-invoicing and statutory VAT calculations per item category. Fully audit-ready without manual retyping.

Fragmented Legacy Tools:

Requires third-party billing connectors or manual PDF re-entry by an external accountant each quarter.

Capacity Planning

Operational Throughput Calculator

Simulate system behavior for your store footprint. Adjust your store count and transaction velocity to see expected concurrency locking response times.

3 stores
1 boutique10 branches25 locations
650 sales/day
50 sales1,500 sales3,000 sales

Concurrency Guarantee: Every sale executes an atomic write-ahead stock movement. If an online shopper and an in-store customer claim the last unit within milliseconds, the reservation queue rejects the second order with an immediate out-of-stock warning before payment capture.

Stock Lock Latency

~25 ms

99.9th percentile response

Daily Stock Movements

5,460

Atomic inventory writes

Peak DB Throughput

0.4 qps

Easily handled on base tier

Overselling Risk

0.00%

Pessimistic stock lock

Ready to Connect Your Store?

Experience the Connected Platform

Start with a 14-day guided trial. Connect your physical counter, launch your branded webshop, and issue Peppol e-invoices with zero setup fees.

Connected Commerce For Independent Retail

Ready to run your store from one connected pulse?

Experience fast POS checkout, unified stock management, autonomous reorder workflows, and Peppol e-invoicing built for independent retail across 50+ supported countries.