# MCW Konektor Runbook

Tento subor je kratky servisny navod pre core health a diagnostiku. Odkazy z `/api/health/core` smeruju na tieto sekcie.

## Core OK

Jadro nehlasi ziadne problemy. Nie je potrebny zasah.

## Core Diagnostika

1. Otvor cloud panel a cast Nastavenia / Diagnostika jadra.
2. Skontroluj `Health`, `Top typ`, suhrn problemov a konkretne riadky so `Support key`.
3. Skontroluj aj paging metriky: `Siroke dotazy`, `Bez filtrov`, `Sort fallback` a export `mcw-pagination-summary.csv`.
4. Oprav najprv kriticke problemy, potom varovania.
5. Po oprave znova nacitaj `/api/health/core` alebo cloud panel.

## Paging A Extremne Requesty

1. Otvor Nastavenia / Diagnostika jadra a exportuj `mcw-pagination-health.csv`.
2. Ak je `responsePressure` high alebo `broadQuery` true, pridaj `shopId`, `status`, `q` alebo iny uzsi filter.
3. Ak je `unfilteredQuery` true pri velkej kolekcii, neposielaj dalsie stranky bez filtra.
4. Ak je `ignoredFilterCount` vacsie ako 0 alebo `filterSafetyLevel` je `ignored-filters`, oprav API klienta na povolene filtre z `requestedFilterKeys` a odstran hodnoty z `unknownFilterKeys`.
5. Ak je `filterSafetyLevel` `invalid-date-range`, oprav `dateFrom` alebo `dateTo` na ISO datum, napriklad `2026-05-11`.
6. Ak je `sortFallback` alebo `directionFallback` true, oprav API klienta na povolene sort pole a smer `asc` alebo `desc`.
7. Ak `needsMoreFiltering` ostava true, presun velky export do background jobu namiesto nacitania v prehliadaci.
8. Pri `queryCapped` skrat vyhladavaci text a pouzi presnejsie klucove slova.

## Duplicity

Skontroluj duplicitne ID, SKU, cisla objednavok, faktur alebo zlavovych kodov. Zachovaj jeden spravny zaznam a druhy oprav alebo zluc.

## Vazby

Skontroluj neplatne vazby medzi e-shopom, produktom, objednavkou, fakturou, zasielkou alebo suborom. Oprav chybajuce ID alebo odstran neplatny odkaz.

## Multi E-shop ShopId

Dopln `shopId` pri zaznamoch, ktore patria ku konkretnej domene/e-shopu. Pri viacerych e-shopoch nesmie byt prevadzkovy zaznam bez `shopId`.

## Subory

Skontroluj `bucket`, `path`, `entityType` a `entityId`. Subor musi ukazovat na existujuci doklad alebo entitu.

## Fronta Uloh

1. Otvor cloud modul Fronta uloh alebo endpoint `/api/health/jobs`.
2. Skontroluj `Health`, `Top typ`, `Neopakovatelne`, `Top problem`, `Po limite`, `Zaseknute` a `Stare cakajuce`.
3. Pri neopakovatelnej ulohe najprv oprav typ jobu, payload alebo konfiguraciu integracie. Retry je blokovany zamerne.
4. Pri zaseknutej ulohe skontroluj, ci bezi worker a ci uloha nema dlhy `lockedAt`.
5. Pri ulohe po limite pokusov skontroluj `error`, `result.recommendedAction` a suvisiaci `syncLog`.
6. Ak rastie `Top typ` alebo `queuedPressurePercent`, skontroluj modul, ktory produkuje najviac uloh, a ci nevznika slucka.
7. Ak su `Stare cakajuce` vacsie ako 0, over, ci worker pravidelne bezi a ci `runAfter` nie je v minulosti prilis dlho.
8. Ak API vrati duplicitu s dovodom `cooldown`, nejde o chybu: system zamerne chrani frontu pred okamzitym opakovanim rovnakej sync/export ulohy.
9. Po oprave pouzi retry iba pri ulohach, ktore nie su oznacene `retryable=false`.

## Sklad

Skontroluj zaporne skladove hodnoty, neplatne mnozstva poloziek a nesediace sucty objednavok.

## Uctovnictvo

Skontroluj datum vystavenia, splatnost, uhradenu sumu, stav platby a vazbu faktury na objednavku.

## Logistika

Skontroluj stav zasielky, dopravcu a tracking cislo pri odoslanych alebo dorucenych zasielkach.

## Kontakty

Skontroluj emailove adresy zakaznikov, dodavatelov a emailovych konceptov.

## QR Kody

Pregeneruj alebo oprav QR hodnoty dotknutych produktov alebo objednavok.

## Zlavove Kody

Skontroluj hodnotu, platnost, pouzitia a limity zlavoveho kodu.