# Dashboard main page (home) plan

> One file: `docs/project/cruds/dashboard-home.md`. The admin **home page** (`admin.home`) — the first screen
> after login. Built once per project from this plan, alongside the CRUDs. Drives `build-dashboard-crud` §14.

## 1) KPI cards (aggregate across main entities)
- `<entity>`: `<total / active / this-month / …>` — source: `App\Services\Admin\<Entity>Service` (no queries in Blade).
- … one set per key entity.

## 2) Charts (ApexCharts — already bundled)
- `<title>`: `<line/bar/donut>` — data: `<by month / by status / by type>` — source service method.

## 3) Quick links / shortcuts
- `<label>` → `route('admin.<plural>.<action>')` (the main CRUDs the admin uses most).

## 4) Layout
- Extends `admin.layouts.master`; reuse the stats/diagram partials & JS used by the CRUD statistics.
- Responsive cards grid; figures via `number_format`; **no inline `style=`** on icons (use CSS tokens).

## 5) Translations (mandatory)
- Every card title, chart title, quick-link label, and section heading exists in **both** `lang/ar` and `lang/en`.
  Zero hardcoded strings.

## 6) Build checklist
- [ ] `HomeController@index` (thin) pulls aggregates from the entity services → returns the view.
- [ ] view `resources/views/admin/home/index.blade.php` (cards + charts + quick links).
- [ ] all strings translated ar+en · `admin.home` route + sidebar `home` entry present.