HS Farm · katalog i serwis GRIMME · wersja 2

Jak działa tryb offline i online

Jedna aplikacja żyje w dwóch miejscach: na serwerze firmowym i na laptopach serwisantów w terenie. Ta instrukcja wyjaśnia, co skąd się bierze, co działa bez internetu i jak dane wracają do siebie po powrocie zasięgu.

1Dwa światy, jedna aplikacja

🌐Online — serwer

vps.hsfarm.pl

zawsze aktualny katalog: 1 226 modeli, 5,4 mln części, rysunki, cennik, tłumaczenia,
tu logują się klienci (e-mail + hasło) i tu trafiają ich zgłoszenia usterek,
panel administratora: konta, urządzenia, aktualizacja katalogu z GRIMME,
punkt zbiorczy synchronizacji — praca wszystkich laptopów spływa tutaj.

💼Offline — laptop / tablet

localhost:8085 (na urządzeniu)

pełna kopia katalogu i wszystkich rysunków na dysku — działa w polu, bez zasięgu,
logowanie: nazwisko z listy + PIN (bez e-maila),
wyceny i protokoły z podpisem klienta powstają lokalnie,
po powrocie zasięgu wszystko samo wysyła się na serwer.

Obie strony to ten sam program — różni je tylko to, skąd biorą dane. Serwer trzyma dane robocze w bazie serwerowej; laptop wozi swoje w trzech plikach: katalog.db (części), rysunki.db (rysunki i kółka) i serwis.db (Twoja praca — jedyny plik, który się synchronizuje).

2Co działa gdzie

Funkcja	Online (serwer)	Offline (laptop bez sieci)
Katalog części: przeglądanie, wyszukiwarka, „gdzie użyto"	✓	✓
Rysunki z kółkami numerów (klik w część ↔ kółko na rysunku)	✓	✓ z `rysunki.db`
Tłumaczenia PL + ręczne poprawki (ołówek ✎)	✓	✓ poprawka dojedzie z synchronizacją
Wyceny napraw (części + usługi)	✓	✓
Protokoły serwisowe z podpisem klienta	✓	✓ podpis na ekranie, bez sieci
Podświetlanie części pasujących do maszyny klienta	✓	✓ dane maszyn są w `serwis.db`
Dodanie nowej maszyny po numerze seryjnym	✓	wymaga internetu*
Zgłoszenia usterek — złożenie przez klienta	✓ klient loguje się na serwer	— klient nie ma dostępu do laptopa
Zgłoszenia usterek — obsługa przez serwisanta (podgląd, przejęcie, wycena)	✓	✓ zgłoszenia przywozi synchronizacja
Wysłanie oferty e-mailem do klienta	✓	wymaga internetu*
Synchronizacja z serwerem	—	wymaga internetu*

* „Wymaga internetu" znaczy tylko tyle: poczeka. Rozpoznanie numeru seryjnego pyta na żywo katalog GRIMME, a wysyłka danych rusza sama, gdy laptop złapie sieć — nic nie przepada i niczego nie trzeba powtarzać.

3Dzień pracy na laptopie

Włączasz komputer→ aplikacja startuje sama→ nazwisko + PIN→ praca w terenie, także bez zasięgu→ powrót do sieci: dane wysyłają się same

Nic nie zapisujesz ręcznie. Wersja robocza protokołu zapisuje się w trakcie pisania; po nagłym wyłączeniu komputera aplikacja wraca do przerwanej pracy komunikatem „Masz niezapisaną pracę".
Rysunek jest zawsze na widoku. Panel z rysunkiem „przykleja się" do góry ekranu przy przewijaniu listy części — tak samo online i offline.
Synchronizacja biegnie sama co minutę w tle. Ręcznie wymuszasz ją przyciskiem „Synchronizuj" obok kropki stanu w nagłówku panelu.

Kropka stanu w nagłówku

Zielona — serwer ma już całą Twoją pracę. Możesz zamknąć komputer.
Pomarańczowa — coś czeka na wysłanie. Wyśle się samo po powrocie zasięgu; liczba obok mówi, ile zmian czeka.
Szara — brak połączenia z serwerem. Pracujesz normalnie dalej.

4Synchronizacja — jak dane wracają do siebie

Laptop i serwer wymieniają się stanem rekordów, nie historią klikania: najpierw laptop wysyła swoją pracę (protokoły, wyceny, poprawki tłumaczeń), potem pobiera zmiany innych. Powtórzenie synchronizacji niczego nie psuje.

