Instalación

Ejecución desde el código fuente

La ejecución desde el código fuente permite a los desarrolladores ejecutar rápidamente Flowset Tasklist en un entorno de desarrollo y adaptar la aplicación a sus necesidades con flexibilidad.

Requisitos

Antes de comenzar, asegúrate de tener instalados los siguientes componentes:

Node.js versión 20.19 o superior (se recomienda LTS)
npm versión 8 o superior
Git para clonar el repositorio

Instalación y ejecución

Clona el repositorio del proyecto:

git clone https://github.com/flowset/flowset-tasklist-react-community
cd flowset-tasklist-react-community

Crea un archivo de configuración del entorno:
```
cp .env.example .env.local
```
Edita .env.local y especifica los parámetros de conexión de tu motor BPM:
```
VITE_APP_LOCALE=en
VITE_BPM_ENGINE_API_URL=http://localhost:8080/engine-rest
VITE_BPM_ENGINE_TYPE=OPERATON
```
- VITE_APP_LOCALE — idioma de la interfaz;
- VITE_BPM_ENGINE_API_URL — URL de la API REST del motor;
- VITE_BPM_ENGINE_TYPE — tipo de motor (CAMUNDA_7, OPERATON).
Instala las dependencias:
```
npm install
```
Ejecuta la aplicación en modo de desarrollo:
```
npm run dev
```
Después de iniciar la aplicación correctamente, la interfaz estará disponible en: http://localhost:3000

Para una compilación de producción, puedes utilizar los siguientes comandos:

npm run build
npm run preview

Docker

Para ejecutar rápidamente Flowset Tasklist sin instalar Node.js, puedes utilizar la imagen Docker lista para usar.

Requisitos

Docker
Docker Compose (recomendado para despliegues complejos)

Ejecución mediante Docker

Clona el repositorio del proyecto:

git clone https://github.com/flowset/flowset-tasklist-react-community
cd flowset-tasklist-react-community/docker-compose

Edita el archivo .env, especificando los parámetros de conexión del motor BPM:

VITE_APP_LOCALE=en
VITE_BPM_ENGINE_API_URL=http://localhost:8080/engine-rest
VITE_BPM_ENGINE_TYPE=OPERATON

Inicia el contenedor:
```
docker-compose up -d
```
Comprueba que el contenedor esté en ejecución:
```
docker ps
```
Después de iniciar el contenedor, la interfaz estará disponible en: http://localhost:3000

Si ejecutas Tasklist en un contenedor mientras el motor BPM se ejecuta localmente, debes habilitar las solicitudes CORS.

Para Tomcat, añade el siguiente filtro a web.xml:

<filter>
  <filter-name>CorsFilter</filter-name>
  <filter-class>org.apache.catalina.filters.CorsFilter</filter-class>
  <init-param>
    <param-name>cors.allowed.origins</param-name>
    <param-value>http://localhost:3000</param-value>
  </init-param>
  <init-param>
    <param-name>cors.allowed.methods</param-name>
    <param-value>GET,POST,HEAD,OPTIONS,PUT,DELETE</param-value>
  </init-param>
  <init-param>
    <param-name>cors.allowed.headers</param-name>
    <param-value>Content-Type,Accept,X-Requested-With,Authorization,Origin</param-value>
  </init-param>
  <init-param>
    <param-name>cors.exposed.headers</param-name>
    <param-value>Location</param-value>
  </init-param>
</filter>

<filter-mapping>
  <filter-name>CorsFilter</filter-name>
  <url-pattern>/*</url-pattern>
</filter-mapping>

Para Operaton Run, añade la siguiente configuración a default.yml:

operaton.bpm:
  run:
# https://docs.operaton.org/docs/documentation/user-guide/operaton-bpm-run/#cross-origin-resource-sharing
    cors:
      enabled: true
      allowed-origins: "http://localhost:3000"

Detención del contenedor

Para detener el contenedor, utiliza el comando:

docker-compose down

Si quieres ejecutar el contenedor directamente sin Docker Compose, utiliza:

docker run -d --name flowset-tasklist -p 3000:3000 \
  -e VITE_BPM_ENGINE_API_URL=http://localhost:8080/engine-rest \
  -e VITE_BPM_ENGINE_TYPE=OPERATON \
  flowset/flowset-tasklist-react-community:latest