Files
Provider-Crawl/database/IMAGE-MAPPING.md
Richie cc91427789 Initial commit: funeral provider discovery pipeline
Python crawlers for VIC Register, Funerals Australia, NFDA
n8n workflows for scheduled discovery and enrichment
SQLite schema and seeded dev database (1,463 providers)
End-to-end process documentation in n8n/PROCESS.md
2026-04-24 10:27:08 +10:00

70 lines
3.9 KiB
Markdown

# 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