# 📊 Dashboard

The Dashboard is your command center—providing a real-time overview of your store’s sales, expenses, profits, stock status, and more. Whether you’re managing a single outlet or multiple, this is the first screen you’ll check to stay informed and in control.

<figure><img src="https://2303123582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mg970NsjedQxcUQ2m-0%2Fuploads%2FraYCaXcts9eNYpUN94dV%2Fimage.png?alt=media&#x26;token=36b84a8f-b5af-4386-9aa8-e4f87c5f2d81" alt=""><figcaption></figcaption></figure>

***

### 📅 Report Period Selector



At the top of the dashboard, you can select a reporting period:

* Today
* This Month
* This Year

The entire dashboard refreshes based on the selected range, allowing you to compare current stats against the previous equivalent period.

***

### 📈 Key Metrics Overview 

Six primary KPIs (Key Performance Indicators) are shown at the top, each comparing current values to the previous period:

<figure><img src="https://2303123582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mg970NsjedQxcUQ2m-0%2Fuploads%2FVIAGJi7rdppZesCUpG88%2Fimage.png?alt=media&#x26;token=1e5f359d-fc29-4063-998d-66d993417277" alt=""><figcaption></figcaption></figure>

| Metric         | What It Means                                                               |
| -------------- | --------------------------------------------------------------------------- |
| 💰 Total Sales | Total gross revenue generated within the selected period.                   |
| 🧾 Total Tax   | Combined tax amount collected on all sales.                                 |
| 📉 Expenses    | All business expenses (like utilities, rent, repairs) logged in the system. |
| 📦 Items Sold  | Number of product units sold during the reporting range.                    |
| 📈 Profit      | Net profit after subtracting costs and expenses from sales.                 |
| 🧮 Cost        | Combined cost of goods sold, calculated using each product’s cost price.    |

Each card also shows a % change compared to the previous period, giving you immediate insight into performance trends.

***

### 📚 Cashbook History 

A 10-entry log of the most recent cashbook activities is displayed in a table format. Each row shows:

<figure><img src="https://2303123582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mg970NsjedQxcUQ2m-0%2Fuploads%2FVh27qwCwwlZiaLPeh9SE%2Fimage.png?alt=media&#x26;token=c5478fff-510e-4a14-ac13-9c10d77c37ca" alt=""><figcaption></figcaption></figure>

| Column          | Meaning                                                   |
| --------------- | --------------------------------------------------------- |
| 🔓 Opening      | Starting cash amount at the beginning of the entry period |
| 💳 Sales        | Total revenue collected                                   |
| 📦 Items        | Number of items sold in that session                      |
| 💸 Tax          | Tax collected from the sales                              |
| 🎁 Discount     | Any discounts applied during sales                        |
| 💼 Profit       | Net profit from that session                              |
| 🕒 Last Updated | The date when the cash session was last closed or edited  |

> 🔐 Cashbook sessions can be reviewed under Cash Registers, allowing better financial transparency.

***

### ⚠️ Stock Alerts

<figure><img src="https://2303123582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mg970NsjedQxcUQ2m-0%2Fuploads%2FniRTICITqHwgJ4rkI6kQ%2Fimage.png?alt=media&#x26;token=c627d3e1-da08-47a0-a087-9b1d58fbffff" alt=""><figcaption></figcaption></figure>

This section highlights products that have hit critical low stock levels, helping you prevent stockouts. For each low-stock product, the system shows:

* SKU (Stock Keeping Unit)
* Product Name
* Current Quantity (QTY)



Products with QTY: 0 appear automatically in this list, and you can click on each item to go directly to the inventory update page.



> 📦 Stay ahead of demand—enable email or in-app notifications for stock alerts under Settings → Inventory.

***

### 🧠 Dashboard Tips

* 🔄 Data Refresh: Most dashboard data is cached for performance and refreshed in near real-time.
* 🧑‍🤝‍🧑 User Role Control: Admins see everything; cashiers and warehouse staff will only see role-relevant data.
* 🛠 Custom Widgets (Coming Soon): Future updates will allow hiding/reordering dashboard widgets based on user preference.
