# 📊 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.
***
### 📅 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:
| 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:
| 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
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.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://codehas.gitbook.io/advance-point-of-sale-next-pos/dashboard.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.