feat(loyalty): cross-persona page alignment with shared components

Align loyalty pages across admin, merchant, and store personas so each
sees the same page set scoped to their access level. Admin acts as a
superset of merchant with "on behalf" capabilities.

New pages:
- Store: Staff PINs management (CRUD)
- Merchant: Cards, Card Detail, Transactions, Staff PINs (CRUD), Settings (read-only)
- Admin: Merchant Cards, Card Detail, Transactions, PINs (read-only)

Architecture:
- 4 shared Jinja2 partials (cards-list, card-detail, transactions, pins)
- 4 shared JS factory modules parameterized by apiPrefix/scope
- Persona templates are thin wrappers including shared partials
- PinDetailResponse schema for cross-store PIN listings

API: 17 new endpoints (11 merchant, 6 admin on-behalf)
Tests: 38 new integration tests, arch-check green
i18n: ~130 new keys across en/fr/de/lb
Docs: pages-and-navigation.md with full page matrix

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

app/modules/loyalty/docs/index.md

@@ -45,6 +45,22 @@ See [Data Model](data-model.md) for full entity relationships.
 - **MerchantLoyaltySettings** — Admin-controlled merchant settings
 - **AppleDeviceRegistration** — Apple Wallet push notification tokens
 
+## Pages & Navigation
+
+See [Pages & Navigation](pages-and-navigation.md) for the full cross-persona page matrix, URL patterns, sidebar navigation, and shared component architecture.
+
+All personas share the same page set with scope-appropriate access:
+
+| Page | Admin | Merchant | Store | Storefront |
+|---|:---:|:---:|:---:|:---:|
+| Program | Any merchant | Own | Own | Public |
+| Analytics | Any merchant | Multi-store | Store-scoped | -- |
+| Cards/Members | Any merchant | All stores | Store-scoped | Own card |
+| Transactions | Any merchant | Store filter | Store-scoped | Own history |
+| Staff PINs | Read-only | Full CRUD | Full CRUD | -- |
+| Settings | Edit | Read-only | -- | -- |
+| Terminal | -- | -- | POS | -- |
+
 ## API Endpoints
 
 ### Store Endpoints (`/api/v1/store/loyalty/`)
@@ -53,15 +69,34 @@ See [Data Model](data-model.md) for full entity relationships.
 |--------|----------|-------------|
 | `GET` | `/program` | Get store's loyalty program |
 | `POST` | `/program` | Create loyalty program |
-| `PATCH` | `/program` | Update loyalty program |
+| `PUT` | `/program` | Update loyalty program |
+| `DELETE` | `/program` | Delete loyalty program |
 | `GET` | `/stats` | Get program statistics |
+| `GET` | `/stats/merchant` | Get merchant-wide statistics |
 | `GET` | `/cards` | List customer cards |
 | `POST` | `/cards/enroll` | Enroll customer in program |
 | `POST` | `/stamp` | Add stamp to card |
 | `POST` | `/stamp/redeem` | Redeem stamps for reward |
-| `POST` | `/points` | Earn points from purchase |
+| `POST` | `/stamp/void` | Void stamps |
+| `POST` | `/points/earn` | Earn points from purchase |
 | `POST` | `/points/redeem` | Redeem points for reward |
-| `*` | `/pins/*` | Staff PIN management |
+| `POST` | `/points/void` | Void points |
+| `POST` | `/cards/{id}/points/adjust` | Manual point adjustment (owner) |
+| `*` | `/pins/*` | Staff PIN management (list, create, update, delete, unlock) |
+
+### Merchant Endpoints (`/api/v1/merchants/loyalty/`)
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| `GET/POST/PATCH/DELETE` | `/program` | Program CRUD |
+| `GET` | `/stats` | Merchant-wide statistics |
+| `GET` | `/cards` | List cards across all stores |
+| `GET` | `/cards/{id}` | Card detail |
+| `GET` | `/cards/{id}/transactions` | Card transaction history |
+| `GET` | `/transactions` | Merchant-wide transactions |
+| `*` | `/pins/*` | Staff PIN management across stores |
+| `GET` | `/settings` | Loyalty settings (read-only) |
+| `GET` | `/locations` | Store list for filter dropdowns |
 
 ### Admin Endpoints (`/api/v1/admin/loyalty/`)
 
@@ -70,6 +105,15 @@ See [Data Model](data-model.md) for full entity relationships.
 | `GET` | `/programs` | List all loyalty programs |
 | `GET` | `/programs/{id}` | Get specific program |
 | `GET` | `/stats` | Platform-wide statistics |
+| `GET` | `/merchants/{mid}/cards` | Merchant's cards (on behalf) |
+| `GET` | `/merchants/{mid}/cards/{cid}` | Card detail (on behalf) |
+| `GET` | `/merchants/{mid}/transactions` | Merchant's transactions |
+| `GET` | `/merchants/{mid}/pins` | Merchant's PINs (read-only) |
+| `GET` | `/merchants/{mid}/locations` | Merchant's stores |
+| `GET` | `/merchants/{mid}/stats` | Merchant statistics |
+| `GET/PATCH` | `/merchants/{mid}/settings` | Merchant settings |
+| `GET` | `/wallet-status` | Wallet integration status |
+| `*` | `/debug/*` | Wallet debug endpoints (super admin) |
 
 ### Storefront Endpoints (`/api/v1/storefront/loyalty/`)
 
@@ -78,6 +122,7 @@ See [Data Model](data-model.md) for full entity relationships.
 | `GET` | `/card` | Get customer's loyalty card |
 | `GET` | `/transactions` | Transaction history |
 | `POST` | `/enroll` | Self-enrollment |
+| `GET` | `/program` | Public program info |
 
 ## Scheduled Tasks
 
@@ -105,6 +150,7 @@ Environment variables (prefix: `LOYALTY_`):
 
 - [Data Model](data-model.md) — Entity relationships and database schema
 - [Business Logic](business-logic.md) — Anti-fraud system, wallet integration, enrollment flow
+- [Pages & Navigation](pages-and-navigation.md) — Cross-persona page matrix, URL patterns, shared components
 - [User Journeys](user-journeys.md) — Detailed user journey flows with dev/prod URLs
 - [Program Analysis](program-analysis.md) — Business analysis and platform vision
 - [UI Design](ui-design.md) — Admin and store interface mockups and implementation roadmap