How talmastera/fyp works
TalknLearn is an Android translation and language-learning app backed by Firebase Cloud Functions, Firestore, and Azure services. Users enter through the app’s navigation and can translate speech or scanned text, build learning materials from translation history, manage vocabulary, and use friend and sharing features. Account, settings, and history data sync through Firebase. The graph preserves README-documented capabilities, but sampled source only verifies some internal calls; unverified feature wiring is shown as dashed.
Main entry points: ContinuousConversationController.kt Speech screens · LearningViewModel.kt Learning screens · index.ts Function exports · FriendsViewModel.kt Friends screens
Components 25
App shell
- App navigation
app/src/main/java/com/translator/TalknLearn/navigation/AppNavigation.kt - UI language
app/src/main/java/com/translator/TalknLearn/data/ui/UiLanguageStateController.kt
Translation and speech
- Speech screens
app/src/main/java/com/translator/TalknLearn/screens/speech/ContinuousConversationController.kt - Speech use cases
app/src/main/java/com/translator/TalknLearn/domain/speech/StartContinuousConversationUseCase.kt - Speech repository
app/src/main/java/com/translator/TalknLearn/data/repositories/AzureSpeechRepository.kt - Translation client
app/src/main/java/com/translator/TalknLearn/data/clients/CloudTranslatorClient.kt - Image OCR
app/src/main/java/com/translator/TalknLearn/data/ocr/MLKitOcrRepository.kt
Learning and history
- Translation history
app/src/main/java/com/translator/TalknLearn/data/history/FirestoreHistoryRepository.kt - Learning screens
app/src/main/java/com/translator/TalknLearn/screens/learning/LearningViewModel.kt - Learning generation
app/src/main/java/com/translator/TalknLearn/data/learning/LearningContentRepositoryImpl.kt - Quiz repository
app/src/main/java/com/translator/TalknLearn/data/learning/FirestoreQuizRepository.kt - Word bank
app/src/main/java/com/translator/TalknLearn/data/wordbank/WordBankGenerationRepository.kt
Accounts and friends
- Authentication
app/src/main/java/com/translator/TalknLearn/data/user/FirebaseAuthRepository.kt - Friends screens
app/src/main/java/com/translator/TalknLearn/screens/friends/FriendsViewModel.kt - Friends data
app/src/main/java/com/translator/TalknLearn/data/friends/FirestoreFriendsRepository.kt - Chat data
app/src/main/java/com/translator/TalknLearn/data/friends/FirestoreChatRepository.kt
Cloud services
- Translation functions
fyp-backend/functions/src/translation.ts - AI functions
fyp-backend/functions/src/learning.ts - Push notifications
fyp-backend/functions/src/notifications.ts - Function exports
fyp-backend/functions/src/index.ts
Other components
- App user
- Azure Speech
- Azure Translator
- Firebase Auth
- Cloud Firestore
Connections 28
- App user → App navigation: opens
- App navigation → Speech screens: offers translation
- Speech screens → Speech use cases: starts conversation
app/src/main/java/com/translator/TalknLearn/screens/speech/ContinuousConversationController.kt - Speech use cases → Speech repository: uses speech
- Speech repository → Azure Speech: requests speech
- Speech screens → Translation client: translates text
- Translation client → Translation functions: calls function
- Translation functions → Azure Translator: requests translation
fyp-backend/functions/src/translation.ts - App user → Image OCR: scans image
- Speech screens → Translation history: saves segments
- Translation history → Cloud Firestore: syncs records
- App user → Learning screens: creates materials
- Learning screens → Learning generation: requests sheets
- Learning generation → AI functions: generates content
- Learning screens → Quiz repository: manages quizzes
- Learning screens → Word bank: manages vocabulary
- App user → Authentication: signs in
- Authentication → Firebase Auth: authenticates
app/src/main/java/com/translator/TalknLearn/data/user/FirebaseAuthRepository.kt - App user → Friends screens: uses social features
- Friends screens → Friends data: manages friends
- Friends screens → Chat data: sends messages
- Friends data → Cloud Firestore: reads and writes
- Chat data → Cloud Firestore: reads and writes
- Function exports → Translation functions: exports
fyp-backend/functions/src/index.ts - Function exports → AI functions: exports
fyp-backend/functions/src/index.ts - Function exports → Push notifications: exports
fyp-backend/functions/src/index.ts - Chat data → Push notifications: triggers push
- App user → UI language: changes interface language
app/src/main/java/com/translator/TalknLearn/data/ui/UiLanguageStateController.kt