# yulianmartinez/challengetribal architecture

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

- Interactive diagram: https://gitdiagram.com/yulianmartinez/challengetribal
- Repository: https://github.com/yulianmartinez/challengetribal

## Overview

#### Purpose and Entry Point
This is a native Android app that fetches and displays Chuck Norris joke categories from `https://api.chucknorris.io/jokes/categories`. The launch/UI entry is `app/src/main/java/com/ymd/tribalchallenge/ui/MainActivity.kt`; application-wide initialization is in `app/src/main/java/com/ymd/tribalchallenge/ui/TribalApplication.kt`. The project is split into `app`, `domain`, and `infrastructure` Gradle modules.

#### Presentation Layer
The app module owns Android lifecycle integration, XML views, and MVVM presentation state. `MainActivity` renders `app/src/main/res/layout/activity_main.xml` and delegates category loading to `app/src/main/java/com/ymd/tribalchallenge/viewmodel/CategoryViewModel.kt`. This layer should depend on domain contracts rather than network details.

#### Category List Rendering
Categories are presented through RecyclerView-style adapter components: `app/src/main/java/com/ymd/tribalchallenge/ui/adapter/CategoryAdapter.kt`, `app/src/main/java/com/ymd/tribalchallenge/ui/adapter/CategoryViewHolder.kt`, and `app/src/main/res/layout/item_category.xml`. `CategoryListener.kt` forms the UI interaction boundary for category item events.

#### Domain Contracts and Use Case
The domain module contains framework-independent category abstractions. `domain/src/main/java/com/ymd/domain/service/CategoryService.kt` defines the category-oriented business operation, while `domain/src/main/java/com/ymd/domain/repository/CategoryRepository.kt` defines the data-access boundary. Error semantics are centralized in `domain/src/main/java/com/ymd/domain/exception/AppException.kt` and `domain/src/main/java/com/ymd/domain/exception/CategoryException.kt`.

#### Infrastructure and Remote Boundary
Infrastructure implements domain-facing category access and owns the HTTP/API details. `infrastructure/src/main/java/com/ymd/infrastructure/service/CategoryServiceImpl.kt` is the concrete service implementation, and `infrastructure/src/main/java/com/ymd/infrastructure/api/ApiCategory.kt` represents the remote endpoint boundary. The sole identified external service is the public Chuck Norris API; no persistence backend is evident from the tree.

#### Dependency Injection and Async Execution
Dependency wiring is organized in `infrastructure/src/main/java/com/ymd/infrastructure/di/CategoryModule.kt`, which binds category dependencies across domain and infrastructure. `infrastructure/src/main/java/com/ymd/infrastructure/di/HttpClientModule.kt` supplies HTTP-client dependencies, and `infrastructure/src/main/java/com/ymd/infrastructure/di/DispatcherModule.kt` supplies coroutine dispatchers. Coroutines carry asynchronous work from the ViewModel through domain/infrastructure to the remote API.

#### Primary Flow
1. Android starts `TribalApplication` and `MainActivity`.
2. `CategoryViewModel` requests categories through the domain `CategoryService`/`CategoryRepository` boundary.
3. DI resolves the infrastructure implementation.
4. `CategoryServiceImpl` calls `ApiCategory`, using the configured HTTP client, against Chuck Norris API.
5. Results or mapped domain exceptions return to the ViewModel.
6. The activity updates the category adapter and item layout on the Android UI boundary.

