● Punjab School Education Department · Government of Pakistan
CoderzHunt Developed by CoderzHunt

AI Smart
Attendance &
Monitoring System

A province-wide biometric platform replacing manual registers with AI facial recognition, geo-fencing, and real-time dashboards across all administrative tiers of Punjab's school system.

Face Recognition + Anti-spoofing
Offline-First Architecture
8 Role Hierarchies
Urdu / RTL Support
21+
REST + WebSocket API Routes
3,234
Attendance Records Seeded (6 months)
5
Docker Compose Services
8
Role-Based Dashboards
★
Super Admin
Teacher
Student
The Challenge

Why Manual Attendance Fails

Punjab's school system serves millions of students. Manual registers cannot scale, verify, or report accurately — creating systemic accountability failures.

📋
01
Proxy Marking & Manipulation
Manual attendance registers allow teachers and staff to mark attendance fraudulently, with no verification mechanism to detect ghost or proxy attendance.
🔭
02
No Real-Time Visibility
Provincial, district, and tehsil authorities have no live view of school-level attendance. Reports arrive days or weeks late — too slow for corrective action.
🏃
03
High Absenteeism in Remote Areas
Teacher absenteeism is critically high in rural and remote schools with no monitoring. Students lose teaching hours with no accountability mechanism.
📍
04
No Geo-Verification
There is no way to verify that staff are physically present within school premises. Attendance can be submitted from anywhere, enabling ghost claims.
⏳
05
Delayed Reporting Weakens Governance
Without real-time dashboards, provincial authorities cannot identify patterns of absenteeism or intervene promptly — accountability is fundamentally broken.
The Solution

AI-Powered Smart Attendance

A province-wide platform that makes attendance tamper-proof, real-time, and verifiable through biometrics, geo-fencing, and hierarchical dashboards.

🤖
AI Biometric Verification
Facial recognition with real-time liveness detection (eye-blink anti-spoofing) + WebAuthn fingerprint enrollment ensures only genuine, present individuals are recorded.
📡
Geo-Fenced Boundaries
GPS validation confirms physical presence within school premises. Attendance recorded outside the defined geo-fence is flagged and rejected automatically.
📶
Offline-First Architecture
Dexie.js-powered IndexedDB queue stores attendance locally during connectivity loss. A WebSocket-based sync engine pushes all queued records the moment connectivity is restored.
📊
Real-Time Dashboards
Province → District → Tehsil → School hierarchy. Every tier sees live attendance rates, absentee heatmaps, biometric distribution charts, and trend sparklines.
🔐
Role-Based Access Control
Eight distinct roles with screen-level permission granularity. JWT access + refresh tokens, account lockout, session management, and forced logout on policy violation.
Role Hierarchy

8 Roles, One Platform

Every administrative level — from provincial authority to student — has a dedicated, permission-scoped dashboard tailored to their responsibilities.

Province-wide
★
Super Admin
Province Level
Full system control
User management
Province-wide reports
Audit logs
District
District Admin
District Level
District oversight
School management
District reports
Tehsil
Tehsil Admin
Tehsil Level
Tehsil monitoring
Teacher oversight
Tehsil reports
School
Principal
School Level
Staff attendance
Device management
School reports
Own Records
Teacher
Own Records
Personal attendance
Leave requests
Own schedule
Data Entry
Data Entry Opr.
Data Entry
Manual entry
Data feeding
Validation
Own Records
Lower Staff
Own Records
Personal attendance
View schedule
Own Records
Student
Own Records
Personal attendance
Academic schedule
Attendance Flow

How Attendance Actually Works

From the moment a teacher arrives at school to the province-wide dashboard update — every step is automated, verified, and audited.

1
🏫
Arrive at School
Staff / student enters geo-fenced premises
2
📷
Kiosk Scan
Fullscreen kiosk activates face recognition camera
3
👁️
Liveness Check
Eye-blink anti-spoofing challenge prevents photo fraud
4
🔐
Identity Verify
Face → Fingerprint → Manual override fallback chain
5
✅
Record Attendance
Timestamped, geo-tagged record written to DB
6
📡
Sync to Server
Real-time push via WebSocket; offline queue for poor connectivity
7
📊
Live Dashboard
All administrative tiers see real-time attendance instantly
AI Fraud Prevention

Zero Tolerance for
Fake & Duplicate Attendance

Every layer of the system is engineered to make fraud impossible — from biometric liveness to server-side duplicate guards and real-time anomaly alerts.

⚠ Common Fraud Threats
🧑‍🤝‍🧑
Proxy Attendance
One person marks attendance on behalf of another who is absent
🖼️
Photo / Video Spoofing
Holding a photo or playing a video in front of the camera to fool face recognition
🔁
Duplicate Marking
Same person attempts to mark attendance multiple times in a single session
📍
Remote / Ghost Marking
Marking attendance from outside school premises without physical presence
👻
Ghost Employees
Non-existent or terminated staff listed as present to claim salaries
✓ AI Protection Layers
👁️
Liveness Detection
Eye-blink challenge confirms a live person is present — defeats all photo & video spoof attacks
🤖
Biometric Identity Lock
Face + fingerprint vector matched against enrolled biometric — proxy is biometrically impossible
🛡️
Server-Side Duplicate Guard
Backend rejects any second attendance record for the same user within the same attendance window
📡
Geo-Fence Enforcement
GPS boundary check rejects all attendance attempts from outside the school premises
📋
Tamper-Proof Audit Log
Every attempt — success or failure — is logged with timestamp, method, and device ID. Nothing is editable.
🧬
Face Vector Match
Deep learning facial embedding compared against enrolled biometric vector — unique per individual
🔑
WebAuthn Fingerprint
Hardware-bound fingerprint via WebAuthn — the private key never leaves the device, impossible to replicate
⏱️
Attendance Windows
Configurable school-specific time windows. Any attempt outside the window is automatically rejected
🚨
Real-Time Anomaly Alerts
Repeated failures, unusual patterns, or off-hours attempts trigger instant alerts to the Principal and Admin
How AI eliminates duplicate & fake attendance
✗ Proxy marking → Biometric block
✗ Photo spoofing → Liveness check
✗ Double marking → Duplicate guard
✗ Remote marking → Geo-fence
✗ Ghost employees → Identity lock
✗ Record tampering → Immutable audit log
~100%
Fraud elimination rate
6
Defence layers active
System Screens

Key Workflows in Action

From login through biometric attendance capture, analytics dashboards, and report exports.

localhost:5173/login
Login · Role-based redirect after authentication · JWT access + refresh tokens
localhost:5173/attendance ⛶ Fullscreen
🏫 Govt. High School Lahore · District Lahore
08:32:15
Mode: FACE SCAN › FINGERPRINT › MANUAL
🙂
● SCANNING… Please look at the camera
👁️ Blink once to continue anti-spoofing check
Recent
Muhammad Ali 08:29:11 ✓ Face
Ayesha Siddiqui 08:27:44 ✓ Finger
Tariq Mehmood 08:25:02 ✓ Face
Attendance Kiosk · Face scan + liveness · Fallback chain · Offline queue indicator
localhost:5173/dashboard — Super Admin
🏫 📊 👥 📋 📅 🖥️ ⚙️
Province Attendance Overview
Mon, 24 Feb 2026 · Punjab
● Live ↓ Export
84.3%
Province Rate
3,412
Active Schools
42,891
Today's Records
127
Alerts
Weekly Attendance Trend (%)
MonTueWedThuFriSatSun
Biometric Methods
Face 60%
Finger 36%
Manual 4%
Super Admin Dashboard · Province-wide KPIs · Weekly trend · Biometric distribution
localhost:5173/reports
📋 Attendance Reports
↓ Export CSV
📅 Feb 1–24, 2026
🗺️ Lahore District
🏫 All School Types
✓ Apply
School District Present% Face Finger
Govt High School Model Town Lahore 91%
 68% 28%
Govt Girls School Gulberg Lahore 88%
 55% 38%
Govt Primary School Johar Town Lahore 74%
 48% 32%
Govt Middle School DHA Ph-5 Lahore 95%
 72% 25%
Govt High School Raiwind Lahore 61%
 40% 22%
Showing 5 of 412 schools · Page 1 of 83
← Prev   1   2   3 …   Next →
Reports Page · Filterable by date, district, school type · CSV export · Paginated
System Architecture

Built for Scale & Reliability

Five containerized Docker services orchestrated with health checks, migration-safe startup, and secure service-to-service authentication.

🖥️
React SPA (Client)
Vite · TypeScript · Tailwind · shadcn/ui · Zustand · Recharts · Dexie.js · WebAuthn
localhost:5173
REST API + WebSocket
⚡
FastAPI Backend
SQLAlchemy · Alembic · JWT Auth · Pydantic · Uvicorn
Auth · Users · Attendance · Leave · Holiday · Devices · Notif. · Reports
localhost:8000
📟
Device Service
ZKTeco Simulator
X-Device-Sync-Key
localhost:8010
PostgreSQL · Persistent Volume
🐘
PostgreSQL 16
Primary Database · Alembic Migrations
3,234+ seeded attendance records · 6-month Punjab dataset
localhost:5432
🔧
pgAdmin 4
DB Administration UI
localhost:5050
Technology Stack

