# Project Dashboard

<p class="doc-lead">The Project Dashboard gives a company-wide view of project operations and, when permitted, financial performance — KPI cards, status chart, sales-vs-cost trend, and top projects by invoiced value.</p>

<div class="doc-toc">
<p class="doc-toc-title">On this page</p>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Getting started</span>
<div class="doc-toc-links">
<a href="#/project/project-dashboard?id=overview">Overview</a>
<a href="#/project/project-dashboard?id=period-filter">Period filter</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Widgets &amp; charts</span>
<div class="doc-toc-links">
<a href="#/project/project-dashboard?id=operational-kpis">Operational KPIs</a>
<a href="#/project/project-dashboard?id=financial-kpis">Financial KPIs</a>
<a href="#/project/project-dashboard?id=charts">Charts</a>
<a href="#/project/project-dashboard?id=top-projects">Top Projects</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">More</span>
<div class="doc-toc-links">
<a href="#/project/project-dashboard?id=example">Example</a>
<a href="#/project/project-dashboard?id=faq">FAQ</a>
<a href="#/project/project-dashboard?id=related">Related</a>
</div>
</div>
</div>

<hr class="doc-section-divider">

<h2 id="overview">Overview</h2>

Go to <b>Project → Dashboard</b> from the left menu.

The dashboard loads automatically when you open it. Use the date range in the header and click <b>Apply</b> to change the reporting period for operational KPIs, financial KPIs (when visible), and the Top Projects table.

<b>Who sees what</b>

| **Section** | **Typical access** |
|-------------|-------------------|
| Operational KPIs, Projects by Status chart | Users with Project Dashboard widget permission |
| Financial KPIs, Sales vs Cost chart, Top Projects | Users who can open <a href="#/project/reports/project-wise-profit">Project Wise Profit</a> |

> Screenshot pending — `project/images/project-dashboard.webp`

<hr class="doc-section-divider">

<h2 id="period-filter">Period filter</h2>

| **Control** | **Description** |
|-------------|-----------------|
| Date range (header) | Select the period for KPI cards and Top Projects. Defaults to <b>this month</b>. |
| Apply | Reload the dashboard with the selected period. |

<b>Important:</b> The <b>Sales vs Cost (Last 12 months)</b> chart always shows the trailing twelve months and does not change when you adjust the period filter.

<hr class="doc-section-divider">

<h2 id="operational-kpis">Operational KPIs</h2>

These widgets reflect the <b>selected period</b> label shown above the cards (for example, “This month” or a custom range). Several cards link to filtered lists when clicked.

| **Widget** | **What it shows** | **Drill-down** |
|------------|-------------------|----------------|
| <b>Total Projects</b> | Count of all projects | <a href="#/project/projects">Projects</a> list |
| <b>On Going</b> | Projects with status On Going | Projects list filtered to On Going |
| <b>Completed</b> | Projects marked Completed | Projects list filtered to Completed |
| <b>Not Started</b> | Projects not yet started | Projects list filtered to Not Started |
| <b>Overdue Projects</b> | Active projects past due date | — |
| <b>Due This Month</b> | Active projects with due date in the current calendar month | — |
| <b>Open Tasks</b> | Tasks not yet finished | <a href="#/project/project-task">Project Task</a> list |
| <b>Overdue Tasks</b> | Open tasks past planned end date | — |

<b>Active projects</b> for Overdue and Due This Month means status <b>Not started</b>, <b>On Going</b>, or <b>Paused</b> — Completed, Cancelled, and Stopped projects are excluded.

<hr class="doc-section-divider">

<h2 id="financial-kpis">Financial KPIs</h2>

Visible only when your role can access <b>Project Wise Profit</b>. Totals include <b>labor cost</b> and extra project rates (when set) and match the grand totals on <a href="#/project/reports/project-wise-profit">Project Wise Profit</a> for the same period.

