# adelchipelizzo/secretaryapp architecture

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

- Interactive diagram: https://gitdiagram.com/adelchipelizzo/secretaryapp
- Repository: https://github.com/adelchipelizzo/secretaryapp

## Overview

Secretary appears to be an Android call-screening and call-management app, with call handling, a user interface, and local/remote data components. The principal workflow is likely an incoming call being screened and presented for user action; the tree also shows call detection and in-call handling. The supplied source excerpts contain no app code and the README is empty, so these stages and their connections are inferred from filenames. Dashed edges mark those unverified relationships rather than asserted calls.

Main entry points: [`app/src/main/java/com/adelforce/secretary/data/SecretaryRepository.kt`](https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/data/SecretaryRepository.kt) (Secretary repository), [`app/src/main/java/com/adelforce/secretary/data/SecretaryDao.kt`](https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/data/SecretaryDao.kt) (Database access), [`app/src/main/java/com/adelforce/secretary/service/SecretaryCallScreeningService.kt`](https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/service/SecretaryCallScreeningService.kt) (Call screening), [`app/src/main/java/com/adelforce/secretary/service/CallManager.kt`](https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/service/CallManager.kt) (Call manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_call["Call handling"]
  node_screening["Call screening"]
  node_detection["Call detection"]
  node_manager["Call manager<br/>[CallManager.kt]"]
  node_incall["In-call service"]
  node_actions["Call actions"]
end

subgraph group_ui["User interface"]
  node_incoming_ui["Incoming call UI"]
  node_main_ui["Main screen<br/>[MainActivity.kt]"]
  node_splash["Splash screen<br/>[SplashActivity.kt]"]
end

subgraph group_data["Data access"]
  node_repository["Secretary repository"]
  node_api["API contract<br/>[SecretaryApi.kt]"]
  node_api_service["API service"]
  node_dao["Database access<br/>[SecretaryDao.kt]"]
  node_database[("Local database")]
  node_entities["Stored entities"]
end

subgraph group_support["Call support"]
  node_context["Call context<br/>[CallContext.kt]"]
  node_defaults["Default data"]
  node_notifications["Notifications"]
  node_telephony_utils["Telephony utilities<br/>[TelephonyUtils.kt]"]
end

node_android(("Android telephony"))

node_android -.->|"dispatches"| node_screening
node_screening -.->|"handles call"| node_manager
node_android -.->|"dispatches"| node_detection
node_manager -.->|"presents call"| node_incoming_ui
node_incoming_ui -.->|"submits action"| node_actions
node_android -.->|"dispatches"| node_incall
node_main_ui -.->|"loads data"| node_repository
node_repository -.->|"requests data"| node_api_service
node_api_service -.->|"implements contract"| node_api
node_repository -.->|"accesses data"| node_dao
node_dao -.->|"queries"| node_database
node_dao -.->|"uses records"| node_entities

click node_screening "https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/service/SecretaryCallScreeningService.kt"
click node_detection "https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/service/CallDetectionService.kt"
click node_manager "https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/service/CallManager.kt"
click node_incall "https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/service/SecretaryInCallService.kt"
click node_actions "https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/service/SecretaryActionReceiver.kt"
click node_incoming_ui "https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/ui/IncomingCallActivity.kt"
click node_main_ui "https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/ui/main/MainActivity.kt"
click node_splash "https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/ui/SplashActivity.kt"
click node_repository "https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/data/SecretaryRepository.kt"
click node_api "https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/data/SecretaryApi.kt"
click node_api_service "https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/data/SecretaryApiServiceImpl.kt"
click node_dao "https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/data/SecretaryDao.kt"
click node_database "https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/data/SecretaryDatabase.kt"
click node_entities "https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/data/SecretaryEntities.kt"
click node_context "https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/core/CallContext.kt"
click node_defaults "https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/util/DefaultDataProvider.kt"
click node_notifications "https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/util/NotificationHelper.kt"
click node_telephony_utils "https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/util/TelephonyUtils.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_screening,node_detection,node_manager,node_incall,node_actions toneBlue
class node_incoming_ui,node_main_ui,node_splash toneAmber
class node_repository,node_api,node_api_service,node_dao,node_database,node_entities toneMint
class node_context,node_defaults,node_notifications,node_telephony_utils toneRose
class node_android toneIndigo
```

## Components

### Call handling

- [Call screening](https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/service/SecretaryCallScreeningService.kt): `app/src/main/java/com/adelforce/secretary/service/SecretaryCallScreeningService.kt`
- [Call detection](https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/service/CallDetectionService.kt): `app/src/main/java/com/adelforce/secretary/service/CallDetectionService.kt`
- [Call manager](https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/service/CallManager.kt): `app/src/main/java/com/adelforce/secretary/service/CallManager.kt`
- [In-call service](https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/service/SecretaryInCallService.kt): `app/src/main/java/com/adelforce/secretary/service/SecretaryInCallService.kt`
- [Call actions](https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/service/SecretaryActionReceiver.kt): `app/src/main/java/com/adelforce/secretary/service/SecretaryActionReceiver.kt`

### User interface

- [Incoming call UI](https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/ui/IncomingCallActivity.kt): `app/src/main/java/com/adelforce/secretary/ui/IncomingCallActivity.kt`
- [Main screen](https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/ui/main/MainActivity.kt): `app/src/main/java/com/adelforce/secretary/ui/main/MainActivity.kt`
- [Splash screen](https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/ui/SplashActivity.kt): `app/src/main/java/com/adelforce/secretary/ui/SplashActivity.kt`

### Data access

- [Secretary repository](https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/data/SecretaryRepository.kt): `app/src/main/java/com/adelforce/secretary/data/SecretaryRepository.kt`
- [API contract](https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/data/SecretaryApi.kt): `app/src/main/java/com/adelforce/secretary/data/SecretaryApi.kt`
- [API service](https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/data/SecretaryApiServiceImpl.kt): `app/src/main/java/com/adelforce/secretary/data/SecretaryApiServiceImpl.kt`
- [Database access](https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/data/SecretaryDao.kt): `app/src/main/java/com/adelforce/secretary/data/SecretaryDao.kt`
- [Local database](https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/data/SecretaryDatabase.kt): `app/src/main/java/com/adelforce/secretary/data/SecretaryDatabase.kt`
- [Stored entities](https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/data/SecretaryEntities.kt): `app/src/main/java/com/adelforce/secretary/data/SecretaryEntities.kt`

### Call support

- [Call context](https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/core/CallContext.kt): `app/src/main/java/com/adelforce/secretary/core/CallContext.kt`
- [Default data](https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/util/DefaultDataProvider.kt): `app/src/main/java/com/adelforce/secretary/util/DefaultDataProvider.kt`
- [Notifications](https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/util/NotificationHelper.kt): `app/src/main/java/com/adelforce/secretary/util/NotificationHelper.kt`
- [Telephony utilities](https://github.com/adelchipelizzo/secretaryapp/blob/master/app/src/main/java/com/adelforce/secretary/util/TelephonyUtils.kt): `app/src/main/java/com/adelforce/secretary/util/TelephonyUtils.kt`

### Other components

- **Android telephony**

## Connections

- Android telephony → Call screening: dispatches
- Call screening → Call manager: handles call
- Android telephony → Call detection: dispatches
- Call manager → Incoming call UI: presents call
- Incoming call UI → Call actions: submits action
- Android telephony → In-call service: dispatches
- Main screen → Secretary repository: loads data
- Secretary repository → API service: requests data
- API service → API contract: implements contract
- Secretary repository → Database access: accesses data
- Database access → Local database: queries
- Database access → Stored entities: uses records
