# aryanpandya0/dingding architecture

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

- Interactive diagram: https://gitdiagram.com/aryanpandya0/dingding
- Repository: https://github.com/aryanpandya0/dingding

## Overview

DingDing is an Android notification sound-rules app: users configure a sound for a person or group in a supported messaging app, and notification handling looks up the matching rule. The UI also supports recent observed identities, contact search, rule management, and sound preview. The sampled sources show rule and observed-identity persistence through Room, plus app-specific identity resolvers. NotificationListener’s implementation and the complete notification-to-playback path were not excerpted, so those links are limited to relationships visible in the source index.

Main entry points: [`app/src/main/java/com/dingding/app/MainActivity.kt`](https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/MainActivity.kt) (App screens), [`app/src/main/java/com/dingding/app/identity/AppIdentityResolverRegistry.kt`](https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/identity/AppIdentityResolverRegistry.kt) (Resolver registry), [`app/src/main/java/com/dingding/app/data/DingDingDatabase.kt`](https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/data/DingDingDatabase.kt) (Room database), [`app/src/main/java/com/dingding/app/identity/AppIdentityResolver.kt`](https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/identity/AppIdentityResolver.kt) (Resolver contract)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Configuration UI"]
  node_main["App screens<br/>[MainActivity.kt]"]
  node_theme["Theme colors<br/>[Color.kt]"]
  node_rulemodel["Sound rule"]
  node_supported["Supported apps<br/>[SupportedApp.kt]"]
end

subgraph group_notify["Notification handling"]
  node_listener["Notification listener"]
  node_notificationdata["Notification data"]
end

subgraph group_identity["Identity resolution"]
  node_registry["Resolver registry"]
  node_resolverinterface["Resolver contract"]
  node_identitymodel["Identity model<br/>[AppIdentity.kt]"]
  node_whatsapp["WhatsApp resolver"]
  node_telegram["Telegram resolver"]
  node_instagram["Instagram resolver"]
  node_discord["Discord resolver"]
  node_observed["Observed identities"]
end

subgraph group_storage["Local persistence"]
  node_rules["Rule repository<br/>[RuleRepository.kt]"]
  node_database[("Room database")]
  node_ruleentity["Rule records<br/>[RuleEntity.kt]"]
  node_observedentity["Observed records<br/>[ObservedEntity.kt]"]
  node_ruledao["Rule DAO<br/>[RuleDao.kt]"]
  node_observeddao["Observed DAO<br/>[ObservedDao.kt]"]
end

node_user(("User"))

node_user -->|"configures"| node_main
node_main -->|"manages rules"| node_rules
node_main -->|"gets resolver"| node_registry
node_main -->|"uses colors"| node_theme
node_main -->|"creates rules"| node_rulemodel
node_main -->|"shows apps"| node_supported
node_listener -->|"gets resolver"| node_registry
node_listener -->|"looks up rules"| node_rules
node_registry -->|"dispatches to"| node_whatsapp
node_registry -->|"dispatches to"| node_telegram
node_registry -->|"dispatches to"| node_instagram
node_registry -->|"dispatches to"| node_discord
node_whatsapp -->|"records identities"| node_observed
node_telegram -->|"records identities"| node_observed
node_whatsapp -->|"implements"| node_resolverinterface
node_telegram -->|"implements"| node_resolverinterface
node_instagram -->|"implements"| node_resolverinterface
node_discord -->|"implements"| node_resolverinterface
node_observed -->|"opens database"| node_database
node_rules -->|"opens database"| node_database
node_database -->|"stores"| node_ruleentity
node_database -->|"stores"| node_observedentity
node_database -->|"provides DAO"| node_ruledao
node_database -->|"provides DAO"| node_observeddao
node_notificationdata -.->|"supplies data"| node_listener
node_identitymodel -->|"uses model"| node_resolverinterface

