Ciclo de Aprobación

El Ciclo de Aprobación protege tus análisis contra cambios accidentales, garantizando que todas las modificaciones en visualizaciones y dashboards pasen por un proceso de revisión antes de ser publicadas.

Funcionalidades

📝 Borradores

Edita de forma aislada sin afectar la versión publicada

🔍 Solicitudes de Revisión

Envía cambios para aprobación

✅ Aprobaciones

Validación por pares antes de publicar

📚 Historial de Versiones

Auditoría completa de todos los cambios

¿Por qué Usarlo?

• Protección contra errores: Los cambios pasan por revisión antes de afectar a los usuarios
• Gobernanza: Controla quién puede aprobar cambios críticos
• Colaboración: Discusiones y comentarios durante la revisión
• Auditoría: Historial completo de quién hizo qué y cuándo
• Reversibilidad: Restaura versiones anteriores con un clic

Conceptos Principales

Borradores

Un borrador es una copia de trabajo aislada de una visualización o dashboard. Mientras editas el borrador, otros usuarios continúan viendo la versión publicada. Esto permite hacer cambios sin interrumpir a quienes están usando el análisis.

Características de los borradores:

• Aislamiento total de la versión publicada
• Solo el autor puede ver y editar
• Pueden ser descartados en cualquier momento
• No hay límite de tiempo para trabajar en ellos

Solicitudes de Revisión

Cuando tu borrador está listo, creas una solicitud de revisión. Esto notifica a los revisores que hay cambios esperando aprobación. La solicitud incluye:

• Título descriptivo de los cambios
• Descripción detallada (opcional)
• Comparativo entre versión actual y propuesta
• Espacio para comentarios y discusión

Estado de una Solicitud

Estado	Descripción
Pendiente	Esperando revisión
Aprobado	Revisado y aprobado, listo para fusionar
Rechazado	Cambios solicitados
Fusionado	Publicado en la versión principal
Cancelado	Descartado

Versiones

Cada vez que una solicitud se fusiona, se crea una nueva versión inmutable. El historial de versiones permite:

• Ver todas las versiones anteriores
• Comparar versiones
• Restaurar versiones antiguas
• Auditar quién hizo cada cambio

Flujo Estándar

┌─────────────────────────────────────────────────────────────┐
│                                                             │
│  1. CREAR         2. EDITAR        3. SOLICITAR            │
│  ┌─────────┐      ┌─────────┐      ┌─────────┐             │
│  │Borrador │ ───► │ Edición │ ───► │Revisión │             │
│  └─────────┘      └─────────┘      └─────────┘             │
│                                         │                   │
│                                         ▼                   │
│  6. PUBLICADO     5. FUSIONAR      4. APROBAR              │
│  ┌─────────┐      ┌─────────┐      ┌─────────┐             │
│  │ Versión │ ◄─── │ Fusión  │ ◄─── │Aprobación│            │
│  │  Nueva  │      └─────────┘      └─────────┘             │
│  └─────────┘                                                │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Cómo Usar en la Práctica

Creando un Borrador

1. Abre la visualización o dashboard que deseas editar
2. Haz clic en Editar
3. En la ventana, elige Crear nuevo borrador
4. Dale un nombre descriptivo (ej: "Agregar filtro de fecha")
5. Realiza tus cambios normalmente

Borradores Existentes

Si ya existe un borrador activo, puedes continuar trabajando en él en vez de crear uno nuevo.

Editando el Borrador

• Tus cambios quedan aislados de la versión publicada
• Otros usuarios continúan viendo la versión principal
• Puedes alternar entre borrador y versión principal para comparar

Enviando para Revisión

1. Con el borrador abierto, haz clic en Enviar para Revisión
2. Completa:
   • Título: Qué cambió (ej: "Agrega filtro de período")
   • Descripción (opcional): Detalles de los cambios
3. Haz clic en Enviar

Generación con IA

Usa los botones de IA para generar título y descripción automáticamente basándose en tus cambios.

