11.manual-de-desarrollador/11.1-Guía-de-instalación.md

+### Dependencias necesarias
+
+A continuación se listan las versiones de software utilizadas para la creación y compilación del proyecto. Versiones diferentes podrían ser válidas, aunque esto no está garantizado. Todo el software se descargó del [repositorio oficial del CESTIC](https://nexus.servdev.mdef.es/) (accesible desde INTRANET), aunque se incluyen rutas de descarga a los repositorios externos oficiales de cada aplicación.
+
+1. **Node.js (v24.7.0) y npm (v11.5.1)**: Descarga: [nodejs.org](https://nodejs.org/)
+2. **Maven (v3.9.11)**: Descarga: [maven.apache.org](https://maven.apache.org/install.html)
+3. **Java Development Kit (v17.0.2)**: Descarga: [Oracle](https://www.oracle.com/java/technologies/javase-downloads.html)
+
+### Instrucciones para desarrollar el frontend
+
+- Clonar el repositorio
+- Ejecutar una consola/terminal dentro de la carpeta del repositorio.
+- Cambiar al directorio del frontend ejecutando `cd frontend`.
+- Ejecutar `npm install` para instalar las dependencias de Node.js.
+- Realizar los cambios que se requieran en el código. Ejecutado `npm run dev` en la terminal se pueden ver los cambios en tiempo real.
+
+### Instrucciones para desarrollar el backend
+
+- Clonar el repositorio.
+- Importar el proyecto Maven en Eclipse. El directorio raíz del backend contiene el `pom.xml` general y las carpetas de los diferentes módulos. Al importarlo, aparecerán todos los módulos del proyecto.
+- Abrir el menú `Debug Configurations`. Seleccionar `Spring Boot App` y la pestaña `demeter-aplicacion - ArranqueAplicacion`.
+- En la pestaña `Spring Boot` seleccionar `Override properties` e introducir:
+
+```text
+spring.config.location=ruta-a-los-repositorios/demeter/conf/local/application.properties
+```
+
+Esto es necesario ya que `application.properties` no se encuentra dentro del módulo `demeter-aplicacion`.
+
+- En la pestaña `Arguments` seleccionar `VM arguments` e introducir:
+
+```text
+-Dlog.dir="C:/temp/logs" -Dserver.name=localhost -Dnombre.app=demeter
+```
+
+- Guardar y salir.
+- El módulo que se debe ejecutar en el IDE es el denominado `demeter-aplicacion`.
+
+### Instrucciones para desplegar el frontend
+
+- Clonar el repositorio
+- Ejecutar una consola/terminal dentro de la carpeta del repositorio.
+- Cambiar al directorio del frontend ejecutando `cd frontend`.
+- Ejecutar `npm install` para instalar las dependencias de Node.js.
+- Ejecutar `npm run build` para construir los archivos que se deben desplegar en el servidor. Los archivos generados se encontrarán en la carpeta `dist`.
+
+### Instrucciones para desplegar el backend
+
+- Clonar el repositorio
+- Ejecutar una consola/terminal dentro de la carpeta del repositorio.
+- Cambiar al directorio raíz del backend ejecutando `cd demeter`.
+- Compilación. Existen dos formas de compilar el backend, generando un archivo `jar` o un archivo `war`. La diferencia radica en que los `jar` se utilizan para proyectos no desplegados en servidor, mientras que los `war` se usan para aplicaciones desplegadas.
+
+#### Generar el war
+
+- Incluir en el `pom.xml` del módulo `demeter-aplicacion`:
+
+```xml
+<packaging>war</packaging>
+```
+
+- Añadir el siguiente plugin dentro de `<plugins>`:
+
+```xml
+<plugin>
+  <groupId>org.apache.maven.plugins</groupId>
+  <artifactId>maven-war-plugin</artifactId>
+  <version>3.4.0</version>
+  <configuration>
+    <failOnMissingWebXml>false</failOnMissingWebXml>
+  </configuration>
+</plugin>
+```
+
+- Ejecutar en la carpeta raíz del backend (la que contiene el `pom.xml` general y las carpetas de cada módulo) `mvn clean package`
+- El archivo `war` generado se encuentra en la ruta `demeter/demeter/demeter-aplicacion/target`.
+
+#### Generar el jar
+
+- Eliminar del `pom.xml` del módulo `demeter-aplicacion` los elementos especificados en el apartado `war`.
+- Ejecutar en la carpeta raíz del backend (la que contiene el `pom.xml` general y las carpetas de cada módulo) `mvn clean package`
+- El archivo `jar` generado se encuentra en la ruta `demeter/demeter/demeter-aplicacion/target`.
+
+#### Ejecución
+
+En la máquina de despliegue:
+
+- Crear la carpeta `demeter` y dentro de ella la carpeta `logs`.
+- Copiar la carpeta `conf` desde la raíz del repositorio a `demeter`. Esta contiene el archivo `application.properties` y los certificados.
+
+Ejecutar el backend desde la carpeta `demeter` con el comando:
+
+```bash
+java -jar -Dlog.dir="<ruta-a-demeter>\logs" -Dserver.name=<nombre-del-servidor> -Dnombre.app=demeter demeter-aplicacion.jar --spring.config.location="<ruta-a-demeter>\conf\local\application.properties"
+```
+
+Los parámetros de ejecución coinciden con los configurados en Eclipse para el desarrollo.