https://github.com/ncc-projects/equipo-47

Sistema para la gestión centralizada de información de salud de mascotas, permitiendo registrar perfiles, historial de vacunación, alimentación, citas veterinarias y recordatorios automatizados.
https://github.com/ncc-projects/equipo-47

auth0 react spring-boot spring-security tailwind

Last synced: 2 months ago
JSON representation

Sistema para la gestión centralizada de información de salud de mascotas, permitiendo registrar perfiles, historial de vacunación, alimentación, citas veterinarias y recordatorios automatizados.

Host: GitHub
URL: https://github.com/ncc-projects/equipo-47
Owner: ncc-projects
Created: 2025-12-06T16:21:12.000Z (7 months ago)
Default Branch: main
Last Pushed: 2025-12-20T19:33:09.000Z (6 months ago)
Last Synced: 2025-12-22T19:32:16.283Z (6 months ago)
Topics: auth0, react, spring-boot, spring-security, tailwind
Language: TypeScript
Homepage:
Size: 3.16 MB
Stars: 0
Watchers: 0
Forks: 0
Open Issues: 4
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

Pet Health Tracker

![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)

Pet Health Tracker es un sistema web diseñado para gestionar de manera integral la salud de mascotas, permitiendo administrar perfiles, historial médico, alimentación y recordatorios automáticos. El proyecto está construido con un enfoque escalable, seguro y mantenible.

## Índice

1. [Funcionalidades](#Funcionalidades)
2. [Requerimientos previos](#requerimientos-previos)
3. [Configuración](#configuración)
4. [Swagger](#swagger)
5. [Tecnologías utilizadas](#tecnologías-utilizadas)
6. [Estructura del proyecto](#estructura-del-proyecto)
7. [Modelo entidad-relación](#modelo-entidad-relación)
8. [Licencia](#licencia)

## Funcionalidades

### 1. Gestión de Usuarios
- Autenticación con JWT
- Cifrado con BCrypt
- Endpoints:
- `POST /api/v1/login`
- `POST /api/v1/users/register`
- `POST /api/v1/users/request-password-renewal`
- `POST /api/v1/users/renew-password`

### 2. Gestión de Mascotas
- CRUD completo
- Validación de campos y archivos
- Endpoints:
- `POST /api/pets`
- `GET /api/pets/:id`
- `GET /api/pets`
- `PUT /api/pets/:id`
- `DELETE /api/pets/:id`

### 3. Registro de Salud
- Tipos: vacunación, desparasitación, consulta veterinaria
- Adjuntos (PDF/JPG/PNG)
- Endpoints:
- `POST /api/v1/vaccination-events`

### 4. Recordatorios Automáticos
- Recordatorios por usuario
- Alertas por email o notificaciones internas
- Endpoint:
- `GET /api/v1/vaccination-events`
- `GET /api/v1/vaccination-events/:petId/reminders`

### 5. Dashboard
- Agregación de datos
- Indicadores clave:
- Próximas vacunas
- Alertas
- Eventos próximos
- Endpoint:
- `GET /dashboard/:petId`

## Requerimientos previos

- **JDK: Java 21 o superior**
- **Gestor de dependencias: Maven 4.0.0**
- **Spring Boot 3.3.5**
- **Base de datos PostgreSQL**

## Configuración

1. Clona el repositorio

```bash
git clone https://github.com/ncc-projects/equipo-47.git
cd equipo-47
2. Configura las variables de entorno para la conexión a la base de datos desde `application-prod.yml`

```yaml
spring:
datasource:
url: ${DB_URL:jdbc:postgresql://localhost:5432/pet_db}
username: ${DB_USER}
password: ${DB_PASS}
driver-class-name: org.postgresql.Driver
jpa:

hibernate:
ddl-auto: update
show-sql: true

server:
port: 8080

konecta:
cors:
allowed-origins: "*"
allowed-methods: "GET,POST,PUT,DELETE,OPTIONS"
allowed-headers: "*"

security:
secret: ${JWT_SECRET} # Get from env vars
expiration-ms: ${JWT_EXPIRATION_MS:86400000}

3. Crea el archivo .env para el frontend
```yaml
VITE_API_URL=http://localhost:8080/api/v1

5. Crea un base de datos vacía con el nombre pet_db

6. Variables de entorno para el backend
```yaml
JWT_SECRET 123456789
DB_USER postgres
DB_PASS usatucontrasenia
CLOUDINARY_API_KEY tuapikey
CLOUDINARY_API_SECRET tuapisecret
CLOUDINARY_NAME tuname
SPRING_MAIL_USERNAME tumail@gmail.com
SPRING_MAIL_PASSWORD tumailpassword

8. Ejecuta el proyecto backend y frontend

9. La aplicación backend estará disponible en: http://localhost:8080

## Swagger
Swagger está configurado para generar documentación de la API automáticamente. Puedes acceder a la interfaz de Swagger en la siguiente URL cuando el servidor esté en funcionamiento:
```
http://localhost:8080/swagger-ui/index.html
```

## Tecnologías utilizadas

- **React**: Biblioteca para construir interfaces web dinámicas y reutilizables.
- **Spring Boot**: Desarrollo rápido y robusto de aplicaciones.
- **Spring Security y JWT**: Autenticación segura.
- **PostgreSQL**: Sistema de gestión de bases de datos relacional.

## Estructura del proyecto Backend

Arquitectura basada en paquetes funcionales, se organizan las carpetas de acuerdo con las características o módulos de la aplicación, es un diseño entre aspectos funcionales y principios de Clean Architecture y este tipo de arquitectura agrupa cada módulo con sus propios componentes como controladores, servicios, repositorios y modelos.