Merge pull request #46 from muke78/dev

deploy: Mejoras en la estructura de la base de datos, hooks,  docuemntacion, mejoramiento estructura de codigo, simplificacion de swagger docs

Author: muke78

.github/workflows/dependency-review.yml

@@ -10,7 +10,7 @@ export NVM_DIR="$HOME/.nvm"
 echo "🔍 Verificando archivos antes del commit..."
 echo "📦 Formateando código con Prettier..."
 
-yarn prettier 'src/**/*.{js,ts,jsx,tsx,json}' server.js package.json --write || exit 1
+pnpm prettier 'src/**/*.{js,ts,jsx,tsx,json}' server.js package.json --write || exit 1
 
 
 # Agregar los archivos modificados después del formateo

.github/workflows/node.js.yml

@@ -7,7 +7,7 @@ if [ "$BRANCH" = "staging" ]; then
   echo "📍 Estás en la rama 'staging'. Ejecutando pruebas..."
    echo "🧪 Ejecutando tests con servidor..."
 
-  if ! yarn test:with-server; then
+  if ! pnpm test:with-server; then
     echo "❌ Tests fallaron. Corrige los errores antes de hacer commit."
     exit 1
   fi

.husky/pre-commit

@@ -1,4 +1,4 @@
-Copyright (c) 2024 Erick Miguel Gonzalez Rivera
+Copyright (c) 2025 Erick Miguel Gonzalez Rivera
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

.husky/pre-push

@@ -2,9 +2,11 @@
 
 ## Cambios importantes
 
-- Hacer la modularizacion de los usuairos para que trabaje con services y models y controllers
+- Verificar testeos del catalogo de activos y de usuarios juntos y hacerlos
+- Busar una forma mas segura de pasarle el token a los test
+- Probar la funcion de token para el refresco del mismo, y hacer la docuemntacion en postman
+- Excluir por aparte el controlador de google para el login, y tenerlo aparte (Sacarlo de los usuario y que tenga su propio espacio)
 
 ## Cambios que se puedan ir haciendo
 
-- Hacer la documentacion en postman para posteriormente publicarla
 - Ir adecuando el codigo poco a poco el codigo en ingles

Administracion de Jardin de niños.pdf

@@ -8,23 +8,50 @@
 
 ## 🔧 Tecnologías Utilizadas
 
-### 🔙 Backend
-
-- **Node.js** 🟢
-- **Express.js** 🔵
-- **MySQL2** 🐬
-- **Google Auth Libary** 🔡 (Login con google)
-- **Argon2** 🔒 (Hash de contraseñas)
-- **JWT** 🔑 (Autenticación)
-- **Jest y Frisby** 🧪 (Pruebas de las API)
-- **Swagger & Swagger-UI** 📚 (Documentación de la API)
-- **Express Rate Limit** ⏱️ (Limitación de peticiones)
-- **Helmet** 🛡️ (Seguridad en headers HTTP)
-- **CORS** 🌐 (Permite el acceso entre dominios)
-- **Morgan** 🪵 (Middleware de logging)
-- **Commander & Inquirer** ⚙️ (Comandos CLI)
-- **Formkit Tempo** 🕒 (Fechas en formato entendible y legible)
-- **Husky** 🐶 (Hooks de Git)
+### 🔙 Backend - Stack y Librerías
+
+Tecnologías y herramientas utilizadas en el backend de este proyecto:
+
+#### 🧠 Core & Framework
+- **Node.js** 🟢 – Entorno de ejecución de JavaScript para backend.
+- **Express.js** ⚡ – Framework web minimalista para crear APIs y servidores HTTP.
+
+#### 🛡️ Seguridad y Autenticación
+- **Argon2** 🔒 – Algoritmo de hashing seguro para contraseñas.
+- **jsonwebtoken (JWT)** 🔑 – Autenticación basada en tokens.
+- **Google Auth Library** 🔐 – Autenticación con cuentas de Google.
+- **helmet** 🛡️ – Configura cabeceras HTTP seguras.
+- **express-rate-limit** ⏱️ – Protección contra ataques de fuerza bruta y abuso.
+- **cors** 🌐 – Permite solicitudes entre dominios.
+
+#### 🐬 Base de Datos
+- **MySQL2** 🐬 – Cliente MySQL para Node.js compatible con promesas.
+
+#### 🪵 Logging y Utilidades
+- **morgan** 🪵 – Middleware para registrar peticiones HTTP.
+
+#### 📦 Formateo, Linting y Calidad de Código
+- **prettier** ✨ – Formateador de código automático.
+- **@trivago/prettier-plugin-sort-imports** 🔀 – Ordenamiento automático de imports.
+- **eslint** 🧹 – Linter para mantener un estilo de código consistente.
+- **@eslint/js** ⚙️ – Configuración moderna para `eslint`.
+- **standard** 📏 – Estilo de código estándar para JavaScript.
+
+#### 🧪 Testing
+- **jest** ✅ – Framework de testing.
+- **frisby** 🧪 – Librería para pruebas HTTP y APIs REST.
+- **@faker-js/faker** 👻 – Generador de datos falsos para pruebas.
+
+#### ⚙️ Automatización y Entorno de Desarrollo
+- **nodemon** 🔄 – Reinicio automático del servidor al detectar cambios.
+- **concurrently** 🧵 – Ejecuta múltiples comandos en paralelo.
+- **dotenv** 🧬 – Carga variables de entorno desde archivos `.env`.
+- **husky** 🐶 – Automatiza scripts en Git como pre-commit o pre-push.
+
+#### 📚 Documentación
+- **swagger-jsdoc** 📝 – Generador de especificaciones OpenAPI desde JSDoc.
+- **swagger-ui-express** 🌐 – Interfaz de usuario Swagger para probar la API.
+- **swagger-themes** 🎨 – Temas visuales personalizados para Swagger UI.
 
 ---
 
