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

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
Benzer ürünler

PHP ve MySQL ile eksiksiz İK sistemi: çalışanlar, devam, izin, bordro ve işe alım. Kolay cPanel kurulumu, premium arayüz.
Yayın: Haziran 2026
Çalışanları, yoklamayı, izinleri, bordroyu ve İK raporlarını duyarlı bir web tabanlı İK yönetim sistemiyle yönetin.
Yayın: Ekim 2026
Proje Yönetimi, Bordro, Devam ve Puantaj Lite ile İK Yönetimi
Yayın: Mayıs 2024
Vardiya kayıtları, yönetici onayları ve yazdırılabilir haftalık raporlarla kendi sunucunuzda barındırılan ekip puantaj sistemi.
Yayın: Kasım 2026
PHP/CodeIgniter İK sistemi: çalışan öz hizmeti, devam takibi, sözleşmeler ve yönetici paneli
Yayın: Ağustos 2026
Eksiksiz bir faturalandırma, gider takibi ve İK yönetim sistemi.
Yayın: Temmuz 2026