---
id: przewodnik-weter
title: Przewodnik Weter
summary: Podstawy i szczegółowe instrukcje pracy w Weterze dla lekarzy, techników, recepcji, administracji oraz hodowców.
audience: lekarz, technik, administracja, recepcja, kierownik, hodowca, agent
reviewed_at: 2026-10-02
source_commit: 4740180a6b2ae46ffdfb656bcdcc45a8193bb2c6
---

# Przewodnik Weter

Ten przewodnik pomaga rozpocząć pracę w Weterze i wykonywać codzienne czynności. Jest przeznaczony dla osób, które wcześniej nie znały programu. Wyjaśnia nazwy, pokazuje kolejne kroki i opisuje skutki zapisu.

## Od czego zacząć

| Twoja sytuacja | Zacznij tutaj |
|---|---|
| Pierwszy raz korzystasz z programu Weter | [Pierwsze kroki](md/00-czym-jest-weter.md) → [Mapa programu](md/03-pasek-menu.md) |
| Nie rozumiesz nazwy z ekranu | [Słownik pojęć](md/01-slownik-pojec.md) |
| Brakuje przycisku lub funkcji | [Dostęp i role](md/02-kto-widzi-co.md) |
| Szukasz pomocy w konkretnej sprawie | [Częste pytania](md/22-czeste-pytania.md) |
| Masz konto hodowcy | [Portal hodowcy](md/14-portal-hodowcy.md) |
| Pracujesz z przewodnikiem jako agent AI | [Punkt startowy dla agentów](agent/START.md) |

## Podstawy pracy

- [Pierwsze kroki w Weterze](md/00-czym-jest-weter.md)
- [Słownik pojęć](md/01-slownik-pojec.md)
- [Dostęp do funkcji i role pracowników](md/02-kto-widzi-co.md)
- [Mapa programu — gdzie znaleźć funkcję](md/03-pasek-menu.md)
- [Start i Twój dzień](md/04-start-i-twoj-dzien.md)

## Właściciele, zwierzęta i stada

- [Klienci i ich kartoteki](md/11-klienci.md)
- [Portal hodowcy](md/14-portal-hodowcy.md)

## Planowanie i kontakt z klientami

- [Kalendarz, zadania i grafik](md/05-planowanie.md)
- [SMS-y i powiadomienia](md/16-sms-i-powiadomienia.md)
- [Rezerwacje wizyt online](md/18-kalendarz-rezerwacji-online.md)

## Wizyta i dokumentacja medyczna

- [Wizyta i wypełnianie karty](md/06-wizyta.md)
- [Książki leczenia, DOD i karty robocze](md/08-dokumenty.md)
- [Szczepienia i inseminacje](md/09-szczepienia-i-inseminacje.md)
- [Konsultacje, sprzedaż, rozliczenia klienta i rejestry specjalne](md/10-konsultacja-sprzedaz-zk.md)
- [Wydruki, załączniki i zgody](md/19-wydruki-zalaczniki-zgody.md)

## Leki, magazyn i rozliczenia

- [Magazyn: leki, dostawy, WZ, MM i inwentura](md/07-magazyn.md)
- [Finanse, faktury, KSeF i cenniki](md/12-moduly.md)

## Konto i organizacja lecznicy

- [Konto, ustawienia, pracownicy, słowniki i raporty](md/13-konto.md)
- [Logowanie, subskrypcja, instalacja i pomoc](md/20-konto-subskrypcja-i-pomoc.md)

## Praca w terenie i narzędzia

- [Praca bez internetu](md/15-tryb-offline.md)
- [Asystent AI i integracje](md/17-asystent-ai-i-integracje.md)
- [Skanowanie, wyszukiwanie i formularze](md/21-skanowanie-wyszukiwanie-i-formularze.md)

## Pytania i obsługa systemu

- [Częste pytania i sprawdzanie problemów](md/22-czeste-pytania.md)

## Podsumowanie przeglądu i baza aktualizacji

**Pełny przegląd wykonano na commicie `4740180a6b2ae46ffdfb656bcdcc45a8193bb2c6` gałęzi `develop` repozytorium `mszpiler/weter`, dnia 2026-10-02.** Po pobraniu zmian z `origin` lokalny i zdalny `develop` wskazywały tę samą bazę. Pierwszy przegląd obejmuje 24 rozdziały w dziewięciu obszarach, 129 pojęć oraz mapę 186 różnych tras interfejsu i 143 plików kontrolerów.

Przy kolejnej aktualizacji porównaj tę bazę z nowym `develop`. Zmieniaj treści dotyczące różnic, zamiast ponownie przepisywać cały przewodnik. Rozdziały mają własny commit i datę sprawdzenia. Nie należy zmieniać tych wartości tylko dlatego, że przebudowano stronę.

Mapę ekranów i źródeł zapisano w [inventory.json](agent/inventory.json) oraz [source-index.json](agent/source-index.json). [Instrukcja aktualizacji](agent/maintenance.md) opisuje porównanie commitów i sprawdzenie nowych funkcji.

**Aktualizacja częściowa z 2026-10-06:** mapa obejmuje 187 różnych tras i 143 kontrolery na `c4c88ab478894209f043152751ede4a26cf62042`. Uzupełniono rozdziały 06, 17 i 21 o skanowanie leków, wybór zeskanowanej serii i kreator podłączenia asystenta. Ich `review_scope` określa zakres sprawdzenia. Nie oznacza to nowego pełnego przeglądu pozostałych rozdziałów ani wykonania nowych zrzutów. `inventory_commit` w katalogu określa bazę mapy ekranów; `source_commit` nadal wskazuje pełny przegląd treści.

**Scalenie aktualizacji z 2026-10-06:** mapa tras i źródeł została odświeżona do `9b1ee18ae81ca9c34de0053762a5ae160750b752`; liczba tras i kontrolerów pozostaje bez zmian. Rozdziały 07 i 21 uwzględniają nowe kody QR, wybór typu kodu oraz druk etykiet. Rozdział 17 zachowuje wskazówki o planach asystentów wyświetlane przez aplikację; nie stanowią one ponownej weryfikacji ofert dostawców. Zakresy przeglądu rozdziałów i historyczna baza pełnego przeglądu pozostają rozdzielone.


```bash
python3 przewodnik/update-plan.py --repo ../weter --to origin/develop
```

Polecenie uruchom z katalogu `weter-docs`. Odczytuje zmiany i wskazuje rozdziały do sprawdzenia. Pokazuje również zmiany bez przypisania, które trzeba osobno sklasyfikować.

