{"id":19628107,"url":"https://github.com/dvtecno/qa-local-testing-env","last_synced_at":"2026-03-19T10:51:54.456Z","repository":{"id":254626932,"uuid":"847058851","full_name":"DVTecno/QA-Local-Testing-Env","owner":"DVTecno","description":"Herramientas y guías para configurar un entorno local de pruebas de QA, incluyendo servidores backend con Spring Boot y frontend con React, para realizar pruebas tempranas y eficaces en el proceso de desarrollo.","archived":false,"fork":false,"pushed_at":"2024-08-24T21:54:38.000Z","size":103,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-29T20:40:45.982Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"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/DVTecno.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}},"created_at":"2024-08-24T18:18:13.000Z","updated_at":"2024-08-24T21:58:16.000Z","dependencies_parsed_at":"2024-08-24T21:31:55.208Z","dependency_job_id":"64a07232-c605-430f-8f60-29ff37ea4002","html_url":"https://github.com/DVTecno/QA-Local-Testing-Env","commit_stats":null,"previous_names":["dvtecno/qa-local-testing-env"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/DVTecno/QA-Local-Testing-Env","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DVTecno%2FQA-Local-Testing-Env","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DVTecno%2FQA-Local-Testing-Env/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DVTecno%2FQA-Local-Testing-Env/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DVTecno%2FQA-Local-Testing-Env/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DVTecno","download_url":"https://codeload.github.com/DVTecno/QA-Local-Testing-Env/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DVTecno%2FQA-Local-Testing-Env/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272815834,"owners_count":24997662,"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","status":"online","status_checked_at":"2025-08-30T02:00:09.474Z","response_time":77,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2024-11-11T11:54:09.729Z","updated_at":"2026-02-09T21:36:25.052Z","avatar_url":"https://github.com/DVTecno.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# QA-Local-Testing-Env\n\n![Portada del Proyecto](./assets/portada.png)\n\nEste repositorio contiene todo lo necesario para levantar los servidores del backend y frontend en tu entorno local para realizar pruebas tempranas de QA. Con esta guía, podrás configurar el entorno de desarrollo y empezar a realizar pruebas de manera autónoma.\n\n## Tabla de Contenidos\n- [Requisitos](#requisitos)\n- [Configuración del Backend](#configuración-del-backend)\n- [Configuración del Frontend](#configuración-del-frontend)\n- [Comandos Útiles](#comandos-útiles)\n- [Solución de Problemas](#solución-de-problemas)\n- [Inicia tu primer proyecto Vite](#inicia-tu-primer-proyecto-vite)\n- [Enlaces de Interés](#enlaces-de-interés)\n\n## Requisitos\n\nAntes de comenzar, asegúrate de tener instaladas las siguientes herramientas:\n\n- [Java JDK](https://www.oracle.com/java/technologies/javase-jdk11-downloads.html) - Versión 21 o superior.\n- [Maven](https://maven.apache.org/) - Para manejar las dependencias del backend.\n- [Node.js](https://nodejs.org/en) - Versión 18.x o superior.\n- [npm](https://www.npmjs.com/) o [yarn](https://yarnpkg.com/) - Para manejar las dependencias del frontend.\n- [MySQL](https://dev.mysql.com/downloads/installer/) - Para la base de datos.\n- [Git](https://git-scm.com/) - Para clonar el repositorio.\n- [Vite](https://vitejs.dev/guide/) - Para levantar el servidor de desarrollo del frontend.\n- [IntelliJ IDEA Community Edition](https://www.jetbrains.com/idea/download/?section=windows) - IDE recomendado para trabajar con Spring Boot.\n- [Visual Studio Code](https://code.visualstudio.com/) - IDE recomendado para trabajar con React.\n\n## Recomendación del IDE\n\nPara trabajar con Spring Boot, **IntelliJ IDEA Community Edition** es altamente recomendado. Este IDE ofrece varias ventajas que facilitan el desarrollo, especialmente para quienes no tienen experiencia avanzada en configuración de entornos:\n\n- **Integración Completa con Java**: IntelliJ IDEA Community Edition viene con soporte integrado para Java, lo que simplifica el desarrollo y evita la necesidad de configurar manualmente el entorno Java.\n- **Configuración Automática de Maven**: El IDE gestiona automáticamente las dependencias y el path de Maven, facilitando la construcción y ejecución del proyecto sin complicaciones adicionales.\n- **Facilidad de Uso**: La configuración automática y las recomendaciones del IDE son especialmente útiles para aquellos que pueden no estar familiarizados con todas las configuraciones y comandos necesarios para levantar un proyecto Spring Boot.\n\n## Configuración del Backend\n\n1. Clona el repositorio y navega a la carpeta del backend:\n\n    ```bash\n    git clone https://github.com/DVTecno/QA-Local-Testing-Env.git\n    cd backend\n    ```\n\n2. Compila el proyecto y descarga las dependencias:\n\n    ```bash\n    mvn clean install\n    ```\n\n3. Configura las variables de entorno:\n\n   - Crea un archivo `application.properties` en `src/main/resources/` con el siguiente contenido:\n\n     ```properties\n     spring.datasource.url=jdbc:mysql://localhost:3306/tu_base_de_datos\n     spring.datasource.username=tu_usuario\n     spring.datasource.password=tu_contraseña\n     ```\n\n4. Levanta el servidor:\n\n    ```bash\n    mvn spring-boot:run\n    ```\n\n    El backend estará corriendo en `http://localhost:8080`.\n\n## Configuración del Frontend\n\n1. Navega a la carpeta del frontend:\n\n    ```bash\n    cd frontend\n    ```\n\n2. Instala las dependencias:\n\n    ```bash\n    npm install\n    ```\n\n3. Levanta el servidor de desarrollo:\n\n    ```bash\n    npm run dev\n    ```\n\n    El frontend estará corriendo en `http://localhost:5200`.\n\n## Comandos Útiles\n\n- **Iniciar el Backend**: `mvn spring-boot:run` (en la carpeta `backend`)\n- **Iniciar el Frontend**: `npm run dev` (en la carpeta `frontend`)\n- **Construir el Frontend para Producción**: `npm run build`\n\n## Verificación de la Configuración\n\nPara asegurarte de que todo se ha configurado correctamente:\n\n1. **Backend**: Visita `http://localhost:8080` en tu navegador. Deberías ver la página de bienvenida o un mensaje indicando que el servidor está corriendo.\n2. **Frontend**: Visita `http://localhost:5200` en tu navegador. Deberías ver la interfaz de la aplicación cargada correctamente.\n3. **Base de Datos**: Usa MySQL Workbench para conectarte a la base de datos en `localhost:3306` y verificar que la base de datos `tu_base_de_datos` existe y es accesible.\n\n## Solución de Problemas\n\n- **Problema 1**: No se puede conectar a la base de datos.\n  - **Causa posible**: MySQL no está corriendo o las credenciales son incorrectas.\n  - **Solución**:\n    1. Verifica que MySQL esté en ejecución. En Linux, usa el comando `sudo systemctl status mysql`. En Windows, usa `sc query mysql`.\n    2. Asegúrate de que las credenciales en `application.properties` sean correctas. Intenta conectarte a la base de datos manualmente usando MySQL Workbench para verificar la conectividad.\n\n- **Problema 2**: El frontend no carga.\n  - **Causa posible**: El backend no está corriendo o hay un problema con el puerto.\n  - **Solución**:\n    1. Asegúrate de que el backend esté corriendo en `http://localhost:8080`.\n    2. Verifica que el servidor de desarrollo del frontend esté en `http://localhost:5200`.\n    3. Revisa la configuración del archivo `.env` en el frontend y asegúrate de que `VITE_API_URL` esté configurado correctamente.\n\n\n## Inicia tu primer proyecto Vite\n\n### Nota de compatibilidad\n\nVite requiere Node.js versión 18+ o 20+. Sin embargo, algunas plantillas requieren una versión superior de Node.js para funcionar, por favor actualiza si tu gestor de paquetes te advierte sobre ello.\n\n### Crear un Proyecto con Vite\n\nPara crear un nuevo proyecto de React usando Vite, sigue estos pasos:\n\n1. Abre tu terminal y ejecuta el siguiente comando:\n\n    ```bash\n    npm create vite@latest\n    ```\n\n2. Sigue las instrucciones que aparecen en la terminal para configurar el proyecto.\n\nDurante la configuración, se te solicitarán las siguientes opciones. Debes seleccionar las siguientes:\n\nSelecciona un framework:\n\nEn la terminal, elige React de la lista de opciones:\n\n```bash\n? Select a framework:\n    Vanilla\n    Vue\n    React \u003c-\n    Preact\n    Lit\n    Svelte\n```\n\nLuego, elige entre JavaScript o TypeScript:\n\n```bash\n? Select a variant:\n    JavaScript \u003c-\n    TypeScript\n```\n\n3. Una vez configurado, navega a la carpeta del proyecto y levanta el servidor de desarrollo:\n\n    ```bash\n    cd nombre-del-proyecto\n    npm install\n    npm run dev\n    ```\n\nEl proyecto estará corriendo en `http://localhost:5200`.\n\n\n## Preguntas Frecuentes\n\n**1. ¿Qué hago si mi puerto 8080 ya está en uso?**\n\nPuedes cambiar el puerto del backend editando el archivo\n `application.properties`:\n```bash\nserver.port=8081\n```\n\n## ¡Todo Listo!\n\nAhora que tienes todo configurado, puedes empezar a realizar tus pruebas en el entorno local. Si encuentras algún problema, revisa la sección de solución de problemas o consulta los enlaces de interés para obtener más ayuda.\n\n## Enlaces de Interés\n\n- **Instalador MySQL Community y MySQL Workbench**:  \n  [MySQL Community](https://dev.mysql.com/downloads/installer/)  \n  [MySQL Workbench](https://dev.mysql.com/downloads/workbench/)\n\n- **Instalador Node.js**:  \n  [Node.js](https://nodejs.org/en)\n\n- **Instalador Vite**:  \n  [Vite](https://es.vitejs.dev/guide/)\n\n- **Instalar IntelliJ IDEA Community Edition**:  \n  [IntelliJ IDEA](https://www.jetbrains.com/idea/download/?section=windows)\n\n- **Instalar Visual Studio Code**:  \n  [Visual Studio Code](https://code.visualstudio.com/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdvtecno%2Fqa-local-testing-env","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdvtecno%2Fqa-local-testing-env","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdvtecno%2Fqa-local-testing-env/lists"}