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

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

• 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

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

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

   • Frontend: http://localhost:3000
   • Backend API: http://localhost:3001
   • Health Check: http://localhost:3001/health

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

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.

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.

• 💬 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.

• ⚡ Real-time productivity and attendance tracking.
• 🏅 Deep-dive KPIs by department, location, and staff.
• 🔮 Predictive trends and anomaly alerts.

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.

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

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

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

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

• ✅ 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

# 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"}'

// 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": { ... } }
}

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

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