How hcmdz/privnum works
Privnum is an offline Android private caller-ID and contact manager. Users keep multi-number contacts in encrypted app-local storage, then search, view, edit, import/export, or share them; incoming-call identification and on-demand call history are separate paths, with history matching against saved contacts. Settings cover language, appearance, security, and caller behavior. The graph follows documented capabilities and sampled imports/calls; some caller integrations and unsampled feature internals are represented only where the README supports them, otherwise links are omitted.
Main entry points: AppNav.kt App navigation · ContactRepository.kt Contact repository · EditorScreen.kt Contact editor · PreviewScreen.kt Contact details
Components 27
App navigation
- Main activity
app/src/main/java/com/hcmdz/privnum/MainActivity.kt - App navigation
app/src/main/java/com/hcmdz/privnum/AppNav.kt
Contact workflows
- Contact list
feature/contacts/src/main/java/com/hcmdz/privnum/contacts/ContactsScreen.kt - Contact search
feature/search/src/main/java/com/hcmdz/privnum/search/SearchScreen.kt - Contact editor
feature/editor/src/main/java/com/hcmdz/privnum/editor/EditorScreen.kt - Contact details
feature/preview/src/main/java/com/hcmdz/privnum/preview/PreviewScreen.kt - VCF mapping
core/data/src/main/java/com/hcmdz/privnum/data/VcfMapper.kt
Local data and security
- Contact model
core/data/src/main/java/com/hcmdz/privnum/data/Contact.kt - Number parsing
core/data/src/main/java/com/hcmdz/privnum/data/PhoneNumberUtils.kt - Contact repository
core/data/src/main/java/com/hcmdz/privnum/data/ContactRepository.kt - Contact DAO
core/data/src/main/java/com/hcmdz/privnum/data/db/ContactDao.kt - Encrypted contact database
core/data/src/main/java/com/hcmdz/privnum/data/db/PrivnumDatabase.kt - Encrypted photo store
core/data/src/main/java/com/hcmdz/privnum/data/ContactPhotoStore.kt
Caller and history
- Call screening
core/caller/src/main/java/com/hcmdz/privnum/caller/CallDetectScreeningService.kt - Call event receiver
core/caller/src/main/java/com/hcmdz/privnum/caller/CallReceiver.kt - Call directory provider
core/caller/src/main/java/com/hcmdz/privnum/caller/CallDirectoryProvider.kt - Call history reader
core/caller/src/main/java/com/hcmdz/privnum/caller/CallHistoryRepository.kt - System call log
core/caller/src/main/java/com/hcmdz/privnum/caller/CallLogDataSource.kt - Call history screen
feature/calllog/src/main/java/com/hcmdz/privnum/calllog/HistoryScreen.kt
Settings and presentation
- Settings screen
feature/settings/src/main/java/com/hcmdz/privnum/settings/SettingsScreen.kt - Preferences store
core/data/src/main/java/com/hcmdz/privnum/data/SettingsStore.kt - App lock
feature/lock/src/main/java/com/hcmdz/privnum/lock/LockScreen.kt - Passcode and biometrics
core/data/src/main/java/com/hcmdz/privnum/data/PasscodeStore.kt - Shared UI helpers
core/ui/src/main/java/com/hcmdz/privnum/ui/ContactAvatar.kt
Other components
- App user
- Android call system
- Phone and messaging apps
Connections 33
- App user → Main activity: opens
README.md - Main activity → App navigation: starts
app/src/main/java/com/hcmdz/privnum/MainActivity.kt - App navigation → Contact list: routes to
app/src/main/java/com/hcmdz/privnum/AppNav.kt - App navigation → Contact search: routes to
app/src/main/java/com/hcmdz/privnum/AppNav.kt - App navigation → Contact editor: routes to
app/src/main/java/com/hcmdz/privnum/AppNav.kt - App navigation → Contact details: routes to
app/src/main/java/com/hcmdz/privnum/AppNav.kt - App navigation → Call history screen: routes to
app/src/main/java/com/hcmdz/privnum/AppNav.kt - App navigation → Settings screen: routes to
app/src/main/java/com/hcmdz/privnum/AppNav.kt - App navigation → App lock: routes to
app/src/main/java/com/hcmdz/privnum/AppNav.kt - Contact list → VCF mapping: imports exports
feature/contacts/src/main/java/com/hcmdz/privnum/contacts/ContactsScreen.kt - Contact details → Phone and messaging apps: launches actions
feature/preview/src/main/java/com/hcmdz/privnum/preview/PreviewScreen.kt - Contact list → Contact model: uses model
feature/contacts/src/main/java/com/hcmdz/privnum/contacts/ContactsScreen.kt - Contact editor → Number parsing: formats numbers
feature/editor/src/main/java/com/hcmdz/privnum/editor/EditorScreen.kt - Contact editor → Shared UI helpers: renders avatars
feature/editor/src/main/java/com/hcmdz/privnum/editor/EditorScreen.kt - Contact details → Shared UI helpers: renders avatars
feature/preview/src/main/java/com/hcmdz/privnum/preview/PreviewScreen.kt - Contact editor → Contact repository: saves contacts
- Contact search → Contact repository: searches contacts
- Contact details → Contact repository: loads deletes
- Contact repository → Contact DAO: queries writes
core/data/src/main/java/com/hcmdz/privnum/data/ContactRepository.kt - Contact repository → Encrypted contact database: opens
core/data/src/main/java/com/hcmdz/privnum/data/ContactRepository.kt - Contact repository → Encrypted photo store: manages photos
core/data/src/main/java/com/hcmdz/privnum/data/ContactRepository.kt - Contact editor → Encrypted photo store: stores photos
- Call screening → Android call system: screens calls
README.md - Call screening → Call event receiver: references
core/caller/src/main/java/com/hcmdz/privnum/caller/CallDetectScreeningService.kt - Call directory provider → Contact repository: looks up callers
- Call history reader → System call log: reads entries
core/caller/src/main/java/com/hcmdz/privnum/caller/CallHistoryRepository.kt - Call history reader → Contact repository: matches numbers
core/caller/src/main/java/com/hcmdz/privnum/caller/CallHistoryRepository.kt - Call history reader → Preferences store: reads region
core/caller/src/main/java/com/hcmdz/privnum/caller/CallHistoryRepository.kt - Call history screen → Call history reader: shows recent calls
- Settings screen → Preferences store: updates preferences
- Settings screen → Passcode and biometrics: configures lock
- App lock → Passcode and biometrics: verifies passcode
- Settings screen → Call screening: configures caller ID