# InstaSoft Office Tool

**Belso hasznalatu Office telepito varazslo az InstaSoft Informatikai Zrt. ugyfelei szamara.**

Microsoft Office 2019 / 2021 / 2024 telepites, eltavolitas es licenc-kezeles egyetlen alkalmazasbol.

---

## Funkcionalitas

### Office telepites (varazslo)

1. **Verzio valasztas** — Office 2024, 2021 vagy 2019
2. **Kiadas valasztas** — Standard, Professional Plus, Otthoni es kisvallalati verzio
3. **Beallitasok** — architektura (64/32-bit), nyelv, alkalmazasok kizarasa
4. **Termekkulcs** — opcionalis, ha megadja az ugyfei, automatikusan aktivalodik
5. **Osszegzes** — generalt ODT XML megtekintese es mentese
6. **Meglevo Office ellenorzes** — telepites elott felkinaija a regi verzio eltavolatasat
7. **Telepites** — ODT automatikus letoltese es futtatasa
8. **Telepites utan** — aktivaias lehetoseg + Word/Excel/PowerPoint/Outlook inditas

### Office eltavolitas

- Registry-bol detektalja a telepitett Office verziokat (Click-to-Run + MSI)
- Szelektiv eltavolitas: minden termek kulon kivalaszthato
- Click-to-Run: ODT `setup.exe /configure remove.xml` (specifikus Product ID-vel)
- MSI: `msiexec /x {GUID} /qb`
- Opcionalis licenc-adatbazis tisztitas (ospp.vbs /unpkey)

### Licenc-kezeles

- `ospp.vbs /dstatus` — licenc allapot lekerdezese
- Minden talalt kulcs kulon kartyakon jelenik meg
- **Aktivalas** gomb: termekkulcs bekeresi dialog → `/inpkey` → `/act`
- **Eltavolitas** gomb: kulon kulcsonkent `/unpkey`
- Osszes kulcs eltavolitasa (2+ kulcs eseten)

---

## Technikai reszletek

### Platform

| | |
|---|---|
| **Keretrendszer** | WPF .NET Framework 4.8 |
| **Nyelv** | C# (SDK-style csproj) |
| **Cel platform** | Windows 7 SP1+ (.NET 4.8 szukseges) |
| **Build** | `dotnet build -c Release` (.NET 8 SDK) |
| **Kimenet** | `bin\Release\net48\InstaSoftOfficeTool.exe` |
| **Merret** | ~25 KB (egyetlen exe, nem kell telepiteni) |
| **Jogosultsag** | Administrator (UAC manifest) |

### Design

- **Fluent Design** vilagos tema (Windows 11 stilus)
- Segoe UI Variable font (fallback: Segoe UI)
- Lekerekitett sarkok, kartyak arnyekkal, accent szin: `#0078D4`
- Sajat ConfirmDialog es ProductKeyDialog (nem Windows MessageBox)
- 800x550 px fix ablakmerret

### ODT (Office Deployment Tool)

- Automatikus letoltes: `https://officecdn.microsoft.com/pr/wsus/setup.exe`
- Letoltott fajl helye: `%TEMP%\InstaSoftODT\setup.exe`
- Ha mar letezik es >1MB, ujra nem tolti le
- XML generalas az `OdtXmlGenerator` osztalyban

### Tamogatott Office termekek

| Evjarat | Kiadas | Product ID | Channel |
|---------|--------|------------|---------|
| 2024 | Standard | Standard2024Volume | PerpetualVL2024 |
| 2024 | Professional Plus | ProPlus2024Volume | PerpetualVL2024 |
| 2024 | Otthoni es kisvallalati | HomeBusiness2024Retail | Current |
| 2021 | Standard | Standard2021Volume | PerpetualVL2021 |
| 2021 | Professional Plus | ProPlus2021Volume | PerpetualVL2021 |
| 2021 | Otthoni es kisvallalati | HomeBusiness2021Retail | Current |
| 2019 | Standard | Standard2019Volume | PerpetualVL2019 |
| 2019 | Professional Plus | ProPlus2019Volume | PerpetualVL2019 |
| 2019 | Otthoni es kisvallalati | HomeBusiness2019Retail | Current |

### Alkalmazas kizarasi szabalyok

| Alkalmazas | Elerheto kiadasok | Alapertelmezett |
|---|---|---|
| Word, Excel, PowerPoint, Outlook, OneNote | Mind | Bekapcsolva |
| Access | Csak Professional Plus | Bekapcsolva |
| Publisher | Professional Plus, Standard | Bekapcsolva |
| Teams | Mind | Kikapcsolva |
| Skype for Business | Mind | Kikapcsolva |

### ospp.vbs kereses

A program az alabbi helyeken keresi az `ospp.vbs` fajlt:

1. `C:\Program Files\Microsoft Office\root\Office16\OSPP.VBS` (Click-to-Run)
2. `C:\Program Files (x86)\Microsoft Office\root\Office16\OSPP.VBS`
3. `C:\Program Files\Microsoft Office\Office16\ospp.vbs` (MSI)
4. `C:\Program Files (x86)\Microsoft Office\Office16\ospp.vbs`
5. Office15, Office14 valtozatok
6. Registry: `HKLM\SOFTWARE\Microsoft\Office\ClickToRun\Configuration\InstallationPath`

---

## Projekt struktura

```
InstaSoftOfficeTool/
├── InstaSoftOfficeTool.csproj      Projekt fajl (.NET Framework 4.8)
├── App.xaml / App.xaml.cs          Alkalmazas belepesi pont
├── MainWindow.xaml / .xaml.cs      Fo ablak, navigacio, wizard logika
├── app.manifest                    UAC requireAdministrator
│
├── Models/
│   ├── OfficeVersion.cs            Evjarat enum (2024, 2021, 2019)
│   ├── OfficeEdition.cs            Kiadas adatok (ProductId, Channel)
│   ├── InstallConfig.cs            Telepitesi konfig + nyelvek + alkalmazasok
│   └── InstalledOffice.cs          Detektalt Office info
│
├── Pages/
│   ├── WelcomePage.xaml             Udvoziod oldal (3 kartya-gomb)
│   ├── VersionPage.xaml             Evjarat valasztas
│   ├── EditionPage.xaml             Kiadas valasztas (dinamikus)
│   ├── ConfigPage.xaml              Architektura, nyelv, alkalmazasok
│   ├── ProductKeyPage.xaml          Termekkulcs bevitel (5x5 mezo)
│   ├── SummaryPage.xaml             Osszegzes + XML preview
│   ├── PreInstallCheckPage.xaml     Meglevo Office ellenorzes/eltavolitas
│   ├── ProgressPage.xaml            Telepitesi folyamat + befejezs utan aktivalas/inditas
│   ├── RemovePage.xaml              Onallo Office eltavolitas
│   ├── TroubleshootPage.xaml        Licenc-kezeles (dstatus, aktivalas, unpkey)
│   ├── ConfirmDialog.xaml           Sajat megerosito dialog (overlay)
│   └── ProductKeyDialog.xaml        Termekkulcs bekero dialog (overlay)
│
├── Services/
│   ├── OdtXmlGenerator.cs          ODT XML konfig generalas
│   ├── OdtDownloader.cs            ODT letoltes (officecdn.microsoft.com)
│   ├── OfficeDetector.cs           Telepitett Office detektalas (registry)
│   ├── LicenseManager.cs           ospp.vbs kereses es futtatás (/dstatus, /inpkey, /act, /unpkey)
│   └── ProcessRunner.cs            Kulso folyamat futtatas async
│
├── Styles/
│   ├── FluentTheme.xaml            Szinek, brushok, globalis font
│   ├── ButtonStyles.xaml           PrimaryButton, SecondaryButton, CardButton
│   └── ControlStyles.xaml          ComboBox, TextBox, CheckBox, RadioButton, ProgressBar
│
└── Resources/
    └── app.ico                     Alkalmazas ikon
```

---

## Build

### Elofeltetel

- .NET 8 SDK (a `dotnet` parancshoz)
- Nincs szukseg Visual Studio-ra

### Forditas

```bash
cd C:\Projects\InstaSoftOfficeTool
dotnet build -c Release
```

Kimenet: `bin\Release\net48\InstaSoftOfficeTool.exe`

### Fontos

- **Build elott be kell zarni a futó programot** — az exe zárolt, amíg fut
- Csak az `.exe` kell a futtatashoz, a `.pdb` es `.config` nem szukseges

---

## Terjesztes

### Kodalairás

Az exe fajlt OV (Organization Validation) tanustvannyal kell alairni a SmartScreen figyelmeztetesek elkerulesehez.

```bash
signtool sign /f certificate.pfx /p PASSWORD /fd SHA256 /tr http://timestamp.digicert.com /td SHA256 InstaSoftOfficeTool.exe
```

### Verziokezeles

Verzioszam **3 helyen** kell frissiteni kiadaskor:

1. `InstaSoftOfficeTool.csproj` — `<Version>`, `<AssemblyVersion>`, `<FileVersion>`
2. `MainWindow.xaml` — jobb felso sarok `Text="v1.xx"`
3. Git tag: `git tag v1.xx && git push origin v1.xx`

---

## Verziotortenet

| Verzio | Datum | Valtozasok |
|--------|-------|------------|
| v1.01 | 2026-03-31 | Elso kiadas: wizard, eltavolitas, licenc-kezeles |
| v1.02 | 2026-03-31 | Licenc UI javitasok, ospp.vbs root/Office16 path |
| v1.03 | 2026-03-31 | Fluent ComboBox/CheckBox/TextBox stilusok |
| v1.04 | 2026-03-31 | Config layout (arch+nyelv egymas mellett), Skype default off |
| v1.05 | 2026-03-31 | Gomb szoveg kontraszt javitas (feher kek alapon) |
| v1.06 | 2026-03-31 | Termekkulcs paste javitas (DataObject.Pasting) |
| v1.07 | 2026-03-31 | Pre-install Office ellenorzes a telepites elott |
| v1.08 | 2026-03-31 | Sajat Fluent megerosito dialog (MessageBox helyett) |
| v1.09 | 2026-04-01 | ODT CDN letoltes fix, szelektiv C2R eltavolitas |
| v1.10 | 2026-04-02 | Aktivalas kulcs dialoggal, auto-refresh, Access korlatozas |
| v1.11 | 2026-04-02 | Teljes alkalmazas lista, kiadasfuggo elerhetseg |
| v1.13 | 2026-04-02 | Telepites utani aktivalas es app inditas |
| v1.14 | 2026-04-02 | Ablak merret visszaallitas Vissza gombnal |
| v1.16 | 2026-04-02 | PowerShell verzio torolve, flat projekt struktura |