# safarov399/sigma-contacts architecture

> Architecture diagram of the GitHub repository safarov399/sigma-contacts, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/safarov399/sigma-contacts
- Repository: https://github.com/safarov399/sigma-contacts

## Overview

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: [`feature/home/src/main/java/me/safarov399/home/HomeFragment.kt`](https://github.com/safarov399/sigma-contacts/blob/master/feature/home/src/main/java/me/safarov399/home/HomeFragment.kt) (Contact home), [`app/src/main/java/me/safarov399/sigmacontacts/FullScreenActivity.kt`](https://github.com/safarov399/sigma-contacts/blob/master/app/src/main/java/me/safarov399/sigmacontacts/FullScreenActivity.kt) (Full-screen router), [`data/src/main/java/me/safarov399/data/db/AppDatabase.kt`](https://github.com/safarov399/sigma-contacts/blob/master/data/src/main/java/me/safarov399/data/db/AppDatabase.kt) (Room database), [`feature/details/src/main/java/me/safarov399/details/DetailsFragment.kt`](https://github.com/safarov399/sigma-contacts/blob/master/feature/details/src/main/java/me/safarov399/details/DetailsFragment.kt) (Contact details)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and navigation"]
  node_main["Main activity<br/>[MainActivity.kt]"]
  node_fullscreen["Full-screen router"]
end

subgraph group_features["Contact features"]
  node_home["Contact home<br/>[HomeFragment.kt]"]
  node_contact_vm["Home state logic<br/>[HomeViewModel.kt]"]
  node_add["Add contact<br/>[AddFragment.kt]"]
  node_details["Contact details<br/>[DetailsFragment.kt]"]
  node_labels["Labels"]
  node_saved["Saved locations"]
  node_highlights["Highlights"]
  node_organize["Organize contacts"]
  node_settings["Settings"]
end

subgraph group_domain["Domain and data"]
  node_contact_domain["Contact use cases"]
  node_label_domain["Label use cases"]
  node_location_domain["Location use cases"]
  node_contact_repo["Contact repository"]
  node_label_repo["Label repository<br/>[LabelRepository.kt]"]
  node_location_repo["Location repository"]
end

subgraph group_storage["Local persistence"]
  node_database[("Room database<br/>[AppDatabase.kt]")]
  node_contact_dao["Contact DAO<br/>[ContactDao.kt]"]
  node_label_dao["Label DAO<br/>[LabelDao.kt]"]
  node_location_dao["Location DAO<br/>[SaveLocationDao.kt]"]
end

subgraph group_shared["Shared UI and state"]
  node_base_fragment["MVI fragment base<br/>[BaseFragment.kt]"]
  node_contact_entity["Contact entity<br/>[ContactEntity.kt]"]
end

node_user(("App user"))
node_android_contacts[("Android contacts provider")]

node_user -->|"opens"| node_main
node_main -->|"routes to"| node_fullscreen
node_fullscreen -.->|"hosts"| node_home
node_fullscreen -->|"routes to"| node_add
node_fullscreen -->|"routes to"| node_details
node_fullscreen -->|"routes to"| node_settings
node_home -->|"opens details"| node_fullscreen
node_home -->|"opens add"| node_fullscreen
node_home -.->|"posts events"| node_contact_vm
node_home -->|"opens sheet"| node_saved
node_details -->|"extends"| node_base_fragment
node_home -->|"extends"| node_base_fragment
node_base_fragment -.->|"collects state"| node_contact_vm
node_add -->|"writes contacts"| node_android_contacts
node_details -.->|"loads contact"| node_contact_domain
node_contact_vm -.->|"uses"| node_contact_domain
node_labels -.->|"uses"| node_label_domain
node_saved -.->|"uses"| node_location_domain
node_contact_domain -.->|"delegates"| node_contact_repo
node_label_domain -.->|"delegates"| node_label_repo
node_location_domain -.->|"delegates"| node_location_repo
node_contact_repo -->|"calls"| node_contact_dao
node_label_repo -.->|"calls"| node_label_dao
node_location_repo -->|"calls"| node_location_dao
node_database -->|"provides"| node_contact_dao
node_database -->|"provides"| node_label_dao
node_database -->|"provides"| node_location_dao
node_contact_dao -.->|"stores"| node_contact_entity
node_highlights -.->|"returns to"| node_home
node_organize -.->|"offers tools"| node_user

click node_main "https://github.com/safarov399/sigma-contacts/blob/master/app/src/main/java/me/safarov399/sigmacontacts/MainActivity.kt"
click node_fullscreen "https://github.com/safarov399/sigma-contacts/blob/master/app/src/main/java/me/safarov399/sigmacontacts/FullScreenActivity.kt"
click node_home "https://github.com/safarov399/sigma-contacts/blob/master/feature/home/src/main/java/me/safarov399/home/HomeFragment.kt"
click node_contact_vm "https://github.com/safarov399/sigma-contacts/blob/master/feature/home/src/main/java/me/safarov399/home/HomeViewModel.kt"
click node_add "https://github.com/safarov399/sigma-contacts/blob/master/feature/add/src/main/java/me/safarov399/add/AddFragment.kt"
click node_details "https://github.com/safarov399/sigma-contacts/blob/master/feature/details/src/main/java/me/safarov399/details/DetailsFragment.kt"
click node_labels "https://github.com/safarov399/sigma-contacts/tree/master/feature/home/src/main/java/me/safarov399/label"
click node_saved "https://github.com/safarov399/sigma-contacts/tree/master/feature/home/src/main/java/me/safarov399/save_location"
click node_highlights "https://github.com/safarov399/sigma-contacts/tree/master/feature/highlights/src/main/java/me/safarov399/highlights"
click node_organize "https://github.com/safarov399/sigma-contacts/tree/master/feature/organize/src/main/java/me/safarov399/organize"
click node_settings "https://github.com/safarov399/sigma-contacts/blob/master/feature/settings/src/main/java/me/safarov399/settings/SettingsFragment.kt"
click node_contact_domain "https://github.com/safarov399/sigma-contacts/tree/master/domain/src/main/java/me/safarov399/domain/usecase/contact"
click node_label_domain "https://github.com/safarov399/sigma-contacts/tree/master/domain/src/main/java/me/safarov399/domain/usecase/label"
click node_location_domain "https://github.com/safarov399/sigma-contacts/tree/master/domain/src/main/java/me/safarov399/domain/usecase/save_location"
click node_contact_repo "https://github.com/safarov399/sigma-contacts/blob/master/data/src/main/java/me/safarov399/data/repo/ContactRepository.kt"
click node_label_repo "https://github.com/safarov399/sigma-contacts/blob/master/data/src/main/java/me/safarov399/data/repo/LabelRepository.kt"
click node_location_repo "https://github.com/safarov399/sigma-contacts/blob/master/data/src/main/java/me/safarov399/data/repo/SaveLocationRepository.kt"
click node_database "https://github.com/safarov399/sigma-contacts/blob/master/data/src/main/java/me/safarov399/data/db/AppDatabase.kt"
click node_contact_dao "https://github.com/safarov399/sigma-contacts/blob/master/data/src/main/java/me/safarov399/data/dao/ContactDao.kt"
click node_label_dao "https://github.com/safarov399/sigma-contacts/blob/master/data/src/main/java/me/safarov399/data/dao/LabelDao.kt"
click node_location_dao "https://github.com/safarov399/sigma-contacts/blob/master/data/src/main/java/me/safarov399/data/dao/SaveLocationDao.kt"
click node_base_fragment "https://github.com/safarov399/sigma-contacts/blob/master/core/src/main/java/me/safarov399/core/base/BaseFragment.kt"
click node_contact_entity "https://github.com/safarov399/sigma-contacts/blob/master/core/src/main/java/me/safarov399/core/entity/ContactEntity.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_fullscreen,node_user toneBlue
class node_home,node_contact_vm,node_add,node_details,node_labels,node_saved,node_highlights,node_organize,node_settings,node_android_contacts toneAmber
class node_contact_domain,node_label_domain,node_location_domain,node_contact_repo,node_label_repo,node_location_repo toneMint
class node_database,node_contact_dao,node_label_dao,node_location_dao toneRose
class node_base_fragment,node_contact_entity toneIndigo
```

## Components

### App and navigation

- [Main activity](https://github.com/safarov399/sigma-contacts/blob/master/app/src/main/java/me/safarov399/sigmacontacts/MainActivity.kt): `app/src/main/java/me/safarov399/sigmacontacts/MainActivity.kt`
- [Full-screen router](https://github.com/safarov399/sigma-contacts/blob/master/app/src/main/java/me/safarov399/sigmacontacts/FullScreenActivity.kt): `app/src/main/java/me/safarov399/sigmacontacts/FullScreenActivity.kt`

### Contact features

- [Contact home](https://github.com/safarov399/sigma-contacts/blob/master/feature/home/src/main/java/me/safarov399/home/HomeFragment.kt): `feature/home/src/main/java/me/safarov399/home/HomeFragment.kt`
- [Home state logic](https://github.com/safarov399/sigma-contacts/blob/master/feature/home/src/main/java/me/safarov399/home/HomeViewModel.kt): `feature/home/src/main/java/me/safarov399/home/HomeViewModel.kt`
- [Add contact](https://github.com/safarov399/sigma-contacts/blob/master/feature/add/src/main/java/me/safarov399/add/AddFragment.kt): `feature/add/src/main/java/me/safarov399/add/AddFragment.kt`
- [Contact details](https://github.com/safarov399/sigma-contacts/blob/master/feature/details/src/main/java/me/safarov399/details/DetailsFragment.kt): `feature/details/src/main/java/me/safarov399/details/DetailsFragment.kt`
- [Labels](https://github.com/safarov399/sigma-contacts/tree/master/feature/home/src/main/java/me/safarov399/label): `feature/home/src/main/java/me/safarov399/label`
- [Saved locations](https://github.com/safarov399/sigma-contacts/tree/master/feature/home/src/main/java/me/safarov399/save_location): `feature/home/src/main/java/me/safarov399/save_location`
- [Highlights](https://github.com/safarov399/sigma-contacts/tree/master/feature/highlights/src/main/java/me/safarov399/highlights): `feature/highlights/src/main/java/me/safarov399/highlights`
- [Organize contacts](https://github.com/safarov399/sigma-contacts/tree/master/feature/organize/src/main/java/me/safarov399/organize): `feature/organize/src/main/java/me/safarov399/organize`
- [Settings](https://github.com/safarov399/sigma-contacts/blob/master/feature/settings/src/main/java/me/safarov399/settings/SettingsFragment.kt): `feature/settings/src/main/java/me/safarov399/settings/SettingsFragment.kt`

### Domain and data

- [Contact use cases](https://github.com/safarov399/sigma-contacts/tree/master/domain/src/main/java/me/safarov399/domain/usecase/contact): `domain/src/main/java/me/safarov399/domain/usecase/contact`
- [Label use cases](https://github.com/safarov399/sigma-contacts/tree/master/domain/src/main/java/me/safarov399/domain/usecase/label): `domain/src/main/java/me/safarov399/domain/usecase/label`
- [Location use cases](https://github.com/safarov399/sigma-contacts/tree/master/domain/src/main/java/me/safarov399/domain/usecase/save_location): `domain/src/main/java/me/safarov399/domain/usecase/save_location`
- [Contact repository](https://github.com/safarov399/sigma-contacts/blob/master/data/src/main/java/me/safarov399/data/repo/ContactRepository.kt): `data/src/main/java/me/safarov399/data/repo/ContactRepository.kt`
- [Label repository](https://github.com/safarov399/sigma-contacts/blob/master/data/src/main/java/me/safarov399/data/repo/LabelRepository.kt): `data/src/main/java/me/safarov399/data/repo/LabelRepository.kt`
- [Location repository](https://github.com/safarov399/sigma-contacts/blob/master/data/src/main/java/me/safarov399/data/repo/SaveLocationRepository.kt): `data/src/main/java/me/safarov399/data/repo/SaveLocationRepository.kt`

### Local persistence

- [Room database](https://github.com/safarov399/sigma-contacts/blob/master/data/src/main/java/me/safarov399/data/db/AppDatabase.kt): `data/src/main/java/me/safarov399/data/db/AppDatabase.kt`
- [Contact DAO](https://github.com/safarov399/sigma-contacts/blob/master/data/src/main/java/me/safarov399/data/dao/ContactDao.kt): `data/src/main/java/me/safarov399/data/dao/ContactDao.kt`
- [Label DAO](https://github.com/safarov399/sigma-contacts/blob/master/data/src/main/java/me/safarov399/data/dao/LabelDao.kt): `data/src/main/java/me/safarov399/data/dao/LabelDao.kt`
- [Location DAO](https://github.com/safarov399/sigma-contacts/blob/master/data/src/main/java/me/safarov399/data/dao/SaveLocationDao.kt): `data/src/main/java/me/safarov399/data/dao/SaveLocationDao.kt`

### Shared UI and state

- [MVI fragment base](https://github.com/safarov399/sigma-contacts/blob/master/core/src/main/java/me/safarov399/core/base/BaseFragment.kt): `core/src/main/java/me/safarov399/core/base/BaseFragment.kt`
- [Contact entity](https://github.com/safarov399/sigma-contacts/blob/master/core/src/main/java/me/safarov399/core/entity/ContactEntity.kt): `core/src/main/java/me/safarov399/core/entity/ContactEntity.kt`

### Other components

- **App user**
- **Android contacts provider**

## Connections

- App user → Main activity: opens (evidence: `app/src/main/java/me/safarov399/sigmacontacts/MainActivity.kt`)
- Main activity → Full-screen router: routes to (evidence: `app/src/main/java/me/safarov399/sigmacontacts/MainActivity.kt`)
- Full-screen router → Contact home: hosts
- Full-screen router → Add contact: routes to (evidence: `app/src/main/java/me/safarov399/sigmacontacts/FullScreenActivity.kt`)
- Full-screen router → Contact details: routes to (evidence: `app/src/main/java/me/safarov399/sigmacontacts/FullScreenActivity.kt`)
- Full-screen router → Settings: routes to (evidence: `app/src/main/java/me/safarov399/sigmacontacts/FullScreenActivity.kt`)
- Contact home → Full-screen router: opens details (evidence: `feature/home/src/main/java/me/safarov399/home/HomeFragment.kt`)
- Contact home → Full-screen router: opens add (evidence: `feature/home/src/main/java/me/safarov399/home/HomeFragment.kt`)
- Contact home → Home state logic: posts events (evidence: `feature/home/src/main/java/me/safarov399/home/HomeFragment.kt`)
- Contact home → Saved locations: opens sheet (evidence: `feature/home/src/main/java/me/safarov399/home/HomeFragment.kt`)
- Contact details → MVI fragment base: extends (evidence: `feature/details/src/main/java/me/safarov399/details/DetailsFragment.kt`)
- Contact home → MVI fragment base: extends (evidence: `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 (evidence: `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 (evidence: `data/src/main/java/me/safarov399/data/repo/ContactRepository.kt`)
- Label repository → Label DAO: calls
- Location repository → Location DAO: calls (evidence: `data/src/main/java/me/safarov399/data/repo/SaveLocationRepository.kt`)
- Room database → Contact DAO: provides (evidence: `data/src/main/java/me/safarov399/data/db/AppDatabase.kt`)
- Room database → Label DAO: provides (evidence: `data/src/main/java/me/safarov399/data/db/AppDatabase.kt`)
- Room database → Location DAO: provides (evidence: `data/src/main/java/me/safarov399/data/db/AppDatabase.kt`)
- Contact DAO → Contact entity: stores (evidence: `data/src/main/java/me/safarov399/data/dao/ContactDao.kt`)
- Highlights → Contact home: returns to
- Organize contacts → App user: offers tools
