Runbook incydentowy

Runbook obejmuje najczęstsze incydenty produkcyjne:

• awaria API
• błędy webhooka
• drift stanów magazynowych

1) Szybka diagnoza

1. Otwórz WooCommerce > HFT71 Logi.
2. Sprawdź ostatnie akcje: send_order, get_status, webhook, stock_sync.
3. Zidentyfikuj dominujące kody HTTP:
4. 0/timeout -> problem sieciowy
5. 401/403 -> autoryzacja
6. 404 -> zły endpoint/base URL
7. 429 -> limit requestów
8. 5xx -> awaria po stronie API
9. Zweryfikuj ustawienia i działanie WP-Cron.

2) Scenariusz A - awaria API

Objawy

• Nieudane send_order / get_status, dużo timeoutów lub 5xx.
• Zamówienia processing bez _hft71_order_id.

Mitigacja

• Potwierdź awarię po stronie dostawcy.
• Poinformuj operacje, że handoff do fulfillment jest opóźniony.
• Nie wykonuj masowych ręcznych retry bez kontroli duplikatów.

Odtworzenie

1. Potwierdź powrót API (logowanie + testowy endpoint).
2. Wylistuj dotknięte zamówienia z okna awarii.
3. Wyślij ponownie partiami.
4. Potwierdź zapis _hft71_order_id i brak nowych błędów.

3) Scenariusz B - błędy webhooka

Objawy

• Brak aktualizacji statusów z webhooka.
• Brak wpisów webhook lub odrzucenia requestów.

Mitigacja

• Zweryfikuj URL: /wp-json/hft71/v1/order-status.
• Zweryfikuj sekret webhooka (header X-HFT71-Webhook-Secret lub body).
• Utrzymuj aktywny polling jako fallback.

Odtworzenie

1. Wyślij testowy webhook.
2. Sprawdź odpowiedź HTTP 200.
3. Potwierdź zmianę statusu zamówienia i wpis w logach.

4) Scenariusz C - drift stocku

Objawy

• Rozjazd ilości między WooCommerce i HFT71.

Mitigacja

• Sprawdź hft71_stock_sync_enabled.
• Zweryfikuj poprawność SKU.
• Uruchom ręczną synchronizację stocku.

Odtworzenie

1. Porównaj próbkę SKU (top produkty + losowe).
2. Potwierdź aktualizację _hft71_stock_available.
3. Zweryfikuj stabilność po pełnym cyklu synchronizacji.

5) Po incydencie

• [ ] Uzupełniony timeline i root cause.
• [ ] Zadania zapobiegawcze dodane do backlogu.
• [ ] Runbook zaktualizowany o wnioski.