# Phase 4: Cardex Core Components

## Objective

Create reusable cardex foundations used by User, Family, Coach, and Employee views.

---

## Tasks

### 4.1 Shared cardex page structure

- Header identity panel.
- KPI strip.
- Tabbed timeline/history area.
- Action rail for quick operations.

### 4.2 Shared data transformers

- Normalize timeline entries from bookings/orders/access/finance events.
- Standardize date and amount formatting.
- Ensure place-timezone display consistency.

### 4.3 Reusable filters/pagination

- Date range.
- Event type.
- Amount ranges (financial tabs).
- Cursor/page pagination support for large histories.

---

## File Impact (Expected)

- `app/Filament/V2/Pages/Cardex/*`
- `app/Filament/V2/Components/*`
- `app/Actions/AdminV2/Cardex/*`
- `resources/views/filament/v2/cardex/*`

---

## Acceptance Criteria

- All 4 cardex pages can inherit/reuse the same core components.
- No duplicated formatting logic across cardex implementations.
- Timeline blocks remain performant on large datasets.

---

## Tests

- Transformer unit tests.
- Component behavior tests.
- Pagination/filter integration tests.