﻿# Áttekintés

> A WorkSmartHub munkamenedzsment platform. A cégek arra használják, hogy a feladataikat (javítás, karbantartás, telepítés, árajánlat, kiszállítás) munkajegyként rögzítsék és kövessék, az ügyfél- és raktárnyilvántartásukat egy helyen vezessék, és hogy az egyes csapatok munkája elkülönüljön egymástól.

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

A WorkSmartHub munkamenedzsment platform. A cégek arra használják, hogy a feladataikat (javítás, karbantartás, telepítés, árajánlat, kiszállítás) **munkajegyként** rögzítsék és kövessék, az ügyfél- és raktárnyilvántartásukat egy helyen vezessék, és hogy az egyes csapatok munkája elkülönüljön egymástól.

## Milyen problémákat old meg

- **Külön csapatok, külön adatok.** Minden csapat, osztály vagy projekt saját **munkaterületet** kap, saját hozzáférési szabályokkal, értesítési csatornákkal és fájltárolókkal. A csapattagok csak azt látják, amire szükségük van.
- **Munkajegyek papírmunka nélkül.** A munkajegy mindent tartalmaz, ami a feladathoz tartozik: az ügyfelet, a terméket, a hibát, a státuszt, a hozzárendelt munkatársakat, a felhasznált komponenseket, az elvégzett munkát, a szállítást és a mellékleteket. A státusz- és a felelősváltozásokról az érintettek automatikusan értesítést kapnak.
- **Ügyfélkezelés.** Az ügyfeleket egyszer kell felvenni, a munkajegyeken pedig kiválasztani. Az ügyfél automatikus e-mailt kap, amikor a munkajegyét rögzítik, amikor késést jeleznek, és amíg a kiszállítás tart.
- **Raktárkészlet-kezelés.** A **Raktárkészlet** a munkákhoz használt komponenseket tartja nyilván, mennyiséggel és árral. A munkajegyen felhasznált komponensek levonódnak a készletből, és ha egy komponens fogyóban van, a készletért felelős felhasználók e-mailt kapnak.

## Felépítés

A WorkSmartHub egyetlen webalkalmazás: egy ASP.NET Core szerver (.NET 10), amely ugyanazon a címen és porton az Angular webes felületet is kiszolgálja. A saját infrastruktúráján fut:

