# Wymagania systemowe

Przed wdrożeniem sprawdź obsługiwaną infrastrukturę, architekturę, dostęp sieciowy i zalecane minimalne parametry sprzętowe.

Canonical: https://docs.mintsd.com/pl/docs/mint-service-desk-pl/system-requirements-system-requirements
Language: pl-PL
Revision: 26e268481a7bf0562015daca73819bbb3c207d15411df75c383f3c5e47b8254e

<a id="element-01a14f06-e991-798a-b386-69ae0f6824cc"></a>

Mint Service Desk działa w Dockerze, który zapewnia wirtualizację na poziomie systemu operacyjnego. Pakiet instalacyjny zawiera aplikację, bazę danych i serwer WWW.

<a id="element-01a18c41-4567-75fc-930c-2765bf459ad2"></a>

**Wymagania systemowe**

<a id="element-01a18c41-4567-7bd9-98e2-3c32738d40d2"></a>

System operacyjny

<a id="element-01a18c41-4567-732a-8cf9-89eba15e201b"></a>

- Linux (zalecane dystrybucje LTS: Debian, Ubuntu, Alpine).
- Środowisko powinno zapewniać stabilność i długoterminowe wsparcie.

<a id="element-01a18c41-4567-75d8-9b9a-92d537de90a5"></a>

**Architektura rozwiązania**

<a id="element-01a18c41-4567-7d97-8789-ec1f0c8b72b6"></a>

Mint Service Desk korzysta z architektury mikrousług, złożonej z około 30 niezależnych komponentów.

<a id="element-01a18c41-4567-7e9b-8c8a-24d2f086241b"></a>

Główne technologie:

<a id="element-01a18c41-4567-7900-b4ec-c5b5e1970ce1"></a>

- Backend: C#, .NET, .NET Core, Entity Framework, IdentityServer, SignalR, OpenID Connect
- Frontend: AngularJS, React (w wersjach chmurowych), JavaScript, TypeScript, SCSS, CSS, HTML, SignalRJS, OpenID Connect
- Serwer reverse proxy: NGINX
- Orkiestracja kontenerów: Docker, Docker Compose, Docker Swarm, Kubernetes (w wersjach chmurowych)
- Kolejka komunikatów: RabbitMQ
- Baza danych: PostgreSQL

<a id="element-01a18c41-4567-71a2-bfc6-2a84291047ba"></a>

**Warstwa danych**

<a id="element-01a18c41-4567-7e0c-ae95-4cca1ef74643"></a>

- Silnik bazy danych: PostgreSQL.
- Lokalizacja: instalacja bezpośrednio na hoście, poza środowiskiem kontenerowym.
- Dostępność: dostęp wyłącznie lokalny (localhost).
- Uprawnienia: osobny użytkownik aplikacji z pełnym dostępem do bazy danych Mint Service Desk.
- Wyszukiwarka: SOLR.
- OCR: Tesseract.

<a id="element-01a18c41-4567-73e5-92b1-912f33674afe"></a>

**Warstwa aplikacji**

<a id="element-01a18c41-4567-7d2e-8fd3-fee08c0233f0"></a>

System działa w środowisku kontenerowym Docker Swarm. Obejmuje około 30 mikrousług backendowych opartych na .NET, aplikację frontendową AngularJS, serwer RabbitMQ odpowiedzialny za komunikację asynchroniczną oraz komponenty integracyjne i pomocnicze.

<a id="element-01a18c41-4567-7c6e-a2d5-3183431f5e65"></a>

Architektura zapewnia skalowanie poziome, izolację komponentów i wysoką dostępność usług.

<a id="element-01a18c41-4567-7e89-b244-89c12c937058"></a>

**Warstwa komunikacji (serwer reverse proxy)**

<a id="element-01a18c41-4567-7abc-96e4-653012904f22"></a>

- Technologia: NGINX działający w kontenerze Docker.
- Udostępniane usługi:

  - Port 80 (HTTP): używany wyłącznie do sprawdzania stanu usług lub przekierowań.
  - Port 443 (HTTPS): główny punkt dostępu do systemu.

<a id="element-01a18c41-4567-7873-94c2-1c7f149d8037"></a>

Zalecane jest użycie certyfikatu SSL/TLS, np. Let’s Encrypt lub certyfikatu komercyjnego.

<a id="element-01a18c41-4567-7717-9a01-28dc6d21433f"></a>

**API i integracje**

<a id="element-01a18c41-4567-7fa0-b61a-d5be2e47df6e"></a>

System udostępnia rozbudowane API do integracji z systemami zewnętrznymi, takimi jak systemy dostawców usług zarządzanych (MSP), narzędzia monitorujące i systemy biznesowe.

<a id="element-01a18c41-4567-784a-87be-b60620a97c18"></a>

- Dokumentacja API jest dostępna w standardzie Swagger (OpenAPI).
- Uwierzytelnianie korzysta z modelu Client ID / Client Secret, który umożliwia bezpieczne zarządzanie dostępem wielu integracji.

<a id="element-01a18c41-4567-738c-9797-01ea188a5f9c"></a>

**Model wdrożenia**

<a id="element-01a18c41-4567-7fd7-a33b-d30ba795cb58"></a>

- System można wdrożyć lokalnie, w infrastrukturze klienta (on-premises), lub w chmurze publicznej, np. AWS.
- Architektura kontenerowa zapewnia elastyczność i pozwala dostosować system do różnych środowisk infrastrukturalnych.

<a id="element-01a18c41-4567-70d1-b0da-f1e263c7b5e3"></a>

**Zalecane minimalne parametry sprzętowe**

<a id="element-01a18c41-4567-750e-8df5-63dfddfe7dfb"></a>

- CPU: co najmniej 4 vCPU.
- RAM: co najmniej 16 GB.
- Dysk: co najmniej 500 GB (zalecany SSD).
- Sieć: dostęp do portu 443 (HTTPS).

<a id="element-01a18c41-4567-7b38-bc20-6a4990498142"></a>

**Dodatkowe wymagania**

<a id="element-01a18c41-4567-733d-8a0b-8ad55c4c2f0a"></a>

- Dostęp SSH do serwera.
- Publiczny adres IP lub konfiguracja DNS.
- Możliwość instalacji Docker i Docker Swarm.
- Dostęp do wymaganych portów sieciowych, w szczególności portu 443 dla komunikacji HTTPS.

