Katalog Części — Instrukcja administratora

Pełna dokumentacja funkcji administracyjnych i zarządzania systemem
TYLKO DLA ADMINA

// Spis treści

  1. System ról — uprawnienia użytkowników
  2. Panel administratora
  3. Zarządzanie dostępem (whitelist e-mail)
  4. Zarządzanie kategoriami
  5. Zdjęcia kategorii
  6. Import CSV / XLSX
  7. Import AI (faktury i cenniki)
  8. Eksport XLSX
  9. Wyszukiwanie i usuwanie duplikatów
  10. Usuwanie wielu części naraz
  11. Sync / JSON — kopia zapasowa sesji
  12. Przypomnienie — funkcje wspólne z użytkownikiem

1. System ról — uprawnienia użytkowników

Każdy zalogowany użytkownik ma przypisaną rolę. Rola decyduje, do jakich funkcji ma dostęp.

Rola Co może robić Czego nie może
NOWY Przeglądanie, szukanie, dodawanie części i linków, tworzenie zestawień Edytowanie, usuwanie, import, eksport, zarządzanie kategoriami i użytkownikami
EDITOR Wszystko co NOWY + edytowanie istniejących wpisów, zarządzanie kategoriami Import, eksport, usuwanie, panel admin
ADMIN Pełny dostęp — wszystkie funkcje —
💡 WAŻNE Zmiana roli użytkownika jest natychmiastowa. Nowe uprawnienia obowiązują przy następnym odświeżeniu strony przez użytkownika.

2. Panel administratora

Kliknij przycisk „Admin" w prawym górnym rogu (widoczny tylko dla admina). Otworzy się panel z dwiema zakładkami:

ZRZUT EKRANU: prawy górny róg z przyciskiem „Admin"

Zakładka „Użytkownicy"

Widoczna lista wszystkich zalogowanych użytkowników. Dla każdego z nich możesz zmienić rolę za pomocą listy rozwijanej.

ZRZUT EKRANU: panel admin, zakładka Użytkownicy — lista z listami rozwijanymi ról
⚠️ UWAGA Twój własny wpis jest oznaczony lewą zieloną krawędzią. Możesz zmienić swoją własną rolę — bądź ostrożny, żeby przypadkowo nie pozbawić się dostępu admina.

Przycisk „Usuń" przy użytkowniku usuwa jego konto z systemu. Użytkownik straci dostęp natychmiast.

3. Zarządzanie dostępem (whitelist e-mail)

Program nie jest ogólnodostępny — tylko osoby z autoryzowanymi adresami e-mail mogą się zalogować. Zarządzasz tym w Panelu admin → zakładka „Dostęp e-mail".

ZRZUT EKRANU: panel admin, zakładka „Dostęp e-mail"

Dodawanie nowego użytkownika

Usuwanie dostępu

Kliknij „✕" przy adresie e-mail na liście. Osoba straci możliwość zalogowania się, ale jej dane w katalogu pozostają.

💡 WAŻNE Dozwolone domeny e-mail (np. @wsbtechnika.pl) są zdefiniowane w kodzie aplikacji — nie da się ich zmienić z poziomu panelu. Skontaktuj się z twórcą aplikacji, jeśli potrzebujesz dodać nową domenę.

4. Zarządzanie kategoriami

Kliknij przycisk „Kategorie" w pasku narzędzi. Dostępny dla EDITOR i ADMIN.

ZRZUT EKRANU: okno zarządzania kategoriami

Dodawanie kategorii głównej

Dodawanie podkategorii

Podkategoria pojawi się w liście jako KategoriaGłówna/Podkategoria.

Usuwanie kategorii

Kliknij „✕" przy nazwie kategorii. Kategoria zniknie z list wyboru, ale przypisane do niej części nie zostaną usunięte — nadal będą w bazie, tylko bez aktywnej kategorii.

🔴 UWAGA Przed usunięciem kategorii przenieś lub usuń przypisane do niej części. Inaczej stają się „osieroconymi" wpisami, które trzeba ręcznie poprawić.
💡 WAŻNE Kategorie domyślne (Naczepa, Przyczepki, Ciągnik rolniczy) są wbudowane w kod aplikacji — nie można ich usunąć z panelu.

5. Zdjęcia kategorii

Każda kategoria na stronie głównej może mieć zdjęcie (kafelek). Zdjęcia zarządzasz w oknie Kategorii — tylko ADMIN widzi ikonę 📷 przy każdej kategorii.

Dodanie / zmiana zdjęcia kategorii

Usunięcie zdjęcia kategorii

