Ana Sayfa / Kod ve Scriptler / TimeKeep - Employee Time Clock PHP

TimeKeep - Employee Time Clock PHP

PIN ile giriş-çıkış, çevrimdışı kuyruk, mesai kuralları, onaylar ve bordro dışa aktarma ile çalışan zamanını takip edin.

  • Yayın tarihi10 Kasım 2026
  • Nerede çalışırPHP 8.2, PHP 8.3, PHP 8.4
  • VeritabanıMySQL 8.0, SQLite 3.x
  • Paket içeriği.php, .css, .json, .svg, .sql, .md, .yml/.yaml, composer.json, Dockerfile, JavaScript .js
  • Son güncelleme10 Kasım 2026
  • Canlı demoVar
TimeKeep - Employee Time Clock PHP

Overview

Kiosk clock-in with PIN, offline queue, overtime rules, timesheet approval and payroll CSV. TimeKeep is a complete, self-hosted employee Time Clock in plain PHP 8.2 — no framework, no Composer runtime dependencies and no build step. Upload the files, run the browser installer, choose SQLite or MySQL, and you are live in minutes.

Clock-in that works offline and on site.

What's inside

  • Offline — Punches are queued in IndexedDB and synced in batches. Duplicates are reconciled by client UUID. Late punches keep the client timestamp, are flagged late_sync, and store the server timestamp separately.
  • Sites — Optional rotating check code (HMAC over a 60-second window, valid for the punch instant so offline sync still verifies) and an optional geofence enforced on the server.
  • Punches — clock_in, clock_out, break_start, break_end; sources kiosk, web, manual; device label and site recorded. Punches are never edited.
  • Timesheets — Weekly grid (employees × days), per-employee detail, derived hours. Overtime after the configured daily and weekly thresholds; public holidays paid at double time and excluded from the weekly threshold.
  • Approval — draft → submitted → approved or submitted → rejected → submitted. Submitting is blocked while a shift is open. Approved weeks are final; corrections stay in the audit trail.
  • Corrections — Close an open shift or add a missed shift. Every adjustment is append-only, with reason, author and the punch it references.
  • Export — Payroll CSV per week: minutes, rates, amounts. Generated by the same calculator the screen uses, so totals match to the minute.
  • Roles — admin (everything, including approval and payroll rules) and manager (kiosk, submit, correct, export — no approval). Employee PINs are separate from console logins.

Why TimeKeep

  • Kiosk mode with PIN + optional geofence/QR check, offline queue in IndexedDB that syncs punches with client timestamps and server validation.
  • Exception handling: missed punch, duplicate punch, manual correction with reason and audit trail.

Built to last

  • No framework and no runtime Composer packages — the ZIP is the whole application.
  • SQLite for a zero-config install and MySQL/MariaDB for production, from one migration pair.
  • 33 automated tests covering the money, state-machine, uniqueness and permission rules.
  • English and Chinese interface, dark mode, WCAG AA focus states, usable down to 360 px.
  • CSRF on every POST, prepared statements only, output escaped at the template.

Requirements

  • PHP 8.2 or newer with PDO (pdo_sqlite or pdo_mysql), mbstring, json, openssl and fileinfo.
  • Apache with mod_rewrite or Nginx; document root pointed at public/.
  • SQLite 3 (bundled with PHP) or MySQL 8 / MariaDB 10.4+.
  • Write access to the application root and storage/.

Quick start: upload the ZIP, point the document root at public/, open /install/ and follow the four steps. Docker users can run docker compose up -d --build instead and open the same installer.

Features

• Offline — Punches are queued in IndexedDB and synced in batches. Duplicates are reconciled by client UUID. Late punches keep the client timestamp, are flagged late_sync, and store the server timestamp separately. • Sites — Optional rotating check code (HMAC over a 60-second window, valid for the punch instant so offline sync still verifies) and an optional geofence enforced on the server. • Punches — clock_in, clock_out, break_start, break_end; sources kiosk, web, manual; device label and site recorded. Punches are never edited. • Timesheets — Weekly grid (employees × days), per-employee detail, derived hours. Overtime after the configured daily and weekly thresholds; public holidays paid at double time and excluded from the weekly threshold. • Approval — draft → submitted → approved or submitted → rejected → submitted. Submitting is blocked while a shift is open. Approved weeks are final; corrections stay in the audit trail. • Corrections — Close an open shift or add a missed shift. Every adjustment is append-only, with reason, author and the punch it references. • Export — Payroll CSV per week: minutes, rates, amounts. Generated by the same calculator the screen uses, so totals match to the minute. • Roles — admin (everything, including approval and payroll rules) and manager (kiosk, submit, correct, export — no approval). Employee PINs are separate from console logins. • i18n — English and Chinese, dark mode, WCAG AA focus rings, keyboard reachable, mobile down to 360 px. • Self-hosted PHP 8.2 application with no framework and no runtime Composer dependencies • SQLite and MySQL/MariaDB support from one migration pair, with a four-step browser installer • 12 database tables, 44 routes and 33 automated tests • English and Chinese interface, dark mode, WCAG AA focus states, mobile down to 360 px • CSRF protection, prepared statements and escaped output throughout

Requirements

• PHP 8.2 or newer (tested on 8.2, 8.3 and 8.4) • PDO with pdo_sqlite or pdo_mysql • mbstring, json, openssl and fileinfo extensions • Apache with mod_rewrite, or Nginx with a front-controller rule • SQLite 3, or MySQL 8.0 / MariaDB 10.4 and newer • Write access to the application root and storage/ directory • A modern browser; no Node.js, Composer or build tools required