feat: YD-87 Documentation import, Admin permissions

docs/3-administrator-guides/05-permissions/01-users/README.md

@@ -1,10 +1,40 @@
 ---
-title: Users
-description: Users
+title: Użytkownicy
+description: Moduł pozwala na wprowadzanie użytkowników (standardowych oraz administracyjnych) do systemu. Dzięki temu można decydować, kto ma dostęp i na jakim poziomie.
 keywords:
-  - Users
+  - Użytkownicy
   - Panel konfiguracyjny
   - YetiForce
 tags:
-  - Users
+  - Użytkownicy
+preview: user_list.jpg
 ---
+
+Moduł `Użytkownicy` pozwala na wprowadzanie użytkowników (standardowych oraz administracyjnych) do systemu. Dzięki temu można decydować, kto ma dostęp i na jakim poziomie.
+
+## Lista użytkowników
+
+![user_list.jpg][user_list.jpg]
+
+Bezpośrednio na liście użytkowników jest dostęp do takich narzędzi jak:
+
+1. Masowa edycja - pozwala wprowadzać zmiany na wielu użytkownikach jednocześnie.
+2. Masowe resetowanie hasła - przydatne, gdy trzeba zmienić hasło dostępu dla wielu użytkowników jednocześnie.
+3. Import i eksport użytkowników pozwala na łatwe przenoszenie użytkowników pomiędzy różnymi systemami bazowymi.
+4. Dodawanie użytkownika - pozwala na ręczne dodanie użytkownika w systemie.
+
+## Dodawanie użytkownika
+
+![user_add.jpg][user_add.jpg]
+
+Dodając użytkownika do systemu, należy wypełnić wszystkie pola wymagane przez system (oznaczone gwiazdką) oraz prawidłowo skonfigurować takie informacje, jak waluta, strefa czasowa, formatowanie liczb, język itd.
+
+Od strony uprawnień, najważniejszym polem jest `Rola`, ponieważ będzie ono definiowało zakres uprawnień i zakres dostępu do danych w całym systemie. Jednocześnie należy pamiętać, że żaden użytkownik nie powinien pracować na użytkowniku `administrator`, ponieważ uprawnienia administracyjne służą tylko do zmian administracyjnych w systemie.
+
+System ma wbudowany mechanizm, który wymusza co określony czas zmianę hasła na nowe. Dodatkowo system posiada wsparcie dla 2FA.
+
+## Import użytkowników
+
+![user_import.jpg][user_import.jpg]
+
+System umożliwia import użytkowników. Warto mieć na uwadze, że format danych powinien być zgodny z formatem danych przy eksporcie użytkowników.

docs/3-administrator-guides/05-permissions/02-roles/README.md

@@ -1,6 +1,6 @@
 ---
-title: Role - Struktura organizacyjna firmy
-description: W systemie istnieje wbudowany moduł Ról, umożliwiający mapowanie struktury organizacyjnej firmy.
+title: Role
+description: W systemie istnieje wbudowany moduł ról, umożliwiający mapowanie struktury organizacyjnej firmy.
 keywords:
   - firma
   - organizacyjna
@@ -11,10 +11,59 @@ keywords:
 tags:
   - role
   - struktura
+preview: role-1.jpg
 ---
 
 W systemie istnieje wbudowany moduł Ról, umożliwiający mapowanie struktury organizacyjnej firmy. Mechanizm ten może odzwierciedlać nawet najbardziej złożoną strukturę. Aby skonfigurować ten moduł, musisz przejść do "Konfiguracja systemu" i wybrać "Uprawnienia" i "Role".
 
 Zacznijmy od przykładu organizacji, gdzie na samej górze mamy prezesa, pod nim dyrektora, pod nim trzech kierowników i każdy ma po jednym pracowniku. Jest to prosty przykład struktury, ale w systemie YetiForce nie ma ograniczeń jeśli chodzi o ilość poziomów, które można dodać.
 
+## Drzewo ról
+
 ![role-1.jpg](role-1.jpg)
