CERCLES (Creació d'Equips i seguiment del Rendiment i CoL·laboració En projectes d'Enginyeria del Software) es una herramienta diseñada para facilitar la evaluación de las contribuciones individuales en proyectos colaborativos de ingeniería de software. Su principal objetivo es centralizar la información obtenida de GitHub y proporcionar a profesores y estudiantes una visión clara y objetiva de la participación de cada miembro del equipo. Esta solución mejora la transparencia, la equidad y la eficiencia en la evaluación de los proyectos grupales.
| Repositorio | Nombre | Descripción |
|---|---|---|
| cercles-tfg-frontend | CERCLES Frontend | Frontend de la aplicación CERCLES, desarrollado con React. |
| cercles-tfg-backend | CERCLES Backend | Backend de la aplicación CERCLES, desarrollado con Spring Boot. |
Antes de proceder con la instalación de CERCLES, asegúrate de cumplir con los siguientes requisitos:
- IDE: Visual Studio Code (VSC) o cualquier otro IDE para proyectos backend y frontend (como IntelliJ o Eclipse).
- Java Development Kit (JDK): Descargar e instalar la versión 23 del JDK desde Oracle.
- Apache Maven: Instalar Maven para gestionar las dependencias y construir el archivo
.war.- En Linux/Ubuntu:
sudo apt install maven - En Windows: Descargar desde Maven e incluirlo en las variables de entorno.
- En Linux/Ubuntu:
- Node.js y npm: Descargar e instalar la versión 16+ de Node.js desde Node.js.
- Servidor Web Apache Tomcat: Descargar la versión 10.x desde Tomcat Downloads y configurarlo para desplegar aplicaciones web.
- Base de datos MariaDB: Descargar e instalar MariaDB desde MariaDB Official Downloads.
El archivo .war ya debería estar disponible. Si necesitas generarlo nuevamente, puedes hacerlo desde el IDE configurado con Maven. Este archivo se guarda automáticamente en la carpeta target dentro del directorio del proyecto backend.
Copia el archivo .war al directorio webapps del servidor Apache Tomcat. Tomcat se encargará de descomprimir y desplegar el archivo.
- Crear una nueva base de datos en MariaDB o MySQL.
- Guarda la URL, el puerto, el usuario y la contraseña de conexión.
- No es necesario añadir tablas ni datos manualmente; la aplicación los creará automáticamente al ejecutarse por primera vez.
Edita el archivo application.properties, ubicado en src/main/resources del proyecto backend, para incluir los datos de conexión de la base de datos. Un ejemplo de configuración:
# Datasource
spring.datasource.url=jdbc:mariadb://localhost:3306/nombreBD
spring.datasource.username=username
spring.datasource.password=password
spring.datasource.driver-class-name=org.mariadb.jdbc.Driver
# JPA Properties
spring.jpa.database-platform=org.hibernate.dialect.MariaDBDialect
spring.jpa.hibernate.ddl-auto=none
spring.jpa.show-sql=trueInicia Apache Tomcat y verifica que la aplicación esté funcionando accediendo a http://localhost:8080.
| Archivo | Nombre | Descripción |
|---|---|---|
| Manual de usuario | Manual de usuario | Guía para los usuarios de la aplicación CERCLES, explicando cómo usar las funcionalidades. |
| Swagger API | Documentación Swagger API | Acceso al Swagger que describe la API RESTful de CERCLES, creado mediante una GitHub Page |
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.