@@ -49,7 +76,7 @@
 
 ## Modelo relacional de la Base de Datos 🗄️
 
-![Administracion de jardin de niños](/assets/Administracion%20de%20jardin%20de%20niños.png)
+![Administracion de jardin de niños](/assets/Administracion%20de%20jardin%20de%20niños.svg)
 
 ---
 
@@ -110,7 +137,7 @@ cd Backend_RESTFULL
 2. Instalar las dependencias
 
 ```
-yarn install
+pnpm install
 ```
 
 3. Crear un archivo .env con las siguientes variables:
@@ -128,15 +155,20 @@ JWT_SECRET=your_jwt_secret
 
 ---
 
-## 🚀 Comandos
+## 📦 Scripts disponibles
+
+Estos son los scripts definidos en el archivo `package.json`, los cuales automatizan tareas comunes de desarrollo y pruebas.
+
+| Script                 | Comando                                                                                     | Descripción                                                                 |
+|------------------------|---------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------|
+| `start`                | `nodemon server.js`                                                                         | Inicia el servidor en modo desarrollo usando `nodemon`.                                                         |
+| `dev`                  | `nodemon server.js`                                                                         | Alias de `start`. Ideal para entornos de desarrollo.                                                             |
+| `format`               | `prettier 'src/**/*.{js,ts,jsx,tsx,json}' server.js package.json --write`                   | Formatea el código en la carpeta `src`, `server.js` y `package.json` usando Prettier.                           |
+| `prepare`              | `husky`                                                                                     | Configura los hooks de Git mediante Husky (se ejecuta automáticamente al instalar dependencias).                |
+| `test`                 | `jest`                                                                                      | Ejecuta los tests unitarios utilizando Jest.                                                                     |
+| `test:watch`           | `jest --watchAll`                                                                           | Ejecuta los tests y observa cambios en tiempo real para repetir automáticamente las pruebas.                    |
+| `test:with-server`     | `concurrently --kill-others --success first "pnpm dev" "pnpm test"`                         | Ejecuta el servidor de desarrollo y las pruebas en paralelo. Se detiene si uno de ellos finaliza o falla.       |
 
-| Comando           | Descripción                                         |
-| ----------------- | --------------------------------------------------- |
-| `yarn dev`        | Inicia el servidor en modo desarrollo 🔄            |
-| `yarn start`      | Inicia en modo producción 🚀                        |
-| `yarn format`     | Formatea el código con Prettier 💅                  |
-| `yarn test`       | Ejecuta pruebas unitarias con Jest ✅               |
-| `yarn test:watch` | Ejecuta pruebas automáticamente al hacer cambios 👀 |
 
 ---