Skip to main content

Kokpit i API

Kokpit i API (stan 16.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 16.11)18.11 w raporcie Opiekuna). Adres wskazuje na hub przez tunel saturn.

  • Zakładka „Wpisy”: karty zgłoszeń. KartaOd pokazuje17.11 stan22:55 szkicukarty 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 jego„Cofnij” opis.(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 (np. „do sprawdzenia”, „DO SPRAWDZENIA”).żół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”.

Aktualizacja opublikowanego wpisu czeka na przycisk „Zatwierdź aktualizację wpisu #N” (BIP, od 17.11).

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 (16.11 23:45): przy każdym nowym zleceniu hub wysyła zdarzenie do OpenBot; bez pliku sekretu nic nie wychodzi (stan z raportu 16.11). Wgwg zlecenia-agentow.md z 17.11 webhook działa od 17.11 08:53;53 (nie zweryfikowano na hubie.hubie). Szczegóły: strona „Zlecenia Opiekuna (aktualizacje węzłów)” w książce „Infrastruktura”.

Ostatnia aktualizacja: 17.18.11.2026 13: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-wpisy/README.2026-11-16.md (Webhookstan do Opiekuna, BIP Dobre), Shared/Raporty/programista-hub-bip-2026-11-17.mdAPI)