Store Customers Directory & Overview Statistics Guide

The Store Customers Management module in TRAX Store Management System allows retail businesses to build customer relationships, track spending habits, and link checkout transactions to individual customer profiles.

---

1. Navigation & Access Control #

• Route Path: Navigate to /home/customers from the primary sidebar menu.
• Permissions: Accessible by Store Administrators (Admin) and Store Managers.
• Subscription Feature Key: Governed by the crm feature in your store subscription plan.

---

2. Real-Time Customer Summary Cards #

At the top of the Customers page, three live metric cards summarize your customer engagement:

1. Total Customers (👥): Total number of registered active customer profiles in your store database.
2. Total Orders (🧾): Cumulative count of completed checkout sales linked to registered customers.
3. Total Customer Spent (💰): Total revenue generated from registered customer purchases (calculated live in Euros € by aggregating both cloud database records and local offline invoices).

Visual Reference: Customers Management Table & Summary Cards

(Upload and insert the generated customers_real_ui image here)

---

3. Customers Data Table Breakdown #

The main directory table provides quick insights into customer activity:

Column Header	Field Details & Behavior
#	Row index number.
Customer ID	Unique customer identification number with a blue barcode icon (pi pi-barcode). Clicking the ID immediately opens the Customer Details modal.
Customer Name	Primary client name (displayed in bold text).
Phone	Customer contact number formatted with phone icon (pi pi-phone). Displays “Not specified” if empty.
Orders Count	Blue tag badge (p-tag) displaying total historical order count.
Total Spent	Total expenditure in Euros formatted to two decimal places (e.g., 18,450.00 €).
Actions	Action buttons: View Details (Eye), Edit (Pencil), and Delete (Trash).

4. Real-Time Search & Filtering #

• Debounced Search Bar: Type any customer name, phone number, or email into the search box. The list filters dynamically after 600ms without reloading the page.
• Clear Search: Click the (✕) button on the right side of the input to reset search filters instantly.
• Customer Count Tag: A blue pill tag displays the exact count of filtered results (e.g., “Showing 12 Customers”).