Grafiki kwartalne
Etap miesiąca
Do zrobienia
Sprawy agenta
Puls automatu
Porównanie z poprzednim miesiącem
Wyniki salonów
Premie pracowników
Budżety i sprzedaż online
Wpisz budżet i sprzedaż online każdego salonu. Kolumnę liczb z arkusza można wkleić (Ctrl+V) w pierwsze pole: kolejne wiersze wypełnią się same, w kolejności widocznej w tabeli. Sprzedaż online pozostaje 0 do czasu ustalenia reguły.
Rozliczenie miesiąca
Historia rozliczeń
Grafik kwartalny
Reguły salonu i kalendarz kwartału
Nieobecności pracowników
Oddelegowania grafikowe
Synchronizacja z rozliczeniem premii
Brak wczytanego rozliczenia miesiąca.
Odstępstwa i braki
Przejrzyj to przed przekazaniem miesiąca do kontroli. Pozycje oznaczone jako blokujące nie pozwolą zatwierdzić miesiąca.
Przegląd sieci
Ile osób ma zmianę w każdym salonie i dniu wyświetlanego miesiąca. Puste pole w dniu otwarcia znaczy, że salon nie ma obsady; pomarańczowe, że jest poniżej minimum.
Nieobecności w kwartale
Urlopy, zwolnienia i nieobecności wpisane w grafiku. Zwolnienie lekarskie choćby jeden dzień odbiera premię kwartalną, urlop na żądanie i nieobecność nieusprawiedliwiona także miesięczną.
Premie kwartalne
Premia kwartalna liczy się dla salonu: suma obrotów kwartału podzielona przez sumę budżetów kwartału. Kwota progu jest pulą na salon i dzieli się proporcjonalnie do wymiaru etatu. Skład salonu bierze się z ostatniego miesiąca kwartału.
Salony w kwartale
Premie pracowników
Do decyzji właściciela
Koszt premii salon po salonie
Trend miesiąc do miesiąca
Budżet Pomocnika AI
Sprawy agenta premii
Wszystko, co agent premii znalazł w bieżącym miesiącu. Sprawy krytyczne blokują zatwierdzenie miesiąca. Wyjaśnij albo zamknij każdą z nich.
Pytania i sugestie
Masz pytanie do właściciela albo pomysł na zmianę w programie? Wpisz je tutaj. Odpowiedź i status pojawią się przy wpisie, a właściciel widzi liczbę otwartych wpisów przy zakładce Info.
Pytania Asystenta
Pytania, które Asystent AI zadaje HR i właścicielowi, razem z odpowiedziami. Otwarte pytania można odpowiedzieć w sekcji nad zakładkami.
Co się zmieniło
Lista zmian w programie od najnowszej wersji.
Niezależna kartoteka
Salony w kartotece
Pracownicy w kartotece
Nowy salon
Lista salonów Liczba: 0
Nowy pracownik
Lista pracowników Liczba: 0
Oddelegowanie
Lista oddelegowań
Ustawienia
Progi premii
Plik do importu
Podgląd importu
Aktualizacje programu
Mózg salonów
Trwałe ustalenia dla Pomocnika AI i zespołu: zasady premiowania, praktyki HR, decyzje właściciela. Wpis właściciela obowiązuje od razu. Wpis HR, księgowej i Pomocnika jest propozycją, którą zatwierdza właściciel; do tego czasu Pomocnik traktuje ją jako niewiążącą. W rozmowie z Pomocnikiem wystarczy napisać „zapamiętaj: ...".
Dziennik audytu
Każdy zapis, blokada, eksport, odpowiedź Asystentowi i odmowa dostępu zostawiają wpis. Bez zakresu dat pokazuje się bieżący miesiąc kalendarzowy. Wpisy są przechowywane 36 miesięcy.
| Kiedy | Kto | Akcja | Obiekt | Szczegóły |
|---|
Zdrowie aplikacji
| Miesiąc | Etap | Ostatni zapis | Kto | Integralność |
|---|
Ustalenia z pytań Asystenta
Odpowiedzi HR i właściciela na pytania Asystenta AI. Każda odpowiedź jest też w dzienniku audytu.
Konta
Konta aplikacji: kto może się zalogować i z jaką rolą. Nowe konto dostaje hasło startowe pokazane raz; przy pierwszym logowaniu trzeba je zmienić. Reset hasła, wylogowanie ze wszystkich urządzeń i wyłączenie konta zostają w audycie.
Role i uprawnienia
Zaznaczenie = rola ma uprawnienie. Rola Administrator jest systemowa (zawsze komplet). Zmiana działa od następnego kliknięcia osoby, każdy zapis trafia do audytu. Rolę można usunąć tylko, gdy nikt jej nie ma.
Pomoc
Podręcznik obejmuje pełny cykl rozliczenia: przygotowanie miesiąca, kartotekę, import, obliczenia, kontrolę wyników, zapis, eksport, aktualizacje i odzyskiwanie danych.
Wyszukiwanie obejmuje tytuły, treść, nazwy pól i typowe komunikaty programu.
Szybki start: pierwsze kompletne rozliczenie
- Uruchom rozpakowaną aplikację i sprawdź pasek Pracujesz teraz na.
- W zakładce Miesiące wybierz rok i miesiąc, a następnie użyj Nowy miesiąc z aktualnych danych.
- W Kartotece sprawdź, które salony i osoby są aktywne, po czym wgraj aktywne listy do miesiąca.
- Uzupełnij dane salonów: budżety, sprzedaż, godziny i ewentualne uwagi.
- Uzupełnij pracownikom etat, godziny, podstawę godzin oraz przypisanie do salonu.
- Dodaj oddelegowania i sprawdź progi w zakładce Reguły.
- Otwórz Wyniki, usuń wszystkie statusy do uzupełnienia i sprawdź kwoty.
- Kliknij żółty przycisk zapisu w górnym pasku albo Zapisz aktualny miesiąc.
- Dopiero po zielonym potwierdzeniu wykonaj potrzebne eksporty XLSX, CSV lub JSON.
Najważniejsze: wybór miesiąca w formularzu nie oznacza jego wczytania. O aktualnie używanych danych zawsze informuje górny pasek.
Role, konta i zakładka Więcej
Logowanie jest na ekranie aplikacji: login i hasło konta. Login i rola są widoczne w nagłówku obok przycisków Zmień hasło i Wyloguj. Sesja trwa do 12 godzin, a po 2 godzinach bezczynności trzeba zalogować się ponownie.
Każda rola to zestaw uprawnień z matrycy (Więcej, Role i uprawnienia). Role startowe:
- Administrator (rola systemowa, zawsze komplet): konta, role, audyt, zdrowie, ustalenia, moderacja tablicy Info i mózgu, zasady premii, odblokowanie miesiąca.
- HR: prowadzi miesiąc, kartotekę, grafiki kwartalne i premie kwartalne, pobiera listę płac, rozmawia z Pomocnikiem AI.
- Księgowa: tylko podgląd danych i Pobierz listę płac z zatwierdzonego miesiąca. Pola są wyłączone, przyciski zapisu i etapów ukryte; serwer i tak odrzuca każdy zapis (komunikat z kodem 403), a odmowa trafia do audytu.
Ekran bez uprawnienia znika z menu, a zapis bez uprawnienia dostaje odmowę z nazwą brakującego uprawnienia. Każde zalogowane konto może dodać wpis na tablicy Info i propozycję do mózgu.
Konta i hasła
Konta zakłada Administrator (Więcej, Konta): login, imię i nazwisko, rola. Nowe konto i konto po resecie hasła dostaje hasło startowe pokazane raz, które trzeba zmienić przy pierwszym logowaniu; do tego czasu aplikacja pokazuje tylko okno zmiany hasła. Hasło ma od 12 do 128 znaków (może być zdanie). Karta konta pokazuje ostatnie logowanie, aktywne sesje i ostatnie zdarzenia oraz pozwala nadać nowe hasło, wylogować ze wszystkich urządzeń i wyłączyć konto (dane i historia zostają). Po dziesięciu nieudanych próbach logowania konto jest blokowane na 15 minut.
Audyt, zdrowie, ustalenia
Audyt pokazuje dziennik zdarzeń z filtrami kto, akcja i zakres dat oraz pobiera go jako CSV. Zdrowie podaje wersję, ostatnie zasilenie ze Stoków, ostatni zapis każdego miesiąca, ostatnią kopię, rozmiar danych i liczbę wpisów audytu w bieżącym miesiącu. Ustalenia zbierają odpowiedzi na pytania Asystenta AI.
Retencja: wpisy audytu są przechowywane 36 miesięcy, kopie robocze miesięcy 24 miesiące; archiwum zamkniętych miesięcy i naliczenia zostają bez limitu.
Tablica Info
Zakładka Info zbiera w jednym miejscu komunikację wokół programu. Liczba przy nazwie zakładki (np. Info 2) to wpisy, na które nikt jeszcze nie odpowiedział.
Pytania i sugestie
Każde konto (HR, główna księgowa, właściciel) może wysłać pytanie albo sugestię. Wpis pokazuje autora, datę, treść i status. Właściciel widzi przy każdym wpisie pole odpowiedzi, wybór statusu i przycisk Usuń (usunięcie wymaga drugiego kliknięcia).
- otwarte: wpis czeka na reakcję właściciela,
- rozpatrywana: sugestia jest analizowana,
- wdrożona: zmiana trafiła do programu (patrz Co się zmieniło),
- odrzucona: sugestia nie będzie wdrażana; powód jest w odpowiedzi,
- odpowiedziano: pytanie ma odpowiedź.
Odpowiedź na nietknięty wpis ustawia status odpowiedziano, chyba że właściciel wybierze inny. Każde dodanie wpisu, odpowiedź, zmiana statusu i usunięcie zostawiają wpis w dzienniku audytu.
Pytania Asystenta
Lista pytań, które Asystent AI zadaje HR (regulamin, budżety, godziny, online, lista płac, ERP), razem z odpowiedziami i podpisem. Otwarte pytanie ma link odpowiedz, który prowadzi do sekcji pytań nad zakładkami.
Co się zmieniło
Lista zmian w programie według wersji i daty wydania. Serwer czyta ją z pliku CHANGELOG.md, więc jest zawsze zgodna z wgraną wersją.
Tablica działa po otwarciu aplikacji z serwera. Wpisy są zapisane w pliku data/info.json obok innych danych aplikacji.
Ekran Start: etap miesiąca, braki, sprawy agenta
Zakładka Start otwiera się jako pierwsza i pokazuje stan wczytanego miesiąca w jednym miejscu: kafle (etap, premie razem, realizacja sieci, liczba braków), listę Do zrobienia, puls automatu ze Stoków, sprawy agenta premii oraz porównanie z poprzednim miesiącem.
Etapy miesiąca
- Zasilony: automat wgrał dane ze Stoków pierwszego dnia miesiąca.
- W uzupełnianiu: HR uzupełnia budżety, godziny i oddelegowania; każdy zapis z aplikacji ustawia ten etap.
- Do kontroli: przycisk Przekaż do kontroli wymaga miesiąca bez błędów walidatora. W razie potrzeby Wróć do uzupełniania z podanym powodem.
- Zatwierdzony: Zatwierdź i zablokuj (drugie kliknięcie w ciągu 4 sekund) blokuje miesiąc i zapisuje naliczenie. Wymaga etapu Do kontroli i braku otwartych spraw krytycznych.
- Wydany: po pobraniu listy płac przyciskiem Pobierz listę płac.
- Korekta: odblokowanie z powodem otwiera nową wersję naliczenia.
Do zrobienia
Pozycje blokuje uniemożliwiają przekazanie do kontroli, uwaga wymagają sprawdzenia, info są tylko informacją. Przycisk przy pozycji przenosi do właściwej zakładki. Lista jest liczona z zapisanego miesiąca; przy niezapisanych zmianach najpierw zapisz miesiąc.
Sprawy agenta
Agent premii sprawdza kompletność, obroty, godziny, oddelegowania i zmiany miesiąc do miesiąca. Sprawę można wyjaśnić (z treścią wyjaśnienia) albo zamknąć. Sprawy krytyczne w stanie „nowa” blokują zatwierdzenie.
Jeżeli serwer nie został jeszcze zaktualizowany, ekran pokazuje kontrolę lokalną, a pełna lista braków i sprawy agenta pojawią się po aktualizacji serwera.
Budżety i online: wpisywanie, wklejanie i potwierdzanie
- Zakładka Budżety i online pokazuje wszystkie salony miesiąca z polami budżetu i sprzedaży online oraz źródłem budżetu (wpis ręczny, przepisany z poprzedniego miesiąca, import) i informacją, kto i kiedy go potwierdził.
- Przy zakładaniu miesiąca budżety są przepisywane z poprzedniego miesiąca i oznaczane jako niepotwierdzone. Trzeba je sprawdzić i potwierdzić.
- Kolumnę liczb skopiowaną z arkusza wklej (Ctrl+V) w pierwsze pole kolumny: kolejne wiersze wypełnią się w kolejności widocznej w tabeli. Liczby mogą mieć przecinek, spacje i oznaczenie zł.
- Zapisz i potwierdź budżety zapisuje wszystkie budżety naraz i oznacza je jako potwierdzone przez zalogowaną osobę. Po zapisie miesiąc jest odświeżany z serwera.
- Sprzedaż online pozostaje 0 do czasu ustalenia reguły z HR.
Wczytany miesiąc, wybrany miesiąc i wersja robocza
- Wczytany miesiąc to dane faktycznie widoczne we wszystkich zakładkach.
- Wybrany miesiąc to rok i miesiąc ustawione w formularzu. Dopóki nie użyjesz wczytania lub utworzenia nowego miesiąca, formularz nie zmienia danych.
- Wersja robocza jest automatycznie zabezpieczana lokalnie po zmianach, aby można było wrócić do pracy po zamknięciu programu.
- Wersja robocza nie zastępuje zapisu w historii. Do zakończenia rozliczenia potrzebny jest jawny zapis miesiąca.
- Żółty przycisk oznacza niezapisane zmiany. Zielony komunikat oznacza, że aktualne dane zapisano pod wskazanym miesiącem.
- Ostrzeżenie o różnicy okresów chroni przed przypadkową pracą na innym miesiącu niż wybrany w formularzu.
Historia miesięcy: zapis, blokada, wczytanie i usunięcie
Nowy miesiąc
Nowy miesiąc z aktualnych danych kopiuje bieżącą konfigurację, zmienia okres i synchronizuje aktywną kartotekę. Wartości sprzedaży, godzin i budżetów mogą pozostać z poprzedniego okresu, dlatego trzeba je sprawdzić lub zastąpić importem.
Zapis i nadpisanie
- Zapis tworzy plik RRRR-MM.json w historii i ustawia okres na nazwę wybranego miesiąca.
- Ponowny zapis tego samego miesiąca nadpisuje jego aktualną wersję, a wcześniejszą kopiuje do folderu kopii.
- Program przechowuje do 20 ostatnich automatycznych kopii danego nadpisywanego miesiąca.
Blokowanie zakończonego rozliczenia
- Zablokuj chroni zapis miesiąca jednocześnie przed nadpisaniem i usunięciem. Ochrona działa również po ponownym uruchomieniu programu.
- Przed założeniem blokady program wymaga zapisania albo odrzucenia bieżących zmian roboczych tego miesiąca.
- Zablokowany miesiąc nadal można wczytać, przeglądać, eksportować i użyć jako źródła dla opcji Nowy miesiąc z aktualnych danych.
- Odblokuj wymaga potwierdzenia. Dopiero później możliwy jest ponowny zapis albo usunięcie miesiąca.
- Blokada jest metadanym zapisu, a nie częścią danych rozliczenia, dlatego nie przechodzi na skopiowany nowy miesiąc.
Wczytanie i usunięcie
- Wczytaj zastępuje dane robocze wybranym zapisem i przenosi do zakładki wyników.
- Usuń wymaga potwierdzenia i przed usunięciem wykonuje kopię w backups\usuniete-miesiace. Zablokowanego miesiąca nie można usunąć.
- Historia pokazuje maksymalnie 30 zapisów na stronie; kolejne są dostępne przez paginację.
Stała kartoteka salonów i pracowników
Kartoteka jest niezależna od miesięcy. Przechowuje tożsamość, nazwę, przypisanie pracownika do salonu i status aktywności, ale nie przechowuje miesięcznej sprzedaży ani godzin.
- Wyłączony wpis pozostaje w kartotece i można go później ponownie włączyć.
- Wyłączenie salonu powoduje, że jego pracownicy nie są gotowi do wgrania, nawet jeśli sami pozostają włączeni.
- Usuń trwale usuwa wpis z kartoteki po potwierdzeniu, ale nie zmienia danych w już zapisanych miesiącach.
- Przy usuwaniu salonu z przypisanymi osobami program podaje ich liczbę i pyta o decyzję. Po potwierdzeniu pracownicy pozostają w kartotece jako nieprzypisani; nie są kasowani razem z salonem.
- Nieprzypisany pracownik ma status braku aktywnego salonu i nie zostanie wgrany do miesiąca, dopóki kartoteka nie zostanie ponownie zbudowana z poprawnym przypisaniem.
- Zastąp kartotekę listami miesiąca buduje nową kartotekę z aktualnego rozliczenia. Wcześniejsza kartoteka otrzymuje kopię zapasową.
- Wgraj aktywne listy do miesiąca zachowuje wartości pasujących rekordów, dodaje brakujące aktywne pozycje i usuwa z miesiąca wpisy nieaktywne lub nieobecne.
- Po synchronizacji usuwane są oddelegowania odwołujące się do pracownika albo salonu, którego nie ma już w miesiącu.
- Listy kartoteki pokazują po 30 pozycji i mają niezależne wyszukiwarki oraz paginację.
Uwaga: po wgraniu kartoteki miesiąc ma niezapisane zmiany. Sprawdź wyniki i zapisz okres.
Salony: znaczenie wszystkich pól
| Pole | Znaczenie i wpływ na wynik |
|---|---|
| ID salonu | Techniczny identyfikator tworzony automatycznie z nazwy. Nie trzeba go wpisywać. |
| Nazwa salonu | Nazwa widoczna na listach, w wynikach i raportach. |
| Budżet | Plan sprzedaży używany do obliczenia realizacji. Puste lub zerowe pole daje status braku budżetu. |
| Sprzedaż stacjonarna | Podstawowy obrót salonu. Puste pole jest traktowane jako brak danych, a wpisane zero jako świadoma wartość 0. |
| Sprzedaż online | Dodawana do obrotu. Puste pole jest traktowane jak 0. |
| Godziny otwarcia | Domyślna podstawa godzin budżetu, jeżeli nie podano osobnego pola. |
| Podstawa godzin budżetu | Liczba godzin odpowiadająca pełnemu budżetowi. |
| Godziny do budżetu | Jeżeli są podane, budżet jest proporcjonalnie przeliczany do tej liczby godzin. |
| Uwagi | Informacja źródłowa pomocna przy kontroli i wyszukiwaniu; nie zmienia obliczeń. |
Zakładka pokazuje 30 salonów na stronie. Po zapisaniu formularza można użyć Edytuj albo Usuń przy właściwej pozycji.
Pracownicy: znaczenie wszystkich pól
| Pole | Znaczenie i wpływ na premię |
|---|---|
| ID pracownika | Tworzony automatycznie z imienia i nazwiska. Ponowne dodanie tej samej osoby jest blokowane; istniejący rekord należy otworzyć przyciskiem Edytuj. |
| Imię i nazwisko | Nazwa używana w wynikach, imporcie i raportach. |
| Salon | Salon macierzysty, którego realizacja i premia bazowa są używane dla pracownika. |
| Etat | Mnożnik wymiaru etatu, np. 1 albo 0,5. Puste pole jest obliczane jak 1; strzałki zmieniają wartość co 0,1. |
| Godziny przepracowane | Licznik proporcji czasu pracy; strzałki zmieniają wartość o 1 godzinę. |
| Norma godzin | Domyślny mianownik proporcji, używany gdy brak osobnej podstawy godzin premii; krok wynosi 1 godzinę. |
| Podstawa h premii | Mianownik ważniejszy od normy; pozwala zastosować indywidualną podstawę czasu. Krok wynosi 1 godzinę. |
| Premia bazowa | Możliwa do korekty bezpośrednio w tabeli wyników. Nadpisuje kwotę wynikającą z progu salonu tylko dla tej osoby; strzałki zmieniają ją co 100 zł. |
| Całkowita utrata premii | Ustawia premię na 0 niezależnie od realizacji i godzin. |
| Powód utraty / uwagi | Opis widoczny przy statusie i przydatny w raporcie; sama uwaga nie zmienia kwoty. |
Zakładka pokazuje 30 pracowników na stronie. Wyszukiwarka uwzględnia również salon, liczby i notatki.
Oddelegowania: jak przenoszona jest sprzedaż
- Wybierz pracownika, jego salon macierzysty, salon wykonania i kwotę sprzedaży.
- Kwota trafia do kolumny Deleg. + salonu macierzystego.
- Jeżeli w regułach włączono odejmowanie, ta sama kwota trafia do Deleg. - salonu wykonania.
- Kwota 0 oraz oddelegowanie między tym samym salonem są pomijane w obliczeniach.
Oddelegowanie zmienia obrót salonów, ale nie zmienia przypisania pracownika do salonu macierzystego. Po zmianie nazw lub list sprawdź, czy każde oddelegowanie nadal wskazuje istniejące rekordy.
Reguły, progi i ustawienia globalne
- Okres jest opisem danych. Przy zapisie miesiąca program ustawia go zgodnie z kluczem RRRR-MM.
- Domyślne godziny otwarcia są używane, gdy salon nie ma własnej wartości; standardowo jest to 184.
- Odejmuj oddelegowania z salonu wykonania decyduje, czy przeniesiona sprzedaż ma być jednocześnie odjęta w miejscu wykonania.
- Ogranicz proporcję czasu do 100% nie pozwala, aby nadgodziny podwyższyły mnożnik czasu ponad 1.
- Próg składa się z minimalnego procentu realizacji, kwoty premii bazowej i etykiety.
- Jeżeli salon spełnia kilka progów, program wybiera najwyższy spełniony próg.
Przykład: przy progach 100% = 800 zł i 110% = 1000 zł realizacja 108% daje 800 zł, a 112% daje 1000 zł.
Jak program oblicza wynik salonu
Budżet skorygowany = budżet ÷ podstawa godzin budżetu × godziny do budżetu
Jeżeli nie podano godzin do budżetu, używany jest pełny budżet. Podstawą jest pole salonu, następnie godziny otwarcia, a na końcu wartość domyślna z reguł.
Obrót do premii = sprzedaż stacjonarna + online + oddelegowania do salonu − oddelegowania z salonu
Realizacja = obrót do premii ÷ budżet skorygowany
- Realizacja jest porównywana ze wszystkimi progami.
- Brak budżetu albo sprzedaży stacjonarnej blokuje prawidłowe naliczenie pracownikom tego salonu.
- Kwoty pomocnicze są prezentowane z dokładnością do dwóch miejsc po przecinku.
Jak program oblicza premię pracownika
Proporcja czasu = godziny przepracowane ÷ podstawa h premii lub norma godzin
Premia = premia bazowa × etat × proporcja czasu
- Premia bazowa pochodzi z najwyższego progu salonu, chyba że wpisano indywidualną korektę w wynikach.
- Przy włączonym limicie proporcja czasu nie przekracza 1.
- Całkowita utrata premii ma pierwszeństwo przed naliczeniem.
- Brak salonu, wymaganych danych salonu albo godzin i podstawy czasu daje status do uzupełnienia.
- Wynik końcowy jest zaokrąglany do dwóch miejsc po przecinku.
Przykład: 800 zł × etat 0,5 × 72/72 h = 400 zł.
Korekty bezpośrednio w zakładce Wyniki
Wyniki salonów
Można edytować budżet, sprzedaż stacjonarną, sprzedaż online, godziny otwarcia, podstawę godzin budżetu i godziny do budżetu.
Premie pracowników
Można edytować etat, godziny przepracowane, podstawę godzin oraz premię bazową. Przycisk ? albo kliknięcie w nazwisko rozwija ślad naliczenia: kolejne kroki z liczbami (obrót salonu, realizacja, próg, proporcja czasu, wynik).
- Zmień wartość w komórce i opuść pole albo naciśnij Enter.
- Program aktualizuje dane źródłowe i ponownie oblicza powiązane wyniki.
- Sprawdź statusy i łączną kwotę premii.
- Jeżeli zmiana wpłynęła na końcową premię osoby oznaczonej wcześniej jako Gotowe, program automatycznie cofnie jej oznaczenie kopiowania.
- Kliknij żółty przycisk zapisu. Zielone potwierdzenie kończy korektę.
Kopiowanie premii do innego programu
Ta funkcja służy do kontrolowanego, ręcznego przenoszenia końcowych kwot premii do programu kadrowego, płacowego lub innego formularza.
Przed rozpoczęciem: potwierdź właściwy miesiąc na górnym pasku, usuń niezamierzone statusy do uzupełnienia i zapisz sprawdzone wyniki.
Zalecana kolejność pracy
- W tabeli Premie pracowników sprawdź nazwisko, salon, status oraz końcową wartość w kolumnie Premia.
- Wybierz Kopiuj przy właściwej osobie.
- W drugim programie użyj jego funkcji wklejania i sprawdź, czy kwota trafiła do właściwej osoby oraz właściwego miesiąca.
- Po udanym skopiowaniu wiersz zostaje automatycznie oznaczony jako Gotowe i podświetlony na zielono.
- Powtarzaj czynność, aż licznik pokaże oczekiwaną liczbę obsłużonych osób.
- Po zakończeniu ponownie zapisz miesiąc, aby oznaczenia znalazły się w jego historii.
Znaczenie elementów
| Element | Działanie |
|---|---|
| Kopiuj | Umieszcza końcową kwotę premii w schowku i dopiero po powodzeniu zaznacza rekord jako Gotowe. |
| Gotowe | Ręczne oznaczenie kontrolne. Samo zaznaczenie checkboxa nie kopiuje kwoty do schowka. |
| Skopiowano X z Y | Pokazuje postęp dla wszystkich pracowników w aktualnym miesiącu, również przy aktywnej wyszukiwarce. |
| Wyczyść oznaczenia | Usuwa wszystkie oznaczenia Gotowe w bieżącym miesiącu, ale nie zmienia kwot premii. |
Format kopiowanej wartości
- Do schowka trafia wyłącznie kwota, bez nazwiska, nazwy salonu i symbolu waluty.
- Wartość ma polski format z przecinkiem i dwoma miejscami dziesiętnymi, np. 902,17 albo 0,00.
- Ponowne użycie przycisku Kopiuj zastępuje poprzednią zawartość schowka aktualną kwotą.
Zapis i automatyczne cofanie oznaczeń
- Oznaczenia są przechowywane oddzielnie w danych każdego miesiąca. Po ich zmianie górny pasek może pokazać niezapisane zmiany.
- Wersja robocza zabezpiecza postęp po zamknięciu programu, ale końcowe utrwalenie oznaczeń w historii wymaga zapisania miesiąca.
- Jeśli zmiana etatu, godzin, podstawy, premii bazowej, wyniku salonu, progu albo innych danych zmieni końcową kwotę, oznaczenie danej osoby zostaje automatycznie cofnięte.
- Ponowne przeliczenie bez zmiany końcowej kwoty zachowuje oznaczenie.
- Nowy miesiąc rozpoczyna się bez oznaczeń. Wczytanie wcześniejszego miesiąca przywraca jego własny postęp.
Gdy kopiowanie nie działa
- Sprawdź komunikat nad zakładkami. Przy błędzie rekord nie powinien zostać oznaczony jako Gotowe.
- Uaktywnij okno programu, ponownie wybierz Kopiuj i dopiero potem przejdź do drugiego programu.
- Jeśli kwotę przeniesiono inną metodą, można ręcznie zaznaczyć Gotowe.
- Po ręcznym oznaczeniu nadal sprawdź kwotę w drugim programie, ponieważ checkbox nie wykonuje kopiowania.
Statusy pracowników i kolejność kontroli braków
| Status | Znaczenie | Co sprawdzić |
|---|---|---|
| Naliczona | Wszystkie dane są dostępne, a wynik jest większy od 0. | Zweryfikuj kwotę i proporcję czasu. |
| Bez premii | Salon nie osiągnął progu albo obliczona kwota wynosi 0. | Realizację, progi, etat i indywidualną premię bazową. |
| Do uzupełnienia | Brakuje salonu, budżetu, sprzedaży albo danych godzinowych. | Treść w kolumnie Uwagi wskazuje konkretny brak. |
| Utrata premii | Dla osoby zaznaczono całkowitą utratę. | Powód utraty i poprawność zaznaczenia. |
Najpierw usuń wszystkie statusy do uzupełnienia. Dopiero potem oceniaj pozycje bez premii, ponieważ są one prawidłowym wynikiem reguł, a nie błędem danych.
Wyszukiwanie, listy po 30 pozycji i paginacja
- Listy w zakładkach Salony, Pracownicy i Oddelegowania oraz Historia rozliczeń pokazują maksymalnie 30 pozycji na stronie.
- Przy nagłówkach list salonów i pracowników widoczna jest ich łączna liczba; podczas wyszukiwania licznik pokazuje liczbę dopasowań względem całości.
- Powyżej 30 wyników pod listą pojawiają się numery stron, przyciski poprzedniej i następnej strony oraz zakres widocznych pozycji.
- Po rozpoczęciu wyszukiwania lista wraca na pierwszą stronę i paginuje tylko pasujące rekordy.
- Wyszukiwanie nie usuwa ani nie modyfikuje danych. Usunięcie tekstu przywraca pełną listę.
- Kartoteka ma osobną paginację dla salonów i pracowników, również po 30 pozycji.
- Tabele wyników, historia miesięcy, oddelegowania i progi mają własne pola wyszukiwania dostosowane do ich zawartości. Historia rozpoznaje także słowa zablokowany i odblokowany.
- W wynikach pracowników można wyszukać słowo gotowe, skopiowano albo do skopiowania, aby kontrolować postęp.
- Licznik Skopiowano X z Y zawsze obejmuje pełną listę pracowników, a nie tylko wiersze widoczne po wyszukiwaniu.
Import danych: pełna procedura
- Sprawdź górny pasek i upewnij się, że pracujesz na właściwym miesiącu.
- Wybierz plik XLS, XLSX, CSV, TSV lub JSON albo wklej tekst tabelaryczny. Starszy format XLS jest odczytywany lokalnie i nie wymaga zainstalowanego programu Excel.
- Ustaw rodzaj danych. Opcja automatyczna analizuje nagłówki i nazwy arkuszy.
- Wybierz Sprawdź plik. Na tym etapie dane miesiąca nie są zmieniane.
- Przeczytaj liczniki, ostrzeżenia i podgląd. Brak ostrzeżeń nie zwalnia z kontroli kolumn.
- Wybierz sposób zastosowania i zdecyduj, czy listy mają trafić do stałej kartoteki.
- Kliknij Zastosuj import, sprawdź wyniki oraz statusy, a następnie zapisz miesiąc.
Import: uzupełnianie a zastępowanie danych
Uzupełnij i aktualizuj
Program próbuje dopasować salon lub pracownika po ID albo nazwie. Pasujące rekordy są aktualizowane, nowe dodawane, a pozostałe dane miesiąca pozostają.
Zastąp importowane kategorie
Przed importem program opróżnia tylko kategorie obecne w pliku. Import samych pracowników nie usuwa salonów, a import samych salonów nie usuwa pracowników.
- Pełny JSON w trybie zastąpienia może zastąpić całą konfigurację.
- Powtórzone oddelegowania są pomijane, jeśli mają ten sam zestaw kluczowych danych.
- Nierozpoznane przypisania pracowników i oddelegowań są zgłaszane do kontroli.
- Tryb zastąpienia wymaga dodatkowego potwierdzenia.
Import raportów Makalu: kolejność wczytywania plików
Program automatycznie rozpoznaje cztery układy arkuszy używane w rozliczeniu Makalu. Rozpoznawanie opiera się na zawartości arkusza, dlatego nazwa pliku może się zmieniać.
Zalecana kolejność
- Sprawdź na górnym pasku właściwy miesiąc rozliczenia.
- Przy pierwszym uruchomieniu albo po zmianie listy wczytaj plik salony nazwy i ID. Kolumna A staje się oficjalnym ID, a kolumna B nazwą salonu. Program zachowuje istniejące dane i aktualizuje powiązania.
- Wczytaj miesięczny plik z kolumnami OBRÓT RR, Budżet i online. Obrót RR trafia do sprzedaży stacjonarnej, a online pozostaje osobną wartością doliczaną przez program.
- Parser rozpoznaje skróty RAWA M jako Rawa Mazowiecka oraz SKIERNIEW jako Skierniewice, także gdy słownik salonów nie został jeszcze wczytany.
- Wczytaj raport Sprzedaż w dniach po operatorze. Program dopisze rzeczywistych pracowników i utworzy oddelegowania tylko dla sprzedaży wykonanej poza salonem macierzystym.
- Jako ostatni plik danych wczytaj Karta pracy - wszyscy.XLS. Program uzupełni z niego wyłącznie normę i godziny przepracowane.
- Sprawdź ostrzeżenia importu, wyniki salonów, oddelegowania oraz statusy pracowników. Uzupełnij etat, podstawę h premii, premię bazową i ewentualną utratę premii.
- Kliknij Zapisz aktualny miesiąc. Żaden z importów nie zapisuje miesiąca automatycznie.
Czy kolejność ma znaczenie?
Tak, przy tworzeniu miesiąca od początku. Słownik najpierw ustala oficjalne ID salonów, raport miesięczny tworzy ich wyniki, raport operatorów przypisuje osoby do salonów, a karta pracy na końcu uzupełnia godziny. Dzięki temu osoba z karty pracy nie zostanie dopisana bez salonu.
Nie ma znaczenia przy ponownej korekcie tego samego rodzaju danych, jeśli salony i pracownicy są już prawidłowo przypisani. Poprawiony raport miesięczny, operatorów albo kartę pracy można wczytać ponownie; po kontroli trzeba ponownie zapisać miesiąc.
Bezpieczne zastosowanie: wszystkie cztery układy zawsze działają jako „Uzupełnij i aktualizuj”. Nie usuwają pól, których dany raport nie zawiera.
Import Karty pracy: norma i godziny pracowników
- Program bezpośrednio odczytuje starszy plik .XLS z nagłówkiem „EWIDENCJA CZASU PRACY ZA OKRES”. Nie trzeba otwierać ani zapisywać go ponownie w Excelu.
- Każdy blok PRACOWNIK [AKRONIM] jest łączony z osobą po imieniu i nazwisku, niezależnie od ich kolejności.
- W wierszu PODSUMOWANIE pierwsza wartość czasu trafia do pola Norma, a druga do pola Godziny. Zapis, np. 169:00, oznacza 169 godzin.
- Import zmienia wyłącznie pola Norma i Godziny. Zachowuje salon, etat, podstawę h premii, premię bazową, utratę premii i uwagi.
- Istniejący pracownik jest aktualizowany w bieżącym miesiącu. Osoba nieobecna w miesiącu może zostać dodana tylko z aktywnej Kartoteki, z aktywnym salonem istniejącym w tym miesiącu.
- Osoba bez jednoznacznego i bezpiecznego przypisania do salonu jest pomijana. Jej nazwisko pojawi się w podglądzie oraz komunikacie po imporcie.
- Wartość PRACA 00:00 jest świadomie importowana jako 0 godzin i zawsze zgłaszana do kontroli.
- Okres z nagłówka pliku jest porównywany z wczytanym miesiącem. Przy różnicy program pokaże ostrzeżenie i poprosi o potwierdzenie przed zastosowaniem.
- Import Karty pracy nie zmienia stałej Kartoteki, dlatego opcja jej zapisu jest dla tego formatu wyłączona.
- Znany skrót nazwiska „Agnieszka Dąbrowska-Szmigielsk” jest traktowany jako alternatywny zapis „Agnieszka Dąbrowska-Szmigielska”.
Dla dostarczonego pliku kontrolnego: parser rozpoznaje 47 pracowników. Cztery osoby mają PRACA 00:00 i są wyraźnie wskazane w ostrzeżeniu.
Jak raport operatorów tworzy pracowników i oddelegowania
- Kolumna Dokument.Operator identyfikuje pracownika, a kolumna ze strukturą poziomu 2 wskazuje salon wykonania sprzedaży.
- Salon macierzysty jest ustalany z niepustej kolumny salon macierzysty w innym wierszu tej samej osoby. Gdy raport go nie zawiera, program próbuje użyć przypisania z bieżącego miesiąca lub Kartoteki.
- Wiersz, w którym salon wykonania jest taki sam jak macierzysty, nie tworzy oddelegowania. Sprzedaż jest już częścią obrotu salonu z raportu miesięcznego.
- Wiersz z innym salonem wykonania tworzy oddelegowanie. Kwota zwiększa wynik salonu macierzystego i, zgodnie z ustawieniem w Regułach, pomniejsza salon wykonania.
- Nazwy salonów z prefiksem „Salon” są dopasowywane do nazw bez prefiksu. Imię i nazwisko może występować w odwróconej kolejności.
- Skrócona nazwa, np. Lemanek - Modrzejewska, zostanie połączona z pełną nazwą tylko wtedy, gdy pasuje jednoznacznie do jednej osoby. Pełna nazwa z Kartoteki pozostaje bez zmian.
- Pozycje zaczynające się od OPERATOR TESTOWY oraz Kierownik Regionalna są pomijane jako pracownicy. Ich sprzedaż pozostaje w łącznym obrocie dostarczonym w pliku miesięcznym.
Ponowne wczytanie poprawionego raportu usuwa wcześniejsze oddelegowania utworzone przez ten raport i buduje je ponownie. Oddelegowania dopisane ręcznie pozostają bez zmian.
Kontrola i rozwiązywanie problemów z raportami Makalu
| Objaw | Co sprawdzić |
|---|---|
| Salon ma nazwę równą skróconemu ID | Najpierw zastosuj aktualny słownik nazw i ID salonów, a potem ponownie raport miesięczny. |
| Nierozpoznane powiązanie oddelegowania | Sprawdź, czy pracownik i oba salony są aktywne w Kartotece oraz czy salon macierzysty jest przypisany tej osobie. |
| Za dużo lub za mało pracowników | Porównaj licznik podglądu z rzeczywistymi operatorami. Wpisy testowe i regionalne są celowo pomijane. |
| Brak premii po imporcie operatorów | Raport sprzedażowy nie zawiera etatu ani godzin. Uzupełnij pola wskazane statusem „Do uzupełnienia”. |
| Osoba z Karty pracy została pominięta | Dodaj lub aktywuj osobę w Kartotece, przypisz jej aktywny salon, wgraj Kartotekę do miesiąca albo wcześniej zastosuj raport operatorów, a następnie ponów import Karty pracy. |
| Karta pracy pokazuje inny miesiąc | Przerwij import, wczytaj właściwy miesiąc na górnym pasku i ponownie sprawdź plik. Potwierdzenie różnego okresu służy tylko świadomym wyjątkom. |
| Korekta pliku nie zmieniła zapisanego miesiąca | Po ponownym imporcie sprawdź wyniki i kliknij „Zapisz aktualny miesiąc”. Import zmienia najpierw wersję roboczą. |
Dla dostarczonego zestawu kontrolnego: słownik i raport miesięczny zawierają po 23 salony. Raport operatorów zawiera 36 rzeczywistych pracowników i 6 oddelegowań; wpis regionalny jest raportowany jako pominięty. Karta pracy zawiera 47 pracowników, w tym 4 osoby z PRACA 00:00.
Import: zalecane kolumny i format wartości
| Kategoria | Zalecane nagłówki | Minimum praktyczne |
|---|---|---|
| Salony | Salon, Budżet, Sprzedaż stacjonarna, Sprzedaż online, Godziny otwarcia, Podstawa h budżetu, Godziny do budżetu, Uwagi | Nazwa salonu oraz dane potrzebne do wyniku. |
| Pracownicy | Pracownik, Salon, Etat, Godziny przepracowane, Norma godzin, Podstawa h premii, Premia bazowa, Utrata premii, Powód utraty, Uwagi | Imię i nazwisko oraz salon; do naliczenia także godziny i podstawa. |
| Oddelegowania | Pracownik, Salon macierzysty, Salon wykonania, Kwota, Uwagi | Pracownik, oba salony i kwota. |
- ID są opcjonalne; program może utworzyć je z nazw.
- Liczby mogą zawierać przecinek dziesiętny, kropkę, spacje, oznaczenie zł lub PLN.
- Wartości logiczne utraty premii mogą być zapisane m.in. jako Tak, 1, true albo x.
- Nagłówki powinny znajdować się w jednym wierszu nad danymi. Program analizuje pierwsze wiersze każdego arkusza.
Kontrola jakości po imporcie
- Porównaj liczby rozpoznanych salonów, pracowników i oddelegowań z plikiem źródłowym.
- Sprawdź ostrzeżenia o pustych wierszach, brakujących nazwach i nierozpoznanych powiązaniach.
- W zakładkach Salony i Pracownicy wyszukaj kilka charakterystycznych rekordów.
- W wynikach sprawdź skrajne realizacje, duże premie oraz każdy status do uzupełnienia.
- Jeżeli import miał zasilić kartotekę, otwórz Kartotekę i sprawdź status aktywności.
- Zapisz miesiąc dopiero po tej kontroli.
Eksporty XLSX, CSV i JSON
- Excel XLSX zawiera podsumowanie, wyniki oraz dane źródłowe potrzebne do kontroli.
- Pracownicy CSV zapisuje tabelę naliczeń pracowników.
- Salony CSV zapisuje wyniki salonów wraz z korektami budżetu i oddelegowaniami.
- Nazwy CSV zawierają faktycznie wczytany okres, np. Pracownicy-Lipiec-2026.csv.
- Konfiguracja JSON zapisuje pełne dane bieżącego rozliczenia i może służyć do przeniesienia lub kontroli technicznej.
- Oznaczenia Gotowe nie zmieniają kwot ani tabel w XLSX i CSV. Eksport pełnej konfiguracji JSON zachowuje je jako część danych miesiąca.
Przed eksportem: upewnij się, że górny pasek jest zielony i nie ma statusów do uzupełnienia.
Gdzie program przechowuje dane
Wersja portable zapisuje dane obok pliku EXE. Program nie wysyła rozliczeń do GitHuba.
Pytania do Pomocnika wraz z potrzebnymi danymi kadrowymi przetwarza OpenAI (Codex, subskrypcja ChatGPT konta firmowego, poza EOG); przy awaryjnym przełączeniu może je przetwarzać Anthropic.
| Lokalizacja | Zawartość |
|---|---|
| data\rozliczenia-miesieczne | Zapisane miesiące w plikach RRRR-MM.json, łącznie z ich oznaczeniami Gotowe. |
| data\kartoteka.json | Stała kartoteka salonów i pracowników. |
| data\wersja-robocza.json | Automatyczne zabezpieczenie niezapisanych zmian. |
| backups | Kopie nadpisanych, usuniętych i aktualizowanych danych. |
| outputs\aplikacja | Raporty Excel tworzone przez aplikację. |
| updates | Logi aktualizacji i poprzednia wersja plików programu. |
Postęp kopiowania nie ma osobnego pliku. Jest zapisany wewnątrz właściwego miesiąca, dlatego przenosi się razem z jego plikiem JSON i kopiami zapasowymi.
Folder systemowy Windows Pobrane nie jest używany przez aktualizator programu.
Kopie zapasowe i ręczne przywracanie danych
- backups\miesiace\RRRR-MM zawiera wcześniejsze wersje miesiąca wykonane przed nadpisaniem.
- backups\usuniete-miesiace zawiera kopię miesiąca wykonaną przed usunięciem.
- backups\kartoteka zawiera poprzednie wersje kartoteki.
- backups\aktualizacje zawiera kopie związane z aktualizacją programu.
- Zamknij aplikację.
- Skopiuj wybrany plik kopii w bezpieczne miejsce, aby nie pracować na jedynym egzemplarzu.
- Dla miesiąca umieść kopię w data\rozliczenia-miesieczne i nazwij ją RRRR-MM.json.
- Dla kartoteki zastąp data\kartoteka.json wybraną kopią.
- Uruchom program i sprawdź pasek okresu oraz dane przed dalszą edycją.
Bezpieczna aktualizacja programu
- Zapisz aktualny miesiąc i poczekaj na zielone potwierdzenie.
- Otwórz Aktualizacje i wybierz Sprawdź aktualizacje.
- Jeżeli dostępna jest nowsza wersja, wybierz Pobierz i zainstaluj.
- Program pobiera paczkę z publicznego repozytorium wydań, sprawdza sumę kontrolną, wykonuje kopię danych i uruchamia skrypt wymiany plików.
- Aplikacja zamyka się, podmienia kod i uruchamia ponownie. Po starcie sprawdź numer wersji w stopce.
- Katalogi data, backups, outputs i updates są chronione przed podmianą.
- Po udanej aktualizacji techniczny folder updates\downloads jest usuwany.
- Jeżeli aktualizacja nie powiedzie się, sprawdź updates\update-progress.log i updates\update-error.log.
Przeniesienie programu na inny komputer
- Zapisz miesiąc i zamknij program na starym komputerze.
- Skopiuj cały rozpakowany folder aplikacji, łącznie z data, backups i outputs.
- Na nowym komputerze umieść folder w miejscu z prawem zapisu, np. w Dokumentach.
- Uruchom plik EXE z rozpakowanego folderu, nie z wnętrza archiwum ZIP.
- Sprawdź wersję w stopce, wczytany miesiąc, historię oraz kartotekę.
Skopiowanie samego EXE nie przenosi danych. Do pełnej migracji potrzebny jest cały folder programu.
Dane JSON: zastosowanie zaawansowane
Zakładka Dane JSON pokazuje pełną konfigurację aktualnie wczytanego rozliczenia. Zmiana tekstu oznacza zmianę danych roboczych.
- JSON nadaje się do diagnostyki, wykonania ręcznej kopii i pełnego importu konfiguracji.
- Każdy nawias, przecinek i cudzysłów ma znaczenie. Błąd składni blokuje przeliczenie, ale nie usuwa zapisanego miesiąca.
- Po ręcznej zmianie użyj Przelicz, sprawdź komunikaty i wyniki, a następnie zapisz miesiąc.
- Nie zmieniaj ręcznie ID bez jednoczesnej aktualizacji powiązań pracowników i oddelegowań.
- Pole employeeCopyTracking przechowuje oznaczenia Gotowe i zapamiętaną kwotę. Nie edytuj go ręcznie; program sam usuwa oznaczenia niezgodne z aktualnym wynikiem.
Rozwiązywanie najczęstszych problemów
| Objaw | Postępowanie |
|---|---|
| Po uruchomieniu są inne dane | Sprawdź pasek Pracujesz teraz na, następnie wczytaj właściwy miesiąc z historii. |
| Zmiany zniknęły po ponownym wejściu | Sprawdź wersję roboczą i historię. Końcowy zapis wymaga żółtego przycisku lub Zapisz aktualny miesiąc. |
| Pracownik ma status do uzupełnienia | Przeczytaj kolumnę Uwagi; sprawdź salon, budżet, sprzedaż, godziny oraz podstawę godzin. |
| Nie widać rekordu na liście | Wyczyść wyszukiwarkę i sprawdź pozostałe strony paginacji. |
| Import rozpoznał za mało pozycji | Sprawdź nagłówki, arkusze, puste nazwy i ostrzeżenia w podglądzie importu. |
| Aktualizacja została pobrana, ale nie wdrożona | Zamknij pozostałe uruchomione kopie programu i sprawdź logi w folderze updates. |
| Program nie zapisuje plików | Przenieś cały folder do lokalizacji z prawem zapisu i nie uruchamiaj aplikacji z ZIP-a. |
| JSON zgłasza błąd | Przywróć poprawny eksport JSON albo ponownie wczytaj zapisany miesiąc. |
| Przycisk Kopiuj zgłasza błąd | Uaktywnij okno programu i spróbuj ponownie. Rekord oznacz ręcznie dopiero po niezależnym przeniesieniu i sprawdzeniu kwoty. |
| Oznaczenie Gotowe zniknęło | Sprawdź, czy zmieniła się końcowa kwota premii albo czy utworzono nowy miesiąc. W obu przypadkach cofnięcie oznaczenia jest zamierzone. |
| Licznik nie odpowiada widocznym wierszom | Wyczyść wyszukiwarkę. Licznik obejmuje wszystkich pracowników miesiąca, również rekordy chwilowo ukryte filtrem. |
| Grafik ma różnicę względem normy | Sprawdź zmiany wydłużone, maksymalną obsadę, nieobecności i liczbę osób w salonie. Ponownie użyj Ułóż cały kwartał, a pozostawioną różnicę oceń ręcznie. |
| Dzień dostawy ma brak obsady | Sprawdź nieobecności. Gdy dostępna jest tylko jedna osoba, dodaj zastępstwo do obsady salonu albo zaakceptuj organizacyjne odstępstwo po wyjaśnieniu. |
| Święto nie pozwala wpisać zmiany | To zamierzone zabezpieczenie tabeli. Jeżeli praca jest prawnie i organizacyjnie dopuszczalna, wymaga rozszerzenia kalendarza i osobnej weryfikacji, a nie zwykłego wpisu w komórce. |
| Eksport list obecności nie powstał | Uruchom program jako aplikację portable, wybierz salon z obsadą i sprawdź prawa zapisu do folderu outputs/aplikacja. |
Automatyczne wykrywanie i naprawa duplikatów
Program traktuje jako duplikat tę samą ujednoliconą nazwę pracownika w tym samym salonie. Uwzględnia wielkość liter, polskie znaki, myślniki oraz odwróconą kolejność imienia i nazwiska. Salony są porównywane po nazwie bez technicznego ID i opcjonalnego słowa „Salon”.
- Formularz blokuje ponowne dodanie rozpoznanej osoby lub salonu i kieruje do przycisku Edytuj.
- Przy odczycie danych program zachowuje pierwszy stabilny rekord, uzupełnia go polami z kopii i przepisuje oddelegowania, oznaczenia kopiowania oraz wpisy grafiku na właściwe ID.
- Ta sama osoba może nadal pracować w innym salonie przez oddelegowanie. Nie należy tworzyć dla niej drugiego rekordu pracownika.
- Jeżeli dwie różne osoby rzeczywiście mają identyczne imię i nazwisko oraz ten sam salon, wymagają rozróżnienia w nazwie, np. dodatkowym drugim imieniem, przed zapisaniem.
Licencja, prawa autorskie i dane użytkownika
Copyright (C) 2026 Dariusz Trachimowicz.
- Kod programu i dołączona dokumentacja są udostępniane na warunkach GNU General Public License, wersja 3 lub dowolna późniejsza (GPL-3.0-or-later).
- Licencja pozwala używać, kopiować, analizować, modyfikować i rozpowszechniać program zgodnie z jej warunkami. Przy przekazywaniu programu lub jego zmodyfikowanej wersji trzeba zachować wymagane informacje oraz zapewnić odpowiadający kod źródłowy na zasadach GPL.
- Program jest udostępniany bez gwarancji. Przed naliczeniem i wypłatą premii użytkownik powinien sprawdzić dane źródłowe, reguły oraz wyniki.
- Rozliczenia, kartoteki, kopie zapasowe, importy i eksporty utworzone przez użytkownika nie stają się częścią programu i nie są obejmowane jego licencją.
- Biblioteki zewnętrzne zachowują własne licencje. Ich wykaz znajduje się w pliku THIRD_PARTY_NOTICES.md.
Pełny tekst warunków jest dostarczany z każdą paczką programu w pliku LICENSE.
Dobre praktyki przed zamknięciem miesiąca
- Potwierdź właściwy miesiąc na górnym pasku.
- Sprawdź liczbę salonów i pracowników względem źródła.
- Usuń wszystkie niezamierzone statusy do uzupełnienia.
- Skontroluj najwyższe i najniższe realizacje oraz największe premie.
- Sprawdź oddelegowania i indywidualne korekty premii bazowej.
- Zapisz sprawdzone wyniki i poczekaj na zielone potwierdzenie przed rozpoczęciem przenoszenia kwot.
- Skopiuj premie do drugiego programu, sprawdzając nazwisko i kwotę po każdym wklejeniu.
- Sprawdź licznik Skopiowano X z Y i wyjaśnij wszystkie pozostawione pozycje.
- Zapisz miesiąc ponownie, aby utrwalić oznaczenia Gotowe, i poczekaj na zielone potwierdzenie.
- Wykonaj raport XLSX oraz, gdy potrzebujesz pełnej kopii danych wraz z oznaczeniami, eksport JSON.
- Nie usuwaj folderów data ani backups podczas porządkowania programu.
Grafiki kwartalne: utworzenie, edycja i zapis
Przycisk Grafiki otwiera osobny widok kwartalnych planów pracy, niezależny od bieżącego rozliczenia premii. Nie jest w nim wyświetlany główny pasek Pracujesz teraz na, ponieważ miesiąc rozliczenia nie określa kwartału ani miesiąca planu. Jeden grafik obejmuje trzy miesiące, aktywne salony oraz pracowników pobranych z kartoteki w chwili jego utworzenia.
- Najpierw sprawdź w zakładce Kartoteka, czy potrzebne salony i osoby są aktywne, mają właściwe przypisanie do salonu oraz etat.
- Kliknij Grafiki. W osobnym widoku wybierz rok i kwartał, a następnie użyj przycisku Nowy z kartoteki.
- Wybierz miesiąc i salon. Program pokaże wyłącznie obsadę tego salonu, ale nadal kontroluje równoległe wpisy pracownika w pozostałych salonach.
- Pracownika można dodać do obsady wybranego salonu z listy nad tabelą. Przycisk × przy nazwisku usuwa go z obsady i kasuje jego zmiany tylko w tym salonie.
- W komórce dnia wpisz zmianę, np. 10-18. Program zapisze ją w ujednoliconej postaci 10:00-18:00 i obliczy liczbę godzin.
- Po każdej serii zmian kliknij Zapisz grafik. Zielony komunikat potwierdza trwały zapis.
- Przycisk Wróć do rozliczeń premii zamyka widok grafików i przywraca zwykłe zakładki programu.
Gdzie są dane
Grafiki są zapisywane lokalnie w folderze data/grafiki-kwartalne. Przy nadpisaniu poprzednia wersja trafia do backups/grafiki; program zachowuje do 20 kopii dla każdego kwartału. Aktualizacja programu nie usuwa tych danych.
Generator kwartalny i reguły salonu
Generator przygotowuje plan dla jednego salonu. Ułóż ten miesiąc szybko uzupełnia minimalną obsadę bieżącego miesiąca. Ułóż cały kwartał dodatkowo wyrównuje godziny do kwartalnej normy każdego pracownika, wykorzystuje zmiany wydłużone i wykonuje pełną kontrolę trzech miesięcy.
Ustawienia salonu
| Ustawienie | Zastosowanie |
|---|---|
| Norma pełnego etatu / kwartału | Miesięczny i kwartalny cel dla 1,0 etatu. Cele osób niepełnoetatowych są mnożone przez etat, np. 496 h × 0,5 = 248 h. |
| Zmiana pon.-pt., sobotnia i niedzielna | Zmiany podstawowe. Puste pole oznacza dzień nieczynny. Jeżeli zmiana niedzielna jest pusta, niedziela pracująca korzysta ze zmiany sobotniej. |
| Zmiany wydłużone | Generator może wydłużyć wcześniej przydzielony dzień, aby osiągnąć normę bez dodawania kolejnej osoby ponad maksymalną obsadę. |
| Dzień i obsada dostawy | W wybrany dzień tygodnia obowiązuje osobna minimalna obsada, zwykle dwie osoby. |
| Maksymalna obsada | Oddzielne limity dla poniedziałku, soboty oraz dni od wtorku do piątku zapobiegają nadmiernemu zagęszczeniu planu. |
| Tryb poniedziałku / soboty | Rotacyjnie, tylko pełny etat albo tylko niepełny etat. Tryb szczególny ma pierwszeństwo, ale przy braku możliwej obsady generator podejmuje próbę awaryjną i pokaże wynik kontroli. |
| Zmiana niepełnego etatu w dostawę | Pozwala podać krótszą zmianę tylko dla osoby poniżej 1,0 etatu, np. 11:30-17:30. |
Generator najpierw zapewnia wymaganą obsadę, potem uzupełnia niedobory godzin, a na końcu wydłuża wybrane zmiany. Przy wyborze osoby uwzględnia etat, dotychczasowe wykonanie normy, rotację i odpoczynek dobowy. Kontrola końcowa osobno oblicza przeciętny tygodniowy czas pracy w kwartale.
Przeliczenie usuwa wpisy automatyczne oraz automatyczne zmiany z oddelegowań dla wybranego salonu i zakresu, po czym buduje je ponownie. Wpisy ręczne oraz skonfigurowane nieobecności pozostają zachowane.
Po pracującej sobocie generator daje wolny poniedziałek, jeśli jest inny dostępny kandydat; gdy go brak, dopuszcza wyjątek z ostrzeżeniem. Uwzględnia wpisy w innych salonach tego samego kwartału, także gdy poniedziałek ułożono wcześniej.
Oddelegowania grafikowe i uzupełnianie braków obsady
Oddelegowanie grafikowe określa, że pracownik może być zaplanowany w innym salonie w podanym okresie. Jest przechowywane w grafiku kwartalnym i nie jest tym samym co oddelegowanie sprzedażowe używane przy naliczaniu premii.
Jak dodać oddelegowanie
- Otwórz właściwy grafik kwartalny i rozwiń sekcję Oddelegowania grafikowe.
- Wybierz pracownika. Salon macierzysty zostanie pokazany automatycznie na podstawie danych grafiku.
- Wybierz inny salon docelowy oraz zakres dat mieszczący się w kwartale.
- Opcjonalnie wpisz zmianę, np. 09:00-15:00. Puste pole oznacza, że generator użyje zmiany skonfigurowanej w salonie docelowym.
- Dodaj oddelegowanie, ponownie ułóż salon macierzysty i docelowy, sprawdź kontrolę, a następnie zapisz grafik.
Jak działa generator
- najpierw próbuje zapewnić minimalną obsadę pracownikami należącymi do salonu docelowego,
- gdy własna obsada nie wystarcza, korzysta z aktywnych oddelegowań obejmujących dany dzień,
- w okresie aktywnego oddelegowania pracownik jest zarezerwowany dla salonu docelowego i nie jest automatycznie planowany w salonie macierzystym,
- nie przydziela pracownika do obsady, jeżeli ma nieobecność, inną zmianę tego dnia albo nie zachowałby odpoczynku dobowego,
- zmiana utworzona z oddelegowania ma niebieskie pole i oznaczenie OD; przy osobie oddelegowanej wyświetlany jest także identyfikator OD.
Włączanie, wyłączanie i usuwanie
Oddelegowanie można czasowo wyłączyć przełącznikiem na liście albo trwale usunąć po potwierdzeniu. Wyłączenie lub usunięcie kasuje wygenerowane z niego zmiany, ale nie przebudowuje automatycznie pozostałych salonów. Po każdej takiej operacji ponownie uruchom generator dla zainteresowanych salonów.
Dodanie lub ponowne włączenie oddelegowania usuwa automatyczne zmiany tej osoby w jego zakresie. Wpisy ręczne są zachowane; jeżeli ręczna zmiana koliduje z oddelegowaniem, kontrola grafiku pokaże problem.
Kontrole i lista
- jedna osoba nie może mieć dwóch aktywnych oddelegowań obejmujących te same dni,
- nałożenie oddelegowania na nieobecność powoduje ostrzeżenie,
- zmiana oddelegowana bez aktywnej reguły jest zgłaszana jako błąd,
- wyszukiwarka filtruje po pracowniku, salonach, datach i opisie,
- lista pokazuje do 30 pozycji; większy zestaw jest dzielony na strony.
Kalendarz, normy i kontrola czasu pracy
Przy utworzeniu grafiku program automatycznie dodaje święta ustawowe przypadające w kwartale. Dzień świąteczny jest wyszarzony i generator nie planuje w nim pracy. Od 2025 r. obejmuje to również 24 grudnia.
IV kwartał 2026
| Miesiąc | Norma 1,0 etatu | Najważniejsze dni wolne wpływające na plan |
|---|---|---|
| Październik 2026 | 176 h | Brak święta obniżającego normę w dniu od poniedziałku do soboty. |
| Listopad 2026 | 160 h | 1 listopada i 11 listopada. |
| Grudzień 2026 | 160 h | 24, 25 i 26 grudnia. Święto 26 grudnia przypada w sobotę i obniża normę. |
| Razem | 496 h | Podstawa dla celu kwartalnego pełnego etatu. |
Niedziele pracujące
Daty wpisuje się w formacie RRRR-MM-DD, oddzielając je przecinkami. Muszą być niedzielami należącymi do wybranego kwartału. W planie Q4 2026 wskazane są 13 i 20 grudnia; każda działa jak sobota i ma obsadę jednej osoby. Generator rozdziela je rotacyjnie oraz pozostawia tej osobie wolną poprzednią sobotę i następny poniedziałek.
Kontrole wykonywane przez program
- maksymalnie 12 godzin jednej zmiany w równoważnym systemie czasu pracy,
- co najmniej 11 godzin odpoczynku między zmianami,
- co najmniej 35 godzin nieprzerwanego odpoczynku tygodniowego,
- przeciętnie nie więcej niż 48 zaplanowanych godzin pracy tygodniowo w kwartalnym okresie rozliczeniowym,
- nie więcej niż dwie pracujące niedziele grudniowe dla jednej osoby,
- kolizje pracy z nieobecnością, pracę w dniu wolnym, braki i przekroczenie obsady,
- różnicę między sumą planu a kwartalną normą wynikającą z etatu.
Grafik powinien zostać przekazany pracownikom co najmniej tydzień przed rozpoczęciem okresu, którego dotyczy.
Nieobecności, ręczne korekty i ostrzeżenia
Nieobecność dodana w sekcji Nieobecności pracowników obowiązuje w całym podanym zakresie dat. Osoba nie liczy się do obsady, a tabela pokazuje kod zamiast pola zmiany. Dla `U` i `Z` generator zachowuje jako zaliczenie do normy godziny zmiany, którą przydzieliłby tej osobie; `W` i `N` pozostają zerowe.
Dozwolone wpisy w komórkach
| Wpis | Znaczenie | Wpływ na godziny |
|---|---|---|
| 10-18 lub 10:00-18:00 | Zmiana robocza | Program oblicza czas między początkiem i końcem. |
| W | Wolne | 0 godzin; pracownik nie zostanie automatycznie obsadzony tego dnia. |
| U | Urlop | 0 godzin pracy; przy nieobecności z konfiguracji godziny przydzielonej zmiany zaliczają się do normy. |
| Z | Zwolnienie | 0 godzin pracy; przy nieobecności z konfiguracji godziny przydzielonej zmiany zaliczają się do normy. |
| N | Niedostępność | 0 godzin; ograniczenie planistyczne. |
| @Nazwa salonu | Zmiana tej osoby istnieje w innym salonie | Pole jest tylko informacją i blokuje podwójne automatyczne przypisanie. |
Kod wpisany ręcznie w pojedynczej komórce dotyczy wyłącznie tego miejsca. Nieobecność z konfiguracji jest lepsza dla urlopu lub niedostępności obejmującej kilka dni, ponieważ pozostaje regułą także po ponownym wygenerowaniu kwartału.
Znaczenie komunikatów
- Błąd oznacza naruszenie kontrolowanego limitu, pracę w dniu zamkniętym albo konflikt pracy z nieobecnością. Nie zatwierdzaj planu bez wyjaśnienia.
- Ostrzeżenie oznacza brak lub nadmiar obsady albo różnicę względem normy. Może ujawniać potrzebę zastępstwa z innego salonu.
- Bez naruszeń oznacza, że program nie znalazł problemu w obsługiwanym zestawie reguł. Nadal potrzebna jest kontrola osoby odpowiedzialnej.
Jeżeli nieobecność wypada w dniu dostawy, a salon ma tylko dwie osoby, podwójna obsada jest matematycznie niemożliwa bez zastępstwa. Program pozostawia ostrzeżenie zamiast sztucznie planować nieobecnego pracownika.
Wydruki: grafik salonu, kartki pracowników, premie
Każdy wydruk to osobny dokument (tylko on idzie na papier, bez elementów ekranu). W oknie drukowania przeglądarki można wybrać drukarkę albo „Zapisz jako PDF”; orientacja strony ustawia się sama.
- Drukuj grafik (ekran Grafik kwartalny): grafik wybranego salonu na wyświetlany miesiąc, poziomo, jeden salon na stronie: nazwiska, zmiany z liczbą godzin, suma godzin, kolumna na podpis, legenda, miejsce na podpis sporządzającego i zatwierdzającego. Drukuj wszystkie salony pomija salony bez obsady i wpisów.
- Drukuj kartki pracowników: dla każdej osoby z obsady salonu (i oddelegowanych do niego) jedna kartka A4 pionowo: wszystkie dni miesiąca z godzinami pracy, pracą w innym salonie, nieobecnościami i świętami, suma zaplanowanych godzin, norma miesiąca dla etatu i różnica, klauzula „Przyjęłam/przyjąłem do wiadomości grafik czasu pracy na [miesiąc]” oraz miejsce na datę i podpis pracownika i osoby wydającej grafik. Kartki: wszystkie salony drukuje każdą osobę raz, pod salonem macierzystym.
- Nieobecność z kadr (urlop, zwolnienie, niedostępność) ma pierwszeństwo przed zmianą wpisaną w grafiku: na kartce godziny tej zmiany nie liczą się, a uwaga „do poprawy” i oznaczenie „U!” na grafiku salonu pokazują, gdzie poprawić grafik.
- Drukuj premie (ekran Premie): tabela wyników salonów i tabela premii pracowników z wierszami Razem, bez pól edycji; nagłówek podaje miesiąc, etap i czy to wydruk roboczy (miesiąc niezatwierdzony); na końcu miejsce na podpis sporządzającego i zatwierdzającego.
Kartki i grafiki w stanie „szkic” albo „do kontroli” mają dopisek „Wersja robocza, nie do wywieszenia”. Przed rozdaniem kartek zatwierdź grafik.
Eksport kwartalnych list obecności XLSX
Przycisk Eksportuj listy obecności XLSX tworzy skoroszyt dla aktualnie wybranego salonu. Nie trzeba wcześniej zapisywać grafiku, ale eksport korzysta dokładnie z danych widocznych w bieżącym obszarze roboczym.
- każdy miesiąc kwartału ma osobny arkusz nazwany miesiącem i rokiem,
- każdy dzień kalendarzowy zajmuje osobny wiersz, także niedziele i święta,
- dla każdej osoby są kolumny Plan, Godziny oraz puste miejsce na podpis,
- pracownicy oddelegowani do salonu są automatycznie dodawani do eksportu, nawet jeśli nie należą do jego stałej obsady,
- święta i dni nieczynne są cieniowane i opisane,
- ostatni wiersz pokazuje miesięczną sumę godzin pracy oraz godzin `U` i `Z` zaliczonych do normy, a także miejsce na podpis miesięczny,
- arkusze są przygotowane do wydruku poziomego i mają powtarzalny, zamrożony nagłówek.
Plik trafia także do lokalnego folderu outputs/aplikacja. Nazwa zawiera salon, kwartał, rok i znacznik czasu, dlatego kolejny eksport nie nadpisuje poprzedniego.
Synchronizacja grafiku z rozliczeniem miesiąca
Synchronizacja przenosi plan do rozliczenia premii jako osobną informację kontrolną. Pozwala porównać grafik z późniejszą Kartą pracy, ale nie uczestniczy w samym naliczaniu premii. W osobnym widoku grafików jej narzędzia są celowo ukryte w zwijanej sekcji Synchronizacja z rozliczeniem premii.
- Wczytaj właściwy miesiąc rozliczenia i sprawdź widoczne okno Pracujesz teraz na.
- Otwórz Grafiki i wybierz dokładnie ten sam miesiąc planu. Program zatrzyma operację, jeśli miesiące są różne albo rozliczenie jest zablokowane.
- Rozwiń Synchronizację z rozliczeniem premii i sprawdź pokazane tam rozliczenie docelowe.
- Kliknij Przenieś plan do rozliczenia miesiąca i potwierdź operację.
- W tabeli Premie pracowników sprawdź kolumny Plan oraz Różnica. Różnica jest liczona jako godziny faktyczne minus godziny planowane.
- Zapisz miesiąc osobnym przyciskiem. Synchronizacja tworzy zmianę roboczą i celowo nie zapisuje rozliczenia automatycznie.
Co może zostać uzupełnione
- godziny planowane pracownika oraz identyfikator źródłowego grafiku,
- brakujący etat, jeżeli jest dostępny w grafiku,
- brakujący salon macierzysty, jeżeli taki salon istnieje w rozliczeniu,
- brakujący pracownik, ale tylko wtedy, gdy jego salon istnieje już w miesiącu.
Czego synchronizacja nigdy nie nadpisuje
- godzin faktycznie przepracowanych z Karty pracy,
- normy godzin i podstawy godzin premii,
- budżetów, sprzedaży, oddelegowań i ręcznych korekt premii,
- kwoty naliczonej premii.
Ponowienie synchronizacji dla tego samego miesiąca zastępuje wcześniejszy plan z grafiku aktualnym zestawem godzin. Eksport pracowników CSV i raport XLSX zawierają plan oraz różnicę plan/fakt.
Utworzenie nowego miesiąca z aktualnych danych usuwa plan poprzedniego miesiąca. Dla nowego okresu należy wybrać odpowiedni miesiąc grafiku i wykonać synchronizację ponownie.