Tapping System - How Tap & Reward Works

What is Tapping?

Tapping is the core mechanic of Kinderon - the moment when a student completes a task and earns XP. Whether using physical NFC coins or web-based tapping, the system validates the action, checks lock status, calculates XP rewards, and updates progress in real-time. It's instant feedback that makes learning and behavior change fun!

🎯 Two Ways to Tap:

✅ NFC Tapping: Tap phone to physical coin - automatic, instant, tactile
✅ Web Tapping: Click/tap coin button in app - flexible, accessible anywhere

Both methods trigger the same reward system!

How a Tap Works (Step-by-Step)

🔄 Complete Tap Flow:

Step 1: Tap Detection

NFC: Phone NFC sensor detects coin → Reads NFC tag URL → Opens Kinderon tap page with serial parameter

Web: User clicks coin button in dashboard → Sends coin ID to API endpoint

Step 2: Coin Lookup

System queries database for coin details:

Coin serial/ID validation
Owner check (family or educational account)
Coin type (chore, homework, reading, etc.)
Rarity level (Common to Legendary)
Lock mode (manual, hourly, daily, weekly, per-student)
Current lock status

Step 3: Student Selection

Family Mode: Shows all kids in family → Parent/kid selects who completed task

Classroom Mode: Shows only students in current class → Teacher/student selects name

Step 4: Lock Validation

System checks if coin is currently locked:

Manual: Locked until parent/teacher manually unlocks
Hourly: Locked for 1 hour since last tap
Daily: Locked until midnight (24 hours)
Weekly: Locked for 7 days
Per-Student: Each student has independent lock timer

If locked: Show error message with unlock time → Tap rejected

If unlocked: Proceed to XP award!

Step 5: XP Calculation

System calculates XP reward based on rarity:

Common (50%):	10 XP
Uncommon (25%):	25 XP
Rare (15%):	50 XP
Epic (8%):	100 XP
Legendary (2%):	250 XP

Step 6: Database Update

System records tap in database:

Insert into taps or student_taps table
Update student's total XP
Check for level up (every 100 XP = 1 level)
Update quest progress if quest active
Check achievement triggers
Set coin lock status per lock mode

Step 7: Celebration!

🎉 Success screen displays:

XP earned (+10 XP, +50 XP, etc.)
Total XP progress
Current level
Progress to next level
Quest progress update (if applicable)
Achievement unlock notification (if triggered)
Confetti animation for big milestones!

Lock Modes Explained

🔒 Why Lock Modes Matter

Lock modes prevent "spam tapping" - when someone taps the same coin repeatedly to farm XP without doing the actual task. Each lock mode serves different use cases:

1️⃣ Manual Lock

How it works: Coin stays locked until parent/teacher manually unlocks it

Best for: One-time rewards, special occasions, controlled rewards

Example: "Outstanding Report Card" coin - parent unlocks only when report card comes home

2️⃣ Hourly Lock

How it works: Locks for 60 minutes after each tap

Best for: Tasks that can be done multiple times per day

Example: "Helped Classmate" - students can earn it several times daily without spam

3️⃣ Daily Lock

How it works: Locks until midnight (resets at 00:00)

Best for: Daily routine tasks, homework, bedtime chores

Example: "Made Bed" coin - can only be tapped once per day

4️⃣ Weekly Lock

How it works: Locks for 7 days after tap

Best for: Weekly tasks, bigger projects, recurring assignments

Example: "Cleaned Entire Room" - weekly deep clean

5️⃣ Per-Student Lock ⭐ (Classroom Mode)

How it works: Each student has independent lock timer - one student tapping doesn't lock it for others!

Best for: Shared classroom coins with multiple students

Example: "Participated in Discussion" coin - All 25 students can tap it within the hour

💡 Pro Tip: ALWAYS use per-student lock for classroom coins! This is the killer feature for teachers.

Tap Validation & Security

🛡️ How Kinderon Prevents Cheating

Lock Mode Enforcement: Server-side validation - can't bypass lock by clearing browser cache
Ownership Verification: Only authorized family members or class students can tap coins
Duplicate Detection: Same student can't tap same coin twice within lock period
Timestamp Validation: All taps timestamped - detects suspicious patterns
Rate Limiting: Max 10 taps per minute per student (prevents bot attacks)
Server-Side XP Calculation: Client can't manipulate XP values

🔒 Parents/Teachers Have Full Control: View tap history, see who tapped when, manually unlock/lock coins, adjust XP values, and even delete fraudulent taps from admin panel.

XP & Level System

📈 How Leveling Works

Every 100 XP = 1 Level. Simple and consistent!

Level	Total XP Required	Example Taps
Level 1	0 - 99 XP	10 common coins
Level 5	400 - 499 XP	50 common coins
Level 10	900 - 999 XP	100 common coins OR 40 uncommon
Level 20	1,900 - 1,999 XP	4 legendary coins
Level 50	4,900 - 4,999 XP	20 legendary coins

Level Up Rewards: Many achievements unlock at specific levels (5, 10, 20, 50, 100)

Frequently Asked Questions

❓ What happens if I tap a locked coin?

You'll see an error message showing when the coin will unlock. Example: "This coin is locked until 3:45 PM (2 hours remaining)". No XP is awarded and the tap is not recorded.

❓ Can parents/teachers manually unlock coins early?

Yes! From the dashboard, click "Manage Coins" → Find the coin → Click "Unlock Now". This overrides any lock mode temporarily. Useful for special circumstances or rewards.

❓ Do NFC taps and web taps count the same?

100% the same! Both trigger identical reward systems, use same lock modes, award same XP, and count toward quests/achievements equally.

❓ What if multiple students tap at the exact same time?

With "per-student" lock mode, this works perfectly! Each student gets their XP and individual lock timer starts. Without per-student mode, the first tap to reach the server wins - the second tap will see "coin locked" error.

❓ Can I see a history of all taps?

Yes! Dashboard → "Tap History" shows all taps with: student name, coin tapped, XP earned, timestamp, and quest progress. Export to CSV for record keeping.

Related Features

🪙 NFC Coins

Physical rewards & digital options

👆 Web Tapping

No NFC required - tap from any device

⚔️ Quest System

Multi-step challenges & rewards

Start Tapping & Earning Today!

Transform tasks into rewards with instant feedback

Get Started - It's FREE →

👆 Tapping System