{"id":24822165,"url":"https://github.com/edummorenolp/crud-users-nodejs-express-prisma-ts","last_synced_at":"2026-04-19T03:33:39.143Z","repository":{"id":274486638,"uuid":"922893804","full_name":"EduMMorenolp/CRUD-Users-Nodejs-Express-Prisma-TS","owner":"EduMMorenolp","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-21T05:23:10.000Z","size":113,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-21T06:24:15.211Z","etag":null,"topics":["bcrypt","express","jwt","morgan","nodejs","prisma-orm","swagger","tyepscript"],"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/EduMMorenolp.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-27T09:27:58.000Z","updated_at":"2025-02-21T05:23:13.000Z","dependencies_parsed_at":"2025-02-21T06:22:08.696Z","dependency_job_id":"02206394-56dd-4b2b-a375-b28f049e7f88","html_url":"https://github.com/EduMMorenolp/CRUD-Users-Nodejs-Express-Prisma-TS","commit_stats":null,"previous_names":["edummorenolp/crud-users-nodejs-express-prisma-ts"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EduMMorenolp%2FCRUD-Users-Nodejs-Express-Prisma-TS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EduMMorenolp%2FCRUD-Users-Nodejs-Express-Prisma-TS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EduMMorenolp%2FCRUD-Users-Nodejs-Express-Prisma-TS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EduMMorenolp%2FCRUD-Users-Nodejs-Express-Prisma-TS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/EduMMorenolp","download_url":"https://codeload.github.com/EduMMorenolp/CRUD-Users-Nodejs-Express-Prisma-TS/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245542727,"owners_count":20632553,"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","jwt","morgan","nodejs","prisma-orm","swagger","tyepscript"],"created_at":"2025-01-30T18:26:43.016Z","updated_at":"2026-04-19T03:33:39.093Z","avatar_url":"https://github.com/EduMMorenolp.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%2Fedummorenolp%2Fcrud-users-nodejs-express-prisma-ts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fedummorenolp%2Fcrud-users-nodejs-express-prisma-ts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fedummorenolp%2Fcrud-users-nodejs-express-prisma-ts/lists"}