# mustafa-muhamed-mansour/recipes architecture

> Architecture diagram of the GitHub repository mustafa-muhamed-mansour/recipes, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mustafa-muhamed-mansour/recipes
- Repository: https://github.com/mustafa-muhamed-mansour/recipes

## Overview

This Android recipe-reading app offers XML and Jetpack Compose interfaces, with recipe retrieval and account registration as its main workflows. Recipe loading is handled through MVVM view models, domain use cases, repository implementations, and a Retrofit service; registration also uses Firebase and local password storage. The README documents encrypted-password display and both UI modes. Some subsystem wiring is inferred only from the README or source index, so unsupported connections are omitted.

Main entry points: [`app/src/main/java/com/recipes/app/composeble/RegisterComponents.kt`](https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/app/composeble/RegisterComponents.kt) (Compose registration), [`app/src/main/java/com/recipes/app/register/fragment/RegisterFragment.kt`](https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/app/register/fragment/RegisterFragment.kt) (XML registration), [`app/src/main/java/com/recipes/app/activities/compose/JetpackActivity.kt`](https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/app/activities/compose/JetpackActivity.kt) (Compose activity), [`app/src/main/java/com/recipes/app/home/pages/HomeJetpack.kt`](https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/app/home/pages/HomeJetpack.kt) (Compose home)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["User interfaces"]
  node_xml_activity["XML activity<br/>[XMLActivity.kt]"]
  node_compose_activity["Compose activity<br/>[JetpackActivity.kt]"]
  node_home_ui["Compose home<br/>[HomeJetpack.kt]"]
  node_register_ui["Compose registration"]
  node_xml_home["XML home<br/>[HomeFragment.kt]"]
  node_xml_register["XML registration"]
  node_recipe_adapter["Recipe list adapter<br/>[RecipeAdapter.kt]"]
  node_recipe_cards["Recipe cards"]
end

subgraph group_domain["Domain workflows"]
  node_home_vm["Home view model<br/>[HomeViewModel.kt]"]
  node_register_vm["Registration view model"]
  node_fetch_recipes["Fetch recipes<br/>[FetchRecipes.kt]"]
  node_register_usecase["Register account"]
  node_home_contract["Home repository contract<br/>[HomeRepository.kt]"]
  node_register_contract["Registration contract"]
  node_recipe_data["Recipe response and model<br/>[RecipesResponse.kt]"]
  node_recipe_entity["Recipe entity<br/>[RecipeModel.kt]"]
end

subgraph group_data["Data access"]
  node_home_repo["Home repository"]
  node_posts_service["Recipes HTTP service<br/>[PostsService.kt]"]
end

subgraph group_security["Account and password"]
  node_register_repo["Registration repository"]
  node_user_entity["User entity<br/>[UserModel.kt]"]
  node_password_store[("Password DataStore")]
  node_crypto["Password encryption<br/>[CryptoData.kt]"]
end

node_user(("App user"))
node_recipe_api{{"Recipe API"}}
node_firebase[("Firebase auth and database")]

node_user -.->|"opens"| node_compose_activity
node_user -.->|"opens"| node_xml_activity
node_compose_activity -->|"shows"| node_home_ui
node_home_ui -->|"observes"| node_home_vm
node_home_vm -->|"invokes"| node_fetch_recipes
node_fetch_recipes -->|"calls"| node_home_contract
node_home_repo -->|"calls"| node_posts_service
node_posts_service -->|"requests recipes"| node_recipe_api
node_posts_service -->|"returns"| node_recipe_data
node_home_contract -->|"returns"| node_recipe_data
node_home_ui -->|"renders"| node_recipe_cards
node_recipe_cards -->|"renders"| node_recipe_entity
node_xml_home -->|"observes"| node_home_vm
node_xml_home -->|"uses"| node_recipe_adapter
node_recipe_adapter -->|"displays"| node_recipe_entity
node_compose_activity -.->|"opens"| node_register_ui
node_register_ui -->|"invokes"| node_register_vm
node_register_vm -->|"invokes"| node_register_usecase
node_register_usecase -->|"calls"| node_register_contract
node_register_repo -->|"creates user"| node_firebase
node_register_repo -->|"creates"| node_user_entity
node_register_ui -->|"reads password"| node_password_store
node_register_ui -->|"encrypts and decrypts"| node_crypto
node_xml_register -->|"uses"| node_register_vm
node_xml_register -->|"uses"| node_crypto
node_xml_register -->|"uses"| node_password_store