- Windowson IIS alatt, Linuxon nginx mögötti systemd szolgáltatásként, Docker konténerben vagy Kubernetesen a Helm charttal ([Telepítés](https://workwise-solutions.net/hu/docs/installation/requirements/));
- választható belső adatbázissal: SQLite (alapértelmezett, egy szerverhez), Microsoft SQL Server, PostgreSQL vagy MySQL;
- a saját felhasználói tárával, vagy Active Directoryból, LDAP-ból, Microsoft Entra ID-ból, illetve OAuth szolgáltatón keresztül érkező felhasználókkal ([Hitelesítés](https://workwise-solutions.net/hu/docs/installation/authentication/)).

A háttérfolyamatok (emlékeztetők, alacsony készlet e-mailek, token- és jelszólejárati figyelmeztetések, számla státusz szinkronizálás, adatbázis-tisztítás) az alkalmazás folyamatán belül futnak. Az integrációkhoz Swagger dokumentációval ellátott REST API áll rendelkezésre, amelyet [személyes hozzáférési tokenekkel](https://workwise-solutions.net/hu/docs/features/personal-access-tokens/) lehet hívni.

![A WorkSmartHub felépítése](https://workwise-solutions.net/docs/images/diagram-architecture-hu.png)
*Egyetlen alkalmazás szolgálja ki a portált, az API-t és a háttérfolyamatokat, az Ön adatbázisával, cache-ével, fájltárolóival és a választható külső szolgáltatásokkal.*

## Alapfogalmak

| Fogalom | Jelentés |
|---|---|
| Munkaterület | Egy csapat elkülönített területe. A munkajegyek, a munkaterület értesítési csatornái és fájltárolói egy munkaterülethez tartoznak. Lásd: [Munkaterületek](https://workwise-solutions.net/hu/docs/features/workspaces/). |
| Munkajegy | Egy feladat, ügyféllel, termékkel, státusszal, felelősökkel, költségekkel és mellékletekkel. Lásd: [Munkajegyek](https://workwise-solutions.net/hu/docs/features/work-tickets/). |
| Ügyfél | A munkajegy megrendelője. Minden munkaterület közösen használja. Lásd: [Ügyfelek](https://workwise-solutions.net/hu/docs/features/clients/). |
| Gyártó, termékcsoport, termék típus | A termék, amelyről a munkajegy szól, három szinten. Lásd: [Gyártók és munkajegy opciók](https://workwise-solutions.net/hu/docs/features/manufacturers-and-ticket-options/). |
| Garanciát viselő | Aki a költséget viseli (például a gyártói garancia, egy biztosító vagy maga az ügyfél). |
| Munkajegy típus, munka típus | Milyen jellegű a munkajegy (például bevizsgálás, javítás), és milyen munka történik (például garanciális javítás). A munka típusokhoz a nyomtatványokon megjelenő jogi szöveg tartozik. |
| Munkafolyamat | Alapértelmezett árral rendelkező munkalépés, amelyet a munkajegyekhez lehet adni. Lásd: [Munkafolyamatok és szállítások](https://workwise-solutions.net/hu/docs/features/acting-works-and-deliveries/). |
| Komponens | Raktári tétel mennyiséggel és árral, amelyet a munkajegyekhez lehet adni. Lásd: [Raktárkészlet](https://workwise-solutions.net/hu/docs/features/warehouse/). |
| Szállítás | Szállítási útvonal árral, amelyet a munkajegyekhez lehet adni. |
| Értesítési csatorna | E-mail, Slack vagy Microsoft Teams kapcsolat a felhasználók értesítésére. Lásd: [Értesítések](https://workwise-solutions.net/hu/docs/features/notifications/). |
| Fájltároló | Ahol a mellékletek és képek tárolódnak: a szerver merevlemeze, Azure Blob, Amazon S3, MinIO, Box, SharePoint vagy Google Cloud Storage. Lásd: [Fájltárolók](https://workwise-solutions.net/hu/docs/features/file-storages/). |

Értesítési csatornák és fájltárolók két szinten léteznek: **munkaterület szinten** (csak az adott munkaterület használja őket) és **alkalmazás szinten** (**App Értesítési Csatornák**, **App Fájltárolók**, minden munkaterület használhatja őket).

![Alapfogalmak és hovatartozásuk](https://workwise-solutions.net/docs/images/diagram-concepts-hu.png)
*A törzsadatokat minden munkaterület közösen használja; a munkajegyek, a munkaterület csatornái és tárolói egy munkaterülethez tartoznak.*

## Kik használják a WorkSmartHubot

- **Alkalmazás adminisztrátorok (Super Admin).** Ők telepítik és konfigurálják az alkalmazást, kezelik a felhasználókat, a munkaterületeket és a globális beállításokat. Általában csak néhány ilyen felhasználó van.
- **Munkaterület adminisztrátorok.** Egy csapat munkaterületéért felelnek: a tagokért, a jogosultságokért, az értesítési csatornákért és fájltárolókért, valamint a munkaterület összes munkajegyéért.
- **Munkajegy adminisztrátorok.** Létrehozzák, módosítják és törlik a munkajegyeket a saját munkaterületükön.
- **Technikusok.** Csak azokat a munkajegyeket látják, amelyekhez őket vagy a csoportjukat hozzárendelték, és ezeken is csak néhány mezőt módosíthatnak (státusz, felelősök, munkafolyamatok, komponensek, mellékletek). Ezt a szerver minden kérésnél ellenőrzi.
- **Olvasók.** Az olvasási jogosultságú felhasználók módosítás nélkül megtekinthetik a munkajegyeket vagy más erőforrásokat.
- **Törzsadat-karbantartók.** Külön alkalmazás jogosultságokkal egyes felhasználók adminisztrátori jog nélkül is kezelhetik az ügyfeleket, gyártókat, komponenseket, munkafolyamatokat vagy szállításokat.

A részletek a [Jogosultságok és szerepkörök](https://workwise-solutions.net/hu/docs/permissions-and-roles/) oldalon találhatók.

## Hogyan működik

1. Az alkalmazás adminisztrátor létrehozza a munkaterületeket, és jogosultságokat ad bennük a felhasználóknak és csoportoknak.
2. Rögzítik a törzsadatokat: cégadatok, gyártók és terméktípusok, garanciát viselők, munkajegy és munka típusok, munkafolyamatok, szállítások, komponensek és ügyfelek. Új ügyfelet a munkajegy mentése is létrehozhat.
3. A munkajegy adminisztrátorok munkajegyeket hoznak létre a munkaterületükön, felhasználókat vagy csoportokat rendelnek hozzájuk, és kiválasztanak egy értesítési csatornát és egy fájltárolót.
4. A hozzárendelt munkatársak dolgoznak a munkajegyen: módosítják a státuszát, munkafolyamatokat és komponenseket adnak hozzá, mellékleteket töltenek fel. Minden módosítás bekerül az eseménynaplóba, a státusz- és felelősváltozásokról pedig a munkajegy értesítési csatornáin keresztül megy értesítés.
5. Egy háttérfolyamat emlékezteti a felelősöket és a munkaterület adminisztrátorokat, ha egy nyitott munkajegy beállítható ideig (alapértelmezetten 5 napig) nem változott.
6. Ha a munka elkészült, a munkajegy kinyomtatható (összesítés és felvételi elismervény), és ha a Számlázz.hu számlázás be van kapcsolva, számlázható.

## Nagyvállalati képességek

- **Hitelesítés és jogosultságkezelés** a vállalati identitásszolgáltatón keresztül (Active Directory, LDAP, Microsoft Entra ID, OAuth: Okta, Google, Microsoft vagy egyedi szolgáltató), csoportalapú jogosultságokkal.
- **Több bérlő egy telepítésen belül**: a munkaterületek teljesen elkülönülnek egymástól.
- **Eseménynapló**: minden felhasználói művelet bekerül az [Események](https://workwise-solutions.net/hu/docs/features/audit-and-logs/) oldalra, a hibák a **Hiba Események** oldalra.
- **Több értesítési csatorna**: e-mail, Slack és Microsoft Teams.
- **Több fájltárolási szolgáltatás**: a szerver merevlemeze, Azure Blob, Amazon S3, MinIO, Box, SharePoint, Google Cloud Storage.
- **Több belső adatbázis**: SQLite, SQL Server, PostgreSQL, MySQL.
- **Személyes hozzáférési tokenek** API automatizáláshoz, hozzáférési (access) és frissítő (refresh) token párként. A tokenek csak API hívásra használhatók, böngészős bejelentkezésre soha, és egy visszavont token körülbelül egy percen belül minden szerveren érvényét veszti.
- **Több csomópontos működés** közös adatbázissal és cache-sel; az ütemezett háttérfolyamatok minden időpontban csak egyszer futnak le a csomópontok között ([Éles üzemeltetés](https://workwise-solutions.net/hu/docs/installation/operations/)).

## Beépített dokumentáció

Az alkalmazásnak saját, rövid magyar nyelvű dokumentációja is van: a **Bevezetés** és a **Kezdő Lépések** oldal, mindkettő letölthető a **Dokumentum letöltése** gombbal. Ez a wiki ugyanezeket a témákat részletesebben tárgyalja.

![A beépített Kezdő Lépések oldal](https://workwise-solutions.net/docs/images/overview-getting-started.png)

## A menü

A bal oldali menü csak azokat az oldalakat mutatja, amelyeket a bejelentkezett felhasználó megnyithat. Minden jogosultsággal így néz ki:

| Menüszakasz | Menüpontok |
|---|---|
| (felül) | **Bevezetés**, **Kezdő Lépések**, **Mobil Alkalmazás** (ha a licenc tartalmazza) |
| Ügyfélmenedzsment | **Ügyfelek**, **Számlák** (ha a Számlázz.hu be van kapcsolva) |
| Gyártók & Típusok | **Gyártók & Típusok** |
| Adminisztráció | **Munkaterületek**, **Munkajegyek**, **Értesítési Csatornák**, **Fájltárolók** |
| Munkajegy Konfigurációk | **Garanciát Viselők**, **Munkajegy Típusok**, **Munka Típusok** |
| Munkafolyamatok | **Munkafolyamatok** |
| Szállítások | **Szállítások** |
| Raktárkészlet | **Komponensek** |
| Szolgáltatás felhasználói katalógus | **Szolgáltatás felhasználói katalógus** |
| Hozzáférési Token | **Személyes Hozzáférési Tokenek**, **Admin Token Menedzsment** |
| Felhasználók & Csoportok | **Felhasználók**, **Csoportok** |
| Külső Felhasználók & Csoportok | **Külső Felhasználók**, **Külső Csoportok** |
| Profilok | **Profilok** (csak nem lokális felhasználói tár esetén) |
| Alkalmazás | **App Konfiguráció**, **Státusz**, **App Értesítési Csatornák**, **App Fájltárolók**, **Licenc** |
| Események & Naplófájlok | **Események**, **Hiba Események**, **Naplófájlok**, **Ügyfél Email Események** |
| Fiók | **Profil**, **Jelszóváltoztatás**, **Kijelentkezés** |

![Munkajegy szerkesztő egy Super Admin teljes menüjével](https://workwise-solutions.net/docs/images/tickets-editor-full.png)
*A Super Admin minden menüpontot lát. Jobb oldalon: a munkajegy szerkesztő.*
