{"id":31757007,"url":"https://github.com/m0nt4ld0/talento-games","last_synced_at":"2026-04-02T01:45:58.986Z","repository":{"id":286836436,"uuid":"962718364","full_name":"m0nt4ld0/talento-games","owner":"m0nt4ld0","description":"Proyecto en React del curso Talento Tech del primer cuatrimestre 2025","archived":false,"fork":false,"pushed_at":"2025-06-20T02:23:33.000Z","size":8275,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-09T19:31:57.864Z","etag":null,"topics":["firebase-auth","react","react-native","reactjs"],"latest_commit_sha":null,"homepage":"https://talento-games.vercel.app/","language":"JavaScript","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/m0nt4ld0.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-04-08T15:11:35.000Z","updated_at":"2025-07-09T00:51:01.000Z","dependencies_parsed_at":"2025-10-09T19:31:35.399Z","dependency_job_id":"ecb3a3d2-e7f2-4d31-b559-d9dac4f025b7","html_url":"https://github.com/m0nt4ld0/talento-games","commit_stats":null,"previous_names":["m0nt4ld0/respawn-party-website"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/m0nt4ld0/talento-games","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m0nt4ld0%2Ftalento-games","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m0nt4ld0%2Ftalento-games/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m0nt4ld0%2Ftalento-games/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m0nt4ld0%2Ftalento-games/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/m0nt4ld0","download_url":"https://codeload.github.com/m0nt4ld0/talento-games/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m0nt4ld0%2Ftalento-games/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31294128,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T01:43:37.129Z","status":"ssl_error","status_checked_at":"2026-04-02T01:43:36.474Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["firebase-auth","react","react-native","reactjs"],"created_at":"2025-10-09T19:31:24.954Z","updated_at":"2026-04-02T01:45:58.941Z","avatar_url":"https://github.com/m0nt4ld0.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Proyecto Final: Talento Games - Tienda de Videojuegos Retro\n\nEste es un proyecto realizado como parte del curso **Talento Tech - React** durante el primer cuatrimestre de 2025. El proyecto simula un negocio de venta de videojuegos retro y está desarrollado en **React** utilizando **JSX**. La aplicación simula una tienda de videojuegos retro donde los usuarios pueden explorar una variedad de juegos, agregarlos a un carrito de compras y realizar la compra. \n[Demo en YouTube](https://www.youtube.com/watch?v=DRMYStHDOvA)\n\n# Tabla de Contenidos\n\n- [Características](#características)\n- [Tecnologías utilizadas](#tecnologías-utilizadas)\n- [Requerimientos mínimos](#requerimientos-mínimos)\n- [Cómo utilizarlo](#cómo-utilizarlo)\n  - [Clonar el repositorio](#clonar-el-repositorio)\n  - [Instalar las dependencias](#instalar-las-dependencias)\n  - [Configuración del archivo .env](#configuración-del-archivo-env)\n  - [Ejecutar el proyecto](#ejecutar-el-proyecto)\n- [Contribuciones](#contribuciones)\n- [Documentación de usuario](#documentación-de-usuario)\n  - [Inicio](#inicio)\n  - [Nosotros](#nosotros)\n  - [Juegos](#juegos)\n  - [Preguntas](#preguntas)\n  - [Contacto](#contacto)\n  - [Carrito](#carrito)\n  - [Registro de usuario](#registro-de-usuario)\n  - [Iniciar sesión (autenticación)](#iniciar-sesión-autenticación)\n  - [Iniciar sesión como administrador](#iniciar-sesión-como-administrador)\n  - [Página no encontrada (404)](#página-no-encontrada-404)\n\n## Características\n- **Carrito de compras:** Los usuarios pueden agregar juegos al carrito y proceder a la compra.\n- **API de RetroAchievements:** Se consumen datos en tiempo real de la API de RetroAchievements para mostrar información sobre los juegos retro y sus logros.\n- **Interfaz intuitiva:** La interfaz es fácil de usar y se enfoca en una experiencia de compra cómoda.\n- **Autenticación de usuarios:** Tanto con cuenta de Google como con cualquier otro e-mail.\n- **Formulario de contacto:** Recibo en mi correo las consultas que el usuario envía a través de dicho formulario. Cuenta con una validación que impone un límite de hasta 3 (tres) envíos consecutivos. Tras sobrepasar ese límite, deberá esperar 15 (quince) minutos para poder consultar nuevamente.\n- **Panel de Administración:** El usuario con privilegios de administrador será capaz de crear, editar y eliminar productos.\n\n## Tecnologías utilizadas\n- Integración con API de [RetroAchievements](https://retroachievements.org/), para obtener información detallada sobre los juegos retro y sus logros.\n- Autenticación de usuarios con Firebase, ya sea con cuenta de Google o cualquier otro e-mail.\n- Envío del formulario de contacto vía e-mail con Formspree.\n- Usuario con privilegios de administrador.\n- Crear, editar y eliminar productos (comportamiento simulado usando MockAPI).\n- Estilos realizados con Bootstrap for React y CSS personalizado.\n- Animaciones realizadas con Sweet Alert 2 y Framer Motion\n\n## Requerimientos mínimos\n- Node.js v18.x+ (recomendado 20.x)\n- Nvm 18 (recomendado 20.x)\n- Vite 6.2\n\n## Cómo utilizarlo\nA continuación, una guía paso a paso para descargar el proyecto y ejecutarlo localmente.\n### Clonar el repositorio\n\nPara clonar este repositorio en tu máquina local, utiliza el siguiente comando:\n\n```bash\ngit clone https://github.com/m0nt4ld0/respawn-party-website.git\n```\n\n### Instalar las dependencias\nUna vez clonado el repositorio, navega a la carpeta del proyecto y ejecuta el siguiente comando para instalar las dependencias:\n```bash\ncd respawn-party-website\nnpm install\n```\n\n### Configuración del archivo .env\nEste proyecto utiliza variables de entorno para acceder a la API de RetroAchievements y a Firebase. Para configurarlas:\n\nCrea un archivo .env en la raíz del proyecto.\n\nAbre el archivo .env y agrega tus credenciales de RetroAchievements y de Firebase siguiendo este formato:\n\n```bash\nVITE_RA_USERNAME=YOUR_RETROACHIEVEMENTS_USERNAME\nVITE_RA_APIKEY=YOUR_RETROACHIEVEMENTS_API_KEY\n\nVITE_FIREBASE_API_KEY=YOUR_FIREBASE_API_KEY\nVITE_FIREBASE_AUTH_DOMAIN=YOUR_FIREBASE_AUTH_DOMAIN\nVITE_FIREBASE_PROJECT_ID=YOUR_FIREBASE_PROJECT_ID\nVITE_FIREBASE_STORAGE_BUCKET=YOUR_FIREBASE_STORAGE_BUCKET\nVITE_FIREBASE_MESSAGING_SENDER_ID=YOUR_FIREBASE_MESSAGING_SENDER_ID\nVITE_FIREBASE_APP_ID=YOUR_FIREBASE_APP_ID\n\nVITE_FORMSPREE_URL=YOUR_VITE_FORMSPREE_URL\n```\n\n### Ejecutar el proyecto\n```bash\nnpm start\n```\n\n### Contribuciones\nEste proyecto **no admite contribuciones**, por tratarse de un trabajo integrador del curso Talento Tech.\n\n## Documentación de usuario\n### Inicio\nUn carousel responsive con imágenes de juegos retro populares. Debajo ofrece un menú con las consolas retro más visitadas.\n\n### Nosotros\nEsta sección describe brevemente la historia del emprendimiento de venta de juegos retro.\n\n### Juegos\nIncluye el listado completo de las consolas disponibles.\n![Captura desde 2025-06-02 00-03-54](https://github.com/user-attachments/assets/ff890bd4-6925-4a12-ac43-312f60f6e284)\n\nAl hacer clic en \"Ver juegos\" accedemos al catálogo de esa consola. Tendremos un menú Breadcrumb donde podremos volver fácilmente a alguno de los pasos anteriores. \n![Captura desde 2025-06-02 00-07-00](https://github.com/user-attachments/assets/972c0a41-4ba5-4da0-9295-9ce862192dfc)\n\nAl hacer clic en el nombre del juego, se abre el detalle del mismo (que incluye datos como nombre, fecha de lanzamiento, una imagen, cantidad de jugadores, etc). \nTambién podremos agregar el juego al carrito. \n![Captura desde 2025-06-02 00-07-08](https://github.com/user-attachments/assets/d1eb1bb1-167f-4e38-91d3-7e4153772df0)\nNótese que es posible agregar múltiples copias de un mismo juego.\n\n### Preguntas\nContiene una serie de preguntas frecuentes y sus respuestas serán visibles al hacer clic en la pregunta.\n![Captura desde 2025-06-02 00-03-23](https://github.com/user-attachments/assets/0f6cf381-a8a8-4926-93fa-84cee143c9aa)\n\n### Contacto\nA través de este formulario, es posible enviar dudas y/o comentarios. Admite hasta 3 (tres) comentarios consecutivos. \n\nPasado ese límite, advierte al usuario que tendrá que esperar 15 (quince) minutos para poder volver a enviar otra consulta.\n![Captura desde 2025-06-02 00-02-39](https://github.com/user-attachments/assets/0d3cb4ea-c4de-4d8a-8399-cdeeeb926644)\n\n### Carrito\n- Visualizar productos agregados\n- Modificar las cantidades de items de cada producto\n- Quitar productos\n- Eliminar todos los productos (vaciar carrito)\n- Proceder a la compra\n\nSi el carrito está vacío, mostrará el mensaje \"No hay productos en el carrito.\" con un botón que nos invita a explorar el catálogo para seleccionar juegos para adquirirlos.\n![Captura desde 2025-06-01 23-54-59](https://github.com/user-attachments/assets/da4b0ae1-a6a3-4838-b550-57e56d828f1d)\n\nEn la pantalla de compra nos pide que ingresemos una tarjeta de crédito. La validación está hecha con el algorimno de Luhn, para poder avanzar de pantalla recomiendo usar una herramienta como este [generador de tarjetas Fake](https://neapay.com/online-tools/credit-card-number-generator-validator.html).\n\nEjemplo:\n\n- **Número**: 4514884147835118\n- **CVV**: 147\n- **Vencimiento**: 10/29\n\nAl procesar la compra, nos muestra un mensaje de éxito, y nos redirige a la homepage.\n\n![image](https://github.com/user-attachments/assets/22610d2c-38c5-46da-912f-aa8f483c5113)\n\n### Registro de usuario\n\n### Iniciar sesión (autenticación)\nLa web ofrece la posibilidad de autenticarse usando una cuenta de Google, o autenticarse utilizando otro e-mail que haya sido registrado previamente (ver Registro de usuario). \n\nAl hacer clic en el botón Ingresar de la barra de navegación, nos lleva a la siguiente página para iniciar sesión en el sitio:\n![Captura desde 2025-06-01 23-59-10](https://github.com/user-attachments/assets/76a85a05-be88-4746-ad07-823307b3f6dc)\n\nInmediatamente después de autenticarnos, nos lleva a nuestro perfil. Si iniciamos sesión con nuestra cuenta de Google, muestra nuestra foto:\n![Captura desde 2025-06-02 00-15-55](https://github.com/user-attachments/assets/f7c1e598-6b2a-4f61-b23a-c83cc9055616)\n\n### Iniciar sesión como administrador\nPara inicar sesión con privilegios de Administrador, utilizar:\n``` \ncorreo admin@talentogames.com \ncontraseña admin123\n```\nEsta cuenta de administrador es ficticia, hecha específicamente para demostrar las funcionalidades de agregar, quitar o modificar productos.\n![Captura desde 2025-06-02 00-14-54](https://github.com/user-attachments/assets/2efc3316-97b7-45b8-b9ed-311dfba28e99)\n\nEl administrador tiene la posibilidad de dar de alta nuevos productos, editar los productos existentes y eliminar productos.\n\nAl intentar eliminar un producto, nos va a pedir la confirmación de que realmente estamos seguros, antes de proceder:\n\n\n\n### Página no encontrada (404)\nSi llegaste a esta página, es muy probable que sea porque\n- Escribiste mal una dirección en la barra de direcciones\n- Una página que era parte de la web fue movida o renombrada y no se actualizó algún enlace que tiene que ver con ella\n- Sos desarrollador/a y/o QA y querés comprobar si puse una página 404 personalizada\nEn cualquiera de los casos antes mencionados, vas a ver la siguiente pantalla:\n![Captura desde 2025-06-02 00-07-30](https://github.com/user-attachments/assets/0d3ce7eb-5f4f-4f70-83d0-11975a3772ec)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fm0nt4ld0%2Ftalento-games","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fm0nt4ld0%2Ftalento-games","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fm0nt4ld0%2Ftalento-games/lists"}