# blackwalltec/dog-adoption-app architecture

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

- Interactive diagram: https://gitdiagram.com/blackwalltec/dog-adoption-app
- Repository: https://github.com/blackwalltec/dog-adoption-app

## Overview

Qariño Animal is a dog-adoption platform with an Android client, an Express API, and a web admin panel. The principal user journey is browsing a dog, viewing its details, and starting an adoption application; the platform also supports accounts, donations, and volunteering. The API mounts separate domain modules, while the admin UI includes workflows such as registering dogs and managing applications. Some Android screens and API module internals were not sampled, so those subsystem links are documented only where visible or marked unverified.

Main entry points: [`apps/android/app/src/main/java/com/app/android/presentation/navigation/AppNavigationManager.kt`](https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/android/app/src/main/java/com/app/android/presentation/navigation/AppNavigationManager.kt) (App navigation), [`apps/api/src/app.js`](https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/api/src/app.js) (API router), [`apps/api/src/modules/catalogo/http/catalogAdmin.controller.js`](https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/api/src/modules/catalogo/http/catalogAdmin.controller.js) (Catalog API), [`apps/web/JS/jsCatalogo/ModalsJS/registerModal.controller.js`](https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/web/JS/jsCatalogo/ModalsJS/registerModal.controller.js) (Dog registration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mobile["Android app"]
  node_androidnav["App navigation"]
  node_mobilecatalog["Dog catalog"]
  node_mobilesolicitudes["Adoption requests"]
  node_mobileprofile["Accounts"]
  node_mobiledonations["Donations"]
  node_mobilevolunteer["Volunteering"]
end

subgraph group_server["Express API"]
  node_apiapp["API router<br/>[app.js]"]
  node_catalogapi["Catalog API"]
  node_requestapi["Request API"]
  node_profileapi["Profile API<br/>[auth.controller.js]"]
  node_registerapi["Registration API"]
  node_donationapi["Donation API"]
  node_volunteerapi["Volunteer API"]
end

subgraph group_admin["Web admin"]
  node_dogregister["Dog registration"]
  node_dropzone["Media dropzone"]
  node_dogsummary["Dog summary"]
  node_adminrequests["Request management"]
end

subgraph group_platform["Domain services"]
  node_supabase[("Supabase client<br/>[supabaseClient.js]")]
  node_mailservice["Mobile email"]
end

node_adopter(("Adopter"))

node_adopter -.->|"uses"| node_androidnav
node_androidnav -->|"routes to"| node_mobilecatalog
node_androidnav -->|"routes to"| node_mobilesolicitudes
node_androidnav -->|"routes to"| node_mobileprofile
node_androidnav -->|"routes to"| node_mobiledonations
node_androidnav -.->|"routes to"| node_mobilevolunteer
node_mobilecatalog -.->|"requests data"| node_catalogapi
node_mobilesolicitudes -.->|"submits requests"| node_requestapi
node_mobileprofile -.->|"uses account API"| node_profileapi
node_mobiledonations -.->|"uses donation API"| node_donationapi
node_mobilevolunteer -.->|"uses programs API"| node_volunteerapi
node_apiapp -->|"mounts module"| node_catalogapi
node_apiapp -->|"mounts module"| node_requestapi
node_apiapp -->|"mounts module"| node_profileapi
node_apiapp -->|"mounts module"| node_donationapi
node_apiapp -->|"mounts module"| node_volunteerapi
node_catalogapi -->|"uses database"| node_supabase
node_registerapi -->|"uses email service"| node_mailservice
node_dogregister -->|"initializes"| node_dropzone
node_dogregister -.->|"opens summary"| node_dogsummary
node_dogregister -.->|"submits dog data"| node_catalogapi
node_adminrequests -.->|"manages requests"| node_requestapi

click node_androidnav "https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/android/app/src/main/java/com/app/android/presentation/navigation/AppNavigationManager.kt"
click node_mobilecatalog "https://github.com/blackwalltec/dog-adoption-app/tree/develop/apps/android/app/src/main/java/com/app/android/presentation/view/viewsCatalogo"
click node_mobilesolicitudes "https://github.com/blackwalltec/dog-adoption-app/tree/develop/apps/android/app/src/main/java/com/app/android/presentation/view/viewsSolicitudes"
click node_mobileprofile "https://github.com/blackwalltec/dog-adoption-app/tree/develop/apps/android/app/src/main/java/com/app/android/presentation/view/viewsPerfiles"
click node_mobiledonations "https://github.com/blackwalltec/dog-adoption-app/tree/develop/apps/android/app/src/main/java/com/app/android/presentation/view/viewsDonativos"
click node_mobilevolunteer "https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/android/app/src/main/java/com/app/android/presentation/viewmodel/viewModelVoluntariado/ProgramasViewModel.kt"
click node_apiapp "https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/api/src/app.js"
click node_catalogapi "https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/api/src/modules/catalogo/http/catalogAdmin.controller.js"
click node_requestapi "https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/api/src/modules/solicitudes/http/requestClient.controller.js"
click node_profileapi "https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/api/src/modules/perfiles/http/auth.controller.js"
click node_registerapi "https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/api/src/modules/perfiles/http/register.controller.js"
click node_donationapi "https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/api/src/modules/donativos/http/adminCfdi.controller.js"
click node_volunteerapi "https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/api/src/modules/voluntarios/http/programaEdicion.controller.js"
click node_supabase "https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/api/src/config/supabaseClient.js"
click node_mailservice "https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/api/src/modules/perfiles/services/correoMovil.service.js"
click node_dogregister "https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/web/JS/jsCatalogo/ModalsJS/registerModal.controller.js"
click node_dropzone "https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/web/JS/jsCatalogo/ModalsJS/dropZone.controller.js"
click node_dogsummary "https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/web/JS/jsCatalogo/ModalsJS/summaryModal.controller.js"
click node_adminrequests "https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/web/JS/jsSolicitudes/adminSolicitudes.view.js"

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_androidnav,node_mobilecatalog,node_mobilesolicitudes,node_mobileprofile,node_mobiledonations,node_mobilevolunteer toneBlue
class node_apiapp,node_catalogapi,node_requestapi,node_profileapi,node_registerapi,node_donationapi,node_volunteerapi toneAmber
class node_dogregister,node_dropzone,node_dogsummary,node_adminrequests toneMint
class node_supabase,node_mailservice toneRose
class node_adopter toneIndigo
```

## Components

### Android app

- [App navigation](https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/android/app/src/main/java/com/app/android/presentation/navigation/AppNavigationManager.kt): `apps/android/app/src/main/java/com/app/android/presentation/navigation/AppNavigationManager.kt`
- [Dog catalog](https://github.com/blackwalltec/dog-adoption-app/tree/develop/apps/android/app/src/main/java/com/app/android/presentation/view/viewsCatalogo): `apps/android/app/src/main/java/com/app/android/presentation/view/viewsCatalogo`
- [Adoption requests](https://github.com/blackwalltec/dog-adoption-app/tree/develop/apps/android/app/src/main/java/com/app/android/presentation/view/viewsSolicitudes): `apps/android/app/src/main/java/com/app/android/presentation/view/viewsSolicitudes`
- [Accounts](https://github.com/blackwalltec/dog-adoption-app/tree/develop/apps/android/app/src/main/java/com/app/android/presentation/view/viewsPerfiles): `apps/android/app/src/main/java/com/app/android/presentation/view/viewsPerfiles`
- [Donations](https://github.com/blackwalltec/dog-adoption-app/tree/develop/apps/android/app/src/main/java/com/app/android/presentation/view/viewsDonativos): `apps/android/app/src/main/java/com/app/android/presentation/view/viewsDonativos`
- [Volunteering](https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/android/app/src/main/java/com/app/android/presentation/viewmodel/viewModelVoluntariado/ProgramasViewModel.kt): `apps/android/app/src/main/java/com/app/android/presentation/viewmodel/viewModelVoluntariado/ProgramasViewModel.kt`

### Express API

- [API router](https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/api/src/app.js): `apps/api/src/app.js`
- [Catalog API](https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/api/src/modules/catalogo/http/catalogAdmin.controller.js): `apps/api/src/modules/catalogo/http/catalogAdmin.controller.js`
- [Request API](https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/api/src/modules/solicitudes/http/requestClient.controller.js): `apps/api/src/modules/solicitudes/http/requestClient.controller.js`
- [Profile API](https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/api/src/modules/perfiles/http/auth.controller.js): `apps/api/src/modules/perfiles/http/auth.controller.js`
- [Registration API](https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/api/src/modules/perfiles/http/register.controller.js): `apps/api/src/modules/perfiles/http/register.controller.js`
- [Donation API](https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/api/src/modules/donativos/http/adminCfdi.controller.js): `apps/api/src/modules/donativos/http/adminCfdi.controller.js`
- [Volunteer API](https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/api/src/modules/voluntarios/http/programaEdicion.controller.js): `apps/api/src/modules/voluntarios/http/programaEdicion.controller.js`

### Web admin

- [Dog registration](https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/web/JS/jsCatalogo/ModalsJS/registerModal.controller.js): `apps/web/JS/jsCatalogo/ModalsJS/registerModal.controller.js`
- [Media dropzone](https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/web/JS/jsCatalogo/ModalsJS/dropZone.controller.js): `apps/web/JS/jsCatalogo/ModalsJS/dropZone.controller.js`
- [Dog summary](https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/web/JS/jsCatalogo/ModalsJS/summaryModal.controller.js): `apps/web/JS/jsCatalogo/ModalsJS/summaryModal.controller.js`
- [Request management](https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/web/JS/jsSolicitudes/adminSolicitudes.view.js): `apps/web/JS/jsSolicitudes/adminSolicitudes.view.js`

### Domain services

- [Supabase client](https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/api/src/config/supabaseClient.js): `apps/api/src/config/supabaseClient.js`
- [Mobile email](https://github.com/blackwalltec/dog-adoption-app/blob/develop/apps/api/src/modules/perfiles/services/correoMovil.service.js): `apps/api/src/modules/perfiles/services/correoMovil.service.js`

### Other components

- **Adopter**

## Connections

- Adopter → App navigation: uses
- App navigation → Dog catalog: routes to (evidence: `apps/android/app/src/main/java/com/app/android/presentation/navigation/AppNavigationManager.kt`)
- App navigation → Adoption requests: routes to (evidence: `apps/android/app/src/main/java/com/app/android/presentation/navigation/AppNavigationManager.kt`)
- App navigation → Accounts: routes to (evidence: `apps/android/app/src/main/java/com/app/android/presentation/navigation/AppNavigationManager.kt`)
- App navigation → Donations: routes to (evidence: `apps/android/app/src/main/java/com/app/android/presentation/navigation/AppNavigationManager.kt`)
- App navigation → Volunteering: routes to
- Dog catalog → Catalog API: requests data
- Adoption requests → Request API: submits requests
- Accounts → Profile API: uses account API
- Donations → Donation API: uses donation API
- Volunteering → Volunteer API: uses programs API
- API router → Catalog API: mounts module (evidence: `apps/api/src/app.js`)
- API router → Request API: mounts module (evidence: `apps/api/src/app.js`)
- API router → Profile API: mounts module (evidence: `apps/api/src/app.js`)
- API router → Donation API: mounts module (evidence: `apps/api/src/app.js`)
- API router → Volunteer API: mounts module (evidence: `apps/api/src/app.js`)
- Catalog API → Supabase client: uses database (evidence: `apps/api/src/modules/catalogo/http/catalogAdmin.controller.js`)
- Registration API → Mobile email: uses email service (evidence: `apps/api/src/modules/perfiles/http/register.controller.js`)
- Dog registration → Media dropzone: initializes (evidence: `apps/web/JS/jsCatalogo/ModalsJS/registerModal.controller.js`)
- Dog registration → Dog summary: opens summary
- Dog registration → Catalog API: submits dog data
- Request management → Request API: manages requests