+
+Moduł `Role` jest modułem łączącym z jednej strony użytkowników, a z drugiej profile, z których użytkownik dziedziczy uprawnienia do modułów, narzędzi i akcji.
+
+## Dodawanie roli
+
+![role-add.jpg](role-add.jpg)
+
+Tworzenie roli daje ogromne możliwości na definiowanie uprawnień dla użytkowników, którzy zostali przypisani bezpośrednio do tej roli. Do najważniejszych możliwości modułu można zaliczyć:
+
+1. Określenie uprawnień do przypisywania użytkowników/grup dla pola 'właściciel rekordu' - uprawnienie działa globalnie.
+2. Określenie uprawnień do przypisywania użytkowników/grup dla pola 'osoby współdzielące' - uprawnienie działa globalnie.
+3. Przypisanie do profilu lub profili (w przypadku przydzielenie do wielu profili, system sumuje uprawnienia).
+4. Blokada zmiany właściciela rekordu (wówczas przy każdym tworzeniu rekordu to on jest jego właścicielem bez możliwości zmiany - pole jest nieaktywne).
+
+Dla uprawnień opisanych w punktach 1. i 2., system pozwala na ustawienie następujących mechanizmów:
+
+- Tylko ja - użytkownik, który jest zalogowany
+- Użytkownicy posiadający podrzędną rolę
+- Użytkownicy posiadający podrzędną rolę lub tą samą rolę co ja
+- Wszyscy użytkownicy
+- Z panelu przydziału rekordów
+
+W praktyce oznacza to, że gdy w punktach 1. i 2. zostanie ustawiona któraś z powyższych wartości, będzie można uzyskać dostęp do różnej listy użytkowników/grup jakie można przydzielać, tworząc rekord. Ostatnia opcja (z panelu) pozwala na dowolną inną konfigurację, którą można określić w niezależnym panelu opisanym również w tej dokumentacji.
+
+Następnie w roli można określić dodatkowe parametry decydujące o 'dziedziczeniu uprawnień':
+
+1. Czy udostępnić listę do rekordów powiązanych z rekordem do którego mamy dostęp?
+2. Czy udostępnić podgląd do rekordów powiązanych z rekordem do którego mamy dostęp?
+3. Uprawnienia do rekordów powiązanych bazują na:
+   1. Właściciel rekordu
+   2. Osoby współdzielące
+   3. Dostęp do rekordu
+   4. Wyjątki zasad dostępu
+
+Parametry te, pozwalają na włączenie zależności dostępu do danych w zależności od hierarchii powiązania modułów, np. jeżeli mamy dostęp do klienta, to możemy mieć również dostęp do wszystkich rekordów powiązanych, np. kalendarz, dokumenty, komentarze, faktury nawet jeżeli użytkownik nie ma do nich bezpośrednio dostępu.
+
+Dodatkowo jeżeli zostanie włączona opcja: 'Czy włączyć edycję do rekordów powiązanych - z naszym rekordem - których nie jesteśmy właścicielem?' wówczas system pozwoli nam na edycję rekordów, nawet jeżeli normalnie nie mielibyśmy do tego dostępu. Należy pamiętać, że dostęp mamy tylko wówczas, gdy system 'wie' z jakiego rekordu 'otrzymaliśmy' te uprawnienia.
+
+Na roli możemy określić poziom do wyszukiwarki oraz do danych jakie możemy wyszukiwać, możemy to ustawić za pomocą narzędzi:
+
+- Moduły w których można wyszukiwać bez uprawnień
+- Czy włączyć możliwość zaawansowanego wyszukiwania?
+
+W systemie można wyłączyć również możliwość podglądu innych kalendarzy (z poziomu graficznego interfejsu - 'Czy może przeglądać graficzny kalendarz innych użytkowników?').
+
+Opcja 'Automatyczny przydział rekordów' pozwala na wykorzystanie panelu do automatycznego rozdzielania rekordów w systemie. Opcja ta jest szczególnie przydatna dla firm, które automatycznie ładują do systemu duże bazy leadów i szans sprzedażowych.

docs/3-administrator-guides/05-permissions/03-profiles/README.md

@@ -10,7 +10,7 @@ keywords:
 preview: profiles-01.jpg
 ---
 
-Profile pozwalają zdefiniować uprawnienia do wielu funkcji i widoków dostępnych w systemie.
+Profile pozwalają na określenie uprawnień do przeglądania, tworzenia, edycji, usuwania rekordów, w modułach, do których użytkownik ma dostęp. Dodatkowo w każdym module można określić listę pól, do których użytkownik ma uprawnienia (podgląd, edycja) oraz narzędzia, z jakich może korzystać.
 
 ![profiles-01.jpg](profiles-01.jpg)
 

docs/3-administrator-guides/05-permissions/04-groups/README.md

@@ -0,0 +1,20 @@
+---
+title: Grupy
+description: Grupy służą do określania uprawnień do rekordu (za pomocą pól właściciel rekordu i osoby współdzielące).
+tags:
+  - uprawnienia
+  - grupy
+keywords:
+  - uprawnienia
+  - grupy
+preview: edit.jpg
+---
+
+![edit.jpg](edit.jpg)
+
+Grupy służą do określania uprawnień do rekordu (za pomocą pól właściciel rekordu i osoby współdzielące). Do grup możemy dodawać:
+
+- Użytkowników
+- Inne grupy
+- Role
+- Role i podrole

