CLAUDE.md

1# Profile Feature
2 
3Account-level — GitHub user profile, login/logout, version info. **Settings live in `feature/tweaks/`** — this module narrow on purpose. Owns account identity + exposes `ProfileRepository.getUser()` to other features (home/search/details/starred/favourites/tweaks/dev-profile consume it for E20 self-owned badge and account-aware flows).
4 
5## Structure
6 
7```
8feature/profile/
9├── domain/        # ProfileRepository, UserProfile
10├── data/          # ProfileRepositoryImpl, UserProfileMappers
11└── presentation/
12    ├── ProfileViewModel / State / Action / Event / Root
13    ├── model/ProxyType (legacy — proxy lives in tweaks now)
14    └── components/ LogoutDialog, SectionText, sections/{Account, AccountSection, ProfileSection}
15```
16 
17## Key interface
18 
19```kotlin
20interface ProfileRepository {
21    val isUserLoggedIn: Flow<Boolean>
22    fun getUser(): Flow<UserProfile?>
23    fun getVersionName(): String
24    suspend fun logout()
25    fun observeCacheSize(): Flow<Long>
26    suspend fun clearCache()
27}
28```
29 
30## Navigation
31 
32`GithubStoreGraph.ProfileScreen`.
33 
34## Notes
35 
36- `getUser()` cached via `CacheManager` key `profile:me`. Invalidates on logout.
37- "Settings" tap → `TweaksScreen`. Don't add settings here.
38- VM injects: `ProfileRepository`, `Platform`.
39