Skip to content
Goat head chess knight pieceA theme-aware monochrome engraving-style illustration of a chess knight piece with a goat head.Sam Ananias Cases
completedSignature System

Biometrics Integrated Timekeeping System (BITS)

A full-stack attendance management platform with biometric device integration, automated shift calculations, and role-based adjustment workflows.

Key decision: Architect containerized Express.js hardware listeners connecting physical biometric hardware to PostgreSQL audit logs via Prisma ORM.
Biometrics Integrated Timekeeping System (BITS)

Project Overview

BITS (Biometrics Integrated Timekeeping System) is a production-grade full-stack attendance management platform designed to automate employee attendance logging, biometric hardware synchronization, shift calculations, and overtime approval workflows.

BITS Dashboard Overview

Built as a multi-container microservice system using Next.js for the frontend dashboard, Express.js for the backend API, PostgreSQL with Prisma ORM for relational data persistence, and Docker for containerization.

Core System Features

  • Biometric Hardware Listener: Listens to raw events from physical biometric check-in devices and synchronizes logs directly to backend database records.
  • Automated Timekeeping Engine: Calculates late arrivals, undertime, overtime, break minutes, and night-shift differentials in real time.
  • Employee Lifecycle Management: Tracks employees across stages (ACTIVE → STAGED → INACTIVE → TERMINATED) with contact info, profile imagery, and badge IDs.
  • Approval Workflows: Employee-submitted overtime requests and attendance adjustments undergo manager review with audit trails.

BITS Biometric Device Management

Tech Stack & Architecture

  • Frontend: Next.js, React, Tailwind CSS, TypeScript
  • Backend API: Node.js, Express.js, Prisma ORM
  • Database: PostgreSQL
  • DevOps: Docker, Docker Compose, .env environment isolation

Key project outcomes

  • Integrated biometric hardware devices for real-time check-in and check-out tracking.
  • Built automated attendance calculation engines for night-shift differentials, undertime, and overtime approvals.
  • Implemented full employee lifecycle management across Active, Staged, Inactive, and Terminated states.
  • Containerized full application stack with Docker Compose for seamless environment portability.