docs/3-administrator-guides/05-permissions/05-sharing-access/README.md

@@ -0,0 +1,16 @@
+---
+title: Dostęp do modułów
+description: Jednym z ważniejszych modułów zarządzających uprawnieniami, ponieważ określa on dostęp do rekordów, które nie należą do nas.
+tags:
+  - uprawnienia
+  - dostęp do modułów
+keywords:
+  - uprawnienia
+  - dostęp
+  - modułów
+preview: list.jpg
+---
+
+![list.jpg](list.jpg)
+
+Jednym z ważniejszych modułów zarządzających uprawnieniami jest 'Dostęp do modułów', ponieważ określa on dostęp do rekordów, które nie należą do nas. Dodatkowo przy modułach można tworzyć wyjątki, które pozwalają nam na przegląd i edycję danych, które nie należą do nas.

docs/3-administrator-guides/05-permissions/06-global-permission/README.md

@@ -0,0 +1,15 @@
+---
+title: Dostęp specjalny
+description: W tym module tworzone są specjalne uprawnienia, które przydziela się dla profili.
+tags:
+  - uprawnienia
+  - dostęp specjalny
+keywords:
+  - uprawnienia
+  - dostęp
+  - specjalny
+preview: list.jpg
+---
+
+![list.jpg](list.jpg)
+W tym module tworzone są specjalne uprawnienia, które przydziela się dla profili. Uprawnienia te pozwalają na podgląd i edycję do wszystkich rekordów niezależnie od innych uprawnień. Jeżeli użytkownik ma dostęp do modułu, to będzie miał dostęp do wszystkich rekordów w nim.

docs/3-administrator-guides/05-permissions/07-locks/README.md

@@ -0,0 +1,24 @@
+---
+title: Blokady
+description: Narzędzie pozwala ograniczać użytkownikom kopiowanie i wklejanie danych z i do systemu.
+tags:
+  - uprawnienia
+  - blokady
+keywords:
+  - uprawnienia
+  - blokady
+preview: list.jpg
+---
+
+![list.jpg](list.jpg)
+
+Narzędzie pozwala ograniczać użytkownikom kopiowanie i wklejanie danych z i do systemu. Do podstawowych możliwości narzędzia możemy zaliczyć:
+
+- Blokadę wycinania
+- Blokadę kopiowania
+- Blokadę wklejania
+- Blokadę prawego klawisza myszki
+- Blokadę zaznaczenia
+- Blokadę przeciągania elementów strony
+
+Należy pamiętać, że ograniczenia te są nakładane na warstwie przeglądarki, a więc jeżeli ktoś użyje przeglądarki, która nie wspiera tego typu zabezpieczeń, to nie będą one działać.

docs/3-administrator-guides/05-permissions/08-record-allocation-owner/README.md

@@ -0,0 +1,17 @@
+---
+title: Przydział osób współdzielących
+description: Ten panel działa tak samo jak w przypadku modułu 'Przydział właściciela rekordu', ale dotyczy on drugiego pola od uprawnień, czyli pola osób współdzielących.
+tags:
+  - uprawnienia
+  - przydział
+  - współdzielących
+keywords:
+  - uprawnienia
+  - przydział
+  - współdzielenie
+preview: list.jpg
+---
+
+![list.jpg](list.jpg)
+
+Jest to narzędzie, które pozwala na przeglądanie danych na liście rekordów, nie na podstawie tylko tego do kogo dane są przypisane, ale również na podstawie uprawnień wynikających z dziedziczenia. Moduł ten domyślnie działa wolno dla dużych systemów mających duże bazy danych i dużą ilość użytkowników. Dodatkowo mechanizm działa z pewnym opóźnieniem (czas oczekiwania zależy od konfiguracji CRON-a).

docs/3-administrator-guides/05-permissions/10-record-allocation-shared/README.md

@@ -0,0 +1,17 @@
+---
+title: Przydział właściciela rekordu
+description: Narzędzie to pozwala na określenie użytkowników/grup, jakie będą dostępne dla użytkownika przy tworzeniu rekordu w określonym module.
+tags:
+  - uprawnienia
+  - przydział
+  - właściciela
+keywords:
+  - uprawnienia
+  - przydział
+  - właściciel
+preview: list.jpg
+---
+
+![list.jpg](list.jpg)
+
+Narzędzie to pozwala na określenie użytkowników/grup, jakie będą dostępne dla użytkownika przy tworzeniu rekordu w określonym module. Jeżeli dostępne opcje na roli przestają być wystarczające, wówczas z pomocą przychodzi to narzędzie.