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

database/IMAGE-MAPPING.md

@@ -0,0 +1,69 @@
+# 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