# 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)