Skip to content

An Innovative and Smart Employee Attendance Solutionโ€”crafted to eliminate 70% of HR workload, ensuring seamless attendance tracking and automated payroll management with efficiency and precision. ๐Ÿš€

License

Notifications You must be signed in to change notification settings

W3JDev/PUNCH-CLOCK

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

45 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

PUNCHโฐCLOCK โฐ

Enterprise Workforce Orchestration Platform - Full Independence Rebuild
Complete source code control โ€ข Production-ready โ€ข Enterprise-grade security


๐Ÿš€ Enterprise Rebuild Complete

Transform from Base44-dependent to fully independent platform with modern full-stack architecture.

Version Status Independence Stack Multi-Tenant AI Assistant


๐Ÿ—๏ธ Architecture Overview

  • Backend: Node.js + Express + TypeScript + Prisma + PostgreSQL
  • Frontend: Next.js 14 + TypeScript + Tailwind CSS + Shadcn/ui
  • Database: PostgreSQL 15+ with multi-tenant Row-Level Security
  • Cache: Redis for sessions and real-time data
  • AI: OpenAI/Anthropic integration with persistent memory
  • DevOps: Docker + GitHub Actions + Automated CI/CD
  • Security: JWT + Google OAuth + Rate limiting + Audit logs

๐Ÿš€ Quick Start

Prerequisites

  • Node.js 20+
  • Docker & Docker Compose
  • PostgreSQL 15+
  • Redis 7+

Installation

  1. Clone and install

    git clone https://github.com/W3JDev/PUNCH-CLOCK.git
    cd PUNCH-CLOCK
    npm install
  2. Setup environment

    cp .env.example .env
    cp apps/backend/.env.example apps/backend/.env
    # Edit with your configuration
  3. Start with Docker

    npm run docker:dev
  4. Access application

๐Ÿ“Š Project Structure

PUNCH-CLOCK/
โ”œโ”€โ”€ apps/
โ”‚   โ”œโ”€โ”€ backend/           # Node.js + Express API
โ”‚   โ”‚   โ”œโ”€โ”€ src/
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ controllers/
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ middleware/
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ routes/
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ services/
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ utils/
โ”‚   โ”‚   โ”œโ”€โ”€ prisma/schema.prisma
โ”‚   โ”‚   โ””โ”€โ”€ Dockerfile
โ”‚   โ””โ”€โ”€ frontend/          # Next.js 14 App
โ”‚       โ”œโ”€โ”€ src/
โ”‚       โ”‚   โ”œโ”€โ”€ app/
โ”‚       โ”‚   โ”œโ”€โ”€ components/
โ”‚       โ”‚   โ””โ”€โ”€ lib/
โ”‚       โ””โ”€โ”€ Dockerfile
โ”œโ”€โ”€ .github/workflows/     # CI/CD Pipeline
โ”œโ”€โ”€ docker-compose.dev.yml
โ””โ”€โ”€ package.json

โœจ What's New in v2.0

Unleashing game-changing productivity and intelligence:

  • ๐ŸŽฏ Multi-Tenant Architecture: Enterprise-grade isolation and security.
  • ๐Ÿค– AI Assistant with Persistent Memory: Remembers your context and preferences!
  • ๐Ÿ“ฅ Bulk Import/Export: Effortless CSV/Excel batch operations.
  • ๐Ÿ”” Real-Time Notifications: Never miss a beatโ€”alerts for lateness, payroll, and more.
  • ๐Ÿท๏ธ Enhanced Kiosk: Touchless, device-aware, supports FaceID.
  • ๐Ÿ“Š Live Dashboards: 47+ KPIs, anomaly alerts, and predictive insights.
  • ๐Ÿ Performance & Security: Lightning-fast, robust compliance, deep audit trails.

๐Ÿš€ Why PUNCHโฐCLOCK?


AI-Driven HR Automation
Automate attendance, payroll, leave, and analytics.

No Hardware Needed
100% web-based, mobile-first, kiosk-ready.

Enterprise-Grade Security
Google OAuth, SOC2, ISO27001, RLS.

๐ŸŒŸ Standout Features

  • ๐Ÿ’ฌ AI Chat Assistant: Directly add/edit staff, schedule shifts, approve leave, and get instant insights from chat!
  • ๐Ÿ•ต๏ธ Smart Attendance: PIN, QR, FaceID, & location-aware check-ins.
  • ๐Ÿข Multi-Tenant Isolation: True org-level data isolation & row-level security.
  • ๐Ÿ“ฆ Bulk Operations: Import/export staff, shifts, attendance with validation & error reporting.
  • ๐Ÿ”” Automated Notifications: Real-time in-app & email alerts.
  • ๐Ÿง  Persistent AI Memory: Remembers admins, context, & history.
  • ๐ŸŽจ Custom Branding: Org-specific themes, kiosk modes, device management.
  • ๐Ÿ“Š Comprehensive Analytics: 47+ KPIs, live dashboards, anomaly detection.

