SlabUploader/docs/CREATE.md

Milestone 3 — Create

Builds on Milestones 1–2 (docs/CAPTURE.md, docs/PHOTOS.md). Destination and field names also live in docs/PRODUCT.md.

Scope source of truth: this file and the Ty conversations that wrote it. Task and milestone breakdowns on main (including older PRODUCT / IMPL-PLAN / CONTENT-WOO splits) are obsolete for M3. Do not cross-reference main for what M3 includes once this branch is the working set.

Goal

Phone path from Photos-ready device draft → store-synced Woo attributes filled and reviewed → WooCommerce product create (practice SKUs as draft) → clear device draft.

M3 also wires the OpenAI-compatible inference endpoint as a server dependency so inference ops can run when enabled. Create must still work with inference off.

Woo attributes

Locked name for the synced taxonomy package. WooCommerce is the source of truth; the app caches ids and never invents the lists.

Categories (product categories, leaf-only)

Field	Cardinality	Notes
Species	exactly 1 required	Synced species leaves only; no hardcoded / fallback set
Wood category	1+ required	Parents are grouping only; picks are leaves

Attributes (exactly five locked Woo attributes)

Attribute	Cardinality	Notes
Edge Type	1 required	Term id from sync
Figure	1+ required	Term ids from sync
Grade	1+ required	Term ids from sync
Thickness	1 required	Measured thickness rounded up into the store band
Moisture	1 required	Default kiln-dried; user sets/keeps; never inferred

v1: missing attributes are skipped, not created. Species, character, length, and free-text thickness are not product attributes.

Tags

Tag prefix	Cardinality	Notes
fig-*	1+ required	Other Woo tags ignored
feat-*	0+ optional	Character / inclusions / voids / checks map onto existing feat tags only

Listing facts beside taxonomy

• User: SKU, length, thickness (and app-computed widths / sqft / bdft from M1/M2)
• Price: propose bdft × species $/bdft from pricing rules; user may override; missing rate → empty price
• Copy: title / short title / description from templates (optional Generate text when inference is on; not required for ready)

Sync (Woo)

• FastAPI is the sole Woo client. Credentials never in the browser.
• Auth: WordPress application password for a dedicated low-privilege WP user (not Woo ck_/cs_ consumer keys).
• Store URL: WOO_BASE_URL from deploy/.env / compose (https:// only). Settings shows it read-only. Not a SQLite settings row.
• Woo username + application password: Settings UI → AES-GCM in SQLite (SLAB_AES_KEY env).
• Taxonomy sync pulls, in order: categories → tags (fig-* / feat-* only) → attributes + terms (five locked).
• Sync failure keeps the previous cache (never delete-then-fail). Stale picks show “no longer valid”; never silently swap.

Inference dependency

• OpenAI-compatible endpoint: inference_base_url, API key, model in Settings (encrypted), not compose env.
• Server proxies all inference calls.
• Feature-flagged. Create / ready path must pass with inference off (manual taxonomy + deterministic numbers + Woo draft).
• Vision may prefill taxonomy at ≥0.7 confidence when on; typed values always win; below threshold → leave empty.

Ready set (submission ready)

Review does not continue until the full ready set is filled. Species + one figure is not enough.

Required:

• ≥1 inventory PNG (from M2)
• SKU, length, thickness; widths / sqft / bdft present
• Species, ≥1 wood category, edge type, ≥1 figure, ≥1 grade, thickness band, moisture, ≥1 fig-*, price
• feat-* optional (0+)

Create

• POST product to Woo with categories, attributes, tags, price, copy, inventory PNG images.
• Duplicate SKU (any store status) blocks create; no update path in this version.
• SLAB-UAT-* always creates as Woo draft, even if Settings say publish.
• Device draft ≠ Woo draft. After successful create, clear the device draft.
• Default create status from Settings woo_create_status (draft | publish, default draft), subject to the UAT force-draft rule.

Acceptance (done when)

Product state induced: overnight UAT app on ubudual5060 http://100.64.0.9:10881 (or the current M3 deploy of this branch), with Woo credentials and WOO_BASE_URL pointed at the intended store.

Evidence from that state:

1. Taxonomy sync via application password retrieves Woo attributes into the app cache; pickers offer only synced ids.
2. A Photos-ready slab can be filled to the full ready set using those synced lists (inference off is a required path).
3. Create with SLAB-UAT-* yields a WooCommerce draft product whose categories / attributes / tags / price / images match the reviewed ready set.
4. Duplicate SKU is blocked; device draft clears after success.
5. Inference Settings accept an OpenAI-compatible base URL / key / model; create still succeeds with inference disabled.

Dishonest proxies (do not count as pass)

• Hardcoded or fixture taxonomy lists treated as “synced”
• Mock Woo client or in-process fake that never hit the real store
• Claiming ready / create green from unit tests alone without a real draft in the store
• Consumer-key auth instead of application password
• Inference “wired” only as dead config with no server proxy path, or create that requires inference on
• Touching :10880 (Ty Node/SvelteKit) or dumping work onto m2-ds / doc-simplification branches

Out of scope (unless Ty expands M3 in chat)

• Full Assist UX beyond the OpenAI endpoint dependency and optional prefill rules above
• Creating new Woo attributes / terms / tags from the app
• Update-in-place of an existing store SKU
• Bulk create