How safarov399/sigma-contacts works
Sigma Contacts is an Android contacts app organized around MVI-style feature modules. The main workflow requests contact permission, displays contacts, and opens a selected contact’s details; users can also start contact creation and access labels, saved locations, highlights, organization, and settings. The graph includes the documented domain/data layers and Room storage. Several feature ViewModels and repository implementations were not excerpted, so their connections are shown as unverified rather than asserted as observed calls.
Main entry points: HomeFragment.kt Contact home · FullScreenActivity.kt Full-screen router · AppDatabase.kt Room database · DetailsFragment.kt Contact details
Components 25
App and navigation
- Main activity
app/src/main/java/me/safarov399/sigmacontacts/MainActivity.kt - Full-screen router
app/src/main/java/me/safarov399/sigmacontacts/FullScreenActivity.kt
Contact features
- Contact home
feature/home/src/main/java/me/safarov399/home/HomeFragment.kt - Home state logic
feature/home/src/main/java/me/safarov399/home/HomeViewModel.kt - Add contact
feature/add/src/main/java/me/safarov399/add/AddFragment.kt - Contact details
feature/details/src/main/java/me/safarov399/details/DetailsFragment.kt - Labels
feature/home/src/main/java/me/safarov399/label - Saved locations
feature/home/src/main/java/me/safarov399/save_location - Highlights
feature/highlights/src/main/java/me/safarov399/highlights - Organize contacts
feature/organize/src/main/java/me/safarov399/organize - Settings
feature/settings/src/main/java/me/safarov399/settings/SettingsFragment.kt
Domain and data
- Contact use cases
domain/src/main/java/me/safarov399/domain/usecase/contact - Label use cases
domain/src/main/java/me/safarov399/domain/usecase/label - Location use cases
domain/src/main/java/me/safarov399/domain/usecase/save_location - Contact repository
data/src/main/java/me/safarov399/data/repo/ContactRepository.kt - Label repository
data/src/main/java/me/safarov399/data/repo/LabelRepository.kt - Location repository
data/src/main/java/me/safarov399/data/repo/SaveLocationRepository.kt
Local persistence
- Room database
data/src/main/java/me/safarov399/data/db/AppDatabase.kt - Contact DAO
data/src/main/java/me/safarov399/data/dao/ContactDao.kt - Label DAO
data/src/main/java/me/safarov399/data/dao/LabelDao.kt - Location DAO
data/src/main/java/me/safarov399/data/dao/SaveLocationDao.kt
Shared UI and state
- MVI fragment base
core/src/main/java/me/safarov399/core/base/BaseFragment.kt - Contact entity
core/src/main/java/me/safarov399/core/entity/ContactEntity.kt
Other components
- App user
- Android contacts provider
Connections 30
- App user → Main activity: opens
app/src/main/java/me/safarov399/sigmacontacts/MainActivity.kt - Main activity → Full-screen router: routes to
app/src/main/java/me/safarov399/sigmacontacts/MainActivity.kt - Full-screen router → Contact home: hosts
- Full-screen router → Add contact: routes to
app/src/main/java/me/safarov399/sigmacontacts/FullScreenActivity.kt - Full-screen router → Contact details: routes to
app/src/main/java/me/safarov399/sigmacontacts/FullScreenActivity.kt - Full-screen router → Settings: routes to
app/src/main/java/me/safarov399/sigmacontacts/FullScreenActivity.kt - Contact home → Full-screen router: opens details
feature/home/src/main/java/me/safarov399/home/HomeFragment.kt - Contact home → Full-screen router: opens add
feature/home/src/main/java/me/safarov399/home/HomeFragment.kt - Contact home → Home state logic: posts events
feature/home/src/main/java/me/safarov399/home/HomeFragment.kt - Contact home → Saved locations: opens sheet
feature/home/src/main/java/me/safarov399/home/HomeFragment.kt - Contact details → MVI fragment base: extends
feature/details/src/main/java/me/safarov399/details/DetailsFragment.kt - Contact home → MVI fragment base: extends
feature/home/src/main/java/me/safarov399/home/HomeFragment.kt - MVI fragment base → Home state logic: collects state
- Add contact → Android contacts provider: writes contacts
feature/add/src/main/java/me/safarov399/add/AddFragment.kt - Contact details → Contact use cases: loads contact
- Home state logic → Contact use cases: uses
- Labels → Label use cases: uses
- Saved locations → Location use cases: uses
- Contact use cases → Contact repository: delegates
- Label use cases → Label repository: delegates
- Location use cases → Location repository: delegates
- Contact repository → Contact DAO: calls
data/src/main/java/me/safarov399/data/repo/ContactRepository.kt - Label repository → Label DAO: calls
- Location repository → Location DAO: calls
data/src/main/java/me/safarov399/data/repo/SaveLocationRepository.kt - Room database → Contact DAO: provides
data/src/main/java/me/safarov399/data/db/AppDatabase.kt - Room database → Label DAO: provides
data/src/main/java/me/safarov399/data/db/AppDatabase.kt - Room database → Location DAO: provides
data/src/main/java/me/safarov399/data/db/AppDatabase.kt - Contact DAO → Contact entity: stores
data/src/main/java/me/safarov399/data/dao/ContactDao.kt - Highlights → Contact home: returns to
- Organize contacts → App user: offers tools