========================================================================
  CST Installer V2
  Interni nastroj pro hromadny deployment a diagnostiku Ricoh MFD zarizeni
========================================================================

------------------------------------------------------------------------
RYCHLY START
------------------------------------------------------------------------

  1. Rozbal archiv do slozky TDT
     (tam kde je java\, lib\, terminaldeploymenttool.bat)
  2. Spust CST_Installer_V2.exe
  3. V zalozce Settings zadej Cloud URL a API klic, nastav Network Profile
  4. V zalozce Network Scan prohledej subnet a pridej tiskarny
  5. V zalozce Deployment spust Install / Configure / Verify

  POZOR: Pokud chybi slozky java\ nebo lib\, aplikace nastartuje
  v Diagnostics Mode - Network Scan a Deep Scan funguji, ale deployment
  je zablokovany. Viz sekce nize.

------------------------------------------------------------------------
OBSAH
------------------------------------------------------------------------

  - Co to dela
  - Diagnostics Mode (bez TDT)
  - Network Profiles
  - Doporuceny provozni baseline
  - Konfigurace
  - Klavesove zkratky
  - Technicky prehled
  - Limity
  - Prehled zmen oproti stare verzi

------------------------------------------------------------------------
CO TO DELA
------------------------------------------------------------------------

  Jeden nastroj pokryva cely provozni cyklus:

  Network Scan -> Probe -> Deep Scan -> Install / Configure -> Verify -> Troubleshooting

  Sekce          Funkce
  ----------     --------------------------------------------------------
  Deployment     Install, Configure, Uninstall, Restart, Probe, Verify
  Network Scan   CIDR nebo rozsah IP, Quick Add Single Device, import ze souboru
  Deep Scan      SNMP diagnostika: model, SN, MAC, uptime, counter, alerty,
                 tonery, zasobniky
  Settings       Cloud URL, API klic, card reader, network profil,
                 bezpecnostni volby

------------------------------------------------------------------------
DIAGNOSTICS MODE (BEZ TDT)
------------------------------------------------------------------------

  Pokud spustis EXE bez TDT baliku (chybi java\, lib\, terminaldeploymenttool.bat):

  - Aplikace nastartuje normalne a zobrazi informacni dialog.
  - Network Scan a Deep Scan funguji plne (ciste SNMP/Python, Java nepotrebuji).
  - Probe funguje (SNMP).
  - Install, Configure, Uninstall, Restart, Verify jsou zablokovane
    s vysvetlujici hlasou.

  Hodi se pro kolegy, kteri potrebuji jen diagnostikovat tiskarny
  u zakaznika bez nahravani terminalu.

------------------------------------------------------------------------
NETWORK PROFILES
------------------------------------------------------------------------

  V Settings -> Network profile:

  Profil                    Safe  PJL  Delay  Vlakna  Kdy pouzit
  -------                   ----  ---  -----  ------  ----------------------------
  Balanced (Recommended)     ANO  NE   80 ms    6     Bezny provoz u zakaznika
  Strict VPN                 ANO  NE  140 ms    4     Pomala / citliva VPN linka
  Fast LAN                   NE   NE   20 ms   12     Interni trustovana LAN
  Diagnostic (PJL allowed)   NE   ANO   0 ms   12     Hluboke testovani, ne u zak.
  Custom                  dle nastaveni           Rucni kombinace

  VYCHOZI PROFIL PO PRVNIM SPUSTENI JE BALANCED.
  Pokud jsi u zakaznika, nemen na Fast LAN ani Diagnostic bez rozmyslu -
  SNMP flood muze vyvolat alert v jejich IPS/SOC.

------------------------------------------------------------------------
DOPORUCENY PROVOZNI BASELINE
------------------------------------------------------------------------

  Safe Network Mode : ZAPNUTO
  PJL fallback      : VYPNUTO
  Threads           : 4-8 (dle lokality)
  Scan delay        : 80-150 ms (VPN)  /  20-80 ms (interni LAN)

------------------------------------------------------------------------
KONFIGURACE
------------------------------------------------------------------------

  Nastaveni se uklada do config.json.
  (vznikne automaticky pri prvnim Save Settings, nebo zkopiruj
   config.json.example a prejmenuj ho)

  Citliva data (heslo, API klic):
    - Vychozi: save_sensitive = false -> hesla se do config.json neukladaji.
    - Pokud zapnes ukladani, sdilej config.json jen v zabezpecenem kanalu.

  Logy:
    - Aplikacni log: logs\deployment.log (rotujici, max 5 MB x 3 zalohy)
    - Hesla a API klice jsou v logu vzdy maskovany jako ******

------------------------------------------------------------------------
KLAVESOVE ZKRATKY
------------------------------------------------------------------------

  Zkratka              Akce
  -------              -------------------------------------
  Ctrl+F               Filtrovat seznam zarizeni
  F5                   Probe vybranych / vsech zarizeni
  Ctrl+S               Ulozit nastaveni
  Escape               Zastavit bezici operaci
  Ctrl+A               Vybrat vse v seznamu
  Prave tlacitko mys   Kontextove menu (Deep Scan, Copy IP/SN, Kill process...)

------------------------------------------------------------------------
TECHNICKY PREHLED
------------------------------------------------------------------------

  - Platforma:    Python 3.13 + CustomTkinter, kompilovaný PyInstaller
                  OneDir (~30 MB)
  - Deployment:   Asynchronni HTTP klient -> lokalni TDT API Server
                  (port 7312). Fallback na prime CLI volani Javy.
  - SNMP:         Asynchronni dotazy (asyncio), tabulkove OID walky.
  - PJL fallback: Volitelny port 9100 probe pro model/SN
                  (pouze mimo Safe mode)
  - Izolace proc: TDT API Server bezi jako jeden Java proces na pozadi -
                  zadne stovky .bat subprocesů na tiskarnu.
                  Drasticka uspora RAM a CPU.
  - Log routing:  Stdout Javy se cte v realnem case a routuje do GUI
                  per-IP. Citliva data jsou maskovana pred predanim
                  do callbacku i pred zapisem na disk.

------------------------------------------------------------------------
LIMITY
------------------------------------------------------------------------

  - Dostupnost OID zavisi na modelu Ricoh a verzi FW
    (lokalni SNMP nastaveni).
  - Nektere modely neposkytují software/app inventory pres SNMP.
  - PJL informace mohou byt filtrovany bezpecnostni politikou zarizeni.
  - Verify vyzaduje TDT komponenty (spousti Javu) -
    v Diagnostics Mode neni dostupny.

------------------------------------------------------------------------
PREHLED ZMEN OPROTI STARE VERZI
------------------------------------------------------------------------

  CO JE NOVE:

  - Diagnostics Mode - aplikace startuje i bez TDT slozek,
    Network Scan a Deep Scan jsou plne funkcni.
  - Network Profiles - jednim klikem nastavis cele sitove chovani.
  - Safe Network Mode (vychozi zapnuty) - SNMP-first, pacing + jitter,
    ochrana pred nechtěnym skenem verejnych IP.
  - Quick Add Single Device - pridani jednoho stroje s okamzitym
    background probe.
  - Deep Scan prepracovany na ciste SNMP: model, SN, MAC, uptime,
    counter, alerty, tonery, zasobniky, doporucene akce.
  - Klavesove zkratky a kontextove menu (Copy IP, Copy SN,
    Kill process, Deep Scan).
  - Sidebar Dashboard se stavem operace a Session Cards
    pro Export/Load Config.

  CO ZUSTALO KOMPATIBILNI:

  - Hlavni logika nasazeni pres TDT (install, configure, uninstall, restart).
  - Konfigurace card readeru (VID/PID, preset) a Home Key mode.
  - Export CSV.
  - Kontextove operace nad seznamem zarizeni.

------------------------------------------------------------------------
VERZE
------------------------------------------------------------------------

  Verze:              V2.0
  Build vystup:       CST_Installer_V2.exe (PyInstaller OneDir, ~30 MB)
  Doporucene nasazeni u zakaznika: Safe Network Mode = ON, profil Balanced

========================================================================