Kliknij ikonę 🗑 (kosz) przy danej kategorii w oknie Kategorii. Zdjęcie zostanie usunięte z chmury — kategoria wróci do domyślnego wyglądu (szary placeholder).

ZRZUT EKRANU: okno kategorii z ikonami 📷 i 🗑 przy każdej kategorii

6. Import CSV / XLSX

Pozwala wgrać wiele części naraz z pliku arkusza kalkulacyjnego. Kliknij przycisk „Import CSV/XLSX" w pasku narzędzi.

ZRZUT EKRANU: okno importu z polem przeciągnij-i-upuść
ZRZUT EKRANU: okno importu z wypełnionym mapowaniem kolumn i podglądem danych
✅ WSKAZÓWKA Kolumna „Nazwa części" jest jedynym polem obowiązkowym. Wiersze bez nazwy są pomijane automatycznie.
💡 CENY Wystarczy podać tylko jedną cenę (netto lub brutto) — program automatycznie obliczy drugą na podstawie stawki VAT 23%.

Obsługiwane formaty cen w pliku

Import obsługuje różne formaty zapisu liczb: 1234.56, 1234,56, 1 234,56 — wszystkie zostaną poprawnie wczytane.

⚠️ UWAGA Import nie sprawdza duplikatów — jeśli importujesz ten sam plik dwa razy, wpisy pojawią się podwójnie. Skorzystaj z funkcji Duplikatów, żeby je posprzątać.

7. Import AI (faktury i cenniki)

Funkcja „Import AI" pozwala wczytać części bezpośrednio z faktury, cennika lub zdjęcia — bez ręcznego przepisywania. Kliknij przycisk „Import AI" w pasku narzędzi.

ZRZUT EKRANU: okno importu AI z polem przeciągnij-i-upuść na PDF lub zdjęcie
💡 WAŻNE Import AI korzysta z modelu językowego (zewnętrzna usługa). Jakość odczytu zależy od czytelności dokumentu. Zawsze sprawdź wyniki przed importem.

8. Eksport XLSX

Pozwala pobrać aktualny katalog jako plik Excel. Przycisk „Eksport XLSX" w pasku narzędzi eksportuje aktualnie wyfiltrowaną listę — nie cały katalog.

✅ WSKAZÓWKA Żeby wyeksportować cały katalog — przed kliknięciem eksportu wyczyść filtry (kliknij kategorię „Wszystkie" i usuń tekst z wyszukiwarki).

Wyeksportowany plik zawiera kolumny: ID, Kategoria, Nazwa, Cena netto, Cena brutto, Opis, Zdjęcie (URL), Data dodania.

Eksport linków do dostawców

W zakładce „Linki / Dostawcy" jest osobny przycisk „Eksport XLSX" — pobiera listę dostawców.

9. Wyszukiwanie i usuwanie duplikatów

Kliknij przycisk „Duplikaty" w pasku narzędzi. Program znajdzie i pokaże grupy identycznych wpisów.

ZRZUT EKRANU: okno duplikatów z listą grup i checkboxami
💡 CO JEST DUPLIKATEM? Dwa wpisy są duplikatem, gdy mają tę samą kategorię, tę samą nazwę i tę samą cenę netto. Jeśli ceny się różnią — nie są duplikatem, nawet gdy nazwy są identyczne.
🔴 UWAGA Usunięcie jest nieodwracalne. Upewnij się, że zaznaczasz kopie do usunięcia, a nie oryginały.

10. Usuwanie wielu części naraz

W widoku kart i tabeli każda część ma checkbox (pole wyboru). Możesz zaznaczyć wiele części i usunąć je jednocześnie.

ZRZUT EKRANU: widok tabeli z zaznaczonymi checkboxami i pływającym przyciskiem „Usuń zaznaczone"
🔴 UWAGA Usunięcie jest nieodwracalne. Nie ma opcji cofnięcia. Rozważ eksport przed masowym usuwaniem.

11. Sync / JSON — kopia zapasowa sesji

Przycisk „Sync / JSON" w prawym górnym rogu paska narzędzi otwiera narzędzie do ręcznej synchronizacji i tworzenia kopii zapasowej.

ZRZUT EKRANU: okno Sync/JSON

Co można zrobić?

⚠️ UWAGA Import JSON zastępuje aktualne dane — używaj ostrożnie. To narzędzie awaryjne, nie codzienna funkcja.

12. Przypomnienie — funkcje wspólne z użytkownikiem

Admin korzysta ze wszystkich funkcji, które mają zwykli użytkownicy. Szczegółowy opis tych funkcji znajduje się w Instrukcji obsługi dla użytkownika (instrukcja_uzytkownik.html):