Rejestrator Godzin Pracy na ESP32

[Egzekutor27]

Hejka Wszystkim.

Pochwalę się ukończonym już projektem, nad którym pracowałem 3 tygodnie ( praca i inne obowiązki, ograniczały czas ). W dziale Projekty - DIY w budowie (worklogi), można poczytać krótko co i jak na temat projektu, ale  po krótce opisze co i jak:

Cel systemu:

Zarejestrowanie wejścia i wyjścia każdego pracownika przy pomocy karty RFID (NFC), zapisanie danych na karcie SD, a następnie prezentacja dziennych i miesięcznych raportów czasu pracy w postaci czytelnej strony WWW chronionej PIN-em.

Komponenty systemu:

• ESP32 Sercem systemu, obsługuje logikę, WiFi, webserwer, SD, NFC, LCD
• PN532 (NFC) Czytnik kart – odczytuje UID karty pracownika
• Karta SD Przechowuje pliki: pracownicy.txt + dzienniki czasu pracy (np. JAN_M.txt)
• LCD 20x4 (I2C) Wyświetla aktualne komunikaty dla użytkownika
• WiFi + WebServer Tworzy dostęp przez przeglądarkę do raportów
• Strona WWW Zawiera raporty dzienne, miesięczne, selektor użytkowników, PIN, logo, zegar.

Ekran LCD – co pokazuje:

1. Ekran startowy (inicjalizacja):

LOADING SYSTEM
TWOJE IP:
192.168.x.x     ← Adres sieci
Odczyt Karty SD
Karta SD gotowa!
SYSTEM GOTOWY
(nazwa restauracji) WITA
WCZYTAJ KARTE...

2. Przyłożenie karty:

Jeśli karta to ADMIN:

UZYSKANO DOSTEP
JAKO ADMINISTRATOR
 

Jeśli karta to VIP:

UZYSKANO DOSTEP
DO RAPORTOW
 

Jeśli karta to pracownik:

Przy wejściu:

ZALOGOWANO
HH:MM
DD.MM.YYYY
IMIE_NAZWISKO
 

Przy wyjściu: ( identycznie tylko WYLOGOWANO )

Jeśli karta jest nieznana:

NIEZNANA KARTA!
Serial Monitor – co wyświetla:

1. Start systemu:

[SYSTEM] Start ESP32...
[WIFI] Łączenie z siecią WiFi...
[WIFI] Połączono z siecią!
[IP] Twoje IP: 192.168.x.x
[OK] Wczytano pracowników z SD!
[KOMENDY] Dostępne komendy:
  ➤ POMOC – pokaż dostępne komendy
  ➤ DODAJ <UID> <IMIE_NAZWISKO>
  ➤ USUN <UID>
  ➤ LISTA – lista pracowników
  ➤ RESTART – restart ESP32

2. Zdarzenia użytkownika:

[ADMINISTRATOR] Dostęp OK
[VIP] Dostęp OK
[PRACOWNIK] JAN_M - WEJŚCIE o 07:12
[PRACOWNIK] JAN_M - WYJŚCIE o 15:02
[ERROR] Nieznana karta: ABC12345
 

Strona WWW (dostępna pod IP ESP32)

Dostęp:

• Dostęp tylko po przyłożeniu karty ADMIN lub VIP
• Wyświetlane okno logowania PIN (tylko raz na sesję):
• PIN ADMIN: xxxxxx
• PIN VIP: xxxxxx

Funkcje:

• Wybór daty (dla raportu dziennego)
• Lista użytkowników (oprócz VIP/ADMIN)
• Tryb raportu:
• „Raport dzienny”
• „Raport miesięczny”
• Drukuj
• Wyloguj (czyści PIN z localStorage)

Raport dzienny:

Tabela:

• Użytkownik
• Data
• Wejścia, Wyjścia, Suma czasu, Ilość wejść
• Raport miesięczny:
• Tabela:
• Użytkownik
• Dzień
• Suma czasu pracy
• Na dole: suma miesięczna (np. 149h 52m)

Bezpieczeństwo i PIN:

• PIN jest wymagany tylko przy pierwszym wejściu na stronę w danej sesji (localStorage)
• Po kliknięciu „Wyloguj” – PIN jest usuwany, i użytkownik musi wpisać go ponownie

Pliki na karcie SD:

/pracownicy.txt
Zawiera mapowanie UID -> nazwa -> kolor
Format:

1AE8B660;JAN_M;#33FF57
DC45B402;ADMINISTRATOR;#7D33FF
DD29CC01;V.I.P.;#3357FF

/JAN_M.txt, /NATALIA_P.txt, ...
Dzienniki obecności. Przykład:

01.05.2025 07:12 WEJSCIE
01.05.2025 15:02 WYJSCIE
Suma: 7h 50m

Możliwości rozbudowy (opcjonalne na przyszłość):

• Eksport do CSV
• Wysyłka e-mail raportów
• Interfejs administracyjny (dodawanie pracowników online)
• Zerowanie plików po roku (archiwizacja)
• Oczywiście również jest Zabezpieczenie tzw. "stan awaryjny" w razie braku zasilania

Jak działa tryb awaryjny:

1. Co się dzieje po restarcie:

• Po ponownym uruchomieniu ESP32, system:
• wczytuje pracowników z pliku pracownicy.txt
• przegląda wszystkie pliki .txt pracowników
• sprawdza ostatnią linię w każdym z tych plików

2. Jeśli ostatnia linia zawiera "WEJŚCIE":

• System zakłada, że pracownik był zalogowany, ale nie zdążył się wylogować
• Dodaje WYJŚCIE z aktualną datą i godziną
• Oblicza czas pracy między "WEJŚCIE" a tym automatycznym "WYJŚCIE"
• Dodaje linię "Suma: Xh Ym"
• Wyświetla komunikat na LCD i w Serial Monitorze:
• [AWARIA] Automatyczne WYJŚCIE dla: JAN_M

Mam nadzieję, że Komuś się spodoba projekt. Przepraszam, za taka ilość rozpiski ale...

Dziękuję koledze @Wiktor2019 za wydruk i piękne dopasowanie obudowy pod projekt.

A Wam za... 

[ethanak]

Ja tak z ciekawości - masz jakieś zabezpieczenie przed sytuacją, że zasilanie padnie w czasie zapisu na kartę?

[_LM_]

Możesz podlinkować do workloga? Jak ustawiany lub synchronizowany jest aktualny czas? No, takie oprawienie LCD to mi się podoba  bardzo fajne @Wiktor2019

Edytowano Maj 2, 2025 przez _LM_

[Egzekutor27]

34 minuty temu, ethanak napisał:

Ja tak z ciekawości - masz jakieś zabezpieczenie przed sytuacją, że zasilanie padnie w czasie zapisu na kartę?

Zapis na kartę jest tylko w trakcie Logowanie/Wylogowanie. Więc... że akurat nastąpi brak zasilania jest bardzo mało prawdopodobne. Jest natomiast usługa Awaryjna. (opisana powyżej).

[Egzekutor27]

13 minut temu, _LM_ napisał:

Możesz podlinkować do workloga? Jak ustawiany lub synchronizowany jest aktualny czas? No, takie oprawienie LCD to mi się podoba  bardzo fajne @Wiktor2019

#include <WiFi.h>
#include <WebServer.h>
#include <LiquidCrystal_I2C.h>
#include <SD.h>
#include <SPI.h>
#include <Wire.h>
#include <Adafruit_PN532.h>
#include <TimeLib.h>
#include <NTPClient.h>
#include <WiFiUdp.h>
#include <map>
#include <vector>
 

NTPClient timeClient(ntpUDP, "pool.ntp.org", 7200, 60000);

 

[_LM_]

Dodałbym RTC zewnętrzny dla świętego spokoju, aha i chyba dodałbym przycisk gdzie niewol... ekhm, pracownik może kliknąć wejście/wyjście bo co jeśli komuś odbije się dwa razy przy logowaniu? 

Edytowano Maj 2, 2025 przez _LM_

[Egzekutor27]

11 minut temu, _LM_ napisał:

Dodałbym RTC zewnętrzny dla świętego spokoju, aha i chyba dodałbym przycisk gdzie niewol... ekhm, pracownik może kliknąć wejście/wyjście bo co jeśli komuś odbije się dwa razy przy logowaniu? 

Nie ma możliwości aby się zalogowało 2x za jednym przyłożeniem karty. Przykładasz karte, następuje logowanie, czas ( chyba 1,5 sekundy ) zanim ekran sie odświeży. więc nie ma takiej możliwości  Wiadomo, nie trzymasz tej karty przyłożonej wiecznie, przykładasz i odkładasz a w tym czasie nastepuje Logowanie lub Wylogowanie, zależne czy przyszedłes do pracy czy kończysz :)Co do RTC myślałem ale te zmiany czasu Wiosna/Jesień. Więc zostało przy czasie internetowym

[_LM_]

Chodziło mi o to że czasem te czytniki potrafią dwa razy za jednym podejściem, no chyba że u ciebie ten efekt nie występuje. 

[Egzekutor27]

Nie ma tej opcji, w ciągu tych trzech tygodni dziesiątki razy były testy

[bjrk]

Swego czasu pisałem program do rejestracji czasu pracy. Tam były potrzebne cztery przypadki: Wejście / Wyjście  - Służbowe / Prywatne.

Na przykład, jeśli pracownik przed przyjściem do zakładu miał coś załatwić na mieście, to rejestrował "przyjście służbowe" a system naliczał mu obecność od standardowej godziny rozpoczęcia pracy. (Analogicznie wyjście) Wprowadzanie automatycznej rejestracji pozwoliło wtedy na wprowadzenie częściowego ruchomego czasu pracy. Przyjście pomiędzy 7 a 9 oraz wyjście pomiędzy 15 a 17. Rozliczenie było miesięczne, z dopuszczalną odchyłką 4 godziny (chyba?).

Najzabawniejsze były panie z kadr, które ciągle "sprawdzały" program na kalkulatorze i liczyły minuty jako setne części godziny.

[Egzekutor27]

2 minuty temu, bjrk napisał:

Swego czasu pisałem program do rejestracji czasu pracy. Tam były potrzebne cztery przypadki: Wejście / Wyjście  - Służbowe / Prywatne.

Na przykład, jeśli pracownik przed przyjściem do zakładu miał coś załatwić na mieście, to rejestrował "przyjście służbowe" a system naliczał mu obecność od standardowej godziny rozpoczęcia pracy. (Analogicznie wyjście) Wprowadzanie automatycznej rejestracji pozwoliło wtedy na wprowadzenie częściowego ruchomego czasu pracy. Przyjście pomiędzy 7 a 9 oraz wyjście pomiędzy 15 a 17. Rozliczenie było miesięczne, z dopuszczalną odchyłką 4 godziny (chyba?).

Najzabawniejsze były panie z kadr, które ciągle "sprawdzały" program na kalkulatorze i liczyły minuty jako setne części godziny.

Ciekawy projekt.  A kadrowe to pewnie miałeś ubaw po pachy

[ethanak]

@Egzekutor27 znając prawa Murphy'ego jedyne padnięcie zasilania będzie akurat w trakcie zapisu. Poleganie na tym że "to się praktycznie nie zdarzy" to podstawowy błąd.

[_LM_]

2 minuty temu, ethanak napisał:

Poleganie na tym że "to się praktycznie nie zdarzy" to podstawowy błąd.

tak samo z RTC, skąd pewność że układ zawsze zdoła się połączyć z serwerem? 

[Egzekutor27]

4 minuty temu, ethanak napisał:

@Egzekutor27 znając prawa Murphy'ego jedyne padnięcie zasilania będzie akurat w trakcie zapisu. Poleganie na tym że "to się praktycznie nie zdarzy" to podstawowy błąd.

biorę to pod uwagę

[Egzekutor27]

1 minutę temu, _LM_ napisał:

tak samo z RTC, skąd pewność że układ zawsze zdoła się połączyć z serwerem? 

Nigdy nie ma pewności. Elektronika bywa nie przewidywalna  Owszem można było dodac zasilanie awaryjne typu akumulatorek ale w tej obudowie chciałem zostawić tak jak jest