Branch: feature/windows-installer-service
Data rozpoczęcia: 2025-01-11
Status: W trakcie
Stworzenie kompletnego, produkcyjnego rozwiązania Windows installer + Windows Service dla ScaleCmdBridge, tak aby:
- Użytkownik pobiera jeden plik instalacyjny (ScaleCmdBridge-Setup-x64.exe)
- Po instalacji automatycznie tworzy się i uruchamia Windows Service
- Frontend dostępny jako aplikacja webowa pod http://localhost:8080
- Automatyczne uruchamianie przy starcie Windows
- Konfiguracja firewall, logi, skróty
- Analiza wymagań
- Dodać
actix-filesdoCargo.toml - Dodać serwowanie statycznych plików z
dist/pod/ - Zachować API pod
/api/*,/health,/devices,/scalecmd - Dodać obsługę SPA routing (fallback do index.html przez default_handler)
- Przetestować lokalnie (frontend dostępny przez backend na http://localhost:8080)
- Zaprojektować strukturę katalogów:
C:\Program Files\ScaleCmdBridge\- binarki, nssm.exe, web/C:\ProgramData\ScaleCmdBridge\- config/, logs/
- Dodać auto-detekcję ścieżek (ProgramData dla config, ProgramFiles dla web)
- Zaktualizować
main.rsdo używania ścieżek z ProgramData/ProgramFiles - Dodać tworzenie katalogu logs w ProgramData
- Dodać obsługę logów do pliku (wymaga dodatkowej biblioteki)
- Stworzyć
INSTALL-SERVICE.bat- instalacja usługi przez NSSM - Stworzyć
UNINSTALL-SERVICE.bat- odinstalowanie usługi - Stworzyć
START-SERVICE.bat/STOP-SERVICE.bat- zarządzanie - Skonfigurować NSSM:
- AppDirectory:
C:\Program Files\ScaleCmdBridge\ - StartType: SERVICE_AUTO_START
- Logowanie do pliku (stdout/stderr)
- Rotacja logów (dziennie, 10MB max)
- AppDirectory:
- Pobrać NSSM (nssm.exe) - dodać do repo lub pobierać podczas builda
- Dodać EventLog support (wymaga dodatkowej biblioteki w Rust)
- Stworzyć skrypt Inno Setup (.iss):
- GUI z wyborem portu (domyślnie 8080)
- Wykrywanie konfliktu portu
- Kopiowanie plików do Program Files
- Instalacja NSSM service (przez INSTALL-SERVICE.bat)
- Konfiguracja firewall (netsh advfirewall)
- Skróty Start Menu (opcjonalnie Desktop)
- Uruchomienie usługi po instalacji
- Uninstaller z usuwaniem serwisu
- Dokumentacja instalatora
- Dodać ikony i branding
- Przetestować instalację na czystym systemie
- Stworzyć
scripts/Build-WindowsInstaller.ps1:- Build Rust release (
scaleit-bridge.exe) - Build React (
npm run build→dist/) - Pobranie/setup NSSM automatycznie
- Kompilacja Inno Setup Compiler
- Wygenerowanie
ScaleCmdBridge-Setup-x64.exe
- Build Rust release (
- Auto-detekcja Inno Setup Compiler
- Auto-detekcja wersji z Cargo.toml
- Walidacja i error handling na każdym kroku
- Przetestować pełny build pipeline
- Dodać obsługę Windows EventLog w Rust
- Konfiguracja logów:
- Plik:
C:\ProgramData\ScaleCmdBridge\logs\scaleit-bridge.log - EventLog: Application log, source "ScaleCmdBridge"
- Plik:
- Rotacja logów (max rozmiar, max pliki)
- Zaprojektować strategię aktualizacji:
- In-place upgrade przez instalator (zalecane)
- Manual upgrade script dla zaawansowanych
- Zachowanie configu i logów podczas upgrade
- Dodać weryfikację wersji w instalatorze (AppMutex, VersionInfo)
- Dodać backup configu przed aktualizacją (automatyczny)
- Dokumentacja strategii aktualizacji (docs/UPDATE_STRATEGY.md)
- Funkcje pomocnicze w instalatorze (ServiceExists, FirewallRuleNotExists)
- Zaktualizować README z instrukcją instalacji (sekcja Windows Production Installation)
- Stworzyć WINDOWS_INSTALLATION_GUIDE.md (kompletny przewodnik)
- Dodać troubleshooting guide (w WINDOWS_INSTALLATION_GUIDE.md)
- Dodać przykłady zarządzania usługą (komendy, skrypty)
- Stworzyć UPDATE_STRATEGY.md (strategia aktualizacji)
- Test budowania instalatora (sukces!)
- Naprawa błędów składni Inno Setup
- Weryfikacja wszystkich komponentów
- Test instalacji na czystym Windows 10/11 (wymaga testu na docelowym systemie)
- Test zarządzania usługą (start/stop/restart)
- Test automatycznego uruchamiania po restarcie
- Test konfiguracji firewall
- Test aktualizacji (upgrade)
C:\Program Files\ScaleCmdBridge\
├── ScaleCmdBridge.exe # Główny plik wykonywalny
├── nssm.exe # NSSM service manager
├── web\ # Frontend (dist/)
│ ├── index.html
│ ├── assets\
│ └── ...
└── README.md # Dokumentacja
C:\ProgramData\ScaleCmdBridge\
├── config\
│ └── devices.json # Konfiguracja urządzeń
└── logs\
└── scaleit-bridge.log # Logi aplikacji
- Nazwa usługi:
ScaleCmdBridge - Display Name:
ScaleIT Bridge Service - Description:
Universal Industrial Scale Communication Bridge - Start Type: Automatic (SERVICE_AUTO_START)
- Executable:
C:\Program Files\ScaleCmdBridge\ScaleCmdBridge.exe - Working Directory:
C:\Program Files\ScaleCmdBridge\ - Logs:
- File:
C:\ProgramData\ScaleCmdBridge\logs\scaleit-bridge.log - EventLog: Application, Source: ScaleCmdBridge
- File:
- Domyślny port: 8080
- Konfiguracja: Plik
.envlub zmienna środowiskowaPORT - Firewall: Automatyczna konfiguracja przez instalator
- Windows Service: NSSM (Non-Sucking Service Manager)
- Installer: Inno Setup
- Build Script: PowerShell
- Backend: Rust (Actix-web) + actix-files
- Frontend: React/Vite (statyczne pliki)
- ✅ NSSM zamiast natywnego Windows Service (prostsze, nie wymaga zmian w kodzie)
- ✅ Inno Setup zamiast NSIS/WiX (użytkownik ma już zainstalowane)
- ✅ Frontend jako statyczne pliki w backendzie (jeden port, prostsze)
- ✅ ProgramData dla config/logs (standard Windows, łatwiejsze backup)
- Jak obsłużyć SPA routing w Actix (fallback do index.html) - ✅ ROZWIĄZANE: default_handler
- Jak przekazać port z instalatora do aplikacji (zmienna środowiskowa PORT)
- Jak obsłużyć upgrade bez utraty configu
Aktualny etap: Faza 5 - Build Pipeline ✅ ZAKOŃCZONA
Następny etap: Testy instalacji i dokumentacja
Ostatnia aktualizacja: 2025-01-11