| Data | Commit bazowy | Zakres |
|---|---|---|
| 2026-10-02 | 4740180a6b2ae46ffdfb656bcdcc45a8193bb2c6 | Pełny przegląd develop, poprawa starych opisów, nazwa „przewodnik”, wersje dla ludzi i agentów. |
| 2026-10-02 | 20cf78ccdcd81221f24765d9a2d34c3fe0f1127f | 90 zrzutów z przykładowymi danymi, warianty WebP i metadane obrazów. Baza pełnego przeglądu tekstu pozostaje bez zmian. |
| 2026-10-02 | 20cf78ccdcd81221f24765d9a2d34c3fe0f1127f | Przegląd odkrywania treści przez agentów: główny llms i mapy witryny wskazują przewodnik; HTML i odpowiedzi serwera wskazują lokalny llms. Dodatkowo poprawiono kolejność reguł karencji w rozdziale Magazyn i doprecyzowano automatyczne przesyłanie kart oraz lokalne wydruki w rozdziale Praca bez internetu. Rozwinięto wyszukiwarkę o popularne pytania i odmiany słów, w tym „tworzenie konta”. Baza pełnego przeglądu tekstu pozostaje bez zmian. |
| 2026-10-06 | c4c88ab478894209f043152751ede4a26cf62042 | Częściowy przegląd skanowania leków i integracji AI, aktualna mapa tras, mapa zadań i narzędzi MCP oraz wspólne pytania wyszukiwarki. Baza pełnego przeglądu i pochodzenie zrzutów pozostają zapisane osobno. |
| 2026-10-06 | 9b1ee18ae81ca9c34de0053762a5ae160750b752 | Scalenie źródeł po pull: kody QR i etykiety, wskazówki planów asystentów z instrukcji aplikacji oraz odświeżona mapa statycznych tras i zależności. |
| 2026-10-08 | 0e5648a578b8fcb29d30a94e98c2ab608e492234 | Częściowy przegląd rozdziałów 01, 13 i 15: magazyn dla kart offline (niezależny albo — w gabinecie jednoosobowym — główny), komunikat dla gabinetu wieloosobowego i odświeżanie ustawień konta na urządzeniu. Baza pełnego przeglądu i pochodzenie zrzutów pozostają zapisane osobno. |
| 2026-10-11 | 3751d076e1259ac77f64af37f06b1a559c566a1c | Częściowy przegląd rozdziału 17: wystawianie karty leczenia przez asystenta (potwierdzenie serii leków, polecenie „zapisz”, numer karty po zapisie) oraz wartości domyślne lekarza, daty, godziny, celu leku, drogi podania i dawkowania. Baza pełnego przeglądu i pochodzenie zrzutów pozostają zapisane osobno. |
| 2026-10-12 | 7b03c97c5741102ab77a6ad6efface7be04a5ebd | Częściowy przegląd rozdziału 17: połączenie asystenta z Weterem krok po kroku dla ChatGPT, Claude, Claude Code, Gemini CLI, Antigravity, Grok, VS Code, Cursor, Codex i Perplexity (dokumentacja dostawców z 12.10.2026; Konto asystenta AI, identyfikator klienta, plany), karta z jednego polecenia, usuwanie i poprawka zapisanej karty po numerze i dniu, dyktowanie wywiadu; mapa zadań i intencje wyszukiwania dla tych sekcji. Baza pełnego przeglądu i pochodzenie zrzutów pozostają zapisane osobno. |
| 2026-10-13 | a0c5c61fd9f464a89347d0181e861ed73226ad66 | Częściowy przegląd rozdziałów 03 i 07: pozycja menu Magazyn → „Lista dokumentów” nazywa się „Dokumenty magazynu”, tak jak nagłówek tej listy (Trello 1653). Baza pełnego przeglądu i pochodzenie zrzutów pozostają zapisane osobno. |
| 2026-10-13 | 98adcf7e8995140c0c5eb3163922764c841f3360 | Częściowy przegląd rozdziału 17 (Trello 1627): ChatGPT — link do strony Wtyczki, Wetera nie szuka się w wyszukiwarce wtyczek, Tryb dewelopera, gdy pod „+” są tylko opcje utworzenia i przesłania wtyczki, sprawdzian planu przyciskiem „+” i lista „Gdy Weter nie daje się dodać”; intencja wyszukiwania dla trybu dewelopera. Baza pełnego przeglądu i pochodzenie zrzutów pozostają zapisane osobno. |
| 2026-10-13 | 1df512e1e313db52fcc41afad3c8eab58c561ae1 | Częściowy przegląd rozdziału 17 (Trello 1628, 1629): Claude — krok „Sign in now”, ostrzeżenie przed „Use Claude's published identity” i „Register automatically” („Detected”), komunikaty „Couldn't register with … sign-in service” i „Couldn't reach the MCP server” z rozwiązaniem; intencja wyszukiwania dla komunikatów Claude. Baza pełnego przeglądu i pochodzenie zrzutów pozostają zapisane osobno. |
| 2026-10-13 | 2897f9dc510d9ccb069da4219ffc212de65c09d7 | Częściowy przegląd rozdziału 17: opublikowane tożsamości (CIMD, Keycloak 26.8) — ChatGPT, Claude, Claude Code, VS Code i Codex łączą się bez identyfikatora klienta, `weter-mcp` zostaje dla Gemini CLI, Antigravity, Grok, Cursor i Perplexity oraz jako zapas; kroki zgodne z zakładkami kreatora. Baza pełnego przeglądu i pochodzenie zrzutów pozostają zapisane osobno. |
| 2026-10-13 | 0d004cbd371f741f5b0c857aefc50bf7d7a35777 | Częściowy przegląd rozdziału 17: nazwy przycisków i pól programów AI po polsku z angielską nazwą w nawiasie (ChatGPT: strona Wtyczki, „Szukaj wtyczek”, Dodaj → „Dodaj niestandardowy serwer MCP”, Tryb deweloperski) i po angielsku ze znaczeniem w nawiasie tam, gdzie program nie ma polskiego interfejsu (Claude, Antigravity, Grok, Perplexity); intencje wyszukiwania i mapa zadań dla „Dodaj niestandardowy serwer MCP” i „tryb deweloperski”. Baza pełnego przeglądu i pochodzenie zrzutów pozostają zapisane osobno. |
| 2026-10-14 | d6289b059b9ed4c8fdcad4ba3b3bcd662ea0d7c0 | Częściowy przegląd rozdziału 20 (Trello 1659): „Nie pamiętasz loginu lub hasła?” — wiadomość z loginem i odnośnikiem do ustawienia hasła, osobny odnośnik dla każdego aktywnego konta adresu, login na stronie odnośnika, rejestracja z zajętym adresem e-mail; intencje wyszukiwania dla zapomnianego loginu. Baza pełnego przeglądu i pochodzenie zrzutów pozostają zapisane osobno. |
| 2026-10-16 | 76480d52c35338117fe5e66fe6b32b9add2e38c2 | Częściowy przegląd sekcji Gemini w rozdziale 17 (Trello 1670): polska wersja i ograniczenia własnych aplikacji, instalacja Antigravity, pobieranie konfiguracji w kreatorze, logowanie kontami Google i Wetera oraz osobny wariant Gemini CLI. Dokumentacja Google z 16.10.2026 i lokalne zmiany na gałęzi fix/1670-gemini-instructions; podany commit jest bazą poprawki. Pełne logowanie z rzeczywistym kontem pozostaje do weryfikacji. |
| 2026-10-16 | 7f6d0699d5b63ffaa87c521da8c590906f05983e | Częściowy przegląd instrukcji asystentów: polskie nazwy Groka zgodne z kreatorem (Trello 1668), oba warianty logowania i polecenia Claude Code, spójna mapa zadań i opis intencji Claude. Instrukcja Gemini z Trello 1670 jest już scalona. Bez ponownej weryfikacji planów dostawców ani rzeczywistego logowania. |
| 2026-10-16 | e2fdf0ba9d31f307b26ffda9f5df1b64a353e186 | Częściowy przegląd przed wydaniem: rozdziały 02, 05, 07, 08, 12, 16, 17 i 21; karty robocze i zadania MCP, statusy SMS, finanse klienta, przypisanie polityki, dostęp modułów, pula kodów i Opcje leku. Mapa obejmuje 71 narzędzi i 32 zadania. Baza pełnego przeglądu oraz daty zrzutów pozostają bez zmian. |
| 2026-10-17 | 401d1fc494cd91e72751913ec254a1a459ab96a3 | Częściowy przegląd rozdziałów 06 i 07: szczegółowy opis poprawionego okna karencji — sposoby, dane karty, wybór pozostałych wpisów, potwierdzenia i walidacja. Bez nowego pełnego przeglądu pozostałych rozdziałów. |
| 2026-10-18 | e0f271280b6fec6e70eee30de87d9fe29bae31c7 | Nowe zrzuty okna Ustalenie okresu karencji w rozdziale 06 (okno główne, Tylko dla tej karty, Pozostałe okresy karencji leku, Dodaj okres karencji) i zakładki Okresy karencji leku w rozdziale 07; rozdział 07 nazywa wartości ogólne **Wszystkie gatunki** i **Wszystkie drogi podania** oraz przyciski zakładki leku. Bez nowego pełnego przeglądu pozostałych rozdziałów. |

## Jak znaleźć odpowiedź

Pole **Znajdź odpowiedź** jest na każdej stronie przewodnika. Wpisz nazwę czynności lub krótkie pytanie, na przykład „tworzenie konta”, „jak dodać pracownika” albo „wydruk karty”. Wyniki prowadzą do konkretnego miejsca w instrukcji.

Wyszukiwarka rozpoznaje popularne określenia i odmiany słów; polskie znaki nie są wymagane. Zakładanie konta placówki i dodawanie pracownika to osobne czynności. Przy ogólnym pytaniu mogą pojawić się obie instrukcje — wybierz tę, która pasuje do Twojej sytuacji.

Jeżeli nie znajdziesz odpowiedzi, spróbuj krótszej nazwy czynności albo wybierz obszar ze spisu treści. Wyszukiwarka przeszukuje ten przewodnik; nie sprawdza danych na Twoim koncie i nie układa nowych odpowiedzi.

## Wersje dla ludzi i agentów

Źródłem treści są pliki **Markdown** w `md/`. Strony HTML oraz indeksy powstają z tych samych plików. Dzięki temu instrukcja na stronie i wersja odczytywana przez agenta mają tę samą treść.

W `weter-site/przewodnik/` generator przygotowuje:

- stronę startową z obszarami, ścieżkami nauki i wyszukiwarką;
- osobny HTML i Markdown dla każdego rozdziału, ze stałymi adresami i kotwicami;
- lokalny indeks `llms.txt`, pełny tekst `llms-full.txt` oraz indeks sekcji `search-index.json`;
- mały `sections-index.json` z tytułami i metadanymi rozdziałów, bez pełnych tekstów;
- `agent/tasks.json` oraz `agent/tasks.md` z połączeniem zadania, adresu ekranu, sekcji przewodnika i narzędzi MCP, łącznie z zakresem dostępu, skutkiem zapisu i ograniczeniami;
- katalog obszarów, metadane i mapę źródeł dla agentów.

Wyszukiwarka w przeglądarce ładuje pełny tekst dopiero przy pierwszym pytaniu. Korzysta z pliku skryptu, dzięki czemu działa także przy lokalnym otwarciu strony przez `file://`. Bez JavaScript nadal dostępne są spis rozdziałów i pełne instrukcje. Pytania, odmiany i sprawdzone kierowania do sekcji mają jedno źródło: `search-intents.json`; ten sam plik jest pakowany do dokumentacji MCP.

## Zrzuty ekranów

W przewodniku znajduje się **94 zrzuty rzeczywistych ekranów**: od logowania i menu po magazyn, dokumenty, ustawienia i pracę bez internetu. Podpis pod obrazem wyjaśnia, co widać. Wybierz **Powiększ zrzut ekranu**, jeżeli potrzebujesz przeczytać drobne napisy. Nazwy osób, zwierząt i lecznicy oraz widoczne dane są przykładami. Na Twoim koncie zawartość list i dostępne przyciski mogą się różnić, zależnie od uprawnień i ustawień.

Obrazy przygotowano z pełnej aplikacji uruchomionej w osobnym środowisku. **Wersja kodu zrzutów: `20cf78ccdcd81221f24765d9a2d34c3fe0f1127f`, opublikowany `develop` Weter, 2026-10-02.** Zrzuty okna karencji na karcie i zakładki **Okresy karencji** leku wykonano ponownie na `e0f271280b6fec6e70eee30de87d9fe29bae31c7` (`develop`, 2026-10-18). Baza pełnego przeglądu tekstu pozostaje wskazana wyżej. Daty wykonania oraz wersje poszczególnych obrazów znajdują się w [manifeście zrzutów](images/screenshots.json).

