chore: complete M1.1 runtime QA and release packaging

2026-09-13 19:04:41 +03:30
commit f11e1d650d
66 changed files with 3094 additions and 0 deletions
@@ -0,0 +1,49 @@
+# XShop – Performance
+
+## 1. Budgets
+
+- LCP < 2.5s on mid-tier mobile (4G, Moto G4 class).
+- Total blocking JS < 150ms.
+- No render-blocking webfont swap beyond FOIT 100ms (use `font-display: swap`).
+- DB queries: shop archive < 12 queries, product < 15 (WC baseline excluded).
+
+## 2. Assets
+
+- **Conditional enqueue**: each module (`search`, `filter`, `gallery`, `wishlist`) enqueued only where needed (`is_shop`, `is_product`, `is_search`, or presence of shortcode/block).
+- **No global JS**: single `xshop.js` is ~5KB bootstrap; feature modules lazy-imported via `import()`.
+- **CSS**: tokens + base always; component CSS split but concatenated in release (critical inline optional, not required v1).
+- **No jQuery** for new code; WC jQuery remains for its own handlers.
+- **Images**: `loading="lazy"` + `decoding="async"` + `srcset`, hero eager. Thumbnails via `wp_get_attachment_image`.
+- **Fonts**: system stack default; optional Vazirmatn self-hosted, subset, no external request by default.
+
+## 3. Queries
+
+- Avoid N+1: prime post caches (`update_post_meta_cache`, `update_post_term_cache`), use `wc_get_products` with `return => ids` where only IDs needed, then `wc_get_product` in loop.
+- Cache expensive counts: filter counts via transient (5 min), search suggestions via transient (5 min).
+- No queries on `init` for frontend; defer to template.
+
+## 4. Caching
+
+- Transients for search/filter counts; `wp_cache` for in-request repeated lookups (e.g., `xshop_get_setting`).
+- Compatibility with WP Rocket / LiteSpeed – no `DONOTCACHEPAGE` abuse.
+
+## 5. Minification
+
+- Release build minifies CSS/JS (`tools/build-release.ps1` runs cssnano/terser or PHP minify). Source maps for dev.
+
+## 6. DOM
+
+- Minimal wrappers, no deep nesting. No layout thrash (batch DOM reads/writes).
+- Carousel: CSS scroll-snap, no heavy JS.
+
+## 7. Monitoring
+
+- `System Status` reports: PHP/WP/WC versions, active plugins, asset sizes, transient hit rate.
+- Lighthouse CI optional (not required for v1).
+
+## 8. Anti-Patterns Forbidden
+
+- Global `wp_enqueue_script` without condition.
+- Querying all products to compute filters.
+- Unbounded `WP_Query` without `posts_per_page` / `no_found_rows`.
+- External fonts/CDNs by default.