Skip to main content

Dashboard

Process Demonstration​

Dashboard process preview

Executive Summary​

The Dashboard screen provides an at-a-glance view of key performance indicators (KPIs) related to fuel station operations. It consolidates sales data, nozzle performance, and tank stock levels into a single interface, enabling operators to monitor daily and monthly metrics efficiently.

Business Purpose​

This screen supports operational decision-making by delivering real-time insights into fuel sales volumes and revenues, nozzle dispensing statistics, and fuel stock availability in tanks. It aids in identifying performance trends, optimizing fuel dispensing, and ensuring sufficient stock levels for uninterrupted service.

Operating Procedure​

  1. Access the Dashboard via the main navigation or by entering the URL path /dashboard.
  2. Review the KPI cards at the top of the screen, which display "Today's Sales by Product" including volumes (L) and sales values (Rs) for the current day and month.
  3. Examine the "Nozzle Stats" widget to monitor individual nozzle fuel dispensation details broken down by today’s liters and revenue, monthly liters and revenue, and 7-day dispensing trends.
  4. Use the charts and tables to observe daily and monthly comparisons, as indicated by labels such as "Day / month" and "T vs M."
  5. Inspect the "Tank Stock Levels" widget to verify current fuel quantities in storage tanks to plan refills and inventory management.
  6. Scroll through the dashboard as needed to ensure full visibility of all KPI cards, charts, and tables.
  7. Hover over specific areas such as “Nozzle Stats” and “Tank Stock Levels” widgets to access detailed information or tooltips where applicable.

Required Inputs​

  • Real-time fuel sales data aggregated by product and nozzle.
  • Current and historical tank stock levels.
  • Date and time context to appropriately display daily and monthly statistics.

Validation Rules​

  • KPI cards must load immediately after the page header <h1> and main cards become visible.
  • Sales volumes and revenues must accurately reflect the current day and month without lag.
  • Nozzle stats should match recorded dispensing data for each nozzle.
  • Tank stock levels must correspond to the latest inventory readings.
  • Data elements should update dynamically and refresh upon user page access or predetermined intervals without requiring manual intervention.

Expected Results​

  • The Dashboard page fully loads with visible header and KPI cards within a short wait time.
  • The "Today's Sales by Product" section correctly shows sales quantities in liters and amounts in rupees for the current day.
  • The "Nozzle Stats" section displays accurate per-nozzle data for liters dispensed and revenue generated both daily and monthly, along with a 7-day summary.
  • Charts and tables provide clear comparative views of daily versus monthly performance metrics.
  • The "Tank Stock Levels" widget accurately reflects current fuel inventory status, visible without display errors.
  • Hover interactions reveal additional nozzle or tank data without delay.

Exception Handling​

  • If any KPI card or widget fails to load within a reasonable timeframe (approximately 700ms post-scroll), refresh the page or re-access the dashboard to trigger data reload.
  • Missing or inconsistent nozzle statistics should prompt verification of dispenser data integrity and reconfirmation of real-time feed connectivity.
  • Discrepancies in tank stock levels require immediate reporting to inventory control to prevent stockouts or overordering.
  • Unresponsive hover tooltips suggest potential UI glitches; performing a browser refresh or switching browsers may resolve the issue.
  • Persistent data inconsistencies or load failures must be escalated to system support for investigation.

This document is system-generated and maintained by the PMS documentation automation pipeline.