ADMIN-CDMS-001 a ADMIN-CDMS-007

Admin CDMS

La sección Admin CDMS tiene 7 pestañas para la gestión operacional, mantenimiento de integridad y configuración del repositorio documental.

Tab Documentos

Vista de gestión de todas las versiones de documentos del sistema con búsqueda full-text. La tabla muestra: código, título, versión (label), estado, área y si tiene PDF sellado en R2 (has_sealed_pdf). Los documentos sin PDF sellado se destacan con un indicador de advertencia.

Podés buscar por código o título (mínimo 2 caracteres). El buscador usa debounce y filtra en tiempo real.

Reparse de anchors (por documento)

Cuando un campo del formulario IDT no tiene _docx_anchor definido, el campo se descarta silenciosamente durante la generación del PDF (defecto técnico TD-CTR-FIELD-002). El reparse detecta y reconstruye los anchors analizando el DOCX vinculado a la versión.

Batch Export ZIP

Exporta los archivos sellados (PDF o DOCX) de múltiples documentos en un único ZIP. Útil para entregas de documentación a auditores externos, respaldos o distribución interna.

1. Buscá documentos en el campo de búsqueda (mínimo 2 caracteres)
2. Hacé clic en un resultado para agregarlo a la selección. Podés agregar múltiples documentos de diferentes búsquedas.
3. Para quitar un documento de la selección, hacé clic en el ✕ junto a su nombre
4. Elegí el tipo: PDF (informe sellado) o DOCX (plantilla Word)
5. Hacé clic en Generar ZIP → el servidor genera el archivo y retorna la URL de descarga con el nombre del ZIP y la cantidad de documentos incluidos

Tab Áreas y Códigos

Define los códigos de área del sistema. Los códigos de área se usan en los documentos CDMS, trainings TMS, hallazgos AUM y eventos QEM para clasificar el contenido organizacionalmente.

