InicioDocumentaciónWorkflows y Procesos

Workflows y Procesos

Documentación del sistema de flujos de trabajo y procesos de la intranet

Contenido

Alta de Nuevo Usuario Día Libre Disposición Comunicación de Bajas

Mantenimiento Estructuras Acciones Automáticas

Sistema de Workflows

Motor de flujos de trabajo configurable

El sistema utiliza un motor de workflows configurable data-driven que permite definir flujos de aprobación sin modificar código. Esto significa que los procesos de validación, aprobación y gestión de solicitudes pueden adaptarse a las necesidades del centro sin necesidad de cambios técnicos.

Ventaja principal

Los estados, transiciones y validaciones se definen en la base de datos, permitiendo ajustar los procesos sin desplegar nuevas versiones.

Gestión de Usuarios

Alta y validación de usuarios

Calendarios

Días libres y permisos

Validaciones

Horarios y documentación

Workflows Configurados

REQUEST

Alta de Nuevo Usuario

request_new_user

Flujo de estados:

Pendiente de Validación

Aprobada - Usuario Creado

Rechazada

Acción automática

Al aprobarse, se crea automáticamente el usuario en el sistema y se envía notificación al solicitante.

REQUEST

Día Libre Disposición

request_free_day

Flujo de estados:

Pendiente

Aprobada

Rechazada

Cancelada por usuario

Reglas especiales

Máximo 3 profesores por día. Límite de 4 días por profesor (configurable).

REQUEST

Comunicación de Bajas

request_sick_leave

Flujo de estados:

Pendiente de Notificación

Notificado

Esperando Documentación

Enviado a Validación

Validado

Rechazado

Documentación requerida

Este workflow requiere documentación médica que debe ser validada por administración.

Mantenimiento de Workflows

Cómo crear y modificar workflows

Pasos para crear un nuevo workflow:

Editar el archivo de configuración

prisma/seed/data/workflows.ts

Añadir la definición del workflow

export const myNewWorkflow = {
  code: 'my_workflow_code',
  name: 'Nombre del Workflow',
  description: 'Descripción',
  entityType: 'REQUEST',
  version: 1,
  isActive: true,
  states: [
    { code: 'pending', name: 'Pendiente', color: 'amber', order: 1, isInitial: true },
    { code: 'approved', name: 'Aprobado', color: 'green', order: 2, isFinal: true }
  ],
  transitions: [
    { fromCode: 'pending', toCode: 'approved', allowedRoles: ['ADMIN'], requiresComment: true }
  ]
}

Actualizar la exportación

Añadir el nuevo workflow al array allWorkflows

Aplicar cambios en BD

npx prisma db seed

Estructura de Estados

Propiedad	Tipo	Descripción
code	string	Identificador único
name	string	Nombre visible
color	string	Color UI (amber, green, red...)
order	number	Orden de aparición
isInitial	boolean	Estado inicial
isFinal	boolean	Estado terminal
isTerminal	boolean	Final sin salida

Estructura de Transiciones

Propiedad	Tipo	Descripción
fromCode	string	Estado origen
toCode	string	Estado destino
allowedRoles	string[]	Roles permitidos
requiresComment	boolean	¿Requiere comentario?
validatorCode	string	Validación personalizada
autoActions	string[]	Acciones automáticas

Acciones Automáticas Disponibles

Acciones que se ejecutan automáticamente en las transiciones

create_notification

Crea notificación al usuario cuando cambia el estado de su solicitud

remove_calendar_event

Elimina evento de calendario al cancelar una solicitud aprobada