============================================================
  estymat — program do analizy transakcji i wyceny nieruchomości
  INSTRUKCJA INSTALACJI I AKTYWACJI
============================================================

1. WYMAGANIA
------------------------------------------------------------
- Windows 10/11 (64-bit)  LUB  macOS 12 lub nowszy
- Połączenie z internetem (do pobierania danych geodezyjnych
  z publicznych geoportali i ULDK). Program nie wysyła Twoich
  danych transakcyjnych, wycen ani danych klientów — wysyła
  jedynie minimalne dane diagnostyczne (typ zdarzenia, wersja
  programu, fingerprint maszyny). Można je wyłączyć w
  Ustawieniach → "Diagnostyka i komunikacja z producentem".
- Ok. 1 GB wolnego miejsca na dysku.


2. INSTALACJA
------------------------------------------------------------
WINDOWS:
  1. Rozpakuj otrzymany plik ZIP w dowolnym, ZAPISYWALNYM miejscu
     (np. Pulpit albo Dokumenty — NIE w "Program Files").
  2. Wejdź do rozpakowanego folderu i uruchom  estymat.exe
  3. Jeśli Windows pokaże ostrzeżenie "Windows chronił komputer":
     kliknij "Więcej informacji" → "Uruchom mimo to".

macOS:
  1. Rozpakuj otrzymany plik ZIP (dwuklik).
  2. Przeciągnij  estymat.app  do folderu Programy (lub zostaw na Pulpicie).
  3. PRAWY KLIK na estymat.app → "Otwórz" → w okienku ponownie "Otwórz".
     (Tylko za pierwszym razem — aplikacja nie jest jeszcze podpisana
      certyfikatem Apple, dlatego zwykły dwuklik może ją zablokować.)

  Jeśli macOS NIE daje opcji "Otwórz" (nowsze wersje, np. Sequoia):
     - Spróbuj uruchomić aplikację (dwuklik) — pojawi się ostrzeżenie.
     - Wejdź:  Menu Apple  →  Ustawienia systemowe  →  Prywatność i ochrona
     - Przewiń na dół do sekcji "Ochrona" — będzie komunikat o zablokowaniu
       "estymat" i przycisk  "Otwórz mimo to"  → kliknij go i potwierdź.
     - To wystarczy raz; potem aplikacja otwiera się normalnie.


3. PIERWSZE URUCHOMIENIE — WERSJA PRÓBNA (DEMO)
------------------------------------------------------------
Bez pliku licencji program działa jako WERSJA PRÓBNA:
  - 7 dni od pierwszego uruchomienia
  - PEŁNE funkcje (import, baza, MPnP, MKĆŚ, regresja, operat)
  - limit 5000 transakcji w bazie
W tytule okna widać: [WERSJA PRÓBNA — X dni].
Po 7 dniach zostaje tylko eksport własnych danych — aż do aktywacji.

WSKAZÓWKA: dane transakcji pobierasz sam(a) z geoportalu (Import).
Zalecany format: GML.


4. ZAKUP I AKTYWACJA PEŁNEJ WERSJI
------------------------------------------------------------
Krok 1. Uruchom program i wejdź:  Pomoc → Twoja licencja.
        Odczytaj swoje "ID maszyny" (fingerprint).

Krok 2. Wyślij to ID na adres:  kontakt@estymat.pl
        (podaj też imię/nazwisko lub firmę i wybrany moduł:
         BAZA = import + baza,  PRO = wszystko + wyceny i operat).

Krok 3. Otrzymasz mailem plik licencji  .lic

Krok 4. W programie:  Pomoc → Wczytaj licencję  → wskaż plik .lic
        (albo skopiuj plik do folderu  ~/.estymat/  jako licencja.lic)

Krok 5. Uruchom program ponownie — w tytule okna pojawi się
        Twoje imię i nazwa modułu. Funkcje są odblokowane.

Licencję można wystawić na 2 urządzenia (np. komputer + laptop) —
podaj wtedy ID obu maszyn.


5. ANTYWIRUS / WINDOWS DEFENDER — WAŻNE (PRZECZYTAJ RAZ)
------------------------------------------------------------
Aplikacja działa NIEZALEŻNIE od systemowego Pythona, bibliotek czy
aktualizacji Windows. Comiesięczne aktualizacje, feature update
(np. 23H2 → 24H2) ani upgrade Win10 → Win11 NIE wpływają na program
ani Twoją licencję.

ALE: Windows Defender ORAZ antywirusy firm trzecich (Avast, AVG,
Norton, McAfee itd.) mogą uznać estymat.exe za podejrzany. To
FAŁSZYWY ALARM — typowy dla aplikacji bez komercyjnego podpisu
cyfrowego (nie tylko naszej). Program NIE jest wirusem.

  Typowe komunikaty:
    - "Wykryto zagrożenie" / "Win64:MalwareX-gen" / "WS.Reputation"
    - aplikacja zniknęła z folderu (trafiła do kwarantanny)
    - "Aplikacja zablokowana przez administratora"
    - antywirus zablokował POBIERANIE pliku z internetu

