5. Playbooks

Documenta los procesos de negocio, reglas y contexto que conectan tus activos técnicos de datos.

5.1 ¿Qué es un Playbook?

Un Playbook es un documento de conocimiento de formato libre que vive junto a tus activos de datos en Metaustral. Mientras que los activos de datos (tablas, dashboards, KPIs) describen la capa técnica —qué es el dato—, los Playbooks describen la capa de negocio: cómo debe usarse, por qué fue construido y qué procesos o reglas lo gobiernan.

Casos de uso típicos de Playbooks:

• Documentar un proceso de negocio (ej: "Cómo se calcula el ingreso mensual")
• Capturar reglas de negocio asociadas a KPIs o reportes específicos
• Escribir runbooks para pipelines de datos — qué hacer cuando falla un job
• Explicar el contexto y la propiedad detrás de un dominio o producto de datos
• Onboardear nuevos miembros del equipo sobre cómo fluyen los datos en la organización

Playbooks en el catálogo — cada tarjeta muestra el título, categoría, estado, cantidad de activos vinculados, propietario y una vista previa del contenido. Los Playbooks se pueden filtrar desde el selector de tipo en el sidebar.

5.2 Propiedades

Cada Playbook tiene los siguientes campos de metadatos:

Las propiedades se pueden editar inline desde la tabla de Data Assets en Gestión de datos, o desde la pestaña Overview dentro de la página del Playbook.

5.3 Redactar contenido

El cuerpo principal de un Playbook es un documento Markdown de formato libre. Cambia a la pestaña Content dentro de la página del Playbook para abrir el editor. El editor soporta:

• Encabezados (#, ##, ###)
• Negrita e itálica (**negrita**, *itálica*)
• Listas con viñetas y numeradas
• Bloques de código (delimitados con ```)
• Tablas, citas y líneas horizontales
• Links inline ([texto](url))

El contenido se guarda automáticamente mientras escribes. Se genera automáticamente una tabla de contenidos a partir de tus encabezados, que se muestra en el sidebar derecho de la página del Playbook para facilitar la navegación.

5.4 Vincular a activos de datos

Un Playbook puede vincularse a uno o más activos de datos de tu catálogo. Esto crea una conexión bidireccional: el Playbook referencia los activos que gobierna, y la página de detalle de cada activo vinculado muestra qué Playbooks lo referencian.

Para vincular activos, abre la página del Playbook y ve a la pestaña Linked Assets. Desde ahí puedes buscar y agregar cualquier activo del catálogo. Los activos vinculados se muestran en la tarjeta del Playbook en el catálogo y en el panel de vista rápida.

Página de detalle del Playbook — la pestaña Overview muestra las propiedades y etiquetas; la pestaña Content contiene el editor Markdown; Linked Assets muestra los activos del catálogo vinculados con su tipo, estado y score de calidad.

5.5 Control de acceso

Los Playbooks son visibles para todos los usuarios del tenant, incluyendo Viewers. Solo los Editors y superiores pueden crearlos, editarlos o eliminarlos. La gestión de Playbooks (operaciones masivas, edición inline) es accesible desde la pestaña Data Assets en Gestión de datos.