click node_xml_activity "https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/app/activities/xml/XMLActivity.kt"
click node_compose_activity "https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/app/activities/compose/JetpackActivity.kt"
click node_home_ui "https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/app/home/pages/HomeJetpack.kt"
click node_register_ui "https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/app/composeble/RegisterComponents.kt"
click node_xml_home "https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/app/home/fragment/HomeFragment.kt"
click node_xml_register "https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/app/register/fragment/RegisterFragment.kt"
click node_recipe_adapter "https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/app/adapter/RecipeAdapter.kt"
click node_recipe_cards "https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/app/composeble/ItemProductOfCard.kt"
click node_home_vm "https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/app/home/viewmodel/HomeViewModel.kt"
click node_register_vm "https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/app/register/viewmodel/RegisterViewModel.kt"
click node_fetch_recipes "https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/domain/usecase/FetchRecipes.kt"
click node_register_usecase "https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/domain/usecase/RegisterAccountUseCase.kt"
click node_home_contract "https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/domain/repository/HomeRepository.kt"
click node_register_contract "https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/domain/repository/RegisterRepository.kt"
click node_home_repo "https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/data/repository/HomeRepositoryIml.kt"
click node_register_repo "https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/data/repository/RegisterRepositoryIml.kt"
click node_posts_service "https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/data/datasource/remote/PostsService.kt"
click node_recipe_data "https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/domain/response/RecipesResponse.kt"
click node_recipe_entity "https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/domain/entity/RecipeModel.kt"
click node_user_entity "https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/domain/entity/UserModel.kt"
click node_password_store "https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/data/datasource/local/datastore/PasswordDataStore.kt"
click node_crypto "https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/app/utils/CryptoData.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_xml_activity,node_compose_activity,node_home_ui,node_register_ui,node_xml_home,node_xml_register,node_recipe_adapter,node_recipe_cards,node_user toneBlue
class node_home_vm,node_register_vm,node_fetch_recipes,node_register_usecase,node_home_contract,node_register_contract,node_recipe_data,node_recipe_entity,node_firebase toneAmber
class node_home_repo,node_posts_service,node_recipe_api toneMint
class node_register_repo,node_user_entity,node_password_store,node_crypto toneRose
```

## Components

### User interfaces

- [XML activity](https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/app/activities/xml/XMLActivity.kt): `app/src/main/java/com/recipes/app/activities/xml/XMLActivity.kt`
- [Compose activity](https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/app/activities/compose/JetpackActivity.kt): `app/src/main/java/com/recipes/app/activities/compose/JetpackActivity.kt`
- [Compose home](https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/app/home/pages/HomeJetpack.kt): `app/src/main/java/com/recipes/app/home/pages/HomeJetpack.kt`
- [Compose registration](https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/app/composeble/RegisterComponents.kt): `app/src/main/java/com/recipes/app/composeble/RegisterComponents.kt`
- [XML home](https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/app/home/fragment/HomeFragment.kt): `app/src/main/java/com/recipes/app/home/fragment/HomeFragment.kt`
- [XML registration](https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/app/register/fragment/RegisterFragment.kt): `app/src/main/java/com/recipes/app/register/fragment/RegisterFragment.kt`
- [Recipe list adapter](https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/app/adapter/RecipeAdapter.kt): `app/src/main/java/com/recipes/app/adapter/RecipeAdapter.kt`
- [Recipe cards](https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/app/composeble/ItemProductOfCard.kt): `app/src/main/java/com/recipes/app/composeble/ItemProductOfCard.kt`

### Domain workflows

- [Home view model](https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/app/home/viewmodel/HomeViewModel.kt): `app/src/main/java/com/recipes/app/home/viewmodel/HomeViewModel.kt`
- [Registration view model](https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/app/register/viewmodel/RegisterViewModel.kt): `app/src/main/java/com/recipes/app/register/viewmodel/RegisterViewModel.kt`
- [Fetch recipes](https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/domain/usecase/FetchRecipes.kt): `app/src/main/java/com/recipes/domain/usecase/FetchRecipes.kt`
- [Register account](https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/domain/usecase/RegisterAccountUseCase.kt): `app/src/main/java/com/recipes/domain/usecase/RegisterAccountUseCase.kt`
- [Home repository contract](https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/domain/repository/HomeRepository.kt): `app/src/main/java/com/recipes/domain/repository/HomeRepository.kt`
- [Registration contract](https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/domain/repository/RegisterRepository.kt): `app/src/main/java/com/recipes/domain/repository/RegisterRepository.kt`
- [Recipe response and model](https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/domain/response/RecipesResponse.kt): `app/src/main/java/com/recipes/domain/response/RecipesResponse.kt`
- [Recipe entity](https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/domain/entity/RecipeModel.kt): `app/src/main/java/com/recipes/domain/entity/RecipeModel.kt`

### Data access

- [Home repository](https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/data/repository/HomeRepositoryIml.kt): `app/src/main/java/com/recipes/data/repository/HomeRepositoryIml.kt`
- [Recipes HTTP service](https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/data/datasource/remote/PostsService.kt): `app/src/main/java/com/recipes/data/datasource/remote/PostsService.kt`

### Account and password

- [Registration repository](https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/data/repository/RegisterRepositoryIml.kt): `app/src/main/java/com/recipes/data/repository/RegisterRepositoryIml.kt`
- [User entity](https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/domain/entity/UserModel.kt): `app/src/main/java/com/recipes/domain/entity/UserModel.kt`
- [Password DataStore](https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/data/datasource/local/datastore/PasswordDataStore.kt): `app/src/main/java/com/recipes/data/datasource/local/datastore/PasswordDataStore.kt`
- [Password encryption](https://github.com/mustafa-muhamed-mansour/recipes/blob/master/app/src/main/java/com/recipes/app/utils/CryptoData.kt): `app/src/main/java/com/recipes/app/utils/CryptoData.kt`

### Other components

- **App user**
- **Recipe API**
- **Firebase auth and database**

## Connections

- App user → Compose activity: opens (evidence: `README.md`)
- App user → XML activity: opens (evidence: `README.md`)
- Compose activity → Compose home: shows (evidence: `app/src/main/java/com/recipes/app/activities/compose/JetpackActivity.kt`)
- Compose home → Home view model: observes (evidence: `app/src/main/java/com/recipes/app/home/pages/HomeJetpack.kt`)
- Home view model → Fetch recipes: invokes (evidence: `app/src/main/java/com/recipes/app/home/viewmodel/HomeViewModel.kt`)
- Fetch recipes → Home repository contract: calls (evidence: `app/src/main/java/com/recipes/domain/usecase/FetchRecipes.kt`)
- Home repository → Recipes HTTP service: calls (evidence: `app/src/main/java/com/recipes/data/repository/HomeRepositoryIml.kt`)
- Recipes HTTP service → Recipe API: requests recipes (evidence: `app/src/main/java/com/recipes/data/datasource/remote/PostsService.kt`)
- Recipes HTTP service → Recipe response and model: returns (evidence: `app/src/main/java/com/recipes/data/datasource/remote/PostsService.kt`)
- Home repository contract → Recipe response and model: returns (evidence: `app/src/main/java/com/recipes/domain/repository/HomeRepository.kt`)
- Compose home → Recipe cards: renders (evidence: `app/src/main/java/com/recipes/app/home/pages/HomeJetpack.kt`)
- Recipe cards → Recipe entity: renders (evidence: `app/src/main/java/com/recipes/app/composeble/ItemProductOfCard.kt`)
- XML home → Home view model: observes (evidence: `app/src/main/java/com/recipes/app/home/fragment/HomeFragment.kt`)
- XML home → Recipe list adapter: uses (evidence: `app/src/main/java/com/recipes/app/home/fragment/HomeFragment.kt`)
- Recipe list adapter → Recipe entity: displays (evidence: `app/src/main/java/com/recipes/app/adapter/RecipeAdapter.kt`)
- Compose activity → Compose registration: opens (evidence: `README.md`)
- Compose registration → Registration view model: invokes (evidence: `app/src/main/java/com/recipes/app/composeble/RegisterComponents.kt`)
- Registration view model → Register account: invokes (evidence: `app/src/main/java/com/recipes/app/register/viewmodel/RegisterViewModel.kt`)
- Register account → Registration contract: calls (evidence: `app/src/main/java/com/recipes/domain/usecase/RegisterAccountUseCase.kt`)
- Registration repository → Firebase auth and database: creates user (evidence: `app/src/main/java/com/recipes/data/repository/RegisterRepositoryIml.kt`)
- Registration repository → User entity: creates (evidence: `app/src/main/java/com/recipes/data/repository/RegisterRepositoryIml.kt`)
- Compose registration → Password DataStore: reads password (evidence: `app/src/main/java/com/recipes/app/composeble/RegisterComponents.kt`)
- Compose registration → Password encryption: encrypts and decrypts (evidence: `app/src/main/java/com/recipes/app/composeble/RegisterComponents.kt`)
- XML registration → Registration view model: uses (evidence: `app/src/main/java/com/recipes/app/register/fragment/RegisterFragment.kt`)
- XML registration → Password encryption: uses (evidence: `app/src/main/java/com/recipes/app/register/fragment/RegisterFragment.kt`)
- XML registration → Password DataStore: uses (evidence: `app/src/main/java/com/recipes/app/register/fragment/RegisterFragment.kt`)