>>> ZALECANE OD RAZU PRZY PIERWSZEJ INSTALACJI: dodaj DWA wyjątki.
    Dzięki nim NIE tylko ta instalacja, ale i przyszłe AUTOMATYCZNE
    aktualizacje przejdą bez blokad.

  WYJĄTEK 1 — FOLDER z aplikacją (chroni podmianę plików przy update):
    • Windows Defender: Windows Security → "Ochrona przed wirusami
      i zagrożeniami" → "Zarządzaj ustawieniami" → "Wykluczenia" →
      "Dodaj wykluczenie" → "Folder" → wskaż folder z estymat.exe.
    • Avast/AVG: Menu → Ustawienia → Ogólne → Wyjątki (Blokowane
      i dozwolone) → Dodaj wyjątek → wskaż folder z estymat.exe.
    • Norton: Ustawienia → Antywirus → Skany i zagrożenia →
      "Elementy wykluczone ze skanowania" → Konfiguruj → Dodaj folder.

  WYJĄTEK 2 — DOMENA (chroni pobieranie aktualizacji z sieci):
    Dodaj do zaufanych / wykluczeń stron:
        estymat.pl    oraz    api.estymat.pl
    • Avast/AVG: Ustawienia → Ochrona → Osłona sieci Web (Web Shield)
      → Wyjątki / Dozwolone adresy → dodaj oba adresy.
    • Norton: Ustawienia → Zapora / Bezpieczne przeglądanie →
      wyłącz chwilowo "Analiza pobierania" LUB dodaj witrynę do zaufanych.

  JEŚLI PLIK JUŻ TRAFIŁ DO KWARANTANNY (zniknął):
    1. Wejdź w Kwarantannę / Historię ochrony antywirusa.
    2. Znajdź wpis "estymat" → "Przywróć" (Restore).
    3. Dodaj do wyjątków (jak wyżej), żeby nie blokował ponownie.

DOCELOWO: pracujemy nad komercyjnym PODPISEM CYFROWYM aplikacji —
po jego wdrożeniu te alarmy znikną całkowicie i nie trzeba będzie
dodawać wyjątków.

W razie wątpliwości napisz: kontakt@estymat.pl — pomogę zdalnie
(TeamViewer) w 5 minut.


6. ZMIANA SPRZĘTU / REINSTALACJA WINDOWS — RE-AKTYWACJA LICENCJI
------------------------------------------------------------
Licencja jest powiązana z konkretnym komputerem (ID maszyny).
ZWYKŁE aktualizacje Windowsa NIE zmieniają tego ID — licencja
działa dalej.

ID maszyny zmienia się TYLKO w tych sytuacjach:
  - czysta reinstalacja Windows ("Resetuj komputer" → "Usuń
    wszystko" lub instalacja z pendrive),
  - wymiana płyty głównej,
  - klonowanie systemu na inny komputer.

Jeśli to się stało, przy próbie aktywacji starej licencji pokaże
się komunikat "Plik licencji nie pasuje do tego komputera".
W oknie błędu jest gotowy przycisk "📧 Napisz do producenta"
— otworzy mejl z wpisanym nowym ID maszyny. Wystarczy wysłać,
otrzymasz nowy plik .lic.


7. AKTUALIZACJA DO NOWSZEJ WERSJI ESTYMATA
------------------------------------------------------------
Twoja baza, oceny, licencja i ustawienia są zapisane POZA folderem
aplikacji — w katalogu ~/.estymat/ (macOS/Linux) lub
%USERPROFILE%\.estymat\ (Windows). Dlatego update to po prostu
PODMIANA folderu aplikacji — nic nie tracisz.

WINDOWS:
  1. Zamknij Estymat.
  2. Skasuj stary folder z aplikacją (lub zmień nazwę na np.
     estymat_OLD\ jeśli wolisz zachować kopię na wszelki wypadek).
  3. Rozpakuj nowy ZIP do tej samej lokalizacji.
  4. Uruchom estymat.exe — wszystko działa dalej.

macOS:
  1. Zamknij Estymat (Cmd+Q).
  2. Przeciągnij stary estymat.app do Kosza.
  3. Rozpakuj nowy ZIP, umieść estymat.app tam, gdzie był stary.
  4. PRAWY KLIK na estymat.app → "Otwórz" → potwierdź (tylko za
     pierwszym razem nowej wersji).

CO PRZEŻYWA AKTUALIZACJĘ (klient NIE traci):
  ✓ baza transakcji (rcn_baza.db)
  ✓ licencja .lic — ten sam plik działa dalej, fingerprint maszyny
    się nie zmienia
  ✓ oceny cech, uwagi własne, sesje wyceny
  ✓ ustawienia (logo, e-mail, www, dane osobowe, foldery eksportu)
  ✓ tytuł okna od razu pokazuje nową wersję

ZALECANE (opcjonalnie) — backup przed aktualizacją:
  - Windows: skopiuj %USERPROFILE%\.estymat\ na pendrive
  - macOS:   skopiuj ~/.estymat/ w bezpieczne miejsce

Nawet bez backupu zadziała — ale dobry nawyk dla spokoju.


8. KONTAKT
------------------------------------------------------------
  e-mail:  kontakt@estymat.pl
  www:     https://estymat.pl
