> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Dashboard

> Monitor incoming BCB mail at a glance — KPIs, mail categories, sync status, and recent activity in the Reporter module.

The **Dashboard** is the landing page of the **BC Correios** plugin. It gives you a single view of the mailbox health: how much mail has arrived, what still needs attention, how it breaks down by category, whether synchronization with the Banco Central do Brasil (BCB) is healthy, and what happened most recently.

## Accessing the Dashboard

***

Open **Reporter** > **BC Correios** > **Dashboard** from the left-side menu. The Dashboard is at the root of the BC Correios section.

<Note>
  The Dashboard requires the `dashboard:get` permission. Without it, you see a "not authorized" page instead of a partial view.
</Note>

## KPI cards

***

Four cards summarize the current state of the mailbox:

| KPI             | Meaning                                                                                                    |
| :-------------- | :--------------------------------------------------------------------------------------------------------- |
| **Total Mails** | All mail received from the BCB.                                                                            |
| **Unread**      | Mail not yet opened. Links directly to the [Inbox](/en/lerian-console/reporter-console/bc-correios-inbox). |
| **Urgent**      | Mail flagged as requiring prompt attention.                                                                |
| **Categories**  | Number of AI-derived categories detected across the mailbox.                                               |

## Sync status bar

***

The sync status bar shows the connection to the BCB and lets you trigger a manual fetch:

* **Status badge** — `Pending`, `Syncing`, `Completed`, or `Failed`.
* **Last sync** — relative time of the most recent synchronization (or "never synced").
* **Polling interval** — how often BC Correios checks for new mail (configured in [Settings](/en/lerian-console/reporter-console/bc-correios-settings)).
* **Credentials** — whether the BCB (Sisbacen) credentials are valid. If invalid, the badge links to Settings.
* **Sync now** — triggers an immediate synchronization without waiting for the next polling cycle.

<Note>
  If consecutive synchronization failures occur, a counter appears in the bar so you can react before mail is missed.
</Note>

### First-time setup prompt

If credentials have not been validated and no mail has been received yet, the Dashboard shows an onboarding alert prompting you to configure your **Sisbacen credentials** in Settings before mail can start arriving.

## Activity and category charts

***

* **Activity chart** — monthly volume of received mail, so you can spot spikes or quiet periods.
* **Mail categories** — a proportional bar with a legend showing the share of each [mail type](/en/lerian-console/reporter-console/bc-correios): Circular, Resolution, Communication, and Other, each with a count and percentage.

## Recent activity

***

The recent mails table lists the latest items received, with their type, subject, sender, and received time. Click a subject to open the [mail detail](/en/lerian-console/reporter-console/bc-correios-inbox#mail-detail) view.

<Tip>
  The Dashboard refreshes automatically while the tab is in focus — sync status roughly every 30 seconds and KPIs every minute. You don't need to reload the page.
</Tip>