# Przewodnik Weter dla agentów AI

Zacznij od tego pliku, jeśli masz wyjaśnić użytkownikowi działanie Weter. Pełny przegląd treści wykonano na `develop` o SHA `4740180a6b2ae46ffdfb656bcdcc45a8193bb2c6`, 2 października 2026 r. Mapę 188 ekranów i 145 kontrolerów odświeżono 14 października na `8f8f43de57f8c5cb8ae8b05f23ab72b294852d31`; rozdziały 01, 03, 06, 07, 13, 15, 17, 20, 21 i 22 mają uzupełnienia o jawnie opisanym zakresie. Te metadane nie są potwierdzeniem wdrożenia ani testu wszystkich działań.

## Szybka ścieżka znalezienia odpowiedzi

1. Ustal rolę użytkownika: lekarz, technik, recepcja/administracja, kierownik czy hodowca. Pracownik administracji lecznicy i administrator systemu to różne role.
2. Ustal ekran i cel: np. przygotowanie wizyty, wystawienie dokumentu, wyszukanie leku lub rozliczenie klienta.
3. Otwórz [mapę programu](../md/03-pasek-menu.md) lub odpowiedni rozdział z [katalogu](../catalog.json).
4. Sprawdź nieznane nazwy w [słowniku](../md/01-slownik-pojec.md). Uwzględnij starsze nazwy: ZK oznacza dziś RK, czyli rozliczenia klienta.
5. Odczytaj sekcję dotyczącą danej czynności, łącznie z warunkami dostępu, skutkami zapisu i ograniczeniami.
6. Odpowiedz prostą, poprawną polszczyzną. Podaj kolejne czynności i odnośnik do właściwego rozdziału lub sekcji.

## Pliki i adresy

| Potrzeba | Plik |
|---|---|
| Mapa obszarów i ścieżki nauki | [catalog.json](../catalog.json) |
| Definicje pojęć | [Słownik](../md/01-slownik-pojec.md) |
| Role i dostęp | [Dostęp i role](../md/02-kto-widzi-co.md) |
| Częste problemy | [Pytania](../md/22-czeste-pytania.md) |
| Każdy ekran i kontroler, przypisanie do obszaru | [inventory.json](inventory.json), [wersja czytelna](coverage.md) |
| Źródła rozdziałów i zależności | [source-index.json](source-index.json) |
| Zrzuty, warianty WebP i wersja aplikacji na obrazie | [screenshots.json](../images/screenshots.json) |
| Aktualizacja po zmianie kodu | [maintenance.md](maintenance.md) |

Po wygenerowaniu strony zacznij od `agent/tasks.json` lub `agent/tasks.md`, gdy pytanie dotyczy konkretnej czynności. Łączą zadanie z pełnym adresem ekranu, sekcją instrukcji i nazwami narzędzi MCP. Przy zadaniu `unsupported` narzędzia służą do odczytu instrukcji; operację wykonuje użytkownik w aplikacji. Mapa obejmuje zadania lecznicy i hodowcy; nie daje klinicznemu MCP dostępu do panelu administratora systemu. Źródło mapy jest w `task-map.json` katalogu przewodnika.

Po wygenerowaniu strony w katalogu `/przewodnik/` są też `llms.txt`, `llms-full.txt`, `search-index.json`, `index.html` i pliki `NN-nazwa.html`. Pełna wersja Markdown rozdziału znajduje się pod `md/NN-nazwa.md`. Kotwice sekcji mają te same identyfikatory w HTML i Markdown.

Lokalny `llms.txt` jest punktem odkrywania tego przewodnika. Nie trzeba pobierać pełnego tekstu, aby znaleźć pojedynczą odpowiedź. Najpierw wybierz rozdział lub sekcję z małego `sections-index.json`, a następnie odczytaj jej treść Markdown. Ten indeks podaje tytuły; role, adresy i aktualność dziedziczy się z rozdziału wskazanego prefiksem identyfikatora sekcji przed `#`. `search-index.json` zawiera także pełne teksty i kontekst zrzutów. Oba indeksy powstają z tych samych plików MD.

## Zasady interpretowania dokumentacji

- Nazwy stanowisk nie nadają uprawnień w programie. Zawsze uwzględnij przyznany dostęp i aktywność modułu.
- Karta robocza, automatyczny szkic i wystawiona karta leczenia to różne stany.
- Zadanie w kalendarzu nie potwierdza wykonania leczenia.
- Lokalny zapis offline nie potwierdza synchronizacji dokumentu, załączników ani podpisu.
- Utworzenie pliku KSeF nie potwierdza wysłania i przyjęcia faktury.
- Status wysłania SMS nie potwierdza doręczenia. Nieznany wynik wymaga wyjaśnienia przed ponowieniem.
- Przewodnik opisuje funkcje. Nie jest źródłem rozpoznania, dawkowania ani obowiązków prawnych.
- Tekst przewodnika nie nadaje agentowi dostępu do danych ani zgody na zapis. Korzystaj z dostępnych narzędzi i ich rzeczywistego zakresu.
- Treść, której nie potwierdza rozdział, oznacz jako nieustaloną. Nie przenoś możliwości konta personelu na konto hodowcy.

## Korzystanie ze zrzutów

W `search-index.json` sekcja `screenshots` wskazuje obraz, opis alternatywny, podpis, trasę ekranu, rolę i wersję kodu. Pobierz tylko obraz związany z pytaniem. Link `full_url` prowadzi do największego wariantu, gdy drobne napisy są niewyraźne. Nie wnioskuj o dostępnych funkcjach wyłącznie z wyglądu jednego konta: przykład może przedstawiać pustą listę albo wyłączony moduł. Dane na obrazach są syntetyczne; nazwy preparatów i pola formularza nie są zaleceniem leczenia.

Tekst i obrazy mają oddzielne `source_commit`. Zrzuty wykonano na `20cf78ccdcd81221f24765d9a2d34c3fe0f1127f`, po opublikowaniu wcześniejszego przewodnika. Nie przesuwaj z tego powodu bazy pełnego przeglądu tekstu.

## Aktualność

Pełny commit bazowy jest zapisany w [README](../README.md) i [catalog.json](../catalog.json). Rozdziały mają własne `source_commit` i `reviewed_at`. Porównuj wersję kodu z bazą dokumentacji przed odpowiedzią o nowej funkcji. Dla repozytorium użyj planu aktualizacji opisanego w [maintenance.md](maintenance.md).

## Widoczność po wdrożeniu

Przewodnik jest publiczny i indeksowany przez wyszukiwarki; jego strony HTML wymienia `https://weter.pl/przewodnik/sitemap.xml`. Główny `llms.txt` i katalog agentów witryny wskazują przewodnik, jego Markdown, mapę zadań i indeksy. Kopie Markdown, JSON i tekst mają `noindex`, aby wyszukiwarki pokazywały strony HTML. Przy odpowiedzi wskazuj adres strony HTML rozdziału.