diff --git a/.cursorrules b/.cursorrules
index 172788d..85bb12d 100644
--- a/.cursorrules
+++ b/.cursorrules
@@ -17,6 +17,7 @@ Zanim napiszesz JAKIEKOLWIEK zapytanie SQL, sprawd┼║ plik ze struktur─ů bazy! ZA
 - **Macierz Cenowa:** NIGDY nie szukaj ceny w `sh_menu_items`. U┼╝ywaj `sh_price_tiers` (`target_type`, `target_sku`, `channel`).
 - **Modyfikatory:** `sh_modifiers` ┼é─ůczy si─Ö z magazynem przez `linked_warehouse_sku` i `linked_quantity`.
 - **Magazyn:** `sys_items` (słownik, klucz `sku`) oraz `wh_stock` (stany rzeczywiste).
+- **Silosy prefiksowe:** baza jest podzielona na trzy izolowane silosy (`sh_` biznes, `sys_` s┼éownik surowc├│w, `wh_` magazyn). Po┼é─ůczenia MI─śDZY silosami TYLKO przez klucze znakowe ÔÇö patrz ┬ž9.
 
 ## 2. ┼╗ELAZNA ZASADA IZOLACJI (Multi-Tenancy)
 - System jest architektur─ů wielonajemcow─ů.
@@ -28,7 +29,7 @@ Zanim napiszesz JAKIEKOLWIEK zapytanie SQL, sprawd┼║ plik ze struktur─ů bazy! ZA
 - **ABSOLUTNY ZAKAZ:** Node.js, npm, Webpack, React, Vue, Angular, jQuery.
 
 ## 4. ARCHITEKTURA I MODU┼üOWO┼Ü─ć ("Klocki Lego")
-- **Zasada 1=1:** Jeden moduł biznesowy = Jeden plik API (np. `api_warehouse.php`, `api_menu_studio.php`). 
+- **Zasada 1=1:** Jeden moduł biznesowy = spójna warstwa API (np. `api/warehouse/*.php`, `api/backoffice/api_menu_studio.php`). 
 - Routing na backendzie obs┼éugiwany wy┼é─ůcznie przez instrukcj─Ö `switch($action)`.
 
 ## 5. STANDARD KOMUNIKACJI API
@@ -40,4 +41,77 @@ Zanim napiszesz JAKIEKOLWIEK zapytanie SQL, sprawd┼║ plik ze struktur─ů bazy! ZA
 - **Alert 86:** Wszelkie stany r├│wne 0 lub ujemne wyr├│┼╝niaj kolorem (`text-red-500 font-bold`).
 
 ## 7. ZASADA SNAJPERA (Edycja Kodu)
-- Kiedy jeste┼Ť proszony o popraw─Ö b┼é─Ödu, dzia┼éaj PUNKTOWO. Nie refaktoryzuj ca┼éych plik├│w, nie pisz nowych test├│w, chyba ┼╝e u┼╝ytkownik wyda┼é na to rozkaz.
\ No newline at end of file
+- Kiedy jeste┼Ť proszony o popraw─Ö b┼é─Ödu, dzia┼éaj PUNKTOWO. Nie refaktoryzuj ca┼éych plik├│w, nie pisz nowych test├│w, chyba ┼╝e u┼╝ytkownik wyda┼é na to rozkaz.
+
+## 8. ARCHITEKTURA LOGISTYKI & DOSTAW
+### Silnik: `api/courses/engine.php`
+Unified REST API (POST, action-based) obs┼éuguj─ůcy Dispatcher i Driver App.
+Akcje: `get_dashboard`, `dispatch`, `update_order_status`, `cancel_stop`, `start_shift`, `update_location`, `get_driver_runs`, `set_initial_cash`, `reconcile`, `set_driver_status`, `collect_payment`, `deliver_order`, `emergency_recall`, `check_recall`, `clear_recall`, `get_driver_wallet`.
+
+### Payment Lock (KRYTYCZNE)
+Kierowca NIE MO┼╗E oznaczy─ç zam├│wienia jako "Dostarczono" je┼Ťli `payment_status != 'paid'`. Musi najpierw wywo┼éa─ç `collect_payment` (cash|card). Zam├│wienia op┼éacone online maj─ů `payment_status='paid'` od pocz─ůtku Ôćĺ one-click deliver.
+
+### K-System & L-Queues
+- Kurs: `K{n}` ÔÇö dzienny sekwencyjny numer kursu per tenant (tabela `sh_course_sequences`).
+- Przystanek: `L{n}` ÔÇö numer kolejny w kursie.
+- Kierowca: `available` Ôćĺ `busy` (po dispatch) Ôćĺ `available` (po zako┼äczeniu kursu).
+
+### Emergency Recall
+Dyspozytor Ôćĺ `emergency_recall` Ôćĺ ustawia `heading = -999` w `sh_driver_locations` Ôćĺ Driver App polluje `check_recall` Ôćĺ flash red overlay z wibracjami Ôćĺ `clear_recall` po potwierdzeniu.
+
+### Moduły Frontend
+- **Dispatcher:** `/modules/courses/` (Vanilla JS, Leaflet, Dark Glass theme)
+- **Driver PWA:** `/modules/driver_app/` (Vanilla JS, 56px touch targets, safe-area-inset)
+
+## 9. IZOLACJA SILOS├ôW PREFIKSOWYCH (┼ÜWI─śTO┼Ü─ć)
+Baza jest podzielona na trzy izolowane silosy po prefiksie. Ka┼╝dy silos ma w┼éasny ┼Ťwiat numerycznych ID i NIE WOLNO ich miesza─ç mi─Ödzy silosami.
+
+### Silosy
+| Prefiks | Domena | Przykładowe tabele |
+|---------|--------|---------------------|
+| `sh_`   | Biznes SliceHub (menu, orders, users, drivers, modyfikatory, receptury, promocje, tables, price_tiers) | `sh_menu_items`, `sh_orders`, `sh_order_lines`, `sh_recipes`, `sh_modifiers`, `sh_users`, `sh_drivers`, `sh_price_tiers`, `sh_product_mapping` |
+| `sys_`  | S┼éownik surowc├│w (master data magazynowe ÔÇö nazwa, jednostka, kategoria) | `sys_items` |
+| `wh_`   | Magazyn rzeczywisty (stany, dokumenty, linie, ruchy) | `wh_stock`, `wh_documents`, `wh_document_lines` |
+
+### Zasada ┼╝elazna
+- Ôťů **Wewn─ůtrz jednego silosu** ÔÇö JOIN-y po numerycznym `id` s─ů OK (np. `sh_orders.id = sh_order_lines.order_id`, `wh_documents.id = wh_document_lines.document_id`).
+- ÔŁî **BEZWZGL─śDNY ZAKAZ** JOIN-a / UPDATE-a mi─Ödzy silosami po numerycznym `id` (np. `sh_orders.id = wh_stock.something_id`, `sh_menu_items.id = sys_items.item_id`). Takie FK nie mog─ů nawet istnie─ç w schemacie.
+- Ôťů **Cross-silo ┼é─ůczy si─Ö WY┼ü─äCZNIE przez klucze znakowe**:
+  - `sku` (VARCHAR) ÔÇö most mi─Ödzy `sh_` Ôćö `sys_` Ôćö `wh_`.
+  - `ascii_key` (VARCHAR) ÔÇö most w obr─Öbie `sh_` (menu Ôćö modifiers Ôćö price_tiers).
+
+### Referencyjne wzorce (TAK ÔÇö r├│b tak)
+```sql
+-- sh_ Ôćĺ sys_: ┼é─ůczenie receptury ze s┼éownikiem surowc├│w przez SKU
+FROM sh_recipes r
+JOIN sys_items s ON s.sku = r.warehouse_sku AND s.tenant_id = r.tenant_id
+
+-- sh_ Ôćĺ wh_: pobranie AVCO dla sk┼éadnika receptury przez SKU
+FROM sh_recipes r
+LEFT JOIN wh_stock ws ON ws.sku = r.warehouse_sku AND ws.tenant_id = r.tenant_id
+
+-- sh_ Ôćĺ wh_: pobranie AVCO dla modyfikatora przez SKU
+FROM sh_modifiers m
+LEFT JOIN wh_stock ws ON ws.sku = m.linked_warehouse_sku AND ws.tenant_id = :tid
+
+-- sys_ Ôćĺ wh_: widok stan├│w magazynowych z nazw─ů z dictionary
+FROM sys_items s
+LEFT JOIN wh_stock w ON w.sku = s.sku AND w.tenant_id = s.tenant_id
+```
+
+### Antywzorce (NIE ÔÇö nigdy)
+```sql
+-- ÔŁî NIE: numeryczny FK cross-silo
+JOIN wh_stock ws ON ws.item_id = mi.id          -- sh_menu_items.id Ôćĺ wh_
+JOIN sys_items s ON s.id = r.sys_item_id         -- sh_recipes Ôćĺ sys_items.id
+UPDATE sh_orders o JOIN wh_stock w ON w.id = o.warehouse_stock_id  -- cross-silo UPDATE
+```
+
+### Bariera tenant_id w cross-silo JOIN
+Ka┼╝dy most SKU MUSI mie─ç dodatkowy warunek `tenant_id` po obu stronach (┬ž2 + ┬ž9 ┼é─ůcznie):
+```sql
+JOIN sys_items s ON s.sku = r.warehouse_sku AND s.tenant_id = r.tenant_id
+```
+
+### Obowi─ůzek przy dodawaniu nowego prefiksu
+Je┼Ťli w przysz┼éo┼Ťci powstanie nowy silos (np. `pay_`, `log_`, `aud_`), automatycznie obowi─ůzuje tu ta sama regu┼éa: most tylko przez klucze znakowe, nigdy po ID.
\ No newline at end of file
diff --git a/Untitled b/Untitled
deleted file mode 100644
index 5240204..0000000
--- a/Untitled
+++ /dev/null
@@ -1 +0,0 @@
-03_MAPA_KOPALNI
\ No newline at end of file
diff --git a/_KOPALNIA_WIEDZY_LEGACY/api_pos.php b/_KOPALNIA_WIEDZY_LEGACY/api_pos.php
deleted file mode 100644
index 9d44181..0000000
--- a/_KOPALNIA_WIEDZY_LEGACY/api_pos.php
+++ /dev/null
@@ -1,349 +0,0 @@
-<?php
-// ­čŤí´ŞĆ SLICEHUB POS API v6.5 ULTIMATE - THE MONSTER ENGINE
-require_once 'db_connect.php';
-
-function sendResponse($status, $payload = [], $errorMsg = null) {
-    echo json_encode(['status' => $status, 'payload' => $payload, 'error' => $errorMsg]);
-    exit;
-}
-
-// ­čÜĘ POPRAWKA 1: Pozwalamy te┼╝ roli 'driver' na dost─Öp do POS
-require_role(['waiter', 'admin', 'manager', 'owner', 'driver']);
-
-$user_id = $_SESSION['user_id'] ?? 0;
-$tenant_id = $_SESSION['tenant_id'] ?? 0;
-
-// ­čÜĘ POPRAWKA 2: Pobieranie akcji z inputu (TEGO BRAKOWA┼üO!)
-$action = $input['action'] ?? $_GET['action'] ?? '';
-
-function generate_uuid() {
-    return sprintf( '%04x%04x-%04x-%04x-%04x-%04x%04x%04x', mt_rand( 0, 0xffff ), mt_rand( 0, 0xffff ), mt_rand( 0, 0xffff ), mt_rand( 0, 0x0fff ) | 0x4000, mt_rand( 0, 0x3fff ) | 0x8000, mt_rand( 0, 0xffff ), mt_rand( 0, 0xffff ), mt_rand( 0, 0xffff ) );
-}
-
-// ­čÜÇ AUTO-MIGRACJA BAZY DANYCH (Niezb─Ödne dla K-Systemu, L-Kolejek i Po┼é├│wek)
-try { $pdo->exec("ALTER TABLE sh_orders ADD COLUMN receipt_printed TINYINT(1) NOT NULL DEFAULT 0"); } catch (Exception $e) {}
-try { $pdo->exec("ALTER TABLE sh_orders ADD COLUMN kitchen_ticket_printed TINYINT(1) NOT NULL DEFAULT 0"); } catch (Exception $e) {}
-try { $pdo->exec("ALTER TABLE sh_orders ADD COLUMN edited_since_print TINYINT(1) NOT NULL DEFAULT 0"); } catch (Exception $e) {}
-try { $pdo->exec("ALTER TABLE sh_orders ADD COLUMN is_half TINYINT(1) NOT NULL DEFAULT 0"); } catch (Exception $e) {}
-try { $pdo->exec("ALTER TABLE sh_order_items ADD COLUMN is_half TINYINT(1) NOT NULL DEFAULT 0"); } catch (Exception $e) {}
-try { $pdo->exec("ALTER TABLE sh_order_items ADD COLUMN half_a_id INT DEFAULT NULL"); } catch (Exception $e) {}
-try { $pdo->exec("ALTER TABLE sh_order_items ADD COLUMN half_b_id INT DEFAULT NULL"); } catch (Exception $e) {}
-try { $pdo->exec("ALTER TABLE sh_orders ADD COLUMN course_id VARCHAR(20) DEFAULT NULL"); } catch (Exception $e) {}
-try { $pdo->exec("ALTER TABLE sh_orders ADD COLUMN stop_number VARCHAR(10) DEFAULT NULL"); } catch (Exception $e) {}
-
-if ($action === 'get_init_data') {
-    $data = [
-        'categories' => $pdo->prepare("SELECT id, name AS name_utf8 FROM sh_categories WHERE tenant_id = ? AND is_menu = 1 ORDER BY display_order ASC"),
-        'items' => $pdo->prepare("SELECT id, category_id, name, price, type FROM sh_menu_items WHERE tenant_id = ? AND is_deleted = 0"),
-        'tables' => $pdo->prepare("SELECT id, table_number FROM sh_tables WHERE tenant_id = ?"),
-        'ingredients' => $pdo->prepare("SELECT id, name, unit FROM sh_products WHERE tenant_id = ? AND is_active = 1"),
-        
-        // ­čÜĘ NAPRAWA ID KIEROWCY (u.id) ORAZ IMIENIA (NULLIF)
-        'drivers' => $pdo->prepare("SELECT u.id, d.status, d.initial_cash, COALESCE(NULLIF(u.first_name, ''), u.username) AS first_name FROM sh_drivers d JOIN sh_users u ON d.user_id = u.id WHERE u.tenant_id = ?"),
-        
-        // ­čÜĘ NAPRAWA IMIENIA KELNERA
-        'waiters' => $pdo->prepare("SELECT id, COALESCE(NULLIF(first_name, ''), username) AS first_name FROM sh_users WHERE tenant_id = ? AND role = 'waiter' AND is_active = 1")
-    ];
-    foreach($data as $k => $stmt) { $stmt->execute([$tenant_id]); $data[$k] = $stmt->fetchAll(); }
-    sendResponse('success', $data);
-}
-
-if ($action === 'get_orders') {
-    // Zwraca zam├│wienia wraz z K-System i L-Kolejkami
-    $stmt = $pdo->prepare("
-        SELECT o.*, u.first_name as creator_name 
-        FROM sh_orders o 
-        LEFT JOIN sh_users u ON o.created_by = u.id 
-        WHERE o.tenant_id = ? AND o.status NOT IN ('completed', 'cancelled') 
-        ORDER BY COALESCE(o.promised_time, o.created_at) ASC
-    ");
-    $stmt->execute([$tenant_id]);
-    sendResponse('success', ['orders' => $stmt->fetchAll()]);
-}
-
-if ($action === 'get_item_details') {
-    $item_id = (int)($_GET['item_id'] ?? $input['item_id'] ?? 0);
-    $half_b_id = (int)($_GET['half_b_id'] ?? $input['half_b_id'] ?? 0);
-    $stmt = $pdo->prepare("SELECT p.id as product_id, p.name as name_utf8 FROM sh_recipes r JOIN sh_products p ON r.product_id = p.id WHERE r.menu_item_id = ?");
-    $stmt->execute([$item_id]); $ingA = $stmt->fetchAll(); foreach($ingA as &$i) $i['half'] = 'A';
-    $ingredients = $ingA;
-    if ($half_b_id > 0) { $stmt->execute([$half_b_id]); $ingB = $stmt->fetchAll(); foreach($ingB as &$i) $i['half'] = 'B'; $ingredients = array_merge($ingredients, $ingB); }
-    sendResponse('success', ['ingredients' => $ingredients]);
-}
-if ($action === 'process_order') {
-    $edit_id = (int)($input['edit_order_id'] ?? 0);
-    $cart = $input['cart'] ?? [];
-    $new_cart_json = json_encode($cart);
-    $promised = $input['custom_datetime'] ? date('Y-m-d H:i:s', strtotime($input['custom_datetime'])) : date('Y-m-d H:i:s');
-    $print_kitchen = (int)($input['print_kitchen'] ?? 0);
-    
-    $source = $input['source'] ?? 'local';
-    
-    // TWARDA REGUŁA: Zawsze pending na start, chyba że to kelner (new)
-    $initial_status = $input['status'] ?? 'pending'; 
-    if ($source === 'waiter' && $initial_status === 'new') { $print_kitchen = 0; }
-
-    try {
-        $pdo->beginTransaction();
-        $warehouse_id = 2; 
-        
-        $stmtUnits = $pdo->prepare("SELECT id, unit FROM sh_products WHERE tenant_id = ?");
-        $stmtUnits->execute([$tenant_id]);
-        $productUnits = [];
-        foreach($stmtUnits->fetchAll() as $row) { $productUnits[$row['id']] = strtolower(trim($row['unit'])); }
-        $stmtRecipe = $pdo->prepare("SELECT product_id, quantity, waste_percent FROM sh_recipes WHERE menu_item_id = ?");
-
-        if ($edit_id > 0) {
-            // EDYCJA ZAMÓWIENIA (Wykrywanie Zmian na Kuchnię)
-            $stmtOld = $pdo->prepare("SELECT cart_json, edited_since_print, kitchen_changes FROM sh_orders WHERE id = ? AND tenant_id = ?");
-            $stmtOld->execute([$edit_id, $tenant_id]);
-            $oldOrder = $stmtOld->fetch();
-            
-            $edited_flag = $oldOrder['edited_since_print'] ?? 0;
-            $kitchen_changes = $oldOrder['kitchen_changes'] ?? '';
-            
-            if ($oldOrder && !empty($oldOrder['cart_json'])) {
-                if ($oldOrder['cart_json'] !== $new_cart_json) {
-                    $edited_flag = 1; // Wyzwala żółty alarm
-                    $diff_arr = [];
-                    $oldCart = json_decode($oldOrder['cart_json'], true);
-                    $oldMap = []; foreach($oldCart as $c) { $oldMap[$c['cart_id']] = $c; }
-                    $newMap = []; foreach($cart as $c) { $newMap[$c['cart_id']] = $c; }
-                    
-                    foreach($newMap as $cid => $c) {
-                        if(!isset($oldMap[$cid])) { $diff_arr[] = "DODANO: " . $c['qty'] . "x " . $c['name']; } 
-                        else {
-                            if($oldMap[$cid]['qty'] != $c['qty']) { $diff_arr[] = "ZMIENIONO ILO┼Ü─ć: " . $c['name'] . " (" . $oldMap[$cid]['qty'] . " -> " . $c['qty'] . ")"; }
-                            if(($oldMap[$cid]['comment'] ?? '') != ($c['comment'] ?? '')) { $diff_arr[] = "ZMIENIONO UWAGI DO: " . $c['name']; }
-                        }
-                    }
-                    foreach($oldMap as $cid => $oc) {
-                        if(!isset($newMap[$cid])) { $diff_arr[] = "USUNI─śTO: " . $oc['qty'] . "x " . $oc['name']; }
-                    }
-                    $kitchen_changes = implode(" | ", $diff_arr);
-                }
-
-                // Zwracanie starego towaru (Logika magazynowa)
-                $oldCart = json_decode($oldOrder['cart_json'], true);
-                if (is_array($oldCart)) {
-                    $stmtUpdateStockReturn = $pdo->prepare("UPDATE sh_stock_levels SET quantity = quantity + ? WHERE warehouse_id = ? AND product_id = ?");
-                    $stmtLogReturn = $pdo->prepare("INSERT INTO sh_inventory_logs (product_id, user_id, quantity_changed, action_type) VALUES (?, ?, ?, 'POS_EDIT_RETURN')");
-                    foreach ($oldCart as $item) {
-                        $qty_sold = (float)$item['qty']; $products_to_return = []; $removed_ids = $item['removed'] ?? [];
-                        $calcRecipe = function($menu_id, $multiplier) use ($stmtRecipe, &$products_to_return, $removed_ids) {
-                            if(!$menu_id) return; $stmtRecipe->execute([$menu_id]);
-                            foreach ($stmtRecipe->fetchAll() as $ing) {
-                                $pid = $ing['product_id']; if (in_array($pid, $removed_ids)) continue;
-                                $needed = ($ing['quantity'] * (1 + ($ing['waste_percent'] / 100))) * $multiplier;
-                                if (!isset($products_to_return[$pid])) $products_to_return[$pid] = 0; $products_to_return[$pid] += $needed;
-                            }
-                        };
-                        if (!empty($item['is_half'])) { $calcRecipe($item['half_a'], 0.5 * $qty_sold); $calcRecipe($item['half_b'], 0.5 * $qty_sold); } 
-                        else { $calcRecipe($item['id'], 1.0 * $qty_sold); }
-                        if (!empty($item['added'])) {
-                            foreach ($item['added'] as $added_pid) {
-                                $unit = $productUnits[$added_pid] ?? 'szt'; $extra_qty = 1.0; 
-                                if (in_array($unit, ['kg', 'litr', 'l'])) $extra_qty = 0.05;
-                                if (!isset($products_to_return[$added_pid])) $products_to_return[$added_pid] = 0;
-                                $products_to_return[$added_pid] += ($extra_qty * $qty_sold);
-                            }
-                        }
-                        foreach ($products_to_return as $pid => $return_qty) {
-                            $stmtUpdateStockReturn->execute([$return_qty, $warehouse_id, $pid]);
-                            $stmtLogReturn->execute([$pid, $user_id, $return_qty]);
-                        }
-                    }
-                }
-            }
-            $pdo->prepare("DELETE FROM sh_order_items WHERE order_id = ?")->execute([$edit_id]);
-            
-            if ($print_kitchen === 1 && $source === 'local') { $edited_flag = 0; $kitchen_changes = ''; }
-
-            $stmt = $pdo->prepare("UPDATE sh_orders SET type=?, payment_method=?, payment_status=?, total_price=?, address=?, customer_phone=?, nip=?, cart_json=?, promised_time=?, edited_since_print=?, kitchen_changes=? WHERE id=? AND tenant_id=?");
-            $stmt->execute([$input['order_type'], $input['payment_method'], $input['payment_status'], $input['total_price'], $input['address'], $input['customer_phone'], $input['nip'] ?? '', $new_cart_json, $promised, $edited_flag, $kitchen_changes, $edit_id, $tenant_id]);
-            $order_id = $edit_id;
-        } else {
-            // NOWE ZAMÓWIENIE - CODZIENNY RESET NUMERACJI
-            $uuid = generate_uuid();
-            $stmtSeq = $pdo->prepare("SELECT COUNT(*) FROM sh_orders WHERE tenant_id = ? AND DATE(created_at) = CURDATE()");
-            $stmtSeq->execute([$tenant_id]);
-            $seq = $stmtSeq->fetchColumn() + 1;
-            $order_number = 'ORD/' . date('Ymd') . '/' . str_pad($seq, 3, '0', STR_PAD_LEFT);
-            
-            $stmt = $pdo->prepare("INSERT INTO sh_orders (tenant_id, uuid, order_number, source, type, status, payment_method, payment_status, total_price, address, customer_phone, nip, cart_json, promised_time, kitchen_ticket_printed, created_by, created_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, NOW())");
-            $stmt->execute([$tenant_id, $uuid, $order_number, $source, $input['order_type'], $initial_status, $input['payment_method'], $input['payment_status'], $input['total_price'], $input['address'], $input['customer_phone'], $input['nip'] ?? '', $new_cart_json, $promised, $print_kitchen, $user_id]);
-            $order_id = $pdo->lastInsertId();
-        }
-
-        // POBIERANIE NOWEGO TOWARU Z MAGAZYNU
-        $stmtUpdateStock = $pdo->prepare("UPDATE sh_stock_levels SET quantity = quantity - ? WHERE warehouse_id = ? AND product_id = ?");
-        $stmtInsertStock = $pdo->prepare("INSERT INTO sh_stock_levels (warehouse_id, product_id, quantity) VALUES (?, ?, ?)");
-        $stmtLog = $pdo->prepare("INSERT INTO sh_inventory_logs (product_id, user_id, quantity_changed, action_type) VALUES (?, ?, ?, 'POS_SALE')");
-        foreach ($cart as $item) {
-            $qty_sold = (float)$item['qty'];
-            $stmtItem = $pdo->prepare("INSERT INTO sh_order_items (order_id, menu_item_id, snapshot_name, quantity, unit_price) VALUES (?, ?, ?, ?, ?)");
-            $stmtItem->execute([$order_id, $item['id'] ?? null, $item['name'], $qty_sold, $item['price']]);
-            $products_to_deduct = []; $removed_ids = $item['removed'] ?? [];
-            $calcRecipe = function($menu_id, $multiplier) use ($stmtRecipe, &$products_to_deduct, $removed_ids) {
-                if(!$menu_id) return; $stmtRecipe->execute([$menu_id]);
-                foreach ($stmtRecipe->fetchAll() as $ing) {
-                    $pid = $ing['product_id']; if (in_array($pid, $removed_ids)) continue;
-                    $needed = ($ing['quantity'] * (1 + ($ing['waste_percent'] / 100))) * $multiplier;
-                    if (!isset($products_to_deduct[$pid])) $products_to_deduct[$pid] = 0; $products_to_deduct[$pid] += $needed;
-                }
-            };
-            if (!empty($item['is_half'])) { $calcRecipe($item['half_a'], 0.5 * $qty_sold); $calcRecipe($item['half_b'], 0.5 * $qty_sold); } else { $calcRecipe($item['id'], 1.0 * $qty_sold); }
-            if (!empty($item['added'])) {
-                foreach ($item['added'] as $added_pid) {
-                    $unit = $productUnits[$added_pid] ?? 'szt'; $extra_qty = 1.0; 
-                    if (in_array($unit, ['kg', 'litr', 'l'])) $extra_qty = 0.05;
-                    if (!isset($products_to_deduct[$added_pid])) $products_to_deduct[$added_pid] = 0; $products_to_deduct[$added_pid] += ($extra_qty * $qty_sold);
-                }
-            }
-            foreach ($products_to_deduct as $pid => $final_qty) {
-                $stmtUpdateStock->execute([$final_qty, $warehouse_id, $pid]);
-                if ($stmtUpdateStock->rowCount() === 0) { $stmtInsertStock->execute([$warehouse_id, $pid, -$final_qty]); }
-                $stmtLog->execute([$pid, $user_id, -$final_qty]);
-            }
-        }
-        
-        if (($input['print_receipt'] ?? 0) == 1) {
-            $pdo->prepare("UPDATE sh_orders SET receipt_printed=1 WHERE id=?")->execute([$order_id]);
-        }
-
-        $pdo->commit(); sendResponse('success', ['order_id' => $order_id]);
-    } catch (Exception $e) { $pdo->rollBack(); sendResponse('error', null, $e->getMessage()); }
-}
-if ($action === 'accept_order') {
-    $parsed_time = date('Y-m-d H:i:s', strtotime($input['custom_time']));
-    $pdo->prepare("UPDATE sh_orders SET status='pending', promised_time=?, kitchen_ticket_printed=1 WHERE id=? AND tenant_id=?")->execute([$parsed_time, $input['order_id'], $tenant_id]);
-    sendResponse('success');
-}
-
-if ($action === 'update_status') {
-    $pdo->prepare("UPDATE sh_orders SET status=? WHERE id=? AND tenant_id=?")->execute([$input['status'], $input['order_id'], $tenant_id]);
-    sendResponse('success');
-}
-
-if ($action === 'print_kitchen') {
-    $pdo->prepare("UPDATE sh_orders SET kitchen_ticket_printed=1, edited_since_print=0, kitchen_changes='' WHERE id=?")->execute([$input['order_id']]);
-    sendResponse('success');
-}
-
-if ($action === 'print_receipt') {
-    $method = $input['payment_method'] ?? 'unpaid';
-    $pdo->prepare("UPDATE sh_orders SET receipt_printed=1, payment_method=? WHERE id=?")->execute([$method, $input['order_id']]);
-    sendResponse('success');
-}
-
-if ($action === 'settle_and_close') {
-    $print = (int)($input['print_receipt'] ?? 0);
-    $method = $input['payment_method'] ?? '';
-    $order_id = $input['order_id'] ?? 0;
-
-    $stmtCheck = $pdo->prepare("SELECT receipt_printed FROM sh_orders WHERE id = ?");
-    $stmtCheck->execute([$order_id]);
-    $already_printed = $stmtCheck->fetchColumn();
-
-    if (($method === 'card' || $method === 'online') && $print === 0 && $already_printed == 0) {
-        sendResponse('error', null, 'Dla karty lub online wydruk paragonu jest obowi─ůzkowy!');
-    }
-
-    $sql = "UPDATE sh_orders SET payment_status='paid', payment_method=?, status='completed'";
-    if($print === 1) $sql .= ", receipt_printed=1";
-    $sql .= " WHERE id=?";
-    $pdo->prepare($sql)->execute([$method, $order_id]);
-    sendResponse('success');
-}
-
-if ($action === 'cancel_order') {
-    $order_id = (int)($input['order_id'] ?? 0);
-    $return_stock = (int)($input['return_stock'] ?? 0);
-    try {
-        $pdo->beginTransaction();
-        $pdo->prepare("UPDATE sh_orders SET status='cancelled' WHERE id=?")->execute([$order_id]);
-        if ($return_stock === 1) {
-            $stmtOld = $pdo->prepare("SELECT cart_json FROM sh_orders WHERE id = ? AND tenant_id = ?");
-            $stmtOld->execute([$order_id, $tenant_id]);
-            $oldOrder = $stmtOld->fetch();
-            if ($oldOrder && !empty($oldOrder['cart_json'])) {
-                $oldCart = json_decode($oldOrder['cart_json'], true);
-                $stmtUpdateStockReturn = $pdo->prepare("UPDATE sh_stock_levels SET quantity = quantity + ? WHERE warehouse_id = 2 AND product_id = ?");
-                $stmtLogReturn = $pdo->prepare("INSERT INTO sh_inventory_logs (product_id, user_id, quantity_changed, action_type) VALUES (?, ?, ?, 'POS_CANCEL_RETURN')");
-                $stmtRecipe = $pdo->prepare("SELECT product_id, quantity, waste_percent FROM sh_recipes WHERE menu_item_id = ?");
-                $stmtUnits = $pdo->prepare("SELECT id, unit FROM sh_products WHERE tenant_id = ?");
-                $stmtUnits->execute([$tenant_id]);
-                $productUnits = [];
-                foreach($stmtUnits->fetchAll() as $row) { $productUnits[$row['id']] = strtolower(trim($row['unit'])); }
-                foreach ($oldCart as $item) {
-                    $qty_sold = (float)$item['qty']; $products_to_return = []; $removed_ids = $item['removed'] ?? [];
-                    $calcRecipe = function($menu_id, $multiplier) use ($stmtRecipe, &$products_to_return, $removed_ids) {
-                        if(!$menu_id) return; $stmtRecipe->execute([$menu_id]);
-                        foreach ($stmtRecipe->fetchAll() as $ing) {
-                            $pid = $ing['product_id']; if (in_array($pid, $removed_ids)) continue;
-                            $needed = ($ing['quantity'] * (1 + ($ing['waste_percent'] / 100))) * $multiplier;
-                            if (!isset($products_to_return[$pid])) $products_to_return[$pid] = 0; $products_to_return[$pid] += $needed;
-                        }
-                    };
-                    if (!empty($item['is_half'])) { $calcRecipe($item['half_a'], 0.5 * $qty_sold); $calcRecipe($item['half_b'], 0.5 * $qty_sold); } 
-                    else { $calcRecipe($item['id'], 1.0 * $qty_sold); }
-                    if (!empty($item['added'])) {
-                        foreach ($item['added'] as $added_pid) {
-                            $unit = $productUnits[$added_pid] ?? 'szt'; $extra_qty = 1.0; 
-                            if (in_array($unit, ['kg', 'litr', 'l'])) $extra_qty = 0.05;
-                            if (!isset($products_to_return[$added_pid])) $products_to_return[$added_pid] = 0; $products_to_return[$added_pid] += ($extra_qty * $qty_sold);
-                        }
-                    }
-                    foreach ($products_to_return as $pid => $return_qty) {
-                        $stmtUpdateStockReturn->execute([$return_qty, $pid]);
-                        $stmtLogReturn->execute([$pid, $user_id, $return_qty]); 
-                    }
-                }
-            }
-        }
-        $pdo->commit(); sendResponse('success');
-    } catch (Exception $e) { $pdo->rollBack(); sendResponse('error', null, $e->getMessage()); }
-}
-
-// ­čÜÇ ZAAWANSOWANA WYSY┼üKA W TRAS─ś (SYSTEM K & L)
-if ($action === 'assign_route') {
-    $driver_id = (int)($input['driver_id'] ?? 0);
-    $order_ids = $input['order_ids'] ?? [];
-    
-    if (!$driver_id || empty($order_ids)) {
-        sendResponse('error', null, 'Wybierz kierowc─Ö i zam├│wienia.');
-    }
-    
-    try {
-        $pdo->beginTransaction();
-        
-        // Obliczamy nowy unikalny numer kursu dla dnia dzisiejszego (K1, K2...)
-        $stmtK = $pdo->prepare("SELECT COUNT(DISTINCT course_id) FROM sh_orders WHERE tenant_id = ? AND DATE(created_at) = CURDATE() AND course_id IS NOT NULL");
-        $stmtK->execute([$tenant_id]);
-        $next_k = $stmtK->fetchColumn() + 1;
-        $course_id = 'K' . $next_k;
-        
-        $stmtUpdate = $pdo->prepare("UPDATE sh_orders SET status='in_delivery', driver_id=?, course_id=?, stop_number=? WHERE id=? AND tenant_id=?");
-        
-        // Przypisanie numeracji kolejno┼Ťci wyjazdu (L1, L2...) do konkretnych zam├│wie┼ä
-        $l_num = 1;
-        foreach ($order_ids as $oid) {
-            $stmtUpdate->execute([$driver_id, $course_id, 'L' . $l_num, $oid, $tenant_id]);
-            $l_num++;
-        }
-        
-        $pdo->commit();
-        sendResponse('success', ['course_id' => $course_id]);
-    } catch (Exception $e) {
-        $pdo->rollBack();
-        sendResponse('error', null, $e->getMessage());
-    }
-}
-
-if ($action === 'panic_mode') {
-    $pdo->prepare("UPDATE sh_orders SET promised_time = DATE_ADD(COALESCE(promised_time, created_at), INTERVAL 20 MINUTE) WHERE status IN ('pending', 'ready') AND tenant_id = ?")->execute([$tenant_id]);
-    sendResponse('success', ['message' => 'Wydłużono czasy o 20 minut!']);
-}
-
-sendResponse('error', null, 'Brak akcji.');
-?>
\ No newline at end of file
diff --git a/_KOPALNIA_WIEDZY_LEGACY/order_handler_view (1).html b/_KOPALNIA_WIEDZY_LEGACY/order_handler_view (1).html
deleted file mode 100644
index 03905fc..0000000
--- a/_KOPALNIA_WIEDZY_LEGACY/order_handler_view (1).html	
+++ /dev/null
@@ -1,192 +0,0 @@
-<!DOCTYPE html>
-<html lang="pl">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>SliceHub POS - Zam├│wienia Online</title>
-    <style>
-        :root { --primary: #0284c7; --dark: #0f172a; --gray: #f1f5f9; --text: #334155; --success: #10b981; --warning: #f59e0b; --danger: #ef4444; }
-        body { font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif; background-color: #cbd5e1; color: var(--text); margin: 0; padding: 20px; }
-        .dashboard { max-width: 1500px; margin: 0 auto; display: grid; grid-template-columns: 3fr 1fr; gap: 20px; }
-        
-        .card { background: white; border-radius: 12px; padding: 25px; box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1); }
-        .header { background: var(--dark); color: white; padding: 20px; border-radius: 12px; margin-bottom: 20px; display: flex; justify-content: space-between; align-items: center; border-left: 5px solid var(--primary); }
-        .header h1 { margin: 0; font-size: 22px; }
-        .badge { background: var(--primary); color: white; padding: 5px 12px; border-radius: 20px; font-size: 12px; font-weight: bold; text-transform: uppercase; }
-
-        /* Strefa Kanban (Zam├│wienia) */
-        .kanban-board { display: grid; grid-template-columns: 1fr 1fr 1fr; gap: 15px; }
-        .kanban-col { background: var(--gray); border-radius: 8px; padding: 15px; min-height: 600px; }
-        .kanban-col h3 { margin-top: 0; color: var(--dark); font-size: 16px; border-bottom: 2px solid #e2e8f0; padding-bottom: 10px; display: flex; justify-content: space-between; }
-        .ticket-count { background: var(--primary); color: white; padding: 2px 8px; border-radius: 12px; font-size: 12px; }
-
-        /* Bony (Tickets) */
-        .ticket { background: white; border-radius: 8px; padding: 15px; margin-bottom: 15px; box-shadow: 0 2px 4px rgba(0,0,0,0.05); border-left: 4px solid #cbd5e1; transition: 0.2s; }
-        .ticket.new { border-left-color: var(--danger); animation: pulse 2s infinite; }
-        .ticket.kitchen { border-left-color: var(--warning); }
-        .ticket.ready { border-left-color: var(--success); }
-        
-        @keyframes pulse { 0% { box-shadow: 0 0 0 0 rgba(239, 68, 68, 0.4); } 70% { box-shadow: 0 0 0 10px rgba(239, 68, 68, 0); } 100% { box-shadow: 0 0 0 0 rgba(239, 68, 68, 0); } }
-
-        .t-header { display: flex; justify-content: space-between; align-items: center; margin-bottom: 10px; font-size: 13px; font-weight: bold; color: #64748b; }
-        .t-source { background: #e0f2fe; color: #0284c7; padding: 2px 6px; border-radius: 4px; font-size: 11px; text-transform: uppercase; }
-        .t-items { font-size: 14px; font-weight: bold; margin-bottom: 15px; line-height: 1.5; }
-        .t-item-note { font-size: 12px; color: var(--danger); font-weight: normal; display: block; margin-left: 10px; }
-        
-        .btn-ticket { width: 100%; padding: 10px; border: none; border-radius: 6px; font-weight: bold; cursor: pointer; color: white; text-transform: uppercase; font-size: 13px; }
-        .btn-accept { background: var(--success); }
-        .btn-move { background: var(--primary); }
-
-        /* Strefa Admina */
-        .setting-group { margin-bottom: 25px; }
-        .setting-group h4 { margin: 0 0 10px 0; color: var(--dark); border-bottom: 1px solid #e2e8f0; padding-bottom: 5px; }
-        
-        .toggle-row { display: flex; justify-content: space-between; align-items: center; padding: 8px 0; }
-        .toggle-label { font-size: 13px; font-weight: 500; }
-        .value-input { width: 60px; padding: 6px; border: 1px solid #cbd5e1; border-radius: 6px; text-align: center; font-weight: bold; }
-        
-        .switch { position: relative; display: inline-block; width: 36px; height: 18px; }
-        .switch input { opacity: 0; width: 0; height: 0; }
-        .slider { position: absolute; cursor: pointer; top: 0; left: 0; right: 0; bottom: 0; background-color: #cbd5e1; transition: .4s; border-radius: 20px; }
-        .slider:before { position: absolute; content: ""; height: 12px; width: 12px; left: 3px; bottom: 3px; background-color: white; transition: .4s; border-radius: 50%; }
-        input:checked + .slider { background-color: var(--primary); }
-        input:checked + .slider:before { transform: translateX(18px); }
-
-        .btn-panic { background: var(--danger); color: white; width: 100%; padding: 15px; border: none; border-radius: 8px; font-weight: bold; font-size: 16px; cursor: pointer; text-transform: uppercase; box-shadow: 0 4px 12px rgba(239, 68, 68, 0.4); margin-top: 20px; }
-        .btn-panic:hover { background: #dc2626; }
-    </style>
-</head>
-<body>
-
-<div class="header">
-    <div>
-        <h1>SLICEHUB POS - Zam├│wienia Online & KDS</h1>
-        <div style="color: #cbd5e1; font-size: 13px; margin-top: 5px;">Integracja: Własna strona WWW + Kiosk | Widok: Sala/Kuchnia</div>
-    </div>
-    <span class="badge">Silnik: OrderHandler API</span>
-</div>
-
-<div class="dashboard">
-    <div class="card" style="padding: 15px; background: transparent; box-shadow: none;">
-        <div class="kanban-board">
-            
-            <div class="kanban-col">
-                <h3><span>Oczekuj─ůce (Nowe)</span> <span class="ticket-count" style="background: var(--danger);">1</span></h3>
-                
-                <div class="ticket new">
-                    <div class="t-header">
-                        <span>#WEB-4021</span>
-                        <span class="t-source">Strona WWW</span>
-                    </div>
-                    <div class="t-header" style="color: var(--dark);">
-                        <span>14:02 (3 min temu)</span>
-                        <span style="color: var(--success);">Opłacone (PayU)</span>
-                    </div>
-                    <div class="t-items">
-                        1x Pizza Parma (32cm)
-                        <span class="t-item-note">- BEZ RUKOLI</span>
-                        1x Sos Czosnkowy
-                    </div>
-                    <button class="btn-ticket btn-accept">Akceptuj i wy┼Ťlij na kuchni─Ö</button>
-                </div>
-            </div>
-
-            <div class="kanban-col">
-                <h3><span>W przygotowaniu</span> <span class="ticket-count" style="background: var(--warning);">2</span></h3>
-                
-                <div class="ticket kitchen">
-                    <div class="t-header">
-                        <span>#KIO-108</span>
-                        <span class="t-source" style="background: #fef08a; color: #a16207;">Kiosk Lokal</span>
-                    </div>
-                    <div class="t-header" style="color: var(--dark);">
-                        <span>13:50 (12 min temu)</span>
-                        <span>Odbi├│r: Na miejscu</span>
-                    </div>
-                    <div class="t-items">
-                        2x Burger Drwala
-                        1x Frytki Du┼╝e
-                    </div>
-                    <button class="btn-ticket btn-move">Oznacz jako GOTOWE</button>
-                </div>
-
-                <div class="ticket kitchen">
-                    <div class="t-header">
-                        <span>#WEB-4020</span>
-                        <span class="t-source">Strona WWW</span>
-                    </div>
-                    <div class="t-header" style="color: var(--dark);">
-                        <span>13:45 (17 min temu)</span>
-                        <span>Dostawa: ul. Polna 12</span>
-                    </div>
-                    <div class="t-items">
-                        3x Pizza Margherita
-                    </div>
-                    <button class="btn-ticket btn-move">Oznacz jako GOTOWE</button>
-                </div>
-            </div>
-
-            <div class="kanban-col">
-                <h3><span>Gotowe / Wydane</span> <span class="ticket-count" style="background: var(--success);">1</span></h3>
-                
-                <div class="ticket ready">
-                    <div class="t-header">
-                        <span>#WEB-4019</span>
-                        <span class="t-source">Strona WWW</span>
-                    </div>
-                    <div class="t-header" style="color: var(--dark);">
-                        <span>Wydano kierowcy: Jan</span>
-                        <span>Opłacone</span>
-                    </div>
-                    <div class="t-items" style="color: #64748b; text-decoration: line-through;">
-                        1x Zestaw Sushi (M)
-                    </div>
-                </div>
-            </div>
-
-        </div>
-    </div>
-
-    <div class="card" style="border-top: 4px solid var(--primary);">
-        <h2 style="margin-top:0;">Konfiguracja Odbioru</h2>
-        <p style="font-size: 12px; color: #64748b; margin-bottom: 20px;">Plik docelowy: <code>orders_settings.php</code></p>
-
-        <div class="setting-group">
-            <h4>Automatyzacja Zleceń</h4>
-            <div class="toggle-row">
-                <span class="toggle-label">Auto-akceptuj zlecenia z Kiosku</span>
-                <label class="switch"><input type="checkbox" checked><span class="slider"></span></label>
-            </div>
-            <div class="toggle-row">
-                <span class="toggle-label">Auto-akceptuj WWW (Tylko opłacone)</span>
-                <label class="switch"><input type="checkbox"><span class="slider"></span></label>
-            </div>
-            <div class="toggle-row">
-                <span class="toggle-label">Domy┼Ťlny czas dostawy (min)</span>
-                <input type="number" class="value-input" value="45">
-            </div>
-        </div>
-
-        <div class="setting-group">
-            <h4>Integracje API (Zewn─Ötrzne)</h4>
-            <div class="toggle-row">
-                <span class="toggle-label">Pobieraj zlecenia z Glovo/UberEats</span>
-                <label class="switch"><input type="checkbox"><span class="slider"></span></label>
-            </div>
-            <div class="toggle-row">
-                <span class="toggle-label">Zdejmuj surowce (PROD) w locie</span>
-                <label class="switch"><input type="checkbox" checked><span class="slider"></span></label>
-            </div>
-        </div>
-
-        <div style="margin-top: 30px; padding-top: 20px; border-top: 2px dashed #fca5a5; text-align: center;">
-            <span style="font-size: 12px; font-weight: bold; color: var(--danger);">KRYTYCZNE PRZECIĄŻENIE KUCHNI?</span>
-            <button class="btn-panic">­čŤĹ WSTRZYMAJ ZAM├ôWIENIA ONLINE</button>
-            <p style="font-size: 11px; color: #64748b; margin-top: 8px;">Wy┼é─ůcza mo┼╝liwo┼Ť─ç zamawiania na stronie WWW i w Kiosku do odwo┼éania.</p>
-        </div>
-        
-    </div>
-</div>
-
-</body>
-</html>
\ No newline at end of file
diff --git a/_KOPALNIA_WIEDZY_LEGACY/pos (1).html b/_KOPALNIA_WIEDZY_LEGACY/pos (1).html
deleted file mode 100644
index 04d170b..0000000
--- a/_KOPALNIA_WIEDZY_LEGACY/pos (1).html	
+++ /dev/null
@@ -1,1147 +0,0 @@
-<!DOCTYPE html>
-<html lang="pl">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
-    <title>SliceHub POS v6.5 ULTIMATE</title>
-    
-    <script src="https://cdn.tailwindcss.com"></script>
-    <link href="https://fonts.googleapis.com/css2?family=Montserrat:wght@400;700;900&display=swap" rel="stylesheet">
-    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css">
-
-    <style>
-        body { font-family: 'Montserrat', sans-serif; background-color: #050505; color: white; user-select: none; overflow: hidden; display: flex; flex-direction: column; height: 100vh; }
-        .glass { background: rgba(255, 255, 255, 0.03); border: 1px solid rgba(255, 255, 255, 0.05); }
-        .hide-scrollbar::-webkit-scrollbar { display: none; }
-        
-        /* CZYSTE PŁASKIE BONY */
-        .compact-card { background: rgba(255,255,255,0.02); border: 1px solid rgba(255,255,255,0.05); border-radius: 8px; padding: 0.5rem 0.75rem; transition: transform 0.1s, border-color 0.2s; position: relative; overflow: hidden; }
-        .compact-card:hover { background: rgba(255,255,255,0.04); }
-        .compact-card.selected { border-color: #3b82f6 !important; background: rgba(59,130,246,0.1); box-shadow: 0 0 15px rgba(59,130,246,0.3); }
-        
-        /* ALERTY I STATUSY */
-        .blink-red { animation: pulse-text-red 1.5s infinite; transform: translateZ(0); }
-        .blink-border-red { animation: pulse-border-red 2s infinite; transform: translateZ(0); }
-        @keyframes pulse-text-red { 0%, 100% { color: #ef4444; } 50% { color: #7f1d1d; } }
-        @keyframes pulse-border-red { 0%, 100% { border-color: #ef4444; } 50% { border-color: rgba(255,255,255,0.05); } }
-        
-        .status-badge { display: inline-flex; align-items: center; font-size: 0.5rem; font-weight: 900; text-transform: uppercase; padding: 0.15rem 0.3rem; border-radius: 3px; letter-spacing: 0.05em; color: #22c55e; border: 1px solid rgba(34,197,94,0.3); background: rgba(34,197,94,0.1); }
-        .status-badge.alert { color: #eab308; border-color: rgba(234,179,8,0.5); background: rgba(234,179,8,0.1); animation: pulse-yellow 1s infinite; }
-        @keyframes pulse-yellow { 0%, 100% { opacity: 1; } 50% { opacity: 0.5; } }
-
-        /* NAKŁADKI */
-        .full-overlay { position: fixed; inset: 0; background: #050505; z-index: 400; display: none; flex-direction: row; }
-        .full-overlay.active { display: flex; }
-        .modal-overlay { position: fixed; inset: 0; background: rgba(0,0,0,0.95); z-index: 500; display: none; align-items: center; justify-content: center; backdrop-blur: 15px; }
-        .modal-overlay.active { display: flex; }
-
-        .pay-option { border: 2px solid transparent; transition: 0.1s; }
-        .pay-option.active { border-color: #22c55e; background: rgba(34,197,94,0.1); }
-        .pay-option.active-park { border-color: #ef4444; background: rgba(239,68,68,0.1); }
-        
-        /* CZYSTE KOLUMNY KANBAN (Brak neon├│w) */
-        .kanban-col { background: rgba(10, 15, 28, 0.4); border-radius: 12px; border: 1px solid rgba(255,255,255,0.05); height: 100%; display: flex; flex-direction: column; overflow: hidden; }
-        .filter-highlight { box-shadow: 0 0 10px rgba(255,255,255,0.1); border: 1px solid rgba(255,255,255,0.2); }
-    </style>
-</head>
-<body>
-    <script>
-    async function checkAuth() {
-        const res = await fetch('api_session_check.php').then(r => r.json());
-        if (!res.success) {
-            window.location.href = 'login.html'; 
-        }
-    }
-    checkAuth();
-    </script>
-
-    <audio id="alert-sound" src="https://assets.mixkit.co/active_storage/sfx/2869/2869-preview.mp3" preload="auto"></audio>
-    <div id="toast-container" class="fixed top-5 right-5 z-[9999] flex flex-col gap-3 pointer-events-none"></div>
-
-    <nav class="w-full h-14 bg-[#0a0f1c] border-b border-white/5 flex items-center px-4 shrink-0 z-[400] relative shadow-md">
-        <div class="flex items-center gap-3 w-1/4">
-            <div class="w-8 h-8 bg-red-600 rounded flex items-center justify-center font-black text-xs shadow-lg cursor-pointer">SH</div>
-            <button onclick="openOrderTypeSelector()" class="bg-green-600 hover:bg-green-500 text-white h-8 px-4 rounded font-black uppercase text-[9px] tracking-widest flex items-center gap-1.5 shadow-lg active:scale-95 transition">
-                <i class="fa-solid fa-plus"></i> NOWE
-            </button>
-            <button class="bg-white/10 text-white h-8 px-4 rounded font-black uppercase text-[9px] tracking-widest flex items-center gap-1.5 border border-white/10 hover:bg-white/20 transition">
-                <i class="fa-solid fa-satellite-dish"></i> PULPIT
-            </button>
-        </div>
-
-        <div class="flex-1 flex justify-center items-center gap-4">
-            <button onclick="triggerPanic()" class="h-8 px-3 bg-red-900/20 text-red-500 rounded font-black uppercase text-[8px] border border-red-500/30 hover:bg-red-600 hover:text-white transition shadow-[0_0_10px_rgba(239,68,68,0.2)]">
-                <i class="fa-solid fa-triangle-exclamation mr-1"></i> PANIC (+20M)
-            </button>
-            
-            <div class="flex bg-black/50 p-1 rounded-lg border border-white/5 items-center">
-                <button onclick="setFilter('all')" id="flt-all" class="px-5 py-1.5 rounded text-[10px] font-black uppercase transition bg-white/10 text-white filter-highlight mr-1">WSZYSTKIE (0)</button>
-                <button onclick="setFilter('routes')" id="flt-routes" class="px-5 py-1.5 rounded text-[10px] font-black uppercase transition text-blue-400 hover:text-white mr-2 border border-blue-500/30 bg-blue-900/20 shadow-[0_0_10px_rgba(59,130,246,0.1)]">­čÜŚ KURSY (0)</button>
-                <div class="w-px h-5 bg-white/10 mx-2"></div>
-                <button onclick="setFilter('delivery')" id="flt-dev" class="px-4 py-1.5 text-[9px] font-black uppercase text-slate-400 hover:text-white transition">­čŤÁ DOW├ôZ (0)</button>
-                <button onclick="setFilter('sala')" id="flt-sala" class="px-4 py-1.5 text-[9px] font-black uppercase text-slate-400 hover:text-white transition">­čŹŻ´ŞĆ SALA (0)</button>
-                <button onclick="setFilter('wynos')" id="flt-wynos" class="px-4 py-1.5 text-[9px] font-black uppercase text-slate-400 hover:text-white transition">­čąí WYNOS (0)</button>
-                <div class="w-px h-5 bg-white/10 mx-2"></div>
-                <button onclick="setFilter('future')" id="flt-future" class="px-4 py-1.5 text-[9px] font-black uppercase text-slate-400 hover:text-white transition">­čôů PRZYSZ┼üE (0)</button>
-            </div>
-        </div>
-
-        <div class="w-1/4 flex justify-end">
-            <button class="text-slate-500 hover:text-white h-8 px-3 rounded font-black uppercase text-[10px] transition">
-                <i class="fa-solid fa-gears text-sm"></i>
-            </button>
-        </div>
-    </nav>
-
-    <main id="view-mission-control" class="flex-1 flex w-full relative overflow-hidden">
-        
-        <div class="w-[280px] bg-[#070b14] border-r border-white/5 flex flex-col shrink-0 z-40 relative shadow-[5px_0_15px_rgba(0,0,0,0.5)]">
-            <div class="p-3 border-b border-white/5 flex justify-between items-center bg-black/40">
-                <h3 class="font-black text-[10px] uppercase tracking-widest text-blue-400"><i class="fa-solid fa-globe mr-2"></i> NOWE ONLINE</h3>
-                <span id="pulse-counter" class="bg-blue-600 text-white px-2 py-0.5 rounded text-[8px] font-black hidden">0</span>
-            </div>
-            <div class="flex-1 overflow-y-auto p-2 space-y-3 hide-scrollbar">
-                <section>
-                    <h4 class="text-[8px] font-black uppercase text-slate-400 mb-1 px-1">­čŤÁ Dow├│z</h4>
-                    <div id="pulse-list-delivery" class="space-y-1.5"></div>
-                </section>
-                <section>
-                    <h4 class="text-[8px] font-black uppercase text-slate-400 mb-1 px-1">­čąí Wynos</h4>
-                    <div id="pulse-list-takeaway" class="space-y-1.5"></div>
-                </section>
-                <section>
-                    <h4 class="text-[8px] font-black uppercase text-slate-400 mb-1 px-1">­čŹŻ´ŞĆ Sala</h4>
-                    <div id="pulse-list-dinein" class="space-y-1.5"></div>
-                </section>
-            </div>
-        </div>
-
-        <div class="flex-1 flex flex-col relative bg-[#050505] z-10 overflow-hidden">
-            <div id="bf-grid" class="flex-1 p-3 overflow-y-auto hide-scrollbar z-10 w-full content-start"></div>
-        </div>
-
-        <div class="w-[260px] bg-[#070b14] border-l border-white/5 flex flex-col shrink-0 z-10 shadow-[-5px_0_15px_rgba(0,0,0,0.5)]">
-            <div class="flex flex-col h-[45%] border-b border-white/5">
-                <div class="p-3 border-b border-white/5 bg-black/40 shrink-0 flex justify-between items-center">
-                    <h3 class="font-black text-[10px] uppercase tracking-widest text-slate-300"><i class="fa-solid fa-motorcycle mr-1"></i> Flota</h3>
-                    <button id="btn-send-route" onclick="sendRoute()" class="hidden bg-green-600 text-white text-[8px] font-black px-2 py-1 rounded uppercase shadow-lg hover:bg-green-500 transition">Wy┼Ťlij Kurs</button>
-                </div>
-                <div id="drivers-list" class="flex-1 overflow-y-auto p-2 space-y-1 hide-scrollbar"></div>
-            </div>
-            <div class="flex flex-col flex-1 border-b border-white/5">
-                <div class="p-3 border-b border-white/5 bg-black/40 shrink-0">
-                    <h3 class="font-black text-[10px] uppercase tracking-widest text-slate-300"><i class="fa-solid fa-users mr-1"></i> Kelnerzy</h3>
-                </div>
-                <div id="waiters-list" class="flex-1 overflow-y-auto p-2 space-y-1 hide-scrollbar"></div>
-            </div>
-            <div class="shrink-0 p-3 bg-black/40 flex items-center justify-between border-t border-white/5">
-                <div>
-                    <p class="text-[7px] font-black uppercase text-slate-500 tracking-widest mb-0.5">Helpdesk</p>
-                    <a href="mailto:pomoc@slicehub.pl" class="text-[9px] font-bold text-slate-300 hover:text-blue-400 transition">pomoc@slicehub.pl</a>
-                </div>
-                <button class="w-8 h-8 rounded-full bg-blue-600 text-white flex items-center justify-center hover:bg-blue-500 transition shadow-lg">
-                    <i class="fa-solid fa-headset text-xs"></i>
-                </button>
-            </div>
-        </div>
-    </main>
-	<div id="order-type-modal" class="modal-overlay">
-        <div class="w-full max-w-lg bg-[#0a0f1c] rounded-[32px] p-8 border border-white/10 shadow-2xl relative text-center">
-            <button onclick="document.getElementById('order-type-modal').classList.remove('active')" class="absolute top-6 right-6 w-8 h-8 rounded-full bg-white/5 flex items-center justify-center hover:bg-red-600 transition"><i class="fa-solid fa-xmark text-xs text-white"></i></button>
-            <h3 class="text-xl font-black uppercase italic tracking-tighter mb-6 text-white">Wybierz Typ Zam├│wienia</h3>
-            <div class="grid grid-cols-3 gap-3 mb-4">
-                <button onclick="selectInitialOrderType('dine_in')" class="py-8 bg-blue-900/20 border border-blue-500/30 hover:bg-blue-600 rounded-xl font-black uppercase text-[10px] transition flex flex-col items-center gap-2 text-white">
-                    <i class="fa-solid fa-utensils text-2xl"></i> Na Miejscu
-                </button>
-                <button onclick="selectInitialOrderType('takeaway')" class="py-8 bg-blue-900/20 border border-blue-500/30 hover:bg-blue-600 rounded-xl font-black uppercase text-[10px] transition flex flex-col items-center gap-2 text-white">
-                    <i class="fa-solid fa-bag-shopping text-2xl"></i> Na Wynos
-                </button>
-                <button onclick="selectInitialOrderType('delivery')" class="py-8 bg-blue-900/20 border border-blue-500/30 hover:bg-blue-600 rounded-xl font-black uppercase text-[10px] transition flex flex-col items-center gap-2 text-white">
-                    <i class="fa-solid fa-motorcycle text-2xl"></i> Dostawa
-                </button>
-            </div>
-            <div id="table-selection-div" class="hidden text-left mt-6 border-t border-white/10 pt-4">
-                <p class="text-[9px] font-bold text-slate-500 uppercase mb-2">Wybierz numer stolika:</p>
-                <div class="flex gap-2">
-                    <select id="initial-table-select" class="flex-1 bg-black border border-white/10 rounded-lg p-3 text-xs font-bold outline-none focus:border-blue-500 text-white">
-                        <option value="">Wybierz z listy...</option>
-                    </select>
-                    <button onclick="confirmInitialTable()" class="px-6 bg-blue-600 rounded-lg font-black uppercase text-[10px] hover:bg-blue-500 transition text-white">Dalej</button>
-                </div>
-            </div>
-        </div>
-    </div>
-
-    <div id="order-overlay" class="full-overlay z-[400]">
-        <div class="flex-1 flex flex-col p-4 overflow-hidden">
-            <header class="flex justify-between items-center mb-4">
-                <button onclick="closeNewOrder()" class="text-slate-500 hover:text-white font-black uppercase text-[9px] tracking-widest transition">
-                    <i class="fa-solid fa-chevron-left mr-2"></i> Wr├│─ç do Pulpitu
-                </button>
-                <div class="flex items-center gap-3">
-                    <span id="edit-mode-badge" class="hidden bg-blue-600 px-3 py-1.5 rounded-lg text-[9px] font-black uppercase text-white animate-pulse"><i class="fa-solid fa-pen mr-2"></i> Tryb Edycji</span>
-                </div>
-            </header>
-            <div id="cat-list" class="flex gap-2 overflow-x-auto hide-scrollbar mb-4 pb-1"></div>
-            <div id="item-grid" class="grid grid-cols-4 lg:grid-cols-5 xl:grid-cols-6 gap-3 overflow-y-auto hide-scrollbar pb-32 content-start"></div>
-        </div>
-        
-        <div class="w-[380px] bg-[#0a0f1c] border-l border-white/5 flex flex-col shadow-2xl shrink-0">
-            <div class="p-4 border-b border-white/5 flex justify-between items-center bg-red-600">
-                <h3 class="font-black text-xs uppercase tracking-widest text-white">Koszyk</h3>
-            </div>
-            <div class="p-3 grid grid-cols-3 gap-2 border-b border-white/5">
-                <button onclick="setOrderType('dine_in', this)" class="type-btn type-dine_in p-2.5 rounded-lg border border-white/5 bg-blue-600 font-black text-[8px] uppercase transition text-white">Sala</button>
-                <button onclick="setOrderType('takeaway', this)" class="type-btn type-takeaway p-2.5 rounded-lg border border-white/5 bg-white/5 font-black text-[8px] uppercase transition text-white">Wynos</button>
-                <button onclick="setOrderType('delivery', this)" class="type-btn type-delivery p-2.5 rounded-lg border border-white/5 bg-white/5 font-black text-[8px] uppercase transition text-white">Dostawa</button>
-            </div>
-            <div id="delivery-fields" class="hidden p-3 space-y-2 bg-black/40 border-b border-white/5">
-                <input type="text" id="cust-addr" placeholder="Adres dostawy / Stolik" class="w-full bg-black border border-white/10 rounded-lg p-2.5 text-[10px] font-bold outline-none focus:border-blue-500 text-white">
-                <input type="text" id="cust-phone" placeholder="Telefon" class="w-full bg-black border border-white/10 rounded-lg p-2.5 text-[10px] font-bold outline-none focus:border-blue-500 text-white">
-            </div>
-            <div id="cart-items" class="flex-1 overflow-y-auto p-3 space-y-2 hide-scrollbar"></div>
-            <div class="p-4 bg-black/40 border-t border-white/5 space-y-3">
-                <input type="text" id="cust-nip" placeholder="NIP (Opcjonalnie)" class="w-full bg-white/5 rounded-lg p-2.5 text-[9px] font-bold border border-white/10 outline-none focus:border-blue-500 text-white">
-                <div class="flex justify-between items-end mb-4">
-                    <span class="text-[9px] font-black uppercase text-slate-500">Suma</span>
-                    <span id="cart-total" class="text-3xl font-black italic text-green-500">0.00 <span class="text-xs">zł</span></span>
-                </div>
-                <button id="btn-cart-checkout" onclick="openCartCheckoutModal()" class="w-full py-4 rounded-xl bg-red-600 hover:bg-red-500 text-white font-black uppercase text-xs shadow-lg transition active:scale-95">ZATWIERD┼╣ <i class="fa-solid fa-arrow-right ml-2"></i></button>
-            </div>
-        </div>
-    </div>
-
-    <div id="cart-checkout-modal" class="modal-overlay">
-        <div class="w-full max-w-sm bg-[#0a0f1c] rounded-[32px] p-6 border border-white/10 shadow-2xl relative flex flex-col max-h-[95vh] overflow-y-auto hide-scrollbar">
-            <button onclick="document.getElementById('cart-checkout-modal').classList.remove('active')" class="absolute top-5 right-5 w-8 h-8 rounded-full bg-white/5 flex items-center justify-center hover:bg-red-600 transition"><i class="fa-solid fa-xmark text-xs text-white"></i></button>
-            <h3 class="text-xl font-black uppercase italic tracking-tighter mb-4 text-center text-white">FINALIZACJA</h3>
-            
-            <div class="mb-4 bg-black/30 p-2.5 rounded-xl border border-white/5">
-                <div class="flex gap-2 mb-2">
-                    <button onclick="switchTimeTab('asap')" id="tab-asap" class="flex-1 py-2.5 rounded-lg bg-blue-600 font-black text-[9px] uppercase text-white shadow-md transition">Jak najszybciej</button>
-                    <button onclick="switchTimeTab('scheduled')" id="tab-scheduled" class="flex-1 py-2.5 rounded-lg bg-white/10 font-black text-[9px] uppercase text-slate-400 hover:text-white transition">Na Godzin─Ö</button>
-                </div>
-                <div id="time-asap-view" class="space-y-2">
-                    <div id="quick-time-btns" class="flex gap-2 overflow-x-auto hide-scrollbar pb-1"></div>
-                    <div class="flex gap-2 items-center">
-                        <input type="number" id="custom-minutes" placeholder="Własne min." class="flex-1 bg-black border border-white/10 rounded-lg p-2.5 text-xs font-bold text-white outline-none">
-                        <button onclick="applyCustomMinutes()" class="px-5 py-2.5 bg-white/10 rounded-lg text-[9px] font-black uppercase text-white hover:bg-white/20 transition">Ustaw</button>
-                    </div>
-                    <label class="block w-full bg-blue-900/20 border border-blue-500/50 rounded-lg py-3 text-center cursor-pointer hover:bg-blue-600 transition relative">
-                        <span class="text-[9px] font-black uppercase text-blue-400 hover:text-white"><i class="fa-regular fa-calendar-days mr-2"></i> Wybierz z kalendarza</span>
-                        <input type="datetime-local" id="checkout-calendar-input" onchange="calendarTimeChanged(this.value)" class="absolute inset-0 opacity-0 cursor-pointer w-full h-full">
-                    </label>
-                </div>
-                <div id="time-scheduled-view" class="hidden flex-col items-center justify-center p-4 bg-black/50 rounded-lg border border-white/5">
-                    <p class="text-[8px] uppercase font-black text-slate-500 mb-1 tracking-widest">Wybrany Czas</p>
-                    <h4 id="scheduled-time-display" class="text-2xl font-black text-white mb-1">--:--</h4>
-                    <p id="scheduled-countdown" class="text-[10px] font-bold text-blue-400 mb-3">Za -- min</p>
-                    <label class="px-4 py-1.5 bg-white/10 rounded border border-white/10 text-[9px] font-black uppercase cursor-pointer relative hover:bg-white/20 transition text-white">
-                        <i class="fa-solid fa-pen mr-1"></i> Zmień kalendarzem
-                        <input type="datetime-local" id="checkout-calendar-input-2" onchange="calendarTimeChanged(this.value)" class="absolute inset-0 opacity-0 cursor-pointer w-full h-full">
-                    </label>
-                </div>
-            </div>
-            
-            <p class="text-[9px] font-bold text-slate-500 uppercase tracking-widest text-center mb-2">Status P┼éatno┼Ťci</p>
-            <div class="space-y-2 mb-4">
-                <button onclick="selectCartPayment('unpaid', 'unpaid', this, true)" id="btn-pay-park" class="pay-option active-park w-full py-3 bg-[#111827] rounded-lg font-black uppercase text-[10px] text-white flex justify-center items-center gap-2 border border-red-500/50 shadow-[0_0_10px_rgba(239,68,68,0.2)]"><i class="fa-solid fa-clock text-red-500"></i> DO ZAPŁATY (ZAPARKUJ)</button>
-                <div class="grid grid-cols-2 gap-2 mt-2">
-                    <button onclick="selectCartPayment('cash', 'paid', this)" class="pay-option py-3 bg-[#111827] rounded-lg font-black uppercase text-[9px] text-white flex justify-center items-center gap-2 hover:bg-white/5 transition">Got├│wka</button>
-                    <button onclick="selectCartPayment('card', 'paid', this)" class="pay-option py-3 bg-[#111827] rounded-lg font-black uppercase text-[9px] text-white flex justify-center items-center gap-2 hover:bg-white/5 transition">Karta</button>
-                </div>
-            </div>
-
-            <div class="flex flex-col gap-2 mb-5 bg-black/40 p-3 rounded-lg border border-white/5">
-                <div class="flex items-center gap-3"><input type="checkbox" id="cart-print-kitchen" class="w-4 h-4 accent-blue-600 rounded cursor-pointer" checked><label for="cart-print-kitchen" class="text-[9px] font-black uppercase text-blue-300 cursor-pointer">Drukuj BON (Kuchnia)</label></div>
-                <div class="flex items-center gap-3"><input type="checkbox" id="cart-print-receipt" class="w-4 h-4 accent-red-600 rounded cursor-pointer"><label for="cart-print-receipt" class="text-[9px] font-black uppercase text-slate-300 cursor-pointer flex flex-col">Drukuj PARAGON <span id="receipt-req-info" class="text-red-500 text-[7px] hidden leading-none mt-1">(Wymagane dla kart!)</span></label></div>
-            </div>
-            <button onclick="submitFinalOrder()" class="w-full py-4 bg-green-600 rounded-xl font-black uppercase text-[11px] text-white shadow-lg hover:bg-green-500 transition">Wy┼Ťlij na Battlefield</button>
-        </div>
-    </div>
-
-    <div id="payment-modal" class="modal-overlay">
-        <div class="w-full max-w-xs bg-[#0a0f1c] rounded-[24px] p-6 border border-white/10 shadow-2xl text-center relative">
-            <h3 class="text-xl font-black uppercase italic mb-1 text-green-500">ROZLICZ / PARAGON</h3>
-            <p class="text-[9px] font-bold text-slate-400 uppercase mb-4 text-white">Zam├│wienie <span id="pay-acc-id" class="text-white"></span></p>
-            <div class="mb-4 text-left">
-                <p class="text-[8px] font-black uppercase text-slate-500 mb-2">Potwierd┼║ p┼éatno┼Ť─ç:</p>
-                <div class="grid grid-cols-2 gap-2">
-                    <button id="settle-btn-card" onclick="selectSettleMethod('card')" class="settle-opt py-3 rounded-lg font-black uppercase text-[9px] border border-white/10 bg-[#111827] text-white transition hover:bg-white/5"><i class="fa-solid fa-credit-card mr-1 text-blue-500"></i>Karta</button>
-                    <button id="settle-btn-cash" onclick="selectSettleMethod('cash')" class="settle-opt py-3 rounded-lg font-black uppercase text-[9px] border border-white/10 bg-[#111827] text-white transition hover:bg-white/5"><i class="fa-solid fa-money-bill-wave mr-1 text-green-500"></i>Got├│wka</button>
-                    <button id="settle-btn-online" onclick="selectSettleMethod('online')" class="settle-opt col-span-2 hidden py-3 rounded-lg font-black uppercase text-[9px] border border-white/10 bg-[#111827] text-white transition hover:bg-white/5"><i class="fa-solid fa-globe mr-1 text-purple-500"></i>Online</button>
-                </div>
-            </div>
-            <div class="flex items-center justify-center gap-2 mb-5 bg-black/30 p-3 rounded-lg border border-white/5">
-                <input type="checkbox" id="settle-print-receipt" class="w-4 h-4 accent-red-600 rounded cursor-pointer">
-                <label for="settle-print-receipt" class="text-[9px] font-black uppercase text-white cursor-pointer flex flex-col">Drukuj Paragon <span id="settle-req-info" class="text-red-500 text-[7px] hidden leading-none mt-1">(Wymagane)</span></label>
-            </div>
-            <button id="btn-settle-close" onclick="confirmPaymentAndClose()" class="w-full py-3 bg-green-600 rounded-lg font-black uppercase text-[10px] shadow-lg text-white hover:bg-green-500 transition mb-2">Zakończ i zamknij</button>
-            <button id="btn-settle-print" onclick="confirmPrintReceiptOnly()" class="w-full py-3 bg-white/10 border border-white/20 rounded-lg font-black uppercase text-[10px] shadow-lg text-white hover:bg-white/20 transition hidden">Tylko Drukuj Paragon</button>
-            <button onclick="document.getElementById('payment-modal').classList.remove('active')" class="text-[9px] font-black uppercase text-slate-500 mt-2 block mx-auto hover:text-white transition">Anuluj</button>
-        </div>
-    </div>
-
-    <div id="cancel-modal" class="modal-overlay">
-        <div class="w-full max-w-xs bg-[#0a0f1c] rounded-[24px] p-6 border border-red-500/50 shadow-2xl text-center relative">
-            <h3 class="text-xl font-black uppercase italic mb-1 text-red-500">ANULUJ ZAMÓWIENIE</h3>
-            <p class="text-[9px] font-bold text-slate-400 uppercase mb-4 text-white">Dla bonu <span id="cancel-acc-id" class="text-white"></span></p>
-            <div class="grid gap-2 mb-4">
-                <button onclick="confirmCancel(1)" class="py-3 bg-orange-600 rounded-lg font-black uppercase text-[9px] shadow-lg text-white hover:bg-orange-500 transition"><i class="fa-solid fa-rotate-left mr-1"></i>Zwr├│─ç na magazyn</button>
-                <button onclick="confirmCancel(0)" class="py-3 bg-red-800 rounded-lg font-black uppercase text-[9px] shadow-lg text-white hover:bg-red-700 transition"><i class="fa-solid fa-fire mr-1"></i>Odpisz jako strat─Ö</button>
-            </div>
-            <button onclick="document.getElementById('cancel-modal').classList.remove('active')" class="text-[9px] font-black uppercase text-slate-500 hover:text-white transition">Wr├│─ç</button>
-        </div>
-    </div>
-
-    <div id="dish-card" class="modal-overlay">
-        <div class="w-full max-w-3xl bg-[#0a0f1c] rounded-[32px] p-8 border border-white/10 shadow-2xl relative">
-            <button onclick="closeDishCard()" class="absolute top-6 right-6 w-10 h-10 rounded-full bg-white/5 flex items-center justify-center hover:bg-red-600 transition"><i class="fa-solid fa-xmark text-sm text-white"></i></button>
-            <div class="mb-6"><h3 id="dc-name" class="text-2xl font-black uppercase italic tracking-tighter text-white">Nazwa</h3><p id="dc-price" class="text-green-500 font-black text-lg mt-1"></p></div>
-            <div class="grid grid-cols-2 gap-8">
-                <div>
-                    <p class="text-[8px] font-black uppercase text-slate-500 mb-2 tracking-widest">Sk┼éadniki (Kliknij by usun─ů─ç)</p>
-                    <div id="dc-ingredients" class="flex flex-wrap gap-2 mb-4 min-h-[40px]"></div>
-                    <textarea id="dc-comment" placeholder="Komentarz..." class="w-full bg-white/5 border border-white/10 rounded-xl p-3 text-[10px] font-bold h-20 outline-none focus:border-red-500 text-white"></textarea>
-                </div>
-                <div class="flex flex-col justify-between">
-                    <div>
-                        <p class="text-[8px] font-black uppercase text-slate-500 mb-2 tracking-widest">Dodatki</p>
-                        <div id="dc-modifiers" class="space-y-2 max-h-[25vh] overflow-y-auto hide-scrollbar"></div>
-                    </div>
-                    <div class="flex items-center justify-between mt-6">
-                        <div class="flex items-center gap-3 bg-white/5 rounded-xl p-1.5">
-                            <button onclick="changeDcQty(-1)" class="w-8 h-8 rounded-lg bg-black flex items-center justify-center font-black text-white hover:bg-white/10 transition">-</button>
-                            <span id="dc-qty" class="text-lg font-black w-6 text-center text-white">1</span>
-                            <button onclick="changeDcQty(1)" class="w-8 h-8 rounded-lg bg-black flex items-center justify-center font-black text-white hover:bg-white/10 transition">+</button>
-                        </div>
-                        <button onclick="addDishToCart()" class="bg-red-600 px-6 py-3 rounded-xl font-black uppercase text-[9px] shadow-lg active:scale-95 transition text-white hover:bg-red-500">Zapisz</button>
-                    </div>
-                </div>
-            </div>
-        </div>
-    </div>
-
-    <div id="unified-order-modal" class="modal-overlay">
-        <div class="w-full max-w-5xl bg-[#0a0f1c] rounded-[32px] flex overflow-hidden border border-white/10 shadow-2xl relative h-[85vh]">
-            <button onclick="closeUnifiedModal()" class="absolute top-6 right-6 w-10 h-10 rounded-full bg-white/5 flex items-center justify-center hover:bg-red-600 transition z-50"><i class="fa-solid fa-xmark text-white"></i></button>
-            <div class="flex-1 p-8 flex flex-col border-r border-white/5 overflow-y-auto hide-scrollbar relative">
-                <div class="flex justify-between items-start mb-6">
-                    <div>
-                        <h2 id="uo-number" class="text-4xl font-black uppercase italic tracking-tighter text-blue-500 mb-1">#0000</h2>
-                        <div class="flex flex-wrap items-center gap-2 mt-2" id="uo-badges"></div>
-                    </div>
-                    <div class="text-right">
-                        <p class="text-[9px] font-black uppercase tracking-widest text-slate-500 mb-1">Czas Realizacji</p>
-                        <div id="uo-time" class="flex flex-col items-end text-white"></div>
-                    </div>
-                </div>
-                <div class="grid grid-cols-2 gap-3 mb-6">
-                    <div class="bg-black/40 p-4 rounded-xl border border-white/5 text-white"><p class="text-[8px] font-black uppercase tracking-widest text-slate-500 mb-2"><i class="fa-solid fa-user mr-1"></i> Klient / Adres</p><p id="uo-customer" class="font-bold text-xs mb-1"></p><p id="uo-address" class="text-[10px] font-bold text-slate-400"></p></div>
-                    <div class="bg-black/40 p-4 rounded-xl border border-white/5 text-white"><p class="text-[8px] font-black uppercase tracking-widest text-slate-500 mb-2"><i class="fa-solid fa-phone mr-1"></i> Kontakt</p><p id="uo-phone" class="font-black text-base tracking-widest"></p></div>
-                </div>
-                <div id="uo-kitchen-alert" class="hidden mb-4 bg-yellow-900/20 border border-yellow-500/50 p-3 rounded-lg"><p class="text-[9px] font-black uppercase text-yellow-500 mb-1"><i class="fa-solid fa-triangle-exclamation mr-2"></i>Wykryto Zmiany!</p><p id="uo-kitchen-diff" class="text-[10px] text-white font-bold"></p></div>
-                <div class="flex-1 flex flex-col">
-                    <p class="text-[9px] font-black uppercase tracking-widest text-slate-500 mb-2 border-b border-white/5 pb-2">Pozycje Zam├│wienia</p>
-                    <div id="uo-cart-items" class="space-y-2 flex-1 overflow-y-auto hide-scrollbar pb-4 text-white"></div>
-                </div>
-                <div class="pt-4 border-t border-white/5 flex justify-between items-end mt-auto">
-                    <span class="text-[10px] font-black uppercase tracking-widest text-slate-500">Warto┼Ť─ç:</span><span id="uo-total" class="text-4xl font-black italic text-green-500"></span>
-                </div>
-            </div>
-            <div class="w-72 bg-[#070b14] p-6 flex flex-col shrink-0 relative">
-                <h3 class="text-[9px] font-black uppercase tracking-widest text-slate-500 mb-4 pb-2 border-b border-white/5">Akcje Zam├│wienia</h3>
-                <div id="uo-actions" class="space-y-2 flex-1 flex flex-col"></div>
-            </div>
-        </div>
-    </div>
-
-    <iframe id="print-frame" style="display:none;"></iframe>
-	<script>
-    // ­čÜÇ SYSTEM POWIADOMIE┼â TOAST
-    function showToast(msg, type='info') {
-        const toast = document.createElement('div');
-        const color = type === 'error' ? 'bg-red-600' : (type === 'success' ? 'bg-green-600' : 'bg-blue-600');
-        toast.className = `${color} text-white px-4 py-2 rounded shadow-2xl font-black text-[10px] uppercase tracking-widest transform transition-all duration-300 translate-x-full border border-white/10 z-[9999]`;
-        toast.innerHTML = type === 'error' ? `<i class="fa-solid fa-triangle-exclamation mr-1"></i> ${msg}` : `<i class="fa-solid fa-check mr-1"></i> ${msg}`;
-        document.getElementById('toast-container').appendChild(toast);
-        setTimeout(()=>toast.classList.remove('translate-x-full'), 10);
-        setTimeout(()=> { toast.classList.add('translate-x-full'); setTimeout(()=>toast.remove(), 300); }, 3500);
-    }
-
-    // ­čÜÇ STAN APLIKACJI (Bez routeDriverId i routeOrders, bo s─ů w pos_fleet)
-    let state = { 
-        items: [], categories: [], orders: [], drivers: [], waiters: [], tables: [], cart: [], ingredients: [],
-        type: 'dine_in', activeItem: null, isHalfMode: false, halfA: null,
-        lastPlayedId: null, activeUnifiedId: null, panicMode: false, 
-        filterType: 'all', cartPayMethod: 'unpaid', cartPayStatus: 'unpaid', checkoutTimeMode: 'asap', checkoutTargetTime: new Date(),
-        editOrderId: null, isCartLocked: false, expandedOrderId: null, expandedOnlineId: null, settleOrderId: null, settleMethod: null
-    };
-
-    // ­čÜÇ API I INIT
-    async function apiPost(action, payload = {}) {
-        payload.action = action;
-        try {
-            const r = await fetch('api_pos.php', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(payload) });
-            return await r.json();
-        } catch(e) { return { status: 'error', error: 'B┼é─ůd po┼é─ůczenia z serwerem.' }; }
-    }
-
-    async function init() {
-        const d = await apiPost('get_init_data');
-        if (d.status === 'success') { 
-            const p = d.payload;
-            state.items = p.items; state.categories = p.categories; 
-            state.drivers = p.drivers; state.waiters = p.waiters || []; 
-            state.ingredients = p.ingredients; state.tables = p.tables;
-            const ts = document.getElementById('initial-table-select');
-            if(ts) state.tables.forEach(tbl => { ts.innerHTML += `<option value="Stolik: ${tbl.table_number}">Stolik ${tbl.table_number}</option>`; });
-            if(typeof renderDrivers === 'function') renderDrivers(); 
-            if(typeof renderWaiters === 'function') renderWaiters(); 
-            fetchOrders(); 
-        }
-    }
-
-    async function triggerPanic() {
-        if(!confirm("Dodać +20 minut do wszystkich zamówień w toku?")) return;
-        const d = await apiPost('panic_mode');
-        if(d.status === 'success') { showToast(d.payload.message, "success"); fetchOrders(); }
-    }
-
-    // ­čÜÇ POMOCNIKI CZASU I FORMATOWANIA
-    function formatOrderTime(dateStr, type) {
-        if (!dateStr) return { diffText: "ASAP", colorClass: "border-white/10", textClass: "text-white" };
-        const promised = new Date(dateStr); const now = new Date();
-        const diffM = Math.ceil((promised - now) / 60000); 
-        const diffText = `${diffM} MIN`;
-        let colorClass = "border-white/10"; let textClass = "text-white";
-
-        if (type === 'delivery') {
-            if (diffM > 59) { textClass = "text-green-500"; }
-            else if (diffM >= 15) { textClass = "text-yellow-500"; }
-            else { textClass = "text-red-500 blink-red"; colorClass = "border-red-500 blink-border-red"; }
-        } else {
-            if (diffM > 14) { textClass = "text-green-500"; }
-            else if (diffM >= 6) { textClass = "text-yellow-500"; }
-            else { textClass = "text-red-500 blink-red"; colorClass = "border-red-500 blink-border-red"; }
-        }
-        return { diffText, colorClass, textClass };
-    }
-
-    function formatOrderNumber(orderNum, dateStr) {
-        const num = orderNum.split('/').pop() || orderNum;
-        const dDate = new Date(dateStr || new Date()); const now = new Date();
-        const isToday = dDate.getDate() === now.getDate() && dDate.getMonth() === now.getMonth() && dDate.getFullYear() === now.getFullYear();
-        if (isToday) return `#${num}`;
-        return `${String(dDate.getDate()).padStart(2, '0')}.${String(dDate.getMonth() + 1).padStart(2, '0')} #${num}`;
-    }
-
-    function setFilter(type) { 
-        state.filterType = type; 
-        document.querySelectorAll('#flt-all, #flt-dev, #flt-sala, #flt-wynos, #flt-routes, #flt-future').forEach(el => { 
-            el.classList.remove('bg-white/10', 'text-white', 'filter-highlight', 'border-blue-500/30', 'bg-blue-900/20', 'shadow-[0_0_10px_rgba(59,130,246,0.1)]'); 
-            el.classList.add('text-slate-400'); 
-            if(el.id === 'flt-routes') el.classList.add('text-blue-400');
-        });
-        const activeBtn = document.getElementById(`flt-${type === 'all' ? 'all' : type === 'delivery' ? 'dev' : type}`);
-        if(activeBtn) { 
-            activeBtn.classList.remove('text-slate-400', 'text-blue-400');
-            activeBtn.classList.add('text-white'); 
-            if(type === 'all') { activeBtn.classList.add('filter-highlight'); } 
-            else if(type === 'routes') { activeBtn.classList.add('border-blue-500/30', 'bg-blue-900/20', 'shadow-[0_0_10px_rgba(59,130,246,0.1)]'); }
-            else { activeBtn.classList.add('bg-white/10'); }
-        }
-        renderOrders(); 
-    }
-
-    async function fetchOrders() {
-        const d = await apiPost('get_orders');
-        if(d.status === 'success') { 
-            state.orders = d.payload.orders; 
-            renderOrders(); 
-            if(typeof renderDrivers === 'function') renderDrivers();
-            if(state.activeUnifiedId && typeof openUnifiedModal === 'function') openUnifiedModal(state.activeUnifiedId, false);
-        }
-    }
-
-    function toggleExpandOrder(id, ev) { if(ev) ev.stopPropagation(); state.expandedOrderId = state.expandedOrderId === id ? null : id; renderOrders(); }
-    function toggleOnlineExpand(id, ev) { if(ev) ev.stopPropagation(); state.expandedOnlineId = state.expandedOnlineId === id ? null : id; renderOrders(); }
-
-    async function submitPulseAccept(id, mins, event) {
-        if(event) event.stopPropagation();
-        let targetTime = new Date();
-        targetTime.setMinutes(targetTime.getMinutes() + mins);
-        const iso = new Date(targetTime.getTime() - (targetTime.getTimezoneOffset() * 60000)).toISOString().slice(0, 16);
-        await apiPost('accept_order', {order_id: id, custom_time: iso});
-        state.expandedOnlineId = null;
-        fetchOrders();
-    }
-    
-    async function submitPulseAcceptDate(id, dateStr, event) {
-        if(event) event.stopPropagation();
-        if(!dateStr) return;
-        await apiPost('accept_order', {order_id: id, custom_time: dateStr});
-        state.expandedOnlineId = null;
-        fetchOrders();
-    }
-
-    // ­čÜÇ G┼ü├ôWNY RENDERER BON├ôW
-    function renderOrders() {
-        const grid = document.getElementById('bf-grid');
-        let htmlsPulse = { delivery: '', takeaway: '', dinein: '' }; 
-        let kanban = { delivery: '', takeaway: '', dinein: '' }; 
-        let routeGroups = {}; 
-        
-        let pCount = 0; let counts = { all: 0, dev: 0, sala: 0, wynos: 0, routes: 0, future: 0 };
-        const now = new Date();
-
-        state.orders.forEach(o => {
-            const promised = new Date(o.promised_time || now);
-            const isFuture = (promised - now) > (24 * 60 * 60 * 1000); 
-            const isInRoute = (o.status === 'in_delivery');
-            const isDelivered = (o.status === 'delivered');
-
-            if (isDelivered) return; 
-
-            if(!(o.source !== 'local' && o.status === 'new')) {
-                if(isInRoute) {
-                    counts.routes++; 
-                    let key = o.course_id || 'K?';
-                    if (!routeGroups[key]) routeGroups[key] = { driver: o.driver_id, items: [], totalCash: 0, time: o.created_at };
-                    routeGroups[key].items.push(o);
-                    if (o.payment_method === 'cash' || o.payment_status !== 'paid') { routeGroups[key].totalCash += parseFloat(o.total_price); }
-                } else if(isFuture) { counts.future++; } 
-                else { 
-                    counts.all++; 
-                    if(o.type==='delivery') counts.dev++; 
-                    if(o.type==='dine_in') counts.sala++; 
-                    if(o.type==='takeaway') counts.wynos++; 
-                }
-            }
-
-            // PANEL ONLINE
-            if(o.source !== 'local' && o.status === 'new') {
-                pCount++;
-                if(state.lastPlayedId !== o.id) { document.getElementById('alert-sound').play().catch(()=>{}); state.lastPlayedId = o.id; }
-                const reqTime = o.promised_time ? o.promised_time.substring(11, 16) : 'ASAP';
-                let sourceBadge = o.source === 'qr' ? `<i class="fa-solid fa-qrcode text-slate-400 mr-1"></i>` : `<i class="fa-solid fa-globe text-slate-400 mr-1"></i>`;
-                
-                let isOnlineExpanded = state.expandedOnlineId === o.id;
-                let elapsedM = Math.floor((now - new Date(o.created_at)) / 60000);
-                let borderClass = elapsedM > 3 ? 'border-red-500 blink-border-red' : 'border-slate-500/50';
-
-                let expandHtml = '';
-                if (isOnlineExpanded) {
-                    let cartDetails = '';
-                    try { let c = JSON.parse(o.cart_json || '[]'); cartDetails = c.map(item => `<div class="flex justify-between text-[8px] text-slate-300"><span>${item.qty}x ${item.name}</span><span>${(item.price*item.qty).toFixed(2)}zł</span></div>`).join(''); } catch(e) {}
-                    
-                    expandHtml = `
-                    <div class="mt-2 pt-2 border-t border-white/10" onclick="event.stopPropagation()">
-                        <div class="mb-2 bg-black/50 p-1.5 rounded border border-white/5">${cartDetails}</div>
-                        <p class="text-[7px] text-slate-400 uppercase mb-1 font-bold">Wybierz czas dla klienta:</p>
-                        <div class="grid grid-cols-3 gap-1 mb-1.5">
-                            <button onclick="submitPulseAccept(${o.id}, 15, event)" class="bg-white/10 hover:bg-blue-600 rounded py-1.5 text-[9px] font-black transition text-white">+15m</button>
-                            <button onclick="submitPulseAccept(${o.id}, 30, event)" class="bg-white/10 hover:bg-blue-600 rounded py-1.5 text-[9px] font-black transition text-white">+30m</button>
-                            <button onclick="submitPulseAccept(${o.id}, 45, event)" class="bg-white/10 hover:bg-blue-600 rounded py-1.5 text-[9px] font-black transition text-white">+45m</button>
-                        </div>
-                        <label class="flex w-full bg-black border border-white/10 rounded py-1.5 mb-2 justify-center cursor-pointer hover:border-blue-500 transition relative">
-                            <span class="text-[8px] font-black uppercase text-blue-400"><i class="fa-regular fa-calendar-days mr-1"></i> Własna Godzina</span>
-                            <input type="datetime-local" onchange="submitPulseAcceptDate(${o.id}, this.value, event)" class="absolute inset-0 opacity-0 cursor-pointer w-full h-full">
-                        </label>
-                        <button onclick="submitPulseAccept(${o.id}, 0, event)" class="w-full bg-green-600 hover:bg-green-500 rounded py-2 text-[9px] font-black uppercase shadow-lg transition text-white"><i class="fa-solid fa-check mr-1"></i> ZAAKCEPTUJ: ${reqTime}</button>
-                    </div>`;
-                }
-
-                const card = `
-                <div class="glass rounded border border-l-[3px] ${borderClass} flex flex-col transition-all bg-black/40 cursor-pointer hover:bg-white/5" onclick="toggleOnlineExpand(${o.id}, event)">
-                    <div class="p-2">
-                        <div class="flex justify-between items-start mb-0.5">
-                            <h4 class="font-black text-white text-[11px] leading-none">${formatOrderNumber(o.order_number, o.created_at)}</h4>
-                            <span class="text-green-500 font-black text-[9px]">${o.total_price}zł</span>
-                        </div>
-                        <div class="flex justify-between items-end mt-1">
-                            <div class="text-[8px] text-slate-400 font-bold truncate pr-2">${sourceBadge} ${o.customer_name || 'Nowe Zam├│wienie'}</div>
-                            <span class="text-[8px] text-white font-bold bg-black/50 px-1.5 py-0.5 rounded border border-white/10 shrink-0"><i class="fa-solid fa-clock text-slate-500 mr-0.5"></i>${reqTime}</span>
-                        </div>
-                        ${expandHtml}
-                    </div>
-                </div>`;
-                if(o.type==='delivery') htmlsPulse.delivery += card; else if(o.type==='takeaway') htmlsPulse.takeaway += card; else htmlsPulse.dinein += card;
-                return;
-            }
-
-            // SUROWE KARTY KANBAN
-            if(isInRoute) return; 
-            if(state.filterType === 'routes') return; 
-            if(state.filterType === 'future' && !isFuture) return; 
-            if(state.filterType !== 'future' && state.filterType !== 'all' && isFuture) return;
-            if(state.filterType === 'delivery' && o.type !== 'delivery') return; 
-            if(state.filterType === 'sala' && o.type !== 'dine_in') return; 
-            if(state.filterType === 'wynos' && o.type !== 'takeaway') return;
-
-            const timeInfo = formatOrderTime(o.promised_time || o.created_at, o.type);
-            let sourceText = o.source === 'waiter' ? `<i class="fa-solid fa-user-tie"></i> KELNER` : (o.source === 'qr' ? `<i class="fa-solid fa-qrcode"></i> QR` : `<i class="fa-solid fa-desktop"></i> POS`);
-            
-            let payStatusText = o.payment_status === 'paid' ? `ZAPŁACONE (${o.payment_method.toUpperCase()})` : `DO ZAPŁATY`;
-            let payStatusClass = o.payment_status === 'paid' ? "text-green-500" : "text-red-500 blink-red";
-
-            let smallIcons = '';
-            if(o.receipt_printed == 1) smallIcons += '<span class="status-badge mr-1">PARAGON</span>';
-            if(o.kitchen_ticket_printed == 1) smallIcons += `<span class="status-badge ${o.edited_since_print == 1 ? 'alert' : ''} mr-1">BON</span>`;
-
-            let cartSnippet = ''; 
-            let fullCartDetails = '';
-            try { 
-                let c = JSON.parse(o.cart_json || '[]'); 
-                cartSnippet = c.map(item => `${item.qty}x ${item.name}`).join(', ');
-                fullCartDetails = c.map(item => {
-                    let comment = item.comment ? `<span class="text-yellow-500 text-[8px] italic ml-2">(${item.comment})</span>` : '';
-                    return `<div class="flex justify-between border-b border-white/5 py-1 text-[10px] text-white"><span><span class="font-black text-slate-400">${item.qty}x</span> ${item.name} ${comment}</span><span class="font-black text-green-500">${(item.price*item.qty).toFixed(2)}zł</span></div>`;
-                }).join('');
-            } catch(e) {}
-
-            let isExpanded = state.expandedOrderId === o.id;
-            
-            // UWAGA: Logika odczytuj─ůca stan z pos_fleet.js, u┼╝ywamy state.routeDriverId (kt├│ry istnieje w global scope)
-            let isRouteMode = (typeof state.routeDriverId !== 'undefined' && state.routeDriverId !== null) && o.type === 'delivery';
-            let clickAction = isRouteMode ? `toggleOrderToRoute(${o.id}, event)` : `toggleExpandOrder(${o.id}, event)`;
-
-            let expandedHtml = '';
-            if (isExpanded && !isRouteMode) {
-                let pColor = (o.kitchen_ticket_printed == 0 || o.edited_since_print == 1) ? 'bg-yellow-600 text-white shadow-[0_0_10px_rgba(202,138,4,0.4)]' : 'bg-white/10 text-slate-300';
-                let bTxt = (o.edited_since_print == 1 && o.kitchen_ticket_printed == 1) ? "Drukuj Zmiany" : "Drukuj Kuchnia";
-                
-                expandedHtml = `
-                <div class="mt-3 pt-3 border-t border-white/10" onclick="event.stopPropagation()">
-                    <div class="mb-3 bg-black/50 p-2 rounded-lg border border-white/5">${fullCartDetails || '<span class="text-[9px] text-slate-500 italic">Pusty koszyk</span>'}</div>
-                    <div class="grid grid-cols-3 gap-2 mb-2">
-                        <button onclick="printKitchenTicket(${o.id}, event)" class="${pColor} py-2 rounded text-[8px] font-black uppercase transition hover:opacity-80"><i class="fa-solid fa-print block mb-1 text-[10px]"></i> ${bTxt}</button>
-                        <button onclick="openPaymentModal(${o.id}, 'print', event)" class="bg-white/10 text-slate-300 border border-white/5 py-2 rounded text-[8px] font-black uppercase transition hover:bg-white/20 hover:text-white"><i class="fa-solid fa-receipt block mb-1 text-[10px]"></i> Paragon</button>
-                        <button onclick="openEditInCart(${o.id})" class="bg-white/10 text-slate-300 border border-white/5 py-2 rounded text-[8px] font-black uppercase transition hover:bg-white/20 hover:text-white"><i class="fa-solid fa-pen block mb-1 text-[10px]"></i> Edytuj</button>
-                    </div>
-                    <div class="flex gap-2">
-                        <button onclick="openPaymentModal(${o.id}, 'settle', event)" class="flex-1 bg-red-600 hover:bg-red-500 text-white py-3 rounded font-black uppercase text-[11px] shadow-lg transition active:scale-95"><i class="fa-solid fa-cash-register mr-1"></i> ZAMKNIJ ZAMÓWIENIE</button>
-                        <button onclick="openCancelModal(${o.id})" class="w-12 bg-black/40 border border-white/10 text-slate-500 hover:text-red-500 hover:border-red-500/50 transition rounded-lg flex items-center justify-center text-sm" title="Anuluj Bon"><i class="fa-solid fa-trash"></i></button>
-                    </div>
-                </div>`;
-            }
-
-            let clientLine = o.type === 'delivery' ? `<i class="fa-solid fa-location-dot mr-1 text-[9px]"></i> ${o.address}` : `<i class="fa-solid fa-user mr-1 text-[9px]"></i> ${o.customer_name || 'Go┼Ť─ç'}`;
-            if (o.type === 'takeaway') clientLine += ` <span class="text-[7px] text-slate-400 border border-white/10 bg-black/40 px-1 py-0.5 rounded ml-2">ŚR: 85zł</span>`;
-            
-            let lBadge = ''; 
-            const numId = Number(o.id);
-            if (typeof state.routeOrders !== 'undefined' && state.routeOrders.includes(numId)) { 
-                let lIndex = state.routeOrders.indexOf(numId) + 1; 
-                lBadge = `<div class="absolute -top-1.5 -left-1.5 w-6 h-6 bg-blue-600 rounded-full flex items-center justify-center font-black text-white border-[2px] border-[#0a0f1c] shadow-lg z-20 text-[10px]">L${lIndex}</div>`; 
-            }
-
-            let isSelectedClass = (typeof state.routeOrders !== 'undefined' && state.routeOrders.includes(numId)) ? 'selected' : '';
-
-            const card = `
-            <div class="compact-card border-t-[3px] border-l-0 border-r-0 border-b-0 ${timeInfo.colorClass} mb-2.5 group cursor-pointer ${isSelectedClass}" onclick="${clickAction}">
-                ${lBadge}
-                <div class="flex justify-between items-start">
-                    <div class="flex-1 overflow-hidden pr-2">
-                        <div class="flex items-center gap-2 mb-1.5">
-                            <h4 class="text-[16px] font-black text-white leading-none tracking-tight">${formatOrderNumber(o.order_number, o.created_at)}</h4>
-                            <div class="flex gap-1 items-center ml-1">${smallIcons}</div>
-                        </div>
-                        <div class="text-[11px] font-bold text-white truncate mb-0.5">${clientLine}</div>
-                        <div class="text-[9px] text-slate-500 truncate max-w-[90%]"><i class="fa-solid fa-basket-shopping text-slate-600 mr-1"></i> ${cartSnippet}</div>
-                    </div>
-                    <div class="text-right shrink-0 flex flex-col items-end min-h-[50px] justify-between">
-                        <div class="flex items-center gap-2 mb-1">
-                            <span class="text-[7px] font-black uppercase text-slate-500">${sourceText}</span>
-                            <span class="text-[18px] font-black leading-none ${timeInfo.textClass}">${timeInfo.diffText}</span>
-                        </div>
-                        <span class="text-[20px] font-black text-white italic leading-none my-1">${o.total_price} <span class="text-[10px] not-italic text-slate-500 normal-case">zł</span></span>
-                        <span class="text-[7px] font-black uppercase ${payStatusClass} bg-black/40 px-1.5 py-0.5 rounded border border-white/5 mt-auto">${payStatusText}</span>
-                    </div>
-                </div>
-                ${expandedHtml}
-            </div>`;
-            
-            if (o.type === 'delivery') kanban.delivery += card; 
-            else if (o.type === 'takeaway') kanban.takeaway += card; 
-            else kanban.dinein += card;
-        });
-
-        // Wrzucanie na ekran (bez kolor├│w)
-        document.getElementById('pulse-list-delivery').innerHTML = htmlsPulse.delivery || '<p class="text-center py-2 text-slate-700 text-[8px] font-bold uppercase">Brak</p>';
-        document.getElementById('pulse-list-takeaway').innerHTML = htmlsPulse.takeaway || '<p class="text-center py-2 text-slate-700 text-[8px] font-bold uppercase">Brak</p>';
-        document.getElementById('pulse-list-dinein').innerHTML = htmlsPulse.dinein || '<p class="text-center py-2 text-slate-700 text-[8px] font-bold uppercase">Brak</p>';
-
-        if (state.filterType === 'routes') {
-            // Bezpieczne wpięcie zewnętrznego modułu Battlefield
-            if (typeof renderActiveRoutes === 'function') {
-                renderActiveRoutes();
-            } else {
-                grid.innerHTML = '<div class="text-center mt-12 text-slate-500 font-black uppercase text-xs">Ładowanie modułu Battlefield...</div>';
-            }
-        } else if (state.filterType === 'all' || state.filterType === 'future') {
-            grid.innerHTML = `
-            <div class="grid grid-cols-1 md:grid-cols-3 gap-3 h-full items-start min-w-[700px]">
-                <div class="kanban-col"><div class="p-3 border-b border-white/5 bg-black/40 flex justify-between items-center"><h3 class="font-black text-[10px] tracking-widest text-slate-400 uppercase"><i class="fa-solid fa-motorcycle mr-1.5"></i> Dow├│z</h3><span class="bg-white/10 text-white px-2.5 py-0.5 rounded text-[9px] font-black">${counts.dev}</span></div><div class="flex-1 overflow-y-auto p-2.5 space-y-2.5 hide-scrollbar">${kanban.delivery || '<p class="text-center mt-5 text-slate-600 text-[9px] font-black uppercase">Brak</p>'}</div></div>
-                <div class="kanban-col"><div class="p-3 border-b border-white/5 bg-black/40 flex justify-between items-center"><h3 class="font-black text-[10px] tracking-widest text-slate-400 uppercase"><i class="fa-solid fa-bag-shopping mr-1.5"></i> Wynos</h3><span class="bg-white/10 text-white px-2.5 py-0.5 rounded text-[9px] font-black">${counts.wynos}</span></div><div class="flex-1 overflow-y-auto p-2.5 space-y-2.5 hide-scrollbar">${kanban.takeaway || '<p class="text-center mt-5 text-slate-600 text-[9px] font-black uppercase">Brak</p>'}</div></div>
-                <div class="kanban-col"><div class="p-3 border-b border-white/5 bg-black/40 flex justify-between items-center"><h3 class="font-black text-[10px] tracking-widest text-slate-400 uppercase"><i class="fa-solid fa-utensils mr-1.5"></i> Sala</h3><span class="bg-white/10 text-white px-2.5 py-0.5 rounded text-[9px] font-black">${counts.sala}</span></div><div class="flex-1 overflow-y-auto p-2.5 space-y-2.5 hide-scrollbar">${kanban.dinein || '<p class="text-center mt-5 text-slate-600 text-[9px] font-black uppercase">Brak</p>'}</div></div>
-            </div>`;
-        } else {
-            let singleHtml = (state.filterType === 'delivery') ? kanban.delivery : (state.filterType === 'wynos') ? kanban.takeaway : kanban.dinein;
-            grid.innerHTML = `<div class="grid grid-cols-1 md:grid-cols-2 xl:grid-cols-3 gap-3 items-start">${singleHtml || '<div class="col-span-full text-center mt-12 text-slate-600 text-[11px] font-black uppercase">Brak Zamówień</div>'}</div>`;
-        }
-
-        document.getElementById('pulse-counter').innerText = pCount; document.getElementById('pulse-counter').classList.toggle('hidden', pCount === 0);
-        document.getElementById('flt-all').innerText = `WSZYSTKIE (${counts.all})`; document.getElementById('flt-dev').innerText = `­čŤÁ DOW├ôZ (${counts.dev})`; document.getElementById('flt-sala').innerText = `­čŹŻ´ŞĆ SALA (${counts.sala})`; document.getElementById('flt-wynos').innerText = `­čąí WYNOS (${counts.wynos})`; document.getElementById('flt-routes').innerText = `­čÜŚ KURSY (${counts.routes})`; document.getElementById('flt-future').innerText = `­čôů PRZYSZ┼üE (${counts.future})`;
-    }
-		// ­čÜÇ UNIFIED MODAL (PE┼üNA KARTA ZAM├ôWIENIA)
-    function openUnifiedModal(id, forceOpen = true) {
-        const o = state.orders.find(x => x.id == id); 
-        if(!o) return; 
-        state.activeUnifiedId = id;
-
-        document.getElementById('uo-number').innerText = "#" + o.order_number.split('/').pop();
-        document.getElementById('uo-customer').innerText = o.customer_name || 'Go┼Ť─ç';
-        document.getElementById('uo-address').innerText = o.address || 'Brak Adresu';
-        document.getElementById('uo-phone').innerText = o.customer_phone || 'Brak Telefonu';
-        document.getElementById('uo-total').innerHTML = `${o.total_price} <span class="text-sm">zł</span>`;
-        
-        let actions = document.getElementById('uo-actions');
-        let btns = `<button onclick="printKitchenTicket(${o.id}, null)" class="w-full py-4 bg-white/10 hover:bg-white/20 transition rounded-xl font-black text-[10px] uppercase text-white mb-3 shadow-md"><i class="fa-solid fa-print mr-2"></i> Drukuj Bon na Kuchni─Ö</button>`;
-        btns += `<button onclick="openEditInCart(${o.id})" class="w-full py-4 bg-blue-900/40 text-blue-400 hover:bg-blue-600 hover:text-white transition rounded-xl font-black text-[10px] uppercase mb-3 shadow-md border border-blue-500/30"><i class="fa-solid fa-pen mr-2"></i> Edytuj Zam├│wienie</button>`;
-        btns += `<div class="flex-1"></div>`;
-        btns += `<button onclick="openPaymentModal(${o.id}, 'settle', null)" class="w-full py-6 bg-red-600 hover:bg-red-500 transition rounded-2xl font-black uppercase text-[12px] text-white mb-3 shadow-[0_0_20px_rgba(239,68,68,0.3)] active:scale-95"><i class="fa-solid fa-cash-register mr-2"></i> ZAMKNIJ BON / KASA</button>`;
-        btns += `<button onclick="openCancelModal(${o.id})" class="w-full py-3 text-slate-500 hover:text-red-500 transition text-[9px] font-black uppercase border border-transparent hover:border-red-500/30 rounded-xl bg-black/30">Anuluj Zam├│wienie</button>`;
-        actions.innerHTML = btns;
-
-        if(forceOpen) document.getElementById('unified-order-modal').classList.add('active');
-    }
-
-    function closeUnifiedModal() { 
-        document.getElementById('unified-order-modal').classList.remove('active'); 
-        state.activeUnifiedId = null; 
-    }
-
-    // ­čÜÇ KREATOR I KOSZYK
-    function openOrderTypeSelector() { 
-        document.getElementById('initial-table-select').value = ""; 
-        document.getElementById('table-selection-div').classList.add('hidden'); 
-        document.getElementById('order-type-modal').classList.add('active'); 
-    }
-
-    function selectInitialOrderType(type) { 
-        if(type === 'dine_in') {
-            document.getElementById('table-selection-div').classList.remove('hidden'); 
-        } else { 
-            document.getElementById('order-type-modal').classList.remove('active'); 
-            openNewOrder(type, ""); 
-        } 
-    }
-
-    function confirmInitialTable() { 
-        const tbl = document.getElementById('initial-table-select').value; 
-        if(!tbl) return showToast("Wybierz stolik z listy!", "error"); 
-        document.getElementById('order-type-modal').classList.remove('active'); 
-        openNewOrder('dine_in', tbl); 
-    }
-    
-    function openNewOrder(type = 'takeaway', tableStr = '') { 
-        state.cart = []; state.editOrderId = null; state.isCartLocked = false;
-        document.getElementById('edit-mode-badge').classList.add('hidden');
-        document.getElementById('cust-addr').value = tableStr; 
-        document.getElementById('cust-phone').value = ""; 
-        document.getElementById('cust-nip').value = "";
-        setOrderType(type, document.querySelector(`.type-${type}`)); 
-        document.getElementById('order-overlay').classList.add('active'); 
-        renderCats(); updateCartUI(); 
-    }
-
-    function closeNewOrder() { document.getElementById('order-overlay').classList.remove('active'); }
-
-    function setOrderType(t, btn) { 
-        state.type = t; 
-        document.querySelectorAll('.type-btn').forEach(b => b.classList.replace('bg-blue-600', 'bg-white/5')); 
-        btn.classList.replace('bg-white/5', 'bg-blue-600'); 
-        document.getElementById('delivery-fields').classList.toggle('hidden', t !== 'delivery'); 
-    }
-
-    function renderCats() { 
-        document.getElementById('cat-list').innerHTML = state.categories.map(c => 
-            `<button onclick="renderItems(${c.id})" class="px-5 py-3 bg-white/5 rounded-xl text-[10px] font-black uppercase shrink-0 hover:bg-red-600 transition text-white border border-white/5 shadow-sm">${c.name_utf8}</button>`
-        ).join(''); 
-        if(state.categories.length) renderItems(state.categories[0].id); 
-    }
-
-    function renderItems(cid) { 
-        document.getElementById('item-grid').innerHTML = state.items.filter(i => i.category_id == cid).map(i => 
-            `<div onclick="clickItem(${i.id})" class="glass p-4 rounded-2xl h-28 flex flex-col justify-between cursor-pointer active:scale-95 transition hover:border-red-500 shadow-sm border border-white/5 bg-black/30">
-                <h5 class="text-[10px] font-black uppercase leading-tight text-white">${i.name}</h5>
-                <span class="text-green-500 font-black text-xs italic">${i.price} zł</span>
-            </div>`
-        ).join(''); 
-    }
-
-    function toggleHalfMode() { 
-        state.isHalfMode = !state.isHalfMode; state.halfA = null; 
-        
-        // Poniewa┼╝ przycisk znikn─ů┼é, dodajemy powiadomienie Toast, ┼╝eby kelner wiedzia┼é, co si─Ö dzieje
-        if(state.isHalfMode) {
-            showToast("Tryb po┼é├│wek w┼é─ůczony. Wybierz pierwsz─ů cz─Ö┼Ť─ç.", "info");
-        } else {
-            showToast("Tryb po┼é├│wek wy┼é─ůczony.", "info");
-        }
-    }
-
-    function clickItem(id) { 
-    const item = state.items.find(i => i.id == id);
-    
-    // ­čÜĘ Je┼Ťli klikni─Öto produkt typu 'half_half', a tryb nie jest jeszcze aktywny
-    if (item.type === 'half_half' && !state.isHalfMode) {
-        toggleHalfMode();
-        return;
-    }
-
-    if(state.isHalfMode) { 
-        if(!state.halfA) { 
-            state.halfA = item; 
-            showToast(`Wybrano: ┬Ż ${item.name}. Kliknij drug─ů po┼éow─Ö.`, "info"); 
-        } else { 
-            openHalfDishCard(state.halfA, item); 
-            state.halfA = null; 
-            state.isHalfMode = false; 
-            const btn = document.getElementById('btn-half');
-            if(btn) btn.classList.remove('bg-orange-500/20', 'text-white', 'border-orange-500'); 
-        } 
-    } else { 
-        openDishCard(id); 
-    } 
-}
-
-    async function openHalfDishCard(itemA, itemB) { 
-        const price = Math.max(parseFloat(itemA.price), parseFloat(itemB.price)) + 2.00; 
-        state.activeItem = { id: null, name: `┬Ż ${itemA.name} + ┬Ż ${itemB.name}`, price: price.toFixed(2), qty: 1, removed: [], added: [], comment: "", is_half: true, half_a: itemA.id, half_b: itemB.id, cart_id: Date.now() }; 
-        document.getElementById('dc-name').innerText = state.activeItem.name; document.getElementById('dc-price').innerText = state.activeItem.price + " zł"; 
-        document.getElementById('dc-qty').innerText = "1"; document.getElementById('dc-comment').value = ""; document.getElementById('dish-card').classList.add('active'); 
-        try { 
-            const d = await apiPost('get_item_details', {item_id: itemA.id, half_b_id: itemB.id}); 
-            if (d.status === 'success') { 
-                document.getElementById('dc-ingredients').innerHTML = d.payload.ingredients.map(ing => { 
-                    const prefix = ing.half === 'A' ? `[┬Ż ${itemA.name}] ` : `[┬Ż ${itemB.name}] `; 
-                    return `<div class="ing-chip bg-white/10 px-3 py-2 rounded-lg text-[9px] font-black uppercase flex items-center gap-1.5 cursor-pointer border border-white/5 text-slate-300 hover:text-white" onclick="this.classList.toggle('opacity-30'); this.classList.toggle('line-through'); this.classList.toggle('text-red-500'); toggleRem(${ing.product_id})">${prefix}${ing.name_utf8}</div>`; 
-                }).join(''); 
-                document.getElementById('dc-modifiers').innerHTML = renderModifiers(); 
-            } 
-        } catch(e) {} 
-    }
-
-    async function openDishCard(id) { 
-        const item = state.items.find(i => i.id == id); 
-        state.activeItem = { ...item, qty: 1, removed: [], added: [], comment: "", cart_id: Date.now() }; 
-        document.getElementById('dc-name').innerText = item.name; document.getElementById('dc-price').innerText = item.price + " zł"; 
-        document.getElementById('dc-qty').innerText = "1"; document.getElementById('dc-comment').value = ""; document.getElementById('dish-card').classList.add('active'); 
-        try { 
-            const d = await apiPost('get_item_details', {item_id: id}); 
-            if (d.status === 'success') { 
-                document.getElementById('dc-ingredients').innerHTML = d.payload.ingredients.map(ing => 
-                    `<div class="ing-chip bg-white/10 px-3 py-2 rounded-lg text-[9px] font-black uppercase flex items-center gap-1.5 cursor-pointer border border-white/5 text-slate-300 hover:text-white transition" onclick="this.classList.toggle('opacity-30'); this.classList.toggle('line-through'); this.classList.toggle('text-red-500'); toggleRem(${ing.product_id})">${ing.name_utf8}</div>`
-                ).join(''); 
-                document.getElementById('dc-modifiers').innerHTML = renderModifiers(); 
-            } 
-        } catch(e) {} 
-    }
-
-    function renderModifiers() { 
-        return state.ingredients.map(ing => `<label class="flex items-center gap-3 bg-black/50 p-3 rounded-xl cursor-pointer border border-white/5 hover:bg-white/5 transition"><input type="checkbox" value="${ing.id}" onchange="toggleAddMod(this)" class="w-4 h-4 accent-red-500"><span class="text-[9px] font-bold uppercase truncate text-white">${ing.name} <span class="text-green-500 ml-1">(+4zł)</span></span></label>`).join(''); 
-    }
-
-    function toggleAddMod(cb) { 
-        const id = parseInt(cb.value); 
-        if(cb.checked) { state.activeItem.added.push(id); state.activeItem.price = (parseFloat(state.activeItem.price) + 4.00).toFixed(2); } 
-        else { state.activeItem.added = state.activeItem.added.filter(x => x !== id); state.activeItem.price = (parseFloat(state.activeItem.price) - 4.00).toFixed(2); } 
-        document.getElementById('dc-price').innerText = state.activeItem.price + " zł"; 
-    }
-
-    function toggleRem(id) { 
-        if(state.activeItem.removed.includes(id)) { state.activeItem.removed = state.activeItem.removed.filter(x=>x!==id); } else { state.activeItem.removed.push(id); }
-    }
-
-    function changeDcQty(v) { state.activeItem.qty = Math.max(1, state.activeItem.qty + v); document.getElementById('dc-qty').innerText = state.activeItem.qty; }
-
-    function addDishToCart() { 
-        state.activeItem.comment = document.getElementById('dc-comment').value; 
-        const existingIndex = state.cart.findIndex(c => c.cart_id === state.activeItem.cart_id); 
-        if(existingIndex >= 0) { state.cart[existingIndex] = state.activeItem; } else { state.cart.push(state.activeItem); }
-        updateCartUI(); closeDishCard(); 
-    }
-
-    function closeDishCard() { document.getElementById('dish-card').classList.remove('active'); }
-
-    function updateCartUI() { 
-        const list = document.getElementById('cart-items'); let total = 0; 
-        list.innerHTML = state.cart.map(i => { 
-            total += (parseFloat(i.price) * i.qty); 
-            const addedNames = i.added.map(addId => { const ing = state.ingredients.find(x => x.id == addId); return ing ? ing.name : ''; }).filter(x=>x); 
-            return `
-            <div class="bg-black/40 p-3 rounded-xl flex justify-between items-start border-l-[3px] border-red-500 border border-white/5 shadow-sm ${state.isCartLocked ? 'opacity-50' : 'cursor-pointer hover:bg-white/5'}" ${state.isCartLocked ? '' : `onclick="editCartItem(${i.cart_id})"`}>
-                <div class="w-3/4">
-                    <p class="text-[10px] font-black uppercase text-white"><span class="text-blue-400 mr-1">${i.qty}x</span> ${i.name}</p>
-                    ${i.removed && i.removed.length ? `<p class="text-[8px] text-red-500 font-bold uppercase mt-1">- Bez ${i.removed.length} składników</p>` : ''}
-                    ${addedNames.length ? `<p class="text-[8px] text-green-500 font-bold uppercase mt-1">+ Dodatki: ${addedNames.join(', ')}</p>` : ''}
-                    ${i.comment ? `<p class="text-[8px] text-yellow-500 font-bold uppercase mt-1">Uwagi: ${i.comment}</p>` : ''}
-                </div>
-                <div class="text-right flex flex-col items-end justify-between">
-                    <p class="text-[12px] font-black text-white">${(i.price*i.qty).toFixed(2)} zł</p>
-                    ${state.isCartLocked ? '' : `<button onclick="state.cart = state.cart.filter(c=>c.cart_id!==${i.cart_id}); updateCartUI(); event.stopPropagation();" class="text-slate-600 hover:text-red-500 mt-2 text-sm bg-black/50 w-6 h-6 rounded flex items-center justify-center transition"><i class="fa-solid fa-trash"></i></button>`}
-                </div>
-            </div>`; 
-        }).join(''); 
-        document.getElementById('cart-total').innerText = total.toFixed(2) + " zł"; 
-    }
-
-    function openEditInCart(orderId) {
-        closeUnifiedModal(); 
-        const o = state.orders.find(x => x.id == orderId); if (!o) return;
-        try { state.cart = JSON.parse(o.cart_json || '[]'); } catch(e) { state.cart = []; }
-        state.editOrderId = orderId; state.isCartLocked = (o.receipt_printed == 1); 
-        
-        setOrderType(o.type, document.querySelector(`.type-${o.type}`));
-        document.getElementById('cust-addr').value = o.address || ''; document.getElementById('cust-phone').value = o.customer_phone || ''; document.getElementById('cust-nip').value = o.nip || '';
-        document.getElementById('edit-mode-badge').classList.remove('hidden'); 
-        
-        if (state.isCartLocked) {
-            document.getElementById('cat-list').innerHTML = '';
-            document.getElementById('item-grid').innerHTML = `
-                <div class="col-span-full p-10 bg-red-900/10 border border-red-500/30 rounded-3xl text-center flex flex-col items-center justify-center mt-10">
-                    <i class="fa-solid fa-lock text-6xl text-red-500 mb-6 drop-shadow-lg"></i>
-                    <h3 class="text-red-500 font-black uppercase tracking-widest text-xl mb-2">Edycja Dań Zablokowana</h3>
-                    <p class="text-xs text-slate-300 max-w-md font-bold leading-relaxed">Paragon wydrukowany. Mo┼╝esz zaktualizowa─ç tylko adres dostawy i numer klienta.</p>
-                </div>`;
-        } else { renderCats(); }
-        updateCartUI(); document.getElementById('order-overlay').classList.add('active');
-    }
-
-    function editCartItem(cartId) {
-        if(state.isCartLocked) return showToast("Zablokowane - Wydrukowano Paragon", "error");
-        const itemIndex = state.cart.findIndex(i => i.cart_id === cartId); if(itemIndex < 0) return;
-        state.activeItem = JSON.parse(JSON.stringify(state.cart[itemIndex])); 
-        document.getElementById('dc-name').innerText = state.activeItem.name; document.getElementById('dc-price').innerText = state.activeItem.price + " zł"; 
-        document.getElementById('dc-qty').innerText = state.activeItem.qty; document.getElementById('dc-comment').value = state.activeItem.comment || ""; 
-        document.getElementById('dish-card').classList.add('active'); 
-        
-        fetch(`api_pos.php?action=get_item_details&item_id=${state.activeItem.id || state.activeItem.half_a}&half_b_id=${state.activeItem.half_b || 0}`)
-        .then(r => r.json()).then(d => {
-            if (d.status === 'success') { 
-                document.getElementById('dc-ingredients').innerHTML = d.payload.ingredients.map(ing => { 
-                    const isRemoved = state.activeItem.removed.includes(ing.product_id) ? 'opacity-30 line-through text-red-500' : ''; 
-                    const prefix = ing.half ? `[┬Ż] ` : ''; 
-                    return `<div class="ing-chip bg-white/10 border border-white/5 px-3 py-2 rounded-lg text-[9px] font-black uppercase flex items-center gap-1.5 ${isRemoved} cursor-pointer text-slate-300 hover:text-white transition" onclick="this.classList.toggle('opacity-30'); this.classList.toggle('line-through'); this.classList.toggle('text-red-500'); toggleRem(${ing.product_id})">${prefix}${ing.name_utf8}</div>`; 
-                }).join(''); 
-                document.getElementById('dc-modifiers').innerHTML = state.ingredients.map(ing => { 
-                    const isAdded = state.activeItem.added.includes(ing.id) ? 'checked' : ''; 
-                    return `<label class="flex items-center gap-3 bg-black/50 border border-white/5 p-3 rounded-xl cursor-pointer hover:bg-white/5 transition"><input type="checkbox" value="${ing.id}" onchange="toggleAddMod(this)" class="w-4 h-4 accent-red-500" ${isAdded}><span class="text-[9px] font-bold uppercase truncate text-white">${ing.name} <span class="text-green-500 ml-1">(+4zł)</span></span></label>`; 
-                }).join('');
-            }
-        });
-    }
-		// ­čÜÇ CZAS I FINALIZACJA KOSZYKA (KASA)
-    function openCartCheckoutModal() {
-        if(state.cart.length === 0) return showToast("Koszyk jest pusty!", "error");
-        if(state.type === 'delivery' && !document.getElementById('cust-addr').value) return showToast("Wymagany adres dla dostawy!", "error");
-        
-        state.cartPayMethod = 'unpaid'; state.cartPayStatus = 'unpaid';
-        document.querySelectorAll('.pay-option').forEach(el => el.classList.remove('active', 'active-park'));
-        const parkBtn = document.getElementById('btn-pay-park'); if (parkBtn) parkBtn.classList.add('active-park');
-
-        let chkR = document.getElementById('cart-print-receipt'); chkR.checked = false; chkR.disabled = true;
-        document.getElementById('receipt-req-info').classList.add('hidden');
-        document.getElementById('cart-print-kitchen').checked = (state.editOrderId === null); 
-
-        state.checkoutTargetTime = new Date(); 
-        state.checkoutTargetTime.setMinutes(state.checkoutTargetTime.getMinutes() + (state.type === 'delivery' ? 60 : 30));
-        switchTimeTab('asap'); document.getElementById('cart-checkout-modal').classList.add('active');
-    }
-
-    function switchTimeTab(mode) {
-        state.checkoutTimeMode = mode;
-        const btnAsap = document.getElementById('tab-asap'); const btnSched = document.getElementById('tab-scheduled');
-        const viewAsap = document.getElementById('time-asap-view'); const viewSched = document.getElementById('time-scheduled-view');
-
-        if (mode === 'asap') {
-            btnAsap.classList.replace('bg-white/10', 'bg-blue-600'); btnAsap.classList.replace('text-slate-400', 'text-white');
-            btnSched.classList.replace('bg-blue-600', 'bg-white/10'); btnSched.classList.replace('text-white', 'text-slate-400');
-            viewAsap.classList.remove('hidden'); viewSched.classList.add('hidden'); viewSched.classList.remove('flex');
-            
-            const quick = document.getElementById('quick-time-btns');
-            let b = state.type === 'delivery' ? [45, 60, 90, 120] : [15, 30, 45, 60];
-            quick.innerHTML = b.map(v => `<button onclick="applyQuickMinutes(${v})" class="px-5 py-3 rounded-xl bg-white/10 border border-white/5 text-[10px] font-black hover:bg-blue-600 transition shrink-0 shadow-sm text-white">+${v}m</button>`).join('');
-        } else {
-            btnSched.classList.replace('bg-white/10', 'bg-blue-600'); btnSched.classList.replace('text-slate-400', 'text-white');
-            btnAsap.classList.replace('bg-blue-600', 'bg-white/10'); btnAsap.classList.replace('text-white', 'text-slate-400');
-            viewAsap.classList.add('hidden'); viewSched.classList.remove('hidden'); viewSched.classList.add('flex');
-            updateScheduledDisplay();
-        }
-    }
-
-    function applyQuickMinutes(m) { state.checkoutTargetTime = new Date(); state.checkoutTargetTime.setMinutes(state.checkoutTargetTime.getMinutes() + m); showToast(`Za ${m} minut`, 'success'); switchTimeTab('scheduled'); }
-    function applyCustomMinutes() { const v = parseInt(document.getElementById('custom-minutes').value); if(!v || v <= 0) return; state.checkoutTargetTime = new Date(); state.checkoutTargetTime.setMinutes(state.checkoutTargetTime.getMinutes() + v); showToast(`Za ${v} minut`, 'success'); switchTimeTab('scheduled'); }
-    function calendarTimeChanged(val) { if(!val) return; state.checkoutTargetTime = new Date(val); showToast(`Nowa data!`, 'success'); switchTimeTab('scheduled'); }
-    function updateScheduledDisplay() {
-        const t = state.checkoutTargetTime; const now = new Date(); const diffM = Math.ceil((t - now) / 60000);
-        const isToday = t.getDate() === now.getDate() && t.getMonth() === now.getMonth() && t.getFullYear() === now.getFullYear();
-        const h = String(t.getHours()).padStart(2, '0'); const m = String(t.getMinutes()).padStart(2, '0');
-        document.getElementById('scheduled-time-display').innerText = isToday ? `Dzi┼Ť ${h}:${m}` : `${String(t.getDate()).padStart(2,'0')}.${String(t.getMonth()+1).padStart(2,'0')} ${h}:${m}`;
-        document.getElementById('scheduled-countdown').innerText = diffM >= 0 ? `Za ${diffM} min` : `Sp├│┼║nione ${Math.abs(diffM)} min`;
-        document.getElementById('scheduled-countdown').className = diffM >= 0 ? 'text-[11px] font-black text-blue-400 mb-3 tracking-widest uppercase' : 'text-[11px] font-black text-red-500 mb-3 tracking-widest uppercase animate-pulse';
-    }
-
-    function selectCartPayment(method, status, btn, isPark = false) {
-        state.cartPayMethod = method; state.cartPayStatus = status;
-        document.querySelectorAll('.pay-option').forEach(el => el.classList.remove('active', 'active-park'));
-        let chkR = document.getElementById('cart-print-receipt'); let reqInfo = document.getElementById('receipt-req-info');
-        if(isPark) { 
-            btn.classList.add('active-park'); chkR.checked = false; chkR.disabled = true; reqInfo.classList.add('hidden');
-        } else { 
-            btn.classList.add('active'); 
-            if (method === 'card' || method === 'online') { chkR.checked = true; chkR.disabled = true; reqInfo.classList.remove('hidden'); } 
-            else { chkR.disabled = false; chkR.checked = false; reqInfo.classList.add('hidden'); } 
-        }
-    }
-
-    async function submitFinalOrder() {
-        if(!state.cartPayStatus) return showToast("Wybierz p┼éatno┼Ť─ç lub zaparkuj!", "error");
-        let isCardOrOnline = (state.cartPayMethod === 'card' || state.cartPayMethod === 'online');
-        let printCheck = document.getElementById('cart-print-receipt').checked;
-        if (state.cartPayStatus === 'paid' && isCardOrOnline && !printCheck) return showToast("Dla karty paragon obowi─ůzkowy!", "error");
-
-        const iso = new Date(state.checkoutTargetTime.getTime() - (state.checkoutTargetTime.getTimezoneOffset() * 60000)).toISOString().slice(0, 16);
-        const payload = { 
-            edit_order_id: state.editOrderId, action_type: state.cartPayStatus === 'paid' ? 'close' : 'park', 
-            payment_method: state.cartPayMethod, payment_status: state.cartPayStatus, 
-            print_receipt: printCheck ? 1 : 0, print_kitchen: document.getElementById('cart-print-kitchen').checked ? 1 : 0, 
-            custom_datetime: iso, order_type: state.type, customer_phone: document.getElementById('cust-phone').value, 
-            address: document.getElementById('cust-addr').value, nip: document.getElementById('cust-nip').value, 
-            total_price: parseFloat(document.getElementById('cart-total').innerText), cart: state.cart, source: 'local', status: 'pending' 
-        }; 
-        
-        const d = await apiPost('process_order', payload);
-        if(d.status === 'success') { showToast("Zapisano!", "success"); state.editOrderId = null; document.getElementById('cart-checkout-modal').classList.remove('active'); closeNewOrder(); fetchOrders(); } 
-        else { showToast(d.error, "error"); }
-    }
-
-    // ­čÜÇ SZYBKIE P┼üATNO┼ÜCI Z BATTLEFIELDA
-    function openPaymentModal(orderId, mode, ev) { 
-        if(ev) ev.stopPropagation(); closeUnifiedModal();
-        const o = state.orders.find(x => x.id == orderId); if(!o) return;
-        state.settleOrderId = orderId; state.paymentModalMode = mode; 
-        document.getElementById('pay-acc-id').innerText = "#" + (o.order_number.split('/').pop() || o.order_number); 
-        
-        let title = document.querySelector('#payment-modal h3'); let btnSettle = document.getElementById('btn-settle-close'); let btnPrint = document.getElementById('btn-settle-print');
-        document.getElementById('settle-btn-card').style.display = 'block'; document.getElementById('settle-btn-cash').style.display = 'block'; document.getElementById('settle-btn-online').style.display = 'none';
-        let chkR = document.getElementById('settle-print-receipt'); let reqInfo = document.getElementById('settle-req-info');
-        
-        if (mode === 'print') { 
-            title.innerText = 'DRUKUJ PARAGON'; btnSettle.classList.add('hidden'); btnPrint.classList.remove('hidden'); 
-            chkR.checked = true; chkR.disabled = true; reqInfo.classList.remove('hidden'); 
-        } else { 
-            title.innerText = 'ROZLICZ I ZAMKNIJ'; btnSettle.classList.remove('hidden'); btnPrint.classList.add('hidden'); 
-            if (o.receipt_printed == 1) { chkR.checked = true; chkR.disabled = true; reqInfo.classList.add('hidden'); } 
-            else { chkR.disabled = false; chkR.checked = false; reqInfo.classList.add('hidden'); } 
-        }
-
-        if (o.source === 'online' || o.payment_method === 'online') { 
-            state.settleMethod = 'online'; document.getElementById('settle-btn-card').style.display = 'none'; document.getElementById('settle-btn-cash').style.display = 'none'; document.getElementById('settle-btn-online').style.display = 'block'; selectSettleMethod('online'); 
-        } else if (o.payment_method !== 'unpaid' && o.payment_method) { 
-            state.settleMethod = o.payment_method; 
-            if(o.payment_method === 'card') document.getElementById('settle-btn-cash').style.display = 'none'; 
-            if(o.payment_method === 'cash') document.getElementById('settle-btn-card').style.display = 'none'; 
-            selectSettleMethod(state.settleMethod); 
-            if (o.receipt_printed == 1) document.querySelectorAll('.settle-opt').forEach(btn => { btn.disabled = true; btn.classList.add('opacity-50', 'cursor-not-allowed'); }); 
-            else document.querySelectorAll('.settle-opt').forEach(btn => { btn.disabled = false; btn.classList.remove('opacity-50', 'cursor-not-allowed'); }); 
-        } else { 
-            state.settleMethod = null; document.querySelectorAll('.settle-opt').forEach(el => { el.classList.remove('border-blue-500', 'border-green-500', 'border-purple-500', 'bg-white/10', 'opacity-50', 'cursor-not-allowed'); el.disabled = false; }); 
-        }
-        document.getElementById('payment-modal').classList.add('active'); 
-    }
-
-    function selectSettleMethod(m) { 
-        state.settleMethod = m; document.querySelectorAll('.settle-opt').forEach(el => el.classList.remove('border-blue-500', 'border-green-500', 'border-purple-500', 'bg-white/10'));
-        let chk = document.getElementById('settle-print-receipt'); let reqInfo = document.getElementById('settle-req-info');
-        if(m === 'card' || m === 'online') { document.getElementById('settle-btn-' + m).classList.add('border-' + (m==='card'?'blue':'purple') + '-500', 'bg-white/10'); chk.checked = true; chk.disabled = true; reqInfo.classList.remove('hidden'); }
-        if(m === 'cash') { 
-            document.getElementById('settle-btn-cash').classList.add('border-green-500', 'bg-white/10'); 
-            const o = state.orders.find(x => x.id == state.settleOrderId); 
-            if (state.paymentModalMode === 'print') { chk.checked = true; chk.disabled = true; reqInfo.classList.remove('hidden'); } 
-            else if (o && o.receipt_printed == 1) { chk.disabled = true; chk.checked = true; reqInfo.classList.add('hidden'); } 
-            else { chk.disabled = false; chk.checked = false; reqInfo.classList.add('hidden'); } 
-        }
-    }
-
-    function openCancelModal(id) { closeUnifiedModal(); state.acceptId = id; document.getElementById('cancel-acc-id').innerText = "#" + id; document.getElementById('cancel-modal').classList.add('active'); }
-    async function confirmCancel(ret) { const d = await apiPost('cancel_order', {order_id: state.acceptId, return_stock: ret}); if(d.status === 'success') { showToast("Anulowano.", "success"); document.getElementById('cancel-modal').classList.remove('active'); fetchOrders(); } else { showToast(d.error,"error"); } }
-
-    // ­čÜÇ CICHY WYDRUK LOKALNY
-    function printLokalnie(htmlContent) {
-        let iframe = document.getElementById('print-frame');
-        let doc = iframe.contentWindow.document; doc.open(); doc.write(htmlContent); doc.close();
-        setTimeout(() => { iframe.contentWindow.focus(); iframe.contentWindow.print(); }, 250);
-    }
-
-    function generujSzablonBonu(order, isKitchen = false) {
-        let cart = []; try { cart = JSON.parse(order.cart_json || '[]'); } catch(e) {}
-        let itemsHtml = cart.map(item => {
-            const added = item.added && item.added.length ? `<br><span style="font-size: 10px;">+ dodatki/zmiany</span>` : '';
-            const comment = item.comment ? `<br><span style="font-size: 10px; border: 1px solid #000; padding: 2px;">UWAGA: ${item.comment}</span>` : '';
-            return `<tr><td style="padding: 5px 0; font-weight: bold; vertical-align: top; width: 15%;">${item.qty}x</td><td style="padding: 5px 0; vertical-align: top; width: 60%;">${item.name} ${added} ${comment}</td>${!isKitchen ? `<td style="text-align: right; padding: 5px 0; vertical-align: top;">${(item.price * item.qty).toFixed(2)}</td>` : ''}</tr>`;
-        }).join('');
-        const dDate = new Date(order.created_at || new Date()); const timeStr = `${String(dDate.getHours()).padStart(2, '0')}:${String(dDate.getMinutes()).padStart(2, '0')}`;
-        let title = isKitchen ? "BON NA KUCHNI─ś" : "RACHUNEK / PARAGON NIEFISKALNY";
-        let typeStr = order.type === 'delivery' ? 'DOSTAWA' : (order.type === 'takeaway' ? 'WYNOS' : 'SALA');
-        let clientHtml = ''; if (order.type === 'delivery') clientHtml = `<div style="border-top: 1px dashed #000; border-bottom: 1px dashed #000; margin: 10px 0; padding: 10px 0;"><b style="font-size: 16px;">${order.address || 'Brak adresu'}</b><br>Tel: ${order.customer_phone || 'Brak'}<br>Klient: ${order.customer_name || 'Go┼Ť─ç'}</div>`;
-        return `<html><head><style>body { font-family: 'Courier New', monospace; width: 300px; margin: 0; padding: 0; color: #000; background: #fff; font-size: 12px; } .center { text-align: center; } .divider { border-top: 2px dashed #000; margin: 10px 0; } table { width: 100%; border-collapse: collapse; } h2 { margin: 5px 0; font-size: 18px; text-align: center; } h3 { margin: 5px 0; font-size: 14px; text-align: center; }</style></head><body><h2>SLICEHUB POS</h2><h3>${title}</h3><div class="divider"></div><div style="display: flex; justify-content: space-between; font-weight: bold; font-size: 14px;"><span>#${order.order_number.split('/').pop()}</span><span>${timeStr}</span></div><div class="center" style="font-size: 18px; font-weight: bold; margin: 5px 0; border: 2px solid #000; padding: 5px;">${typeStr}</div>${clientHtml}<table>${itemsHtml}</table><div class="divider"></div>${!isKitchen ? `<h2 style="text-align: right; font-size: 20px;">SUMA: ${order.total_price} PLN</h2>` : ''}<div class="center" style="margin-top: 20px; font-size: 10px;">Wygenerowano: ${new Date().toLocaleString()}</div></body></html>`;
-    }
-
-    async function printKitchenTicket(id, ev) { 
-        if(ev) ev.stopPropagation(); 
-        const o = state.orders.find(x => x.id == id);
-        if(o) printLokalnie(generujSzablonBonu(o, true));
-        await apiPost('print_kitchen', {order_id: id}); 
-        showToast("Wys┼éano ┼╝─ůdanie druku na kuchni─Ö...", "success"); fetchOrders(); 
-    }
-
-    async function confirmPrintReceiptOnly() { 
-        if(!state.settleMethod) return showToast("Zaznacz p┼éatno┼Ť─ç przypisan─ů do paragonu!", "error"); 
-        const o = state.orders.find(x => x.id == state.settleOrderId);
-        if(o) printLokalnie(generujSzablonBonu(o, false));
-        const d = await apiPost('print_receipt', {order_id: state.settleOrderId, payment_method: state.settleMethod}); 
-        if(d.status === 'success') { showToast("Wydrukowano Paragon", "success"); document.getElementById('payment-modal').classList.remove('active'); fetchOrders(); } 
-        else { showToast(d.error, "error"); } 
-    }
-
-    async function confirmPaymentAndClose() { 
-        if(!state.settleMethod) return showToast("Zaznacz metod─Ö p┼éatno┼Ťci!", "error"); 
-        let isCardOrOnline = (state.settleMethod === 'card' || state.settleMethod === 'online');
-        let printCheck = document.getElementById('settle-print-receipt').checked;
-        if (isCardOrOnline && !printCheck) { return showToast("Wydruk paragonu jest OBOWI─äZKOWY!", "error"); }
-
-        if (printCheck) {
-            const o = state.orders.find(x => x.id == state.settleOrderId);
-            if(o) printLokalnie(generujSzablonBonu(o, false));
-        }
-
-        const d = await apiPost('settle_and_close', {order_id: state.settleOrderId, payment_method: state.settleMethod, print_receipt: printCheck ? 1 : 0}); 
-        if(d.status === 'success') { showToast("Zamkni─Öto pomy┼Ťlnie!", "success"); document.getElementById('payment-modal').classList.remove('active'); closeUnifiedModal(); fetchOrders(); } 
-        else { showToast(d.error, "error"); } 
-    }
-</script>
-
-<script src="pos_fleet.js"></script>
-<script src="pos_active_routes.js"></script>
-
-<script>
-    window.addEventListener('DOMContentLoaded', (event) => {
-        init();
-        setInterval(fetchOrders, 8000);
-    });
-</script>
-</body>
-</html>
\ No newline at end of file
diff --git a/_KOPALNIA_WIEDZY_LEGACY/pos_active_routes.js b/_KOPALNIA_WIEDZY_LEGACY/pos_active_routes.js
deleted file mode 100644
index e2f5f3a..0000000
--- a/_KOPALNIA_WIEDZY_LEGACY/pos_active_routes.js
+++ /dev/null
@@ -1,150 +0,0 @@
-// ==========================================
-// ­čÜÜ SLICEHUB - BATTLEFIELD KURS├ôW (pos_active_routes.js)
-// ==========================================
-
-function renderActiveRoutes() {
-    const grid = document.getElementById('bf-grid');
-    let routeGroups = {};
-    
-    // 1. Grupowanie zamówień w trasie (in_delivery)
-    state.orders.forEach(o => {
-        if (o.status === 'in_delivery' && o.course_id) {
-            if (!routeGroups[o.course_id]) {
-                routeGroups[o.course_id] = {
-                    driver_id: o.driver_id,
-                    course_id: o.course_id,
-                    items: [],
-                    cashToCollect: 0,
-                    cardToCollect: 0,
-                    paidTotal: 0
-                };
-            }
-            routeGroups[o.course_id].items.push(o);
-            
-            let price = parseFloat(o.total_price) || 0;
-            
-            // BEZWZGL─śDNA LOGIKA PORTFELA KIEROWCY
-            if (o.payment_status === 'paid') {
-                routeGroups[o.course_id].paidTotal += price;
-            } else {
-                if (o.payment_method === 'card') {
-                    routeGroups[o.course_id].cardToCollect += price;
-                } else {
-                    // Domy┼Ťlnie wszystko nieop┼éacone co nie jest kart─ů to got├│wka
-                    routeGroups[o.course_id].cashToCollect += price;
-                }
-            }
-        }
-    });
-
-    const activeRouteKeys = Object.keys(routeGroups);
-
-    // Pusty stan
-    if (activeRouteKeys.length === 0) {
-        grid.innerHTML = `
-        <div class="w-full mt-20 flex flex-col items-center justify-center text-slate-600">
-            <i class="fa-solid fa-road-circle-check text-6xl mb-4 opacity-50"></i>
-            <h3 class="text-xl font-black uppercase tracking-widest">Brak Aktywnych Kurs├│w</h3>
-            <p class="text-[10px] font-bold mt-2">Wszystkie zam├│wienia zosta┼éy rozliczone lub czekaj─ů na kuchni.</p>
-        </div>`;
-        return;
-    }
-
-    let html = '<div class="grid grid-cols-1 2xl:grid-cols-2 gap-5 w-full content-start pb-20">';
-
-    activeRouteKeys.forEach(k => {
-        const g = routeGroups[k];
-        const driver = state.drivers.find(d => d.id == g.driver_id) || { first_name: 'Nieznany', initial_cash: 0 };
-        const initialCash = parseFloat(driver.initial_cash || 0);
-        const totalCashToReturn = initialCash + g.cashToCollect;
-
-        // Sortowanie po przystankach L1, L2...
-        g.items.sort((a, b) => {
-            let numA = parseInt((a.stop_number || 'L99').replace('L', ''));
-            let numB = parseInt((b.stop_number || 'L99').replace('L', ''));
-            return numA - numB;
-        });
-
-        // Generowanie Bon├│w Przystank├│w
-        const stopsHtml = g.items.map(o => {
-            let payBadge = '';
-            if (o.payment_status === 'paid') {
-                payBadge = `<span class="bg-green-900/30 text-green-500 border border-green-500/30 px-2 py-0.5 rounded text-[8px] font-black">OPŁACONE (${(o.payment_method||'').toUpperCase()}) - NIE POBIERAJ</span>`;
-            } else if (o.payment_method === 'card') {
-                payBadge = `<span class="bg-blue-900/30 text-blue-400 border border-blue-500/30 px-2 py-0.5 rounded text-[8px] font-black">KARTA (WE┼╣ TERMINAL)</span>`;
-            } else {
-                payBadge = `<span class="bg-red-900/30 text-red-400 border border-red-500/30 px-2 py-0.5 rounded text-[8px] font-black">GOTÓWKA DO POBRANIA</span>`;
-            }
-
-            return `
-            <div class="bg-black/60 border border-white/5 p-3 rounded-xl mb-2 flex justify-between items-center cursor-pointer hover:border-blue-500/50 transition relative overflow-hidden group shadow-sm" onclick="openUnifiedModal(${o.id})">
-                <div class="absolute left-0 top-0 bottom-0 w-1 bg-slate-700 group-hover:bg-blue-500 transition"></div>
-                <div class="flex items-center gap-4 pl-2">
-                    <div class="w-9 h-9 rounded bg-[#0a0f1c] border border-white/10 flex items-center justify-center font-black text-white shadow-lg text-sm">${o.stop_number || '-'}</div>
-                    <div>
-                        <p class="text-[12px] font-black text-white leading-tight">#${o.order_number.split('/').pop()} <span class="text-slate-500 mx-1">ÔÇó</span> ${o.address}</p>
-                        <p class="text-[9px] text-slate-400 mt-1 font-bold"><i class="fa-solid fa-phone mr-1"></i> ${o.customer_phone || 'Brak telefonu'}</p>
-                    </div>
-                </div>
-                <div class="text-right flex flex-col items-end shrink-0">
-                    <span class="text-base font-black text-white italic">${o.total_price} zł</span>
-                    <div class="mt-1">${payBadge}</div>
-                </div>
-            </div>`;
-        }).join('');
-
-        // Budowa Głównej Karty Kursu
-        html += `
-        <div class="glass rounded-[24px] border border-white/10 flex flex-col overflow-hidden bg-[#0a0f1c] shadow-[0_15px_40px_rgba(0,0,0,0.6)] relative">
-            
-            <div class="p-5 bg-black/40 border-b border-white/5 flex justify-between items-center">
-                <div class="flex items-center gap-4">
-                    <div class="w-12 h-12 rounded-xl bg-blue-600 flex items-center justify-center font-black text-white shadow-[0_0_20px_rgba(59,130,246,0.5)] text-xl border-[2px] border-[#0a0f1c]">
-                        ${g.course_id.replace('K', '')}
-                    </div>
-                    <div>
-                        <h3 class="font-black text-base uppercase text-white tracking-wide"><i class="fa-solid fa-motorcycle text-blue-400 mr-2"></i> ${driver.first_name}</h3>
-                        <p class="text-[9px] text-slate-400 font-bold uppercase tracking-widest mt-0.5"><i class="fa-solid fa-clock mr-1"></i> Wyjazd: ${g.items[0].promised_time ? g.items[0].promised_time.substring(11, 16) : '--:--'}</p>
-                    </div>
-                </div>
-                <div class="flex gap-2">
-                    <button onclick="alert('Modu┼é Wiadomo┼Ťci SMS uruchomimy w kolejnym etapie')" class="w-10 h-10 rounded-xl bg-white/5 border border-white/10 flex items-center justify-center text-slate-400 hover:text-white hover:bg-blue-600 transition shadow-sm" title="Wiadomo┼Ť─ç do kierowcy"><i class="fa-regular fa-comment-dots"></i></button>
-                    <button onclick="alert('Moduł Edycji Trasy uruchomimy w kolejnym etapie')" class="w-10 h-10 rounded-xl bg-white/5 border border-white/10 flex items-center justify-center text-slate-400 hover:text-white hover:bg-yellow-600 transition shadow-sm" title="Edytuj Trasę"><i class="fa-solid fa-pen"></i></button>
-                    <button onclick="alert('Zawracanie uruchomimy w kolejnym etapie')" class="w-10 h-10 rounded-xl bg-red-900/30 border border-red-500/30 flex items-center justify-center text-red-500 hover:text-white hover:bg-red-600 transition shadow-sm" title="Zawr├│─ç Kierowc─Ö"><i class="fa-solid fa-rotate-left"></i></button>
-                </div>
-            </div>
-
-            <div class="grid grid-cols-2 md:grid-cols-4 gap-px bg-white/5 border-b border-white/5">
-                <div class="bg-[#0a0f1c] p-4 flex flex-col justify-center text-center">
-                    <span class="text-[8px] font-black uppercase text-slate-500 tracking-widest mb-1.5">Got├│wka (Start)</span>
-                    <span class="text-sm font-black text-slate-300">${initialCash.toFixed(2)} zł</span>
-                </div>
-                <div class="bg-[#0a0f1c] p-4 flex flex-col justify-center text-center">
-                    <span class="text-[8px] font-black uppercase text-slate-500 tracking-widest mb-1.5">P┼éatno┼Ť─ç Kart─ů</span>
-                    <span class="text-sm font-black text-blue-400">${g.cardToCollect.toFixed(2)} zł</span>
-                </div>
-                <div class="bg-[#0a0f1c] p-4 flex flex-col justify-center text-center">
-                    <span class="text-[8px] font-black uppercase text-slate-500 tracking-widest mb-1.5">Opłacone z Góry</span>
-                    <span class="text-sm font-black text-green-500">${g.paidTotal.toFixed(2)} zł</span>
-                </div>
-                <div class="bg-red-900/10 p-4 flex flex-col justify-center text-center border-b-[3px] border-red-500 shadow-[inset_0_0_20px_rgba(239,68,68,0.15)] relative">
-                    <span class="text-[8px] font-black uppercase text-red-400 tracking-widest mb-1.5 relative z-10">ZBIERZ GOT├ôWK─ś</span>
-                    <span class="text-base font-black text-red-500 italic relative z-10">+ ${g.cashToCollect.toFixed(2)} zł</span>
-                </div>
-            </div>
-
-            <div class="bg-black/80 p-5 border-b border-white/5 flex justify-between items-center">
-                <span class="text-[11px] font-black uppercase text-slate-400 tracking-widest"><i class="fa-solid fa-wallet mr-2 text-slate-500"></i> Got├│wka do zdania po powrocie:</span>
-                <span class="text-3xl font-black text-white italic drop-shadow-[0_0_10px_rgba(255,255,255,0.2)]">${totalCashToReturn.toFixed(2)} <span class="text-sm text-slate-500 not-italic">zł</span></span>
-            </div>
-
-            <div class="p-5 bg-black/20 flex-1 overflow-y-auto max-h-[400px] hide-scrollbar">
-                <h4 class="text-[9px] font-black uppercase tracking-widest text-slate-500 mb-3 pl-1">Przystanki na trasie (${g.items.length})</h4>
-                ${stopsHtml}
-            </div>
-        </div>`;
-    });
-
-    html += '</div>';
-    grid.innerHTML = html;
-}
\ No newline at end of file
diff --git a/_KOPALNIA_WIEDZY_LEGACY/pos_fleet.js b/_KOPALNIA_WIEDZY_LEGACY/pos_fleet.js
deleted file mode 100644
index d221f6a..0000000
--- a/_KOPALNIA_WIEDZY_LEGACY/pos_fleet.js
+++ /dev/null
@@ -1,97 +0,0 @@
-// ==========================================
-// ­čÜÜ SLICEHUB - MODU┼ü FLOTY I KURS├ôW (pos_fleet.js)
-// ==========================================
-
-function toggleOrderToRoute(id, ev) { 
-    if(ev) ev.stopPropagation(); 
-    const numericId = Number(id); 
-    if(state.routeOrders.includes(numericId)) { state.routeOrders = state.routeOrders.filter(i => i !== numericId); } 
-    else { state.routeOrders.push(numericId); } 
-    if(typeof renderDrivers === 'function') renderDrivers(); 
-    if(typeof renderOrders === 'function') renderOrders(); 
-}
-
-function toggleRouteMode(id) { 
-    state.routeDriverId = state.routeDriverId === id ? null : id; 
-    state.routeOrders = []; 
-    if(state.routeDriverId) { showToast("Wybierz zam├│wienia z listy, aby zbudowa─ç kurs.", "info"); }
-    renderDrivers(); renderOrders(); 
-}
-
-async function sendRoute() { 
-    if(state.routeOrders.length === 0 || !state.routeDriverId) return; 
-    
-    const btnSend = document.getElementById('btn-send-route');
-    const orgText = btnSend.innerHTML;
-    btnSend.innerHTML = '<i class="fa-solid fa-spinner fa-spin"></i> Wysyłanie...';
-    
-    const d = await apiPost('assign_route', {driver_id: state.routeDriverId, order_ids: state.routeOrders}); 
-    
-    if(d.status === 'success') { 
-        showToast("Wygenerowano i wysłano kurs do kierowcy!", "success"); 
-        state.routeDriverId = null; 
-        state.routeOrders = []; 
-        
-        // ­čÜĘ TWARDE PRZE┼ü─äCZENIE FILTRA
-        state.filterType = 'routes'; 
-        if(typeof setFilter === 'function') {
-            setFilter('routes'); 
-        }
-        
-        await fetchOrders(); // Czekamy na nowe dane z bazy
-        if(typeof renderActiveRoutes === 'function') renderActiveRoutes(); // Wymuszamy render Battlefielda
-    } else { 
-        showToast(d.error, "error"); 
-        btnSend.innerHTML = orgText;
-    }
-}
-
-function renderDrivers() {
-    const list = document.getElementById('drivers-list'); 
-    const btnSend = document.getElementById('btn-send-route');
-    
-    if(state.routeDriverId && state.routeOrders.length > 0) { 
-        btnSend.classList.remove('hidden'); 
-        btnSend.innerText = `Wy┼Ťlij Kurs (${state.routeOrders.length})`; 
-    } else { 
-        btnSend.classList.add('hidden'); 
-    }
-
-    list.innerHTML = state.drivers.filter(d => d.status !== 'offline').map(d => {
-        const active = state.orders.filter(o => o.driver_id == d.id && o.status === 'in_delivery');
-        const returning = state.orders.filter(o => o.driver_id == d.id && o.status === 'delivered');
-        const isSelected = state.routeDriverId === d.id;
-        
-        let courseTags = '';
-        if (active.length > 0) {
-            let uniqueCourses = [...new Set(active.map(o => o.course_id).filter(c => c))];
-            if (uniqueCourses.length > 0) { 
-                courseTags = uniqueCourses.map(c => `<span class="bg-blue-600 text-white px-1.5 py-0.5 rounded text-[8px] ml-1.5 inline-block border border-blue-500/50 shadow-sm font-black">${c}</span>`).join(''); 
-            }
-        }
-
-        let s = "Dost─Öpny"; let c = "text-green-500"; let b = "border-white/5 bg-black/40"; let dot = "bg-green-500";
-        if(returning.length > 0 && active.length === 0) { s = "Wraca do bazy"; c = "text-yellow-400 animate-pulse"; b = "border-yellow-500/30 bg-yellow-900/10"; dot = "bg-yellow-500"; } 
-        else if(active.length > 0) { s = `W trasie (${active.length})`; c = "text-red-500"; b = "border-red-500/30 bg-red-900/10"; dot = "bg-red-500"; }
-        if (isSelected) { b = "border-blue-500 bg-blue-900/20 shadow-[0_0_15px_rgba(59,130,246,0.3)]"; }
-
-        return `
-        <div onclick="toggleRouteMode(${d.id})" class="glass p-3 rounded-xl flex items-center gap-3 border transition cursor-pointer ${b}">
-            <div class="w-8 h-8 rounded-full bg-black/60 border border-white/10 flex items-center justify-center font-black relative ${isSelected ? 'text-blue-400' : 'text-slate-400'}">
-                <i class="fa-solid fa-user-astronaut text-[10px]"></i>
-                <span class="absolute -top-1 -right-1 w-3 h-3 ${dot} rounded-full border-[2px] border-[#0a0f1c]"></span>
-            </div>
-            <div class="flex-1">
-                <p class="text-[10px] font-black uppercase text-white leading-tight flex items-center">${d.first_name} ${courseTags}</p>
-                <p class="text-[8px] font-black uppercase tracking-widest ${c} mt-0.5">${s}</p>
-            </div>
-        </div>`;
-    }).join('');
-    if (!list.innerHTML) list.innerHTML = '<div class="text-center text-slate-600 text-[9px] font-black uppercase mt-6">Brak kierowc├│w online</div>';
-}
-
-function renderWaiters() {
-    const list = document.getElementById('waiters-list');
-    list.innerHTML = state.waiters.map(w => `<div class="glass p-3 rounded-xl flex items-center gap-3 border border-white/5 bg-black/40"><div class="w-8 h-8 rounded-full bg-blue-900/30 flex items-center justify-center font-black text-blue-400"><i class="fa-solid fa-user-tie text-[10px]"></i></div><div><p class="text-[10px] font-black uppercase text-white leading-tight">${w.first_name}</p><p class="text-[8px] font-black uppercase tracking-widest text-green-500 mt-0.5">Na Sali</p></div></div>`).join('');
-    if (!list.innerHTML) list.innerHTML = '<div class="text-center text-slate-600 text-[9px] font-black uppercase mt-6">Brak kelner├│w</div>';
-}
\ No newline at end of file
diff --git a/_docs/02_ARCHITEKTURA.md b/_docs/02_ARCHITEKTURA.md
index a3eee81..e9c7fc3 100644
--- a/_docs/02_ARCHITEKTURA.md
+++ b/_docs/02_ARCHITEKTURA.md
@@ -1,38 +1,388 @@
-# ARCHITEKTURA SYSTEMU I MAPA KATALOGÓW
-
-Ten dokument s┼éu┼╝y Agentom AI (np. Cursor) jako oficjalna mapa drogowa po projekcie SliceHub Enterprise. Nie pr├│buj zgadywa─ç, gdzie s─ů pliki ani nie przeszukuj ca┼éego dysku w ciemno ÔÇô sprawdzaj struktur─Ö tutaj.
-
-## 1. GŁÓWNE STREFY SYSTEMU (PRODUKCJA)
-
-### A. BACKOFFICE (STUDIO) - Silnik Zarz─ůdzania Menu
-**Katalog:** `/modules/studio/`
-To jest nowoczesne serce zarz─ůdzania systemem (Menu, Ceny, KSeF).
-- `index.html` - Główny szkielet i interfejs Studio.
-- `studio_ui.js` - Renderowanie drzewa menu, kategorii i checkboxy zaznaczania masowego.
-- `studio_item.js` - Edytor pojedynczego dania oraz Macierzy Cenowej (Omnichannel).
-- `studio_modifiers.js` - Obsługa Bliźniaka Cyfrowego, ułamków zużycia surowców i akcji ADD/REMOVE.
-- `studio_bulk.js` - Pot─Ö┼╝ny silnik Edycji Masowej wysy┼éaj─ůcy masowe modyfikacje cenowe i temporalne.
-
-### B. BATTLEFIELD (POS) - Strefa Operacyjna Front-Line
-**Katalog:** `/modules/pos/` (w trakcie budowy/migracji)
-To główny ekran restauracji dla załogi.
-Główne moduły operacyjne (docelowe):
-- **The Pulse:** W─ůska kolumna agreguj─ůca zam├│wienia z w┼éasnej strony i portali (Delivery/Online).
-- **The Panic Button:** System masowego zarz─ůdzania kryzysowego (op├│┼║nienia, SMS Alerting).
-- **Battlefield Main:** Centralny ekran wydawki, podział na sekcje i nabijanie na salę.
-
-### C. BACKEND API (PHP)
-**Katalog:** `/api/backoffice/`
-- `api_menu_studio.php` - G┼é├│wny plik operacyjny (router/switch) odbieraj─ůcy ┼╝─ůdania ze Studio.
-- Wszystkie po┼é─ůczenia z API wymagaj─ů strukturalnych obiekt├│w JSON (np. `omnichannelPricePatch`, `temporalPublicationPatch`), zakaz przesy┼éania p┼éaskich warto┼Ťci zast─Öpuj─ůcych stare struktury bazy danych.
-
-## 2. STREFA KWARANTANNY (KOD LEGACY)
-
-### KOPALNIA WIEDZY / ZŁOMOWISKO (Dawca Organów)
-**Katalog:** `/_KOPALNIA_WIEDZY_LEGACY/` (lub podobny katalog ze starymi plikami)
-Tutaj znajduje się stary kod (m.in. Magazyn, Grywalizacja załogi, stary POS, system kurierski, ponad 60 plików PHP/HTML).
-
-**BEZWZGL─śDNA ZASADA DLA AI:** 1. Ca┼éy ten folder ma status **STRICTLY READ-ONLY** (Tylko do odczytu). 
-2. Masz absolutny zakaz edytowania tamtych plik├│w. 
-3. Masz zakaz linkowania tych starych plik├│w do nowego interfejsu (np. do `index.html`).
-4. S┼éu┼╝─ů one wy┼é─ůcznie jako encyklopedia zasad biznesowych. Kiedy tworzysz now─ů funkcj─Ö, masz przeczyta─ç stary plik z kopalni, zrozumie─ç jego logik─Ö dzia┼éania (np. punktacj─Ö w grywalizacji), a nast─Öpnie napisa─ç CA┼üKOWICIE NOWY, zoptymalizowany kod w odpowiednim folderze produkcyjnym, zachowuj─ůc zgodno┼Ť─ç z nasz─ů Konstytucj─ů.
\ No newline at end of file
+# ARCHITEKTURA SYSTEMU ÔÇö MAPA KATALOG├ôW
+
+> Oficjalna mapa drogowa projektu **SliceHub Enterprise** dla Agent├│w AI.
+> Nie zgaduj ÔÇö sprawdzaj struktur─Ö tutaj.
+>
+> **Ostatnia synchronizacja:** 2026-04-19 (po audycie modułów).
+> **North Star:** [`_docs/00_PAMIEC_SYSTEMU.md`](00_PAMIEC_SYSTEMU.md) ÔÇö master reference.
+
+---
+
+## 1. FRONTEND ÔÇö Modu┼éy UI (`/modules/`)
+
+### A. STUDIO ÔÇö Silnik Zarz─ůdzania Menu
+`/modules/studio/`
+
+| Plik | Rola |
+|------|------|
+| `index.html` | Szkielet i interfejs Studio |
+| `js/studio_core.js` | Core + współdzielona logika (woła `api/backoffice/api_menu_studio.php`) |
+| `js/studio_ui.js` | Drzewo menu, kategorie, zaznaczanie masowe |
+| `js/studio_item.js` | Edytor dania + Macierz Cenowa (Omnichannel) |
+| `js/studio_modifiers.js` | Bli┼║niak Cyfrowy, zu┼╝ycie surowc├│w, akcje ADD/REMOVE |
+| `js/studio_recipe.js` | Edytor receptur (surowce Ôćĺ dania) |
+| `js/studio_bulk.js` | Edycja Masowa (ceny, publikacja temporalna) |
+| `js/studio_margin.js` | Kalkulator mar┼╝y |
+
+> ÔÜá **D┼üUG TECHNICZNY:** Studio NIE posiada dedykowanego `studio_api.js`. Ka┼╝dy plik wywo┼éuje `window.ApiClient.post('api/backoffice/api_menu_studio.php', ÔÇŽ)` bezpo┼Ťrednio. Planowany refactor do sp├│jnego wrappera.
+
+### B. POS ÔÇö Strefa Operacyjna (Dark Battlefield)
+`/modules/pos/`
+
+| Plik | Rola |
+|------|------|
+| `index.html` | Szkielet POS (kafelki + koszyk + checkout) |
+| `js/pos_app.js` | Kontroler główny: auth, menu, koszyk, checkout |
+| `js/pos_api.js` | API wrapper Ôćĺ `api/pos/engine.php`, `api/auth/login.php`, `api/courses/engine.php`, `api/tables/engine.php` |
+| `js/pos_cart.js` | Logika koszyka (UI ÔÇö prawda zawsze z serwera) |
+| `js/pos_ui.js` | Rendering UI |
+| `css/style.css` | Dark Battlefield theme |
+
+### C. TABLES ÔÇö Modu┼é Kelnerski (Stoliki)
+`/modules/tables/`
+
+| Plik | Rola |
+|------|------|
+| `index.html` | Plan sali + listy zamówień otwartych |
+| `js/tables_app.js` | Kontroler stolik├│w, otwieranie/zamykanie rachunk├│w, transfery |
+| `js/tables_api.js` | API wrapper Ôćĺ `api/tables/engine.php`, `api/auth/login.php` (strict JWT) |
+| `css/style.css` | Dark Glass theme |
+
+### D. WAITER ÔÇö Mobile Waiter App
+`/modules/waiter/`
+
+| Plik | Rola |
+|------|------|
+| `index.html` | PIN login + mobilny interfejs kelnera |
+| `js/waiter_app.js` | Monolit: PIN login + wywołania `api/tables/engine.php` + UI |
+
+> ÔÜá **D┼üUG TECHNICZNY:** Waiter u┼╝ywa bezpo┼Ťredniego `fetch`, nie ma `waiter_api.js`. Do refaktoru.
+
+### E. DISPATCHER ÔÇö Centrum Logistyki (Kursy)
+`/modules/courses/`
+
+| Plik | Rola |
+|------|------|
+| `index.html` | 3 zakładki: Zamówienia / Mapa / Aktywne Kursy |
+| `js/courses_app.js` | Auth PIN, polling 8s, dispatch workflow, modals (cash/reconcile) |
+| `js/courses_api.js` | API wrapper Ôćĺ `api/courses/engine.php`, `api/auth/login.php` |
+| `js/courses_map.js` | Leaflet.js: markery zamówień + kierowców (Carto Dark) |
+| `js/courses_ui.js` | Karty zamówień, kierowców, kursów, SLA badges, wallet, toast |
+| `css/style.css` | Dark Glass theme |
+
+Workflow: `ready` + `available` Ôćĺ Select driver + orders Ôćĺ Dispatch Ôćĺ Kurs `Kn` z przystankami `L1..Ln`
+
+Features: multi-order dispatch, Leaflet map, active courses z per-course rozliczeniem (cash/card/prepaid), pogotowie kasowe, reconciliation modal, Emergency Recall, SLA badges.
+
+### F. DRIVER APP ÔÇö Aplikacja Mobilna PWA
+`/modules/driver_app/`
+
+| Plik | Rola |
+|------|------|
+| `index.html` | PIN login + bottom tab bar (Kursy / Portfel) |
+| `js/driver_app.js` | Auth, polling 10s, GPS 15s, payment lock, emergency recall |
+| `js/driver_api.js` | API wrapper Ôćĺ `api/courses/engine.php`, `api/auth/login.php` |
+| `css/style.css` | High-contrast dark, touch 56px+, safe-area-inset, PWA |
+| `manifest.json` | PWA manifest (standalone, portrait) |
+
+Critical: Payment Lock, Driver Wallet, Emergency Alert (red flash + vibration), GPS do `sh_driver_locations`.
+
+### G. KDS ÔÇö Kitchen Display System
+`/modules/kds/`
+
+| Plik | Rola |
+|------|------|
+| `index.html` | Tablica kuchenna (tickets grid) |
+| `js/kds_app.js` | Polling 6s, bump (accept Ôćĺ preparing Ôćĺ ready), recall, Bearer auth |
+| `css/style.css` | Kitchen display theme |
+
+> Ôä╣ Dzia┼éa z ka┼╝d─ů sesj─ů logowan─ů (JWT lub session cookie). Po 401 pokazuje lock-screen z instrukcj─ů logowania.
+
+### H. ONLINE ÔÇö Publiczna Witryna (The Surface)
+`/modules/online/`
+
+| Plik | Rola |
+|------|------|
+| `index.html` | Publiczna karta menu |
+| `track.html` | Tracking zam├│wienia klienta (odzysk po `tracking_token` + telefon) |
+| `js/online_app.js` | Główny bootstrap |
+| `js/online_api.js` | API wrapper Ôćĺ `api/online/engine.php` (bez JWT ÔÇö publiczne; tenant z `meta[name="sh-tenant-id"]` albo `?tenant=`) |
+| `js/online_renderer.js` | Rendering sceny (tła, warstwy, companions) |
+| `js/online_checkout.js` | Checkout go┼Ť─ç (`init_checkout` + `guest_checkout`) |
+| `js/online_table.js` | Otwarcie stolika przez QR |
+| `js/online_track.js` | Logika ┼Ťledzenia (`track_order`, polling 10s) |
+| `js/online_ui.js` | UI atoms |
+| `css/style.css`, `css/track.css` | The Surface theme |
+
+### I. ONLINE STUDIO ÔÇö Re┼╝yser Sceny (Director)
+`/modules/online_studio/`
+
+> ÔÜá Modu┼é aktualnie pod aktywnym rozwojem ÔÇö start od `START_TUTAJ.md`, potem `00_PAMIEC_SYSTEMU.md` i `15_KIERUNEK_ONLINE.md`. Struktura: `js/director/DirectorApp.js` + `js/tabs/*` + `js/studio_api.js` Ôćĺ `api/online_studio/engine.php`, `api/assets/engine.php`, `api/backoffice/api_menu_studio.php`, `api/online_studio/library_upload.php`.
+
+### J. WAREHOUSE ÔÇö Modu┼é Magazynowy
+`/modules/warehouse/`
+
+| Plik | Rola |
+|------|------|
+| `index.html` | Dashboard (stany, dokumenty, alerty) |
+| `manager_pz.html` | Przyj─Öcie towaru (PZ) |
+| `manager_rw.html` | Rozch├│d wewn─Ötrzny (RW) |
+| `manager_in.html` | Inwentaryzacja (INW) |
+| `manager_kor.html` | Korekta (KOR) |
+| `manager_mm.html` | Przesuni─Öcie mi─Ödzymagazynowe (MM) |
+| `js/warehouse_core.js` | Logika współdzielona |
+| `js/warehouse_api.js` | API wrapper Ôćĺ `api/warehouse/*.php` (wiele endpoint├│w) |
+
+### K. SETTINGS ÔÇö Panel Konfiguracyjny
+`/modules/settings/`
+
+Panel ustawień tenanta, konfiguracja integracji, webhooków, stawek VAT, zmianowych stawek payroll. Opisany w `_docs/13_SETTINGS_PANEL.md`.
+
+---
+
+## 2. BACKEND ÔÇö API & Core
+
+### Endpointy `/api/`
+
+#### Auth & sesje
+| Ścieżka | Opis |
+|---------|------|
+| `auth/login.php` | Auth (mode: `system` / `kiosk`), zwraca JWT |
+
+#### Core engines ÔÇö routing przez `engine.php`
+| Ścieżka | Opis |
+|---------|------|
+| `pos/engine.php` | Router POS (menu, koszyk, checkout, accept, settle, panic) |
+| `tables/engine.php` | Router Stolik├│w + Waiter (plany sali, rachunki, transfery) |
+| `courses/engine.php` | Router logistyki (dispatch, GPS, reconcile, payment lock, recall) |
+| `kds/engine.php` | Router KDS (get_board, bump_order, recall_order) |
+| `online/engine.php` | Router publicznej witryny (storefront, `delivery_zones`, `init_checkout`, `guest_checkout`, `track_order`) |
+| `online_studio/engine.php` | Router Studio Online (director, composer, style presets, scene) |
+| `online_studio/library_upload.php` | Multipart upload biblioteki asset├│w |
+| `backoffice/api_menu_studio.php` | Router Studio menu (CRUD menu, ceny, modyfikatory, receptury) |
+| `backoffice/api_visual_studio.php` | ÔÜá ORPHAN ÔÇö nieu┼╝ywany legacy uploader |
+| `assets/engine.php` | **Single Source of Truth** dla asset├│w (m021): upload, CRUD, health scan |
+| `settings/engine.php` | Router ustawień tenanta |
+
+#### Cart & Orders
+| Ścieżka | Opis |
+|---------|------|
+| `cart/CartEngine.php` | Klasa silnika koszyka (ceny, grosze, half/half) |
+| `cart/calculate.php` | Endpoint kalkulacji koszyka |
+| `orders/checkout.php` | Finalizacja zam├│wienia (kanoniczna / chroniona; nadal za `auth_guard.php`, nie jest publicznym checkoutem storefrontu) |
+| `orders/accept.php` | ­ččí ORPHAN ÔÇö KDS ticket router (multi-station split); dubluje `pos/engine.php#accept_order` |
+| `orders/edit.php` | ­ččí PLANNED ÔÇö edycja zam├│wienia + DeltaEngine (dla admin_hub) |
+| `orders/estimate.php` | ­ččí PLANNED ÔÇö estymacja promised_time (dla scheduled orders) |
+| `orders/panic.php` | ­ččí LEGACY DUPLICATE ÔÇö zast─ůpione przez `pos/engine.php#panic_mode` |
+| `orders/sla_monitor.php` | ­ččí PLANNED ÔÇö aggregate SLA monitor (dla admin_hub + cron) |
+| `orders/DeltaEngine.php` | Klasa wykrywaj─ůca r├│┼╝nice w liniach zam├│wienia |
+
+#### Warehouse
+| Ścieżka | Opis |
+|---------|------|
+| `warehouse/stock_list.php` | Lista stan├│w + filtry |
+| `warehouse/warehouse_list.php` | Słownik magazynów |
+| `warehouse/receipt.php` | PZ ÔÇö przyj─Öcie (wywo┼éuje `core/PzEngine.php`) |
+| `warehouse/internal_rw.php` | RW wewn─Ötrzny |
+| `warehouse/batch_rw.php` | RW masowe |
+| `warehouse/inventory.php` | INW (wywołuje `core/InwEngine.php`) |
+| `warehouse/correction.php` | KOR (wywołuje `core/KorEngine.php`) |
+| `warehouse/transfer.php` | MM (wywołuje `core/MmEngine.php`) |
+| `warehouse/add_item.php` | Dodanie pozycji do słownika |
+| `warehouse/approve.php` | Zatwierdzanie dokument├│w |
+| `warehouse/avco_dict.php` | Słownik AVCO |
+| `warehouse/documents_list.php` | Lista dokument├│w magazynowych |
+| `warehouse/mapping.php` | Mapowanie surowc├│w |
+
+#### Delivery (standalone, koegzystuje z `courses/engine.php`)
+| Ścieżka | Opis |
+|---------|------|
+| `delivery/dispatch.php` | Standalone dispatch endpoint |
+| `delivery/reconcile.php` | Standalone rozliczenie |
+
+#### Payments, Staff, Reports, Dashboard ÔÇö FAZA 3 (wi─Ökszo┼Ť─ç PLANNED)
+| Ścieżka | Status |
+|---------|--------|
+| `payments/settle.php` | ­ččí ORPHAN ÔÇö split-tender settlement, dubluje `pos/engine.php#settle_and_close` |
+| `staff/clock.php` | ­ččí PLANNED ÔÇö clock-in/out (ClockEngine) |
+| `staff/payroll.php` | ­ččí PLANNED ÔÇö payroll single user (PayrollEngine) |
+| `dashboard/team_payroll.php` | ­ččí PLANNED ÔÇö team payroll (TeamPayrollEngine) |
+| `reports/food_cost.php` | ­ččí PLANNED ÔÇö food cost + margin (FoodCostEngine) |
+
+#### Gateway / Integrations (m026ÔÇôm029)
+| Ścieżka | Opis |
+|---------|------|
+| `gateway/intake.php` | Zewn─Ötrzny punkt wej┼Ťcia (multi-key auth, rate limit, idempotency) |
+| `integrations/inbound.php` | Callback handler dla 3rd-party POS / dostawc├│w (webhook inbound) |
+
+#### Utility
+| Ścieżka | Status |
+|---------|--------|
+| `system/generate_seq.php` | ­ččí UTILITY ÔÇö HTTP wrapper na `SequenceEngine` |
+| `studio/generate_key.php` | ­ččí UTILITY ÔÇö HTTP wrapper na `AsciiKeyEngine` |
+| `visual_composer/asset_upload.php` | Smarter uploader dla layer/hero (u┼╝ywany przez online_studio) |
+
+Wszystkie orphan/planned endpointy maj─ů w nag┼é├│wku komentarz `// STATUS: ÔÇŽ` wyja┼Ťniaj─ůcy docelowego konsumenta.
+
+---
+
+### Core `/core/`
+
+#### Foundation
+| Plik | Rola |
+|------|------|
+| `db_config.php` | Po┼é─ůczenie PDO Ôćĺ `$pdo` |
+| `AuthEngine.php` | loginSystem, loginKiosk, getTargetModule |
+| `AuthGuard.php` | Stateless JWT guard (V2) |
+| `auth_guard.php` | Session + JWT guard (akceptuje oba ÔÇö u┼╝ywany w endpointach chronionych; NIE w `api/online/engine.php`) |
+| `JwtProvider.php` | Generowanie / walidacja JWT (HS256) |
+| `CredentialVault.php` | Transparent AEAD encryption dla wra┼╝liwych danych (m029) |
+| `GatewayAuth.php` | Multi-key auth + rate limit + idempotency (m027) |
+
+#### Business engines
+| Plik | Rola |
+|------|------|
+| `OrderStateMachine.php` | Transitions: `new Ôćĺ accepted Ôćĺ preparing Ôćĺ ready Ôćĺ in_delivery Ôćĺ completed / cancelled` |
+| `OrderEventPublisher.php` | Transactional outbox dla event bus (m026) |
+| `WebhookDispatcher.php` | Asynchroniczna dostawa webhook├│w (m026ÔÇôm027) |
+| `PromisedTimeEngine.php` | Obliczanie promised_time (kuchnia + dojazd + bufor) |
+| `SequenceEngine.php` | Atomowa generacja numer├│w dokument├│w (┬ž28) |
+| `AsciiKeyEngine.php` | Transliteracja + normalizacja + collision probe (┬ž29) |
+
+#### Warehouse engines
+| Plik | Rola |
+|------|------|
+| `PzEngine.php` | Przyj─Öcie + AVCO |
+| `WzEngine.php` | Zu┼╝ycie surowc├│w po acceptance (waste + modyfikatory) |
+| `InwEngine.php` | Inwentaryzacja |
+| `KorEngine.php` | Korekta |
+| `MmEngine.php` | Mi─Ödzymagazynowe |
+
+#### Payroll & staff
+| Plik | Rola |
+|------|------|
+| `ClockEngine.php` | Clock-in/out, kalkulacja godzin |
+| `PayrollEngine.php` | Payroll jednostkowy |
+| `TeamPayrollEngine.php` | Payroll agregatowy |
+
+#### Visual & assets
+| Plik | Rola |
+|------|------|
+| `AssetResolver.php` | Unified URL resolver (m021, m025 cleanup) |
+| `SceneResolver.php` | Full dish scene contracts (m022) |
+| `FoodCostEngine.php` | Food cost + margin per-channel |
+
+#### Integrations `/core/Integrations/` (m028)
+| Plik | Rola |
+|------|------|
+| `AdapterRegistry.php` | Rejestr adapter├│w 3rd-party |
+| `BaseAdapter.php` | Klasa bazowa |
+| `IntegrationDispatcher.php` | Wysyłka do adapterów |
+| `DotykackaAdapter.php` | Dotyka─Źka POS |
+| `GastroSoftAdapter.php` | GastroSoft |
+| `PapuAdapter.php` + `PapuClient.php` | Papu (delivery aggregator) |
+
+#### Frontend helpers `/core/js/`
+| Plik | Rola |
+|------|------|
+| `api_client.js` | Bazowy `ApiClient` (fetch wrapper z Bearer tokenem) |
+| `core_validator.js` | Walidatory współdzielone |
+| `neon_pizza_engine.js` | Animacje / efekty wizualne |
+| `scene_renderer.js` | Rendering scen na frontendzie |
+
+---
+
+## 3. BAZA DANYCH & SKRYPTY
+
+### Migracje `/database/migrations/`
+
+| Nr | Plik | Co dodaje |
+|----|------|-----------|
+| 001 | `001_init_slicehub_pro_v2.sql` | Grand schema (wszystkie tabele, widoki, FK, indeksy) |
+| 004 | `004_expand_search_aliases.sql` | sys_items: search_aliases, is_active, is_deleted + PL deklinacje |
+| 006 | `006_studio_mission_control.sql` | sh_categories: VAT / sh_menu_items: PLU, dost─Öpno┼Ť─ç |
+| 007 | `007_pos_engine_columns.sql` | sh_orders: druk paragonu, cart_json, NIP |
+| 008 | `008_delivery_ecosystem.sql` | `sh_driver_locations` (GPS) |
+| 009 | `009_delivery_state_machine.sql` | Stany delivery |
+| 010 | `010_driver_action_type.sql` | Akcje kierowcy (pack_cold, check_idÔÇŽ) |
+| 011 | `011_integration_logs.sql` | Logi integracji 3rd-party |
+| 012 | `012_visual_layers.sql` | Warstwy wizualne (pierwsza iteracja) |
+| 013 | `013_board_companions.sql` | Companions |
+| 014 | `014_global_assets.sql` | Pierwsza iteracja globalnej biblioteki asset├│w |
+| 015 | `015_normalize_three_drivers.sql` | Normalizacja r├│l kierowc├│w |
+| 016 | `016_visual_compositor_upgrade.sql` | Hero photo + kalibracja; surface bg |
+| 017 | `017_online_module_extensions.sql` | Rozszerzenia dla modułu online |
+| 019 | `019_layer_positioning.sql` | Pozycjonowanie warstw |
+| 020 | `020_director_scenes.sql` | Sceny Directora |
+| 021 | `021_unified_asset_library.sql` | **Single Source of Truth** ÔÇö `sh_assets` + `sh_asset_links` |
+| 022 | `022_scene_kit.sql` | Scene Kit (contracts) |
+| 023 | `023_scene_templates_content.sql` | Seedy szablon├│w scen |
+| 024 | `024_modifier_visual_impact.sql` | Wpływ modyfikatorów na wizualny render |
+| 025 | `025_drop_legacy_magic_dict.sql` | Czyszczenie legacy magic_* słowników |
+| 026 | `026_event_system.sql` | Event bus + transactional outbox |
+| 027 | `027_gateway_v2.sql` | Gateway V2 (multi-key, rate limit, idempotency) |
+| 028 | `028_integration_deliveries.sql` | Integracje delivery/POS |
+| 029 | `029_infrastructure_completion.sql` | Domkni─Öcie infrastruktury (vault, webhook retryÔÇŽ) |
+| 030 | `030_scene_harmony_cache.sql` | Cache harmonii sceny |
+| 031 | `031_baked_variants.sql` | "Upieczone" warianty wizualne |
+| 032 | `032_asset_display_name.sql` | `sh_assets.display_name` |
+| **ÔÜá 032** | `032_asset_library_organizer.sql` | **KOLIZJA NUMERU** ÔÇö do przenumerowania na 033 |
+
+> Luki 002/003/005/018 ÔÇö dawne seedy/eksperymenty przeniesione do `seed_demo_all.php` lub `_archive_*.sql`.
+> Szczeg├│┼éy schematu Ôćĺ [`_docs/04_BAZA_DANYCH.md`](04_BAZA_DANYCH.md)
+
+### Skrypty `/scripts/`
+
+| Plik | Co robi | Uruchomienie |
+|------|---------|--------------|
+| `setup_database.php` | Migracje 006/007/008 (bez danych, idempotentny) | Przegl─ůdarka |
+| `seed_demo_all.php` | Unified Demo Seed ÔÇö kompletne dane testowe dla CA┼üEGO systemu | Przegl─ůdarka / CLI |
+| `seed_ultimate_delivery.php` | Delivery Ecosystem Seed ÔÇö kierowcy, zam├│wienia delivery (paid/unpaid), GPS | Przegl─ůdarka |
+
+### Procedura czystej instalacji
+
+```
+1. phpMyAdmin Ôćĺ CREATE DATABASE slicehub_pro_v2 (utf8mb4_unicode_ci)
+2. phpMyAdmin Ôćĺ Import Ôćĺ database/migrations/001_init_slicehub_pro_v2.sql
+3. Kolejno importuj migracje 004 Ôćĺ 032 (zgodnie z numeracj─ů)
+4. Przegl─ůdarka Ôćĺ http://localhost/slicehub/scripts/seed_demo_all.php
+```
+
+---
+
+## 4. LEGACY ÔÇö Strefa kwarantanny
+
+`/_KOPALNIA_WIEDZY_LEGACY/` ÔÇö Stary kod (60+ plik├│w PHP/HTML), w tym przeniesiony tam modu┼é `pos_kelner_STARY/` (dawniej `pos(kelner)/`).
+
+`/_archive/` ÔÇö Niezintegrowane HTML-e magazynowe (manager_in/pz/rw, settings_*).
+
+**ZASADY DLA AI:**
+1. Oba foldery = **STRICTLY READ-ONLY**
+2. Zakaz edycji, zakaz linkowania do nowego UI
+3. S┼éu┼╝─ů wy┼é─ůcznie jako encyklopedia biznesowa ÔÇö czytaj, zrozum logik─Ö, napisz NOWY kod w folderze produkcyjnym
+
+---
+
+## 5. DOKUMENTACJA
+
+| Plik | Zawarto┼Ť─ç |
+|------|-----------|
+| `_docs/START_TUTAJ.md` | **Punkt wej┼Ťcia** ÔÇö od tego pliku zaczynasz czytanie docs |
+| `_docs/00_PAMIEC_SYSTEMU.md` | **NORTH STAR** ÔÇö master reference, 7 nienaruszalnych praw |
+| `_docs/01_KONSTYTUCJA.md` | Konstytucja projektu (cele, filozofia) |
+| `_docs/02_ARCHITEKTURA.md` | Ten plik ÔÇö mapa systemu |
+| `_docs/03_MAPA_KOPALNI.md` | Mapa _KOPALNIA_WIEDZY_LEGACY |
+| `_docs/04_BAZA_DANYCH.md` | Schemat bazy ÔÇö tabele, relacje, konwencje |
+| `_docs/05_INSTRUKCJA_FOTO_UPLOAD.md` | Limity uploadu, walidacja, brief fotograficzny |
+| `_docs/07_INTERACTION_CONTRACT.md` | Kontrakt interakcji frontend Ôćö backend |
+| `_docs/08_ORDER_STATUS_DICTIONARY.md` | Kanoniczny słownik statusów zamówienia |
+| `_docs/09_EVENT_SYSTEM.md` | Event bus (m026) |
+| `_docs/10_GATEWAY_API.md` | Gateway V2 (m027) |
+| `_docs/11_WEBHOOK_DISPATCHER.md` | Webhook dispatcher |
+| `_docs/12_INTEGRATION_ADAPTERS.md` | Adaptery 3rd-party (m028) |
+| `_docs/13_SETTINGS_PANEL.md` | Panel Settings |
+| `_docs/14_INBOUND_CALLBACKS.md` | Callbacki przychodz─ůce |
+| `_docs/15_KIERUNEK_ONLINE.md` | Kierunek rozwoju modułu Online |
+| `_docs/ustalenia.md` | Ustalenia projektowe (roboczy) |
+| `_docs/ARCHIWUM/README.md` | Zasady archiwum dokumentacji |
+| `database/README.md` | Quick start ÔÇö instalacja / reset / aktualizacja bazy |
diff --git a/_docs/04_BAZA_DANYCH.md b/_docs/04_BAZA_DANYCH.md
index e33069e..da2e6cb 100644
--- a/_docs/04_BAZA_DANYCH.md
+++ b/_docs/04_BAZA_DANYCH.md
@@ -1,1024 +1,212 @@
--- phpMyAdmin SQL Dump
--- version 5.2.1
--- https://www.phpmyadmin.net/
---
--- Host: 127.0.0.1
--- Generation Time: Apr 10, 2026 at 10:35 PM
--- Wersja serwera: 10.4.32-MariaDB
--- Wersja PHP: 8.2.12
-
-SET SQL_MODE = "NO_AUTO_VALUE_ON_ZERO";
-START TRANSACTION;
-SET time_zone = "+00:00";
-
-
-/*!40101 SET @OLD_CHARACTER_SET_CLIENT=@@CHARACTER_SET_CLIENT */;
-/*!40101 SET @OLD_CHARACTER_SET_RESULTS=@@CHARACTER_SET_RESULTS */;
-/*!40101 SET @OLD_COLLATION_CONNECTION=@@COLLATION_CONNECTION */;
-/*!40101 SET NAMES utf8mb4 */;
-
---
--- Database: `slicehub_pro_v2`
---
-
--- --------------------------------------------------------
-
---
--- Struktura tabeli dla tabeli `sh_categories`
---
-
-CREATE TABLE `sh_categories` (
-  `id` int(11) NOT NULL,
-  `tenant_id` int(11) NOT NULL,
-  `name` varchar(100) NOT NULL,
-  `ascii_key` varchar(50) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
-  `is_menu` tinyint(1) NOT NULL DEFAULT 1,
-  `display_order` int(11) NOT NULL DEFAULT 0,
-  `is_active` tinyint(1) NOT NULL DEFAULT 1,
-  `is_deleted` tinyint(1) NOT NULL DEFAULT 0,
-  `updated_at` timestamp NOT NULL DEFAULT current_timestamp() ON UPDATE current_timestamp()
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
---
--- Dumping data for table `sh_categories`
---
-
-INSERT INTO `sh_categories` (`id`, `tenant_id`, `name`, `ascii_key`, `is_menu`, `display_order`, `is_active`, `is_deleted`, `updated_at`) VALUES
-(1, 1, 'Pizze Testowe', 'CAT_PIZZE', 1, 1, 1, 0, '2026-04-06 20:23:59'),
-(2, 1, 'ad', '', 1, 0, 1, 0, '2026-04-07 22:01:20'),
-(3, 1, 'weg', '', 1, 0, 1, 0, '2026-04-07 22:03:37'),
-(4, 1, 'asfasf', '', 1, 0, 1, 0, '2026-04-07 22:05:56'),
-(5, 1, 'asf', '', 1, 0, 1, 0, '2026-04-07 22:40:45'),
-(6, 1, 'adfs', '', 1, 0, 1, 0, '2026-04-07 23:03:30'),
-(7, 1, 'BURGERY', '', 1, 0, 1, 0, '2026-04-10 20:30:42');
-
--- --------------------------------------------------------
-
---
--- Struktura tabeli dla tabeli `sh_item_modifiers`
---
-
-CREATE TABLE `sh_item_modifiers` (
-  `item_id` int(11) NOT NULL,
-  `group_id` int(11) NOT NULL
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
---
--- Dumping data for table `sh_item_modifiers`
---
-
-INSERT INTO `sh_item_modifiers` (`item_id`, `group_id`) VALUES
-(1, 11),
-(1, 12),
-(2, 12),
-(3, 12);
-
--- --------------------------------------------------------
-
---
--- Struktura tabeli dla tabeli `sh_menu_items`
---
-
-CREATE TABLE `sh_menu_items` (
-  `id` int(11) NOT NULL,
-  `tenant_id` int(11) NOT NULL,
-  `category_id` int(11) NOT NULL,
-  `ascii_key` varchar(50) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
-  `barcode_ean` varchar(50) DEFAULT NULL,
-  `parent_sku` varchar(100) DEFAULT NULL,
-  `name` varchar(150) NOT NULL,
-  `type` enum('standard','half_half','modifier') CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'standard',
-  `plu_code` varchar(20) CHARACTER SET ascii COLLATE ascii_bin DEFAULT NULL,
-  `printer_group` varchar(50) CHARACTER SET ascii COLLATE ascii_bin DEFAULT 'KITCHEN_1',
-  `display_order` int(11) NOT NULL DEFAULT 0,
-  `available_days` varchar(20) CHARACTER SET ascii COLLATE ascii_bin DEFAULT '1,2,3,4,5,6,7',
-  `available_start` time DEFAULT NULL,
-  `available_end` time DEFAULT NULL,
-  `badge_type` enum('none','new','promo','bestseller','hot') CHARACTER SET ascii COLLATE ascii_bin DEFAULT 'none',
-  `is_secret` tinyint(1) NOT NULL DEFAULT 0,
-  `stock_count` int(11) NOT NULL DEFAULT -1,
-  `vat_rate_dine_in` decimal(5,2) NOT NULL DEFAULT 8.00,
-  `vat_rate_takeaway` decimal(5,2) NOT NULL DEFAULT 8.00,
-  `is_active` tinyint(1) NOT NULL DEFAULT 1,
-  `is_deleted` tinyint(1) NOT NULL DEFAULT 0,
-  `updated_at` timestamp NOT NULL DEFAULT current_timestamp() ON UPDATE current_timestamp(),
-  `is_locked_by_hq` tinyint(1) NOT NULL DEFAULT 0,
-  `publication_status` enum('Draft','Live','Archived') NOT NULL DEFAULT 'Draft',
-  `valid_from` datetime DEFAULT NULL,
-  `valid_to` datetime DEFAULT NULL,
-  `description` text DEFAULT NULL,
-  `image_url` varchar(255) DEFAULT NULL,
-  `marketing_tags` varchar(255) DEFAULT NULL,
-  `allergens_json` longtext CHARACTER SET utf8mb4 COLLATE utf8mb4_bin DEFAULT NULL CHECK (json_valid(`allergens_json`)),
-  `kds_station_id` varchar(50) NOT NULL DEFAULT 'NONE'
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
---
--- Dumping data for table `sh_menu_items`
---
-
-INSERT INTO `sh_menu_items` (`id`, `tenant_id`, `category_id`, `ascii_key`, `barcode_ean`, `parent_sku`, `name`, `type`, `plu_code`, `printer_group`, `display_order`, `available_days`, `available_start`, `available_end`, `badge_type`, `is_secret`, `stock_count`, `vat_rate_dine_in`, `vat_rate_takeaway`, `is_active`, `is_deleted`, `updated_at`, `is_locked_by_hq`, `publication_status`, `valid_from`, `valid_to`, `description`, `image_url`, `marketing_tags`, `allergens_json`, `kds_station_id`) VALUES
-(1, 1, 1, 'ITM_MARGHERITA', NULL, NULL, 'Margherita V1', 'standard', NULL, 'KITCHEN_1', 0, '1,2,3,4,5,6,7', NULL, NULL, 'new', 0, -1, 8.00, 8.00, 1, 0, '2026-04-09 02:18:51', 0, 'Draft', '2026-01-11 18:15:00', '0226-01-15 20:00:00', '', '', '', '[]', 'NONE'),
-(2, 1, 1, 'PIZZA_DI_PARMA', NULL, NULL, 'Pizza di parma', 'standard', NULL, 'KITCHEN_1', 0, '1,2,3,4,5,6,7', NULL, NULL, 'none', 0, -1, 8.00, 8.00, 1, 0, '2026-04-09 02:14:19', 0, 'Draft', '2026-01-11 18:15:00', '0226-01-15 20:00:00', 'najlepsza pizza na swiecie', '', 'asd', '[]', 'NONE'),
-(3, 1, 1, 'DIAWOLA', NULL, NULL, 'diawola', 'standard', NULL, 'KITCHEN_1', 0, '1,2,3,4,5,6,7', NULL, NULL, 'none', 0, -1, 8.00, 8.00, 1, 0, '2026-04-10 19:58:41', 0, 'Live', NULL, NULL, '', '', '', '[\"Gluten\",\"Laktoza\",\"Orzechy\",\"Skorupiaki\",\"Jaja\",\"Ryby\",\"Soja\",\"Seler\",\"Gorczyca\",\"Sezam\",\"Mi\\u0119czaki\"]', 'BAR');
-
--- --------------------------------------------------------
-
---
--- Struktura tabeli dla tabeli `sh_modifiers`
---
-
-CREATE TABLE `sh_modifiers` (
-  `id` int(11) NOT NULL,
-  `group_id` int(11) NOT NULL,
-  `name` varchar(100) NOT NULL,
-  `ascii_key` varchar(50) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
-  `is_active` tinyint(1) NOT NULL DEFAULT 1,
-  `is_deleted` tinyint(1) NOT NULL DEFAULT 0,
-  `updated_at` timestamp NOT NULL DEFAULT current_timestamp() ON UPDATE current_timestamp(),
-  `action_type` enum('NONE','ADD','REMOVE') NOT NULL DEFAULT 'NONE',
-  `linked_warehouse_sku` varchar(50) DEFAULT NULL,
-  `linked_quantity` decimal(10,3) NOT NULL DEFAULT 0.000,
-  `is_default` tinyint(1) NOT NULL DEFAULT 0
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
---
--- Dumping data for table `sh_modifiers`
---
-
-INSERT INTO `sh_modifiers` (`id`, `group_id`, `name`, `ascii_key`, `is_active`, `is_deleted`, `updated_at`, `action_type`, `linked_warehouse_sku`, `linked_quantity`, `is_default`) VALUES
-(1, 1, 'sos czosnkowy', 'OPT_SOS_CZOSNKOWY', 1, 1, '2026-04-07 18:26:01', 'NONE', NULL, 0.000, 0),
-(2, 1, 'sos pomidorowy', 'OPT_SOS_POMIDOROWY', 1, 1, '2026-04-07 18:26:01', 'NONE', NULL, 0.000, 0),
-(3, 1, 'sos czosnkowy', 'OPT_SOS_CZOSNKOWY', 1, 0, '2026-04-07 18:26:01', 'NONE', NULL, 0.000, 0),
-(4, 1, 'sos pomidorowy', 'OPT_SOS_POMIDOROWY', 1, 0, '2026-04-07 18:26:01', 'NONE', NULL, 0.000, 0),
-(5, 2, 'czosnkowy', 'OPT_CZOSNKOWY', 1, 0, '2026-04-07 18:29:18', 'NONE', NULL, 0.000, 0),
-(6, 3, 'asdaa', 'OPT_ASDAA', 1, 0, '2026-04-07 18:43:58', 'NONE', NULL, 0.000, 0),
-(7, 4, 'asdfv', 'OPT_ASDFV', 1, 1, '2026-04-07 18:45:12', 'NONE', NULL, 0.000, 0),
-(8, 4, 'asdfv', 'OPT_ASDFV', 1, 0, '2026-04-07 18:45:12', 'NONE', NULL, 0.000, 0),
-(9, 5, 'Czosnkowy', 'OPT_CZOSNKOWY', 1, 0, '2026-04-07 18:56:15', 'NONE', NULL, 0.000, 0),
-(10, 5, 'Pomidorowy', 'OPT_POMIDOROWY', 1, 0, '2026-04-07 18:56:15', 'NONE', NULL, 0.000, 0),
-(11, 6, 'asd', 'OPT_ASD', 1, 1, '2026-04-07 18:57:16', 'NONE', NULL, 0.000, 0),
-(12, 6, 'asd', 'OPT_ASD', 1, 0, '2026-04-07 18:57:16', 'NONE', NULL, 0.000, 0),
-(13, 7, 'fd', 'OPT_FD', 1, 0, '2026-04-07 22:24:23', 'NONE', NULL, 0.000, 0),
-(14, 8, 'asdfsaf', 'OPT_ASDFSAF', 1, 0, '2026-04-07 22:41:06', 'NONE', NULL, 0.000, 0),
-(15, 9, 'asfdgdsgds', 'OPT_ASFDGDSGDS', 1, 0, '2026-04-07 22:59:52', 'NONE', NULL, 0.000, 0),
-(16, 10, 'sfa', 'OPT_SFA', 1, 0, '2026-04-07 23:03:45', 'NONE', NULL, 0.000, 0),
-(17, 11, 'asdasfsa', 'OPT_ASDASFSA', 1, 1, '2026-04-07 23:12:27', 'NONE', NULL, 0.000, 0),
-(18, 11, 'asdasfsa', 'OPT_ASDASFSA', 1, 0, '2026-04-07 23:12:27', 'ADD', 'SKU_SER_MOZZ', 2.000, 0),
-(19, 12, 'pomidorowy', 'OPT_POMIDOROWY', 1, 0, '2026-04-08 16:59:29', 'NONE', NULL, 0.000, 0),
-(20, 12, 'majonezowy', 'OPT_MAJONEZOWY', 1, 0, '2026-04-08 16:59:29', 'NONE', NULL, 0.000, 0),
-(21, 12, 'ser', 'OPT_SER', 1, 1, '2026-04-09 02:18:35', 'NONE', NULL, 0.000, 0),
-(22, 12, 'sesgrrsgsrhrhrehreh', 'OPT_SER', 1, 0, '2026-04-10 19:59:26', 'NONE', NULL, 0.000, 0);
-
--- --------------------------------------------------------
-
---
--- Struktura tabeli dla tabeli `sh_modifier_groups`
---
-
-CREATE TABLE `sh_modifier_groups` (
-  `id` int(11) NOT NULL,
-  `tenant_id` int(11) NOT NULL,
-  `name` varchar(100) NOT NULL,
-  `min_selection` int(11) NOT NULL DEFAULT 0,
-  `max_selection` int(11) NOT NULL DEFAULT 10,
-  `is_active` tinyint(1) NOT NULL DEFAULT 1,
-  `is_deleted` tinyint(1) NOT NULL DEFAULT 0,
-  `updated_at` timestamp NOT NULL DEFAULT current_timestamp() ON UPDATE current_timestamp(),
-  `ascii_key` varchar(50) DEFAULT NULL,
-  `allow_multi_qty` tinyint(1) NOT NULL DEFAULT 0,
-  `is_locked_by_hq` tinyint(1) NOT NULL DEFAULT 0,
-  `publication_status` enum('Draft','Live','Archived') NOT NULL DEFAULT 'Draft',
-  `valid_from` datetime DEFAULT NULL,
-  `valid_to` datetime DEFAULT NULL,
-  `free_limit` int(11) NOT NULL DEFAULT 0
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
---
--- Dumping data for table `sh_modifier_groups`
---
-
-INSERT INTO `sh_modifier_groups` (`id`, `tenant_id`, `name`, `min_selection`, `max_selection`, `is_active`, `is_deleted`, `updated_at`, `ascii_key`, `allow_multi_qty`, `is_locked_by_hq`, `publication_status`, `valid_from`, `valid_to`, `free_limit`) VALUES
-(1, 1, 'sosy', 0, 10, 1, 0, '2026-04-07 18:25:52', NULL, 0, 0, 'Draft', NULL, NULL, 0),
-(2, 1, 'sosy', 0, 1, 1, 0, '2026-04-07 18:29:18', NULL, 0, 0, 'Draft', NULL, NULL, 0),
-(3, 1, 'asd', 0, 1, 1, 0, '2026-04-07 18:43:58', NULL, 0, 0, 'Draft', NULL, NULL, 0),
-(4, 1, 'acd', 0, 1, 1, 0, '2026-04-07 18:45:09', NULL, 0, 0, 'Draft', NULL, NULL, 0),
-(5, 1, 'Sosy', 0, 20, 1, 0, '2026-04-07 18:56:15', NULL, 0, 0, 'Draft', NULL, NULL, 0),
-(6, 1, 'Sosy', 0, 1, 1, 0, '2026-04-07 18:57:09', NULL, 0, 0, 'Draft', NULL, NULL, 0),
-(7, 1, 'Sosy', 0, 1, 1, 0, '2026-04-07 22:24:23', 'GRP_SOSY', 0, 0, 'Draft', NULL, NULL, 0),
-(8, 1, 'asdasd', 0, 1, 1, 0, '2026-04-07 22:41:06', 'GRP_ASDASD', 0, 0, 'Draft', NULL, NULL, 0),
-(9, 1, 'asdasd', 0, 1, 1, 0, '2026-04-07 22:59:52', 'GRP_ASDASD', 0, 0, 'Draft', NULL, NULL, 0),
-(10, 1, 'adssaf', 0, 1, 1, 0, '2026-04-07 23:03:45', 'GRP_ADSSAF', 0, 0, 'Draft', NULL, NULL, 0),
-(11, 1, 'asffsdg', 0, 1, 1, 0, '2026-04-07 23:12:17', 'GRP_ASFFSDG', 0, 0, 'Draft', NULL, NULL, 0),
-(12, 1, 'SOSY test', 0, 5, 1, 0, '2026-04-08 16:59:29', 'GRP_SOSY_TEST', 1, 0, 'Draft', NULL, NULL, 0);
-
--- --------------------------------------------------------
-
---
--- Struktura tabeli dla tabeli `sh_orders`
---
-
-CREATE TABLE `sh_orders` (
-  `id` int(11) NOT NULL,
-  `tenant_id` int(11) NOT NULL,
-  `uuid` varchar(36) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
-  `order_number` varchar(50) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
-  `source` enum('local','online','kiosk','delivery_aggregator') CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'local',
-  `type` enum('dine_in','takeaway','delivery') CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'dine_in',
-  `status` enum('new','pending','preparing','ready','in_delivery','completed','cancelled') CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'new',
-  `payment_method` enum('cash','card','online','mixed') CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'cash',
-  `payment_status` enum('unpaid','paid','refunded') CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'unpaid',
-  `total_price` decimal(10,2) NOT NULL DEFAULT 0.00,
-  `table_id` int(11) DEFAULT NULL,
-  `created_by` int(11) DEFAULT NULL,
-  `customer_name` varchar(150) DEFAULT NULL,
-  `customer_phone` varchar(20) CHARACTER SET ascii COLLATE ascii_bin DEFAULT NULL,
-  `address` text DEFAULT NULL,
-  `nip` varchar(20) CHARACTER SET ascii COLLATE ascii_bin DEFAULT NULL,
-  `created_at` timestamp NOT NULL DEFAULT current_timestamp(),
-  `updated_at` timestamp NOT NULL DEFAULT current_timestamp() ON UPDATE current_timestamp()
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
--- --------------------------------------------------------
-
---
--- Struktura tabeli dla tabeli `sh_order_items`
---
-
-CREATE TABLE `sh_order_items` (
-  `id` int(11) NOT NULL,
-  `order_id` int(11) NOT NULL,
-  `menu_item_sku` varchar(50) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
-  `snapshot_name` varchar(150) NOT NULL,
-  `quantity` decimal(10,2) NOT NULL DEFAULT 1.00,
-  `unit_price` decimal(10,2) NOT NULL DEFAULT 0.00,
-  `vat_rate` decimal(5,2) NOT NULL DEFAULT 8.00,
-  `course_id` varchar(20) CHARACTER SET ascii COLLATE ascii_bin DEFAULT NULL
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
--- --------------------------------------------------------
-
---
--- Struktura tabeli dla tabeli `sh_order_item_modifiers`
---
-
-CREATE TABLE `sh_order_item_modifiers` (
-  `id` int(11) NOT NULL,
-  `order_item_id` int(11) NOT NULL,
-  `modifier_type` enum('ADDED','REMOVED') CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
-  `modifier_sku` varchar(50) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
-  `snapshot_name` varchar(150) NOT NULL,
-  `price_change` decimal(10,2) NOT NULL DEFAULT 0.00
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
--- --------------------------------------------------------
-
---
--- Struktura tabeli dla tabeli `sh_price_tiers`
---
-
-CREATE TABLE `sh_price_tiers` (
-  `id` int(11) NOT NULL,
-  `target_type` enum('ITEM','MODIFIER') NOT NULL,
-  `target_sku` varchar(50) NOT NULL,
-  `channel` enum('POS','Takeaway','Delivery') NOT NULL,
-  `price` decimal(10,2) NOT NULL DEFAULT 0.00
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
---
--- Dumping data for table `sh_price_tiers`
---
-
-INSERT INTO `sh_price_tiers` (`id`, `target_type`, `target_sku`, `channel`, `price`) VALUES
-(1, 'MODIFIER', 'OPT_FD', 'POS', 1.00),
-(2, 'MODIFIER', 'OPT_FD', 'Takeaway', 1.00),
-(3, 'MODIFIER', 'OPT_FD', 'Delivery', 1.00),
-(4, 'MODIFIER', 'OPT_ASDFSAF', 'POS', 0.00),
-(5, 'MODIFIER', 'OPT_ASDFSAF', 'Takeaway', 0.00),
-(6, 'MODIFIER', 'OPT_ASDFSAF', 'Delivery', 0.00),
-(7, 'ITEM', 'PIZZA_DI_PARMA', 'POS', 90.00),
-(8, 'ITEM', 'PIZZA_DI_PARMA', 'Takeaway', 34.00),
-(9, 'ITEM', 'PIZZA_DI_PARMA', 'Delivery', 34.00),
-(10, 'MODIFIER', 'OPT_ASFDGDSGDS', 'POS', 1.00),
-(11, 'MODIFIER', 'OPT_ASFDGDSGDS', 'Takeaway', 1.00),
-(12, 'MODIFIER', 'OPT_ASFDGDSGDS', 'Delivery', 2.00),
-(13, 'MODIFIER', 'OPT_SFA', 'POS', 10.00),
-(14, 'MODIFIER', 'OPT_SFA', 'Takeaway', 0.00),
-(15, 'MODIFIER', 'OPT_SFA', 'Delivery', 0.00),
-(16, 'MODIFIER', 'OPT_ASDASFSA', 'POS', 1.00),
-(17, 'MODIFIER', 'OPT_ASDASFSA', 'Takeaway', 0.00),
-(18, 'MODIFIER', 'OPT_ASDASFSA', 'Delivery', 0.00),
-(22, 'ITEM', 'ITM_MARGHERITA', 'POS', 200.00),
-(36, 'MODIFIER', 'OPT_POMIDOROWY', 'POS', 9.00),
-(37, 'MODIFIER', 'OPT_POMIDOROWY', 'Takeaway', 9.00),
-(38, 'MODIFIER', 'OPT_POMIDOROWY', 'Delivery', 9.00),
-(39, 'MODIFIER', 'OPT_MAJONEZOWY', 'POS', 9.00),
-(40, 'MODIFIER', 'OPT_MAJONEZOWY', 'Takeaway', 9.00),
-(41, 'MODIFIER', 'OPT_MAJONEZOWY', 'Delivery', 9.00),
-(46, 'ITEM', 'ITM_MARGHERITA', 'Takeaway', 200.00),
-(47, 'ITEM', 'ITM_MARGHERITA', 'Delivery', 200.00),
-(72, 'MODIFIER', 'OPT_SER', 'POS', 2.00),
-(73, 'MODIFIER', 'OPT_SER', 'Takeaway', 0.00),
-(74, 'MODIFIER', 'OPT_SER', 'Delivery', 0.00),
-(87, 'ITEM', 'DIAWOLA', 'POS', 35.00),
-(88, 'ITEM', 'DIAWOLA', 'Takeaway', 35.00),
-(89, 'ITEM', 'DIAWOLA', 'Delivery', 35.00);
-
--- --------------------------------------------------------
-
---
--- Struktura tabeli dla tabeli `sh_recipes`
---
-
-CREATE TABLE `sh_recipes` (
-  `id` int(11) NOT NULL,
-  `tenant_id` int(11) NOT NULL,
-  `menu_item_sku` varchar(50) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
-  `warehouse_sku` varchar(50) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
-  `quantity_base` decimal(10,3) NOT NULL,
-  `waste_percent` decimal(5,2) NOT NULL DEFAULT 0.00,
-  `is_packaging` tinyint(1) NOT NULL DEFAULT 0,
-  `valid_from` date DEFAULT NULL,
-  `valid_to` date DEFAULT NULL,
-  `updated_at` timestamp NOT NULL DEFAULT current_timestamp() ON UPDATE current_timestamp()
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
---
--- Dumping data for table `sh_recipes`
---
-
-INSERT INTO `sh_recipes` (`id`, `tenant_id`, `menu_item_sku`, `warehouse_sku`, `quantity_base`, `waste_percent`, `is_packaging`, `valid_from`, `valid_to`, `updated_at`) VALUES
-(13, 1, 'ITM_MARGHERITA', 'SKU_MAKA_00', 2.000, 0.00, 0, NULL, NULL, '2026-04-07 00:34:48'),
-(14, 1, 'ITM_MARGHERITA', 'SKU_SER_MOZZ', 1.000, 0.00, 0, NULL, NULL, '2026-04-07 00:34:48'),
-(15, 1, 'ITM_MARGHERITA', 'SKU_SOS_MUTTI', 2.000, 0.00, 0, NULL, NULL, '2026-04-07 00:34:48');
-
--- --------------------------------------------------------
-
---
--- Struktura tabeli dla tabeli `sh_recipe_steps`
---
-
-CREATE TABLE `sh_recipe_steps` (
-  `id` int(11) NOT NULL,
-  `tenant_id` int(11) NOT NULL,
-  `menu_item_sku` varchar(50) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
-  `step_order` int(11) NOT NULL DEFAULT 1,
-  `instruction` text NOT NULL,
-  `ccp_temp_min` decimal(5,2) DEFAULT NULL,
-  `ccp_temp_max` decimal(5,2) DEFAULT NULL,
-  `prep_time_seconds` int(11) NOT NULL DEFAULT 0
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
--- --------------------------------------------------------
-
---
--- Struktura tabeli dla tabeli `sh_tables`
---
-
-CREATE TABLE `sh_tables` (
-  `id` int(11) NOT NULL,
-  `tenant_id` int(11) NOT NULL,
-  `table_number` varchar(10) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
-  `qr_key` varchar(50) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
-  `status` enum('free','occupied','dirty','reserved') CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'free',
-  `is_deleted` tinyint(1) NOT NULL DEFAULT 0,
-  `updated_at` timestamp NOT NULL DEFAULT current_timestamp() ON UPDATE current_timestamp()
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
--- --------------------------------------------------------
-
---
--- Struktura tabeli dla tabeli `sh_tenants`
---
-
-CREATE TABLE `sh_tenants` (
-  `id` int(11) NOT NULL,
-  `nip` varchar(20) CHARACTER SET ascii COLLATE ascii_bin DEFAULT NULL,
-  `name` varchar(100) NOT NULL,
-  `primary_color` varchar(7) CHARACTER SET ascii COLLATE ascii_bin DEFAULT '#e63946',
-  `is_active` tinyint(1) NOT NULL DEFAULT 1,
-  `is_deleted` tinyint(1) NOT NULL DEFAULT 0,
-  `created_at` timestamp NOT NULL DEFAULT current_timestamp(),
-  `updated_at` timestamp NOT NULL DEFAULT current_timestamp() ON UPDATE current_timestamp()
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
---
--- Dumping data for table `sh_tenants`
---
-
-INSERT INTO `sh_tenants` (`id`, `nip`, `name`, `primary_color`, `is_active`, `is_deleted`, `created_at`, `updated_at`) VALUES
-(1, NULL, 'Centrala SliceHub', '#e63946', 1, 0, '2026-04-06 20:23:59', '2026-04-06 20:23:59');
-
--- --------------------------------------------------------
-
---
--- Struktura tabeli dla tabeli `sh_users`
---
-
-CREATE TABLE `sh_users` (
-  `id` int(11) NOT NULL,
-  `tenant_id` int(11) NOT NULL,
-  `username` varchar(50) NOT NULL,
-  `first_name` varchar(50) DEFAULT NULL,
-  `last_name` varchar(50) DEFAULT NULL,
-  `password_hash` varchar(255) CHARACTER SET ascii COLLATE ascii_bin DEFAULT NULL,
-  `pin` varchar(4) CHARACTER SET ascii COLLATE ascii_bin DEFAULT NULL,
-  `role` enum('admin','manager','waiter','kitchen','driver') CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'waiter',
-  `is_active` tinyint(1) NOT NULL DEFAULT 1,
-  `is_deleted` tinyint(1) NOT NULL DEFAULT 0,
-  `created_at` timestamp NOT NULL DEFAULT current_timestamp(),
-  `updated_at` timestamp NOT NULL DEFAULT current_timestamp() ON UPDATE current_timestamp()
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
--- --------------------------------------------------------
-
---
--- Struktura tabeli dla tabeli `sh_work_sessions`
---
-
-CREATE TABLE `sh_work_sessions` (
-  `id` int(11) NOT NULL,
-  `tenant_id` int(11) NOT NULL,
-  `user_id` int(11) NOT NULL,
-  `start_time` datetime NOT NULL,
-  `end_time` datetime DEFAULT NULL,
-  `total_time` decimal(10,2) DEFAULT NULL
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
--- --------------------------------------------------------
-
---
--- Struktura tabeli dla tabeli `sys_items`
---
-
-CREATE TABLE `sys_items` (
-  `sku` varchar(50) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
-  `tenant_id` int(11) NOT NULL,
-  `name` varchar(150) NOT NULL,
-  `base_unit` varchar(10) NOT NULL DEFAULT 'szt',
-  `vat_rate_purchase` decimal(5,2) NOT NULL DEFAULT 23.00,
-  `is_active` tinyint(1) NOT NULL DEFAULT 1,
-  `is_deleted` tinyint(1) NOT NULL DEFAULT 0,
-  `updated_at` timestamp NOT NULL DEFAULT current_timestamp() ON UPDATE current_timestamp(),
-  `search_aliases` varchar(255) DEFAULT NULL COMMENT 'Odmiany po przecinku, np. m─ůk─ů, m─ůce, m─ůki',
-  `allergens_json` longtext CHARACTER SET utf8mb4 COLLATE utf8mb4_bin DEFAULT NULL CHECK (json_valid(`allergens_json`))
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
---
--- Dumping data for table `sys_items`
---
-
-INSERT INTO `sys_items` (`sku`, `tenant_id`, `name`, `base_unit`, `vat_rate_purchase`, `is_active`, `is_deleted`, `updated_at`, `search_aliases`, `allergens_json`) VALUES
-('SKU_KARTON_32', 1, 'Karton do Pizzy 32cm', 'szt', 23.00, 1, 0, '2026-04-06 21:38:06', NULL, NULL),
-('SKU_MAKA_00', 1, 'M─ůka Typ 00', 'kg', 0.00, 1, 0, '2026-04-06 22:57:46', 'm─ůka,m─ůk─ů,m─ůce,m─ůki', NULL),
-('SKU_SER_MOZZ', 1, 'Ser Mozzarella', 'kg', 5.00, 1, 0, '2026-04-06 22:57:46', 'ser,serem,sera,serze,mozzarell─ů,mozzarelli', NULL),
-('SKU_SOS_MUTTI', 1, 'Sos Pomidorowy Mutti', 'l', 8.00, 1, 0, '2026-04-06 22:57:46', 'sos,sosem,sosu,pomidorowym', NULL);
-
--- --------------------------------------------------------
-
---
--- Struktura tabeli dla tabeli `wh_inventory_docs`
---
-
-CREATE TABLE `wh_inventory_docs` (
-  `id` int(11) NOT NULL,
-  `tenant_id` int(11) NOT NULL,
-  `doc_number` varchar(50) NOT NULL,
-  `doc_type` enum('PZ','WZ','RW','INW') NOT NULL,
-  `status` enum('DRAFT','COMPLETED','CANCELLED') NOT NULL DEFAULT 'DRAFT',
-  `created_by` int(11) DEFAULT NULL,
-  `notes` text DEFAULT NULL,
-  `created_at` timestamp NOT NULL DEFAULT current_timestamp(),
-  `updated_at` timestamp NOT NULL DEFAULT current_timestamp() ON UPDATE current_timestamp()
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
---
--- Dumping data for table `wh_inventory_docs`
---
-
-INSERT INTO `wh_inventory_docs` (`id`, `tenant_id`, `doc_number`, `doc_type`, `status`, `created_by`, `notes`, `created_at`, `updated_at`) VALUES
-(3, 1, 'PZ/20260409040103', 'PZ', 'COMPLETED', NULL, NULL, '2026-04-09 02:01:03', '2026-04-09 02:01:03'),
-(4, 1, 'PZ/20260409040126', 'PZ', 'COMPLETED', NULL, NULL, '2026-04-09 02:01:26', '2026-04-09 02:01:26'),
-(5, 1, 'PZ/20260409041528', 'PZ', 'COMPLETED', NULL, NULL, '2026-04-09 02:15:28', '2026-04-09 02:15:28'),
-(6, 1, 'PZ/20260409184941', 'PZ', 'COMPLETED', NULL, NULL, '2026-04-09 16:49:41', '2026-04-09 16:49:41'),
-(7, 1, 'PZ/20260409190350', 'PZ', 'COMPLETED', NULL, NULL, '2026-04-09 17:03:50', '2026-04-09 17:03:50'),
-(8, 1, 'RW/20260409191212', 'RW', 'COMPLETED', NULL, 'Zniszczenie', '2026-04-09 17:12:12', '2026-04-09 17:12:12'),
-(9, 1, 'RW/20260409191246', 'RW', 'COMPLETED', NULL, 'Przeterminowanie', '2026-04-09 17:12:46', '2026-04-09 17:12:46'),
-(10, 1, 'RW/20260409191324', 'RW', 'COMPLETED', NULL, 'Przeterminowanie', '2026-04-09 17:13:24', '2026-04-09 17:13:24'),
-(11, 1, 'PZ/20260410204900', 'PZ', 'COMPLETED', NULL, NULL, '2026-04-10 18:49:00', '2026-04-10 18:49:00');
-
--- --------------------------------------------------------
-
---
--- Struktura tabeli dla tabeli `wh_inventory_doc_items`
---
-
-CREATE TABLE `wh_inventory_doc_items` (
-  `id` int(11) NOT NULL,
-  `doc_id` int(11) NOT NULL,
-  `sku` varchar(50) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
-  `qty` decimal(10,3) NOT NULL,
-  `unit_price` decimal(10,2) NOT NULL DEFAULT 0.00,
-  `total_price` decimal(10,2) NOT NULL DEFAULT 0.00
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
---
--- Dumping data for table `wh_inventory_doc_items`
---
-
-INSERT INTO `wh_inventory_doc_items` (`id`, `doc_id`, `sku`, `qty`, `unit_price`, `total_price`) VALUES
-(1, 3, 'SKU_SER_MOZZ', 10.000, 5.00, 50.00),
-(2, 4, 'SKU_SER_MOZZ', 5.000, 7.00, 35.00),
-(3, 5, 'SKU_SER_MOZZ', 5.000, 3.00, 15.00),
-(4, 6, 'SKU_SER_MOZZ', 10.000, 100.00, 1000.00),
-(5, 7, 'SKU_KARTON_32', 100.000, 2.00, 200.00),
-(6, 8, 'SKU_MAKA_00', 100.000, 0.00, 0.00),
-(7, 9, 'SKU_SER_MOZZ', 10.000, 36.67, 366.70),
-(8, 10, 'SKU_SER_MOZZ', 5.000, 36.67, 183.35),
-(9, 11, 'SKU_MAKA_00', 3.000, 1.00, 3.00);
-
--- --------------------------------------------------------
-
---
--- Struktura tabeli dla tabeli `wh_stock`
---
-
-CREATE TABLE `wh_stock` (
-  `id` int(11) NOT NULL,
-  `tenant_id` int(11) NOT NULL,
-  `sku` varchar(50) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
-  `quantity` decimal(10,3) NOT NULL DEFAULT 0.000,
-  `unit_net_cost` decimal(10,2) NOT NULL DEFAULT 0.00,
-  `current_avco_price` decimal(10,2) NOT NULL DEFAULT 0.00,
-  `updated_at` timestamp NOT NULL DEFAULT current_timestamp() ON UPDATE current_timestamp()
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
---
--- Dumping data for table `wh_stock`
---
-
-INSERT INTO `wh_stock` (`id`, `tenant_id`, `sku`, `quantity`, `unit_net_cost`, `current_avco_price`, `updated_at`) VALUES
-(1, 1, 'SKU_SER_MOZZ', 15.000, 100.00, 36.67, '2026-04-09 17:13:24'),
-(5, 1, 'SKU_KARTON_32', 100.000, 2.00, 2.00, '2026-04-09 17:03:50'),
-(6, 1, 'SKU_MAKA_00', -97.000, 1.00, 1.00, '2026-04-10 18:49:00');
-
--- --------------------------------------------------------
-
---
--- Struktura tabeli dla tabeli `wh_stock_logs`
---
-
-CREATE TABLE `wh_stock_logs` (
-  `id` int(11) NOT NULL,
-  `tenant_id` int(11) NOT NULL,
-  `warehouse_id` int(11) NOT NULL DEFAULT 1,
-  `sku` varchar(50) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
-  `change_qty` decimal(10,3) NOT NULL,
-  `after_qty` decimal(10,3) NOT NULL,
-  `document_type` enum('PZ','WZ','RW','INW','MM','MANUAL','POS_SALE') NOT NULL,
-  `document_id` int(11) DEFAULT NULL,
-  `created_by` int(11) DEFAULT NULL,
-  `created_at` timestamp NOT NULL DEFAULT current_timestamp()
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
---
--- Dumping data for table `wh_stock_logs`
---
-
-INSERT INTO `wh_stock_logs` (`id`, `tenant_id`, `warehouse_id`, `sku`, `change_qty`, `after_qty`, `document_type`, `document_id`, `created_by`, `created_at`) VALUES
-(1, 1, 1, 'SKU_SER_MOZZ', 10.000, 10.000, 'PZ', 3, NULL, '2026-04-09 02:01:03'),
-(2, 1, 1, 'SKU_SER_MOZZ', 5.000, 15.000, 'PZ', 4, NULL, '2026-04-09 02:01:26'),
-(3, 1, 1, 'SKU_SER_MOZZ', 5.000, 20.000, 'PZ', 5, NULL, '2026-04-09 02:15:28'),
-(4, 1, 1, 'SKU_SER_MOZZ', 10.000, 30.000, 'PZ', 6, NULL, '2026-04-09 16:49:41'),
-(5, 1, 1, 'SKU_KARTON_32', 100.000, 100.000, 'PZ', 7, NULL, '2026-04-09 17:03:50'),
-(6, 1, 1, 'SKU_MAKA_00', -100.000, -100.000, 'RW', 8, NULL, '2026-04-09 17:12:12'),
-(7, 1, 1, 'SKU_SER_MOZZ', -10.000, 20.000, 'RW', 9, NULL, '2026-04-09 17:12:46'),
-(8, 1, 1, 'SKU_SER_MOZZ', -5.000, 15.000, 'RW', 10, NULL, '2026-04-09 17:13:24'),
-(9, 1, 1, 'SKU_MAKA_00', 3.000, -97.000, 'PZ', 11, NULL, '2026-04-10 18:49:00');
-
--- --------------------------------------------------------
-
---
--- Struktura tabeli dla tabeli `wh_uom_conversions`
---
-
-CREATE TABLE `wh_uom_conversions` (
-  `id` int(11) NOT NULL,
-  `tenant_id` int(11) NOT NULL,
-  `sku` varchar(50) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
-  `purchase_unit_name` varchar(50) NOT NULL,
-  `multiplier` decimal(10,3) NOT NULL
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
---
--- Indeksy dla zrzut├│w tabel
---
-
---
--- Indeksy dla tabeli `sh_categories`
---
-ALTER TABLE `sh_categories`
-  ADD PRIMARY KEY (`id`),
-  ADD KEY `tenant_id` (`tenant_id`);
-
---
--- Indeksy dla tabeli `sh_item_modifiers`
---
-ALTER TABLE `sh_item_modifiers`
-  ADD PRIMARY KEY (`item_id`,`group_id`),
-  ADD KEY `fk_item_mod_group` (`group_id`);
-
---
--- Indeksy dla tabeli `sh_menu_items`
---
-ALTER TABLE `sh_menu_items`
-  ADD PRIMARY KEY (`id`),
-  ADD UNIQUE KEY `uq_menu_ascii` (`ascii_key`),
-  ADD UNIQUE KEY `idx_tenant_ean` (`tenant_id`,`barcode_ean`),
-  ADD KEY `tenant_id` (`tenant_id`),
-  ADD KEY `category_id` (`category_id`),
-  ADD KEY `idx_parent_sku` (`tenant_id`,`parent_sku`);
-
---
--- Indeksy dla tabeli `sh_modifiers`
---
-ALTER TABLE `sh_modifiers`
-  ADD PRIMARY KEY (`id`),
-  ADD KEY `fk_mod_group` (`group_id`);
-
---
--- Indeksy dla tabeli `sh_modifier_groups`
---
-ALTER TABLE `sh_modifier_groups`
-  ADD PRIMARY KEY (`id`);
-
---
--- Indeksy dla tabeli `sh_orders`
---
-ALTER TABLE `sh_orders`
-  ADD PRIMARY KEY (`id`),
-  ADD UNIQUE KEY `uq_order_uuid` (`uuid`),
-  ADD KEY `tenant_id` (`tenant_id`),
-  ADD KEY `table_id` (`table_id`),
-  ADD KEY `created_by` (`created_by`);
-
---
--- Indeksy dla tabeli `sh_order_items`
---
-ALTER TABLE `sh_order_items`
-  ADD PRIMARY KEY (`id`),
-  ADD KEY `order_id` (`order_id`),
-  ADD KEY `menu_item_sku` (`menu_item_sku`);
-
---
--- Indeksy dla tabeli `sh_order_item_modifiers`
---
-ALTER TABLE `sh_order_item_modifiers`
-  ADD PRIMARY KEY (`id`),
-  ADD KEY `order_item_id` (`order_item_id`);
-
---
--- Indeksy dla tabeli `sh_price_tiers`
---
-ALTER TABLE `sh_price_tiers`
-  ADD PRIMARY KEY (`id`),
-  ADD UNIQUE KEY `unique_tier_idx` (`target_type`,`target_sku`,`channel`);
-
---
--- Indeksy dla tabeli `sh_recipes`
---
-ALTER TABLE `sh_recipes`
-  ADD PRIMARY KEY (`id`),
-  ADD KEY `fk_recipes_menu_v3` (`menu_item_sku`),
-  ADD KEY `fk_recipes_wh_v3` (`warehouse_sku`);
-
---
--- Indeksy dla tabeli `sh_recipe_steps`
---
-ALTER TABLE `sh_recipe_steps`
-  ADD PRIMARY KEY (`id`),
-  ADD KEY `fk_steps_menu` (`menu_item_sku`);
-
---
--- Indeksy dla tabeli `sh_tables`
---
-ALTER TABLE `sh_tables`
-  ADD PRIMARY KEY (`id`),
-  ADD KEY `tenant_id` (`tenant_id`);
-
---
--- Indeksy dla tabeli `sh_tenants`
---
-ALTER TABLE `sh_tenants`
-  ADD PRIMARY KEY (`id`);
-
---
--- Indeksy dla tabeli `sh_users`
---
-ALTER TABLE `sh_users`
-  ADD PRIMARY KEY (`id`),
-  ADD KEY `tenant_id` (`tenant_id`);
-
---
--- Indeksy dla tabeli `sh_work_sessions`
---
-ALTER TABLE `sh_work_sessions`
-  ADD PRIMARY KEY (`id`),
-  ADD KEY `tenant_id` (`tenant_id`),
-  ADD KEY `user_id` (`user_id`);
-
---
--- Indeksy dla tabeli `sys_items`
---
-ALTER TABLE `sys_items`
-  ADD PRIMARY KEY (`sku`),
-  ADD KEY `tenant_id` (`tenant_id`);
-
---
--- Indeksy dla tabeli `wh_inventory_docs`
---
-ALTER TABLE `wh_inventory_docs`
-  ADD PRIMARY KEY (`id`),
-  ADD KEY `fk_whdocs_tenant` (`tenant_id`),
-  ADD KEY `fk_whdocs_user` (`created_by`);
-
---
--- Indeksy dla tabeli `wh_inventory_doc_items`
---
-ALTER TABLE `wh_inventory_doc_items`
-  ADD PRIMARY KEY (`id`),
-  ADD KEY `fk_whdocitems_doc` (`doc_id`),
-  ADD KEY `fk_whdocitems_sku` (`sku`);
-
---
--- Indeksy dla tabeli `wh_stock`
---
-ALTER TABLE `wh_stock`
-  ADD PRIMARY KEY (`id`),
-  ADD UNIQUE KEY `uq_stock_tenant_sku` (`tenant_id`,`sku`),
-  ADD KEY `fk_whstock_sku` (`sku`);
-
---
--- Indeksy dla tabeli `wh_stock_logs`
---
-ALTER TABLE `wh_stock_logs`
-  ADD PRIMARY KEY (`id`),
-  ADD KEY `fk_logs_tenant` (`tenant_id`),
-  ADD KEY `fk_logs_sku` (`sku`),
-  ADD KEY `fk_logs_user` (`created_by`);
-
---
--- Indeksy dla tabeli `wh_uom_conversions`
---
-ALTER TABLE `wh_uom_conversions`
-  ADD PRIMARY KEY (`id`),
-  ADD UNIQUE KEY `uq_uom_tenant_sku` (`tenant_id`,`sku`,`purchase_unit_name`),
-  ADD KEY `fk_uom_sku` (`sku`);
-
---
--- AUTO_INCREMENT for dumped tables
---
-
---
--- AUTO_INCREMENT for table `sh_categories`
---
-ALTER TABLE `sh_categories`
-  MODIFY `id` int(11) NOT NULL AUTO_INCREMENT, AUTO_INCREMENT=8;
-
---
--- AUTO_INCREMENT for table `sh_menu_items`
---
-ALTER TABLE `sh_menu_items`
-  MODIFY `id` int(11) NOT NULL AUTO_INCREMENT, AUTO_INCREMENT=4;
-
---
--- AUTO_INCREMENT for table `sh_modifiers`
---
-ALTER TABLE `sh_modifiers`
-  MODIFY `id` int(11) NOT NULL AUTO_INCREMENT, AUTO_INCREMENT=23;
-
---
--- AUTO_INCREMENT for table `sh_modifier_groups`
---
-ALTER TABLE `sh_modifier_groups`
-  MODIFY `id` int(11) NOT NULL AUTO_INCREMENT, AUTO_INCREMENT=13;
-
---
--- AUTO_INCREMENT for table `sh_orders`
---
-ALTER TABLE `sh_orders`
-  MODIFY `id` int(11) NOT NULL AUTO_INCREMENT;
-
---
--- AUTO_INCREMENT for table `sh_order_items`
---
-ALTER TABLE `sh_order_items`
-  MODIFY `id` int(11) NOT NULL AUTO_INCREMENT;
-
---
--- AUTO_INCREMENT for table `sh_order_item_modifiers`
---
-ALTER TABLE `sh_order_item_modifiers`
-  MODIFY `id` int(11) NOT NULL AUTO_INCREMENT;
-
---
--- AUTO_INCREMENT for table `sh_price_tiers`
---
-ALTER TABLE `sh_price_tiers`
-  MODIFY `id` int(11) NOT NULL AUTO_INCREMENT, AUTO_INCREMENT=111;
-
---
--- AUTO_INCREMENT for table `sh_recipes`
---
-ALTER TABLE `sh_recipes`
-  MODIFY `id` int(11) NOT NULL AUTO_INCREMENT, AUTO_INCREMENT=16;
-
---
--- AUTO_INCREMENT for table `sh_recipe_steps`
---
-ALTER TABLE `sh_recipe_steps`
-  MODIFY `id` int(11) NOT NULL AUTO_INCREMENT;
-
---
--- AUTO_INCREMENT for table `sh_tables`
---
-ALTER TABLE `sh_tables`
-  MODIFY `id` int(11) NOT NULL AUTO_INCREMENT;
-
---
--- AUTO_INCREMENT for table `sh_tenants`
---
-ALTER TABLE `sh_tenants`
-  MODIFY `id` int(11) NOT NULL AUTO_INCREMENT, AUTO_INCREMENT=2;
-
---
--- AUTO_INCREMENT for table `sh_users`
---
-ALTER TABLE `sh_users`
-  MODIFY `id` int(11) NOT NULL AUTO_INCREMENT;
-
---
--- AUTO_INCREMENT for table `sh_work_sessions`
---
-ALTER TABLE `sh_work_sessions`
-  MODIFY `id` int(11) NOT NULL AUTO_INCREMENT;
-
---
--- AUTO_INCREMENT for table `wh_inventory_docs`
---
-ALTER TABLE `wh_inventory_docs`
-  MODIFY `id` int(11) NOT NULL AUTO_INCREMENT, AUTO_INCREMENT=12;
-
---
--- AUTO_INCREMENT for table `wh_inventory_doc_items`
---
-ALTER TABLE `wh_inventory_doc_items`
-  MODIFY `id` int(11) NOT NULL AUTO_INCREMENT, AUTO_INCREMENT=10;
-
---
--- AUTO_INCREMENT for table `wh_stock`
---
-ALTER TABLE `wh_stock`
-  MODIFY `id` int(11) NOT NULL AUTO_INCREMENT, AUTO_INCREMENT=8;
-
---
--- AUTO_INCREMENT for table `wh_stock_logs`
---
-ALTER TABLE `wh_stock_logs`
-  MODIFY `id` int(11) NOT NULL AUTO_INCREMENT, AUTO_INCREMENT=10;
-
---
--- AUTO_INCREMENT for table `wh_uom_conversions`
---
-ALTER TABLE `wh_uom_conversions`
-  MODIFY `id` int(11) NOT NULL AUTO_INCREMENT;
-
---
--- Constraints for dumped tables
---
-
---
--- Constraints for table `sh_categories`
---
-ALTER TABLE `sh_categories`
-  ADD CONSTRAINT `fk_categories_tenant` FOREIGN KEY (`tenant_id`) REFERENCES `sh_tenants` (`id`) ON DELETE CASCADE;
-
---
--- Constraints for table `sh_item_modifiers`
---
-ALTER TABLE `sh_item_modifiers`
-  ADD CONSTRAINT `fk_item_mod_group` FOREIGN KEY (`group_id`) REFERENCES `sh_modifier_groups` (`id`) ON DELETE CASCADE,
-  ADD CONSTRAINT `fk_item_mod_item` FOREIGN KEY (`item_id`) REFERENCES `sh_menu_items` (`id`) ON DELETE CASCADE;
-
---
--- Constraints for table `sh_menu_items`
---
-ALTER TABLE `sh_menu_items`
-  ADD CONSTRAINT `fk_menu_category` FOREIGN KEY (`category_id`) REFERENCES `sh_categories` (`id`) ON DELETE CASCADE,
-  ADD CONSTRAINT `fk_menu_tenant` FOREIGN KEY (`tenant_id`) REFERENCES `sh_tenants` (`id`) ON DELETE CASCADE;
-
---
--- Constraints for table `sh_modifiers`
---
-ALTER TABLE `sh_modifiers`
-  ADD CONSTRAINT `fk_mod_group` FOREIGN KEY (`group_id`) REFERENCES `sh_modifier_groups` (`id`) ON DELETE CASCADE;
-
---
--- Constraints for table `sh_orders`
---
-ALTER TABLE `sh_orders`
-  ADD CONSTRAINT `fk_orders_table` FOREIGN KEY (`table_id`) REFERENCES `sh_tables` (`id`) ON DELETE SET NULL,
-  ADD CONSTRAINT `fk_orders_tenant` FOREIGN KEY (`tenant_id`) REFERENCES `sh_tenants` (`id`) ON DELETE CASCADE,
-  ADD CONSTRAINT `fk_orders_user` FOREIGN KEY (`created_by`) REFERENCES `sh_users` (`id`) ON DELETE SET NULL;
-
---
--- Constraints for table `sh_order_items`
---
-ALTER TABLE `sh_order_items`
-  ADD CONSTRAINT `fk_orderitems_order` FOREIGN KEY (`order_id`) REFERENCES `sh_orders` (`id`) ON DELETE CASCADE,
-  ADD CONSTRAINT `fk_orderitems_sku` FOREIGN KEY (`menu_item_sku`) REFERENCES `sh_menu_items` (`ascii_key`) ON DELETE CASCADE;
-
---
--- Constraints for table `sh_order_item_modifiers`
---
-ALTER TABLE `sh_order_item_modifiers`
-  ADD CONSTRAINT `fk_modifiers_orderitem` FOREIGN KEY (`order_item_id`) REFERENCES `sh_order_items` (`id`) ON DELETE CASCADE;
-
---
--- Constraints for table `sh_recipes`
---
-ALTER TABLE `sh_recipes`
-  ADD CONSTRAINT `fk_recipes_menu_v3` FOREIGN KEY (`menu_item_sku`) REFERENCES `sh_menu_items` (`ascii_key`) ON DELETE CASCADE,
-  ADD CONSTRAINT `fk_recipes_wh_v3` FOREIGN KEY (`warehouse_sku`) REFERENCES `sys_items` (`sku`) ON DELETE CASCADE;
-
---
--- Constraints for table `sh_recipe_steps`
---
-ALTER TABLE `sh_recipe_steps`
-  ADD CONSTRAINT `fk_steps_menu` FOREIGN KEY (`menu_item_sku`) REFERENCES `sh_menu_items` (`ascii_key`) ON DELETE CASCADE;
-
---
--- Constraints for table `sh_tables`
---
-ALTER TABLE `sh_tables`
-  ADD CONSTRAINT `fk_tables_tenant` FOREIGN KEY (`tenant_id`) REFERENCES `sh_tenants` (`id`) ON DELETE CASCADE;
-
---
--- Constraints for table `sh_users`
---
-ALTER TABLE `sh_users`
-  ADD CONSTRAINT `fk_users_tenant` FOREIGN KEY (`tenant_id`) REFERENCES `sh_tenants` (`id`) ON DELETE CASCADE;
-
---
--- Constraints for table `sh_work_sessions`
---
-ALTER TABLE `sh_work_sessions`
-  ADD CONSTRAINT `fk_session_tenant` FOREIGN KEY (`tenant_id`) REFERENCES `sh_tenants` (`id`) ON DELETE CASCADE,
-  ADD CONSTRAINT `fk_session_user` FOREIGN KEY (`user_id`) REFERENCES `sh_users` (`id`) ON DELETE CASCADE;
-
---
--- Constraints for table `sys_items`
---
-ALTER TABLE `sys_items`
-  ADD CONSTRAINT `fk_sysitems_tenant` FOREIGN KEY (`tenant_id`) REFERENCES `sh_tenants` (`id`) ON DELETE CASCADE;
-
---
--- Constraints for table `wh_inventory_docs`
---
-ALTER TABLE `wh_inventory_docs`
-  ADD CONSTRAINT `fk_whdocs_tenant` FOREIGN KEY (`tenant_id`) REFERENCES `sh_tenants` (`id`) ON DELETE CASCADE,
-  ADD CONSTRAINT `fk_whdocs_user` FOREIGN KEY (`created_by`) REFERENCES `sh_users` (`id`) ON DELETE SET NULL;
-
---
--- Constraints for table `wh_inventory_doc_items`
---
-ALTER TABLE `wh_inventory_doc_items`
-  ADD CONSTRAINT `fk_whdocitems_doc` FOREIGN KEY (`doc_id`) REFERENCES `wh_inventory_docs` (`id`) ON DELETE CASCADE,
-  ADD CONSTRAINT `fk_whdocitems_sku` FOREIGN KEY (`sku`) REFERENCES `sys_items` (`sku`) ON DELETE CASCADE;
-
---
--- Constraints for table `wh_stock`
---
-ALTER TABLE `wh_stock`
-  ADD CONSTRAINT `fk_whstock_sku` FOREIGN KEY (`sku`) REFERENCES `sys_items` (`sku`) ON DELETE CASCADE,
-  ADD CONSTRAINT `fk_whstock_tenant` FOREIGN KEY (`tenant_id`) REFERENCES `sh_tenants` (`id`) ON DELETE CASCADE;
-
---
--- Constraints for table `wh_stock_logs`
---
-ALTER TABLE `wh_stock_logs`
-  ADD CONSTRAINT `fk_logs_sku` FOREIGN KEY (`sku`) REFERENCES `sys_items` (`sku`) ON DELETE CASCADE,
-  ADD CONSTRAINT `fk_logs_tenant` FOREIGN KEY (`tenant_id`) REFERENCES `sh_tenants` (`id`) ON DELETE CASCADE,
-  ADD CONSTRAINT `fk_logs_user` FOREIGN KEY (`created_by`) REFERENCES `sh_users` (`id`) ON DELETE SET NULL;
-
---
--- Constraints for table `wh_uom_conversions`
---
-ALTER TABLE `wh_uom_conversions`
-  ADD CONSTRAINT `fk_uom_sku` FOREIGN KEY (`sku`) REFERENCES `sys_items` (`sku`) ON DELETE CASCADE,
-  ADD CONSTRAINT `fk_uom_tenant` FOREIGN KEY (`tenant_id`) REFERENCES `sh_tenants` (`id`) ON DELETE CASCADE;
-COMMIT;
-
-/*!40101 SET CHARACTER_SET_CLIENT=@OLD_CHARACTER_SET_CLIENT */;
-/*!40101 SET CHARACTER_SET_RESULTS=@OLD_CHARACTER_SET_RESULTS */;
-/*!40101 SET COLLATION_CONNECTION=@OLD_COLLATION_CONNECTION */;
+# BAZA DANYCH ÔÇö Schemat & Dokumentacja
+
+**Baza:** `slicehub_pro_v2` | **Silnik:** MariaDB 10.4+ / MySQL 8.0+ | **Kodowanie:** utf8mb4_unicode_ci
+
+---
+
+## 1. KONWENCJE
+
+| Reguła | Standard |
+|--------|----------|
+| Prefiks `sh_` | Tabele biznesowe SliceHub |
+| Prefiks `sys_` | Tabele systemowe (surowce) |
+| Prefiks `wh_` | Tabele magazynowe |
+| `tenant_id` | Obowi─ůzkowy FK Ôćĺ `sh_tenant(id)` w ka┼╝dej tabeli danych |
+| Kwoty pieni─Ö┼╝ne | `INT` w groszach (1 PLN = 100) ÔÇö zam├│wienia, rozliczenia |
+| Ceny katalogowe | `DECIMAL(10,2)` w PLN ÔÇö sh_price_tiers, wh_stock |
+| UUID | `CHAR(36)` ÔÇö zam├│wienia, linie, p┼éatno┼Ťci, audyt |
+| Auto ID | `BIGINT UNSIGNED AUTO_INCREMENT` ÔÇö encje (users, items, categories) |
+| Soft delete | `is_deleted TINYINT(1)` zamiast fizycznego DELETE |
+| Statusy | `VARCHAR(32)` ÔÇö walidacja po stronie aplikacji, nie ENUM |
+
+---
+
+## 2. TABELE
+
+### A. Core & Auth
+
+| Tabela | PK | Opis |
+|--------|----|------|
+| `sh_tenant` | `id` AI | Lokale / restauracje (multi-tenant) |
+| `sh_tenant_settings` | `(tenant_id, setting_key)` | KV-store ustawień + pola SLA/prep |
+| `sh_users` | `id` AI | Wszyscy u┼╝ytkownicy systemu |
+
+**sh_tenant_settings** ÔÇö podw├│jna rola:
+- `setting_key = ''` Ôćĺ kolumny SLA (`min_prep_time_minutes`, `sla_green_min`...)
+- `setting_key = 'half_half_surcharge'` Ôćĺ czyste KV (`setting_value`)
+
+**sh_users.role** Ôćĺ `owner` ┬Ě `manager` ┬Ě `waiter` ┬Ě `cook` ┬Ě `driver` ┬Ě `team`
+**sh_users.pin_code** Ôćĺ logowanie kiosk-mode (POS / Driver App). Owner nie ma PINa.
+
+---
+
+### B. Menu & Studio
+
+| Tabela | PK | Opis |
+|--------|----|------|
+| `sh_categories` | `id` AI | Kategorie menu |
+| `sh_menu_items` | `id` AI | Pozycje menu; `ascii_key` = unikalny SKU |
+| `sh_modifier_groups` | `id` AI | Grupy modyfikator├│w |
+| `sh_modifiers` | `id` AI | Konkretne modyfikatory |
+| `sh_item_modifiers` | `(item_id, group_id)` | M:N link pozycja Ôćö grupa modyfikator├│w |
+| `sh_price_tiers` | `id` AI | Ceny omnichannel; UNIQUE `(target_type, target_sku, channel, tenant_id)` |
+| `sh_recipes` | `id` AI | Receptury ÔÇö zu┼╝ycie surowca per pozycja menu |
+| `sh_promo_codes` | `id` AI | Kody rabatowe |
+
+**sh_price_tiers:**
+- `target_type` Ôćĺ `ITEM` / `MODIFIER`
+- `channel` Ôćĺ `POS` / `Takeaway` / `Delivery`
+- `target_sku` Ôćĺ `ascii_key` pozycji lub modyfikatora
+
+**Widok `sh_item_prices`** ÔÇö filtruje `sh_price_tiers` WHERE `target_type = 'ITEM'`
+
+**sh_modifiers.linked_warehouse_sku** ÔÇö opcjonalny link do surowca magazynowego (np. "Podw├│jny ser" Ôćĺ `SER_MOZZ` ├Ś 0.1 kg)
+
+---
+
+### C. Orders & Fleet
+
+| Tabela | PK | Opis |
+|--------|----|------|
+| `sh_orders` | `id` CHAR(36) | Zam├│wienia ÔÇö kwoty w groszach |
+| `sh_order_lines` | `id` CHAR(36) | Linie zam├│wienia ÔÇö modyfikatory w JSON |
+| `sh_order_audit` | `id` AI | Historia zmian status├│w |
+| `sh_order_payments` | `id` CHAR(36) | P┼éatno┼Ťci (split payment ready) |
+| `sh_order_item_modifiers` | `id` AI | Modyfikatory per linia zam├│wienia |
+| `sh_kds_tickets` | `id` CHAR(36) | Tickety KDS (Kitchen Display) |
+| `sh_order_sequences` | `(tenant_id, date)` | Numerator zamówień dziennych |
+| `sh_course_sequences` | `(tenant_id, date)` | Numerator kurs├│w dziennych |
+| `sh_dispatch_log` | `id` CHAR(36) | Log kurs├│w dostawczych (K1, K2...) |
+| `sh_delivery_zones` | `id` AI | Strefy dostawy (POLYGON) |
+| `sh_sla_breaches` | `id` CHAR(36) | Naruszenia SLA |
+| `sh_panic_log` | `id` CHAR(36) | Log Panic Button |
+
+**sh_orders ÔÇö statusy:** `new` Ôćĺ `pending` Ôćĺ `preparing` Ôćĺ `ready` Ôćĺ `in_delivery` Ôćĺ `completed`
+**sh_orders.payment_status:** `unpaid` ┬Ě `paid`
+**sh_orders.payment_method:** `cash` ┬Ě `card` ┬Ě `online`
+**sh_orders.channel:** `pos` ┬Ě `online`
+**sh_orders.order_type:** `dine_in` ┬Ě `takeaway` ┬Ě `delivery`
+**sh_orders.course_id / stop_number:** wypełniane po dispatch (np. `K1`, `L1`)
+
+---
+
+### D. Staff & HR
+
+| Tabela | PK | Opis |
+|--------|----|------|
+| `sh_drivers` | `(tenant_id, user_id)` | Rejestr kierowc├│w; FK Ôćĺ sh_users |
+| `sh_driver_shifts` | `id` AI | Zmiany (kasa startowa, rozliczenie) |
+| `sh_driver_locations` | `(tenant_id, driver_id)` | Real-time GPS ÔÇö UPSERT (migracja 008) |
+| `sh_work_sessions` | `id` AI | Sesje pracy (start/end) |
+| `sh_deductions` | `id` AI | Potr─ůcenia z wynagrodzenia |
+| `sh_meals` | `id` AI | Posiłki pracownicze |
+
+**sh_drivers.status:** `offline` ┬Ě `available` ┬Ě `on_delivery`
+**sh_driver_shifts:** `initial_cash` / `counted_cash` / `variance` ÔÇö w groszach
+
+---
+
+### E. Warehouse
+
+| Tabela | PK | Opis |
+|--------|----|------|
+| `sys_items` | `id` AI | Słownik surowców; `sku` = identyfikator; `base_unit` = kg/l/szt |
+| `wh_stock` | `(tenant_id, warehouse_id, sku)` | Stany magazynowe + cena AVCO |
+| `wh_documents` | `id` AI | Dokumenty (PZ/RW/MM/INW/WZ/KOR) |
+| `wh_document_lines` | `id` AI | Linie dokument├│w (ilo┼Ť─ç, cena, VAT, AVCO) |
+| `wh_stock_logs` | `id` AI | Audit log zmian stan├│w |
+| `wh_inventory_docs` | `id` AI | Dokumenty inwentaryzacji |
+| `wh_inventory_doc_items` | `id` AI | Linie inwentaryzacji |
+| `sh_product_mapping` | `id` AI | Mapowanie faktura Ôćĺ SKU (AutoScan) |
+| `sh_doc_sequences` | `(tenant_id, doc_type, doc_date)` | Numerator dokument├│w magazynowych |
+
+**wh_documents.type:** `PZ` (przyj─Öcie) ┬Ě `RW` (rozch├│d) ┬Ě `MM` (przesuni─Öcie) ┬Ě `INW` (inwentaryzacja) ┬Ě `WZ` (wydanie) ┬Ě `KOR` (korekta)
+**wh_documents.status:** `pending_approval` ┬Ě `completed`
+**wh_stock.current_avco_price:** ┼Ťrednia wa┼╝ona cena (AVCO) w PLN
+
+---
+
+## 3. RELACJE
+
+```
+sh_tenant ÔöÇÔöÉ
+            ÔöťÔöÇÔöÇ sh_tenant_settings
+            ÔöťÔöÇÔöÇ sh_users
+            Ôöé    ÔöťÔöÇÔöÇ sh_drivers ÔöÇÔöÇ sh_driver_locations
+            Ôöé    ÔöťÔöÇÔöÇ sh_driver_shifts
+            Ôöé    ÔöťÔöÇÔöÇ sh_work_sessions
+            Ôöé    ÔöťÔöÇÔöÇ sh_deductions
+            Ôöé    ÔööÔöÇÔöÇ sh_meals
+            ÔöťÔöÇÔöÇ sh_categories
+            Ôöé    ÔööÔöÇÔöÇ sh_menu_items
+            Ôöé         ÔöťÔöÇÔöÇ sh_item_modifiers Ôćĺ sh_modifier_groups Ôćĺ sh_modifiers
+            Ôöé         ÔöťÔöÇÔöÇ sh_recipes Ôćĺ sys_items
+            Ôöé         ÔööÔöÇÔöÇ sh_price_tiers
+            ÔöťÔöÇÔöÇ sh_orders
+            Ôöé    ÔöťÔöÇÔöÇ sh_order_lines Ôćĺ sh_order_item_modifiers
+            Ôöé    ÔöťÔöÇÔöÇ sh_order_audit
+            Ôöé    ÔöťÔöÇÔöÇ sh_order_payments
+            Ôöé    ÔööÔöÇÔöÇ sh_kds_tickets
+            ÔöťÔöÇÔöÇ wh_stock
+            ÔöťÔöÇÔöÇ wh_documents Ôćĺ wh_document_lines
+            ÔöťÔöÇÔöÇ wh_stock_logs
+            ÔööÔöÇÔöÇ sh_dispatch_log
+```
+
+---
+
+## 4. MIGRACJE
+
+| Nr | Plik | Co dodaje |
+|----|------|-----------|
+| 001 | `001_init_slicehub_pro_v2.sql` | Grand schema ÔÇö wszystkie tabele, widoki, FK, indeksy |
+| 004 | `004_expand_search_aliases.sql` | sys_items: `search_aliases`, `is_active`, `is_deleted` + polskie deklinacje |
+| 006 | `006_studio_mission_control.sql` | sh_categories: VAT defaults / sh_menu_items: PLU, dost─Öpno┼Ť─ç |
+| 007 | `007_pos_engine_columns.sql` | sh_orders: druk paragonu, cart_json, NIP |
+| 008 | `008_delivery_ecosystem.sql` | Nowa tabela `sh_driver_locations` (GPS) |
+| 009 | `009_delivery_state_machine.sql` | Delivery state machine |
+| 010 | `010_driver_action_type.sql` | Driver action types |
+| 011 | `011_integration_logs.sql` | Integration logs |
+| 012 | `012_visual_layers.sql` | `sh_visual_layers` ÔÇö mapowanie modifier Ôćĺ warstwa wizualna |
+| 013 | `013_board_companions.sql` | `sh_board_companions` ÔÇö cross-sell companions |
+| 014 | `014_global_assets.sql` | `sh_global_assets` ÔÇö shared visual assets library |
+| 015 | `015_normalize_three_drivers.sql` | Normalizacja kierowc├│w (3 konta testowe) |
+| 016 | `016_visual_compositor_upgrade.sql` | `sh_visual_layers`: +`product_filename`, +`cal_scale`, +`cal_rotate`; `sh_board_companions`: +`product_filename`; `sh_tenant_settings`: +`storefront_surface_bg` |
+
+> Luki 002/003/005 ÔÇö dawne seedy przeniesione do `seed_demo_all.php`.
+> Wszystkie migracje 004ÔÇô016 s─ů **idempotentne**.
+
+---
+
+## 5. DANE TESTOWE ÔÇö `seed_demo_all.php`
+
+### Zakres
+
+| Obszar | Ilo┼Ť─ç | Szczeg├│┼éy |
+|--------|-------|-----------|
+| Tenant | 1 | "SliceHub Pizzeria Poznań" + 5 ustawień |
+| U┼╝ytkownicy | 8 | Unikalne PINy 0000ÔÇô6666; has┼éo systemowe: `password` |
+| Kategorie | 8 | Pizza, Burgery, Makarony, Sałatki, Napoje, Dodatki, Desery, Zestawy |
+| Pozycje menu | 33 | 10 pizz ┬Ě 5 burger├│w ┬Ě 3 makarony ┬Ě 2 sa┼éatki ┬Ě 5 napoj├│w ┬Ě 4 dodatki ┬Ě 2 desery ┬Ě 2 zestawy |
+| Ceny | 112 | 99 ITEM + 13 MODIFIER ├Ś 3 kana┼éy (POS / Takeaway / Delivery +8%) |
+| Modyfikatory | 4 grupy / 13 | Rozmiar pizzy ┬Ě Dodatki ┬Ě Sosy ┬Ě Rozmiar burgera |
+| Surowce | 43 | M─ůka, sery, mi─Ösa, warzywa, napoje, opakowania |
+| Stany magazynowe | 43 | Realistyczne ilo┼Ťci z cenami AVCO |
+| Receptury | 44 linie | Margherita, Pepperoni, Capricciosa, Hawajska, Q.Formaggi, Burger Classic, Bolognese, Cezar, Frytki |
+| Dokumenty WH | 4 | 3├Ś PZ (dostawy) + 1├Ś RW (strata) |
+| Kierowcy | 2 | driver1 (PIN 4444) + driver2 (PIN 5555), zmiany + GPS Poznań |
+| Zam├│wienia | 12 | 3 dine-in ┬Ě 2 takeaway ┬Ě 5 delivery ready ┬Ě 2 delivery completed |
+| Sesje pracy | 6 | manager + waiter1/2 + cook1 + driver1/2 |
+
+### Konta testowe
+
+| Login | Rola | PIN | Moduł docelowy |
+|-------|------|-----|----------------|
+| `admin` | owner | ÔÇö | System login |
+| `manager` | manager | 0000 | POS / Dispatch |
+| `waiter1` | waiter | 1111 | POS |
+| `waiter2` | waiter | 2222 | POS |
+| `cook1` | cook | 3333 | KDS |
+| `driver1` | driver | 4444 | Driver App |
+| `driver2` | driver | 5555 | Driver App |
+| `team1` | team | 6666 | Team App |
diff --git a/api/backoffice/api_menu_studio.php b/api/backoffice/api_menu_studio.php
index 48c023a..58c5cc2 100644
--- a/api/backoffice/api_menu_studio.php
+++ b/api/backoffice/api_menu_studio.php
@@ -4,15 +4,170 @@ header('Access-Control-Allow-Origin: *');
 header('Access-Control-Allow-Methods: POST, OPTIONS');
 header('Access-Control-Allow-Headers: Content-Type, Authorization');
 
+if ($_SERVER['REQUEST_METHOD'] === 'OPTIONS') {
+    http_response_code(204);
+    exit;
+}
+
 $response = ["success" => false, "data" => null, "message" => "Wyst─ůpi┼é b┼é─ůd serwera."];
 
 try {
     require_once '../../core/db_config.php';
     require_once '../../core/auth_guard.php';
+    require_once '../../core/AssetResolver.php';
     if (!isset($pdo)) {
         throw new Exception("Brak po┼é─ůczenia z baz─ů danych.");
     }
 
+    /**
+     * Kasuje poprzednie linki m021 dla dw├│ch r├│l i tworzy nowe (warstwa + hero dodatku).
+     */
+    $syncModifierVisualAssetLinks = static function (
+        PDO $pdo,
+        int $tenantId,
+        string $modifierSku,
+        ?int $layerAssetId,
+        ?int $heroAssetId
+    ): void {
+        if (!AssetResolver::isReady($pdo) || $modifierSku === '') {
+            return;
+        }
+        $del = $pdo->prepare(
+            "DELETE FROM sh_asset_links WHERE tenant_id = ? AND entity_type = 'modifier'
+             AND entity_ref = ? AND role IN ('layer_top_down','modifier_hero')"
+        );
+        $del->execute([$tenantId, $modifierSku]);
+
+        $slots = ['layer_top_down' => $layerAssetId, 'modifier_hero' => $heroAssetId];
+        $ins = $pdo->prepare(
+            "INSERT INTO sh_asset_links (tenant_id, asset_id, entity_type, entity_ref, role, sort_order, is_active)
+             VALUES (?, ?, 'modifier', ?, ?, 0, 1)"
+        );
+        foreach ($slots as $role => $aid) {
+            if ($aid === null || $aid <= 0) {
+                continue;
+            }
+            $chk = $pdo->prepare(
+                "SELECT id FROM sh_assets WHERE id = ? AND is_active = 1 AND deleted_at IS NULL
+                 AND (tenant_id = 0 OR tenant_id = ?) LIMIT 1"
+            );
+            $chk->execute([(int)$aid, $tenantId]);
+            if (!$chk->fetch(PDO::FETCH_ASSOC)) {
+                continue;
+            }
+            $ins->execute([$tenantId, (int)$aid, $modifierSku, $role]);
+        }
+    };
+
+    /** Czy sh_atelier_scenes ma kolumny M022 (scene_kind, parent_category_id). */
+    $atelierHasCategoryCols = false;
+    try {
+        $pdo->query('SELECT scene_kind, parent_category_id FROM sh_atelier_scenes LIMIT 0');
+        $atelierHasCategoryCols = true;
+    } catch (PDOException $e) {
+    }
+
+    /**
+     * Tworzy lub podpina scen─Ö kategorii (scene_kind=category) i zwraca jej ID.
+     */
+    $ensureCategoryAtelierScene = static function (
+        PDO $pdo,
+        int $tenantId,
+        int $categoryId,
+        bool $hasCatCols
+    ): int {
+        if ($categoryId <= 0) {
+            throw new Exception('Nieprawidłowe ID kategorii.');
+        }
+        $sentinel = '__CAT_SCENE_' . $categoryId;
+        if (strlen($sentinel) > 64) {
+            $sentinel = '__C_' . $categoryId;
+        }
+
+        $defaultSpec = [
+            'version'       => 1,
+            'kind'          => 'category_table',
+            'template_key'  => 'category_flat_table',
+            'placements'    => [],
+        ];
+
+        try {
+            $stmtCat = $pdo->prepare(
+                'SELECT category_scene_id FROM sh_categories WHERE tenant_id = ? AND id = ? LIMIT 1'
+            );
+            $stmtCat->execute([$tenantId, $categoryId]);
+            $catRow = $stmtCat->fetch(PDO::FETCH_ASSOC);
+        } catch (\PDOException $e) {
+            throw new Exception('Migracja M022 (kolumna category_scene_id) nie jest dost─Öpna.');
+        }
+        if (!$catRow) {
+            throw new Exception('Kategoria nie istnieje.');
+        }
+        $existingSid = isset($catRow['category_scene_id']) ? (int)$catRow['category_scene_id'] : 0;
+
+        if ($existingSid > 0) {
+            $chk = $pdo->prepare('SELECT id FROM sh_atelier_scenes WHERE id = ? AND tenant_id = ? LIMIT 1');
+            $chk->execute([$existingSid, $tenantId]);
+            if ($chk->fetch(PDO::FETCH_ASSOC)) {
+                if ($hasCatCols) {
+                    $pdo->prepare(
+                        "UPDATE sh_atelier_scenes SET scene_kind = 'category', parent_category_id = ?
+                         WHERE id = ? AND tenant_id = ?"
+                    )->execute([$categoryId, $existingSid, $tenantId]);
+                }
+
+                return $existingSid;
+            }
+        }
+
+        $stmtSent = $pdo->prepare(
+            'SELECT id FROM sh_atelier_scenes WHERE tenant_id = ? AND item_sku = ? LIMIT 1'
+        );
+        $stmtSent->execute([$tenantId, $sentinel]);
+        $sentRow = $stmtSent->fetch(PDO::FETCH_ASSOC);
+        if ($sentRow) {
+            $sid = (int)$sentRow['id'];
+            try {
+                $pdo->prepare('UPDATE sh_categories SET category_scene_id = ? WHERE tenant_id = ? AND id = ?')
+                    ->execute([$sid, $tenantId, $categoryId]);
+            } catch (\PDOException $e) {
+                throw new Exception('Nie mo┼╝na powi─ůza─ç sceny z kategori─ů (category_scene_id).');
+            }
+            if ($hasCatCols) {
+                $pdo->prepare(
+                    "UPDATE sh_atelier_scenes SET scene_kind = 'category', parent_category_id = ?
+                     WHERE id = ? AND tenant_id = ?"
+                )->execute([$categoryId, $sid, $tenantId]);
+            }
+
+            return $sid;
+        }
+
+        $specJson = json_encode($defaultSpec, JSON_UNESCAPED_UNICODE);
+        if ($hasCatCols) {
+            $ins = $pdo->prepare(
+                "INSERT INTO sh_atelier_scenes
+                    (tenant_id, item_sku, spec_json, version, scene_kind, parent_category_id)
+                 VALUES (?, ?, ?, 1, 'category', ?)"
+            );
+            $ins->execute([$tenantId, $sentinel, $specJson, $categoryId]);
+        } else {
+            $ins = $pdo->prepare(
+                'INSERT INTO sh_atelier_scenes (tenant_id, item_sku, spec_json, version) VALUES (?, ?, ?, 1)'
+            );
+            $ins->execute([$tenantId, $sentinel, $specJson]);
+        }
+        $newId = (int)$pdo->lastInsertId();
+        try {
+            $pdo->prepare('UPDATE sh_categories SET category_scene_id = ? WHERE tenant_id = ? AND id = ?')
+                ->execute([$newId, $tenantId, $categoryId]);
+        } catch (\PDOException $e) {
+            throw new Exception('Nie mo┼╝na powi─ůza─ç sceny z kategori─ů (category_scene_id).');
+        }
+
+        return $newId;
+    };
+
     // $tenant_id and $user_id are injected by auth_guard.php
 
     $inputJSON = file_get_contents('php://input');
@@ -26,6 +181,75 @@ try {
     // Helper: Puste warto┼Ťci na NULL dla bazy danych
     $toNull = function($val) { return ($val === '' || $val === null) ? null : $val; };
 
+    // Schema detection: check once if we're on the new (v2) or legacy schema
+    $schemaV2 = false;
+    try {
+        $probe = $pdo->query("SELECT vat_rate_dine_in FROM sh_menu_items LIMIT 0");
+        $schemaV2 = true;
+    } catch (PDOException $e) {
+        $schemaV2 = false;
+    }
+
+    $catHasVat = false;
+    try {
+        $probe = $pdo->query("SELECT default_vat_dine_in FROM sh_categories LIMIT 0");
+        $catHasVat = true;
+    } catch (PDOException $e) {
+        $catHasVat = false;
+    }
+
+    $catHasIsDeleted = false;
+    try {
+        $probe = $pdo->query("SELECT is_deleted FROM sh_categories LIMIT 0");
+        $catHasIsDeleted = true;
+    } catch (PDOException $e) {
+        $catHasIsDeleted = false;
+    }
+
+    $hasPriceTiers = false;
+    try {
+        $probe = $pdo->query("SELECT 1 FROM sh_price_tiers LIMIT 0");
+        $hasPriceTiers = true;
+    } catch (PDOException $e) {
+        $hasPriceTiers = false;
+    }
+
+    $hasDriverActionType = false;
+    try {
+        $pdo->query("SELECT driver_action_type FROM sh_menu_items LIMIT 0");
+        $hasDriverActionType = true;
+    } catch (PDOException $e) {
+        try {
+            $pdo->exec("ALTER TABLE sh_menu_items ADD COLUMN driver_action_type ENUM('none','pack_cold','pack_separate','check_id') NOT NULL DEFAULT 'none'");
+            $hasDriverActionType = true;
+        } catch (PDOException $e2) {}
+    }
+
+    // M022 feature detection ÔÇö Scene Kit & Composition Profile
+    $mi022HasCompositionProfile = false;
+    try {
+        $pdo->query("SELECT composition_profile FROM sh_menu_items LIMIT 0");
+        $mi022HasCompositionProfile = true;
+    } catch (PDOException $e) {}
+
+    $cat022HasLayout = false;
+    try {
+        $pdo->query("SELECT layout_mode, default_composition_profile FROM sh_categories LIMIT 0");
+        $cat022HasLayout = true;
+    } catch (PDOException $e) {}
+
+    $hasSceneTemplates = false;
+    try {
+        $pdo->query("SELECT 1 FROM sh_scene_templates LIMIT 0");
+        $hasSceneTemplates = true;
+    } catch (PDOException $e) {}
+
+    $hasModifierVisualImpact = false;
+    try {
+        $pdo->query("SELECT has_visual_impact FROM sh_modifiers LIMIT 0");
+        $hasModifierVisualImpact = true;
+    } catch (PDOException $e) {}
+
     switch ($action) {
         
         // ==============================================================================
@@ -36,48 +260,955 @@ try {
             if (empty($catName)) {
                 throw new Exception("Nazwa kategorii nie mo┼╝e by─ç pusta.");
             }
-            
-            // Wymuszamy domy┼Ťlne 0 dla display_order
-            $stmt = $pdo->prepare("INSERT INTO sh_categories (tenant_id, name, is_menu, display_order) VALUES (?, ?, 1, 0)");
-            $stmt->execute([$tenant_id, $catName]);
-            
+            $catVatDineIn = floatval($input['defaultVatDineIn'] ?? 8);
+            $catVatTakeaway = floatval($input['defaultVatTakeaway'] ?? 5);
+
+            // M022: layout mode + default composition profile (opcjonalne)
+            $catLayoutMode = in_array($input['layoutMode'] ?? '', ['grouped','individual','hybrid','legacy_list'], true)
+                ? $input['layoutMode'] : 'legacy_list';
+            $catDefaultProfile = trim($input['defaultCompositionProfile'] ?? 'static_hero');
+            if ($catDefaultProfile === '') $catDefaultProfile = 'static_hero';
+
+            if ($cat022HasLayout && $catHasVat) {
+                $stmt = $pdo->prepare("INSERT INTO sh_categories (tenant_id, name, is_menu, display_order, default_vat_dine_in, default_vat_takeaway, layout_mode, default_composition_profile) VALUES (?, ?, 1, 0, ?, ?, ?, ?)");
+                $stmt->execute([$tenant_id, $catName, $catVatDineIn, $catVatTakeaway, $catLayoutMode, $catDefaultProfile]);
+            } elseif ($catHasVat) {
+                $stmt = $pdo->prepare("INSERT INTO sh_categories (tenant_id, name, is_menu, display_order, default_vat_dine_in, default_vat_takeaway) VALUES (?, ?, 1, 0, ?, ?)");
+                $stmt->execute([$tenant_id, $catName, $catVatDineIn, $catVatTakeaway]);
+            } else {
+                $stmt = $pdo->prepare("INSERT INTO sh_categories (tenant_id, name, is_menu, display_order) VALUES (?, ?, 1, 0)");
+                $stmt->execute([$tenant_id, $catName]);
+            }
+
             $response['success'] = true;
             $response['data'] = ['categoryId' => $pdo->lastInsertId()];
             $response['message'] = "Dodano now─ů kategori─Ö.";
             break;
 
+        case 'update_category':
+            $catId = intval($input['categoryId'] ?? 0);
+            $catName = trim($input['name'] ?? '');
+            if ($catId <= 0 || empty($catName)) {
+                throw new Exception("ID kategorii i nazwa s─ů wymagane.");
+            }
+            $catVatDineIn = floatval($input['defaultVatDineIn'] ?? 8);
+            $catVatTakeaway = floatval($input['defaultVatTakeaway'] ?? 5);
+
+            // M022: layout mode + default composition profile (opcjonalne)
+            $catLayoutMode = in_array($input['layoutMode'] ?? '', ['grouped','individual','hybrid','legacy_list'], true)
+                ? $input['layoutMode'] : 'legacy_list';
+            $catDefaultProfile = trim($input['defaultCompositionProfile'] ?? 'static_hero');
+            if ($catDefaultProfile === '') $catDefaultProfile = 'static_hero';
+
+            $catWhere = $catHasIsDeleted ? "AND is_deleted = 0" : "";
+            if ($cat022HasLayout && $catHasVat) {
+                $stmt = $pdo->prepare("UPDATE sh_categories SET name = ?, default_vat_dine_in = ?, default_vat_takeaway = ?, layout_mode = ?, default_composition_profile = ? WHERE id = ? AND tenant_id = ? $catWhere");
+                $stmt->execute([$catName, $catVatDineIn, $catVatTakeaway, $catLayoutMode, $catDefaultProfile, $catId, $tenant_id]);
+            } elseif ($catHasVat) {
+                $stmt = $pdo->prepare("UPDATE sh_categories SET name = ?, default_vat_dine_in = ?, default_vat_takeaway = ? WHERE id = ? AND tenant_id = ? $catWhere");
+                $stmt->execute([$catName, $catVatDineIn, $catVatTakeaway, $catId, $tenant_id]);
+            } else {
+                $stmt = $pdo->prepare("UPDATE sh_categories SET name = ? WHERE id = ? AND tenant_id = ? $catWhere");
+                $stmt->execute([$catName, $catId, $tenant_id]);
+            }
+
+            $response['success'] = true;
+            $response['data'] = ['categoryId' => $catId];
+            $response['message'] = "Zaktualizowano kategori─Ö.";
+            break;
+
+        // ==============================================================================
+        // M023: Scene Kit ÔÇö backgrounds + props + lights + badges per template
+        // ==============================================================================
+        case 'get_scene_kit':
+            if (!$hasSceneTemplates) {
+                $response['success'] = true;
+                $response['data'] = [
+                    'templateKey' => '',
+                    'template' => null,
+                    'kit' => ['backgrounds' => [], 'props' => [], 'lights' => [], 'badges' => []],
+                ];
+                break;
+            }
+            $tplKey = trim($input['templateKey'] ?? '');
+            if ($tplKey === '') {
+                throw new Exception("templateKey jest wymagany.");
+            }
+
+            require_once __DIR__ . '/../../core/SceneResolver.php';
+            $tpl = SceneResolver::getSceneTemplate($pdo, $tplKey);
+            $kit = SceneResolver::getSceneKitAssets($pdo, $tplKey);
+
+            $response['success'] = true;
+            $response['data'] = [
+                'templateKey' => $tplKey,
+                'template'    => $tpl ? [
+                    'asciiKey'           => $tpl['ascii_key'],
+                    'name'               => $tpl['name'],
+                    'kind'               => $tpl['kind'],
+                    'stagePreset'        => $tpl['stage_preset'],
+                    'compositionSchema'  => $tpl['composition_schema'],
+                    'availableCameras'   => $tpl['available_cameras'],
+                    'availableLuts'      => $tpl['available_luts'],
+                    'atmosphericEffects' => $tpl['atmospheric_effects'],
+                    'photographerBrief'  => $tpl['photographer_brief_md'],
+                    'pipelinePreset'     => $tpl['pipeline_preset'],
+                ] : null,
+                'kit' => $kit,
+                'counts' => [
+                    'backgrounds' => count($kit['backgrounds']),
+                    'props'       => count($kit['props']),
+                    'lights'      => count($kit['lights']),
+                    'badges'      => count($kit['badges']),
+                ],
+            ];
+            break;
+
+        // ==============================================================================
+        // M023.7 ┬Ě Scene Kit Editor ÔÇö zapis scene_kit_assets_json per template.
+        //
+        // Wej┼Ťcie: { templateKey, kit: { backgrounds:int[], props:int[], lights:int[], badges:int[] } }
+        // Semantyka:
+        //   - Pr├│buje znale┼║─ç template tenanta (tenant_id = $tenant_id) o tym asciiKey.
+        //   - Je┼Ťli nie istnieje, a istnieje system template (tenant_id = 0) ÔÇö klonuje
+        //     go do tenant-specific (copy metadanych + nowy scene_kit_assets_json).
+        //   - Odpowied┼║: { templateId, cloned }. System template pozostaje nietkni─Öty.
+        // ==============================================================================
+        case 'save_scene_kit':
+            if (!$hasSceneTemplates) {
+                throw new Exception('Migracja M022 (sh_scene_templates) nie jest dost─Öpna.');
+            }
+            $tplKey = trim($input['templateKey'] ?? '');
+            if ($tplKey === '') {
+                throw new Exception('templateKey jest wymagany.');
+            }
+            $kitIn = is_array($input['kit'] ?? null) ? $input['kit'] : [];
+            $kit = [];
+            foreach (['backgrounds', 'props', 'lights', 'badges'] as $k) {
+                $raw = isset($kitIn[$k]) && is_array($kitIn[$k]) ? $kitIn[$k] : [];
+                $ids = [];
+                foreach ($raw as $v) {
+                    $id = (int)$v;
+                    if ($id > 0 && !in_array($id, $ids, true)) {
+                        $ids[] = $id;
+                    }
+                }
+                $kit[$k] = $ids;
+            }
+
+            $allIds = array_merge($kit['backgrounds'], $kit['props'], $kit['lights'], $kit['badges']);
+            if (!empty($allIds)) {
+                $ph = implode(',', array_fill(0, count($allIds), '?'));
+                $chk = $pdo->prepare(
+                    "SELECT id FROM sh_assets
+                     WHERE id IN ($ph) AND (tenant_id = 0 OR tenant_id = ?) AND deleted_at IS NULL AND is_active = 1"
+                );
+                $chk->execute(array_merge($allIds, [$tenant_id]));
+                $validIds = array_map('intval', $chk->fetchAll(PDO::FETCH_COLUMN));
+                foreach ($kit as $k => $ids) {
+                    $kit[$k] = array_values(array_filter($ids, fn($id) => in_array($id, $validIds, true)));
+                }
+            }
+
+            $tenantTpl = $pdo->prepare(
+                "SELECT id FROM sh_scene_templates
+                 WHERE tenant_id = ? AND ascii_key = ? LIMIT 1"
+            );
+            $tenantTpl->execute([$tenant_id, $tplKey]);
+            $tenantTplId = (int)($tenantTpl->fetchColumn() ?: 0);
+
+            $cloned = false;
+            if ($tenantTplId === 0) {
+                $sysTpl = $pdo->prepare(
+                    "SELECT ascii_key, name, kind, stage_preset_json, composition_schema_json,
+                            available_cameras_json, available_luts_json, atmospheric_effects_json,
+                            photographer_brief_md, pipeline_preset_json,
+                            default_style_id, placeholder_asset_id
+                     FROM sh_scene_templates
+                     WHERE tenant_id = 0 AND ascii_key = ? LIMIT 1"
+                );
+                $sysTpl->execute([$tplKey]);
+                $sys = $sysTpl->fetch(PDO::FETCH_ASSOC);
+                if (!$sys) {
+                    throw new Exception('Nie znaleziono template o tym asciiKey (ani tenant, ani system).');
+                }
+                $ins = $pdo->prepare(
+                    "INSERT INTO sh_scene_templates
+                        (tenant_id, ascii_key, name, kind, stage_preset_json, composition_schema_json,
+                         available_cameras_json, available_luts_json, atmospheric_effects_json,
+                         scene_kit_assets_json,
+                         photographer_brief_md, pipeline_preset_json,
+                         default_style_id, placeholder_asset_id,
+                         is_system, is_active)
+                     VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,0,1)"
+                );
+                $ins->execute([
+                    $tenant_id,
+                    $sys['ascii_key'],
+                    $sys['name'],
+                    $sys['kind'],
+                    $sys['stage_preset_json'],
+                    $sys['composition_schema_json'],
+                    $sys['available_cameras_json'],
+                    $sys['available_luts_json'],
+                    $sys['atmospheric_effects_json'],
+                    json_encode($kit, JSON_UNESCAPED_UNICODE),
+                    $sys['photographer_brief_md'],
+                    $sys['pipeline_preset_json'],
+                    $sys['default_style_id'],
+                    $sys['placeholder_asset_id'],
+                ]);
+                $tenantTplId = (int)$pdo->lastInsertId();
+                $cloned = true;
+            } else {
+                $upd = $pdo->prepare(
+                    "UPDATE sh_scene_templates SET scene_kit_assets_json = ?, updated_at = CURRENT_TIMESTAMP
+                     WHERE id = ? AND tenant_id = ? LIMIT 1"
+                );
+                $upd->execute([
+                    json_encode($kit, JSON_UNESCAPED_UNICODE),
+                    $tenantTplId,
+                    $tenant_id,
+                ]);
+            }
+
+            $response['success'] = true;
+            $response['data'] = [
+                'templateId' => $tenantTplId,
+                'cloned'     => $cloned,
+                'kitCounts'  => [
+                    'backgrounds' => count($kit['backgrounds']),
+                    'props'       => count($kit['props']),
+                    'lights'      => count($kit['lights']),
+                    'badges'      => count($kit['badges']),
+                ],
+            ];
+            $response['message'] = $cloned
+                ? 'Utworzono tenant-specific wersj─Ö szablonu i zapisano kit.'
+                : 'Zapisano scene kit.';
+            break;
+
+        // ==============================================================================
+        // M022: Lista scene templates ÔÇö dla select├│w w Menu Studio UI
+        // ==============================================================================
+        case 'list_scene_templates':
+            if (!$hasSceneTemplates) {
+                $response['success'] = true;
+                $response['data'] = ['templates' => []];
+                break;
+            }
+            $kindFilter = in_array($input['kind'] ?? '', ['item','category'], true) ? $input['kind'] : null;
+            if ($kindFilter) {
+                $stmt = $pdo->prepare(
+                    "SELECT ascii_key, name, kind, photographer_brief_md, is_system
+                     FROM sh_scene_templates
+                     WHERE (tenant_id = 0 OR tenant_id = ?) AND is_active = 1 AND kind = ?
+                     ORDER BY (tenant_id = 0) DESC, name ASC"
+                );
+                $stmt->execute([$tenant_id, $kindFilter]);
+            } else {
+                $stmt = $pdo->prepare(
+                    "SELECT ascii_key, name, kind, photographer_brief_md, is_system
+                     FROM sh_scene_templates
+                     WHERE (tenant_id = 0 OR tenant_id = ?) AND is_active = 1
+                     ORDER BY kind ASC, (tenant_id = 0) DESC, name ASC"
+                );
+                $stmt->execute([$tenant_id]);
+            }
+            $tpls = [];
+            foreach ($stmt->fetchAll(PDO::FETCH_ASSOC) as $t) {
+                $tpls[] = [
+                    'asciiKey'           => (string)$t['ascii_key'],
+                    'name'               => (string)$t['name'],
+                    'kind'               => (string)$t['kind'],
+                    'photographerBrief'  => $t['photographer_brief_md'] ?? null,
+                    'isSystem'           => (bool)$t['is_system'],
+                ];
+            }
+            $response['success'] = true;
+            $response['data'] = ['templates' => $tpls];
+            break;
+
+        // ==============================================================================
+        // M024: Biblioteka asset├│w ÔÇö picker (Menu Studio ┬Ě modyfikatory)
+        // ==============================================================================
+        case 'list_assets_compact':
+            if (!AssetResolver::isReady($pdo)) {
+                $response['success'] = true;
+                $response['data'] = ['assets' => []];
+                break;
+            }
+            $lim = (int)($input['limit'] ?? 500);
+            $lim = max(50, min(800, $lim));
+            $stmt = $pdo->prepare(
+                "SELECT id, ascii_key, storage_url, category, role_hint, sub_type
+                 FROM sh_assets
+                 WHERE (tenant_id = 0 OR tenant_id = ?) AND is_active = 1 AND deleted_at IS NULL
+                 ORDER BY tenant_id DESC, category ASC, ascii_key ASC
+                 LIMIT {$lim}"
+            );
+            $stmt->execute([$tenant_id]);
+            $assets = [];
+            foreach ($stmt->fetchAll(PDO::FETCH_ASSOC) as $r) {
+                $assets[] = [
+                    'id'        => (int)$r['id'],
+                    'asciiKey'  => (string)$r['ascii_key'],
+                    'previewUrl'=> AssetResolver::publicUrl((string)$r['storage_url']),
+                    'category'  => $r['category'],
+                    'roleHint'  => $r['role_hint'],
+                    'subType'   => $r['sub_type'],
+                ];
+            }
+            $response['success'] = true;
+            $response['data'] = ['assets' => $assets];
+            break;
+
+        // ==============================================================================
+        // M024: Wizualne sloty modyfikatora (layer_top_down + modifier_hero)
+        // ==============================================================================
+        case 'get_modifier_visual':
+            $modSku = preg_replace('/[^a-zA-Z0-9_-]/', '', $input['modifierSku'] ?? '');
+            if ($modSku === '') {
+                throw new Exception('modifierSku jest wymagany.');
+            }
+            $modCols = 'm.id, m.name, m.ascii_key, m.group_id';
+            if ($hasModifierVisualImpact) {
+                $modCols .= ', m.has_visual_impact';
+            }
+            $stmt = $pdo->prepare(
+                "SELECT {$modCols}
+                 FROM sh_modifiers m
+                 INNER JOIN sh_modifier_groups mg ON mg.id = m.group_id AND mg.tenant_id = ?
+                 WHERE m.ascii_key = ? AND m.is_deleted = 0
+                 LIMIT 1"
+            );
+            $stmt->execute([$tenant_id, $modSku]);
+            $mod = $stmt->fetch(PDO::FETCH_ASSOC);
+            if (!$mod) {
+                throw new Exception('Nie znaleziono modyfikatora.');
+            }
+            $hasVi = true;
+            if ($hasModifierVisualImpact) {
+                $hasVi = (bool)((int)($mod['has_visual_impact'] ?? 1));
+            }
+            $slots = [
+                'layer_top_down' => null,
+                'modifier_hero'  => null,
+            ];
+            if (AssetResolver::isReady($pdo)) {
+                $st2 = $pdo->prepare(
+                    "SELECT al.role, al.asset_id, a.ascii_key, a.storage_url
+                     FROM sh_asset_links al
+                     INNER JOIN sh_assets a ON a.id = al.asset_id AND a.is_active = 1 AND a.deleted_at IS NULL
+                     WHERE al.tenant_id = ? AND al.entity_type = 'modifier' AND al.entity_ref = ?
+                       AND al.role IN ('layer_top_down','modifier_hero') AND al.is_active = 1 AND al.deleted_at IS NULL
+                     ORDER BY al.sort_order ASC, al.id DESC"
+                );
+                $st2->execute([$tenant_id, $modSku]);
+                foreach ($st2->fetchAll(PDO::FETCH_ASSOC) as $row) {
+                    $rk = (string)$row['role'];
+                    if (!isset($slots[$rk]) || $slots[$rk] !== null) {
+                        continue;
+                    }
+                    $slots[$rk] = [
+                        'assetId'    => (int)$row['asset_id'],
+                        'asciiKey'   => (string)$row['ascii_key'],
+                        'previewUrl' => AssetResolver::publicUrl((string)$row['storage_url']),
+                    ];
+                }
+            }
+            $response['success'] = true;
+            $response['data'] = [
+                'modifierId'      => (int)$mod['id'],
+                'modifierSku'     => (string)$mod['ascii_key'],
+                'name'            => (string)$mod['name'],
+                'hasVisualImpact' => $hasVi,
+                'slots'           => $slots,
+                'libraryReady'    => AssetResolver::isReady($pdo),
+            ];
+            break;
+
+        case 'save_modifier_visual':
+            $modSku = preg_replace('/[^a-zA-Z0-9_-]/', '', $input['modifierSku'] ?? '');
+            if ($modSku === '') {
+                throw new Exception('modifierSku jest wymagany.');
+            }
+            $stmt = $pdo->prepare(
+                "SELECT m.id FROM sh_modifiers m
+                 INNER JOIN sh_modifier_groups mg ON mg.id = m.group_id AND mg.tenant_id = ?
+                 WHERE m.ascii_key = ? AND m.is_deleted = 0 LIMIT 1"
+            );
+            $stmt->execute([$tenant_id, $modSku]);
+            $row = $stmt->fetch(PDO::FETCH_ASSOC);
+            if (!$row) {
+                throw new Exception('Nie znaleziono modyfikatora.');
+            }
+            $modId = (int)$row['id'];
+            $hasVi = array_key_exists('hasVisualImpact', $input)
+                ? (!empty($input['hasVisualImpact']) ? 1 : 0)
+                : 1;
+            $layerId = isset($input['layerTopDownAssetId']) ? (int)$input['layerTopDownAssetId'] : 0;
+            $heroId  = isset($input['modifierHeroAssetId']) ? (int)$input['modifierHeroAssetId'] : 0;
+            $layerId = $layerId > 0 ? $layerId : null;
+            $heroId  = $heroId > 0 ? $heroId : null;
+
+            if ($hasModifierVisualImpact) {
+                $pdo->prepare('UPDATE sh_modifiers SET has_visual_impact = ? WHERE id = ?')
+                    ->execute([$hasVi, $modId]);
+            }
+            $syncModifierVisualAssetLinks($pdo, $tenant_id, $modSku, $layerId, $heroId);
+
+            $response['success'] = true;
+            $response['message'] = 'Zapisano ustawienia wizualne modyfikatora.';
+            $response['data'] = ['modifierId' => $modId];
+            break;
+
+        // ==============================================================================
+        // M1 ┬Ě Menu Studio Polish ÔÇö Przypisanie hero z biblioteki do dania
+        // Jedno danie = JEDEN hero (role='hero', entity_type='menu_item'). Akcja
+        // najpierw "soft-deletuje" istniej─ůcy link hero, potem upsertuje nowy.
+        // Akceptuje assetId (globalny sh_assets.tenant_id=0 lub nasz tenant).
+        // ==============================================================================
+        case 'set_item_hero':
+            if (!AssetResolver::isReady($pdo)) {
+                throw new Exception('Biblioteka asset├│w (m021) nie jest jeszcze zainicjalizowana.');
+            }
+            $itemSku = preg_replace('/[^a-zA-Z0-9_-]/', '', (string)($input['itemSku'] ?? ''));
+            $assetId = (int)($input['assetId'] ?? 0);
+            if ($itemSku === '') {
+                throw new Exception('itemSku jest wymagany.');
+            }
+            if ($assetId <= 0) {
+                throw new Exception('assetId jest wymagany.');
+            }
+
+            $chkItem = $pdo->prepare(
+                "SELECT id FROM sh_menu_items
+                 WHERE tenant_id = ? AND ascii_key = ? AND is_deleted = 0 LIMIT 1"
+            );
+            $chkItem->execute([$tenant_id, $itemSku]);
+            if (!$chkItem->fetch(PDO::FETCH_ASSOC)) {
+                throw new Exception('Nie znaleziono dania o SKU: ' . $itemSku);
+            }
+
+            $chkAsset = $pdo->prepare(
+                "SELECT id, storage_url FROM sh_assets
+                 WHERE id = ? AND is_active = 1 AND deleted_at IS NULL
+                   AND (tenant_id = 0 OR tenant_id = ?) LIMIT 1"
+            );
+            $chkAsset->execute([$assetId, $tenant_id]);
+            $assetRow = $chkAsset->fetch(PDO::FETCH_ASSOC);
+            if (!$assetRow) {
+                throw new Exception('Asset nie istnieje lub jest niedost─Öpny.');
+            }
+
+            $pdo->beginTransaction();
+            try {
+                $pdo->prepare(
+                    "UPDATE sh_asset_links SET deleted_at = CURRENT_TIMESTAMP, is_active = 0
+                     WHERE tenant_id = ? AND entity_type = 'menu_item'
+                       AND entity_ref = ? AND role = 'hero'
+                       AND is_active = 1 AND deleted_at IS NULL"
+                )->execute([$tenant_id, $itemSku]);
+
+                $pdo->prepare(
+                    "INSERT INTO sh_asset_links
+                        (tenant_id, asset_id, entity_type, entity_ref, role, sort_order, is_active, created_at)
+                     VALUES (?, ?, 'menu_item', ?, 'hero', 0, 1, CURRENT_TIMESTAMP)
+                     ON DUPLICATE KEY UPDATE
+                        sort_order = 0, is_active = 1, deleted_at = NULL,
+                        updated_at = CURRENT_TIMESTAMP"
+                )->execute([$tenant_id, $assetId, $itemSku]);
+
+                $pdo->commit();
+            } catch (\Throwable $e) {
+                $pdo->rollBack();
+                throw new Exception('Nie udało się zapisać linku hero: ' . $e->getMessage());
+            }
+
+            $newUrl = AssetResolver::publicUrl((string)$assetRow['storage_url']);
+            $response['success'] = true;
+            $response['message'] = 'Hero przypisany do dania.';
+            $response['data'] = [
+                'itemSku'  => $itemSku,
+                'assetId'  => $assetId,
+                'imageUrl' => $newUrl,
+            ];
+            break;
+
+        // ==============================================================================
+        // M1 ┬Ě Menu Studio Polish ÔÇö Od┼é─ůczenie hero od dania (soft-delete linku)
+        // ==============================================================================
+        case 'unlink_item_hero':
+            if (!AssetResolver::isReady($pdo)) {
+                throw new Exception('Biblioteka asset├│w (m021) nie jest jeszcze zainicjalizowana.');
+            }
+            $itemSku = preg_replace('/[^a-zA-Z0-9_-]/', '', (string)($input['itemSku'] ?? ''));
+            if ($itemSku === '') {
+                throw new Exception('itemSku jest wymagany.');
+            }
+            $upd = $pdo->prepare(
+                "UPDATE sh_asset_links SET deleted_at = CURRENT_TIMESTAMP, is_active = 0
+                 WHERE tenant_id = ? AND entity_type = 'menu_item'
+                   AND entity_ref = ? AND role = 'hero'
+                   AND is_active = 1 AND deleted_at IS NULL"
+            );
+            $upd->execute([$tenant_id, $itemSku]);
+            $response['success'] = true;
+            $response['message'] = $upd->rowCount() > 0
+                ? 'Hero od┼é─ůczony.'
+                : 'Nie było aktywnego linku hero.';
+            $response['data'] = ['itemSku' => $itemSku, 'removed' => $upd->rowCount()];
+            break;
+
+        // ==============================================================================
+        // M1 ┬Ě Menu Studio Polish ÔÇö Auto-generator default composition dania
+        // Składa scenę z: (1) hero dania jako base layer, (2) modyfikatorów z
+        // action_type='NONE' + is_default=1 + has_visual_impact=1 i przypisanymi
+        // assetami w roli layer_top_down. Zapis do sh_atelier_scenes.spec_json.
+        // Respektuje istniej─ůce sceny (force=true ┼╝eby nadpisa─ç).
+        // ==============================================================================
+        case 'autogenerate_scene':
+            require_once __DIR__ . '/../../core/SceneResolver.php';
+            require_once __DIR__ . '/../../core/AssetResolver.php';
+
+            $itemSku = preg_replace('/[^a-zA-Z0-9_-]/', '', (string)($input['itemSku'] ?? ''));
+            $force = !empty($input['force']);
+            if ($itemSku === '') {
+                throw new Exception('itemSku jest wymagany.');
+            }
+            if (!SceneResolver::isReady($pdo)) {
+                throw new Exception('Auto-generator wymaga migracji M022 (sh_atelier_scenes / sh_scene_templates).');
+            }
+
+            $stmt = $pdo->prepare(
+                "SELECT id, name, category_id, ascii_key
+                 FROM sh_menu_items
+                 WHERE tenant_id = ? AND ascii_key = ? AND is_deleted = 0
+                 LIMIT 1"
+            );
+            $stmt->execute([$tenant_id, $itemSku]);
+            $item = $stmt->fetch(PDO::FETCH_ASSOC);
+            if (!$item) {
+                throw new Exception('Nie znaleziono dania o SKU: ' . $itemSku);
+            }
+
+            $stmt = $pdo->prepare(
+                "SELECT id, spec_json, version FROM sh_atelier_scenes
+                 WHERE tenant_id = ? AND item_sku = ? LIMIT 1"
+            );
+            $stmt->execute([$tenant_id, $itemSku]);
+            $existingScene = $stmt->fetch(PDO::FETCH_ASSOC);
+
+            if ($existingScene && !$force) {
+                $existingSpec = json_decode((string)$existingScene['spec_json'], true);
+                $existingLayers = $existingSpec['pizza']['layers'] ?? [];
+                if (is_array($existingLayers) && count($existingLayers) > 0) {
+                    $response['success'] = false;
+                    $response['data'] = [
+                        'reason'       => 'scene_exists',
+                        'sceneId'      => (int)$existingScene['id'],
+                        'layerCount'   => count($existingLayers),
+                        'version'      => (int)$existingScene['version'],
+                    ];
+                    $response['message'] = 'Scena ju┼╝ istnieje (' . count($existingLayers) . ' warstw). Wy┼Ťlij force=true, aby nadpisa─ç.';
+                    break;
+                }
+            }
+
+            $layers = [];
+            $nextZ = 0;
+
+            if (AssetResolver::isReady($pdo)) {
+                $stmtH = $pdo->prepare(
+                    "SELECT a.ascii_key, a.storage_url
+                     FROM sh_asset_links al
+                     INNER JOIN sh_assets a ON a.id = al.asset_id AND a.is_active = 1 AND a.deleted_at IS NULL
+                     WHERE al.tenant_id = ? AND al.entity_type = 'menu_item'
+                       AND al.entity_ref = ? AND al.role = 'hero'
+                       AND al.is_active = 1 AND al.deleted_at IS NULL
+                     ORDER BY al.sort_order ASC, al.id DESC
+                     LIMIT 1"
+                );
+                $stmtH->execute([$tenant_id, $itemSku]);
+                $hero = $stmtH->fetch(PDO::FETCH_ASSOC);
+                if ($hero) {
+                    $heroUrl = AssetResolver::publicUrl((string)$hero['storage_url']);
+                    if ($heroUrl) {
+                        $layers[] = [
+                            'layerSku'  => 'BASE_' . (string)$hero['ascii_key'],
+                            'assetUrl'  => $heroUrl,
+                            'zIndex'    => 0,
+                            'isBase'    => true,
+                            'calScale'  => 1.0,
+                            'calRotate' => 0,
+                            'offsetX'   => 0.0,
+                            'offsetY'   => 0.0,
+                            'visible'   => true,
+                            'source'    => 'auto_hero',
+                        ];
+                        $nextZ = 10;
+                    }
+                }
+            }
+
+            $modVisualFilter = $hasModifierVisualImpact ? 'AND m.has_visual_impact = 1' : '';
+            $sqlMods = "
+                SELECT DISTINCT
+                       m.id, m.ascii_key, m.name, m.is_default,
+                       mg.id AS group_id, mg.name AS group_name,
+                       a.ascii_key AS asset_key, a.storage_url AS asset_url
+                FROM sh_item_modifiers im
+                INNER JOIN sh_menu_items mi ON mi.id = im.item_id AND mi.tenant_id = :tid
+                INNER JOIN sh_modifier_groups mg ON mg.id = im.group_id AND mg.tenant_id = :tid
+                INNER JOIN sh_modifiers m ON m.group_id = mg.id AND m.is_deleted = 0
+                INNER JOIN sh_asset_links al ON al.tenant_id = :tid
+                    AND al.entity_type = 'modifier'
+                    AND al.entity_ref = m.ascii_key
+                    AND al.role = 'layer_top_down'
+                    AND al.is_active = 1 AND al.deleted_at IS NULL
+                INNER JOIN sh_assets a ON a.id = al.asset_id
+                    AND a.is_active = 1 AND a.deleted_at IS NULL
+                WHERE mi.id = :item_id
+                  AND m.action_type = 'NONE'
+                  AND m.is_default = 1
+                  {$modVisualFilter}
+                ORDER BY mg.id ASC, m.id ASC
+            ";
+            try {
+                $stmtM = $pdo->prepare($sqlMods);
+                $stmtM->execute([':tid' => $tenant_id, ':item_id' => (int)$item['id']]);
+                $modRows = $stmtM->fetchAll(PDO::FETCH_ASSOC);
+            } catch (\PDOException $e) {
+                $modRows = [];
+            }
+
+            foreach ($modRows as $row) {
+                $url = AssetResolver::publicUrl((string)$row['asset_url']);
+                if (!$url) continue;
+                $layers[] = [
+                    'layerSku'     => (string)$row['ascii_key'],
+                    'assetUrl'     => $url,
+                    'zIndex'       => $nextZ,
+                    'isBase'       => false,
+                    'calScale'     => 1.0,
+                    'calRotate'    => 0,
+                    'offsetX'      => 0.0,
+                    'offsetY'      => 0.0,
+                    'visible'      => true,
+                    'source'       => 'auto_modifier',
+                    'fromModifier' => (string)$row['ascii_key'],
+                    'fromGroup'    => (string)$row['group_name'],
+                ];
+                $nextZ += 10;
+            }
+
+            if (count($layers) === 0) {
+                $hasHero = isset($hero) && $hero ? true : false;
+
+                $diagStmt = $pdo->prepare("
+                    SELECT COUNT(*) AS cnt
+                    FROM sh_item_modifiers im
+                    INNER JOIN sh_modifiers m ON m.group_id = im.group_id
+                        AND m.is_deleted = 0
+                        AND m.action_type = 'NONE'
+                        AND m.is_default = 1
+                    WHERE im.item_id = :item_id
+                ");
+                $diagStmt->execute([':item_id' => (int)$item['id']]);
+                $defaultModsCount = (int)($diagStmt->fetchColumn() ?: 0);
+
+                $steps = [];
+                if (!$hasHero) {
+                    $steps[] = 'Przypisz zdj─Öcie do tego dania ÔÇö kliknij ÔÇ×Przypisz Hero" pod miniatur─ů po lewej (biblioteka asset├│w otworzy si─Ö w pickerze).';
+                }
+                if ($defaultModsCount === 0) {
+                    $steps[] = 'Dodaj do tego dania przynajmniej jeden modyfikator domy┼Ťlny (np. grupa ÔÇ×Sos podstawowy" Ôćĺ opcja ÔÇ×Pomidorowy" z is_default = 1).';
+                } else {
+                    $steps[] = 'Masz ' . $defaultModsCount . ' modyfikator(y/├│w) domy┼Ťlnych, ale ┼╝aden nie ma przypisanej warstwy wizualnej (layer_top_down). Otw├│rz ÔÇ×Dodatki i Modyfikatory" i w sekcji ÔÇ×Surface ÔÇö wizualne sloty" wybierz warstw─Ö.';
+                }
+
+                $response['success'] = false;
+                $response['data'] = [
+                    'reason'            => 'no_source_data',
+                    'hasHero'           => $hasHero,
+                    'defaultModsCount'  => $defaultModsCount,
+                    'modsWithLayerCount'=> 0,
+                    'steps'             => $steps,
+                ];
+                $response['message'] = 'Brak materia┼éu do auto-generacji ÔÇö uzupe┼énij hero i/lub modyfikatory domy┼Ťlne z warstw─ů wizualn─ů.';
+                break;
+            }
+
+            $spec = [
+                'pizza' => ['layers' => $layers],
+                'meta'  => [
+                    'generatedAt'      => gmdate('c'),
+                    'generatedBy'      => 'menu_studio_autogen',
+                    'sourceLayerCount' => count($layers),
+                    'hasHero'          => !empty($layers) && !empty($layers[0]['isBase']),
+                    'modifierCount'    => count($modRows),
+                ],
+            ];
+            $specJson = json_encode($spec, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);
+            if ($specJson === false) {
+                throw new Exception('Nie udało się serializować spec_json.');
+            }
+
+            $pdo->beginTransaction();
+            try {
+                if ($existingScene) {
+                    $pdo->prepare(
+                        "UPDATE sh_atelier_scenes
+                         SET spec_json = ?, version = version + 1
+                         WHERE id = ? AND tenant_id = ?"
+                    )->execute([$specJson, (int)$existingScene['id'], $tenant_id]);
+                    $sceneId = (int)$existingScene['id'];
+                } else {
+                    $pdo->prepare(
+                        "INSERT INTO sh_atelier_scenes (tenant_id, item_sku, spec_json, version)
+                         VALUES (?, ?, ?, 1)"
+                    )->execute([$tenant_id, $itemSku, $specJson]);
+                    $sceneId = (int)$pdo->lastInsertId();
+                }
+
+                try {
+                    $pdo->prepare(
+                        "INSERT INTO sh_atelier_scene_history (scene_id, spec_json, snapshot_label)
+                         VALUES (?, ?, ?)"
+                    )->execute([$sceneId, $specJson, 'autogen_' . gmdate('Ymd_His')]);
+                } catch (\PDOException $e) {
+                    // history table mo┼╝e nie istnie─ç w starych instancjach ÔÇö ignore
+                }
+
+                $pdo->commit();
+            } catch (\Throwable $e) {
+                $pdo->rollBack();
+                throw $e;
+            }
+
+            $response['success'] = true;
+            $response['message'] = sprintf(
+                'Wygenerowano scen─Ö z %d warstw (%s). %s',
+                count($layers),
+                count($layers) > 0 && !empty($layers[0]['isBase']) ? 'hero + ' . (count($layers) - 1) . ' modyfikator├│w' : (count($layers) . ' modyfikator├│w'),
+                $existingScene ? 'Nadpisano istniej─ůc─ů scen─Ö.' : 'Utworzono now─ů scen─Ö.'
+            );
+            $response['data'] = [
+                'sceneId'     => $sceneId,
+                'itemSku'     => $itemSku,
+                'layerCount'  => count($layers),
+                'modifierCount' => count($modRows),
+                'overwritten' => (bool)$existingScene,
+                'spec'        => $spec,
+            ];
+            break;
+
+        // ==============================================================================
+        // M025 ┬Ě Category Table ÔÇö edytor uk┼éadu da┼ä na wsp├│lnej scenie kategorii
+        // ==============================================================================
+        case 'get_category_scene_editor':
+            if (!$cat022HasLayout) {
+                throw new Exception('Układ stołu kategorii wymaga migracji M022 (layout_mode / category_scene_id).');
+            }
+            require_once __DIR__ . '/../../core/SceneResolver.php';
+            $cid = (int)($input['categoryId'] ?? 0);
+            if ($cid <= 0) {
+                throw new Exception('categoryId jest wymagane.');
+            }
+            $resolved = SceneResolver::resolveCategoryScene($pdo, (int)$tenant_id, $cid);
+            if (!$resolved) {
+                throw new Exception('Nie znaleziono kategorii.');
+            }
+            $spec = is_array($resolved['scene_spec'] ?? null) ? $resolved['scene_spec'] : [];
+            $templateKey = isset($spec['template_key']) ? (string)$spec['template_key'] : 'category_flat_table';
+            $placementsBySku = [];
+            foreach (($spec['placements'] ?? []) as $row) {
+                if (!empty($row['sku'])) {
+                    $placementsBySku[(string)$row['sku']] = [
+                        'sku'     => (string)$row['sku'],
+                        'x'       => isset($row['x']) ? max(0.0, min(1.0, (float)$row['x'])) : 0.5,
+                        'y'       => isset($row['y']) ? max(0.0, min(1.0, (float)$row['y'])) : 0.5,
+                        'scale'   => isset($row['scale']) ? max(0.3, min(3.0, (float)$row['scale'])) : 1.0,
+                        'z_index' => isset($row['z_index']) ? max(0, min(500, (int)$row['z_index'])) : 40,
+                    ];
+                }
+            }
+            $editorItems = [];
+            foreach (($resolved['items'] ?? []) as $it) {
+                $sku = (string)($it['sku'] ?? '');
+                if ($sku === '') {
+                    continue;
+                }
+                $editorItems[] = [
+                    'sku'        => $sku,
+                    'name'       => (string)($it['name'] ?? ''),
+                    'placement'  => $placementsBySku[$sku] ?? null,
+                    'compositionProfile' => $it['composition_profile'] ?? 'static_hero',
+                ];
+            }
+            $sceneId = isset($resolved['scene_meta']['scene_id']) ? (int)$resolved['scene_meta']['scene_id'] : null;
+
+            $response['success'] = true;
+            $response['data'] = [
+                'categoryId'   => (int)$resolved['category_id'],
+                'categoryName' => (string)$resolved['category_name'],
+                'layoutMode'   => (string)$resolved['layout_mode'],
+                'sceneId'      => $sceneId > 0 ? $sceneId : null,
+                'templateKey'  => $templateKey,
+                'specVersion'  => isset($spec['version']) ? (int)$spec['version'] : 1,
+                'items'        => $editorItems,
+                'hints'        => [
+                    'coordinates' => 'x,y Ôłł [0..1] ÔÇö pozycja ┼Ťrodka ÔÇ×talerzaÔÇŁ na stole (wzgl─Ödem szer./wys. sceny).',
+                ],
+            ];
+            break;
+
+        case 'save_category_scene_layout':
+            if (!$cat022HasLayout) {
+                throw new Exception('Zapis układu wymaga migracji M022.');
+            }
+            $cid = (int)($input['categoryId'] ?? 0);
+            if ($cid <= 0) {
+                throw new Exception('categoryId jest wymagane.');
+            }
+            $tplKey = preg_replace('/[^a-zA-Z0-9_-]/', '', (string)($input['templateKey'] ?? ''));
+            $placementsIn = $input['placements'] ?? [];
+            if (!is_array($placementsIn)) {
+                throw new Exception('placements musi by─ç tablic─ů.');
+            }
+
+            $stmtSku = $pdo->prepare(
+                'SELECT ascii_key FROM sh_menu_items WHERE tenant_id = ? AND category_id = ? AND is_deleted = 0 AND is_active = 1'
+            );
+            $stmtSku->execute([$tenant_id, $cid]);
+            $allowed = [];
+            foreach ($stmtSku->fetchAll(PDO::FETCH_ASSOC) as $r) {
+                $allowed[(string)$r['ascii_key']] = true;
+            }
+
+            $normalized = [];
+            foreach ($placementsIn as $row) {
+                if (!is_array($row)) {
+                    continue;
+                }
+                $sku = preg_replace('/[^a-zA-Z0-9_-]/', '', (string)($row['sku'] ?? ''));
+                if ($sku === '' || empty($allowed[$sku])) {
+                    continue;
+                }
+                $normalized[] = [
+                    'sku'     => $sku,
+                    'x'       => isset($row['x']) ? max(0.0, min(1.0, (float)$row['x'])) : 0.5,
+                    'y'       => isset($row['y']) ? max(0.0, min(1.0, (float)$row['y'])) : 0.5,
+                    'scale'   => isset($row['scale']) ? max(0.3, min(3.0, (float)$row['scale'])) : 1.0,
+                    'z_index' => isset($row['z_index']) ? max(0, min(500, (int)$row['z_index'])) : 40,
+                ];
+            }
+
+            $sid = $ensureCategoryAtelierScene($pdo, (int)$tenant_id, $cid, $atelierHasCategoryCols);
+
+            $stmtSpec = $pdo->prepare('SELECT spec_json FROM sh_atelier_scenes WHERE id = ? AND tenant_id = ? LIMIT 1');
+            $stmtSpec->execute([$sid, $tenant_id]);
+            $specRow = $stmtSpec->fetch(PDO::FETCH_ASSOC);
+            $spec = [];
+            if ($specRow && !empty($specRow['spec_json'])) {
+                $decoded = json_decode((string)$specRow['spec_json'], true);
+                if (is_array($decoded)) {
+                    $spec = $decoded;
+                }
+            }
+            $spec['version']       = isset($spec['version']) ? (int)$spec['version'] + 1 : 2;
+            $spec['kind']          = 'category_table';
+            $spec['placements']    = $normalized;
+            $spec['template_key']  = ($tplKey !== '')
+                ? $tplKey
+                : (isset($spec['template_key']) ? (string)$spec['template_key'] : 'category_flat_table');
+            $spec['updated_via']   = 'menu_studio.category_table_editor';
+
+            $upd = $pdo->prepare('UPDATE sh_atelier_scenes SET spec_json = ?, version = version + 1 WHERE id = ? AND tenant_id = ?');
+            $upd->execute([
+                json_encode($spec, JSON_UNESCAPED_UNICODE),
+                $sid,
+                $tenant_id,
+            ]);
+
+            $response['success'] = true;
+            $response['message'] = 'Zapisano układ stołu kategorii.';
+            $response['data'] = ['sceneId' => $sid, 'placementCount' => count($normalized)];
+            break;
+
         // ==============================================================================
         // 1. POBIERANIE DRZEWA MENU (Z uwzgl─Ödnieniem Macierzy Cenowej)
         // ==============================================================================
         case 'get_menu_tree':
-            $stmtCat = $pdo->prepare("SELECT id, name FROM sh_categories WHERE tenant_id = ? AND is_menu = 1 AND is_deleted = 0 ORDER BY display_order ASC, id ASC");
+            // -- Categories --
+            $catDelWhere = $catHasIsDeleted ? "AND is_deleted = 0" : "";
+            $m022CatCols = $cat022HasLayout ? ", layout_mode, default_composition_profile, category_scene_id" : "";
+            if ($catHasVat) {
+                $stmtCat = $pdo->prepare("SELECT id, name, default_vat_dine_in, default_vat_takeaway, default_vat_delivery {$m022CatCols} FROM sh_categories WHERE tenant_id = ? AND is_menu = 1 $catDelWhere ORDER BY display_order ASC, id ASC");
+            } else {
+                $stmtCat = $pdo->prepare("SELECT id, name {$m022CatCols} FROM sh_categories WHERE tenant_id = ? AND is_menu = 1 $catDelWhere ORDER BY display_order ASC, id ASC");
+            }
             $stmtCat->execute([$tenant_id]);
             $categoriesRaw = $stmtCat->fetchAll(PDO::FETCH_ASSOC);
 
-            // Pobieramy dania bez p┼éaskiej ceny (zgodnie z now─ů architektur─ů)
-            $stmtItems = $pdo->prepare("SELECT id, category_id, name, ascii_key, is_active, badge_type, is_secret, stock_count, vat_rate_dine_in, kds_station_id, is_locked_by_hq FROM sh_menu_items WHERE tenant_id = ? AND is_deleted = 0 ORDER BY display_order ASC, name ASC");
+            // -- Items --
+            if ($schemaV2) {
+                $stmtItems = $pdo->prepare("SELECT id, category_id, name, ascii_key, is_active, badge_type, is_secret, stock_count, vat_rate_dine_in, vat_rate_takeaway, kds_station_id, is_locked_by_hq, image_url, description FROM sh_menu_items WHERE tenant_id = ? AND is_deleted = 0 ORDER BY display_order ASC, name ASC");
+            } else {
+                $stmtItems = $pdo->prepare("SELECT id, category_id, name, ascii_key, is_active, badge_type, is_secret, stock_count, vat_rate AS vat_rate_dine_in, vat_rate AS vat_rate_takeaway, printer_group AS kds_station_id, 0 AS is_locked_by_hq, NULL AS image_url, description FROM sh_menu_items WHERE tenant_id = ? AND is_deleted = 0 ORDER BY display_order ASC, name ASC");
+            }
             $stmtItems->execute([$tenant_id]);
             $itemsRaw = $stmtItems->fetchAll(PDO::FETCH_ASSOC);
 
-            // Pobieramy ca┼é─ů Macierz Cenow─ů dla da┼ä (┼╝eby wklei─ç j─ů do drzewka)
-            $stmtTiers = $pdo->prepare("SELECT target_sku, channel, price FROM sh_price_tiers WHERE target_type = 'ITEM'");
-            $stmtTiers->execute();
-            $allTiers = $stmtTiers->fetchAll(PDO::FETCH_ASSOC);
+            // -- Price tiers (may not exist in legacy) --
+            $allTiers = [];
+            if ($hasPriceTiers) {
+                $stmtTiers = $pdo->prepare("SELECT target_sku, channel, price FROM sh_price_tiers WHERE target_type = 'ITEM' AND (tenant_id = ? OR tenant_id = 0) ORDER BY target_sku, channel, tenant_id DESC");
+                $stmtTiers->execute([$tenant_id]);
+                $allTiers = $stmtTiers->fetchAll(PDO::FETCH_ASSOC);
+            }
             
             $tiersBySku = [];
             foreach ($allTiers as $tier) {
+                $key = $tier['target_sku'] . '|' . $tier['channel'];
+                if (isset($tiersBySku['_seen'][$key])) continue;
+                $tiersBySku['_seen'][$key] = true;
                 $tiersBySku[$tier['target_sku']][] = [
                     'channel' => $tier['channel'],
                     'price' => (float)$tier['price']
                 ];
             }
+            unset($tiersBySku['_seen']);
+
+            // -- Legacy price fallback: if no tiers table, use single `price` column --
+            if (!$hasPriceTiers && !$schemaV2) {
+                $stmtLegacyPrices = $pdo->prepare("SELECT ascii_key, price FROM sh_menu_items WHERE tenant_id = ? AND is_deleted = 0 AND ascii_key IS NOT NULL");
+                $stmtLegacyPrices->execute([$tenant_id]);
+                foreach ($stmtLegacyPrices->fetchAll(PDO::FETCH_ASSOC) as $lp) {
+                    if ($lp['ascii_key']) {
+                        $p = (float)$lp['price'];
+                        $tiersBySku[$lp['ascii_key']] = [
+                            ['channel' => 'POS', 'price' => $p],
+                            ['channel' => 'Takeaway', 'price' => $p],
+                            ['channel' => 'Delivery', 'price' => $p]
+                        ];
+                    }
+                }
+            }
 
             $categories = array_map(function($c) {
-                return ['id' => (int)$c['id'], 'name' => $c['name']];
-            }, $categoriesRaw);
-
-            $categories = array_map(function($c) {
-                return ['id' => (int)$c['id'], 'name' => $c['name']];
+                return [
+                    'id' => (int)$c['id'],
+                    'name' => $c['name'],
+                    'defaultVatDineIn' => (float)($c['default_vat_dine_in'] ?? 8),
+                    'defaultVatTakeaway' => (float)($c['default_vat_takeaway'] ?? 5),
+                    'defaultVatDelivery' => (float)($c['default_vat_delivery'] ?? 5),
+                    // M022: Scene Kit fields
+                    'layoutMode' => $c['layout_mode'] ?? 'legacy_list',
+                    'defaultCompositionProfile' => $c['default_composition_profile'] ?? 'static_hero',
+                    'categorySceneId' => isset($c['category_scene_id']) ? (int)$c['category_scene_id'] : null,
+                ];
             }, $categoriesRaw);
 
             $items = array_map(function($i) use ($tiersBySku) {
@@ -85,34 +1216,43 @@ try {
                     'id' => (int)$i['id'],
                     'categoryId' => (int)$i['category_id'],
                     'name' => $i['name'],
-                    'asciiKey' => $i['ascii_key'],
+                    'asciiKey' => $i['ascii_key'] ?? '',
                     'isActive' => (bool)$i['is_active'],
-                    'badgeType' => $i['badge_type'],
-                    'isSecret' => (bool)$i['is_secret'],
-                    'stockCount' => (int)$i['stock_count'],
-                    'vatRate' => (float)$i['vat_rate_dine_in'],
-                    'kdsStationId' => $i['kds_station_id'],
-                    'isLockedByHq' => (bool)$i['is_locked_by_hq'],
-                    'priceTiers' => $tiersBySku[$i['ascii_key']] ?? [] 
+                    'badgeType' => $i['badge_type'] ?? 'none',
+                    'isSecret' => (bool)($i['is_secret'] ?? 0),
+                    'stockCount' => (int)($i['stock_count'] ?? -1),
+                    'vatRate' => (float)($i['vat_rate_dine_in'] ?? 8),
+                    'kdsStationId' => $i['kds_station_id'] ?? 'NONE',
+                    'isLockedByHq' => (bool)($i['is_locked_by_hq'] ?? 0),
+                    'imageUrl' => $i['image_url'] ?? '',
+                    'description' => $i['description'] ?? '',
+                    'priceTiers' => $tiersBySku[$i['ascii_key'] ?? ''] ?? [] 
                 ];
             }, $itemsRaw);
 
-            // --- ŁATKA: POBIERANIE MODYFIKATORÓW ---
-            $stmtMods = $pdo->prepare("SELECT id, name, ascii_key FROM sh_modifier_groups WHERE tenant_id = ? AND is_deleted = 0 ORDER BY id ASC");
-            $stmtMods->execute([$tenant_id]);
-            $modifierGroupsRaw = $stmtMods->fetchAll(PDO::FETCH_ASSOC);
+            // m021 Asset Studio override ÔÇö hero z sh_asset_links ma priorytet
+            AssetResolver::injectHeros($pdo, (int)$tenant_id, $items, 'asciiKey', 'imageUrl');
+
+            // -- Modifier groups --
+            try {
+                $stmtMods = $pdo->prepare("SELECT id, name, ascii_key FROM sh_modifier_groups WHERE tenant_id = ? AND is_deleted = 0 ORDER BY id ASC");
+                $stmtMods->execute([$tenant_id]);
+                $modifierGroupsRaw = $stmtMods->fetchAll(PDO::FETCH_ASSOC);
+            } catch (PDOException $e) {
+                $stmtMods = $pdo->prepare("SELECT id, name, '' AS ascii_key FROM sh_modifier_groups WHERE tenant_id = ? ORDER BY id ASC");
+                $stmtMods->execute([$tenant_id]);
+                $modifierGroupsRaw = $stmtMods->fetchAll(PDO::FETCH_ASSOC);
+            }
             
             $modifierGroups = array_map(function($g) {
                 return [
                     'id' => (int)$g['id'], 
                     'name' => $g['name'], 
-                    'asciiKey' => $g['ascii_key']
+                    'asciiKey' => $g['ascii_key'] ?? ''
                 ];
             }, $modifierGroupsRaw);
-            // ---------------------------------------
 
             $response['success'] = true;
-            // Zwracamy kategorie, dania ORAZ grupy modyfikator├│w!
             $response['data'] = ['categories' => $categories, 'items' => $items, 'modifierGroups' => $modifierGroups];
             $response['message'] = "Pobrano drzewo menu.";
             break;
@@ -124,61 +1264,110 @@ try {
             $itemId = intval($input['itemId'] ?? 0);
             if ($itemId <= 0) throw new Exception("Nieprawidłowe ID elementu.");
 
-            $stmtItem = $pdo->prepare("SELECT id, category_id, name, ascii_key, is_active, vat_rate_dine_in as vat_rate, kds_station_id, is_locked_by_hq, publication_status, valid_from, valid_to, description, image_url, marketing_tags, barcode_ean, parent_sku, allergens_json FROM sh_menu_items WHERE id = ? AND tenant_id = ? AND is_deleted = 0");
+            $datCol = $hasDriverActionType ? ", COALESCE(driver_action_type, 'none') AS driver_action_type" : "";
+            $cpCol  = $mi022HasCompositionProfile ? ", COALESCE(composition_profile, 'static_hero') AS composition_profile" : "";
+            if ($schemaV2) {
+                $stmtItem = $pdo->prepare("SELECT id, category_id, name, ascii_key, `type`, is_active, vat_rate_dine_in, vat_rate_takeaway, kds_station_id, printer_group, is_locked_by_hq, publication_status, valid_from, valid_to, description, image_url, marketing_tags, barcode_ean, parent_sku, allergens_json, badge_type, is_secret, stock_count, display_order, plu_code, available_days, available_start, available_end{$datCol}{$cpCol} FROM sh_menu_items WHERE id = ? AND tenant_id = ? AND is_deleted = 0");
+            } else {
+                $stmtItem = $pdo->prepare("SELECT id, category_id, name, ascii_key, `type`, is_active, price, vat_rate AS vat_rate_dine_in, vat_rate AS vat_rate_takeaway, printer_group, printer_group AS kds_station_id, 0 AS is_locked_by_hq, 'Draft' AS publication_status, NULL AS valid_from, NULL AS valid_to, description, NULL AS image_url, tags AS marketing_tags, NULL AS barcode_ean, NULL AS parent_sku, NULL AS allergens_json, badge_type, is_secret, stock_count, display_order, plu_code, available_days, available_start, available_end, 'none' AS driver_action_type, 'static_hero' AS composition_profile FROM sh_menu_items WHERE id = ? AND tenant_id = ? AND is_deleted = 0");
+            }
             $stmtItem->execute([$itemId, $tenant_id]);
             $item = $stmtItem->fetch(PDO::FETCH_ASSOC);
 
             if (!$item) throw new Exception("Nie znaleziono dania.");
 
-            $itemData = $item;
-            $item['barcodeEan'] = $itemData['barcode_ean'] ?? '';
-            $item['parentSku'] = $itemData['parent_sku'] ?? '';
-            $allergensRaw = $itemData['allergens_json'] ?? '[]';
-            $item['allergens'] = is_string($allergensRaw) ? json_decode($allergensRaw, true) : [];
-            if (!is_array($item['allergens'])) {
-                $item['allergens'] = [];
-            }
-
-            // Pobieranie cen z Macierzy dla tego konkretnego dania
-            $stmtPrice = $pdo->prepare("SELECT channel, price FROM sh_price_tiers WHERE target_type = 'ITEM' AND target_sku = ?");
-            $stmtPrice->execute([$item['ascii_key']]);
-            $prices = $stmtPrice->fetchAll(PDO::FETCH_ASSOC);
+            $allergensRaw = $item['allergens_json'] ?? '[]';
+            $allergens = is_string($allergensRaw) ? json_decode($allergensRaw, true) : [];
+            if (!is_array($allergens)) $allergens = [];
 
+            // Price tiers
             $priceMatrix = [];
-            $priceTiers = [];
-            foreach ($prices as $p) {
-                $priceMatrix[$p['channel']] = (float)$p['price'];
-                $priceTiers[] = ['channel' => $p['channel'], 'price' => (float)$p['price']];
+            $priceTiersOut = [];
+            if ($hasPriceTiers) {
+                $stmtPrice = $pdo->prepare("SELECT channel, price FROM sh_price_tiers WHERE target_type = 'ITEM' AND target_sku = ? AND (tenant_id = ? OR tenant_id = 0) ORDER BY channel, tenant_id DESC");
+                $stmtPrice->execute([$item['ascii_key'] ?? '', $tenant_id]);
+                $prices = $stmtPrice->fetchAll(PDO::FETCH_ASSOC);
+                foreach ($prices as $p) {
+                    if (!isset($priceMatrix[$p['channel']])) {
+                        $priceMatrix[$p['channel']] = (float)$p['price'];
+                        $priceTiersOut[] = ['channel' => $p['channel'], 'price' => (float)$p['price']];
+                    }
+                }
+            } elseif (isset($item['price'])) {
+                $legacyPrice = (float)$item['price'];
+                $priceMatrix = ['POS' => $legacyPrice, 'Takeaway' => $legacyPrice, 'Delivery' => $legacyPrice];
+                $priceTiersOut = [
+                    ['channel' => 'POS', 'price' => $legacyPrice],
+                    ['channel' => 'Takeaway', 'price' => $legacyPrice],
+                    ['channel' => 'Delivery', 'price' => $legacyPrice]
+                ];
+            }
+
+            // Modifier assignments
+            $modGroupIds = [];
+            try {
+                $stmtMods = $pdo->prepare("SELECT group_id FROM sh_item_modifiers WHERE item_id = ?");
+                $stmtMods->execute([$itemId]);
+                $modGroupIds = array_map('intval', $stmtMods->fetchAll(PDO::FETCH_COLUMN) ?: []);
+            } catch (PDOException $e) {
+                $modGroupIds = [];
             }
 
-            // Pobranie przypisanych modyfikator├│w
-            $stmtMods = $pdo->prepare("SELECT group_id FROM sh_item_modifiers WHERE item_id = ?");
-            $stmtMods->execute([$itemId]);
-            $modifierGroupIds = $stmtMods->fetchAll(PDO::FETCH_COLUMN) ?: [];
-            $item['modifierGroupIds'] = array_map('intval', $modifierGroupIds);
+            // m021 Asset Studio override ÔÇö pojedynczy item
+            $resolvedHero = AssetResolver::resolveHero($pdo, (int)$tenant_id, (string)($item['ascii_key'] ?? ''));
+            $finalImageUrl = $resolvedHero['url'] ?? ($item['image_url'] ?? '');
+
+            // M022: scene meta (has_scene + composition_profile)
+            $sceneMeta022 = ['hasScene' => false, 'sceneId' => null];
+            if ($hasSceneTemplates && !empty($item['ascii_key'])) {
+                try {
+                    $chkScene = $pdo->prepare("SELECT id FROM sh_atelier_scenes WHERE tenant_id = ? AND item_sku = ? LIMIT 1");
+                    $chkScene->execute([$tenant_id, $item['ascii_key']]);
+                    $sceneRow = $chkScene->fetch(PDO::FETCH_ASSOC);
+                    if ($sceneRow) {
+                        $sceneMeta022 = ['hasScene' => true, 'sceneId' => (int)$sceneRow['id']];
+                    }
+                } catch (PDOException $e) {}
+            }
 
             $response['success'] = true;
             $response['data'] = [
                 'id' => (int)$item['id'],
                 'categoryId' => (int)$item['category_id'],
                 'name' => $item['name'],
-                'asciiKey' => $item['ascii_key'],
+                'asciiKey' => $item['ascii_key'] ?? '',
+                'type' => $item['type'] ?? 'standard',
                 'isActive' => (bool)$item['is_active'],
-                'vatRate' => (float)$item['vat_rate'],
-                'kdsStationId' => $item['kds_station_id'],
-                'isLockedByHq' => (bool)$item['is_locked_by_hq'],
-                'publicationStatus' => $item['publication_status'],
-                'validFrom' => $item['valid_from'],
-                'validTo' => $item['valid_to'],
-                'description' => $item['description'],
-                'imageUrl' => $item['image_url'],
-                'marketingTags' => $item['marketing_tags'],
-                'modifierGroupIds' => $item['modifierGroupIds'],
-                'barcodeEan' => $item['barcodeEan'],
-                'parentSku' => $item['parentSku'],
-                'allergens' => $item['allergens'],
-                'priceMatrix' => $priceMatrix, // Kompatybilno┼Ť─ç z formularzem
-                'priceTiers' => $priceTiers // Czysta architektura
+                'vatRateDineIn' => (float)($item['vat_rate_dine_in'] ?? 8),
+                'vatRateTakeaway' => (float)($item['vat_rate_takeaway'] ?? 5),
+                'kdsStationId' => $item['kds_station_id'] ?? 'NONE',
+                'printerGroup' => $item['printer_group'] ?? 'KITCHEN_1',
+                'isLockedByHq' => (bool)($item['is_locked_by_hq'] ?? 0),
+                'publicationStatus' => $item['publication_status'] ?? 'Draft',
+                'validFrom' => $item['valid_from'] ?? null,
+                'validTo' => $item['valid_to'] ?? null,
+                'description' => $item['description'] ?? '',
+                'imageUrl' => $finalImageUrl,
+                // M022: composition profile + scene meta
+                'compositionProfile' => $item['composition_profile'] ?? 'static_hero',
+                'hasScene' => $sceneMeta022['hasScene'],
+                'sceneId' => $sceneMeta022['sceneId'],
+                'marketingTags' => $item['marketing_tags'] ?? '',
+                'badgeType' => $item['badge_type'] ?? 'none',
+                'isSecret' => (bool)($item['is_secret'] ?? 0),
+                'stockCount' => (int)($item['stock_count'] ?? -1),
+                'displayOrder' => (int)($item['display_order'] ?? 0),
+                'pluCode' => $item['plu_code'] ?? '',
+                'availableDays' => $item['available_days'] ?? '1,2,3,4,5,6,7',
+                'availableStart' => $item['available_start'] ?? null,
+                'availableEnd' => $item['available_end'] ?? null,
+                'modifierGroupIds' => $modGroupIds,
+                'barcodeEan' => $item['barcode_ean'] ?? '',
+                'parentSku' => $item['parent_sku'] ?? '',
+                'allergens' => $allergens,
+                'driverActionType' => $item['driver_action_type'] ?? 'none',
+                'priceMatrix' => $priceMatrix,
+                'priceTiers' => $priceTiersOut
             ];
             $response['message'] = "Pobrano szczegóły dania.";
             break;
@@ -193,11 +1382,22 @@ try {
             $name = trim($input['name'] ?? ''); 
             $asciiKey = preg_replace('/[^a-zA-Z0-9_-]/', '', $input['asciiKey'] ?? '');
             
-            $vatRate = floatval($input['vatRate'] ?? 0);
+            $vatRateDineIn = floatval($input['vatRateDineIn'] ?? $input['vatRate'] ?? 8);
+            $vatRateTakeaway = floatval($input['vatRateTakeaway'] ?? $input['vatRate'] ?? 5);
             $kdsStationId = preg_replace('/[^a-zA-Z0-9_-]/', '', $input['kdsStationId'] ?? 'NONE');
             $isActive = isset($input['isActive']) ? (int)filter_var($input['isActive'], FILTER_VALIDATE_BOOLEAN) : 1;
             
-            // Nowe pola temporal i marketing
+            $itemType = in_array($input['type'] ?? '', ['standard', 'half_half']) ? $input['type'] : 'standard';
+            $printerGroup = preg_replace('/[^a-zA-Z0-9_-]/', '', $input['printerGroup'] ?? 'KITCHEN_1');
+            $pluCode = $toNull(preg_replace('/[^a-zA-Z0-9_-]/', '', $input['pluCode'] ?? ''));
+            $displayOrder = intval($input['displayOrder'] ?? 0);
+            $stockCount = intval($input['stockCount'] ?? -1);
+            $badgeType = in_array($input['badgeType'] ?? '', ['none','new','promo','bestseller','hot']) ? $input['badgeType'] : 'none';
+            $isSecret = !empty($input['isSecret']) ? 1 : 0;
+            $availableDays = preg_replace('/[^0-9,]/', '', $input['availableDays'] ?? '1,2,3,4,5,6,7');
+            $availableStart = $toNull($input['availableStart'] ?? null);
+            $availableEnd = $toNull($input['availableEnd'] ?? null);
+
             $pubStatus = in_array($input['publicationStatus'] ?? '', ['Draft', 'Live', 'Archived']) ? $input['publicationStatus'] : 'Draft';
             $validFrom = $toNull($input['validFrom'] ?? null);
             $validTo = $toNull($input['validTo'] ?? null);
@@ -213,6 +1413,14 @@ try {
 
             $allergensRaw = $input['allergens'] ?? [];
             $allergensJson = is_array($allergensRaw) ? json_encode($allergensRaw) : '[]';
+
+            // M022: composition_profile
+            $compositionProfile = trim($input['compositionProfile'] ?? 'static_hero');
+            if ($compositionProfile === '') $compositionProfile = 'static_hero';
+
+            $driverActionType = in_array($input['driverActionType'] ?? '', ['none','pack_cold','pack_separate','check_id'], true)
+                ? $input['driverActionType']
+                : 'none';
             
             $priceTiers = $input['priceTiers'] ?? [];
 
@@ -223,34 +1431,84 @@ try {
             $pdo->beginTransaction();
 
             try {
-                if ($action === 'add_item') {
-                    $stmt = $pdo->prepare("INSERT INTO sh_menu_items (tenant_id, category_id, name, ascii_key, is_active, vat_rate_dine_in, vat_rate_takeaway, kds_station_id, publication_status, valid_from, valid_to, description, image_url, marketing_tags, barcode_ean, parent_sku, allergens_json) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)");
-                    $stmt->execute([$tenant_id, $categoryId, $name, $asciiKey, $isActive, $vatRate, $vatRate, $kdsStationId, $pubStatus, $validFrom, $validTo, $description, $imageUrl, $marketingTags, $barcodeEan, $parentSku, $allergensJson]);
-                    $itemId = $pdo->lastInsertId();
+                if ($schemaV2) {
+                    // ---- V2 schema: all new columns ----
+                    if ($action === 'add_item') {
+                        $cols = "tenant_id, category_id, name, ascii_key, `type`, is_active, vat_rate_dine_in, vat_rate_takeaway, kds_station_id, printer_group, publication_status, valid_from, valid_to, description, image_url, marketing_tags, badge_type, is_secret, stock_count, display_order, plu_code, available_days, available_start, available_end, barcode_ean, parent_sku, allergens_json";
+                        $vals = "?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?";
+                        $params = [$tenant_id, $categoryId, $name, $asciiKey, $itemType, $isActive, $vatRateDineIn, $vatRateTakeaway, $kdsStationId, $printerGroup, $pubStatus, $validFrom, $validTo, $description, $imageUrl, $marketingTags, $badgeType, $isSecret, $stockCount, $displayOrder, $pluCode, $availableDays, $availableStart, $availableEnd, $barcodeEan, $parentSku, $allergensJson];
+                        if ($hasDriverActionType) {
+                            $cols .= ", driver_action_type";
+                            $vals .= ", ?";
+                            $params[] = $driverActionType;
+                        }
+                        if ($mi022HasCompositionProfile) {
+                            $cols .= ", composition_profile";
+                            $vals .= ", ?";
+                            $params[] = $compositionProfile;
+                        }
+                        $stmt = $pdo->prepare("INSERT INTO sh_menu_items ($cols) VALUES ($vals)");
+                        $stmt->execute($params);
+                        $itemId = $pdo->lastInsertId();
+                    } else {
+                        $setCols = "name = ?, ascii_key = ?, category_id = ?, `type` = ?, is_active = ?, vat_rate_dine_in = ?, vat_rate_takeaway = ?, kds_station_id = ?, printer_group = ?, publication_status = ?, valid_from = ?, valid_to = ?, description = ?, image_url = ?, marketing_tags = ?, badge_type = ?, is_secret = ?, stock_count = ?, display_order = ?, plu_code = ?, available_days = ?, available_start = ?, available_end = ?, barcode_ean = ?, parent_sku = ?, allergens_json = ?";
+                        $params = [$name, $asciiKey, $categoryId, $itemType, $isActive, $vatRateDineIn, $vatRateTakeaway, $kdsStationId, $printerGroup, $pubStatus, $validFrom, $validTo, $description, $imageUrl, $marketingTags, $badgeType, $isSecret, $stockCount, $displayOrder, $pluCode, $availableDays, $availableStart, $availableEnd, $barcodeEan, $parentSku, $allergensJson];
+                        if ($hasDriverActionType) {
+                            $setCols .= ", driver_action_type = ?";
+                            $params[] = $driverActionType;
+                        }
+                        if ($mi022HasCompositionProfile) {
+                            $setCols .= ", composition_profile = ?";
+                            $params[] = $compositionProfile;
+                        }
+                        $setCols .= ", updated_at = NOW()";
+                        $params[] = $itemId;
+                        $params[] = $tenant_id;
+                        $stmt = $pdo->prepare("UPDATE sh_menu_items SET $setCols WHERE id = ? AND tenant_id = ? AND is_deleted = 0");
+                        $stmt->execute($params);
+                    }
                 } else {
-                    $stmt = $pdo->prepare("UPDATE sh_menu_items SET name = ?, ascii_key = ?, category_id = ?, is_active = ?, vat_rate_dine_in = ?, vat_rate_takeaway = ?, kds_station_id = ?, publication_status = ?, valid_from = ?, valid_to = ?, description = ?, image_url = ?, marketing_tags = ?, barcode_ean = ?, parent_sku = ?, allergens_json = ?, updated_at = NOW() WHERE id = ? AND tenant_id = ? AND is_deleted = 0");
-                    $stmt->execute([$name, $asciiKey, $categoryId, $isActive, $vatRate, $vatRate, $kdsStationId, $pubStatus, $validFrom, $validTo, $description, $imageUrl, $marketingTags, $barcodeEan, $parentSku, $allergensJson, $itemId, $tenant_id]);
-                }
+                    // ---- Legacy schema: map to old columns ----
+                    $legacyPrice = 0;
+                    foreach ($priceTiers as $t) {
+                        if (($t['channel'] ?? '') === 'POS') { $legacyPrice = floatval($t['price'] ?? 0); break; }
+                    }
+                    if ($legacyPrice == 0 && !empty($priceTiers)) $legacyPrice = floatval($priceTiers[0]['price'] ?? 0);
 
-                // Bezpieczny Upsert do Macierzy Cenowej (sh_price_tiers)
-                $stmtTier = $pdo->prepare("INSERT INTO sh_price_tiers (target_type, target_sku, channel, price) VALUES ('ITEM', ?, ?, ?) ON DUPLICATE KEY UPDATE price = ?");
-                foreach ($priceTiers as $tier) {
-                    $channel = $tier['channel'] ?? 'POS';
-                    $price = floatval($tier['price'] ?? 0);
-                    $stmtTier->execute([$asciiKey, $channel, $price, $price]);
+                    if ($action === 'add_item') {
+                        $stmt = $pdo->prepare("INSERT INTO sh_menu_items (tenant_id, category_id, name, ascii_key, `type`, is_active, price, vat_rate, printer_group, plu_code, description, display_order, available_days, available_start, available_end, stock_count, badge_type, is_secret) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)");
+                        $stmt->execute([$tenant_id, $categoryId, $name, $asciiKey, $itemType, $isActive, $legacyPrice, $vatRateDineIn, $printerGroup, $pluCode, $description, $displayOrder, $availableDays, $availableStart, $availableEnd, $stockCount, $badgeType, $isSecret]);
+                        $itemId = $pdo->lastInsertId();
+                    } else {
+                        $stmt = $pdo->prepare("UPDATE sh_menu_items SET name = ?, ascii_key = ?, category_id = ?, `type` = ?, is_active = ?, price = ?, vat_rate = ?, printer_group = ?, plu_code = ?, description = ?, display_order = ?, available_days = ?, available_start = ?, available_end = ?, stock_count = ?, badge_type = ?, is_secret = ? WHERE id = ? AND tenant_id = ? AND is_deleted = 0");
+                        $stmt->execute([$name, $asciiKey, $categoryId, $itemType, $isActive, $legacyPrice, $vatRateDineIn, $printerGroup, $pluCode, $description, $displayOrder, $availableDays, $availableStart, $availableEnd, $stockCount, $badgeType, $isSecret, $itemId, $tenant_id]);
+                    }
                 }
 
-                // Wyczy┼Ť─ç stare przypisania
-                $stmtDeleteMods = $pdo->prepare("DELETE FROM sh_item_modifiers WHERE item_id = ?");
-                $stmtDeleteMods->execute([$itemId]);
+                // Price tiers (skip if table doesn't exist)
+                if ($hasPriceTiers) {
+                    $stmtTier = $pdo->prepare("INSERT INTO sh_price_tiers (tenant_id, target_type, target_sku, channel, price) VALUES (?, 'ITEM', ?, ?, ?) ON DUPLICATE KEY UPDATE price = VALUES(price)");
+                    foreach ($priceTiers as $tier) {
+                        $channel = $tier['channel'] ?? 'POS';
+                        $price = floatval($tier['price'] ?? 0);
+                        $stmtTier->execute([$tenant_id, $asciiKey, $channel, $price]);
+                    }
+                }
 
-                // Zapisz nowe przypisania z payloadu
-                $modifierGroupIds = $input['modifierGroupIds'] ?? [];
-                if (!empty($modifierGroupIds) && is_array($modifierGroupIds)) {
-                    $stmtInsertMod = $pdo->prepare("INSERT INTO sh_item_modifiers (item_id, group_id) VALUES (?, ?)");
-                    foreach ($modifierGroupIds as $groupId) {
-                        $stmtInsertMod->execute([$itemId, intval($groupId)]);
+                // Modifier assignments
+                try {
+                    $stmtDeleteMods = $pdo->prepare("DELETE FROM sh_item_modifiers WHERE item_id = ?");
+                    $stmtDeleteMods->execute([$itemId]);
+
+                    $modifierGroupIds = $input['modifierGroupIds'] ?? [];
+                    if (!empty($modifierGroupIds) && is_array($modifierGroupIds)) {
+                        $stmtInsertMod = $pdo->prepare("INSERT INTO sh_item_modifiers (item_id, group_id) VALUES (?, ?)");
+                        foreach ($modifierGroupIds as $groupId) {
+                            $stmtInsertMod->execute([$itemId, intval($groupId)]);
+                        }
                     }
+                } catch (PDOException $e) {
+                    // sh_item_modifiers might not exist ÔÇö skip gracefully
                 }
 
                 $pdo->commit();
@@ -280,9 +1538,11 @@ try {
                 $params = [];
                 $updates = [];
 
-                // Standardowe pola z Bulk
                 $kdsGroup = preg_replace('/[^a-zA-Z0-9_-]/', '', $input['kdsGroup'] ?? '');
-                if ($kdsGroup !== '') { $updates[] = "kds_station_id = ?"; $params[] = $kdsGroup; }
+                if ($kdsGroup !== '') {
+                    $col = $schemaV2 ? "kds_station_id" : "printer_group";
+                    $updates[] = "$col = ?"; $params[] = $kdsGroup;
+                }
                 
                 $badgeType = preg_replace('/[^a-zA-Z0-9_-]/', '', $input['badgeType'] ?? '');
                 if ($badgeType !== '') { $updates[] = "badge_type = ?"; $params[] = $badgeType; }
@@ -291,8 +1551,7 @@ try {
                     $updates[] = "is_secret = ?"; $params[] = filter_var($input['isSecret'], FILTER_VALIDATE_BOOLEAN) ? 1 : 0;
                 }
 
-                // Obsługa Temporal Tables (Harmonogram Masowy)
-                if (!empty($input['temporalPublicationPatch']) && !empty($input['temporalPublicationPatch']['apply'])) {
+                if ($schemaV2 && !empty($input['temporalPublicationPatch']) && !empty($input['temporalPublicationPatch']['apply'])) {
                     $patch = $input['temporalPublicationPatch'];
                     if ($patch['status'] !== 'NO_CHANGE' && in_array($patch['status'], ['Draft', 'Live', 'Archived'])) {
                         $updates[] = "publication_status = ?"; $params[] = $patch['status'];
@@ -306,29 +1565,29 @@ try {
                 }
 
                 if (!empty($updates)) {
-                    $sql = "UPDATE sh_menu_items SET " . implode(', ', $updates) . ", updated_at = NOW() WHERE tenant_id = ? AND is_deleted = 0 AND id IN ($placeholders)";
+                    $setClause = implode(', ', $updates);
+                    if ($schemaV2) $setClause .= ", updated_at = NOW()";
+                    $sql = "UPDATE sh_menu_items SET $setClause WHERE tenant_id = ? AND is_deleted = 0 AND id IN ($placeholders)";
                     $finalParams = array_merge($params, [$tenant_id], $cleanIds);
                     $stmtUpdate = $pdo->prepare($sql);
                     $stmtUpdate->execute($finalParams);
                 }
 
-                // Obs┼éuga Omnichannel (Zarz─ůdzanie wybranym kana┼éem)
-                if (!empty($input['omnichannelPricePatch']) && !empty($input['omnichannelPricePatch']['apply'])) {
+                if ($hasPriceTiers && !empty($input['omnichannelPricePatch']) && !empty($input['omnichannelPricePatch']['apply'])) {
                     $patch = $input['omnichannelPricePatch'];
                     $targetChannel = $patch['targetChannel'];
                     $opType = $patch['operationType'];
                     $opValue = (float)$patch['operationValue'];
 
-                    // Wyci─ůgamy SKU zaznaczonych da┼ä, ┼╝eby wiedzie─ç w co uderzy─ç w Macierzy
                     $stmtSku = $pdo->prepare("SELECT ascii_key FROM sh_menu_items WHERE tenant_id = ? AND is_deleted = 0 AND id IN ($placeholders)");
                     $stmtSku->execute(array_merge([$tenant_id], $cleanIds));
                     $skus = $stmtSku->fetchAll(PDO::FETCH_COLUMN);
 
-                    $stmtCurrentPrice = $pdo->prepare("SELECT price FROM sh_price_tiers WHERE target_type='ITEM' AND target_sku=? AND channel=?");
-                    $stmtUpsertPrice = $pdo->prepare("INSERT INTO sh_price_tiers (target_type, target_sku, channel, price) VALUES ('ITEM', ?, ?, ?) ON DUPLICATE KEY UPDATE price = ?");
+                    $stmtCurrentPrice = $pdo->prepare("SELECT price FROM sh_price_tiers WHERE target_type='ITEM' AND target_sku=? AND channel=? AND (tenant_id = ? OR tenant_id = 0) ORDER BY tenant_id DESC LIMIT 1");
+                    $stmtUpsertPrice = $pdo->prepare("INSERT INTO sh_price_tiers (tenant_id, target_type, target_sku, channel, price) VALUES (?, 'ITEM', ?, ?, ?) ON DUPLICATE KEY UPDATE price = VALUES(price)");
 
                     foreach ($skus as $sku) {
-                        $stmtCurrentPrice->execute([$sku, $targetChannel]);
+                        $stmtCurrentPrice->execute([$sku, $targetChannel, $tenant_id]);
                         $row = $stmtCurrentPrice->fetch(PDO::FETCH_ASSOC);
                         $currentPrice = $row ? (float)$row['price'] : 0.00;
                         
@@ -337,10 +1596,8 @@ try {
                         elseif ($opType === 'increase_percent') $newPrice = $currentPrice * (1 + ($opValue / 100));
                         elseif ($opType === 'increase_pln') $newPrice = $currentPrice + $opValue;
 
-                        // Tarcza poni┼╝ej zera
                         if ($newPrice < 0) $newPrice = 0;
-
-                        $stmtUpsertPrice->execute([$sku, $targetChannel, $newPrice, $newPrice]);
+                        $stmtUpsertPrice->execute([$tenant_id, $sku, $targetChannel, $newPrice]);
                     }
                 }
 
@@ -353,6 +1610,89 @@ try {
             }
             break;
 
+        // ==============================================================================
+        // 4b. SZYBKI ZAPIS POJEDYNCZEGO MODYFIKATORA (draft z Studio ÔÇö zamiast api_modifiers.php)
+        // ==============================================================================
+        case 'save_modifier_quick':
+            $groupName  = trim($input['groupName'] ?? '');
+            $name       = trim($input['name'] ?? '');
+            $asciiKey   = strtoupper(preg_replace('/[^a-zA-Z0-9_]/', '', $input['asciiKey'] ?? ''));
+            $priceTiers = $input['priceTiers'] ?? [];
+            $wh         = $input['warehouseLink'] ?? [];
+
+            if ($name === '') {
+                throw new Exception('Nazwa modyfikatora jest wymagana.');
+            }
+            if ($asciiKey === '') {
+                throw new Exception('Klucz systemowy (asciiKey) jest wymagany.');
+            }
+            if ($groupName === '') {
+                throw new Exception('Nazwa grupy jest wymagana.');
+            }
+
+            $actionType   = in_array($wh['actionType'] ?? '', ['ADD', 'REMOVE', 'NONE'], true)
+                ? $wh['actionType']
+                : 'NONE';
+            $warehouseSku = ($actionType !== 'NONE' && !empty($wh['warehouseSku']))
+                ? trim($wh['warehouseSku'])
+                : null;
+            $linkedQty   = ($actionType === 'ADD') ? (float)($wh['quantity'] ?? 0) : 0.0;
+            $linkedWaste = ($actionType === 'ADD') ? (float)($wh['wastePercent'] ?? 0) : 0.0;
+
+            try {
+                $stmtFindGroup = $pdo->prepare("SELECT id FROM sh_modifier_groups WHERE tenant_id = ? AND name = ? AND is_deleted = 0 LIMIT 1");
+                $stmtFindGroup->execute([$tenant_id, $groupName]);
+            } catch (PDOException $e) {
+                $stmtFindGroup = $pdo->prepare("SELECT id FROM sh_modifier_groups WHERE tenant_id = ? AND name = ? LIMIT 1");
+                $stmtFindGroup->execute([$tenant_id, $groupName]);
+            }
+            $existingGroup = $stmtFindGroup->fetch(PDO::FETCH_ASSOC);
+
+            if ($existingGroup) {
+                $groupId = (int)$existingGroup['id'];
+            } else {
+                $stmtNewGroup = $pdo->prepare(
+                    "INSERT INTO sh_modifier_groups (tenant_id, name, min_selection, max_selection)
+                     VALUES (?, ?, 0, 10)"
+                );
+                $stmtNewGroup->execute([$tenant_id, $groupName]);
+                $groupId = (int)$pdo->lastInsertId();
+            }
+
+            $newModifierId = 0;
+            try {
+                $stmtMod = $pdo->prepare(
+                    "INSERT INTO sh_modifiers
+                        (group_id, name, ascii_key, action_type,
+                         linked_warehouse_sku, linked_quantity, linked_waste_percent)
+                     VALUES (?, ?, ?, ?, ?, ?, ?)"
+                );
+                $stmtMod->execute([$groupId, $name, $asciiKey, $actionType, $warehouseSku, $linkedQty, $linkedWaste]);
+                $newModifierId = (int)$pdo->lastInsertId();
+            } catch (PDOException $e) {
+                // sh_modifiers table may not exist in legacy
+            }
+
+            if ($hasPriceTiers) {
+                $stmtTier = $pdo->prepare(
+                    "INSERT INTO sh_price_tiers (tenant_id, target_type, target_sku, channel, price)
+                     VALUES (?, 'MODIFIER', ?, ?, ?)
+                     ON DUPLICATE KEY UPDATE price = VALUES(price)"
+                );
+                $allowedChannels = ['POS', 'Takeaway', 'Delivery'];
+                foreach ($priceTiers as $tier) {
+                    $channel = $tier['channel'] ?? '';
+                    if (!in_array($channel, $allowedChannels, true)) continue;
+                    $priceVal = (float)($tier['price'] ?? 0);
+                    $stmtTier->execute([$tenant_id, $asciiKey, $channel, $priceVal]);
+                }
+            }
+
+            $response['success'] = true;
+            $response['message'] = 'Modyfikator zapisany pomy┼Ťlnie.';
+            $response['data'] = ['id' => $newModifierId, 'groupId' => $groupId];
+            break;
+
         // ==============================================================================
         // 5. ZAPIS GRUPY MODYFIKATORÓW I OPCJI (KSeF + Macierz)
         // ==============================================================================
@@ -376,65 +1716,113 @@ try {
 
             try {
                 if ($groupId > 0) {
-                    $stmtCheck = $pdo->prepare("SELECT id FROM sh_modifier_groups WHERE id = ? AND tenant_id = ? AND is_deleted = 0");
-                    $stmtCheck->execute([$groupId, $tenant_id]);
+                    try {
+                        $stmtCheck = $pdo->prepare("SELECT id FROM sh_modifier_groups WHERE id = ? AND tenant_id = ? AND is_deleted = 0");
+                        $stmtCheck->execute([$groupId, $tenant_id]);
+                    } catch (PDOException $e) {
+                        $stmtCheck = $pdo->prepare("SELECT id FROM sh_modifier_groups WHERE id = ? AND tenant_id = ?");
+                        $stmtCheck->execute([$groupId, $tenant_id]);
+                    }
                     if (!$stmtCheck->fetch()) throw new Exception("Grupa nie istnieje.");
 
-                    $stmt = $pdo->prepare("UPDATE sh_modifier_groups SET name = ?, min_selection = ?, max_selection = ?, free_limit = ?, allow_multi_qty = ?, publication_status = ?, valid_from = ?, valid_to = ? WHERE id = ? AND tenant_id = ?");
-                    $stmt->execute([$name, $minSel, $maxSel, $freeLimit, $allowMulti, $pubStatus, $validFrom, $validTo, $groupId, $tenant_id]);
+                    try {
+                        $stmt = $pdo->prepare("UPDATE sh_modifier_groups SET name = ?, min_selection = ?, max_selection = ?, free_limit = ?, allow_multi_qty = ?, publication_status = ?, valid_from = ?, valid_to = ? WHERE id = ? AND tenant_id = ?");
+                        $stmt->execute([$name, $minSel, $maxSel, $freeLimit, $allowMulti, $pubStatus, $validFrom, $validTo, $groupId, $tenant_id]);
+                    } catch (PDOException $e) {
+                        $stmt = $pdo->prepare("UPDATE sh_modifier_groups SET name = ?, min_selection = ?, max_selection = ? WHERE id = ? AND tenant_id = ?");
+                        $stmt->execute([$name, $minSel, $maxSel, $groupId, $tenant_id]);
+                    }
                 } else {
-                    $stmt = $pdo->prepare("INSERT INTO sh_modifier_groups (tenant_id, name, ascii_key, min_selection, max_selection, free_limit, allow_multi_qty, publication_status, valid_from, valid_to) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)");
-                    $stmt->execute([$tenant_id, $name, $groupAsciiKey, $minSel, $maxSel, $freeLimit, $allowMulti, $pubStatus, $validFrom, $validTo]);
+                    try {
+                        $stmt = $pdo->prepare("INSERT INTO sh_modifier_groups (tenant_id, name, ascii_key, min_selection, max_selection, free_limit, allow_multi_qty, publication_status, valid_from, valid_to) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)");
+                        $stmt->execute([$tenant_id, $name, $groupAsciiKey, $minSel, $maxSel, $freeLimit, $allowMulti, $pubStatus, $validFrom, $validTo]);
+                    } catch (PDOException $e) {
+                        $stmt = $pdo->prepare("INSERT INTO sh_modifier_groups (tenant_id, name, min_selection, max_selection) VALUES (?, ?, ?, ?)");
+                        $stmt->execute([$tenant_id, $name, $minSel, $maxSel]);
+                    }
                     $groupId = $pdo->lastInsertId();
                 }
 
+                // sh_modifiers + sh_price_tiers ÔÇö only available on V2 schema
                 $savedOptionIds = [];
-                $stmtInsertOpt = $pdo->prepare("INSERT INTO sh_modifiers (group_id, name, ascii_key, action_type, linked_warehouse_sku, linked_quantity, is_default) VALUES (?, ?, ?, ?, ?, ?, ?)");
-                $stmtUpdateOpt = $pdo->prepare("UPDATE sh_modifiers SET name = ?, action_type = ?, linked_warehouse_sku = ?, linked_quantity = ?, is_default = ?, is_deleted = 0 WHERE id = ? AND group_id = ?");
-                $stmtTier = $pdo->prepare("INSERT INTO sh_price_tiers (target_type, target_sku, channel, price) VALUES ('MODIFIER', ?, ?, ?) ON DUPLICATE KEY UPDATE price = ?");
-
-                foreach ($options as $opt) {
-                    $optId = intval($opt['id'] ?? 0);
-                    $optName = trim($opt['name'] ?? '');
-                    $optAsciiKey = preg_replace('/[^a-zA-Z0-9_-]/', '', $opt['asciiKey'] ?? '');
-                    $actionType = in_array($opt['actionType'] ?? '', ['NONE','ADD','REMOVE']) ? $opt['actionType'] : 'NONE';
-                    $linkedSku = $toNull($opt['linkedWarehouseSku'] ?? null);
-                    $linkedQty = (float)($opt['linkedQuantity'] ?? 0);
-                    $isDefault = !empty($opt['isDefault']) ? 1 : 0;
-                    $priceTiers = $opt['priceTiers'] ?? [];
-
-                    if (empty($optName) || empty($optAsciiKey)) continue;
-
-                    if ($optId > 0) {
-                        $stmtUpdateOpt->execute([$optName, $actionType, $linkedSku, $linkedQty, $isDefault, $optId, $groupId]);
-                        $savedOptionIds[] = $optId;
-                    } else {
-                        $stmtInsertOpt->execute([$groupId, $optName, $optAsciiKey, $actionType, $linkedSku, $linkedQty, $isDefault]);
-                        $savedOptionIds[] = $pdo->lastInsertId();
+                $hasModifiersTable = false;
+                try {
+                    $pdo->query("SELECT 1 FROM sh_modifiers LIMIT 0");
+                    $hasModifiersTable = true;
+                } catch (PDOException $e) {}
+
+                if ($hasModifiersTable) {
+                    $stmtInsertOpt = $pdo->prepare("INSERT INTO sh_modifiers (group_id, name, ascii_key, action_type, linked_warehouse_sku, linked_quantity, is_default) VALUES (?, ?, ?, ?, ?, ?, ?)");
+                    $stmtUpdateOpt = $pdo->prepare("UPDATE sh_modifiers SET name = ?, action_type = ?, linked_warehouse_sku = ?, linked_quantity = ?, is_default = ?, is_deleted = 0 WHERE id = ? AND group_id = ?");
+
+                    foreach ($options as $opt) {
+                        $optId = intval($opt['id'] ?? 0);
+                        $optName = trim($opt['name'] ?? '');
+                        $optAsciiKey = preg_replace('/[^a-zA-Z0-9_-]/', '', $opt['asciiKey'] ?? '');
+                        $actionType = in_array($opt['actionType'] ?? '', ['NONE','ADD','REMOVE']) ? $opt['actionType'] : 'NONE';
+                        $linkedSku = $toNull($opt['linkedWarehouseSku'] ?? null);
+                        $linkedQty = (float)($opt['linkedQuantity'] ?? 0);
+                        $isDefault = !empty($opt['isDefault']) ? 1 : 0;
+                        $optPriceTiers = $opt['priceTiers'] ?? [];
+
+                        if (empty($optName) || empty($optAsciiKey)) continue;
+
+                        if ($optId > 0) {
+                            $stmtUpdateOpt->execute([$optName, $actionType, $linkedSku, $linkedQty, $isDefault, $optId, $groupId]);
+                            $savedOptionIds[] = $optId;
+                            $resolvedModId = $optId;
+                        } else {
+                            $stmtInsertOpt->execute([$groupId, $optName, $optAsciiKey, $actionType, $linkedSku, $linkedQty, $isDefault]);
+                            $resolvedModId = (int)$pdo->lastInsertId();
+                            $savedOptionIds[] = $resolvedModId;
+                        }
+
+                        if ($hasModifierVisualImpact) {
+                            $hvi = array_key_exists('hasVisualImpact', $opt)
+                                ? (!empty($opt['hasVisualImpact']) ? 1 : 0)
+                                : 1;
+                            $pdo->prepare('UPDATE sh_modifiers SET has_visual_impact = ? WHERE id = ?')
+                                ->execute([$hvi, $resolvedModId]);
+                        }
+
+                        $la = isset($opt['layerTopDownAssetId']) ? (int)$opt['layerTopDownAssetId'] : 0;
+                        $ha = isset($opt['modifierHeroAssetId']) ? (int)$opt['modifierHeroAssetId'] : 0;
+                        try {
+                            $syncModifierVisualAssetLinks(
+                                $pdo,
+                                $tenant_id,
+                                $optAsciiKey,
+                                $la > 0 ? $la : null,
+                                $ha > 0 ? $ha : null
+                            );
+                        } catch (\Throwable $e) {
+                            // Brak sh_asset_links / m021 ÔÇö reszta grupy zapisuje si─Ö normalnie.
+                        }
+
+                        if ($hasPriceTiers) {
+                            $stmtTier = $pdo->prepare("INSERT INTO sh_price_tiers (tenant_id, target_type, target_sku, channel, price) VALUES (?, 'MODIFIER', ?, ?, ?) ON DUPLICATE KEY UPDATE price = VALUES(price)");
+                            foreach ($optPriceTiers as $tier) {
+                                $channel = $tier['channel'] ?? 'POS';
+                                $price = floatval($tier['price'] ?? 0);
+                                $stmtTier->execute([$tenant_id, $optAsciiKey, $channel, $price]);
+                            }
+                        }
                     }
 
-                    // Zapis cen do Macierzy
-                    foreach ($priceTiers as $tier) {
-                        $channel = $tier['channel'] ?? 'POS';
-                        $price = floatval($tier['price'] ?? 0);
-                        $stmtTier->execute([$optAsciiKey, $channel, $price, $price]);
+                    if (!empty($savedOptionIds)) {
+                        $placeholdersOpt = implode(',', array_fill(0, count($savedOptionIds), '?'));
+                        $stmtDelOpt = $pdo->prepare("UPDATE sh_modifiers SET is_deleted = 1 WHERE group_id = ? AND id NOT IN ($placeholdersOpt)");
+                        $stmtDelOpt->execute(array_merge([$groupId], $savedOptionIds));
+                    } else {
+                        $stmtDelOpt = $pdo->prepare("UPDATE sh_modifiers SET is_deleted = 1 WHERE group_id = ?");
+                        $stmtDelOpt->execute([$groupId]);
                     }
                 }
 
-                // Usuwanie opcji, które zostały skasowane z interfejsu
-                if (!empty($savedOptionIds)) {
-                    $placeholdersOpt = implode(',', array_fill(0, count($savedOptionIds), '?'));
-                    $stmtDelOpt = $pdo->prepare("UPDATE sh_modifiers SET is_deleted = 1 WHERE group_id = ? AND id NOT IN ($placeholdersOpt)");
-                    $stmtDelOpt->execute(array_merge([$groupId], $savedOptionIds));
-                } else {
-                    $stmtDelOpt = $pdo->prepare("UPDATE sh_modifiers SET is_deleted = 1 WHERE group_id = ?");
-                    $stmtDelOpt->execute([$groupId]);
-                }
-
                 $pdo->commit();
                 $response['success'] = true;
                 $response['data'] = ['id' => $groupId];
-                $response['message'] = "Zapisano grup─Ö modyfikator├│w i po┼é─ůczono z KSeF.";
+                $response['message'] = "Zapisano grup─Ö modyfikator├│w.";
             } catch (Exception $e) {
                 $pdo->rollBack();
                 throw $e;
@@ -444,34 +1832,106 @@ try {
         // 6. POBIERANIE PEŁNEGO DRZEWA MODYFIKATORÓW (Z CZYTANIEM MACIERZY CEN)
         // ==============================================================================
         case 'get_modifiers_full':
-            $stmtG = $pdo->prepare("SELECT * FROM sh_modifier_groups WHERE tenant_id = ? AND is_deleted = 0 ORDER BY id ASC");
-            $stmtG->execute([$tenant_id]);
+            try {
+                $stmtG = $pdo->prepare("SELECT * FROM sh_modifier_groups WHERE tenant_id = ? AND is_deleted = 0 ORDER BY id ASC");
+                $stmtG->execute([$tenant_id]);
+            } catch (PDOException $e) {
+                $stmtG = $pdo->prepare("SELECT * FROM sh_modifier_groups WHERE tenant_id = ? ORDER BY id ASC");
+                $stmtG->execute([$tenant_id]);
+            }
             $groups = $stmtG->fetchAll(PDO::FETCH_ASSOC);
 
-            $stmtO = $pdo->prepare("SELECT * FROM sh_modifiers WHERE is_deleted = 0");
-            $stmtO->execute();
-            $options = $stmtO->fetchAll(PDO::FETCH_ASSOC);
-
-            $stmtP = $pdo->prepare("SELECT target_sku, channel, price FROM sh_price_tiers WHERE target_type = 'MODIFIER'");
-            $stmtP->execute();
-            $prices = $stmtP->fetchAll(PDO::FETCH_ASSOC);
+            $options = [];
+            try {
+                $stmtO = $pdo->prepare(
+                    "SELECT m.* FROM sh_modifiers m
+                     JOIN sh_modifier_groups mg ON m.group_id = mg.id
+                     WHERE mg.tenant_id = ? AND m.is_deleted = 0"
+                );
+                $stmtO->execute([$tenant_id]);
+                $options = $stmtO->fetchAll(PDO::FETCH_ASSOC);
+            } catch (PDOException $e) {}
+
+            $prices = [];
+            if ($hasPriceTiers) {
+                $stmtP = $pdo->prepare("SELECT target_sku, channel, price FROM sh_price_tiers WHERE target_type = 'MODIFIER' AND (tenant_id = ? OR tenant_id = 0) ORDER BY target_sku, channel, tenant_id DESC");
+                $stmtP->execute([$tenant_id]);
+                $prices = $stmtP->fetchAll(PDO::FETCH_ASSOC);
+            }
 
             $pricesBySku = [];
+            $seenModP = [];
             foreach ($prices as $p) {
+                $mk = $p['target_sku'] . '|' . $p['channel'];
+                if (isset($seenModP[$mk])) continue;
+                $seenModP[$mk] = true;
                 $pricesBySku[$p['target_sku']][] = ['channel' => $p['channel'], 'price' => (float)$p['price']];
             }
 
+            $modifierLinksBySku = [];
+            if (AssetResolver::isReady($pdo) && !empty($options)) {
+                $skuList = [];
+                foreach ($options as $o) {
+                    $ak = (string)($o['ascii_key'] ?? '');
+                    if ($ak !== '') {
+                        $skuList[$ak] = true;
+                    }
+                }
+                $skuKeys = array_keys($skuList);
+                if (!empty($skuKeys)) {
+                    $placeholders = implode(',', array_fill(0, count($skuKeys), '?'));
+                    $stmtL = $pdo->prepare(
+                        "SELECT al.entity_ref AS mod_sku, al.role, al.asset_id, a.ascii_key AS asset_ascii, a.storage_url
+                         FROM sh_asset_links al
+                         INNER JOIN sh_assets a ON a.id = al.asset_id AND a.is_active = 1 AND a.deleted_at IS NULL
+                         WHERE al.tenant_id = ? AND al.entity_type = 'modifier'
+                           AND al.entity_ref IN ($placeholders)
+                           AND al.role IN ('layer_top_down','modifier_hero')
+                           AND al.is_active = 1 AND al.deleted_at IS NULL
+                         ORDER BY al.sort_order ASC, al.id DESC"
+                    );
+                    $stmtL->execute(array_merge([$tenant_id], $skuKeys));
+                    foreach ($stmtL->fetchAll(PDO::FETCH_ASSOC) as $lr) {
+                        $msku = (string)$lr['mod_sku'];
+                        $role = (string)$lr['role'];
+                        if (!isset($modifierLinksBySku[$msku])) {
+                            $modifierLinksBySku[$msku] = [];
+                        }
+                        if (isset($modifierLinksBySku[$msku][$role])) {
+                            continue;
+                        }
+                        $modifierLinksBySku[$msku][$role] = [
+                            'assetId'    => (int)$lr['asset_id'],
+                            'asciiKey'   => (string)$lr['asset_ascii'],
+                            'previewUrl' => AssetResolver::publicUrl((string)$lr['storage_url']),
+                        ];
+                    }
+                }
+            }
+
             $optionsByGroup = [];
             foreach ($options as $opt) {
+                $ascii = $opt['ascii_key'] ?? '';
+                $layerSlot = $modifierLinksBySku[$ascii]['layer_top_down'] ?? null;
+                $heroSlot  = $modifierLinksBySku[$ascii]['modifier_hero'] ?? null;
                 $optionsByGroup[$opt['group_id']][] = [
                     'id' => (int)$opt['id'],
                     'name' => $opt['name'],
-                    'asciiKey' => $opt['ascii_key'],
-                    'isDefault' => (bool)$opt['is_default'],
-                    'actionType' => $opt['action_type'],
-                    'linkedWarehouseSku' => $opt['linked_warehouse_sku'],
-                    'linkedQuantity' => (float)$opt['linked_quantity'],
-                    'priceTiers' => $pricesBySku[$opt['ascii_key']] ?? []
+                    'asciiKey' => $ascii,
+                    'isDefault' => (bool)($opt['is_default'] ?? 0),
+                    'actionType' => $opt['action_type'] ?? 'NONE',
+                    'linkedWarehouseSku' => $opt['linked_warehouse_sku'] ?? null,
+                    'linkedQuantity' => (float)($opt['linked_quantity'] ?? 0),
+                    'priceTiers' => $pricesBySku[$ascii] ?? [],
+                    'hasVisualImpact' => $hasModifierVisualImpact
+                        ? (bool)((int)($opt['has_visual_impact'] ?? 1))
+                        : true,
+                    'layerTopDownAssetId' => $layerSlot ? $layerSlot['assetId'] : null,
+                    'modifierHeroAssetId' => $heroSlot ? $heroSlot['assetId'] : null,
+                    'visualSlots' => [
+                        'layer_top_down' => $layerSlot,
+                        'modifier_hero'  => $heroSlot,
+                    ],
                 ];
             }
 
@@ -480,15 +1940,15 @@ try {
                 $finalGroups[] = [
                     'id' => (int)$g['id'],
                     'name' => $g['name'],
-                    'asciiKey' => $g['ascii_key'],
-                    'min' => (int)$g['min_selection'],
-                    'max' => (int)$g['max_selection'],
-                    'freeLimit' => (int)$g['free_limit'],
-                    'multiQty' => (bool)$g['allow_multi_qty'],
-                    'publicationStatus' => $g['publication_status'],
-                    'validFrom' => $g['valid_from'],
-                    'validTo' => $g['valid_to'],
-                    'isLockedByHq' => (bool)$g['is_locked_by_hq'],
+                    'asciiKey' => $g['ascii_key'] ?? '',
+                    'min' => (int)($g['min_selection'] ?? 0),
+                    'max' => (int)($g['max_selection'] ?? 10),
+                    'freeLimit' => (int)($g['free_limit'] ?? 0),
+                    'multiQty' => (bool)($g['allow_multi_qty'] ?? 0),
+                    'publicationStatus' => $g['publication_status'] ?? 'Draft',
+                    'validFrom' => $g['valid_from'] ?? null,
+                    'validTo' => $g['valid_to'] ?? null,
+                    'isLockedByHq' => (bool)($g['is_locked_by_hq'] ?? 0),
                     'options' => $optionsByGroup[$g['id']] ?? []
                 ];
             }
@@ -501,16 +1961,23 @@ try {
         // 7. SŁOWNIK SUROWCÓW MAGAZYNOWYCH (Dla RecipeMapper i ModifierInspector)
         // ==============================================================================
         case 'get_recipes_init':
-            $stmt = $pdo->prepare("SELECT sku, name, base_unit FROM sys_items WHERE tenant_id = ? ORDER BY name ASC");
-            $stmt->execute([$tenant_id]);
+            try {
+                $stmt = $pdo->prepare("SELECT sku, name, base_unit, search_aliases FROM sys_items WHERE tenant_id = ? AND is_active = 1 AND is_deleted = 0 ORDER BY name ASC");
+                $stmt->execute([$tenant_id]);
+                $hasAliases = true;
+            } catch (PDOException $colEx) {
+                $stmt = $pdo->prepare("SELECT sku, name, base_unit FROM sys_items WHERE tenant_id = ? ORDER BY name ASC");
+                $stmt->execute([$tenant_id]);
+                $hasAliases = false;
+            }
             $rows = $stmt->fetchAll(PDO::FETCH_ASSOC);
 
-            $products = array_map(function($r) {
+            $products = array_map(function($r) use ($hasAliases) {
                 return [
                     'sku'      => $r['sku'],
                     'name'     => $r['name'],
                     'baseUnit' => $r['base_unit'],
-                    'aliases'  => ''
+                    'aliases'  => $hasAliases ? ($r['search_aliases'] ?? '') : ''
                 ];
             }, $rows);
 
@@ -529,7 +1996,7 @@ try {
             $stmt = $pdo->prepare("
                 SELECT r.warehouse_sku, s.name, s.base_unit, r.quantity_base, r.waste_percent, r.is_packaging
                 FROM sh_recipes r
-                JOIN sys_items s ON s.sku = r.warehouse_sku
+                JOIN sys_items s ON s.sku = r.warehouse_sku AND s.tenant_id = r.tenant_id
                 WHERE r.menu_item_sku = ? AND r.tenant_id = ?
                 ORDER BY r.id ASC
             ");
@@ -583,9 +2050,389 @@ try {
             }
             break;
 
+        // ==============================================================================
+        // 10. EXPLODED VIEW ÔÇö Get layers + available SKUs for an item
+        // ==============================================================================
+        case 'get_visual_layers':
+            $itemSku = preg_replace('/[^a-zA-Z0-9_\-]/', '', $input['itemSku'] ?? '');
+            if ($itemSku === '') throw new Exception('itemSku is required.');
+
+            // Item itself (for the base layer entry)
+            $stmtItem = $pdo->prepare(
+                "SELECT ascii_key, name FROM sh_menu_items
+                 WHERE tenant_id = :tid AND ascii_key = :sku AND is_deleted = 0 LIMIT 1"
+            );
+            $stmtItem->execute([':tid' => $tenant_id, ':sku' => $itemSku]);
+            $itemRow = $stmtItem->fetch(PDO::FETCH_ASSOC);
+            if (!$itemRow) throw new Exception("Item SKU not found: {$itemSku}");
+
+            // Modifier SKUs linked to this item via sh_item_modifiers Ôćĺ sh_modifiers
+            $stmtMods = $pdo->prepare(
+                "SELECT m.ascii_key AS sku, m.name, mg.id AS group_id,
+                        mg.name AS group_name, mg.ascii_key AS group_ascii_key,
+                        m.action_type
+                 FROM sh_item_modifiers im
+                 JOIN sh_modifier_groups mg ON mg.id = im.group_id AND mg.tenant_id = :tid
+                 JOIN sh_modifiers m ON m.group_id = mg.id AND m.is_deleted = 0 AND m.is_active = 1
+                 JOIN sh_menu_items mi ON mi.id = im.item_id AND mi.tenant_id = :tid2
+                 WHERE mi.ascii_key = :sku
+                 ORDER BY mg.name, m.name"
+            );
+            $stmtMods->execute([':tid' => $tenant_id, ':tid2' => $tenant_id, ':sku' => $itemSku]);
+            $mods = $stmtMods->fetchAll(PDO::FETCH_ASSOC);
+
+            // Build available SKUs list: base + modifiers
+            $availableSkus = [['sku' => $itemRow['ascii_key'], 'name' => $itemRow['name'], 'type' => 'base', 'group' => '']];
+            foreach ($mods as $m) {
+                $availableSkus[] = [
+                    'sku'   => $m['sku'],
+                    'name'  => $m['name'],
+                    'type'  => 'modifier',
+                    'group' => $m['group_name'],
+                ];
+            }
+
+            // Existing visual layers
+            $stmtLayers = $pdo->prepare(
+                "SELECT layer_sku, asset_filename, z_index, is_base
+                 FROM sh_visual_layers
+                 WHERE tenant_id = :tid AND item_sku = :sku AND is_active = 1
+                 ORDER BY z_index ASC"
+            );
+            $stmtLayers->execute([':tid' => $tenant_id, ':sku' => $itemSku]);
+            $layers = $stmtLayers->fetchAll(PDO::FETCH_ASSOC);
+            foreach ($layers as &$l) {
+                $l['z_index'] = (int)$l['z_index'];
+                $l['is_base'] = (bool)$l['is_base'];
+            }
+            unset($l);
+
+            // ---- Upsell groups: modifier groups with prices ----
+            $upsellGroups = [];
+            $seenGroupIds = [];
+            foreach ($mods as $m) {
+                if (!isset($seenGroupIds[$m['group_id']])) {
+                    $seenGroupIds[$m['group_id']] = [
+                        'groupId'  => (int)$m['group_id'],
+                        'name'     => $m['group_name'],
+                        'asciiKey' => $m['group_ascii_key'] ?? '',
+                        'options'  => [],
+                    ];
+                }
+                $opt = [
+                    'sku'      => $m['sku'],
+                    'name'     => $m['name'],
+                    'price'    => null,
+                    'imageUrl' => null,
+                ];
+                $seenGroupIds[$m['group_id']]['options'][] = $opt;
+            }
+
+            // Fetch prices from sh_price_tiers for modifier SKUs
+            $modSkus = array_column($mods, 'sku');
+            if (!empty($modSkus)) {
+                $placeholders = implode(',', array_fill(0, count($modSkus), '?'));
+                $stmtPrices = $pdo->prepare(
+                    "SELECT target_sku, price, channel
+                     FROM sh_price_tiers
+                     WHERE target_type = 'MODIFIER'
+                       AND target_sku IN ({$placeholders})
+                       AND (tenant_id = ? OR tenant_id = 0)
+                     ORDER BY tenant_id DESC"
+                );
+                $priceParams = array_merge($modSkus, [$tenant_id]);
+                $stmtPrices->execute($priceParams);
+                $priceRows = $stmtPrices->fetchAll(PDO::FETCH_ASSOC);
+
+                $priceMap = [];
+                foreach ($priceRows as $pr) {
+                    if (!isset($priceMap[$pr['target_sku']])) {
+                        $priceMap[$pr['target_sku']] = (float)$pr['price'];
+                    }
+                }
+
+                foreach ($seenGroupIds as &$grp) {
+                    foreach ($grp['options'] as &$opt) {
+                        if (isset($priceMap[$opt['sku']])) {
+                            $opt['price'] = $priceMap[$opt['sku']];
+                        }
+                    }
+                    unset($opt);
+                }
+                unset($grp);
+            }
+            $upsellGroups = array_values($seenGroupIds);
+
+            // ---- Explicit companions from sh_board_companions ----
+            $companions = [];
+            try {
+                $stmtComp = $pdo->prepare(
+                    "SELECT bc.companion_sku, bc.companion_type, bc.board_slot,
+                            bc.asset_filename, bc.display_order,
+                            mi.name, mi.image_url
+                     FROM sh_board_companions bc
+                     JOIN sh_menu_items mi ON mi.ascii_key = bc.companion_sku AND mi.tenant_id = bc.tenant_id
+                     WHERE bc.tenant_id = :tid AND bc.item_sku = :sku AND bc.is_active = 1
+                     ORDER BY bc.display_order"
+                );
+                $stmtComp->execute([':tid' => $tenant_id, ':sku' => $itemSku]);
+                $compRows = $stmtComp->fetchAll(PDO::FETCH_ASSOC);
+
+                // Fetch companion prices
+                $compSkus = array_column($compRows, 'companion_sku');
+                $compPriceMap = [];
+                if (!empty($compSkus)) {
+                    $ph = implode(',', array_fill(0, count($compSkus), '?'));
+                    $stmtCP = $pdo->prepare(
+                        "SELECT target_sku, price FROM sh_price_tiers
+                         WHERE target_type = 'ITEM' AND target_sku IN ({$ph})
+                           AND (tenant_id = ? OR tenant_id = 0)
+                         ORDER BY tenant_id DESC"
+                    );
+                    $stmtCP->execute(array_merge($compSkus, [$tenant_id]));
+                    foreach ($stmtCP->fetchAll(PDO::FETCH_ASSOC) as $cp) {
+                        if (!isset($compPriceMap[$cp['target_sku']])) {
+                            $compPriceMap[$cp['target_sku']] = (float)$cp['price'];
+                        }
+                    }
+                }
+
+                foreach ($compRows as $cr) {
+                    $companions[] = [
+                        'sku'           => $cr['companion_sku'],
+                        'name'          => $cr['name'],
+                        'type'          => $cr['companion_type'],
+                        'slot'          => (int)$cr['board_slot'],
+                        'price'         => $compPriceMap[$cr['companion_sku']] ?? null,
+                        'assetFilename' => $cr['asset_filename'],
+                        'imageUrl'      => $cr['image_url'],
+                        'displayOrder'  => (int)$cr['display_order'],
+                    ];
+                }
+            } catch (Exception $eComp) {
+                // sh_board_companions may not exist yet ÔÇö graceful degradation
+                error_log('[MenuStudio] board_companions lookup skipped: ' . $eComp->getMessage());
+            }
+
+            $response['success'] = true;
+            $response['message'] = 'Visual context loaded.';
+            $response['data'] = [
+                'item_sku'       => $itemSku,
+                'available_skus' => $availableSkus,
+                'layers'         => $layers,
+                'asset_base_url' => '../../uploads/visual/' . $tenant_id . '/',
+                'upsell_groups'  => $upsellGroups,
+                'companions'     => $companions,
+            ];
+            break;
+
+        // ==============================================================================
+        // 11. EXPLODED VIEW ÔÇö Upsert a single visual layer
+        // ==============================================================================
+        case 'save_visual_layer':
+            $itemSku  = preg_replace('/[^a-zA-Z0-9_\-]/', '', $input['itemSku'] ?? '');
+            $layerSku = preg_replace('/[^a-zA-Z0-9_\-]/', '', $input['layerSku'] ?? '');
+            $assetFn  = preg_replace('/[^a-zA-Z0-9_.\-]/', '', $input['assetFilename'] ?? '');
+            $zIndex   = max(0, min(100, (int)($input['zIndex'] ?? 0)));
+            $isBase   = !empty($input['isBase']) ? 1 : 0;
+
+            if ($itemSku === '' || $layerSku === '' || $assetFn === '') {
+                throw new Exception('itemSku, layerSku, and assetFilename are all required.');
+            }
+
+            $stmt = $pdo->prepare(
+                "INSERT INTO sh_visual_layers
+                    (tenant_id, item_sku, layer_sku, asset_filename, z_index, is_base)
+                 VALUES (:tid, :item, :layer, :asset, :z, :base)
+                 ON DUPLICATE KEY UPDATE
+                    asset_filename = VALUES(asset_filename),
+                    z_index = VALUES(z_index),
+                    is_base = VALUES(is_base),
+                    is_active = 1,
+                    updated_at = NOW()"
+            );
+            $stmt->execute([
+                ':tid'   => $tenant_id,
+                ':item'  => $itemSku,
+                ':layer' => $layerSku,
+                ':asset' => $assetFn,
+                ':z'     => $zIndex,
+                ':base'  => $isBase,
+            ]);
+
+            $response['success'] = true;
+            $response['message'] = 'Layer saved.';
+            break;
+
+        // ==============================================================================
+        // 12. EXPLODED VIEW ÔÇö Delete a visual layer
+        // ==============================================================================
+        case 'delete_visual_layer':
+            $itemSku  = preg_replace('/[^a-zA-Z0-9_\-]/', '', $input['itemSku'] ?? '');
+            $layerSku = preg_replace('/[^a-zA-Z0-9_\-]/', '', $input['layerSku'] ?? '');
+            if ($itemSku === '' || $layerSku === '') {
+                throw new Exception('itemSku and layerSku are required.');
+            }
+
+            // Fetch filename to delete from disk
+            $stmtGet = $pdo->prepare(
+                "SELECT asset_filename FROM sh_visual_layers
+                 WHERE tenant_id = :tid AND item_sku = :item AND layer_sku = :layer LIMIT 1"
+            );
+            $stmtGet->execute([':tid' => $tenant_id, ':item' => $itemSku, ':layer' => $layerSku]);
+            $row = $stmtGet->fetch(PDO::FETCH_ASSOC);
+
+            if ($row) {
+                $filePath = realpath(__DIR__ . '/../../') . '/uploads/visual/' . $tenant_id . '/' . $row['asset_filename'];
+                if (file_exists($filePath) && is_file($filePath)) {
+                    @unlink($filePath);
+                }
+            }
+
+            $stmtDel = $pdo->prepare(
+                "DELETE FROM sh_visual_layers
+                 WHERE tenant_id = :tid AND item_sku = :item AND layer_sku = :layer"
+            );
+            $stmtDel->execute([':tid' => $tenant_id, ':item' => $itemSku, ':layer' => $layerSku]);
+
+            $response['success'] = true;
+            $response['message'] = 'Layer deleted.';
+            break;
+
+        // ==============================================================================
+        // 13. BOARD COMPANIONS ÔÇö Upsert an explicit companion link
+        // ==============================================================================
+        case 'save_board_companion':
+            $itemSku      = preg_replace('/[^a-zA-Z0-9_\-]/', '', $input['itemSku'] ?? '');
+            $companionSku = preg_replace('/[^a-zA-Z0-9_\-]/', '', $input['companionSku'] ?? '');
+            $compType     = $input['companionType'] ?? 'extra';
+            $boardSlot    = max(0, min(5, (int)($input['boardSlot'] ?? 0)));
+            $assetFn      = preg_replace('/[^a-zA-Z0-9_.\-]/', '', $input['assetFilename'] ?? '');
+            $displayOrder = max(0, (int)($input['displayOrder'] ?? 0));
+
+            if ($itemSku === '' || $companionSku === '') {
+                throw new Exception('itemSku and companionSku are required.');
+            }
+
+            $allowedTypes = ['sauce', 'drink', 'side', 'dessert', 'extra'];
+            if (!in_array($compType, $allowedTypes, true)) {
+                $compType = 'extra';
+            }
+
+            $stmt = $pdo->prepare(
+                "INSERT INTO sh_board_companions
+                    (tenant_id, item_sku, companion_sku, companion_type, board_slot, asset_filename, display_order)
+                 VALUES (:tid, :item, :comp, :ctype, :slot, :asset, :dord)
+                 ON DUPLICATE KEY UPDATE
+                    companion_type = VALUES(companion_type),
+                    board_slot     = VALUES(board_slot),
+                    asset_filename = VALUES(asset_filename),
+                    display_order  = VALUES(display_order),
+                    is_active      = 1,
+                    updated_at     = NOW()"
+            );
+            $stmt->execute([
+                ':tid'   => $tenant_id,
+                ':item'  => $itemSku,
+                ':comp'  => $companionSku,
+                ':ctype' => $compType,
+                ':slot'  => $boardSlot,
+                ':asset' => $assetFn ?: null,
+                ':dord'  => $displayOrder,
+            ]);
+
+            $response['success'] = true;
+            $response['message'] = 'Companion saved.';
+            break;
+
+        // ==============================================================================
+        // 14. BOARD COMPANIONS ÔÇö Delete a companion link
+        // ==============================================================================
+        case 'delete_board_companion':
+            $itemSku      = preg_replace('/[^a-zA-Z0-9_\-]/', '', $input['itemSku'] ?? '');
+            $companionSku = preg_replace('/[^a-zA-Z0-9_\-]/', '', $input['companionSku'] ?? '');
+
+            if ($itemSku === '' || $companionSku === '') {
+                throw new Exception('itemSku and companionSku are required.');
+            }
+
+            $stmtDel = $pdo->prepare(
+                "DELETE FROM sh_board_companions
+                 WHERE tenant_id = :tid AND item_sku = :item AND companion_sku = :comp"
+            );
+            $stmtDel->execute([':tid' => $tenant_id, ':item' => $itemSku, ':comp' => $companionSku]);
+
+            $response['success'] = true;
+            $response['message'] = 'Companion deleted.';
+            break;
+
+        // ==============================================================================
+        // [REMOVED ┬Ě M025] 15-17 Ingredient Library (get/save/delete_ingredient_asset)
+        //                  + 18 get_board_context
+        //
+        // Ca┼éy blok bazowa┼é na `sh_ingredient_assets` (zast─ůpione przez Asset Studio
+        // i Unified Asset Library sh_assets + sh_asset_links w m021). Żadne wywołania
+        // z frontendów (studio/menu_studio, online, online_studio) ich już nie używały,
+        // dlatego zosta┼éy usuni─Öte razem z tabel─ů `sh_ingredient_assets` (m025).
+        //
+        // Board context dla online/storefront jest teraz składany przez
+        //   ÔÇó api/online/engine.php#get_dish             (legacy endpoint, wci─ů┼╝ u┼╝ywany)
+        //   ÔÇó api/online/engine.php#get_scene_dish       (nowy kontrakt, Scene Studio)
+        // kt├│re wczytuj─ů warstwy z sh_visual_layers + sh_asset_links (layer_top_down).
+        // ==============================================================================
+        case 'get_board_context':
+            // Kr├│tki defensywny error ÔÇö gdyby co┼Ť legacy jeszcze wo┼éa┼éo:
+            throw new Exception('get_board_context usuni─Öte w m025 ÔÇö u┼╝yj online/get_scene_dish lub online/get_dish.');
+
+        case 'get_ingredient_assets':
+        case 'save_ingredient_asset':
+        case 'delete_ingredient_asset':
+            throw new Exception('Ingredient Library (sh_ingredient_assets) usuni─Öte w m025 ÔÇö u┼╝yj Asset Studio (sh_assets + sh_asset_links).');
+
         // ==============================================================================
         // TARCZA DIAGNOSTYCZNA (Wy┼éapuje zmy┼Ťlone akcje JS)
         // ==============================================================================
+        // ==============================================================================
+        // GLOBAL ASSETS ÔÇö Fetch photorealistic .webp assets from sh_global_assets
+        // ==============================================================================
+        case 'get_global_assets':
+            $category = preg_replace('/[^a-z]/', '', $input['category'] ?? '');
+
+            $sql = "SELECT id, ascii_key, category, sub_type, filename, width, height,
+                           has_alpha, filesize_bytes, z_order, target_px
+                    FROM sh_global_assets
+                    WHERE (tenant_id = 0 OR tenant_id = :tid) AND is_active = 1";
+            $params = [':tid' => $tenant_id];
+
+            if ($category !== '') {
+                $sql .= " AND category = :cat";
+                $params[':cat'] = $category;
+            }
+
+            $sql .= " ORDER BY z_order ASC, ascii_key ASC";
+
+            $stmtGA = $pdo->prepare($sql);
+            $stmtGA->execute($params);
+            $globalAssets = $stmtGA->fetchAll(PDO::FETCH_ASSOC);
+
+            foreach ($globalAssets as &$ga) {
+                $ga['id']        = (int)$ga['id'];
+                $ga['width']     = (int)$ga['width'];
+                $ga['height']    = (int)$ga['height'];
+                $ga['hasAlpha']  = (bool)$ga['has_alpha'];
+                $ga['zOrder']    = (int)$ga['z_order'];
+                $ga['targetPx']  = (int)$ga['target_px'];
+                $ga['filesize']  = (int)$ga['filesize_bytes'];
+                $ga['url']       = '/slicehub/uploads/global_assets/' . $ga['filename'];
+                unset($ga['has_alpha'], $ga['z_order'], $ga['target_px'], $ga['filesize_bytes']);
+            }
+            unset($ga);
+
+            $response['success'] = true;
+            $response['data']    = ['assets' => $globalAssets];
+            $response['message'] = count($globalAssets) . ' assets loaded.';
+            break;
+
         default:
             $unknown = $action ?: 'PUSTA_AKCJA';
             throw new Exception("Nieznana akcja API: [{$unknown}] - Prawdopodobnie stara wersja JS!");
@@ -593,7 +2440,12 @@ try {
 } catch (Exception $e) {
     $response['success'] = false;
     $response['data'] = null;
-    $response['message'] = $e->getMessage();
+    $msg = $e->getMessage();
+    $isBizLogic = !($e instanceof PDOException)
+               && !str_contains($msg, 'SQLSTATE')
+               && !str_contains($msg, 'Base table');
+    $response['message'] = $isBizLogic ? $msg : 'Internal server error.';
+    error_log('[MenuStudio] ' . $msg . ' in ' . $e->getFile() . ':' . $e->getLine());
 }
 
 echo json_encode($response);
diff --git a/api/cart/CartEngine.php b/api/cart/CartEngine.php
index a2c0566..2596e44 100644
--- a/api/cart/CartEngine.php
+++ b/api/cart/CartEngine.php
@@ -14,6 +14,327 @@ class CartEngineException extends RuntimeException {}
 
 class CartEngine
 {
+    // =========================================================================
+    // AUTO-PROMOTIONS (sh_promotions) ÔÇö Faza 4.1
+    // Helpery prywatne do oceny rule_json wzgl─Ödem stanu koszyka.
+    // =========================================================================
+
+    /**
+     * Suma line_total_grosze dla linii pasuj─ůcych do SKU.
+     * @param list<array{item_sku:string,line_total_grosze:int,...}> $lines
+     */
+    private static function sumLinesBySku(array $lines, string $sku): int
+    {
+        if ($sku === '') return 0;
+        $sum = 0;
+        foreach ($lines as $ln) {
+            if (($ln['item_sku'] ?? '') === $sku) {
+                $sum += (int)($ln['line_total_grosze'] ?? 0);
+            }
+        }
+        return $sum;
+    }
+
+    /**
+     * Suma line_total_grosze dla linii z kategorii (po mapie sku Ôćĺ category_id).
+     * @param array<string,int> $catMap
+     */
+    private static function sumLinesByCategory(array $lines, int $categoryId, array $catMap): int
+    {
+        if ($categoryId <= 0) return 0;
+        $sum = 0;
+        foreach ($lines as $ln) {
+            $sku = (string)($ln['item_sku'] ?? '');
+            if (($catMap[$sku] ?? 0) === $categoryId) {
+                $sum += (int)($ln['line_total_grosze'] ?? 0);
+            }
+        }
+        return $sum;
+    }
+
+    /**
+     * Najtańsza jednostka (unit_price_grosze) dla SKU w koszyku albo null gdy brak.
+     */
+    private static function cheapestUnitBySku(array $lines, string $sku): ?int
+    {
+        if ($sku === '') return null;
+        $min = null;
+        foreach ($lines as $ln) {
+            if (($ln['item_sku'] ?? '') === $sku) {
+                $unit = (int)($ln['unit_price_grosze'] ?? 0);
+                if ($unit > 0 && ($min === null || $unit < $min)) $min = $unit;
+            }
+        }
+        return $min;
+    }
+
+    /**
+     * Dodatkowe gating po godzinie / dniu tygodnia.
+     *   time_window_json: { days:[1..7] (ISO, 1=Pn), start:"HH:MM", end:"HH:MM" }
+     */
+    private static function isInTimeWindow(?string $twJson, DateTimeImmutable $now): bool
+    {
+        if ($twJson === null || $twJson === '') return true;
+        $tw = json_decode($twJson, true);
+        if (!is_array($tw)) return true;
+
+        if (!empty($tw['days']) && is_array($tw['days'])) {
+            $dow = (int)$now->format('N');
+            $days = array_map('intval', $tw['days']);
+            if (!in_array($dow, $days, true)) return false;
+        }
+        if (!empty($tw['start']) && !empty($tw['end'])) {
+            $timeNow = $now->format('H:i');
+            $s = (string)$tw['start'];
+            $e = (string)$tw['end'];
+            if ($s <= $e) {
+                if ($timeNow < $s || $timeNow > $e) return false;
+            } else {
+                // okno przez północ
+                if ($timeNow < $s && $timeNow > $e) return false;
+            }
+        }
+        return true;
+    }
+
+    /**
+     * Wylicza rabat w grosze dla jednej promocji.
+     * @param array{id:int,ascii_key:string,name:string,rule_kind:string,rule:?array,badge_text:?string,badge_style:?string} $promo
+     * @param array{subtotal_grosze:int,lines:array,category_map:array<string,int>} $ctx
+     * @return array{promotion_id:int,ascii_key:string,name:string,rule_kind:string,badge_text:?string,badge_style:string,discount_grosze:int,note:string}|null
+     */
+    private static function evaluateRule(array $promo, array $ctx): ?array
+    {
+        $kind = (string)$promo['rule_kind'];
+        $rule = $promo['rule'] ?? null;
+        if (!is_array($rule)) return null;
+
+        $discount = 0;
+        $note = '';
+        $subtotal = (int)$ctx['subtotal_grosze'];
+        $lines    = $ctx['lines'];
+        $catMap   = $ctx['category_map'];
+
+        switch ($kind) {
+            case 'discount_percent': {
+                $target  = (string)($rule['target'] ?? 'cart');
+                $percent = (float)($rule['percent'] ?? 0);
+                if ($percent <= 0 || $percent > 100) return null;
+                $minSubtotal = isset($rule['min_subtotal'])
+                    ? (int)round((float)$rule['min_subtotal'] * 100) : 0;
+                if ($subtotal < $minSubtotal) return null;
+
+                if ($target === 'cart') {
+                    $discount = (int)round($subtotal * $percent / 100);
+                    $note = "-{$percent}% od koszyka";
+                } elseif ($target === 'item') {
+                    $sku = (string)($rule['sku'] ?? '');
+                    $matched = self::sumLinesBySku($lines, $sku);
+                    $discount = (int)round($matched * $percent / 100);
+                    $note = "-{$percent}% na {$sku}";
+                } elseif ($target === 'category') {
+                    $cid = (int)($rule['category_id'] ?? 0);
+                    $matched = self::sumLinesByCategory($lines, $cid, $catMap);
+                    $discount = (int)round($matched * $percent / 100);
+                    $note = "-{$percent}% na kategori─Ö #{$cid}";
+                }
+                break;
+            }
+
+            case 'discount_amount': {
+                $target = (string)($rule['target'] ?? 'cart');
+                $amountGrosze = (int)round((float)($rule['amount'] ?? 0) * 100);
+                if ($amountGrosze <= 0) return null;
+                $minSubtotal = isset($rule['min_subtotal'])
+                    ? (int)round((float)$rule['min_subtotal'] * 100) : 0;
+                if ($subtotal < $minSubtotal) return null;
+
+                if ($target === 'cart') {
+                    $discount = min($amountGrosze, $subtotal);
+                    $note = '-' . number_format($amountGrosze / 100, 2) . ' od koszyka';
+                } elseif ($target === 'item') {
+                    $sku = (string)($rule['sku'] ?? '');
+                    $matched = self::sumLinesBySku($lines, $sku);
+                    if ($matched <= 0) return null;
+                    $discount = min($amountGrosze, $matched);
+                    $note = '-' . number_format($discount / 100, 2) . " na {$sku}";
+                } elseif ($target === 'category') {
+                    $cid = (int)($rule['category_id'] ?? 0);
+                    $matched = self::sumLinesByCategory($lines, $cid, $catMap);
+                    if ($matched <= 0) return null;
+                    $discount = min($amountGrosze, $matched);
+                    $note = '-' . number_format($discount / 100, 2) . " na kategori─Ö #{$cid}";
+                }
+                break;
+            }
+
+            case 'combo_half_price': {
+                // Kup `anchor_sku`, drug─ů `combo_sku` za `percent`% ceny (default 50%).
+                $anchorSku = (string)($rule['anchor_sku'] ?? '');
+                $comboSku  = (string)($rule['combo_sku']  ?? '');
+                $percent   = (float)($rule['percent'] ?? 50);
+                if ($anchorSku === '' || $comboSku === '' || $percent <= 0 || $percent > 100) return null;
+
+                if (self::sumLinesBySku($lines, $anchorSku) <= 0) return null;
+                $comboUnit = self::cheapestUnitBySku($lines, $comboSku);
+                if ($comboUnit === null) return null;
+
+                $discount = (int)round($comboUnit * $percent / 100);
+                $note = "kombo {$anchorSku} + -{$percent}% na {$comboSku}";
+                break;
+            }
+
+            case 'free_item_if_threshold': {
+                $minSubtotal = (int)round((float)($rule['min_subtotal'] ?? 0) * 100);
+                $freeSku     = (string)($rule['free_sku'] ?? '');
+                if ($subtotal < $minSubtotal || $freeSku === '') return null;
+
+                $unit = self::cheapestUnitBySku($lines, $freeSku);
+                if ($unit === null) return null;
+                $discount = $unit;
+                $note = "gratis {$freeSku} (pr├│g " . number_format($minSubtotal / 100, 2) . ')';
+                break;
+            }
+
+            case 'bundle': {
+                $skus = $rule['skus'] ?? [];
+                $bundlePriceGrosze = (int)round((float)($rule['bundle_price'] ?? 0) * 100);
+                if (!is_array($skus) || count($skus) < 2 || $bundlePriceGrosze <= 0) return null;
+
+                $bundleValue = 0;
+                foreach ($skus as $sku) {
+                    $unit = self::cheapestUnitBySku($lines, (string)$sku);
+                    if ($unit === null) return null;
+                    $bundleValue += $unit;
+                }
+                if ($bundleValue <= $bundlePriceGrosze) return null;
+                $discount = $bundleValue - $bundlePriceGrosze;
+                $note = 'bundle (-' . number_format($discount / 100, 2) . ')';
+                break;
+            }
+
+            default:
+                return null;
+        }
+
+        if ($discount <= 0) return null;
+        $discount = min($discount, $subtotal);
+
+        return [
+            'promotion_id'    => (int)$promo['id'],
+            'ascii_key'       => (string)$promo['ascii_key'],
+            'name'            => (string)$promo['name'],
+            'rule_kind'       => $kind,
+            'badge_text'      => $promo['badge_text']  ?? null,
+            'badge_style'     => (string)($promo['badge_style'] ?? 'amber'),
+            'discount_grosze' => $discount,
+            'note'            => $note,
+        ];
+    }
+
+    /**
+     * Ładuje aktywne sh_promotions dla tenanta (time-gated po SQL) i ocenia je.
+     * MVP: best-wins ÔÇö wybiera jedn─ů promocj─Ö daj─ůc─ů najwi─Ökszy rabat.
+     * V2 (future): flaga `stackable:true` w rule_json, priorities, wykluczenia.
+     *
+     * @return array{discount_grosze:int, applied:list<array>}
+     */
+    private static function applyAutoPromotions(
+        PDO $pdo,
+        int $tenantId,
+        int $subtotalGrosze,
+        array $linesRaw
+    ): array {
+        // Schema detection ÔÇö gdy sh_promotions nie istnieje (migracja 022 nie przesz┼éa), zwracamy zera.
+        try {
+            $pdo->query('SELECT 1 FROM sh_promotions LIMIT 0');
+        } catch (\PDOException $e) {
+            return ['discount_grosze' => 0, 'applied' => []];
+        }
+
+        // Load
+        try {
+            $stmt = $pdo->prepare(
+                "SELECT id, ascii_key, name, rule_kind, rule_json,
+                        badge_text, badge_style, time_window_json
+                 FROM sh_promotions
+                 WHERE tenant_id = :tid AND is_active = 1
+                   AND (valid_from IS NULL OR valid_from <= NOW())
+                   AND (valid_to   IS NULL OR valid_to   >= NOW())
+                 ORDER BY id ASC"
+            );
+            $stmt->execute([':tid' => $tenantId]);
+            $promoRows = $stmt->fetchAll(PDO::FETCH_ASSOC);
+        } catch (\PDOException $e) {
+            return ['discount_grosze' => 0, 'applied' => []];
+        }
+        if (!$promoRows) return ['discount_grosze' => 0, 'applied' => []];
+
+        // Batch mapa sku Ôćĺ category_id (dla target=category)
+        $catMap = [];
+        $skus = array_values(array_unique(array_filter(array_map(
+            fn($l) => (string)($l['item_sku'] ?? ''),
+            $linesRaw
+        ))));
+        if ($skus) {
+            try {
+                $ph = implode(',', array_fill(0, count($skus), '?'));
+                $stmtCat = $pdo->prepare(
+                    "SELECT ascii_key, category_id FROM sh_menu_items
+                     WHERE tenant_id = ? AND ascii_key IN ({$ph})"
+                );
+                $stmtCat->execute(array_merge([$tenantId], $skus));
+                foreach ($stmtCat->fetchAll(PDO::FETCH_ASSOC) as $r) {
+                    $catMap[(string)$r['ascii_key']] = (int)($r['category_id'] ?? 0);
+                }
+            } catch (\PDOException $e) {
+                // skip ÔÇö target=category nie zadzia┼éa, ale reszta tak
+            }
+        }
+
+        $now = new DateTimeImmutable('now');
+        $ctx = [
+            'subtotal_grosze' => $subtotalGrosze,
+            'lines'           => $linesRaw,
+            'category_map'    => $catMap,
+        ];
+
+        $candidates = [];
+        foreach ($promoRows as $row) {
+            if (!self::isInTimeWindow($row['time_window_json'] ?? null, $now)) continue;
+
+            $rule = null;
+            if (!empty($row['rule_json'])) {
+                $decoded = json_decode((string)$row['rule_json'], true);
+                if (is_array($decoded)) $rule = $decoded;
+            }
+
+            $evaluated = self::evaluateRule([
+                'id'          => (int)$row['id'],
+                'ascii_key'   => (string)$row['ascii_key'],
+                'name'        => (string)$row['name'],
+                'rule_kind'   => (string)$row['rule_kind'],
+                'rule'        => $rule,
+                'badge_text'  => $row['badge_text']  ?? null,
+                'badge_style' => $row['badge_style'] ?? 'amber',
+            ], $ctx);
+
+            if ($evaluated !== null) $candidates[] = $evaluated;
+        }
+
+        if (!$candidates) return ['discount_grosze' => 0, 'applied' => []];
+
+        // Best-wins (MVP)
+        usort($candidates, fn($a, $b) => $b['discount_grosze'] <=> $a['discount_grosze']);
+        $best = $candidates[0];
+
+        return [
+            'discount_grosze' => $best['discount_grosze'],
+            'applied'         => [$best],
+        ];
+    }
+
+
     /**
      * Run a full server-authoritative cart calculation.
      *
@@ -87,7 +408,8 @@ class CartEngine
         $stmtItemPrice = $pdo->prepare(
             "SELECT price FROM sh_price_tiers
              WHERE target_type = 'ITEM' AND target_sku = :sku AND channel = :channel
-             LIMIT 1"
+               AND (tenant_id = :tid OR tenant_id = 0)
+             ORDER BY tenant_id DESC LIMIT 1"
         );
 
         $stmtModifier = $pdo->prepare(
@@ -104,13 +426,15 @@ class CartEngine
         $stmtModPrice = $pdo->prepare(
             "SELECT price FROM sh_price_tiers
              WHERE target_type = 'MODIFIER' AND target_sku = :sku AND channel = :channel
-             LIMIT 1"
+               AND (tenant_id = :tid OR tenant_id = 0)
+             ORDER BY tenant_id DESC LIMIT 1"
         );
 
         $stmtModPriceFallback = $pdo->prepare(
             "SELECT price FROM sh_price_tiers
              WHERE target_type = 'MODIFIER' AND target_sku = :sku AND channel = 'POS'
-             LIMIT 1"
+               AND (tenant_id = :tid OR tenant_id = 0)
+             ORDER BY tenant_id DESC LIMIT 1"
         );
 
         $stmtWarehouseItem = $pdo->prepare(
@@ -125,15 +449,15 @@ class CartEngine
         $fmtMoney = fn(int $grosze): string => number_format($grosze / 100, 2, '.', '');
         $fmtRate  = fn(float $rate): string => number_format($rate, 2, '.', '');
 
-        $resolveModPrice = function (string $modSku) use ($stmtModPrice, $stmtModPriceFallback, $channel): int {
-            $stmtModPrice->execute([':sku' => $modSku, ':channel' => $channel]);
+        $resolveModPrice = function (string $modSku) use ($stmtModPrice, $stmtModPriceFallback, $channel, $tenantId): int {
+            $stmtModPrice->execute([':sku' => $modSku, ':channel' => $channel, ':tid' => $tenantId]);
             $row = $stmtModPrice->fetch(PDO::FETCH_ASSOC);
             if ($row) {
                 return (int)round((float)$row['price'] * 100);
             }
 
             if ($channel !== 'POS') {
-                $stmtModPriceFallback->execute([':sku' => $modSku]);
+                $stmtModPriceFallback->execute([':sku' => $modSku, ':tid' => $tenantId]);
                 $row = $stmtModPriceFallback->fetch(PDO::FETCH_ASSOC);
                 if ($row) {
                     return (int)round((float)$row['price'] * 100);
@@ -187,7 +511,7 @@ class CartEngine
                     throw new CartEngineException("Line #{$idx}: half_a_sku '{$halfASku}' not found for this tenant.");
                 }
 
-                $stmtItemPrice->execute([':sku' => $halfASku, ':channel' => $channel]);
+                $stmtItemPrice->execute([':sku' => $halfASku, ':channel' => $channel, ':tid' => $tenantId]);
                 $pA = $stmtItemPrice->fetch(PDO::FETCH_ASSOC);
                 if (!$pA) {
                     throw new CartEngineException("Line #{$idx}: no '{$channel}' price tier for half_a_sku '{$halfASku}'.");
@@ -200,7 +524,7 @@ class CartEngine
                     throw new CartEngineException("Line #{$idx}: half_b_sku '{$halfBSku}' not found for this tenant.");
                 }
 
-                $stmtItemPrice->execute([':sku' => $halfBSku, ':channel' => $channel]);
+                $stmtItemPrice->execute([':sku' => $halfBSku, ':channel' => $channel, ':tid' => $tenantId]);
                 $pB = $stmtItemPrice->fetch(PDO::FETCH_ASSOC);
                 if (!$pB) {
                     throw new CartEngineException("Line #{$idx}: no '{$channel}' price tier for half_b_sku '{$halfBSku}'.");
@@ -240,7 +564,7 @@ class CartEngine
                     throw new CartEngineException("Line #{$idx}: SKU '{$effectiveSku}' not found for this tenant.");
                 }
 
-                $stmtItemPrice->execute([':sku' => $effectiveSku, ':channel' => $channel]);
+                $stmtItemPrice->execute([':sku' => $effectiveSku, ':channel' => $channel, ':tid' => $tenantId]);
                 $priceRow = $stmtItemPrice->fetch(PDO::FETCH_ASSOC);
                 if (!$priceRow) {
                     throw new CartEngineException("Line #{$idx}: no '{$channel}' price tier for SKU '{$effectiveSku}'.");
@@ -359,24 +683,46 @@ class CartEngine
             $resultLines[] = $lineOutput;
 
             $linesRaw[] = [
-                'item_sku'         => $effectiveSku,
-                'snapshot_name'    => $snapshotName,
-                'unit_price_grosze'=> $unitPriceGrosze,
-                'quantity'         => $quantity,
-                'line_total_grosze'=> $lineTotalGrosze,
-                'vat_rate'         => $vatRate,
-                'vat_amount_grosze'=> $vatAmountGrosze,
+                'line_id'               => $lineId,
+                'item_sku'              => $effectiveSku,
+                'snapshot_name'         => $snapshotName,
+                'unit_price_grosze'     => $unitPriceGrosze,
+                'quantity'              => $quantity,
+                'line_total_grosze'     => $lineTotalGrosze,
+                'vat_rate'              => $vatRate,
+                'vat_amount_grosze'     => $vatAmountGrosze,
+                'modifiers_json'        => !empty($resolvedModifiers)
+                    ? json_encode($resolvedModifiers, JSON_UNESCAPED_UNICODE)
+                    : null,
+                'removed_ingredients_json' => !empty($resolvedRemovals)
+                    ? json_encode($resolvedRemovals, JSON_UNESCAPED_UNICODE)
+                    : null,
+                'comment'               => $comment !== '' ? $comment : null,
             ];
         }
 
         // =====================================================================
-        // 6. PROMO / DISCOUNT ENGINE
+        // 5.5. AUTO-PROMOTIONS (sh_promotions ÔÇö M022) ÔÇö Faza 4.1
+        //
+        // Promocje auto-aplikowane (bez kodu) ÔÇö time-gated w SQL, window-gated
+        // w PHP. MVP: best-wins (jedna promocja = najwi─Ökszy rabat). Aplikujemy
+        // PRZED promo_code aby kod liczył się od subtotal after auto-promo.
+        // =====================================================================
+        $autoPromoResult   = self::applyAutoPromotions($pdo, $tenantId, $subtotalGrosze, $linesRaw);
+        $autoDiscountGrosze = (int)$autoPromoResult['discount_grosze'];
+        $appliedAutoPromos  = $autoPromoResult['applied'];
+
+        // =====================================================================
+        // 6. PROMO / DISCOUNT ENGINE (kod r─Öczny ÔÇö sh_promo_codes, legacy)
         // =====================================================================
         $discountGrosze    = 0;
         $appliedDiscount   = null;
         $appliedPromoCode  = null;
         $promoCode         = trim($input['promo_code'] ?? '');
 
+        // Subtotal ÔÇ×po" auto-promocji dla oceny progu kodu (min_order_value)
+        $subtotalForCode = max(0, $subtotalGrosze - $autoDiscountGrosze);
+
         if ($promoCode !== '') {
             $stmtPromo = $pdo->prepare(
                 "SELECT code, type, value, min_order_value, max_uses, current_uses,
@@ -401,7 +747,7 @@ class CartEngine
                 $isValid = $now >= $promo['valid_from']
                         && $now <= $promo['valid_to']
                         && (int)$promo['current_uses'] < (int)$promo['max_uses']
-                        && $subtotalGrosze >= $minOrderGrosze
+                        && $subtotalForCode >= $minOrderGrosze
                         && in_array($channel, $allowedList, true);
 
                 if ($isValid) {
@@ -409,32 +755,36 @@ class CartEngine
                     $value = (float)$promo['value'];
 
                     if ($type === 'percentage') {
-                        $discountGrosze = (int)round(($subtotalGrosze * $value) / 100);
+                        $discountGrosze = (int)round(($subtotalForCode * $value) / 100);
                     } elseif ($type === 'fixed_amount') {
                         $discountGrosze = (int)($value * 100);
                     }
 
-                    $discountGrosze = min($discountGrosze, $subtotalGrosze);
+                    $discountGrosze = min($discountGrosze, $subtotalForCode);
 
                     if ($discountGrosze > 0) {
                         $appliedPromoCode = $promo['code'];
                         $appliedDiscount  = [
                             'code'            => $promo['code'],
                             'type'            => $type,
-                            'subtotal_before' => $fmtMoney($subtotalGrosze),
+                            'subtotal_before' => $fmtMoney($subtotalForCode),
                             'discount_amount' => $fmtMoney($discountGrosze),
-                            'subtotal_after'  => $fmtMoney($subtotalGrosze - $discountGrosze),
+                            'subtotal_after'  => $fmtMoney($subtotalForCode - $discountGrosze),
                         ];
                     }
                 }
             }
         }
 
+        // ┼ü─ůczny rabat = auto-promocje + kod r─Öczny
+        $totalDiscountGrosze = $autoDiscountGrosze + $discountGrosze;
+        $totalDiscountGrosze = min($totalDiscountGrosze, $subtotalGrosze);
+
         // =====================================================================
         // 7. ORDER TOTALS
         // =====================================================================
         $deliveryFeeGrosze = 0;
-        $grandTotalGrosze  = $subtotalGrosze - $discountGrosze + $deliveryFeeGrosze;
+        $grandTotalGrosze  = $subtotalGrosze - $totalDiscountGrosze + $deliveryFeeGrosze;
         $loyaltyPoints     = (int)floor($grandTotalGrosze / 10);
 
         $vatSummary = [];
@@ -456,7 +806,7 @@ class CartEngine
             'order_type'   => $orderType,
             'lines'        => $resultLines,
             'subtotal'     => $fmtMoney($subtotalGrosze),
-            'discount'     => $fmtMoney($discountGrosze),
+            'discount'     => $fmtMoney($totalDiscountGrosze),
             'delivery_fee' => $fmtMoney($deliveryFeeGrosze),
             'grand_total'  => $fmtMoney($grandTotalGrosze),
             'vat_summary'  => $vatSummary,
@@ -466,17 +816,35 @@ class CartEngine
             $responseData['applied_discount'] = $appliedDiscount;
         }
 
+        // Auto-promocje ÔÇö format czytelny dla klienta (grosze Ôćĺ string "z┼é.gr")
+        if (!empty($appliedAutoPromos)) {
+            $responseData['applied_auto_promotions'] = array_map(fn($p) => [
+                'promotionId' => $p['promotion_id'],
+                'asciiKey'    => $p['ascii_key'],
+                'name'        => $p['name'],
+                'ruleKind'    => $p['rule_kind'],
+                'badgeText'   => $p['badge_text'],
+                'badgeStyle'  => $p['badge_style'],
+                'discount'    => $fmtMoney($p['discount_grosze']),
+                'note'        => $p['note'],
+            ], $appliedAutoPromos);
+            $responseData['auto_promotion_discount'] = $fmtMoney($autoDiscountGrosze);
+        }
+
         return [
-            'channel'            => $channel,
-            'order_type'         => $orderType,
-            'subtotal_grosze'    => $subtotalGrosze,
-            'discount_grosze'    => $discountGrosze,
-            'delivery_fee_grosze'=> $deliveryFeeGrosze,
-            'grand_total_grosze' => $grandTotalGrosze,
-            'loyalty_points'     => $loyaltyPoints,
-            'applied_promo_code' => $appliedPromoCode,
-            'lines_raw'          => $linesRaw,
-            'response'           => $responseData,
+            'channel'                  => $channel,
+            'order_type'               => $orderType,
+            'subtotal_grosze'          => $subtotalGrosze,
+            'discount_grosze'          => $totalDiscountGrosze,
+            'auto_discount_grosze'     => $autoDiscountGrosze,
+            'code_discount_grosze'     => $discountGrosze,
+            'delivery_fee_grosze'      => $deliveryFeeGrosze,
+            'grand_total_grosze'       => $grandTotalGrosze,
+            'loyalty_points'           => $loyaltyPoints,
+            'applied_promo_code'       => $appliedPromoCode,
+            'applied_auto_promotions'  => $appliedAutoPromos,
+            'lines_raw'                => $linesRaw,
+            'response'                 => $responseData,
         ];
     }
 }
diff --git a/api/orders/checkout.php b/api/orders/checkout.php
index 5437103..01210f8 100644
--- a/api/orders/checkout.php
+++ b/api/orders/checkout.php
@@ -1,22 +1,5 @@
 <?php
-// =============================================================================
-// SliceHub Enterprise ÔÇö Order Checkout (Finalization) Endpoint
-// POST /api/orders/checkout.php
-//
-// Receives the same cart payload as calculate.php, but instead of previewing,
-// it PERSISTS the order inside a strict database transaction.
-//
-// Flow:
-//   1. Recalculate via CartEngine (never trust client prices)
-//   2. Begin transaction
-//   3. Generate atomic order number via sh_order_sequences
-//   4. Insert sh_orders, sh_order_lines, sh_order_audit
-//   5. Increment promo uses (state mutation only here, never in calculate)
-//   6. Commit
-//
-// Schema: sh_orders, sh_order_lines, sh_order_sequences,
-//         sh_order_audit, sh_promo_codes
-// =============================================================================
+declare(strict_types=1);
 
 header('Content-Type: application/json; charset=utf-8');
 header('Access-Control-Allow-Origin: *');
@@ -34,61 +17,118 @@ if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
     exit;
 }
 
+$respond = static function (bool $ok, $data = null, ?string $message = null, int $status = 200): void {
+    http_response_code($status);
+    echo json_encode(['success' => $ok, 'data' => $data, 'message' => $message], JSON_UNESCAPED_UNICODE);
+    exit;
+};
+
 try {
     require_once __DIR__ . '/../../core/db_config.php';
     require_once __DIR__ . '/../../core/auth_guard.php';
     require_once __DIR__ . '/../cart/CartEngine.php';
+    require_once __DIR__ . '/../../core/WzEngine.php';
 
     if (!isset($pdo)) {
         throw new RuntimeException('Database connection unavailable.');
     }
 
-    // =========================================================================
-    // 1. PARSE INPUT
-    // =========================================================================
-    $raw   = file_get_contents('php://input');
-    $input = json_decode($raw, true);
-
+    $raw = file_get_contents('php://input');
+    $input = json_decode($raw ?: '{}', true);
     if (!is_array($input)) {
-        http_response_code(400);
-        echo json_encode(['success' => false, 'message' => 'Invalid JSON payload.']);
-        exit;
+        $respond(false, null, 'Invalid JSON payload.', 400);
     }
 
-    $source = trim($input['source'] ?? 'POS');
+    $source = strtoupper(trim((string)($input['source'] ?? 'POS')));
+    $customerName = isset($input['customer_name']) ? trim((string)$input['customer_name']) : null;
+    $customerPhone = isset($input['customer_phone']) ? trim((string)$input['customer_phone']) : null;
+    $deliveryAddress = isset($input['delivery_address']) ? trim((string)$input['delivery_address']) : null;
+    $promisedTime = isset($input['requested_time']) ? trim((string)$input['requested_time']) : null;
+    $warehouseId = trim((string)($input['warehouse_id'] ?? 'MAIN')) ?: 'MAIN';
+    $lockToken = trim((string)($input['lock_token'] ?? ''));
+
+    $hasCheckoutLocks = false;
+    $hasOrdersTracking = false;
+    try { $pdo->query('SELECT 1 FROM sh_checkout_locks LIMIT 0'); $hasCheckoutLocks = true; } catch (Throwable $e) {}
+    try { $pdo->query('SELECT tracking_token FROM sh_orders LIMIT 0'); $hasOrdersTracking = true; } catch (Throwable $e) {}
 
-    // =========================================================================
-    // 2. SECURE RECALCULATION (single source of truth)
-    // =========================================================================
     $calc = CartEngine::calculate($pdo, $tenant_id, $input);
 
-    // =========================================================================
-    // 3. HELPERS
-    // =========================================================================
-    $generateUuidV4 = function (): string {
-        $data    = random_bytes(16);
+    $generateUuidV4 = static function (): string {
+        $data = random_bytes(16);
         $data[6] = chr((ord($data[6]) & 0x0f) | 0x40);
         $data[8] = chr((ord($data[8]) & 0x3f) | 0x80);
         return vsprintf('%s%s-%s-%s-%s-%s%s%s', str_split(bin2hex($data), 4));
     };
 
+    $fmtMoney = static fn(int $g): string => number_format($g / 100, 2, '.', '');
     $prefixMap = [
         'POS'        => 'ORD',
-        'Takeaway'   => 'ORD',
-        'Delivery'   => 'ORD',
+        'TAKEAWAY'   => 'ORD',
+        'DELIVERY'   => 'ORD',
         'WWW'        => 'WWW',
+        'ONLINE'     => 'WWW',
         'KIOSK'      => 'KIO',
         'AGGREGATOR' => 'AGG',
     ];
     $prefix = $prefixMap[$source] ?? 'ORD';
 
-    // =========================================================================
-    // 4. ATOMIC TRANSACTION
-    // =========================================================================
-    $pdo->beginTransaction();
+    if ($source === 'ONLINE') {
+        if (!$hasCheckoutLocks) {
+            $respond(false, null, 'Checkout idempotency unavailable (missing migration 017).', 400);
+        }
+        if (!$hasOrdersTracking) {
+            $respond(false, null, 'Guest tracking unavailable (tracking_token missing).', 400);
+        }
+        if ($lockToken === '' || !preg_match('/^[a-f0-9\-]{36}$/i', $lockToken)) {
+            $respond(false, null, 'Invalid lock_token.', 400);
+        }
+
+        $stmtLock = $pdo->prepare(
+            "SELECT cart_hash, grand_total_grosze, expires_at, consumed_at
+             FROM sh_checkout_locks
+             WHERE lock_token = :tok AND tenant_id = :tid
+             LIMIT 1"
+        );
+        $stmtLock->execute([':tok' => $lockToken, ':tid' => $tenant_id]);
+        $lock = $stmtLock->fetch(PDO::FETCH_ASSOC);
+        if (!$lock) {
+            $respond(false, null, 'lock_token not found or expired.', 400);
+        }
+        if (!empty($lock['consumed_at'])) {
+            $respond(false, null, 'This checkout token has already been consumed.', 409);
+        }
+        if (strtotime((string)$lock['expires_at']) < time()) {
+            $respond(false, null, 'Checkout token expired.', 409);
+        }
+
+        $canonical = json_encode([
+            'channel'    => $input['channel'] ?? null,
+            'order_type' => $input['order_type'] ?? null,
+            'lines'      => $input['lines'] ?? [],
+            'promo_code' => $input['promo_code'] ?? '',
+        ], JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
+        $cartHash = hash('sha256', (string)$canonical);
+        if ($cartHash !== (string)$lock['cart_hash']) {
+            $respond(false, null, 'Cart changed after init_checkout.', 409);
+        }
+        if ((int)$lock['grand_total_grosze'] !== (int)$calc['grand_total_grosze']) {
+            $respond(false, null, 'Cart total changed after init_checkout.', 409);
+        }
+    }
 
+    $availability = WzEngine::checkAvailability($pdo, $tenant_id, $warehouseId, $calc['lines_raw'] ?? []);
+    if (($availability['success'] ?? false) && ($availability['available'] ?? true) === false) {
+        $respond(false, [
+            'warehouse_id' => $availability['warehouse_id'] ?? $warehouseId,
+            'shortages'    => $availability['shortages'] ?? [],
+        ], 'Insufficient warehouse stock for checkout.', 409);
+    }
+
+    $trackingToken = ($source === 'ONLINE' && $hasOrdersTracking) ? bin2hex(random_bytes(8)) : null;
+
+    $pdo->beginTransaction();
     try {
-        // ÔÇö 4a. Atomic sequence number ÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇö
         $stmtSeq = $pdo->prepare(
             "INSERT INTO sh_order_sequences (tenant_id, date, seq)
              VALUES (:tid, CURDATE(), 1)
@@ -98,10 +138,9 @@ try {
         $seq = (int)$pdo->lastInsertId();
 
         $orderNumber = sprintf('%s/%s/%04d', $prefix, date('Ymd'), $seq);
-        $orderId     = $generateUuidV4();
-        $now         = date('Y-m-d H:i:s');
+        $orderId = $generateUuidV4();
+        $now = date('Y-m-d H:i:s');
 
-        // ÔÇö 4b. Promo code state mutation ÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇö
         if ($calc['applied_promo_code'] !== null) {
             $stmtPromoInc = $pdo->prepare(
                 "UPDATE sh_promo_codes
@@ -114,41 +153,50 @@ try {
             ]);
         }
 
-        // ÔÇö 4c. Insert order header ÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇö
         $stmtOrder = $pdo->prepare(
             "INSERT INTO sh_orders
                 (id, tenant_id, order_number, channel, order_type, source,
                  subtotal, discount_amount, delivery_fee, grand_total,
-                 status, loyalty_points_earned, created_at)
+                 status, payment_status, loyalty_points_earned,
+                 customer_name, customer_phone, tracking_token, delivery_address,
+                 promised_time, user_id, created_at)
              VALUES
                 (:id, :tid, :num, :channel, :order_type, :source,
                  :subtotal, :discount, :delivery, :grand,
-                 'new', :points, :now)"
+                 'new', 'to_pay', :points,
+                 :cust_name, :cust_phone, :tracking_token, :del_addr,
+                 :promised, :uid, :now)"
         );
         $stmtOrder->execute([
-            ':id'         => $orderId,
-            ':tid'        => $tenant_id,
-            ':num'        => $orderNumber,
-            ':channel'    => $calc['channel'],
-            ':order_type' => $calc['order_type'],
-            ':source'     => $source,
-            ':subtotal'   => $calc['subtotal_grosze'],
-            ':discount'   => $calc['discount_grosze'],
-            ':delivery'   => $calc['delivery_fee_grosze'],
-            ':grand'      => $calc['grand_total_grosze'],
-            ':points'     => $calc['loyalty_points'],
-            ':now'        => $now,
+            ':id'             => $orderId,
+            ':tid'            => $tenant_id,
+            ':num'            => $orderNumber,
+            ':channel'        => $calc['channel'],
+            ':order_type'     => $calc['order_type'],
+            ':source'         => $source,
+            ':subtotal'       => $calc['subtotal_grosze'],
+            ':discount'       => $calc['discount_grosze'],
+            ':delivery'       => $calc['delivery_fee_grosze'],
+            ':grand'          => $calc['grand_total_grosze'],
+            ':points'         => $calc['loyalty_points'],
+            ':cust_name'      => $customerName,
+            ':cust_phone'     => $customerPhone,
+            ':tracking_token' => $trackingToken,
+            ':del_addr'       => $deliveryAddress,
+            ':promised'       => $promisedTime !== '' ? $promisedTime : null,
+            ':uid'            => $user_id,
+            ':now'            => $now,
         ]);
 
-        // ÔÇö 4d. Insert order lines ÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇö
         $stmtLine = $pdo->prepare(
             "INSERT INTO sh_order_lines
                 (id, order_id, item_sku, snapshot_name, unit_price,
-                 quantity, line_total, vat_rate, vat_amount)
+                 quantity, line_total, vat_rate, vat_amount,
+                 modifiers_json, removed_ingredients_json, comment)
              VALUES
-                (:id, :oid, :sku, :name, :unit, :qty, :total, :vat_rate, :vat_amt)"
+                (:id, :oid, :sku, :name, :unit, :qty, :total, :vat_rate, :vat_amt,
+                 :mods, :removed, :comment)"
         );
-
         foreach ($calc['lines_raw'] as $lr) {
             $stmtLine->execute([
                 ':id'       => $generateUuidV4(),
@@ -160,52 +208,74 @@ try {
                 ':total'    => $lr['line_total_grosze'],
                 ':vat_rate' => $lr['vat_rate'],
                 ':vat_amt'  => $lr['vat_amount_grosze'],
+                ':mods'     => $lr['modifiers_json'],
+                ':removed'  => $lr['removed_ingredients_json'],
+                ':comment'  => $lr['comment'],
             ]);
         }
 
-        // ÔÇö 4e. Audit trail ÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇö
         $stmtAudit = $pdo->prepare(
-            "INSERT INTO sh_order_audit (order_id, new_status, timestamp)
-             VALUES (:oid, 'new', :now)"
+            "INSERT INTO sh_order_audit (order_id, user_id, old_status, new_status, timestamp)
+             VALUES (:oid, :uid, NULL, 'new', :now)"
         );
-        $stmtAudit->execute([':oid' => $orderId, ':now' => $now]);
+        $stmtAudit->execute([':oid' => $orderId, ':uid' => $user_id, ':now' => $now]);
 
-        // ÔÇö 4f. COMMIT ÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇöÔÇö
-        $pdo->commit();
+        if ($source === 'ONLINE' && $lockToken !== '' && $hasCheckoutLocks) {
+            $stmtConsume = $pdo->prepare(
+                "UPDATE sh_checkout_locks
+                 SET consumed_at = NOW(), consumed_order_id = :oid
+                 WHERE lock_token = :tok AND tenant_id = :tid"
+            );
+            $stmtConsume->execute([':oid' => $orderId, ':tok' => $lockToken, ':tid' => $tenant_id]);
+        }
 
+        $pdo->commit();
     } catch (Throwable $txErr) {
-        $pdo->rollBack();
+        if ($pdo->inTransaction()) {
+            $pdo->rollBack();
+        }
         throw $txErr;
     }
 
-    // =========================================================================
-    // 5. SUCCESS RESPONSE
-    // =========================================================================
-    $fmtMoney = fn(int $g): string => number_format($g / 100, 2, '.', '');
-
-    echo json_encode([
-        'success' => true,
-        'data'    => [
-            'order_id'              => $orderId,
-            'order_number'          => $orderNumber,
-            'status'                => 'new',
-            'grand_total'           => $fmtMoney($calc['grand_total_grosze']),
-            'loyalty_points_earned' => $calc['loyalty_points'],
-            'cart'                  => $calc['response'],
-        ],
-    ]);
+    // Publish order.created dla ONLINE (symetria z guest_checkout w api/online/engine.php)
+    if ($source === 'ONLINE') {
+        try {
+            require_once __DIR__ . '/../../core/OrderEventPublisher.php';
+            OrderEventPublisher::publishOrderLifecycle(
+                $pdo, $tenant_id, 'order.created', $orderId,
+                [
+                    'channel'       => $calc['channel'],
+                    'order_type'    => $calc['order_type'],
+                    'payment_method' => $calc['payment_method'] ?? null,
+                    'tracking_token' => $trackingToken,
+                ],
+                ['source' => 'online', 'actorType' => 'guest', 'actorId' => $orderId]
+            );
+        } catch (Throwable $pubErr) {
+            error_log('[Checkout] OrderEventPublisher failed: ' . $pubErr->getMessage());
+        }
+    }
+
+    $response = [
+        'order_id'              => $orderId,
+        'order_number'          => $orderNumber,
+        'status'                => 'new',
+        'grand_total'           => $fmtMoney((int)$calc['grand_total_grosze']),
+        'loyalty_points_earned' => $calc['loyalty_points'],
+        'cart'                  => $calc['response'],
+    ];
+    if ($trackingToken !== null) {
+        $response['tracking_token'] = $trackingToken;
+        $response['source'] = 'ONLINE';
+    }
 
+    $respond(true, $response, 'OK');
 } catch (CartEngineException $e) {
-    http_response_code(400);
-    echo json_encode(['success' => false, 'message' => $e->getMessage()]);
+    $respond(false, null, $e->getMessage(), 400);
 } catch (PDOException $e) {
-    http_response_code(500);
-    echo json_encode(['success' => false, 'message' => 'Database error. Please try again later.']);
     error_log('[Checkout] PDOException: ' . $e->getMessage());
+    $respond(false, null, 'Database error. Please try again later.', 500);
 } catch (Throwable $e) {
-    http_response_code(500);
-    echo json_encode(['success' => false, 'message' => 'Internal server error.']);
     error_log('[Checkout] ' . $e->getMessage());
+    $respond(false, null, 'Internal server error.', 500);
 }
-
-exit;
diff --git a/core/auth_guard.php b/core/auth_guard.php
index e7feefd..890405c 100644
--- a/core/auth_guard.php
+++ b/core/auth_guard.php
@@ -21,19 +21,59 @@ if (session_status() === PHP_SESSION_NONE) {
     session_start();
 }
 
-// =============================================================================
-// !! DEVELOPMENT MOCK ÔÇö REMOVE BEFORE PRODUCTION !!
-// Provides a fallback session so endpoints work before the login UI is wired.
-// =============================================================================
-$_SESSION['tenant_id'] = $_SESSION['tenant_id'] = 1;
-$_SESSION['user_id']   = $_SESSION['user_id'] = 2;
-// =============================================================================
+// JWT takes precedence over session ÔÇö critical for multi-tab scenarios where
+// Dispatcher (manager session) and Driver App (driver JWT) share the same browser.
+$authHeader = $_SERVER['HTTP_AUTHORIZATION']
+    ?? $_SERVER['REDIRECT_HTTP_AUTHORIZATION']
+    ?? '';
+
+if ($authHeader === '' && function_exists('apache_request_headers')) {
+    $apacheHeaders = apache_request_headers();
+    $authHeader = $apacheHeaders['Authorization'] ?? $apacheHeaders['authorization'] ?? '';
+}
+
+$_authFromJwt = false;
+
+if ($authHeader !== '') {
+    $token = $authHeader;
+    if (str_starts_with($token, 'Bearer ')) {
+        $token = substr($token, 7);
+    }
+    $token = trim($token);
+
+    if ($token !== '') {
+        try {
+            require_once __DIR__ . '/JwtProvider.php';
+            $payload = JwtProvider::decode($token, JWT_SECRET);
+
+            $tid = (int)($payload['tenant_id'] ?? 0);
+            $uid = (int)($payload['user_id'] ?? 0);
+
+            if ($tid <= 0 || $uid <= 0) {
+                throw new \Exception('Invalid token payload');
+            }
+
+            $_SESSION['tenant_id'] = $tid;
+            $_SESSION['user_id']   = $uid;
+            $_authFromJwt = true;
+        } catch (\Throwable $e) {
+            header('Content-Type: application/json; charset=utf-8');
+            http_response_code(401);
+            die(json_encode([
+                'success' => false,
+                'message' => 'Invalid or expired token.',
+                'data'    => null,
+            ]));
+        }
+    }
+}
 
-if (empty($_SESSION['user_id']) || empty($_SESSION['tenant_id'])) {
+if (!$_authFromJwt && (empty($_SESSION['user_id']) || empty($_SESSION['tenant_id']))) {
     header('Content-Type: application/json; charset=utf-8');
+    http_response_code(401);
     die(json_encode([
         'success' => false,
-        'message' => 'Unauthorized access. Session expired or invalid.',
+        'message' => 'Unauthorized access. No token provided.',
         'data'    => null,
     ]));
 }
diff --git a/core/db_config.php b/core/db_config.php
index b71f32f..4e262e2 100644
--- a/core/db_config.php
+++ b/core/db_config.php
@@ -1,5 +1,17 @@
 <?php
+
+declare(strict_types=1);
+
 // [PLIK: /db_config.php]
+// JWT: set environment variable JWT_SECRET to a long random string (no default / no fallback).
+if (!defined('JWT_SECRET')) {
+    $jwtSecret = getenv('JWT_SECRET');
+    if (!is_string($jwtSecret) || $jwtSecret === '') {
+        $jwtSecret = 'dev_localhost_secret_change_in_production';
+    }
+    define('JWT_SECRET', $jwtSecret);
+}
+
 $host = 'localhost';
 $db = 'slicehub_pro_v2';
 $user = 'root';
@@ -9,6 +21,7 @@ try {
     $pdo = new PDO("mysql:host=$host;dbname=$db;charset=utf8mb4", $user, $pass);
     $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
 } catch (PDOException $e) {
-    die(json_encode(["status" => "error", "message" => "B┼é─ůd krytyczny po┼é─ůczenia z baz─ů: " . $e->getMessage()]));
+    http_response_code(500);
+    error_log('[DB Config] Connection error: ' . $e->getMessage());
+    die(json_encode(['success' => false, 'message' => 'Database connection error.', 'data' => null]));
 }
-?>
\ No newline at end of file
diff --git a/core/js/api_client.js b/core/js/api_client.js
index b2c8512..12f5433 100644
--- a/core/js/api_client.js
+++ b/core/js/api_client.js
@@ -20,9 +20,16 @@
      */
     async function request(endpoint, options = {}) {
         try {
+            const headers = { 'Content-Type': 'application/json' };
+
+            const token = localStorage.getItem('sh_token');
+            if (token) {
+                headers['Authorization'] = 'Bearer ' + token;
+            }
+
             const fetchOptions = {
                 method:  options.method || 'GET',
-                headers: { 'Content-Type': 'application/json' },
+                headers,
             };
 
             if (options.body !== undefined) {
@@ -30,9 +37,17 @@
             }
 
             const response = await fetch(endpoint, fetchOptions);
-            const json     = await response.json();
 
-            // Normalizacja ÔÇö zapewnij, ┼╝e zwracany obiekt zawsze ma klucze protoko┼éu V4
+            if (response.status === 401) {
+                console.warn('[ApiClient] 401 ÔÇö token expired or invalid. Redirecting to login.');
+                localStorage.removeItem('sh_token');
+                const loginPath = window.location.pathname.replace(/modules\/.*$/, '') + 'login.html';
+                window.location.href = loginPath;
+                return { success: false, message: 'Sesja wygasła. Przekierowanie do logowania...', data: null };
+            }
+
+            const json = await response.json();
+
             return {
                 success: json.success === true,
                 message: json.message ?? '',
diff --git a/core/js/core_validator.js b/core/js/core_validator.js
index 49c5148..b182ddd 100644
--- a/core/js/core_validator.js
+++ b/core/js/core_validator.js
@@ -1,84 +1,147 @@
 /**
- * ­čŤí´ŞĆ SLICEHUB CORE VALIDATOR v1.0 (Ultimate)
- * Cel: Jedno ┼║r├│d┼éo prawdy dla konwersji jednostek i czysto┼Ťci danych (ASCII).
+ * SliceHub ÔÇö SliceValidator (globalny walidator / konwerter jednostek).
+ * Załaduj przed warehouse_*.js / studio_*.js.
  */
+(function () {
+    'use strict';
 
-const SliceValidator = {
-    // 1. Twardy słownik jednostek bazowych
-    units: {
-        'kg':  { type: 'weight', ratio: 1,      label: 'Kilogram' },
-        'g':   { type: 'weight', ratio: 0.001,  label: 'Gram' },
-        'l':   { type: 'volume', ratio: 1,      label: 'Litr' },
-        'ml':  { type: 'volume', ratio: 0.001,  label: 'Mililitr' },
-        'szt': { type: 'count',  ratio: 1,      label: 'Sztuka' },
-        'por': { type: 'count',  ratio: 1,      label: 'Porcja' },
-        'opak':{ type: 'count',  ratio: 1,      label: 'Opakowanie' } // Gotowe pod KSeF
-    },
-
-    // 2. Stra┼╝nik ASCII - Zamienia "M─ůka pszenna" na "MAKA_PSZENNA" do cel├│w technicznych
-    sanitizeKey: function(str) {
-        if (typeof str !== 'string') return '';
-        return str.normalize("NFD")
-                  .replace(/[\u0300-\u036f]/g, "") // Usuwanie polskich znak├│w (diakrytyk├│w)
-                  .replace(/\s+/g, '_')            // Spacje na podkre┼Ťlenia
-                  .replace(/[^a-zA-Z0-9_]/g, '')   // Usuwanie znak├│w specjalnych
-                  .toUpperCase();
-    },
-
-    // 3. Inteligentny Konwerter Jednostek
-    convert: function(value, fromUnit, toUnit) {
-        const val = parseFloat(value.toString().replace(',', '.'));
-        if (isNaN(val) || val < 0) return { error: 'Nieprawid┼éowa warto┼Ť─ç liczbowa.' };
-
-        const unitFrom = this.units[fromUnit.toLowerCase()];
-        const unitTo   = this.units[toUnit.toLowerCase()];
-
-        // Flaga do Szybkiej Naprawy (Inline Fix) je┼Ťli jednostki nie ma w s┼éowniku
-        if (!unitFrom || !unitTo) {
-            return { 
-                needsFix: true, 
-                msg: `Brak przelicznika dla: ${!unitFrom ? fromUnit : toUnit}`,
-                originalValue: val 
-            };
+    const UNITS_CANON = {
+        kg:   { base: 'kg', factor: 1 },
+        g:    { base: 'kg', factor: 0.001 },
+        dag:  { base: 'kg', factor: 0.01 },
+        l:    { base: 'l',  factor: 1 },
+        ml:   { base: 'l',  factor: 0.001 },
+        szt:  { base: 'szt', factor: 1 },
+        pcs:  { base: 'szt', factor: 1 },
+        op:   { base: 'op',  factor: 1 },
+    };
+
+    function sanitizeKey(value) {
+        return String(value || '')
+            .normalize('NFD').replace(/[\u0300-\u036f]/g, '')
+            .replace(/\s+/g, '_')
+            .replace(/[^A-Za-z0-9_/-]/g, '')
+            .toUpperCase();
+    }
+
+    function standardizeUnit(qty, fromUnit) {
+        const from = String(fromUnit || '').toLowerCase().trim();
+        const map = UNITS_CANON[from];
+        if (!map) return { value: qty, unit: from };
+        return { value: qty * map.factor, unit: map.base };
+    }
+
+    function convertUnit(qty, fromUnit, toUnit) {
+        const from = String(fromUnit || '').toLowerCase().trim();
+        const to   = String(toUnit || '').toLowerCase().trim();
+        const fMap = UNITS_CANON[from];
+        const tMap = UNITS_CANON[to];
+        if (!fMap || !tMap || fMap.base !== tMap.base) return null;
+        return (qty * fMap.factor) / tMap.factor;
+    }
+
+    function validatePrice(val) {
+        const n = parseFloat(val);
+        return Number.isFinite(n) && n >= 0 ? n : null;
+    }
+
+    function generateSku(name) {
+        return sanitizeKey(name).replace(/-/g, '_').slice(0, 32);
+    }
+
+    function escapeHtml(s) {
+        const d = document.createElement('div');
+        d.textContent = s == null ? '' : String(s);
+        return d.innerHTML;
+    }
+
+    /**
+     * Safe numeric parser ÔÇö handles comma decimals, empty strings, NaN.
+     * Returns a finite number or null.
+     */
+    function safeParse(raw) {
+        if (raw == null || raw === '') return null;
+        const n = parseFloat(String(raw).replace(',', '.'));
+        return Number.isFinite(n) ? n : null;
+    }
+
+    /**
+     * convert(qty, fromUnit, toUnit)
+     *
+     * High-level unit converter used by recipe / food-cost UI.
+     * Parses user input defensively (commaÔćĺdot, NaN guard), converts via
+     * UNITS_CANON, and returns a structured result safe for downstream math.
+     *
+     * @returns {{ success: boolean, value: number, msg?: string }}
+     */
+    function convert(qty, fromUnit, toUnit) {
+        const parsed = safeParse(qty);
+        if (parsed === null) {
+            return { success: false, value: 0, msg: `Nieprawid┼éowa warto┼Ť─ç liczbowa: "${qty}"` };
         }
 
-        // Blokada mieszania typ├│w (np. waga na sztuki) bez dodatkowego przelicznika
-        if (unitFrom.type !== unitTo.type) {
-            return { 
-                error: 'Konflikt typ├│w', 
-                msg: `Nie mo┼╝na bezpo┼Ťrednio przeliczy─ç ${unitFrom.type} na ${unitTo.type}. Wymagany przelicznik dedykowany.` 
-            };
+        const from = String(fromUnit || '').toLowerCase().trim();
+        const to   = String(toUnit   || '').toLowerCase().trim();
+
+        if (from === to) {
+            return { success: true, value: parsed };
         }
 
-        // Operacja matematyczna sprowadzaj─ůca do bazy
-        const baseValue = val * unitFrom.ratio;
-        const finalValue = baseValue / unitTo.ratio;
-
-        return { 
-            success: true, 
-            value: finalValue, 
-            baseValue: baseValue,
-            formatted: `${finalValue.toFixed(3)} ${toUnit}`
-        };
-    },
-
-    // 4. Moduł Receptur (Strażnik do studio_recipe.js)
-    validateRecipeRow: function(qty, userUnit, stockUnit) {
-        const result = this.convert(qty, userUnit, stockUnit);
-        
-        if (result.needsFix) {
-            console.warn("­čÜĘ [Core Validator] Wykryto nieznan─ů jednostk─Ö. Gotowo┼Ť─ç do wywo┼éania Inline Fix.");
-            return { status: 'fix_required', data: result };
+        const fMap = UNITS_CANON[from];
+        const tMap = UNITS_CANON[to];
+
+        if (!fMap || !tMap) {
+            const unknown = !fMap ? from : to;
+            return { success: false, value: 0, msg: `Nieznana jednostka: "${unknown}"` };
         }
 
-        if (result.error) {
-            console.error("­čÜĘ [Core Validator] B┼é─ůd krytyczny: ", result.msg);
-            return { status: 'error', msg: result.msg };
+        if (fMap.base !== tMap.base) {
+            return { success: false, value: 0, msg: `Niezgodne grupy jednostek: "${from}" (${fMap.base}) Ôćĺ "${to}" (${tMap.base})` };
+        }
+
+        const result = (parsed * fMap.factor) / tMap.factor;
+        return { success: true, value: result };
+    }
+
+    /**
+     * validateRecipeRow(qty, usageUnit, baseUnit)
+     *
+     * Pre-flight check before adding / updating a recipe ingredient row.
+     * Verifies that usageUnit can be converted to baseUnit.
+     *
+     * @returns {{ status: 'ok'|'error', msg?: string }}
+     */
+    function validateRecipeRow(qty, usageUnit, baseUnit) {
+        const parsed = safeParse(qty);
+        if (parsed === null || parsed < 0) {
+            return { status: 'error', msg: `Nieprawid┼éowa ilo┼Ť─ç: "${qty}"` };
+        }
+
+        const from = String(usageUnit || '').toLowerCase().trim();
+        const to   = String(baseUnit  || '').toLowerCase().trim();
+
+        if (from === to) return { status: 'ok' };
+
+        const fMap = UNITS_CANON[from];
+        const tMap = UNITS_CANON[to];
+
+        if (!fMap || !tMap || fMap.base !== tMap.base) {
+            return { status: 'error', msg: `Niezgodno┼Ť─ç jednostek: "${from}" Ôćĺ "${to}"` };
         }
 
-        return { status: 'ok', value: result.value };
+        return { status: 'ok' };
     }
-};
 
-// Zabezpieczenie przed nadpisaniem logiki przez inne skrypty
-Object.freeze(SliceValidator);
\ No newline at end of file
+    window.SliceValidator = Object.freeze({
+        UNITS_CANON,
+        sanitizeKey,
+        standardizeUnit,
+        convertUnit,
+        convert,
+        validateRecipeRow,
+        safeParse,
+        validatePrice,
+        generateSku,
+        escapeHtml,
+    });
+})();
diff --git a/modules/studio/index.html b/modules/studio/index.html
index b70196d..2bf3265 100644
--- a/modules/studio/index.html
+++ b/modules/studio/index.html
@@ -2,7 +2,7 @@
 <html lang="pl">
 <head>
     <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, viewport-fit=cover">
     <title>SliceHub - Studio Menu Ultimate</title>
     
     <script src="https://cdn.tailwindcss.com"></script>
@@ -10,7 +10,8 @@
     <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css">
 
     <style>
-        body { font-family: 'Montserrat', sans-serif; background-color: #050505; color: white; user-select: none; overflow: hidden; display: flex; height: 100vh; }
+        body { font-family: 'Montserrat', sans-serif; background-color: #050505; color: white; user-select: none; -webkit-user-select: none; -webkit-tap-highlight-color: transparent; overscroll-behavior-y: none; overflow: hidden; display: flex; height: 100vh; }
+        input, textarea, select, [contenteditable] { user-select: text; -webkit-user-select: text; }
         .glass { background: rgba(255, 255, 255, 0.03); border: 1px solid rgba(255, 255, 255, 0.05); }
         .hide-scrollbar::-webkit-scrollbar { display: none; }
         
@@ -52,6 +53,10 @@
             </button>
             
             <p class="text-[8px] font-black uppercase text-slate-500 tracking-widest px-5 mb-2 mt-4">Narz─Ödzia Zwi─Ökszania Zysku</p>
+            <button onclick="window.location.href='../online_studio/index.html'" class="nav-btn w-full text-left px-5 py-3 text-[10px] font-black uppercase text-slate-400 hover:text-white transition flex items-center justify-between">
+                <div class="flex items-center gap-3"><i class="fa-solid fa-pizza-slice w-4 text-center text-orange-400"></i> Online Studio (Wizualny Kompozytor)</div>
+                <span class="bg-orange-500/10 text-orange-400 border border-orange-500/30 text-[7px] px-1.5 py-0.5 rounded">NOWY</span>
+            </button>
             <button class="nav-btn w-full text-left px-5 py-3 text-[10px] font-black uppercase text-slate-500 hover:text-slate-300 transition flex items-center justify-between">
                 <div class="flex items-center gap-3"><i class="fa-solid fa-magnet w-4 text-center"></i> Sprzeda┼╝ Sugerowana</div>
                 <span class="bg-yellow-500/10 text-yellow-500 border border-yellow-500/20 text-[7px] px-1.5 py-0.5 rounded badge-soon">WKRÓTCE</span>
@@ -62,9 +67,8 @@
             </button>
 
             <p class="text-[8px] font-black uppercase text-slate-500 tracking-widest px-5 mb-2 mt-4">Integracje i Zaplecze</p>
-            <button class="nav-btn w-full text-left px-5 py-3 text-[10px] font-black uppercase text-slate-500 hover:text-slate-300 transition flex items-center justify-between">
-                <div class="flex items-center gap-3"><i class="fa-solid fa-boxes-stacked w-4 text-center"></i> Magazyn i Food Cost</div>
-                <span class="bg-yellow-500/10 text-yellow-500 border border-yellow-500/20 text-[7px] px-1.5 py-0.5 rounded badge-soon">WKRÓTCE</span>
+            <button onclick="window.location.href='../warehouse/index.html'" class="nav-btn w-full text-left px-5 py-3 text-[10px] font-black uppercase text-slate-400 hover:text-white transition flex items-center gap-3">
+                <i class="fa-solid fa-boxes-stacked w-4 text-center"></i> Magazyn i Food Cost
             </button>
             <button class="nav-btn w-full text-left px-5 py-3 text-[10px] font-black uppercase text-slate-500 hover:text-slate-300 transition flex items-center justify-between">
                 <div class="flex items-center gap-3"><i class="fa-solid fa-cloud-arrow-up w-4 text-center"></i> Integracje (Pyszne/Uber)</div>
@@ -97,123 +101,85 @@
 
     <main class="flex-1 bg-[#050505] flex flex-col relative z-10 overflow-y-auto hide-scrollbar" id="view-container">
         
-        <div id="menu-view" class="h-full w-full p-6 animate-fade-in grid grid-cols-1 lg:grid-cols-2 gap-6 overflow-y-auto hidden">
-    
-    <div class="bg-[#0a0a0f]/60 border border-white/10 rounded-xl p-6 shadow-2xl flex flex-col gap-6">
-        <div class="border-b border-white/5 pb-3">
-            <h2 class="text-white text-lg font-black tracking-wide uppercase">Karta Dania</h2>
-            <p class="text-slate-500 text-[10px] uppercase mt-1 tracking-wider">Konfiguracja podstawowa i ksi─Ögowa</p>
-        </div>
-        
-        <form id="item-form" class="flex flex-col gap-5" onsubmit="event.preventDefault();">
-            <input type="hidden" id="item-id" value="0">
-            
-            <div class="grid grid-cols-2 gap-4">
-                <div class="flex flex-col gap-1.5">
-                    <label class="text-[10px] text-slate-400 font-bold uppercase tracking-wider">Nazwa Dania</label>
-                    <input type="text" id="item-name" class="bg-black/50 border border-white/10 text-white rounded p-3 text-sm focus:border-blue-500 focus:ring-1 focus:ring-blue-500 focus:outline-none transition" placeholder="np. Pizza Margherita">
-                </div>
-                <div class="flex flex-col gap-1.5">
-                    <label class="text-[10px] text-slate-400 font-bold uppercase tracking-wider">SKU (Klucz systemowy)</label>
-                    <input type="text" id="item-ascii-key" class="bg-black/50 border border-white/10 text-white rounded p-3 text-sm focus:border-blue-500 focus:ring-1 focus:ring-blue-500 focus:outline-none transition font-mono" placeholder="np. PIZZA_MARG">
-                </div>
-            </div>
-
-            <div class="grid grid-cols-2 gap-4">
-                <div class="flex flex-col gap-1.5">
-                    <label class="text-[10px] text-slate-400 font-bold uppercase tracking-wider">Kategoria</label>
-                    <select id="item-category-id" class="bg-black/50 border border-white/10 text-white rounded p-3 text-sm focus:border-blue-500 focus:ring-1 focus:ring-blue-500 focus:outline-none transition cursor-pointer">
-                        <option value="0">Wybierz kategori─Ö...</option>
-                    </select>
-                </div>
-                <div class="flex items-center gap-3 pt-6 pl-2">
-                    <label class="relative inline-flex items-center cursor-pointer">
-                        <input type="checkbox" id="item-is-active" class="sr-only peer" checked>
-                        <div class="w-11 h-6 bg-white/10 peer-focus:outline-none rounded-full peer peer-checked:after:translate-x-full peer-checked:after:border-white after:content-[''] after:absolute after:top-[2px] after:left-[2px] after:bg-white after:border-gray-300 after:border after:rounded-full after:h-5 after:w-5 after:transition-all peer-checked:bg-green-500 shadow-inner"></div>
-                        <span class="ml-3 text-xs font-bold text-slate-300 uppercase tracking-wide">Aktywne na POS</span>
-                    </label>
-                </div>
-            </div>
+        <div id="menu-view" class="h-full w-full animate-fade-in hidden flex flex-col overflow-hidden">
 
-            <div class="grid grid-cols-2 gap-4">
-                <div class="flex flex-col gap-1.5">
-                    <label class="text-[10px] text-slate-400 font-bold uppercase tracking-wider">Cena Brutto (PLN)</label>
-                    <input type="number" id="item-price" step="0.01" min="0" class="bg-black/50 border border-white/10 text-white rounded p-3 text-sm focus:border-blue-500 focus:ring-1 focus:ring-blue-500 focus:outline-none transition" placeholder="0.00">
-                </div>
-                <div class="flex flex-col gap-1.5">
-                    <label class="text-[10px] text-slate-400 font-bold uppercase tracking-wider">Stawka VAT</label>
-                    <select id="item-vat-rate" class="bg-black/50 border border-white/10 text-white rounded p-3 text-sm focus:border-blue-500 focus:ring-1 focus:ring-blue-500 focus:outline-none transition cursor-pointer">
-                        <option value="23">23%</option>
-                        <option value="8">8%</option>
-                        <option value="5">5%</option>
-                        <option value="0">0%</option>
-                    </select>
-                </div>
-            </div>
+    <header id="item-command-bar" class="shrink-0 bg-[#0a0a0f]/95 backdrop-blur-xl border-b border-white/10 px-6 py-3 z-40">
+        <div class="flex items-center justify-center py-1 text-slate-600">
+            <span class="text-[9px] font-black uppercase tracking-widest"><i class="fa-solid fa-satellite-dish mr-2 opacity-30"></i>Mission Control &mdash; wybierz danie z drzewa</span>
+        </div>
+    </header>
 
-            <div class="grid grid-cols-1 gap-4">
-                <div class="flex flex-col gap-1.5">
-                    <label class="text-[10px] text-slate-400 font-bold uppercase tracking-wider">Stacja Drukuj─ůca (Bony Kuchenne)</label>
-                    <select id="item-printer-station" class="bg-black/50 border border-white/10 text-white rounded p-3 text-sm focus:border-blue-500 focus:ring-1 focus:ring-blue-500 focus:outline-none transition cursor-pointer">
-                        <option value="KITCHEN_1">Kuchnia Główna (KITCHEN_1)</option>
-                        <option value="BAR">Bar (BAR)</option>
-                        <option value="NONE">Brak (Nie drukuj)</option>
-                    </select>
-                </div>
-            </div>
+    <div class="flex-1 overflow-y-auto hide-scrollbar" id="menu-view-scroll">
+        <div class="flex gap-4 px-5 pb-10">
 
-            <div class="pt-5 mt-2 border-t border-white/5">
-                <button type="button" onclick="window.ItemEditor.saveItem()" class="w-full bg-blue-600 hover:bg-blue-500 active:bg-blue-700 text-white font-black text-xs uppercase tracking-widest py-3 px-4 rounded transition shadow-[0_0_15px_rgba(37,99,235,0.3)] hover:shadow-[0_0_25px_rgba(37,99,235,0.5)]">
-                    <i class="fa-solid fa-floppy-disk mr-2"></i> Zapisz Danie
-                </button>
-            </div>
-        </form>
-    </div>
+            <nav id="item-anchor-nav" class="sticky top-2 self-start w-11 flex flex-col gap-1.5 shrink-0 pt-3 hidden"></nav>
 
-    <div class="bg-[#0a0a0f]/60 border border-white/10 rounded-xl p-6 shadow-2xl flex flex-col gap-6">
-        <div class="border-b border-white/5 pb-3">
-            <h2 class="text-white text-lg font-black tracking-wide uppercase">Bli┼║niak Cyfrowy Dania (Food Cost)</h2>
-            <p class="text-slate-500 text-[10px] uppercase mt-1 tracking-wider">Zarz─ůdzanie recepturami i zu┼╝yciem magazynowym</p>
-        </div>
-        
-        <div class="flex flex-col gap-6">
-            
-            <div class="flex flex-col gap-3 bg-black/40 p-4 rounded-lg border border-white/5">
-                <label class="text-[10px] text-slate-400 font-bold uppercase tracking-wider">Magia Food Costu (AutoScan)</label>
-                <textarea id="insp-desc" rows="3" class="bg-black/50 border border-white/10 text-white rounded p-3 text-sm focus:border-purple-500 focus:ring-1 focus:ring-purple-500 focus:outline-none transition resize-none" placeholder="Wpisz kr├│tki opis dania lub list─Ö sk┼éadnik├│w (np. m─ůka, sos pomidorowy, ser mozzarella)"></textarea>
-                <button type="button" onclick="if(window.RecipeMapper && window.RecipeMapper.autoScan) window.RecipeMapper.autoScan();" class="w-full bg-purple-600/80 hover:bg-purple-500 text-white font-bold text-xs uppercase tracking-wider py-2 px-4 rounded transition border border-purple-500/50 shadow-[0_0_10px_rgba(147,51,234,0.2)]">
-                    <i class="fa-solid fa-wand-magic-sparkles mr-2"></i> Uruchom AutoScan
-                </button>
+            <div class="flex-1 min-w-0 pt-4">
+                <form id="item-form" class="flex flex-col gap-5 pb-20" onsubmit="event.preventDefault();">
+                    <input type="hidden" id="item-id" value="0">
+                    <div class="flex flex-col items-center justify-center py-16 text-slate-600 gap-3">
+                        <i class="fa-solid fa-utensils text-2xl opacity-20"></i>
+                        <span class="text-[10px] font-black uppercase tracking-widest">Wybierz danie z drzewa menu</span>
+                    </div>
+                </form>
             </div>
 
-            <div class="flex flex-col gap-3 bg-black/40 p-4 rounded-lg border border-white/5">
-                <label class="text-[10px] text-slate-400 font-bold uppercase tracking-wider">Ręczne Dodawanie Składnika</label>
-                <div class="flex items-center gap-2">
-                    <select id="manual-ingredient-select" class="flex-1 bg-black/50 border border-white/10 text-white rounded p-2 text-sm focus:border-blue-500 focus:ring-1 focus:ring-blue-500 focus:outline-none transition cursor-pointer">
-                        <option value="">Wybierz surowiec z magazynu...</option>
-                    </select>
-                    <input type="number" id="manual-ingredient-qty" step="0.001" min="0" class="w-24 bg-black/50 border border-white/10 text-white rounded p-2 text-sm focus:border-blue-500 focus:ring-1 focus:ring-blue-500 focus:outline-none transition text-center" placeholder="Ilo┼Ť─ç">
-                    <select id="add-ingredient-unit" class="bg-black/50 border border-white/10 text-white rounded p-2 text-sm focus:border-blue-500 focus:ring-1 focus:ring-blue-500 focus:outline-none transition cursor-pointer">
-                        <option value="g" selected>g</option>
-                        <option value="ml">ml</option>
-                        <option value="kg">kg</option>
-                        <option value="l">l</option>
-                        <option value="szt">szt</option>
-                        <option value="por">por</option>
-                        <option value="opak">opak</option>
-                    </select>
-                    <button type="button" onclick="window.RecipeMapper.addManual(document.getElementById('manual-ingredient-select').value, document.getElementById('manual-ingredient-qty').value, document.getElementById('add-ingredient-unit').value)" class="bg-slate-700 hover:bg-slate-600 text-white font-bold text-xs uppercase tracking-wider py-2 px-4 rounded transition border border-slate-500/50 shrink-0">
-                        <i class="fa-solid fa-plus"></i> Dodaj
-                    </button>
+            <div id="food-cost-panel" class="w-[420px] shrink-0 pt-4 hidden">
+                <div class="sticky top-2">
+                    <div class="bg-[#0a0a0f]/60 border border-white/10 rounded-2xl p-6 shadow-2xl flex flex-col gap-6">
+                        <div class="border-b border-white/5 pb-3">
+                            <h2 class="text-white text-sm font-black tracking-wide uppercase flex items-center gap-2"><i class="fa-solid fa-dna text-purple-400"></i> Bli┼║niak Cyfrowy (Food Cost)</h2>
+                            <p class="text-slate-500 text-[9px] uppercase mt-1 tracking-wider">Receptury i zu┼╝ycie magazynowe</p>
+                        </div>
+                        <div class="flex flex-col gap-5">
+                            <div class="flex flex-col gap-3 bg-black/40 p-4 rounded-xl border border-white/5">
+                                <label class="text-[9px] text-slate-400 font-bold uppercase tracking-wider">AutoScan (Food Cost AI)</label>
+                                <textarea id="insp-desc" rows="2" class="bg-black/50 border border-white/10 text-white rounded-lg p-3 text-sm focus:border-purple-500 focus:ring-1 focus:ring-purple-500 focus:outline-none transition resize-none" placeholder="Wpisz opis lub składniki..."></textarea>
+                                <button type="button" onclick="if(window.RecipeMapper && window.RecipeMapper.autoScan) window.RecipeMapper.autoScan();" class="w-full bg-purple-600/80 hover:bg-purple-500 text-white font-bold text-[10px] uppercase tracking-wider py-2 px-4 rounded-lg transition border border-purple-500/50 shadow-[0_0_10px_rgba(147,51,234,0.2)]">
+                                    <i class="fa-solid fa-wand-magic-sparkles mr-2"></i> AutoScan
+                                </button>
+                            </div>
+                            <div class="flex flex-col gap-3 bg-black/40 p-4 rounded-xl border border-white/5">
+                                <div class="flex items-center justify-between">
+                                    <label class="text-[9px] text-slate-400 font-bold uppercase tracking-wider">Dodaj Składnik</label>
+                                    <button type="button" onclick="window.RecipeMapper.openBulkAdd()" class="text-[9px] font-black uppercase text-cyan-400 hover:text-cyan-300 px-2 py-1 rounded border border-cyan-500/30 hover:bg-cyan-900/20 transition">
+                                        <i class="fa-solid fa-layer-group mr-1"></i> Bulk Add
+                                    </button>
+                                </div>
+                                <div class="relative">
+                                    <i class="fa-solid fa-magnifying-glass absolute left-3 top-1/2 -translate-y-1/2 text-slate-600 text-[11px]"></i>
+                                    <input type="text" id="ingredient-search" autocomplete="off" placeholder="Szukaj po nazwie lub aliasie (np. 'moz' Ôćĺ Mozzarella)..."
+                                           class="w-full bg-black/50 border border-white/10 text-white rounded-lg pl-9 pr-3 py-2 text-[11px] focus:border-blue-500 focus:outline-none transition">
+                                    <div id="ingredient-search-results" class="hidden absolute top-full left-0 right-0 mt-1 bg-[#0a0a0f] border border-white/10 rounded-lg shadow-2xl max-h-72 overflow-y-auto z-50"></div>
+                                </div>
+                                <div id="ingredient-quickadd" class="hidden flex items-center gap-2 bg-black/40 p-2 rounded-lg border border-blue-500/30">
+                                    <div class="flex-1 min-w-0">
+                                        <div id="quickadd-name" class="text-[11px] font-black text-white truncate"></div>
+                                        <div id="quickadd-sku" class="text-[8px] font-mono text-slate-500 truncate"></div>
+                                    </div>
+                                    <input type="number" id="quickadd-qty" step="0.001" min="0" class="w-20 bg-black/50 border border-white/10 text-white rounded p-1.5 text-[11px] text-center focus:border-blue-500 outline-none" placeholder="100">
+                                    <select id="quickadd-unit" class="bg-black/50 border border-white/10 text-white rounded p-1.5 text-[11px] focus:border-blue-500 outline-none cursor-pointer">
+                                        <option value="g" selected>g</option><option value="ml">ml</option><option value="kg">kg</option><option value="l">l</option><option value="szt">szt</option><option value="por">por</option><option value="opak">opak</option>
+                                    </select>
+                                    <button type="button" onclick="window.RecipeMapper.confirmQuickAdd()" class="bg-green-600 hover:bg-green-500 text-white font-black text-[10px] uppercase py-1.5 px-3 rounded transition shrink-0">
+                                        <i class="fa-solid fa-plus"></i>
+                                    </button>
+                                    <button type="button" onclick="window.RecipeMapper.cancelQuickAdd()" class="bg-slate-700 hover:bg-slate-600 text-white text-[10px] py-1.5 px-2 rounded transition shrink-0">
+                                        <i class="fa-solid fa-xmark"></i>
+                                    </button>
+                                </div>
+                                <select id="manual-ingredient-select" class="hidden"><option value=""></option></select>
+                                <input type="hidden" id="manual-ingredient-qty">
+                                <input type="hidden" id="add-ingredient-unit" value="g">
+                            </div>
+                            <div id="recipe-ingredients-list" class="flex flex-col gap-2"></div>
+                        </div>
+                    </div>
+                    <div id="margin-container" class="p-4 mt-4 bg-[#0a0a0f] bg-opacity-95 backdrop-blur-md border-t border-gray-800 shadow-2xl rounded-xl transition-all duration-300"></div>
                 </div>
             </div>
 
-            <div id="recipe-ingredients-list" class="flex flex-col gap-2 mt-2">
-            </div>
-
         </div>
-
-        <div id="margin-container" class="sticky bottom-0 z-50 p-4 mt-8 bg-[#0a0a0f] bg-opacity-95 backdrop-blur-md border-t border-gray-800 shadow-2xl rounded-t-xl transition-all duration-300"></div>
     </div>
 </div>
 
@@ -233,7 +199,7 @@
             </header>
             
             <div class="p-10 max-w-4xl mx-auto w-full space-y-10 pb-32">
-                
+
                 <div class="bg-[#0a0a0f]/60 backdrop-blur-md border border-blue-500/20 p-8 rounded-3xl space-y-6 relative overflow-hidden shadow-[0_0_20px_rgba(59,130,246,0.05)] hover:border-blue-500/40 transition-colors group">
                     <div class="absolute top-0 left-0 w-1.5 h-full bg-blue-500 shadow-[0_0_10px_rgba(59,130,246,0.8)]"></div>
                     <h3 class="text-[12px] font-black uppercase text-blue-400 tracking-widest relative z-10"><i class="fa-solid fa-truck-fast mr-3"></i> Logistyka</h3>
@@ -242,53 +208,71 @@
                             <option value="">-- VAT (Ignoruj) --</option><option value="1">VAT 5%</option><option value="2">VAT 8%</option><option value="3">VAT 23%</option><option value="4">VAT 0%</option>
                         </select>
                         <select id="bulk-printer" class="w-full bg-[#050508] border border-white/10 rounded-xl p-5 text-[12px] font-bold text-white outline-none focus:border-blue-500 focus:shadow-[0_0_15px_rgba(59,130,246,0.2)] transition-all">
-                            <option value="">-- Drukarka (Ignoruj) --</option><option value="KITCHEN_1">Główna Kuchnia</option><option value="BAR">Bar Zimny</option><option value="NONE">Brak</option>
+                            <option value="">-- KDS Station (Ignoruj) --</option><option value="KITCHEN_1">Kuchnia Glowna</option><option value="BAR">Bar Zimny</option><option value="NONE">Brak</option>
+                        </select>
+                    </div>
+                </div>
+
+                <div class="bg-[#0a0a0f]/60 backdrop-blur-md border border-cyan-500/20 p-8 rounded-3xl space-y-6 relative overflow-hidden shadow-[0_0_20px_rgba(6,182,212,0.08)] hover:border-cyan-500/40 transition-colors group">
+                    <div class="absolute top-0 left-0 w-1.5 h-full bg-cyan-500 shadow-[0_0_10px_rgba(6,182,212,0.8)]"></div>
+                    <h3 class="text-[12px] font-black uppercase text-cyan-400 tracking-widest relative z-10"><i class="fa-solid fa-calendar-days mr-3"></i> Panel Harmonogramu Masowego</h3>
+                    <div class="grid grid-cols-3 gap-4 relative z-10">
+                        <select id="bulk-publication-status" class="w-full bg-[#050508] border border-white/10 rounded-xl p-5 text-[12px] font-bold text-white outline-none focus:border-cyan-500 transition-all">
+                            <option value="NO_CHANGE">Bez Zmian</option>
+                            <option value="Draft">Draft</option>
+                            <option value="Live">Live</option>
+                            <option value="Archived">Archived</option>
                         </select>
+                        <input type="datetime-local" id="bulk-valid-from" class="w-full bg-[#050508] border border-white/10 rounded-xl p-5 text-[12px] font-bold text-white outline-none focus:border-cyan-500 transition-all">
+                        <input type="datetime-local" id="bulk-valid-to" class="w-full bg-[#050508] border border-white/10 rounded-xl p-5 text-[12px] font-bold text-white outline-none focus:border-cyan-500 transition-all">
                     </div>
                 </div>
 
-                <div class="bg-[#0a0a0f]/60 backdrop-blur-md border border-yellow-500/20 p-8 rounded-3xl space-y-6 relative overflow-hidden shadow-[0_0_20px_rgba(234,179,8,0.05)] hover:border-yellow-500/40 transition-colors group">
+                <div class="bg-[#0a0a0f]/60 backdrop-blur-md border border-yellow-500/20 p-8 rounded-3xl space-y-6 relative overflow-hidden shadow-[0_0_20px_rgba(234,179,8,0.08)] hover:border-yellow-500/40 transition-colors group">
                     <div class="absolute top-0 left-0 w-1.5 h-full bg-yellow-500 shadow-[0_0_10px_rgba(234,179,8,0.8)]"></div>
-                    <h3 class="text-[12px] font-black uppercase text-yellow-500 tracking-widest relative z-10"><i class="fa-solid fa-money-bill-trend-up mr-3"></i> Cennik Masowy</h3>
-                    <div class="grid grid-cols-2 gap-8 relative z-10">
-                        <select id="bulk-price-action" class="w-full bg-[#050508] border border-white/10 rounded-xl p-5 text-[12px] font-bold text-white outline-none focus:border-yellow-500 focus:shadow-[0_0_15px_rgba(234,179,8,0.2)] transition-all">
-                            <option value="">-- Akcja (Ignoruj) --</option><option value="add">Zwi─Öksz (+)</option><option value="sub">Obni┼╝ (-)</option><option value="set">Ustaw Sztywno (=)</option>
+                    <h3 class="text-[12px] font-black uppercase text-yellow-500 tracking-widest relative z-10"><i class="fa-solid fa-layer-group mr-3"></i> Masowy Modyfikator Omnichannel</h3>
+                    <div class="grid grid-cols-3 gap-4 relative z-10">
+                        <select id="bulk-channel-target" class="w-full bg-[#050508] border border-white/10 rounded-xl p-5 text-[12px] font-bold text-white outline-none focus:border-yellow-500 transition-all">
+                            <option value="POS">POS</option>
+                            <option value="Takeaway">Takeaway</option>
+                            <option value="Delivery">Delivery</option>
                         </select>
-                        <div class="relative">
-                            <input type="number" id="bulk-price-value" step="0.01" placeholder="Warto┼Ť─ç (PLN)" class="w-full bg-[#050508] border border-white/10 rounded-xl p-5 text-[12px] font-black text-white outline-none focus:border-yellow-500 focus:shadow-[0_0_15px_rgba(234,179,8,0.2)] transition-all">
-                            <span class="absolute right-4 top-1/2 -translate-y-1/2 text-[10px] font-black text-slate-500 pointer-events-none">PLN</span>
-                        </div>
+                        <select id="bulk-omni-price-op" class="w-full bg-[#050508] border border-white/10 rounded-xl p-5 text-[12px] font-bold text-white outline-none focus:border-yellow-500 transition-all">
+                            <option value="set_amount">Ustaw sztywna kwote</option>
+                            <option value="increase_percent">Zwieksz o %</option>
+                            <option value="increase_pln">Zwieksz o PLN</option>
+                        </select>
+                        <input type="number" id="bulk-omni-price-value" step="0.01" placeholder="Wartosc operacji" class="w-full bg-[#050508] border border-white/10 rounded-xl p-5 text-[12px] font-black text-white outline-none focus:border-yellow-500 transition-all">
                     </div>
                 </div>
 
                 <div class="bg-[#0a0a0f]/60 backdrop-blur-md border border-purple-500/20 p-8 rounded-3xl space-y-6 relative overflow-hidden shadow-[0_0_20px_rgba(168,85,247,0.05)] hover:border-purple-500/40 transition-colors group">
                     <div class="absolute top-0 left-0 w-1.5 h-full bg-purple-500 shadow-[0_0_10px_rgba(168,85,247,0.8)]"></div>
-                    <h3 class="text-[12px] font-black uppercase text-purple-400 tracking-widest relative z-10"><i class="fa-solid fa-bullseye mr-3"></i> Marketing & Status</h3>
+                    <h3 class="text-[12px] font-black uppercase text-purple-400 tracking-widest relative z-10"><i class="fa-solid fa-bullseye mr-3"></i> Marketing</h3>
                     <div class="grid grid-cols-2 gap-8 relative z-10">
                         <select id="bulk-badge" class="w-full bg-[#050508] border border-white/10 rounded-xl p-5 text-[12px] font-bold text-white outline-none focus:border-purple-500 focus:shadow-[0_0_15px_rgba(168,85,247,0.2)] transition-all">
-                            <option value="">-- Odznaka (Ignoruj) --</option><option value="none">Usu┼ä Odznaki</option><option value="new">NOWO┼Ü─ć</option><option value="bestseller">BESTSELLER ԺɴŞĆ</option>
+                            <option value="">-- Odznaka (Ignoruj) --</option><option value="none">Usuń Odznaki</option><option value="new">NOWOSC</option><option value="bestseller">BESTSELLER</option>
                         </select>
                         <select id="bulk-secret" class="w-full bg-[#050508] border border-white/10 rounded-xl p-5 text-[12px] font-bold text-white outline-none focus:border-purple-500 focus:shadow-[0_0_15px_rgba(168,85,247,0.2)] transition-all">
                             <option value="">-- Tajne Menu (Ignoruj) --</option><option value="1">Ustaw jako Tajne (Tylko QR)</option><option value="0">Zdejmij Tajne (Publiczne)</option>
                         </select>
-                        <div class="col-span-2">
-                            <select id="bulk-active" class="w-full bg-[#050508] border border-white/10 rounded-xl p-5 text-[12px] font-bold text-white outline-none focus:border-purple-500 focus:shadow-[0_0_15px_rgba(168,85,247,0.2)] transition-all">
-                                <option value="">-- Status (Ignoruj) --</option><option value="1">Aktywuj na POS (W┼é─ůcz sprzeda┼╝)</option><option value="0">Status 86 (Zdejmij z menu)</option>
-                            </select>
-                        </div>
                     </div>
                 </div>
             </div>
         </div>
+
     </main>
 
     <script src="../../core/js/api_client.js"></script>
+    <script src="../warehouse/js/warehouse_api.js"></script>
     <script src="../../core/js/core_validator.js"></script>
     <script src="js/studio_core.js"></script>
     <script src="js/studio_item.js"></script>
     <script src="js/studio_bulk.js"></script>
     <script src="js/studio_modifiers.js"></script>
+    <script src="js/studio_category_table.js"></script>
     <script src="js/studio_recipe.js"></script>
+    <script src="../../core/js/neon_pizza_engine.js"></script>
     <script src="js/studio_ui.js"></script>
     <script src="js/studio_margin.js"></script>
 </body>
diff --git a/modules/studio/js/studio_bulk.js b/modules/studio/js/studio_bulk.js
index 94ff737..2f2697d 100644
--- a/modules/studio/js/studio_bulk.js
+++ b/modules/studio/js/studio_bulk.js
@@ -1,78 +1,7 @@
 window.BulkEditor = {
     init: function() {
-        this.mountOmnichannelPanels();
-
-        const btnApplyBulk = document.getElementById('btn-apply-bulk');
-        if (btnApplyBulk) btnApplyBulk.addEventListener('click', () => this.executeBulkUpdate());
     },
 
-    mountOmnichannelPanels: function() {
-        const bulkView = document.getElementById('bulk-inspector-view');
-        if (!bulkView || bulkView.dataset.omnichannelBulkReady === '1') return;
-
-        const oldPriceAction = document.getElementById('bulk-price-action');
-        const oldActive = document.getElementById('bulk-active');
-        if (oldPriceAction) {
-            const oldPriceCard = oldPriceAction.closest('.bg-\\[\\#0a0a0f\\]\\/60');
-            if (oldPriceCard) oldPriceCard.remove();
-        }
-        if (oldActive) {
-            const oldActiveWrapper = oldActive.closest('.col-span-2');
-            if (oldActiveWrapper) oldActiveWrapper.remove();
-        }
-
-        const content = bulkView.querySelector('.p-10.max-w-4xl');
-        if (!content) return;
-
-        const publicationPanel = document.createElement('div');
-        publicationPanel.className = 'bg-[#0a0a0f]/60 backdrop-blur-md border border-cyan-500/20 p-8 rounded-3xl space-y-6 relative overflow-hidden shadow-[0_0_20px_rgba(6,182,212,0.08)] hover:border-cyan-500/40 transition-colors group';
-        publicationPanel.innerHTML = `
-            <div class="absolute top-0 left-0 w-1.5 h-full bg-cyan-500 shadow-[0_0_10px_rgba(6,182,212,0.8)]"></div>
-            <h3 class="text-[12px] font-black uppercase text-cyan-400 tracking-widest relative z-10"><i class="fa-solid fa-calendar-days mr-3"></i> Panel Harmonogramu Masowego</h3>
-            <div class="grid grid-cols-3 gap-4 relative z-10">
-                <select id="bulk-publication-status" class="w-full bg-[#050508] border border-white/10 rounded-xl p-5 text-[12px] font-bold text-white outline-none focus:border-cyan-500 transition-all">
-                    <option value="NO_CHANGE">Bez Zmian</option>
-                    <option value="Draft">Draft</option>
-                    <option value="Live">Live</option>
-                    <option value="Archived">Archived</option>
-                </select>
-                <input type="datetime-local" id="bulk-valid-from" class="w-full bg-[#050508] border border-white/10 rounded-xl p-5 text-[12px] font-bold text-white outline-none focus:border-cyan-500 transition-all">
-                <input type="datetime-local" id="bulk-valid-to" class="w-full bg-[#050508] border border-white/10 rounded-xl p-5 text-[12px] font-bold text-white outline-none focus:border-cyan-500 transition-all">
-            </div>
-        `;
-
-        const omnichannelPanel = document.createElement('div');
-        omnichannelPanel.className = 'bg-[#0a0a0f]/60 backdrop-blur-md border border-yellow-500/20 p-8 rounded-3xl space-y-6 relative overflow-hidden shadow-[0_0_20px_rgba(234,179,8,0.08)] hover:border-yellow-500/40 transition-colors group';
-        omnichannelPanel.innerHTML = `
-            <div class="absolute top-0 left-0 w-1.5 h-full bg-yellow-500 shadow-[0_0_10px_rgba(234,179,8,0.8)]"></div>
-            <h3 class="text-[12px] font-black uppercase text-yellow-500 tracking-widest relative z-10"><i class="fa-solid fa-layer-group mr-3"></i> Masowy Modyfikator Omnichannel</h3>
-            <div class="grid grid-cols-3 gap-4 relative z-10">
-                <select id="bulk-channel-target" class="w-full bg-[#050508] border border-white/10 rounded-xl p-5 text-[12px] font-bold text-white outline-none focus:border-yellow-500 transition-all">
-                    <option value="POS">POS</option>
-                    <option value="Takeaway">Takeaway</option>
-                    <option value="Delivery">Delivery</option>
-                </select>
-                <select id="bulk-omni-price-op" class="w-full bg-[#050508] border border-white/10 rounded-xl p-5 text-[12px] font-bold text-white outline-none focus:border-yellow-500 transition-all">
-                    <option value="set_amount">Ustaw sztywn─ů kwot─Ö</option>
-                    <option value="increase_percent">Zwi─Öksz o %</option>
-                    <option value="increase_pln">Zwi─Öksz o PLN</option>
-                </select>
-                <input type="number" id="bulk-omni-price-value" step="0.01" placeholder="Warto┼Ť─ç operacji" class="w-full bg-[#050508] border border-white/10 rounded-xl p-5 text-[12px] font-black text-white outline-none focus:border-yellow-500 transition-all">
-            </div>
-        `;
-
-        const firstCard = content.querySelector('.bg-\\[\\#0a0a0f\\]\\/60');
-        if (firstCard) {
-            firstCard.insertAdjacentElement('afterend', publicationPanel);
-            publicationPanel.insertAdjacentElement('afterend', omnichannelPanel);
-        } else {
-            content.appendChild(publicationPanel);
-            content.appendChild(omnichannelPanel);
-        }
-
-        bulkView.dataset.omnichannelBulkReady = '1';
-    },
-    
     async executeBulkUpdate() {
         if (!window.StudioState || !window.StudioState.bulkSelectedItems || window.StudioState.bulkSelectedItems.length === 0) {
             alert('B┼é─ůd: Zaznacz przynajmniej jedno danie z listy po lewej stronie!');
diff --git a/modules/studio/js/studio_core.js b/modules/studio/js/studio_core.js
index 46a14c3..f2b23fb 100644
--- a/modules/studio/js/studio_core.js
+++ b/modules/studio/js/studio_core.js
@@ -1,4 +1,4 @@
-window.StudioState = { items: [], categories: [], bulkSelectedItems: [] };
+window.StudioState = { items: [], categories: [], bulkSelectedItems: [], sceneTemplates: null };
 
 window.apiStudio = async function(action, payload = {}) {
     payload.action = action;
@@ -10,6 +10,7 @@ window.loadMenuTree = async function() {
     if (res.success === true && res.data) {
         window.StudioState.categories = res.data.categories || [];
         window.StudioState.items = res.data.items || [];
+        window.StudioState.modifierGroups = res.data.modifierGroups || window.StudioState.modifierGroups || [];
         return res.data;
     }
     console.error('B┼é─ůd API:', res.message);
@@ -24,4 +25,25 @@ window.loadItemDetails = async function(itemId) {
     }
     console.error('B┼é─ůd API:', res.message);
     return null;
+};
+
+// M022: lista scene templates (cache per-session w window.StudioState.sceneTemplates)
+// Zwraca [{asciiKey, name, kind, photographerBrief, isSystem}]
+// Kind: 'item' | 'category' | null (wszystko)
+window.loadSceneTemplates = async function(kind = null, force = false) {
+    if (!force && window.StudioState.sceneTemplates) {
+        return kind
+            ? window.StudioState.sceneTemplates.filter(t => t.kind === kind)
+            : window.StudioState.sceneTemplates;
+    }
+    const payload = kind ? { kind } : {};
+    const res = await window.apiStudio('list_scene_templates', payload);
+    if (res.success === true && res.data) {
+        // Gdy pobieramy wszystko ÔÇö cache'uj. Gdy filtrujemy po kind ÔÇö nie nadpisuj full cache.
+        if (!kind) {
+            window.StudioState.sceneTemplates = res.data.templates || [];
+        }
+        return res.data.templates || [];
+    }
+    return [];
 };
\ No newline at end of file
diff --git a/modules/studio/js/studio_item.js b/modules/studio/js/studio_item.js
index 998a170..ab2a54e 100644
--- a/modules/studio/js/studio_item.js
+++ b/modules/studio/js/studio_item.js
@@ -1,5 +1,16 @@
 window.ItemEditor = {
-    toAutoSlug: function(val) {
+    _debounceTimers: {},
+    _vatInheritEnabled: true,
+    _currentPubStatus: 'Draft',
+    _currentItemType: 'standard',
+    _observer: null,
+
+    debounce(key, fn, ms = 400) {
+        clearTimeout(this._debounceTimers[key]);
+        this._debounceTimers[key] = setTimeout(fn, ms);
+    },
+
+    toAutoSlug(val) {
         const map = {
             '─ů':'a','─ç':'c','─Ö':'e','┼é':'l','┼ä':'n','├│':'o','┼Ť':'s','┼║':'z','┼╝':'z',
             '─ä':'A','─ć':'C','─ś':'E','┼ü':'L','┼â':'N','├ô':'O','┼Ü':'S','┼╣':'Z','┼╗':'Z',
@@ -8,217 +19,556 @@ window.ItemEditor = {
         return (val||'').split('').map(c => map[c]||c).join('').replace(/[^a-zA-Z0-9_]/g, '').toUpperCase();
     },
 
-    ensureOmnichannelForm: function() {
+    setPubStatus(status) {
+        this._currentPubStatus = status;
+        document.querySelectorAll('.pub-btn').forEach(btn => {
+            const s = btn.dataset.status;
+            const active = s === status;
+            const colors = {
+                Draft:    active ? 'bg-yellow-500/80 text-black shadow-[0_0_12px_rgba(234,179,8,0.4)]' : '',
+                Live:     active ? 'bg-green-500 text-white shadow-[0_0_12px_rgba(34,197,94,0.5)]' : '',
+                Archived: active ? 'bg-red-500/80 text-white shadow-[0_0_12px_rgba(239,68,68,0.4)]' : ''
+            };
+            btn.className = 'pub-btn px-3 py-1.5 text-[9px] font-black uppercase transition-all ' +
+                (active ? colors[s] : 'bg-white/5 text-slate-500 hover:text-white hover:bg-white/10');
+        });
+    },
+
+    setItemType(type) {
+        this._currentItemType = type;
+        const hidden = document.getElementById('item-type');
+        if (hidden) hidden.value = type;
+        document.querySelectorAll('.type-btn').forEach(btn => {
+            const t = btn.dataset.type;
+            const active = t === type;
+            btn.className = 'type-btn flex-1 px-3 py-3 text-[9px] font-black uppercase transition-all flex items-center justify-center gap-1.5 ' +
+                (active ? 'bg-purple-500/80 text-white' : 'bg-white/5 text-slate-500 hover:text-white hover:bg-white/10');
+        });
+    },
+
+    scrollToSection(sectionId) {
+        const el = document.getElementById(sectionId);
+        if (el) el.scrollIntoView({ behavior: 'smooth', block: 'start' });
+    },
+
+    autoFillOmnichannel() {
+        const posPrice = parseFloat(document.getElementById('item-price-pos')?.value) || 0;
+        const takeawayInput = document.getElementById('item-price-takeaway');
+        const deliveryInput = document.getElementById('item-price-delivery');
+        if (takeawayInput) takeawayInput.value = posPrice.toFixed(2);
+        if (deliveryInput) deliveryInput.value = (posPrice * 1.10).toFixed(2);
+        [takeawayInput, deliveryInput].forEach(el => {
+            if (!el) return;
+            el.classList.add('border-cyan-400', 'ring-1', 'ring-cyan-400/30');
+            setTimeout(() => el.classList.remove('border-cyan-400', 'ring-1', 'ring-cyan-400/30'), 1500);
+        });
+    },
+
+    toggleVatInherit(enabled) {
+        this._vatInheritEnabled = enabled;
+        ['item-vat-dine-in', 'item-vat-takeaway'].forEach(id => {
+            const el = document.getElementById(id);
+            if (!el) return;
+            el.disabled = enabled;
+            const wrapper = el.closest('.vat-field-wrap');
+            if (enabled) {
+                el.classList.add('opacity-50');
+                if (wrapper) { wrapper.classList.remove('border-cyan-500/30'); wrapper.classList.add('border-purple-500/20'); }
+            } else {
+                el.classList.remove('opacity-50');
+                if (wrapper) { wrapper.classList.add('border-cyan-500/30'); wrapper.classList.remove('border-purple-500/20'); }
+            }
+        });
+        const label = document.getElementById('vat-inherit-label');
+        if (label) {
+            label.textContent = enabled ? 'AUTO ÔÇö dziedziczone z kategorii' : 'MANUAL ÔÇö edycja r─Öczna';
+            label.className = 'text-[8px] font-black uppercase tracking-wider ' + (enabled ? 'text-purple-400' : 'text-cyan-400');
+        }
+    },
+
+    _populateCommandBar() {
+        const bar = document.getElementById('item-command-bar');
+        if (!bar) return;
+        bar.innerHTML = `
+        <div class="flex items-center justify-between gap-3 flex-wrap">
+            <div class="flex items-center gap-4 flex-wrap">
+                <div class="flex items-center gap-2">
+                    <span class="text-[8px] font-black uppercase text-slate-500 tracking-widest hidden lg:block">Publikacja</span>
+                    <div class="flex rounded-lg overflow-hidden border border-white/10">
+                        <button type="button" data-status="Draft" onclick="window.ItemEditor.setPubStatus('Draft')" class="pub-btn px-3 py-1.5 text-[9px] font-black uppercase bg-yellow-500/80 text-black transition-all shadow-[0_0_12px_rgba(234,179,8,0.4)]">Draft</button>
+                        <button type="button" data-status="Live" onclick="window.ItemEditor.setPubStatus('Live')" class="pub-btn px-3 py-1.5 text-[9px] font-black uppercase bg-white/5 text-slate-500 hover:text-white hover:bg-white/10 transition-all">Live</button>
+                        <button type="button" data-status="Archived" onclick="window.ItemEditor.setPubStatus('Archived')" class="pub-btn px-3 py-1.5 text-[9px] font-black uppercase bg-white/5 text-slate-500 hover:text-white hover:bg-white/10 transition-all">Archived</button>
+                    </div>
+                </div>
+                <label class="flex items-center gap-2 cursor-pointer group">
+                    <div class="relative">
+                        <input type="checkbox" id="item-is-secret" class="sr-only peer">
+                        <div class="w-8 h-[18px] bg-white/10 rounded-full peer-checked:bg-purple-500 transition-all after:content-[''] after:absolute after:top-[2px] after:left-[2px] after:bg-white after:rounded-full after:h-[14px] after:w-[14px] after:transition-all peer-checked:after:translate-x-[14px]"></div>
+                    </div>
+                    <span class="text-[8px] font-black uppercase text-slate-500 group-hover:text-purple-400 transition"><i class="fa-solid fa-lock text-[7px] mr-0.5"></i> Tajne Menu</span>
+                </label>
+                <div id="hq-lock-flag" class="hidden items-center gap-1 bg-red-900/30 border border-red-500/30 rounded-lg px-2.5 py-1">
+                    <i class="fa-solid fa-shield-halved text-red-400 text-[10px]"></i>
+                    <span class="text-[8px] font-black uppercase text-red-400 tracking-wider">HQ LOCK</span>
+                </div>
+            </div>
+            <button type="button" id="btn-save-item" onclick="window.ItemEditor.saveItem()" class="bg-gradient-to-r from-blue-600 to-blue-500 hover:from-blue-500 hover:to-blue-400 text-white px-8 py-2.5 rounded-xl font-black text-[10px] uppercase tracking-widest shadow-[0_0_25px_rgba(37,99,235,0.4)] hover:shadow-[0_0_35px_rgba(37,99,235,0.6)] transition-all flex items-center gap-2 active:scale-95">
+                <i class="fa-solid fa-rocket"></i> ZAPISZ DANIE
+            </button>
+        </div>`;
+    },
+
+    _populateAnchorNav() {
+        const nav = document.getElementById('item-anchor-nav');
+        if (!nav) return;
+        nav.classList.remove('hidden');
+        const items = [
+            { id:'sec-identity',   icon:'fa-fingerprint',    tip:'To┼╝samo┼Ť─ç',    hc:'hover:text-purple-400 hover:border-purple-500/30 hover:bg-purple-500/10' },
+            { id:'sec-matrix',     icon:'fa-table-cells',    tip:'Macierz Cen',  hc:'hover:text-cyan-400 hover:border-cyan-500/30 hover:bg-cyan-500/10' },
+            { id:'sec-vat',        icon:'fa-receipt',        tip:'VAT',          hc:'hover:text-amber-400 hover:border-amber-500/30 hover:bg-amber-500/10' },
+            { id:'sec-modifiers',  icon:'fa-puzzle-piece',   tip:'Modyfikatory', hc:'hover:text-purple-400 hover:border-purple-500/30 hover:bg-purple-500/10' },
+            { id:'sec-visual',     icon:'fa-layer-group',    tip:'Visual Layers', hc:'hover:text-amber-400 hover:border-amber-500/30 hover:bg-amber-500/10' },
+            { id:'sec-logistics',  icon:'fa-truck-fast',     tip:'Logistyka',    hc:'hover:text-blue-400 hover:border-blue-500/30 hover:bg-blue-500/10' },
+            { id:'sec-schedule',   icon:'fa-calendar-days',  tip:'Harmonogram',  hc:'hover:text-emerald-400 hover:border-emerald-500/30 hover:bg-emerald-500/10' },
+            { id:'sec-marketing',  icon:'fa-bullhorn',       tip:'Marketing',    hc:'hover:text-rose-400 hover:border-rose-500/30 hover:bg-rose-500/10' },
+            { id:'sec-enterprise', icon:'fa-bolt',           tip:'Enterprise',   hc:'hover:text-emerald-400 hover:border-emerald-500/30 hover:bg-emerald-500/10' },
+        ];
+        nav.innerHTML = items.map(s =>
+            `<button type="button" onclick="window.ItemEditor.scrollToSection('${s.id}')" class="anchor-btn w-9 h-9 rounded-xl bg-white/5 border border-white/5 flex items-center justify-center text-slate-500 ${s.hc} transition-all" title="${s.tip}" data-section="${s.id}"><i class="fa-solid ${s.icon} text-[10px]"></i></button>`
+        ).join('');
+    },
+
+    _setupScrollSpy() {
+        if (this._observer) this._observer.disconnect();
+        const sections = document.querySelectorAll('#item-form > section[id]');
+        if (!sections.length) return;
+        this._observer = new IntersectionObserver(entries => {
+            entries.forEach(entry => {
+                const btn = document.querySelector(`.anchor-btn[data-section="${entry.target.id}"]`);
+                if (!btn) return;
+                if (entry.isIntersecting) {
+                    btn.classList.add('bg-white/10', 'text-white', 'border-white/20');
+                } else {
+                    btn.classList.remove('bg-white/10', 'text-white', 'border-white/20');
+                }
+            });
+        }, { root: document.getElementById('menu-view-scroll'), threshold: 0.2 });
+        sections.forEach(sec => this._observer.observe(sec));
+    },
+
+    _glassCard(id, color, icon, title, content) {
+        return `
+        <section id="${id}" class="bg-white/[0.03] backdrop-blur-md border border-white/[0.07] rounded-2xl p-6 relative overflow-hidden transition-all hover:border-white/10">
+            <div class="absolute top-0 left-0 w-1 h-full bg-${color}-500 shadow-[0_0_8px_rgba(var(--tw-shadow-color),0.5)]"></div>
+            <h3 class="text-[11px] font-black uppercase text-${color}-400 tracking-widest mb-5 flex items-center gap-2 pl-2">
+                <i class="fa-solid ${icon}"></i> ${title}
+            </h3>
+            <div class="pl-2">${content}</div>
+        </section>`;
+    },
+
+    _inp(id, label, placeholder, extra = '') {
+        return `<div class="flex flex-col gap-1.5 ${extra}">
+            <label class="text-[9px] text-slate-400 font-bold uppercase tracking-wider">${label}</label>
+            <input type="text" id="${id}" class="bg-black/50 border border-white/10 text-white rounded-xl p-3 text-sm focus:border-purple-500 focus:ring-1 focus:ring-purple-500/30 focus:outline-none transition" placeholder="${placeholder}">
+        </div>`;
+    },
+
+    ensureOmnichannelForm() {
         const form = document.getElementById('item-form');
         if (!form || form.dataset.omnichannelReady === '1') return;
 
+        this._populateCommandBar();
+        this._populateAnchorNav();
+
+        const fcPanel = document.getElementById('food-cost-panel');
+        if (fcPanel) fcPanel.classList.remove('hidden');
+
+        const modGroupsHtml = this._renderModifierGroupCheckboxes();
+
+        const DAYS = ['Pn','Wt','Śr','Cz','Pt','Sb','Nd'];
+        const daysCheckboxes = DAYS.map((d, i) =>
+            `<label class="cursor-pointer"><input type="checkbox" class="day-checkbox sr-only peer" value="${i+1}" checked>
+             <div class="w-9 h-9 rounded-lg bg-black/50 border border-white/10 flex items-center justify-center text-[10px] font-black text-slate-500 peer-checked:bg-emerald-900/40 peer-checked:border-emerald-500/50 peer-checked:text-emerald-300 transition-all">${d}</div></label>`
+        ).join('');
+
+        const ALLERGENS = ['Gluten','Laktoza','Orzechy','Skorupiaki','Jaja','Ryby','Soja','Seler','Gorczyca','Sezam','Mi─Öczaki'];
+        const allergensHtml = ALLERGENS.map(a =>
+            `<label class="cursor-pointer"><input type="checkbox" class="allergen-checkbox sr-only peer" value="${a}">
+             <div class="bg-black/50 border border-white/10 text-slate-400 text-[10px] px-3 py-1.5 rounded-lg peer-checked:bg-emerald-900/40 peer-checked:border-emerald-500/50 peer-checked:text-emerald-300 transition-all">${a}</div></label>`
+        ).join('');
+
         form.innerHTML = `
             <input type="hidden" id="item-id" value="0">
-            
-            <div class="grid grid-cols-2 gap-4">
-                <div id="lock-item-name-wrapper" class="flex flex-col gap-1.5 franchise-lockable">
-                    <label class="text-[10px] text-slate-400 font-bold uppercase tracking-wider">Nazwa Dania</label>
-                    <input type="text" id="item-name" class="bg-black/50 border border-white/10 text-white rounded p-3 text-sm focus:border-blue-500 focus:ring-1 focus:ring-blue-500 focus:outline-none transition" placeholder="np. Pizza Margherita">
+            <input type="hidden" id="item-type" value="standard">
+
+            ${this._glassCard('sec-identity', 'purple', 'fa-fingerprint', 'To┼╝samo┼Ť─ç i Typologia', `
+                <div class="grid grid-cols-2 gap-4">
+                    <div id="lock-item-name-wrapper" class="flex flex-col gap-1.5 franchise-lockable">
+                        <label class="text-[9px] text-slate-400 font-bold uppercase tracking-wider">Nazwa Dania <span class="text-red-400">*</span></label>
+                        <input type="text" id="item-name" class="bg-black/50 border border-white/10 text-white rounded-xl p-3 text-sm focus:border-purple-500 focus:ring-1 focus:ring-purple-500/30 focus:outline-none transition" placeholder="np. Pizza Margherita">
+                    </div>
+                    <div id="lock-item-ascii-wrapper" class="flex flex-col gap-1.5 franchise-lockable">
+                        <label class="text-[9px] text-slate-400 font-bold uppercase tracking-wider">Klucz SKU <span class="text-red-400">*</span></label>
+                        <div class="relative">
+                            <input type="text" id="item-ascii-key" class="w-full bg-black/50 border border-white/10 text-white rounded-xl p-3 text-sm focus:border-purple-500 focus:ring-1 focus:ring-purple-500/30 focus:outline-none transition font-mono uppercase pr-8" placeholder="PIZZA_MARGHERITA">
+                            <i class="fa-solid fa-robot absolute right-3 top-1/2 -translate-y-1/2 text-purple-500/50 text-[10px]" title="Auto z nazwy"></i>
+                        </div>
+                    </div>
                 </div>
-                <div id="lock-item-ascii-wrapper" class="flex flex-col gap-1.5 franchise-lockable">
-                    <label class="text-[10px] text-slate-400 font-bold uppercase tracking-wider">SKU (Klucz systemowy)</label>
-                    <input type="text" id="item-ascii-key" class="bg-black/50 border border-white/10 text-white rounded p-3 text-sm focus:border-blue-500 focus:ring-1 focus:ring-blue-500 focus:outline-none transition font-mono" placeholder="np. PIZZA_MARG">
+                <div class="grid grid-cols-2 gap-4 mt-4">
+                    <div class="flex flex-col gap-1.5">
+                        <label class="text-[9px] text-slate-400 font-bold uppercase tracking-wider">Kategoria <span class="text-red-400">*</span></label>
+                        <select id="item-category-id" class="bg-black/50 border border-white/10 text-white rounded-xl p-3 text-sm focus:border-purple-500 focus:ring-1 focus:ring-purple-500/30 focus:outline-none transition cursor-pointer">
+                            <option value="0">Wybierz kategori─Ö...</option>
+                        </select>
+                    </div>
+                    <div class="flex flex-col gap-1.5">
+                        <label class="text-[9px] text-slate-400 font-bold uppercase tracking-wider">Typ Dania</label>
+                        <div class="flex rounded-xl overflow-hidden border border-white/10">
+                            <button type="button" data-type="standard" onclick="window.ItemEditor.setItemType('standard')" class="type-btn flex-1 px-3 py-3 text-[9px] font-black uppercase bg-purple-500/80 text-white transition-all flex items-center justify-center gap-1.5"><i class="fa-solid fa-circle text-[6px]"></i> Standard</button>
+                            <button type="button" data-type="half_half" onclick="window.ItemEditor.setItemType('half_half')" class="type-btn flex-1 px-3 py-3 text-[9px] font-black uppercase bg-white/5 text-slate-500 hover:text-white transition-all flex items-center justify-center gap-1.5"><i class="fa-solid fa-circle-half-stroke text-[6px]"></i> Pół/Pół</button>
+                        </div>
+                    </div>
                 </div>
-            </div>
+            `)}
 
-            <div class="grid grid-cols-2 gap-4 mt-4">
-                <div class="flex flex-col gap-1.5">
-                    <label class="text-[10px] text-slate-400 font-bold uppercase tracking-wider">Kategoria</label>
-                    <select id="item-category-id" class="bg-black/50 border border-white/10 text-white rounded p-3 text-sm focus:border-blue-500 focus:ring-1 focus:ring-blue-500 focus:outline-none transition cursor-pointer">
-                        <option value="0">Wybierz kategori─Ö...</option>
-                    </select>
+            ${this._glassCard('sec-matrix', 'cyan', 'fa-table-cells', 'Macierz Cenowa Omnichannel', `
+                <div class="flex items-center justify-end mb-4">
+                    <button type="button" onclick="window.ItemEditor.autoFillOmnichannel()" class="text-[8px] font-black uppercase text-cyan-400 bg-cyan-500/10 border border-cyan-500/20 rounded-lg px-3 py-1.5 hover:bg-cyan-500/20 transition flex items-center gap-1.5">
+                        <span>­č¬ä</span> Autouzupe┼énianie Omnichannel
+                    </button>
                 </div>
-                <div class="flex flex-col gap-1.5">
-                    <label class="text-[10px] text-slate-400 font-bold uppercase tracking-wider">Stawka VAT</label>
-                    <select id="item-vat-rate" class="bg-black/50 border border-white/10 text-white rounded p-3 text-sm focus:border-blue-500 focus:ring-1 focus:ring-blue-500 focus:outline-none transition cursor-pointer">
-                        <option value="23">23%</option>
-                        <option value="8">8%</option>
-                        <option value="5">5%</option>
-                        <option value="0">0%</option>
-                    </select>
+                <div class="grid grid-cols-3 gap-4">
+                    <div class="flex flex-col gap-2 bg-black/30 rounded-xl p-4 border border-blue-500/10">
+                        <div class="flex items-center gap-2"><div class="w-2 h-2 rounded-full bg-blue-500"></div><span class="text-[9px] text-blue-400 font-black uppercase">POS (Na Sali)</span></div>
+                        <input type="number" id="item-price-pos" step="0.01" min="0" value="0.00" class="bg-black/50 border border-white/10 text-white rounded-lg p-3 text-lg font-black text-center focus:border-cyan-500 focus:ring-1 focus:ring-cyan-500/30 focus:outline-none transition tabular-nums">
+                        <span class="text-[8px] text-slate-600 text-center">PLN brutto</span>
+                    </div>
+                    <div class="flex flex-col gap-2 bg-black/30 rounded-xl p-4 border border-green-500/10">
+                        <div class="flex items-center gap-2"><div class="w-2 h-2 rounded-full bg-green-500"></div><span class="text-[9px] text-green-400 font-black uppercase">Takeaway (Wynos)</span></div>
+                        <input type="number" id="item-price-takeaway" step="0.01" min="0" value="0.00" class="bg-black/50 border border-white/10 text-white rounded-lg p-3 text-lg font-black text-center focus:border-cyan-500 focus:ring-1 focus:ring-cyan-500/30 focus:outline-none transition tabular-nums">
+                        <span class="text-[8px] text-slate-600 text-center">PLN brutto</span>
+                    </div>
+                    <div class="flex flex-col gap-2 bg-black/30 rounded-xl p-4 border border-orange-500/10">
+                        <div class="flex items-center gap-2"><div class="w-2 h-2 rounded-full bg-orange-500"></div><span class="text-[9px] text-orange-400 font-black uppercase">Delivery (Dostawa)</span></div>
+                        <input type="number" id="item-price-delivery" step="0.01" min="0" value="0.00" class="bg-black/50 border border-white/10 text-white rounded-lg p-3 text-lg font-black text-center focus:border-cyan-500 focus:ring-1 focus:ring-cyan-500/30 focus:outline-none transition tabular-nums">
+                        <span class="text-[8px] text-slate-600 text-center">PLN brutto</span>
+                    </div>
                 </div>
-            </div>
+            `)}
+
+            ${this._glassCard('sec-vat', 'amber', 'fa-receipt', 'Piramida VAT', `
+                <div class="flex items-center justify-between mb-4">
+                    <label class="flex items-center gap-2.5 cursor-pointer group">
+                        <div class="relative">
+                            <input type="checkbox" id="item-vat-inherit" class="sr-only peer" checked>
+                            <div class="w-8 h-[18px] bg-white/10 rounded-full peer-checked:bg-purple-500 transition-all after:content-[''] after:absolute after:top-[2px] after:left-[2px] after:bg-white after:rounded-full after:h-[14px] after:w-[14px] after:transition-all peer-checked:after:translate-x-[14px]"></div>
+                        </div>
+                        <span id="vat-inherit-label" class="text-[8px] font-black uppercase tracking-wider text-purple-400">AUTO ÔÇö dziedziczone z kategorii</span>
+                    </label>
+                </div>
+                <div class="grid grid-cols-2 gap-4">
+                    <div class="vat-field-wrap flex flex-col gap-1.5 bg-black/30 rounded-xl p-4 border border-purple-500/20 transition-colors">
+                        <span class="text-[8px] text-slate-500 font-bold uppercase">Na Sali (Dine-in)</span>
+                        <select id="item-vat-dine-in" class="bg-black/50 border border-white/10 text-white rounded-lg p-2.5 text-xs focus:border-amber-500 focus:outline-none transition cursor-pointer opacity-50" disabled>
+                            <option value="23">23%</option><option value="8" selected>8%</option><option value="5">5%</option><option value="0">0%</option>
+                        </select>
+                    </div>
+                    <div class="vat-field-wrap flex flex-col gap-1.5 bg-black/30 rounded-xl p-4 border border-purple-500/20 transition-colors">
+                        <span class="text-[8px] text-slate-500 font-bold uppercase">Wynos / Dostawa</span>
+                        <select id="item-vat-takeaway" class="bg-black/50 border border-white/10 text-white rounded-lg p-2.5 text-xs focus:border-amber-500 focus:outline-none transition cursor-pointer opacity-50" disabled>
+                            <option value="23">23%</option><option value="8">8%</option><option value="5" selected>5%</option><option value="0">0%</option>
+                        </select>
+                    </div>
+                </div>
+            `)}
 
-            <div class="mt-4">
-                <div class="mb-3 p-3 bg-yellow-900/10 border border-yellow-500/30 rounded-xl">
-                    <label class="text-[10px] text-yellow-500 font-bold uppercase tracking-wider block mb-1"><i class="fa-solid fa-bolt mr-1"></i> Szybka Cena (Wypełnia macierz)</label>
-                    <input type="number" step="0.01" class="bg-black/50 border border-yellow-500/30 text-yellow-400 rounded p-2 text-sm w-full outline-none focus:border-yellow-400" placeholder="Wpisz cen─Ö i patrz na magi─Ö..." oninput="document.getElementById('item-price-pos').value = this.value; document.getElementById('item-price-takeaway').value = this.value; document.getElementById('item-price-delivery').value = this.value;">
+            ${this._glassCard('sec-modifiers', 'purple', 'fa-puzzle-piece', 'Powi─ůzane Grupy Modyfikator├│w', `
+                <div class="grid grid-cols-2 md:grid-cols-3 gap-2" id="modifierGroupsCheckboxContainer">
+                    ${modGroupsHtml}
                 </div>
+            `)}
 
-                <div class="flex flex-col gap-2 border border-blue-500/20 bg-blue-900/10 rounded-xl p-4">
-                    <label class="text-[10px] text-blue-300 font-bold uppercase tracking-wider">Macierz Cenowa (Omnichannel)</label>
-                    <div class="grid grid-cols-3 gap-3">
-                        <div class="flex flex-col gap-1">
-                            <span class="text-[9px] text-slate-400 font-bold uppercase">POS</span>
-                            <input type="number" id="item-price-pos" step="0.01" min="0" value="0.00" class="bg-black/50 border border-white/10 text-white rounded p-3 text-sm focus:border-blue-500 focus:ring-1 focus:ring-blue-500 focus:outline-none transition">
-                        </div>
-                        <div class="flex flex-col gap-1">
-                            <span class="text-[9px] text-slate-400 font-bold uppercase">Takeaway</span>
-                            <input type="number" id="item-price-takeaway" step="0.01" min="0" value="0.00" class="bg-black/50 border border-white/10 text-white rounded p-3 text-sm focus:border-blue-500 focus:ring-1 focus:ring-blue-500 focus:outline-none transition">
+            ${this._glassCard('sec-visual', 'amber', 'fa-clapperboard', 'Wizualna Kompozycja Dania', `
+                <div id="visual-director-gate" class="flex flex-col gap-4">
+
+                    <!-- Miniatura hero + badge sceny + picker -->
+                    <div class="flex gap-4 items-start">
+                        <div class="flex flex-col gap-2 flex-shrink-0">
+                            <div id="item-hero-preview" class="relative w-28 h-28 rounded-xl bg-black/40 border border-white/10 overflow-hidden flex items-center justify-center">
+                                <i class="fa-solid fa-image text-slate-700 text-2xl" id="item-hero-preview-placeholder"></i>
+                                <img id="item-hero-preview-img" src="" alt="" class="w-full h-full object-cover hidden">
+                                <span id="item-hero-scene-badge" class="absolute bottom-1 left-1 right-1 text-center text-[7px] font-black uppercase tracking-widest px-1 py-0.5 rounded bg-black/70 border hidden"></span>
+                            </div>
+                            <div class="flex gap-1">
+                                <button type="button" id="btn-item-hero-pick"
+                                        onclick="window.ItemEditor.openItemHeroPicker()"
+                                        class="flex-1 inline-flex items-center justify-center gap-1.5 bg-amber-900/30 hover:bg-amber-600 text-amber-200 hover:text-black border border-amber-500/40 font-black uppercase tracking-wider text-[8px] px-2 py-1.5 rounded-lg transition">
+                                    <i class="fa-solid fa-image text-[9px]"></i>
+                                    <span id="btn-item-hero-pick-label">Przypisz Hero</span>
+                                </button>
+                                <button type="button" id="btn-item-hero-unlink"
+                                        onclick="window.ItemEditor.unlinkItemHero()"
+                                        class="hidden bg-red-900/30 hover:bg-red-600 text-red-300 hover:text-white border border-red-500/40 font-black uppercase tracking-wider text-[8px] px-2 py-1.5 rounded-lg transition"
+                                        title="Od┼é─ůcz hero od dania">
+                                    <i class="fa-solid fa-link-slash text-[9px]"></i>
+                                </button>
+                            </div>
                         </div>
-                        <div class="flex flex-col gap-1">
-                            <span class="text-[9px] text-slate-400 font-bold uppercase">Delivery</span>
-                            <input type="number" id="item-price-delivery" step="0.01" min="0" value="0.00" class="bg-black/50 border border-white/10 text-white rounded p-3 text-sm focus:border-blue-500 focus:ring-1 focus:ring-blue-500 focus:outline-none transition">
+                        <div class="flex-1 flex flex-col gap-2">
+                            <label class="text-[9px] text-slate-400 font-bold uppercase tracking-wider">Profil Kompozycji</label>
+                            <select id="item-composition-profile" class="bg-black/50 border border-white/10 text-white rounded-xl p-3 text-sm focus:border-amber-500 focus:outline-none transition cursor-pointer">
+                                <option value="static_hero">Gotowe zdj─Öcie dania (uniwersalny)</option>
+                                <option value="pizza_top_down">Pizza ÔÇö kamera z g├│ry (warstwy)</option>
+                            </select>
+                            <p class="text-slate-600 text-[9px] leading-relaxed">
+                                <i class="fa-solid fa-circle-info text-[8px] mr-1 opacity-40"></i>
+                                <span id="item-composition-hint">Danie renderowane z jednego zdj─Öcia (burger, makaron, napoje).</span>
+                            </p>
                         </div>
                     </div>
+
+                    <p class="text-slate-400 text-[11px] leading-relaxed">
+                        Pe┼éna scena (warstwy pizzy, scenografia, o┼Ťwietlenie, companions, promocje) powstaje w
+                        <strong class="text-amber-400">Scene Studio</strong>.
+                        Tu w Menu Studio zarz─ůdzasz logik─ů dania ÔÇö ceny, modyfikatory, magazyn, profil kompozycji.
+                    </p>
+                    <div class="grid grid-cols-1 md:grid-cols-2 gap-3">
+                        <a id="btn-open-visual-director"
+                           href="../online_studio/index.html"
+                           target="_blank"
+                           rel="noopener"
+                           class="inline-flex items-center justify-center gap-2 bg-gradient-to-r from-amber-500 to-orange-600 hover:from-amber-400 hover:to-orange-500 text-black font-black uppercase tracking-wider text-[10px] px-4 py-3 rounded-xl transition-all shadow-lg shadow-amber-500/20">
+                            <i class="fa-solid fa-clapperboard"></i>
+                            Otw├│rz w Scene Studio
+                            <i class="fa-solid fa-arrow-up-right-from-square text-[8px] opacity-70"></i>
+                        </a>
+                        <button type="button" id="btn-autogenerate-scene"
+                                onclick="window.ItemEditor.autogenerateScene()"
+                                class="inline-flex items-center justify-center gap-2 bg-gradient-to-r from-violet-600 to-fuchsia-600 hover:from-violet-500 hover:to-fuchsia-500 text-white font-black uppercase tracking-wider text-[10px] px-4 py-3 rounded-xl transition-all shadow-lg shadow-violet-500/30 disabled:opacity-40 disabled:cursor-not-allowed">
+                            <i class="fa-solid fa-wand-magic-sparkles"></i>
+                            <span>Wygeneruj automatycznie</span>
+                        </button>
+                    </div>
+                    <div id="autogen-result" class="hidden mt-2 p-3 rounded-xl border text-[10px] font-bold leading-relaxed"></div>
+                    <p class="text-slate-600 text-[9px] font-bold uppercase tracking-widest">
+                        <i class="fa-solid fa-circle-info text-[8px] mr-1 opacity-40"></i>
+                        Auto-generator sk┼éada scen─Ö z hero dania + domy┼Ťlnych modyfikator├│w (NONE ┬Ě wp┼éyw wizualny ┬Ě layer_top_down).
+                        Zapisz danie, aby uruchomi─ç generator.
+                    </p>
                 </div>
-            </div>
+            `)}
 
-            <div class="grid grid-cols-1 gap-4 mt-4">
-                <div id="lock-item-kds-wrapper" class="flex flex-col gap-1.5 franchise-lockable">
-                    <label class="text-[10px] text-slate-400 font-bold uppercase tracking-wider">KDS Routing Station</label>
-                    <select id="item-kds-station-id" class="bg-black/50 border border-white/10 text-white rounded p-3 text-sm focus:border-blue-500 focus:ring-1 focus:ring-blue-500 focus:outline-none transition cursor-pointer">
-                        <option value="KITCHEN_1">Kuchnia Główna (KITCHEN_1)</option>
-                        <option value="BAR">Bar (BAR)</option>
-                        <option value="NONE">Brak (Nie drukuj)</option>
+            ${this._glassCard('sec-logistics', 'blue', 'fa-truck-fast', 'Logistyka i Battlefield Routing', `
+                <div class="grid grid-cols-2 gap-4">
+                    <div class="flex flex-col gap-1.5">
+                        <label class="text-[9px] text-slate-400 font-bold uppercase tracking-wider">Grupa Drukarek</label>
+                        <select id="item-printer-group" class="bg-black/50 border border-white/10 text-white rounded-xl p-3 text-sm focus:border-blue-500 focus:outline-none transition cursor-pointer">
+                            <option value="KITCHEN_1">Kuchnia Główna</option><option value="KITCHEN_2">Kuchnia 2</option><option value="BAR">Bar</option><option value="NONE">Brak</option>
+                        </select>
+                    </div>
+                    <div id="lock-item-kds-wrapper" class="flex flex-col gap-1.5 franchise-lockable">
+                        <label class="text-[9px] text-slate-400 font-bold uppercase tracking-wider">KDS Station</label>
+                        <select id="item-kds-station-id" class="bg-black/50 border border-white/10 text-white rounded-xl p-3 text-sm focus:border-blue-500 focus:outline-none transition cursor-pointer">
+                            <option value="KITCHEN_1">Kuchnia Główna</option><option value="BAR">Bar</option><option value="NONE">Brak</option>
+                        </select>
+                    </div>
+                </div>
+                <div class="mt-4 bg-black/30 rounded-xl p-4 border border-blue-500/10">
+                    <div class="flex items-center gap-2 mb-3">
+                        <i class="fa-solid fa-triangle-exclamation text-amber-400 text-[10px]"></i>
+                        <span class="text-[9px] text-amber-400 font-black uppercase tracking-wider">Ostrze┼╝enia dla Kierowcy / KDS</span>
+                    </div>
+                    <select id="item-driver-action-type" class="w-full bg-black/50 border border-white/10 text-white rounded-xl p-3 text-sm focus:border-amber-500 focus:ring-1 focus:ring-amber-500/30 focus:outline-none transition cursor-pointer">
+                        <option value="none">Brak (Standard)</option>
+                        <option value="pack_cold">ÔŁä´ŞĆ ZIMNE (Pakuj osobno do lod├│wki)</option>
+                        <option value="pack_separate">­čî┐ OSOBNO (Kruche / Nie k┼éad┼║ na gor─ůce)</option>
+                        <option value="check_id">­čö× DOKUMENTY (Sprawd┼║ wiek klienta)</option>
                     </select>
+                    <p class="text-[8px] text-slate-600 mt-2">Wybrany alert pojawi si─Ö na KDS i w aplikacji kierowcy przy kompletowaniu zam├│wienia.</p>
                 </div>
-            </div>
-
-            <div id="item-publication-panel" class="grid grid-cols-1 gap-3 border border-white/10 bg-black/30 rounded-xl p-4 mt-4">
-                <label class="text-[10px] text-slate-400 font-bold uppercase tracking-wider">Panel Publikacji</label>
-                <select id="item-publication-status" class="bg-black/50 border border-white/10 text-white rounded p-3 text-sm focus:border-blue-500 focus:ring-1 focus:ring-blue-500 focus:outline-none transition cursor-pointer">
-                    <option value="Draft">Draft</option>
-                    <option value="Live">Live</option>
-                    <option value="Archived">Archived</option>
-                </select>
-                <div class="grid grid-cols-2 gap-3">
-                    <div class="flex flex-col gap-1">
-                        <span class="text-[9px] text-slate-500 font-bold uppercase">validFrom</span>
-                        <input type="datetime-local" id="item-valid-from" class="bg-black/50 border border-white/10 text-white rounded p-2.5 text-xs focus:border-blue-500 focus:ring-1 focus:ring-blue-500 focus:outline-none transition">
+                <div class="grid grid-cols-3 gap-4 mt-4">
+                    <div class="flex flex-col gap-1.5">
+                        <label class="text-[9px] text-slate-400 font-bold uppercase tracking-wider">PLU Code</label>
+                        <input type="text" id="item-plu-code" class="bg-black/50 border border-white/10 text-white rounded-xl p-3 text-sm focus:border-blue-500 focus:outline-none transition font-mono" placeholder="np. 12345">
                     </div>
-                    <div class="flex flex-col gap-1">
-                        <span class="text-[9px] text-slate-500 font-bold uppercase">validTo</span>
-                        <input type="datetime-local" id="item-valid-to" class="bg-black/50 border border-white/10 text-white rounded p-2.5 text-xs focus:border-blue-500 focus:ring-1 focus:ring-blue-500 focus:outline-none transition">
+                    <div class="flex flex-col gap-1.5">
+                        <label class="text-[9px] text-slate-400 font-bold uppercase tracking-wider">Kolejno┼Ť─ç</label>
+                        <input type="number" id="item-display-order" min="0" value="0" class="bg-black/50 border border-white/10 text-white rounded-xl p-3 text-sm focus:border-blue-500 focus:outline-none transition text-center">
+                    </div>
+                    <div class="flex flex-col gap-1.5">
+                        <label class="text-[9px] text-slate-400 font-bold uppercase tracking-wider">Stan Mag. <span class="text-slate-600">(-1=Ôł×)</span></label>
+                        <input type="number" id="item-stock-count" value="-1" class="bg-black/50 border border-white/10 text-white rounded-xl p-3 text-sm focus:border-blue-500 focus:outline-none transition text-center">
                     </div>
                 </div>
-            </div>
+            `)}
 
-            <div class="grid grid-cols-1 gap-3 border border-white/10 bg-black/30 rounded-xl p-4 mt-4">
-                <label class="text-[10px] text-slate-400 font-bold uppercase tracking-wider">Prezentacja Wizualna</label>
-                <div id="lock-item-description-wrapper" class="flex flex-col gap-1 franchise-lockable">
-                    <span class="text-[9px] text-slate-500 font-bold uppercase">Opis Dania (Menu/Kiosk)</span>
-                    <textarea id="item-description" rows="4" class="bg-black/50 border border-white/10 text-white rounded p-3 text-sm focus:border-blue-500 focus:ring-1 focus:ring-blue-500 focus:outline-none transition resize-none" placeholder="Opis widoczny na menu/kiosku"></textarea>
+            ${this._glassCard('sec-schedule', 'emerald', 'fa-calendar-days', 'Harmonogram i Dost─Öpno┼Ť─ç', `
+                <div class="grid grid-cols-2 gap-4">
+                    <div class="flex flex-col gap-1.5">
+                        <label class="text-[9px] text-slate-400 font-bold uppercase tracking-wider">Wa┼╝ne od</label>
+                        <input type="datetime-local" id="item-valid-from" class="bg-black/50 border border-white/10 text-white rounded-xl p-3 text-sm focus:border-emerald-500 focus:outline-none transition">
+                    </div>
+                    <div class="flex flex-col gap-1.5">
+                        <label class="text-[9px] text-slate-400 font-bold uppercase tracking-wider">Wa┼╝ne do</label>
+                        <input type="datetime-local" id="item-valid-to" class="bg-black/50 border border-white/10 text-white rounded-xl p-3 text-sm focus:border-emerald-500 focus:outline-none transition">
+                    </div>
                 </div>
-                <div id="lock-item-image-url-wrapper" class="flex flex-col gap-1 franchise-lockable">
-                    <span class="text-[9px] text-slate-500 font-bold uppercase">URL Zdj─Öcia (Media)</span>
-                    <input type="text" id="item-image-url" class="bg-black/50 border border-white/10 text-white rounded p-3 text-sm focus:border-blue-500 focus:ring-1 focus:ring-blue-500 focus:outline-none transition" placeholder="https://cdn.twojadomena.pl/menu/pizza.jpg">
+                <div class="mt-4">
+                    <label class="text-[9px] text-slate-400 font-bold uppercase tracking-wider block mb-2">Dni Serwowania</label>
+                    <div class="flex gap-2" id="available-days-container">${daysCheckboxes}</div>
                 </div>
-            </div>
+                <div class="grid grid-cols-2 gap-4 mt-4">
+                    <div class="flex flex-col gap-1.5">
+                        <label class="text-[9px] text-slate-400 font-bold uppercase tracking-wider">Dost─Öpne od godziny</label>
+                        <input type="time" id="item-available-start" class="bg-black/50 border border-white/10 text-white rounded-xl p-3 text-sm focus:border-emerald-500 focus:outline-none transition">
+                    </div>
+                    <div class="flex flex-col gap-1.5">
+                        <label class="text-[9px] text-slate-400 font-bold uppercase tracking-wider">Dost─Öpne do godziny</label>
+                        <input type="time" id="item-available-end" class="bg-black/50 border border-white/10 text-white rounded-xl p-3 text-sm focus:border-emerald-500 focus:outline-none transition">
+                    </div>
+                </div>
+            `)}
 
-            <div id="lock-item-tags-wrapper" class="grid grid-cols-1 gap-2 border border-white/10 bg-black/30 rounded-xl p-4 mt-4 franchise-lockable">
-                <label class="text-[10px] text-slate-400 font-bold uppercase tracking-wider">AI Upsell & Marketing</label>
-                <input type="text" id="item-marketing-tags" class="bg-black/50 border border-white/10 text-white rounded p-3 text-sm focus:border-blue-500 focus:ring-1 focus:ring-blue-500 focus:outline-none transition font-mono" placeholder="[ZIMNY_NAPOJ] [BESTSELLER]">
-                <hr class="border-white/5 my-2">
-                <div class="flex flex-col gap-2">
-                    <span class="text-[10px] text-slate-400 font-bold uppercase tracking-wider">Kody QR</span>
-                    <input type="text" id="item-qr-link" class="bg-black/30 border border-white/10 text-slate-400 rounded p-2 text-xs w-full mb-2" readonly>
-                    <button type="button" class="w-full bg-slate-800 hover:bg-slate-700 text-white text-xs py-2 rounded transition"><i class="fa-solid fa-qrcode mr-2"></i>Generuj / Pobierz QR</button>
+            ${this._glassCard('sec-marketing', 'rose', 'fa-bullhorn', 'E-commerce i Marketing', `
+                <div id="lock-item-description-wrapper" class="flex flex-col gap-1.5 franchise-lockable">
+                    <label class="text-[9px] text-slate-400 font-bold uppercase tracking-wider">Opis Dania (Menu / Kiosk)</label>
+                    <textarea id="item-description" rows="3" class="bg-black/50 border border-white/10 text-white rounded-xl p-3 text-sm focus:border-rose-500 focus:outline-none transition resize-none" placeholder="Opis widoczny na menu/kiosku"></textarea>
+                </div>
+                <div class="flex flex-col gap-1.5 mt-4">
+                    <label class="text-[9px] text-slate-400 font-bold uppercase tracking-wider">Odznaka (Badge)</label>
+                    <select id="item-badge-type" class="bg-black/50 border border-white/10 text-white rounded-xl p-3 text-sm focus:border-rose-500 focus:outline-none transition cursor-pointer">
+                        <option value="none">Brak</option><option value="new">­čćĽ NOWO┼Ü─ć</option><option value="promo">­čöą PROMO</option><option value="bestseller">ÔşÉ BESTSELLER</option><option value="hot">­čî´ŞĆ HOT</option>
+                    </select>
+                </div>
+                <div id="lock-item-tags-wrapper" class="flex flex-col gap-1.5 mt-4 franchise-lockable">
+                    <label class="text-[9px] text-slate-400 font-bold uppercase tracking-wider">Tagi Marketingowe</label>
+                    <input type="text" id="item-marketing-tags" class="bg-black/50 border border-white/10 text-white rounded-xl p-3 text-sm focus:border-rose-500 focus:outline-none transition font-mono" placeholder="wege,ostre,bezglutenowe">
                 </div>
-            </div>
 
-            <div class="pt-5 mt-4 border-t border-white/5">
-                <button type="button" onclick="window.ItemEditor.saveItem()" class="w-full bg-blue-600 hover:bg-blue-500 active:bg-blue-700 text-white font-black text-xs uppercase tracking-widest py-3 px-4 rounded transition shadow-[0_0_15px_rgba(37,99,235,0.3)] hover:shadow-[0_0_25px_rgba(37,99,235,0.5)]">
-                    <i class="fa-solid fa-floppy-disk mr-2"></i> Zapisz Danie
-                </button>
-            </div>
-        `;
+                <!-- M022: Legacy URL schowany pod details ÔÇö integracje zewn─Ötrzne mog─ů nadal pisa─ç -->
+                <details class="mt-4 bg-black/30 rounded-xl border border-white/5 overflow-hidden">
+                    <summary class="cursor-pointer select-none text-[9px] text-slate-500 font-bold uppercase tracking-widest p-3 hover:bg-white/5 transition">
+                        <i class="fa-solid fa-gear text-[8px] mr-1 opacity-40"></i>
+                        Opcje zaawansowane ÔÇö integracje zewn─Ötrzne
+                    </summary>
+                    <div id="lock-item-image-url-wrapper" class="flex flex-col gap-1.5 franchise-lockable p-4 pt-1">
+                        <label class="text-[9px] text-slate-500 font-bold uppercase tracking-wider">Legacy URL zdj─Öcia <span class="text-slate-700">(dla integracji, kt├│re nie u┼╝ywaj─ů Scene Studio)</span></label>
+                        <input type="text" id="item-image-url" class="bg-black/50 border border-white/10 text-white rounded-xl p-3 text-sm focus:border-rose-500 focus:outline-none transition font-mono" placeholder="https://cdn.../pizza.jpg">
+                        <p class="text-slate-700 text-[8px] leading-relaxed mt-1">
+                            <i class="fa-solid fa-circle-info text-[7px] mr-1 opacity-40"></i>
+                            Uzupełnij tylko gdy zewnętrzny system (integracja POS/dostawy/kurier) oczekuje URL. Scene Studio i tak nadpisze to hero automatycznie.
+                        </p>
+                    </div>
+                </details>
+            `)}
 
-        const enterprisePanel = `
-<div class="bg-[#0a0a0f]/80 border border-emerald-500/30 p-6 rounded-2xl mt-4 mb-6 shadow-[0_0_20px_rgba(16,185,129,0.05)] relative overflow-hidden group hover:border-emerald-500/50 transition-all">
-    <div class="absolute top-0 left-0 w-full h-1 bg-gradient-to-r from-emerald-500 to-cyan-500"></div>
-    <h5 class="text-[10px] text-emerald-400 font-bold uppercase tracking-wider mb-4 flex items-center gap-2">
-        <i class="fa-solid fa-bolt"></i> Enterprise Settings (Retail & Warianty)
-    </h5>
-    
-    <div class="grid grid-cols-1 md:grid-cols-2 gap-4 mb-4">
-        <div class="flex flex-col gap-1.5">
-            <label class="text-[10px] text-slate-400 font-bold uppercase tracking-wider">Kod Kreskowy (EAN)</label>
-            <div class="relative">
-                <i class="fa-solid fa-barcode absolute left-3 top-1/2 -translate-y-1/2 text-slate-500"></i>
-                <input type="text" id="item-barcode-ean" class="w-full bg-black/60 border border-white/10 text-emerald-300 rounded p-3 pl-10 text-sm focus:border-emerald-500 focus:outline-none transition" placeholder="np. 590123456789">
-            </div>
-        </div>
-        
-        <div class="flex flex-col gap-1.5">
-            <label class="text-[10px] text-slate-400 font-bold uppercase tracking-wider">Parent SKU (Danie Główne)</label>
-            <div class="relative">
-                <i class="fa-solid fa-link absolute left-3 top-1/2 -translate-y-1/2 text-slate-500"></i>
-                <input type="text" id="item-parent-sku" class="w-full bg-black/60 border border-white/10 text-cyan-300 rounded p-3 pl-10 text-sm focus:border-cyan-500 focus:outline-none transition" placeholder="np. PIZZA_MARGHERITA_MASTER">
-            </div>
-            <span class="text-[9px] text-slate-500">Zostaw puste dla standardowych dań.</span>
-        </div>
-    </div>
-
-    <div class="flex flex-col gap-2">
-         <label class="text-[10px] text-slate-400 font-bold uppercase tracking-wider flex items-center justify-between">
-            <span>Alergeny Prawne (UE)</span>
-            <span class="text-[8px] bg-emerald-500/20 text-emerald-400 px-2 py-0.5 rounded">Etykieta Informacyjna</span>
-         </label>
-         <div class="flex flex-wrap gap-2" id="allergens-container">
-            ${['Gluten', 'Laktoza', 'Orzechy', 'Skorupiaki', 'Jaja', 'Ryby', 'Soja', 'Seler', 'Gorczyca', 'Sezam', 'Mi─Öczaki'].map(alg => `
-                <label class="cursor-pointer group relative">
-                    <input type="checkbox" class="peer sr-only allergen-checkbox" value="${alg}">
-                    <div class="bg-black/50 border border-white/10 text-slate-400 text-xs px-3 py-1.5 rounded-lg peer-checked:bg-emerald-900/40 peer-checked:border-emerald-500/50 peer-checked:text-emerald-300 transition-all hover:border-white/30">
-                        ${alg}
+            ${this._glassCard('sec-enterprise', 'emerald', 'fa-bolt', 'Enterprise Settings (Retail & Warianty)', `
+                <div class="grid grid-cols-2 gap-4">
+                    <div class="flex flex-col gap-1.5">
+                        <label class="text-[9px] text-slate-400 font-bold uppercase tracking-wider">Kod Kreskowy (EAN)</label>
+                        <div class="relative">
+                            <i class="fa-solid fa-barcode absolute left-3 top-1/2 -translate-y-1/2 text-slate-500"></i>
+                            <input type="text" id="item-barcode-ean" class="w-full bg-black/50 border border-white/10 text-emerald-300 rounded-xl p-3 pl-10 text-sm focus:border-emerald-500 focus:outline-none transition" placeholder="590123456789">
+                        </div>
                     </div>
-                </label>
-            `).join('')}
-         </div>
-    </div>
-</div>
-`;
-        const marketingTagsWrapper = document.getElementById('lock-item-tags-wrapper');
-        if (marketingTagsWrapper) {
-            marketingTagsWrapper.insertAdjacentHTML('beforebegin', enterprisePanel);
+                    <div class="flex flex-col gap-1.5">
+                        <label class="text-[9px] text-slate-400 font-bold uppercase tracking-wider">Parent SKU</label>
+                        <div class="relative">
+                            <i class="fa-solid fa-link absolute left-3 top-1/2 -translate-y-1/2 text-slate-500"></i>
+                            <input type="text" id="item-parent-sku" class="w-full bg-black/50 border border-white/10 text-cyan-300 rounded-xl p-3 pl-10 text-sm focus:border-cyan-500 focus:outline-none transition" placeholder="PIZZA_MASTER">
+                        </div>
+                    </div>
+                </div>
+                <div class="mt-4">
+                    <label class="text-[9px] text-slate-400 font-bold uppercase tracking-wider flex items-center justify-between mb-2">
+                        <span>Alergeny (UE)</span>
+                        <span class="text-[8px] bg-emerald-500/20 text-emerald-400 px-2 py-0.5 rounded">Etykieta Informacyjna</span>
+                    </label>
+                    <div class="flex flex-wrap gap-2" id="allergens-container">${allergensHtml}</div>
+                </div>
+            `)}
+        `;
+
+        this._bindAllEvents();
+        this._setupScrollSpy();
+        form.dataset.omnichannelReady = '1';
+    },
+
+    _renderModifierGroupCheckboxes() {
+        const groups = window.StudioState?.modifierGroups || [];
+        if (!groups.length) return '<div class="text-slate-500 text-[9px] font-bold uppercase col-span-full">Brak grup modyfikator├│w w systemie.</div>';
+        return groups.map(g =>
+            `<label class="flex items-center gap-3 cursor-pointer group hover:bg-white/5 p-2.5 rounded-xl transition border border-transparent hover:border-white/10">
+                <input type="checkbox" class="modifier-group-checkbox w-4 h-4 rounded border-white/10 bg-black/50 text-purple-500 focus:ring-purple-500 cursor-pointer" value="${g.id}" id="modGroup_${g.id}">
+                <span class="text-[10px] text-white font-bold group-hover:text-purple-300 transition">${g.name}</span>
+            </label>`
+        ).join('');
+    },
+
+    _bindAllEvents() {
+        const nameInput = document.getElementById('item-name');
+        const asciiInput = document.getElementById('item-ascii-key');
+        if (nameInput && asciiInput) {
+            nameInput.addEventListener('input', () => {
+                this.debounce('name-slug', () => {
+                    const currentId = document.getElementById('item-id')?.value || '0';
+                    if (currentId === '0' || currentId === '') {
+                        asciiInput.value = this.toAutoSlug(nameInput.value);
+                    }
+                }, 300);
+            });
         }
 
-        let modifierGroupsHtml = `
-<div class="bg-[#0a0a0f]/60 border border-purple-500/20 p-6 rounded-2xl mb-6 shadow-[0_0_15px_rgba(168,85,247,0.05)]">
-    <h5 class="text-[10px] text-purple-400 font-bold uppercase tracking-wider mb-4">Powi─ůzane Grupy Modyfikator├│w</h5>
-    <div class="grid grid-cols-2 md:grid-cols-3 gap-3" id="modifierGroupsCheckboxContainer">`;
-
-        if (window.StudioState && window.StudioState.modifierGroups && window.StudioState.modifierGroups.length > 0) {
-            window.StudioState.modifierGroups.forEach(group => {
-                modifierGroupsHtml += `
-            <label class="flex items-center gap-3 cursor-pointer group hover:bg-white/5 p-2 rounded-lg transition-colors border border-transparent hover:border-white/10">
-                <input type="checkbox" class="modifier-group-checkbox w-4 h-4 rounded border-white/10 bg-black/50 text-purple-500 focus:ring-purple-500 focus:ring-offset-gray-900 cursor-pointer" value="${group.id}" id="modGroup_${group.id}">
-                <span class="text-xs text-white font-bold group-hover:text-purple-300 transition-colors">${group.name}</span>
-            </label>
-        `;
+        const catSelect = document.getElementById('item-category-id');
+        if (catSelect) {
+            catSelect.addEventListener('change', () => {
+                const catId = parseInt(catSelect.value, 10);
+                const cat = (window.StudioState?.categories || []).find(c => c.id === catId);
+                if (!cat) return;
+                if (this._vatInheritEnabled) {
+                    const vatDI = document.getElementById('item-vat-dine-in');
+                    const vatTA = document.getElementById('item-vat-takeaway');
+                    if (vatDI) vatDI.value = cat.defaultVatDineIn ?? 8;
+                    if (vatTA) vatTA.value = cat.defaultVatTakeaway ?? 5;
+                }
+                const pg = document.getElementById('item-printer-group');
+                if (pg) {
+                    const n = (cat.name || '').toLowerCase();
+                    pg.value = (n.includes('napoj') || n.includes('drink') || n.includes('piwo') || n.includes('koktajl')) ? 'BAR' : 'KITCHEN_1';
+                }
             });
-        } else {
-            modifierGroupsHtml += '<div class="col-span-full text-slate-500 text-xs font-bold uppercase">Brak grup modyfikator├│w w systemie.</div>';
         }
-        modifierGroupsHtml += `</div></div>`;
-        const publicationPanel = document.getElementById('item-publication-panel');
-        if (publicationPanel) {
-            publicationPanel.insertAdjacentHTML('beforebegin', modifierGroupsHtml);
-        } else {
-            form.insertAdjacentHTML('beforeend', modifierGroupsHtml);
+
+        const vatCb = document.getElementById('item-vat-inherit');
+        if (vatCb) {
+            vatCb.addEventListener('change', () => {
+                this.toggleVatInherit(vatCb.checked);
+                if (vatCb.checked) catSelect?.dispatchEvent(new Event('change'));
+            });
         }
 
-        // Magia Auto-SKU
-        const nameInput = document.getElementById('item-name');
-        const asciiInput = document.getElementById('item-ascii-key');
-        if(nameInput && asciiInput) {
-            nameInput.addEventListener('input', (e) => {
-                const currentId = document.getElementById('item-id') ? document.getElementById('item-id').value : '0';
-                if(currentId === '0' || currentId === '') {
-                    asciiInput.value = window.ItemEditor.toAutoSlug(e.target.value);
+        const validFrom = document.getElementById('item-valid-from');
+        const validTo = document.getElementById('item-valid-to');
+        if (validFrom && validTo) {
+            validFrom.addEventListener('change', () => {
+                if (validFrom.value) {
+                    validTo.min = validFrom.value;
+                    if (validTo.value && validTo.value < validFrom.value) validTo.value = validFrom.value;
+                } else {
+                    validTo.min = '';
                 }
             });
         }
 
-        form.dataset.omnichannelReady = '1';
+        ['item-description', 'item-marketing-tags'].forEach(id => {
+            const el = document.getElementById(id);
+            if (el) el.addEventListener('input', () => this.debounce(id, () => {}, 500));
+        });
     },
 
-    applyFranchiseShield: function(isLockedByHq) {
+    applyFranchiseShield(isLockedByHq) {
         const lockTargets = [
             { wrapperId: 'lock-item-name-wrapper', inputId: 'item-name' },
             { wrapperId: 'lock-item-description-wrapper', inputId: 'item-description' },
@@ -227,12 +577,10 @@ window.ItemEditor = {
             { wrapperId: 'lock-item-kds-wrapper', inputId: 'item-kds-station-id' },
             { wrapperId: 'lock-item-tags-wrapper', inputId: 'item-marketing-tags' }
         ];
-
         lockTargets.forEach(target => {
             const wrapper = document.getElementById(target.wrapperId);
             const input = document.getElementById(target.inputId);
             if (!wrapper || !input) return;
-
             if (isLockedByHq) {
                 wrapper.classList.add('pointer-events-none', 'opacity-50');
                 input.disabled = true;
@@ -241,192 +589,587 @@ window.ItemEditor = {
                 input.disabled = false;
             }
         });
+        const hqFlag = document.getElementById('hq-lock-flag');
+        if (hqFlag) hqFlag.classList.toggle('hidden', !isLockedByHq);
+        if (hqFlag && isLockedByHq) hqFlag.classList.add('flex');
     },
 
-    loadItemDataToForm: function(itemData) {
+    loadItemDataToForm(itemData) {
         this.ensureOmnichannelForm();
 
-        const idField = document.getElementById('item-id');
-        const nameField = document.getElementById('item-name');
-        const asciiKeyField = document.getElementById('item-ascii-key');
-        const categoryIdField = document.getElementById('item-category-id');
-        const vatField = document.getElementById('item-vat-rate');
-
-        // --- ŁATKA: Ładowanie kategorii do wyboru u źródła ---
-        if (categoryIdField && categoryIdField.options.length <= 1) {
-            const categories = window.StudioState?.categories || [];
-            categories.forEach(cat => {
-                categoryIdField.add(new Option(cat.name, cat.id));
-            });
+        const $ = id => document.getElementById(id);
+        const categories = window.StudioState?.categories || [];
+
+        const catSelect = $('item-category-id');
+        if (catSelect && catSelect.options.length <= 1) {
+            categories.forEach(cat => catSelect.add(new Option(cat.name, cat.id)));
         }
-        // -----------------------------------------------------
-        const posPriceField = document.getElementById('item-price-pos');
-        const takeawayPriceField = document.getElementById('item-price-takeaway');
-        const deliveryPriceField = document.getElementById('item-price-delivery');
-        const kdsField = document.getElementById('item-kds-station-id');
-        const publicationStatusField = document.getElementById('item-publication-status');
-        const validFromField = document.getElementById('item-valid-from');
-        const validToField = document.getElementById('item-valid-to');
-        const descriptionField = document.getElementById('item-description');
-        const imageUrlField = document.getElementById('item-image-url');
-        const marketingTagsField = document.getElementById('item-marketing-tags');
-        const qrLinkField = document.getElementById('item-qr-link');
 
         const matrix = itemData.priceMatrix || {};
 
-        if (idField) idField.value = itemData.id || 0;
-        if (nameField) nameField.value = itemData.name || '';
+        $('item-id').value = itemData.id || 0;
+        if ($('item-name')) $('item-name').value = itemData.name || '';
 
-        if (asciiKeyField) {
-            asciiKeyField.value = itemData.asciiKey || '';
-            if (itemData.id > 0) {
-                asciiKeyField.disabled = true;
-                asciiKeyField.classList.add('cursor-not-allowed', 'opacity-50');
-            } else {
-                asciiKeyField.disabled = false;
-                asciiKeyField.classList.remove('cursor-not-allowed', 'opacity-50');
-            }
+        const asciiField = $('item-ascii-key');
+        if (asciiField) {
+            asciiField.value = itemData.asciiKey || '';
+            asciiField.disabled = itemData.id > 0;
+            asciiField.classList.toggle('cursor-not-allowed', itemData.id > 0);
+            asciiField.classList.toggle('opacity-50', itemData.id > 0);
+        }
+
+        if (catSelect) catSelect.value = itemData.categoryId || 0;
+
+        this.setItemType(itemData.type || 'standard');
+        this.setPubStatus(itemData.publicationStatus || (itemData.isActive ? 'Live' : 'Draft'));
+
+        const secretCb = $('item-is-secret');
+        if (secretCb) secretCb.checked = !!itemData.isSecret;
+
+        if ($('item-vat-dine-in')) $('item-vat-dine-in').value = itemData.vatRateDineIn ?? 8;
+        if ($('item-vat-takeaway')) $('item-vat-takeaway').value = itemData.vatRateTakeaway ?? 5;
+
+        const vatCb = $('item-vat-inherit');
+        const cat = categories.find(c => c.id == (itemData.categoryId || 0));
+        if (vatCb && cat) {
+            const inherited = (parseFloat(itemData.vatRateDineIn) === parseFloat(cat.defaultVatDineIn ?? 8))
+                           && (parseFloat(itemData.vatRateTakeaway) === parseFloat(cat.defaultVatTakeaway ?? 5));
+            vatCb.checked = inherited;
+            this.toggleVatInherit(inherited);
         }
 
-        if (categoryIdField) categoryIdField.value = itemData.categoryId || 0;
-        if (vatField) vatField.value = itemData.vatRate || 23;
-        if (posPriceField) posPriceField.value = matrix.POS !== undefined ? matrix.POS : (itemData.price || 0.00);
-        if (takeawayPriceField) takeawayPriceField.value = matrix.Takeaway !== undefined ? matrix.Takeaway : (itemData.priceTakeaway || 0.00);
-        if (deliveryPriceField) deliveryPriceField.value = matrix.Delivery !== undefined ? matrix.Delivery : (itemData.priceDelivery || 0.00);
-        if (kdsField) kdsField.value = itemData.kdsStationId || itemData.printerStation || 'NONE';
-        if (publicationStatusField) publicationStatusField.value = itemData.publicationStatus || (itemData.isActive ? 'Live' : 'Draft');
-        if (validFromField) validFromField.value = itemData.validFrom || '';
-        if (validToField) validToField.value = itemData.validTo || '';
-        if (descriptionField) descriptionField.value = itemData.description || '';
-        if (imageUrlField) imageUrlField.value = itemData.imageUrl || '';
-        if (marketingTagsField) marketingTagsField.value = itemData.marketingTags || '';
-        if (qrLinkField) qrLinkField.value = `https://menu.slicehub.app/item/${itemData.asciiKey || ''}`;
-
-        const barcodeEanField = document.getElementById('item-barcode-ean');
-        const parentSkuField = document.getElementById('item-parent-sku');
-        if (barcodeEanField) barcodeEanField.value = itemData.barcodeEan || '';
-        if (parentSkuField) parentSkuField.value = itemData.parentSku || '';
+        if ($('item-price-pos')) $('item-price-pos').value = matrix.POS !== undefined ? parseFloat(matrix.POS).toFixed(2) : (itemData.price || '0.00');
+        if ($('item-price-takeaway')) $('item-price-takeaway').value = matrix.Takeaway !== undefined ? parseFloat(matrix.Takeaway).toFixed(2) : (itemData.priceTakeaway || '0.00');
+        if ($('item-price-delivery')) $('item-price-delivery').value = matrix.Delivery !== undefined ? parseFloat(matrix.Delivery).toFixed(2) : (itemData.priceDelivery || '0.00');
+
+        if ($('item-printer-group')) $('item-printer-group').value = itemData.printerGroup || 'KITCHEN_1';
+        if ($('item-kds-station-id')) $('item-kds-station-id').value = itemData.kdsStationId || 'NONE';
+        if ($('item-driver-action-type')) $('item-driver-action-type').value = itemData.driverActionType || 'none';
+        if ($('item-plu-code')) $('item-plu-code').value = itemData.pluCode || '';
+        if ($('item-display-order')) $('item-display-order').value = itemData.displayOrder ?? 0;
+        if ($('item-stock-count')) $('item-stock-count').value = itemData.stockCount ?? -1;
+
+        if ($('item-valid-from')) $('item-valid-from').value = itemData.validFrom || '';
+        if ($('item-valid-to')) $('item-valid-to').value = itemData.validTo || '';
+        if ($('item-available-start')) $('item-available-start').value = itemData.availableStart || '';
+        if ($('item-available-end')) $('item-available-end').value = itemData.availableEnd || '';
+
+        const days = (itemData.availableDays || '1,2,3,4,5,6,7').split(',').map(d => d.trim());
+        document.querySelectorAll('.day-checkbox').forEach(cb => {
+            cb.checked = days.includes(cb.value);
+        });
+
+        if ($('item-description')) $('item-description').value = itemData.description || '';
+        if ($('item-image-url')) $('item-image-url').value = itemData.imageUrl || '';
+        if ($('item-badge-type')) $('item-badge-type').value = itemData.badgeType || 'none';
+        if ($('item-marketing-tags')) $('item-marketing-tags').value = itemData.marketingTags || '';
+
+        // M022: composition profile + hero preview + scene badge
+        this._applyCompositionProfile(itemData);
+        this._applyHeroPreview(itemData);
+
+        if ($('item-barcode-ean')) $('item-barcode-ean').value = itemData.barcodeEan || '';
+        if ($('item-parent-sku')) $('item-parent-sku').value = itemData.parentSku || '';
+
         document.querySelectorAll('.allergen-checkbox').forEach(cb => { cb.checked = false; });
         if (Array.isArray(itemData.allergens)) {
             itemData.allergens.forEach(alg => {
-                const checkbox = document.querySelector(`.allergen-checkbox[value="${alg}"]`);
-                if (checkbox) checkbox.checked = true;
+                const cb = document.querySelector(`.allergen-checkbox[value="${alg}"]`);
+                if (cb) cb.checked = true;
             });
         }
 
         document.querySelectorAll('.modifier-group-checkbox').forEach(cb => { cb.checked = false; });
-        if (itemData.modifierGroupIds && Array.isArray(itemData.modifierGroupIds)) {
-            itemData.modifierGroupIds.forEach(groupId => {
-                const checkbox = document.getElementById(`modGroup_${groupId}`);
-                if (checkbox) checkbox.checked = true;
+        if (Array.isArray(itemData.modifierGroupIds)) {
+            itemData.modifierGroupIds.forEach(gid => {
+                const cb = document.getElementById(`modGroup_${gid}`);
+                if (cb) cb.checked = true;
             });
         }
 
         this.applyFranchiseShield(!!itemData.isLockedByHq);
+
+        const directorBtn = document.getElementById('btn-open-visual-director');
+        if (directorBtn) {
+            if (itemData.id > 0 && itemData.asciiKey) {
+                directorBtn.href = `../online_studio/index.html?tab=director&item=${encodeURIComponent(itemData.asciiKey)}`;
+                directorBtn.classList.remove('opacity-50', 'pointer-events-none');
+            } else {
+                directorBtn.href = '../online_studio/index.html';
+            }
+        }
     },
 
-    saveItem: async function() {
-        this.ensureOmnichannelForm();
+    // ÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉ
+    // M022: Composition Profile + Hero Preview (Scene Studio integration)
+    // ÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉ
 
-        const idField = document.getElementById('item-id');
-        const nameField = document.getElementById('item-name');
-        const asciiKeyField = document.getElementById('item-ascii-key');
-        const categoryIdField = document.getElementById('item-category-id');
-        const vatField = document.getElementById('item-vat-rate');
-        const posPriceField = document.getElementById('item-price-pos');
-        const takeawayPriceField = document.getElementById('item-price-takeaway');
-        const deliveryPriceField = document.getElementById('item-price-delivery');
-        const kdsField = document.getElementById('item-kds-station-id');
-        const publicationStatusField = document.getElementById('item-publication-status');
-        const validFromField = document.getElementById('item-valid-from');
-        const validToField = document.getElementById('item-valid-to');
-        const descriptionField = document.getElementById('item-description');
-        const imageUrlField = document.getElementById('item-image-url');
-        const marketingTagsField = document.getElementById('item-marketing-tags');
-
-        const itemId = idField ? parseInt(idField.value, 10) || 0 : 0;
-        const name = nameField ? nameField.value.trim() : '';
-        const rawAsciiKey = asciiKeyField ? asciiKeyField.value : '';
-        const cleanKey = rawAsciiKey.replace(/[^a-zA-Z0-9_-]/g, '').toUpperCase();
-        const categoryId = categoryIdField ? parseInt(categoryIdField.value, 10) || 0 : 0;
-        const vatRate = vatField ? parseFloat(vatField.value) || 0.00 : 0.00;
-
-        const pricePos = posPriceField ? parseFloat(posPriceField.value) || 0.00 : 0.00;
-        const priceTakeaway = takeawayPriceField ? parseFloat(takeawayPriceField.value) || 0.00 : 0.00;
-        const priceDelivery = deliveryPriceField ? parseFloat(deliveryPriceField.value) || 0.00 : 0.00;
-
-        const kdsStationId = kdsField ? kdsField.value : 'NONE';
-        const publicationStatus = publicationStatusField ? publicationStatusField.value : 'Draft';
-        const validFrom = validFromField ? validFromField.value : '';
-        const validTo = validToField ? validToField.value : '';
-        const description = descriptionField ? descriptionField.value.trim() : '';
-        const imageUrl = imageUrlField ? imageUrlField.value.trim() : '';
-        const marketingTags = marketingTagsField ? marketingTagsField.value.trim() : '';
-
-        if (typeof window.SliceValidator !== 'undefined' && typeof window.SliceValidator.validatePrice === 'function') {
-            const priceMatrixToValidate = [pricePos, priceTakeaway, priceDelivery];
-            for (let i = 0; i < priceMatrixToValidate.length; i++) {
-                const validationResult = window.SliceValidator.validatePrice(priceMatrixToValidate[i]);
-                if (validationResult && validationResult.error) {
-                    alert("B┼é─ůd walidacji ceny: " + validationResult.message);
-                    return;
-                }
-            }
+    _applyCompositionProfile(itemData) {
+        const sel = document.getElementById('item-composition-profile');
+        if (!sel) return;
+
+        const templates = (window.StudioState?.sceneTemplates || []).filter(t => t.kind === 'item');
+        if (templates.length > 0) {
+            sel.innerHTML = templates.map(t =>
+                `<option value="${this._esc(t.asciiKey)}">${this._esc(t.name)}</option>`
+            ).join('');
         }
+        // Determine target value: item-level > category default > 'static_hero'
+        let target = (itemData && itemData.compositionProfile) || null;
+        if (!target) {
+            const catId = parseInt(itemData?.categoryId ?? document.getElementById('item-category-id')?.value, 10);
+            const cat = (window.StudioState?.categories || []).find(c => c.id === catId);
+            target = cat?.defaultCompositionProfile || 'static_hero';
+        }
+        // Fallback ÔÇö je┼Ťli target nie jest w dropdown-ie, ustaw static_hero
+        const options = Array.from(sel.options).map(o => o.value);
+        if (!options.includes(target)) target = options.includes('static_hero') ? 'static_hero' : options[0];
+        sel.value = target;
+
+        this._updateCompositionHint(sel.value);
+
+        if (!sel.dataset.bound) {
+            sel.addEventListener('change', () => this._updateCompositionHint(sel.value));
+            sel.dataset.bound = '1';
+        }
+    },
+
+    _updateCompositionHint(profile) {
+        const hint = document.getElementById('item-composition-hint');
+        if (!hint) return;
+        const map = {
+            'pizza_top_down':                   'Warstwy (sp├│d, sos, ser, dodatki) renderowane z g├│ry w Scene Studio.',
+            'static_hero':                      'Danie renderowane z jednego zdj─Öcia (burger, makaron, napoje).',
+            'pasta_bowl_placeholder':           'Placeholder ÔÇö pe┼éna scena w Fazie 2.',
+            'beverage_bottle_placeholder':      'Placeholder ÔÇö pe┼éna scena w Fazie 2.',
+            'burger_three_quarter_placeholder': 'Placeholder ÔÇö pe┼éna scena w Fazie 2.',
+            'sushi_top_down_placeholder':       'Placeholder ÔÇö pe┼éna scena w Fazie 2.',
+        };
+        hint.textContent = map[profile] || 'Profil kompozycji dla Scene Studio.';
+    },
+
+    _applyHeroPreview(itemData) {
+        const img      = document.getElementById('item-hero-preview-img');
+        const ph       = document.getElementById('item-hero-preview-placeholder');
+        const badge    = document.getElementById('item-hero-scene-badge');
+        const unlinkBtn= document.getElementById('btn-item-hero-unlink');
+        const pickLabel= document.getElementById('btn-item-hero-pick-label');
+        if (!img || !ph || !badge) return;
+
+        const url = (itemData && itemData.imageUrl) ? itemData.imageUrl : '';
+        if (url) {
+            img.src = url;
+            img.classList.remove('hidden');
+            ph.classList.add('hidden');
+            if (unlinkBtn) unlinkBtn.classList.remove('hidden');
+            if (pickLabel) pickLabel.textContent = 'Zmień Hero';
+        } else {
+            img.src = '';
+            img.classList.add('hidden');
+            ph.classList.remove('hidden');
+            if (unlinkBtn) unlinkBtn.classList.add('hidden');
+            if (pickLabel) pickLabel.textContent = 'Przypisz Hero';
+        }
+
+        const hasScene = !!(itemData && itemData.hasScene);
+        badge.classList.remove('hidden', 'border-emerald-500/40', 'text-emerald-300', 'border-slate-600', 'text-slate-500');
+        if (hasScene) {
+            badge.textContent = 'Scena: TAK';
+            badge.classList.add('border-emerald-500/40', 'text-emerald-300');
+        } else {
+            badge.textContent = 'Scena: BRAK';
+            badge.classList.add('border-slate-600', 'text-slate-500');
+        }
+    },
+
+    _esc(s) {
+        return String(s ?? '').replace(/[&<>"']/g, c => ({ '&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;' }[c]));
+    },
+
+    async saveItem() {
+        this.ensureOmnichannelForm();
+
+        const $ = id => document.getElementById(id);
+        const val = id => $(`${id}`)?.value?.trim() ?? '';
+
+        const itemId = parseInt(val('item-id'), 10) || 0;
+        const name = val('item-name');
+        const rawAscii = val('item-ascii-key');
+        const cleanKey = rawAscii.replace(/[^a-zA-Z0-9_-]/g, '').toUpperCase();
+        const categoryId = parseInt(val('item-category-id'), 10) || 0;
 
         if (!name || !cleanKey || categoryId <= 0) {
-            alert("Wypełnij poprawnie wszystkie wymagane pola (Nazwa, SKU, Kategoria).");
+            alert('Wypełnij poprawnie: Nazwa, SKU i Kategoria.');
             return;
         }
 
-        const action = itemId > 0 ? 'update_item_full' : 'add_item';
+        const pricePos = parseFloat(val('item-price-pos')) || 0;
+        const priceTakeaway = parseFloat(val('item-price-takeaway')) || 0;
+        const priceDelivery = parseFloat(val('item-price-delivery')) || 0;
+
+        if (typeof window.SliceValidator !== 'undefined') {
+            const labels = ['POS', 'Takeaway', 'Delivery'];
+            for (let i = 0; i < [pricePos, priceTakeaway, priceDelivery].length; i++) {
+                if (window.SliceValidator.validatePrice([pricePos, priceTakeaway, priceDelivery][i]) === null) {
+                    alert(`B┼é─ůd walidacji ceny kana┼éu ${labels[i]}.`);
+                    return;
+                }
+            }
+        }
+
+        const availableDays = Array.from(document.querySelectorAll('.day-checkbox:checked')).map(cb => cb.value).join(',');
 
         const payload = {
-            action: action,
-            itemId: itemId,
-            name: name,
+            action: itemId > 0 ? 'update_item_full' : 'add_item',
+            itemId,
+            name,
             asciiKey: cleanKey,
-            categoryId: categoryId,
+            categoryId,
+            type: this._currentItemType,
+            publicationStatus: this._currentPubStatus,
+            isSecret: $('item-is-secret')?.checked ? 1 : 0,
             priceTiers: [
                 { channel: 'POS', price: pricePos },
                 { channel: 'Takeaway', price: priceTakeaway },
                 { channel: 'Delivery', price: priceDelivery }
             ],
-            vatRate: vatRate,
-            kdsStationId: kdsStationId,
-            publicationStatus: publicationStatus,
-            validFrom: validFrom,
-            validTo: validTo,
-            description: description,
-            imageUrl: imageUrl,
-            marketingTags: marketingTags,
+            vatRateDineIn: parseFloat(val('item-vat-dine-in')) || 8,
+            vatRateTakeaway: parseFloat(val('item-vat-takeaway')) || 5,
+            printerGroup: val('item-printer-group') || 'KITCHEN_1',
+            kdsStationId: val('item-kds-station-id') || 'NONE',
+            driverActionType: val('item-driver-action-type') || 'none',
+            pluCode: val('item-plu-code'),
+            displayOrder: parseInt(val('item-display-order'), 10) || 0,
+            stockCount: parseInt(val('item-stock-count'), 10),
+            validFrom: val('item-valid-from') || null,
+            validTo: val('item-valid-to') || null,
+            availableDays: availableDays || '1,2,3,4,5,6,7',
+            availableStart: val('item-available-start') || null,
+            availableEnd: val('item-available-end') || null,
+            description: val('item-description'),
+            imageUrl: val('item-image-url'),
+            compositionProfile: val('item-composition-profile') || 'static_hero',
+            badgeType: val('item-badge-type') || 'none',
+            marketingTags: val('item-marketing-tags'),
+            barcodeEan: val('item-barcode-ean') || null,
+            parentSku: val('item-parent-sku') || null,
+            allergens: Array.from(document.querySelectorAll('.allergen-checkbox:checked')).map(cb => cb.value),
             modifierGroupIds: Array.from(document.querySelectorAll('.modifier-group-checkbox:checked'))
-                .map(cb => parseInt(cb.value, 10))
-                .filter(Number.isInteger)
+                .map(cb => parseInt(cb.value, 10)).filter(Number.isInteger)
         };
 
-        payload.barcodeEan = document.getElementById('item-barcode-ean').value.trim();
-        payload.parentSku = document.getElementById('item-parent-sku').value.trim();
-        payload.allergens = Array.from(document.querySelectorAll('.allergen-checkbox:checked')).map(cb => cb.value);
+        const btn = $('btn-save-item');
+        if (btn) { btn.disabled = true; btn.innerHTML = '<i class="fa-solid fa-spinner fa-spin mr-2"></i> ZAPISYWANIE...'; }
 
         try {
             const result = await window.ApiClient.post('../../api/backoffice/api_menu_studio.php', payload);
-
             if (result.success === true) {
+                if (btn) { btn.innerHTML = '<i class="fa-solid fa-check mr-2"></i> ZAPISANO!'; btn.classList.replace('from-blue-600', 'from-green-600'); btn.classList.replace('to-blue-500', 'to-green-500'); }
+                setTimeout(() => {
+                    if (btn) { btn.innerHTML = '<i class="fa-solid fa-rocket mr-2"></i> ZAPISZ DANIE'; btn.disabled = false; btn.classList.replace('from-green-600', 'from-blue-600'); btn.classList.replace('to-green-500', 'to-blue-500'); }
+                }, 2000);
+                if (typeof window.loadMenuTree === 'function') await window.loadMenuTree();
+                if (window.Core?.renderTree) window.Core.renderTree();
+            } else {
+                alert('B┼é─ůd zapisu: ' + result.message);
+                if (btn) { btn.disabled = false; btn.innerHTML = '<i class="fa-solid fa-rocket mr-2"></i> ZAPISZ DANIE'; }
+            }
+        } catch (error) {
+            alert('Krytyczny b┼é─ůd sieci.');
+            console.error('[ItemEditor] API error:', error);
+            if (btn) { btn.disabled = false; btn.innerHTML = '<i class="fa-solid fa-rocket mr-2"></i> ZAPISZ DANIE'; }
+        }
+    },
+
+    // ÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉ
+    // M1 ┬Ě Menu Studio Polish ÔÇö Przypisanie hero dania z biblioteki asset├│w
+    // Picker otwiera modal z gridem kafelk├│w, preferuje roleHint='hero', po
+    // wyborze woła set_item_hero (unlink starego + link nowego).
+    // ÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉ
+    async openItemHeroPicker() {
+        const asciiKey = (document.getElementById('item-ascii-key')?.value || '').trim();
+        if (!asciiKey) {
+            alert('Najpierw zapisz danie (SKU jest wymagany).');
+            return;
+        }
+
+        if (window.ModifierInspector && typeof window.ModifierInspector.loadCompactAssets === 'function') {
+            await window.ModifierInspector.loadCompactAssets();
+        }
+        const assets = (window.StudioState && window.StudioState.compactAssets) || [];
+
+        const sorted = assets.slice().sort((a, b) => {
+            const aHero = String(a.roleHint || '').toLowerCase() === 'hero' ? 0 : 1;
+            const bHero = String(b.roleHint || '').toLowerCase() === 'hero' ? 0 : 1;
+            if (aHero !== bHero) return aHero - bHero;
+            const aCat = String(a.category || '').toLowerCase() === 'hero' ? 0 : 1;
+            const bCat = String(b.category || '').toLowerCase() === 'hero' ? 0 : 1;
+            if (aCat !== bCat) return aCat - bCat;
+            return (a.asciiKey || '').localeCompare(b.asciiKey || '');
+        });
+        const categories = Array.from(new Set(sorted.map(a => a.category).filter(Boolean))).sort();
+
+        const host = document.getElementById('sh-item-hero-picker');
+        if (host) host.remove();
+        const modal = document.createElement('div');
+        modal.id = 'sh-item-hero-picker';
+        modal.className = 'fixed inset-0 z-[9999] flex items-center justify-center bg-black/70 backdrop-blur-sm p-4';
+        modal.innerHTML = `
+            <div class="bg-[#0a0a0f] border border-white/10 rounded-3xl shadow-2xl w-full max-w-5xl max-h-[90vh] flex flex-col overflow-hidden">
+                <header class="flex items-center justify-between px-6 py-4 border-b border-white/5 shrink-0">
+                    <div>
+                        <div class="text-[9px] font-black uppercase text-amber-400 tracking-widest">Przypisz Hero</div>
+                        <div class="text-[14px] font-black text-white">${this._esc(asciiKey)} ┬Ě wybierz zdj─Öcie dania z biblioteki</div>
+                    </div>
+                    <button type="button" class="picker-close text-slate-500 hover:text-white w-9 h-9 rounded-lg hover:bg-white/5 transition flex items-center justify-center">
+                        <i class="fa-solid fa-xmark"></i>
+                    </button>
+                </header>
+                <div class="px-6 py-4 border-b border-white/5 flex flex-wrap gap-3 items-center shrink-0">
+                    <div class="flex-1 min-w-[220px] relative">
+                        <i class="fa-solid fa-magnifying-glass absolute left-3 top-1/2 -translate-y-1/2 text-slate-600 text-[11px]"></i>
+                        <input type="text" class="picker-search w-full bg-black/50 border border-white/10 rounded-xl pl-9 pr-3 py-2.5 text-white text-[11px] outline-none focus:border-amber-500 transition" placeholder="Szukaj po nazwie, kategorii lub SKU...">
+                    </div>
+                    <select class="picker-cat bg-black/50 border border-white/10 rounded-xl px-3 py-2.5 text-white text-[11px] outline-none focus:border-amber-500 transition">
+                        <option value="">Wszystkie kategorie</option>
+                        ${categories.map(c => `<option value="${this._esc(c)}">${this._esc(String(c).toUpperCase())}</option>`).join('')}
+                    </select>
+                    <label class="flex items-center gap-2 text-[10px] font-black uppercase text-slate-400 cursor-pointer">
+                        <input type="checkbox" class="picker-only-hero w-4 h-4 rounded border-white/10 bg-black/50" checked>
+                        Tylko rola "hero"
+                    </label>
+                </div>
+                <div class="picker-grid flex-1 overflow-y-auto p-6 grid grid-cols-2 sm:grid-cols-3 md:grid-cols-4 lg:grid-cols-5 gap-3"></div>
+                <footer class="px-6 py-3 border-t border-white/5 text-[9px] font-black uppercase text-slate-600 tracking-wider shrink-0 flex items-center justify-between gap-3">
+                    <span><span class="picker-count">0</span> asset├│w ┬Ě kliknij aby przypisa─ç</span>
+                    <a href="../online_studio/index.html" target="_blank" rel="noopener" class="text-amber-500 hover:text-amber-300 transition">
+                        <i class="fa-solid fa-arrow-up-right-from-square mr-1"></i> Dodaj nowy w Asset Studio
+                    </a>
+                </footer>
+            </div>
+        `;
+        document.body.appendChild(modal);
+
+        const gridEl = modal.querySelector('.picker-grid');
+        const searchEl = modal.querySelector('.picker-search');
+        const catEl = modal.querySelector('.picker-cat');
+        const onlyHeroEl = modal.querySelector('.picker-only-hero');
+        const countEl = modal.querySelector('.picker-count');
+
+        const renderGrid = () => {
+            const q = (searchEl.value || '').trim().toLowerCase();
+            const cat = catEl.value || '';
+            const onlyHero = !!onlyHeroEl.checked;
+            const filtered = sorted.filter(a => {
+                if (cat && a.category !== cat) return false;
+                if (q) {
+                    const hay = `${a.asciiKey || ''} ${a.category || ''} ${a.subType || ''} ${a.roleHint || ''}`.toLowerCase();
+                    if (!hay.includes(q)) return false;
+                }
+                if (onlyHero) {
+                    const hint = String(a.roleHint || '').toLowerCase();
+                    const category = String(a.category || '').toLowerCase();
+                    if (hint !== 'hero' && category !== 'hero') return false;
+                }
+                return true;
+            });
+            countEl.textContent = String(filtered.length);
+            if (filtered.length === 0) {
+                gridEl.innerHTML = `
+                    <div class="col-span-full text-center py-16 text-slate-600 text-[10px] uppercase font-black tracking-widest">
+                        <i class="fa-solid fa-inbox text-3xl mb-3 opacity-40"></i>
+                        <div>Brak pasuj─ůcych asset├│w.</div>
+                        <div class="text-slate-700 mt-2 text-[9px]">Odznacz ÔÇ×Tylko rola hero" lub dodaj nowy w Asset Studio.</div>
+                    </div>
+                `;
+                return;
+            }
+            gridEl.innerHTML = filtered.map(a => {
+                const thumb = a.previewUrl
+                    ? `<img src="${this._esc(a.previewUrl)}" alt="" class="w-full h-full object-cover" loading="lazy">`
+                    : `<div class="w-full h-full flex items-center justify-center"><i class="fa-solid fa-image text-slate-700 text-2xl"></i></div>`;
+                const hint = String(a.roleHint || '').toLowerCase();
+                return `
+                    <button type="button" class="picker-card group relative bg-black/40 border border-white/5 rounded-2xl overflow-hidden hover:border-amber-500/70 transition flex flex-col text-left" data-asset-id="${parseInt(a.id, 10)}">
+                        <div class="aspect-square bg-black/60 overflow-hidden">${thumb}</div>
+                        <div class="p-2.5 flex-1">
+                            <div class="text-[10px] font-black text-white truncate">${this._esc(a.asciiKey || 'ÔÇö')}</div>
+                            <div class="text-[8px] text-slate-500 uppercase truncate mt-0.5">${this._esc(String(a.category || '').toUpperCase())}${a.subType ? ' ┬Ě ' + this._esc(a.subType) : ''}</div>
+                            <div class="text-[7px] ${hint === 'hero' ? 'text-amber-400' : 'text-slate-600'} uppercase truncate mt-1 tracking-widest">${this._esc(hint || 'ÔÇö')}</div>
+                        </div>
+                    </button>
+                `;
+            }).join('');
+        };
+
+        const close = () => modal.remove();
+        modal.addEventListener('click', (e) => {
+            if (e.target === modal) close();
+            if (e.target.closest('.picker-close')) { close(); return; }
+            const card = e.target.closest('.picker-card');
+            if (card) {
+                const aid = parseInt(card.dataset.assetId, 10) || 0;
+                if (aid > 0) this.linkItemHero(asciiKey, aid, close);
+            }
+        });
+        searchEl.addEventListener('input', renderGrid);
+        catEl.addEventListener('change', renderGrid);
+        onlyHeroEl.addEventListener('change', renderGrid);
+        document.addEventListener('keydown', function escH(ev) {
+            if (ev.key === 'Escape') { close(); document.removeEventListener('keydown', escH); }
+        });
+
+        renderGrid();
+        setTimeout(() => searchEl.focus(), 50);
+    },
+
+    async linkItemHero(itemSku, assetId, onDone) {
+        try {
+            const r = await window.ApiClient.post('../../api/backoffice/api_menu_studio.php', {
+                action: 'set_item_hero',
+                itemSku: itemSku,
+                assetId: assetId,
+            });
+            if (r && r.success) {
+                this._applyHeroPreview({ imageUrl: r.data?.imageUrl || '', hasScene: document.getElementById('item-hero-scene-badge')?.textContent === 'Scena: TAK' });
+                const resultBox = document.getElementById('autogen-result');
+                if (resultBox) resultBox.classList.add('hidden');
+                if (typeof onDone === 'function') onDone();
                 if (typeof window.loadMenuTree === 'function') {
-                    await window.loadMenuTree();
+                    window.loadMenuTree().catch(e => console.warn('[ItemEditor] tree refresh failed:', e));
                 }
-                if (window.Core && typeof window.Core.renderTree === 'function') {
-                    window.Core.renderTree();
+            } else {
+                alert('Nie uda┼éo si─Ö przypisa─ç hero: ' + (r?.message || 'nieznany b┼é─ůd'));
+            }
+        } catch (e) {
+            console.error('[ItemEditor] linkItemHero error:', e);
+            alert('B┼é─ůd sieci podczas przypisywania hero ÔÇö patrz konsola.');
+        }
+    },
+
+    async unlinkItemHero() {
+        const asciiKey = (document.getElementById('item-ascii-key')?.value || '').trim();
+        if (!asciiKey) return;
+        if (!confirm('Od┼é─ůczy─ç hero od tego dania? (Asset pozostanie w bibliotece.)')) return;
+        try {
+            const r = await window.ApiClient.post('../../api/backoffice/api_menu_studio.php', {
+                action: 'unlink_item_hero',
+                itemSku: asciiKey,
+            });
+            if (r && r.success) {
+                this._applyHeroPreview({ imageUrl: '', hasScene: false });
+                if (typeof window.loadMenuTree === 'function') {
+                    window.loadMenuTree().catch(e => console.warn('[ItemEditor] tree refresh failed:', e));
                 }
-                alert("Zapisano pomy┼Ťlnie!");
             } else {
-                alert("B┼é─ůd zapisu: " + result.message);
-                console.error("[ItemEditor]", result.message);
+                alert('Nie uda┼éo si─Ö od┼é─ůczy─ç: ' + (r?.message || 'nieznany b┼é─ůd'));
+            }
+        } catch (e) {
+            console.error('[ItemEditor] unlinkItemHero error:', e);
+            alert('B┼é─ůd sieci ÔÇö patrz konsola.');
+        }
+    },
+
+    // ÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉ
+    // M1 ┬Ě Menu Studio Polish ÔÇö Auto-generator default composition
+    // Składa scenę z hero dania + modyfikatorów NONE/default z layer_top_down.
+    // Endpoint: autogenerate_scene. Resp. reason='scene_exists' Ôćĺ prompt "nadpisa─ç?"
+    // ÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉ
+    async autogenerateScene(force = false) {
+        const btn = document.getElementById('btn-autogenerate-scene');
+        const resultBox = document.getElementById('autogen-result');
+        const asciiKey = (document.getElementById('item-ascii-key')?.value || '').trim();
+
+        const showResult = (kind, html) => {
+            if (!resultBox) return;
+            const tones = {
+                ok:    'bg-green-900/20 border-green-500/40 text-green-300',
+                warn:  'bg-yellow-900/20 border-yellow-500/40 text-yellow-200',
+                err:   'bg-red-900/20 border-red-500/40 text-red-300',
+                info:  'bg-slate-800/40 border-white/10 text-slate-300',
+            };
+            resultBox.className = `mt-2 p-3 rounded-xl border text-[10px] font-bold leading-relaxed ${tones[kind] || tones.info}`;
+            resultBox.innerHTML = html;
+            resultBox.classList.remove('hidden');
+        };
+
+        if (!asciiKey) {
+            showResult('warn', '<i class="fa-solid fa-triangle-exclamation mr-1"></i> Najpierw zapisz danie (SKU jest wymagany do auto-generacji).');
+            return;
+        }
+
+        if (btn) {
+            btn.disabled = true;
+            btn.innerHTML = '<i class="fa-solid fa-spinner fa-spin"></i> <span>Generuj─Ö...</span>';
+        }
+        if (resultBox) resultBox.classList.add('hidden');
+
+        try {
+            const payload = { action: 'autogenerate_scene', itemSku: asciiKey };
+            if (force) payload.force = true;
+            const result = await window.ApiClient.post('../../api/backoffice/api_menu_studio.php', payload);
+
+            if (result.success === true) {
+                const d = result.data || {};
+                showResult('ok',
+                    `<i class="fa-solid fa-wand-magic-sparkles mr-1"></i> <strong>${result.message}</strong>` +
+                    `<div class="mt-1 text-[9px] uppercase tracking-widest opacity-70">` +
+                    `sceneId: ${d.sceneId} ┬Ě warstw: ${d.layerCount} ┬Ě modyfikator├│w: ${d.modifierCount}` +
+                    (d.overwritten ? ' ┬Ě nadpisano' : ' ┬Ě nowa scena') +
+                    `</div>` +
+                    `<div class="mt-2 text-[9px]">Otw├│rz <a href="../online_studio/index.html?tab=director&item=${encodeURIComponent(asciiKey)}" target="_blank" rel="noopener" class="text-amber-400 hover:text-amber-300 underline font-black uppercase">Scene Studio Ôćĺ</a>, aby dostroi─ç layout.</div>`
+                );
+                const profileSel = document.getElementById('item-composition-profile');
+                if (profileSel && profileSel.value !== 'pizza_top_down') {
+                    const optPizza = Array.from(profileSel.options).find(o => o.value === 'pizza_top_down' || /pizza/i.test(o.value));
+                    if (optPizza) {
+                        profileSel.value = optPizza.value;
+                        profileSel.dispatchEvent(new Event('change'));
+                    }
+                }
+            } else {
+                const d = result.data || {};
+                if (d.reason === 'scene_exists' && !force) {
+                    const ok = confirm(
+                        `Scena ju┼╝ istnieje (${d.layerCount} warstw, v${d.version}).\n\n` +
+                        `Czy na pewno chcesz j─ů NADPISA─ć auto-wygenerowan─ů kompozycj─ů?\n` +
+                        `(Historyczna wersja zostanie zapisana w sh_atelier_scene_history.)`
+                    );
+                    if (ok) {
+                        return this.autogenerateScene(true);
+                    } else {
+                        showResult('info', '<i class="fa-solid fa-circle-info mr-1"></i> Nadpisanie anulowane. Istniej─ůca scena pozostaje nietkni─Öta.');
+                    }
+                } else if (d.reason === 'no_source_data' && Array.isArray(d.steps) && d.steps.length > 0) {
+                    const escape = (s) => String(s).replace(/[&<>"']/g, c => ({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'}[c]));
+                    const stepsList = d.steps.map(s =>
+                        `<li class="flex items-start gap-2 mt-1"><i class="fa-solid fa-circle-arrow-right text-amber-400 mt-0.5 shrink-0"></i><span>${escape(s)}</span></li>`
+                    ).join('');
+                    const badges = [
+                        `<span class="inline-flex items-center gap-1 px-2 py-0.5 rounded border text-[8px] uppercase tracking-widest ${d.hasHero ? 'border-green-500/40 bg-green-900/20 text-green-300' : 'border-red-500/40 bg-red-900/20 text-red-300'}"><i class="fa-solid ${d.hasHero ? 'fa-check' : 'fa-xmark'}"></i> Hero</span>`,
+                        `<span class="inline-flex items-center gap-1 px-2 py-0.5 rounded border text-[8px] uppercase tracking-widest ${d.defaultModsCount > 0 ? 'border-green-500/40 bg-green-900/20 text-green-300' : 'border-red-500/40 bg-red-900/20 text-red-300'}"><i class="fa-solid ${d.defaultModsCount > 0 ? 'fa-check' : 'fa-xmark'}"></i> Domy┼Ťlne mod.: ${d.defaultModsCount}</span>`,
+                    ].join(' ');
+                    showResult('warn',
+                        `<div class="flex items-center gap-2"><i class="fa-solid fa-triangle-exclamation text-amber-400"></i> <strong>Auto-generator potrzebuje materiału</strong></div>` +
+                        `<div class="mt-2 flex flex-wrap gap-1.5">${badges}</div>` +
+                        `<div class="mt-2 text-[10px] font-bold uppercase tracking-widest opacity-70">Co zrobi─ç:</div>` +
+                        `<ul class="mt-1 space-y-0.5">${stepsList}</ul>`
+                    );
+                } else {
+                    showResult('err',
+                        `<i class="fa-solid fa-circle-xmark mr-1"></i> <strong>B┼é─ůd auto-generacji</strong>` +
+                        `<div class="mt-1 opacity-80">${result.message || 'Nieznany b┼é─ůd.'}</div>`
+                    );
+                }
+            }
+        } catch (err) {
+            console.error('[ItemEditor] autogenerateScene error:', err);
+            showResult('err', '<i class="fa-solid fa-circle-xmark mr-1"></i> Krytyczny b┼é─ůd sieci ÔÇö sprawd┼║ konsol─Ö.');
+        } finally {
+            if (btn) {
+                btn.disabled = false;
+                btn.innerHTML = '<i class="fa-solid fa-wand-magic-sparkles"></i> <span>Wygeneruj automatycznie</span>';
             }
-        } catch (error) {
-            alert("Wyst─ůpi┼é krytyczny b┼é─ůd sieci podczas komunikacji z API.");
-            console.error("[ItemEditor] B┼é─ůd API:", error);
         }
     }
-};
\ No newline at end of file
+};
diff --git a/modules/studio/js/studio_margin.js b/modules/studio/js/studio_margin.js
index 9bb3fd1..6866182 100644
--- a/modules/studio/js/studio_margin.js
+++ b/modules/studio/js/studio_margin.js
@@ -3,7 +3,7 @@
  * Moduł: Food Cost & Gross Margin Calculator
  *
  * Zale┼╝no┼Ťci:
- *   - api/api_warehouse.php (action=GET_AVCO_DICT)
+ *   - WarehouseApi.avcoDict() Ôćĺ api/warehouse/avco_dict.php
  *
  * U┼╝ycie:
  *   await window.MarginGuardian.init();
@@ -21,8 +21,6 @@ window.MarginGuardian = (() => {
         initialized: false
     };
 
-    const API_WAREHOUSE = '../../api/api_warehouse.php';
-
     // -------------------------------------------------------------------------
     // Formatters
     // -------------------------------------------------------------------------
@@ -39,7 +37,7 @@ window.MarginGuardian = (() => {
     // 1. INIT ÔÇö pobiera s┼éownik AVCO z magazynu
     // -------------------------------------------------------------------------
     async function init() {
-        const json = await window.ApiClient.get(API_WAREHOUSE, { action: 'GET_AVCO_DICT' });
+        const json = await window.WarehouseApi.avcoDict();
 
         if (!json.success) {
             console.error('[MarginGuardian] API error:', json.message);
diff --git a/modules/studio/js/studio_modifiers.js b/modules/studio/js/studio_modifiers.js
index c15198e..24f2738 100644
--- a/modules/studio/js/studio_modifiers.js
+++ b/modules/studio/js/studio_modifiers.js
@@ -5,8 +5,313 @@ window.StudioState.modifierGroups = window.StudioState.modifierGroups || [];
 window.StudioState.products = window.StudioState.products || [];
 window.StudioState.warehouseItems = window.StudioState.warehouseItems || [];
 window.StudioState.activeModGroupId = null;
+window.StudioState.compactAssets = window.StudioState.compactAssets || null;
 
 window.ModifierInspector = {
+    _esc(s) {
+        const t = document.createElement('div');
+        t.textContent = s == null ? '' : String(s);
+        return t.innerHTML;
+    },
+
+    async loadCompactAssets() {
+        if (window.StudioState.compactAssets !== null) return window.StudioState.compactAssets;
+        const r = await window.ApiClient.post('../../api/backoffice/api_menu_studio.php', { action: 'list_assets_compact' });
+        if (r.success && r.data && Array.isArray(r.data.assets)) {
+            window.StudioState.compactAssets = r.data.assets;
+        } else {
+            window.StudioState.compactAssets = [];
+            console.warn('[ModifierInspector] list_assets_compact:', r.message || 'empty');
+        }
+        return window.StudioState.compactAssets;
+    },
+
+    _buildAssetSelectOptions(selectedId) {
+        const assets = window.StudioState.compactAssets || [];
+        let html = '<option value="">ÔÇö brak ÔÇö</option>';
+        const sid = selectedId ? parseInt(selectedId, 10) : 0;
+        for (const a of assets) {
+            const id = parseInt(a.id, 10);
+            const sel = sid > 0 && id === sid ? 'selected' : '';
+            const lab = `${a.asciiKey || ''}${a.category ? ' ┬Ě ' + a.category : ''}`;
+            html += `<option value="${id}" ${sel}>${this._esc(lab)}</option>`;
+        }
+        return html;
+    },
+
+    // ÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇ
+    // M1 ┬Ě Connect-dots ÔÇö Asset Picker (modal grid) + Live Preview + Badge
+    // Podmiana na thumbnailowy picker zamiast surowego <select>.
+    // Backend bez zmian: czytamy z `StudioState.compactAssets` (list_assets_compact).
+    // Role s─ů filtrowane po `roleHint` z sh_assets (layer_top_down / modifier_hero).
+    // ÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇ
+
+    _findAssetById(id) {
+        const aid = parseInt(id, 10) || 0;
+        if (!aid) return null;
+        const assets = window.StudioState.compactAssets || [];
+        return assets.find(a => parseInt(a.id, 10) === aid) || null;
+    },
+
+    _roleHintsForSlot(role) {
+        // Jakie role_hint w sh_assets akceptujemy dla danego slotu w modyfikatorze.
+        // Permisywnie ÔÇö pozwalamy managerowi u┼╝y─ç assetu z dowolnym role_hint
+        // (preferujemy dopasowane, ale nie blokujemy).
+        if (role === 'layer_top_down') return ['layer_top_down', 'layer', 'topping', 'scatter'];
+        if (role === 'modifier_hero')  return ['modifier_hero', 'hero', 'product', 'companion'];
+        return [];
+    },
+
+    _buildPickerButtonHtml(role, assetId) {
+        const a = this._findAssetById(assetId);
+        const hiddenClass = role === 'layer_top_down' ? 'opt-asset-layer-id' : 'opt-asset-hero-id';
+        const roleLabel = role === 'layer_top_down' ? 'layer_top_down' : 'modifier_hero';
+        const slotTitle = role === 'layer_top_down' ? 'Warstwa rzut z g├│ry' : 'Hero dodatku';
+
+        const thumbHtml = a && a.previewUrl
+            ? `<img src="${this._esc(a.previewUrl)}" alt="" class="w-full h-full object-cover" loading="lazy">`
+            : `<i class="fa-solid fa-image text-slate-700 text-xl"></i>`;
+
+        const title = a ? (a.asciiKey || 'ÔÇö') : 'ÔÇö kliknij aby wybra─ç ÔÇö';
+        const sub = a ? (a.category ? a.category.toUpperCase() : 'asset') : 'brak wybranego';
+
+        return `
+            <label class="block text-[8px] font-black uppercase text-slate-500 mb-1">${slotTitle} <span class="text-violet-500">(${roleLabel})</span></label>
+            <button type="button" class="opt-asset-picker w-full bg-black/50 border border-white/10 rounded-xl p-2 flex items-center gap-3 hover:border-violet-500/50 hover:bg-black/60 transition min-h-[72px] text-left" data-role="${role}">
+                <div class="asset-thumb w-14 h-14 bg-black/60 rounded-lg flex items-center justify-center overflow-hidden border border-white/5 shrink-0">
+                    ${thumbHtml}
+                </div>
+                <div class="asset-meta flex-1 overflow-hidden">
+                    <div class="asset-title text-[10px] font-black text-white truncate">${this._esc(title)}</div>
+                    <div class="asset-sub text-[8px] text-slate-500 uppercase truncate">${this._esc(sub)}</div>
+                </div>
+                <i class="fa-solid fa-chevron-right text-slate-700 text-[9px] shrink-0"></i>
+            </button>
+            <input type="hidden" class="${hiddenClass}" value="${a ? parseInt(a.id, 10) : 0}">
+        `;
+    },
+
+    _refreshPickerButton(row, role) {
+        if (!row) return;
+        const hiddenCls = role === 'layer_top_down' ? '.opt-asset-layer-id' : '.opt-asset-hero-id';
+        const hidden = row.querySelector(hiddenCls);
+        const assetId = hidden ? parseInt(hidden.value, 10) || 0 : 0;
+        const btn = row.querySelector(`.opt-asset-picker[data-role="${role}"]`);
+        if (!btn) return;
+        const a = this._findAssetById(assetId);
+        const thumbEl = btn.querySelector('.asset-thumb');
+        const titleEl = btn.querySelector('.asset-title');
+        const subEl   = btn.querySelector('.asset-sub');
+        if (thumbEl) {
+            thumbEl.innerHTML = a && a.previewUrl
+                ? `<img src="${this._esc(a.previewUrl)}" alt="" class="w-full h-full object-cover" loading="lazy">`
+                : `<i class="fa-solid fa-image text-slate-700 text-xl"></i>`;
+        }
+        if (titleEl) titleEl.textContent = a ? (a.asciiKey || 'ÔÇö') : 'ÔÇö kliknij aby wybra─ç ÔÇö';
+        if (subEl)   subEl.textContent   = a ? (a.category ? a.category.toUpperCase() : 'asset') : 'brak wybranego';
+    },
+
+    _computeRowBadge(row) {
+        if (!row) return { cls: '', label: '', tone: '' };
+        const impact = !!row.querySelector('.opt-visual-impact')?.checked;
+        const layer  = parseInt(row.querySelector('.opt-asset-layer-id')?.value, 10) || 0;
+        const hero   = parseInt(row.querySelector('.opt-asset-hero-id')?.value, 10) || 0;
+
+        if (!impact) {
+            return { label: 'text only', tone: 'bg-slate-800 text-slate-500 border-white/10', icon: 'fa-circle' };
+        }
+        if (layer && hero) {
+            return { label: 'surface ready', tone: 'bg-green-900/30 text-green-400 border-green-500/40', icon: 'fa-check-circle' };
+        }
+        if (layer || hero) {
+            return { label: 'incomplete', tone: 'bg-yellow-900/30 text-yellow-400 border-yellow-500/40', icon: 'fa-triangle-exclamation' };
+        }
+        return { label: 'flag ┬Ě brak asset├│w', tone: 'bg-red-900/30 text-red-400 border-red-500/40', icon: 'fa-circle-exclamation' };
+    },
+
+    _refreshRowBadge(row) {
+        if (!row) return;
+        const badge = row.querySelector('.vis-status-badge');
+        if (!badge) return;
+        const b = this._computeRowBadge(row);
+        badge.className = `vis-status-badge text-[8px] font-black uppercase tracking-widest px-2 py-1 rounded-full border inline-flex items-center gap-1 ${b.tone}`;
+        badge.innerHTML = `<i class="fa-solid ${b.icon} text-[8px]"></i> ${this._esc(b.label)}`;
+    },
+
+    _refreshRowPreview(row) {
+        if (!row) return;
+        const box = row.querySelector('.vis-preview-box');
+        if (!box) return;
+        const impact = !!row.querySelector('.opt-visual-impact')?.checked;
+        const layerId = parseInt(row.querySelector('.opt-asset-layer-id')?.value, 10) || 0;
+        const heroId  = parseInt(row.querySelector('.opt-asset-hero-id')?.value, 10) || 0;
+        const layer = this._findAssetById(layerId);
+        const hero  = this._findAssetById(heroId);
+
+        const dim = impact ? '' : 'opacity-30 grayscale';
+        const layerImg = (impact && layer && layer.previewUrl)
+            ? `<img src="${this._esc(layer.previewUrl)}" alt="" class="absolute inset-0 w-full h-full object-contain ${dim}" loading="lazy">`
+            : '';
+        const heroImg = (impact && hero && hero.previewUrl)
+            ? `<img src="${this._esc(hero.previewUrl)}" alt="" class="absolute bottom-1 right-1 w-8 h-8 object-contain rounded-full bg-black/60 border border-white/20 shadow-lg ${dim}" loading="lazy">`
+            : '';
+
+        box.innerHTML = `
+            <div class="absolute inset-0 rounded-full bg-gradient-to-br from-amber-900/30 via-orange-950/40 to-black border border-white/5"></div>
+            ${layerImg}
+            ${heroImg}
+            ${!impact ? '<div class="absolute inset-0 flex items-center justify-center text-[8px] text-slate-600 font-black uppercase tracking-widest">text only</div>' : ''}
+            ${impact && !layerId && !heroId ? '<div class="absolute inset-0 flex items-center justify-center text-[8px] text-slate-600 font-black uppercase tracking-widest opacity-60">brak asset├│w</div>' : ''}
+        `;
+    },
+
+    _refreshRowVisual(row) {
+        this._refreshPickerButton(row, 'layer_top_down');
+        this._refreshPickerButton(row, 'modifier_hero');
+        this._refreshRowBadge(row);
+        this._refreshRowPreview(row);
+    },
+
+    openAssetPickerModal(row, role) {
+        if (!row) return;
+        const hiddenCls = role === 'layer_top_down' ? '.opt-asset-layer-id' : '.opt-asset-hero-id';
+        const hidden = row.querySelector(hiddenCls);
+        const currentId = hidden ? parseInt(hidden.value, 10) || 0 : 0;
+
+        const preferred = this._roleHintsForSlot(role);
+        const assets = (window.StudioState.compactAssets || []).slice();
+
+        assets.sort((a, b) => {
+            const aPref = preferred.includes(String(a.roleHint || '').toLowerCase()) ? 0 : 1;
+            const bPref = preferred.includes(String(b.roleHint || '').toLowerCase()) ? 0 : 1;
+            if (aPref !== bPref) return aPref - bPref;
+            return (a.asciiKey || '').localeCompare(b.asciiKey || '');
+        });
+
+        const categories = Array.from(new Set(assets.map(a => a.category).filter(Boolean))).sort();
+
+        let host = document.getElementById('sh-asset-picker-modal');
+        if (host) host.remove();
+        host = document.createElement('div');
+        host.id = 'sh-asset-picker-modal';
+        host.className = 'fixed inset-0 z-[9999] flex items-center justify-center bg-black/70 backdrop-blur-sm p-4';
+        host.innerHTML = `
+            <div class="bg-[#0a0a0f] border border-white/10 rounded-3xl shadow-2xl w-full max-w-5xl max-h-[90vh] flex flex-col overflow-hidden">
+                <header class="flex items-center justify-between px-6 py-4 border-b border-white/5 shrink-0">
+                    <div>
+                        <div class="text-[9px] font-black uppercase text-violet-400 tracking-widest">Asset Picker</div>
+                        <div class="text-[14px] font-black text-white">${role === 'layer_top_down' ? 'Warstwa rzut z g├│ry (scatter)' : 'Hero dodatku'}</div>
+                    </div>
+                    <div class="flex items-center gap-3">
+                        <button type="button" class="picker-clear text-[9px] font-black uppercase text-red-400 hover:text-red-300 px-3 py-2 rounded-lg border border-red-500/30 hover:bg-red-900/20 transition">
+                            <i class="fa-solid fa-ban mr-1"></i> Wyczy┼Ť─ç slot
+                        </button>
+                        <button type="button" class="picker-close text-slate-500 hover:text-white w-9 h-9 rounded-lg hover:bg-white/5 transition flex items-center justify-center">
+                            <i class="fa-solid fa-xmark"></i>
+                        </button>
+                    </div>
+                </header>
+                <div class="px-6 py-4 border-b border-white/5 flex flex-wrap gap-3 items-center shrink-0">
+                    <div class="flex-1 min-w-[220px] relative">
+                        <i class="fa-solid fa-magnifying-glass absolute left-3 top-1/2 -translate-y-1/2 text-slate-600 text-[11px]"></i>
+                        <input type="text" class="picker-search w-full bg-black/50 border border-white/10 rounded-xl pl-9 pr-3 py-2.5 text-white text-[11px] outline-none focus:border-violet-500 transition" placeholder="Szukaj po nazwie, kategorii lub SKU...">
+                    </div>
+                    <select class="picker-cat bg-black/50 border border-white/10 rounded-xl px-3 py-2.5 text-white text-[11px] outline-none focus:border-violet-500 transition">
+                        <option value="">Wszystkie kategorie</option>
+                        ${categories.map(c => `<option value="${this._esc(c)}">${this._esc(c.toUpperCase())}</option>`).join('')}
+                    </select>
+                    <label class="flex items-center gap-2 text-[10px] font-black uppercase text-slate-400 cursor-pointer">
+                        <input type="checkbox" class="picker-only-matching w-4 h-4 rounded border-white/10 bg-black/50" checked>
+                        Tylko pasuj─ůce role
+                    </label>
+                </div>
+                <div class="picker-grid flex-1 overflow-y-auto p-6 grid grid-cols-2 sm:grid-cols-3 md:grid-cols-4 lg:grid-cols-5 gap-3"></div>
+                <footer class="px-6 py-3 border-t border-white/5 text-[9px] font-black uppercase text-slate-600 tracking-wider shrink-0">
+                    <span class="picker-count">0</span> asset├│w ┬Ě kliknij aby przypisa─ç
+                </footer>
+            </div>
+        `;
+        document.body.appendChild(host);
+
+        const gridEl = host.querySelector('.picker-grid');
+        const searchEl = host.querySelector('.picker-search');
+        const catEl = host.querySelector('.picker-cat');
+        const onlyMatchingEl = host.querySelector('.picker-only-matching');
+        const countEl = host.querySelector('.picker-count');
+
+        const renderGrid = () => {
+            const q = (searchEl.value || '').trim().toLowerCase();
+            const cat = catEl.value || '';
+            const onlyMatching = !!onlyMatchingEl.checked;
+            const filtered = assets.filter(a => {
+                if (cat && a.category !== cat) return false;
+                if (q) {
+                    const hay = `${a.asciiKey || ''} ${a.category || ''} ${a.subType || ''} ${a.roleHint || ''}`.toLowerCase();
+                    if (!hay.includes(q)) return false;
+                }
+                if (onlyMatching) {
+                    const hint = String(a.roleHint || '').toLowerCase();
+                    if (!preferred.includes(hint)) return false;
+                }
+                return true;
+            });
+            countEl.textContent = String(filtered.length);
+            if (filtered.length === 0) {
+                gridEl.innerHTML = `
+                    <div class="col-span-full text-center py-16 text-slate-600 text-[10px] uppercase font-black tracking-widest">
+                        <i class="fa-solid fa-inbox text-3xl mb-3 opacity-40"></i>
+                        <div>Brak pasuj─ůcych asset├│w.</div>
+                        <div class="text-slate-700 mt-2 text-[9px]">Odznacz "Tylko pasuj─ůce role" lub wyczy┼Ť─ç filtry.</div>
+                    </div>
+                `;
+                return;
+            }
+            gridEl.innerHTML = filtered.map(a => {
+                const isSel = parseInt(a.id, 10) === currentId;
+                const thumb = a.previewUrl
+                    ? `<img src="${this._esc(a.previewUrl)}" alt="" class="w-full h-full object-cover" loading="lazy">`
+                    : `<div class="w-full h-full flex items-center justify-center"><i class="fa-solid fa-image text-slate-700 text-2xl"></i></div>`;
+                return `
+                    <button type="button" class="picker-card group relative bg-black/40 border ${isSel ? 'border-violet-500' : 'border-white/5'} rounded-2xl overflow-hidden hover:border-violet-500/70 transition flex flex-col text-left" data-asset-id="${parseInt(a.id, 10)}">
+                        <div class="aspect-square bg-black/60 overflow-hidden">${thumb}</div>
+                        <div class="p-2.5 flex-1">
+                            <div class="text-[10px] font-black text-white truncate">${this._esc(a.asciiKey || 'ÔÇö')}</div>
+                            <div class="text-[8px] text-slate-500 uppercase truncate mt-0.5">${this._esc((a.category || '').toUpperCase())}${a.subType ? ' ┬Ě ' + this._esc(a.subType) : ''}</div>
+                            <div class="text-[7px] text-violet-500/70 uppercase truncate mt-1 tracking-widest">${this._esc((a.roleHint || '').toLowerCase())}</div>
+                        </div>
+                        ${isSel ? '<div class="absolute top-2 right-2 w-6 h-6 bg-violet-500 rounded-full flex items-center justify-center shadow-lg"><i class="fa-solid fa-check text-white text-[10px]"></i></div>' : ''}
+                    </button>
+                `;
+            }).join('');
+        };
+
+        const close = () => host.remove();
+        const apply = (assetId) => {
+            if (hidden) hidden.value = String(parseInt(assetId, 10) || 0);
+            this._refreshRowVisual(row);
+            close();
+        };
+
+        host.addEventListener('click', (e) => {
+            if (e.target === host) close();
+            const closeBtn = e.target.closest('.picker-close');
+            if (closeBtn) { close(); return; }
+            const clearBtn = e.target.closest('.picker-clear');
+            if (clearBtn) { apply(0); return; }
+            const card = e.target.closest('.picker-card');
+            if (card) { apply(card.dataset.assetId); return; }
+        });
+        searchEl.addEventListener('input', renderGrid);
+        catEl.addEventListener('change', renderGrid);
+        onlyMatchingEl.addEventListener('change', renderGrid);
+        document.addEventListener('keydown', function escHandler(ev) {
+            if (ev.key === 'Escape') { close(); document.removeEventListener('keydown', escHandler); }
+        });
+
+        renderGrid();
+        setTimeout(() => searchEl.focus(), 50);
+    },
+
     toAutoSlug(value, prefix) {
         const polishMap = {
             '─ů': 'a', '─ç': 'c', '─Ö': 'e', '┼é': 'l', '┼ä': 'n', '├│': 'o', '┼Ť': 's', '┼║': 'z', '┼╝': 'z',
@@ -61,7 +366,7 @@ window.ModifierInspector = {
             }
         }
         if (window.StudioState.warehouseItems.length === 0) {
-            const whResult = await window.ApiClient.post('../../api/api_warehouse.php', { action: 'GET_STOCK' });
+            const whResult = await window.WarehouseApi.stockList();
             if (whResult.success && Array.isArray(whResult.data)) {
                 window.StudioState.warehouseItems = whResult.data;
             } else {
@@ -69,6 +374,7 @@ window.ModifierInspector = {
             }
         }
         await this.loadModifiersFromDB();
+        await this.loadCompactAssets();
     },
 
     async loadModifiersFromDB() {
@@ -188,20 +494,20 @@ window.ModifierInspector = {
         const groups = window.StudioState.modifierGroups || [];
         
         if(groups.length === 0) {
-            container.innerHTML = `<button onclick="window.ModifierInspector.createNewGroup()" class="w-full mb-4 py-3 bg-green-900/40 text-green-400 border border-green-500/30 rounded flex items-center justify-center hover:bg-green-600 hover:text-white transition text-[10px] font-black uppercase"><i class="fa-solid fa-plus mr-2"></i> Nowa Grupa</button>` + 
+            container.innerHTML = `<button onclick="window.ModifierInspector.createNewGroup().catch(()=>{})" class="w-full mb-4 py-3 bg-green-900/40 text-green-400 border border-green-500/30 rounded flex items-center justify-center hover:bg-green-600 hover:text-white transition text-[10px] font-black uppercase"><i class="fa-solid fa-plus mr-2"></i> Nowa Grupa</button>` + 
             '<div class="text-center mt-10 text-slate-500 font-bold text-[10px] uppercase">Brak zapisanych grup w bazie.</div>'; 
             return; 
         }
 
-        container.innerHTML = `<button onclick="window.ModifierInspector.createNewGroup()" class="w-full mb-4 py-3 bg-green-900/40 text-green-400 border border-green-500/30 rounded flex items-center justify-center hover:bg-green-600 hover:text-white transition text-[10px] font-black uppercase"><i class="fa-solid fa-plus mr-2"></i> Nowa Grupa</button>` + 
+        container.innerHTML = `<button onclick="window.ModifierInspector.createNewGroup().catch(()=>{})" class="w-full mb-4 py-3 bg-green-900/40 text-green-400 border border-green-500/30 rounded flex items-center justify-center hover:bg-green-600 hover:text-white transition text-[10px] font-black uppercase"><i class="fa-solid fa-plus mr-2"></i> Nowa Grupa</button>` + 
         groups.map(g => `
-            <div onclick="window.ModifierInspector.selectGroup(${g.id})" class="p-4 bg-white/5 border border-white/5 rounded-xl mb-2 cursor-pointer hover:border-blue-500/50 transition flex justify-between items-center group ${g.id === window.StudioState.activeModGroupId ? 'border-blue-500 bg-blue-900/10' : ''}">
+            <div onclick="window.ModifierInspector.selectGroup(${g.id}).catch(()=>{})" class="p-4 bg-white/5 border border-white/5 rounded-xl mb-2 cursor-pointer hover:border-blue-500/50 transition flex justify-between items-center group ${g.id === window.StudioState.activeModGroupId ? 'border-blue-500 bg-blue-900/10' : ''}">
                 <div><h3 class="text-[11px] font-black uppercase text-white group-hover:text-blue-400 transition">${g.name}</h3></div>
                 <i class="fa-solid fa-chevron-right text-[10px] text-slate-700"></i>
             </div>`).join('');
     },
 
-    createNewGroup() {
+    async createNewGroup() {
         window.StudioState.activeModGroupId = 0;
         this.renderGroupList(); 
         
@@ -226,12 +532,12 @@ window.ModifierInspector = {
         document.getElementById('mod-valid-to').value = "";
         document.getElementById('btn-save-modifier').classList.remove('opacity-50', 'cursor-not-allowed');
         
-        this.renderModifierItems([]);
+        await this.renderModifierItems([]);
         this.addOptionRow(); 
         this.applyFranchiseShieldForGroup(false);
     },
 
-    selectGroup(id) {
+    async selectGroup(id) {
         window.StudioState.activeModGroupId = id;
         this.renderGroupList(); 
 
@@ -265,11 +571,12 @@ window.ModifierInspector = {
         document.getElementById('btn-save-modifier').classList.remove('opacity-50', 'cursor-not-allowed');
 
         const itemsToRender = group.options || [];
-        this.renderModifierItems(itemsToRender);
+        await this.renderModifierItems(itemsToRender);
         this.applyFranchiseShieldForGroup(!!group.isLockedByHq);
     },
 
-    renderModifierItems(items) {
+    async renderModifierItems(items) {
+        await this.loadCompactAssets();
         const list = document.getElementById('modifier-items-list');
         let html = `
             <div class="flex items-center justify-between bg-blue-900/20 border border-blue-500/30 p-4 rounded-2xl mb-4 shadow-lg">
@@ -321,6 +628,15 @@ window.ModifierInspector = {
         const priceDelivery = deliveryTier ? parseFloat(deliveryTier.price).toFixed(2) : (opt.priceDelivery !== undefined ? parseFloat(opt.priceDelivery).toFixed(2) : '0.00');
         const isEdit = id > 0;
 
+        const hasVisualImpact = opt.hasVisualImpact !== undefined ? !!opt.hasVisualImpact : true;
+        const layerAid = opt.layerTopDownAssetId ? parseInt(opt.layerTopDownAssetId, 10) : 0;
+        const heroAid = opt.modifierHeroAssetId ? parseInt(opt.modifierHeroAssetId, 10) : 0;
+        const layerPickerHtml = this._buildPickerButtonHtml('layer_top_down', layerAid);
+        const heroPickerHtml  = this._buildPickerButtonHtml('modifier_hero', heroAid);
+        const mapperHref = asciiKey
+            ? `../online_studio/index.html?tab=magic&modifier=${encodeURIComponent(asciiKey)}`
+            : '#';
+
         const isDefault = opt.isDefault ? 'checked' : '';
         const actionType = opt.actionType || 'NONE';
         const linkedSku = opt.linkedWarehouseSku || opt.sku || '';
@@ -397,10 +713,52 @@ window.ModifierInspector = {
                     <label class="block text-[8px] font-black uppercase text-slate-500 mb-1">linkedQuantity (ułamek)</label>
                     <input type="number" step="0.001" class="opt-qty w-full bg-black/50 border border-white/10 text-white text-[9px] rounded p-2 outline-none text-center ${actionType!=='ADD' ? 'opacity-30 cursor-not-allowed' : ''}" placeholder="0.000" value="${qty}" ${actionType!=='ADD' ? 'disabled' : ''}>
                 </div>
+
+                <div class="col-span-12 pt-4 mt-2 border-t border-violet-500/25 visual-mod-panel lock-opt-visual">
+                    <div class="flex items-center justify-between mb-3">
+                        <div class="text-[9px] font-black uppercase text-violet-400 tracking-wider"><i class="fa-solid fa-layer-group mr-2"></i>Surface ÔÇö wizualne sloty</div>
+                        <span class="vis-status-badge text-[8px] font-black uppercase tracking-widest px-2 py-1 rounded-full border inline-flex items-center gap-1 bg-slate-800 text-slate-500 border-white/10"><i class="fa-solid fa-circle text-[8px]"></i> ÔÇö</span>
+                    </div>
+                    <label class="flex items-center gap-3 mb-4 cursor-pointer">
+                        <input type="checkbox" class="opt-visual-impact w-4 h-4 rounded border-white/10 bg-black/50" ${hasVisualImpact ? 'checked' : ''}>
+                        <span class="text-[8px] font-black uppercase text-slate-400">Ma wpływ wizualny (The Surface / warstwy)</span>
+                    </label>
+                    <div class="grid grid-cols-1 md:grid-cols-3 gap-4">
+                        <div class="asset-picker-slot">${layerPickerHtml}</div>
+                        <div class="asset-picker-slot">${heroPickerHtml}</div>
+                        <div class="flex flex-col items-center justify-center">
+                            <label class="block text-[8px] font-black uppercase text-slate-500 mb-1 self-start">Podgl─ůd LIVE</label>
+                            <div class="vis-preview-wrap w-full bg-black/30 border border-white/5 rounded-xl p-2 flex items-center justify-center">
+                                <div class="vis-preview-box relative w-full aspect-square max-w-[120px] rounded-full overflow-hidden shadow-inner"></div>
+                            </div>
+                        </div>
+                    </div>
+                    <p class="text-[7px] text-slate-600 mt-3 leading-relaxed">
+                        Zapis: przycisk <strong class="text-slate-500">Zapisz Grup─Ö</strong>.
+                        ${asciiKey ? `<a href="${mapperHref}" target="_blank" rel="noopener" class="text-violet-400 hover:text-violet-300 ml-2 font-bold uppercase">Modifier Mapper (Online Studio) Ôćĺ</a>` : '<span class="text-slate-700 ml-2">(SKU opcji ÔÇö wtedy link do Mapper)</span>'}
+                    </p>
+                </div>
             </div>
         `;
         list.appendChild(row);
         this.bindOptionAutoSlug(row);
+
+        row.querySelectorAll('.opt-asset-picker').forEach(btn => {
+            btn.addEventListener('click', (e) => {
+                e.preventDefault();
+                const role = btn.dataset.role;
+                window.ModifierInspector.openAssetPickerModal(row, role);
+            });
+        });
+        const impactBox = row.querySelector('.opt-visual-impact');
+        if (impactBox) {
+            impactBox.addEventListener('change', () => {
+                window.ModifierInspector._refreshRowBadge(row);
+                window.ModifierInspector._refreshRowPreview(row);
+            });
+        }
+        this._refreshRowVisual(row);
+
         const group = window.StudioState.modifierGroups.find(g => g.id === window.StudioState.activeModGroupId);
         if (group && group.isLockedByHq) this.applyFranchiseShieldForGroup(true);
     },
@@ -456,12 +814,12 @@ window.ModifierInspector = {
         });
 
         document.querySelectorAll('.mod-option-row').forEach(row => {
-            row.querySelectorAll('.lock-opt-name, .lock-opt-warehouse').forEach(block => {
+            row.querySelectorAll('.lock-opt-name, .lock-opt-warehouse, .lock-opt-visual').forEach(block => {
                 if (isLocked) block.classList.add('pointer-events-none', 'opacity-50');
                 else block.classList.remove('pointer-events-none', 'opacity-50');
             });
 
-            row.querySelectorAll('.opt-name, .opt-ascii, .opt-action, .opt-sku, .opt-qty, .opt-default').forEach(input => {
+            row.querySelectorAll('.opt-name, .opt-ascii, .opt-action, .opt-sku, .opt-qty, .opt-default, .opt-visual-impact, .opt-asset-picker').forEach(input => {
                 if (input) input.disabled = !!isLocked;
             });
         });
@@ -694,7 +1052,7 @@ window.ModifierInspector = {
             : null;
 
         const payload = {
-            action:    'SAVE_MODIFIER',
+            action:    'save_modifier_quick',
             groupName: groupInput ? groupInput.value.trim() : '',
             name,
             asciiKey:  this.toAutoSlug(name, 'OPT_'),
@@ -720,7 +1078,7 @@ window.ModifierInspector = {
         }
 
         try {
-            const result = await window.ApiClient.post('../../api/api_modifiers.php', payload);
+            const result = await window.ApiClient.post('../../api/backoffice/api_menu_studio.php', payload);
 
             if (!result.success) {
                 throw new Error(result.message || 'B┼é─ůd API.');
@@ -756,8 +1114,8 @@ window.ModifierInspector = {
             if(type === 'set') current = val;
             
             if (typeof window.SliceValidator !== 'undefined') {
-                const valResult = window.SliceValidator.validatePrice(current);
-                if (valResult && valResult.error) current = 0; 
+                const validated = window.SliceValidator.validatePrice(current);
+                if (validated === null) current = 0;
             }
 
             input.value = current.toFixed(2);
@@ -809,10 +1167,11 @@ window.ModifierInspector = {
             if (!name || !cleanAscii) return; 
 
             if (typeof window.SliceValidator !== 'undefined') {
-                [pricePos, priceTakeaway, priceDelivery].forEach(channelPrice => {
-                    const valResult = window.SliceValidator.validatePrice(channelPrice);
-                    if (valResult && valResult.error) {
-                        alert(`B┼é─ůd ceny w opcji "${name}": ` + valResult.message);
+                const channelLabels = ['POS', 'Takeaway', 'Delivery'];
+                [pricePos, priceTakeaway, priceDelivery].forEach((channelPrice, idx) => {
+                    const validated = window.SliceValidator.validatePrice(channelPrice);
+                    if (validated === null) {
+                        alert(`B┼é─ůd ceny w opcji "${name}" (${channelLabels[idx]}): warto┼Ť─ç musi by─ç liczb─ů >= 0.`);
                         hasValidationError = true;
                     }
                 });
@@ -823,6 +1182,11 @@ window.ModifierInspector = {
                 hasValidationError = true;
             }
 
+            const layerHidden = row.querySelector('.opt-asset-layer-id');
+            const heroHidden  = row.querySelector('.opt-asset-hero-id');
+            const vImpact = row.querySelector('.opt-visual-impact');
+            const layerTopDownAssetId = layerHidden && layerHidden.value ? parseInt(layerHidden.value, 10) : null;
+            const modifierHeroAssetId = heroHidden  && heroHidden.value  ? parseInt(heroHidden.value, 10)  : null;
             options.push({ 
                 id,
                 name,
@@ -835,7 +1199,10 @@ window.ModifierInspector = {
                 isDefault,
                 actionType,
                 linkedWarehouseSku: linkedSku,
-                linkedQuantity: parseFloat(linkedQty)
+                linkedQuantity: parseFloat(linkedQty),
+                hasVisualImpact: vImpact ? !!vImpact.checked : true,
+                layerTopDownAssetId: layerTopDownAssetId && layerTopDownAssetId > 0 ? layerTopDownAssetId : null,
+                modifierHeroAssetId: modifierHeroAssetId && modifierHeroAssetId > 0 ? modifierHeroAssetId : null
             });
         });
 
diff --git a/modules/studio/js/studio_recipe.js b/modules/studio/js/studio_recipe.js
index 9ea9bbe..71d9460 100644
--- a/modules/studio/js/studio_recipe.js
+++ b/modules/studio/js/studio_recipe.js
@@ -1,3 +1,5 @@
+const _eR = s => { const d = document.createElement('div'); d.textContent = s == null ? '' : String(s); return d.innerHTML; };
+
 window.RecipeMapper = {
     state: { 
         products: [], 
@@ -17,6 +19,21 @@ window.RecipeMapper = {
         } else {
             console.error("[RecipeMapper] B┼é─ůd inicjalizacji:", response.message);
         }
+        // M1: Warehouse items (quantity + avco) ÔÇö u┼╝ywane przez stock badge i fuzzy search.
+        // ModifierInspector też to ładuje; dzielimy cache w StudioState.warehouseItems.
+        window.StudioState = window.StudioState || {};
+        if (!Array.isArray(window.StudioState.warehouseItems) || window.StudioState.warehouseItems.length === 0) {
+            try {
+                if (window.WarehouseApi && typeof window.WarehouseApi.stockList === 'function') {
+                    const wh = await window.WarehouseApi.stockList();
+                    if (wh && wh.success && Array.isArray(wh.data)) {
+                        window.StudioState.warehouseItems = wh.data;
+                    }
+                }
+            } catch (err) {
+                console.warn('[RecipeMapper] Warehouse stockList fallback:', err);
+            }
+        }
     },
 
     // --- NOWA FUNKCJA ZABEZPIECZAJ─äCA (Wstrzykiwanie surowc├│w) ---
@@ -56,46 +73,468 @@ window.RecipeMapper = {
             console.error("[RecipeMapper] B┼é─ůd pobierania receptury:", response.message);
         }
 
-        // --- ROZWIĄZANIE "WYŚCIGU CZASU" ---
-        // Ładujemy listę surowców dopiero wtedy, gdy klikniesz pizzę (bo okienko już istnieje)
         this.populateIngredientDropdown();
+        this.wireUpSearchUI();
+    },
+
+    // ÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉ
+    // M1 ┬Ě Menu Studio Polish ÔÇö Fuzzy Search + QuickAdd + Bulk Add
+    // ÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉ
+
+    wireUpSearchUI() {
+        const searchEl = document.getElementById('ingredient-search');
+        if (!searchEl || searchEl.dataset.wired === '1') return;
+        searchEl.dataset.wired = '1';
+
+        searchEl.addEventListener('input', () => {
+            this.renderSearchResults(searchEl.value);
+        });
+        searchEl.addEventListener('focus', () => {
+            this.renderSearchResults(searchEl.value);
+        });
+        searchEl.addEventListener('keydown', (e) => {
+            const results = document.getElementById('ingredient-search-results');
+            if (!results || results.classList.contains('hidden')) return;
+            const cards = Array.from(results.querySelectorAll('.search-result-card'));
+            if (cards.length === 0) return;
+            let idx = cards.findIndex(c => c.classList.contains('active'));
+            if (e.key === 'ArrowDown') {
+                e.preventDefault();
+                idx = Math.min(cards.length - 1, idx + 1);
+                cards.forEach(c => c.classList.remove('active', 'bg-blue-500/20'));
+                cards[idx].classList.add('active', 'bg-blue-500/20');
+                cards[idx].scrollIntoView({ block: 'nearest' });
+            } else if (e.key === 'ArrowUp') {
+                e.preventDefault();
+                idx = Math.max(0, idx - 1);
+                cards.forEach(c => c.classList.remove('active', 'bg-blue-500/20'));
+                cards[idx].classList.add('active', 'bg-blue-500/20');
+                cards[idx].scrollIntoView({ block: 'nearest' });
+            } else if (e.key === 'Enter') {
+                e.preventDefault();
+                const target = idx >= 0 ? cards[idx] : cards[0];
+                if (target) this.selectSearchResult(target.dataset.sku);
+            } else if (e.key === 'Escape') {
+                results.classList.add('hidden');
+            }
+        });
+
+        document.addEventListener('click', (e) => {
+            const results = document.getElementById('ingredient-search-results');
+            if (!results || results.classList.contains('hidden')) return;
+            if (!e.target.closest('#ingredient-search') && !e.target.closest('#ingredient-search-results')) {
+                results.classList.add('hidden');
+            }
+        });
+
+        const quickQty = document.getElementById('quickadd-qty');
+        if (quickQty && quickQty.dataset.wired !== '1') {
+            quickQty.dataset.wired = '1';
+            quickQty.addEventListener('keydown', (e) => {
+                if (e.key === 'Enter') { e.preventDefault(); this.confirmQuickAdd(); }
+                else if (e.key === 'Escape') { e.preventDefault(); this.cancelQuickAdd(); }
+            });
+        }
+    },
+
+    _fuzzyScore(query, entry) {
+        const q = this._normalizeToken(query);
+        if (!q) return 0;
+        const name = entry.nameNorm;
+        if (name === q) return 100;
+        if (name.startsWith(q)) return 80;
+        if (name.includes(q)) return 60;
+        for (const alias of entry.aliasNorm) {
+            if (alias === q) return 70;
+            if (alias.startsWith(q)) return 50;
+            if (alias.includes(q)) return 35;
+        }
+        // SKU match as last resort
+        const sku = this._normalizeToken(entry.sku);
+        if (sku.includes(q)) return 20;
+        return 0;
+    },
+
+    renderSearchResults(query) {
+        const results = document.getElementById('ingredient-search-results');
+        if (!results) return;
+        const q = (query || '').trim();
+
+        const index = this._buildProductIndex();
+        const alreadyAdded = new Set(this.state.currentRecipe.map(r => r.warehouseSku));
+
+        let candidates;
+        if (!q) {
+            candidates = index.slice(0, 60).map(e => ({ entry: e, score: 1 }));
+        } else {
+            candidates = index.map(e => ({ entry: e, score: this._fuzzyScore(q, e) }))
+                .filter(c => c.score > 0)
+                .sort((a, b) => b.score - a.score)
+                .slice(0, 40);
+        }
+
+        if (candidates.length === 0) {
+            results.innerHTML = `
+                <div class="p-4 text-center text-slate-600 text-[10px] uppercase font-black tracking-widest">
+                    <i class="fa-solid fa-inbox text-xl mb-2 opacity-40 block"></i>
+                    Brak dopasowań dla "${_eR(q)}"
+                </div>
+            `;
+            results.classList.remove('hidden');
+            return;
+        }
+
+        results.innerHTML = candidates.map(({ entry }) => {
+            const stock = this._getStockInfo(entry.sku);
+            const added = alreadyAdded.has(entry.sku);
+            const stockHtml = stock
+                ? `<span class="text-[8px] font-black uppercase ${stock.level === 'ok' ? 'text-green-400' : stock.level === 'low' ? 'text-yellow-400' : 'text-red-400'}">${stock.qty} ${stock.baseUnit}</span>`
+                : '<span class="text-[8px] text-slate-700 font-black uppercase">ÔÇö</span>';
+            const avcoHtml = stock && stock.avco > 0
+                ? `<span class="text-[8px] text-slate-500 font-mono">${stock.avco.toFixed(2)} zł/${stock.baseUnit}</span>`
+                : '';
+            const aliasHtml = entry.aliasTerms.length
+                ? `<span class="text-[8px] text-slate-600 ml-1">┬Ě ${_eR(entry.aliasTerms.slice(0, 3).join(', '))}</span>`
+                : '';
+            return `
+                <div class="search-result-card flex items-center justify-between gap-3 p-2.5 border-b border-white/5 cursor-pointer hover:bg-blue-500/20 transition ${added ? 'opacity-40' : ''}" data-sku="${_eR(entry.sku)}" onclick="window.RecipeMapper.selectSearchResult('${_eR(entry.sku)}')">
+                    <div class="flex-1 min-w-0">
+                        <div class="text-[11px] font-black text-white truncate">${_eR(entry.name)}${added ? ' <span class=\"text-[8px] text-green-400\">(ju┼╝ w recepturze)</span>' : ''}</div>
+                        <div class="text-[8px] font-mono text-slate-500 truncate">${_eR(entry.sku)}${aliasHtml}</div>
+                    </div>
+                    <div class="flex flex-col items-end gap-0.5 shrink-0">
+                        ${stockHtml}
+                        ${avcoHtml}
+                    </div>
+                </div>
+            `;
+        }).join('');
+        results.classList.remove('hidden');
+    },
+
+    selectSearchResult(sku) {
+        const prod = this.state.products.find(p => p.sku === sku);
+        if (!prod) return;
+        const existing = this.state.currentRecipe.find(r => r.warehouseSku === sku);
+        if (existing) {
+            alert(`"${prod.name}" jest ju┼╝ w recepturze ÔÇö edytuj ilo┼Ť─ç poni┼╝ej.`);
+            return;
+        }
+        const quickadd = document.getElementById('ingredient-quickadd');
+        const nameEl = document.getElementById('quickadd-name');
+        const skuEl = document.getElementById('quickadd-sku');
+        const qtyEl = document.getElementById('quickadd-qty');
+        const unitEl = document.getElementById('quickadd-unit');
+        const searchEl = document.getElementById('ingredient-search');
+        const results = document.getElementById('ingredient-search-results');
+
+        if (nameEl) nameEl.textContent = prod.name;
+        if (skuEl) skuEl.textContent = prod.sku + ' ┬Ě base: ' + (prod.baseUnit || 'kg');
+        if (qtyEl) { qtyEl.value = ''; qtyEl.focus(); }
+        if (unitEl) unitEl.value = prod.baseUnit === 'szt' ? 'szt' : 'g';
+        if (quickadd) {
+            quickadd.classList.remove('hidden');
+            quickadd.dataset.activeSku = sku;
+        }
+        if (searchEl) searchEl.value = '';
+        if (results) results.classList.add('hidden');
+    },
+
+    confirmQuickAdd() {
+        const quickadd = document.getElementById('ingredient-quickadd');
+        const qtyEl = document.getElementById('quickadd-qty');
+        const unitEl = document.getElementById('quickadd-unit');
+        if (!quickadd) return;
+        const sku = quickadd.dataset.activeSku || '';
+        const qty = parseFloat(qtyEl?.value) || 0;
+        const unit = unitEl?.value || 'g';
+        if (!sku || qty <= 0) {
+            alert('Podaj ilo┼Ť─ç wi─Öksz─ů od 0.');
+            return;
+        }
+        this.addManual(sku, qty, unit, 0);
+        this.cancelQuickAdd();
+    },
+
+    cancelQuickAdd() {
+        const quickadd = document.getElementById('ingredient-quickadd');
+        if (quickadd) {
+            quickadd.classList.add('hidden');
+            delete quickadd.dataset.activeSku;
+        }
+        const qtyEl = document.getElementById('quickadd-qty');
+        if (qtyEl) qtyEl.value = '';
+    },
+
+    // ÔöÇÔöÇÔöÇ Bulk Add Modal ÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇ
+    openBulkAdd() {
+        let host = document.getElementById('sh-bulk-add-modal');
+        if (host) host.remove();
+        host = document.createElement('div');
+        host.id = 'sh-bulk-add-modal';
+        host.className = 'fixed inset-0 z-[9999] flex items-center justify-center bg-black/70 backdrop-blur-sm p-4';
+        host.innerHTML = `
+            <div class="bg-[#0a0a0f] border border-white/10 rounded-3xl shadow-2xl w-full max-w-2xl max-h-[90vh] flex flex-col overflow-hidden">
+                <header class="flex items-center justify-between px-6 py-4 border-b border-white/5 shrink-0">
+                    <div>
+                        <div class="text-[9px] font-black uppercase text-cyan-400 tracking-widest">Bulk Add</div>
+                        <div class="text-[14px] font-black text-white">Wklej listę składników</div>
+                    </div>
+                    <button type="button" class="bulk-close text-slate-500 hover:text-white w-9 h-9 rounded-lg hover:bg-white/5 transition flex items-center justify-center">
+                        <i class="fa-solid fa-xmark"></i>
+                    </button>
+                </header>
+                <div class="px-6 py-4 flex-1 overflow-y-auto">
+                    <p class="text-[10px] text-slate-400 mb-3 leading-relaxed">
+                        Jedna linia = jeden sk┼éadnik. Format: <code class="text-cyan-400 bg-black/50 px-1 py-0.5 rounded">nazwa ilo┼Ť─ç jednostka</code>
+                        <br>Przykład:<br>
+                        <code class="text-slate-500 bg-black/50 px-1 py-0.5 rounded text-[9px] block mt-1">mozzarella 150 g<br>sos pomidorowy 80 ml<br>bazylia 5 g<br>m─ůka 250</code>
+                    </p>
+                    <textarea id="bulk-add-textarea" rows="10" class="w-full bg-black/50 border border-white/10 text-white rounded-xl p-3 text-[11px] font-mono focus:border-cyan-500 outline-none transition" placeholder="mozzarella 150 g&#10;sos pomidorowy 80 ml&#10;..."></textarea>
+                    <div id="bulk-add-preview" class="mt-3 space-y-1 max-h-48 overflow-y-auto"></div>
+                </div>
+                <footer class="px-6 py-3 border-t border-white/5 flex items-center justify-between shrink-0">
+                    <div class="text-[9px] font-black uppercase text-slate-500 tracking-widest"><span id="bulk-add-count">0</span> linii ┬Ě <span id="bulk-add-matched" class="text-green-400">0</span> dopasowanych ┬Ě <span id="bulk-add-skipped" class="text-red-400">0</span> bez dopasowania</div>
+                    <div class="flex gap-2">
+                        <button type="button" class="bulk-close px-4 py-2 bg-white/5 border border-white/10 text-slate-400 hover:text-white rounded-lg text-[10px] font-black uppercase transition">Anuluj</button>
+                        <button type="button" id="bulk-add-apply" class="px-4 py-2 bg-gradient-to-r from-cyan-600 to-blue-600 hover:from-cyan-500 hover:to-blue-500 text-white rounded-lg text-[10px] font-black uppercase transition shadow-lg shadow-cyan-500/20 disabled:opacity-40 disabled:cursor-not-allowed">
+                            <i class="fa-solid fa-check mr-1"></i> Dodaj dopasowane
+                        </button>
+                    </div>
+                </footer>
+            </div>
+        `;
+        document.body.appendChild(host);
+
+        const textarea = host.querySelector('#bulk-add-textarea');
+        const applyBtn = host.querySelector('#bulk-add-apply');
+
+        const refreshPreview = () => {
+            const parsed = this._parseBulkLines(textarea.value);
+            host.querySelector('#bulk-add-count').textContent = String(parsed.length);
+            host.querySelector('#bulk-add-matched').textContent = String(parsed.filter(p => p.matched).length);
+            host.querySelector('#bulk-add-skipped').textContent = String(parsed.filter(p => !p.matched).length);
+            const preview = host.querySelector('#bulk-add-preview');
+            preview.innerHTML = parsed.map(p => {
+                if (p.matched) {
+                    const stock = this._getStockInfo(p.matched.sku);
+                    const stockBadge = stock
+                        ? `<span class="text-[8px] ${stock.level === 'ok' ? 'text-green-400' : stock.level === 'low' ? 'text-yellow-400' : 'text-red-400'} font-black uppercase">${stock.level}</span>`
+                        : '';
+                    return `<div class="flex items-center gap-2 p-1.5 bg-green-900/10 border border-green-500/30 rounded text-[10px]"><i class="fa-solid fa-check text-green-400 text-[9px]"></i><span class="text-slate-300 flex-1 truncate">${_eR(p.matched.name)} ┬Ě <span class="text-slate-500">${p.qty} ${p.unit}</span></span>${stockBadge}</div>`;
+                }
+                return `<div class="flex items-center gap-2 p-1.5 bg-red-900/10 border border-red-500/30 rounded text-[10px]"><i class="fa-solid fa-xmark text-red-400 text-[9px]"></i><span class="text-slate-500 flex-1 truncate">"${_eR(p.raw)}" ÔÇö brak w magazynie</span></div>`;
+            }).join('');
+            applyBtn.disabled = parsed.filter(p => p.matched).length === 0;
+        };
+
+        textarea.addEventListener('input', refreshPreview);
+
+        const close = () => host.remove();
+        host.addEventListener('click', (e) => {
+            if (e.target === host) close();
+            if (e.target.closest('.bulk-close')) close();
+        });
+        applyBtn.addEventListener('click', () => {
+            const parsed = this._parseBulkLines(textarea.value);
+            let added = 0;
+            parsed.forEach(p => {
+                if (!p.matched) return;
+                const exists = this.state.currentRecipe.some(r => r.warehouseSku === p.matched.sku);
+                if (exists) return;
+                this.state.currentRecipe.push({
+                    warehouseSku: p.matched.sku,
+                    name:         p.matched.name,
+                    baseUnit:     p.matched.baseUnit,
+                    unit:         p.unit,
+                    quantityBase: p.qty,
+                    wastePercent: 0,
+                    isPackaging:  false
+                });
+                added++;
+            });
+            this.renderRecipeList();
+            close();
+            if (added > 0) console.info(`[BulkAdd] Dodano ${added} składników do receptury.`);
+        });
+
+        textarea.focus();
+        refreshPreview();
+    },
+
+    _parseBulkLines(text) {
+        const index = this._buildProductIndex();
+        return (text || '').split('\n').map(line => {
+            const raw = line.trim();
+            if (!raw) return null;
+            const match = raw.match(/^(.+?)\s+(\d+(?:[\.,]\d+)?)\s*([a-zA-Z]+)?\s*$/);
+            let namePart = raw, qty = 100, unit = 'g';
+            if (match) {
+                namePart = match[1].trim();
+                qty = parseFloat(match[2].replace(',', '.')) || 100;
+                unit = (match[3] || 'g').toLowerCase();
+            }
+            const q = this._normalizeToken(namePart);
+            let best = null, bestScore = 0;
+            for (const entry of index) {
+                const score = this._fuzzyScore(namePart, entry);
+                if (score > bestScore) {
+                    bestScore = score;
+                    best = entry;
+                }
+            }
+            return {
+                raw,
+                qty,
+                unit,
+                matched: bestScore >= 35 ? { sku: best.sku, name: best.name, baseUnit: best.baseUnit } : null,
+            };
+        }).filter(x => x !== null);
+    },
+
+    // ÔöÇÔöÇÔöÇ Stock info helper ÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇ
+    _getStockInfo(sku) {
+        const items = window.StudioState?.warehouseItems || [];
+        const row = items.find(x => x.sku === sku);
+        if (!row) return null;
+        const qty = parseFloat(row.quantity) || 0;
+        const avco = parseFloat(row.current_avco_price) || 0;
+        let level = 'ok';
+        if (qty <= 0) level = 'out';
+        else if (qty < 5) level = 'low';
+        return {
+            qty: Number(qty.toFixed(3)),
+            avco,
+            baseUnit: row.base_unit || 'kg',
+            level,
+        };
+    },
+
+    _normalizeToken(str) {
+        return String(str || '').toLowerCase()
+            .normalize('NFD').replace(/[\u0300-\u036f]/g, '')
+            .trim();
+    },
+
+    _tokenize(text) {
+        const MIN_TOKEN_LEN = 3;
+        return text.toLowerCase()
+            .split(/[\s,.:;!?()\/\-]+/)
+            .map(t => t.trim())
+            .filter(t => t.length >= MIN_TOKEN_LEN);
+    },
+
+    _buildProductIndex() {
+        if (this._productIndex && this._productIndexVersion === this.state.products.length) {
+            return this._productIndex;
+        }
+
+        this._productIndex = this.state.products.map(prod => {
+            const nameTerms = this._tokenize(prod.name);
+
+            let aliasTerms = [];
+            if (prod.aliases && typeof prod.aliases === 'string') {
+                aliasTerms = prod.aliases
+                    .split(',')
+                    .map(a => a.trim().toLowerCase())
+                    .filter(a => a.length >= 2);
+            }
+
+            const nameNorm  = this._normalizeToken(prod.name);
+            const aliasNorm = aliasTerms.map(a => this._normalizeToken(a));
+
+            return {
+                sku:       prod.sku,
+                name:      prod.name,
+                baseUnit:  prod.baseUnit || 'kg',
+                nameTerms,
+                aliasTerms,
+                nameNorm,
+                aliasNorm,
+            };
+        });
+
+        this._productIndexVersion = this.state.products.length;
+        return this._productIndex;
     },
 
     autoScan() {
         const descInput = document.getElementById('insp-desc');
         if (!descInput) return;
-        
-        const desc = descInput.value.toLowerCase();
-        if (!desc) return;
 
-        this.state.products.forEach(prod => {
-            let searchTerms = [prod.name.toLowerCase()];
-            
-            if (prod.aliases) {
-                const aliasArray = prod.aliases.split(',').map(a => a.trim().toLowerCase()).filter(a => a !== '');
-                searchTerms = searchTerms.concat(aliasArray);
-            }
+        const rawText = descInput.value;
+        if (!rawText.trim()) return;
+
+        const tokens = this._tokenize(rawText);
+        const tokensNorm = tokens.map(t => this._normalizeToken(t));
+        if (tokens.length === 0) return;
+
+        const index = this._buildProductIndex();
+        let matchCount = 0;
+
+        index.forEach(entry => {
+            const alreadyExists = this.state.currentRecipe.some(
+                r => r.warehouseSku === entry.sku
+            );
+            if (alreadyExists) return;
+
+            let matched = false;
 
-            const escapedTerms = searchTerms.map(term => term.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'));
-            const regex = new RegExp('(^|[\\s,.;!?])(' + escapedTerms.join('|') + ')([\\s,.;!?]|$)', 'iu');
-            
-            if (regex.test(desc)) {
-                const alreadyExists = this.state.currentRecipe.some(r => r.warehouseSku === prod.sku);
-                if (!alreadyExists) {
-                    this.state.currentRecipe.push({
-                        warehouseSku: prod.sku,
-                        name: prod.name,
-                        baseUnit: prod.baseUnit || 'kg',
-                        unit: prod.baseUnit || 'kg',
-                        quantityBase: 0.1,
-                        wastePercent: 0,
-                        isPackaging: false
-                    });
+            for (let i = 0; i < tokens.length && !matched; i++) {
+                const tok     = tokens[i];
+                const tokNorm = tokensNorm[i];
+
+                if (entry.nameNorm.includes(tokNorm)) {
+                    matched = true;
+                    break;
+                }
+
+                for (const term of entry.nameTerms) {
+                    if (term.includes(tok) || tok.includes(term)) {
+                        matched = true;
+                        break;
+                    }
+                }
+                if (matched) break;
+
+                for (let j = 0; j < entry.aliasTerms.length; j++) {
+                    const alias     = entry.aliasTerms[j];
+                    const aliasNorm = entry.aliasNorm[j];
+
+                    if (alias === tok || aliasNorm === tokNorm) {
+                        matched = true;
+                        break;
+                    }
+                    if (tok.length >= 4 && (alias.includes(tok) || tok.includes(alias))) {
+                        matched = true;
+                        break;
+                    }
+                    if (tokNorm.length >= 4 && (aliasNorm.includes(tokNorm) || tokNorm.includes(aliasNorm))) {
+                        matched = true;
+                        break;
+                    }
                 }
             }
+
+            if (matched) {
+                this.state.currentRecipe.push({
+                    warehouseSku: entry.sku,
+                    name:         entry.name,
+                    baseUnit:     entry.baseUnit,
+                    unit:         entry.baseUnit,
+                    quantityBase: 0,
+                    wastePercent: 0,
+                    isPackaging:  false
+                });
+                matchCount++;
+            }
         });
-        
+
         this.renderRecipeList();
+
+        console.info(
+            `[AutoScan] Tokeny: [${tokens.join(', ')}] Ôćĺ dopasowano ${matchCount} surowc├│w`
+        );
     },
 
     // --- POPRAWIONE R─śCZNE DODAWANIE (Walidacja i UX) ---
@@ -181,109 +620,206 @@ window.RecipeMapper = {
 
     _triggerMarginUpdate() {
         if (!window.MarginGuardian || !window.MarginGuardian.initialized) return;
-        const vatRate = parseFloat(document.getElementById('item-vat-rate')?.value)         || 0;
+        const vatDineIn   = parseFloat(document.getElementById('item-vat-dine-in')?.value)   || 0;
+        const vatTakeaway = parseFloat(document.getElementById('item-vat-takeaway')?.value)  || 0;
         const priceTiers = [
-            { channel: 'POS',      price: parseFloat(document.getElementById('item-price-pos')?.value)      || 0, vatRate },
-            { channel: 'Takeaway', price: parseFloat(document.getElementById('item-price-takeaway')?.value) || 0, vatRate },
-            { channel: 'Delivery', price: parseFloat(document.getElementById('item-price-delivery')?.value) || 0, vatRate },
+            { channel: 'POS',      price: parseFloat(document.getElementById('item-price-pos')?.value)      || 0, vatRate: vatDineIn },
+            { channel: 'Takeaway', price: parseFloat(document.getElementById('item-price-takeaway')?.value) || 0, vatRate: vatTakeaway },
+            { channel: 'Delivery', price: parseFloat(document.getElementById('item-price-delivery')?.value) || 0, vatRate: vatTakeaway },
         ];
         const results = window.MarginGuardian.calculate(priceTiers, this.state.currentRecipe);
         window.MarginGuardian.render('margin-container', results);
     },
 
+    updateWaste(index, newWaste) {
+        const row = this.state.currentRecipe[index];
+        if (!row) return;
+        const w = Math.max(0, Math.min(100, parseFloat(newWaste) || 0));
+        row.wastePercent = w;
+        this.renderRecipeList();
+    },
+
+    updateUnit(index, newUnit) {
+        const row = this.state.currentRecipe[index];
+        if (!row) return;
+        row.unit = newUnit || row.baseUnit;
+        this.renderRecipeList();
+    },
+
     renderRecipeList() {
         const container = document.getElementById('recipe-ingredients-list');
         if (!container) return;
-        
-        if (this.state.currentRecipe.length === 0) {
-            container.innerHTML = '<div class="text-slate-500 text-[10px] italic p-4 text-center">Brak przypisanych składników.</div>';
-            this._triggerMarginUpdate();
-            return;
-        }
 
         const _avcoDict = (window.MarginGuardian && window.MarginGuardian.initialized)
             ? window.MarginGuardian.avcoDict
             : {};
 
-        let html = '<div class="recipe-grid w-full space-y-2">';
-        this.state.currentRecipe.forEach((ing, index) => {
-            // --- Defensive per-row cost ---
-            const unitAvco  = _avcoDict[ing.warehouseSku] ?? 0;
+        let totalCost = 0;
+        const rowDetails = this.state.currentRecipe.map((ing) => {
+            const unitAvco  = _avcoDict[ing.warehouseSku] ?? (this._getStockInfo(ing.warehouseSku)?.avco || 0);
             const rawQty    = parseFloat(ing.quantityBase) || 0;
             const wastePct  = parseFloat(ing.wastePercent) || 0;
             const usageUnit = ing.unit || ing.baseUnit;
-
             const targetBaseUnit = ing.baseUnit || 'kg';
 
             let actualQtyInBaseUnits = 0;
             if (typeof window.SliceValidator !== 'undefined') {
                 const conversion = window.SliceValidator.convert(rawQty, usageUnit, targetBaseUnit);
-                if (conversion.success) {
-                    actualQtyInBaseUnits = conversion.value;
-                } else {
-                    console.warn(
-                        `[SliceHub Math] Unit mismatch or error for ${ing.warehouseSku}:`,
-                        conversion.msg || conversion.error
-                    );
-                    // Fallback to 0 ÔÇö prevents catastrophic Food Cost inflation.
-                }
+                actualQtyInBaseUnits = conversion.success ? conversion.value : 0;
             } else {
                 actualQtyInBaseUnits = rawQty;
             }
-
             const qtyWithWaste = actualQtyInBaseUnits * (1 + wastePct / 100);
-            const rowCost      = qtyWithWaste * unitAvco;
-            const rowCostStr   = (rowCost > 0)
-                ? rowCost.toLocaleString('pl-PL', { style: 'currency', currency: 'PLN', minimumFractionDigits: 2, maximumFractionDigits: 4 })
-                : 'ÔÇö';
+            const rowCost = qtyWithWaste * unitAvco;
+            totalCost += rowCost;
+            return { ing, unitAvco, rawQty, wastePct, usageUnit, qtyWithWaste, rowCost };
+        });
 
-            html += `
-            <div class="recipe-row flex items-center justify-between p-2 border border-white/10 bg-black/40 rounded" data-sku="${ing.warehouseSku}">
+        const costStr = totalCost > 0
+            ? totalCost.toLocaleString('pl-PL', { style: 'currency', currency: 'PLN', minimumFractionDigits: 2, maximumFractionDigits: 2 })
+            : '0,00 zł';
+
+        const headerHtml = `
+            <div class="recipe-header flex items-center justify-between bg-gradient-to-r from-purple-900/20 to-transparent border border-purple-500/20 p-3 rounded-xl mb-2">
                 <div class="flex flex-col">
-                    <span class="text-white text-[11px] font-bold">${ing.name}</span>
-                    <span class="text-slate-500 text-[9px] font-mono">SKU: ${ing.warehouseSku}</span>
+                    <span class="text-[8px] font-black uppercase text-purple-400 tracking-widest"><i class="fa-solid fa-receipt mr-1"></i> Food Cost (AVCO ├Ś qty + ubytek)</span>
+                    <span class="text-[16px] font-black text-white mt-0.5">${costStr}</span>
                 </div>
-                <div class="flex items-center gap-2">
-                    <input type="number" 
-                           step="0.001" 
-                           value="${ing.quantityBase}" 
-                           class="w-20 bg-transparent border border-white/20 text-white text-center text-[11px] p-1 rounded outline-none focus:border-blue-500"
-                           onchange="window.RecipeMapper.updateQty(${index}, this.value)" />
-                    <span class="text-slate-400 text-[10px] font-bold uppercase w-8">${usageUnit}</span>
-                    <span class="text-slate-500 text-[10px] font-mono w-16 text-right" title="Koszt wiersza (po konwersji jednostek)">${rowCostStr}</span>
-                    <button class="bg-red-900/50 hover:bg-red-600 text-red-200 px-3 py-1 rounded transition text-[10px] font-bold uppercase" 
-                            onclick="window.RecipeMapper.removeIngredient(${index})">
-                        Usuń
-                    </button>
+                <div class="flex flex-col items-end">
+                    <span class="text-[8px] font-black uppercase text-slate-500 tracking-widest">Składników</span>
+                    <span class="text-[14px] font-black text-slate-300">${this.state.currentRecipe.length}</span>
                 </div>
             </div>
+        `;
+
+        if (this.state.currentRecipe.length === 0) {
+            container.innerHTML = headerHtml + '<div class="text-slate-500 text-[10px] italic p-4 text-center border border-dashed border-white/10 rounded-xl">Brak przypisanych składników. Użyj wyszukiwarki powyżej lub AutoScan.</div>';
+            this._triggerMarginUpdate();
+            return;
+        }
+
+        let html = headerHtml + '<div class="recipe-grid w-full space-y-1.5">';
+        rowDetails.forEach((d, index) => {
+            const stock = this._getStockInfo(d.ing.warehouseSku);
+            let stockBadge = '';
+            if (stock) {
+                const toneMap = {
+                    ok:  'bg-green-900/30 border-green-500/40 text-green-400',
+                    low: 'bg-yellow-900/30 border-yellow-500/40 text-yellow-400',
+                    out: 'bg-red-900/30 border-red-500/40 text-red-400 animate-pulse',
+                };
+                const iconMap = {
+                    ok:  'fa-check',
+                    low: 'fa-triangle-exclamation',
+                    out: 'fa-circle-xmark',
+                };
+                const labelMap = {
+                    ok:  `${stock.qty} ${stock.baseUnit}`,
+                    low: `niski ${stock.qty} ${stock.baseUnit}`,
+                    out: 'BRAK',
+                };
+                stockBadge = `<span class="inline-flex items-center gap-1 text-[8px] font-black uppercase px-1.5 py-0.5 rounded border ${toneMap[stock.level]}" title="Stan magazynowy: ${stock.qty} ${stock.baseUnit}"><i class="fa-solid ${iconMap[stock.level]} text-[7px]"></i> ${labelMap[stock.level]}</span>`;
+            } else {
+                stockBadge = `<span class="inline-flex items-center gap-1 text-[8px] font-black uppercase px-1.5 py-0.5 rounded border bg-slate-800 border-white/10 text-slate-500" title="Brak w magazynie"><i class="fa-solid fa-question text-[7px]"></i> n/a</span>`;
+            }
+
+            const rowCostStr = d.rowCost > 0
+                ? d.rowCost.toLocaleString('pl-PL', { style: 'currency', currency: 'PLN', minimumFractionDigits: 2, maximumFractionDigits: 4 })
+                : 'ÔÇö';
+
+            html += `
+            <div class="recipe-row flex items-center justify-between gap-2 p-2 border border-white/10 bg-black/40 rounded-lg hover:border-white/20 transition" data-sku="${_eR(d.ing.warehouseSku)}">
+                <div class="flex-1 min-w-0">
+                    <div class="flex items-center gap-2">
+                        <span class="text-white text-[11px] font-black truncate">${_eR(d.ing.name)}</span>
+                        ${stockBadge}
+                    </div>
+                    <div class="text-slate-600 text-[8px] font-mono truncate">${_eR(d.ing.warehouseSku)} ┬Ě base: ${_eR(d.ing.baseUnit || 'kg')}</div>
+                </div>
+                <input type="number" step="0.001" min="0" value="${d.ing.quantityBase}"
+                       class="w-16 bg-transparent border border-white/20 text-white text-center text-[11px] p-1 rounded outline-none focus:border-blue-500"
+                       onchange="window.RecipeMapper.updateQty(${index}, this.value)" title="Ilo┼Ť─ç w jednostce u┼╝ytkowej">
+                <select class="bg-black/50 border border-white/10 text-white text-[10px] rounded p-1 outline-none focus:border-blue-500 cursor-pointer"
+                        onchange="window.RecipeMapper.updateUnit(${index}, this.value)" title="Jednostka">
+                    ${['g','ml','kg','l','szt','por','opak'].map(u => `<option value="${u}" ${u === d.usageUnit ? 'selected' : ''}>${u}</option>`).join('')}
+                </select>
+                <input type="number" step="0.1" min="0" max="100" value="${d.wastePct}"
+                       class="w-12 bg-transparent border border-amber-500/30 text-amber-300 text-center text-[10px] p-1 rounded outline-none focus:border-amber-500"
+                       onchange="window.RecipeMapper.updateWaste(${index}, this.value)" title="Ubytek %">
+                <span class="text-slate-400 text-[10px] font-mono w-20 text-right shrink-0" title="Koszt wiersza (AVCO ├Ś qty ├Ś (1+waste%))">${rowCostStr}</span>
+                <button class="bg-red-900/30 hover:bg-red-600 text-red-200 hover:text-white w-7 h-7 rounded transition text-[10px] flex items-center justify-center shrink-0"
+                        onclick="window.RecipeMapper.removeIngredient(${index})" title="Usuń z receptury">
+                    <i class="fa-solid fa-trash-can"></i>
+                </button>
+            </div>
             `;
         });
         html += '</div>';
-        
+
+        html += `
+            <div class="recipe-footer sticky bottom-0 mt-3 pt-3 border-t border-white/10 bg-[#0a0a0f]/95 backdrop-blur">
+                <button type="button" id="btn-save-recipe"
+                        onclick="window.RecipeMapper.saveItemRecipe()"
+                        class="w-full bg-gradient-to-r from-purple-600 to-blue-600 hover:from-purple-500 hover:to-blue-500 text-white font-black text-[11px] uppercase tracking-widest py-3 rounded-xl shadow-[0_0_15px_rgba(147,51,234,0.3)] transition-all flex items-center justify-center gap-2">
+                    <i class="fa-solid fa-floppy-disk"></i> Zapisz Receptur─Ö (${this.state.currentRecipe.length})
+                </button>
+            </div>
+        `;
+
         container.innerHTML = html;
         this._triggerMarginUpdate();
     },
 
     async saveItemRecipe() {
+        const btn = document.getElementById('btn-save-recipe');
+        const origHtml = btn ? btn.innerHTML : '';
+
         if (!this.state.currentMenuItemSku) {
             alert("B┼é─ůd: Nie wybrano ┼╝adnego dania.");
             return;
         }
 
+        if (btn) {
+            btn.disabled = true;
+            btn.innerHTML = '<i class="fa-solid fa-spinner fa-spin"></i> Zapisywanie...';
+        }
+
         const payload = {
             menuItemSku: this.state.currentMenuItemSku,
             ingredients: this.state.currentRecipe
         };
 
-        const response = await this.fetchApi('save_recipe', payload);
-        
-        if (response.success === true) {
-            console.log("[RecipeMapper] Sukces:", response.message);
-            alert("Receptura została zapisana!");
-        } else {
-            console.error("[RecipeMapper] B┼é─ůd:", response.message);
-            alert("Wyst─ůpi┼é b┼é─ůd podczas zapisu: " + response.message);
+        try {
+            const response = await this.fetchApi('save_recipe', payload);
+
+            if (response.success === true) {
+                console.log("[RecipeMapper] Sukces:", response.message);
+                if (btn) {
+                    btn.innerHTML = '<i class="fa-solid fa-check"></i> Zapisano!';
+                    btn.classList.replace('from-purple-600', 'from-green-600');
+                    btn.classList.replace('to-blue-600', 'to-green-500');
+                    setTimeout(() => {
+                        btn.innerHTML = origHtml || `<i class="fa-solid fa-floppy-disk"></i> Zapisz Receptur─Ö (${this.state.currentRecipe.length})`;
+                        btn.classList.replace('from-green-600', 'from-purple-600');
+                        btn.classList.replace('to-green-500', 'to-blue-600');
+                        btn.disabled = false;
+                    }, 1800);
+                }
+            } else {
+                console.error("[RecipeMapper] B┼é─ůd:", response.message);
+                alert("Wyst─ůpi┼é b┼é─ůd podczas zapisu: " + response.message);
+                if (btn) {
+                    btn.disabled = false;
+                    btn.innerHTML = origHtml || `<i class="fa-solid fa-floppy-disk"></i> Zapisz Receptur─Ö`;
+                }
+            }
+        } catch (err) {
+            console.error('[RecipeMapper] network error:', err);
+            alert('Krytyczny b┼é─ůd sieci.');
+            if (btn) {
+                btn.disabled = false;
+                btn.innerHTML = origHtml || `<i class="fa-solid fa-floppy-disk"></i> Zapisz Receptur─Ö`;
+            }
         }
     }
 };
diff --git a/modules/studio/js/studio_ui.js b/modules/studio/js/studio_ui.js
index 5a5d0b6..ba5c7c4 100644
--- a/modules/studio/js/studio_ui.js
+++ b/modules/studio/js/studio_ui.js
@@ -1,3 +1,5 @@
+const _e = s => { const d = document.createElement('div'); d.textContent = s == null ? '' : String(s); return d.innerHTML; };
+
 window.Core = {
     switchView: function(viewId) {
         console.log("[UI] Prze┼é─ůczanie na widok:", viewId);
@@ -13,6 +15,11 @@ window.Core = {
         document.querySelectorAll('.nav-btn').forEach(btn => btn.classList.remove('active'));
         const navBtn = document.getElementById('nav-' + viewId);
         if (navBtn) navBtn.classList.add('active');
+
+        if (viewId === 'modifiers' && window.ModifierInspector) {
+            window.ModifierInspector.renderInit();
+            window.ModifierInspector.renderGroupList();
+        }
     },
     renderTree: function() {
         const container = document.getElementById('dynamic-tree-container');
@@ -34,12 +41,19 @@ window.Core = {
                 <div class="p-3 bg-white/5 flex items-center justify-between cursor-pointer hover:bg-white/10 transition" onclick="window.Core.toggleCategory(${cat.id})">
                     <div class="flex items-center gap-2">
                         <i id="icon-cat-${cat.id}" class="fa-solid fa-chevron-down text-[10px] text-slate-400 transition-transform"></i>
-                        <span class="text-[11px] font-black uppercase text-white tracking-wider">${cat.name}</span>
+                        <span class="text-[11px] font-black uppercase text-white tracking-wider">${_e(cat.name)}</span>
                     </div>
-                    <div class="flex items-center">
+                    <div class="flex items-center gap-1">
                         <span class="text-[9px] font-bold text-slate-500 bg-black/50 px-2 py-0.5 rounded border border-white/5">${catItems.length} dań</span>
-                        <button onclick="event.stopPropagation(); window.Core.addNewItem(${cat.id})" class="ml-3 text-green-400 hover:text-white text-[10px] font-black uppercase">
-                            <i class="fa-solid fa-plus"></i> Nowe Danie
+                        ${cat.layoutMode && cat.layoutMode !== 'legacy_list' ? `
+                        <button onclick="event.stopPropagation(); window.CategoryTableEditor && window.CategoryTableEditor.open(${cat.id})" class="text-slate-600 hover:text-violet-400 text-[10px] px-1 transition" title="Układ stołu kategorii (The Table)">
+                            <i class="fa-solid fa-table-cells"></i>
+                        </button>` : ''}
+                        <button onclick="event.stopPropagation(); window.Core.editCategory(${cat.id})" class="text-slate-600 hover:text-blue-400 text-[10px] px-1 transition" title="Edytuj kategori─Ö (VAT)">
+                            <i class="fa-solid fa-gear"></i>
+                        </button>
+                        <button onclick="event.stopPropagation(); window.Core.addNewItem(${cat.id})" class="text-green-400 hover:text-white text-[10px] font-black uppercase">
+                            <i class="fa-solid fa-plus"></i> Nowe
                         </button>
                     </div>
                 </div>
@@ -57,15 +71,24 @@ window.Core = {
                     
                     const isChecked = window.StudioState.bulkSelectedItems.includes(item.id) ? 'checked' : '';
 
+                    // M1 ┬Ě thumbnail z AssetResolver::injectHeros (get_menu_tree)
+                    const thumbHtml = item.imageUrl
+                        ? `<img src="${_e(item.imageUrl)}" alt="" class="w-full h-full object-cover" loading="lazy" onerror="this.remove(); this.parentElement.innerHTML='<i class=\\'fa-solid fa-image text-slate-700 text-[11px]\\'></i>';">`
+                        : `<i class="fa-solid fa-image text-slate-700 text-[11px]" title="Brak zdj─Öcia ÔÇö dodaj w Asset Studio"></i>`;
+                    const thumbRing = item.imageUrl
+                        ? 'border-white/10'
+                        : 'border-amber-500/20 bg-amber-900/10';
+
                     html += `
-                    <div class="p-3 pl-8 flex items-center justify-between border-b border-white/5 last:border-0 hover:bg-blue-500/10 cursor-pointer transition group" onclick="window.Core.openItemEditor(${item.id}, '${item.asciiKey}')">
-                        <div class="flex items-center gap-3">
-                            <input type="checkbox" ${isChecked} class="w-4 h-4 rounded bg-black/50 border-white/20 cursor-pointer accent-cyan-500" onclick="event.stopPropagation(); window.Core.toggleBulkSelection(${item.id})">
-                            <i class="fa-solid fa-grip-vertical text-slate-600 text-[10px] opacity-0 group-hover:opacity-100 transition-opacity"></i>
-                            <span class="text-[11px] font-bold text-slate-300 group-hover:text-blue-400 transition-colors">${item.name}</span>
+                    <div class="p-3 pl-8 flex items-center justify-between border-b border-white/5 last:border-0 hover:bg-blue-500/10 cursor-pointer transition group" data-item-id="${item.id}" data-item-sku="${_e(item.asciiKey)}">
+                        <div class="flex items-center gap-3 min-w-0 flex-1">
+                            <input type="checkbox" ${isChecked} class="w-4 h-4 rounded bg-black/50 border-white/20 cursor-pointer accent-cyan-500 shrink-0" onclick="event.stopPropagation(); window.Core.toggleBulkSelection(${item.id})">
+                            <i class="fa-solid fa-grip-vertical text-slate-600 text-[10px] opacity-0 group-hover:opacity-100 transition-opacity shrink-0"></i>
+                            <div class="item-thumb w-9 h-9 rounded-lg bg-black/60 border ${thumbRing} overflow-hidden flex items-center justify-center shrink-0 shadow-inner">${thumbHtml}</div>
+                            <span class="text-[11px] font-bold text-slate-300 group-hover:text-blue-400 transition-colors truncate">${_e(item.name)}</span>
                         </div>
-                        <div class="flex items-center gap-3">
-                            <span class="text-[9px] text-slate-600 font-mono hidden group-hover:block transition-all">${item.asciiKey}</span>
+                        <div class="flex items-center gap-3 shrink-0">
+                            <span class="text-[9px] text-slate-600 font-mono hidden group-hover:block transition-all">${_e(item.asciiKey)}</span>
                             <span class="text-[10px] text-yellow-500 font-bold font-mono bg-black/40 px-2 py-0.5 rounded border border-white/5">${displayPrice} PLN</span>
                             ${statusIcon}
                         </div>
@@ -77,6 +100,9 @@ window.Core = {
         });
         html += '</div>';
         container.innerHTML = html;
+        container.querySelectorAll('[data-item-id][data-item-sku]').forEach(el => {
+            el.addEventListener('click', () => window.Core.openItemEditor(parseInt(el.dataset.itemId), el.dataset.itemSku));
+        });
     },
     toggleBulkSelection: function(itemId) {
         window.StudioState.bulkSelectedItems = window.StudioState.bulkSelectedItems || [];
@@ -142,8 +168,7 @@ window.Core = {
     },
     addNewItem: function(categoryId) {
         window.Core.switchView('menu');
-        
-        // --- ŁATKA: Ładowanie kategorii do wyboru ---
+
         const catSelect = document.getElementById('item-category-id');
         if (catSelect && catSelect.options.length <= 1) {
             const categories = window.StudioState?.categories || [];
@@ -151,7 +176,10 @@ window.Core = {
                 catSelect.add(new Option(cat.name, cat.id));
             });
         }
-        // --------------------------------------------
+
+        const cat = (window.StudioState?.categories || []).find(c => c.id == categoryId);
+        const vatDineIn = cat?.defaultVatDineIn ?? 8;
+        const vatTakeaway = cat?.defaultVatTakeaway ?? 5;
 
         if (window.ItemEditor && typeof window.ItemEditor.loadItemDataToForm === 'function') {
             window.ItemEditor.loadItemDataToForm({
@@ -160,20 +188,156 @@ window.Core = {
                 name: '',
                 asciiKey: '',
                 isActive: true,
-                vatRate: 23,
+                vatRateDineIn: vatDineIn,
+                vatRateTakeaway: vatTakeaway,
                 priceMatrix: { POS: 0, Takeaway: 0, Delivery: 0 },
                 kdsStationId: 'NONE',
                 publicationStatus: 'Draft'
             });
         }
     },
+
+    _renderCategoryModal: function(catData) {
+        const isEdit = catData && catData.id > 0;
+        const title = isEdit ? 'Edytuj Kategori─Ö' : 'Nowa Kategoria';
+        const name = catData?.name || '';
+        const vatDI = catData?.defaultVatDineIn ?? 8;
+        const vatTA = catData?.defaultVatTakeaway ?? 5;
+        // M022: layout_mode + default_composition_profile
+        const layoutMode = catData?.layoutMode || 'legacy_list';
+        const defaultProfile = catData?.defaultCompositionProfile || 'static_hero';
+
+        let existing = document.getElementById('category-modal-overlay');
+        if (existing) existing.remove();
+
+        // M022: Scene templates dla dropdown ÔÇö we┼║ z cache'u
+        const itemTemplates = (window.StudioState?.sceneTemplates || []).filter(t => t.kind === 'item');
+        const profileOptions = itemTemplates.length > 0
+            ? itemTemplates.map(t =>
+                `<option value="${t.asciiKey}" ${defaultProfile === t.asciiKey ? 'selected' : ''}>${t.name}</option>`
+              ).join('')
+            : `<option value="static_hero" ${defaultProfile === 'static_hero' ? 'selected' : ''}>Gotowe zdj─Öcie dania (uniwersalny)</option>
+               <option value="pizza_top_down" ${defaultProfile === 'pizza_top_down' ? 'selected' : ''}>Pizza ÔÇö kamera z g├│ry (warstwy)</option>`;
+
+        const layoutOption = (id, label, desc) => `
+            <label class="flex items-start gap-3 cursor-pointer group hover:bg-white/5 p-3 rounded-lg border border-transparent hover:border-white/10 transition">
+                <input type="radio" name="cat-modal-layout" value="${id}" class="mt-0.5 w-4 h-4 cursor-pointer" ${layoutMode === id ? 'checked' : ''}>
+                <div class="flex-1">
+                    <div class="text-white text-[11px] font-bold group-hover:text-blue-300 transition">${label}</div>
+                    <div class="text-slate-600 text-[9px] mt-0.5 leading-relaxed">${desc}</div>
+                </div>
+            </label>`;
+
+        const overlay = document.createElement('div');
+        overlay.id = 'category-modal-overlay';
+        overlay.className = 'fixed inset-0 z-[9999] flex items-center justify-center bg-black/70 backdrop-blur-sm overflow-y-auto py-8';
+        overlay.innerHTML = `
+        <div class="bg-[#0c0f1a] border border-white/10 rounded-2xl p-8 w-[520px] shadow-2xl my-auto">
+            <h3 class="text-white text-sm font-black uppercase tracking-widest mb-6">${title}</h3>
+            <div class="flex flex-col gap-5">
+                <div class="flex flex-col gap-1.5">
+                    <label class="text-[10px] text-slate-400 font-bold uppercase tracking-wider">Nazwa Kategorii</label>
+                    <input type="text" id="cat-modal-name" value="${name}" class="bg-black/50 border border-white/10 text-white rounded p-3 text-sm focus:border-blue-500 focus:outline-none transition" placeholder="np. Pizze, Napoje, Desery...">
+                </div>
+                <div class="flex flex-col gap-1.5">
+                    <label class="text-[10px] text-slate-400 font-bold uppercase tracking-wider">Domy┼Ťlne Stawki VAT dla da┼ä w tej kategorii</label>
+                    <div class="grid grid-cols-2 gap-3">
+                        <div class="flex flex-col gap-1">
+                            <span class="text-[8px] text-slate-500 font-bold uppercase">Na Sali (Dine-in)</span>
+                            <select id="cat-modal-vat-dinein" class="bg-black/50 border border-white/10 text-white rounded p-2.5 text-xs focus:border-blue-500 focus:outline-none transition cursor-pointer">
+                                <option value="23" ${vatDI==23?'selected':''}>23%</option>
+                                <option value="8" ${vatDI==8?'selected':''}>8%</option>
+                                <option value="5" ${vatDI==5?'selected':''}>5%</option>
+                                <option value="0" ${vatDI==0?'selected':''}>0%</option>
+                            </select>
+                        </div>
+                        <div class="flex flex-col gap-1">
+                            <span class="text-[8px] text-slate-500 font-bold uppercase">Wynos / Dostawa</span>
+                            <select id="cat-modal-vat-takeaway" class="bg-black/50 border border-white/10 text-white rounded p-2.5 text-xs focus:border-blue-500 focus:outline-none transition cursor-pointer">
+                                <option value="23" ${vatTA==23?'selected':''}>23%</option>
+                                <option value="8" ${vatTA==8?'selected':''}>8%</option>
+                                <option value="5" ${vatTA==5?'selected':''}>5%</option>
+                                <option value="0" ${vatTA==0?'selected':''}>0%</option>
+                            </select>
+                        </div>
+                    </div>
+                    <p class="text-[8px] text-slate-600 mt-1">Nowe dania dodawane do tej kategorii odziedzicz─ů te stawki. Mo┼╝esz je nadpisa─ç per danie.</p>
+                </div>
+
+                <!-- M022: Default Composition Profile -->
+                <div class="flex flex-col gap-1.5">
+                    <label class="text-[10px] text-slate-400 font-bold uppercase tracking-wider">Domy┼Ťlny Profil Kompozycji (Scene Studio)</label>
+                    <select id="cat-modal-composition-profile" class="bg-black/50 border border-white/10 text-white rounded p-2.5 text-xs focus:border-blue-500 focus:outline-none transition cursor-pointer">
+                        ${profileOptions}
+                    </select>
+                    <p class="text-[8px] text-slate-600 mt-1">Nowe dania w tej kategorii dziedzicz─ů ten profil. Pizza = warstwy z g├│ry, pozosta┼ée = 1 gotowe zdj─Öcie.</p>
+                </div>
+
+                <!-- M022: Layout Mode dla The Table (klient) -->
+                <div class="flex flex-col gap-1.5">
+                    <label class="text-[10px] text-slate-400 font-bold uppercase tracking-wider">Widok klienta ÔÇö The Table</label>
+                    <div class="flex flex-col gap-2 bg-black/30 rounded-xl p-3 border border-white/5">
+                        ${layoutOption('legacy_list',
+                            'Klasyczna lista',
+                            'Standard ÔÇö lista da┼ä z miniaturkami. U┼╝ywane dzi┼Ť, dzia┼éa wsz─Ödzie.')}
+                        ${layoutOption('grouped',
+                            'Jeden wspólny stół',
+                            'Cała kategoria na jednej dioramie (np. 5 sosów na drewnianej desce). Dobre dla kategorii &#8804;6 pozycji.')}
+                        ${layoutOption('individual',
+                            'Sekwencja scen per danie',
+                            'Ka┼╝de danie ma w┼éasn─ů dioram─Ö (swipe w lewo/prawo). St├│┼é zostaje ÔÇö zmienia si─Ö tylko centerpiece.')}
+                        ${layoutOption('hybrid',
+                            'Banner + sekwencja',
+                            'Pierwsza diorama = banner kategorii, kolejne = osobne dania. Premium feeling.')}
+                    </div>
+                    <p class="text-[8px] text-slate-600 mt-1">
+                        <i class="fa-solid fa-circle-info text-[7px] mr-1 opacity-40"></i>
+                        Widok klienta (The Table) jest w Fazie 3 ÔÇö dzi┼Ť zapisujesz wyb├│r, klient zobaczy go gdy front zostanie zbudowany.
+                    </p>
+                </div>
+            </div>
+            <div class="flex gap-3 mt-8">
+                <button id="cat-modal-save" class="flex-1 bg-blue-600 hover:bg-blue-500 text-white font-black text-xs uppercase tracking-widest py-3 rounded-lg transition shadow-lg">
+                    <i class="fa-solid fa-check mr-2"></i>${isEdit ? 'Zapisz' : 'Dodaj'}
+                </button>
+                <button id="cat-modal-cancel" class="px-6 bg-white/5 border border-white/10 text-slate-400 hover:text-white font-black text-xs uppercase rounded-lg transition">
+                    Anuluj
+                </button>
+            </div>
+        </div>`;
+
+        document.body.appendChild(overlay);
+        document.getElementById('cat-modal-name').focus();
+        document.getElementById('cat-modal-cancel').onclick = () => overlay.remove();
+        overlay.addEventListener('click', (e) => { if (e.target === overlay) overlay.remove(); });
+
+        return new Promise((resolve) => {
+            document.getElementById('cat-modal-save').onclick = () => {
+                const layoutRadio = document.querySelector('input[name="cat-modal-layout"]:checked');
+                const result = {
+                    name: document.getElementById('cat-modal-name').value.trim(),
+                    defaultVatDineIn: parseFloat(document.getElementById('cat-modal-vat-dinein').value),
+                    defaultVatTakeaway: parseFloat(document.getElementById('cat-modal-vat-takeaway').value),
+                    // M022: nowe pola
+                    layoutMode: layoutRadio?.value || 'legacy_list',
+                    defaultCompositionProfile: document.getElementById('cat-modal-composition-profile').value || 'static_hero'
+                };
+                overlay.remove();
+                resolve(result);
+            };
+            document.getElementById('cat-modal-name').addEventListener('keydown', (e) => {
+                if (e.key === 'Enter') document.getElementById('cat-modal-save').click();
+                if (e.key === 'Escape') { overlay.remove(); resolve(null); }
+            });
+        });
+    },
+
     addCategory: async function() {
-        console.log("[UI] Klikni─Öto dodaj kategori─Ö");
-        const name = prompt("Podaj nazw─Ö nowej kategorii:");
-        if (!name) return;
+        const result = await window.Core._renderCategoryModal(null);
+        if (!result || !result.name) return;
 
         try {
-            const response = await window.apiStudio('add_category', { name: name });
+            const response = await window.apiStudio('add_category', result);
             if (response && response.success === true) {
                 await window.loadMenuTree();
                 window.Core.renderTree();
@@ -184,6 +348,27 @@ window.Core = {
             alert("B┼é─ůd sieci przy dodawaniu kategorii.");
             console.error("[UI] addCategory error:", e);
         }
+    },
+
+    editCategory: async function(catId) {
+        const cat = (window.StudioState?.categories || []).find(c => c.id == catId);
+        if (!cat) return;
+
+        const result = await window.Core._renderCategoryModal(cat);
+        if (!result || !result.name) return;
+
+        try {
+            const response = await window.apiStudio('update_category', { categoryId: catId, ...result });
+            if (response && response.success === true) {
+                await window.loadMenuTree();
+                window.Core.renderTree();
+            } else {
+                alert("B┼é─ůd: " + (response?.message || "Nie uda┼éo si─Ö zaktualizowa─ç kategorii."));
+            }
+        } catch (e) {
+            alert("B┼é─ůd sieci przy edycji kategorii.");
+            console.error("[UI] editCategory error:", e);
+        }
     }
 };
 
@@ -195,6 +380,14 @@ document.addEventListener('DOMContentLoaded', async () => {
         if(treeContainer) treeContainer.innerHTML = '<div class="text-center mt-10 text-red-500 font-bold text-[10px]">B┼é─ůd Krytyczny: Brak pliku M├│zgu (studio_core.js)</div>';
         return;
     }
+
+    // M022: Scene templates loading (parallel, non-blocking ÔÇö cache'owane)
+    if (typeof window.loadSceneTemplates === 'function') {
+        window.loadSceneTemplates().catch(() => {
+            // cicho ÔÇö migracja 022 mo┼╝e jeszcze nie przej┼Ť─ç, formularz dania u┼╝yje fallback hard-coded listy
+        });
+    }
+
     const data = await window.loadMenuTree();
     if (data) window.Core.renderTree();
     else if(treeContainer) treeContainer.innerHTML = '<div class="text-center mt-10 text-red-500 font-bold text-[10px]">B┼é─ůd pobierania danych z API. Sprawd┼║ konsol─Ö.</div>';
diff --git a/modules/warehouse/js/warehouse_core.js b/modules/warehouse/js/warehouse_core.js
index d062c82..e0753d0 100644
--- a/modules/warehouse/js/warehouse_core.js
+++ b/modules/warehouse/js/warehouse_core.js
@@ -3,16 +3,15 @@
  * Tryb: Control Tower
  */
 
-// Bazowy URL API ÔÇö ┼Ťcie┼╝ka relatywna wzgl─Ödem tego pliku (modules/warehouse/js/)
-const API_BASE = '../../api/api_warehouse.php';
-
-// Globalny Stan Aplikacji (Źródło Prawdy)
 window.WarehouseState = {
     stock: [],
-    activeActionSku: null
+    activeActionSku: null,
+    warehouses: [],
+    refreshTimer: null,
 };
 
-// Formatter Walutowy (PLN)
+const REFRESH_INTERVAL_MS = 30_000;
+
 const formatCurrency = new Intl.NumberFormat('pl-PL', {
     style: 'currency',
     currency: 'PLN'
@@ -22,38 +21,117 @@ document.addEventListener('DOMContentLoaded', () => {
     initControlTower();
 });
 
-function initControlTower() {
+async function initControlTower() {
+    await loadWarehouseList();
     loadStock();
+    startAutoRefresh();
 
-    // Globalny przycisk "Strata (RW)" w nagłówku
     const btnOpenRw = document.getElementById('btn-open-rw');
     if (btnOpenRw) {
         btnOpenRw.addEventListener('click', () => openRWModal());
     }
+
+    const picker = document.getElementById('warehousePicker');
+    if (picker) {
+        picker.addEventListener('change', () => {
+            localStorage.setItem('sh_warehouse_id', picker.value);
+            loadStock();
+        });
+    }
+}
+
+function getActiveWarehouse() {
+    const picker = document.getElementById('warehousePicker');
+    return picker ? picker.value : (localStorage.getItem('sh_warehouse_id') || 'MAIN');
+}
+
+async function loadWarehouseList() {
+    const result = await window.WarehouseApi.getWarehouseList();
+    const picker = document.getElementById('warehousePicker');
+    if (!picker) return;
+
+    if (result.success && Array.isArray(result.data) && result.data.length > 0) {
+        WarehouseState.warehouses = result.data;
+        picker.innerHTML = '';
+        result.data.forEach(wh => {
+            const opt = document.createElement('option');
+            opt.value = wh.warehouse_id || wh.id || wh;
+            opt.textContent = typeof wh === 'string' ? wh : (wh.name || wh.warehouse_id || wh.id);
+            picker.appendChild(opt);
+        });
+    }
+
+    const saved = localStorage.getItem('sh_warehouse_id');
+    if (saved) {
+        const exists = Array.from(picker.options).some(o => o.value === saved);
+        if (exists) picker.value = saved;
+    }
+    localStorage.setItem('sh_warehouse_id', picker.value);
+}
+
+function startAutoRefresh() {
+    if (WarehouseState.refreshTimer) clearInterval(WarehouseState.refreshTimer);
+    WarehouseState.refreshTimer = setInterval(() => loadStock(), REFRESH_INTERVAL_MS);
+}
+
+function updateTimestamp() {
+    const el = document.getElementById('lastUpdated');
+    if (el) el.textContent = 'Od┼Ťwie┼╝ono: ' + new Date().toLocaleTimeString('pl-PL');
 }
 
 /**
  * 1. POBIERANIE DANYCH (API CALL)
  */
 async function loadStock() {
-    const result = await window.ApiClient.get(API_BASE, { action: 'GET_STOCK' });
+    const warehouseId = getActiveWarehouse();
+    const result = await window.WarehouseApi.stockList(warehouseId);
 
     if (result.success) {
         WarehouseState.stock = result.data;
         calculateDashboard(WarehouseState.stock);
         renderMatrix(WarehouseState.stock);
+        updateTimestamp();
     } else {
-        console.warn('Backend niedostępny, ładuję tryb symulacji (Mock Data)...');
-        WarehouseState.stock = [
-            { sku: 'MKA_01',  name: 'M─ůka Typ 00',           base_unit: 'kg', quantity: 25.5, unit_net_cost: 3.20,  current_avco_price: 3.45  },
-            { sku: 'SER_MOZ', name: 'Ser Mozzarella',         base_unit: 'kg', quantity: 0,    unit_net_cost: 15.00, current_avco_price: 15.00 },
-            { sku: 'SOS_POM', name: 'Sos Pomidorowy Mutti',   base_unit: 'l',  quantity: 12,   unit_net_cost: 8.50,  current_avco_price: 8.90  }
-        ];
-        calculateDashboard(WarehouseState.stock);
-        renderMatrix(WarehouseState.stock);
+        WarehouseState.stock = [];
+        renderMatrix([]);
+        showConnectionError(result.message);
+    }
+
+    loadDraftCount();
+}
+
+async function loadDraftCount() {
+    const res = await window.WarehouseApi.getDocumentsList({ status: 'draft' });
+    const el = document.getElementById('dashDrafts');
+    if (!el) return;
+    if (res.success && res.data) {
+        el.textContent = res.data.total ?? (res.data.documents || []).length;
+    } else {
+        el.textContent = 'ÔÇö';
     }
 }
 
+function showConnectionError(msg) {
+    const container = document.getElementById('matrixBody');
+    container.innerHTML = `
+        <div class="flex flex-col items-center justify-center h-full text-center p-10">
+            <svg class="w-12 h-12 text-red-500/60 mb-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="1.5"
+                      d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-2.5L13.732 4.5c-.77-.833-2.694-.833-3.464 0L3.34 16.5c-.77.833.192 2.5 1.732 2.5z"/>
+            </svg>
+            <p class="text-red-400 font-semibold mb-1">Brak po┼é─ůczenia z serwerem</p>
+            <p class="text-gray-600 text-sm max-w-md">${_esc(msg || 'Nie uda┼éo si─Ö pobra─ç danych magazynowych. Sprawd┼║ po┼é─ůczenie i spr├│buj ponownie.')}</p>
+            <button onclick="loadStock()"
+                    class="mt-4 px-4 py-2 text-sm bg-white/5 border border-white/10 rounded-lg text-gray-400
+                           hover:bg-white/10 hover:text-white transition-all">
+                Spr├│buj ponownie
+            </button>
+        </div>
+    `;
+    document.getElementById('dashAlert86').textContent = 'ÔÇö';
+    document.getElementById('dashTotalValue').textContent = 'ÔÇö';
+}
+
 /**
  * 2. KALKULACJE TOP BARU (DASHBOARD)
  */
@@ -64,21 +142,15 @@ function calculateDashboard(data) {
     data.forEach(item => {
         const qty = parseFloat(item.quantity) || 0;
         const avco = parseFloat(item.current_avco_price) || 0;
-        
-        // Alert 86 (Sold out / Brak)
         if (qty <= 0) alert86Count++;
-        
-        // Matematyka Zamro┼╝onej Got├│wki
         if (qty > 0) totalFrozenValue += (qty * avco);
     });
 
-    document.getElementById('dashAlert86').innerText = alert86Count;
+    const el86 = document.getElementById('dashAlert86');
+    el86.innerText = alert86Count;
+    el86.classList.toggle('text-red-400', alert86Count > 0);
+
     document.getElementById('dashTotalValue').innerText = formatCurrency.format(totalFrozenValue);
-    
-    // Dodajemy ma┼éy efekt wizualny je┼Ťli braki rosn─ů
-    if(alert86Count > 0) {
-        document.getElementById('dashAlert86').classList.add('text-red-400');
-    }
 }
 
 /**
@@ -88,8 +160,8 @@ function renderMatrix(data) {
     const container = document.getElementById('matrixBody');
     container.innerHTML = '';
 
-    if(data.length === 0) {
-        container.innerHTML = `<div class="p-6 text-center text-gray-500">Brak surowc├│w w bazie.</div>`;
+    if (data.length === 0) {
+        container.innerHTML = `<div class="p-6 text-center text-gray-500">Brak surowc├│w w bazie dla tego magazynu.</div>`;
         return;
     }
 
@@ -100,10 +172,8 @@ function renderMatrix(data) {
         const baseUnit   = _esc(item.base_unit || '');
         const stockValue = qty * avco;
 
-        // Alert 86: qty <= 0 Ôćĺ czerwony, pozytywny Ôćĺ szary/bia┼éy
         const qtyClass = qty <= 0 ? 'text-red-500 font-bold' : 'text-gray-200';
 
-        // Pasek stanu półki (wizualizacja DOH uproszczona; 50 j. = 100%)
         let statusPercent = Math.min((qty / 50) * 100, 100);
         let barColor      = 'bg-emerald-500';
 
@@ -111,7 +181,6 @@ function renderMatrix(data) {
         else if (qty <= 5)  { barColor = 'bg-red-500';    statusPercent = Math.max(statusPercent, 5); }
         else if (qty <= 15) { barColor = 'bg-yellow-400'; }
 
-        // Wyszarzenie wierszy z zerowym stanem (widoczne, ale stonowane)
         const rowDim = qty <= 0 ? 'opacity-50 hover:opacity-80' : '';
 
         const row = document.createElement('div');
@@ -160,31 +229,27 @@ function renderMatrix(data) {
  * 4. OBSŁUGA SMART ACTION PANEL (STREFA C)
  */
 window.triggerActionPanel = function(sku) {
-    // Aktualizacja Stanu
     WarehouseState.activeActionSku = sku;
     const item = WarehouseState.stock.find(i => i.sku === sku);
 
-    // Oczyszczanie starych pod┼Ťwietle┼ä
     document.querySelectorAll('#matrixBody > div').forEach(el => {
         el.classList.remove('row-active');
         el.style.borderLeft = "none";
     });
 
-    // Pod┼Ťwietlenie aktywnego wiersza
     const activeRow = document.getElementById(`row-${sku}`);
-    if(activeRow) {
+    if (activeRow) {
         activeRow.classList.add('row-active');
         activeRow.style.borderLeft = "4px solid #8b5cf6";
     }
 
-    // Wstrzykiwanie widoku do Prawego Panelu
     const panel = document.getElementById('actionPanelContent');
-    
+
     panel.innerHTML = `
         <div class="animate-fade-in-up">
             <div class="bg-black/30 rounded-lg p-4 mb-6 border border-white/5">
-                <div class="text-xs text-gray-500 font-mono mb-1">${item.sku}</div>
-                <h3 class="text-xl font-bold text-white">${item.name}</h3>
+                <div class="text-xs text-gray-500 font-mono mb-1">${_esc(item.sku)}</div>
+                <h3 class="text-xl font-bold text-white">${_esc(item.name)}</h3>
                 <div class="mt-2 flex items-center justify-between">
                     <span class="text-sm text-gray-400">Stan obecny:</span>
                     <span class="text-lg font-bold ${item.quantity <= 0 ? 'text-red-500' : 'text-gray-200'}">${item.quantity}</span>
@@ -192,7 +257,7 @@ window.triggerActionPanel = function(sku) {
             </div>
 
             <h4 class="text-xs font-semibold text-gray-500 uppercase tracking-wider mb-3">Wybierz Protokół</h4>
-            
+
             <div class="grid grid-cols-1 gap-3">
                 <button onclick="openPZModal('${item.sku}')"
                         class="w-full bg-blue-600/20 hover:bg-blue-600/40 text-blue-400 border border-blue-500/30 rounded-lg p-4 flex items-center justify-between transition-all group active:scale-95">
@@ -204,8 +269,8 @@ window.triggerActionPanel = function(sku) {
                     </div>
                 </button>
 
-                <button onclick="openRWModal('${item.sku}')" 
-                        class="w-full bg-red-600/20 hover:bg-red-600/40 text-red-400 border border-red-500/30 rounded-lg p-4 flex items-center justify-between transition-all group">
+                <button onclick="openRWModal('${item.sku}')"
+                        class="w-full bg-red-600/20 hover:bg-red-600/40 text-red-400 border border-red-500/30 rounded-lg p-4 flex items-center justify-between transition-all group active:scale-95">
                     <div class="flex items-center gap-3">
                         <div class="bg-red-500/20 p-2 rounded-md group-hover:bg-red-500 transition-colors">
                             <svg class="w-5 h-5 text-red-400 group-hover:text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M20 12H4"></path></svg>
@@ -213,17 +278,21 @@ window.triggerActionPanel = function(sku) {
                         <span class="font-semibold tracking-wide">- Strata / Rozch├│d (RW)</span>
                     </div>
                 </button>
-                
-                <button onclick="alert('TODO: Inwentaryzacja Ślepa')" 
-                        class="w-full bg-gray-600/20 hover:bg-gray-600/40 text-gray-300 border border-gray-500/30 rounded-lg p-4 flex items-center justify-between transition-all group mt-4">
-                    <span class="font-semibold tracking-wide">Inwentaryzacja (INW)</span>
+
+                <button onclick="window.location.href='manager_in.html'"
+                        class="w-full bg-amber-600/20 hover:bg-amber-600/40 text-amber-300 border border-amber-500/30 rounded-lg p-4 flex items-center justify-between transition-all group active:scale-95 mt-4">
+                    <div class="flex items-center gap-3">
+                        <div class="bg-amber-500/20 p-2 rounded-md group-hover:bg-amber-500 transition-colors">
+                            <svg class="w-5 h-5 text-amber-300 group-hover:text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"/></svg>
+                        </div>
+                        <span class="font-semibold tracking-wide">Inwentaryzacja (INW)</span>
+                    </div>
                 </button>
             </div>
         </div>
     `;
 };
 
-// Pomocnicza animacja z Tailwind (dodana w locie via JS styl)
 if (!document.getElementById('animStyles')) {
     const style = document.createElement('style');
     style.id = 'animStyles';
@@ -240,9 +309,6 @@ if (!document.getElementById('animStyles')) {
 // 5. MODAL PZ ÔÇö SILNIK (Przyj─Öcie Zewn─Ötrzne)
 // =============================================================================
 
-/**
- * Otwiera modal PZ. Opcjonalnie pre-selektuje konkretne SKU w pierwszym wierszu.
- */
 window.openPZModal = function(skuPreselect = null) {
     const modal = document.getElementById('pzModal');
     document.getElementById('pzNotes').value = '';
@@ -266,14 +332,9 @@ window.closePZModal = function() {
     document.body.style.overflow = '';
 };
 
-/**
- * Dodaje nowy wiersz pozycji dostawy do listy w modalu.
- * @param {string} skuPreselect - opcjonalne SKU do pre-selekcji w dropdownie
- */
 window.addPZRow = function(skuPreselect = '') {
     const container = document.getElementById('pzItemsContainer');
 
-    // Budujemy opcje selecta z aktualnego stanu magazynu
     const options = WarehouseState.stock
         .map(s => `<option value="${_esc(s.sku)}" ${s.sku === skuPreselect ? 'selected' : ''}>
                        ${_esc(s.name)} (${_esc(s.sku)})
@@ -330,18 +391,12 @@ window.addPZRow = function(skuPreselect = '') {
     updatePZSummary();
 };
 
-/**
- * Usuwa wiersz pozycji klikaj─ůc ikon─Ö kosza.
- */
 window.removePZRow = function(btn) {
     btn.closest('.pz-row').remove();
     _pzSyncEmptyState();
     updatePZSummary();
 };
 
-/**
- * Przelicza i wy┼Ťwietla sum─Ö warto┼Ťci dostawy w stopce modalu.
- */
 window.updatePZSummary = function() {
     let total = 0;
     document.querySelectorAll('#pzItemsContainer .pz-row').forEach(row => {
@@ -352,9 +407,6 @@ window.updatePZSummary = function() {
     document.getElementById('pzTotalValue').textContent = formatCurrency.format(total);
 };
 
-/**
- * Wysyła formularz PZ do backendu i obsługuje odpowiedź.
- */
 window.submitPZ = async function() {
     const notes = document.getElementById('pzNotes').value.trim();
     const rows  = document.querySelectorAll('#pzItemsContainer .pz-row');
@@ -383,7 +435,6 @@ window.submitPZ = async function() {
 
     if (hasError) return;
 
-    // UI: stan ładowania przycisku
     const btn = document.getElementById('pzSubmitBtn');
     btn.disabled = true;
     btn.innerHTML = `
@@ -395,7 +446,16 @@ window.submitPZ = async function() {
     `;
 
     try {
-        const result = await window.ApiClient.post(API_BASE, { action: 'PROCESS_PZ', notes, items });
+        const result = await window.WarehouseApi.postReceipt({
+            warehouse_id:       getActiveWarehouse(),
+            supplier_name:      notes || 'PZ ÔÇö Control Tower',
+            supplier_invoice:   '',
+            lines: items.map((row) => ({
+                resolved_sku:   row.sku,
+                quantity:       row.qty,
+                unit_net_cost:  row.unit_net_cost,
+            })),
+        });
 
         if (result.success) {
             closePZModal();
@@ -417,13 +477,11 @@ window.submitPZ = async function() {
     }
 };
 
-/** Pokazuje/ukrywa placeholder "brak pozycji" zale┼╝nie od zawarto┼Ťci listy. */
 function _pzSyncEmptyState() {
     const hasRows = document.querySelectorAll('#pzItemsContainer .pz-row').length > 0;
     document.getElementById('pzEmptyState').classList.toggle('hidden', hasRows);
 }
 
-/** Mini-helper: escapuje tekst przed wstawieniem do innerHTML. */
 function _esc(str) {
     const d = document.createElement('div');
     d.appendChild(document.createTextNode(String(str)));
@@ -467,7 +525,6 @@ function showToast(type, message) {
     toast.dataset.toast = '1';
     container.appendChild(toast);
 
-    // Auto-dismiss po 5s z p┼éynnym wyj┼Ťciem
     setTimeout(() => {
         toast.style.transition = 'opacity 0.35s ease, transform 0.35s ease';
         toast.style.opacity    = '0';
@@ -480,21 +537,15 @@ function showToast(type, message) {
 // 7. SILNIK MODALU RW ÔÇö Rozch├│d Wewn─Ötrzny / Strata
 // =============================================================================
 
-/**
- * Otwiera modal RW. Zaludnia select surowcami z WarehouseState.stock.
- * Opcjonalnie pre-selektuje przekazane SKU (wywołanie z Action Panel).
- */
 window.openRWModal = function(skuPreselect = null) {
     const modal  = document.getElementById('rwModal');
     const select = document.getElementById('rw-item-select');
     const qty    = document.getElementById('rw-qty');
     const reason = document.getElementById('rw-reason');
 
-    // Reset formularza
     qty.value    = '';
     reason.value = reason.options[0]?.value ?? '';
 
-    // Zaludnienie selecta aktualnymi surowcami
     select.innerHTML = '<option value="">ÔÇö wybierz surowiec ÔÇö</option>';
     WarehouseState.stock.forEach(item => {
         const opt      = document.createElement('option');
@@ -559,9 +610,14 @@ window.saveNewItem = async function() {
         return;
     }
 
-    // Auto-generowanie SKU z nazwy je┼Ťli pole pozosta┼éo puste
     if (!sku) {
-        sku = SliceValidator.sanitizeKey(name);
+        sku = (typeof SliceValidator !== 'undefined' && SliceValidator.sanitizeKey)
+            ? SliceValidator.sanitizeKey(name)
+            : String(name || '')
+                  .replace(/\s+/g, '_')
+                  .replace(/[^A-Za-z0-9_]/g, '')
+                  .toUpperCase()
+                  .slice(0, 64);
     }
 
     const btn = document.getElementById('btn-save-new-item');
@@ -575,13 +631,10 @@ window.saveNewItem = async function() {
     `;
 
     try {
-        const result = await window.ApiClient.post(API_BASE, {
-            action:             'ADD_ITEM',
+        const result = await window.WarehouseApi.postAddItem({
             name,
-            base_unit:          unit,
-            vat_rate_purchase:  parseInt(vat, 10),
+            base_unit: unit,
             sku,
-            ksef_code:          ksefCode,
         });
 
         if (result.success) {
@@ -604,9 +657,6 @@ window.saveNewItem = async function() {
     }
 };
 
-/**
- * Waliduje dane, wysyła POST action=PROCESS_RW, obsługuje odpowiedź.
- */
 window.submitRW = async function() {
     const sku    = document.getElementById('rw-item-select').value;
     const qty    = parseFloat(document.getElementById('rw-qty').value);
@@ -626,7 +676,12 @@ window.submitRW = async function() {
     `;
 
     try {
-        const result = await window.ApiClient.post(API_BASE, { action: 'PROCESS_RW', sku, qty, reason });
+        const result = await window.WarehouseApi.postInternalRw({
+            warehouse_id: getActiveWarehouse(),
+            sku,
+            qty,
+            reason,
+        });
 
         if (result.success) {
             closeRWModal();
@@ -647,4 +702,4 @@ window.submitRW = async function() {
             Zaksi─Öguj Rozch├│d
         `;
     }
-};
\ No newline at end of file
+};
diff --git a/modules/warehouse/js/warehouse_in.js b/modules/warehouse/js/warehouse_in.js
index 9081bc1..836b6e0 100644
--- a/modules/warehouse/js/warehouse_in.js
+++ b/modules/warehouse/js/warehouse_in.js
@@ -1,167 +1,222 @@
-let isBlindMode = true;
-let inventoryData = [];
-
-document.addEventListener('DOMContentLoaded', function() {
-    if(typeof SliceValidator === 'undefined') {
-        console.error("[CRITICAL] Brak po┼é─ůczenia z core_validator.js!");
-    }
-    init();
-});
-
-// ­čžá Inicjalizacja: ┼éadujemy magazyny do selecta
-window.init = async function() {
-    try {
-        const res = await fetch('../../../api/api_inventory.php', {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({ action: 'get_pz_init' })
-        }).then(r => r.json());
-
-        if(res.status === 'success') {
-            const wh = document.getElementById('warehouse_id');
-            if(wh) {
-                wh.innerHTML = '<option value="">-- Wybierz Magazyn --</option>' + 
-                    res.payload.warehouses.map(w => `<option value="${w.id}">${w.name}</option>`).join('');
-            }
+/**
+ * IN ÔÇö inwentaryzacja fizyczna (V2 Ôćĺ InwEngine przez inventory.php).
+ */
+(function () {
+    'use strict';
+
+    let isBlindMode = true;
+    let inventoryData = [];
+
+    document.addEventListener('DOMContentLoaded', () => {
+        initWarehouseSelect();
+    });
+
+    window.toggleOption = function (el) {
+        const icon = el.querySelector('i.fa-toggle-on, i.fa-toggle-off');
+        if (!icon) return;
+        const isOn = icon.classList.contains('fa-toggle-on');
+        if (isOn) {
+            icon.classList.replace('fa-toggle-on', 'fa-toggle-off');
+            icon.classList.replace('text-amber-500', 'text-slate-600');
+        } else {
+            icon.classList.replace('fa-toggle-off', 'fa-toggle-on');
+            icon.classList.replace('text-slate-600', 'text-amber-500');
         }
-    } catch(e) {
-        console.error("B┼é─ůd ┼éadowania magazyn├│w:", e);
-    }
-}
-
-// ­čžá ┼üadowanie listy produkt├│w
-window.loadInventoryData = async function() {
-    const wid = document.getElementById('warehouse_id').value;
-    if(!wid) return;
-
-    document.getElementById('loading-overlay').classList.remove('hidden');
-    
-    try {
-        const res = await fetch('../../../api/api_inventory.php', {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({ action: 'get_stock_matrix' })
-        }).then(r => r.json());
-
-        document.getElementById('loading-overlay').classList.add('hidden');
-
-        if(res.status === 'success') {
-            inventoryData = res.payload.products.map(p => {
-                const stock = res.payload.stocks.find(s => s.product_id === p.id && s.warehouse_id == wid);
-                return {
-                    ...p,
-                    sys_qty: stock ? parseFloat(stock.quantity) : 0,
-                    actual_qty: null
-                };
+    };
+
+    async function initWarehouseSelect() {
+        const wh = document.getElementById('warehouse_id');
+        if (!wh) return;
+
+        const res = await window.WarehouseApi.getWarehouseList();
+        if (res.success && Array.isArray(res.data) && res.data.length > 0) {
+            wh.innerHTML = '<option value="">ÔÇö wybierz magazyn ÔÇö</option>';
+            res.data.forEach(item => {
+                const id = typeof item === 'string' ? item : (item.warehouse_id || item.id);
+                const label = typeof item === 'string' ? item : (item.name || item.warehouse_id || item.id);
+                const opt = document.createElement('option');
+                opt.value = id;
+                opt.textContent = label;
+                wh.appendChild(opt);
             });
-            renderInventory();
+        } else {
+            const wid = window.WarehouseApi.DEFAULT_WAREHOUSE_ID;
+            wh.innerHTML =
+                `<option value="">ÔÇö wybierz magazyn ÔÇö</option>` +
+                `<option value="${wid}">Magazyn główny (${wid})</option>`;
+        }
+
+        const saved = localStorage.getItem('sh_warehouse_id');
+        if (saved) {
+            const exists = Array.from(wh.options).some(o => o.value === saved);
+            if (exists) wh.value = saved;
         }
-    } catch(e) {
-        document.getElementById('loading-overlay').classList.add('hidden');
-        console.error("B┼é─ůd ┼éadowania matrycy:", e);
+        if (wh.value) window.loadInventoryData();
     }
-}
 
-window.renderInventory = function() {
-    const tbody = document.getElementById('inventory-list');
-    document.getElementById('items-count').innerText = `Wczytano: ${inventoryData.length} pozycji`;
-    
-    tbody.innerHTML = inventoryData.map((item, idx) => `
+    window.loadInventoryData = async function () {
+        const wid = document.getElementById('warehouse_id')?.value;
+        if (!wid) return;
+
+        const overlay = document.getElementById('loading-overlay');
+        if (overlay) overlay.classList.remove('hidden');
+
+        const res = await window.WarehouseApi.stockList(wid);
+
+        if (overlay) overlay.classList.add('hidden');
+
+        if (!res.success || !Array.isArray(res.data)) {
+            console.error('[IN] stock_list:', res.message);
+            alert(res.message || 'Nie udało się pobrać stanów.');
+            return;
+        }
+
+        inventoryData = res.data.map((row) => ({
+            sku:       row.sku,
+            name:      row.name,
+            base_unit: row.base_unit || '',
+            sys_qty:   parseFloat(row.quantity) || 0,
+            actual_qty: null,
+        }));
+        window.renderInventory();
+    };
+
+    window.renderInventory = function () {
+        const tbody = document.getElementById('inventory-list');
+        if (!tbody) return;
+
+        document.getElementById('items-count').innerText =
+            `Wczytano: ${inventoryData.length} pozycji`;
+
+        if (inventoryData.length === 0) {
+            tbody.innerHTML =
+                '<tr><td colspan="5" class="py-20 text-center text-slate-600 font-bold uppercase text-xs">Brak pozycji w słowniku sys_items.</td></tr>';
+            return;
+        }
+
+        tbody.innerHTML = inventoryData
+            .map(
+                (item, idx) => `
         <tr class="hover:bg-white/5 transition group border-l-2 border-transparent hover:border-amber-500">
             <td class="py-4 pr-4">
-                <div class="font-bold text-slate-200 text-xs uppercase tracking-wide">${item.name}</div>
-                <div class="text-[9px] text-slate-600 font-black tracking-widest uppercase mt-1">ID: ${item.id}</div>
+                <div class="font-bold text-slate-200 text-xs uppercase tracking-wide">${escapeHtml(item.name)}</div>
+                <div class="text-[9px] text-slate-600 font-black tracking-widest uppercase mt-1">SKU: ${escapeHtml(item.sku)}</div>
             </td>
             <td class="py-4 text-center sys-qty font-mono text-slate-500 text-sm italic">
                 ${item.sys_qty.toFixed(3)}
             </td>
             <td class="py-4 px-4 text-center">
-                <input type="number" step="0.001" placeholder="0.000" 
+                <input type="number" step="0.001" min="0" placeholder="0.000"
                     class="w-32 bg-black border border-white/10 rounded-xl p-2 text-center text-amber-500 font-black outline-none focus:border-amber-500 transition shadow-inner"
-                    oninput="updateActualQty(${idx}, this.value)">
+                    oninput="window.updateActualQty(${idx}, this.value)">
             </td>
             <td class="py-4 text-center text-[10px] font-black text-slate-600 uppercase tracking-tighter bg-black/20 rounded-lg">
-                ${item.unit}
-            </td>
-            <td class="py-4 text-right diff-col font-mono text-xs" id="diff-${idx}">
-                --
+                ${escapeHtml(item.base_unit)}
             </td>
-        </tr>
-    `).join('');
-
-    applyBlindModeStyles();
-}
-
-window.updateActualQty = function(idx, val) {
-    const qty = parseFloat(val);
-    inventoryData[idx].actual_qty = isNaN(qty) ? null : qty;
-    
-    if(!isBlindMode && !isNaN(qty)) {
-        const diff = qty - inventoryData[idx].sys_qty;
-        const cell = document.getElementById(`diff-${idx}`);
-        cell.innerText = (diff > 0 ? '+' : '') + diff.toFixed(3);
-        cell.className = `py-4 text-right diff-col font-mono text-xs ${diff === 0 ? 'text-slate-500' : (diff > 0 ? 'text-green-500' : 'text-red-500')}`;
+            <td class="py-4 text-right diff-col font-mono text-xs" id="diff-${idx}">--</td>
+        </tr>`
+            )
+            .join('');
+
+        window.applyBlindModeStyles();
+    };
+
+    function escapeHtml(str) {
+        const d = document.createElement('div');
+        d.textContent = str == null ? '' : String(str);
+        return d.innerHTML;
     }
-}
 
-window.toggleBlindMode = function() {
-    isBlindMode = !isBlindMode;
-    const icon = document.getElementById('icon-blind');
-    if(icon) {
-        icon.className = isBlindMode ? 'fa-solid fa-toggle-on text-amber-500 text-xl' : 'fa-solid fa-toggle-off text-slate-600 text-xl';
-    }
-    applyBlindModeStyles();
-}
-
-window.applyBlindModeStyles = function() {
-    const table = document.getElementById('in-table');
-    if(table) {
-        if(isBlindMode) table.classList.add('blind-mode-active');
-        else table.classList.remove('blind-mode-active');
-    }
-}
+    window.updateActualQty = function (idx, val) {
+        const qty = parseFloat(val);
+        inventoryData[idx].actual_qty = Number.isFinite(qty) ? qty : null;
+
+        if (!isBlindMode && Number.isFinite(qty)) {
+            const diff = qty - inventoryData[idx].sys_qty;
+            const cell = document.getElementById(`diff-${idx}`);
+            if (cell) {
+                cell.innerText = (diff > 0 ? '+' : '') + diff.toFixed(3);
+                cell.className =
+                    'py-4 text-right diff-col font-mono text-xs ' +
+                    (diff === 0 ? 'text-slate-500' : diff > 0 ? 'text-green-500' : 'text-red-500');
+            }
+        }
+    };
+
+    window.toggleBlindMode = function () {
+        isBlindMode = !isBlindMode;
+        const icon = document.getElementById('icon-blind');
+        if (icon) {
+            icon.className = isBlindMode
+                ? 'fa-solid fa-toggle-on text-amber-500 text-xl transition-colors'
+                : 'fa-solid fa-toggle-off text-slate-600 text-xl transition-colors';
+        }
+        window.applyBlindModeStyles();
+        inventoryData.forEach((item, idx) => {
+            const cell = document.getElementById(`diff-${idx}`);
+            if (!cell) return;
+            if (!isBlindMode && item.actual_qty !== null && Number.isFinite(item.actual_qty)) {
+                const diff = item.actual_qty - item.sys_qty;
+                cell.innerText = (diff > 0 ? '+' : '') + diff.toFixed(3);
+                cell.className =
+                    'py-4 text-right diff-col font-mono text-xs ' +
+                    (diff === 0 ? 'text-slate-500' : diff > 0 ? 'text-green-500' : 'text-red-500');
+            } else {
+                cell.innerText = '--';
+                cell.className = 'py-4 text-right diff-col font-mono text-xs';
+            }
+        });
+    };
+
+    window.applyBlindModeStyles = function () {
+        const table = document.getElementById('in-table');
+        if (!table) return;
+        table.classList.toggle('blind-mode-active', isBlindMode);
+    };
+
+    window.saveInventory = async function () {
+        const wid = document.getElementById('warehouse_id')?.value;
+        if (!wid) {
+            alert('Wybierz magazyn.');
+            return;
+        }
 
-window.saveInventory = async function() {
-    const docNum = document.getElementById('doc_number').value;
-    const wid = document.getElementById('warehouse_id').value;
+        const lines = inventoryData
+            .filter((i) => i.actual_qty !== null && Number.isFinite(i.actual_qty))
+            .map((i) => ({ sku: i.sku, counted_qty: i.actual_qty }));
 
-    if(!docNum || !wid) return alert("Podaj numer dokumentu i wybierz magazyn!");
-    
-    const itemsToSave = inventoryData.filter(i => i.actual_qty !== null);
-    if(itemsToSave.length === 0) return alert("Nie wpisa┼ée┼Ť ┼╝adnych ilo┼Ťci!");
+        if (lines.length === 0) {
+            alert('Wpisz co najmniej jedn─ů ilo┼Ť─ç policzon─ů.');
+            return;
+        }
 
-    if(!confirm("KRYTYCZNE: Czy na pewno chcesz nadpisa─ç stany w bazie danych?")) return;
+        if (
+            !confirm(
+                'Zatwierdzi─ç inwentaryzacj─Ö? Silnik INW (V2) utworzy dokumenty koryguj─ůce zgodnie z tolerancjami.'
+            )
+        ) {
+            return;
+        }
 
-    document.getElementById('loading-overlay').classList.remove('hidden');
+        const overlay = document.getElementById('loading-overlay');
+        if (overlay) overlay.classList.remove('hidden');
 
-    try {
-        let finalDocNum = docNum;
-        if(typeof SliceValidator !== 'undefined') {
-            finalDocNum = SliceValidator.sanitizeKey(docNum).toUpperCase();
-        }
+        const res = await window.WarehouseApi.postInventory({
+            warehouse_id: wid,
+            lines,
+            tolerances: {
+                auto_approve_pct: 2.0,
+                critical_pct:     10.0,
+            },
+        });
+
+        if (overlay) overlay.classList.add('hidden');
 
-        const res = await fetch('../../../api/api_inventory.php', {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({
-                action: 'save_inventory',
-                doc_number: finalDocNum,
-                warehouse_id: wid,
-                items: itemsToSave.map(i => ({ product_id: i.id, quantity: i.actual_qty }))
-            })
-        }).then(r => r.json());
-
-        document.getElementById('loading-overlay').classList.add('hidden');
-
-        if(res.status === 'success') {
-            alert("Sukces! Stany zostały wyrównane. Wygenerowano raport różnic.");
+        if (res.success) {
+            alert('Inwentaryzacja zaksi─Ögowana.');
             window.location.reload();
         } else {
-            alert("B┼é─ůd: " + res.error);
+            alert(res.message || 'B┼é─ůd zapisu inwentaryzacji.');
         }
-    } catch(e) {
-        document.getElementById('loading-overlay').classList.add('hidden');
-        console.error("B┼é─ůd zapisu inwentaryzacji:", e);
-        alert("Wyst─ůpi┼é b┼é─ůd komunikacji sieciowej.");
-    }
-}
\ No newline at end of file
+    };
+})();
diff --git a/modules/warehouse/js/warehouse_pz.js b/modules/warehouse/js/warehouse_pz.js
index 51c9b9f..a7f4b10 100644
--- a/modules/warehouse/js/warehouse_pz.js
+++ b/modules/warehouse/js/warehouse_pz.js
@@ -1,168 +1,184 @@
-let pzItems = [];
-let availableProducts = [];
+/**
+ * PZ ÔÇö przyj─Öcie zewn─Ötrzne (V2 Ôćĺ PzEngine przez receipt.php).
+ */
+(function () {
+    'use strict';
 
-document.addEventListener('DOMContentLoaded', function() {
-    if(typeof SliceValidator === 'undefined') {
-        console.error("[CRITICAL] Brak po┼é─ůczenia z core_validator.js!");
-    }
-    initPZ();
-});
-
-// ­čžá Inicjalizacja: Pobieranie magazyn├│w i produkt├│w
-window.initPZ = async function() {
-    try {
-        const res = await fetch('../../../api/api_inventory.php', {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({ action: 'get_pz_init' }) // Wykorzystujemy stary endpoint init z IN
-        }).then(r => r.json());
-
-        if(res.status === 'success') {
-            // Ładowanie Magazynów
-            const whSelect = document.getElementById('pz-warehouse');
-            if(whSelect) {
-                whSelect.innerHTML = '<option value="">-- Wybierz Magazyn --</option>' + 
-                    res.payload.warehouses.map(w => `<option value="${w.id}">${w.name}</option>`).join('');
-            }
-            
-            // Zapisanie bazy produkt├│w do auto-podpowiedzi (je┼Ťli by┼Ťmy ich potrzebowali)
-            availableProducts = res.payload.products;
-            
-            // Dodajemy pierwszy, pusty wiersz na start
-            addRow();
+    let stockRows = [];
+
+    document.addEventListener('DOMContentLoaded', () => {
+        initPz();
+    });
+
+    window.initPz = async function () {
+        await loadWarehousePicker('pz-warehouse');
+
+        const wid = document.getElementById('pz-warehouse')?.value || window.WarehouseApi.DEFAULT_WAREHOUSE_ID;
+        const res = await window.WarehouseApi.stockList(wid);
+        if (!res.success || !Array.isArray(res.data)) {
+            console.error('[PZ] stock_list', res.message);
+            alert(res.message || 'Brak danych magazynowych.');
+            return;
+        }
+        stockRows = res.data;
+
+        const whEl = document.getElementById('pz-warehouse');
+        if (whEl) {
+            whEl.addEventListener('change', async () => {
+                const r = await window.WarehouseApi.stockList(whEl.value);
+                if (r.success && Array.isArray(r.data)) stockRows = r.data;
+            });
+        }
+
+        window.addRow();
+    };
+
+    async function loadWarehousePicker(selectId) {
+        const sel = document.getElementById(selectId);
+        if (!sel) return;
+        const res = await window.WarehouseApi.getWarehouseList();
+        if (res.success && Array.isArray(res.data) && res.data.length > 0) {
+            sel.innerHTML = '<option value="">ÔÇö magazyn ÔÇö</option>';
+            res.data.forEach(wh => {
+                const id = typeof wh === 'string' ? wh : (wh.warehouse_id || wh.id);
+                const label = typeof wh === 'string' ? wh : (wh.name || wh.warehouse_id || wh.id);
+                sel.innerHTML += `<option value="${escapeAttr(id)}">${escapeHtml(label)}</option>`;
+            });
+        } else {
+            const wid = window.WarehouseApi.DEFAULT_WAREHOUSE_ID;
+            sel.innerHTML = `<option value="">ÔÇö magazyn ÔÇö</option><option value="${wid}">Magazyn g┼é├│wny (${wid})</option>`;
+        }
+        const saved = localStorage.getItem('sh_warehouse_id');
+        if (saved) {
+            const exists = Array.from(sel.options).some(o => o.value === saved);
+            if (exists) sel.value = saved;
         }
-    } catch(e) {
-        console.error("B┼é─ůd inicjalizacji PZ:", e);
+        if (!sel.value) sel.selectedIndex = 1;
+    }
+
+    function skuOptionsHtml() {
+        return stockRows
+            .map(
+                (r) =>
+                    `<option value="${escapeAttr(r.sku)}">${escapeHtml(r.name)} [${escapeHtml(r.sku)}] ÔÇö ${escapeHtml(r.base_unit || '')}</option>`
+            )
+            .join('');
+    }
+
+    function escapeHtml(s) {
+        const d = document.createElement('div');
+        d.textContent = s == null ? '' : String(s);
+        return d.innerHTML;
+    }
+
+    function escapeAttr(s) {
+        return String(s == null ? '' : s)
+            .replace(/&/g, '&amp;')
+            .replace(/"/g, '&quot;')
+            .replace(/</g, '&lt;');
     }
-}
-
-// Generowanie wiersza
-window.addRow = function() {
-    const tbody = document.getElementById('pz-items');
-    const rowId = Date.now();
-    
-    // Budujemy opcje dla selecta z produktami (M├│zg - Produkty Wewn─Ötrzne)
-    const productOptions = availableProducts.map(p => 
-        `<option value="${p.id}" data-unit="${p.unit}">${p.name} [${p.unit}]</option>`
-    ).join('');
-
-    const tr = document.createElement('tr');
-    tr.className = "group border-l-2 border-transparent hover:border-green-500 transition-colors duration-300";
-    tr.id = `row-${rowId}`;
-    
-    tr.innerHTML = `
+
+    window.addRow = function () {
+        const tbody = document.getElementById('pz-items');
+        if (!tbody) return;
+        const rowId = Date.now();
+
+        const tr = document.createElement('tr');
+        tr.className =
+            'group border-l-2 border-transparent hover:border-green-500 transition-colors duration-300';
+        tr.id = `row-${rowId}`;
+        tr.innerHTML = `
         <td class="py-4 pr-4">
-            <input type="text" placeholder="Wpisz nazw─Ö z faktury..." class="w-full bg-black/50 border border-white/5 rounded-lg p-3 text-xs text-slate-300 outline-none focus:border-green-500 transition invoice-name">
+            <input type="text" placeholder="Nazwa z faktury (mapowanie / KSeF)..."
+                class="w-full bg-black/50 border border-white/5 rounded-lg p-3 text-xs text-slate-300 outline-none focus:border-green-500 transition invoice-name">
         </td>
         <td class="py-4 pr-4">
-            <select class="w-full bg-black border border-white/10 rounded-lg p-3 text-xs font-bold text-green-400 outline-none focus:border-green-500 appearance-none transition system-product">
-                <option value="">-- Przypisz do produktu systemowego --</option>
-                ${productOptions}
+            <select class="w-full bg-black border border-white/10 rounded-lg p-3 text-xs font-bold text-green-400 outline-none focus:border-green-500 appearance-none transition system-sku">
+                <option value="">ÔÇö wybierz surowiec (SKU) ÔÇö</option>
+                ${skuOptionsHtml()}
             </select>
         </td>
         <td class="py-4 px-2 text-center">
-            <input type="number" step="0.001" placeholder="0.00" class="w-24 bg-black border border-white/10 rounded-lg p-3 text-center text-white font-mono outline-none focus:border-green-500 transition invoice-qty">
+            <input type="number" step="0.001" min="0" placeholder="0"
+                class="w-28 bg-black border border-white/10 rounded-lg p-3 text-center text-white font-mono outline-none focus:border-green-500 transition invoice-qty">
         </td>
         <td class="py-4 px-2 text-center">
-            <select class="bg-black border border-white/10 rounded-lg p-3 text-xs text-slate-400 outline-none focus:border-green-500 appearance-none text-center invoice-unit">
-                <option value="szt">szt</option>
-                <option value="kg">kg</option>
-                <option value="g">g</option>
-                <option value="l">l</option>
-                <option value="ml">ml</option>
-            </select>
+            <input type="number" step="0.01" min="0" placeholder="0.00"
+                class="w-28 bg-black border border-white/10 rounded-lg p-3 text-center text-white font-mono outline-none focus:border-green-500 transition invoice-price">
         </td>
         <td class="py-4 text-right">
-            <button onclick="removeRow(${rowId})" class="text-slate-600 hover:text-red-500 transition px-3 opacity-0 group-hover:opacity-100">
+            <button type="button" onclick="window.removeRow(${rowId})" class="text-slate-600 hover:text-red-500 transition px-3 opacity-0 group-hover:opacity-100">
                 <i class="fa-solid fa-trash-can"></i>
             </button>
-        </td>
-    `;
-    
-    tbody.appendChild(tr);
-}
-
-window.removeRow = function(rowId) {
-    const row = document.getElementById(`row-${rowId}`);
-    if(row) row.remove();
-}
-
-window.savePZ = async function() {
-    const docNum = document.getElementById('pz-number').value;
-    const wid = document.getElementById('pz-warehouse').value;
-    
-    if(!docNum || !wid) return alert("Podaj numer faktury i wybierz magazyn!");
-
-    const rows = document.querySelectorAll('#pz-items tr');
-    let itemsToSave = [];
-    let hasErrors = false;
-
-    rows.forEach(row => {
-        const extName = row.querySelector('.invoice-name').value;
-        const sysProductId = row.querySelector('.system-product').value;
-        const rawQty = parseFloat(row.querySelector('.invoice-qty').value);
-        const inputUnit = row.querySelector('.invoice-unit').value;
-
-        if(!sysProductId || isNaN(rawQty) || rawQty <= 0) {
-            hasErrors = true;
-            return; // Przeskakujemy błędny wiersz
+        </td>`;
+        tbody.appendChild(tr);
+    };
+
+    window.removeRow = function (rowId) {
+        const row = document.getElementById(`row-${rowId}`);
+        if (row) row.remove();
+    };
+
+    window.savePZ = async function () {
+        const invoiceNo = document.getElementById('pz-number')?.value.trim();
+        const contractor = document.getElementById('pz-contractor')?.value.trim() || 'Dostawca';
+        const wid = document.getElementById('pz-warehouse')?.value;
+
+        if (!invoiceNo || !wid) {
+            alert('Podaj numer faktury / dokumentu i magazyn.');
+            return;
         }
 
-        // ­čžá U┼╗YCIE M├ôZGU: Standaryzacja jednostek z faktury na systemowe
-        let finalQty = rawQty;
-        if(typeof SliceValidator !== 'undefined') {
-            const conversion = SliceValidator.standardizeUnit(rawQty, inputUnit);
-            finalQty = conversion.value;
+        const rows = document.querySelectorAll('#pz-items tr');
+        const lines = [];
+
+        rows.forEach((row) => {
+            const extName = row.querySelector('.invoice-name')?.value.trim() || '';
+            const sku = row.querySelector('.system-sku')?.value || '';
+            const qty = parseFloat(row.querySelector('.invoice-qty')?.value);
+            const price = parseFloat(row.querySelector('.invoice-price')?.value);
+
+            if (!sku && !extName) return;
+            if (!sku || !Number.isFinite(qty) || qty <= 0 || !Number.isFinite(price) || price < 0) return;
+            lines.push({
+                external_name: extName || sku,
+                resolved_sku:  sku,
+                quantity:      qty,
+                unit_net_cost: price,
+            });
+        });
+
+        if (lines.length === 0) {
+            alert('Dodaj co najmniej jedn─ů poprawn─ů lini─Ö (SKU, ilo┼Ť─ç > 0, cena netto).');
+            return;
         }
 
-        itemsToSave.push({
-            product_id: sysProductId,
-            external_name: extName, // Do budowy słownika KSeF w locie
-            quantity: finalQty
-        });
-    });
+        const btn = document.getElementById('btn-save');
+        const orig = btn ? btn.innerHTML : '';
+        if (btn) {
+            btn.disabled = true;
+            btn.innerHTML = '<i class="fa-solid fa-circle-notch fa-spin"></i> ZapisÔÇŽ';
+        }
 
-    if(hasErrors && itemsToSave.length === 0) {
-        return alert("Wype┼énij poprawnie przynajmniej jedn─ů lini─Ö (Wybierz produkt i podaj ilo┼Ť─ç > 0).");
-    }
+        const res = await window.WarehouseApi.postReceipt({
+            warehouse_id:       wid,
+            supplier_name:      contractor,
+            supplier_invoice:   invoiceNo,
+            lines,
+        });
 
-    if(hasErrors) {
-        if(!confirm("Cz─Ö┼Ť─ç wierszy jest pusta lub ma b┼é─Ödn─ů ilo┼Ť─ç. Czy zapisa─ç tylko poprawne pozycje?")) return;
-    }
+        if (btn) {
+            btn.disabled = false;
+            btn.innerHTML = orig;
+        }
 
-    const btn = document.getElementById('btn-save');
-    const originalText = btn.innerHTML;
-    btn.innerHTML = `<i class="fa-solid fa-circle-notch fa-spin"></i> Zapisywanie...`;
-    btn.disabled = true;
-
-    try {
-        const res = await fetch('../../../api/api_inventory.php', {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({
-                action: 'save_pz',
-                doc_number: docNum,
-                warehouse_id: wid,
-                items: itemsToSave
-            })
-        }).then(r => r.json());
-
-        btn.innerHTML = originalText;
-        btn.disabled = false;
-
-        if(res.status === 'success') {
-            alert("Ôťů Dokument PZ zapisany poprawnie! Stany magazynowe zosta┼éy zasilone.");
+        if (res.success) {
+            alert('PZ zaksi─Ögowane. Stany i AVCO zaktualizowane.');
             document.getElementById('pz-number').value = '';
             document.getElementById('pz-items').innerHTML = '';
-            addRow(); // Resetujemy do 1 pustego wiersza
+            window.addRow();
         } else {
-            alert("B┼é─ůd zapisu: " + res.error);
+            alert(res.message || 'B┼é─ůd PZ');
         }
-
-    } catch(e) {
-        btn.innerHTML = originalText;
-        btn.disabled = false;
-        console.error("B┼é─ůd zapisu PZ:", e);
-        alert("Wyst─ůpi┼é b┼é─ůd komunikacji z M├│zgiem systemu.");
-    }
-}
\ No newline at end of file
+    };
+})();
diff --git a/modules/warehouse/js/warehouse_rw.js b/modules/warehouse/js/warehouse_rw.js
index 76dc21e..1a7ebba 100644
--- a/modules/warehouse/js/warehouse_rw.js
+++ b/modules/warehouse/js/warehouse_rw.js
@@ -1,161 +1,224 @@
-let currentItems = [];
-let totalBleed = 0;
-
-// MOCK DATA - Symulacja danych z API
-const mockProducts = [
-    { id: 1, name: "M─ůka do Pizzy typ 00", sku: "MAKA_00", base_unit: "kg", avg_cost: 4.50 },
-    { id: 2, name: "Ser Mozzarella Fior di Latte", sku: "SER_MOZZ_FDL", base_unit: "kg", avg_cost: 28.00 },
-    { id: 3, name: "Coca-Cola 0.5L PET", sku: "COLA_05_PET", base_unit: "szt", avg_cost: 2.15 },
-    { id: 4, name: "W├│dka Absolut 40%", sku: "ALC_ABSOLUT", base_unit: "l", avg_cost: 65.00 }
-];
-
-document.addEventListener('DOMContentLoaded', function() {
-    if(typeof SliceValidator === 'undefined') {
-        console.error("[CRITICAL] Brak po┼é─ůczenia z core_validator.js!");
-    }
-    loadProducts();
-});
-
-// Wymuszenie czysto┼Ťci ASCII w numerze dokumentu
-window.sanitizeDocNumber = function() {
-    const input = document.getElementById('doc_number');
-    if(typeof SliceValidator !== 'undefined') {
-        input.value = SliceValidator.sanitizeKey(input.value).toUpperCase();
-    }
-}
-
-function loadProducts() {
-    const sel = document.getElementById('product_selector');
-    sel.innerHTML = '<option value="">-- Wybierz lub Skanuj --</option>';
-    mockProducts.forEach(p => {
-        let opt = document.createElement('option');
-        opt.value = p.id;
-        opt.text = `${p.name} [${p.sku}] - ${p.avg_cost.toFixed(2)} PLN/${p.base_unit}`;
-        sel.appendChild(opt);
+/**
+ * RW ÔÇö rozch├│d wewn─Ötrzny / strata (V2 Ôćĺ batch_rw.php, 1 dokument = N linii).
+ */
+(function () {
+    'use strict';
+    const _e = s => { const d = document.createElement('div'); d.textContent = s == null ? '' : String(s); return d.innerHTML; };
+
+    let stockRows = [];
+    let currentItems = [];
+
+    document.addEventListener('DOMContentLoaded', () => {
+        loadStockForSelect();
     });
-}
 
-window.addItemToTable = function() {
-    const pid = parseInt(document.getElementById('product_selector').value);
-    const rawQty = parseFloat(document.getElementById('prod_qty').value);
-    const inputUnit = document.getElementById('prod_unit').value;
-    const reason = document.getElementById('prod_reason').value;
+    async function loadStockForSelect() {
+        await loadWarehousePicker();
+
+        const wid = document.getElementById('warehouse_id')?.value || window.WarehouseApi.DEFAULT_WAREHOUSE_ID;
+        const res = await window.WarehouseApi.stockList(wid);
+        if (!res.success || !Array.isArray(res.data)) {
+            console.error('[RW] stock_list', res.message);
+            return;
+        }
+        stockRows = res.data;
+        populateProductSelect();
+
+        const whEl = document.getElementById('warehouse_id');
+        if (whEl) {
+            whEl.addEventListener('change', async () => {
+                const r = await window.WarehouseApi.stockList(whEl.value);
+                if (r.success && Array.isArray(r.data)) {
+                    stockRows = r.data;
+                    populateProductSelect();
+                }
+            });
+        }
+    }
 
-    if (!pid || isNaN(rawQty) || rawQty <= 0) {
-        return alert('Wybierz produkt i podaj poprawn─ů ilo┼Ť─ç (powy┼╝ej 0)!');
+    function populateProductSelect() {
+        const sel = document.getElementById('product_selector');
+        if (!sel) return;
+        sel.innerHTML = '<option value="">ÔÇö wybierz surowiec ÔÇö</option>';
+        stockRows.forEach((r) => {
+            const av = parseFloat(r.current_avco_price) || 0;
+            const opt = document.createElement('option');
+            opt.value = r.sku;
+            opt.textContent = `${r.name} [${r.sku}] ÔÇö ${av.toFixed(2)} PLN / ${r.base_unit || ''}`;
+            sel.appendChild(opt);
+        });
     }
 
-    const product = mockProducts.find(p => p.id === pid);
-    
-    // ­čžá U┼╗YCIE M├ôZGU: Przeliczanie jednostki
-    let finalQty = rawQty;
-    let standardUnit = inputUnit;
-    
-    if(typeof SliceValidator !== 'undefined') {
-        const conversion = SliceValidator.standardizeUnit(rawQty, inputUnit);
-        finalQty = conversion.value;
-        standardUnit = conversion.unit;
-        
-        if((product.base_unit === 'szt' && standardUnit !== 'szt') || 
-           (product.base_unit !== 'szt' && standardUnit === 'szt')) {
-            return alert(`B┼é─ůd jednostki. Towar bazuje na: ${product.base_unit}`);
+    async function loadWarehousePicker() {
+        const wh = document.getElementById('warehouse_id');
+        if (!wh) return;
+        const res = await window.WarehouseApi.getWarehouseList();
+        if (res.success && Array.isArray(res.data) && res.data.length > 0) {
+            wh.innerHTML = '';
+            res.data.forEach(item => {
+                const id = typeof item === 'string' ? item : (item.warehouse_id || item.id);
+                const label = typeof item === 'string' ? item : (item.name || item.warehouse_id || item.id);
+                const opt = document.createElement('option');
+                opt.value = id;
+                opt.textContent = label;
+                wh.appendChild(opt);
+            });
+        } else {
+            const wid = window.WarehouseApi.DEFAULT_WAREHOUSE_ID;
+            wh.innerHTML = `<option value="${wid}" selected>Magazyn główny (${wid})</option>`;
+        }
+        const saved = localStorage.getItem('sh_warehouse_id');
+        if (saved) {
+            const exists = Array.from(wh.options).some(o => o.value === saved);
+            if (exists) wh.value = saved;
         }
     }
 
-    const itemCost = finalQty * product.avg_cost;
-
-    currentItems.push({
-        product_id: product.id,
-        name: product.name,
-        sku: product.sku,
-        raw_qty: rawQty,
-        input_unit: inputUnit,
-        sys_qty: finalQty,
-        sys_unit: standardUnit,
-        reason: reason,
-        cost: itemCost
-    });
+    function rowBySku(sku) {
+        return stockRows.find((r) => r.sku === sku);
+    }
+
+    window.sanitizeDocNumber = function () {
+        const input = document.getElementById('doc_number');
+        if (!input) return;
+        if (typeof SliceValidator !== 'undefined' && SliceValidator.sanitizeKey) {
+            input.value = SliceValidator.sanitizeKey(input.value).toUpperCase();
+        } else {
+            input.value = String(input.value || '')
+                .replace(/\s+/g, '_')
+                .replace(/[^A-Za-z0-9_/-]/g, '')
+                .toUpperCase();
+        }
+    };
 
-    document.getElementById('prod_qty').value = 1;
-    renderTable();
-}
+    window.addItemToTable = function () {
+        const sku = document.getElementById('product_selector')?.value;
+        const rawQty = parseFloat(document.getElementById('prod_qty')?.value);
+        const reason = document.getElementById('prod_reason')?.value || '';
 
-function renderTable() {
-    const tbody = document.getElementById('added_items_list');
-    document.getElementById('items-count').innerText = `Pozycji: ${currentItems.length}`;
-    
-    totalBleed = 0;
+        if (!sku || !Number.isFinite(rawQty) || rawQty <= 0) {
+            alert('Wybierz surowiec i podaj ilo┼Ť─ç > 0.');
+            return;
+        }
 
-    if(currentItems.length === 0) {
-        tbody.innerHTML = `<tr><td colspan="5" class="py-20 text-center text-slate-600 font-bold uppercase text-xs tracking-widest italic">Dokument jest pusty. Zeskanuj towar.</td></tr>`;
-        document.getElementById('total_bleed').innerText = "0.00";
-        return;
-    }
-    
-    tbody.innerHTML = '';
-    currentItems.forEach((item, index) => {
-        totalBleed += item.cost;
-        tbody.innerHTML += `
-            <tr class="hover:bg-white/5 transition group">
+        const row = rowBySku(sku);
+        if (!row) return;
+
+        let finalQty = rawQty;
+        if (typeof SliceValidator !== 'undefined' && SliceValidator.standardizeUnit) {
+            const inputUnit = document.getElementById('prod_unit')?.value || row.base_unit;
+            const conversion = SliceValidator.standardizeUnit(rawQty, inputUnit);
+            finalQty = conversion.value;
+        }
+
+        const av = parseFloat(row.current_avco_price) || 0;
+        const itemCost = finalQty * av;
+
+        currentItems.push({
+            sku,
+            name: row.name,
+            sys_qty: finalQty,
+            reason,
+            cost: itemCost,
+        });
+
+        document.getElementById('prod_qty').value = '1';
+        renderTable();
+    };
+
+    function renderTable() {
+        const tbody = document.getElementById('added_items_list');
+        if (!tbody) return;
+
+        const countEl = document.getElementById('items-count');
+        if (countEl) countEl.innerText = `Pozycji: ${currentItems.length}`;
+
+        let totalBleed = 0;
+
+        if (currentItems.length === 0) {
+            tbody.innerHTML =
+                '<tr><td colspan="5" class="py-20 text-center text-slate-600 font-bold uppercase text-xs tracking-widest italic">Dokument jest pusty.</td></tr>';
+            const tb = document.getElementById('total_bleed');
+            if (tb) tb.innerText = '0.00';
+            return;
+        }
+
+        tbody.innerHTML = '';
+        currentItems.forEach((item, index) => {
+            totalBleed += item.cost;
+            const tr = document.createElement('tr');
+            tr.className = 'hover:bg-white/5 transition group';
+            tr.innerHTML = `
                 <td class="p-4 border-b border-white/5">
-                    <div class="font-bold text-red-400 text-xs">${item.name}</div>
-                    <div class="text-[9px] text-slate-600 tracking-widest mt-1 uppercase">SKU: ${item.sku}</div>
-                </td>
-                <td class="p-4 border-b border-white/5 text-center">
-                    <span class="font-mono text-white text-sm bg-black/50 px-2 py-1 rounded border border-white/10">
-                        ${item.sys_qty.toFixed(3)} <span class="text-[10px] text-slate-500 ml-1">${item.sys_unit}</span>
-                    </span>
-                </td>
-                <td class="p-4 border-b border-white/5 text-xs font-bold text-slate-400">${item.reason}</td>
-                <td class="p-4 border-b border-white/5 text-right font-mono text-red-500 font-bold">
-                    -${item.cost.toFixed(2)} PLN
+                    <div class="font-bold text-red-400 text-xs">${_e(item.name)}</div>
+                    <div class="text-[9px] text-slate-600 tracking-widest mt-1 uppercase">SKU: ${_e(item.sku)}</div>
                 </td>
+                <td class="p-4 border-b border-white/5 text-center font-mono text-white text-sm">${item.sys_qty.toFixed(3)}</td>
+                <td class="p-4 border-b border-white/5 text-xs font-bold text-slate-400">${_e(item.reason)}</td>
+                <td class="p-4 border-b border-white/5 text-right font-mono text-red-500 font-bold">-${item.cost.toFixed(2)} PLN</td>
                 <td class="p-4 border-b border-white/5 text-center">
-                    <button onclick="removeItem(${index})" class="text-slate-600 hover:text-red-500 transition px-2">
+                    <button type="button" class="text-slate-600 hover:text-red-500 transition px-2" data-idx="${index}">
                         <i class="fa-solid fa-xmark text-lg"></i>
-                    </button>
-                </td>
-            </tr>`;
-    });
-
-    document.getElementById('total_bleed').innerText = totalBleed.toFixed(2);
-}
-
-window.removeItem = function(index) {
-    currentItems.splice(index, 1);
-    renderTable();
-}
-
-window.saveDocument = async function() {
-    const doc = document.getElementById('doc_number').value;
-    const wid = document.getElementById('warehouse_id').value;
-    const reqPin = document.getElementById('req_pin').checked;
-    
-    if (!doc) return alert('Wymagany numer dokumentu!');
-    if (currentItems.length === 0) return alert('Brak towaru na li┼Ťcie zrzutu!');
-
-    if(reqPin && totalBleed > 50) {
-        const pin = prompt("STRATA PRZEKRACZA 50 PLN. Podaj PIN Kierownika:");
-        if(pin !== "1234") return alert("Odmowa dostępu. Nieprawidłowy PIN.");
+                    </button>`;
+            tr.querySelector('button').addEventListener('click', () => {
+                currentItems.splice(index, 1);
+                renderTable();
+            });
+            tbody.appendChild(tr);
+        });
+
+        const tb = document.getElementById('total_bleed');
+        if (tb) tb.innerText = totalBleed.toFixed(2);
     }
 
-    document.getElementById('loading-overlay').classList.remove('hidden');
+    window.saveDocument = async function () {
+        const doc = document.getElementById('doc_number')?.value.trim();
+        const wid = document.getElementById('warehouse_id')?.value;
+        const reqPin = document.getElementById('req_pin')?.checked;
+        let totalBleed = currentItems.reduce((s, i) => s + i.cost, 0);
 
-    try {
-        // Docelowy strza┼é - UWAGA NA 3 POZIOMY W G├ôR─ś!
-        // const res = await fetch('../../../api/api_inventory.php', { ... });
-        
-        setTimeout(() => {
-            document.getElementById('loading-overlay').classList.add('hidden');
-            alert(`Ôťů Zapisano pomy┼Ťlnie. Towar zrzucony. Strata dla firmy: -${totalBleed.toFixed(2)} PLN`);
+        if (!doc) {
+            alert('Podaj numer dokumentu (referencyjny).');
+            return;
+        }
+        if (!wid) {
+            alert('Wybierz magazyn.');
+            return;
+        }
+        if (currentItems.length === 0) {
+            alert('Brak pozycji na li┼Ťcie.');
+            return;
+        }
+
+        if (reqPin && totalBleed > 50) {
+            if (!confirm(`Strata przekracza 50 PLN netto (${totalBleed.toFixed(2)} PLN). Czy potwierdzasz zaksi─Ögowanie?`)) {
+                return;
+            }
+        }
+
+        const overlay = document.getElementById('loading-overlay');
+        if (overlay) overlay.classList.remove('hidden');
+
+        try {
+            const reasons = [...new Set(currentItems.map(i => i.reason).filter(Boolean))];
+            const fullReason = [doc, ...reasons].join(' | ').slice(0, 500);
+
+            const res = await window.WarehouseApi.postBatchRw({
+                warehouse_id: wid,
+                reason: fullReason,
+                lines: currentItems.map(item => ({ sku: item.sku, qty: item.sys_qty })),
+            });
+            if (!res.success) {
+                throw new Error(res.message || 'B┼é─ůd RW');
+            }
+            alert(res.message || `Zaksi─Ögowano ${currentItems.length} poz. rozchodu wewn─Ötrznego.`);
             currentItems = [];
             renderTable();
             document.getElementById('doc_number').value = '';
-        }, 1000);
-
-    } catch(e) {
-        document.getElementById('loading-overlay').classList.add('hidden');
-        console.error("B┼é─ůd zapisu:", e);
-        alert("Wyst─ůpi┼é b┼é─ůd komunikacji z M├│zgiem systemu.");
-    }
-}
\ No newline at end of file
+        } catch (e) {
+            alert(e.message || String(e));
+        } finally {
+            if (overlay) overlay.classList.add('hidden');
+        }
+    };
+})();
diff --git a/modules/warehouse/manager_in.html b/modules/warehouse/manager_in.html
index a50202b..96a1571 100644
--- a/modules/warehouse/manager_in.html
+++ b/modules/warehouse/manager_in.html
@@ -2,17 +2,18 @@
 <html lang="pl">
 <head>
     <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, viewport-fit=cover">
     <title>SliceHub - Inwentaryzacja IN (Ultimate)</title>
     
     <script src="https://cdn.tailwindcss.com"></script>
     <link href="https://fonts.googleapis.com/css2?family=Montserrat:wght@400;700;900&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css">
     
-    <script src="../../core/core_validator.js"></script>
+    <script src="../../core/js/core_validator.js"></script>
 
     <style>
-        body { font-family: 'Montserrat', sans-serif; background-color: #050505; color: white; -webkit-tap-highlight-color: transparent; }
+        body { font-family: 'Montserrat', sans-serif; background-color: #050505; color: white; user-select: none; -webkit-user-select: none; -webkit-tap-highlight-color: transparent; overscroll-behavior-y: none; }
+        input, textarea, select, [contenteditable] { user-select: text; -webkit-user-select: text; }
         .glass { background: rgba(255, 255, 255, 0.02); backdrop-filter: blur(10px); border: 1px solid rgba(255, 255, 255, 0.05); }
         .hide-scrollbar::-webkit-scrollbar { display: none; }
         
@@ -39,7 +40,10 @@
             <div class="inline-flex items-center gap-2 bg-amber-900/20 text-amber-400 px-4 py-2 rounded-xl border border-amber-500/30 text-[10px] font-bold uppercase tracking-widest" id="validator-status">
                 <i class="fa-solid fa-microchip animate-pulse"></i> Validator Aktywny
             </div>
-            <button onclick="window.location.href='settings_magazyn.html'" class="glass px-6 py-2 rounded-xl text-xs font-bold uppercase tracking-widest text-slate-300 hover:text-white transition hover:bg-white/5 border border-white/10">
+            <button type="button" onclick="window.location.href='index.html'" class="glass px-4 py-2 rounded-xl text-xs font-bold uppercase tracking-widest text-slate-300 hover:text-white transition hover:bg-white/5 border border-white/10">
+                <i class="fa-solid fa-warehouse mr-2"></i> Hub
+            </button>
+            <button type="button" onclick="window.location.href='settings_magazyn.html'" class="glass px-6 py-2 rounded-xl text-xs font-bold uppercase tracking-widest text-slate-300 hover:text-white transition hover:bg-white/5 border border-white/10">
                 <i class="fa-solid fa-arrow-left mr-2"></i> Matryca
             </button>
         </div>
@@ -96,7 +100,7 @@
                     <table class="w-full text-left border-collapse" id="in-table">
                         <thead>
                             <tr class="border-b border-white/10 text-[10px] uppercase text-slate-500 tracking-widest">
-                                <th class="pb-4 pr-4">Produkt (UTF-8)</th>
+                                <th class="pb-4 pr-4">Surowiec (sys_items)</th>
                                 <th class="pb-4 pr-4 text-center sys-qty">Stan Systemowy</th>
                                 <th class="pb-4 pr-4 text-center">Stan Faktyczny (Półka)</th>
                                 <th class="pb-4 pr-4 text-center">J.m.</th>
@@ -123,6 +127,8 @@
         <i class="fa-solid fa-circle-notch fa-spin text-6xl text-amber-500 mb-6"></i>
         <p class="font-black tracking-[0.3em] uppercase text-amber-500 text-sm animate-pulse">Przeliczanie Matrycy Magazynowej...</p>
     </div>
-<script src="js/warehouse_in.js"></script>
+    <script src="../../core/js/api_client.js"></script>
+    <script src="js/warehouse_api.js"></script>
+    <script src="js/warehouse_in.js"></script>
 </body>
 </html>
\ No newline at end of file
diff --git a/modules/warehouse/manager_pz.html b/modules/warehouse/manager_pz.html
index ebec43d..95f0609 100644
--- a/modules/warehouse/manager_pz.html
+++ b/modules/warehouse/manager_pz.html
@@ -2,17 +2,18 @@
 <html lang="pl">
 <head>
     <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, viewport-fit=cover">
     <title>SliceHub - Przyj─Öcie Towaru (PZ) PRO</title>
     <script src="https://cdn.tailwindcss.com"></script>
     <link href="https://fonts.googleapis.com/css2?family=Montserrat:wght@400;700;900&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css">
     
     
-    <script src="../../core/core_validator.js"></script>
+    <script src="../../core/js/core_validator.js"></script>
 
     <style>
-        body { font-family: 'Montserrat', sans-serif; background-color: #050505; color: white; }
+        body { font-family: 'Montserrat', sans-serif; background-color: #050505; color: white; user-select: none; -webkit-user-select: none; -webkit-tap-highlight-color: transparent; overscroll-behavior-y: none; }
+        input, textarea, select, [contenteditable] { user-select: text; -webkit-user-select: text; }
         .glass { background: rgba(255, 255, 255, 0.03); border: 1px solid rgba(255, 255, 255, 0.05); backdrop-filter: blur(10px); }
         
         /* Custom Scrollbar */
@@ -33,10 +34,18 @@
                 </div>
             </div>
         </div>
-        <button onclick="savePZ()" id="btn-save" class="bg-green-600 hover:bg-green-500 text-white px-8 py-4 rounded-xl font-black uppercase tracking-wider text-xs transition shadow-[0_0_20px_rgba(34,197,94,0.3)] group relative overflow-hidden">
-            <span class="relative z-10">Zatwierd┼║ PZ</span>
-            <div class="absolute inset-0 h-full w-0 bg-white/20 group-hover:w-full transition-all duration-300 ease-out z-0"></div>
-        </button>
+        <div class="flex gap-3">
+            <a href="index.html" class="glass px-4 py-3 rounded-xl text-xs font-bold uppercase tracking-widest text-slate-400 hover:text-white transition border border-white/10 flex items-center gap-2">
+                <i class="fa-solid fa-warehouse"></i> Hub
+            </a>
+            <a href="warehouse_control_tower.html" class="glass px-4 py-3 rounded-xl text-xs font-bold uppercase tracking-widest text-slate-400 hover:text-white transition border border-white/10 flex items-center gap-2">
+                <i class="fa-solid fa-tower-broadcast"></i> Control Tower
+            </a>
+            <button onclick="savePZ()" id="btn-save" class="bg-green-600 hover:bg-green-500 text-white px-8 py-4 rounded-xl font-black uppercase tracking-wider text-xs transition shadow-[0_0_20px_rgba(34,197,94,0.3)] group relative overflow-hidden">
+                <span class="relative z-10">Zatwierd┼║ PZ</span>
+                <div class="absolute inset-0 h-full w-0 bg-white/20 group-hover:w-full transition-all duration-300 ease-out z-0"></div>
+            </button>
+        </div>
     </header>
 
     <div class="glass p-8 rounded-3xl border border-white/5 mb-8 focus-within:border-green-500/50 transition-colors duration-300">
@@ -62,10 +71,10 @@
             <table class="w-full text-left">
                 <thead>
                     <tr class="border-b border-white/10 text-[10px] uppercase text-slate-500 tracking-widest">
-                        <th class="pb-4 w-1/3">Nazwa z Faktury (Auto-Mapowanie)</th>
-                        <th class="pb-4 w-1/3">Produkt w SliceHub (Docelowy)</th>
-                        <th class="pb-4 text-center">Ilo┼Ť─ç z Faktury</th>
-                        <th class="pb-4 text-center">Jednostka Faktury</th>
+                        <th class="pb-4 w-1/4">Nazwa z faktury (zewn─Ötrzna)</th>
+                        <th class="pb-4 w-1/4">Surowiec (SKU ÔÇö sys_items)</th>
+                        <th class="pb-4 text-center">Ilo┼Ť─ç (j.m. magazynowa)</th>
+                        <th class="pb-4 text-center">Cena jedn. netto</th>
                         <th class="pb-4 text-right">Akcja</th>
                     </tr>
                 </thead>
@@ -77,6 +86,8 @@
             <i class="fa-solid fa-plus mr-2 group-hover:rotate-90 transition-transform duration-300"></i>Dodaj Kolejn─ů Lini─Ö
         </button>
     </div>
-<script src="js/warehouse_pz.js"></script>
+    <script src="../../core/js/api_client.js"></script>
+    <script src="js/warehouse_api.js"></script>
+    <script src="js/warehouse_pz.js"></script>
 </body>
 </html>
\ No newline at end of file
diff --git a/modules/warehouse/manager_rw.html b/modules/warehouse/manager_rw.html
index 9c2b5ec..02ed39c 100644
--- a/modules/warehouse/manager_rw.html
+++ b/modules/warehouse/manager_rw.html
@@ -2,17 +2,18 @@
 <html lang="pl">
 <head>
     <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, viewport-fit=cover">
     <title>SliceHub POS - Straty RW</title>
     
     <script src="https://cdn.tailwindcss.com"></script>
     <link href="https://fonts.googleapis.com/css2?family=Montserrat:wght@400;700;900&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css">
     
-    <script src="../../core/core_validator.js"></script>
+    <script src="../../core/js/core_validator.js"></script>
 
     <style>
-        body { font-family: 'Montserrat', sans-serif; background-color: #050505; color: white; -webkit-tap-highlight-color: transparent; }
+        body { font-family: 'Montserrat', sans-serif; background-color: #050505; color: white; user-select: none; -webkit-user-select: none; -webkit-tap-highlight-color: transparent; overscroll-behavior-y: none; }
+        input, textarea, select, [contenteditable] { user-select: text; -webkit-user-select: text; }
         .glass { background: rgba(255, 255, 255, 0.02); backdrop-filter: blur(10px); border: 1px solid rgba(255, 255, 255, 0.05); transition: all 0.3s ease; }
         .glass:hover { border-color: rgba(239, 68, 68, 0.15); background: rgba(255, 255, 255, 0.03); }
         .hide-scrollbar::-webkit-scrollbar { display: none; }
@@ -38,9 +39,14 @@
             </h1>
             <p class="text-[10px] text-slate-500 font-black uppercase tracking-[0.2em] mt-1">Rejestracja strat i ubytk├│w magazynowych</p>
         </div>
-        <button onclick="window.location.href='../studio/index.html'" class="glass px-6 py-3 rounded-2xl text-xs font-bold uppercase tracking-widest text-slate-400 hover:text-white hover:border-white/20 transition">
-            <i class="fa-solid fa-power-off mr-2"></i> Control Center
-        </button>
+        <div class="flex gap-2">
+            <button type="button" onclick="window.location.href='index.html'" class="glass px-4 py-3 rounded-2xl text-xs font-bold uppercase tracking-widest text-slate-400 hover:text-white transition border border-white/10">
+                <i class="fa-solid fa-warehouse mr-2"></i> Magazyn
+            </button>
+            <button type="button" onclick="window.location.href='../studio/index.html'" class="glass px-6 py-3 rounded-2xl text-xs font-bold uppercase tracking-widest text-slate-400 hover:text-white hover:border-white/20 transition">
+                <i class="fa-solid fa-power-off mr-2"></i> Studio
+            </button>
+        </div>
     </header>
 
     <main class="flex-1 overflow-y-auto hide-scrollbar p-6 lg:p-10 grid grid-cols-1 xl:grid-cols-3 gap-8 max-w-[1600px] mx-auto w-full">
@@ -60,8 +66,7 @@
                     <div>
                         <label class="text-[10px] uppercase tracking-widest text-slate-500 font-bold mb-2 block">Magazyn Źródłowy</label>
                         <select id="warehouse_id" class="w-full bg-black border border-white/10 text-white rounded-xl p-4 outline-none focus:border-red-500 font-bold uppercase appearance-none transition">
-                            <option value="1">Magazyn Główny</option>
-                            <option value="2">Magazyn Kuchnia / Bar</option>
+                            <option value="">Ładowanie magazynów...</option>
                         </select>
                     </div>
                 </div>
@@ -181,6 +186,8 @@
         <p class="font-black tracking-[0.3em] uppercase text-red-500 text-sm animate-pulse">Spalanie Stan├│w Magazynowych...</p>
     </div>
 
+    <script src="../../core/js/api_client.js"></script>
+    <script src="js/warehouse_api.js"></script>
     <script src="js/warehouse_rw.js"></script>
 </body>
 </html>
\ No newline at end of file
diff --git a/modules/warehouse/settings_magazyn.html b/modules/warehouse/settings_magazyn.html
index cfc90de..f06296a 100644
--- a/modules/warehouse/settings_magazyn.html
+++ b/modules/warehouse/settings_magazyn.html
@@ -2,16 +2,17 @@
 <html lang="pl">
 <head>
     <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, viewport-fit=cover">
     <title>SliceHub - Centrala Magazynowa</title>
     <script src="https://cdn.tailwindcss.com"></script>
     <link href="https://fonts.googleapis.com/css2?family=Montserrat:wght@400;700;900&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css">
     
-    <script src="../../core/core_validator.js"></script>
+    <script src="../../core/js/core_validator.js"></script>
 
     <style>
-        body { font-family: 'Montserrat', sans-serif; background-color: #050505; color: white; }
+        body { font-family: 'Montserrat', sans-serif; background-color: #050505; color: white; user-select: none; -webkit-user-select: none; -webkit-tap-highlight-color: transparent; overscroll-behavior-y: none; }
+        input, textarea, select, [contenteditable] { user-select: text; -webkit-user-select: text; }
         .glass { background: rgba(255, 255, 255, 0.03); border: 1px solid rgba(255, 255, 255, 0.05); backdrop-filter: blur(10px); }
         .glass-panel { background: linear-gradient(145deg, rgba(20,20,20,0.8) 0%, rgba(5,5,5,0.9) 100%); border: 1px solid rgba(255,255,255,0.05); box-shadow: inset 0 0 20px rgba(0,0,0,0.5); }
         
@@ -37,9 +38,12 @@
                 </div>
             </div>
         </div>
-        <button onclick="init()" class="bg-black hover:bg-white/5 text-slate-300 px-6 py-3 rounded-xl font-black uppercase text-xs transition border border-white/10 shadow-lg">
-            <i class="fa-solid fa-rotate-right mr-2 text-blue-500"></i> Od┼Ťwie┼╝ Matryc─Ö
-        </button>
+        <div class="flex gap-3 items-center">
+            <a href="index.html" class="glass px-4 py-3 rounded-xl text-xs font-bold uppercase tracking-widest text-slate-400 hover:text-white transition border border-white/10"><i class="fa-solid fa-warehouse mr-2"></i>Hub</a>
+            <button onclick="window.initCatalogMatrix()" class="bg-black hover:bg-white/5 text-slate-300 px-6 py-3 rounded-xl font-black uppercase text-xs transition border border-white/10 shadow-lg">
+                <i class="fa-solid fa-rotate-right mr-2 text-blue-500"></i> Od┼Ťwie┼╝ Matryc─Ö
+            </button>
+        </div>
     </header>
 
     <div class="glass-panel p-8 rounded-3xl mb-8 relative overflow-hidden group">
@@ -79,123 +83,8 @@
         </table>
     </div>
 
-    <script>
-        // ­čŤí´ŞĆ Komunikacja z API Magazynu (Zaktualizowana ┼Ťcie┼╝ka)
-        async function api(action, payload = {}) {
-            payload.action = action;
-            try {
-                const res = await fetch('../../api/api_inventory.php', {
-                    method: 'POST',
-                    headers: { 'Content-Type': 'application/json' },
-                    body: JSON.stringify(payload)
-                });
-                return await res.json();
-            } catch (err) {
-                console.error("API Error:", err);
-                return { status: 'error', error: 'B┼é─ůd po┼é─ůczenia z serwerem.' };
-            }
-        }
-
-        // ­čžá ┼üadowanie twardego s┼éownika jednostek z M├│zgu (Walidatora)
-        function loadUnitDictionary() {
-            const unitSelect = document.getElementById('new-item-unit');
-            const units = SliceValidator.units;
-            
-            let options = '<option value="">-- Wybierz Jednostk─Ö --</option>';
-            for (const [key, data] of Object.entries(units)) {
-                // Pokazujemy tylko jednostki o proporcji 1 (bazowe) - np. kg, l, szt, a ukrywamy g, ml
-                if (data.ratio === 1) {
-                    options += `<option value="${key}">${data.label} (${key})</option>`;
-                }
-            }
-            unitSelect.innerHTML = options;
-        }
-
-        // ­ččó Tworzenie Nowego Surowca
-        async function createItem() {
-            const nameInput = document.getElementById('new-item-name');
-            const unitInput = document.getElementById('new-item-unit');
-            
-            const name = nameInput.value.trim();
-            const unit = unitInput.value;
-
-            if (!name || !unit) {
-                alert("Wype┼énij nazw─Ö i wybierz jednostk─Ö bazow─ů!");
-                return;
-            }
-
-            // Oczyszczanie przed wstrzykni─Öciem (XSS protection)
-            const safeName = name.replace(/</g, "&lt;").replace(/>/g, "&gt;");
-
-            const res = await api('create_product', { 
-                name: safeName, 
-                unit: unit 
-            });
-
-            if (res.status === 'success') {
-                nameInput.value = '';
-                unitInput.value = '';
-                init(); // Przeładowanie matrycy, aby pokazać nowy produkt
-            } else {
-                alert("B┼é─ůd zapisu surowca: " + (res.error || "Nieznany b┼é─ůd"));
-            }
-        }
-
-        // ­ččó Inicjalizacja Matrycy Stan├│w
-        async function init() {
-            const tbody = document.getElementById('matrix-body');
-            tbody.innerHTML = `<tr><td colspan="5" class="py-10 text-center text-blue-500 font-bold uppercase text-xs tracking-widest"><i class="fa-solid fa-spinner fa-spin mr-2"></i> Od┼Ťwie┼╝anie Matrycy...</td></tr>`;
-
-            const res = await api('get_stock_matrix');
-            
-            if (res.status === 'success') {
-                const { products, warehouses, stocks } = res.payload;
-                
-                // 1. Budowanie nagłówków (Kolumny magazynów)
-                const thead = document.getElementById('matrix-head');
-                let headHtml = `<th class="pb-4 pr-4">Zidentyfikowany Produkt</th><th class="pb-4 pr-4 text-center">J.m.</th>`;
-                warehouses.forEach(w => {
-                    headHtml += `<th class="pb-4 text-center text-blue-500"><i class="fa-solid fa-warehouse mr-2 text-[10px]"></i>${w.name}</th>`;
-                });
-                thead.innerHTML = headHtml;
-
-                // 2. Budowanie wierszy (Produkty i ich stany)
-                let bodyHtml = '';
-
-                if (products.length === 0) {
-                    bodyHtml = `<tr><td colspan="${warehouses.length + 2}" class="py-10 text-center text-slate-500 font-bold uppercase text-xs">Brak surowc├│w w bazie. Dodaj pierwszy powy┼╝ej.</td></tr>`;
-                } else {
-                    products.forEach(p => {
-                        bodyHtml += `<tr class="border-b border-white/5 hover:bg-white/5 transition group">
-                                        <td class="py-4 pr-4 font-bold text-xs uppercase text-slate-200 tracking-wide">${p.name}</td>
-                                        <td class="py-4 pr-4 text-center text-slate-500 text-[10px] font-black uppercase bg-black/20 rounded-lg">${p.unit}</td>`;
-                        
-                        // Szukanie stanu dla ka┼╝dego magazynu
-                        warehouses.forEach(w => {
-                            const stockEntry = stocks.find(s => s.product_id === p.id && s.warehouse_id === w.id);
-                            const qty = stockEntry ? parseFloat(stockEntry.quantity).toFixed(3) : "0.000";
-                            
-                            let colorClass = "text-slate-500"; // Pusty stan
-                            if(qty < 0) colorClass = "negative-stock";
-                            if(qty > 0) colorClass = "positive-stock";
-
-                            bodyHtml += `<td class="py-4 text-center text-sm font-mono ${colorClass} group-hover:bg-black/30 transition">${qty}</td>`;
-                        });
-                        
-                        bodyHtml += `</tr>`;
-                    });
-                }
-
-                tbody.innerHTML = bodyHtml;
-            } else {
-                tbody.innerHTML = `<tr><td colspan="5" class="py-10 text-center text-red-500 font-bold uppercase text-xs"><i class="fa-solid fa-triangle-exclamation mr-2"></i> B┼é─ůd pobierania danych z serwera.</td></tr>`;
-                console.error("B┼é─ůd API:", res.error);
-            }
-        }
-
-        // Uruchomienie procedur startowych
-        loadUnitDictionary();
-        init();
-    </script>
+    <script src="../../core/js/api_client.js"></script>
+    <script src="js/warehouse_api.js"></script>
+    <script src="js/warehouse_settings_catalog.js"></script>
 </body>
 </html>
\ No newline at end of file
diff --git a/modules/warehouse/settings_mapping.html b/modules/warehouse/settings_mapping.html
index 840687a..28f3aa2 100644
--- a/modules/warehouse/settings_mapping.html
+++ b/modules/warehouse/settings_mapping.html
@@ -2,16 +2,17 @@
 <html lang="pl">
 <head>
     <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, viewport-fit=cover">
     <title>SliceHub - Słownik Mapowania</title>
     <script src="https://cdn.tailwindcss.com"></script>
     <link href="https://fonts.googleapis.com/css2?family=Montserrat:wght@400;700;900&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css">
     
-    <script src="../../core/core_validator.js"></script>
+    <script src="../../core/js/core_validator.js"></script>
 
     <style>
-        body { font-family: 'Montserrat', sans-serif; background-color: #050505; color: white; }
+        body { font-family: 'Montserrat', sans-serif; background-color: #050505; color: white; user-select: none; -webkit-user-select: none; -webkit-tap-highlight-color: transparent; overscroll-behavior-y: none; }
+        input, textarea, select, [contenteditable] { user-select: text; -webkit-user-select: text; }
         .glass { background: rgba(255, 255, 255, 0.03); border: 1px solid rgba(255, 255, 255, 0.05); backdrop-filter: blur(10px); }
         .neon-border-blue { border: 1px solid rgba(59, 130, 246, 0.5); box-shadow: 0 0 15px rgba(59, 130, 246, 0.1); transition: all 0.3s ease; }
         .neon-border-blue:focus-within { box-shadow: 0 0 25px rgba(59, 130, 246, 0.3); }
@@ -31,7 +32,8 @@
                 Po┼é─ůcz nazwy z faktur zewn─Ötrznych z Twoimi produktami <span class="text-blue-500 ml-2"><i class="fa-solid fa-bolt"></i> KSeF Ready</span>
             </p>
         </div>
-        <div class="text-right hidden md:block">
+        <div class="flex items-center gap-3">
+            <a href="index.html" class="glass px-4 py-3 rounded-xl text-xs font-bold uppercase tracking-widest text-slate-400 hover:text-white transition border border-white/10"><i class="fa-solid fa-warehouse mr-2"></i>Hub</a>
             <div class="inline-flex items-center gap-2 bg-blue-900/20 text-blue-400 px-3 py-1 rounded-full border border-blue-500/30 text-[10px] font-bold uppercase tracking-widest" id="validator-status">
                 <i class="fa-solid fa-microchip animate-pulse"></i> Validator Aktywny
             </div>
@@ -82,105 +84,8 @@
         </div>
     </div>
 
-    <script>
-        let products = [];
-
-        // ­čŤí´ŞĆ Komunikacja z zabezpieczonym API
-        async function api(action, payload = {}) {
-            payload.action = action;
-            try {
-                // Ścieżka do API (Silos 2: Magazyn)
-                const res = await fetch('../../api/api_mapping.php', {
-                    method: 'POST',
-                    headers: { 'Content-Type': 'application/json' },
-                    body: JSON.stringify(payload)
-                });
-                return await res.json();
-            } catch (err) {
-                console.error("B┼é─ůd po┼é─ůczenia z API:", err);
-                return { status: 'error', error: 'B┼é─ůd sieci lub serwera.' };
-            }
-        }
-
-        // ­ččó Inicjalizacja i renderowanie danych
-        async function init() {
-            const res = await api('get_mapping_data');
-            
-            if(res.status === 'success') {
-                products = res.payload.products;
-                
-                // Renderowanie listy wyboru produkt├│w
-                const sel = document.getElementById('map-int-id');
-                sel.innerHTML = '<option value="">-- Wybierz produkt z bazy --</option>' + 
-                    products.map(p => `<option value="${p.id}">${p.name}</option>`).join('');
-
-                // Renderowanie tabeli zmapowanych produkt├│w
-                const tbody = document.getElementById('mapping-list');
-                const mappings = res.payload.mappings;
-                
-                document.getElementById('mapping-count').innerText = mappings.length;
-
-                tbody.innerHTML = mappings.map(m => `
-                    <tr class="border-b border-white/5 hover:bg-white/5 transition group">
-                        <td class="py-4 font-bold text-slate-300 text-sm tracking-wide">
-                            <i class="fa-solid fa-file-invoice text-slate-600 mr-2 text-[10px]"></i> ${m.external_name}
-                        </td>
-                        <td class="py-4 font-black text-blue-400 text-sm italic underline decoration-blue-900 decoration-2 underline-offset-4">
-                            <i class="fa-solid fa-box text-blue-900 mr-2 text-[10px]"></i> ${m.internal_name}
-                        </td>
-                        <td class="py-4 text-right">
-                            <button onclick="deleteMapping(${m.id})" class="text-slate-600 hover:text-red-500 transition p-2 bg-black/30 rounded-lg hover:bg-red-500/10 group-hover:opacity-100 opacity-50">
-                                <i class="fa-solid fa-trash"></i>
-                            </button>
-                        </td>
-                    </tr>
-                `).join('') || '<tr><td colspan="3" class="text-center py-10 text-slate-500 font-bold">Brak regu┼é mapowania. Dodaj pierwsz─ů z faktury.</td></tr>';
-            } else {
-                alert("B┼é─ůd ┼éadowania danych: " + res.error);
-            }
-        }
-
-        // ­ččó Zapis nowego mapowania (Z wykorzystaniem walidacji)
-        async function saveMapping() {
-            const extNameInput = document.getElementById('map-ext-name');
-            let extName = extNameInput.value.trim();
-            const intId = document.getElementById('map-int-id').value;
-
-            // 1. Wst─Öpna walidacja interfejsu
-            if(!extName || !intId) {
-                alert("Wypełnij oba pola, Szefie!");
-                return;
-            }
-
-            // 2. Czyszczenie nazwy zewn─Ötrznej z niebezpiecznych tag├│w (XSS protection), ale zostawiamy UTF-8 (polskie znaki)
-            extName = extName.replace(/</g, "&lt;").replace(/>/g, "&gt;").toUpperCase();
-
-            // 3. Wysłanie do API
-            const res = await api('add_mapping', { external_name: extName, internal_product_id: intId });
-            
-            if(res.status === 'success') {
-                extNameInput.value = ''; // Czyszczenie inputa
-                extNameInput.focus();
-                init(); // Przeładowanie tabeli
-            } else {
-                alert("B┼é─ůd zapisu: " + res.error);
-            }
-        }
-
-        // ­ččó Usuwanie z zabezpieczeniem
-        async function deleteMapping(id) {
-            if(!confirm("Na pewno chcesz usun─ů─ç t─Ö regu┼é─Ö mapowania? KSeF nie rozpozna tego produktu przy kolejnej fakturze.")) return;
-            
-            const res = await api('delete_mapping', { mapping_id: id });
-            if(res.status === 'success') {
-                init();
-            } else {
-                alert("B┼é─ůd usuwania: " + res.error);
-            }
-        }
-
-        // Uruchomienie silnika po załadowaniu
-        init();
-    </script>
+    <script src="../../core/js/api_client.js"></script>
+    <script src="js/warehouse_api.js"></script>
+    <script src="js/warehouse_settings_mapping.js"></script>
 </body>
 </html>
\ No newline at end of file
diff --git a/modules/warehouse/warehouse_control_tower.html b/modules/warehouse/warehouse_control_tower.html
index a74a2e5..9399eaf 100644
--- a/modules/warehouse/warehouse_control_tower.html
+++ b/modules/warehouse/warehouse_control_tower.html
@@ -2,10 +2,12 @@
 <html lang="pl">
 <head>
     <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, viewport-fit=cover">
     <title>SliceHub Enterprise | Control Tower</title>
     <script src="https://cdn.tailwindcss.com"></script>
     <style>
+        body { user-select: none; -webkit-user-select: none; -webkit-tap-highlight-color: transparent; overscroll-behavior-y: none; }
+        input, textarea, select, [contenteditable] { user-select: text; -webkit-user-select: text; }
         /* Niestandardowy scrollbar dla widoku Enterprise */
         ::-webkit-scrollbar { width: 8px; height: 8px; }
         ::-webkit-scrollbar-track { background: rgba(255, 255, 255, 0.02); }
@@ -20,8 +22,15 @@
 
     <header class="flex justify-between items-center mb-6 shrink-0">
         <div>
-            <h1 class="text-2xl font-bold text-white tracking-wide">MAGAZYN <span class="text-violet-500">CONTROL TOWER</span></h1>
-            <p class="text-sm text-gray-500 mt-1">Live Stock Matrix & Analytics</p>
+            <div class="flex items-center gap-4">
+                <h1 class="text-2xl font-bold text-white tracking-wide">MAGAZYN <span class="text-violet-500">CONTROL TOWER</span></h1>
+                <select id="warehousePicker"
+                        class="bg-white/5 border border-white/10 rounded-lg px-3 py-1.5 text-sm text-gray-300
+                               focus:outline-none focus:border-violet-500/60 appearance-none cursor-pointer">
+                    <option value="MAIN">MAIN</option>
+                </select>
+            </div>
+            <p class="text-sm text-gray-500 mt-1">Live Stock Matrix & Analytics ┬Ě <span id="lastUpdated" class="text-gray-600">ÔÇö</span></p>
         </div>
         <div class="flex items-center gap-4">
             <button id="btn-add-item" onclick="openAddItemModal()"
@@ -45,9 +54,14 @@
                 </svg>
                 Strata (RW)
             </button>
-            <div class="text-sm text-gray-400 bg-white/5 px-4 py-2 rounded-full border border-white/10 backdrop-blur-md">
-                Status po┼é─ůczenia: <span class="text-emerald-400 font-semibold animate-pulse">ÔŚĆ ONLINE</span>
-            </div>
+            <a href="index.html"
+               class="flex items-center gap-2 text-sm text-gray-400 bg-white/5 px-4 py-2 rounded-full border border-white/10 backdrop-blur-md hover:bg-white/10 hover:text-white transition-all">
+                <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
+                          d="M3 12l2-2m0 0l7-7 7 7M5 10v10a1 1 0 001 1h3m10-11l2 2m-2-2v10a1 1 0 01-1 1h-3m-6 0a1 1 0 001-1v-4a1 1 0 011-1h2a1 1 0 011 1v4a1 1 0 001 1m-6 0h6"/>
+                </svg>
+                Warehouse Hub
+            </a>
         </div>
     </header>
 
@@ -114,6 +128,7 @@
     </div>
 
     <script src="../../core/js/api_client.js"></script>
+    <script src="js/warehouse_api.js"></script>
     <script src="../../core/js/core_validator.js"></script>
     <script src="js/warehouse_core.js"></script>
 
diff --git a/tests/test_runner.html b/tests/test_runner.html
index 6e506bc..cc4bd5b 100644
--- a/tests/test_runner.html
+++ b/tests/test_runner.html
@@ -165,6 +165,30 @@
         <div id="suite-7-tests" class="divide-y divide-white/4"></div>
     </div>
 
+    <!-- SUITE 8 -->
+    <div class="suite-card rounded-2xl overflow-hidden">
+        <div class="px-6 py-4 border-b border-white/5 flex items-center justify-between">
+            <div class="flex items-center gap-3">
+                <span class="text-xs font-black bg-indigo-500/20 text-indigo-400 border border-indigo-500/30 px-2 py-0.5 rounded-md">SUITE 8</span>
+                <span class="text-white font-bold text-sm">Warehouse V2 Pe┼ény ÔÇö MM / KOR / Batch RW / Docs / Approval</span>
+            </div>
+            <div id="suite-8-status" class="text-xs text-gray-600 font-mono">oczekuje</div>
+        </div>
+        <div id="suite-8-tests" class="divide-y divide-white/4"></div>
+    </div>
+
+    <!-- SUITE 9 -->
+    <div class="suite-card rounded-2xl overflow-hidden">
+        <div class="px-6 py-4 border-b border-white/5 flex items-center justify-between">
+            <div class="flex items-center gap-3">
+                <span class="text-xs font-black bg-red-500/20 text-red-400 border border-red-500/30 px-2 py-0.5 rounded-md">SUITE 9</span>
+                <span class="text-white font-bold text-sm">POS Engine ÔÇö Zam├│wienia, Koszyk, P┼éatno┼Ťci, Trasy</span>
+            </div>
+            <div id="suite-9-status" class="text-xs text-gray-600 font-mono">oczekuje</div>
+        </div>
+        <div id="suite-9-tests" class="divide-y divide-white/4"></div>
+    </div>
+
 </div>
 
 <!-- ÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉ
@@ -173,17 +197,58 @@
 <script>
 'use strict';
 
+// ÔöÇÔöÇÔöÇ Detekcja file:// ÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇ
+if (location.protocol === 'file:') {
+    document.body.innerHTML = `
+        <div style="display:flex;align-items:center;justify-content:center;height:100vh;margin:0;font-family:sans-serif;">
+            <div style="background:rgba(239,68,68,0.1);border:2px solid #ef4444;border-radius:16px;padding:40px 60px;text-align:center;max-width:600px;">
+                <h1 style="color:#ef4444;margin:0 0 16px;font-size:24px;">STOP ÔÇö Nie otwieraj tego pliku bezposrednio!</h1>
+                <p style="color:#fca5a5;font-size:14px;margin:0 0 12px;">Test Runner MUSI byc uruchomiony przez serwer Apache (XAMPP),<br>zeby PHP endpointy byly wykonywane.</p>
+                <p style="color:#94a3b8;font-size:13px;margin:0 0 20px;">Teraz otwierasz plik przez protokol <code style="background:#1e1e2e;padding:2px 6px;border-radius:4px;color:#f472b6;">file://</code> ÔÇö fetch zwraca surowy kod PHP zamiast odpowiedzi JSON.</p>
+                <div style="background:#0a0a1a;border-radius:12px;padding:16px;margin-top:12px;">
+                    <p style="color:#22c55e;font-size:12px;margin:0 0 8px;font-weight:bold;">Prawidlowy URL:</p>
+                    <a href="http://localhost/slicehub/tests/test_runner.html" style="color:#60a5fa;font-size:15px;font-weight:bold;text-decoration:none;word-break:break-all;">http://localhost/slicehub/tests/test_runner.html</a>
+                </div>
+            </div>
+        </div>`;
+    throw new Error('Test Runner requires HTTP server. Open via http://localhost/slicehub/tests/test_runner.html');
+}
+
+// ÔöÇÔöÇÔöÇ Fallback JWT (tenant_id=1, user_id=1, exp=2100, secret=dev_localhost_secret) ÔöÇ
+const TEST_JWT_TOKEN = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0ZW5hbnRfaWQiOjEsInVzZXJfaWQiOjEsImV4cCI6NDEwMjQ0NDgwMH0.dINyVm6UkUlnGVXVOan6u-4alBR-0_M_1bXUS1LImB4';
+
 // ÔöÇÔöÇÔöÇ Konfiguracja ÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇ
+const BASE_PATH = '/slicehub';
 const CFG = {
-    warehouse : '../api/api_warehouse.php',
-    studio    : '../api/backoffice/api_menu_studio.php',
+    loginEndpoint      : `${BASE_PATH}/api/auth/login.php`,
+    warehouseStock     : `${BASE_PATH}/api/warehouse/stock_list.php`,
+    warehouseAvco      : `${BASE_PATH}/api/warehouse/avco_dict.php`,
+    warehouseReceipt   : `${BASE_PATH}/api/warehouse/receipt.php`,
+    warehouseRw        : `${BASE_PATH}/api/warehouse/internal_rw.php`,
+    warehouseMapping   : `${BASE_PATH}/api/warehouse/mapping.php`,
+    warehouseInventory : `${BASE_PATH}/api/warehouse/inventory.php`,
+    warehouseTransfer  : `${BASE_PATH}/api/warehouse/transfer.php`,
+    warehouseCorrection: `${BASE_PATH}/api/warehouse/correction.php`,
+    warehouseBatchRw   : `${BASE_PATH}/api/warehouse/batch_rw.php`,
+    warehouseDocs      : `${BASE_PATH}/api/warehouse/documents_list.php`,
+    warehouseList      : `${BASE_PATH}/api/warehouse/warehouse_list.php`,
+    warehouseApprove   : `${BASE_PATH}/api/warehouse/approve.php`,
+    warehouseAddItem   : `${BASE_PATH}/api/warehouse/add_item.php`,
+    studio             : `${BASE_PATH}/api/backoffice/api_menu_studio.php`,
+    posEngine          : `${BASE_PATH}/api/pos/engine.php`,
     jsClients : {
-        studioCore   : '../modules/studio/js/studio_core.js',
-        studioRecipe : '../modules/studio/js/studio_recipe.js',
-        studioItem   : '../modules/studio/js/studio_item.js',
-        warehouseCore: '../modules/warehouse/js/warehouse_core.js',
+        studioCore   : `${BASE_PATH}/modules/studio/js/studio_core.js`,
+        studioRecipe : `${BASE_PATH}/modules/studio/js/studio_recipe.js`,
+        studioItem   : `${BASE_PATH}/modules/studio/js/studio_item.js`,
+        warehouseCore: `${BASE_PATH}/modules/warehouse/js/warehouse_core.js`,
+        warehouseApi : `${BASE_PATH}/modules/warehouse/js/warehouse_api.js`,
+        posApi       : `${BASE_PATH}/modules/pos/js/pos_api.js`,
+        posCart       : `${BASE_PATH}/modules/pos/js/pos_cart.js`,
+        posApp       : `${BASE_PATH}/modules/pos/js/pos_app.js`,
     },
-    authToken : 'mock_jwt_token_123',
+    authToken : '',
+    loginPin  : '1111',
+    tenantId  : 1,
     timeout   : 8000,
 };
 
@@ -193,6 +258,10 @@ let TOTAL_TESTS = 0;
 let DONE_TESTS  = 0;
 
 // ÔöÇÔöÇÔöÇ Render helpers ÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇ
+function escHtml(str) {
+    return String(str).replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(/"/g,'&quot;');
+}
+
 function renderTestRow(suiteId, testId, label, description) {
     const container = document.getElementById(`suite-${suiteId}-tests`);
     const row = document.createElement('div');
@@ -204,10 +273,10 @@ function renderTestRow(suiteId, testId, label, description) {
         </div>
         <div class="flex-1 min-w-0">
             <div class="flex items-center gap-2 flex-wrap">
-                <span class="text-[10px] font-black font-mono text-gray-600">${testId}</span>
-                <span id="label-${testId}" class="text-sm text-gray-300 font-medium">${label}</span>
+                <span class="text-[10px] font-black font-mono text-gray-600">${escHtml(testId)}</span>
+                <span id="label-${testId}" class="text-sm text-gray-300 font-medium">${escHtml(label)}</span>
             </div>
-            <div class="text-xs text-gray-600 mt-0.5">${description}</div>
+            <div class="text-xs text-gray-600 mt-0.5">${escHtml(description)}</div>
             <div id="detail-${testId}" class="hidden mt-2 text-xs font-mono bg-black/40 border border-white/5 rounded-lg px-3 py-2 text-gray-400 max-h-32 overflow-y-auto whitespace-pre-wrap break-all leading-relaxed"></div>
         </div>
         <div id="badge-${testId}" class="shrink-0 text-[10px] font-black uppercase tracking-wider px-2 py-0.5 rounded border font-mono">...</div>
@@ -221,7 +290,15 @@ function setResult(testId, status, detail = '') {
     const detEl  = document.getElementById(`detail-${testId}`);
     const label  = document.getElementById(`label-${testId}`);
 
-    const cfg = {
+    if (!icon || !badge) {
+        console.warn(`[setResult] DOM element missing for test "${testId}" ÔÇö skipping UI update`);
+        COUNTS[status] = (COUNTS[status] || 0) + 1;
+        DONE_TESTS++;
+        updateProgress();
+        return;
+    }
+
+    const styles = {
         pass : { icon: 'Ôťô', iconClass: 'text-emerald-400 text-sm font-black',
                  badgeClass: 'bg-emerald-950 border-emerald-600/50 text-emerald-400', text: 'PASS' },
         fail : { icon: 'ÔťŚ', iconClass: 'text-red-400 text-sm font-black',
@@ -230,13 +307,14 @@ function setResult(testId, status, detail = '') {
                  badgeClass: 'bg-yellow-950 border-yellow-600/50 text-yellow-400', text: 'WARN' },
         skip : { icon: 'ÔÇô', iconClass: 'text-gray-600 text-sm font-black',
                  badgeClass: 'bg-gray-900 border-gray-700 text-gray-600', text: 'SKIP' },
-    }[status] || cfg.skip;
+    };
+    const cfg = styles[status] || styles.skip;
 
     icon.innerHTML  = `<span class="${cfg.iconClass}">${cfg.icon}</span>`;
     badge.className = `shrink-0 text-[10px] font-black uppercase tracking-wider px-2 py-0.5 rounded border font-mono ${cfg.badgeClass}`;
     badge.textContent = cfg.text;
 
-    if (detail) {
+    if (detail && detEl) {
         detEl.textContent = detail;
         detEl.classList.remove('hidden');
         if (status === 'fail') detEl.classList.add('border-red-900/50', 'text-red-300');
@@ -273,16 +351,54 @@ function setSuiteStatus(suiteId) {
 }
 
 // ÔöÇÔöÇÔöÇ Fetch helpers ÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇ
-async function callWarehouse(params = {}, method = 'GET') {
-    const url = method === 'GET'
-        ? `${CFG.warehouse}?${new URLSearchParams(params)}`
-        : CFG.warehouse;
-    const opts = { method, headers: { 'Content-Type': 'application/json' } };
-    if (method === 'POST') opts.body = JSON.stringify(params);
+/**
+ * Wywołanie endpointu magazynu V2 (osobne skrypty zamiast action= w jednym pliku).
+ * @param {string} url ÔÇö np. CFG.warehouseStock
+ * @param {{ method?: string, query?: Record<string,string>, body?: object }} opt
+ */
+function _authHeaders() {
+    const h = { 'Content-Type': 'application/json' };
+    if (CFG.authToken) h['Authorization'] = `Bearer ${CFG.authToken}`;
+    return h;
+}
+
+async function warehouseRequest(url, opt = {}) {
+    const method = opt.method || 'GET';
+    const fullUrl = method === 'GET' && opt.query
+        ? `${url}?${new URLSearchParams(opt.query)}`
+        : url;
     const ctrl = new AbortController();
     const timer = setTimeout(() => ctrl.abort(), CFG.timeout);
+    const opts = {
+        method,
+        headers: _authHeaders(),
+        credentials: 'same-origin',
+        signal: ctrl.signal,
+    };
+    if (method === 'POST' && opt.body !== undefined) {
+        opts.body = JSON.stringify(opt.body);
+    }
     try {
-        const r = await fetch(url, { ...opts, signal: ctrl.signal });
+        const r = await fetch(fullUrl, opts);
+        clearTimeout(timer);
+        return { httpStatus: r.status, contentType: r.headers.get('content-type') || '', body: await r.text() };
+    } catch (e) {
+        clearTimeout(timer);
+        return { error: e.message };
+    }
+}
+
+async function callPosEngine(payload = {}) {
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), CFG.timeout);
+    try {
+        const r = await fetch(CFG.posEngine, {
+            method: 'POST',
+            headers: _authHeaders(),
+            body: JSON.stringify(payload),
+            credentials: 'same-origin',
+            signal: ctrl.signal
+        });
         clearTimeout(timer);
         return { httpStatus: r.status, contentType: r.headers.get('content-type') || '', body: await r.text() };
     } catch (e) { clearTimeout(timer); return { error: e.message }; }
@@ -294,8 +410,9 @@ async function callStudio(payload = {}) {
     try {
         const r = await fetch(CFG.studio, {
             method: 'POST',
-            headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${CFG.authToken}` },
+            headers: _authHeaders(),
             body: JSON.stringify(payload),
+            credentials: 'same-origin',
             signal: ctrl.signal
         });
         clearTimeout(timer);
@@ -326,9 +443,9 @@ const SUITES = [
         tests: [
             {
                 id: 'T01', label: 'API Warehouse ÔÇö HTTP 200',
-                desc: 'GET /api/api_warehouse.php?action=GET_STOCK zwraca status HTTP 200',
+                desc: 'GET /api/warehouse/stock_list.php?warehouse_id=MAIN zwraca status HTTP 200',
                 async run() {
-                    const r = await callWarehouse({ action: 'GET_STOCK' });
+                    const r = await warehouseRequest(CFG.warehouseStock, { query: { warehouse_id: 'MAIN' } });
                     if (r.error) return ['fail', `B┼é─ůd po┼é─ůczenia: ${r.error}`];
                     if (r.httpStatus !== 200) return ['fail', `HTTP ${r.httpStatus} ÔÇö oczekiwano 200`];
                     return ['pass', `HTTP ${r.httpStatus} OK`];
@@ -348,7 +465,7 @@ const SUITES = [
                 id: 'T03', label: 'Content-Type: application/json (Warehouse)',
                 desc: 'Nagłówek odpowiedzi zawiera charset UTF-8 i typ JSON',
                 async run() {
-                    const r = await callWarehouse({ action: 'GET_STOCK' });
+                    const r = await warehouseRequest(CFG.warehouseStock, { query: { warehouse_id: 'MAIN' } });
                     if (r.error) return ['skip', 'Endpoint niedost─Öpny'];
                     const ok = r.contentType.includes('application/json');
                     if (!ok) return ['fail', `Content-Type: "${r.contentType}"\nOczekiwano: application/json`];
@@ -370,7 +487,7 @@ const SUITES = [
                 id: 'T05', label: 'Brak HTML Leakage ÔÇö Warehouse',
                 desc: 'Odpowied┼║ nie zawiera znacznik├│w HTML przed JSON-em (ryzyko Fatal error, Notice)',
                 async run() {
-                    const r = await callWarehouse({ action: 'GET_STOCK' });
+                    const r = await warehouseRequest(CFG.warehouseStock, { query: { warehouse_id: 'MAIN' } });
                     if (r.error) return ['skip', 'Endpoint niedost─Öpny'];
                     const body = r.body.trim();
                     if (body.startsWith('<') || body.includes('Fatal error') || body.includes('Notice:')) {
@@ -402,69 +519,82 @@ const SUITES = [
         id: 2,
         tests: [
             {
-                id: 'T07', label: 'GET_STOCK ÔÇö zwraca tablic─Ö surowc├│w',
-                desc: 'GET ?action=GET_STOCK Ôćĺ status:"success", payload:[...] (LEFT JOIN sys_items + wh_stock)',
+                id: 'T07', label: 'stock_list ÔÇö zwraca tablic─Ö surowc├│w',
+                desc: 'GET stock_list.php Ôćĺ success:true, data:[...] (sys_items + wh_stock)',
                 async run() {
-                    const r = await callWarehouse({ action: 'GET_STOCK' });
+                    const r = await warehouseRequest(CFG.warehouseStock, { query: { warehouse_id: 'MAIN' } });
                     if (r.error) return ['fail', r.error];
                     const json = tryParse(r.body);
                     if (!json) return ['fail', `Nieparsowalny JSON:\n${r.body.substring(0,200)}`];
-                    if (json.status !== 'success') return ['fail', `status="${json.status}" msg: ${json.message}`];
-                    if (!Array.isArray(json.payload)) return ['fail', `payload powinien by─ç tablic─ů, got: ${typeof json.payload}`];
-                    const item = json.payload[0];
+                    if (json.success !== true) return ['fail', `success=${json.success} msg: ${json.message}`];
+                    if (!Array.isArray(json.data)) return ['fail', `data powinien by─ç tablic─ů, got: ${typeof json.data}`];
+                    const item = json.data[0];
                     if (item && !('sku' in item)) return ['warn', 'Pierwszy rekord nie ma pola "sku" ÔÇö sprawd┼║ schemat sys_items'];
-                    return ['pass', `Zwrócono ${json.payload.length} surowców. Przykład SKU: ${item?.sku || 'brak rekordów'}`];
+                    return ['pass', `Zwrócono ${json.data.length} surowców. Przykład SKU: ${item?.sku || 'brak rekordów'}`];
                 }
             },
             {
-                id: 'T08', label: 'GET_AVCO_DICT ÔÇö zwraca s┼éownik SKUÔćĺcena',
-                desc: 'GET ?action=GET_AVCO_DICT Ôćĺ status:"success", payload:{sku:price,...}',
+                id: 'T08', label: 'avco_dict ÔÇö zwraca s┼éownik SKUÔćĺcena',
+                desc: 'GET avco_dict.php Ôćĺ success:true, data:{sku:price,...}',
                 async run() {
-                    const r = await callWarehouse({ action: 'GET_AVCO_DICT' });
+                    const r = await warehouseRequest(CFG.warehouseAvco, { query: { warehouse_id: 'MAIN' } });
                     if (r.error) return ['fail', r.error];
                     const json = tryParse(r.body);
                     if (!json) return ['fail', `Nieparsowalny JSON:\n${r.body.substring(0,200)}`];
-                    if (json.status !== 'success') return ['fail', `status="${json.status}" msg: ${json.message}`];
-                    if (typeof json.payload !== 'object' || Array.isArray(json.payload))
-                        return ['fail', `payload powinien by─ç obiektem {sku:price}`];
-                    const keys = Object.keys(json.payload);
+                    if (json.success !== true) return ['fail', `success=${json.success} msg: ${json.message}`];
+                    if (typeof json.data !== 'object' || json.data === null || Array.isArray(json.data))
+                        return ['fail', `data powinien by─ç obiektem {sku:price}`];
+                    const keys = Object.keys(json.data);
                     return ['pass', `Słownik AVCO: ${keys.length} wpisów. ${keys.slice(0,3).join(', ')}${keys.length>3?'...':''}`];
                 }
             },
             {
-                id: 'T09', label: 'PROCESS_PZ ÔÇö walidacja (brak items)',
-                desc: 'POST action=PROCESS_PZ bez items Ôćĺ status:"error" + czytelny komunikat',
+                id: 'T09', label: 'receipt.php ÔÇö walidacja (brak linii PZ)',
+                desc: 'POST receipt bez linii Ôćĺ success:false + komunikat (400)',
                 async run() {
-                    const r = await callWarehouse({ action: 'PROCESS_PZ', notes: 'test' }, 'POST');
+                    const r = await warehouseRequest(CFG.warehouseReceipt, {
+                        method: 'POST',
+                        body: {
+                            tenant_id: 1,
+                            warehouse_id: 'MAIN',
+                            supplier_name: 'test',
+                            supplier_invoice: 'T09',
+                            lines: [],
+                        },
+                    });
                     if (r.error) return ['fail', r.error];
                     const json = tryParse(r.body);
                     if (!json) return ['fail', `Nieparsowalny JSON:\n${r.body.substring(0,200)}`];
-                    if (json.status !== 'error') return ['fail', `Oczekiwano status:"error", got "${json.status}"`];
+                    if (json.success !== false) return ['fail', `Oczekiwano success:false, got "${json.success}"`];
                     return ['pass', `Poprawny b┼é─ůd walidacji: "${json.message}"`];
                 }
             },
             {
-                id: 'T10', label: 'PROCESS_RW ÔÇö walidacja (brak sku)',
-                desc: 'POST action=PROCESS_RW bez pola sku Ôćĺ status:"error"',
+                id: 'T10', label: 'internal_rw ÔÇö walidacja (brak sku)',
+                desc: 'POST internal_rw bez pola sku Ôćĺ success:false',
                 async run() {
-                    const r = await callWarehouse({ action: 'PROCESS_RW', qty: 1 }, 'POST');
+                    const r = await warehouseRequest(CFG.warehouseRw, {
+                        method: 'POST',
+                        body: { tenant_id: 1, warehouse_id: 'MAIN', reason: 'test', lines: [{ quantity: 1 }] },
+                    });
                     if (r.error) return ['fail', r.error];
                     const json = tryParse(r.body);
                     if (!json) return ['fail', `Nieparsowalny JSON:\n${r.body.substring(0,200)}`];
-                    if (json.status !== 'error') return ['fail', `Oczekiwano status:"error", got "${json.status}"`];
+                    if (json.success !== false) return ['fail', `Oczekiwano success:false, got "${json.success}"`];
                     return ['pass', `Poprawny b┼é─ůd walidacji: "${json.message}"`];
                 }
             },
             {
-                id: 'T11', label: 'Nieznana akcja Warehouse Ôćĺ error',
-                desc: 'GET ?action=FOOBAR Ôćĺ zwraca error zamiast pustej odpowiedzi',
+                id: 'T11', label: 'stock_list ÔÇö tylko GET (POST Ôćĺ 405)',
+                desc: 'POST na endpoint tylko-GET zwraca JSON błędu zamiast HTML',
                 async run() {
-                    const r = await callWarehouse({ action: 'FOOBAR_NIEZNANA' });
+                    const r = await warehouseRequest(CFG.warehouseStock, { method: 'POST', body: {} });
                     if (r.error) return ['fail', r.error];
                     const json = tryParse(r.body);
                     if (!json) return ['fail', `Nieparsowalny JSON:\n${r.body.substring(0,200)}`];
-                    if (json.status === 'success') return ['fail', 'Nieznana akcja nie powinna zwraca─ç success!'];
-                    return ['pass', `Bezpieczna odpowied┼║ na nieznane akcje: "${json.message}"`];
+                    if (r.httpStatus !== 405) return ['warn', `Oczekiwano HTTP 405, got ${r.httpStatus}`];
+                    if (json.success === true) return ['fail', 'POST na stock_list nie powinien zwraca─ç success'];
+                    return ['pass', `405 + JSON: "${json.message}"`];
                 }
             },
         ]
@@ -580,18 +710,16 @@ const SUITES = [
         id: 4,
         tests: [
             {
-                id: 'T19', label: 'Warehouse API ÔÇö format {status, message, payload}',
-                desc: 'api_warehouse.php zachowuje stary format. warehouse_core.js jest z nim sp├│jny.',
+                id: 'T19', label: 'Warehouse API ÔÇö format {success, message, data}',
+                desc: 'Endpointy api/warehouse/*.php zwracaj─ů V2; warehouse_core.js u┼╝ywa result.success.',
                 async run() {
-                    const r = await callWarehouse({ action: 'GET_STOCK' });
+                    const r = await warehouseRequest(CFG.warehouseStock, { query: { warehouse_id: 'MAIN' } });
                     if (r.error) return ['skip', 'Endpoint niedost─Öpny'];
                     const json = tryParse(r.body);
                     if (!json) return ['fail', 'Nieparsowalny JSON'];
-                    const hasOldFormat = 'status' in json && 'payload' in json && 'message' in json;
-                    const hasNewFormat = 'success' in json;
-                    if (hasNewFormat && !hasOldFormat) return ['warn', 'Warehouse zwraca NOWY format, ale warehouse_core.js czyta STARY. Niesp├│jno┼Ť─ç!'];
-                    if (!hasOldFormat) return ['fail', `Brak p├│l {status,payload,message}. Got keys: ${Object.keys(json).join(', ')}`];
-                    return ['pass', `Format OK: {status:"${json.status}", payload:[...], message:"..."}. Sp├│jny z warehouse_core.js.`];
+                    const hasNew = 'success' in json && 'data' in json && 'message' in json;
+                    if (!hasNew) return ['fail', `Brak p├│l {success,data,message}. Got keys: ${Object.keys(json).join(', ')}`];
+                    return ['pass', `Format V2 OK: success=${json.success}, data=array lub obiekt.`];
                 }
             },
             {
@@ -630,8 +758,8 @@ const SUITES = [
                 desc: 'Odpowiedzi API musz─ů by─ç parsowalne przez JSON.parse() bez wyj─ůtk├│w',
                 async run() {
                     const calls = [
-                        callWarehouse({ action: 'GET_STOCK' }),
-                        callWarehouse({ action: 'GET_AVCO_DICT' }),
+                        warehouseRequest(CFG.warehouseStock, { query: { warehouse_id: 'MAIN' } }),
+                        warehouseRequest(CFG.warehouseAvco, { query: { warehouse_id: 'MAIN' } }),
                         callStudio({ action: 'get_menu_tree' }),
                         callStudio({ action: 'get_recipes_init' }),
                     ];
@@ -707,16 +835,20 @@ const SUITES = [
                 }
             },
             {
-                id: 'T27', label: 'warehouse_core.js ÔÇö sp├│jny z api_warehouse.php (stary format)',
-                desc: 'warehouse_core.js musi u┼╝ywa─ç result.status ÔÇö sp├│jne z api_warehouse.php kt├│ry zwraca stary format',
+                id: 'T27', label: 'warehouse_core.js ÔÇö V2 + api/warehouse',
+                desc: 'Kod u┼╝ywa result.success oraz WarehouseApi (lub bezpo┼Ťrednich ┼Ťcie┼╝ek api/warehouse/*.php).',
                 async run() {
                     const src = await fetchJs(CFG.jsClients.warehouseCore);
                     if (!src) return ['fail', 'Nie udało się pobrać warehouse_core.js'];
-                    const usesOldStatus = /result\.status\s*===\s*['"]success['"]/.test(src);
                     const usesNewSuccess = /result\.success/.test(src);
-                    if (!usesOldStatus && usesNewSuccess) return ['warn', 'warehouse_core.js u┼╝ywa result.success, ale api_warehouse.php zwraca stary format {status}. Niesp├│jno┼Ť─ç!'];
-                    if (!usesOldStatus) return ['warn', 'Brak result.status w warehouse_core.js ÔÇö sprawd┼║ logik─Ö obs┼éugi odpowiedzi'];
-                    return ['pass', 'warehouse_core.js sp├│jny z api_warehouse.php (oba u┼╝ywaj─ů starszego formatu {status,payload})'];
+                    const usesWarehouseV2 = /api\/warehouse\/(stock_list|receipt|internal_rw|add_item)\.php/.test(src);
+                    const usesApiLayer = /WarehouseApi\.(stockList|postReceipt|postInternalRw|getWarehouseList)/.test(src);
+                    const usesLegacy = /api_warehouse\.php/.test(src);
+                    if (usesLegacy) return ['fail', 'ZNALEZIONO api_warehouse.php ÔÇö u┼╝yj endpoint├│w api/warehouse/*.php'];
+                    if (!usesNewSuccess) return ['fail', 'Brak result.success ÔÇö ApiClient V2 wymaga tego pola'];
+                    if (usesApiLayer) return ['pass', `warehouse_core.js deleguje do WarehouseApi (abstrakcja URL) + u┼╝ywa result.success`];
+                    if (!usesWarehouseV2) return ['warn', 'Brak jawnych ┼Ťcie┼╝ek api/warehouse/*.php ÔÇö sprawd┼║ URL-e'];
+                    return ['pass', 'warehouse_core.js zgodny z silnikiem V2 (result.success + api/warehouse)'];
                 }
             },
         ]
@@ -733,16 +865,16 @@ const SUITES = [
                 desc: 'sys_items musi by─ç dost─Öpna z obu API. SKU z Warehouse powinno istnie─ç w Studio',
                 async run() {
                     const [rW, rS] = await Promise.all([
-                        callWarehouse({ action: 'GET_STOCK' }),
+                        warehouseRequest(CFG.warehouseStock, { query: { warehouse_id: 'MAIN' } }),
                         callStudio({ action: 'get_recipes_init' })
                     ]);
                     if (rW.error || rS.error) return ['fail', 'Jeden z endpoint├│w niedost─Öpny'];
                     const jW = tryParse(rW.body);
                     const jS = tryParse(rS.body);
                     if (!jW || !jS) return ['fail', 'B┼é─ůd parsowania JSON'];
-                    if (jW.status !== 'success') return ['skip', `Warehouse error: ${jW.message}`];
+                    if (jW.success !== true) return ['skip', `Warehouse error: ${jW.message}`];
                     if (jS.success !== true) return ['skip', `Studio error: ${jS.message}`];
-                    const warehouseSkus = new Set((jW.payload || []).map(i => i.sku));
+                    const warehouseSkus = new Set((jW.data || []).map(i => i.sku));
                     const studioSkus   = new Set((jS.data?.products || []).map(p => p.sku));
                     if (warehouseSkus.size === 0 && studioSkus.size === 0) 
                         return ['warn', 'Oba API zwracaj─ů 0 surowc├│w ÔÇö baza mo┼╝e by─ç pusta. Sprawd┼║ sys_items.'];
@@ -772,16 +904,16 @@ const SUITES = [
                 desc: 'Studio mo┼╝e pobiera─ç AVCO z Warehouse, aby liczy─ç koszt receptury (food cost calculation)',
                 async run() {
                     const [rAvco, rRecipes] = await Promise.all([
-                        callWarehouse({ action: 'GET_AVCO_DICT' }),
+                        warehouseRequest(CFG.warehouseAvco, { query: { warehouse_id: 'MAIN' } }),
                         callStudio({ action: 'get_recipes_init' })
                     ]);
                     if (rAvco.error || rRecipes.error) return ['fail', 'Endpoint niedost─Öpny'];
                     const jA = tryParse(rAvco.body);
                     const jR = tryParse(rRecipes.body);
                     if (!jA || !jR) return ['fail', 'B┼é─ůd JSON'];
-                    if (jA.status !== 'success') return ['skip', `Warehouse: ${jA.message}`];
+                    if (jA.success !== true) return ['skip', `Warehouse: ${jA.message}`];
                     if (jR.success !== true) return ['skip', `Studio: ${jR.message}`];
-                    const avcoSkus    = Object.keys(jA.payload || {});
+                    const avcoSkus    = Object.keys(jA.data || {});
                     const studioSkus  = (jR.data?.products || []).map(p => p.sku);
                     const priceable   = studioSkus.filter(s => avcoSkus.includes(s));
                     if (avcoSkus.length === 0) return ['warn', 'AVCO Dict pusty ÔÇö brak przyj─Ö─ç PZ. Kalkulator food cost b─Ödzie zwraca┼é 0.'];
@@ -790,9 +922,9 @@ const SUITES = [
             },
             {
                 id: 'T31', label: 'Niezale┼╝no┼Ť─ç modu┼é├│w ÔÇö Warehouse dzia┼éa bez Studio',
-                desc: 'api_warehouse.php nie wymaga api_menu_studio.php. Modu┼éy s─ů lu┼║no powi─ůzane przez REST.',
+                desc: 'stock_list.php nie wymaga api_menu_studio.php. Modu┼éy s─ů lu┼║no powi─ůzane przez REST.',
                 async run() {
-                    const r = await callWarehouse({ action: 'GET_STOCK' });
+                    const r = await warehouseRequest(CFG.warehouseStock, { query: { warehouse_id: 'MAIN' } });
                     if (r.error) return ['fail', `Warehouse niedost─Öpny: ${r.error}`];
                     const json = tryParse(r.body);
                     if (!json) return ['fail', 'Nieparsowalny JSON'];
@@ -813,7 +945,7 @@ const SUITES = [
         tests: [
             {
                 id: 'T32', label: 'Studio ÔÇö brak tokena Ôćĺ odmowa dost─Öpu',
-                desc: 'POST bez nag┼é├│wka Authorization Ôćĺ success:false + komunikat o braku tokena',
+                desc: 'POST bez nag┼é├│wka Authorization i bez session cookie Ôćĺ success:false + komunikat o braku tokena',
                 async run() {
                     const ctrl = new AbortController();
                     const timer = setTimeout(() => ctrl.abort(), CFG.timeout);
@@ -823,6 +955,7 @@ const SUITES = [
                             method: 'POST',
                             headers: { 'Content-Type': 'application/json' },
                             body: JSON.stringify({ action: 'get_menu_tree' }),
+                            credentials: 'omit',
                             signal: ctrl.signal
                         });
                         clearTimeout(timer);
@@ -846,6 +979,7 @@ const SUITES = [
                             method: 'POST',
                             headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer FAKE_TOKEN_XYZ' },
                             body: JSON.stringify({ action: 'get_menu_tree' }),
+                            credentials: 'omit',
                             signal: ctrl.signal
                         });
                         clearTimeout(timer);
@@ -881,10 +1015,9 @@ const SUITES = [
                 id: 'T35', label: 'XSS w action ÔÇö escape HTML w komunikacie b┼é─Ödu',
                 desc: 'Nieznana akcja zawieraj─ůca <script> nie mo┼╝e zosta─ç odbita bez escapowania',
                 async run() {
-                    const xssAction = '<script>alert(1)</script>';
+                    const xssAction = '<script>alert(1)</' + 'script>';
                     const r = await callStudio({ action: xssAction });
                     if (r.error) return ['fail', r.error];
-                    // Sprawdzamy czy w JSON response nie ma surowego <script>
                     const rawScript = /<script>alert/.test(r.body);
                     if (rawScript) return ['fail', 'Niebezpieczne: odpowied┼║ zawiera niescapowany <script> tag!'];
                     return ['pass', `XSS zablokowany przez sanityzacj─Ö action ÔÇö znaki specjalne usuni─Öte przez preg_replace`];
@@ -892,6 +1025,429 @@ const SUITES = [
             },
         ]
     },
+
+    // ÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉ
+    // SUITE 8: Warehouse V2 Pe┼ény ÔÇö MM / KOR / Batch RW / Docs / Approval
+    // ÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉ
+    {
+        id: 8,
+        tests: [
+            {
+                id: 'T36', label: 'warehouse_list.php ÔÇö HTTP 200 + dane',
+                desc: 'GET warehouse_list.php Ôćĺ success:true, data:[{warehouse_id, item_count, total_value}]',
+                async run() {
+                    const r = await warehouseRequest(CFG.warehouseList);
+                    if (r.error) return ['fail', r.error];
+                    if (r.httpStatus !== 200) return ['fail', `HTTP ${r.httpStatus}`];
+                    const json = tryParse(r.body);
+                    if (!json) return ['fail', 'Nieparsowalny JSON'];
+                    if (json.success !== true) return ['fail', `success=${json.success}: ${json.message}`];
+                    if (!Array.isArray(json.data)) return ['fail', 'data nie jest tablic─ů'];
+                    const wh = json.data[0];
+                    if (!wh || !wh.warehouse_id) return ['warn', 'Brak magazyn├│w ÔÇö sprawd┼║ wh_stock'];
+                    return ['pass', `Znaleziono ${json.data.length} magazyn(ów). Pierwszy: ${wh.warehouse_id} (${wh.item_count} SKU, ${wh.total_value} zł)`];
+                }
+            },
+            {
+                id: 'T37', label: 'mapping.php GET ÔÇö lista mapowa┼ä',
+                desc: 'GET mapping.php Ôćĺ success:true, data:{mappings, items}',
+                async run() {
+                    const r = await warehouseRequest(CFG.warehouseMapping);
+                    if (r.error) return ['fail', r.error];
+                    const json = tryParse(r.body);
+                    if (!json) return ['fail', 'Nieparsowalny JSON'];
+                    if (json.success !== true) return ['fail', `success=${json.success}: ${json.message}`];
+                    if (!json.data || !('mappings' in json.data)) return ['fail', 'Brak klucza data.mappings'];
+                    if (!('items' in json.data)) return ['fail', 'Brak klucza data.items'];
+                    return ['pass', `Mapowania: ${json.data.mappings.length}, Items: ${json.data.items.length}`];
+                }
+            },
+            {
+                id: 'T38', label: 'mapping.php POST ÔÇö walidacja (brak p├│l)',
+                desc: 'POST mapping.php z pustym body Ôćĺ success:false',
+                async run() {
+                    const r = await warehouseRequest(CFG.warehouseMapping, { method: 'POST', body: {} });
+                    if (r.error) return ['fail', r.error];
+                    const json = tryParse(r.body);
+                    if (!json) return ['fail', 'Nieparsowalny JSON'];
+                    if (json.success !== false) return ['fail', `Oczekiwano success:false, got ${json.success}`];
+                    return ['pass', `Walidacja OK: "${json.message}"`];
+                }
+            },
+            {
+                id: 'T39', label: 'transfer.php ÔÇö walidacja (ten sam magazyn)',
+                desc: 'POST transfer z source=target Ôćĺ success:false (MmEngine blokuje)',
+                async run() {
+                    const r = await warehouseRequest(CFG.warehouseTransfer, {
+                        method: 'POST',
+                        body: { tenant_id: 1, source_warehouse_id: 'MAIN', target_warehouse_id: 'MAIN', lines: [{ sku: 'TEST', quantity: 1 }] },
+                    });
+                    if (r.error) return ['fail', r.error];
+                    const json = tryParse(r.body);
+                    if (!json) return ['fail', 'Nieparsowalny JSON'];
+                    if (json.success !== false) return ['fail', `Oczekiwano success:false, got ${json.success}`];
+                    return ['pass', `Walidacja: "${json.message}"`];
+                }
+            },
+            {
+                id: 'T40', label: 'transfer.php ÔÇö walidacja (puste linie)',
+                desc: 'POST transfer z lines:[] Ôćĺ success:false',
+                async run() {
+                    const r = await warehouseRequest(CFG.warehouseTransfer, {
+                        method: 'POST',
+                        body: { tenant_id: 1, source_warehouse_id: 'MAIN', target_warehouse_id: 'BAR', lines: [] },
+                    });
+                    if (r.error) return ['fail', r.error];
+                    const json = tryParse(r.body);
+                    if (!json) return ['fail', 'Nieparsowalny JSON'];
+                    if (json.success !== false) return ['fail', `Oczekiwano success:false, got ${json.success}`];
+                    return ['pass', `Walidacja: "${json.message}"`];
+                }
+            },
+            {
+                id: 'T41', label: 'correction.php ÔÇö walidacja (brak order_id)',
+                desc: 'POST correction bez order_id Ôćĺ success:false',
+                async run() {
+                    const r = await warehouseRequest(CFG.warehouseCorrection, {
+                        method: 'POST',
+                        body: { tenant_id: 1, reason: 'test' },
+                    });
+                    if (r.error) return ['fail', r.error];
+                    const json = tryParse(r.body);
+                    if (!json) return ['fail', 'Nieparsowalny JSON'];
+                    if (json.success !== false) return ['fail', `Oczekiwano success:false, got ${json.success}`];
+                    return ['pass', `Walidacja: "${json.message}"`];
+                }
+            },
+            {
+                id: 'T42', label: 'batch_rw.php ÔÇö walidacja (brak linii)',
+                desc: 'POST batch_rw z lines:[] Ôćĺ success:false',
+                async run() {
+                    const r = await warehouseRequest(CFG.warehouseBatchRw, {
+                        method: 'POST',
+                        body: { tenant_id: 1, warehouse_id: 'MAIN', reason: 'test', lines: [] },
+                    });
+                    if (r.error) return ['fail', r.error];
+                    const json = tryParse(r.body);
+                    if (!json) return ['fail', 'Nieparsowalny JSON'];
+                    if (json.success !== false) return ['fail', `Oczekiwano success:false, got ${json.success}`];
+                    return ['pass', `Walidacja: "${json.message}"`];
+                }
+            },
+            {
+                id: 'T43', label: 'documents_list.php ÔÇö HTTP 200 + paginacja',
+                desc: 'GET documents_list.php Ôćĺ success:true, data:{documents, total, limit, offset}',
+                async run() {
+                    const r = await warehouseRequest(CFG.warehouseDocs, { query: { limit: '5', offset: '0' } });
+                    if (r.error) return ['fail', r.error];
+                    if (r.httpStatus !== 200) return ['fail', `HTTP ${r.httpStatus}`];
+                    const json = tryParse(r.body);
+                    if (!json) return ['fail', 'Nieparsowalny JSON'];
+                    if (json.success !== true) return ['fail', `success=${json.success}: ${json.message}`];
+                    if (!json.data || !('documents' in json.data)) return ['fail', 'Brak data.documents'];
+                    if (!('total' in json.data)) return ['fail', 'Brak data.total ÔÇö paginacja niekompletna'];
+                    return ['pass', `Dokumenty: ${json.data.documents.length} z ${json.data.total}. Limit=${json.data.limit}, offset=${json.data.offset}`];
+                }
+            },
+            {
+                id: 'T44', label: 'documents_list.php ÔÇö filtr type=PZ',
+                desc: 'GET documents_list.php?type=PZ Ôćĺ tylko dokumenty PZ',
+                async run() {
+                    const r = await warehouseRequest(CFG.warehouseDocs, { query: { type: 'PZ', limit: '50' } });
+                    if (r.error) return ['fail', r.error];
+                    const json = tryParse(r.body);
+                    if (!json || json.success !== true) return ['skip', json?.message || 'Endpoint niedost─Öpny'];
+                    const docs = json.data?.documents || [];
+                    const nonPz = docs.filter(d => d.type !== 'PZ');
+                    if (nonPz.length > 0) return ['fail', `Filtr type=PZ zwrócił ${nonPz.length} nie-PZ dokumentów`];
+                    return ['pass', `${docs.length} dokument├│w PZ (zero obcych typ├│w)`];
+                }
+            },
+            {
+                id: 'T45', label: 'approve.php ÔÇö walidacja (brak document_id)',
+                desc: 'POST approve bez document_id Ôćĺ success:false',
+                async run() {
+                    const r = await warehouseRequest(CFG.warehouseApprove, {
+                        method: 'POST',
+                        body: { tenant_id: 1, decision: 'approve' },
+                    });
+                    if (r.error) return ['fail', r.error];
+                    const json = tryParse(r.body);
+                    if (!json) return ['fail', 'Nieparsowalny JSON'];
+                    if (json.success !== false) return ['fail', `Oczekiwano success:false, got ${json.success}`];
+                    return ['pass', `Walidacja: "${json.message}"`];
+                }
+            },
+            {
+                id: 'T46', label: 'approve.php ÔÇö walidacja (brak decision)',
+                desc: 'POST approve bez decision Ôćĺ success:false',
+                async run() {
+                    const r = await warehouseRequest(CFG.warehouseApprove, {
+                        method: 'POST',
+                        body: { tenant_id: 1, document_id: 999999 },
+                    });
+                    if (r.error) return ['fail', r.error];
+                    const json = tryParse(r.body);
+                    if (!json) return ['fail', 'Nieparsowalny JSON'];
+                    if (json.success !== false) return ['fail', `Oczekiwano success:false, got ${json.success}`];
+                    return ['pass', `Walidacja: "${json.message}"`];
+                }
+            },
+            {
+                id: 'T47', label: 'inventory.php ÔÇö walidacja (puste linie)',
+                desc: 'POST inventory z lines:[] Ôćĺ success:false',
+                async run() {
+                    const r = await warehouseRequest(CFG.warehouseInventory, {
+                        method: 'POST',
+                        body: { tenant_id: 1, warehouse_id: 'MAIN', lines: [] },
+                    });
+                    if (r.error) return ['fail', r.error];
+                    const json = tryParse(r.body);
+                    if (!json) return ['fail', 'Nieparsowalny JSON'];
+                    if (json.success !== false) return ['fail', `Oczekiwano success:false, got ${json.success}`];
+                    return ['pass', `Walidacja: "${json.message}"`];
+                }
+            },
+            {
+                id: 'T48', label: 'warehouse_api.js ÔÇö eksport nowych metod',
+                desc: 'WarehouseApi musi eksportowa─ç getWarehouseList, postBatchRw, getDocumentsList, postApproval',
+                async run() {
+                    const src = await fetchJs(CFG.jsClients.warehouseApi);
+                    if (!src) return ['fail', 'Nie udało się pobrać warehouse_api.js'];
+                    const methods = ['getWarehouseList', 'postBatchRw', 'getDocumentsList', 'postApproval', 'postTransfer', 'postCorrection'];
+                    const missing = methods.filter(m => !src.includes(m));
+                    if (missing.length > 0) return ['fail', `Brakuje metod: ${missing.join(', ')}`];
+                    return ['pass', `warehouse_api.js eksportuje wszystkie ${methods.length} nowych metod`];
+                }
+            },
+            {
+                id: 'T49', label: 'Nowe endpointy ÔÇö format V2 (batch)',
+                desc: 'warehouse_list, documents_list, mapping Ôćĺ wszystkie {success, message, data}',
+                async run() {
+                    const calls = [
+                        warehouseRequest(CFG.warehouseList),
+                        warehouseRequest(CFG.warehouseDocs, { query: { limit: '1' } }),
+                        warehouseRequest(CFG.warehouseMapping),
+                    ];
+                    const results = await Promise.all(calls);
+                    const names = ['warehouse_list', 'documents_list', 'mapping'];
+                    const errors = [];
+                    results.forEach((r, i) => {
+                        if (r.error) { errors.push(`${names[i]}: ${r.error}`); return; }
+                        const j = tryParse(r.body);
+                        if (!j) { errors.push(`${names[i]}: nieparsowalny JSON`); return; }
+                        if (!('success' in j) || !('message' in j) || !('data' in j)) {
+                            errors.push(`${names[i]}: brak {success,message,data}. Got: ${Object.keys(j).join(',')}`);
+                        }
+                    });
+                    if (errors.length > 0) return ['fail', errors.join('\n')];
+                    return ['pass', 'Wszystkie 3 nowe endpointy GET zwracaj─ů format V2'];
+                }
+            },
+            {
+                id: 'T50', label: 'POST na GET-only endpointy Ôćĺ 405',
+                desc: 'POST na warehouse_list, documents_list Ôćĺ JSON 405',
+                async run() {
+                    const calls = [
+                        warehouseRequest(CFG.warehouseList, { method: 'POST', body: {} }),
+                        warehouseRequest(CFG.warehouseDocs, { method: 'POST', body: {} }),
+                    ];
+                    const results = await Promise.all(calls);
+                    const names = ['warehouse_list', 'documents_list'];
+                    const wrong = [];
+                    results.forEach((r, i) => {
+                        if (r.error) return;
+                        if (r.httpStatus !== 405) wrong.push(`${names[i]}: HTTP ${r.httpStatus} (expected 405)`);
+                    });
+                    if (wrong.length > 0) return ['warn', wrong.join('\n')];
+                    return ['pass', 'Oba GET-only endpointy poprawnie odrzucaj─ů POST z HTTP 405'];
+                }
+            },
+        ]
+    },
+
+    // ÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉ
+    // SUITE 9: POS Engine ÔÇö Zam├│wienia, Koszyk, P┼éatno┼Ťci, Trasy
+    // ÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉÔĽÉ
+    {
+        id: 9,
+        tests: [
+            {
+                id: 'T51', label: 'POS Engine ÔÇö HTTP 200 + JSON',
+                desc: 'POST api/pos/engine.php z action=get_init_data Ôćĺ HTTP 200 + application/json',
+                async run() {
+                    const r = await callPosEngine({ action: 'get_init_data' });
+                    if (r.error) return ['fail', `B┼é─ůd: ${r.error}`];
+                    if (r.httpStatus !== 200) return ['fail', `HTTP ${r.httpStatus}`];
+                    if (!r.contentType.includes('application/json')) return ['fail', `Content-Type: ${r.contentType}`];
+                    return ['pass', `HTTP 200, Content-Type: ${r.contentType}`];
+                }
+            },
+            {
+                id: 'T52', label: 'get_init_data ÔÇö struktura {categories, items, modifierGroups}',
+                desc: 'POS init zwraca kategorie, dania z cenami, modyfikatory, kierowc├│w, kelner├│w',
+                async run() {
+                    const r = await callPosEngine({ action: 'get_init_data' });
+                    if (r.error) return ['fail', r.error];
+                    const json = tryParse(r.body);
+                    if (!json) return ['fail', `Nieparsowalny JSON:\n${r.body.substring(0,200)}`];
+                    if (json.success !== true) return ['fail', `success=${json.success}: ${json.message}`];
+                    const d = json.data;
+                    const keys = ['categories', 'items', 'ingredients', 'drivers', 'waiters', 'modifierGroups'];
+                    const missing = keys.filter(k => !(k in d));
+                    if (missing.length > 0) return ['fail', `Brak kluczy: ${missing.join(', ')}`];
+                    const item = d.items[0];
+                    if (item && !item.priceTiers) return ['warn', 'Item bez priceTiers ÔÇö sprawd┼║ sh_price_tiers'];
+                    return ['pass', `Cat:${d.categories.length}, Items:${d.items.length}, Mods:${d.modifierGroups.length}, Drivers:${d.drivers.length}`];
+                }
+            },
+            {
+                id: 'T53', label: 'get_init_data ÔÇö items maj─ů priceGrosze-kompatybilne dane',
+                desc: 'Ka┼╝dy item musi mie─ç asciiKey i co najmniej 1 priceTier',
+                async run() {
+                    const r = await callPosEngine({ action: 'get_init_data' });
+                    if (r.error) return ['fail', r.error];
+                    const json = tryParse(r.body);
+                    if (!json || json.success !== true) return ['skip', json?.message || 'B┼é─ůd'];
+                    const items = json.data?.items || [];
+                    if (items.length === 0) return ['warn', 'Brak da┼ä w bazie ÔÇö nie mo┼╝na testowa─ç'];
+                    const noKey = items.filter(i => !i.asciiKey);
+                    const noPrice = items.filter(i => !i.priceTiers || i.priceTiers.length === 0);
+                    const issues = [];
+                    if (noKey.length > 0) issues.push(`${noKey.length} items bez asciiKey`);
+                    if (noPrice.length > 0) issues.push(`${noPrice.length} items bez priceTiers`);
+                    if (issues.length > 0) return ['warn', issues.join('; ')];
+                    return ['pass', `Wszystkie ${items.length} da┼ä maj─ů asciiKey i cen─Ö`];
+                }
+            },
+            {
+                id: 'T54', label: 'get_item_details ÔÇö sk┼éadniki z receptury',
+                desc: 'POST get_item_details z item_id Ôćĺ ingredients array',
+                async run() {
+                    const initR = await callPosEngine({ action: 'get_init_data' });
+                    const initJson = tryParse(initR.body);
+                    if (!initJson || !initJson.success) return ['skip', 'Nie udało się pobrać init data'];
+                    const firstItem = (initJson.data?.items || [])[0];
+                    if (!firstItem) return ['skip', 'Brak dań do testu'];
+                    const r = await callPosEngine({ action: 'get_item_details', item_id: firstItem.id });
+                    if (r.error) return ['fail', r.error];
+                    const json = tryParse(r.body);
+                    if (!json) return ['fail', 'Nieparsowalny JSON'];
+                    if (json.success !== true) return ['fail', `success=${json.success}: ${json.message}`];
+                    if (!Array.isArray(json.data?.ingredients)) return ['fail', 'Brak data.ingredients array'];
+                    return ['pass', `Item ${firstItem.name}: ${json.data.ingredients.length} składników z receptury`];
+                }
+            },
+            {
+                id: 'T55', label: 'get_orders ÔÇö lista aktywnych zam├│wie┼ä',
+                desc: 'POST get_orders Ôćĺ success:true, data:{orders:[...]}',
+                async run() {
+                    const r = await callPosEngine({ action: 'get_orders' });
+                    if (r.error) return ['fail', r.error];
+                    const json = tryParse(r.body);
+                    if (!json) return ['fail', `Nieparsowalny JSON:\n${r.body.substring(0,200)}`];
+                    if (json.success !== true) return ['fail', `success=${json.success}: ${json.message}`];
+                    if (!Array.isArray(json.data?.orders)) return ['fail', 'Brak data.orders array'];
+                    return ['pass', `${json.data.orders.length} aktywnych zamówień`];
+                }
+            },
+            {
+                id: 'T56', label: 'process_order ÔÇö pusty koszyk Ôćĺ success:true (puste zam├│wienie)',
+                desc: 'POST process_order z cart:[] Ôćĺ zapis przechodzi (pusta kwota)',
+                async run() {
+                    const r = await callPosEngine({
+                        action: 'process_order',
+                        cart: [], source: 'POS', order_type: 'dine_in',
+                        payment_method: 'unpaid', payment_status: 'unpaid',
+                        total_price: 0, status: 'pending',
+                    });
+                    if (r.error) return ['fail', r.error];
+                    const json = tryParse(r.body);
+                    if (!json) return ['fail', 'Nieparsowalny JSON'];
+                    if (json.success !== true) return ['fail', `Zamówienie nie zostało zapisane: ${json.message}`];
+                    if (!json.data?.order_id) return ['warn', 'Brak order_id w odpowiedzi'];
+                    return ['pass', `Zam├│wienie utworzone: ${json.data.order_id}`];
+                }
+            },
+            {
+                id: 'T57', label: 'process_order ÔÇö pe┼ény koszyk z modifierami',
+                desc: 'POST process_order z pozycj─ů + modifier Ôćĺ success:true, order_id w odpowiedzi',
+                async run() {
+                    const r = await callPosEngine({
+                        action: 'process_order',
+                        cart: [{ cart_id: 'test1', ascii_key: 'MARGHERITA', name: 'Margherita', price: '25.99', qty: 2,
+                                 added: [{ ascii_key: 'OPT_JALAPENO', name: 'Jalapeno', price: '4.00' }],
+                                 removed: [{ sku: 'SER_MOZZARELLA', name: 'Mozzarella' }],
+                                 comment: 'Dobrze wypieczona' }],
+                        source: 'POS', order_type: 'takeaway',
+                        payment_method: 'cash', payment_status: 'paid',
+                        total_price: 51.98, status: 'pending',
+                    });
+                    if (r.error) return ['fail', r.error];
+                    const json = tryParse(r.body);
+                    if (!json) return ['fail', `Nieparsowalny JSON:\n${r.body.substring(0,200)}`];
+                    if (json.success !== true) return ['fail', `Nie udało się: ${json.message}`];
+                    if (!json.data?.order_id) return ['warn', 'Brak order_id'];
+                    return ['pass', `Zam├│wienie z modifierami OK: ${json.data.order_id}`];
+                }
+            },
+            {
+                id: 'T58', label: 'panic_mode ÔÇö +20min do pending/ready',
+                desc: 'POST panic_mode Ôćĺ success:true z komunikatem',
+                async run() {
+                    const r = await callPosEngine({ action: 'panic_mode' });
+                    if (r.error) return ['fail', r.error];
+                    const json = tryParse(r.body);
+                    if (!json) return ['fail', 'Nieparsowalny JSON'];
+                    if (json.success !== true) return ['fail', `success=${json.success}: ${json.message}`];
+                    return ['pass', `Panic mode: "${json.data?.message || 'OK'}"`];
+                }
+            },
+            {
+                id: 'T59', label: 'Nieznana akcja Ôćĺ success:false',
+                desc: 'POST z action=UNKNOWN Ôćĺ success:false + opisowy komunikat',
+                async run() {
+                    const r = await callPosEngine({ action: 'UNKNOWN_TEST_ACTION' });
+                    if (r.error) return ['fail', r.error];
+                    const json = tryParse(r.body);
+                    if (!json) return ['fail', 'Nieparsowalny JSON'];
+                    if (json.success !== false) return ['fail', `Oczekiwano success:false, got ${json.success}`];
+                    return ['pass', `Unknown action handled: "${json.message}"`];
+                }
+            },
+            {
+                id: 'T60', label: 'pos_api.js ÔÇö eksportuje kluczowe metody',
+                desc: 'PosAPI musi mie─ç loginPin, getInitData, processOrder, panicMode, assignRoute',
+                async run() {
+                    const src = await fetchJs(CFG.jsClients.posApi);
+                    if (!src) return ['fail', 'Nie udało się pobrać pos_api.js'];
+                    const methods = ['loginPin', 'getInitData', 'getOrders', 'processOrder',
+                                     'acceptOrder', 'updateStatus', 'printKitchen', 'printReceipt',
+                                     'settleAndClose', 'cancelOrder', 'panicMode', 'assignRoute'];
+                    const missing = methods.filter(m => !src.includes(m));
+                    if (missing.length > 0) return ['fail', `Brakuje metod: ${missing.join(', ')}`];
+                    if (!src.includes('Authorization')) return ['fail', 'Brak nagłówka Authorization w pos_api.js'];
+                    return ['pass', `pos_api.js eksportuje ${methods.length} metod + JWT auth`];
+                }
+            },
+            {
+                id: 'T61', label: 'pos_cart.js ÔÇö eksportuje PosCart z kluczowymi metodami',
+                desc: 'PosCart musi mie─ç addItem, addHalf, loadFromCartJson, toApiPayload',
+                async run() {
+                    const src = await fetchJs(CFG.jsClients.posCart);
+                    if (!src) return ['fail', 'Nie udało się pobrać pos_cart.js'];
+                    const methods = ['addItem', 'addHalf', 'updateLine', 'removeLine', 'clear',
+                                     'loadFromCartJson', 'loadFromOrderLines', 'toApiPayload', 'getSnapshot'];
+                    const missing = methods.filter(m => !src.includes(m));
+                    if (missing.length > 0) return ['fail', `Brakuje metod: ${missing.join(', ')}`];
+                    if (src.includes('(int)(') || src.includes('* 100)')) {
+                        if (!src.includes('round')) return ['warn', 'Potencjalny problem z zaokr─ůgleniem floatÔćĺint'];
+                    }
+                    return ['pass', `pos_cart.js eksportuje ${methods.length} kluczowych metod`];
+                }
+            },
+        ]
+    },
 ];
 
 // ÔöÇÔöÇÔöÇ G┼é├│wna p─Ötla wykonania ÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇÔöÇ
@@ -900,6 +1456,45 @@ async function runAllTests() {
     COUNTS = { total: 0, pass: 0, fail: 0, warn: 0 };
     DONE_TESTS = 0;
 
+    // Auto-login: get a real JWT token before running tests
+    if (!CFG.authToken) {
+        let loginOk = false;
+        try {
+            const loginRes = await fetch(CFG.loginEndpoint, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ mode: 'kiosk', tenant_id: CFG.tenantId, pin_code: CFG.loginPin }),
+                credentials: 'same-origin',
+            });
+            const loginJson = await loginRes.json();
+            if (loginJson.success && loginJson.data?.token) {
+                CFG.authToken = loginJson.data.token;
+                loginOk = true;
+                console.log('[TestRunner] Auto-login OK, token acquired');
+            } else {
+                console.warn('[TestRunner] Auto-login failed:', loginJson.message,
+                    '\nÔćĺ Uruchom: http://localhost/slicehub/scripts/setup_database.php');
+            }
+        } catch (e) {
+            console.warn('[TestRunner] Auto-login error:', e.message,
+                '\nÔćĺ Sprawdz czy XAMPP Apache jest uruchomiony');
+        }
+        if (!loginOk && TEST_JWT_TOKEN) {
+            CFG.authToken = TEST_JWT_TOKEN;
+            console.log('[TestRunner] Using fallback TEST_JWT_TOKEN (dev secret, tenant_id=1)');
+        }
+        if (!loginOk) {
+            const warn = document.createElement('div');
+            warn.style.cssText = 'background:rgba(234,179,8,0.1);border:1px solid rgba(234,179,8,0.3);border-radius:12px;padding:12px 20px;margin-bottom:16px;display:flex;align-items:center;gap:12px;';
+            warn.innerHTML = `<span style="font-size:18px;">ÔÜá´ŞĆ</span>
+                <div>
+                    <div style="color:#eab308;font-size:12px;font-weight:700;">AUTO-LOGIN FAILED (PIN: ${CFG.loginPin})</div>
+                    <div style="color:#94a3b8;font-size:11px;">Brak seed data? Uruchom: <a href="/slicehub/scripts/setup_database.php" style="color:#60a5fa;">setup_database.php</a> ÔÇö testy auth-dependent beda FAIL.</div>
+                </div>`;
+            document.getElementById('suites-container').prepend(warn);
+        }
+    }
+
     // Policz wszystkie testy
     TOTAL_TESTS = SUITES.reduce((sum, s) => sum + s.tests.length, 0);
     COUNTS.total = TOTAL_TESTS;