​

TekTree Gamification System

​

Core Gamification Philosophy

• Immediate feedback (real-time XP, badges)
• Progress visibility (levels, leaderboards)
• Social proof (achievements, followers)
• Intrinsic motivation (mastery, autonomy, purpose)
• Sustainable engagement (daily streaks, quests)

​

XP (Experience Points) System

​

XP Earning Mechanics

​

XP Multipliers (Pro+ Tiers)

• Pro: 1.2x XP on all actions
• Team: 1.5x XP on all actions
• Enterprise: 2.0x XP on all actions

​

Anti-Gaming Mechanisms

1. Daily Caps: Prevent XP farming through spam
2. Quality Signals: Upvotes, accepted answers weight higher
3. Time Delays: Can’t delete and recreate for XP
4. Moderation Penalties: Spam flagged content = XP deduction
5. XP Decay: 5% per month for inactive users (no activity 30+ days)

​

Level System

​

Level Progression Table

​

Leveling Formula

xp_required(level) = 100 * (1.2 ^ (level - 1))

​

Level-Up Experience

1. Real-time animation (WebSocket push)
2. Notification “Congratulations! You’re now a [Title]”
3. Sound effect (optional, user preference)
4. Confetti animation on profile page
5. Feature unlock message if new features available
6. Social share prompt (optional)

​

Achievement System

​

Achievement Categories

​

1. Onboarding Achievements

​

2. Contribution Achievements

​

3. Quality Achievements

​

4. Social Achievements

​

5. Consistency Achievements

​

6. Expertise Achievements

​

7. Special Achievements

​

Achievement Tiers

• Bronze: Common achievements (70% of users)
• Silver: Uncommon achievements (30% of users)
• Gold: Rare achievements (10% of users)
• Legendary: Ultra-rare achievements (<1% of users)

​

Leaderboard System

​

Leaderboard Types

​

1. Global XP Leaderboard

• Scope: All users, all-time XP
• Reset: Never
• Top: 100 users displayed
• Update Frequency: Real-time (throttled to 5s intervals)

​

2. Weekly XP Leaderboard

• Scope: All users, current week (Monday-Sunday)
• Reset: Every Monday 00:00 UTC
• Top: 100 users displayed
• Prizes: Top 10 get special “Weekly Champion” badge

​

3. Monthly XP Leaderboard

• Scope: All users, current month
• Reset: First day of month 00:00 UTC
• Top: 100 users displayed
• Prizes: Top 3 get featured on homepage

​

4. Area-Specific Leaderboards

• Scope: Users active in specific area
• Reset: Weekly
• Top: 50 users per area
• Badge: Area expert badge for top contributor

​

5. Contribution-Specific Leaderboards

• Types:
  • Most questions posted (this week)
  • Most answers submitted (this week)
  • Most insights published (this month)
  • Most helpful (most accepted answers)

​

Leaderboard Privacy

• Profile setting: “Hide from leaderboards”
• Still earn XP and achievements
• Leaderboard position shown as ”-” to user

​

Streak Tracking System

​

Daily Activity Definition

​

Streak Mechanics

• Streak Counter: Displayed on profile and dashboard
• Streak Freeze: Earn 1 freeze per 7-day streak (use to skip 1 day)
• Streak Recovery: 24-hour grace period after day ends
• Streak Notification: Daily reminder at 8 PM local time if no activity

​

Streak Milestones

​

Quest System (Future P2)

​

Quest Types

​

Daily Quests (Reset 00:00 UTC)

• Answer 3 questions → +30 XP
• Post 1 insight → +50 XP
• Give 5 upvotes → +15 XP
• Comment on 3 items → +20 XP

​

Weekly Quests (Reset Monday)

• Publish 2 insights → +150 XP
• Earn 100 XP from content → +100 XP bonus
• Help 10 people (answers) → +200 XP
• Reach top 50 on leaderboard → +300 XP

​

Special Quests (Time-Limited)

• Holiday events
• Platform milestones (e.g., “1M questions posted”)
• Collaborative quests (community goals)

​

Social Proof Mechanics

​

Profile Badges

• Level badge: Current level title
• Achievement badges: Top 5 favorite achievements (user-selected)
• Special badges: Pro/Team/Enterprise tier, Moderator, Early Adopter
• Streak badge: Current streak count (if 7+ days)

​

Content Author Badges

• Level tier: Icon indicating level range (1-5, 6-10, 11-20, 21+)
• Expertise badge: If user is top contributor in this area
• Quality badge: If user has high acceptance rate (50%+)

​

Profile Stats Showcase

• Total XP
• Current level
• Rank on global leaderboard (if top 1000)
• Total contributions (questions, answers, insights)
• Acceptance rate (% of answers accepted)
• Follower count
• Areas of expertise (top 3 by contribution)

​

Gamification Analytics

​

Metrics Tracked

• Daily Active Users (DAU) interacting with gamification features
• Average XP earned per user per day
• Leaderboard view rate
• Achievement unlock rate

• Streak retention (% of users maintaining 7+ day streaks)
• Level progression velocity
• Churn rate by level

• Conversion rate (free → paid) by XP level
• XP multiplier usage (Pro+ tiers)

​

A/B Testing

• XP values (test +10 XP vs +15 XP for insights)
• Achievement thresholds
• Leaderboard formats
• Notification frequency

​

Technical Implementation

​

Data Models

type UserGamificationProfile struct {
    UserID              string     `bson:"user_id"`
    TotalXP             int        `bson:"total_xp"`
    CurrentLevel        int        `bson:"current_level"`
    XPToNextLevel       int        `bson:"xp_to_next_level"`
    DailyXPEarned       int        `bson:"daily_xp_earned"`
    DailyXPResetAt      time.Time  `bson:"daily_xp_reset_at"`
    CurrentStreak       int        `bson:"current_streak"`
    LongestStreak       int        `bson:"longest_streak"`
    StreakFreezes       int        `bson:"streak_freezes"`
    LastActivityAt      time.Time  `bson:"last_activity_at"`
    Achievements        []string   `bson:"achievements"`
    FeaturedAchievements []string  `bson:"featured_achievements"`
    LeaderboardOptOut   bool       `bson:"leaderboard_opt_out"`
}

type Achievement struct {
    ID                string     `bson:"_id"`
    Name              string     `bson:"name"`
    Description       string     `bson:"description"`
    Tier              string     `bson:"tier"` // bronze, silver, gold, legendary
    XPBonus           int        `bson:"xp_bonus"`
    BadgeImageURL     string     `bson:"badge_image_url"`
    UnlockCriteria    string     `bson:"unlock_criteria"` // JSON query
    UnlockedCount     int        `bson:"unlocked_count"`
}

type XPTransaction struct {
    TransactionID     string     `bson:"_id"`
    UserID            string     `bson:"user_id"`
    Amount            int        `bson:"amount"`
    Source            string     `bson:"source"` // question_posted, answer_accepted, etc.
    RelatedEntityID   string     `bson:"related_entity_id"`
    Timestamp         time.Time  `bson:"timestamp"`
    DailyCap          int        `bson:"daily_cap"`
    DailyTotal        int        `bson:"daily_total"`
}

​

Event-Driven XP Calculation

func (s *GamificationService) HandleKnowledgeEvent(event Event) {
    switch event.Type {
    case "knowledge.question.posted":
        s.AwardXP(event.UserID, 5, "question_posted", event.QuestionID)
    case "knowledge.answer.accepted":
        s.AwardXP(event.AnswerAuthor, 50, "answer_accepted", event.AnswerID)
    case "knowledge.insight.published":
        s.AwardXP(event.UserID, 25, "insight_published", event.InsightID)
    }
}

func (s *GamificationService) AwardXP(userID string, amount int, source string, entityID string) {
    // Check daily cap
    dailyTotal := s.GetDailyXPTotal(userID, source)
    cap := s.GetDailyCap(source)
    if dailyTotal >= cap {
        log.Info("Daily XP cap reached", "user_id", userID, "source", source)
        return
    }

    // Apply tier multiplier
    multiplier := s.GetUserTierMultiplier(userID)
    finalAmount := int(float64(amount) * multiplier)

    // Record transaction
    txn := XPTransaction{
        UserID:          userID,
        Amount:          finalAmount,
        Source:          source,
        RelatedEntityID: entityID,
        Timestamp:       time.Now(),
    }
    s.RecordTransaction(txn)

    // Update user profile
    s.UpdateUserXP(userID, finalAmount)

    // Check for level up
    if newLevel := s.CheckLevelUp(userID); newLevel > 0 {
        s.EmitLevelUpEvent(userID, newLevel)
    }

    // Check for achievements
    s.CheckAchievements(userID, source)

    // Emit XP earned event
    s.EmitXPEarnedEvent(userID, finalAmount, source, entityID)
}