# ambidextp/android architecture

> Architecture diagram of the GitHub repository ambidextp/android, 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/ambidextp/android
- Repository: https://github.com/ambidextp/android

## Overview

This appears to be an Android activity-planning and tracking app, with sign-in/registration, activity browsing and creation, in-progress and personal activity views, and profile/password screens. The likely user journey is to enter through the app, browse or create an activity, then track it or review personal activities. The supplied excerpts contain no product source and the README is empty, so links below are unverified inferences from component names; no runtime calls or data transfers could be confirmed.

Main entry points: [`app/src/main/java/com/example/android/fragments/TabFragment.kt`](https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/fragments/TabFragment.kt) (Tab Navigation), [`app/src/main/java/com/example/android/MainActivity.kt`](https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/MainActivity.kt) (App Entry), [`app/src/main/java/com/example/android/fragments/ActivityFragment.kt`](https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/fragments/ActivityFragment.kt) (Activity Browse), [`app/src/main/java/com/example/android/models/DB.kt`](https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/models/DB.kt) (Local Database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["App Navigation"]
  node_main["App Entry<br/>[MainActivity.kt]"]
  node_tabs["Tab Navigation<br/>[TabFragment.kt]"]
end

subgraph group_accounts["Accounts and Profile"]
  node_login["Sign In<br/>[LoginActivity.kt]"]
  node_registration["Registration"]
  node_profile["Profile<br/>[ProfileFragment.kt]"]
  node_password["Password Change"]
end

subgraph group_activities["Activity Workflows"]
  node_browse["Activity Browse"]
  node_detail["Activity Detail"]
  node_create["Create Activity"]
  node_inprogress["In Progress"]
  node_mine["My Activities"]
  node_activity_screen["Activity Screen"]
  node_activity_adapter["Activity List Adapter<br/>[ActivityAdapter.kt]"]
  node_type_adapter["Type Adapter"]
end

subgraph group_data["Activity Data"]
  node_viewmodel["Activities View Model"]
  node_repository["Activity Repository"]
  node_dao["Activity DAO<br/>[Dao.kt]"]
  node_database[("Local Database<br/>[DB.kt]")]
  node_entity["Activity Records<br/>[Entity.kt]"]
  node_activity_type["Activity Types<br/>[ActivityType.kt]"]
  node_converter["Type Converter<br/>[TypeConverter.kt]"]
end

node_user(("User"))

node_user -.->|"opens app"| node_main
node_main -.->|"may route"| node_login
node_main -.->|"may show"| node_tabs
node_user -.->|"registers"| node_registration
node_tabs -.->|"may navigate"| node_browse
node_tabs -.->|"may navigate"| node_mine
node_tabs -.->|"may navigate"| node_profile
node_browse -.->|"may open"| node_detail
node_browse -.->|"may render"| node_activity_adapter
node_create -.->|"may select"| node_activity_type
node_activity_screen -.->|"may display"| node_inprogress
node_mine -.->|"may observe"| node_viewmodel
node_viewmodel -.->|"may delegate"| node_repository
node_repository -.->|"may query"| node_dao
node_dao -.->|"may use"| node_database
node_database -.->|"may store"| node_entity
node_database -.->|"may configure"| node_converter

click node_main "https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/MainActivity.kt"
click node_tabs "https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/fragments/TabFragment.kt"
click node_login "https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/LoginActivity.kt"
click node_registration "https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/RegistrationActivity.kt"
click node_profile "https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/fragments/ProfileFragment.kt"
click node_password "https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/fragments/ChangePasswordFragment.kt"
click node_browse "https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/fragments/ActivityFragment.kt"
click node_detail "https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/fragments/ActivityDetailFragment.kt"
click node_create "https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/fragments/NewActivityFragment.kt"
click node_inprogress "https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/fragments/ActivityInProgressFragment.kt"
click node_mine "https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/fragments/MyActivitiesFragment.kt"
click node_activity_screen "https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/ActivityActivity.kt"
click node_activity_adapter "https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/ActivityAdapter.kt"
click node_type_adapter "https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/ActivityTypeAdapter.kt"
click node_viewmodel "https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/models/MyActivitiesViewModel.kt"
click node_repository "https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/models/ActivityRepository.kt"
click node_dao "https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/models/Dao.kt"
click node_database "https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/models/DB.kt"
click node_entity "https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/models/Entity.kt"
click node_activity_type "https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/models/ActivityType.kt"
click node_converter "https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/models/TypeConverter.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_main,node_tabs,node_user toneBlue
class node_login,node_registration,node_profile,node_password toneAmber
class node_browse,node_detail,node_create,node_inprogress,node_mine,node_activity_screen,node_activity_adapter,node_type_adapter toneMint
class node_viewmodel,node_repository,node_dao,node_database,node_entity,node_activity_type,node_converter toneRose
```

## Components

### App Navigation

- [App Entry](https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/MainActivity.kt): `app/src/main/java/com/example/android/MainActivity.kt`
- [Tab Navigation](https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/fragments/TabFragment.kt): `app/src/main/java/com/example/android/fragments/TabFragment.kt`

### Accounts and Profile

- [Sign In](https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/LoginActivity.kt): `app/src/main/java/com/example/android/LoginActivity.kt`
- [Registration](https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/RegistrationActivity.kt): `app/src/main/java/com/example/android/RegistrationActivity.kt`
- [Profile](https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/fragments/ProfileFragment.kt): `app/src/main/java/com/example/android/fragments/ProfileFragment.kt`
- [Password Change](https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/fragments/ChangePasswordFragment.kt): `app/src/main/java/com/example/android/fragments/ChangePasswordFragment.kt`

### Activity Workflows

- [Activity Browse](https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/fragments/ActivityFragment.kt): `app/src/main/java/com/example/android/fragments/ActivityFragment.kt`
- [Activity Detail](https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/fragments/ActivityDetailFragment.kt): `app/src/main/java/com/example/android/fragments/ActivityDetailFragment.kt`
- [Create Activity](https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/fragments/NewActivityFragment.kt): `app/src/main/java/com/example/android/fragments/NewActivityFragment.kt`
- [In Progress](https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/fragments/ActivityInProgressFragment.kt): `app/src/main/java/com/example/android/fragments/ActivityInProgressFragment.kt`
- [My Activities](https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/fragments/MyActivitiesFragment.kt): `app/src/main/java/com/example/android/fragments/MyActivitiesFragment.kt`
- [Activity Screen](https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/ActivityActivity.kt): `app/src/main/java/com/example/android/ActivityActivity.kt`
- [Activity List Adapter](https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/ActivityAdapter.kt): `app/src/main/java/com/example/android/ActivityAdapter.kt`
- [Type Adapter](https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/ActivityTypeAdapter.kt): `app/src/main/java/com/example/android/ActivityTypeAdapter.kt`

### Activity Data

- [Activities View Model](https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/models/MyActivitiesViewModel.kt): `app/src/main/java/com/example/android/models/MyActivitiesViewModel.kt`
- [Activity Repository](https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/models/ActivityRepository.kt): `app/src/main/java/com/example/android/models/ActivityRepository.kt`
- [Activity DAO](https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/models/Dao.kt): `app/src/main/java/com/example/android/models/Dao.kt`
- [Local Database](https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/models/DB.kt): `app/src/main/java/com/example/android/models/DB.kt`
- [Activity Records](https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/models/Entity.kt): `app/src/main/java/com/example/android/models/Entity.kt`
- [Activity Types](https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/models/ActivityType.kt): `app/src/main/java/com/example/android/models/ActivityType.kt`
- [Type Converter](https://github.com/ambidextp/android/blob/master/app/src/main/java/com/example/android/models/TypeConverter.kt): `app/src/main/java/com/example/android/models/TypeConverter.kt`

### Other components

- **User**

## Connections

- User → App Entry: opens app
- App Entry → Sign In: may route
- App Entry → Tab Navigation: may show
- User → Registration: registers
- Tab Navigation → Activity Browse: may navigate
- Tab Navigation → My Activities: may navigate
- Tab Navigation → Profile: may navigate
- Activity Browse → Activity Detail: may open
- Activity Browse → Activity List Adapter: may render
- Create Activity → Activity Types: may select
- Activity Screen → In Progress: may display
- My Activities → Activities View Model: may observe
- Activities View Model → Activity Repository: may delegate
- Activity Repository → Activity DAO: may query
- Activity DAO → Local Database: may use
- Local Database → Activity Records: may store
- Local Database → Type Converter: may configure