Revisando Solicitudes

1. Accede a Solicitudes de Revisión en el menú
2. Selecciona una solicitud pendiente
3. Analiza los cambios en la pestaña Cambios
4. Agrega comentarios si es necesario
5. Haz clic en Aprobar o Solicitar Cambios

Fusionando (Publicando)

1. Con la solicitud aprobada, haz clic en Fusionar
2. Agrega una descripción del cambio (opcional)
3. Confirma la fusión

La nueva versión ahora está publicada y visible para todos.

Promoción Directa

En casos excepcionales (correcciones urgentes), los administradores pueden publicar directamente:

1. En el borrador, haz clic en Enviar para Revisión
2. Selecciona la pestaña Promover Directamente
3. Informa el motivo (mínimo 10 caracteres)
4. Haz clic en Publicar sin Aprobación

Uso con Moderación

La promoción directa ignora el ciclo de aprobación. Úsala solo para correcciones críticas y urgentes. Todas las promociones directas quedan registradas en el historial.

Comentarios y Discusión

Durante la revisión, autores y revisores pueden intercambiar comentarios:

• Agregar comentario: Escribe en la caja de texto y envía
• Responder: Haz clic en "Responder" en un comentario existente
• Editar: Edita tus propios comentarios (marcados como "editado")
• Eliminar: Elimina tus propios comentarios

Los comentarios se deshabilitan después de que la solicitud se fusiona o cancela.

Historial de Versiones

Cada fusión crea una nueva versión inmutable. Para acceder:

1. Abre la visualización o dashboard
2. Haz clic en el ícono de Historial (reloj)
3. Ve todas las versiones con:
   • Número de versión
   • Fecha y hora
   • Autor
   • Descripción del cambio
   • Si fue promoción directa

Restaurando Versiones

1. En el historial, localiza la versión deseada
2. Haz clic en Visualizar para revisar
3. Haz clic en Promover para restaurarla como versión actual

Nueva Versión

Restaurar una versión antigua crea una nueva versión. El historial permanece intacto.

Gobernanza y Compliance

Aprobaciones Obligatorias

• Todos los cambios pasan por revisión antes de ser publicados
• Configurable: número mínimo de aprobaciones
• Configurable: aprobaciones obligatorias de responsables

Pista de Auditoría

Todos los eventos son registrados:

• Creación de borrador
• Envío para revisión
• Aprobaciones y rechazos
• Fusiones
• Promociones directas
• Cancelaciones

Trazabilidad

Cada versión registra:

• Quién la creó
• Cuándo fue publicada
• Qué solicitud de revisión la originó
• Si fue promoción directa y por qué motivo

Flujo Recomendado para Equipos

Para Cambios Pequeños

Autor → Borrador → Solicitar Revisión → 1 Aprobación → Fusionar

Para Cambios Significativos

Autor → Borrador → Solicitar Revisión → Discusión → 2+ Aprobaciones → Fusionar

Para Correcciones Urgentes

Admin → Borrador → Promoción Directa (con justificación)

Buenas Prácticas

Para Autores

• ✅ Usa nombres descriptivos en los borradores
• ✅ Escribe descripciones claras en la solicitud
• ✅ Responde a los comentarios de los revisores
• ✅ Prueba tus cambios antes de enviar
• ❌ No acumules muchos cambios en un único borrador

Para Revisores

• ✅ Revisa los cambios con atención
• ✅ Deja comentarios constructivos
• ✅ Aprueba solo si estás seguro
• ✅ Usa "Solicitar Cambios" cuando sea necesario
• ❌ No apruebes sin revisar

Para Administradores

• ✅ Define número mínimo de aprobaciones
• ✅ Monitorea el uso de promoción directa
• ✅ Revisa la pista de auditoría periódicamente
• ❌ No uses promoción directa de forma rutinaria

Recursos Adicionales

• Permisos - Configura quién puede aprobar
• Seguridad - Prácticas de seguridad y compliance