Skip to main content

Kokpit i API

Kokpit i API (stan 18.11.2026)

Kokpit

  • LAN: http://10.30.7.163:8080/wpisy oraz /sprawy.

  • Publiczny: kokpit.jakosciowo.pl, za Cloudflare Access (przekierowanie na logowanie, sprawdzone 18.11 w raporcie Opiekuna). Adres wskazuje na hub przez tunel saturn.

  • Zakładka „Wpisy”: karty zgłoszeń. Od 17.11 22:55 karty mają status (wdrożone 17.11 22:55 wg README):

    Status Znaczenie
    Do przeglądu nowa karta, czeka na człowieka
    Oczekuje na poprawę uwagi do poprawy, karta wraca do przeglądu po „Poprawione”
    Zatwierdzone zatwierdzona, szkic jeszcze nie powstał (w drodze albo nieudany)
    Szkic gotowy szkic jest na stronie
    Opublikowane / Zaplanowane odczyt ze strony: publiczny albo z datą w przyszłości
    Do decyzji BIP: aktualizacja czeka na zatwierdzenie albo wpis trzeba wskazać
    Zatwierdzone ręcznie zamknięte poza hubem (tylko Cloudflare Access)
    Odrzucone
    Wstrzymane szkicownik strony stoi (401, 403 albo 429, bezpiecznik)
  • Przyciski (obecny przepływ): „Zatwierdź” (z Do przeglądu), „Do poprawy” (uwagi obowiązkowe), „Odrzuć”, „Zapisz uwagi”, „Zatwierdzone ręcznie…” i „Cofnij” (tylko Cloudflare Access, dopóki hub nie zapisał szkicu).

  • Historia karty: rozwijana; kto (e-mail z Cloudflare Access albo adres), kiedy, notatka, link.

  • Zakładki: domyślnie „Wymaga uwagi” (Do przeglądu, Do decyzji, Wstrzymane), potem każdy status osobno i „Wszystkie”.

  • Schemat A (decyzja 18.11, w budowie): nowe karty bez „Zatwierdź”, przycisk „Opublikuj…” z oknem potwierdzenia. Stan i warunki: strona „Przepływ zgłoszenia”, sekcja „Schemat A”. Na produkcji nie włączony (nie zweryfikowano).

  • Elementy do sprawdzenia są wyróżnione na żółto. Od 17.11 (BIP i Jakubów): gdy data z formularza różni się od chwili utworzenia szkicu o ponad 3 godziny, plakietka „zaplanowany” albo „data z przeszłości”.

  • Zakładka „Sprawy”: powiadomienia i decyzje. Akcje: Wykonane, Przypomnij za 1 dzień, Przypomnij za 7 dni, Zignoruj. Wygasanie po 7 dniach: strona „Nadzór i Sprawy”.

  • Restart kokpitu lub API trwa ok. 1 s. Otwarta strona kokpitu prosi wtedy o odświeżenie.

API agentów

Adres: http://10.30.7.163:8090 (port 8090, usługa wpisy-api).

Metoda i ścieżka Co robi
GET /api/health stan usługi
GET /api/karty lista kart; opcjonalnie ?stan=… (np. do_zatwierdzenia, opublikowany)
GET /api/karty/<id> jedna karta
POST /api/karty/<id>/uwagi JSON {"uwagi": "..."}; zmienia tylko uwagi, nie stan karty
GET /api/sprawy otwarte sprawy
POST /api/sprawy JSON: klucz, tytul (wymagane), zrodlo, typ, poziom, opis
POST /api/sprawy/ustapila JSON {"klucz": "..."}; zamyka sprawę
GET /api/zadania?stan=zlecone zlecenia Opiekuna czekające, od najstarszego (tylko z 10.30.7.162)
GET /api/zadania/<id> jedno zlecenie
POST /api/zadania/<id>/start zlecone → w toku; 409, gdy inne zlecenie jest w toku
POST /api/zadania/<id>/wynik w toku → wykonane; JSON {"wynik": "...", "tekst": "..."}
  • Dozwolone typ: aktualizacja, dysk, kopia, bezpieczenstwo, usluga, inne.
  • Dozwolone poziom: pilne, uwaga, info.
  • Sprawa z tym samym kluczem, która jest otwarta, zostaje zaktualizowana, a nie dublowana.
  • Zmiany statusów są zgodne wstecz. API niczego nie publikuje, nie wycofuje i nie usuwa (wg README huba).

Zamierzony dostęp: z 10.30.7.162 (CT162, agenci OpenBot) i z WireGuard 10.30.8.200 (agent-gate).

Stan faktyczny (raport Programisty huba, 16.11): API odpowiada bez klucza z całej sieci WireGuard 10.30.8.0/24, bo firewall Proxmoxa nie filtruje interfejsu wg0. Agent z CT162 technicznie może też zatwierdzić kartę w kokpicie. Potwierdzone 16.11 przez Klaudiusza; pozostaje na liście zabezpieczeń (strona 83).

Zatwierdzanie i publikację robi tylko użytkownik w kokpicie.

Zlecenia Opiekuna (/api/zadania) są tylko z 10.30.7.162. Z innych adresów (np. WireGuard z slonce) zwracają 403. Brak adresu do tworzenia zleceń, restartu i poleceń (404). Webhook do Opiekuna: przy każdym nowym zleceniu hub wysyła zdarzenie do OpenBot; wg zlecenia-agentow.md działa od 17.11 08:53 (nie zweryfikowano na hubie). Szczegóły: strona „Zlecenia Opiekuna (aktualizacje węzłów)” w książce „Infrastruktura”.

Ostatnia aktualizacja: 18.11.2026 08:00 UTC, źródło: Shared/hub-wpisy/README.md (statusy kart 17.11 22:55, schemat A 18.11), zlecenia-agentow.md (webhook, 17.11), Shared/Raporty/programista-hub-2026-11-16.md (stan API)