click node_main "https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/MainActivity.kt"
click node_theme "https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/ui/theme/Color.kt"
click node_rulemodel "https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/NotificationRule.kt"
click node_supported "https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/SupportedApp.kt"
click node_listener "https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/NotificationListener.kt"
click node_notificationdata "https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/NotificationData.kt"
click node_rules "https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/RuleRepository.kt"
click node_registry "https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/identity/AppIdentityResolverRegistry.kt"
click node_resolverinterface "https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/identity/AppIdentityResolver.kt"
click node_identitymodel "https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/identity/AppIdentity.kt"
click node_whatsapp "https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/identity/WhatsAppIdentityResolver.kt"
click node_telegram "https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/identity/TelegramIdentityResolver.kt"
click node_instagram "https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/identity/InstagramIdentityResolver.kt"
click node_discord "https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/identity/DiscordIdentityResolver.kt"
click node_observed "https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/identity/ObservedMetadataRepository.kt"
click node_database "https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/data/DingDingDatabase.kt"
click node_ruleentity "https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/data/RuleEntity.kt"
click node_observedentity "https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/data/ObservedEntity.kt"
click node_ruledao "https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/data/RuleDao.kt"
click node_observeddao "https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/data/ObservedDao.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_theme,node_rulemodel,node_supported,node_user toneBlue
class node_listener,node_notificationdata toneAmber
class node_registry,node_resolverinterface,node_identitymodel,node_whatsapp,node_telegram,node_instagram,node_discord,node_observed toneMint
class node_rules,node_database,node_ruleentity,node_observedentity,node_ruledao,node_observeddao toneRose
```

## Components

### Configuration UI

- [App screens](https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/MainActivity.kt): `app/src/main/java/com/dingding/app/MainActivity.kt`
- [Theme colors](https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/ui/theme/Color.kt): `app/src/main/java/com/dingding/app/ui/theme/Color.kt`
- [Sound rule](https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/NotificationRule.kt): `app/src/main/java/com/dingding/app/NotificationRule.kt`
- [Supported apps](https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/SupportedApp.kt): `app/src/main/java/com/dingding/app/SupportedApp.kt`

### Notification handling

- [Notification listener](https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/NotificationListener.kt): `app/src/main/java/com/dingding/app/NotificationListener.kt`
- [Notification data](https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/NotificationData.kt): `app/src/main/java/com/dingding/app/NotificationData.kt`

### Identity resolution

- [Resolver registry](https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/identity/AppIdentityResolverRegistry.kt): `app/src/main/java/com/dingding/app/identity/AppIdentityResolverRegistry.kt`
- [Resolver contract](https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/identity/AppIdentityResolver.kt): `app/src/main/java/com/dingding/app/identity/AppIdentityResolver.kt`
- [Identity model](https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/identity/AppIdentity.kt): `app/src/main/java/com/dingding/app/identity/AppIdentity.kt`
- [WhatsApp resolver](https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/identity/WhatsAppIdentityResolver.kt): `app/src/main/java/com/dingding/app/identity/WhatsAppIdentityResolver.kt`
- [Telegram resolver](https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/identity/TelegramIdentityResolver.kt): `app/src/main/java/com/dingding/app/identity/TelegramIdentityResolver.kt`
- [Instagram resolver](https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/identity/InstagramIdentityResolver.kt): `app/src/main/java/com/dingding/app/identity/InstagramIdentityResolver.kt`
- [Discord resolver](https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/identity/DiscordIdentityResolver.kt): `app/src/main/java/com/dingding/app/identity/DiscordIdentityResolver.kt`
- [Observed identities](https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/identity/ObservedMetadataRepository.kt): `app/src/main/java/com/dingding/app/identity/ObservedMetadataRepository.kt`

### Local persistence

- [Rule repository](https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/RuleRepository.kt): `app/src/main/java/com/dingding/app/RuleRepository.kt`
- [Room database](https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/data/DingDingDatabase.kt): `app/src/main/java/com/dingding/app/data/DingDingDatabase.kt`
- [Rule records](https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/data/RuleEntity.kt): `app/src/main/java/com/dingding/app/data/RuleEntity.kt`
- [Observed records](https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/data/ObservedEntity.kt): `app/src/main/java/com/dingding/app/data/ObservedEntity.kt`
- [Rule DAO](https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/data/RuleDao.kt): `app/src/main/java/com/dingding/app/data/RuleDao.kt`
- [Observed DAO](https://github.com/aryanpandya0/dingding/blob/main/app/src/main/java/com/dingding/app/data/ObservedDao.kt): `app/src/main/java/com/dingding/app/data/ObservedDao.kt`

### Other components

- **User**

## Connections

- User → App screens: configures (evidence: `app/src/main/java/com/dingding/app/MainActivity.kt`)
- App screens → Rule repository: manages rules (evidence: `app/src/main/java/com/dingding/app/MainActivity.kt`)
- App screens → Resolver registry: gets resolver (evidence: `app/src/main/java/com/dingding/app/MainActivity.kt`)
- App screens → Theme colors: uses colors (evidence: `app/src/main/java/com/dingding/app/MainActivity.kt`)
- App screens → Sound rule: creates rules (evidence: `app/src/main/java/com/dingding/app/MainActivity.kt`)
- App screens → Supported apps: shows apps (evidence: `app/src/main/java/com/dingding/app/MainActivity.kt`)
- Notification listener → Resolver registry: gets resolver (evidence: `app/src/main/java/com/dingding/app/NotificationListener.kt`)
- Notification listener → Rule repository: looks up rules (evidence: `app/src/main/java/com/dingding/app/NotificationListener.kt`)
- Resolver registry → WhatsApp resolver: dispatches to (evidence: `app/src/main/java/com/dingding/app/identity/AppIdentityResolverRegistry.kt`)
- Resolver registry → Telegram resolver: dispatches to (evidence: `app/src/main/java/com/dingding/app/identity/AppIdentityResolverRegistry.kt`)
- Resolver registry → Instagram resolver: dispatches to (evidence: `app/src/main/java/com/dingding/app/identity/AppIdentityResolverRegistry.kt`)
- Resolver registry → Discord resolver: dispatches to (evidence: `app/src/main/java/com/dingding/app/identity/AppIdentityResolverRegistry.kt`)
- WhatsApp resolver → Observed identities: records identities (evidence: `app/src/main/java/com/dingding/app/identity/WhatsAppIdentityResolver.kt`)
- Telegram resolver → Observed identities: records identities (evidence: `app/src/main/java/com/dingding/app/identity/TelegramIdentityResolver.kt`)
- WhatsApp resolver → Resolver contract: implements (evidence: `app/src/main/java/com/dingding/app/identity/WhatsAppIdentityResolver.kt`)
- Telegram resolver → Resolver contract: implements (evidence: `app/src/main/java/com/dingding/app/identity/TelegramIdentityResolver.kt`)
- Instagram resolver → Resolver contract: implements (evidence: `app/src/main/java/com/dingding/app/identity/InstagramIdentityResolver.kt`)
- Discord resolver → Resolver contract: implements (evidence: `app/src/main/java/com/dingding/app/identity/DiscordIdentityResolver.kt`)
- Observed identities → Room database: opens database (evidence: `app/src/main/java/com/dingding/app/identity/ObservedMetadataRepository.kt`)
- Rule repository → Room database: opens database (evidence: `app/src/main/java/com/dingding/app/RuleRepository.kt`)
- Room database → Rule records: stores (evidence: `app/src/main/java/com/dingding/app/data/DingDingDatabase.kt`)
- Room database → Observed records: stores (evidence: `app/src/main/java/com/dingding/app/data/DingDingDatabase.kt`)
- Room database → Rule DAO: provides DAO (evidence: `app/src/main/java/com/dingding/app/data/DingDingDatabase.kt`)
- Room database → Observed DAO: provides DAO (evidence: `app/src/main/java/com/dingding/app/data/DingDingDatabase.kt`)
- Notification data → Notification listener: supplies data
- Identity model → Resolver contract: uses model (evidence: `app/src/main/java/com/dingding/app/identity/AppIdentityResolver.kt`)
