nikollquinteroc/PetMatch

Proyecto de simulación laboral usando kotlin

★ 0Forks 0KotlinGitHub ↗Compare

README

PetMatch

PetMatch es una aplicación móvil innovadora que tiene como objetivo principal facilitar la adopción de mascotas y combatir el abandono animal, creando un puente entre los responsables de mascotas que buscan un hogar amoroso para sus carismáticos compañeros y adoptantes que desean abrirles las puertas de su corazón a un nuevo miembro de la familia.

Presentacion 1

Un proyecto con un impacto positivo en la sociedad

Con esta aplicación queremos poner nuestro granito de arena para hacer de este mundo un lugar mejor, tanto para nosotros como para nuestros peludos y diversos compañeros. En particular queremos conseguir lo siguiente:

Reducción del abandono animal

Al conectar a potenciales adoptantes con animales en busca de un hogar, se disminuye la cantidad de mascotas abandonadas en las calles, mejorando su calidad de vida y bienestar.

Fomenta la responsabilidad y el amor por los animales

La aplicación promueve la tendencia responsable de mascotas, educando a los adoptantes sobre los cuidados necesarios y creando conciencia sobre la importancia de brindarles un hogar lleno de afecto y seguridad.

Fortalece la comunidad

PetMatch fomenta la unión entre personas que comparten el amor por los animales, creando una red de apoyo y colaboración para el cuidado y bienestar animal.

Tabla de contenido

Tecnologías utilizadas

  • Kotlin - Jetpack Compose - MVVM - Coil
  • Firebase suite - Auth - Realtime database.
  • Gestión del proyecto: Jira, Slack y Discord

Características

  • Registro de usuarios.
  • Autentificación de usuarios.
  • Visualización de listado de mascotas.
  • Visualización del perfil de las mascotas.
  • Geolocalización del usuario para mostrarle mascotas cercanas que esten en adopción.
  • Soporte de conexión entre responsable de la mascota y el que quiere adoptar.

Reglas de negocio

  • Los roles válidos para un usuario son "Admin", "Pet Responsible" y "Adopter".

Configuración del entorno

Para usar este proyecto es necesario realizar varias preparaciones.

Prerrequisitos

Para ejecutar el proyecto es necesario tener cuentas en plataformas específicas y tener instaladas algunas herramientas:

Android Studio Firebase Kotlin Android Git GitHub

Repositorio

Clona el repositorio en un directorio de tu conveniencia. Una forma de hacerlo es mediante comandos de consola.

cd <nombre del directorio del proyecto>
git clone <URL del repositorio>

Android Studio

La primera vez que abras el proyecto hay que esperar a que Gradle haga las configuraciones y descarga necesarias.

Gradle Configurations

Gradle download

Para poder ejecutar la aplicación es necesario una de las siguientes cosas:

  1. Crear un dispositivo virtual.
  2. Conectar un celular al emulador.

La opción 1 se hace mediante la opción "Device Manager" en el menú lateral. Durante la creación es necesario seleccionar el modelo del celular y la versión de android (hay que descargar una imagen del sistema operativo si no se ha hecho previamente).

Create Virtual Device

La opción 2 se realiza mediante la lista desplegable de "Available devices" del menú superior y central.

Connect Device

Base de datos

Necesitas tener una cuenta en Firebase para poder crear una base de datos y conectarla con el proyecto.

Desde Android Studio es posible empezar el proceso de creación y conexión entre firebase y el proyecto, para ello hay que darle click a la opción "Tools" del menú superior y luego darle click a la opción "Firebase".

Firebase conection 1

Esta opción abre un asistente que cuenta con la documentación necesaria para realizar la conexión. Despliega la sección "Realtime Database" y sigue los pasos indicados.

Firebase conection 2

Equipo

Contributors

nikollquinterocJormanPzCsteven-04

Issues