Skip to content

riyonp23/Tokened

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

67 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Tokened

A gamified student engagement platform that rewards attendance and participation.

Python MongoDB FBLA

πŸ† 1st Place β€” 2023 DLC FBLA Coding & Programming Competition


πŸ“Œ Overview

Tokened addresses a real problem in schools: low student attendance and disengagement at events. The platform tracks student participation and awards digital tokens as rewards, creating a gamification loop that incentivizes consistent attendance.

Teachers manage events and verify attendance through a secure code system. Students accumulate tokens redeemable for rewards, creating measurable engagement improvement over time.


✨ Features

Feature Description
🎟️ Token Rewards Students earn tokens for attending and participating in events
πŸ” Teacher Verification Secure teacher confirmation code system prevents attendance fraud
πŸ“Š Attendance Tracking Persistent MongoDB backend logs all student milestones and check-ins
πŸ† Leaderboard Gamified ranking system to encourage healthy competition
πŸ“§ Email Integration Automated email notifications for account management
πŸ–₯️ Cross-Platform Runs on Windows 10/11, Linux, and macOS

πŸ› οΈ Tech Stack

Technology Purpose
Python 3.10 Core application (~2,000 lines)
MongoDB Scalable attendance & milestone database
JavaScript Frontend UI components
CustomTkinter Desktop GUI framework

Key Engineering: Designed a scalable MongoDB schema to log student attendance and dynamic reward milestones, optimized for 500 concurrent records during peak event check-ins.


πŸš€ Getting Started

Prerequisites

  • Windows 10/11, Linux, or macOS
  • Stable internet connection
  • 25 MB disk space, 2 GB RAM

Installation

# 1. Download and extract the ZIP
# 2. Ensure the assets/ folder is in the same directory as Tokened.exe
# 3. Run the executable
Tokened.exe

Note: For demo purposes, the teacher confirmation code is 0000. Use a non-sensitive password for testing.


πŸ“ Project Structure

Tokened/
β”œβ”€β”€ assets/          # UI assets, icons, fonts
β”œβ”€β”€ sources/         # Python source code (~2,000 lines)
β”œβ”€β”€ Tokened.exe      # Compiled executable
└── Tokened Documentation.pdf  # Full project documentation

πŸ† Competition

Built for the 2023 DLC FBLA Coding & Programming Competition, where it earned 1st Place against competing student development teams. Full project documentation is included in the repo.


πŸ‘€ Author

Riyon Praveen β€” Computer Science Student, University of South Florida

LinkedIn GitHub

About

πŸ† 1st Place 2023 FBLA β€” Gamified student engagement platform built in Python with MongoDB. Tracks event attendance and rewards participation with digital tokens to drive measurable school engagement.

Topics

Resources

Stars

Watchers

Forks

Used by

Contributors

Languages