Gestión de servicios

• Flujo de trabajo entre gestores y analistas
• Versionamiento de servicios

Flujo de trabajo entre gestores y analistas

Flujo de trabajo para la gestión y publicación de servicios

Esta sección describe el flujo de trabajo institucional para la creación, revisión y publicación de servicios en el Catálogo de Servicios del Estado Dominicano, detallando las responsabilidades y acciones de los gestores institucionales y los analistas en cada etapa.

El flujo está diseñado para garantizar:

• Calidad y consistencia de la información.

• Validación institucional antes de la publicación.

• Protección de los servicios publicados que son consumidos por ciudadanos y sistemas externos.

---

1. Roles involucrados

Gestores institucionales

Son los responsables de:

• Crear y mantener la información de los servicios de su institución.

• Proponer actualizaciones y correcciones.

• Atender observaciones realizadas durante el proceso de revisión.

Analistas

Son los responsables de:

• Revisar y validar los servicios creados o actualizados.

• Garantizar el cumplimiento de lineamientos, normativas y estándares del Catálogo.

• Autorizar la publicación de los servicios.

---

2. Estados del servicio

Durante su ciclo de vida, un servicio puede encontrarse en los siguientes estados:

• Borrador

• En revisión

• Corrección

• Publicado

• Archivado

Cada estado define qué acciones están permitidas y quién puede realizarlas.

---

3. Flujo completo del servicio

Paso 1: Creación del servicio (Estado: Borrador)

• El gestor institucional crea un nuevo servicio.

• El servicio inicia automáticamente en estado Borrador.

• En este estado:

  • El gestor puede completar toda la información del servicio.

  • El servicio no es visible públicamente.

  • El servicio no es consumido por otras plataformas.

📌 Objetivo del estado Borrador:
Permitir la construcción inicial del servicio sin restricciones.

---

Paso 2: Envío a revisión (Estado: En revisión)

• Una vez que el gestor considera que la información está completa y correcta:

  • Cambia el estado del servicio a En revisión.

• A partir de este momento:

  • El servicio queda bloqueado para edición por parte del gestor.

  • El servicio pasa a la cola de revisión de los analistas.

📌 Objetivo del estado En revisión:
Solicitar formalmente la validación institucional del servicio.

---

Paso 3: Revisión del servicio por el analista

El analista revisa el servicio considerando:

• Claridad de la información.

• Coherencia con otros servicios del Catálogo.

• Cumplimiento de lineamientos normativos y técnicos.

El analista puede tomar una de dos decisiones:

---

Opción A: Servicio aprobado (Estado: Publicado)

• Si el servicio cumple con todos los criterios:

  • El analista cambia el estado a Publicado.

• Al publicarse:

  • El servicio se convierte en información oficial.

  • Puede ser visible para la ciudadanía (según su configuración).

  • Puede ser consumido por otras plataformas del Estado.

  • El servicio queda protegido contra ediciones directas por gestores.

📌 Objetivo del estado Publicado:
Garantizar una fuente confiable, estable y validada de información pública.

---

Opción B: Servicio con observaciones (Estado: Corrección)

• Si el servicio requiere ajustes:

  • El analista cambia el estado a Corrección.

  • Registra observaciones y comentarios indicando los cambios necesarios.

• En este estado:

  • El gestor recupera la capacidad de edición.

  • El servicio no se publica ni se expone externamente.

📌 Objetivo del estado Corrección:
Permitir ajustes sin reiniciar el proceso desde cero.

---

Paso 4: Corrección del servicio (Estado: Corrección)

• El gestor institucional:

  • Atiende las observaciones realizadas por el analista.

  • Actualiza la información del servicio.

• Una vez realizadas las correcciones:

  • Cambia nuevamente el estado a En revisión.

• El servicio regresa al flujo de validación del analista.

Este ciclo puede repetirse hasta que el servicio cumpla con los criterios de publicación.

---

4. Publicación y mantenimiento del servicio

Cuando un servicio está en estado Publicado:

• No puede ser editado directamente por gestores.

• Permanece disponible como información oficial.

• Cualquier cambio posterior debe realizarse mediante el mecanismo de versionamiento, el cual cuenta con su propio proceso de revisión y aprobación.

📌 Esto garantiza que:

• La información pública no se vea afectada por cambios en proceso.

• Exista trazabilidad y control institucional sobre cada modificación.

---

5. Archivado de servicios

• Un servicio puede pasar a estado Archivado cuando:

  • Ya no está vigente.

  • Ha sido sustituido por otro servicio.

  • Debe retirarse del Catálogo por decisión institucional.

• Los servicios archivados:

  • No son visibles públicamente.

  • No pueden ser editados ni publicados nuevamente sin una acción administrativa definida.

---

6. Resumen del flujo

1. Gestor crea el servicio → Borrador

