{"id":18936895,"url":"https://github.com/estefiturin/password-manager-backend","last_synced_at":"2026-03-21T08:30:14.700Z","repository":{"id":261445974,"uuid":"883766803","full_name":"code-byestefi/password-manager-backend","owner":"code-byestefi","description":"LIVE: https://passwords-manager-frontend.netlify.app/login","archived":false,"fork":false,"pushed_at":"2024-11-06T15:14:03.000Z","size":485,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-31T21:28:24.433Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://password-manager-backend-production-68e1.up.railway.app/v3/api-docs","language":"Java","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/code-byestefi.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":"2024-11-05T14:36:36.000Z","updated_at":"2024-11-06T15:25:03.000Z","dependencies_parsed_at":"2024-11-06T16:35:04.737Z","dependency_job_id":null,"html_url":"https://github.com/code-byestefi/password-manager-backend","commit_stats":null,"previous_names":["code-byestefi/password-manager-backend"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code-byestefi%2Fpassword-manager-backend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code-byestefi%2Fpassword-manager-backend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code-byestefi%2Fpassword-manager-backend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code-byestefi%2Fpassword-manager-backend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/code-byestefi","download_url":"https://codeload.github.com/code-byestefi/password-manager-backend/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239937697,"owners_count":19721483,"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":[],"created_at":"2024-11-08T12:09:10.335Z","updated_at":"2026-03-21T08:30:14.650Z","avatar_url":"https://github.com/code-byestefi.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Password Manager | Gestor de Contraseñas Seguro\n\nUna aplicación web moderna y segura para gestionar contraseñas, desarrollada con Spring Boot y React. Este gestor de contraseñas permite a los usuarios almacenar y organizar sus credenciales de forma segura, con características clave como:\n\n✨ **Características Destacadas**:\n- Encriptación robusta de contraseñas\n- Sistema de categorización flexible\n- Autenticación segura con JWT y verificación por email\n- Interfaz intuitiva y responsive\n- Búsqueda y filtrado instantáneo\n- Gestión de categorías personalizada\n\n🛠️ **Stack Tecnológico**:\n- Backend: Spring Boot, Spring Security, JPA/Hibernate\n- Frontend: React, TypeScript, TailwindCSS\n- Base de Datos: PostgreSQL\n- Herramientas: Docker, JWT, React Query\n\n🔐 **Seguridad**:\nImplementa las mejores prácticas de seguridad, incluyendo autenticación de dos pasos vía email, encriptación de datos sensibles y tokens JWT para sesiones seguras.\n\n\n# Documentación API Password Manager\n\n## Autenticación y Usuarios\n\n### Registro y Verificación\n- `POST /api/auth/register`\n  - Registra un nuevo usuario\n  - Body: `{ \"name\": string, \"email\": string, \"password\": string }`\n  - Retorna: Token JWT y datos del usuario\n\n- `POST /api/auth/verify`\n  - Verifica el código enviado por email\n  - Body: `{ \"email\": string, \"code\": string }`\n  - Retorna: Estado de verificación\n\n- `POST /api/auth/resend-code`\n  - Reenvía el código de verificación\n  - Body: `{ \"email\": string }`\n  - Retorna: Confirmación de envío\n\n### Login\n- `POST /api/auth/login`\n  - Autentica al usuario\n  - Body: `{ \"email\": string, \"password\": string }`\n  - Retorna: Token JWT y datos del usuario\n\n## Gestión de Contraseñas\n\n### Operaciones CRUD\n- `GET /api/passwords`\n  - Obtiene todas las contraseñas del usuario\n  - Headers: Authorization Bearer Token\n  - Retorna: Lista de contraseñas encriptadas\n\n- `POST /api/passwords`\n  - Crea una nueva contraseña\n  - Headers: Authorization Bearer Token\n  - Body: \n    ```json\n    {\n      \"name\": string,\n      \"username\": string,\n      \"password\": string,\n      \"websiteUrl\": string (opcional),\n      \"notes\": string (opcional),\n      \"categoryId\": number (opcional)\n    }\n    ```\n  - Retorna: Contraseña creada\n\n- `PUT /api/passwords/{id}`\n  - Actualiza una contraseña existente\n  - Headers: Authorization Bearer Token\n  - Body: Igual que POST pero campos opcionales\n  - Retorna: Contraseña actualizada\n\n- `DELETE /api/passwords/{id}`\n  - Elimina una contraseña\n  - Headers: Authorization Bearer Token\n  - Retorna: 204 No Content\n\n### Operaciones Especiales\n- `GET /api/passwords/{id}/decrypt`\n  - Obtiene la contraseña desencriptada\n  - Headers: Authorization Bearer Token\n  - Retorna: Contraseña en texto plano\n \n## Generador de Contraseñas\n\n### Generación de Contraseñas Seguras\n- `POST /api/passwords/generator`\n  - Genera una contraseña segura\n  - Headers: Authorization Bearer Token\n  - Body (opcional):\n    ```json\n    {\n      \"length\": number,\n      \"includeUppercase\": boolean,\n      \"includeLowercase\": boolean,\n      \"includeNumbers\": boolean,\n      \"includeSpecialChars\": boolean\n    }\n    ```\n  - Retorna:\n    ```json\n    {\n      \"password\": string,\n      \"strength\": string\n    }\n    ```\n\n## Gestión de Categorías\n\n### Operaciones CRUD\n- `GET /api/categories`\n  - Obtiene todas las categorías del usuario\n  - Headers: Authorization Bearer Token\n  - Retorna: Lista de categorías\n\n- `POST /api/categories`\n  - Crea una nueva categoría\n  - Headers: Authorization Bearer Token\n  - Body: `{ \"name\": string }`\n  - Retorna: Categoría creada\n\n- `PUT /api/categories/{id}`\n  - Actualiza una categoría\n  - Headers: Authorization Bearer Token\n  - Body: `{ \"name\": string }`\n  - Retorna: Categoría actualizada\n\n- `DELETE /api/categories/{id}`\n  - Elimina una categoría\n  - Headers: Authorization Bearer Token\n  - Retorna: 204 No Content\n\n### Gestión de Imagen de Perfil\n- `POST /api/profile/image`\n  - Actualiza la imagen de perfil\n  - Headers: Authorization Bearer Token\n  - Content-Type: multipart/form-data\n  - Body: FormData con campo \"image\"\n  - Retorna: ID de la foto y mensaje de confirmación\n\n- `GET /api/profile/image/{id}`\n  - Obtiene una imagen específica\n  - Headers: Authorization Bearer Token\n  - Retorna: Imagen en formato JPEG\n\n- `GET /api/profile/image`\n  - Obtiene la imagen de perfil actual\n  - Headers: Authorization Bearer Token\n  - Retorna: Imagen en formato JPEG\n\n- `DELETE /api/profile/image`\n  - Elimina la imagen de perfil\n  - Headers: Authorization Bearer Token\n  - Retorna: Mensaje de confirmación\n\n## Detalles de Implementación\n\n### Seguridad\n- Todas las rutas (excepto register/login) requieren autenticación JWT\n- Las contraseñas se almacenan encriptadas en la base de datos\n- Verificación por email obligatoria para nuevos usuarios\n- Validación de pertenencia de recursos al usuario actual\n\n### Paginación y Filtrado\n- Los endpoints GET soportan parámetros de query para:\n  - Búsqueda: `?search=término`\n  - Filtrado por categoría: `?categoryId=1`\n  - Paginación: `?page=0\u0026size=10`\n  - Ordenamiento: `?sort=name,desc`\n\n### Validaciones\n- Campos requeridos en registro:\n  - Email válido y único\n  - Contraseña mínimo 8 caracteres\n  - Nombre no vacío\n\n- Campos requeridos en contraseñas:\n  - Nombre no vacío\n  - Usuario no vacío\n  - Contraseña no vacía\n\n### Respuestas de Error\n```json\n{\n  \"message\": \"Descripción del error\",\n  \"timestamp\": \"2024-11-05T12:00:00Z\",\n  \"status\": 400,\n  \"path\": \"/api/passwords\"\n}\n```\n\n### Códigos de Estado\n- 200: Éxito\n- 201: Recurso creado\n- 400: Error de validación\n- 401: No autenticado\n- 403: No autorizado\n- 404: Recurso no encontrado\n- 409: Conflicto (ej: email duplicado)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Festefiturin%2Fpassword-manager-backend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Festefiturin%2Fpassword-manager-backend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Festefiturin%2Fpassword-manager-backend/lists"}