Przejdź do treści
alekajiya
Otwórz menu
Wszystkie projekty

RCP: rejestracja czasu pracy

2 min czytaniaProgramowanie

Importer odbić z czytnika kart RFID i aplikacja do list obecności, wniosków i raportów dla instytucji publicznej. Bez nowego systemu: dane trafiają do intranetu, z którego instytucja już korzysta.

Technologie

  • SvelteKit
  • TypeScript
  • Tailwind v4
  • Flowbite Svelte
  • Directus
  • Python
  • Nodemailer
  • Docker

Instytucja, w której pracuję, od lat ma czytnik kart RFID do rejestracji czasu pracy. Problem polegał na tym, że odbicia lądowały w plikach tekstowych, a kadry składały z nich listy obecności ręcznie.

Zamiast kupować nowy system, dobudowałem do istniejącego czytnika dwie rzeczy: importer, który przenosi odbicia do intranetu, i aplikację, w której kadry, przełożeni i pracownicy widzą obecność w przeglądarce.

Schemat: odbicia z czytnika RCP trafiają przez importer w Pythonie do Directusa intranetu, a stamtąd do aplikacji RCP Dashboard z listami obecności, dziennikiem, wnioskami i raportami(powiększ)
Droga odbicia karty od czytnika do listy obecności

Importer: pliki tekstowe do bazy

Czytnik zapisuje każdy dzień do osobnego pliku. Każda linia ma 24 znaki: datę, godzinę bez sekund, numer karty i rodzaj zdarzenia, czyli wejście, wyjście, wyjście służbowe albo powrót.

Importer w Pythonie co godzinę:

  • sprawdza katalog z nowymi plikami,
  • parsuje linie i pomija te, które już są w bazie, więc ponowne wczytanie pliku niczego nie dubluje,
  • łączy numer karty z pracownikiem w kartotece,
  • zapisuje zdarzenia w Directusie intranetu,
  • przenosi przetworzony plik do archiwum i zapisuje wszystko w logu.

Osobny skrypt przenosi pliki z komputera, do którego podłączony jest czytnik. Nikt nie musi już ich kopiować ręcznie.

Jedno źródło prawdy

Dane trafiają do tego samego Directusa, z którego korzysta intranet. Są tam pracownicy, struktura organizacyjna, stanowiska, karty RFID, słownik nieobecności i typy wniosków. RCP Dashboard nie ma własnej bazy, tylko nadbudowuje interfejs nad tymi danymi.

RCP Dashboard

Aplikacja ma osobne widoki dla różnych ról:

  • obecność dzienna z przełączaniem dni strzałkami,
  • dziennik zdarzeń z ręczną korektą odbić przez kadry,
  • wnioski: urlop, wyjście służbowe i prywatne, nadgodziny, z akceptacją najpierw przełożonego, a potem kierownictwa,
  • listy pracowników z eksportem do CSV,
  • raporty: dzienna lista obecności, podsumowanie miesiąca i karta pracownika,
  • moja obecność, czyli widok dla każdego pracownika z jego własnymi odbiciami.

Uprawnienia wynikają z ról i struktury organizacyjnej. Kadry widzą wszystkich, przełożony swój zespół, a pracownik tylko siebie. Logowanie odbywa się kontem intranetu, a zdarzenia bezpieczeństwa trafiają do osobnego dziennika.

Tryb uproszczony

Wprowadzanie elektronicznej rejestracji czasu pracy w instytucji to także sprawa ludzi, a nie tylko techniki. Administrator może tymczasowo ukryć godziny odbić i oznaczenie spóźnień w widokach aplikacji. Dane w bazie zostają bez zmian, a kadry dalej widzą i poprawiają prawdziwe wartości.

Dlaczego bez zrzutów ekranu

To system z danymi o obecności konkretnych osób, więc zamiast zrzutów pokazuję schemat.

Stack

  • SvelteKit z adapterem Node, TypeScript,
  • Tailwind v4 i Flowbite Svelte (szablon panelu administracyjnego),
  • Directus intranetu przez oficjalne SDK,
  • importer i synchronizacja plików w Pythonie,
  • powiadomienia e-mail przez Nodemailer,
  • Docker.

Nowe teksty na maila

Raz na jakiś czas, gdy pojawi się nowy wpis albo projekt. Bez reklam.

Komentarze

Jeszcze nikt nie skomentował. Możesz być pierwszy.

Kliknij albo przewiń, żeby przybliżyć. Przeciągnij, żeby przesunąć.Stuknij dwa razy albo rozsuń palce, żeby przybliżyć.

Inne projekty

Rejestr prawa lokalnego: pięć tysięcy aktów w jednej wyszukiwarce

Zarządzenia i uchwały były rozrzucone po BIP, paczkach z EZD, dysku sieciowym i archiwum. Zbudowałem rejestr, który łączy te źródła, pokazuje status aktu, podpis elektroniczny i publikację w Dzienniku Urzędowym, a do tego wskazuje luki w numeracji.

Panel SMS: powiadomienia wysyłane z przeglądarki

Nakładka WWW na moją bramkę SMS: wysyłka do numerów, kontaktów i grup, wysyłka zaplanowana, rozmowy, wspólna skrzynka i zapisy na powiadomienia z potwierdzeniem kodem SMS. Jeden kod działa w dwóch instancjach, każda z własną kartą SIM i wyglądem.

Własna bramka SMS: modem GSM, dwie karty i API dla wielu systemów

Moje systemy wysyłają SMS-y o przerwanych transmisjach, awariach tablic i zmianach w kopiach zapasowych. Zamiast płacić za komercyjną bramkę, zbudowałem własną: modem Quectel M95, dwie karty SIM, API w Pythonie, podpisane webhooki, raporty doręczenia i panel z logowaniem dwuetapowym.