Documentación · DataLab

Manual de administrador

Eres el guardián de la calidad del dato. Desde la Mesa de Trabajo revisas cada carga, decides qué llega a producción, defines quién puede reportar y modelas la estructura misma de la información. Esta guía reúne las cuatro responsabilidades del rol admin-datalab.

¿Para quién es esto? Para quien tenga el rol admin-datalab o el rol admin global. Si solo cargas información en las operaciones que tienes asignadas, tu guía es el Manual de usuario.

Tus cuatro responsabilidades

Revisar y aprobar

Validar cada carga en la Mesa de Trabajo y aprobarla o rechazarla con observaciones.

Procesar a RTDB

Llevar lo aprobado a producción y reprocesar cuando cambia el schema.

Gestionar responsables

Asignar quién puede subir cada operación, por área o con override puntual.

Editar schemas

Definir la estructura de cada operación en la fuente de verdad, sin redeploy.

El flujo de una carga en la Mesa de Trabajo

Todo entra por /operaciones. Una carga no aparece en los dashboards hasta que tú la apruebas y la procesas: son dos pasos distintos y deliberados.

1

Revisar la carga

En /operaciones/revisar abres cada carga pendiente. Contrasta que las columnas coincidan con el schema de la operación, que los valores sean coherentes y que corresponda al periodo esperado.

2

Aprobar o rechazar con observaciones

Si está bien, apruebas. Si algo falla, la rechazas dejando una observación clara: esa nota le llega al responsable para que corrija y vuelva a subir. Rechazar es tan valioso como aprobar.

3

Procesar a RTDB

Lo aprobado se lleva a producción desde /operaciones/procesar. Solo en este momento el dato queda disponible para los tableros y consultas públicas.

4

Auditar

En /operaciones/auditoria revisas la trazabilidad: quién subió, quién aprobó, qué se procesó y cuándo. Es tu registro de respaldo ante cualquier verificación.

Reprocesar tras cambiar un schema. Si editas la estructura de una operación, vuelve a /operaciones/procesar y reprocesa las cargas afectadas para que la información en RTDB refleje el nuevo schema. El reprocesamiento es la forma correcta de propagar un cambio estructural.

Vistas del Panel de Operaciones

VistaRutaPara qué
Mesa de Trabajo/operacionesPunto de entrada: estado general de cargas y accesos rápidos.
Revisar/operaciones/revisarAprobar o rechazar cargas con observaciones.
Procesar/operaciones/procesarLlevar lo aprobado a RTDB y reprocesar tras cambios de schema.
Auditoría/operaciones/auditoriaTrazabilidad completa: quién, qué y cuándo.
Responsables/operaciones/responsablesAsignar responsables por área u override por operación.
Espacio para screenshot Mesa de Trabajo Vista de /operaciones con las cargas pendientes de revisión y sus estados.

Gestionar responsables

En /operaciones/responsables defines quién puede subir cada operación. Hay dos niveles y su interacción es la clave del modelo.

El override REEMPLAZA al área, no se suma. Cuando una operación tiene override, los responsables del área quedan excluidos de ella salvo que los agregues explícitamente al override. Si alguien del área debe conservar el acceso, inclúyelo también en la lista del override.

Para el detalle del algoritmo de resolución y la estructura exacta en RTDB, consulta el Modelo de permisos y el manejo de roles.

Editar schemas: la fuente de verdad

Cada operación tiene un schema que define sus columnas, tipos y reglas. Los schemas viven en /DataLab/config/upload_schemas — esa ruta es la fuente de verdad del sistema.

1

Editar el schema

Modificas la definición de la operación en /DataLab/config/upload_schemas. El wizard de carga y el validador leen esta configuración, así que el cambio los alcanza de inmediato.

2

Se propaga sin redeploy

No hace falta desplegar de nuevo la aplicación: los cambios se propagan solos. La próxima carga ya usa la nueva estructura.

3

Reprocesar lo existente

Para que las cargas ya aprobadas reflejen el nuevo schema, reprocésalas desde /operaciones/procesar.

Antes de tocar un schema en producción, revisa el formato de schema y confirma con quién reporta esa operación. Un cambio de columnas puede invalidar las cargas en curso.

Consultar el catálogo

El catálogo es el inventario vivo de operaciones: qué se reporta, en qué área, con qué schema y quién es responsable. Úsalo para tener el mapa completo antes de aprobar, asignar o editar. Puedes recorrerlo desde el Explorador y verificar estructuras con el Validador.

Espacio para screenshot Editor de schemas La configuración de una operación en /DataLab/config/upload_schemas y cómo se refleja en el wizard.
Marco institucional. Este manual describe el enfoque operativo de la plataforma para revisar y publicar información. Cualquier criterio institucional o legal sobre qué se reporta, cómo se conserva o quién autoriza debe consultarse con las políticas oficiales de la Oficina de Planeación.