Products menu: single-product overviews link to the product (spec v1.33)

Decision Harry 2026-11-12 for the third level of the products panel: an overview page with exactly one product is presented as that product. items[].link becomes the product detail page and items[].image the product picture (productimage, else heroimage, else the page media as before); new additive fields items[].linkType (product | overview) and items[].overviewLink (always the overview page). The product uid is resolved from the card link via the product slug; one extra query per build. Applies today to Avedia, EZ TV, X-Player End-Points, ChannelLink IP Gateway and ActiveSQX and switches back automatically once an editor adds a second card. Removing the sub-product line and the shortcut pill/subline is front end work (ticket 0121-BE).

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

packages/vitec/Documentation/Headless-JSON-Architecture.md

@@ -45,6 +45,7 @@
 | 1.30 | 2026‑11‑02 | **Interface change (additive).** Megamenu `pagetree` entries carry `display` (`columns` \| `rail`) and, for `rail`, `cardSize` (`regular` \| `compact`): Markets and Solutions switch to a left list with the sub-pages as image cards on hover. Page-tree items gained `image` (page media) and `teaser` (abstract) from stage 2; the sub-solution pages received their hero background as page media (sub-markets had page media already). |
 | 1.31 | 2026‑11‑05 | **No interface change (data source).** Megamenu Insights `spotlight.news` read only news folder 11; the newer posts live in 442 (ticket 0046-FE). Catalog and spotlight entries gained the editor fields *Data source folders* and *Data source categories*; the Insights listener reads news from them (empty = 11 + 442, no category filter), newest `datetime` first, three cards. Pages carrying the menu are tagged with the news and event tables, so a saved news or event record refreshes the menu. Contract unchanged. |
 | 1.32 | 2026‑11‑05 | **Interface change (additive).** Products menu: categories and sub-categories are clickable pages (were sysfolders/labels): `categories[].link` and `groups[].link`. Six sub-categories are the 2026-10 category pages (content/slug/SEO kept, sitemap name as nav_title = menu `title`); 3 categories, End-Points, RF Gateway and Capture & Graphics (content of Graphics & Multi-Display + Video Capture) are new pages; Graphics & Multi-Display, Video Capture and Infrastructure & Accessories left the menus (reachable). Breadcrumbs run through category and sub-category. Spec text on the removed v1.28 transitional fields corrected. **Caching:** `/_json/` responses no longer carry browser cache headers (`page.config.sendCacheHeaders = 0`) - EXT:headless enables them and TYPO3 14's default page lifetime of one year made browsers keep every JSON response up to a year; front ends should request with `cache: 'no-cache'` to get past copies cached before. |
+| 1.33 | 2026‑11‑12 | **Interface change (additive).** Products menu: an overview page with exactly one product is presented as that product — `items[].link` is the product detail page and `items[].image` the product picture (productimage, else heroimage, else page media); new `items[].linkType` (`product` | `overview`) and `items[].overviewLink` (always the overview page). Applies today to Avedia, EZ TV, X-Player End-Points, ChannelLink IP Gateway, ActiveSQX (decision Harry 2026-11-12). Front end: no sub-product count for `linkType = product`. |
 
 This document is drafted in the style of, and adopts the terminology conventions of,
 ISO/IEC/IEEE 42010 (architecture description), ISO/IEC/IEEE 26514 (information for
@@ -1229,8 +1230,13 @@ reached from the overview pages.
     "groups": [ { "title": "Encoders & Decoders", "link": "/products/video-encoding-and-streaming",
       "items": [
         { "type": "page", "uid": 587, "title": "Appliances", "link": "/products/appliances",
+          "linkType": "overview", "overviewLink": "/products/appliances",
           "productCount": 5, "products": [ { "title": "MGW Diamond-H", "link": "/product/…" } ],
           "image": null },
+        { "type": "page", "uid": 575, "title": "Avedia", "link": "/product/avedia-platform-iptv-signage-cmsserver",
+          "linkType": "product", "overviewLink": "/products/avedia",
+          "productCount": 1, "products": [ { "title": "Avedia Platform", "link": "/product/avedia-platform-iptv-signage-cmsserver" } ],
+          "image": { "url": "/fileadmin/_processed_/…webp", "alternative": "", "width": 640, "height": 360 } },
         { "type": "shortcut", "title": "Aligo KVM", "link": "/products/aligo",
           "target": { "category": 1, "group": 3, "page": 0 } } ] } ] } ]
 }
@@ -1251,8 +1257,18 @@ reached from the overview pages.
 - `products` are the product cards of the overview page that link a detail
   page (container children included, creation order); `productCount` is
   their number - a card without a resolvable product is not counted.
+- **Single-product overviews (v1.33, additive):** an overview page with
+  exactly one product is presented as that product - `link` is the product
+  detail page (`/product/<slug>`) and `image` the product's own picture
+  (*productimage*, else *heroimage*, else the page media). `linkType` tells
+  the two cases apart: `product` | `overview`; `overviewLink` always holds
+  the overview page (`/products/<slug>`) for breadcrumb-style uses. Today
+  this applies to Avedia, EZ TV, X-Player End-Points, ChannelLink IP Gateway
+  and ActiveSQX; it switches automatically when an editor adds a second
+  card. The front end should not render a sub-product count for these.
 - `image` (from content stage 2) is the overview page's first page media as a
-  640 px WebP, `null` when none is set.
+  640 px WebP (`linkType = overview`) or the product picture (`linkType =
+  product`), `null` when none is set.
 - The promo boxes of the left column ("Product highlight", "Product news")
   are the entry's editorial `teasers` next to `catalog` (`kicker` = box
   label, plus `title`, `text`, `link`, `image`; designed for two, an empty
@@ -1710,4 +1726,4 @@ remediation.
 - Header convention — the uniform header section across CEs, plugins and containers.
 - `Configuration/Sets/Vitecset/setup.typoscript` — the single TypoScript entry point.
 
-*End of document EVO‑VITEC‑HL‑001 v1.32.*
+*End of document EVO‑VITEC‑HL‑001 v1.33.*