Modern, Production-Grade Tools

Every technology chosen for reliability, developer velocity, and long-term maintainability.

Frontend
⚛️
React 18
UI Framework
🔷
TypeScript 5
Type Safety
⚡
Vite 5
Build Tool
🎨
Tailwind CSS
Styling
🧩
shadcn/ui
Components
🐻
Zustand 4
State Mgmt
📈
Recharts 2
Visualization
💾
Dexie.js 3
Offline Queue
🔑
WebAuthn
Fingerprint
Backend & Infrastructure
🚀
FastAPI
REST + WebSocket
🐍
Python 3.11+
Backend Language
🗄️
SQLAlchemy 2
ORM
🔄
Alembic
Migrations
🐘
PostgreSQL 16
Database
🔐
PyJWT 2
Auth Tokens
✅
Pydantic 2
Validation
🐳
Docker Compose
Orchestration
🖥️
pgAdmin 4
DB Admin
Expected Impact

Transforming Education Accountability

Measurable outcomes for Punjab's school system when biometric attendance replaces manual registers province-wide.

📉
0%
Reduction in teacher absenteeism
⚡
Real-time
Reporting (vs. 2–7 days)
🎯
>0%
Biometric-verified accuracy
🌍
Province
Wide coverage across all Punjab schools
Before: Manual Registers
✗ Proxy attendance undetectable
✗ 2–7 day reporting lag
✗ No geo-verification
✗ Manual data entry errors
✗ No audit trail
After: AI Smart Attendance
✓ Biometric + liveness verification
✓ Real-time province-wide dashboards
✓ GPS geo-fenced boundary check
✓ Offline-first + auto-sync
✓ Full audit log + session tracking
Access Information

Local Test Credentials

Use these credentials to explore each role's dashboard in the local Docker environment. For authorized QA use only.

Role Employee ID Password
Super Admin admin Admin@12345
District Admin DIST-ADMIN-001 Admin@12345
Tehsil Admin TEHSIL-ADMIN-001 Admin@12345
Data Entry Opr. DATA-ENTRY-001 Pass@12345
Principal LHR-SCH-01-001 Pass@12345
Teacher LHR-SCH-01-002 Pass@12345
Lower Staff LHR-SCH-01-004 Pass@12345
Student LHR-SCH-01-005 Pass@12345
Local Services
Frontend (React)
localhost:5173
Backend API
localhost:8000
Swagger UI (API Docs)
localhost:8000/docs
pgAdmin
localhost:5050
Device Service
localhost:8010
Quick Start
# Clone and configure
cp .env.example .env

# Start all services
docker compose up --build

# Seed demo data
docker compose exec server \
python -m seed.seed_pakistan_dataset
About the Development Partner
CoderzHunt

Transforming Ideas into Reality

CoderzHunt is a premier software development company that precisely designs, brilliantly builds, and delivers custom software with an unrelenting commitment to quality — trusted by clients across the globe.

532+
Projects Completed
528+
Happy Clients
98%
On-Time Delivery
8yrs
In Business
Who We Are

CoderzHunt is a No. 1 Software Development Firm that hunts the top developers globally to ensure client success. We precisely design, brilliantly build, and develop custom software with an unrelenting commitment to quality.

From government-scale platforms to enterprise SaaS — we deliver technology that drives measurable outcomes, backed by 24/7 client support and end-to-end project ownership.

✓ Government & enterprise-grade solutions
✓ Full-stack development with modern tech stacks
✓ AI, biometrics & emerging technology specialists
✓ Globally recruited top-tier development talent
🌐 Visit coderzhunt.com
Our Services
🌐
Web Development
React, Next.js, Vue
📱
Mobile Apps
iOS & Android
🤖
AI & ML Solutions
AR, VR, Biometrics
☁️
Cloud Solutions
AWS, Azure, GCP
🛒
E-Commerce
Shopify, WooCommerce
⛓️
Blockchain
Web3, Smart Contracts
📊
Business Intelligence
Dashboards & Analytics
🎨
UI/UX Design
Web & Graphic Design
Have a project in mind?
From government platforms to enterprise software — CoderzHunt builds technology that scales. Let's turn your idea into reality.
🚀  Work With Us