EnEl La Corocora

Proyecto académico — Business Process based Software Development

Jhon Garcia Johan Hernandez Daniel Villegas

---

Descripción general

Este proyecto modela los procesos principales de una Electrificadora utilizando BPMN 2.0, DMN, Camunda Forms y Camunda Platform.
El objetivo es representar, analizar y automatizar el ciclo completo del servicio eléctrico: desde la toma de lectura del medidor hasta la entrega de la factura final al suscriptor.

Se desarrollaron tres macroprocesos principales y un conjunto de decisiones (DMN) y formularios humanos (Forms) necesarios para operar cada flujo BPM.

---

Macroprocesos

1. Proceso: Tomar Lectura

Representa la actividad que realiza el lector al registrar la lectura del medidor.

Actividades principales

• Validar datos del suscriptor
• Procesar lectura capturada
• Comparar lectura actual vs lectura anterior
• Validación mediante ValidarLectura.dmn
• Manejo de errores y anomalías
• Registro digital de la lectura mediante Camunda Forms
• Almacenamiento en base de datos

Entradas

• lecturaActual
• lecturaAnterior
• Información del medidor y suscriptor

Salidas

• Consumo total
• Lectura validada
• Indicadores de anomalías

---

2. Proceso: Generar Factura

Genera la factura con base en la lectura validada y las reglas de negocio tarifarias.

Actividades del proceso

• Recibir lecturas registradas
• Validar el estado del suscriptor
• Aplicar tarifas CREG por estrato
• Calcular consumo y valor final
• Validación mediante DMN
• Agendamiento técnico en caso de anomalías
• Generación de factura preliminar y final

Salidas

• Factura generada
• Valores de consumo
• Tarifas aplicadas
• Posibles órdenes técnicas

---

3. Proceso: Entregar Factura

Controla el proceso de entrega física de facturas.

Flujos del proceso

• Clasificar facturas por zona
• Asignar ruta de entrega
• Registrar entrega exitosa
• Registrar novedades: dirección incorrecta, usuario ausente, acceso restringido
• Cierre del ciclo de entrega

---

Artefactos incluidos

Los artefactos principales (BPMN, DMN y Form) se encuentran en la carpeta static/ del repositorio.

Archivos BPMN (Procesos) — static/bpmn/

• AgendarVisitaTecnica.bpmn
• Cartera_EMSA.bpmn
• EntregarFactura.bpmn
• EntregarLectura.bpmn
• GenerarFactura.bpmn
• GuardarEntrega.bpmn
• GuardarLectura.bpmn
• TomarLectura.bpmn

Archivos DMN (Reglas de decisión) — static/dmn/

• FinanciamientoEstratos.dmn — reglas tarifarias por estrato
• ValidarEntrega.dmn — valida condiciones para entregar factura
• ValidarLectura.dmn — evalúa si la lectura es válida o anómala
• Verificacion_Saldo.dmn — verifica estado de cartera del suscriptor

Archivos Form (Tareas humanas) — static/form/

• AnotarLectura.form
• Consulta_Estado_Cuenta.form
• Coordenar_Tecnico.form
• DatosLectura.form
• EnviarLecturas.form
• IniciarLectura.form
• MostrarFactura.form
• Notificar_Usuario.form
• RegistrarAvizo.form
• RegistrarEntrega.form
• RegistrarMedidor.form
• RegistrarVisita.form
• Registro_Verificacion_Pago.form
• VerificarCliente.form

---

Tecnologías utilizadas

• Camunda Platform
• BPMN
• DMN
• Camunda Forms
• Java
• Spring Boot
• Maven

Buenas prácticas implementadas

• Separación clara entre tareas humanas y automáticas.
• Uso de DMN para reglas de negocio reutilizables.
• Control de variables mediante IN/OUT mappings en Service Tasks.
• Subprocesos reutilizables y flujo jerárquico.
• Manejo explícito de errores y excepciones.
• Modelos documentados con anotaciones y descripciones.