01

Descripción General

HunterDex es una aplicación desarrollada en Python utilizando la biblioteca Kivy, diseñada para la gestión y consulta de un catálogo digital de monstruos. El sistema permite a los usuarios autenticarse mediante un inicio de sesión, explorar una colección de criaturas organizadas en un catálogo interactivo, realizar búsquedas por nombre o tipo, consultar información detallada de cada monstruo y administrar una lista personalizada de favoritos.

Cada registro almacena información relevante como identificador, nombre, tipo, nivel, puntos de vida, descripción e imagen asociada, proporcionando una experiencia de consulta visual e intuitiva.

Además de las funciones disponibles para los usuarios generales, HunterDex incorpora un panel de administración que permite realizar operaciones completas de gestión sobre los datos almacenados. Los administradores pueden agregar nuevos monstruos, modificar registros existentes, eliminar información obsoleta y gestionar las imágenes asociadas a cada criatura.

La aplicación implementa una arquitectura basada en programación orientada a objetos y utiliza archivos JSON como mecanismo de persistencia de datos, funcionando como una base de datos local para almacenar usuarios, monstruos, favoritos e imágenes.

02

Funcionalidades del Sistema

🔐
Autenticación
Inicio de sesión seguro con diferenciación de roles: usuario general y administrador.
📖
Catálogo Interactivo
Exploración visual del catálogo de monstruos con imágenes y datos completos.
🔍
Búsqueda Avanzada
Filtrado por nombre o tipo de criatura de forma rápida e intuitiva.
Lista de Favoritos
Gestión de una colección personalizada de monstruos favoritos por usuario.
Alta de Registros
Los administradores pueden agregar nuevas criaturas con todos sus atributos.
✏️
Modificación
Edición de registros existentes incluyendo nombre, tipo, nivel, HP y descripción.
🗑️
Eliminación
Baja de monstruos obsoletos del catálogo de forma controlada.
🖼️
Gestión de Imágenes
Administración de imágenes asociadas a cada criatura del catálogo.
03

Estructura de Datos del Monstruo

Cada entidad monstruo almacena los siguientes atributos en el sistema de persistencia JSON:

Campo Tipo Descripción Gestión
id Integer Identificador único del monstruo Auto
nombre String Nombre de la criatura CRUD
tipo String Clasificación o categoría del monstruo CRUD
nivel Integer Nivel de poder o dificultad CRUD
hp Integer Puntos de vida de la criatura CRUD
descripción String Descripción detallada del monstruo CRUD
imagen String Ruta o referencia al archivo de imagen CRUD
04

Tecnologías y Herramientas

Python 3
Kivy (GUI Framework)
JSON (Persistencia de datos)
POO — Orientación a Objetos
Arquitectura MVC
Patrón Módular
05

Persistencia de Datos (JSON)

La aplicación utiliza archivos JSON como base de datos local. Cada archivo gestiona una entidad del sistema:

Archivo Entidad Descripción
usuarios.json Usuarios Credenciales, roles y datos de cada usuario registrado
monstruos.json Monstruos Catálogo completo de criaturas con todos sus atributos
favoritos.json Favoritos Relación de monstruos favoritos por usuario
imagenes.json Imágenes Referencias y rutas de las imágenes asociadas a las criaturas
06

Integrantes del Equipo

01
Anyelo Fabricio Cejudo Silva
Desarrollador
02
Anthuan Justin Martinez Castillo
Desarrollador
03
Arturo Oswaldo Sánchez Acquart
Desarrollador
04
Sebastián González Maldonado
Desarrollador

Reemplaza los nombres de ejemplo con los datos reales de tu equipo.