From 40080aee3a650f35f53bda000babac1183ba5951 Mon Sep 17 00:00:00 2001 From: grokbot_ty Date: Wed, 16 Sep 2026 21:07:12 +0000 Subject: [PATCH] docs(m3): lock Woo image order including dimension overlay Calibration clean PNG is #1, dimension-overlay copy is #2, then other inventory PNGs in capture/add order (max 5). --- docs/CREATE.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/CREATE.md b/docs/CREATE.md index 5177df5..8562438 100644 --- a/docs/CREATE.md +++ b/docs/CREATE.md @@ -261,7 +261,7 @@ Mill-owner path after Photos-ready: 2. Look up SKU in the store (`GET /products?sku={sku}`, any status). Stop if found. 3. Refresh taxonomy if last successful pull is older than 1 hour. 4. Resolve categories, tags, and attributes from the synced lists. -5. Upload each inventory PNG (`kind=inventory` only) via `POST /media`, keep alpha. Reference `source_url` values on the product. Cap at 5 inventory photos. Calibration-only artifacts are not store images. +5. Upload inventory PNGs via `POST /media`, keep alpha. Reference `source_url` values on the product. Cap at 5 images. **Woo image order (locked):** (1) clean calibration inventory PNG, (2) dimension-overlay copy of that calibration PNG, (3+) remaining batch inventory PNGs in the order they were added in the web app. The overlay is part of the submission. Do not upload non-inventory artifacts outside that lineup. 6. `POST /products` with status from Settings `woo_create_status` (`draft` or `publish`, default `draft`). **`SLAB-UAT-*` always forces draft.** 7. On success: log, set `woo_product_id`, mark published locally, delete original and processed photos, clear device draft. 8. On failure: log, mark failed, keep photos, put a field-level error on the phone. No raw status codes for the mill owner. @@ -410,7 +410,7 @@ These came from comparing `CREATE.md` to the technical requirements on `main`. D 2. **`attributes` element shape on `POST /products`.** `main` leaves `"attributes": [ … if present … ]` without fields. Need the exact Woo REST object fields for the five locked attributes (typically attribute `id`, `options` as term names, `visible`, `variation`). Prefer a live product sample from Whidbey Wood Store or the official Woo REST product-attribute docs Ty points us at. Do not guess. -3. **Dimension-overlay PNG.** Photos-ready lineup includes the overlay copy. `main` says only `kind=inventory` images go to Woo (≤5). Confirm: **omit** the overlay from Woo upload, **include** it as an inventory image, or something else. +3. **Dimension-overlay PNG.** **Locked (Ty 2026-09-16):** include in Woo upload. Order is (1) clean calibration PNG, (2) dimension-overlay copy of that calibration PNG, (3+) other inventory PNGs in the order they were added in the web app. Cap remains ≤5. 4. **Template `{character}`.** Default title/short/description templates need a `{character}` string. Confirm the source when `feat-*` is empty, one tag, or many (for example first feat tag name, figure term, or a dedicated field).