🎯 Very Simple Attendance System

📖 About

Very Simple Attendance System is a modern, Docker-based attendance tracking solution that combines security with simplicity. Built for organizations that need reliable attendance tracking with device-specific verification.

Why Choose This System?

• 🔐 Enhanced Security: Unique PTP (Personal Token Pin) system for device verification
• ⚡ Real-time Tracking: Instant clock in/out with live updates
• 🌟 User-Friendly: Clean, intuitive interface for both admins and users
• 🔄 Flexible Management: Comprehensive admin controls for user management
• 📊 Rich Analytics: Detailed attendance reports and statistics
• 🐳 Easy Deployment: Simple Docker-based setup

🚀 Quick Start

One-Click Setup

# Clone the repository
git clone https://github.com/rakshitbharat/very-simple-attendance.git

# Navigate to project directory
cd very-simple-attendance/source

# Launch with Docker
docker-compose up -d

Access your system at http://localhost:3000

Default Admin Credentials:

Email: admin@admin.com
Password: [Contact System Provider]

💫 Features Showcase

🔐 Authentication & Login

👥 User Management

Admin Dashboard Overview

User Management Interface

Administrative Controls:

⏰ Attendance Tracking

User Dashboard

Clock In/Out Interface

🔒 PTP Security System

PTP Information Screen

PTP Verification Process

PTP Reset Function

📱 Interface Tour

Admin Dashboard

• Active users monitoring
• Total check-ins tracking
• Weekly attendance overview
• User management tools
• PTP management system

User Dashboard

• Current work status
• Today's hours tracking
• Weekly summary
• Monthly attendance calendar
• Personal activity log

🛠️ Technical Stack

• Frontend: Next.js 14
• Backend: Next.js API Routes
• Database: MySQL
• Containerization: Docker & Docker Compose
• Authentication: Custom PTP System

🖥️ CLI Operations

Password Management

The system provides command-line tools for user management and password operations:

# Reset user password
npm run reset-password

# This will:
# 1. Show all current users
# 2. Allow you to select a user
# 3. Let you set a new password
# 4. Provide a PTP code for verification

Password Reset via CLI

User Management

# Create new user
npm run reset-password
# Select "Create New User" option
# Follow the prompts to enter email and password

User Creation via CLI

CLI Features:

• 👤 List all current users
• 🔑 Reset user passwords
• ➕ Create new users
• 🔐 Automatic PTP code generation
• 📊 Direct database interaction
• ⚡ Quick administrative actions

Note: CLI operations require direct access to the application server and appropriate permissions.

📋 User Guides

For Administrators

1. User Management

   • Add new users
   • Assign roles
   • Manage PTPs
   • Monitor attendance

2. System Controls

   • Reset user PTPs
   • Manage devices
   • Generate reports
   • Configure settings

For Regular Users

1. First-Time Setup

   • Login with provided credentials
   • Enter PTP code
   • Register device

2. Daily Usage

   • Quick clock in/out
   • View attendance history
   • Check work hours
   • Monitor attendance streak

⚙️ Configuration

Environment Setup

DB_HOST=localhost
DB_PORT=3306
DB_USER=root
DB_PASS=password

Docker Configuration

version: "3.8"
services:
  app:
    build: .
    ports:
      - "3000:3000"

🆘 Troubleshooting

Common solutions for:

• Device verification issues
• PTP reset procedures
• Login problems
• Docker deployment challenges

🤝 Support

Need help? We're here for you:

1. Check the troubleshooting guide
2. Contact system administrator
3. Submit an issue on GitHub
4. Email support team

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

🌟 Secure Attendance Tracking Made Simple 🌟

Built with ❤️ for modern organizations