# portaone/porta-phone-mobile-app architecture

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

- Interactive diagram: https://gitdiagram.com/portaone/porta-phone-mobile-app
- Repository: https://github.com/portaone/porta-phone-mobile-app

## Overview

This repository excerpt is an Android Flutter call-keeping plugin, providing native call lifecycle integration, Telecom and standalone call handling, incoming-call presentation, and signaling-service support. The principal flow is a Flutter/native request into call coordination, through Telecom or standalone execution, with notifications and lifecycle events keeping the user and app informed. The tree also shows settings, permissions, diagnostics, media, and cross-platform plugin implementations. No README was supplied and most source is unsampled, so the graph limits direct edges to relationships visible in excerpts or the source index.

Main entry points: [`callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/incoming_call/IncomingCallService.kt`](https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/incoming_call/IncomingCallService.kt) (Incoming call service), [`callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/core/CallkeepCore.kt`](https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/core/CallkeepCore.kt) (Call state core), [`callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/common/StorageDelegate.kt`](https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/common/StorageDelegate.kt) (Call preferences), [`callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/foreground/ForegroundService.kt`](https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/foreground/ForegroundService.kt) (Foreground bridge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_bridge["Flutter bridge"]
  node_plugin["Callkeep plugin"]
  node_api["Native APIs<br/>[ConnectionsApi.kt]"]
  node_platforms["Other platform plugins"]
end

subgraph group_calls["Call coordination"]
  node_core["Call state core<br/>[CallkeepCore.kt]"]
  node_foreground["Foreground bridge"]
  node_telecom["Telecom connections"]
  node_connection["Connection manager"]
  node_standalone["Standalone calls"]
  node_incoming["Incoming call service"]
end

subgraph group_presentation["Call presentation"]
  node_active["Active call service"]
  node_notifications["Notification manager"]
  node_notifbuilders["Call notification builders"]
end

subgraph group_support["Native support"]
  node_storage[("Call preferences<br/>[StorageDelegate.kt]")]
  node_assets["Asset cache"]
  node_permissions["Permissions"]
  node_diagnostics["Diagnostics and logs<br/>[Log.kt]"]
end

subgraph group_signaling["Signaling service"]
  node_signaling["Signaling service"]
  node_signalingplugin["Signaling plugin"]
  node_restart["Restart worker"]
end

node_flutter(("Flutter app"))

node_flutter -.->|"invokes"| node_plugin
node_plugin -.->|"exposes"| node_api
node_foreground -->|"tracks calls"| node_core
node_foreground -->|"reads settings"| node_storage
node_foreground -->|"coordinates"| node_incoming
node_telecom -->|"uses"| node_connection
node_standalone -->|"tracks calls"| node_core
node_incoming -->|"coordinates"| node_core
node_incoming -->|"builds alerts"| node_notifbuilders
node_incoming -->|"checks access"| node_permissions
node_incoming -->|"reads settings"| node_storage
node_notifications -->|"starts or releases"| node_incoming
node_notifications -->|"starts or stops"| node_active
node_active -->|"dispatches hangup"| node_core
node_assets -.->|"caches configured media"| node_storage
node_diagnostics -->|"reads log path"| node_storage
node_signalingplugin -->|"configures"| node_signaling
node_signaling -->|"queues restart"| node_restart
node_platforms -.->|"platform implementation"| node_flutter

click node_plugin "https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/WebtritCallkeepPlugin.kt"
click node_api "https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/ConnectionsApi.kt"
click node_core "https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/core/CallkeepCore.kt"
click node_foreground "https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/foreground/ForegroundService.kt"
click node_telecom "https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/connection/PhoneConnectionService.kt"
click node_connection "https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/connection/ConnectionManager.kt"
click node_standalone "https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/connection/StandaloneCallService.kt"
click node_incoming "https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/incoming_call/IncomingCallService.kt"
click node_active "https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/active_call/ActiveCallService.kt"
click node_notifications "https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/managers/NotificationManager.kt"
click node_notifbuilders "https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/notifications/IncomingCallNotificationBuilder.kt"
click node_storage "https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/common/StorageDelegate.kt"
click node_assets "https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/common/AssetCacheManager.kt"
click node_permissions "https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/common/PermissionsHelper.kt"
click node_diagnostics "https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/common/Log.kt"
click node_signaling "https://github.com/portaone/porta-phone-mobile-app/blob/master/phone/packages/signaling_service/signaling_service_android/android/src/main/kotlin/com/webtrit/signaling_service/SignalingForegroundService.kt"
click node_signalingplugin "https://github.com/portaone/porta-phone-mobile-app/blob/master/phone/packages/signaling_service/signaling_service_android/android/src/main/kotlin/com/webtrit/signaling_service/WebtritSignalingServicePlugin.kt"
click node_restart "https://github.com/portaone/porta-phone-mobile-app/blob/master/phone/packages/signaling_service/signaling_service_android/android/src/main/kotlin/com/webtrit/signaling_service/SignalingRestartWorker.kt"
click node_platforms "https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_ios/ios/webtrit_callkeep_ios/Sources/webtrit_callkeep_ios/include/webtrit_callkeep_ios/WebtritCallkeepPlugin.h"

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_plugin,node_api,node_platforms toneBlue
class node_core,node_foreground,node_telecom,node_connection,node_standalone,node_incoming toneAmber
class node_active,node_notifications,node_notifbuilders toneMint
class node_storage,node_assets,node_permissions,node_diagnostics toneRose
class node_signaling,node_signalingplugin,node_restart,node_flutter toneIndigo
```

## Components

### Flutter bridge

- [Callkeep plugin](https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/WebtritCallkeepPlugin.kt): `callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/WebtritCallkeepPlugin.kt`
- [Native APIs](https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/ConnectionsApi.kt): `callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/ConnectionsApi.kt`
- [Other platform plugins](https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_ios/ios/webtrit_callkeep_ios/Sources/webtrit_callkeep_ios/include/webtrit_callkeep_ios/WebtritCallkeepPlugin.h): `callkeep/webtrit_callkeep_ios/ios/webtrit_callkeep_ios/Sources/webtrit_callkeep_ios/include/webtrit_callkeep_ios/WebtritCallkeepPlugin.h`

### Call coordination

- [Call state core](https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/core/CallkeepCore.kt): `callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/core/CallkeepCore.kt`
- [Foreground bridge](https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/foreground/ForegroundService.kt): `callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/foreground/ForegroundService.kt`
- [Telecom connections](https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/connection/PhoneConnectionService.kt): `callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/connection/PhoneConnectionService.kt`
- [Connection manager](https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/connection/ConnectionManager.kt): `callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/connection/ConnectionManager.kt`
- [Standalone calls](https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/connection/StandaloneCallService.kt): `callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/connection/StandaloneCallService.kt`
- [Incoming call service](https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/incoming_call/IncomingCallService.kt): `callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/incoming_call/IncomingCallService.kt`

### Call presentation

- [Active call service](https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/active_call/ActiveCallService.kt): `callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/active_call/ActiveCallService.kt`
- [Notification manager](https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/managers/NotificationManager.kt): `callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/managers/NotificationManager.kt`
- [Call notification builders](https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/notifications/IncomingCallNotificationBuilder.kt): `callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/notifications/IncomingCallNotificationBuilder.kt`

### Native support

- [Call preferences](https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/common/StorageDelegate.kt): `callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/common/StorageDelegate.kt`
- [Asset cache](https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/common/AssetCacheManager.kt): `callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/common/AssetCacheManager.kt`
- [Permissions](https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/common/PermissionsHelper.kt): `callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/common/PermissionsHelper.kt`
- [Diagnostics and logs](https://github.com/portaone/porta-phone-mobile-app/blob/master/callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/common/Log.kt): `callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/common/Log.kt`

### Signaling service

- [Signaling service](https://github.com/portaone/porta-phone-mobile-app/blob/master/phone/packages/signaling_service/signaling_service_android/android/src/main/kotlin/com/webtrit/signaling_service/SignalingForegroundService.kt): `phone/packages/signaling_service/signaling_service_android/android/src/main/kotlin/com/webtrit/signaling_service/SignalingForegroundService.kt`
- [Signaling plugin](https://github.com/portaone/porta-phone-mobile-app/blob/master/phone/packages/signaling_service/signaling_service_android/android/src/main/kotlin/com/webtrit/signaling_service/WebtritSignalingServicePlugin.kt): `phone/packages/signaling_service/signaling_service_android/android/src/main/kotlin/com/webtrit/signaling_service/WebtritSignalingServicePlugin.kt`
- [Restart worker](https://github.com/portaone/porta-phone-mobile-app/blob/master/phone/packages/signaling_service/signaling_service_android/android/src/main/kotlin/com/webtrit/signaling_service/SignalingRestartWorker.kt): `phone/packages/signaling_service/signaling_service_android/android/src/main/kotlin/com/webtrit/signaling_service/SignalingRestartWorker.kt`

### Other components

- **Flutter app**

## Connections

- Flutter app → Callkeep plugin: invokes
- Callkeep plugin → Native APIs: exposes
- Foreground bridge → Call state core: tracks calls (evidence: `callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/foreground/ForegroundService.kt`)
- Foreground bridge → Call preferences: reads settings (evidence: `callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/foreground/ForegroundService.kt`)
- Foreground bridge → Incoming call service: coordinates (evidence: `callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/foreground/ForegroundService.kt`)
- Telecom connections → Connection manager: uses (evidence: `callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/connection/PhoneConnectionService.kt`)
- Standalone calls → Call state core: tracks calls (evidence: `callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/connection/StandaloneCallService.kt`)
- Incoming call service → Call state core: coordinates (evidence: `callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/incoming_call/IncomingCallService.kt`)
- Incoming call service → Call notification builders: builds alerts (evidence: `callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/incoming_call/IncomingCallService.kt`)
- Incoming call service → Permissions: checks access (evidence: `callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/incoming_call/IncomingCallService.kt`)
- Incoming call service → Call preferences: reads settings (evidence: `callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/incoming_call/IncomingCallService.kt`)
- Notification manager → Incoming call service: starts or releases (evidence: `callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/managers/NotificationManager.kt`)
- Notification manager → Active call service: starts or stops (evidence: `callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/managers/NotificationManager.kt`)
- Active call service → Call state core: dispatches hangup (evidence: `callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/services/services/active_call/ActiveCallService.kt`)
- Asset cache → Call preferences: caches configured media
- Diagnostics and logs → Call preferences: reads log path (evidence: `callkeep/webtrit_callkeep_android/android/src/main/kotlin/com/webtrit/callkeep/common/Log.kt`)
- Signaling plugin → Signaling service: configures (evidence: `phone/packages/signaling_service/signaling_service_android/android/src/main/kotlin/com/webtrit/signaling_service/SignalingForegroundService.kt`)
- Signaling service → Restart worker: queues restart (evidence: `phone/packages/signaling_service/signaling_service_android/android/src/main/kotlin/com/webtrit/signaling_service/SignalingForegroundService.kt`)
- Other platform plugins → Flutter app: platform implementation
