# thedach/user_list architecture

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

- Interactive diagram: https://gitdiagram.com/thedach/user_list
- Repository: https://github.com/thedach/user_list

## Overview

This Android app retrieves a user list, displays it, and lets people inspect user details and save or unsave users. The main screen initiates loading through its ViewModel; Retrofit requests the user API, and the returned users are rendered in a reusable list adapter. The detail and saved-user screens use Room-backed ViewModels and a DAO for saved-user lookup and changes. Source excerpts support these key paths; relationships among the model classes are based on the source index, and no README documentation was provided.

Main entry points: [`app/src/main/java/com/thedach/userlist/MainActivity.java`](https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/MainActivity.java) (User list), [`app/src/main/java/com/thedach/userlist/User.java`](https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/User.java) (User model), [`app/src/main/java/com/thedach/userlist/SavedUsersActivity.java`](https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/SavedUsersActivity.java) (Saved list), [`app/src/main/java/com/thedach/userlist/ApiService.java`](https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/ApiService.java) (User API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["User screens"]
  node_main["User list<br/>[MainActivity.java]"]
  node_saved["Saved list"]
  node_detail["User details"]
  node_adapter["User list adapter<br/>[UsersAdapter.java]"]
end

subgraph group_logic["View models"]
  node_mainvm["List ViewModel<br/>[MainViewModel.java]"]
  node_savedvm["Saved ViewModel"]
  node_detailvm["Detail ViewModel"]
end

subgraph group_remote["Remote users"]
  node_factory["API factory<br/>[ApiFactory.java]"]
  node_api["User API<br/>[ApiService.java]"]
end

subgraph group_storage["Saved user data"]
  node_database[("Room database<br/>[UserDatabase.java]")]
  node_dao["User DAO<br/>[UserDao.java]"]
  node_user["User model<br/>[User.java]"]
  node_address["Address model<br/>[Address.java]"]
  node_company["Company model<br/>[Company.java]"]
end

node_person(("App user"))
node_service{{"Users service"}}

node_person -->|"opens"| node_main
node_main -->|"requests users"| node_mainvm
node_mainvm -->|"uses API"| node_factory
node_factory -->|"creates service"| node_api
node_api -->|"requests users"| node_service
node_mainvm -->|"loads users"| node_api
node_main -->|"sets users"| node_adapter
node_main -->|"opens details"| node_detail
node_main -->|"opens saved list"| node_saved
node_saved -->|"observes saved users"| node_savedvm
node_saved -->|"sets users"| node_adapter
node_saved -->|"opens details"| node_detail
node_detail -->|"checks saved status"| node_detailvm
node_savedvm -->|"gets DAO"| node_database
node_detailvm -->|"gets DAO"| node_database
node_database -->|"provides"| node_dao
node_savedvm -->|"reads saved users"| node_dao
node_detailvm -->|"reads and changes"| node_dao
node_dao -->|"stores"| node_user
node_api -->|"returns users"| node_user
node_user -->|"embeds"| node_address
node_user -->|"embeds"| node_company
node_adapter -->|"renders"| node_user

click node_main "https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/MainActivity.java"
click node_saved "https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/SavedUsersActivity.java"
click node_detail "https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/UserDetailActivity.java"
click node_adapter "https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/UsersAdapter.java"
click node_mainvm "https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/MainViewModel.java"
click node_savedvm "https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/SavedUsersViewModel.java"
click node_detailvm "https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/UserDetailViewModel.java"
click node_factory "https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/ApiFactory.java"
click node_api "https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/ApiService.java"
click node_database "https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/UserDatabase.java"
click node_dao "https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/UserDao.java"
click node_user "https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/User.java"
click node_address "https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/Address.java"
click node_company "https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/Company.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_main,node_saved,node_detail,node_adapter,node_person,node_service toneBlue
class node_mainvm,node_savedvm,node_detailvm toneAmber
class node_factory,node_api toneMint
class node_database,node_dao,node_user,node_address,node_company toneRose
```

## Components

### User screens

- [User list](https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/MainActivity.java): `app/src/main/java/com/thedach/userlist/MainActivity.java`
- [Saved list](https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/SavedUsersActivity.java): `app/src/main/java/com/thedach/userlist/SavedUsersActivity.java`
- [User details](https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/UserDetailActivity.java): `app/src/main/java/com/thedach/userlist/UserDetailActivity.java`
- [User list adapter](https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/UsersAdapter.java): `app/src/main/java/com/thedach/userlist/UsersAdapter.java`

### View models

- [List ViewModel](https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/MainViewModel.java): `app/src/main/java/com/thedach/userlist/MainViewModel.java`
- [Saved ViewModel](https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/SavedUsersViewModel.java): `app/src/main/java/com/thedach/userlist/SavedUsersViewModel.java`
- [Detail ViewModel](https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/UserDetailViewModel.java): `app/src/main/java/com/thedach/userlist/UserDetailViewModel.java`

### Remote users

- [API factory](https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/ApiFactory.java): `app/src/main/java/com/thedach/userlist/ApiFactory.java`
- [User API](https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/ApiService.java): `app/src/main/java/com/thedach/userlist/ApiService.java`

### Saved user data

- [Room database](https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/UserDatabase.java): `app/src/main/java/com/thedach/userlist/UserDatabase.java`
- [User DAO](https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/UserDao.java): `app/src/main/java/com/thedach/userlist/UserDao.java`
- [User model](https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/User.java): `app/src/main/java/com/thedach/userlist/User.java`
- [Address model](https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/Address.java): `app/src/main/java/com/thedach/userlist/Address.java`
- [Company model](https://github.com/thedach/user_list/blob/master/app/src/main/java/com/thedach/userlist/Company.java): `app/src/main/java/com/thedach/userlist/Company.java`

### Other components

- **App user**
- **Users service**

## Connections

- App user → User list: opens (evidence: `app/src/main/java/com/thedach/userlist/MainActivity.java`)
- User list → List ViewModel: requests users (evidence: `app/src/main/java/com/thedach/userlist/MainActivity.java`)
- List ViewModel → API factory: uses API (evidence: `app/src/main/java/com/thedach/userlist/MainViewModel.java`)
- API factory → User API: creates service (evidence: `app/src/main/java/com/thedach/userlist/ApiFactory.java`)
- User API → Users service: requests users (evidence: `app/src/main/java/com/thedach/userlist/ApiService.java`)
- List ViewModel → User API: loads users (evidence: `app/src/main/java/com/thedach/userlist/MainViewModel.java`)
- User list → User list adapter: sets users (evidence: `app/src/main/java/com/thedach/userlist/MainActivity.java`)
- User list → User details: opens details (evidence: `app/src/main/java/com/thedach/userlist/MainActivity.java`)
- User list → Saved list: opens saved list (evidence: `app/src/main/java/com/thedach/userlist/MainActivity.java`)
- Saved list → Saved ViewModel: observes saved users (evidence: `app/src/main/java/com/thedach/userlist/SavedUsersActivity.java`)
- Saved list → User list adapter: sets users (evidence: `app/src/main/java/com/thedach/userlist/SavedUsersActivity.java`)
- Saved list → User details: opens details (evidence: `app/src/main/java/com/thedach/userlist/SavedUsersActivity.java`)
- User details → Detail ViewModel: checks saved status (evidence: `app/src/main/java/com/thedach/userlist/UserDetailActivity.java`)
- Saved ViewModel → Room database: gets DAO (evidence: `app/src/main/java/com/thedach/userlist/SavedUsersViewModel.java`)
- Detail ViewModel → Room database: gets DAO (evidence: `app/src/main/java/com/thedach/userlist/UserDetailViewModel.java`)
- Room database → User DAO: provides (evidence: `app/src/main/java/com/thedach/userlist/UserDatabase.java`)
- Saved ViewModel → User DAO: reads saved users (evidence: `app/src/main/java/com/thedach/userlist/SavedUsersViewModel.java`)
- Detail ViewModel → User DAO: reads and changes (evidence: `app/src/main/java/com/thedach/userlist/UserDetailViewModel.java`)
- User DAO → User model: stores (evidence: `app/src/main/java/com/thedach/userlist/UserDao.java`)
- User API → User model: returns users (evidence: `app/src/main/java/com/thedach/userlist/ApiService.java`)
- User model → Address model: embeds (evidence: `app/src/main/java/com/thedach/userlist/User.java`)
- User model → Company model: embeds (evidence: `app/src/main/java/com/thedach/userlist/User.java`)
- User list adapter → User model: renders (evidence: `app/src/main/java/com/thedach/userlist/UsersAdapter.java`)