๐Ÿ“Š Visual Dashboards & Analytics

Live Dashboard

  • โšก Real-time productivity and attendance tracking.
  • ๐Ÿ… Deep-dive KPIs by department, location, and staff.
  • ๐Ÿ”ฎ Predictive trends and anomaly alerts.

๐Ÿค– Advanced AI Assistant

Interact, automate, and analyzeโ€”all in chat.

  • Direct Actions: Add/edit staff, create shifts, approve leave, update settings.
  • Context Awareness: Always up-to-date with org/team/staff data.
  • Smart Suggestions: Recommends actions and flags anomalies before you notice.

๐Ÿ•’ Effortless Shift Scheduling

Visual Shift Scheduler

  • Visual drag-and-drop scheduling
  • Conflict detection & auto-assignment
  • Bulk imports, smart templates

๐Ÿท๏ธ Kiosk: Touchless, Secure, Lightning-Fast

  • PIN, QR, and FaceID check-in/out
  • Device registration & org isolation
  • Auto-detection for check-in/out events

๐Ÿ”” Notifications & Alerts

Notification Center

  • Real-time in-app & email notifications
  • Automated alerts for lateness, approvals, payroll
  • Notification center with priority & expiry

๐Ÿ” Security & Compliance

encryption:
  data_at_rest: AES-256
  data_in_transit: TLS 1.3+
compliance:
  - GDPR
  - CCPA
  - HIPAA Ready
  - SOC2 Type II
authentication:
  - Google OAuth
  - PIN + QR/FaceID
row_level_security: Full multi-tenant isolation
audit_trails: Comprehensive, per-entity

๐Ÿšฆ Status & Roadmap

  • โœ… Multi-tenant architecture, persistent AI memory, advanced notifications, bulk import/export, enhanced kiosk, pro docs
  • ๐Ÿ”ง Next: Face recognition, mobile app, advanced analytics, public API, integrations

๐Ÿ† Competitive Edge

Capability PUNCHโฐCLOCK Others
Set-up Time 18 min 6.8 days
Compliance Regions 142 38
Analytics KPIs 47+ 12
Cost per Employee/hr $0.23 $0.87
Multi-Tenant Isolation Yes Rare
AI Actionable Assistant Yes No

โšก Quick Start

# Live Demo
OPEN https://app--punchclock-f4eabd7d.base44.app/Landing

# Test Credentials (Admin)
EMAIL: admin@w3jdev.demo
PASSWORD: Demo@SecurePunch123

# API Example
curl -X POST https://api.punchclock.w3jdev.com/v1/auth \
  -H "Content-Type: application/json" \
  -d '{"email":"demo@w3jdev.com", "password":"Demo@API123"}'

๐Ÿ—ƒ๏ธ Example Entity Schemas

Click to expand
// Employee
{
  "organization_id": "string",
  "first_name": "string",
  "last_name": "string",
  "position": "string",
  "department": "string",
  "employment_type": "string",
  "profile_photo": "string (URL)"
}
// Attendance
{
  "organization_id": "string",
  "employee_id": "string",
  "check_in_time": "datetime",
  "check_in_method": "string"
}
// Organization
{
  "business_name": "string",
  "org_code": "string",
  "settings": { "branding": { ... }, "kiosk": { ... } }
}

๐Ÿ“œ Changelog

Version Date Highlights
2.0 2025-07-08 Multi-tenancy, AI memory, bulk import, notifications
1.5 2025-04-12 Enhanced analytics, new kiosk UI
1.0 2024-12-01 Initial public release

๐Ÿค Partnership & Support

  • Reseller Program: 25% recurring commissions
  • Support: Priority ticketing, dedicated account management
  • Compliance Docs: SOC2 ยท DPIA ยท Pen Test

๐Ÿ“œ License

W3JDEV ENTERPRISE LICENSE v2.3 ยท License Terms
Patents Pending.


โญ Ready to Transform Your Workforce?
Star this repo, try the live demo, and join the productivity revolution!

ยฉ 2025 W3JDEV Technologies
Redefining Workforce Management Through AI-Powered Precision


About

An Innovative and Smart Employee Attendance Solutionโ€”crafted to eliminate 70% of HR workload, ensuring seamless attendance tracking and automated payroll management with efficiency and precision. ๐Ÿš€

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •