Feature/dra 141

[rajdeveloper90]

Summary by CodeRabbit

Release Notes

• New Features

  • Added address book upload functionality allowing users to sync their contacts to the app.
  • Implemented friend invitation flow integrated into the user registration process—users are now prompted to invite friends after account creation.

• Improvements

  • Enhanced onboarding navigation with streamlined activity transitions.

[coderabbitai]

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Free

Run ID: 9d405c61-c472-4f13-a886-2956ce1009b6

📥 Commits

Reviewing files that changed from the base of the PR and between d724c58 and fb17ef0.

📒 Files selected for processing (13)

• app/src/main/java/eu/theappfactory/dailyrecipes/data/invite/AddressBookDataSource.kt
• app/src/main/java/eu/theappfactory/dailyrecipes/data/invite/AddressBookRepository.kt
• app/src/main/java/eu/theappfactory/dailyrecipes/di/SharedModule.kt
• app/src/main/java/eu/theappfactory/dailyrecipes/domain/invite/UploadAddressBookUseCase.kt
• app/src/main/java/eu/theappfactory/dailyrecipes/model/Contact.kt
• app/src/main/java/eu/theappfactory/dailyrecipes/ui/categories/CategoriesFragment.kt
• app/src/main/java/eu/theappfactory/dailyrecipes/ui/invite/addressbook/InviteFriendsFragment.kt
• app/src/main/java/eu/theappfactory/dailyrecipes/ui/invite/addressbook/InviteFriendsViewModel.kt
• app/src/main/java/eu/theappfactory/dailyrecipes/ui/launch/LauncherActivity.kt
• app/src/main/java/eu/theappfactory/dailyrecipes/ui/launch/LauncherViewModel.kt
• app/src/main/java/eu/theappfactory/dailyrecipes/ui/register/createuser/CreateUsernameFragment.kt
• app/src/main/java/eu/theappfactory/dailyrecipes/ui/register/createuser/CreateUsernameViewModel.kt
• app/src/main/java/eu/theappfactory/dailyrecipes/util/ViewModelFactory.kt

---

📝 Walkthrough

Walkthrough

This PR implements an address book contacts upload feature. After users create accounts and reach onboarding screens, they navigate to an invite friends flow where contacts are loaded from the device and uploaded to Firestore. Navigation in certain flows transitions from NavController-based to explicit activity Intent launches.

Changes

Cohort / File(s)	Summary
Address Book Data Layer app/src/main/java/eu/theappfactory/dailyrecipes/data/invite/AddressBookDataSource.kt, app/src/main/java/eu/theappfactory/dailyrecipes/data/invite/AddressBookRepository.kt	Added uploadContacts suspend function to both interface and implementation. DataSource fetches existing contacts from Firestore and writes missing ones; Repository delegates to DataSource.
Dependency Injection app/src/main/java/eu/theappfactory/dailyrecipes/di/SharedModule.kt, app/src/main/java/eu/theappfactory/dailyrecipes/util/ViewModelFactory.kt	Updated DI provider to pass FirebaseFirestore to DefaultAddressBookDataSource. ViewModelFactory now injects UploadAddressBookUseCase and wires it into InviteFriendsViewModel.
Domain Layer app/src/main/java/eu/theappfactory/dailyrecipes/domain/invite/UploadAddressBookUseCase.kt	New domain use case that delegates contact uploads to the repository through a coroutine dispatcher.
Model app/src/main/java/eu/theappfactory/dailyrecipes/model/Contact.kt	Added companion object with DISPLAY_NAME and PHONE_NUMBER constants for serialization/mapping.
Registration & Onboarding Flow app/src/main/java/eu/theappfactory/dailyrecipes/ui/register/createuser/CreateUsernameFragment.kt, app/src/main/java/eu/theappfactory/dailyrecipes/ui/register/createuser/CreateUsernameViewModel.kt	ViewModel now emits onUserNameCreated event; Fragment observes and navigates to InviteFriendsPermissionActivity.
Address Book Upload Flow app/src/main/java/eu/theappfactory/dailyrecipes/ui/invite/addressbook/InviteFriendsViewModel.kt	Extended to upload contacts after loading. Retrieves current Firebase user ID and calls UploadAddressBookUseCase, setting preference flag only on success.
Navigation Changes app/src/main/java/eu/theappfactory/dailyrecipes/ui/invite/addressbook/InviteFriendsFragment.kt, app/src/main/java/eu/theappfactory/dailyrecipes/ui/categories/CategoriesFragment.kt, app/src/main/java/eu/theappfactory/dailyrecipes/ui/launch/LauncherActivity.kt, app/src/main/java/eu/theappfactory/dailyrecipes/ui/launch/LauncherViewModel.kt	Replaced NavController navigation with explicit Intent-based activity launches; re-enabled ADD_FRIENDS as active launch destination in LauncherViewModel and LauncherActivity.

Sequence Diagram(s)

sequenceDiagram
    participant User
    participant CreateUsernameFragment
    participant CreateUsernameViewModel
    participant InviteFriendsPermissionActivity
    participant InviteFriendsFragment
    participant InviteFriendsViewModel
    participant UploadAddressBookUseCase
    participant AddressBookRepository
    participant FirebaseFirestore

    User->>CreateUsernameFragment: Enter username
    CreateUsernameFragment->>CreateUsernameViewModel: createUser()
    CreateUsernameViewModel->>CreateUsernameViewModel: Post onUserNameCreated event
    CreateUsernameFragment->>InviteFriendsPermissionActivity: Start activity via Intent
    InviteFriendsFragment->>InviteFriendsViewModel: loadAddressBook()
    InviteFriendsViewModel->>InviteFriendsViewModel: Obtain contacts from device
    InviteFriendsViewModel->>InviteFriendsViewModel: Get current user ID
    InviteFriendsViewModel->>UploadAddressBookUseCase: execute(userId, contactList)
    UploadAddressBookUseCase->>AddressBookRepository: uploadContacts()
    AddressBookRepository->>FirebaseFirestore: Fetch existing contacts from users/{userId}/contacts
    FirebaseFirestore-->>AddressBookRepository: Return existing contacts
    AddressBookRepository->>FirebaseFirestore: Write missing contacts
    FirebaseFirestore-->>AddressBookRepository: Success
    AddressBookRepository-->>UploadAddressBookUseCase: Result.Success
    UploadAddressBookUseCase-->>InviteFriendsViewModel: Result received
    InviteFriendsViewModel->>InviteFriendsViewModel: Set userHasAddedFriends = true
    User->>InviteFriendsFragment: Proceed to main activity

Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Poem

🐰 A carrot-load of contacts sent,
Through Firestore's green corridor they went,
From username bloom to friends so true,
The address book dances, shiny and new!
hops excitedly ✨

---

Note

🎁 Summarized by CodeRabbit Free

Your organization is on the Free plan. CodeRabbit will generate a high-level summary and a walkthrough for each pull request. For a comprehensive line-by-line review, please upgrade your subscription to CodeRabbit Pro by visiting https://app.coderabbit.ai/login.

_{Comment @coderabbitai help to get the list of available commands and usage tips.}