⚡ HelpMan — Gamified AI Placement Preparation Platform

Daily AI-curated coding problems delivered via Telegram. Level up with XP, streaks, and leaderboards.

---

🎯 Overview

HelpMan is an AI-powered placement preparation platform that automatically generates personalized daily coding tasks based on your Codeforces and LeetCode profiles. Tasks are delivered via Telegram and tracked with a gamification system including XP, streaks, ranks, and leaderboards.

The Problem

• Students preparing for placements lack structured daily practice
• Existing platforms don't personalize problem selection to skill level
• No motivation system to maintain consistency during stressful seasons

The Solution

• AI Engine: Groq (GPT OSS 120B) analyzes your ratings, weak topics, and history to generate 3 targeted coding problems and 2 theory reading tasks daily.
• Telegram Delivery: Receive tasks right where you chat using our Telegram Bot
• Gamification: XP with log-capped streak multipliers, rank progression (Bronze → Master), and competitive leaderboards

---

✨ Features

Feature	Description
🤖 AI Task Engine	Groq (Llama 3) generates personalized daily coding and theory tasks
📖 Theory Tasks	Integrates CS Fundamentals and System Design into your daily prep
📱 Telegram Bot	Quick daily delivery of tasks using /daily via Telegram
🔥 Streak System	Log-capped multipliers reward consistency fairly
🏆 Rank Progression	Progress from Bronze → Silver → Gold → Platinum → Master
📊 Dashboard	Premium dark-mode UI with XP progress, stats, and tasks
👥 Leaderboard	Top-3 podium + full ranking table
⚙️ Settings	Profile, linked accounts, and difficulty preferences
🛡️ Admin Panel	System stats, user management, and rank distribution
🔒 Security	JWT auth, webhook signature verification, and rate limiting
🗃️ Audit Trail	Every XP transaction is logged securely

---

🏗 Architecture & Deployment Scenario

HelpMan is built on a modern, decoupled architecture designed for scale and responsiveness, and is currently fully deployed in a production-ready environment.

• Frontend (Vercel): A dynamic Next.js application that handles user authentication, the interactive dashboard, and administrative panels. It is deployed globally via Vercel's Edge Network for instant load times.
• Backend (Render): An Express.js REST API acting as the central nervous system. It continuously listens for Telegram Webhooks, interfaces with the Gemini AI API, and calculates Gamification logic (XP/Streaks).
• Database (Neon): A serverless PostgreSQL database managed via Prisma ORM, providing a persistent source of truth for user data and tasks.

System Flow

graph TD
    %% Clients
    User((Telegram User))
    Web((Web Dashboard User))
    
    %% Frontend
    subgraph Frontend [Vercel Deployment]
        Dashboard[Next.js Dashboard]
        AdminPanel[Admin Panel]
    end
    
    %% Backend
    subgraph Backend [Render Web Service]
        Webhook[Telegram Webhook]
        Tasks[Task Management]
        XP[XP & Gamification Engine]
    end
    
    %% External APIs
    subgraph External [External Services]
        Groq["Groq AI (Llama 3)"]
        TelegramAPI[Telegram API]
        CF_LC[Codeforces & LeetCode]
    end
    
    %% Database
    DB[(Neon PostgreSQL Serverless)]
    
    %% Connections
    User <-->|/daily, /status| TelegramAPI
    TelegramAPI <-->|Webhook POST| Webhook
    Web <-->|REST API| Backend
    
    Webhook --> Tasks
    Tasks --> Groq
    Tasks --> CF_LC
    Tasks --> XP
    
    Backend <-->|Prisma ORM| DB

Loading

How the Magic Works (The /daily Command)

1. Trigger: You send /daily to the Telegram Bot.
2. Data Gathering: The Express backend instantly fetches your live Codeforces and LeetCode ratings.
3. AI Generation: A structured prompt containing your ratings and weak topics is sent to the incredibly fast Groq API (running GPT OSS 120B).
4. Processing: Groq returns 3 perfectly tailored coding problems and 2 CS theory reading tasks. The backend validates this and securely stores it in PostgreSQL.
5. Delivery: The server formats the tasks into a rich message and delivers it back to you on Telegram.

---

Built with ❤️ by Divyanshu

⚡ Start your placement prep journey today! ⚡