| **Widget** | **What it shows** |
|------------|-------------------|
| <b>Invoiced</b> | Approved sale invoice value linked to projects in the period |
| <b>Total Cost</b> | Consumables, purchases, expenses, payslip cost, plus Additional Cost and Unconsidered Hours Cost when those rates are set |
| <b>Labor Cost</b> | Payslip cost allocated from payslip and attendance (considered hours) |
| <b>Profit</b> | Invoiced minus total cost |
| <b>Profit Margin</b> | Profit as a percentage of invoiced value |

<hr class="doc-section-divider">

<h2 id="charts">Charts</h2>

<h3 id="projects-by-status">Projects by Status</h3>

A pie chart of project counts by status: <b>Not started</b>, <b>Completed</b>, <b>On Going</b>, <b>Paused</b>, <b>Cancelled</b>, and <b>Stopped</b>. Empty status buckets are omitted from the chart.

<h3 id="sales-vs-cost">Sales vs Cost (Last 12 months, incl. labor)</h3>

Line chart comparing monthly <b>Sales</b> (invoiced value) and <b>Cost</b> (consumables, purchases, expenses, payslip cost, and extra project rates when set) for the last twelve months. Requires Project Wise Profit report access.

<hr class="doc-section-divider">

<h2 id="top-projects">Top Projects</h2>

A table of up to eight projects ranked by <b>invoiced value</b> in the selected period. Columns include Invoiced, Total Cost, Labor Cost, Profit, and Margin. Click a row to open that project.

Requires Project Wise Profit report access.

<hr class="doc-section-divider">

<h2 id="example">Example</h2>

A operations manager opens the dashboard on the first Monday of the month. Operational cards show eight overdue projects and six overdue tasks. They click <b>On Going</b> to review active jobs.

The finance lead widens the period to the financial year, checks <b>Invoiced</b> and <b>Profit</b> against last month, then uses the Top Projects table to open the highest-value job for detail.

<hr class="doc-section-divider">

<h2 id="faq">FAQ</h2>

<b>Why do KPI cards and the chart show different periods?</b><br>
KPI cards and Top Projects use the date range you select (default this month). The Sales vs Cost chart is always the last twelve months so you can see the trend regardless of the card period.

<b>Why do I not see financial widgets or charts?</b><br>
Financial KPIs, the sales-vs-cost chart, and Top Projects require access to <a href="#/project/reports/project-wise-profit">Project Wise Profit</a>. Operational widgets and the status pie chart still appear if you have Project Dashboard widget permission.

<b>Is this the same as the dashboard inside a single project?</b><br>
No. <b>Project → Dashboard</b> is company-wide. The <b>Dashboard</b> tab inside one project shows that project's sale, purchase, and expense totals — see <a href="#/project/projects?id=project-view-dashboard">Project View Dashboard</a>.

<b>Do financial totals include labor cost?</b><br>
Yes. Total Cost and the monthly cost line include payslip cost from attendance, plus Additional Cost and Unconsidered Hours Cost when those rates are set on the project — consistent with Project Wise Profit.

<b>Why is Overdue Projects different from overdue tasks?</b><br>
Overdue Projects looks at the project <b>due date</b> for active projects. Overdue Tasks looks at each task's <b>planned end date</b> for tasks not yet finished.

<b>Can I see Paused, Cancelled, or Stopped on the dashboard?</b><br>
Yes — they appear in the Projects by Status pie chart. Operational count cards focus on the main working statuses; use the <a href="#/project/projects">Projects</a> list quick-filter tabs for Paused, Stopped, and Cancelled.

<b>How is Top Projects sorted?</b><br>
By invoiced (sale invoice) value in the selected period, not by contract or project value on the project header.

<hr class="doc-section-divider">

<h2 id="related">Related</h2>

<ul>
<li><a href="#/project/projects">Projects</a></li>
<li><a href="#/project/reports/project-wise-profit">Project Wise Profit</a></li>
<li><a href="#/project/reports/project-summary">Project Summary</a></li>
<li><a href="#/project/daily-schedule">Daily Schedule</a></li>
</ul>
