# XWUIOpsCommercialDashboardPage

The OPFlow Commercial Dashboard: an `XWUIShellPage` wrapping an `XWUIDashboard` with a Fiscal-Year + Quarter toolbar, an eight-tile macro-KPI ribbon (Recognized Revenue, Pipeline Revenue, Profit Margin, Invoiced, Paid, Unpaid, Invoices count, Active Deals count), and a vertically-stacked widget grid covering Invoice Aging (Current / 30 / 60 / 90 / Overdue buckets), Revenue vs Target, Pipeline Funnel, Revenue Trend, Revenue by Client, Revenue by Category, Quarterly Progress mini-cards, Profit by Project, and an Invoice Tracking block. Money fields accept raw SAR numbers (formatted en-SA inside the component) or pre-formatted shorthand strings like "31.3M"; the chart bodies are pluggable content slots. Use it as the finance command centre for the Commercial module.

## Basic Usage

Mounts the dashboard for fiscal year 2026 with the eight KPI tiles, the invoice-aging buckets, and four quarterly-progress cards populated from raw SAR figures.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Commercial Dashboard for FY2026 / All Quarters with 31.3M recognized revenue, 33.75% margin, invoice-aging buckets, and Q1-Q4 progress cards.
```

## Q4 Close-out

Scopes the dashboard to a single quarter at year-end, with healthy collections and quarterly cards showing the year nearly landed.

```example
file: examples/Q4Closeout.ts
html: examples/Q4Closeout.html
title: Q4 Close-out
description: FY2026 / Q4 close-out view with 12.4M recognized revenue, 38.2% margin, an almost-fully-collected aging row, and Q1-Q3 cards at target with Q4 at 89%.
```

## Prior-Year Review (shorthand)

Looks back at the closed FY2025 year using the string-shorthand money API and an overdue-heavy aging row.

```example
file: examples/PriorYearReview.ts
html: examples/PriorYearReview.html
title: Prior-Year Review (shorthand)
description: Closed FY2025 review built entirely from pre-formatted "M" shorthand strings, with an overdue-weighted aging row (6.7M unpaid) and four landed quarters.
```

```api
```