Přejít na obsah
Všechny projekty
V provozuDocházka a správa zaměstnanců · 2025–2026

Docházka SaaS

Docházka, směny a správa zaměstnanců s QR terminálem; z interního systému jednoho klienta vyrostl multi-tenant SaaS.

🔒 Soukromý repozitářnasmene.cz ↗

01 Problém

Sezónní turistický provoz s mnoha brigádníky evidoval docházku na papíře a v chatu. Mzdy, zálohy a checklisty směn znamenaly každý měsíc ruční práci a nikdo neměl spolehlivou auditní stopu.

02 Co aplikace dělá

  • Příchody a odchody přes QR kód; na místě je ESP32 zařízení zobrazující rotující QR kód.
  • Checklisty směn, ruční opravy s auditním logem, oznámení a zálohy na mzdu.
  • Měsíční exporty pro mzdy; instalovatelné jako PWA na telefonech zaměstnanců.
  • SaaS větev: izolace tenantů přes row-level security v Postgresu, onboarding, zálohování a obnova pro každého tenanta.

03 Architektura

  1. 01 DeviceESP32 firmware zobrazující QR kód pro příchod
  2. 02 WebNext.js 16 + React 19, PWA
  3. 03 BackendSupabase: Postgres, autentizace, RLS politiky podle tenant_id v JWT
  4. 04 Data90+ SQL migrací, tabulky auditního logu
  5. 05 OpsDocker, Caddy pro každého tenanta, skriptovaný onboarding a obnova

04 Technologie

Next.jsReactTypeScriptSupabasePostgreSQL RLSPWAESP32 / ArduinoDockerCaddy

05 Jak jsem pracoval s AI

Verze pro jednoho klienta rostla s agenty funkci po funkci podle skutečné zpětné vazby od zaměstnanců. Přechod na multi-tenant jsem naplánoval předem: sepsal jsem model tenantů a pravidla RLS, agenti pak po dávkách převáděli dotazy a CI s testy hlídaly, že žádný dotaz nepřekročí hranici tenanta.

06 Co je ověřené

  • Verze pro jednoho klienta běží v produkci u klienta (ověřeno z kopie produkčního nasazení).
  • SaaS větev: GitHub Actions CI, 12 testovacích souborů, 94 migrací.
  • Firmware ESP32 pro QR displej je součástí repozitáře.

07 Upřímné poznámky

  • SaaS varianta zatím neobsluhuje původního klienta; jde o paralelní větev v aktivním vývoji.

08 Screenshoty

Přehled: kdo je právě v práci, živá docházka, schvalování a obsazenost příštího týdne
Týdenní plánování směn podle pozic se žádostmi o zrušení směny
Denní kontroly: příchody, odchody a checklisty směn
Výplaty: hodiny, sazby, zálohy a částky k výplatě
Pohled zaměstnance na telefonu: aktuální směna, checklist, žádost o zálohu
Další projektNightshift