| @@ -41,8 +41,20 @@ | ||
| 41 | 41 | **Read Lane**: |
| 42 | 42 | One of the two paths a collection read reaches the client by — the direct lane (`wcpos/v1` controllers, plus the flat `wcpos/v2` routes with no `wc/v3` proxy backing, e.g. `/variations`) and the proxy lane (`wcpos/v2` → `wc/v3`). Behaviour that exists on one lane only is a parity bug, not a design. (Code comments also say "lane" for the request shapes *within* one route — include lane, discovery lane; that narrower sense is not this term.) |
| 43 | 43 | _Avoid_: v1/v2 API, endpoint version |
| 44 | 44 | |
| 45 | +**Write Payload shape**: | |
| 46 | +The one pass an order document takes through the Order Write Payload module before WooCommerce sees it, named by what an absent line means. The _full-document_ shape (`for_update`, the `wcpos/v2` push lane) treats the document as the whole order: an omitted stored line is deleted and coupon lines are reconciled. The _partial-document_ shape (`for_partial_update`, the `wcpos/v1` lane) keeps WooCommerce's own semantics: an absent line is untouched and coupon lines pass through to the controller. Both shapes share every other rule; a rule that exists in one shape only is a ruling (recorded on the module), not a drift. | |
| 47 | +_Avoid_: v1 sanitizer, v2 forward rules, payload filter | |
| 48 | + | |
| 49 | +**Create Identity**: | |
| 50 | +The proof that a record born on the `wcpos/v2` push lane owns its client UUID before the mutation is finalized: poison checkpoint, UUID persisted, resolved back to the same id, checkpoint finalized. Written once in the Create Identity module; a retry against a `poison` checkpoint re-enters the same proof rather than running a second copy. ADR 0038 decides when identity is re-proved; this module decides where the proof lives. | |
| 51 | +_Avoid_: poison retry, identity stamp, recovery path | |
| 52 | + | |
| 53 | +**Promoted Service**: | |
| 54 | +A shared POS service (auth, settings, cashier, receipts, print jobs, stores, extensions, logs, gateways, checkout, templates, shipping methods, tax classes, order statuses) that answers identically under `wcpos/v1` and `wcpos/v2`. The Controller Registry derives the v2 map from the v1 map, so promotion is the default and only the nine frozen data controllers (the sync surface replaced them, #544) are excluded. | |
| 55 | +_Avoid_: v2 twin, pass-through subclass, v2 controllers map | |
| 56 | + | |
| 45 | 57 | **Replica policy**: |
| 46 | 58 | What a collection's client-side copy aims to hold: `complete` (a full replica, e.g. products, |
| 47 | 59 | variations) or `windowed` (a bounded recent window of an unbounded set, e.g. orders). |
| 48 | 60 | _Avoid_: cache mode, sync mode |
