feat: Phase 3 — 26 medium-priority gaps implemented

P3-A/K  Profile: Eventify ID glassmorphic badge (tap-to-copy), DiceBear
        Notionists avatar via TierAvatarRing, district picker (14 pills)
        with 183-day cooldown lock, multipart photo upload to server
P3-B    Home: Top Events converted to PageView scroll-snap
        (viewportFraction 0.9 + PageScrollPhysics)
P3-C    Event detail: contributor widget (tier ring + name + navigation),
        related events horizontal row; added getEventsByCategory() to
        EventsService; added contributorId/Name/Tier fields to EventModel
P3-D    Kerala pincodes: 463-entry JSON (all 14 districts), registered as
        asset, async-loaded in SearchScreen replacing hardcoded 32 cities
P3-E    Checkout: promo code field + Apply/Remove button in Step 2,
        discountAmount subtracted from total, applyPromo()/resetPromo()
        methods in CheckoutProvider
P3-F/G  Gamification: reward cycle countdown + EP→RP progress bar (blue→
        amber) in contribute + profile screens; TierAvatarRing in podium
        and all leaderboard rows; GlassCard current-user stats card at
        top of leaderboard tab
P3-H    New ContributorProfileScreen: tier ring, stats, submission grid
        with status chips; getDashboardForUser() in GamificationService;
        wired from leaderboard row taps
P3-I    Achievements: 11 default badges (up from 6), 6 new icon map
        entries; progress % labels already confirmed present
P3-J    Reviews: CustomPainter circular arc rating ring (amber, 84px)
        replaces large rating number in ReviewSummary
P3-L    Share rank card: RepaintBoundary → PNG capture → Share.shareXFiles;
        share button wired in profile header and leaderboard tab
P3-M    SafeArea audit: home bottom nav, contribute/achievements scroll
        padding, profile CustomScrollView top inset

New files: tier_avatar_ring.dart, glass_card.dart,
  eventify_bottom_sheet.dart, contributor_profile_screen.dart,
  share_rank_card.dart, assets/data/kerala_pincodes.json
New dep:   path_provider ^2.1.0

lib/features/events/models/event_models.dart

@@ -72,6 +72,11 @@ class EventModel {
   final double? averageRating;
   final int? reviewCount;
 
+  // Contributor fields (EVT-001)
+  final String? contributorId;
+  final String? contributorName;
+  final String? contributorTier;
+
   EventModel({
     required this.id,
     required this.name,
@@ -97,6 +102,9 @@ class EventModel {
     this.importantInfo = const [],
     this.averageRating,
     this.reviewCount,
+    this.contributorId,
+    this.contributorName,
+    this.contributorTier,
   });
 
   /// Safely parse a double from backend (may arrive as String or num)
@@ -156,6 +164,9 @@ class EventModel {
       importantInfo: _parseImportantInfo(j['important_info']),
       averageRating: (j['average_rating'] as num?)?.toDouble(),
       reviewCount: (j['review_count'] as num?)?.toInt(),
+      contributorId: j['contributor_id']?.toString(),
+      contributorName: j['contributor_name'] as String?,
+      contributorTier: j['contributor_tier'] as String?,
     );
   }
 }

lib/features/events/services/events_service.dart

@@ -83,6 +83,28 @@ class EventsService {
     return EventModel.fromJson(Map<String, dynamic>.from(res));
   }
 
+  /// Related events by event_type_id (EVT-002).
+  /// Fetches events with the same category, silently returns [] on failure.
+  Future<List<EventModel>> getEventsByCategory(int eventTypeId, {int limit = 5}) async {
+    try {
+      final res = await _api.post(
+        ApiEndpoints.eventsByCategory,
+        body: {'event_type_id': eventTypeId, 'page_size': limit, 'page': 1},
+        requiresAuth: false,
+      );
+      final results = res['results'] ?? res['events'] ?? res['data'] ?? [];
+      if (results is List) {
+        return results
+            .whereType<Map<String, dynamic>>()
+            .map((e) => EventModel.fromJson(e))
+            .toList();
+      }
+    } catch (_) {
+      // silently fail — related events are non-critical
+    }
+    return [];
+  }
+
   /// Events by month and year for calendar (POST to /events/events-by-month-year/)
   Future<Map<String, dynamic>> getEventsByMonthYear(String month, int year) async {
     final res = await _api.post(ApiEndpoints.eventsByMonth, body: {'month': month, 'year': year}, requiresAuth: false);