BIT GROUP C Attendance System

Powered by Alien Technology from Pluto for Ultimate Performance

A secure, modern attendance tracking system built with pure HTML, CSS, and JavaScript for GitHub Pages, backed by Cloudflare Workers with KV storage.

Features

• Lightning-fast attendance marking
• Advanced fraud detection system
• Enhanced device fingerprinting
• Ghana IP address verification
• GPS location verification (Strict Mode)
• PIN-based authentication (Surname or Index)
• Real-time countdown timer
• Auto-refresh system state
• Mobile-responsive design
• CSV/Excel export for admin
• Bulk student upload via CSV/TXT

Technology Stack

Built with:

• Cryptonite - Advanced encryption
• Infinity Stones - Unlimited scalability
• Dragon Balls - Wish-granted features
• Hello World Code - The foundation of all code

System Architecture

• Frontend: Pure HTML, CSS, JavaScript (GitHub Pages)
• Backend: Cloudflare Workers
• Database: Cloudflare KV Storage
• Hosting: GitHub Pages

Deployment

Prerequisites

• Node.js installed
• Git installed
• Cloudflare account with Workers
• GitHub account

Step 1: Clone Repository

git clone https://github.com/CodeLabWithOsman/alienztech.git
cd alienztech

Step 2: Install Dependencies

npm install

Step 3: Deploy Cloudflare Worker

npm run worker:deploy

This deploys the worker to: https://every.pupujiger.workers.dev/

Step 4: Deploy to GitHub Pages

npm run deploy

Your site will be live at: https://CodeLabWithOsman.github.io/alienztech/

System Rules

1. Do not use VPN or proxy services
2. Do not mark attendance for someone else
3. Do not attempt to mark attendance multiple times
4. Enable location services when strict mode is active
5. Must be within GCTU campus during strict mode
6. Only mark attendance when enabled by admin

Admin Features

• Toggle attendance on/off (with 10-minute countdown)
• Toggle strict mode (GPS verification)
• Add/Remove students
• Bulk import via CSV/TXT
• Blacklist management
• Download attendance records (CSV/Excel)
• View fraud attempts
• Clear all attendance

Admin Access

The admin panel is hidden and not accessible via /admin URL. Only those who know the special access path can reach it.

Contact

• Myles - Course Representative - WhatsApp
• Dhonzy - Course Representative - WhatsApp
• Admin - Administrator - WhatsApp

Security Features

• Device fingerprinting
• IP tracking (Ghana only)
• VPN detection and blocking
• Location verification
• Fraud attempt logging
• Blacklist system
• Protected students (cannot be modified)

File Upload Formats

Bulk Student Upload

Supports multiple formats:

• CSV: Name,IndexNumber or IndexNumber,Name
• TXT: Name - IndexNumber or Name IndexNumber
• Tab-separated values
• Pipe-separated values

Example:

Osman Mohammed Abutazure,1686468923
Portia Awusi Atsu,1685397148
Princess Asiedua Annor,1700493421

Local Development

npm start

Visit: http://localhost:8000

License

MIT License - Built with Alien Technology

Violate Any Rule

And you'll see what happens. The system is watching.

---

Built by Alien Technology from Pluto • Powered by Cloudflare Workers