Zrzuty są zapisane jako WebP w kilku szerokościach, bez powiększania oryginału. Strona wybiera odpowiedni rozmiar i ładuje obrazy w miarę przewijania. Wymiary są zapisane w HTML, aby pojawienie się obrazu nie przesuwało tekstu. Oryginalne PNG nie są publikowane. Opisy alternatywne, podpisy i dane `ImageObject` pomagają odczytać kontekst obrazu; indeks sekcji udostępnia te same informacje agentom.

Przy następnej zmianie interfejsu porównaj także wersję zrzutu z nowym kodem. [Instrukcja aktualizacji obrazów](agent/maintenance.md#aktualizacja-zrzutow-ekranu) opisuje format manifestu i sprawdzenia.

## Dostęp do przewodnika

Od 2026-10-18 przewodnik jest indeksowany przez wyszukiwarki (decyzja właściciela): strony HTML mają `index,follow`, a generator tworzy `przewodnik/sitemap.xml` (strona główna przewodnika i rozdziały publiczne, `lastmod` = `reviewed_at`), wskazaną w `robots.txt` witryny. Kopie Markdown, JSON i tekst zachowują nagłówek `X-Robots-Tag: noindex, follow`, aby nie dublować stron HTML. Podgląd VPN (`private/przewodnik/`) pozostaje w całości `noindex`. Przewodnik nie ma pozycji w głównym menu witryny; prowadzą do niego pomoc `?` w aplikacji, odnośniki ze stron produktu, główny `llms.txt` i mapa `agent/catalog.json`. Ponieważ wyszukiwarki i modele AI pokazują treść ekranów, przewodnik trzeba przebudowywać przy każdym wdrożeniu strony.

Bezpośredni adres nie wymaga osobnego uwierzytelnienia. Brak linku w publicznym menu nie stanowi ograniczenia dostępu.

## Sprawdzenie i budowanie

Z katalogu `weter-docs`:

```bash
python3 przewodnik/build-site.py --check
python3 przewodnik/build-site.py
python3 przewodnik/build-site.py --check-built
python3 -m unittest discover -s przewodnik/tests
```

Z katalogu `weter-site`:

```bash
./build-dist.sh --skip-blog
```

Walidacja sprawdza pliki, kotwice, spójność katalogu i gotowych stron. Budowanie strony nie jest jej wdrożeniem. Do wdrożenia przygotowany jest katalog `dist/` witryny, zgodnie z instrukcjami `weter-site`.

Skrypty nie tworzą PDF-ów. Stary spis treści wskazywał narzędzia i pliki PDF, których nie było w repozytorium. Bieżąca dokumentacja obejmuje faktycznie przygotowane Markdown i HTML.

## Stara nazwa i pozostałe dokumenty

Głównym miejscem tego przewodnika jest `przewodnik/`. Dawny katalog `funkcjonalnosci/` zawiera odnośniki do nowych plików i służy zachowaniu wcześniejszych ścieżek.

`user-docs/` zawiera także krótsze instrukcje. Generator dokumentacji MCP pobiera rozdziały tego przewodnika dla użytkowników lecznicy i hodowcy, wspólne intencje wyszukiwania oraz mapę zadań. Rozdział 23, przeznaczony dla obsługi systemu, pozostaje poza pomocą kliniczną MCP. Gotowe krótsze instrukcje są materiałem uzupełniającym. Zmiana źródeł wymaga przebudowania zbioru dokumentacji w `weter/mcp-server`; sprawdzenie świeżości tego zbioru jest częścią kontroli trzech repozytoriów. W razie rozbieżności sprawdź rzeczywiste zachowanie aplikacji i metadane przeglądu dokumentu.