diff --git a/web/spec/index.html b/web/spec/index.html index eb4cef9..8cc0b8c 100644 --- a/web/spec/index.html +++ b/web/spec/index.html @@ -520,8 +520,8 @@

Specifikace & anotace

- Verze: 0.5 - Datum: 2026-04-21 + Verze: 0.6 + Datum: 2026-04-28 x9/xetup Status: aktivni vyvoj
@@ -599,9 +599,10 @@ 7-Zip (7zip.7zip)OK Adobe Acrobat Reader 64-bit (Adobe.Acrobat.Reader.64-bit)OK OpenVPN Connect (OpenVPNTechnologies.OpenVPNConnect)OK - Atera Agent installInvoke-WebRequest + msiexec /i /qn - Adobe PDF default: .pdf -> AcroRd32 po instalaciOK – UCPD stop/start kolem zápisu asociace - UCPD.sys (kernel driver, od Feb 2024) blokuje UserChoiceReseno: Stop-Service ucpd → HKCR zapis → Start-Service ucpd + Atera Agent installInvoke-WebRequest + msiexec /i /qb – /qb umozni zobrazeni MFA okna + Adobe PDF default: .pdf -> AcroRd32 po instalaciOK – UCPD stop/start kolem zapisu asociace + UCPD.sys (kernel driver, od Feb 2024) blokuje UserChoiceStop-Service ucpd + 2s sleep + overeni zastaveni pred HKCR zapisem + Winget parallel joby: timeout 600s + kill zavislychWait-Job -Timeout 600; po vyprseni Kill + Remove zavislych jobu Winget cesta explicitne predavana do parallel jobuOpraveno – Start-Job nezdedi PATH; winget.exe fullpath preda jako argument. Exit 3010 (success+reboot) nyni vyhodnocen jako OK.
@@ -728,7 +729,7 @@ - + @@ -821,13 +822,13 @@
OA3 BIOS/UEFI klic – kontrola embedded keyWMI: SoftwareLicensingService.OA3xOriginalProductKey
Klic z config.json (activation.productKey)OK – priorita nad OA3 a GVLK
Fallback na GVLK (KMS client key) dle edice OSOK
Fallback na GVLK (KMS client key) dle EditionIDRegistry EditionID (nelokalizovany) misto Win32_OperatingSystem.Caption
Volitelny KMS server (activation.kmsServer)OK
Preskocit pokud jiz aktivovanoOK
Typ klice: MAK vs KMS vs retail?Zavisi na klientovi – otevrena otazka
- +
Instalace NuGet providera + PSWindowsUpdate modulu ze PSGalleryInstall-PackageProvider + Install-Module PSWindowsUpdate -Force
Prvni pruchod aktualizaci (bez rebootu)Install-WindowsUpdate -AcceptAll -IgnoreReboot
X9-WindowsUpdate scheduled task – pokracovani po restartuBezi pri kazdem logonu jako SYSTEM; po pruchodu bez novych update se task sam smaze
Reboot cyklus (exit 9) – pokracovani pres xetup resumeExit 9 = reboot needed; xetup ulozi stav, nastavi autologon + X9-Resume task, restartuje
Automaticky restart po skonceni deploymetu (GUI odpocet)xetup.exe zobrazi 60s odpocet + tlacitka "Restartovat ted" / "Zrusit restart"
- Windows Update typicky vyzaduje vice restartovacich kolu. Prvni pruchod probehne behem deploymetu, - dalsi kola zaridti scheduled task, ktery se po dokonceni sam odregistruje.

- Pozor: Prvni restart spusti jak Windows Update task, tak Dell firmware staging (krok 11). + Windows Update typicky vyzaduje vice restartovacich kolu. Kazdy pruchod skonci exit 9 (dalsi updaty) nebo exit 0 (hotovo). + xetup resume cyklus automaticky opakuje az do uplne aktualizace. Max 5 rebootu na krok (ochrana proti smycce).

+ Pozor: Prvni restart spusti jak Windows Update, tak Dell firmware staging (krok 11).
@@ -881,6 +882,12 @@ Summary s odpoctem a automatickym restartemFaze 3 – 60s odpocet, tlacitka "Restartovat ted" / "Zrusit restart" UAC requireAdministrator (app.manifest + rsrc)Windows vyzada elevaci pri spusteni; ComCtl32 v6 + DPI awareness PowerShell okno skryte na pozadiSysProcAttr.HideWindow = true; PS chyby filtrovane (At line:, CategoryInfo atd.) + Watchdog timer: 30 min ticho = kill skriptutime.AfterFunc s Reset pri kazdem vystupu – zabiji zavisly PS proces + Reboot loop ochrana: max 5 pokusu na krokRetryCounts v state.json; po 5 restartech krok oznacen ERROR a preskocen + Atomicky zapis state.json (write tmp + rename)Prevence korupce pri vypadku napajeni behem zapisu + E-mail report: 3 pokusy + lokalni HTML fallbackBackoff 0/1/5s; vzdy ulozi C:\X9\report.html bez ohledu na SMTP + Hive unload retry (5 pokusu, GC pred kazdym)Prevence "hive in use" chyby pri reg unload ntuser.dat + Resume fix: StepsByIDs nyni nastavuje Enabled=trueOpravena kriticka chyba – resume mode preskakoval vsechny kroky Self-update: stahnout novou verzi z xetup.x9.cz/dlOverit hash pred spustenim config.json: per-klient preset na USBJmeno PC prefix, SW seznam, klic – lezi vedle .exe @@ -888,7 +895,9 @@ Struktura: cmd/xetup/, internal/config/, internal/gui/, internal/runner/

Go zavislosti: github.com/lxn/walk (Win32 GUI), golang.org/x/sys

Build: CGO_ENABLED=1 CC=x86_64-w64-mingw32-gcc GOOS=windows GOARCH=amd64 go build -ldflags="-s -w -H windowsgui" ./cmd/xetup/
- CI (Forgejo Actions) sestavi a publikuje automaticky pri kazdem push na main. + CI (Forgejo Actions) sestavi a publikuje automaticky pri kazdem push na main.

+ Spolehlivost (v0.6): Watchdog zabiji zavisle skripty po 30 min ticha. Reboot-loop ochrana omezi opakovani kazdeho kroku na 5 restartu. + State file se zapisuje atomicky (tmp+rename). E-mail report se zkusi 3x s backoff a vzdy ulozi lokalni HTML kopii.