feat: achievements models and logic

[coxmars]

📝 Pull Request Overview

• Implements Achievements functionality.
• Closes #29

🔄 Changes Made

• Achievement Model Creation:

  • Added a new Achievement model in achievement.cairo with the following attributes:
  • achievement_id
  • achievement_type
  • rarity
  • name
  • description
  • is_hidden
  • is_unlocked
  • Implemented AchievementProgress struct to represent individual player progress towards achievements.
  • Created AchievementType and AchievementRarity enums to categorize achievements.

• Achievement Management Functions:

  • Implemented initialize_default_achievements() to set up predefined achievements.
  • Created initialize_player_achievement_progress() to initialize a player's achievement progress.
  • Developed update_achievement_progress() to handle progress updates and achievement unlocking.
  • Added get_unlocked_achievements() to retrieve a list of a player's unlocked achievements.

• Comprehensive Tests:

  • Added unit tests for the Achievement system including:
  • Testing initialization of default achievements
  • Verifying player achievement progress initialization
  • Validating achievement progress updates and unlocking mechanism
  • Checking retrieval of unlocked achievements

🔧 Testing

• Implemented and passed unit tests for all new achievement functionalities.
• Ensured proper handling of edge cases, such as updating already unlocked achievements.