﻿# Követelmények és tervezés

> A WorkSmartHub egyetlen webalkalmazás: az ASP.NET Core szerver ugyanazon a címen és porton szolgálja ki az API-t és az Angular portált. A háttérfolyamatok ugyanebben a folyamatban futnak, ezért az alkalmazásnak folyamatosan futnia kell, nem csak kérés esetén.

Source: https://workwise-solutions.net/hu/docs/installation/requirements/ · Language: hu · English version: https://workwise-solutions.net/docs/installation/requirements/

A WorkSmartHub egyetlen webalkalmazás: az ASP.NET Core szerver ugyanazon a címen és porton szolgálja ki az API-t és az Angular portált. A háttérfolyamatok ugyanebben a folyamatban futnak, ezért az alkalmazásnak folyamatosan futnia kell, nem csak kérés esetén.

## Telepítési lehetőségek

| Lehetőség | Szükséges futtatókörnyezet a gépen | Oldal |
|---|---|---|
| Windows Server IIS-sel | ASP.NET Core **10.0 Hosting Bundle**, Microsoft Visual C++ Redistributable (x64) | [Windows (IIS)](https://workwise-solutions.net/hu/docs/installation/windows-iis/) |
| Linux szolgáltatás (Ubuntu, Debian, RHEL család) nginx mögött | ASP.NET Core **10.0** futtatókörnyezet (`aspnetcore-runtime-10.0`) | [Linux](https://workwise-solutions.net/hu/docs/installation/linux/) |
| Docker | Docker Engine 20.10+ vagy Docker Desktop (WSL 2); az image tartalmazza a .NET 10 futtatókörnyezetet Ubuntu 24.04-en | [Docker](https://workwise-solutions.net/hu/docs/installation/docker/) |
| Kubernetes | Egy fürt, `kubectl`, Helm 3 | [Kubernetes](https://workwise-solutions.net/hu/docs/installation/kubernetes/) |

A futtatott kiadás határozza meg a .NET verzióját: a jelenlegi kiadások a **.NET 10** (LTS) verzióra épülnek. Frissítéskor nézze meg a `TargetFramework` értékét és a kiadási jegyzéket; újabb .NET verzió esetén előbb annak a futtatókörnyezetét vagy Hosting Bundle-jét kell telepíteni.

## Belső adatbázis

Az alkalmazás az adatait egy választható belső adatbázisban tárolja ([Konfiguráció](https://workwise-solutions.net/hu/docs/installation/configuration/#belső-adatbázis)):

| Adatbázis | Mire való |
|---|---|
| **SQLite** (alapértelmezett) | Nem kell hozzá adatbázis-szerver; csak egy alkalmazásszerverrel működik. Kisebb telepítésekhez és kipróbáláshoz. |
| **Microsoft SQL Server** | Éles üzem, több szerverrel is. |
| **PostgreSQL** | Éles üzem, több szerverrel is. A Kubernetes chart alapértelmezésként tartalmaz egyet. |
| **MySQL** | Éles üzem, több szerverrel is. |

A sémát az alkalmazás induláskor automatikusan létrehozza és migrálja.

## Egyéb összetevők

- **SMTP-szerver** a felhasználóknak és ügyfeleknek szóló e-mailekhez (jelszó-visszaállítás, új felhasználók, ügyfél-e-mailek, figyelmeztetések).
- **Identitásszolgáltató**, ha a felhasználók céges fiókkal jelentkeznek be: Active Directory (csak Windows/IIS), LDAP, Microsoft Entra ID vagy OAuth (Okta, Google, Microsoft, egyedi) ([Hitelesítés](https://workwise-solutions.net/hu/docs/installation/authentication/)).
- **Fájltároló**: a szerver saját lemeze, vagy Azure Blob, Amazon S3, MinIO, Box, SharePoint, Google Cloud Storage ([Fájltárolók](https://workwise-solutions.net/hu/docs/features/file-storages/)).
- **Cache**: alapértelmezés szerint memóriában; több szerver esetén Redis vagy adatbázis-cache ([Éles üzemeltetés](https://workwise-solutions.net/hu/docs/installation/operations/)).
- **HTTPS**: éles telepítésnél kötelező, mert a bejelentkezési sütit a böngésző csak HTTPS-en küldi el. A TLS-t az IIS, az nginx, egy ingress vagy egy terheléselosztó zárja le.
- Opcionálisan: Slack vagy Microsoft Teams, Számlázz.hu, HashiCorp Vault.

## Egy szerver vagy több

| | Egy szerver | Több szerver |
|---|---|---|
| Adatbázis | bármelyik (az SQLite is megfelel) | SQL Server, PostgreSQL vagy MySQL |
| Cache | InMemory | Redis vagy adatbázis-cache |
| Fájltároló | szerverlemez vagy felhő | felhős tároló |
| Beállítások | | minden szerveren azonos `appsettings.json`, az aláíró kulcsokkal és a `PublicBaseUrl` értékkel együtt |

![A telepítési mód kiválasztása](https://workwise-solutions.net/docs/images/diagram-deployment-options-hu.png)
*A szerverek száma dönti el az adatbázist, a cache-t és a fájltárolót; az Active Directory bejelentkezéshez Windows és IIS kell.*

## Böngészők és eszközök

A portál asztali webalkalmazás, a mai böngészőkhöz. Telefon képernyőjére nincs optimalizálva; telefonon a [mobilalkalmazás](https://workwise-solutions.net/hu/docs/features/mobile-app/) használható.

## Ellenőrzőlista az éles indulás előtt

- [ ] Saját aláíró kulcsok az `appsettings.json`-ban (három kulcs, lásd: [Konfiguráció](https://workwise-solutions.net/hu/docs/installation/configuration/#aláíró-kulcsok))
- [ ] Beállított `PublicBaseUrl`
- [ ] HTTPS az alkalmazás előtt; a `SecureCookie` értéke `true` marad
- [ ] Kitöltött és kipróbált SMTP-beállítások
- [ ] Ütemezett mentés az adatbázisról és az adatmappáról ([Frissítés, mentés és visszaállítás](https://workwise-solutions.net/hu/docs/installation/upgrade-backup-restore/))
- [ ] Feltöltött licenc, létrehozott első Super Admin ([Első lépések](https://workwise-solutions.net/hu/docs/getting-started/))
