Zwischenstand vom 29.05.2026

2026-05-29 11:14:02 +02:00
1 parent b6d2142214
commit dba154e572
@@ -16,23 +16,19 @@ use TYPO3\CMS\Core\Utility\GeneralUtility;
 use TYPO3\CMS\Extbase\Service\ImageService;

 /**
- * UserFunc to render product list as JSON for headless
+ * UserFunc to render product list as JSON for headless.
+ *
+ * `render()` performs page discovery (used for top-level list plugins via
+ * TypoScript). `renderForRecord()` processes one specific tt_content row and
+ * is used both internally and by ContainerChildrenProcessor to resolve a
+ * product-list plugin nested inside a b13 container.
 */
 class ProductListJsonRenderer
 {
    public function render(string $content, array $conf): string
    {
-        // IMPORTANT: Headless creates new cObj contexts when rendering JSON fields,
-        // losing the current content element context. Also, Extbase repositories don't work
-        // in UserFunc context because the full Extbase framework isn't bootstrapped.
-        //
-        // Solution: Query tt_content directly to find the plugin configuration,
-        // then use direct database queries for products instead of Extbase repositories.
-
-        // Get current page UID
        $pageId = (int)($GLOBALS['TSFE']->id ?? 0);

-        // Query tt_content for vitec_productlist on this page
        $queryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
            ->getQueryBuilderForTable('tt_content');

@@ -49,95 +45,93 @@ class ProductListJsonRenderer
            ->fetchAllAssociative();

        if (empty($contentElements)) {
-            return json_encode(['debug' => 'No vitec_productlist on page ' . $pageId]);
+            // Not a product-list page: emit nothing so headless removes the key.
+            return '';
        }

-        // Take the first one (there should typically be only one)
-        $contentElement = $contentElements[0];
+        return $this->renderForRecord($contentElements[0]);
+    }

-        // Parse FlexForm
-        $flexFormService = GeneralUtility::makeInstance(FlexFormService::class);
-        $flexFormData = $flexFormService->convertFlexFormContentToArray($contentElement['pi_flexform'] ?? '');
-        $settings = $flexFormData['settings'] ?? [];
+    /**
+     * Render exactly the given tt_content row (the product-list plugin element).
+     * Exception-safe: returns '' on any failure.
+     *
+     * @param array<string,mixed> $contentElement tt_content row of the plugin
+     */
+    public function renderForRecord(array $contentElement): string
+    {
+        try {
+            // Parse FlexForm of THIS element
+            $flexFormService = GeneralUtility::makeInstance(FlexFormService::class);
+            $flexFormData = $flexFormService->convertFlexFormContentToArray($contentElement['pi_flexform'] ?? '');
+            $settings = $flexFormData['settings'] ?? [];

-        // Extract category UIDs and debug setting
-        $categoryUids = array_filter(
-            array_map('intval', explode(',', (string)($settings['categories'] ?? '')))
-        );
-        $debugMode = (bool)($settings['debug'] ?? false);
-        $allProducts = (bool)($settings['allproducts'] ?? false);
-
-        // Extbase repositories don't work in UserFunc context
-        // Use direct database query instead
-        $productQueryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
-            ->getQueryBuilderForTable('tx_vitec_domain_model_product');
-
-        $productQuery = $productQueryBuilder
-            ->select('p.*')
-            ->from('tx_vitec_domain_model_product', 'p')
-            ->where(
-                $productQueryBuilder->expr()->eq('p.deleted', 0),
-                $productQueryBuilder->expr()->eq('p.hidden', 0),
-                $productQueryBuilder->expr()->eq('p.legacy', 0),
-                $productQueryBuilder->expr()->eq('p.supportproduct', 0),
-                $productQueryBuilder->expr()->eq('p.hideonwebsite', 0),
-                $productQueryBuilder->expr()->eq('p.hideonproducts', 0),
-                $productQueryBuilder->expr()->eq('p.subproduct', 0)
+            $categoryUids = array_filter(
+                array_map('intval', explode(',', (string)($settings['categories'] ?? '')))
            );
+            $debugMode = (bool)($settings['debug'] ?? false);
+            $allProducts = (bool)($settings['allproducts'] ?? false);

-        // Add category filter if specified and allProducts is not enabled
-        if (!empty($categoryUids) && !$allProducts) {
-            // Join with sys_category_record_mm to filter by categories
-            $productQuery
-                ->join(
-                    'p',
-                    'sys_category_record_mm',
-                    'mm',
-                    'mm.uid_foreign = p.uid AND mm.tablenames = ' . $productQueryBuilder->createNamedParameter('tx_vitec_domain_model_product', ParameterType::STRING) . ' AND mm.fieldname = ' . $productQueryBuilder->createNamedParameter('categories', ParameterType::STRING)
-                )
-                ->andWhere(
-                    $productQueryBuilder->expr()->in('mm.uid_local', $productQueryBuilder->createNamedParameter($categoryUids, Connection::PARAM_INT_ARRAY))
-                )
-                ->groupBy('p.uid');
+            // Extbase repositories don't work in UserFunc context — direct query.
+            $productQueryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
+                ->getQueryBuilderForTable('tx_vitec_domain_model_product');
+
+            $productQuery = $productQueryBuilder
+                ->select('p.*')
+                ->from('tx_vitec_domain_model_product', 'p')
+                ->where(
+                    $productQueryBuilder->expr()->eq('p.deleted', 0),
+                    $productQueryBuilder->expr()->eq('p.hidden', 0),
+                    $productQueryBuilder->expr()->eq('p.legacy', 0),
+                    $productQueryBuilder->expr()->eq('p.supportproduct', 0),
+                    $productQueryBuilder->expr()->eq('p.hideonwebsite', 0),
+                    $productQueryBuilder->expr()->eq('p.hideonproducts', 0),
+                    $productQueryBuilder->expr()->eq('p.subproduct', 0)
+                );
+
+            if (!empty($categoryUids) && !$allProducts) {
+                $productQuery
+                    ->join(
+                        'p',
+                        'sys_category_record_mm',
+                        'mm',
+                        'mm.uid_foreign = p.uid AND mm.tablenames = ' . $productQueryBuilder->createNamedParameter('tx_vitec_domain_model_product', ParameterType::STRING) . ' AND mm.fieldname = ' . $productQueryBuilder->createNamedParameter('categories', ParameterType::STRING)
+                    )
+                    ->andWhere(
+                        $productQueryBuilder->expr()->in('mm.uid_local', $productQueryBuilder->createNamedParameter($categoryUids, Connection::PARAM_INT_ARRAY))
+                    )
+                    ->groupBy('p.uid');
+            }
+
+            $products = $productQuery->executeQuery()->fetchAllAssociative();
+
+            $productsData = [];
+            foreach ($products as $product) {
+                $productsData[] = $this->serializeProduct($product);
+            }
+
+            if ($debugMode) {
+                return json_encode([
+                    'products' => $productsData,
+                    'debug' => [
+                        'pageId' => (int)($GLOBALS['TSFE']->id ?? 0),
+                        'categoryUids' => $categoryUids,
+                        'productCount' => count($productsData),
+                        'settings' => $settings,
+                    ],
+                ]);
+            }
+
+            return json_encode($productsData);
+        } catch (\Throwable $e) {
+            return '';
        }
-
-        $products = $productQuery->executeQuery()->fetchAllAssociative();
-
-        // Serialize products (they're already associative arrays from the query)
-        $productsData = [];
-        foreach ($products as $product) {
-            $productsData[] = $this->serializeProduct($product);
-        }
-
-        // If debug mode is enabled, return object with products and debug info
-        if ($debugMode) {
-            return json_encode([
-                'products' => $productsData,
-                'debug' => [
-                    'pageId' => $pageId,
-                    'categoryUids' => $categoryUids,
-                    'productCount' => count($productsData),
-                    'settings' => $settings
-                ]
-            ]);
-        }
-
-        // Otherwise return products array directly (backward compatible)
-        return json_encode($productsData);
    }

    /**
     * Serialize a single product DB row to the full headless JSON structure.
     *
-     * Includes every field declared on the Product domain model
-     * (Evomedien\Vitec\Domain\Model\Product) plus all fully resolved
-     * relations (categories, productimage, downloads, ogimage, relatedprodukt).
-     *
-     * DB-only columns that are NOT part of the domain model
-     * (cta, links, sorting1-5, key1-3, apptext1-3, productlayout, image,
-     * relatedimage, system fields) are intentionally omitted.
-     *
-     * @param array<string,mixed> $product Associative DB row of tx_vitec_domain_model_product
+     * @param array<string,mixed> $product
     * @return array<string,mixed>
     */
    protected function serializeProduct(array $product): array
@@ -145,10 +139,8 @@ class ProductListJsonRenderer
        $uid = (int)$product['uid'];

        return [
-            // --- identifier ---
            'uid' => $uid,

-            // --- scalar string fields (Product domain model) ---
            'title' => (string)($product['title'] ?? ''),
            'slug' => (string)($product['slug'] ?? ''),
            'urltitle' => (string)($product['urltitle'] ?? ''),
@@ -166,7 +158,6 @@ class ProductListJsonRenderer
            'contentelement' => (string)($product['contentelement'] ?? ''),
            'contentelementcta' => (string)($product['contentelementcta'] ?? ''),

-            // --- boolean flags (Product domain model) ---
            'hideonapp' => (bool)($product['hideonapp'] ?? false),
            'hideonwebsite' => (bool)($product['hideonwebsite'] ?? false),
            'hideondatasheets' => (bool)($product['hideondatasheets'] ?? false),
@@ -176,10 +167,8 @@ class ProductListJsonRenderer
            'supportproduct' => (bool)($product['supportproduct'] ?? false),
            'subproduct' => (bool)($product['subproduct'] ?? false),

-            // --- convenience link (kept for backward compatibility) ---
            'link' => '/product/' . (string)($product['slug'] ?? ''),

-            // --- fully resolved relations ---
            'categories' => $this->getProductCategories($uid),
            'images' => $this->getProductImages($uid),
            'downloads' => $this->getProductDownloads($uid),
@@ -188,10 +177,6 @@ class ProductListJsonRenderer
        ];
    }

-    /**
-     * Get product images from FAL (sys_file_reference)
-     * Processes images through ImageService and generates srcset for responsive images
-     */
    protected function getProductImages(int $productUid): array
    {
        $queryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
@@ -217,10 +202,8 @@ class ProductListJsonRenderer
        $images = [];
        foreach ($fileReferences as $fileRefData) {
            try {
-                // Get FAL FileReference object
                $fileReference = $resourceFactory->getFileReferenceObject((int)$fileRefData['uid']);

-                // Define image sizes for srcset
                $sizes = [
                    'small' => ['width' => 400, 'height' => null],
                    'medium' => ['width' => 800, 'height' => null],
@@ -247,7 +230,6 @@ class ProductListJsonRenderer
                    ];
                }

-                // Get original/default image
                $defaultProcessed = $imageService->applyProcessingInstructions(
                    $fileReference,
                    ['width' => 800, 'crop' => $fileRefData['crop'] ?? null]
@@ -267,7 +249,6 @@ class ProductListJsonRenderer
                    ]
                ];
            } catch (\Exception $e) {
-                // Skip images that can't be processed
                continue;
            }
        }
@@ -276,8 +257,6 @@ class ProductListJsonRenderer
    }

    /**
-     * Get the single Open Graph image (ogimage) for a product, or null.
-     *
     * @return array<string,mixed>|null
     */
    protected function getProductOgImage(int $productUid): ?array
@@ -331,9 +310,6 @@ class ProductListJsonRenderer
        }
    }

-    /**
-     * Get categories for a product (resolved sys_category records).
-     */
    protected function getProductCategories(int $productUid): array
    {
        $queryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
@@ -369,9 +345,6 @@ class ProductListJsonRenderer
        }, $categories);
    }

