{"id":24829920,"url":"https://github.com/organization-devxp/crud-users-nodejs-express-typescript-prisma","last_synced_at":"2026-04-09T18:09:28.012Z","repository":{"id":274563918,"uuid":"923153134","full_name":"Organization-DevXP/CRUD-Users-Nodejs-Express-TypeScript-Prisma","owner":"Organization-DevXP","description":"Este proyecto es una plantilla inicial para desarrollar APIs en Node.js. Incluye características como autenticación, cifrado de contraseñas, documentación con Swagger, y conexión a bases de datos.","archived":false,"fork":false,"pushed_at":"2025-02-05T18:41:02.000Z","size":104,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-02-05T19:43:17.378Z","etag":null,"topics":["bcrypt","express","express-validator","javascript","jwt","mysql","nodejs","prisma-orm","swagger","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Organization-DevXP.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-27T18:22:40.000Z","updated_at":"2025-02-05T18:41:07.000Z","dependencies_parsed_at":"2025-02-05T19:31:57.909Z","dependency_job_id":null,"html_url":"https://github.com/Organization-DevXP/CRUD-Users-Nodejs-Express-TypeScript-Prisma","commit_stats":null,"previous_names":["organization-devxp/crud-users-nodejs-express-typescript-prisma"],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Organization-DevXP%2FCRUD-Users-Nodejs-Express-TypeScript-Prisma","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Organization-DevXP%2FCRUD-Users-Nodejs-Express-TypeScript-Prisma/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Organization-DevXP%2FCRUD-Users-Nodejs-Express-TypeScript-Prisma/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Organization-DevXP%2FCRUD-Users-Nodejs-Express-TypeScript-Prisma/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Organization-DevXP","download_url":"https://codeload.github.com/Organization-DevXP/CRUD-Users-Nodejs-Express-TypeScript-Prisma/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245574417,"owners_count":20637792,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bcrypt","express","express-validator","javascript","jwt","mysql","nodejs","prisma-orm","swagger","typescript"],"created_at":"2025-01-30T23:39:47.352Z","updated_at":"2026-04-09T18:09:27.984Z","avatar_url":"https://github.com/Organization-DevXP.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# **CRUD Users API - Node.js, Express, TypeScript, Prisma**\n\n## 📜 **Descripción**\n\nEste proyecto es una API RESTful para gestionar usuarios, construida utilizando `Node.js`, `Express` y `TypeScript`. Permite crear, leer, actualizar y eliminar usuarios con un enfoque en autenticación JWT, roles de usuario, y manejo de contraseñas mediante `bcryptjs`.\n\n## ✨ **Características**\n\n- **Autenticación JWT**: Utiliza `JSON Web Tokens (JWT)` para la autenticación de usuarios.\n- **Roles de usuario**: Soporta roles de usuario, permitiendo la gestión de accesos con permisos específicos.\n- **Soft delete**: Implementa un sistema de eliminación lógica (soft delete) para los usuarios.\n- **Restauración de usuarios**: Permite restaurar usuarios eliminados lógicamente.\n- **Manejo de contraseñas**: Las contraseñas se cifran con `bcryptjs` para asegurar la seguridad de los datos.\n- **Swagger UI**: Documentación de la API accesible a través de `Swagger`.\n\n## 🛠️ **Tecnologías utilizadas**\n\n- **Node.js**: Entorno de ejecución de JavaScript.\n- **Express**: Framework para aplicaciones web.\n- **TypeScript**: Superset de JavaScript que agrega tipado estático.\n- **Prisma**: ORM para interactuar con la base de datos (opcional).\n- **JWT (JSON Web Token)**: Autenticación basada en tokens.\n- **bcryptjs**: Cifrado y comparación de contraseñas.\n- **Swagger UI**: Documentación interactiva de la API.\n\n## 📋 **Requisitos**\n\n- **Node.js** (v16 o superior)\n- **npm** (o **yarn** como alternativa)\n- **MySQL** (para la base de datos)\n\n## 🚀 **Instalación**\n\n1. Clona este repositorio:\n\n   ```bash\n   git clone https://github.com/(usuario)/CRUD-Users-Nodejs-Express-Prisma-TS.git\n   ```\n\n2. Accede al directorio del proyecto:\n\n   ```bash\n   cd CRUD-Users-Nodejs-Express-Prisma-TS\n   ```\n\n3. Instala las dependencias:\n\n   ```bash\n   npm install\n   ```\n\n4. Crea el archivo `.env` con las siguientes variables de entorno (puedes usar el `.env.example` como guia):\n\n   ```env\n   # Puerto del servidor\n   PORT=3000\n\n   # Configuración de la base de datos MySQL\n   DATABASE_URL=\"mysql://user:password@host:port/database\"\n\n   # Configuración de JWT\n   JWT_SECRET=yoursecretkey\n\n   # Configuracion de Swagger Server\n   BASE_PATH=api\n   VERSIONS_API=v1\n   BASE_URL=http://localhost\n   ```\n\n5. Si es necesario, ejecuta las migraciones de la base de datos (si usas Prisma):\n\n```bash\nnpx prisma migrate dev\n```\n\n## ⚡ **Ejecución**\n\nEjecuta el siguiente comando para compilar el código TypeScript a JavaScript en la carpeta dist (según la configuración en tsconfig.json):\n\n```bash\nnpm run build\n```\n\nPara iniciar el servidor, ejecuta el siguiente comando:\n\n```bash\nnpm run start\n```\n\n## 📃 **Documentación API (Swagger UI)**\n\nAccede a la documentación interactiva de `Swagger UI` después de iniciar el servidor:\n\n```bash\n✅ La base de datos está online.\n==================================================\n🚀 Servidor corriendo en: http://localhost:3000\n📃 Swagger Docs: http://localhost:3000/api-docs\n==================================================\n```\n\n---\n\n## 📌 Endpoints\n\n### 🔐 Autenticación (`/auth`)\n\n| Método   | Endpoint         | Descripción                |\n| -------- | ---------------- | -------------------------- |\n| **POST** | `/auth/register` | Registrar un nuevo usuario |\n| **POST** | `/auth/login`    | Iniciar sesión             |\n| **POST** | `/auth/logout`   | Cerrar sesión              |\n\n### 👨‍💼 Admin (`/admin`)\n\n| Método     | Endpoint                    | Descripción                        |\n| ---------- | --------------------------- | ---------------------------------- |\n| **GET**    | `/admin/allusers`           | Obtener todos los usuarios         |\n| **GET**    | `/admin/users/{id}`         | Obtener usuario por ID             |\n| **GET**    | `/admin/search`             | Buscar usuarios con filtros        |\n| **PUT**    | `/admin/users/update/{id}`  | Actualizar usuario                 |\n| **DELETE** | `/admin/users/delete/{id}`  | Eliminar usuario (borrado lógico)  |\n| **PUT**    | `/admin/users/restore/{id}` | Restaurar usuario (borrado lógico) |\n\n### 👤 Usuarios (`/users`)\n\n| Método     | Endpoint        | Descripción                       |\n| ---------- | --------------- | --------------------------------- |\n| **GET**    | `/users`        | Obtener datos del usuario         |\n| **PUT**    | `/users/update` | Actualizar usuario                |\n| **DELETE** | `/users/delete` | Eliminar usuario (borrado lógico) |\n\n## 📌 Nuevas Rutas Recomendadas a implementar\n\n### 🔐 Autenticación (`/auth`)\n\n| Método   | Endpoint                | Descripción                          |\n| -------- | ----------------------- | ------------------------------------ |\n| **POST** | `/auth/refresh-token`   | Generar nuevo token de acceso        |\n| **POST** | `/auth/change-password` | Cambiar contraseña autenticado       |\n| **POST** | `/auth/reset-password`  | Solicitar recuperación de contraseña |\n| **POST** | `/auth/verify-email`    | Verificar email del usuario          |\n\n### 👤 Usuarios (`/users`)\n\n| Método    | Endpoint                  | Descripción                    |\n| --------- | ------------------------- | ------------------------------ |\n| **PATCH** | `/users/update-role/{id}` | Cambiar rol de usuario (admin) |\n\n### ⚙️ Utilidades\n\n| Método  | Endpoint  | Descripción                |\n| ------- | --------- | -------------------------- |\n| **GET** | `/health` | Verificar estado de la API |\n\n## 📝 **Licencia**\n\nEste proyecto está bajo la licencia MIT.\n\n## 🌟 Contribuciones\n\n¡Las contribuciones son bienvenidas! Si tienes sugerencias o encuentras errores, no dudes en crear un issue o enviar un pull request.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Forganization-devxp%2Fcrud-users-nodejs-express-typescript-prisma","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Forganization-devxp%2Fcrud-users-nodejs-express-typescript-prisma","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Forganization-devxp%2Fcrud-users-nodejs-express-typescript-prisma/lists"}