# oopnv70-lab/androidaccounts architecture

> Architecture diagram of the GitHub repository oopnv70-lab/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/oopnv70-lab/androidaccounts
- Repository: https://github.com/oopnv70-lab/androidaccounts

## Overview

AndroidAccounts is a Shizuku-backed Android app for managing multi-user spaces and inspecting accounts and account authenticators within them. The user opens the user list, can request removal of another user, or navigates to that user’s account view; view models poll the service and expose results to Compose pages. The service uses privileged Android Binder APIs and maps their results into app entities. README documents the Shizuku/Sui and hidden-API-bypass dependencies; sampled code shows the Binder service and compatibility fallback, but not every integration detail.

Main entry points: [`app/src/main/java/com/rosan/accounts/data/service/model/ShizukuUserService.kt`](https://github.com/oopnv70-lab/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/oopnv70-lab/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerPage.kt) (User list page), [`app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerViewModel.kt`](https://github.com/oopnv70-lab/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerViewModel.kt) (User workflow), [`app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerPage.kt`](https://github.com/oopnv70-lab/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerPage.kt) (Account page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Compose application"]
  node_activity["Main activity<br/>[MainActivity.kt]"]
  node_mainpage["Main navigation<br/>[MainPage.kt]"]
  node_mainscreen["Screen routes<br/>[MainScreen.kt]"]
end

subgraph group_flows["Management workflows"]
  node_userpage["User list page<br/>[UserManagerPage.kt]"]
  node_uservm["User workflow"]
  node_useraction["User actions"]
  node_userstate["User state"]
  node_accountpage["Account page"]
  node_accountvm["Account workflow"]
  node_accountaction["Account actions"]
  node_accountstate["Account state"]
end

subgraph group_service["Service access"]
  node_repo["User service contract<br/>[UserService.kt]"]
  node_binder["Shizuku service"]
  node_usermanagercompat["User API fallback"]
  node_userentity["User entity<br/>[UserEntity.kt]"]
  node_accountentity["Account entity<br/>[AccountEntity.kt]"]
  node_authentity["Authenticator entity"]
end

subgraph group_api["Android hidden APIs"]
  node_iuser["IUserManager stub<br/>[IUserManager.java]"]
  node_iaccount["IAccountManager stub"]
  node_ipackage["IPackageManager stub"]
  node_userinfo["UserInfo stub<br/>[UserInfo.java]"]
end

node_user(("App user"))
node_shizuku["Shizuku / Sui"]

node_user -.->|"opens"| node_activity
node_activity -->|"shows"| node_mainpage
node_mainpage -->|"uses routes"| node_mainscreen
node_mainpage -->|"shows"| node_userpage
node_mainpage -->|"shows"| node_accountpage
node_userpage -->|"dispatches"| node_uservm
node_userpage -->|"dispatches"| node_useraction
node_uservm -->|"handles"| node_useraction
node_uservm -->|"updates"| node_userstate
node_userpage -->|"renders"| node_userstate
node_userpage -->|"navigates"| node_accountpage
node_accountpage -->|"dispatches"| node_accountvm
node_accountpage -->|"dispatches"| node_accountaction
node_accountvm -->|"handles"| node_accountaction
node_accountvm -->|"updates"| node_accountstate
node_accountpage -->|"renders"| node_accountstate
node_uservm -->|"requests users"| node_repo
node_uservm -->|"requests removal"| node_repo
node_accountvm -->|"loads accounts"| node_repo
node_binder -->|"implements"| node_repo
node_binder -->|"uses Binder access"| node_shizuku
node_binder -->|"calls"| node_iuser
node_binder -->|"calls"| node_iaccount
node_binder -->|"calls"| node_ipackage
node_binder -->|"uses fallback"| node_usermanagercompat
node_usermanagercompat -->|"tries signatures"| node_iuser
node_iuser -->|"returns users"| node_userinfo
node_binder -->|"maps users"| node_userentity
node_binder -->|"maps accounts"| node_accountentity
node_binder -->|"maps authenticators"| node_authentity

click node_activity "https://github.com/oopnv70-lab/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/activity/MainActivity.kt"
click node_mainpage "https://github.com/oopnv70-lab/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/main/MainPage.kt"
click node_mainscreen "https://github.com/oopnv70-lab/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/main/MainScreen.kt"
click node_userpage "https://github.com/oopnv70-lab/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerPage.kt"
click node_uservm "https://github.com/oopnv70-lab/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerViewModel.kt"
click node_useraction "https://github.com/oopnv70-lab/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerViewAction.kt"
click node_userstate "https://github.com/oopnv70-lab/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerViewState.kt"
click node_accountpage "https://github.com/oopnv70-lab/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerPage.kt"
click node_accountvm "https://github.com/oopnv70-lab/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerViewModel.kt"
click node_accountaction "https://github.com/oopnv70-lab/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerViewAction.kt"
click node_accountstate "https://github.com/oopnv70-lab/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerViewState.kt"
click node_repo "https://github.com/oopnv70-lab/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/data/service/repo/UserService.kt"
click node_binder "https://github.com/oopnv70-lab/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/data/service/model/ShizukuUserService.kt"
click node_usermanagercompat "https://github.com/oopnv70-lab/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/data/common/utils/UserManagerCompat.kt"
click node_userentity "https://github.com/oopnv70-lab/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/data/service/entity/UserEntity.kt"
click node_accountentity "https://github.com/oopnv70-lab/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/data/service/entity/AccountEntity.kt"
click node_authentity "https://github.com/oopnv70-lab/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/data/service/entity/AccountAuthenticatorEntity.kt"
click node_iuser "https://github.com/oopnv70-lab/androidaccounts/blob/main/hidden-api/src/main/java/android/os/IUserManager.java"
click node_iaccount "https://github.com/oopnv70-lab/androidaccounts/blob/main/hidden-api/src/main/java/android/accounts/IAccountManager.java"
click node_ipackage "https://github.com/oopnv70-lab/androidaccounts/blob/main/hidden-api/src/main/java/android/content/pm/IPackageManager.java"
click node_userinfo "https://github.com/oopnv70-lab/androidaccounts/blob/main/hidden-api/src/main/java/android/content/pm/UserInfo.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_activity,node_mainpage,node_mainscreen,node_user,node_shizuku toneBlue
class node_userpage,node_uservm,node_useraction,node_userstate,node_accountpage,node_accountvm,node_accountaction,node_accountstate toneAmber
class node_repo,node_binder,node_usermanagercompat,node_userentity,node_accountentity,node_authentity toneMint
class node_iuser,node_iaccount,node_ipackage,node_userinfo toneRose
```

## Components

### Compose application

- [Main activity](https://github.com/oopnv70-lab/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`
- [Main navigation](https://github.com/oopnv70-lab/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`
- [Screen routes](https://github.com/oopnv70-lab/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/ui/page/main/MainScreen.kt): `app/src/main/java/com/rosan/accounts/ui/page/main/MainScreen.kt`

### Management workflows

- [User list page](https://github.com/oopnv70-lab/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`
- [User workflow](https://github.com/oopnv70-lab/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/oopnv70-lab/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/oopnv70-lab/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 page](https://github.com/oopnv70-lab/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`
- [Account workflow](https://github.com/oopnv70-lab/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/oopnv70-lab/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/oopnv70-lab/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/oopnv70-lab/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/oopnv70-lab/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 API fallback](https://github.com/oopnv70-lab/androidaccounts/blob/main/app/src/main/java/com/rosan/accounts/data/common/utils/UserManagerCompat.kt): `app/src/main/java/com/rosan/accounts/data/common/utils/UserManagerCompat.kt`
- [User entity](https://github.com/oopnv70-lab/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/oopnv70-lab/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/oopnv70-lab/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`

### Android hidden APIs

- [IUserManager stub](https://github.com/oopnv70-lab/androidaccounts/blob/main/hidden-api/src/main/java/android/os/IUserManager.java): `hidden-api/src/main/java/android/os/IUserManager.java`
- [IAccountManager stub](https://github.com/oopnv70-lab/androidaccounts/blob/main/hidden-api/src/main/java/android/accounts/IAccountManager.java): `hidden-api/src/main/java/android/accounts/IAccountManager.java`
- [IPackageManager stub](https://github.com/oopnv70-lab/androidaccounts/blob/main/hidden-api/src/main/java/android/content/pm/IPackageManager.java): `hidden-api/src/main/java/android/content/pm/IPackageManager.java`
- [UserInfo stub](https://github.com/oopnv70-lab/androidaccounts/blob/main/hidden-api/src/main/java/android/content/pm/UserInfo.java): `hidden-api/src/main/java/android/content/pm/UserInfo.java`

### Other components

- **App user**
- **Shizuku / Sui**

## Connections

- App user → Main activity: opens
- Main activity → Main navigation: shows (evidence: `app/src/main/java/com/rosan/accounts/ui/activity/MainActivity.kt`)
- Main navigation → Screen routes: uses routes (evidence: `app/src/main/java/com/rosan/accounts/ui/page/main/MainPage.kt`)
- Main navigation → User list page: shows (evidence: `app/src/main/java/com/rosan/accounts/ui/page/main/MainPage.kt`)
- Main navigation → Account page: shows (evidence: `app/src/main/java/com/rosan/accounts/ui/page/main/MainPage.kt`)
- User list page → User workflow: dispatches (evidence: `app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerPage.kt`)
- User list page → User actions: dispatches (evidence: `app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerPage.kt`)
- User workflow → User actions: handles (evidence: `app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerViewModel.kt`)
- User workflow → User state: updates (evidence: `app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerViewModel.kt`)
- User list page → User state: renders (evidence: `app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerPage.kt`)
- User list page → Account page: navigates (evidence: `app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerPage.kt`)
- Account page → Account workflow: dispatches (evidence: `app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerPage.kt`)
- Account page → Account actions: dispatches (evidence: `app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerPage.kt`)
- Account workflow → Account actions: handles (evidence: `app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerViewModel.kt`)
- Account workflow → Account state: updates (evidence: `app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerViewModel.kt`)
- Account page → Account state: renders (evidence: `app/src/main/java/com/rosan/accounts/ui/page/account_manager/AccountManagerPage.kt`)
- User workflow → User service contract: requests users (evidence: `app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerViewModel.kt`)
- User workflow → User service contract: requests removal (evidence: `app/src/main/java/com/rosan/accounts/ui/page/user_manager/UserManagerViewModel.kt`)
- Account workflow → User service contract: loads accounts (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 → Shizuku / Sui: uses Binder access (evidence: `app/src/main/java/com/rosan/accounts/data/service/model/ShizukuUserService.kt`)
- Shizuku service → IUserManager stub: calls (evidence: `app/src/main/java/com/rosan/accounts/data/service/model/ShizukuUserService.kt`)
- Shizuku service → IAccountManager stub: calls (evidence: `app/src/main/java/com/rosan/accounts/data/service/model/ShizukuUserService.kt`)
- Shizuku service → IPackageManager stub: calls (evidence: `app/src/main/java/com/rosan/accounts/data/service/model/ShizukuUserService.kt`)
- Shizuku service → User API fallback: uses fallback (evidence: `app/src/main/java/com/rosan/accounts/data/service/model/ShizukuUserService.kt`)
- User API fallback → IUserManager stub: tries signatures (evidence: `app/src/main/java/com/rosan/accounts/data/common/utils/UserManagerCompat.kt`)
- IUserManager stub → UserInfo stub: returns users (evidence: `hidden-api/src/main/java/android/os/IUserManager.java`)
- 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`)
