Achievements

// From achievement_provider.dart:25
Future<void> fetchAchievements(BuildContext context) async {
  _isLoading = true;
  notifyListeners();
  
  try {
    // Get user progress from server
    final List<Map<String, dynamic>> serverData = 
        await _service.getAchievements();
    
    // Merge with static definitions (icons, text)
    final staticDefs = AppAchievements.getDefinitions(context);
    
    _achievements = staticDefs.map((staticDef) {
      final serverMatch = serverData.firstWhere(
        (s) => s['id'].toString() == staticDef.id,
        orElse: () => {},
      );
      
      return AchievementDefinition(
        id: staticDef.id,
        title: staticDef.title,
        desc: staticDef.desc,
        icon: staticDef.icon,
        category: staticDef.category,
        isLegendary: staticDef.isLegendary,
        unlocked: serverMatch['unlocked'] ?? false,
        unlockedAt: serverMatch['unlockedAt'] != null 
            ? DateTime.parse(serverMatch['unlockedAt']) 
            : null,
      );
    }).toList();
  } finally {
    _isLoading = false;
    notifyListeners();
  }
}

// From achievements_service.dart:22
Future<void> triggerAction(String actionType, dynamic value) async {
  try {
    await _dio.post('/achievements/check', data: {
      'action': actionType,
      'value': value,
    });
  } catch (e) {
    // Silent error to not interrupt UX
  }
}

// From achievement_provider.dart:83
Future<void> checkAchievementsStatus(BuildContext context) async {
  await fetchAchievements(context);
}

// Example: Track progress toward "100 Items" achievement
final currentCount = 47;
final requiredCount = 100;
final progress = currentCount / requiredCount; // 0.47 or 47%

// From achievement_provider.dart:70
String getFormattedDate(String achievementId) {
  try {
    final ach = _achievements.firstWhere((a) => a.id == achievementId);
    if (ach.unlockedAt == null) return '';
    
    return DateFormat.yMMMd().format(ach.unlockedAt!);
  } catch (e) {
    return '';
  }
}

// From achievements_model.dart:3
class AchievementDefinition {
  final String id;
  final String title;
  final String desc;
  final IconData icon;
  final String category;
  final bool isLegendary;
  final bool unlocked;
  final DateTime? unlockedAt;
  
  const AchievementDefinition({
    required this.id,
    required this.title,
    required this.desc,
    required this.icon,
    this.category = 'general',
    this.isLegendary = false,
    this.unlocked = false,
    this.unlockedAt,
  });
}