feat(gamification): build subscription gamification system with achievements and rewards (#725)

[primexk5]

Summary

This PR builds a comprehensive subscription gamification system for SubTrackr, designed to increase subscriber retention and platform engagement through interactive rewards, milestone achievements, dynamic leaderboards, social sharing, and on-chain Stellar Soroban smart contract tracking.

Closes #725

---

Key Highlights & Features

1. Gamification Models & Types (src/types/gamification.ts)

   • Added RewardDefinition and RewardItem interfaces for discount coupons, loyalty credits, and unlocked badges.
   • Added GamificationConfig, GamificationAnalytics, and multi-category leaderboard type definitions.

2. Frontend Services & State Management (src/services/gamificationService.ts, src/store/gamificationStore.ts)

   • Defined structured reward coupons (e.g., 10% discount codes PRO-10OFF, 500 crypto credits, 1,000 bonus credits, and 20% VIP lifetime discounts VIP-20OFF).
   • Implemented multi-category leaderboards (All Time, Weekly, Streaks) with percentile ranking.
   • Integrated native social sharing helpers (shareAchievement, shareBadge, shareLevel) using React Native Share.
   • Enhanced store actions for reward claiming (claimReward), coupon redemption (redeemReward), configuration updates, and real-time telemetry calculations (getAnalytics()).

3. UI Screens & Components (src/components/gamification/GamificationComponents.tsx, src/screens/GamificationScreen.tsx)

   • Built RewardCard and RewardsList supporting one-tap coupon copying to the device clipboard and redemption tracking.
   • Built GamificationAnalyticsCard showcasing completion rate progress bars, total XP, and longest streak counters.
   • Built GamificationConfigModal allowing users to toggle sound effects, push notifications, leaderboards, and progress resets.
   • Upgraded GamificationScreen.tsx into a tabbed hub (📊 Dashboard, 🎁 Rewards, and 🏆 Leaderboard) with top-level Share and Settings actions.

4. On-Chain Soroban Smart Contract Tracking (contracts/subscription/src/achievements.rs)

   • Developed an on-chain Stellar/Soroban smart contract module for decentralized tracking of unlocked milestone Symbols.
   • Implemented record_achievement, get_earned_achievements, and has_achievement utilizing a self-contained, persistent AchievementKey::UserAchievements storage key.

5. Documentation & Testing (docs/gamification-guide.md)

   • Added a comprehensive developer and system guide detailing architecture, achievement triggers, reward distribution rules, leaderboard math, store configuration, and Rust API code examples.
   • Extended unit test suites in gamificationStore.test.ts and gamificationService.test.ts to verify audit logs, reward item generation, coupon redemptions, configuration suppression, and social sharing.

---

Verification

• Verified only files related to Issue Build subscription gamification system with achievements and rewards #725 were modified without touching unrelated files or components.
• Executed unit tests for store actions, analytics calculations, leaderboard filtering, and social sharing integrations.

[drips-wave]

@primexk5 Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits