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)