---

name: sporsal description: Sporsal spor buluşma uygulaması için proje-spesifik kurallar ve konvansiyonlar. Bu skill'i Sporsal projesinde çalışırken kullan - mimari, dosya yapısı, model ve servis kalıpları için.

Sporsal Proje Skill'i

Proje Genel Bakış

Sporsal, spor tutkunlarının buluşma organize etmesini ve spor arkadaşı bulmasını sağlayan bir Flutter uygulamasıdır.

Tagline: "Spor Arkadaşını Bul"

Mimari

Klasör Yapısı

lib/
├── core/
│   ├── models/          # Veri modelleri
│   └── services/        # İş mantığı servisleri
├── features/
│   └── [feature]/
│       └── presentation/
│           ├── [feature]_screen.dart
│           └── widgets/
├── theme/
│   └── app_theme.dart
└── main.dart

Feature Modülleri

• auth/ - Giriş, kayıt ekranları
• home/ - Ana sayfa, buluşma listesi
• meetups/ - Buluşma oluşturma, detay
• chat/ - Mesajlaşma
• profile/ - Profil görüntüleme, düzenleme

Veri Modelleri

UserModel

// Lokasyon: lib/core/models/user_model.dart
class UserModel {
  final String id;
  final String username;
  final String email;
  final String? profileImageUrl;
  final String? bio;
  final List<Certificate> certificates;
  final List<Badge> badges;
  final int followersCount;
  final int followingCount;
  final String? location;
  final String? gender;
  final DateTime? birthDate;
  final Level level;              // beginner, intermediate, advanced
  final PreferredTime preferredTime;
  final PlayStyle playStyle;      // competitive, casual
  final List<String> followers;
  final List<String> following;
}

MeetupModel

// Lokasyon: lib/core/models/meetup_model.dart
class MeetupModel {
  final String id;
  final String title;
  final String description;
  final String? imageUrl;
  final MeetupType type;          // football, yoga, tennis, basketball, running, other
  final DateTime date;
  final String locationName;
  final String locationAddress;
  final String organizerId;
  final String organizerName;
  final String? organizerImageUrl;
  final int currentParticipants;
  final int maxParticipants;
  final bool isFull;
  final List<String> participantIds;
}

MessageModel

// Lokasyon: lib/core/models/message_model.dart
class MessageModel {
  final String id;
  final String senderId;
  final String senderName;
  final String? senderImageUrl;
  final String? text;
  final String? imageUrl;
  final MessageType type;         // text, image, system
  final DateTime timestamp;
}

Servisler

AuthService

// Lokasyon: lib/core/services/auth_service.dart
// Provider ile kullanım: context.read<AuthService>()

// Metodlar:
- signUp(email, password, username)
- signIn(email, password)
- signOut()
- getCurrentUser() -> Future<UserModel?>
- followUser(targetUserId)
- unfollowUser(targetUserId)
- updateUserProfile(UserModel)

MeetupService

// Lokasyon: lib/core/services/meetup_service.dart

// Metodlar:
- createMeetup(MeetupModel)
- getMeetupsStream() -> Stream<List<MeetupModel>>
- getUserMeetups(userId) -> Stream<List<MeetupModel>>
- getMeetup(meetupId) -> Future<MeetupModel?>
- joinMeetup(meetupId) -> Transaction ile atomik
- isParticipant(meetupId) -> Future<bool>

ChatService

// Lokasyon: lib/core/services/chat_service.dart

// Metodlar:
- sendMessage(chatId, MessageModel)
- getMessagesStream(chatId) -> Stream<List<MessageModel>>

// Firestore yapısı: chats/{meetupId}/messages/{messageId}

Routing (GoRouter)

Route Tanımları

// main.dart içinde

'/login'        -> LoginScreen
'/signup'       -> SignupScreen
'/home'         -> HomeScreen (MainShell içinde)
'/chats'        -> MyChatsScreen (MainShell içinde)
'/create'       -> CreateMeetupScreen (MainShell içinde)
'/profile'      -> ProfileScreen (MainShell içinde)
'/detail'       -> MeetupDetailScreen (extra: MeetupModel)
'/chat'         -> ChatScreen (queryParams: chatId, title)
'/edit-profile' -> EditProfileScreen (extra: UserModel)
'/create-profile' -> CreateProfileScreen

Navigasyon Örnekleri

// Named route
context.goNamed('home');

// Extra data ile
context.go('/detail', extra: meetup);

// Query params ile
context.go('/chat?chatId=${meetup.id}&title=${meetup.title}');

// Geri
context.pop();

Tema

Renkler

// Primary: #6C63FF (Mor)
// Dark background: #1A1A2E (Koyu lacivert)

// Kullanım:
Theme.of(context).colorScheme.primary
Theme.of(context).colorScheme.surface

Font

// Google Fonts: Outfit
GoogleFonts.outfit()

Varsayılan Tema

Uygulama varsayılan olarak dark mode kullanır.

Firestore Koleksiyonları

users/
  {userId}/
    - username, email, profileImageUrl, bio
    - certificates[], badges[]
    - followersCount, followingCount
    - location, gender, birthDate
    - level, preferredTime, playStyle
    - followers[], following[]

meetups/
  {meetupId}/
    - title, description, imageUrl
    - type, date
    - locationName, locationAddress
    - organizerId, organizerName, organizerImageUrl
    - currentParticipants, maxParticipants, isFull
    - participantIds[]

chats/
  {meetupId}/
    - lastMessage, lastMessageTime, lastSenderName
    messages/
      {messageId}/
        - senderId, senderName, senderImageUrl
        - text, imageUrl, type, timestamp

Kod Stilleri

Türkçe Kullanıcı Mesajları

// Hata mesajları Türkçe olmalı
throw 'Bu e-posta zaten kullanımda';
throw 'Şifre en az 6 karakter olmalı';

// SnackBar mesajları
ScaffoldMessenger.of(context).showSnackBar(
  SnackBar(content: Text('Buluşmaya katıldınız!')),
);

Async İşlemler Sonrası Context Kontrolü

await someAsyncOperation();
if (!context.mounted) return;
// context kullanımı

Loading State Pattern

bool _isLoading = false;

Future<void> _submit() async {
  setState(() => _isLoading = true);
  try {
    await operation();
  } catch (e) {
    // handle error
  } finally {
    if (mounted) {
      setState(() => _isLoading = false);
    }
  }
}

// Button'da:
ElevatedButton(
  onPressed: _isLoading ? null : _submit,
  child: _isLoading
      ? SizedBox(
          height: 20,
          width: 20,
          child: CircularProgressIndicator(strokeWidth: 2),
        )
      : Text('Gönder'),
)

Yeni Özellik Ekleme Rehberi

1. Model gerekiyorsa: lib/core/models/ altına ekle
2. Servis gerekiyorsa: lib/core/services/ altına ekle, main.dart'ta Provider'a kaydet
3. Ekran: lib/features/[feature]/presentation/ altına ekle
4. Route: main.dart'ta GoRouter'a ekle
5. Widget: Tekrar kullanılacaksa widgets/ alt klasörüne

Önemli Notlar

• Buluşmaya katılım MeetupService.joinMeetup() ile transaction kullanır
• Chat mesajları subcollection'da saklanır
• Profil resimleri Firebase Storage'da profile_images/ altında
• Uygulama dili Türkçe, tüm UI metinleri Türkçe olmalı