docs(web): update site - add intro, sync spec with current codebase
Main page: add short intro paragraph describing what xetup does. Spec page: - Remove steps 05 (personalization) and 06 (scheduled-tasks) - both scripts were deleted/merged into step 04 - Merge personalization items into step 04 card, retitle to "Default Profile + Personalizace" - Fix taskbar note: reference to krok 06 replaced with correct info - Fix arch build command: add CGO_ENABLED=1, CC=mingw, -s -w flags - Bump version to 0.5, date to 2026-04-17 - Remove step-05 and step-06 from JS STEP_SCRIPT mapping descriptions.json: - Update atera-agent-install: reflect download approach + MFA window - Remove stale 05-personalization and 06-scheduled-tasks entries Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
X9 Dev
parent
3645088bbb
commit
e57fd6c5f2
3 changed files with 27 additions and 87 deletions
|
|
@ -28,7 +28,7 @@
|
|||
"7-zip-7zip-7zip": "Installs 7-Zip (winget ID: 7zip.7zip). Used for archive management. Silent install with --accept-package-agreements --accept-source-agreements flags required for unattended deployment.",
|
||||
"adobe-acrobat-reader-64-bit-adobe-acroba": "Installs Adobe Acrobat Reader DC 64-bit (Adobe.Acrobat.Reader.64-bit). Required as the default PDF viewer to prevent Edge from handling PDFs in browser mode, which limits functionality.",
|
||||
"openvpn-connect-openvpntechnologies-open": "Installs OpenVPN Connect client. Used for client VPN access when the client network requires a VPN. The ovpn profile and credentials are configured separately per client.",
|
||||
"atera-agent-install": "Atera RMM agent installed via msiexec /qn. Download: Invoke-WebRequest from https://x9.servicedesk.atera.com/api/utils/agent-install/windows/?cid=31&aeid=50b72e7113e54a63ac76b96c54c7e337. Agent enables MSP monitoring, remote access, and ticketing integration with the Atera dashboard.",
|
||||
"atera-agent-install": "Downloads Atera MSI from x9.servicedesk.atera.com and installs via msiexec /qn. During install the Atera MSI shows an interactive MFA window - the technician enters the 2FA code to complete agent registration. Agent enables MSP monitoring, remote access, and ticketing integration with the Atera dashboard.",
|
||||
"adobe-pdf-default-pdf-acrord32-po-instal": "Sets .pdf -> AcroRd32 file association after Acrobat install via HKCR (system-wide, no UserChoice hash issue). UCPD driver is stopped immediately before the write and restarted after to ensure the association persists across Edge updates.",
|
||||
"ucpd-sys-kernel-driver-od-feb-2024-bloku": "UCPD.sys (User Choice Protection Driver) is stopped before the PDF association write and restarted after. Pattern: Stop-Service ucpd -> set HKCR\\.pdf -> Start-Service ucpd. Implemented in this script."
|
||||
}
|
||||
|
|
@ -74,27 +74,6 @@
|
|||
"explorer-fullpath-1-cabinetstate": "FullPath=1 in HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Explorer\\CabinetState. Displays the full directory path (e.g. C:\\Users\\jan\\Documents\\Projekty) in the File Explorer title bar instead of just the folder name."
|
||||
}
|
||||
},
|
||||
"05-personalization": {
|
||||
"synopsis": "Sets system colors, wallpaper, and visual theme.",
|
||||
"description": "Applies X9.cz visual identity: dark taskbar/Start with accent color #223B47\n(deep blue-gray), light app mode, no transparency. Wallpaper is set to a solid\ncolor matching the accent. BackInfo.exe (Step 07) overwrites the wallpaper with\na live system info BMP on every logon - solid color is only the fallback.",
|
||||
"items": {
|
||||
"system-tema-taskbar-start-dark": "SystemUsesLightTheme=0 in Themes\\Personalize. Dark mode for shell (taskbar, Start menu, Action Center, notification area). Does NOT affect application windows - those stay light. Reduces eye strain in dim environments.",
|
||||
"aplikacni-tema-light": "AppsUseLightTheme=1. Application windows (File Explorer, Settings, Calculator, etc.) use white/light backgrounds. Majority of business applications (Office, browsers) also respect this and show light mode.",
|
||||
"accent-barva-223b47-tmave-modroseda": "AccentColor DWORD = 0xFF473B22 (stored as ABGR: A=FF, B=47, G=3B, R=22). The deep blue-gray #223B47 is the X9.cz brand color, also used as the solid wallpaper background.",
|
||||
"accent-barva-na-start-a-taskbaru-ano": "ColorPrevalence=1. Applies accent color to taskbar background and Start menu surface. The taskbar becomes the brand color instead of default black, creating a distinct recognizable look on X9.cz-deployed machines.",
|
||||
"pruhlednost-vypnuta": "EnableTransparency=0. Disables Aero translucency on taskbar and Start. Improves text readability on the taskbar, reduces subtle GPU usage, and looks more professional/consistent on business machines.",
|
||||
"tapeta-jednobarevna-223b47-bez-obrazku": "Wallpaper set to solid color #223B47 via SystemParametersInfo(SPI_SETDESKWALLPAPER). BackInfo.exe generates a BMP with hostname, username, OS, network info and sets it as wallpaper on every logon. Solid color = fallback only."
|
||||
}
|
||||
},
|
||||
"06-scheduled-tasks": {
|
||||
"synopsis": "Registers logon scheduled tasks to maintain per-user settings that Windows resets.",
|
||||
"description": "Creates scheduled tasks under Task Scheduler that run at user logon (and optionally\non a timer) to enforce settings that Windows tends to revert. Tasks are registered\nin the Default profile task store so new user accounts inherit them automatically.\nNote: PDF-DefaultApp task has been removed - PDF default is set once during deployment.",
|
||||
"items": {
|
||||
"showalltrayicons-pri-logonu-kazdou-1-min": "Task 'ShowAllTrayIcons': runs at logon, repeats every 1 minute. Sets HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Explorer\\EnableAutoTray=0. Windows 11 re-enables auto-hiding of tray icons after updates and sometimes after logon - the 1-min repeat ensures permanent override.",
|
||||
"unlockstartlayout-jednou-po-aplikaci-lay": "Task 'UnlockStartLayout': runs once, 30 seconds after logon. Clears the Start menu layout lock bit that is set when ConfigureStartPins is applied. Without this, users cannot pin or unpin apps from Start after deployment.",
|
||||
"pdf-defaultapp-pri-kazdem-logonu": "REMOVED. PDF default is set once during deployment (step 02) with UCPD service stopped. The scheduled task is no longer needed."
|
||||
}
|
||||
},
|
||||
"07-backinfo": {
|
||||
"synopsis": "Deploys BackInfo.exe to C:\\Program Files\\Backinfo\\ and configures auto-start.",
|
||||
"description": "Copies the BackInfo folder from assets to Program Files, writes the OS name\nto the registry (HKLM\\SOFTWARE\\BackInfo\\OSName) so BackInfo can display it,\nand creates a Startup shortcut so BackInfo launches on every user logon.\nBackInfo renders a BMP wallpaper overlay with hostname, username, OS, HW info,\nand network info - configured via BackInfo.ini.",
|
||||
|
|
|
|||
|
|
@ -172,6 +172,14 @@
|
|||
Win10 + Win11, OEM i cisty install, funguje offline.
|
||||
</p>
|
||||
|
||||
<p style="color:var(--muted);font-size:.92rem;max-width:540px;line-height:1.65;margin-bottom:2.5rem">
|
||||
Technik spusti <code style="background:rgba(255,255,255,.1);padding:.1rem .35rem;border-radius:4px;font-size:.88rem">xetup.exe</code>
|
||||
na novem PC a aplikace projde vsemi kroky sama – bloatware, software (winget),
|
||||
systemova nastaveni, aktivace Windows, prejmenovani, vicekolove Windows Update.
|
||||
Po dokonceni prijde emailovy report na net@x9.cz.
|
||||
Technik muze mezitim pracovat jinde.
|
||||
</p>
|
||||
|
||||
<div class="actions">
|
||||
<a href="/spec/" class="btn-primary">Zobrazit specifikaci</a>
|
||||
<a href="https://git.xetup.x9.cz/x9/xetup" class="btn-secondary">Git repozitar</a>
|
||||
|
|
|
|||
|
|
@ -499,9 +499,7 @@
|
|||
<a href="#step-01">01 – Bloatware</a>
|
||||
<a href="#step-02">02 – Software (winget)</a>
|
||||
<a href="#step-03">03 – Registry (HKLM)</a>
|
||||
<a href="#step-04">04 – Default Profile</a>
|
||||
<a href="#step-05">05 – Personalizace</a>
|
||||
<a href="#step-06">06 – Scheduled Tasks</a>
|
||||
<a href="#step-04">04 – Default Profile + Personalizace</a>
|
||||
<a href="#step-07">07 – BackInfo</a>
|
||||
<a href="#step-08">08 – Aktivace Windows</a>
|
||||
<a href="#step-09">09 – PC identita</a>
|
||||
|
|
@ -521,8 +519,8 @@
|
|||
|
||||
<h1>Specifikace & anotace</h1>
|
||||
<div class="meta">
|
||||
<span>Verze: 0.4</span>
|
||||
<span>Datum: 2026-04-16</span>
|
||||
<span>Verze: 0.5</span>
|
||||
<span>Datum: 2026-04-17</span>
|
||||
<span><a href="https://git.xetup.x9.cz/x9/xetup">x9/xetup</a></span>
|
||||
<span>Status: aktivni vyvoj</span>
|
||||
</div>
|
||||
|
|
@ -654,31 +652,36 @@
|
|||
<div class="step" id="step-04">
|
||||
<div class="step-header">
|
||||
<span class="step-num">04</span>
|
||||
<span class="step-title">Default Profile (NTUSER.DAT)</span>
|
||||
<span class="step-title">Default Profile + Personalizace</span>
|
||||
<span class="badge badge-ok">OK</span>
|
||||
</div>
|
||||
<div class="step-body">
|
||||
<table class="items">
|
||||
<tr class="flag-done"><td>Taskbar: zarovnat vlevo (TaskbarAl = 0)</td><td>Win11 default je center</td></tr>
|
||||
<tr class="flag-done"><td>Taskbar: skryt Search, Copilot, Task View, Widgets, Chat</td><td>OK</td></tr>
|
||||
<tr class="flag-done"><td>Taskbar: zobrazit vsechny ikonky v tray (Scheduled task)</td><td>ShowAllTrayIcons</td></tr>
|
||||
<tr class="flag-done"><td>Taskbar: zobrazit vsechny ikonky v tray (EnableAutoTray = 0)</td><td>Win11 periodicky znovu skryva tray ikony po updatu</td></tr>
|
||||
<tr class="flag-done"><td>Taskbar: explicitni pinlist (TaskbarLayoutModification.xml)</td><td>default/user: Pruzkumnik + Edge; admin: Pruzkumnik + Edge + PowerShell. <code>PinListPlacement="Replace"</code> – prazdny seznam by dovoloval Windows pridat Store a dalsi vychozi.</td></tr>
|
||||
<tr class="flag-done"><td>Explorer: zobrazovat pripony souboru (HideFileExt = 0)</td><td>OK</td></tr>
|
||||
<tr class="flag-done"><td>Explorer: otevrit na This PC (LaunchTo = 1)</td><td>OK</td></tr>
|
||||
<tr class="flag-done"><td>Explorer: ShowRecent = 0, ShowFrequent = 0</td><td>Skryt nedavne a caste soubory v Quick Access</td></tr>
|
||||
<tr class="flag-done"><td>Explorer: FullPath = 1 (CabinetState)</td><td>Zobrazovat plnou cestu v titulku okna Explorera</td></tr>
|
||||
<tr class="flag-done"><td>Start menu: vyprazdnit piny (Win11)</td><td>ConfigureStartPins = {"pinnedList":[]}</td></tr>
|
||||
<tr class="flag-done"><td>Start menu: zakaz Bing vyhledavani</td><td>DisableSearchBoxSuggestions = 1</td></tr>
|
||||
<tr class="flag-done"><td>Copilot: zakaz (TurnOffWindowsCopilot = 1)</td><td>OK</td></tr>
|
||||
<tr class="flag-done"><td>NumLock zapnout pri startu (InitialKeyboardIndicators = 2)</td><td>OK</td></tr>
|
||||
<tr class="flag-done"><td>Accent barva na titulnich listech (ColorPrevalence = 1)</td><td>OK</td></tr>
|
||||
<tr class="flag-done"><td>OneDrive RunOnce klic je tady – smazat</td><td>Opraveno – blok odstranen ze scriptu (brani reinstalaci pres M365)</td></tr>
|
||||
<tr class="flag-done"><td>Explorer: ShowRecent = 0, ShowFrequent = 0</td><td>Skryt nedavne a caste soubory v Quick Access</td></tr>
|
||||
<tr class="flag-done"><td>Explorer: FullPath = 1 (CabinetState)</td><td>Zobrazovat plnou cestu v titulku okna Explorera</td></tr>
|
||||
<tr class="flag-done"><td>System tema (taskbar, Start): Dark</td><td>OK</td></tr>
|
||||
<tr class="flag-done"><td>Aplikacni tema: Light</td><td>OK</td></tr>
|
||||
<tr class="flag-done"><td>Accent barva: #223B47 (tmave modroseda)</td><td>AccentColor DWORD = 0xFF473B22 (ABGR)</td></tr>
|
||||
<tr class="flag-done"><td>Accent barva na Start a taskbaru (ColorPrevalence = 1)</td><td>OK</td></tr>
|
||||
<tr class="flag-done"><td>Pruhlednost: vypnuta (EnableTransparency = 0)</td><td>OK</td></tr>
|
||||
<tr class="flag-done"><td>Tapeta: jednobarevna #223B47; Wallpaper="" v default hive</td><td>BackInfo prepise tapetu svym BMP; prazdny retezec = solid barva, ne cerna plocha</td></tr>
|
||||
<tr class="flag-done"><td>OneDrive RunOnce klic odstranen</td><td>Odstraneni branil reinstalaci pres M365 – klice smazany ze skriptu</td></tr>
|
||||
</table>
|
||||
<div class="note">
|
||||
<strong>Metoda:</strong> <code>reg load HKU\DefaultProfile C:\Users\Default\NTUSER.DAT</code>
|
||||
→ zapsat zmeny → <code>reg unload HKU\DefaultProfile</code>.<br>
|
||||
Tato operace musi probihat PRED prvnim prihlasenim uzivatele.
|
||||
Aktualne prihlaseny uzivatel dostava zmeny pres primy zapis do HKCU.
|
||||
Personalizace (barvy, tapeta) je soucasti tohoto kroku – jeden hive load/unload,
|
||||
zadna kontigence s dalsimi skripty. BackInfo.exe (krok 07) prepise tapetu BMP pri kazdem logonu.
|
||||
</div>
|
||||
</div>
|
||||
<div class="step-footer">
|
||||
|
|
@ -687,54 +690,6 @@
|
|||
</div>
|
||||
</div>
|
||||
|
||||
<!-- STEP 05 -->
|
||||
<div class="step" id="step-05">
|
||||
<div class="step-header">
|
||||
<span class="step-num">05</span>
|
||||
<span class="step-title">Personalizace (barvy, tapeta)</span>
|
||||
<span class="badge badge-ok">OK</span>
|
||||
</div>
|
||||
<div class="step-body">
|
||||
<table class="items">
|
||||
<tr class="flag-done"><td>System tema (taskbar, Start): Dark</td><td>OK</td></tr>
|
||||
<tr class="flag-done"><td>Aplikacni tema: Light</td><td>OK</td></tr>
|
||||
<tr class="flag-done"><td>Accent barva: #223B47 (tmave modroseda)</td><td>OK</td></tr>
|
||||
<tr class="flag-done"><td>Accent barva na Start a taskbaru: ano</td><td>OK</td></tr>
|
||||
<tr class="flag-done"><td>Pruhlednost: vypnuta</td><td>OK</td></tr>
|
||||
<tr class="flag-done"><td>Tapeta: jednobarevna #223B47 (bez obrazku)</td><td>BackInfo prepise tapetu svym BMP</td></tr>
|
||||
<tr class="flag-done"><td>Wallpaper="" v default hive (oprava cerne tapety)</td><td>Bez tohoto klice novy uzivatel zdedi neplatnou cestu k tapete a dostane cernou plochu. Prazdny retezec = solid barva z <code>Control Panel\Colors\Background</code></td></tr>
|
||||
</table>
|
||||
<div class="note">
|
||||
BackInfo.exe (STEP 07) prepise tapetu BMP se systemovymi informacemi.
|
||||
Jednobarevna tapeta je fallback pro pripad, ze BackInfo nedobehne nebo se nespusti.
|
||||
</div>
|
||||
</div>
|
||||
<div class="step-footer">
|
||||
<span class="step-status">Script: <code>05-personalization.ps1</code></span>
|
||||
<div class="comment-widget" data-issue="6"></div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- STEP 06 -->
|
||||
<div class="step" id="step-06">
|
||||
<div class="step-header">
|
||||
<span class="step-num">06</span>
|
||||
<span class="step-title">Scheduled Tasks</span>
|
||||
<span class="badge badge-ok">OK</span>
|
||||
</div>
|
||||
<div class="step-body">
|
||||
<table class="items">
|
||||
<tr class="flag-done"><td>ShowAllTrayIcons – pri logonu + kazdou 1 min</td><td>Win11 automaticky skryva tray ikony</td></tr>
|
||||
<tr class="flag-done"><td>UnlockStartLayout – jednou po aplikaci layoutu</td><td>Odemkne Start menu pro uzivatelske zmeny</td></tr>
|
||||
<tr class="flag-done"><td>PDF-DefaultApp pri kazdem logonu – odstranen</td><td>PDF asociace nastavena jednou v kroku 02 (UCPD stop/start). Task nebyl nutny.</td></tr>
|
||||
</table>
|
||||
</div>
|
||||
<div class="step-footer">
|
||||
<span class="step-status">Script: <code>06-scheduled-tasks.ps1</code></span>
|
||||
<div class="comment-widget" data-issue="7"></div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- STEP 07 -->
|
||||
<div class="step" id="step-07">
|
||||
<div class="step-header">
|
||||
|
|
@ -899,7 +854,7 @@
|
|||
<tr class="flag-open"><td>Win11 24H2 kompatibilita layoutu</td><td>24H2 vyzaduje ProvisionedLayoutModification.xml – nutno otestovat na realne instalaci</td></tr>
|
||||
</table>
|
||||
<div class="note">
|
||||
Layout se pri aplikaci zamkne. UnlockStartLayout task (krok 06) ho odemkne 5 min po startu, aby uzivatel mohl dale upravovat.
|
||||
Layout se pri aplikaci zamkne. UnlockStartLayout scheduled task (registrovany v kroku 04) ho odemkne 5 min po startu, aby uzivatel mohl dale upravovat.
|
||||
</div>
|
||||
</div>
|
||||
<div class="step-footer">
|
||||
|
|
@ -934,7 +889,7 @@
|
|||
<div class="note">
|
||||
<strong>Struktura:</strong> <code>cmd/xetup/</code>, <code>internal/config/</code>, <code>internal/gui/</code>, <code>internal/runner/</code><br><br>
|
||||
<strong>Go zavislosti:</strong> github.com/lxn/walk (Win32 GUI), golang.org/x/sys<br><br>
|
||||
<strong>Build:</strong> <code>GOOS=windows GOARCH=amd64 go build -ldflags="-H windowsgui" ./cmd/xetup/</code><br>
|
||||
<strong>Build:</strong> <code>CGO_ENABLED=1 CC=x86_64-w64-mingw32-gcc GOOS=windows GOARCH=amd64 go build -ldflags="-s -w -H windowsgui" ./cmd/xetup/</code><br>
|
||||
CI (Forgejo Actions) sestavi a publikuje automaticky pri kazdem push na main.
|
||||
</div>
|
||||
</div>
|
||||
|
|
@ -1154,8 +1109,6 @@
|
|||
'step-02': '02-software',
|
||||
'step-03': '03-system-registry',
|
||||
'step-04': '04-default-profile',
|
||||
'step-05': '05-personalization',
|
||||
'step-06': '06-scheduled-tasks',
|
||||
'step-07': '07-backinfo',
|
||||
'step-08': '08-activation',
|
||||
'step-09': '09-pc-identity',
|
||||
|
|
|
|||
Loading…
Reference in a new issue