Campo	Editable	Descripción
Código	No (inmutable)	3-4 letras mayúsculas. Ej: CLD, CLB, SPT. Se crea al registrar el área y no puede modificarse.
Nombre completo	✅	Nombre legible. Ej: "Calidad", "Calibraciones". Editable con ✏.
Color de acento UI	✅	Color hexadecimal (#RRGGBB). Aparece como borde de color en las cards de documentos del área.
Activa	Toggle	Desactivar oculta el área de los selectores nuevos pero no afecta documentos existentes.

Crear área nueva: completá el formulario de "Nueva área" con código (único, mayúsculas), nombre y color → Guardar. El sistema llama a POST /admin/cdms/areas. El código debe ser único en el sistema — si ya existe, el servidor retorna error.

Tab Integridad

Herramientas de verificación y mantenimiento de la integridad del almacenamiento R2. Para uso en procesos de auditoría técnica o ante sospechas de corrupción de datos.

• Verificar hash de un PDF: Ingresá el ID de la versión y ejecutá la verificación. El sistema calcula el SHA-256 del objeto en R2 y lo compara con el hash almacenado en la base de datos al momento del sellado. Si coinciden: ✅ PDF íntegro. Si difieren: ⛔ probable corrupción, reportar inmediatamente.
• Detectar PDFs inválidos: Escanea el bucket buscando objetos menores a 500 bytes (indicador de PDF vacío o parcialmente generado). Retorna la lista de objetos con problema para revisar manualmente.
• Regenerar PDF: Disponible como último recurso para versiones con PDF faltante o corrupto. La regeneración almacena el nuevo PDF en el bucket ion-eqms-uploads-prod con prefijo regenerated/ (sin WORM). El PDF en el bucket WORM (ion-eqms-artifacts-prod) no se modifica ni elimina.

Tab Esquemas IDT

Gestión de los schemas de formulario (Form Builder) para documentos IDT. Un schema define los campos que el técnico debe completar cuando ejecuta ese protocolo en un bundle CTR.

La tabla lista todos los IDTs con:

• Código y título del documento
• Versión vigente
• Estado del schema: sin schema / con schema + contador de campos
• Estado de anchors: todos OK / N campos sin anchor

Hacé clic en un IDT para expandir y ver el listado de campos del schema, con el estado de cada anchor.

Acciones por documento IDT

Acción	Ícono	Descripción	¿Cuándo usar?
Dry Run Reparse	🔍	Previsualiza qué anchors detectaría el parser en el DOCX. No modifica nada.	Antes de aplicar cualquier reparse. Siempre primero.
Aplicar Reparse	⚡	Analiza el DOCX del IDT y actualiza los anchors de todos los campos del schema en la BD.	Cuando el dry run confirma que los anchors detectados son correctos.
Inject	💉	Inyecta manualmente un anchor específico en un campo del schema. Requiere ingresar el field_id y el anchor exacto.	Cuando el reparse automático no detecta el anchor de un campo específico y conocés el anchor correcto.

Tab Storage R2

Interfaz de operaciones de mantenimiento directas sobre el storage Cloudflare R2. Complementa el Tab Documentos con acceso más directo a la capa de storage.

Las operaciones disponibles son las mismas que en el Tab Documentos (reparse por versión ID y batch export) pero sin la capa de búsqueda por nombre — ingresás el ID directamente. Útil cuando ya conocés el ID o cuando la búsqueda del Tab Documentos no está retornando el documento correcto por algún problema de indexación.

Tab Motivos de firma (✍)

Configura los textos predeterminados que aparecen como sugerencias en el modal de firma electrónica. Cada preset está asociado a un módulo-clave que identifica el contexto donde se usa:

Módulo-clave (key)	Dónde aparece
cdms_approve	Modal de firma al efectivizar un documento en CDMS
cdms_reject	Modal de rechazo de documento en CDMS
ccm_approve	Modal de aprobación de Change Control
ccm_reject	Modal de rechazo de Change Control
qem_advance	Modal de avance de estado de evento QEM
ctr_sign_tech	Modal de firma como técnico en bundle CTR
ctr_sign_ver	Modal de firma como verificador en bundle CTR

Editar presets de un módulo

1. Hacé clic en ✏ Editar junto al módulo que querés modificar
2. El textarea muestra los presets actuales, uno por línea
3. Modificá, agregá o eliminá líneas según necesites. Cada línea es un preset independiente.
4. Hacé clic en Guardar — el sistema llama a PUT /admin/cdms/signature-presets/{key}

Para agregar un módulo custom (para integraciones o contextos no estándar), usá el panel "Nuevo módulo custom": ingresá el key único y los presets separados por línea.

Tab Relaciones (🔗)

Panel de administración y auditoría de las relaciones entre documentos (WF-CDMS-REL-001). Permite supervisar, filtrar, eliminar y exportar el grafo de relaciones documentales del sistema.

Ver relaciones de un documento

1. Buscá por código o título (mínimo 2 caracteres, debounce automático)
2. Seleccioná el documento focal en el dropdown
3. El panel carga y muestra todas las relaciones de ese documento: documento relacionado (código + título), nota/motivo de la relación y fecha de creación

Eliminar una relación

Hacé clic en el ícono 🗑 junto a la relación. El sistema pide confirmación. Al confirmar, llama a la API de eliminación y registra el evento relationship_removed en el audit trail con el admin ejecutor. La eliminación es inmediata e irreversible.

Exportar relaciones

• Exportar selección (CSV): genera el CSV en el cliente (sin llamada al servidor) con las relaciones del documento focal actualmente seleccionado. El archivo incluye BOM UTF-8 para compatibilidad con Excel.
• Exportar todo (ZIP/CSV): llama al servidor para generar el export completo de todas las relaciones del sistema. Útil para auditorías o reportes de trazabilidad documental.

Columnas del CSV: Documento Focal — Código / Título, Relacionado — Código / Título, Nota/Motivo, Fecha de creación.