Skip to content
alekajiya
Open menu
All projects

RCP: rejestracja czasu pracy

2 min readProgramowanie

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.

Technologies

  • 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(enlarge)
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.

Was this useful?

New posts by e-mail

Every now and then, when a new post or project goes up. No ads.

Got an idea, a question or a comment? Write to me:Enable JavaScript to see the e-mail address

Comments

No comments yet. Be the first.

Click or scroll to zoom in. Drag to move around.Double tap or pinch to zoom in.

More projects

Local law register: five thousand acts in one search engine

Orders and resolutions were scattered across the BIP public information bulletin, signed packages from the document management system, a network drive and a paper archive. I built a register that joins these sources, shows each act's status, electronic signature and Official Journal publication, and points out gaps in the numbering.

SMS panel: notifications sent from the browser

A web front end for my SMS gateway: sending to numbers, contacts and groups, scheduled sending, conversations, a shared inbox and notification sign-ups confirmed with an SMS code. One codebase runs as two instances, each with its own SIM card and look.

My own SMS gateway: a GSM modem, two SIM cards and an API for many systems

My systems send text messages about interrupted streams, failing information boards and changes spotted by backups. Instead of paying for a commercial gateway, I built my own: a Quectel M95 modem, two SIM cards, a Python API, signed webhooks, delivery reports and a panel with two-factor login.