# Image Assets & Verified Provider Mapping

## Image Directory Structure

All images are downloaded locally in `images/` with the following structure:

```
images/
├── manifest.json              # Full index mapping CMS IDs → local paths
├── providers/{slug}/          # 12 verified brands
│   ├── logo.{ext}             # Rectangular/stacked logo
│   └── badge.{ext}            # Circular/square badge (for cards)
├── funeral-homes/{slug}/      # 7 parent organisations
│   └── logo.{ext}
├── locations/{slug}/          # 20 physical offices
│   └── photo.{ext}            # Building/staff hero photo
├── coffins/{category}/        # 201 coffins by range
│   └── {slug}/01.{ext}       # 1-4 images per coffin
├── venues/{slug}/             # 1,678 service venues
│   └── 01.{ext}
└── crematoriums/{slug}/       # 38 crematoriums
    └── 01.{ext}
```

## Verified Brand → Image Mapping

These are the 12 existing verified brands from the CMS, with their image paths:

| CMS ID | Brand | Logo | Badge |
|--------|-------|------|-------|
| 1 | H.Parsons Funeral Directors | `providers/hparsons-funeral-directors/logo.png` | `providers/hparsons-funeral-directors/badge.png` |
| 3 | Rankins Funerals | `providers/rankins-funerals/logo.webp` | `providers/rankins-funerals/badge.png` |
| 4 | Parsons Ladies Funeral Directors | `providers/parsons-ladies-funeral-directors/logo.png` | `providers/parsons-ladies-funeral-directors/badge.png` |
| 5 | Wollongong City Funerals | `providers/wollongong-city-funerals/logo.webp` | `providers/wollongong-city-funerals/badge.png` |
| 6 | Easy Funerals | `providers/easy-funerals/logo.webp` | `providers/easy-funerals/badge.png` |
| 7 | Mackay Family Funerals | `providers/mackay-family-funerals/logo.webp` | `providers/mackay-family-funerals/badge.png` |
| 8 | H.Parsons Shoalhaven | `providers/hparsons-funeral-directors-shoalhaven/logo.png` | `providers/hparsons-funeral-directors-shoalhaven/badge.png` |
| 9 | Killick Family Funerals | `providers/killick-family-funerals/logo.webp` | `providers/killick-family-funerals/badge.png` |
| 10 | Kenneally's Funerals | `providers/kenneallys-funerals/logo.webp` | `providers/kenneallys-funerals/badge.png` |
| 11 | Lady Anne Funerals | `providers/lady-anne-funerals/logo.webp` | `providers/lady-anne-funerals/badge.png` |
| 12 | Mannings Funerals | `providers/mannings-funerals/logo.webp` | `providers/mannings-funerals/badge.png` |
| 13 | Botanical Funerals | `providers/botanical-funerals-by-ian-allison/logo.webp` | `providers/botanical-funerals-by-ian-allison/badge.png` |

## How to Use on the Demo Site

### For verified providers:
- Serve images from `images/providers/{slug}/` for logos and badges
- Serve location photos from `images/locations/{slug}/`
- Serve product images from `images/coffins/`, `images/venues/`, `images/crematoriums/`
- The `manifest.json` contains the full mapping from CMS record IDs to local file paths

### For unverified providers:
- **No images** — they have no logo, badge, or photos
- Use a generic placeholder or text-based display (business name initials, etc.)
- Images are only added when a provider signs up to become verified

### Importing verified brands:
The 12 verified brands need to be imported into the database with their full data from
`schemas/brands-full.json` (brand details, locations, packages, inclusions) and linked
to their images. Some of these brands were also discovered by the crawler and already
exist in `providers.db` as unverified — they should be **upgraded** (set `verified = true`,
add images) rather than duplicated.

### Product images:
- 201 coffins with 1-4 images each, organised by range (solid-timber, custom-board, etc.)
- 1,678 venue photos
- 38 crematorium photos
- These are only relevant for verified provider flows (arrangement booking)
- The `manifest.json` maps each product's CMS ID to its local image path