2. Gestor envía el servicio → En revisión

3. Analista revisa:

   • Aprueba → Publicado

   • Solicita cambios → Corrección

4. Gestor corrige → En revisión

5. Analista publica → Publicado

---

7. Consideraciones finales

• El flujo de trabajo asegura la calidad y confiabilidad del Catálogo.

• Cada cambio queda sujeto a validación institucional.

• Los servicios publicados se protegen para evitar modificaciones no controladas.

• El proceso fomenta la colaboración clara entre gestores y analistas.

Versionamiento de servicios

1. ¿Qué es una versión de un servicio?

Una versión es una copia controlada de un servicio existente que permite realizar modificaciones sin afectar el servicio vigente que consultan otras plataformas y sistemas del Estado.

El versionamiento existe para:

• Permitir actualizaciones seguras de servicios ya registrados.

• Evitar cambios directos sobre información que ya está siendo utilizada por ciudadanos y sistemas externos.

• Garantizar que toda modificación pase por un proceso de validación antes de convertirse en información oficial.

La versión no reemplaza automáticamente al servicio principal. Solo se convierte en oficial cuando es promovida y aprobada según las reglas establecidas.

---

2. Servicio principal vs versiones

En el Catálogo existen dos niveles de información:

Servicio principal

• Es la versión oficial y vigente del servicio.

• Es la que consumen:

  • El portal ciudadano.

  • Otras plataformas del Estado.

  • Sistemas que consultan el Catálogo mediante integraciones.

• Su estado es determinante para definir quién puede modificarlo.

Versiones del servicio

• Son copias del servicio principal creadas para:

  • Proponer cambios.

  • Actualizar información.

  • Corregir contenidos.

• Los cambios realizados en una versión no afectan al servicio principal hasta que la versión sea promovida.

---

3. Estados del servicio y su impacto en el versionamiento

El comportamiento del versionamiento depende del estado del servicio principal, no del estado asignado dentro de la versión.

Estados editables por gestores

Los gestores solo pueden editar directamente un servicio cuando el servicio principal está en alguno de los siguientes estados:

• Borrador

• Corrección

En estos casos:

• El gestor puede editar el servicio principal.

• El gestor puede crear versiones.

• El gestor puede promover una versión a principal, ya que tiene permisos de edición sobre el servicio.

---

Estados no editables por gestores

Cuando el servicio principal se encuentra en estados como:

• En revisión

• Publicado

Ocurre lo siguiente:

• El servicio principal no puede ser editado por gestores.

• El gestor sí puede crear y editar versiones del servicio.

• El gestor NO puede promover una versión a principal, aunque la versión esté completa o tenga cambios válidos.

Esto es intencional y responde a la necesidad de proteger la información oficial del Catálogo.

---

4. ¿Por qué un gestor no puede promover una versión si el servicio está publicado?

Promover una versión implica actualizar el servicio principal.

Cuando un servicio está en estado En revisión o Publicado:

• El Catálogo asume que esa información:

  • Ya fue validada.

  • Está siendo utilizada por sistemas externos.

  • No debe cambiar sin una validación institucional.

Por esta razón:

• Solo los perfiles autorizados para editar servicios en estos estados (por ejemplo, analistas) pueden promover versiones.

• El gestor queda limitado a proponer cambios, no a publicarlos directamente.

Esto garantiza:

• Trazabilidad.

• Control institucional.

• Consistencia de la información pública.

---

5. Flujo correcto de trabajo para gestores usando versiones

Cuando un gestor necesita actualizar un servicio que ya está en revisión o publicado, el proceso correcto es:

1. Crear una nueva versión del servicio.

2. Realizar los cambios necesarios dentro de esa versión.

3. Marcar la versión como lista para revisión (según el flujo definido).

4. Notificar al equipo responsable de validación para que:

   • Revise los cambios.

   • Decida si la versión puede ser promovida.

Hasta que esto ocurra:

• El servicio principal permanece intacto.

• Los ciudadanos y sistemas externos continúan consultando la información vigente.

---

6. Flujo de trabajo para analistas

Los analistas tienen la responsabilidad de:

• Revisar las versiones creadas por los gestores.

• Validar que los cambios cumplan con:

  • Lineamientos del Catálogo.

  • Normativas vigentes.

  • Estándares de calidad de la información.

• Promover la versión a principal cuando corresponda.

Una vez promovida:

• La versión pasa a ser el nuevo servicio oficial.

• La versión anterior queda registrada como parte del historial.

---

7. Consideraciones importantes

• Cambiar el estado dentro de una versión no modifica los permisos sobre el servicio principal.

• El versionamiento no sustituye el flujo de validación institucional.

• Un servicio publicado no debe volver a borrador salvo decisiones excepcionales.

• El historial de versiones permite:

  • Auditoría.

  • Seguimiento de cambios.

  • Transparencia institucional.