# Zlecenia Opiekuna (aktualizacje węzłów)

# Zlecenia Opiekuna (aktualizacje węzłów, stan 17.11.2026)

Użytkownik zleca z kokpitu (CT163). Agent Opiekun wykonuje na węźle `/usr/local/sbin/aktualizuj-wezel` w trybie `dry` albo `run`. Skrypt nigdy nie restartuje węzła. Wynik wraca na kartę sprawy; użytkownik go czyta i zatwierdza.

## Które sprawy
- Typ `aktualizacja`, tytuł „N paczek do aktualizacji”, węzeł z listy: saturn, naptun, merkury, jowisz, slonce, mars, grws1.
- Pozostałe sprawy aktualizacji (np. wtyczki z kanału J-Tools) nie dostają przycisków.

## Karta sprawy
- „Zleć Opiekunowi: zaktualizuj” i „Zleć symulację”, gdy węzeł nie ma aktywnego zlecenia.
- Blok „Zlecenie Opiekuna #N” ze stanem (zlecone i czeka, w toku, zakończone z wynikiem) i pełnym raportem (escapowany).
- Żółty pasek „WYMAGANY RESTART WĘZŁA, osobna decyzja”, gdy raport ma „restart wezla wymagany: TAK”. Kokpit nie restartuje.
- Po wyniku: „Zatwierdzam wynik (zamknij sprawę)”, „Ponów”, „Przypomnij”, „Zignoruj”. Przy czekającym zleceniu: „Anuluj zlecenie”.
- Linia „Kolejka Opiekuna” nad sprawami. Strona odświeża się co 30 s, gdy coś czeka albo trwa.

## Kto może zlecić
- Symulację: każdy z dostępem do kokpitu. Hub sam tworzy automatyczną symulację.
- Aktualizację (także „Ponów”): tylko żądanie przez Cloudflare Access (konektor CT134). Bez nagłówka z e-mailem zlecającego żądanie dostaje 403. Z LAN, VPN i od agentów też 403.

## Automatyczna symulacja
- Gdy sprawa jest otwarta bez zleceń („nowa sprawa”) albo zmienia się liczba paczek.
- Najwyżej jedna automatyczna na sprawę na dobę. Nigdy przy aktywnym zleceniu węzła.

## Zasady
- W całym systemie jedno zadanie w toku. Na węzeł jedno aktywne zlecenie. Pilnują tego unikalne indeksy w bazie.
- Zadanie w toku dłużej niż 90 minut: BLAD „brak odpowiedzi Opiekuna”. Spóźniony wynik hub przyjmuje z adnotacją.
- Wyniki: symulacja SYMULACJA, BRAK, BLAD, ODMOWA; aktualizacja OK, BRAK, BLAD, ODMOWA.
- Zamknięcie sprawy („Wykonane”, „Zignoruj”, „ustąpiła”) anuluje jej czekające zlecenia.
- Log (tabela `log`): `zadanie-zlecone`, `zadanie-start`, `zadanie-wynik`, `zadanie-przekroczony-czas`, `zadanie-anulowane`, `zadanie-zatwierdzone`.

## API dla Opiekuna (port 8090, tylko z 10.30.7.162)
- `GET /api/zadania?stan=zlecone`: czekające, od najstarszego; `mozna_zaczac: true`, gdy nic nie jest w toku.
- `GET /api/zadania?stan=w_toku`, `GET /api/zadania?stan=wykonane`, `GET /api/zadania/<id>`.
- `POST /api/zadania/<id>/start`: zlecone → w toku; 409, gdy inne jest w toku.
- `POST /api/zadania/<id>/wynik`: w toku → wykonane; JSON `{"wynik": "...", "tekst": "..."}`.
- Brak adresu do tworzenia zleceń, restartu i wykonywania poleceń (404).

## Webhook do Opiekuna (od 16.11, 23:45)

- Wdrożony na hubie (raport Programisty), test na kopii bazy: 36 z 36 sprawdzeń. Przy każdym zleceniu hub wysyła zdarzenie do OpenBot po zapisie zlecenia.
- **Stan 16.11 (raport Programisty): nieaktywny**, bo brak pliku sekretu `/etc/wpisy/openbot-webhook-opiekun.secret`. Hub wtedy nic nie wysyłał, a zdarzenie dostawało status „pominiete”. Adres jest w `/etc/wpisy/openbot-webhook-opiekun.url`.
- **Stan 17.11 (`zlecenia-agentow.md`, wiersz Opiekuna):** webhook działa od 17.11 08:53 (czas bez strefy). Nie zweryfikowano na hubie ani w OpenBot.
- Aktywacja: użytkownik generuje sekret w ustawieniach rutyn OpenBot, Klaudiusz zapisuje go na hubie i w Vaultwarden. Pierwsze zlecenie pokaże wynik na karcie (401: zły sekret, 404: brak rutyny).
- Opiekun pobiera zlecenia z `/api/zadania`. Rutyna zapasowa wg `zlecenia-agentow.md` z 17.11: co 15 minut (webhook działa, jak wyżej).
- **Nie zweryfikowano:** prawdziwe wysłanie do OpenBot (brak sekretu w chwili raportu).

## Stan (raport Programisty, 16.11 ok. 21:15)
- Testy na kopii: 60 z 60 sprawdzeń OK (`testy/test_zadania_infra_ct163.py`). Węzłów nie dotykano.
- Produkcja: 7 automatycznych symulacji w kolejce (zlecenia #1–#7, sprawy 75, 76, 77, 84, 85, 87, 89), nic w toku. Pierwsza próba: zlecenie #2 (jowisz, symulacja).
- **Nie zweryfikowano:** pracy prawdziwego Opiekuna i skryptu na węźle; logowania przez Cloudflare Access na żywo (w teście nagłówek był symulowany).

Ostatnia aktualizacja: 17.11.2026 13:00 UTC, źródło: zlecenia-agentow.md (webhook i rutyna zapasowa, 17.11), Shared/hub-wpisy/README.md (Webhook do Opiekuna)