# iamr0s/androidaccounts architecture

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

- Interactive diagram: https://gitdiagram.com/iamr0s/androidaccounts
- Repository: https://github.com/iamr0s/androidaccounts

## Overview

This Android app manages Android users and their accounts through a Compose interface. Users load a user list, can remove a non-current user, and open a selected user’s account view; the view models poll the service and publish state to the UI. The service uses Shizuku-backed Android system interfaces to retrieve users, account authenticators, and accounts. The source excerpts establish these main interactions; additional wiring is represented only where the source index names the relationship.

Main entry points: [`app/src/main/java/com/rosan/accounts/data/service/model/ShizukuUserService.kt`](https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/data/service/model/ShizukuUserService.kt) (Shizuku service), [`app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerPage.kt`](https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerPage.kt) (User manager), [`app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerPage.kt`](https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerPage.kt) (Account manager), [`app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerViewModel.kt`](https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerViewModel.kt) (User view model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["Compose interface"]
  node_user["User manager<br/>[UserManagerPage.kt]"]
  node_account["Account manager"]
  node_main["Main navigation<br/>[MainPage.kt]"]
  node_activity["Main activity<br/>[MainActivity.kt]"]
end

subgraph group_state["UI state"]
  node_user_vm["User view model"]
  node_user_action["User actions"]
  node_user_state["User state"]
  node_account_vm["Account view model"]
  node_account_action["Account actions"]
  node_account_state["Account state"]
end

subgraph group_service["Service access"]
  node_userservice["User service contract<br/>[UserService.kt]"]
  node_shizuku_service["Shizuku service"]
  node_user_entity["User entity<br/>[UserEntity.kt]"]
  node_account_entity["Account entity<br/>[AccountEntity.kt]"]
  node_auth_entity["Authenticator entity"]
  node_shizuku_util["Shizuku binder utilities<br/>[ShizukuUtil.kt]"]
end

subgraph group_platform["Android interfaces"]
  node_android_users["User manager API<br/>[IUserManager.java]"]
  node_android_accounts["Account manager API"]
  node_android_packages["Package manager APIs"]
  node_android_userinfo["User information<br/>[UserInfo.java]"]
  node_android_service_manager["Service manager"]
end

node_operator(("App user"))
node_android_system[("Android system services")]
node_shizuku["Shizuku"]

node_operator -.->|"opens app"| node_activity
node_activity -->|"shows navigation"| node_main
node_main -->|"routes to"| node_user
node_main -->|"routes to"| node_account
node_user -->|"dispatches actions"| node_user_vm
node_user -->|"creates actions"| node_user_action
node_user_vm -->|"handles actions"| node_user_action
node_user_vm -->|"updates state"| node_user_state
node_user -.->|"renders state"| node_user_state
node_account -->|"dispatches actions"| node_account_vm
node_account -->|"creates actions"| node_account_action
node_account_vm -->|"handles actions"| node_account_action
node_account_vm -->|"updates state"| node_account_state
node_account -.->|"renders state"| node_account_state
node_user_vm -->|"loads and removes"| node_userservice
node_account_vm -->|"loads account data"| node_userservice
node_shizuku_service -->|"implements"| node_userservice
node_shizuku_service -->|"maps users"| node_user_entity
node_shizuku_service -->|"maps accounts"| node_account_entity
node_shizuku_service -->|"maps authenticators"| node_auth_entity
node_shizuku_service -->|"calls user APIs"| node_android_users
node_shizuku_service -->|"calls account APIs"| node_android_accounts
node_shizuku_service -->|"looks up packages"| node_android_packages
node_android_users -->|"returns user records"| node_android_userinfo
node_shizuku_service -->|"gets service binders"| node_shizuku_util
node_shizuku_util -->|"retrieves binders"| node_android_service_manager
node_shizuku_util -->|"checks permissions"| node_shizuku
node_android_users -.->|"accesses system service"| node_android_system
node_android_accounts -.->|"accesses system service"| node_android_system
node_android_packages -.->|"accesses system service"| node_android_system

click node_user "https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerPage.kt"
click node_account "https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerPage.kt"
click node_main "https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/main/MainPage.kt"
click node_activity "https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/activity/MainActivity.kt"
click node_user_vm "https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerViewModel.kt"
click node_user_action "https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerViewAction.kt"
click node_user_state "https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerViewState.kt"
click node_account_vm "https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerViewModel.kt"
click node_account_action "https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerViewAction.kt"
click node_account_state "https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerViewState.kt"
click node_userservice "https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/data/service/repo/UserService.kt"
click node_shizuku_service "https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/data/service/model/ShizukuUserService.kt"
click node_user_entity "https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/data/service/entity/UserEntity.kt"
click node_account_entity "https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/data/service/entity/AccountEntity.kt"
click node_auth_entity "https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/data/service/entity/AccountAuthenticatorEntity.kt"
click node_shizuku_util "https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/data/common/utils/ShizukuUtil.kt"
click node_android_users "https://github.com/iamr0s/androidaccounts/blob/main/hidden-api/src/main/java/android/os/IUserManager.java"
click node_android_accounts "https://github.com/iamr0s/androidaccounts/blob/main/hidden-api/src/main/java/android/accounts/IAccountManager.java"
click node_android_packages "https://github.com/iamr0s/androidaccounts/blob/main/hidden-api/src/main/java/android/content/pm/IPackageManager.java"
click node_android_userinfo "https://github.com/iamr0s/androidaccounts/blob/main/hidden-api/src/main/java/android/content/pm/UserInfo.java"
click node_android_service_manager "https://github.com/iamr0s/androidaccounts/blob/main/hidden-api/src/main/java/android/os/ServiceManager.java"

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_user,node_account,node_main,node_activity,node_operator toneBlue
class node_user_vm,node_user_action,node_user_state,node_account_vm,node_account_action,node_account_state,node_android_system toneAmber
class node_userservice,node_shizuku_service,node_user_entity,node_account_entity,node_auth_entity,node_shizuku_util toneMint
class node_android_users,node_android_accounts,node_android_packages,node_android_userinfo,node_android_service_manager toneRose
class node_shizuku toneIndigo
```

## Components

### Compose interface

- [User manager](https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerPage.kt): `app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerPage.kt`
- [Account manager](https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerPage.kt): `app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerPage.kt`
- [Main navigation](https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/main/MainPage.kt): `app/src/main/java/com/rosan/accounts/ui/page/main/MainPage.kt`
- [Main activity](https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/activity/MainActivity.kt): `app/src/main/java/com/rosan/accounts/ui/activity/MainActivity.kt`

### UI state

- [User view model](https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerViewModel.kt): `app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerViewModel.kt`
- [User actions](https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerViewAction.kt): `app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerViewAction.kt`
- [User state](https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerViewState.kt): `app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerViewState.kt`
- [Account view model](https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerViewModel.kt): `app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerViewModel.kt`
- [Account actions](https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerViewAction.kt): `app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerViewAction.kt`
- [Account state](https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerViewState.kt): `app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerViewState.kt`

### Service access

- [User service contract](https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/data/service/repo/UserService.kt): `app/src/main/java/com/rosan/accounts/data/service/repo/UserService.kt`
- [Shizuku service](https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/data/service/model/ShizukuUserService.kt): `app/src/main/java/com/rosan/accounts/data/service/model/ShizukuUserService.kt`
- [User entity](https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/data/service/entity/UserEntity.kt): `app/src/main/java/com/rosan/accounts/data/service/entity/UserEntity.kt`
- [Account entity](https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/data/service/entity/AccountEntity.kt): `app/src/main/java/com/rosan/accounts/data/service/entity/AccountEntity.kt`
- [Authenticator entity](https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/data/service/entity/AccountAuthenticatorEntity.kt): `app/src/main/java/com/rosan/accounts/data/service/entity/AccountAuthenticatorEntity.kt`
- [Shizuku binder utilities](https://github.com/iamr0s/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/data/common/utils/ShizukuUtil.kt): `app/src/main/java/com/rosan/accounts/data/common/utils/ShizukuUtil.kt`

### Android interfaces

- [User manager API](https://github.com/iamr0s/androidaccounts/blob/main/hidden-api/src/main/java/android/os/IUserManager.java): `hidden-api/src/main/java/android/os/IUserManager.java`
- [Account manager API](https://github.com/iamr0s/androidaccounts/blob/main/hidden-api/src/main/java/android/accounts/IAccountManager.java): `hidden-api/src/main/java/android/accounts/IAccountManager.java`
- [Package manager APIs](https://github.com/iamr0s/androidaccounts/blob/main/hidden-api/src/main/java/android/content/pm/IPackageManager.java): `hidden-api/src/main/java/android/content/pm/IPackageManager.java`
- [User information](https://github.com/iamr0s/androidaccounts/blob/main/hidden-api/src/main/java/android/content/pm/UserInfo.java): `hidden-api/src/main/java/android/content/pm/UserInfo.java`
- [Service manager](https://github.com/iamr0s/androidaccounts/blob/main/hidden-api/src/main/java/android/os/ServiceManager.java): `hidden-api/src/main/java/android/os/ServiceManager.java`

### Other components

- **App user**
- **Android system services**
- **Shizuku**

## Connections

- App user → Main activity: opens app
- Main activity → Main navigation: shows navigation (evidence: `app/src/main/java/com/rosan/accounts/ui/activity/MainActivity.kt`)
- Main navigation → User manager: routes to (evidence: `app/src/main/java/com/rosan/accounts/ui/page/main/MainPage.kt`)
- Main navigation → Account manager: routes to (evidence: `app/src/main/java/com/rosan/accounts/ui/page/main/MainPage.kt`)
- User manager → User view model: dispatches actions (evidence: `app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerPage.kt`)
- User manager → User actions: creates actions (evidence: `app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerPage.kt`)
- User view model → User actions: handles actions (evidence: `app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerViewModel.kt`)
- User view model → User state: updates state (evidence: `app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerViewModel.kt`)
- User manager → User state: renders state
- Account manager → Account view model: dispatches actions (evidence: `app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerPage.kt`)
- Account manager → Account actions: creates actions (evidence: `app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerPage.kt`)
- Account view model → Account actions: handles actions (evidence: `app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerViewModel.kt`)
- Account view model → Account state: updates state (evidence: `app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerViewModel.kt`)
- Account manager → Account state: renders state (evidence: `app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerPage.kt`)
- User view model → User service contract: loads and removes (evidence: `app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerViewModel.kt`)
- Account view model → User service contract: loads account data (evidence: `app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerViewModel.kt`)
- Shizuku service → User service contract: implements (evidence: `app/src/main/java/com/rosan/accounts/data/service/model/ShizukuUserService.kt`)
- Shizuku service → User entity: maps users (evidence: `app/src/main/java/com/rosan/accounts/data/service/model/ShizukuUserService.kt`)
- Shizuku service → Account entity: maps accounts (evidence: `app/src/main/java/com/rosan/accounts/data/service/model/ShizukuUserService.kt`)
- Shizuku service → Authenticator entity: maps authenticators (evidence: `app/src/main/java/com/rosan/accounts/data/service/model/ShizukuUserService.kt`)
- Shizuku service → User manager API: calls user APIs (evidence: `app/src/main/java/com/rosan/accounts/data/service/model/ShizukuUserService.kt`)
- Shizuku service → Account manager API: calls account APIs (evidence: `app/src/main/java/com/rosan/accounts/data/service/model/ShizukuUserService.kt`)
- Shizuku service → Package manager APIs: looks up packages (evidence: `app/src/main/java/com/rosan/accounts/data/service/model/ShizukuUserService.kt`)
- User manager API → User information: returns user records (evidence: `hidden-api/src/main/java/android/os/IUserManager.java`)
- Shizuku service → Shizuku binder utilities: gets service binders (evidence: `app/src/main/java/com/rosan/accounts/data/service/model/ShizukuUserService.kt`)
- Shizuku binder utilities → Service manager: retrieves binders (evidence: `app/src/main/java/com/rosan/accounts/data/common/utils/ShizukuUtil.kt`)
- Shizuku binder utilities → Shizuku: checks permissions (evidence: `app/src/main/java/com/rosan/accounts/data/common/utils/ShizukuUtil.kt`)
- User manager API → Android system services: accesses system service
- Account manager API → Android system services: accesses system service
- Package manager APIs → Android system services: accesses system service