Numery dokumentów się nie gryzą. Każde urządzenie ma własny numer i własną pulę: protokół to PS-rok-urządzenie-kolejny, np. PS-2026-03-0007 z laptopa nr 3. Dwa laptopy bez zasięgu nigdy nie wystawią tego samego numeru.
Przy konflikcie wygrywa nowsza wersja, a odrzucona trafia do przejrzenia w panelu administratora (zakładka Synchronizacja) — nic nie znika po cichu.
Podpisany protokół jest nietykalny. Dokumentu z podpisem klienta nie nadpisze ani synchronizacja, ani edycja w aplikacji. Próba kończy się wpisem w konfliktach do przejrzenia.

Zgubiony lub skradziony sprzęt

Zgłoś administratorowi. Jeden przycisk „Odłącz" w panelu unieważnia token urządzenia — laptop traci możliwość wymiany danych z serwerem od następnej próby synchronizacji.

5Skąd laptop ma dane i jak się aktualizują

Plik	Co zawiera	Jak się zmienia
`serwis.db`	Twoja praca: konta, maszyny klientów, wyceny, protokoły, poprawki tłumaczeń	Synchronizacja — automatycznie, co minutę przy zasięgu
`katalog.db`	Katalog GRIMME: modele, części, cennik, słownik tłumaczeń	Podmiana pliku przy aktualizacji katalogu (np. nowe roczniki) — pobierana z serwera plików
`rysunki.db`	Wszystkie rysunki techniczne i dane kółek — jeden plik zamiast setek tysięcy	Jak wyżej; nowego rysunku spoza pliku aplikacja spróbuje dociągnąć z sieci, gdy jest zasięg

Ręczna poprawka tłumaczenia (ołówek ✎ przy nazwie, dla serwisanta i administratora) zapisuje się do serwis.db — dlatego przeżywa każdą aktualizację katalogu i sama rozjeżdża się na serwer oraz pozostałe laptopy. Puste pole przy poprawce znaczy „pokaż oryginał angielski".

6Instalacja i dostęp nowego urządzenia

pliki.hsfarm.pl → instalator→ kreator: tylko imię i nazwisko→ pobranie danych (~9,5 GB)→ administrator zatwierdza jednym kliknięciem→ synchronizacja rusza sama

Instalator pobiera się ze strony pliki.hsfarm.pl (strona jawna; hasło — kod instalacyjny — potrzebne dopiero przy pobieraniu plików) i sam zgłasza komputer na serwer — żadnych tokenów nie trzeba przepisywać. Administrator widzi w panelu nazwę komputera i osobę.
Do zatwierdzenia aplikacja działa normalnie, tylko nie wymienia danych. Stan sprawdzisz na stronie „Pierwsze uruchomienie" przyciskiem „Sprawdź dostęp do serwera" (✅ zatwierdzone / ⏳ czeka).
Zerwane pobieranie danych wznawia się od miejsca przerwania — uruchom instalację ponownie albo plik pobierz_dane.ps1 z folderu aplikacji.
PIN-y do logowania nadaje administrator przy kontach serwisantów; PIN jest sprawą urządzenia i nie podróżuje przez synchronizację.

7Gdy coś nie gra

Objaw	Co to znaczy i co zrobić
„Urządzenie czeka na zatwierdzenie przez administratora"	Normalny stan po instalacji — daj znać administratorowi, zatwierdzenie to jedno kliknięcie. Pracować możesz od razu.
„Port 8085 jest już zajęty"	Aplikacja najpewniej już działa (wystartowała z Windows) — otwórz ją ikoną GRIMME Serwis z pulpitu.
Kropka długo pomarańczowa mimo zasięgu	Kliknij „Synchronizuj" i przeczytaj komunikat. „Odłączone przez administratora" = sprzęt został odcięty — kontakt z administratorem.
Rysunek się nie ładuje offline	Pojedyncze, bardzo świeże rysunki mogą nie być jeszcze w `rysunki.db` — dociągną się przy zasięgu. Komplet wraca z aktualizacją pliku rysunków.
Nowa maszyna po serialu nie chce się dodać w polu	Rozpoznanie numeru seryjnego pyta katalog GRIMME na żywo — dodaj maszynę po powrocie do sieci albo wybierz model ręcznie z listy.

Zasada nadrzędna

Brak internetu nigdy nie blokuje pracy i nigdy nie kasuje danych. Wszystko, co zrobisz offline, jest zapisane lokalnie i wyjedzie na serwer przy pierwszej okazji — a podpisanego dokumentu nie ruszy nikt i nic.