-    /**
-     * Get all downloads for a product (resolved via tx_vitec_product_download_mm).
-     */
    protected function getProductDownloads(int $productUid): array
    {
        $queryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
@@ -400,7 +373,6 @@ class ProductListJsonRenderer
        foreach ($downloads as $download) {
            $fileInfo = null;

-            // Get file information from FAL if file reference exists
            if (!empty($download['file'])) {
                $fileQueryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
                    ->getQueryBuilderForTable('sys_file_reference');
@@ -448,12 +420,6 @@ class ProductListJsonRenderer
        return $result;
    }

-    /**
-     * Get related products (resolved via tx_vitec_product_related_mm).
-     *
-     * Returns a shallow representation (no nested relations) to avoid
-     * infinite recursion between mutually related products.
-     */
    protected function getRelatedProducts(int $productUid): array
    {
        $queryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
@@ -480,8 +446,6 @@ class ProductListJsonRenderer
        $result = [];
        foreach ($related as $rel) {
            $relUid = (int)$rel['uid'];
-            $images = $this->getProductImages($relUid);
-
            $result[] = [
                'uid' => $relUid,
                'title' => (string)($rel['title'] ?? ''),
@@ -490,7 +454,7 @@ class ProductListJsonRenderer
                'teaser' => (string)($rel['teaser'] ?? ''),
                'description' => (string)($rel['description'] ?? ''),
                'link' => '/product/' . (string)($rel['slug'] ?? ''),
-                'images' => $images,
+                'images' => $this->getProductImages($relUid),
            ];
        }

@@ -0,0 +1,499 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Evomedien\Vitec\UserFunc;
+
+use Doctrine\DBAL\ParameterType;
+use Evomedien\Vitec\Domain\Repository\ProductRepository;
+use Psr\Http\Message\ServerRequestInterface;
+use TYPO3\CMS\Core\Database\Connection;
+use TYPO3\CMS\Core\Imaging\ImageManipulation\CropVariantCollection;
+use TYPO3\CMS\Core\Resource\FileReference;
+use TYPO3\CMS\Core\Resource\ResourceFactory;
+use TYPO3\CMS\Core\Service\FlexFormService;
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+use TYPO3\CMS\Extbase\Service\ImageService;
+
+/**
+ * UserFunc to render product list as JSON for headless
+ */
+class ProductListJsonRenderer
+{
+    public function render(string $content, array $conf): string
+    {
+        // IMPORTANT: Headless creates new cObj contexts when rendering JSON fields,
+        // losing the current content element context. Also, Extbase repositories don't work
+        // in UserFunc context because the full Extbase framework isn't bootstrapped.
+        //
+        // Solution: Query tt_content directly to find the plugin configuration,
+        // then use direct database queries for products instead of Extbase repositories.
+
+        // Get current page UID
+        $pageId = (int)($GLOBALS['TSFE']->id ?? 0);
+
+        // Query tt_content for vitec_productlist on this page
+        $queryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
+            ->getQueryBuilderForTable('tt_content');
+
+        $contentElements = $queryBuilder
+            ->select('*')
+            ->from('tt_content')
+            ->where(
+                $queryBuilder->expr()->eq('pid', $queryBuilder->createNamedParameter($pageId, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('list_type', $queryBuilder->createNamedParameter('vitec_productlist', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('deleted', 0),
+                $queryBuilder->expr()->eq('hidden', 0)
+            )
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        if (empty($contentElements)) {
+            return json_encode(['debug' => 'No vitec_productlist on page ' . $pageId]);
+        }
+
+        // Take the first one (there should typically be only one)
+        $contentElement = $contentElements[0];
+
+        // Parse FlexForm
+        $flexFormService = GeneralUtility::makeInstance(FlexFormService::class);
+        $flexFormData = $flexFormService->convertFlexFormContentToArray($contentElement['pi_flexform'] ?? '');
+        $settings = $flexFormData['settings'] ?? [];
+
+        // Extract category UIDs and debug setting
+        $categoryUids = array_filter(
+            array_map('intval', explode(',', (string)($settings['categories'] ?? '')))
+        );
+        $debugMode = (bool)($settings['debug'] ?? false);
+        $allProducts = (bool)($settings['allproducts'] ?? false);
+
+        // Extbase repositories don't work in UserFunc context
+        // Use direct database query instead
+        $productQueryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
+            ->getQueryBuilderForTable('tx_vitec_domain_model_product');
+
+        $productQuery = $productQueryBuilder
+            ->select('p.*')
+            ->from('tx_vitec_domain_model_product', 'p')
+            ->where(
+                $productQueryBuilder->expr()->eq('p.deleted', 0),
+                $productQueryBuilder->expr()->eq('p.hidden', 0),
+                $productQueryBuilder->expr()->eq('p.legacy', 0),
+                $productQueryBuilder->expr()->eq('p.supportproduct', 0),
+                $productQueryBuilder->expr()->eq('p.hideonwebsite', 0),
+                $productQueryBuilder->expr()->eq('p.hideonproducts', 0),
+                $productQueryBuilder->expr()->eq('p.subproduct', 0)
+            );
+
+        // Add category filter if specified and allProducts is not enabled
+        if (!empty($categoryUids) && !$allProducts) {
+            // Join with sys_category_record_mm to filter by categories
+            $productQuery
+                ->join(
+                    'p',
+                    'sys_category_record_mm',
+                    'mm',
+                    'mm.uid_foreign = p.uid AND mm.tablenames = ' . $productQueryBuilder->createNamedParameter('tx_vitec_domain_model_product', ParameterType::STRING) . ' AND mm.fieldname = ' . $productQueryBuilder->createNamedParameter('categories', ParameterType::STRING)
+                )
+                ->andWhere(
+                    $productQueryBuilder->expr()->in('mm.uid_local', $productQueryBuilder->createNamedParameter($categoryUids, Connection::PARAM_INT_ARRAY))
+                )
+                ->groupBy('p.uid');
+        }
+
+        $products = $productQuery->executeQuery()->fetchAllAssociative();
+
+        // Serialize products (they're already associative arrays from the query)
+        $productsData = [];
+        foreach ($products as $product) {
+            $productsData[] = $this->serializeProduct($product);
+        }
+
+        // If debug mode is enabled, return object with products and debug info
+        if ($debugMode) {
+            return json_encode([
+                'products' => $productsData,
+                'debug' => [
+                    'pageId' => $pageId,
+                    'categoryUids' => $categoryUids,
+                    'productCount' => count($productsData),
+                    'settings' => $settings
+                ]
+            ]);
+        }
+
+        // Otherwise return products array directly (backward compatible)
+        return json_encode($productsData);
+    }
+
+    /**
+     * Serialize a single product DB row to the full headless JSON structure.
+     *
+     * Includes every field declared on the Product domain model
+     * (Evomedien\Vitec\Domain\Model\Product) plus all fully resolved
+     * relations (categories, productimage, downloads, ogimage, relatedprodukt).
+     *
+     * DB-only columns that are NOT part of the domain model
+     * (cta, links, sorting1-5, key1-3, apptext1-3, productlayout, image,
+     * relatedimage, system fields) are intentionally omitted.
+     *
+     * @param array<string,mixed> $product Associative DB row of tx_vitec_domain_model_product
+     * @return array<string,mixed>
+     */
+    protected function serializeProduct(array $product): array
+    {
+        $uid = (int)$product['uid'];
+
+        return [
+            // --- identifier ---
+            'uid' => $uid,
+
+            // --- scalar string fields (Product domain model) ---
+            'title' => (string)($product['title'] ?? ''),
+            'slug' => (string)($product['slug'] ?? ''),
+            'urltitle' => (string)($product['urltitle'] ?? ''),
+            'seotitle' => (string)($product['seotitle'] ?? ''),
+            'seometa' => (string)($product['seometa'] ?? ''),
+            'keywords' => (string)($product['keywords'] ?? ''),
+            'structureddata' => (string)($product['structureddata'] ?? ''),
+            'teaser' => (string)($product['teaser'] ?? ''),
+            'subtitle' => (string)($product['subtitle'] ?? ''),
+            'video' => (string)($product['video'] ?? ''),
+            'applications' => (string)($product['applications'] ?? ''),
+            'description' => (string)($product['description'] ?? ''),
+            'highlights' => (string)($product['highlights'] ?? ''),
+            'shortcutpid' => (string)($product['shortcutpid'] ?? ''),
+            'contentelement' => (string)($product['contentelement'] ?? ''),
+            'contentelementcta' => (string)($product['contentelementcta'] ?? ''),
+
+            // --- boolean flags (Product domain model) ---
+            'hideonapp' => (bool)($product['hideonapp'] ?? false),
+            'hideonwebsite' => (bool)($product['hideonwebsite'] ?? false),
+            'hideondatasheets' => (bool)($product['hideondatasheets'] ?? false),
+            'hideonproducts' => (bool)($product['hideonproducts'] ?? false),
+            'shortcut' => (bool)($product['shortcut'] ?? false),
+            'legacy' => (bool)($product['legacy'] ?? false),
+            'supportproduct' => (bool)($product['supportproduct'] ?? false),
+            'subproduct' => (bool)($product['subproduct'] ?? false),
+
+            // --- convenience link (kept for backward compatibility) ---
+            'link' => '/product/' . (string)($product['slug'] ?? ''),
+
+            // --- fully resolved relations ---
+            'categories' => $this->getProductCategories($uid),
+            'images' => $this->getProductImages($uid),
+            'downloads' => $this->getProductDownloads($uid),
+            'ogimage' => $this->getProductOgImage($uid),
+            'relatedprodukt' => $this->getRelatedProducts($uid),
+        ];
+    }
+
+    /**
+     * Get product images from FAL (sys_file_reference)
+     * Processes images through ImageService and generates srcset for responsive images
+     */
+    protected function getProductImages(int $productUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_file_reference');
+
+        $fileReferences = $queryBuilder
+            ->select('sfr.uid', 'sfr.uid_local', 'sfr.title', 'sfr.description', 'sfr.alternative', 'sfr.crop')
+            ->from('sys_file_reference', 'sfr')
+            ->where(
+                $queryBuilder->expr()->eq('sfr.tablenames', $queryBuilder->createNamedParameter('tx_vitec_domain_model_product', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('sfr.fieldname', $queryBuilder->createNamedParameter('productimage', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('sfr.uid_foreign', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('sfr.deleted', 0),
+                $queryBuilder->expr()->eq('sfr.hidden', 0)
+            )
+            ->orderBy('sfr.sorting_foreign')
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        $imageService = GeneralUtility::makeInstance(ImageService::class);
+        $resourceFactory = GeneralUtility::makeInstance(ResourceFactory::class);
+
+        $images = [];
+        foreach ($fileReferences as $fileRefData) {
+            try {
+                // Get FAL FileReference object
+                $fileReference = $resourceFactory->getFileReferenceObject((int)$fileRefData['uid']);
+
+                // Define image sizes for srcset
+                $sizes = [
+                    'small' => ['width' => 400, 'height' => null],
+                    'medium' => ['width' => 800, 'height' => null],
+                    'large' => ['width' => 1200, 'height' => null],
+                    'xlarge' => ['width' => 1600, 'height' => null],
+                ];
+
+                $srcset = [];
+                foreach ($sizes as $sizeName => $dimensions) {
+                    $processedImage = $imageService->applyProcessingInstructions(
+                        $fileReference,
+                        [
+                            'width' => $dimensions['width'],
+                            'height' => $dimensions['height'],
+                            'crop' => $fileRefData['crop'] ?? null
+                        ]
+                    );
+
+                    $imageUri = $imageService->getImageUri($processedImage);
+                    $srcset[] = [
+                        'url' => $imageUri,
+                        'width' => $dimensions['width'],
+                        'descriptor' => $dimensions['width'] . 'w'
+                    ];
+                }
+
+                // Get original/default image
+                $defaultProcessed = $imageService->applyProcessingInstructions(
+                    $fileReference,
+                    ['width' => 800, 'crop' => $fileRefData['crop'] ?? null]
+                );
+
+                $images[] = [
+                    'uid' => (int)$fileRefData['uid'],
+                    'url' => $imageService->getImageUri($defaultProcessed),
+                    'title' => $fileRefData['title'] ?? '',
+                    'alternative' => $fileRefData['alternative'] ?? '',
+                    'description' => $fileRefData['description'] ?? '',
+                    'srcset' => $srcset,
+                    'properties' => [
+                        'width' => $fileReference->getProperty('width'),
+                        'height' => $fileReference->getProperty('height'),
+                        'mimeType' => $fileReference->getProperty('mime_type')
+                    ]
+                ];
+            } catch (\Exception $e) {
+                // Skip images that can't be processed
+                continue;
+            }
+        }
+
+        return $images;
+    }
+
+    /**
+     * Get the single Open Graph image (ogimage) for a product, or null.
+     *
+     * @return array<string,mixed>|null
+     */
+    protected function getProductOgImage(int $productUid): ?array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_file_reference');
+
+        $fileRefData = $queryBuilder
+            ->select('sfr.uid', 'sfr.title', 'sfr.description', 'sfr.alternative', 'sfr.crop')
+            ->from('sys_file_reference', 'sfr')
+            ->where(
+                $queryBuilder->expr()->eq('sfr.tablenames', $queryBuilder->createNamedParameter('tx_vitec_domain_model_product', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('sfr.fieldname', $queryBuilder->createNamedParameter('ogimage', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('sfr.uid_foreign', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('sfr.deleted', 0),
+                $queryBuilder->expr()->eq('sfr.hidden', 0)
+            )
+            ->orderBy('sfr.sorting_foreign')
+            ->setMaxResults(1)
+            ->executeQuery()
+            ->fetchAssociative();
+
+        if (!$fileRefData) {
+            return null;
+        }
+
+        try {
+            $resourceFactory = GeneralUtility::makeInstance(ResourceFactory::class);
+            $imageService = GeneralUtility::makeInstance(ImageService::class);
+            $fileReference = $resourceFactory->getFileReferenceObject((int)$fileRefData['uid']);
+
+            $processed = $imageService->applyProcessingInstructions(
+                $fileReference,
+                ['width' => 1200, 'crop' => $fileRefData['crop'] ?? null]
+            );
+
+            return [
+                'uid' => (int)$fileRefData['uid'],
+                'url' => $imageService->getImageUri($processed),
+                'title' => $fileRefData['title'] ?? '',
+                'alternative' => $fileRefData['alternative'] ?? '',
+                'description' => $fileRefData['description'] ?? '',
+                'properties' => [
+                    'width' => $fileReference->getProperty('width'),
+                    'height' => $fileReference->getProperty('height'),
+                    'mimeType' => $fileReference->getProperty('mime_type'),
+                ],
+            ];
+        } catch (\Exception $e) {
+            return null;
+        }
+    }
+
+    /**
+     * Get categories for a product (resolved sys_category records).
+     */
+    protected function getProductCategories(int $productUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_category');
+
+        $categories = $queryBuilder
+            ->select('c.uid', 'c.title', 'c.description')
+            ->from('sys_category', 'c')
+            ->join(
+                'c',
+                'sys_category_record_mm',
+                'mm',
+                'mm.uid_local = c.uid AND mm.tablenames = ' .
+                $queryBuilder->createNamedParameter('tx_vitec_domain_model_product', ParameterType::STRING) .
+                ' AND mm.fieldname = ' .
+                $queryBuilder->createNamedParameter('categories', ParameterType::STRING)
+            )
+            ->where(
+                $queryBuilder->expr()->eq('mm.uid_foreign', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('c.deleted', 0),
+                $queryBuilder->expr()->eq('c.hidden', 0)
+            )
+            ->orderBy('mm.sorting', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        return array_map(static function ($cat) {
+            return [
+                'uid' => (int)$cat['uid'],
+                'title' => $cat['title'] ?? '',
+                'description' => $cat['description'] ?? '',
+            ];
+        }, $categories);
+    }
+
+    /**
+     * Get all downloads for a product (resolved via tx_vitec_product_download_mm).
+     */
+    protected function getProductDownloads(int $productUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
+            ->getQueryBuilderForTable('tx_vitec_domain_model_download');
+
+        $downloads = $queryBuilder
+            ->select('d.*')
+            ->from('tx_vitec_domain_model_download', 'd')
+            ->join(
+                'd',
+                'tx_vitec_product_download_mm',
+                'mm',
+                'mm.uid_foreign = d.uid'
+            )
+            ->where(
+                $queryBuilder->expr()->eq('mm.uid_local', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('d.deleted', 0),
+                $queryBuilder->expr()->eq('d.hidden', 0),
+                $queryBuilder->expr()->eq('d.hideonwebsite', 0)
+            )
+            ->orderBy('mm.sorting', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        $result = [];
+        foreach ($downloads as $download) {
+            $fileInfo = null;
+
+            // Get file information from FAL if file reference exists
+            if (!empty($download['file'])) {
+                $fileQueryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
+                    ->getQueryBuilderForTable('sys_file_reference');
+
+                $fileRef = $fileQueryBuilder
+                    ->select('fr.uid', 'f.uid as file_uid', 'f.identifier', 'f.name', 'f.size', 'f.extension', 'f.mime_type')
+                    ->from('sys_file_reference', 'fr')
+                    ->join('fr', 'sys_file', 'f', 'fr.uid_local = f.uid')
+                    ->where(
+                        $fileQueryBuilder->expr()->eq('fr.uid_foreign', $fileQueryBuilder->createNamedParameter((int)$download['uid'], ParameterType::INTEGER)),
+                        $fileQueryBuilder->expr()->eq('fr.tablenames', $fileQueryBuilder->createNamedParameter('tx_vitec_domain_model_download', ParameterType::STRING)),
+                        $fileQueryBuilder->expr()->eq('fr.fieldname', $fileQueryBuilder->createNamedParameter('file', ParameterType::STRING)),
+                        $fileQueryBuilder->expr()->eq('fr.deleted', 0),
+                        $fileQueryBuilder->expr()->eq('f.missing', 0)
+                    )
+                    ->orderBy('fr.sorting_foreign', 'ASC')
+                    ->setMaxResults(1)
+                    ->executeQuery()
+                    ->fetchAssociative();
+
+                if ($fileRef) {
+                    $fileInfo = [
+                        'uid' => (int)$fileRef['file_uid'],
+                        'name' => $fileRef['name'],
+                        'url' => '/fileadmin' . $fileRef['identifier'],
+                        'size' => (int)$fileRef['size'],
+                        'extension' => $fileRef['extension'],
+                        'mimeType' => $fileRef['mime_type'] ?? '',
+                    ];
+                }
+            }
+
+            $result[] = [
+                'uid' => (int)$download['uid'],
+                'title' => $download['title'] ?? '',
+                'slug' => $download['slug'] ?? '',
+                'teaser' => $download['teaser'] ?? '',
+                'description' => $download['description'] ?? '',
+                'keywords' => $download['keywords'] ?? '',
+                'icon' => $download['icon'] ?? '',
+                'file' => $fileInfo,
+            ];
+        }
+
+        return $result;
+    }
+
+    /**
+     * Get related products (resolved via tx_vitec_product_related_mm).
+     *
+     * Returns a shallow representation (no nested relations) to avoid
+     * infinite recursion between mutually related products.
+     */
+    protected function getRelatedProducts(int $productUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
+            ->getQueryBuilderForTable('tx_vitec_domain_model_product');
+
+        $related = $queryBuilder
+            ->select('p.uid', 'p.title', 'p.slug', 'p.subtitle', 'p.teaser', 'p.description')
+            ->from('tx_vitec_domain_model_product', 'p')
+            ->join(
+                'p',
+                'tx_vitec_product_related_mm',
+                'mm',
+                'mm.uid_foreign = p.uid'
+            )
+            ->where(
+                $queryBuilder->expr()->eq('mm.uid_local', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('p.deleted', 0),
+                $queryBuilder->expr()->eq('p.hidden', 0)
+            )
+            ->orderBy('mm.sorting', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        $result = [];
+        foreach ($related as $rel) {
+            $relUid = (int)$rel['uid'];
+            $images = $this->getProductImages($relUid);
+
+            $result[] = [
+                'uid' => $relUid,
+                'title' => (string)($rel['title'] ?? ''),
+                'slug' => (string)($rel['slug'] ?? ''),
+                'subtitle' => (string)($rel['subtitle'] ?? ''),
+                'teaser' => (string)($rel['teaser'] ?? ''),
+                'description' => (string)($rel['description'] ?? ''),
+                'link' => '/product/' . (string)($rel['slug'] ?? ''),
+                'images' => $images,
+            ];
+        }
+
+        return $result;
+    }
+}
@@ -14,25 +14,22 @@ use TYPO3\CMS\Core\Imaging\ImageService;
 use Doctrine\DBAL\ParameterType;

 /**
- * UserFunc to render single product data as JSON for headless output
+ * UserFunc to render a single product as JSON for headless output.
+ *
+ * `render()` performs page discovery (top-level plugin via TypoScript).
+ * `renderForRecord()` processes one specific tt_content row and is reused
+ * by ContainerChildrenProcessor for product-show plugins nested in a
+ * b13 container.
 */
 class ProductShowJsonRenderer
 {
    public function render(string $content, array $conf): string
    {
-        $pageId = (int)$GLOBALS['TSFE']->id;
-        
-        // DEBUG: Log that the UserFunc is being called
-        $debugInfo = [
-            'userFuncCalled' => true,
-            'pageId' => $pageId,
-            'requestUri' => $_SERVER['REQUEST_URI'] ?? 'unknown',
-        ];
-        
-        // Query tt_content for vitec_productshow on this page
+        $pageId = (int)($GLOBALS['TSFE']->id ?? 0);
+
        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
            ->getQueryBuilderForTable('tt_content');
-        
+
        $contentElements = $queryBuilder
            ->select('*')
            ->from('tt_content')
@@ -44,140 +41,161 @@ class ProductShowJsonRenderer
            )
            ->executeQuery()
            ->fetchAllAssociative();
-        
-        $debugInfo['contentElementsFound'] = count($contentElements);
-        
+
        if (empty($contentElements)) {
-            $debugInfo['error'] = 'No vitec_productshow on page';
-            return json_encode(['debug' => $debugInfo]);
+            return '';
        }
-        
-        // Take the first one
-        $contentElement = $contentElements[0];
-        
-        // Parse FlexForm
-        $flexFormService = GeneralUtility::makeInstance(FlexFormService::class);
-        $flexFormData = $flexFormService->convertFlexFormContentToArray($contentElement['pi_flexform'] ?? '');
-        $settings = $flexFormData['settings'] ?? [];
-        
-        // Get product UID from FlexForm or route parameter
-        $productUid = (int)($settings['product'] ?? 0);
-        $layout = (int)($settings['layout'] ?? 0);
-        $debugMode = (bool)($settings['debug'] ?? false);
-        
-        // If no product selected in FlexForm, try to get from route parameter
-        if (!$productUid) {
-            // Get the product parameter from GET request
-            $routeParams = $GLOBALS['TYPO3_REQUEST']->getQueryParams();
-            $productParam = $routeParams['tx_vitec_productshow']['product'] ?? null;
-            
-            if ($productParam) {
-                // If it's a slug, resolve it to UID
-                if (!is_numeric($productParam)) {
-                    $slugQueryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
-                        ->getQueryBuilderForTable('tx_vitec_domain_model_product');
-                    
-                    $productBySlug = $slugQueryBuilder
-                        ->select('uid')
-                        ->from('tx_vitec_domain_model_product')
-                        ->where(
-                            $slugQueryBuilder->expr()->eq('slug', $slugQueryBuilder->createNamedParameter($productParam)),
-                            $slugQueryBuilder->expr()->eq('deleted', 0),
-                            $slugQueryBuilder->expr()->eq('hidden', 0)
-                        )
-                        ->executeQuery()
-                        ->fetchAssociative();
-                    
-                    $productUid = (int)($productBySlug['uid'] ?? 0);
-                } else {
-                    $productUid = (int)$productParam;
+
+        return $this->renderForRecord($contentElements[0]);
+    }
+
+    /**
+     * Render exactly the given tt_content row (the product-show plugin element).
+     * Exception-safe: returns '' on any failure.
+     *
+     * @param array<string,mixed> $contentElement
+     */
+    public function renderForRecord(array $contentElement): string
+    {
+        try {
+            $pageId = (int)($GLOBALS['TSFE']->id ?? 0);
+
+            $flexFormService = GeneralUtility::makeInstance(FlexFormService::class);
+            $flexFormData = $flexFormService->convertFlexFormContentToArray($contentElement['pi_flexform'] ?? '');
+            $settings = $flexFormData['settings'] ?? [];
+
+            $productUid = (int)($settings['product'] ?? 0);
+            $layout = (int)($settings['layout'] ?? 0);
+            $debugMode = (bool)($settings['debug'] ?? false);
+
+            if (!$productUid) {
+                $routeParams = $GLOBALS['TYPO3_REQUEST']->getQueryParams();
+                $productParam = $routeParams['tx_vitec_productshow']['product'] ?? null;
+
+                if ($productParam) {
+                    if (!is_numeric($productParam)) {
+                        $slugQueryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+                            ->getQueryBuilderForTable('tx_vitec_domain_model_product');
+
+                        $productBySlug = $slugQueryBuilder
+                            ->select('uid')
+                            ->from('tx_vitec_domain_model_product')
+                            ->where(
+                                $slugQueryBuilder->expr()->eq('slug', $slugQueryBuilder->createNamedParameter($productParam)),
+                                $slugQueryBuilder->expr()->eq('deleted', 0),
+                                $slugQueryBuilder->expr()->eq('hidden', 0)
+                            )
+                            ->executeQuery()
+                            ->fetchAssociative();
+
+                        $productUid = (int)($productBySlug['uid'] ?? 0);
+                    } else {
+                        $productUid = (int)$productParam;
+                    }
                }
            }
-        }
-        
-        if (!$productUid) {
-            return json_encode([
-                'error' => 'No product selected or found',
-                'debug' => [
-                    'settings' => $settings, 
-                    'routeParams' => $routeParams ?? [],
-                    'allQueryParams' => $GLOBALS['TYPO3_REQUEST']->getQueryParams() ?? [],
-                    'requestUri' => $GLOBALS['TYPO3_REQUEST']->getUri()->getPath() ?? ''
-                ]
-            ]);
-        }
-        
-        // Query product
-        $productQueryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
-            ->getQueryBuilderForTable('tx_vitec_domain_model_product');
-        
-        $product = $productQueryBuilder
-            ->select('*')
-            ->from('tx_vitec_domain_model_product')
-            ->where(
-                $productQueryBuilder->expr()->eq('uid', $productQueryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
-                $productQueryBuilder->expr()->eq('deleted', 0),
-                $productQueryBuilder->expr()->eq('hidden', 0)
-            )
-            ->executeQuery()
-            ->fetchAssociative();
-        
-        if (!$product) {
-            return json_encode([
-                'error' => 'Product not found',
-                'debug' => $debugMode ? ['productUid' => $productUid] : null
-            ]);
-        }
-        
-        // Get product images
-        $images = $this->getProductImages((int)$product['uid']);
-        
-        // Get categories
-        $categories = $this->getProductCategories((int)$product['uid']);
-        
-        // Get downloads
-        $downloads = $this->getProductDownloads((int)$product['uid']);
-        
-        // Build response
-        $response = [
-            'product' => [
-                'uid' => (int)$product['uid'],
-                'title' => $product['title'],
-                'subtitle' => $product['subtitle'],
-                'slug' => $product['slug'],
-                'teaser' => $product['teaser'],
-                'description' => $product['description'],
-                'seotitle' => $product['seotitle'],
-                'categories' => $categories,
-                'images' => $images,
-                'downloads' => $downloads,
-            ],
-            'layout' => $layout,
-            'settings' => [
+
+            if (!$productUid) {
+                return $debugMode
+                    ? json_encode(['error' => 'No product selected or found', 'debug' => ['settings' => $settings]])
+                    : '';
+            }
+
+            $productQueryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+                ->getQueryBuilderForTable('tx_vitec_domain_model_product');
+
+            $product = $productQueryBuilder
+                ->select('*')
+                ->from('tx_vitec_domain_model_product')
+                ->where(
+                    $productQueryBuilder->expr()->eq('uid', $productQueryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                    $productQueryBuilder->expr()->eq('deleted', 0),
+                    $productQueryBuilder->expr()->eq('hidden', 0)
+                )
+                ->executeQuery()
+                ->fetchAssociative();
+
+            if (!$product) {
+                return $debugMode
+                    ? json_encode(['error' => 'Product not found', 'debug' => ['productUid' => $productUid]])
+                    : '';
+            }
+
+            $response = [
+                'product' => $this->serializeProduct($product),
                'layout' => $layout,
-            ],
-        ];
-        
-        if ($debugMode) {
-            $response['debug'] = [
-                'pageId' => $pageId,
-                'productUid' => $productUid,
-                'layout' => $layout,
-                'settings' => $settings,
+                'settings' => [
+                    'layout' => $layout,
+                ],
            ];
+
+            if ($debugMode) {
+                $response['debug'] = [
+                    'pageId' => $pageId,
+                    'productUid' => $productUid,
+                    'layout' => $layout,
+                    'settings' => $settings,
+                ];
+            }
+
+            return json_encode($response);
+        } catch (\Throwable $e) {
+            return '';
        }
-        
-        return json_encode($response);
    }
-    
+
    /**
-     * Get all images for a product with FAL and ImageService processing
+     * @param array<string,mixed> $product
+     * @return array<string,mixed>
     */
+    protected function serializeProduct(array $product): array
+    {
+        $uid = (int)$product['uid'];
+
+        return [
+            'uid' => $uid,
+
+            'title' => (string)($product['title'] ?? ''),
+            'slug' => (string)($product['slug'] ?? ''),
+            'urltitle' => (string)($product['urltitle'] ?? ''),
+            'seotitle' => (string)($product['seotitle'] ?? ''),
+            'seometa' => (string)($product['seometa'] ?? ''),
+            'keywords' => (string)($product['keywords'] ?? ''),
+            'structureddata' => (string)($product['structureddata'] ?? ''),
+            'teaser' => (string)($product['teaser'] ?? ''),
+            'subtitle' => (string)($product['subtitle'] ?? ''),
+            'video' => (string)($product['video'] ?? ''),
+            'applications' => (string)($product['applications'] ?? ''),
+            'description' => (string)($product['description'] ?? ''),
+            'highlights' => (string)($product['highlights'] ?? ''),
+            'shortcutpid' => (string)($product['shortcutpid'] ?? ''),
+            'contentelement' => (string)($product['contentelement'] ?? ''),
+            'contentelementcta' => (string)($product['contentelementcta'] ?? ''),
+
+            'hideonapp' => (bool)($product['hideonapp'] ?? false),
+            'hideonwebsite' => (bool)($product['hideonwebsite'] ?? false),
+            'hideondatasheets' => (bool)($product['hideondatasheets'] ?? false),
+            'hideonproducts' => (bool)($product['hideonproducts'] ?? false),
+            'shortcut' => (bool)($product['shortcut'] ?? false),
+            'legacy' => (bool)($product['legacy'] ?? false),
+            'supportproduct' => (bool)($product['supportproduct'] ?? false),
+            'subproduct' => (bool)($product['subproduct'] ?? false),
+
+            'link' => '/product/' . (string)($product['slug'] ?? ''),
+
+            'categories' => $this->getProductCategories($uid),
+            'images' => $this->getProductImages($uid),
+            'downloads' => $this->getProductDownloads($uid),
+            'ogimage' => $this->getProductOgImage($uid),
+            'relatedprodukt' => $this->getRelatedProducts($uid),
+        ];
+    }
+
    protected function getProductImages(int $productUid): array
    {
        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
            ->getQueryBuilderForTable('sys_file_reference');
-        
+
        $fileReferences = $queryBuilder
            ->select('*')
            ->from('sys_file_reference')
@@ -191,27 +209,25 @@ class ProductShowJsonRenderer
            ->orderBy('sorting_foreign', 'ASC')
            ->executeQuery()
            ->fetchAllAssociative();
-        
+
        if (empty($fileReferences)) {
            return [];
        }
-        
+
        $resourceFactory = GeneralUtility::makeInstance(ResourceFactory::class);
        $imageService = GeneralUtility::makeInstance(ImageService::class);
        $images = [];
-        
+
        foreach ($fileReferences as $fileRef) {
            try {
                $fileReference = $resourceFactory->getFileReferenceObject($fileRef['uid']);
                $originalFile = $fileReference->getOriginalFile();
-                
-                // Process main image
+
                $processedImage = $imageService->applyProcessingInstructions(
                    $fileReference,
                    ['width' => '1874c', 'height' => '625c']
                );
-                
-                // Generate srcset
+
                $srcset = [];
                foreach ([400, 800, 1200, 1600] as $width) {
                    $processedVariant = $imageService->applyProcessingInstructions(
@@ -224,7 +240,7 @@ class ProductShowJsonRenderer
                        'descriptor' => $width . 'w',
                    ];
                }
-                
+
                $images[] = [
                    'uid' => $fileRef['uid'],
                    'url' => $imageService->getImageUri($processedImage),
@@ -239,22 +255,73 @@ class ProductShowJsonRenderer
                    ],
                ];
            } catch (\Exception $e) {
-                // Skip invalid file references
                continue;
            }
        }
-        
+
        return $images;
    }
-    
+
    /**
-     * Get categories for a product
+     * @return array<string,mixed>|null
     */
+    protected function getProductOgImage(int $productUid): ?array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_file_reference');
+
+        $fileRef = $queryBuilder
+            ->select('*')
+            ->from('sys_file_reference')
+            ->where(
+                $queryBuilder->expr()->eq('uid_foreign', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('tablenames', $queryBuilder->createNamedParameter('tx_vitec_domain_model_product', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('fieldname', $queryBuilder->createNamedParameter('ogimage', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('deleted', 0),
+                $queryBuilder->expr()->eq('hidden', 0)
+            )
+            ->orderBy('sorting_foreign', 'ASC')
+            ->setMaxResults(1)
+            ->executeQuery()
+            ->fetchAssociative();
+
+        if (!$fileRef) {
+            return null;
+        }
+
+        try {
+            $resourceFactory = GeneralUtility::makeInstance(ResourceFactory::class);
+            $imageService = GeneralUtility::makeInstance(ImageService::class);
+            $fileReference = $resourceFactory->getFileReferenceObject($fileRef['uid']);
+            $originalFile = $fileReference->getOriginalFile();
+
+            $processedImage = $imageService->applyProcessingInstructions(
+                $fileReference,
+                ['width' => 1200]
+            );
+
+            return [
+                'uid' => $fileRef['uid'],
+                'url' => $imageService->getImageUri($processedImage),
+                'title' => $fileReference->getTitle() ?: '',
+                'alternative' => $fileReference->getAlternative() ?: '',
+                'description' => $fileReference->getDescription() ?: '',
+                'properties' => [
+                    'width' => $originalFile->getProperty('width'),
+                    'height' => $originalFile->getProperty('height'),
+                    'mimeType' => $originalFile->getMimeType(),
+                ],
+            ];
+        } catch (\Exception $e) {
+            return null;
+        }
+    }
+
    protected function getProductCategories(int $productUid): array
    {
        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
            ->getQueryBuilderForTable('sys_category');
-        
+
        $categories = $queryBuilder
            ->select('c.uid', 'c.title', 'c.description')
            ->from('sys_category', 'c')
@@ -262,9 +329,9 @@ class ProductShowJsonRenderer
                'c',
                'sys_category_record_mm',
                'mm',
-                'mm.uid_local = c.uid AND mm.tablenames = ' . 
-                $queryBuilder->createNamedParameter('tx_vitec_domain_model_product', ParameterType::STRING) . 
-                ' AND mm.fieldname = ' . 
+                'mm.uid_local = c.uid AND mm.tablenames = ' .
+                $queryBuilder->createNamedParameter('tx_vitec_domain_model_product', ParameterType::STRING) .
+                ' AND mm.fieldname = ' .
                $queryBuilder->createNamedParameter('categories', ParameterType::STRING)
            )
            ->where(
@@ -275,7 +342,7 @@ class ProductShowJsonRenderer
            ->orderBy('mm.sorting', 'ASC')
            ->executeQuery()
            ->fetchAllAssociative();
-        
+
        return array_map(function ($cat) {
            return [
                'uid' => (int)$cat['uid'],
@@ -284,15 +351,12 @@ class ProductShowJsonRenderer
            ];
        }, $categories);
    }
-    
-    /**
-     * Get all downloads for a product
-     */
+
    protected function getProductDownloads(int $productUid): array
    {
        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
            ->getQueryBuilderForTable('tx_vitec_domain_model_download');
-        
+
        $downloads = $queryBuilder
            ->select('d.*')
            ->from('tx_vitec_domain_model_download', 'd')
@@ -311,16 +375,15 @@ class ProductShowJsonRenderer
            ->orderBy('mm.sorting', 'ASC')
            ->executeQuery()
            ->fetchAllAssociative();
-        
+
        $result = [];
        foreach ($downloads as $download) {
            $fileInfo = null;
-            
-            // Get file information from FAL if file reference exists
+
            if (!empty($download['file'])) {
                $fileQueryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
                    ->getQueryBuilderForTable('sys_file_reference');
-                
+
                $fileRef = $fileQueryBuilder
                    ->select('fr.uid', 'f.uid as file_uid', 'f.identifier', 'f.name', 'f.size', 'f.extension', 'f.mime_type')
                    ->from('sys_file_reference', 'fr')
@@ -336,7 +399,7 @@ class ProductShowJsonRenderer
                    ->setMaxResults(1)
                    ->executeQuery()
                    ->fetchAssociative();
-                
+
                if ($fileRef) {
                    $fileInfo = [
                        'uid' => (int)$fileRef['file_uid'],
@@ -348,7 +411,7 @@ class ProductShowJsonRenderer
                    ];
                }
            }
-            
+
            $result[] = [
                'uid' => (int)$download['uid'],
                'title' => $download['title'] ?? '',
@@ -360,7 +423,48 @@ class ProductShowJsonRenderer
                'file' => $fileInfo,
            ];
        }
-        
+
+        return $result;
+    }
+
+    protected function getRelatedProducts(int $productUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('tx_vitec_domain_model_product');
+
+        $related = $queryBuilder
+            ->select('p.uid', 'p.title', 'p.slug', 'p.subtitle', 'p.teaser', 'p.description')
+            ->from('tx_vitec_domain_model_product', 'p')
+            ->join(
+                'p',
+                'tx_vitec_product_related_mm',
+                'mm',
+                'mm.uid_foreign = p.uid'
+            )
+            ->where(
+                $queryBuilder->expr()->eq('mm.uid_local', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('p.deleted', 0),
+                $queryBuilder->expr()->eq('p.hidden', 0)
+            )
+            ->orderBy('mm.sorting', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        $result = [];
+        foreach ($related as $rel) {
+            $relUid = (int)$rel['uid'];
+            $result[] = [
+                'uid' => $relUid,
+                'title' => (string)($rel['title'] ?? ''),
+                'slug' => (string)($rel['slug'] ?? ''),
+                'subtitle' => (string)($rel['subtitle'] ?? ''),
+                'teaser' => (string)($rel['teaser'] ?? ''),
+                'description' => (string)($rel['description'] ?? ''),
+                'link' => '/product/' . (string)($rel['slug'] ?? ''),
+                'images' => $this->getProductImages($relUid),
+            ];
+        }
+
        return $result;
    }
 }
@@ -0,0 +1,366 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Evomedien\Vitec\UserFunc;
+
+use TYPO3\CMS\Core\Database\ConnectionPool;
+use TYPO3\CMS\Core\Service\FlexFormService;
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+use TYPO3\CMS\Core\Resource\ResourceFactory;
+use TYPO3\CMS\Core\Imaging\ImageManipulation\CropVariantCollection;
+use TYPO3\CMS\Core\Resource\FileReference;
+use TYPO3\CMS\Core\Imaging\ImageService;
+use Doctrine\DBAL\ParameterType;
+
+/**
+ * UserFunc to render single product data as JSON for headless output
+ */
+class ProductShowJsonRenderer
+{
+    public function render(string $content, array $conf): string
+    {
+        $pageId = (int)$GLOBALS['TSFE']->id;
+        
+        // DEBUG: Log that the UserFunc is being called
+        $debugInfo = [
+            'userFuncCalled' => true,
+            'pageId' => $pageId,
+            'requestUri' => $_SERVER['REQUEST_URI'] ?? 'unknown',
+        ];
+        
+        // Query tt_content for vitec_productshow on this page
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('tt_content');
+        
+        $contentElements = $queryBuilder
+            ->select('*')
+            ->from('tt_content')
+            ->where(
+                $queryBuilder->expr()->eq('pid', $queryBuilder->createNamedParameter($pageId, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('list_type', $queryBuilder->createNamedParameter('vitec_productshow', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('deleted', 0),
+                $queryBuilder->expr()->eq('hidden', 0)
+            )
+            ->executeQuery()
+            ->fetchAllAssociative();
+        
+        $debugInfo['contentElementsFound'] = count($contentElements);
+        
+        if (empty($contentElements)) {
+            $debugInfo['error'] = 'No vitec_productshow on page';
+            return json_encode(['debug' => $debugInfo]);
+        }
+        
+        // Take the first one
+        $contentElement = $contentElements[0];
+        
+        // Parse FlexForm
+        $flexFormService = GeneralUtility::makeInstance(FlexFormService::class);
+        $flexFormData = $flexFormService->convertFlexFormContentToArray($contentElement['pi_flexform'] ?? '');
+        $settings = $flexFormData['settings'] ?? [];
+        
+        // Get product UID from FlexForm or route parameter
+        $productUid = (int)($settings['product'] ?? 0);
+        $layout = (int)($settings['layout'] ?? 0);
+        $debugMode = (bool)($settings['debug'] ?? false);
+        
+        // If no product selected in FlexForm, try to get from route parameter
+        if (!$productUid) {
+            // Get the product parameter from GET request
+            $routeParams = $GLOBALS['TYPO3_REQUEST']->getQueryParams();
+            $productParam = $routeParams['tx_vitec_productshow']['product'] ?? null;
+            
+            if ($productParam) {
+                // If it's a slug, resolve it to UID
+                if (!is_numeric($productParam)) {
+                    $slugQueryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+                        ->getQueryBuilderForTable('tx_vitec_domain_model_product');
+                    
+                    $productBySlug = $slugQueryBuilder
+                        ->select('uid')
+                        ->from('tx_vitec_domain_model_product')
+                        ->where(
+                            $slugQueryBuilder->expr()->eq('slug', $slugQueryBuilder->createNamedParameter($productParam)),
+                            $slugQueryBuilder->expr()->eq('deleted', 0),
+                            $slugQueryBuilder->expr()->eq('hidden', 0)
+                        )
+                        ->executeQuery()
+                        ->fetchAssociative();
+                    
+                    $productUid = (int)($productBySlug['uid'] ?? 0);
+                } else {
+                    $productUid = (int)$productParam;
+                }
+            }
+        }
+        
+        if (!$productUid) {
+            return json_encode([
+                'error' => 'No product selected or found',
+                'debug' => [
+                    'settings' => $settings, 
+                    'routeParams' => $routeParams ?? [],
+                    'allQueryParams' => $GLOBALS['TYPO3_REQUEST']->getQueryParams() ?? [],
+                    'requestUri' => $GLOBALS['TYPO3_REQUEST']->getUri()->getPath() ?? ''
+                ]
+            ]);
+        }
+        
+        // Query product
+        $productQueryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('tx_vitec_domain_model_product');
+        
+        $product = $productQueryBuilder
+            ->select('*')
+            ->from('tx_vitec_domain_model_product')
+            ->where(
+                $productQueryBuilder->expr()->eq('uid', $productQueryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $productQueryBuilder->expr()->eq('deleted', 0),
+                $productQueryBuilder->expr()->eq('hidden', 0)
+            )
+            ->executeQuery()
+            ->fetchAssociative();
+        
+        if (!$product) {
+            return json_encode([
+                'error' => 'Product not found',
+                'debug' => $debugMode ? ['productUid' => $productUid] : null
+            ]);
+        }
+        
+        // Get product images
+        $images = $this->getProductImages((int)$product['uid']);
+        
+        // Get categories
+        $categories = $this->getProductCategories((int)$product['uid']);
+        
+        // Get downloads
+        $downloads = $this->getProductDownloads((int)$product['uid']);
+        
+        // Build response
+        $response = [
+            'product' => [
+                'uid' => (int)$product['uid'],
+                'title' => $product['title'],
+                'subtitle' => $product['subtitle'],
+                'slug' => $product['slug'],
+                'teaser' => $product['teaser'],
+                'description' => $product['description'],
+                'seotitle' => $product['seotitle'],
+                'categories' => $categories,
+                'images' => $images,
+                'downloads' => $downloads,
+            ],
+            'layout' => $layout,
+            'settings' => [
+                'layout' => $layout,
+            ],
+        ];
+        
+        if ($debugMode) {
+            $response['debug'] = [
+                'pageId' => $pageId,
+                'productUid' => $productUid,
+                'layout' => $layout,
+                'settings' => $settings,
+            ];
+        }
+        
+        return json_encode($response);
+    }
+    
+    /**
+     * Get all images for a product with FAL and ImageService processing
+     */
+    protected function getProductImages(int $productUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_file_reference');
+        
+        $fileReferences = $queryBuilder
+            ->select('*')
+            ->from('sys_file_reference')
+            ->where(
+                $queryBuilder->expr()->eq('uid_foreign', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('tablenames', $queryBuilder->createNamedParameter('tx_vitec_domain_model_product', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('fieldname', $queryBuilder->createNamedParameter('productimage', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('deleted', 0),
+                $queryBuilder->expr()->eq('hidden', 0)
+            )
+            ->orderBy('sorting_foreign', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+        
+        if (empty($fileReferences)) {
+            return [];
+        }
+        
+        $resourceFactory = GeneralUtility::makeInstance(ResourceFactory::class);
+        $imageService = GeneralUtility::makeInstance(ImageService::class);
+        $images = [];
+        
+        foreach ($fileReferences as $fileRef) {
+            try {
+                $fileReference = $resourceFactory->getFileReferenceObject($fileRef['uid']);
+                $originalFile = $fileReference->getOriginalFile();
+                
+                // Process main image
+                $processedImage = $imageService->applyProcessingInstructions(
+                    $fileReference,
+                    ['width' => '1874c', 'height' => '625c']
+                );
+                
+                // Generate srcset
+                $srcset = [];
+                foreach ([400, 800, 1200, 1600] as $width) {
+                    $processedVariant = $imageService->applyProcessingInstructions(
+                        $fileReference,
+                        ['width' => $width . 'c', 'height' => (int)($width / 3) . 'c']
+                    );
+                    $srcset[] = [
+                        'url' => $imageService->getImageUri($processedVariant),
+                        'width' => $width,
+                        'descriptor' => $width . 'w',
+                    ];
+                }
+                
+                $images[] = [
+                    'uid' => $fileRef['uid'],
+                    'url' => $imageService->getImageUri($processedImage),
+                    'title' => $fileReference->getTitle() ?: '',
+                    'alternative' => $fileReference->getAlternative() ?: '',
+                    'description' => $fileReference->getDescription() ?: '',
+                    'srcset' => $srcset,
+                    'properties' => [
+                        'width' => $originalFile->getProperty('width'),
+                        'height' => $originalFile->getProperty('height'),
+                        'mimeType' => $originalFile->getMimeType(),
+                    ],
+                ];
+            } catch (\Exception $e) {
+                // Skip invalid file references
+                continue;
+            }
+        }
+        
+        return $images;
+    }
+    
+    /**
+     * Get categories for a product
+     */
+    protected function getProductCategories(int $productUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_category');
+        
+        $categories = $queryBuilder
+            ->select('c.uid', 'c.title', 'c.description')
+            ->from('sys_category', 'c')
+            ->join(
+                'c',
+                'sys_category_record_mm',
+                'mm',
+                'mm.uid_local = c.uid AND mm.tablenames = ' . 
+                $queryBuilder->createNamedParameter('tx_vitec_domain_model_product', ParameterType::STRING) . 
+                ' AND mm.fieldname = ' . 
+                $queryBuilder->createNamedParameter('categories', ParameterType::STRING)
+            )
+            ->where(
+                $queryBuilder->expr()->eq('mm.uid_foreign', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('c.deleted', 0),
+                $queryBuilder->expr()->eq('c.hidden', 0)
+            )
+            ->orderBy('mm.sorting', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+        
+        return array_map(function ($cat) {
+            return [
+                'uid' => (int)$cat['uid'],
+                'title' => $cat['title'],
+                'description' => $cat['description'] ?? '',
+            ];
+        }, $categories);
+    }
+    
+    /**
+     * Get all downloads for a product
+     */
+    protected function getProductDownloads(int $productUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('tx_vitec_domain_model_download');
+        
+        $downloads = $queryBuilder
+            ->select('d.*')
+            ->from('tx_vitec_domain_model_download', 'd')
+            ->join(
+                'd',
+                'tx_vitec_product_download_mm',
+                'mm',
+                'mm.uid_foreign = d.uid'
+            )
+            ->where(
+                $queryBuilder->expr()->eq('mm.uid_local', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('d.deleted', 0),
+                $queryBuilder->expr()->eq('d.hidden', 0),
+                $queryBuilder->expr()->eq('d.hideonwebsite', 0)
+            )
+            ->orderBy('mm.sorting', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+        
+        $result = [];
+        foreach ($downloads as $download) {
+            $fileInfo = null;
+            
+            // Get file information from FAL if file reference exists
+            if (!empty($download['file'])) {
+                $fileQueryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+                    ->getQueryBuilderForTable('sys_file_reference');
+                
+                $fileRef = $fileQueryBuilder
+                    ->select('fr.uid', 'f.uid as file_uid', 'f.identifier', 'f.name', 'f.size', 'f.extension', 'f.mime_type')
+                    ->from('sys_file_reference', 'fr')
+                    ->join('fr', 'sys_file', 'f', 'fr.uid_local = f.uid')
+                    ->where(
+                        $fileQueryBuilder->expr()->eq('fr.uid_foreign', $fileQueryBuilder->createNamedParameter((int)$download['uid'], ParameterType::INTEGER)),
+                        $fileQueryBuilder->expr()->eq('fr.tablenames', $fileQueryBuilder->createNamedParameter('tx_vitec_domain_model_download', ParameterType::STRING)),
+                        $fileQueryBuilder->expr()->eq('fr.fieldname', $fileQueryBuilder->createNamedParameter('file', ParameterType::STRING)),
+                        $fileQueryBuilder->expr()->eq('fr.deleted', 0),
+                        $fileQueryBuilder->expr()->eq('f.missing', 0)
+                    )
+                    ->orderBy('fr.sorting_foreign', 'ASC')
+                    ->setMaxResults(1)
+                    ->executeQuery()
+                    ->fetchAssociative();
+                
+                if ($fileRef) {
+                    $fileInfo = [
+                        'uid' => (int)$fileRef['file_uid'],
+                        'name' => $fileRef['name'],
+                        'url' => '/fileadmin' . $fileRef['identifier'],
+                        'size' => (int)$fileRef['size'],
+                        'extension' => $fileRef['extension'],
+                        'mimeType' => $fileRef['mime_type'] ?? '',
+                    ];
+                }
+            }
+            
+            $result[] = [
+                'uid' => (int)$download['uid'],
+                'title' => $download['title'] ?? '',
+                'slug' => $download['slug'] ?? '',
+                'teaser' => $download['teaser'] ?? '',
+                'description' => $download['description'] ?? '',
+                'keywords' => $download['keywords'] ?? '',
+                'icon' => $download['icon'] ?? '',
+                'file' => $fileInfo,
+            ];
+        }
+        
+        return $result;
+    }
+}
@@ -0,0 +1,512 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Evomedien\Vitec\UserFunc;
+
+use TYPO3\CMS\Core\Database\ConnectionPool;
+use TYPO3\CMS\Core\Service\FlexFormService;
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+use TYPO3\CMS\Core\Resource\ResourceFactory;
+use TYPO3\CMS\Core\Imaging\ImageManipulation\CropVariantCollection;
+use TYPO3\CMS\Core\Resource\FileReference;
+use TYPO3\CMS\Core\Imaging\ImageService;
+use Doctrine\DBAL\ParameterType;
+
+/**
+ * UserFunc to render single product data as JSON for headless output
+ */
+class ProductShowJsonRenderer
+{
+    public function render(string $content, array $conf): string
+    {
+        $pageId = (int)$GLOBALS['TSFE']->id;
+
+        // DEBUG: Log that the UserFunc is being called
+        $debugInfo = [
+            'userFuncCalled' => true,
+            'pageId' => $pageId,
+            'requestUri' => $_SERVER['REQUEST_URI'] ?? 'unknown',
+        ];
+
+        // Query tt_content for vitec_productshow on this page
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('tt_content');
+
+        $contentElements = $queryBuilder
+            ->select('*')
+            ->from('tt_content')
+            ->where(
+                $queryBuilder->expr()->eq('pid', $queryBuilder->createNamedParameter($pageId, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('list_type', $queryBuilder->createNamedParameter('vitec_productshow', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('deleted', 0),
+                $queryBuilder->expr()->eq('hidden', 0)
+            )
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        $debugInfo['contentElementsFound'] = count($contentElements);
+
+        if (empty($contentElements)) {
+            $debugInfo['error'] = 'No vitec_productshow on page';
+            return json_encode(['debug' => $debugInfo]);
+        }
+
+        // Take the first one
+        $contentElement = $contentElements[0];
+
+        // Parse FlexForm
+        $flexFormService = GeneralUtility::makeInstance(FlexFormService::class);
+        $flexFormData = $flexFormService->convertFlexFormContentToArray($contentElement['pi_flexform'] ?? '');
+        $settings = $flexFormData['settings'] ?? [];
+
+        // Get product UID from FlexForm or route parameter
+        $productUid = (int)($settings['product'] ?? 0);
+        $layout = (int)($settings['layout'] ?? 0);
+        $debugMode = (bool)($settings['debug'] ?? false);
+
+        // If no product selected in FlexForm, try to get from route parameter
+        if (!$productUid) {
+            // Get the product parameter from GET request
+            $routeParams = $GLOBALS['TYPO3_REQUEST']->getQueryParams();
+            $productParam = $routeParams['tx_vitec_productshow']['product'] ?? null;
+
+            if ($productParam) {
+                // If it's a slug, resolve it to UID
+                if (!is_numeric($productParam)) {
+                    $slugQueryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+                        ->getQueryBuilderForTable('tx_vitec_domain_model_product');
+
+                    $productBySlug = $slugQueryBuilder
+                        ->select('uid')
+                        ->from('tx_vitec_domain_model_product')
+                        ->where(
+                            $slugQueryBuilder->expr()->eq('slug', $slugQueryBuilder->createNamedParameter($productParam)),
+                            $slugQueryBuilder->expr()->eq('deleted', 0),
+                            $slugQueryBuilder->expr()->eq('hidden', 0)
+                        )
+                        ->executeQuery()
+                        ->fetchAssociative();
+
+                    $productUid = (int)($productBySlug['uid'] ?? 0);
+                } else {
+                    $productUid = (int)$productParam;
+                }
+            }
+        }
+
+        if (!$productUid) {
+            return json_encode([
+                'error' => 'No product selected or found',
+                'debug' => [
+                    'settings' => $settings,
+                    'routeParams' => $routeParams ?? [],
+                    'allQueryParams' => $GLOBALS['TYPO3_REQUEST']->getQueryParams() ?? [],
+                    'requestUri' => $GLOBALS['TYPO3_REQUEST']->getUri()->getPath() ?? ''
+                ]
+            ]);
+        }
+
+        // Query product
+        $productQueryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('tx_vitec_domain_model_product');
+
+        $product = $productQueryBuilder
+            ->select('*')
+            ->from('tx_vitec_domain_model_product')
+            ->where(
+                $productQueryBuilder->expr()->eq('uid', $productQueryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $productQueryBuilder->expr()->eq('deleted', 0),
+                $productQueryBuilder->expr()->eq('hidden', 0)
+            )
+            ->executeQuery()
+            ->fetchAssociative();
+
+        if (!$product) {
+            return json_encode([
+                'error' => 'Product not found',
+                'debug' => $debugMode ? ['productUid' => $productUid] : null
+            ]);
+        }
+
+        // Build response (full Product domain model + resolved relations)
+        $response = [
+            'product' => $this->serializeProduct($product),
+            'layout' => $layout,
+            'settings' => [
+                'layout' => $layout,
+            ],
+        ];
+
+        if ($debugMode) {
+            $response['debug'] = [
+                'pageId' => $pageId,
+                'productUid' => $productUid,
+                'layout' => $layout,
+                'settings' => $settings,
+            ];
+        }
+
+        return json_encode($response);
+    }
+
+    /**
+     * Serialize a single product DB row to the full headless JSON structure.
+     *
+     * Includes every field declared on the Product domain model
+     * (Evomedien\Vitec\Domain\Model\Product) plus all fully resolved
+     * relations (categories, productimage, downloads, ogimage, relatedprodukt).
+     *
+     * Kept structurally identical to ProductListJsonRenderer::serializeProduct()
+     * so list and detail endpoints expose the same product schema.
+     *
+     * @param array<string,mixed> $product Associative DB row of tx_vitec_domain_model_product
+     * @return array<string,mixed>
+     */
+    protected function serializeProduct(array $product): array
+    {
+        $uid = (int)$product['uid'];
+
+        return [
+            // --- identifier ---
+            'uid' => $uid,
+
+            // --- scalar string fields (Product domain model) ---
+            'title' => (string)($product['title'] ?? ''),
+            'slug' => (string)($product['slug'] ?? ''),
+            'urltitle' => (string)($product['urltitle'] ?? ''),
+            'seotitle' => (string)($product['seotitle'] ?? ''),
+            'seometa' => (string)($product['seometa'] ?? ''),
+            'keywords' => (string)($product['keywords'] ?? ''),
+            'structureddata' => (string)($product['structureddata'] ?? ''),
+            'teaser' => (string)($product['teaser'] ?? ''),
+            'subtitle' => (string)($product['subtitle'] ?? ''),
+            'video' => (string)($product['video'] ?? ''),
+            'applications' => (string)($product['applications'] ?? ''),
+            'description' => (string)($product['description'] ?? ''),
+            'highlights' => (string)($product['highlights'] ?? ''),
+            'shortcutpid' => (string)($product['shortcutpid'] ?? ''),
+            'contentelement' => (string)($product['contentelement'] ?? ''),
+            'contentelementcta' => (string)($product['contentelementcta'] ?? ''),
+
+            // --- boolean flags (Product domain model) ---
+            'hideonapp' => (bool)($product['hideonapp'] ?? false),
+            'hideonwebsite' => (bool)($product['hideonwebsite'] ?? false),
+            'hideondatasheets' => (bool)($product['hideondatasheets'] ?? false),
+            'hideonproducts' => (bool)($product['hideonproducts'] ?? false),
+            'shortcut' => (bool)($product['shortcut'] ?? false),
+            'legacy' => (bool)($product['legacy'] ?? false),
+            'supportproduct' => (bool)($product['supportproduct'] ?? false),
+            'subproduct' => (bool)($product['subproduct'] ?? false),
+
+            // --- convenience link (kept for backward compatibility) ---
+            'link' => '/product/' . (string)($product['slug'] ?? ''),
+
+            // --- fully resolved relations ---
+            'categories' => $this->getProductCategories($uid),
+            'images' => $this->getProductImages($uid),
+            'downloads' => $this->getProductDownloads($uid),
+            'ogimage' => $this->getProductOgImage($uid),
+            'relatedprodukt' => $this->getRelatedProducts($uid),
+        ];
+    }
+
+    /**
+     * Get all images for a product with FAL and ImageService processing
+     */
+    protected function getProductImages(int $productUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_file_reference');
+
+        $fileReferences = $queryBuilder
+            ->select('*')
+            ->from('sys_file_reference')
+            ->where(
+                $queryBuilder->expr()->eq('uid_foreign', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('tablenames', $queryBuilder->createNamedParameter('tx_vitec_domain_model_product', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('fieldname', $queryBuilder->createNamedParameter('productimage', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('deleted', 0),
+                $queryBuilder->expr()->eq('hidden', 0)
+            )
+            ->orderBy('sorting_foreign', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        if (empty($fileReferences)) {
+            return [];
+        }
+
+        $resourceFactory = GeneralUtility::makeInstance(ResourceFactory::class);
+        $imageService = GeneralUtility::makeInstance(ImageService::class);
+        $images = [];
+
+        foreach ($fileReferences as $fileRef) {
+            try {
+                $fileReference = $resourceFactory->getFileReferenceObject($fileRef['uid']);
+                $originalFile = $fileReference->getOriginalFile();
+
+                // Process main image
+                $processedImage = $imageService->applyProcessingInstructions(
+                    $fileReference,
+                    ['width' => '1874c', 'height' => '625c']
+                );
+
+                // Generate srcset
+                $srcset = [];
+                foreach ([400, 800, 1200, 1600] as $width) {
+                    $processedVariant = $imageService->applyProcessingInstructions(
+                        $fileReference,
+                        ['width' => $width . 'c', 'height' => (int)($width / 3) . 'c']
+                    );
+                    $srcset[] = [
+                        'url' => $imageService->getImageUri($processedVariant),
+                        'width' => $width,
+                        'descriptor' => $width . 'w',
+                    ];
+                }
+
+                $images[] = [
+                    'uid' => $fileRef['uid'],
+                    'url' => $imageService->getImageUri($processedImage),
+                    'title' => $fileReference->getTitle() ?: '',
+                    'alternative' => $fileReference->getAlternative() ?: '',
+                    'description' => $fileReference->getDescription() ?: '',
+                    'srcset' => $srcset,
+                    'properties' => [
+                        'width' => $originalFile->getProperty('width'),
+                        'height' => $originalFile->getProperty('height'),
+                        'mimeType' => $originalFile->getMimeType(),
+                    ],
+                ];
+            } catch (\Exception $e) {
+                // Skip invalid file references
+                continue;
+            }
+        }
+
+        return $images;
+    }
+
+    /**
+     * Get the single Open Graph image (ogimage) for a product, or null.
+     *
+     * @return array<string,mixed>|null
+     */
+    protected function getProductOgImage(int $productUid): ?array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_file_reference');
+
+        $fileRef = $queryBuilder
+            ->select('*')
+            ->from('sys_file_reference')
+            ->where(
+                $queryBuilder->expr()->eq('uid_foreign', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('tablenames', $queryBuilder->createNamedParameter('tx_vitec_domain_model_product', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('fieldname', $queryBuilder->createNamedParameter('ogimage', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('deleted', 0),
+                $queryBuilder->expr()->eq('hidden', 0)
+            )
+            ->orderBy('sorting_foreign', 'ASC')
+            ->setMaxResults(1)
+            ->executeQuery()
+            ->fetchAssociative();
+
+        if (!$fileRef) {
+            return null;
+        }
+
+        try {
+            $resourceFactory = GeneralUtility::makeInstance(ResourceFactory::class);
+            $imageService = GeneralUtility::makeInstance(ImageService::class);
+            $fileReference = $resourceFactory->getFileReferenceObject($fileRef['uid']);
+            $originalFile = $fileReference->getOriginalFile();
+
+            $processedImage = $imageService->applyProcessingInstructions(
+                $fileReference,
+                ['width' => 1200]
+            );
+
+            return [
+                'uid' => $fileRef['uid'],
+                'url' => $imageService->getImageUri($processedImage),
+                'title' => $fileReference->getTitle() ?: '',
+                'alternative' => $fileReference->getAlternative() ?: '',
+                'description' => $fileReference->getDescription() ?: '',
+                'properties' => [
+                    'width' => $originalFile->getProperty('width'),
+                    'height' => $originalFile->getProperty('height'),
+                    'mimeType' => $originalFile->getMimeType(),
+                ],
+            ];
+        } catch (\Exception $e) {
+            return null;
+        }
+    }
+
+    /**
+     * Get categories for a product
+     */
+    protected function getProductCategories(int $productUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_category');
+
+        $categories = $queryBuilder
+            ->select('c.uid', 'c.title', 'c.description')
+            ->from('sys_category', 'c')
+            ->join(
+                'c',
+                'sys_category_record_mm',
+                'mm',
+                'mm.uid_local = c.uid AND mm.tablenames = ' .
+                $queryBuilder->createNamedParameter('tx_vitec_domain_model_product', ParameterType::STRING) .
+                ' AND mm.fieldname = ' .
+                $queryBuilder->createNamedParameter('categories', ParameterType::STRING)
+            )
+            ->where(
+                $queryBuilder->expr()->eq('mm.uid_foreign', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('c.deleted', 0),
+                $queryBuilder->expr()->eq('c.hidden', 0)
+            )
+            ->orderBy('mm.sorting', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        return array_map(function ($cat) {
+            return [
+                'uid' => (int)$cat['uid'],
+                'title' => $cat['title'],
+                'description' => $cat['description'] ?? '',
+            ];
+        }, $categories);
+    }
+
+    /**
+     * Get all downloads for a product
+     */
+    protected function getProductDownloads(int $productUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('tx_vitec_domain_model_download');
+
+        $downloads = $queryBuilder
+            ->select('d.*')
+            ->from('tx_vitec_domain_model_download', 'd')
+            ->join(
+                'd',
+                'tx_vitec_product_download_mm',
+                'mm',
+                'mm.uid_foreign = d.uid'
+            )
+            ->where(
+                $queryBuilder->expr()->eq('mm.uid_local', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('d.deleted', 0),
+                $queryBuilder->expr()->eq('d.hidden', 0),
+                $queryBuilder->expr()->eq('d.hideonwebsite', 0)
+            )
+            ->orderBy('mm.sorting', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        $result = [];
+        foreach ($downloads as $download) {
+            $fileInfo = null;
+
+            // Get file information from FAL if file reference exists
+            if (!empty($download['file'])) {
+                $fileQueryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+                    ->getQueryBuilderForTable('sys_file_reference');
+
+                $fileRef = $fileQueryBuilder
+                    ->select('fr.uid', 'f.uid as file_uid', 'f.identifier', 'f.name', 'f.size', 'f.extension', 'f.mime_type')
+                    ->from('sys_file_reference', 'fr')
+                    ->join('fr', 'sys_file', 'f', 'fr.uid_local = f.uid')
+                    ->where(
+                        $fileQueryBuilder->expr()->eq('fr.uid_foreign', $fileQueryBuilder->createNamedParameter((int)$download['uid'], ParameterType::INTEGER)),
+                        $fileQueryBuilder->expr()->eq('fr.tablenames', $fileQueryBuilder->createNamedParameter('tx_vitec_domain_model_download', ParameterType::STRING)),
+                        $fileQueryBuilder->expr()->eq('fr.fieldname', $fileQueryBuilder->createNamedParameter('file', ParameterType::STRING)),
+                        $fileQueryBuilder->expr()->eq('fr.deleted', 0),
+                        $fileQueryBuilder->expr()->eq('f.missing', 0)
+                    )
+                    ->orderBy('fr.sorting_foreign', 'ASC')
+                    ->setMaxResults(1)
+                    ->executeQuery()
+                    ->fetchAssociative();
+
+                if ($fileRef) {
+                    $fileInfo = [
+                        'uid' => (int)$fileRef['file_uid'],
+                        'name' => $fileRef['name'],
+                        'url' => '/fileadmin' . $fileRef['identifier'],
+                        'size' => (int)$fileRef['size'],
+                        'extension' => $fileRef['extension'],
+                        'mimeType' => $fileRef['mime_type'] ?? '',
+                    ];
+                }
+            }
+
+            $result[] = [
+                'uid' => (int)$download['uid'],
+                'title' => $download['title'] ?? '',
+                'slug' => $download['slug'] ?? '',
+                'teaser' => $download['teaser'] ?? '',
+                'description' => $download['description'] ?? '',
+                'keywords' => $download['keywords'] ?? '',
+                'icon' => $download['icon'] ?? '',
+                'file' => $fileInfo,
+            ];
+        }
+
+        return $result;
+    }
+
+    /**
+     * Get related products (resolved via tx_vitec_product_related_mm).
+     *
+     * Returns a shallow representation (no nested relations) to avoid
+     * infinite recursion between mutually related products.
+     */
+    protected function getRelatedProducts(int $productUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('tx_vitec_domain_model_product');
+
+        $related = $queryBuilder
+            ->select('p.uid', 'p.title', 'p.slug', 'p.subtitle', 'p.teaser', 'p.description')
+            ->from('tx_vitec_domain_model_product', 'p')
+            ->join(
+                'p',
+                'tx_vitec_product_related_mm',
+                'mm',
+                'mm.uid_foreign = p.uid'
+            )
+            ->where(
+                $queryBuilder->expr()->eq('mm.uid_local', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('p.deleted', 0),
+                $queryBuilder->expr()->eq('p.hidden', 0)
+            )
+            ->orderBy('mm.sorting', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        $result = [];
+        foreach ($related as $rel) {
+            $relUid = (int)$rel['uid'];
+
+            $result[] = [
+                'uid' => $relUid,
+                'title' => (string)($rel['title'] ?? ''),
+                'slug' => (string)($rel['slug'] ?? ''),
+                'subtitle' => (string)($rel['subtitle'] ?? ''),
+                'teaser' => (string)($rel['teaser'] ?? ''),
+                'description' => (string)($rel['description'] ?? ''),
+                'link' => '/product/' . (string)($rel['slug'] ?? ''),
+                'images' => $this->getProductImages($relUid),
+            ];
+        }
+
+        return $result;
+    }
+}
@@ -0,0 +1,223 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Evomedien\Vitec\UserFunc;
+
+use Doctrine\DBAL\ParameterType;
+use TYPO3\CMS\Core\Database\ConnectionPool;
+use TYPO3\CMS\Core\Resource\ResourceFactory;
+use TYPO3\CMS\Core\Service\FlexFormService;
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+use TYPO3\CMS\Extbase\Service\ImageService;
+
+/**
+ * UserFunc to render the usecase list as JSON for headless output.
+ *
+ * `render()` = page discovery (top-level plugin). `renderForRecord()` =
+ * one specific tt_content row, reused by ContainerChildrenProcessor for
+ * usecase-list plugins nested in a b13 container. Exception-safe.
+ */
+class UsecaseListJsonRenderer
+{
+    public function render(string $content, array $conf): string
+    {
+        $pageId = (int)($GLOBALS['TSFE']->id ?? 0);
+
+        $ttContentQb = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('tt_content');
+
+        $contentElements = $ttContentQb
+            ->select('*')
+            ->from('tt_content')
+            ->where(
+                $ttContentQb->expr()->eq('pid', $ttContentQb->createNamedParameter($pageId, ParameterType::INTEGER)),
+                $ttContentQb->expr()->eq('list_type', $ttContentQb->createNamedParameter('vitec_usecaselist', ParameterType::STRING)),
+                $ttContentQb->expr()->eq('deleted', 0),
+                $ttContentQb->expr()->eq('hidden', 0)
+            )
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        if (empty($contentElements)) {
+            return '';
+        }
+
+        return $this->renderForRecord($contentElements[0]);
+    }
+
+    /**
+     * @param array<string,mixed> $contentElement
+     */
+    public function renderForRecord(array $contentElement): string
+    {
+        try {
+            $flexFormService = GeneralUtility::makeInstance(FlexFormService::class);
+            $flexFormData = $flexFormService->convertFlexFormContentToArray($contentElement['pi_flexform'] ?? '');
+            $settings = $flexFormData['settings'] ?? [];
+            $debugMode = (bool)($settings['debug'] ?? false);
+
+            $usecaseQb = GeneralUtility::makeInstance(ConnectionPool::class)
+                ->getQueryBuilderForTable('tx_vitec_domain_model_usecase');
+
+            $usecases = $usecaseQb
+                ->select('u.*')
+                ->from('tx_vitec_domain_model_usecase', 'u')
+                ->where(
+                    $usecaseQb->expr()->eq('u.deleted', 0),
+                    $usecaseQb->expr()->eq('u.hidden', 0),
+                    $usecaseQb->expr()->eq('u.hideonwebsite', 0)
+                )
+                ->orderBy('u.title', 'ASC')
+                ->executeQuery()
+                ->fetchAllAssociative();
+
+            $usecasesData = [];
+            foreach ($usecases as $usecase) {
+                $usecasesData[] = $this->serializeUsecase($usecase);
+            }
+
+            if ($debugMode) {
+                return json_encode([
+                    'usecases' => $usecasesData,
+                    'debug' => [
+                        'pageId' => (int)($GLOBALS['TSFE']->id ?? 0),
+                        'usecaseCount' => count($usecasesData),
+                        'settings' => $settings,
+                    ],
+                ]);
+            }
+
+            return json_encode($usecasesData);
+        } catch (\Throwable $e) {
+            return '';
+        }
+    }
+
+    /**
+     * @param array<string,mixed> $usecase
+     * @return array<string,mixed>
+     */
+    protected function serializeUsecase(array $usecase): array
+    {
+        $uid = (int)$usecase['uid'];
+
+        return [
+            'uid' => $uid,
+            'title' => (string)($usecase['title'] ?? ''),
+            'slug' => (string)($usecase['slug'] ?? ''),
+            'subtitle' => (string)($usecase['subtitle'] ?? ''),
+            'teaser' => (string)($usecase['teaser'] ?? ''),
+            'description' => (string)($usecase['description'] ?? ''),
+            'singlepid' => (string)($usecase['singlepid'] ?? ''),
+            'hideonapp' => (bool)($usecase['hideonapp'] ?? false),
+            'hideonwebsite' => (bool)($usecase['hideonwebsite'] ?? false),
+            'categories' => $this->getUsecaseCategories($uid),
+            'caseimage' => $this->getUsecaseImage($uid, 'caseimage'),
+            'logoimage' => $this->getUsecaseImage($uid, 'logoimage'),
+        ];
+    }
+
+    /**
+     * @return array<string,mixed>|null
+     */
+    protected function getUsecaseImage(int $usecaseUid, string $fieldName): ?array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_file_reference');
+
+        $fileRefData = $queryBuilder
+            ->select('sfr.uid', 'sfr.title', 'sfr.description', 'sfr.alternative', 'sfr.crop')
+            ->from('sys_file_reference', 'sfr')
+            ->where(
+                $queryBuilder->expr()->eq('sfr.tablenames', $queryBuilder->createNamedParameter('tx_vitec_domain_model_usecase', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('sfr.fieldname', $queryBuilder->createNamedParameter($fieldName, ParameterType::STRING)),
+                $queryBuilder->expr()->eq('sfr.uid_foreign', $queryBuilder->createNamedParameter($usecaseUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('sfr.deleted', 0),
+                $queryBuilder->expr()->eq('sfr.hidden', 0)
+            )
+            ->orderBy('sfr.sorting_foreign')
+            ->setMaxResults(1)
+            ->executeQuery()
+            ->fetchAssociative();
+
+        if (!$fileRefData) {
+            return null;
+        }
+
+        try {
+            $resourceFactory = GeneralUtility::makeInstance(ResourceFactory::class);
+            $imageService = GeneralUtility::makeInstance(ImageService::class);
+            $fileReference = $resourceFactory->getFileReferenceObject((int)$fileRefData['uid']);
+
+            $srcset = [];
+            foreach ([400, 800, 1200, 1600] as $width) {
+                $variant = $imageService->applyProcessingInstructions(
+                    $fileReference,
+                    ['width' => $width, 'crop' => $fileRefData['crop'] ?? null]
+                );
+                $srcset[] = [
+                    'url' => $imageService->getImageUri($variant),
+                    'width' => $width,
+                    'descriptor' => $width . 'w',
+                ];
+            }
+
+            $default = $imageService->applyProcessingInstructions(
+                $fileReference,
+                ['width' => 800, 'crop' => $fileRefData['crop'] ?? null]
+            );
+
+            return [
+                'uid' => (int)$fileRefData['uid'],
+                'url' => $imageService->getImageUri($default),
+                'title' => $fileRefData['title'] ?? '',
+                'alternative' => $fileRefData['alternative'] ?? '',
+                'description' => $fileRefData['description'] ?? '',
+                'srcset' => $srcset,
+                'properties' => [
+                    'width' => $fileReference->getProperty('width'),
+                    'height' => $fileReference->getProperty('height'),
+                    'mimeType' => $fileReference->getProperty('mime_type'),
+                ],
+            ];
+        } catch (\Exception $e) {
+            return null;
+        }
+    }
+
+    protected function getUsecaseCategories(int $usecaseUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_category');
+
+        $categories = $queryBuilder
+            ->select('c.uid', 'c.title', 'c.description')
+            ->from('sys_category', 'c')
+            ->join(
+                'c',
+                'sys_category_record_mm',
+                'mm',
+                'mm.uid_local = c.uid AND mm.tablenames = ' .
+                $queryBuilder->createNamedParameter('tx_vitec_domain_model_usecase', ParameterType::STRING) .
+                ' AND mm.fieldname = ' .
+                $queryBuilder->createNamedParameter('categories', ParameterType::STRING)
+            )
+            ->where(
+                $queryBuilder->expr()->eq('mm.uid_foreign', $queryBuilder->createNamedParameter($usecaseUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('c.deleted', 0),
+                $queryBuilder->expr()->eq('c.hidden', 0)
+            )
+            ->orderBy('mm.sorting', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        return array_map(static function ($cat) {
+            return [
+                'uid' => (int)$cat['uid'],
+                'title' => $cat['title'] ?? '',
+                'description' => $cat['description'] ?? '',
+            ];
+        }, $categories);
+    }
+}
@@ -0,0 +1,244 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Evomedien\Vitec\UserFunc;
+
+use Doctrine\DBAL\ParameterType;
+use TYPO3\CMS\Core\Database\Connection;
+use TYPO3\CMS\Core\Database\ConnectionPool;
+use TYPO3\CMS\Core\Resource\ResourceFactory;
+use TYPO3\CMS\Core\Service\FlexFormService;
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+use TYPO3\CMS\Extbase\Service\ImageService;
+
+/**
+ * UserFunc to render the usecase list as JSON for headless output.
+ *
+ * Mirrors ProductListJsonRenderer: Extbase repositories don't work in a
+ * UserFunc context (framework not bootstrapped), so tt_content and the
+ * usecase records are queried directly. Exception-safe: returns an empty
+ * string on any failure so headless `ifEmptyUnsetKey` can drop the key.
+ */
+class UsecaseListJsonRenderer
+{
+    public function render(string $content, array $conf): string
+    {
+        try {
+            $pageId = (int)($GLOBALS['TSFE']->id ?? 0);
+
+            // Find the vitec_usecaselist plugin on this page
+            $ttContentQb = GeneralUtility::makeInstance(ConnectionPool::class)
+                ->getQueryBuilderForTable('tt_content');
+
+            $contentElements = $ttContentQb
+                ->select('*')
+                ->from('tt_content')
+                ->where(
+                    $ttContentQb->expr()->eq('pid', $ttContentQb->createNamedParameter($pageId, ParameterType::INTEGER)),
+                    $ttContentQb->expr()->eq('list_type', $ttContentQb->createNamedParameter('vitec_usecaselist', ParameterType::STRING)),
+                    $ttContentQb->expr()->eq('deleted', 0),
+                    $ttContentQb->expr()->eq('hidden', 0)
+                )
+                ->executeQuery()
+                ->fetchAllAssociative();
+
+            if (empty($contentElements)) {
+                // Not a usecase-list page (or none configured): emit nothing
+                // so headless removes the key entirely.
+                return '';
+            }
+
+            $contentElement = $contentElements[0];
+
+            // Parse FlexForm (debug flag only; the list shows all visible usecases)
+            $flexFormService = GeneralUtility::makeInstance(FlexFormService::class);
+            $flexFormData = $flexFormService->convertFlexFormContentToArray($contentElement['pi_flexform'] ?? '');
+            $settings = $flexFormData['settings'] ?? [];
+            $debugMode = (bool)($settings['debug'] ?? false);
+
+            // Query visible usecases directly (Extbase unavailable in UserFunc)
+            $usecaseQb = GeneralUtility::makeInstance(ConnectionPool::class)
+                ->getQueryBuilderForTable('tx_vitec_domain_model_usecase');
+
+            $usecases = $usecaseQb
+                ->select('u.*')
+                ->from('tx_vitec_domain_model_usecase', 'u')
+                ->where(
+                    $usecaseQb->expr()->eq('u.deleted', 0),
+                    $usecaseQb->expr()->eq('u.hidden', 0),
+                    $usecaseQb->expr()->eq('u.hideonwebsite', 0)
+                )
+                ->orderBy('u.title', 'ASC')
+                ->executeQuery()
+                ->fetchAllAssociative();
+
+            $usecasesData = [];
+            foreach ($usecases as $usecase) {
+                $usecasesData[] = $this->serializeUsecase($usecase);
+            }
+
+            if ($debugMode) {
+                return json_encode([
+                    'usecases' => $usecasesData,
+                    'debug' => [
+                        'pageId' => $pageId,
+                        'usecaseCount' => count($usecasesData),
+                        'settings' => $settings,
+                    ],
+                ]);
+            }
+
+            return json_encode($usecasesData);
+        } catch (\Throwable $e) {
+            return '';
+        }
+    }
+
+    /**
+     * Serialize a single usecase DB row to the full headless JSON structure.
+     *
+     * Includes every field declared on the Usecase domain model
+     * (Evomedien\Vitec\Domain\Model\Usecase) plus all resolved relations
+     * (categories, caseimage, logoimage). Kept structurally analogous to
+     * ProductListJsonRenderer::serializeProduct().
+     *
+     * @param array<string,mixed> $usecase
+     * @return array<string,mixed>
+     */
+    protected function serializeUsecase(array $usecase): array
+    {
+        $uid = (int)$usecase['uid'];
+
+        return [
+            // --- identifier ---
+            'uid' => $uid,
+
+            // --- scalar string fields (Usecase domain model) ---
+            'title' => (string)($usecase['title'] ?? ''),
+            'slug' => (string)($usecase['slug'] ?? ''),
+            'subtitle' => (string)($usecase['subtitle'] ?? ''),
+            'teaser' => (string)($usecase['teaser'] ?? ''),
+            'description' => (string)($usecase['description'] ?? ''),
+            'singlepid' => (string)($usecase['singlepid'] ?? ''),
+
+            // --- boolean flags (Usecase domain model) ---
+            'hideonapp' => (bool)($usecase['hideonapp'] ?? false),
+            'hideonwebsite' => (bool)($usecase['hideonwebsite'] ?? false),
+
+            // --- fully resolved relations ---
+            'categories' => $this->getUsecaseCategories($uid),
+            'caseimage' => $this->getUsecaseImage($uid, 'caseimage'),
+            'logoimage' => $this->getUsecaseImage($uid, 'logoimage'),
+        ];
+    }
+
+    /**
+     * Resolve a single FAL image field (caseimage / logoimage) with srcset.
+     *
+     * @return array<string,mixed>|null
+     */
+    protected function getUsecaseImage(int $usecaseUid, string $fieldName): ?array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_file_reference');
+
+        $fileRefData = $queryBuilder
+            ->select('sfr.uid', 'sfr.title', 'sfr.description', 'sfr.alternative', 'sfr.crop')
+            ->from('sys_file_reference', 'sfr')
+            ->where(
+                $queryBuilder->expr()->eq('sfr.tablenames', $queryBuilder->createNamedParameter('tx_vitec_domain_model_usecase', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('sfr.fieldname', $queryBuilder->createNamedParameter($fieldName, ParameterType::STRING)),
+                $queryBuilder->expr()->eq('sfr.uid_foreign', $queryBuilder->createNamedParameter($usecaseUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('sfr.deleted', 0),
+                $queryBuilder->expr()->eq('sfr.hidden', 0)
+            )
+            ->orderBy('sfr.sorting_foreign')
+            ->setMaxResults(1)
+            ->executeQuery()
+            ->fetchAssociative();
+
+        if (!$fileRefData) {
+            return null;
+        }
+
+        try {
+            $resourceFactory = GeneralUtility::makeInstance(ResourceFactory::class);
+            $imageService = GeneralUtility::makeInstance(ImageService::class);
+            $fileReference = $resourceFactory->getFileReferenceObject((int)$fileRefData['uid']);
+
+            $sizes = [400, 800, 1200, 1600];
+            $srcset = [];
+            foreach ($sizes as $width) {
+                $processedVariant = $imageService->applyProcessingInstructions(
+                    $fileReference,
+                    ['width' => $width, 'crop' => $fileRefData['crop'] ?? null]
+                );
+                $srcset[] = [
+                    'url' => $imageService->getImageUri($processedVariant),
+                    'width' => $width,
+                    'descriptor' => $width . 'w',
+                ];
+            }
+
+            $default = $imageService->applyProcessingInstructions(
+                $fileReference,
+                ['width' => 800, 'crop' => $fileRefData['crop'] ?? null]
+            );
+
+            return [
+                'uid' => (int)$fileRefData['uid'],
+                'url' => $imageService->getImageUri($default),
+                'title' => $fileRefData['title'] ?? '',
+                'alternative' => $fileRefData['alternative'] ?? '',
+                'description' => $fileRefData['description'] ?? '',
+                'srcset' => $srcset,
+                'properties' => [
+                    'width' => $fileReference->getProperty('width'),
+                    'height' => $fileReference->getProperty('height'),
+                    'mimeType' => $fileReference->getProperty('mime_type'),
+                ],
+            ];
+        } catch (\Exception $e) {
+            return null;
+        }
+    }
+
+    /**
+     * Get categories for a usecase (resolved sys_category records).
+     */
+    protected function getUsecaseCategories(int $usecaseUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_category');
+
+        $categories = $queryBuilder
+            ->select('c.uid', 'c.title', 'c.description')
+            ->from('sys_category', 'c')
+            ->join(
+                'c',
+                'sys_category_record_mm',
+                'mm',
+                'mm.uid_local = c.uid AND mm.tablenames = ' .
+                $queryBuilder->createNamedParameter('tx_vitec_domain_model_usecase', ParameterType::STRING) .
+                ' AND mm.fieldname = ' .
+                $queryBuilder->createNamedParameter('categories', ParameterType::STRING)
+            )
+            ->where(
+                $queryBuilder->expr()->eq('mm.uid_foreign', $queryBuilder->createNamedParameter($usecaseUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('c.deleted', 0),
+                $queryBuilder->expr()->eq('c.hidden', 0)
+            )
+            ->orderBy('mm.sorting', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        return array_map(static function ($cat) {
+            return [
+                'uid' => (int)$cat['uid'],
+                'title' => $cat['title'] ?? '',
+                'description' => $cat['description'] ?? '',
+            ];
+        }, $categories);
+    }
+}
@@ -0,0 +1,265 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Evomedien\Vitec\UserFunc;
+
+use Doctrine\DBAL\ParameterType;
+use TYPO3\CMS\Core\Database\ConnectionPool;
+use TYPO3\CMS\Core\Resource\ResourceFactory;
+use TYPO3\CMS\Core\Service\FlexFormService;
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+use TYPO3\CMS\Extbase\Service\ImageService;
+
+/**
+ * UserFunc to render a single usecase as JSON for headless output.
+ *
+ * `render()` = page discovery (top-level plugin). `renderForRecord()` =
+ * one specific tt_content row, reused by ContainerChildrenProcessor for
+ * usecase-show plugins nested in a b13 container. Exception-safe.
+ */
+class UsecaseShowJsonRenderer
+{
+    public function render(string $content, array $conf): string
+    {
+        $pageId = (int)($GLOBALS['TSFE']->id ?? 0);
+
+        $ttContentQb = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('tt_content');
+
+        $contentElements = $ttContentQb
+            ->select('*')
+            ->from('tt_content')
+            ->where(
+                $ttContentQb->expr()->eq('pid', $ttContentQb->createNamedParameter($pageId, ParameterType::INTEGER)),
+                $ttContentQb->expr()->eq('list_type', $ttContentQb->createNamedParameter('vitec_usecaseshow', ParameterType::STRING)),
+                $ttContentQb->expr()->eq('deleted', 0),
+                $ttContentQb->expr()->eq('hidden', 0)
+            )
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        if (empty($contentElements)) {
+            return '';
+        }
+
+        return $this->renderForRecord($contentElements[0]);
+    }
+
+    /**
+     * @param array<string,mixed> $contentElement
+     */
+    public function renderForRecord(array $contentElement): string
+    {
+        try {
+            $pageId = (int)($GLOBALS['TSFE']->id ?? 0);
+
+            $flexFormService = GeneralUtility::makeInstance(FlexFormService::class);
+            $flexFormData = $flexFormService->convertFlexFormContentToArray($contentElement['pi_flexform'] ?? '');
+            $settings = $flexFormData['settings'] ?? [];
+
+            $usecaseUid = (int)($settings['usecase'] ?? 0);
+            $layout = (string)($settings['layout'] ?? 'default');
+            $debugMode = (bool)($settings['debug'] ?? false);
+
+            if (!$usecaseUid) {
+                $routeParams = $GLOBALS['TYPO3_REQUEST']->getQueryParams();
+                $usecaseParam = $routeParams['tx_vitec_usecaseshow']['usecase'] ?? null;
+
+                if ($usecaseParam) {
+                    if (!is_numeric($usecaseParam)) {
+                        $slugQb = GeneralUtility::makeInstance(ConnectionPool::class)
+                            ->getQueryBuilderForTable('tx_vitec_domain_model_usecase');
+                        $bySlug = $slugQb
+                            ->select('uid')
+                            ->from('tx_vitec_domain_model_usecase')
+                            ->where(
+                                $slugQb->expr()->eq('slug', $slugQb->createNamedParameter($usecaseParam)),
+                                $slugQb->expr()->eq('deleted', 0),
+                                $slugQb->expr()->eq('hidden', 0)
+                            )
+                            ->executeQuery()
+                            ->fetchAssociative();
+                        $usecaseUid = (int)($bySlug['uid'] ?? 0);
+                    } else {
+                        $usecaseUid = (int)$usecaseParam;
+                    }
+                }
+            }
+
+            if (!$usecaseUid) {
+                return $debugMode
+                    ? json_encode(['error' => 'No usecase selected or found', 'debug' => ['settings' => $settings]])
+                    : '';
+            }
+
+            $usecaseQb = GeneralUtility::makeInstance(ConnectionPool::class)
+                ->getQueryBuilderForTable('tx_vitec_domain_model_usecase');
+
+            $usecase = $usecaseQb
+                ->select('*')
+                ->from('tx_vitec_domain_model_usecase')
+                ->where(
+                    $usecaseQb->expr()->eq('uid', $usecaseQb->createNamedParameter($usecaseUid, ParameterType::INTEGER)),
+                    $usecaseQb->expr()->eq('deleted', 0),
+                    $usecaseQb->expr()->eq('hidden', 0)
+                )
+                ->executeQuery()
+                ->fetchAssociative();
+
+            if (!$usecase) {
+                return $debugMode
+                    ? json_encode(['error' => 'Usecase not found', 'debug' => ['usecaseUid' => $usecaseUid]])
+                    : '';
+            }
+
+            $response = [
+                'usecase' => $this->serializeUsecase($usecase),
+                'layout' => $layout,
+                'settings' => [
+                    'layout' => $layout,
+                ],
+            ];
+
+            if ($debugMode) {
+                $response['debug'] = [
+                    'pageId' => $pageId,
+                    'usecaseUid' => $usecaseUid,
+                    'layout' => $layout,
+                    'settings' => $settings,
+                ];
+            }
+
+            return json_encode($response);
+        } catch (\Throwable $e) {
+            return '';
+        }
+    }
+
+    /**
+     * @param array<string,mixed> $usecase
+     * @return array<string,mixed>
+     */
+    protected function serializeUsecase(array $usecase): array
+    {
+        $uid = (int)$usecase['uid'];
+
+        return [
+            'uid' => $uid,
+            'title' => (string)($usecase['title'] ?? ''),
+            'slug' => (string)($usecase['slug'] ?? ''),
+            'subtitle' => (string)($usecase['subtitle'] ?? ''),
+            'teaser' => (string)($usecase['teaser'] ?? ''),
+            'description' => (string)($usecase['description'] ?? ''),
+            'singlepid' => (string)($usecase['singlepid'] ?? ''),
+            'hideonapp' => (bool)($usecase['hideonapp'] ?? false),
+            'hideonwebsite' => (bool)($usecase['hideonwebsite'] ?? false),
+            'categories' => $this->getUsecaseCategories($uid),
+            'caseimage' => $this->getUsecaseImage($uid, 'caseimage'),
+            'logoimage' => $this->getUsecaseImage($uid, 'logoimage'),
+        ];
+    }
+
+    /**
+     * @return array<string,mixed>|null
+     */
+    protected function getUsecaseImage(int $usecaseUid, string $fieldName): ?array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_file_reference');
+
+        $fileRefData = $queryBuilder
+            ->select('sfr.uid', 'sfr.title', 'sfr.description', 'sfr.alternative', 'sfr.crop')
+            ->from('sys_file_reference', 'sfr')
+            ->where(
+                $queryBuilder->expr()->eq('sfr.tablenames', $queryBuilder->createNamedParameter('tx_vitec_domain_model_usecase', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('sfr.fieldname', $queryBuilder->createNamedParameter($fieldName, ParameterType::STRING)),
+                $queryBuilder->expr()->eq('sfr.uid_foreign', $queryBuilder->createNamedParameter($usecaseUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('sfr.deleted', 0),
+                $queryBuilder->expr()->eq('sfr.hidden', 0)
+            )
+            ->orderBy('sfr.sorting_foreign')
+            ->setMaxResults(1)
+            ->executeQuery()
+            ->fetchAssociative();
+
+        if (!$fileRefData) {
+            return null;
+        }
+
+        try {
+            $resourceFactory = GeneralUtility::makeInstance(ResourceFactory::class);
+            $imageService = GeneralUtility::makeInstance(ImageService::class);
+            $fileReference = $resourceFactory->getFileReferenceObject((int)$fileRefData['uid']);
+
+            $srcset = [];
+            foreach ([400, 800, 1200, 1600] as $width) {
+                $variant = $imageService->applyProcessingInstructions(
+                    $fileReference,
+                    ['width' => $width, 'crop' => $fileRefData['crop'] ?? null]
+                );
+                $srcset[] = [
+                    'url' => $imageService->getImageUri($variant),
+                    'width' => $width,
+                    'descriptor' => $width . 'w',
+                ];
+            }
+
+            $default = $imageService->applyProcessingInstructions(
+                $fileReference,
+                ['width' => 800, 'crop' => $fileRefData['crop'] ?? null]
+            );
+
+            return [
+                'uid' => (int)$fileRefData['uid'],
+                'url' => $imageService->getImageUri($default),
+                'title' => $fileRefData['title'] ?? '',
+                'alternative' => $fileRefData['alternative'] ?? '',
+                'description' => $fileRefData['description'] ?? '',
+                'srcset' => $srcset,
+                'properties' => [
+                    'width' => $fileReference->getProperty('width'),
+                    'height' => $fileReference->getProperty('height'),
+                    'mimeType' => $fileReference->getProperty('mime_type'),
+                ],
+            ];
+        } catch (\Exception $e) {
+            return null;
+        }
+    }
+
+    protected function getUsecaseCategories(int $usecaseUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_category');
+
+        $categories = $queryBuilder
+            ->select('c.uid', 'c.title', 'c.description')
+            ->from('sys_category', 'c')
+            ->join(
+                'c',
+                'sys_category_record_mm',
+                'mm',
+                'mm.uid_local = c.uid AND mm.tablenames = ' .
+                $queryBuilder->createNamedParameter('tx_vitec_domain_model_usecase', ParameterType::STRING) .
+                ' AND mm.fieldname = ' .
+                $queryBuilder->createNamedParameter('categories', ParameterType::STRING)
+            )
+            ->where(
+                $queryBuilder->expr()->eq('mm.uid_foreign', $queryBuilder->createNamedParameter($usecaseUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('c.deleted', 0),
+                $queryBuilder->expr()->eq('c.hidden', 0)
+            )
+            ->orderBy('mm.sorting', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        return array_map(static function ($cat) {
+            return [
+                'uid' => (int)$cat['uid'],
+                'title' => $cat['title'] ?? '',
+                'description' => $cat['description'] ?? '',
+            ];
+        }, $categories);
+    }
+}
@@ -0,0 +1,271 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Evomedien\Vitec\UserFunc;
+
+use Doctrine\DBAL\ParameterType;
+use TYPO3\CMS\Core\Database\ConnectionPool;
+use TYPO3\CMS\Core\Resource\ResourceFactory;
+use TYPO3\CMS\Core\Service\FlexFormService;
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+use TYPO3\CMS\Extbase\Service\ImageService;
+
+/**
+ * UserFunc to render a single usecase as JSON for headless output.
+ *
+ * Mirrors ProductShowJsonRenderer. Extbase repositories are unavailable in a
+ * UserFunc context, so tt_content and the usecase record are queried directly.
+ * Exception-safe: returns '' on any failure / when not applicable so headless
+ * `ifEmptyUnsetKey` drops the key entirely.
+ */
+class UsecaseShowJsonRenderer
+{
+    public function render(string $content, array $conf): string
+    {
+        try {
+            $pageId = (int)($GLOBALS['TSFE']->id ?? 0);
+
+            // Find the vitec_usecaseshow plugin on this page
+            $ttContentQb = GeneralUtility::makeInstance(ConnectionPool::class)
+                ->getQueryBuilderForTable('tt_content');
+
+            $contentElements = $ttContentQb
+                ->select('*')
+                ->from('tt_content')
+                ->where(
+                    $ttContentQb->expr()->eq('pid', $ttContentQb->createNamedParameter($pageId, ParameterType::INTEGER)),
+                    $ttContentQb->expr()->eq('list_type', $ttContentQb->createNamedParameter('vitec_usecaseshow', ParameterType::STRING)),
+                    $ttContentQb->expr()->eq('deleted', 0),
+                    $ttContentQb->expr()->eq('hidden', 0)
+                )
+                ->executeQuery()
+                ->fetchAllAssociative();
+
+            if (empty($contentElements)) {
+                return '';
+            }
+
+            $contentElement = $contentElements[0];
+
+            // Parse FlexForm
+            $flexFormService = GeneralUtility::makeInstance(FlexFormService::class);
+            $flexFormData = $flexFormService->convertFlexFormContentToArray($contentElement['pi_flexform'] ?? '');
+            $settings = $flexFormData['settings'] ?? [];
+
+            $usecaseUid = (int)($settings['usecase'] ?? 0);
+            $layout = (string)($settings['layout'] ?? 'default');
+            $debugMode = (bool)($settings['debug'] ?? false);
+
+            // Fall back to route / query parameter (uid or slug)
+            if (!$usecaseUid) {
+                $routeParams = $GLOBALS['TYPO3_REQUEST']->getQueryParams();
+                $usecaseParam = $routeParams['tx_vitec_usecaseshow']['usecase'] ?? null;
+
+                if ($usecaseParam) {
+                    if (!is_numeric($usecaseParam)) {
+                        $slugQb = GeneralUtility::makeInstance(ConnectionPool::class)
+                            ->getQueryBuilderForTable('tx_vitec_domain_model_usecase');
+                        $bySlug = $slugQb
+                            ->select('uid')
+                            ->from('tx_vitec_domain_model_usecase')
+                            ->where(
+                                $slugQb->expr()->eq('slug', $slugQb->createNamedParameter($usecaseParam)),
+                                $slugQb->expr()->eq('deleted', 0),
+                                $slugQb->expr()->eq('hidden', 0)
+                            )
+                            ->executeQuery()
+                            ->fetchAssociative();
+                        $usecaseUid = (int)($bySlug['uid'] ?? 0);
+                    } else {
+                        $usecaseUid = (int)$usecaseParam;
+                    }
+                }
+            }
+
+            if (!$usecaseUid) {
+                return $debugMode
+                    ? json_encode(['error' => 'No usecase selected or found', 'debug' => ['settings' => $settings]])
+                    : '';
+            }
+
+            // Query the usecase
+            $usecaseQb = GeneralUtility::makeInstance(ConnectionPool::class)
+                ->getQueryBuilderForTable('tx_vitec_domain_model_usecase');
+
+            $usecase = $usecaseQb
+                ->select('*')
+                ->from('tx_vitec_domain_model_usecase')
+                ->where(
+                    $usecaseQb->expr()->eq('uid', $usecaseQb->createNamedParameter($usecaseUid, ParameterType::INTEGER)),
+                    $usecaseQb->expr()->eq('deleted', 0),
+                    $usecaseQb->expr()->eq('hidden', 0)
+                )
+                ->executeQuery()
+                ->fetchAssociative();
+
+            if (!$usecase) {
+                return $debugMode
+                    ? json_encode(['error' => 'Usecase not found', 'debug' => ['usecaseUid' => $usecaseUid]])
+                    : '';
+            }
+
+            $response = [
+                'usecase' => $this->serializeUsecase($usecase),
+                'layout' => $layout,
+                'settings' => [
+                    'layout' => $layout,
+                ],
+            ];
+
+            if ($debugMode) {
+                $response['debug'] = [
+                    'pageId' => $pageId,
+                    'usecaseUid' => $usecaseUid,
+                    'layout' => $layout,
+                    'settings' => $settings,
+                ];
+            }
+
+            return json_encode($response);
+        } catch (\Throwable $e) {
+            return '';
+        }
+    }
+
+    /**
+     * Serialize a single usecase DB row. Structurally identical to
+     * UsecaseListJsonRenderer::serializeUsecase() so list and detail
+     * endpoints expose the same usecase schema.
+     *
+     * @param array<string,mixed> $usecase
+     * @return array<string,mixed>
+     */
+    protected function serializeUsecase(array $usecase): array
+    {
+        $uid = (int)$usecase['uid'];
+
+        return [
+            'uid' => $uid,
+            'title' => (string)($usecase['title'] ?? ''),
+            'slug' => (string)($usecase['slug'] ?? ''),
+            'subtitle' => (string)($usecase['subtitle'] ?? ''),
+            'teaser' => (string)($usecase['teaser'] ?? ''),
+            'description' => (string)($usecase['description'] ?? ''),
+            'singlepid' => (string)($usecase['singlepid'] ?? ''),
+            'hideonapp' => (bool)($usecase['hideonapp'] ?? false),
+            'hideonwebsite' => (bool)($usecase['hideonwebsite'] ?? false),
+            'categories' => $this->getUsecaseCategories($uid),
+            'caseimage' => $this->getUsecaseImage($uid, 'caseimage'),
+            'logoimage' => $this->getUsecaseImage($uid, 'logoimage'),
+        ];
+    }
+
+    /**
+     * Resolve a single FAL image field (caseimage / logoimage) with srcset.
+     *
+     * @return array<string,mixed>|null
+     */
+    protected function getUsecaseImage(int $usecaseUid, string $fieldName): ?array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_file_reference');
+
+        $fileRefData = $queryBuilder
+            ->select('sfr.uid', 'sfr.title', 'sfr.description', 'sfr.alternative', 'sfr.crop')
+            ->from('sys_file_reference', 'sfr')
+            ->where(
+                $queryBuilder->expr()->eq('sfr.tablenames', $queryBuilder->createNamedParameter('tx_vitec_domain_model_usecase', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('sfr.fieldname', $queryBuilder->createNamedParameter($fieldName, ParameterType::STRING)),
+                $queryBuilder->expr()->eq('sfr.uid_foreign', $queryBuilder->createNamedParameter($usecaseUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('sfr.deleted', 0),
+                $queryBuilder->expr()->eq('sfr.hidden', 0)
+            )
+            ->orderBy('sfr.sorting_foreign')
+            ->setMaxResults(1)
+            ->executeQuery()
+            ->fetchAssociative();
+
+        if (!$fileRefData) {
+            return null;
+        }
+
+        try {
+            $resourceFactory = GeneralUtility::makeInstance(ResourceFactory::class);
+            $imageService = GeneralUtility::makeInstance(ImageService::class);
+            $fileReference = $resourceFactory->getFileReferenceObject((int)$fileRefData['uid']);
+
+            $srcset = [];
+            foreach ([400, 800, 1200, 1600] as $width) {
+                $variant = $imageService->applyProcessingInstructions(
+                    $fileReference,
+                    ['width' => $width, 'crop' => $fileRefData['crop'] ?? null]
+                );
+                $srcset[] = [
+                    'url' => $imageService->getImageUri($variant),
+                    'width' => $width,
+                    'descriptor' => $width . 'w',
+                ];
+            }
+
+            $default = $imageService->applyProcessingInstructions(
+                $fileReference,
+                ['width' => 800, 'crop' => $fileRefData['crop'] ?? null]
+            );
+
+            return [
+                'uid' => (int)$fileRefData['uid'],
+                'url' => $imageService->getImageUri($default),
+                'title' => $fileRefData['title'] ?? '',
+                'alternative' => $fileRefData['alternative'] ?? '',
+                'description' => $fileRefData['description'] ?? '',
+                'srcset' => $srcset,
+                'properties' => [
+                    'width' => $fileReference->getProperty('width'),
+                    'height' => $fileReference->getProperty('height'),
+                    'mimeType' => $fileReference->getProperty('mime_type'),
+                ],
+            ];
+        } catch (\Exception $e) {
+            return null;
+        }
+    }
+
+    /**
+     * Get categories for a usecase (resolved sys_category records).
+     */
+    protected function getUsecaseCategories(int $usecaseUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_category');
+
+        $categories = $queryBuilder
+            ->select('c.uid', 'c.title', 'c.description')
+            ->from('sys_category', 'c')
+            ->join(
+                'c',
+                'sys_category_record_mm',
+                'mm',
+                'mm.uid_local = c.uid AND mm.tablenames = ' .
+                $queryBuilder->createNamedParameter('tx_vitec_domain_model_usecase', ParameterType::STRING) .
+                ' AND mm.fieldname = ' .
+                $queryBuilder->createNamedParameter('categories', ParameterType::STRING)
+            )
+            ->where(
+                $queryBuilder->expr()->eq('mm.uid_foreign', $queryBuilder->createNamedParameter($usecaseUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('c.deleted', 0),
+                $queryBuilder->expr()->eq('c.hidden', 0)
+            )
+            ->orderBy('mm.sorting', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        return array_map(static function ($cat) {
+            return [
+                'uid' => (int)$cat['uid'],
+                'title' => $cat['title'] ?? '',
+                'description' => $cat['description'] ?? '',
+            ];
+        }, $categories);
+    }
+}