feat(analytics): track card scanning and addition events

Add two new analytics events to track the card management flow:

- CardScanned: Tracks when users scan or input a card number
  - Property: scanMethod (enum: NFC, MANUAL) to distinguish input method
  - Tracked when valid 12-digit card number is received

- CardAdded: Tracks successful card additions to user's collection
  - Property: cardType to identify the type of card added
  - Tracked after card is saved to repository

Both scan methods (NFC and manual input) now explicitly specify the
scan method parameter, ensuring accurate tracking and preventing future
errors if new input sources are added.

Author: Sloy

app/src/main/java/com/sloy/sevibus/feature/cards/CardViewModel.kt

@@ -8,6 +8,7 @@ import com.sloy.sevibus.domain.repository.CardsRepository
 import com.sloy.sevibus.infrastructure.SevLogger
 import com.sloy.sevibus.infrastructure.analytics.Analytics
 import com.sloy.sevibus.infrastructure.analytics.events.Clicks
+import com.sloy.sevibus.infrastructure.analytics.events.Events
 import kotlinx.coroutines.ExperimentalCoroutinesApi
 import kotlinx.coroutines.flow.Flow
 import kotlinx.coroutines.flow.MutableSharedFlow
@@ -55,12 +56,12 @@ class CardViewModel(
         CardsScreenState.Error(error)
     }.stateIn(viewModelScope, SharingStarted.WhileSubscribed(), CardsScreenState.Loading)
 
-    fun onNewCardNumber(serialNumber: String) {
+    fun onNewCardNumber(serialNumber: String, scanMethod: Events.CardScanned.ScanMethod) {
         newCardState.value = CardsScreenNewCardState.InputForm(serialNumber)
         if (serialNumber.length < 12 || !serialNumber.all { it.isDigit() }) return
         val cardId = serialNumber.toLong()
 
-
+        analytics.track(Events.CardScanned(scanMethod))
         newCardState.value = CardsScreenNewCardState.CheckingCard(serialNumber)
         viewModelScope.launch {
             runCatching { cardsRepository.checkCard(cardId) }
@@ -89,6 +90,7 @@ class CardViewModel(
             events.emit(CardsScreenEvent.ShowMessage("Ya tienes guardada esa tarjeta"))
         } else {
             cardsRepository.addUserCard(card)
+            analytics.track(Events.CardAdded(card.type))
             scrollToCard.value = card.serialNumber
         }
         newCardState.value = CardsScreenNewCardState.InputForm()

app/src/main/java/com/sloy/sevibus/feature/cards/CardsScreen.kt

@@ -98,6 +98,7 @@ import com.sloy.sevibus.domain.model.CardInfo
 import com.sloy.sevibus.infrastructure.EventCollector
 import com.sloy.sevibus.infrastructure.FeatureFlags
 import com.sloy.sevibus.infrastructure.SevLogger
+import com.sloy.sevibus.infrastructure.analytics.events.Events
 import com.sloy.sevibus.infrastructure.extensions.performHapticGestureStart
 import com.sloy.sevibus.infrastructure.extensions.performHapticSegmentTick
 import com.sloy.sevibus.infrastructure.extensions.splitPhrase
@@ -136,7 +137,10 @@ fun CardsScreen(
     val nfcAnimation = remember { Animatable(1f) }
 
     EventCollector(nfcStateManager.events) { nfcReadEvent ->
-        viewModel.onNewCardNumber(CardSerialNumberUtils.calculateVisibleSerialNumber(nfcReadEvent.cardId))
+        viewModel.onNewCardNumber(
+            CardSerialNumberUtils.calculateVisibleSerialNumber(nfcReadEvent.cardId),
+            scanMethod = Events.CardScanned.ScanMethod.NFC
+        )
         nfcAnimation.animatePulse()
     }
     EventCollector(viewModel.events) {
@@ -155,7 +159,9 @@ fun CardsScreen(
         state,
         newCardState,
         nfcState,
-        viewModel::onNewCardNumber,
+        onNewCardNumber = { serialNumber ->
+            viewModel.onNewCardNumber(serialNumber, Events.CardScanned.ScanMethod.MANUAL)
+        },
         viewModel::onDeleteCard,
         viewModel::onTopUpClicked,
         viewModel::onStartReordering,

app/src/main/java/com/sloy/sevibus/infrastructure/analytics/events/Events.kt

@@ -34,5 +34,20 @@ interface Events {
         "Review Dialog Failed",
         "reason" to reason
     )
+
+    data class CardAdded(val cardType: String) : SevEvent(
+        "Card Added",
+        "cardType" to cardType
+    )
+
+    data class CardScanned(val scanMethod: ScanMethod) : SevEvent(
+        "Card Scanned",
+        "scanMethod" to scanMethod.name.lowercase()
+    ) {
+        enum class ScanMethod {
+            NFC,
+            MANUAL
+        }
+    }
 }