Document real dw_unified adapter + index.real.html in README

c12c9ee94be27da5196ecf635d5a67974afad576 · 2026-06-24 07:30:46 -0700 · steve

Files touched

M README.md

Diff

commit c12c9ee94be27da5196ecf635d5a67974afad576
Author: steve <steve@designerwallcoverings.com>
Date:   Wed Jun 24 07:30:46 2026 -0700

    Document real dw_unified adapter + index.real.html in README
---
 README.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/README.md b/README.md
index 51ffc0c..dfe7f28 100644
--- a/README.md
+++ b/README.md
@@ -13,3 +13,22 @@ Features: filter trees · merchandising (pin/boost/bury) · filter layout (sideb
 canonicalization · custom dual-handle range sliders · color swatches.
 
 State persists to localStorage. `data/products.json` is DW-shaped sample data.
+
+## Real-catalog reference (`index.real.html`)
+
+`build-data.py` is a READ-ONLY adapter over the local `dw_unified` mirror. It maps
+one real DW collection — **Thibaut · "TEXTURE RESOURCE 9"** (149 ACTIVE SKUs,
+100% color+hex+width+image+price coverage in `thibaut_catalog`) — into the module's
+product shape and writes `data/products.real.json` + a derived `data/config.real.json`
+(57 raw color names → 6 buckets; vendor spelling aliases). It NEVER writes to
+dw_unified (`set_session(readonly=True)`).
+
+```bash
+python3 build-data.py          # regenerate the real data from dw_unified ($0, local read)
+python3 -m http.server 8849    # then open index.real.html
+```
+
+`index.real.html` is a standalone internal reference page (clone of `index.html`)
+pointing at the real data + derived config. Verified render: 149 cards, 149 real
+Shopify-CDN images, Blue facet narrows 149→42 (see `preview.real.png`).
+Live customer-facing wiring is gated — see the pending-approval memo.

← 378068e Verified real render: Playwright screenshot, 149 cards + 149 · back to Dw Discovery · discovery: point index.html at real dw_unified catalog (fix 9ba8fa6 →