Main entry points: [`infrastructure/src/main/java/com/ymd/infrastructure/service/CategoryServiceImpl.kt`](https://github.com/yulianmartinez/challengetribal/blob/main/infrastructure/src/main/java/com/ymd/infrastructure/service/CategoryServiceImpl.kt) (CategoryServiceImpl), [`app/src/main/java/com/ymd/tribalchallenge/ui/MainActivity.kt`](https://github.com/yulianmartinez/challengetribal/blob/main/app/src/main/java/com/ymd/tribalchallenge/ui/MainActivity.kt) (MainActivity), [`app/src/main/java/com/ymd/tribalchallenge/viewmodel/CategoryViewModel.kt`](https://github.com/yulianmartinez/challengetribal/blob/main/app/src/main/java/com/ymd/tribalchallenge/viewmodel/CategoryViewModel.kt) (CategoryViewModel), [`app/src/main/java/com/ymd/tribalchallenge/ui/adapter/CategoryAdapter.kt`](https://github.com/yulianmartinez/challengetribal/blob/main/app/src/main/java/com/ymd/tribalchallenge/ui/adapter/CategoryAdapter.kt) (Category list renderer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["Android Presentation"]
  node_application["TribalApplication<br/>Android application"]
  node_activity["MainActivity<br/>Android UI entry<br/>[MainActivity.kt]"]
  node_main_layout["Main screen layout<br/>XML layout<br/>[activity_main.xml]"]
  node_viewmodel["CategoryViewModel<br/>MVVM state holder"]
  node_adapter["Category list renderer<br/>RecyclerView adapter<br/>[CategoryAdapter.kt]"]
  node_item_layout["Category row layout<br/>XML layout<br/>[item_category.xml]"]
  node_listener["CategoryListener<br/>UI interaction contract"]
end

subgraph group_domain["Domain"]
  node_category_service["CategoryService<br/>domain use-case contract<br/>[CategoryService.kt]"]
  node_category_repository["CategoryRepository<br/>data-access contract"]
  node_domain_errors["Domain exceptions<br/>error model<br/>[AppException.kt]"]
end

subgraph group_infrastructure["Infrastructure"]
  node_category_impl["CategoryServiceImpl<br/>remote category implementation"]
  node_api_category["ApiCategory<br/>remote API client<br/>[ApiCategory.kt]"]
  node_category_module["CategoryModule<br/>DI bindings<br/>[CategoryModule.kt]"]
  node_http_module["HttpClientModule<br/>HTTP DI provider"]
  node_dispatcher_module["DispatcherModule<br/>coroutine DI provider"]
end

node_chuck_api{{"Chuck Norris API<br/>external HTTP service"}}

node_application -->|"initializes DI"| node_category_module
node_application -->|"starts"| node_activity
node_activity -->|"renders"| node_main_layout
node_activity -->|"observes state"| node_viewmodel
node_activity -->|"updates categories"| node_adapter
node_adapter -->|"inflates"| node_item_layout
node_adapter -->|"emits item events"| node_listener
node_viewmodel -->|"loads categories"| node_category_service
node_viewmodel -.->|"uses coroutine dispatchers"| node_dispatcher_module
node_category_service -->|"retrieves through"| node_category_repository
node_category_impl -->|"implements"| node_category_repository
node_category_impl -->|"calls"| node_api_category
node_category_impl -->|"maps failures to"| node_domain_errors
node_category_module -.->|"binds"| node_category_service
node_category_module -.->|"provides"| node_category_impl
node_http_module -.->|"supplies HTTP client"| node_api_category
node_dispatcher_module -.->|"supplies dispatchers"| node_category_impl
node_api_category -->|"GET /jokes/categories"| node_chuck_api

click node_application "https://github.com/yulianmartinez/challengetribal/blob/main/app/src/main/java/com/ymd/tribalchallenge/ui/TribalApplication.kt"
click node_activity "https://github.com/yulianmartinez/challengetribal/blob/main/app/src/main/java/com/ymd/tribalchallenge/ui/MainActivity.kt"
click node_main_layout "https://github.com/yulianmartinez/challengetribal/blob/main/app/src/main/res/layout/activity_main.xml"
click node_viewmodel "https://github.com/yulianmartinez/challengetribal/blob/main/app/src/main/java/com/ymd/tribalchallenge/viewmodel/CategoryViewModel.kt"
click node_adapter "https://github.com/yulianmartinez/challengetribal/blob/main/app/src/main/java/com/ymd/tribalchallenge/ui/adapter/CategoryAdapter.kt"
click node_item_layout "https://github.com/yulianmartinez/challengetribal/blob/main/app/src/main/res/layout/item_category.xml"
click node_listener "https://github.com/yulianmartinez/challengetribal/blob/main/app/src/main/java/com/ymd/tribalchallenge/ui/adapter/CategoryListener.kt"
click node_category_service "https://github.com/yulianmartinez/challengetribal/blob/main/domain/src/main/java/com/ymd/domain/service/CategoryService.kt"
click node_category_repository "https://github.com/yulianmartinez/challengetribal/blob/main/domain/src/main/java/com/ymd/domain/repository/CategoryRepository.kt"
click node_domain_errors "https://github.com/yulianmartinez/challengetribal/blob/main/domain/src/main/java/com/ymd/domain/exception/AppException.kt"
click node_category_impl "https://github.com/yulianmartinez/challengetribal/blob/main/infrastructure/src/main/java/com/ymd/infrastructure/service/CategoryServiceImpl.kt"
click node_api_category "https://github.com/yulianmartinez/challengetribal/blob/main/infrastructure/src/main/java/com/ymd/infrastructure/api/ApiCategory.kt"
click node_category_module "https://github.com/yulianmartinez/challengetribal/blob/main/infrastructure/src/main/java/com/ymd/infrastructure/di/CategoryModule.kt"
click node_http_module "https://github.com/yulianmartinez/challengetribal/blob/main/infrastructure/src/main/java/com/ymd/infrastructure/di/HttpClientModule.kt"
click node_dispatcher_module "https://github.com/yulianmartinez/challengetribal/blob/main/infrastructure/src/main/java/com/ymd/infrastructure/di/DispatcherModule.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_application,node_activity,node_main_layout,node_viewmodel,node_adapter,node_item_layout,node_listener toneBlue
class node_category_service,node_category_repository,node_domain_errors toneAmber
class node_category_impl,node_api_category,node_category_module,node_http_module,node_dispatcher_module toneMint
class node_chuck_api toneNeutral
```

## Components

### Android Presentation

App module lifecycle, state, and XML rendering.

- [TribalApplication](https://github.com/yulianmartinez/challengetribal/blob/main/app/src/main/java/com/ymd/tribalchallenge/ui/TribalApplication.kt): Android application · Initializes application-wide dependencies. · `app/src/main/java/com/ymd/tribalchallenge/ui/TribalApplication.kt`
- [MainActivity](https://github.com/yulianmartinez/challengetribal/blob/main/app/src/main/java/com/ymd/tribalchallenge/ui/MainActivity.kt): Android UI entry · Launches category screen and renders state. · `app/src/main/java/com/ymd/tribalchallenge/ui/MainActivity.kt`
- [Main screen layout](https://github.com/yulianmartinez/challengetribal/blob/main/app/src/main/res/layout/activity_main.xml): XML layout · `app/src/main/res/layout/activity_main.xml`
- [CategoryViewModel](https://github.com/yulianmartinez/challengetribal/blob/main/app/src/main/java/com/ymd/tribalchallenge/viewmodel/CategoryViewModel.kt): MVVM state holder · Loads categories asynchronously for the UI. · `app/src/main/java/com/ymd/tribalchallenge/viewmodel/CategoryViewModel.kt`
- [Category list renderer](https://github.com/yulianmartinez/challengetribal/blob/main/app/src/main/java/com/ymd/tribalchallenge/ui/adapter/CategoryAdapter.kt): RecyclerView adapter · Adapter and holder render category rows. · `app/src/main/java/com/ymd/tribalchallenge/ui/adapter/CategoryAdapter.kt`
- [Category row layout](https://github.com/yulianmartinez/challengetribal/blob/main/app/src/main/res/layout/item_category.xml): XML layout · `app/src/main/res/layout/item_category.xml`
- [CategoryListener](https://github.com/yulianmartinez/challengetribal/blob/main/app/src/main/java/com/ymd/tribalchallenge/ui/adapter/CategoryListener.kt): UI interaction contract · `app/src/main/java/com/ymd/tribalchallenge/ui/adapter/CategoryListener.kt`

### Domain

Framework-independent category contracts and errors.

- [CategoryService](https://github.com/yulianmartinez/challengetribal/blob/main/domain/src/main/java/com/ymd/domain/service/CategoryService.kt): domain use-case contract · Defines category business operation. · `domain/src/main/java/com/ymd/domain/service/CategoryService.kt`
- [CategoryRepository](https://github.com/yulianmartinez/challengetribal/blob/main/domain/src/main/java/com/ymd/domain/repository/CategoryRepository.kt): data-access contract · Abstracts category retrieval. · `domain/src/main/java/com/ymd/domain/repository/CategoryRepository.kt`
- [Domain exceptions](https://github.com/yulianmartinez/challengetribal/blob/main/domain/src/main/java/com/ymd/domain/exception/AppException.kt): error model · Centralizes application and category errors. · `domain/src/main/java/com/ymd/domain/exception/AppException.kt`

### Infrastructure

Remote implementation, HTTP, and dependency wiring.

- [CategoryServiceImpl](https://github.com/yulianmartinez/challengetribal/blob/main/infrastructure/src/main/java/com/ymd/infrastructure/service/CategoryServiceImpl.kt): remote category implementation · Maps remote results and failures to domain behavior. · `infrastructure/src/main/java/com/ymd/infrastructure/service/CategoryServiceImpl.kt`
- [ApiCategory](https://github.com/yulianmartinez/challengetribal/blob/main/infrastructure/src/main/java/com/ymd/infrastructure/api/ApiCategory.kt): remote API client · Represents the categories endpoint. · `infrastructure/src/main/java/com/ymd/infrastructure/api/ApiCategory.kt`
- [CategoryModule](https://github.com/yulianmartinez/challengetribal/blob/main/infrastructure/src/main/java/com/ymd/infrastructure/di/CategoryModule.kt): DI bindings · Binds domain category contracts to infrastructure. · `infrastructure/src/main/java/com/ymd/infrastructure/di/CategoryModule.kt`
- [HttpClientModule](https://github.com/yulianmartinez/challengetribal/blob/main/infrastructure/src/main/java/com/ymd/infrastructure/di/HttpClientModule.kt): HTTP DI provider · `infrastructure/src/main/java/com/ymd/infrastructure/di/HttpClientModule.kt`
- [DispatcherModule](https://github.com/yulianmartinez/challengetribal/blob/main/infrastructure/src/main/java/com/ymd/infrastructure/di/DispatcherModule.kt): coroutine DI provider · `infrastructure/src/main/java/com/ymd/infrastructure/di/DispatcherModule.kt`

### Other components

- **Chuck Norris API**: external HTTP service · Public categories endpoint.

## Connections

- TribalApplication → CategoryModule: initializes DI
- TribalApplication → MainActivity: starts
- MainActivity → Main screen layout: renders
- MainActivity → CategoryViewModel: observes state
- MainActivity → Category list renderer: updates categories
- Category list renderer → Category row layout: inflates
- Category list renderer → CategoryListener: emits item events
- CategoryViewModel → CategoryService: loads categories
- CategoryViewModel → DispatcherModule: uses coroutine dispatchers
- CategoryService → CategoryRepository: retrieves through
- CategoryServiceImpl → CategoryRepository: implements
- CategoryServiceImpl → ApiCategory: calls
- CategoryServiceImpl → Domain exceptions: maps failures to
- CategoryModule → CategoryService: binds
- CategoryModule → CategoryServiceImpl: provides
- HttpClientModule → ApiCategory: supplies HTTP client
- DispatcherModule → CategoryServiceImpl: supplies dispatchers
- ApiCategory → Chuck Norris API: GET /jokes/categories
