Versiones, colaboración y exportación

Una vez abres un documento en el editor de Tendios Create, dispones de tres capacidades clave para trabajar en equipo con seguridad: edición colaborativa en tiempo real, versiones con snapshots y importación/exportación de formatos ofimáticos. Todas se apoyan en Tiptap Collab (Yjs) y en las extensiones Pro de Tiptap.

Colaboración en tiempo real

El editor se conecta a un TiptapCollabProvider usando el tipTapDocumentId asociado al documento. Esto permite que:

• Varias personas editen simultáneamente sin sobrescribirse, gracias al modelo CRDT de Yjs.
• Se muestre el caret y la selección de cada colaborador con su nombre (extensión CollaborationCaret) y el componente ConnectedUsers liste quién está conectado en ese momento.
• Los cambios se sincronicen al servidor automáticamente mientras escribes.

Comentarios en el texto

La extensión CommentsKit de Tiptap Pro permite añadir comentarios a fragmentos seleccionados del documento, crear hilos de discusión y resolverlos cuando se haya tratado el tema. Es útil para revisiones cruzadas con servicios jurídicos, interventoría o responsables técnicos sin salir del editor.

Versiones con snapshots

Tendios Create usa las extensiones Snapshot y SnapshotCompare de Tiptap Pro para capturar versiones del documento. Desde el componente Versioning puedes:

• Consultar la lista de versiones guardadas con su fecha y el usuario asociado.
• Previsualizar el contenido de una versión anterior sin salir del documento actual.
• Comparar dos versiones para ver las diferencias de contenido (watchPreviewContent de la extensión snapshot).
• Restaurar una versión anterior: se emite el evento restoreVersion con el número y fecha de la versión, y el contenido restaurado se convierte en el estado actual.

Sugerencias de IA con seguimiento

El editor incluye una extensión propia de AI suggestion: Vera puede insertar cambios en forma de sugerencia que se muestran marcados en el texto, de modo que los puedes aceptar o rechazar uno a uno. Esto deja una traza clara de qué aportó la IA y qué fue aceptado por el equipo humano.

Variables y citaciones

Entre las extensiones del editor hay soporte para:

• Variables dinámicas que se insertan como tokens y se resuelven al exportar.
• Citaciones generales y específicas de tipo legal (legal-citation), pensadas para referenciar artículos normativos dentro de un pliego.
• Alineación de texto, tablas, imágenes subidas desde el cliente, búsqueda interna, nivel de indentación y diff de encabezados.

Importar desde Word

Desde el menú Archivo → Importar del editor puedes subir un .docx. La mutación useConvertDocumentMutation lo envía al backend, que lo convierte al formato interno de Tiptap. Si el archivo no tiene un formato admitido, se muestra un toast indicando las extensiones soportadas.

Exportar a Word y a PDF

La exportación se realiza desde el mismo menú del editor:

• Word (.docx): se genera en el cliente con la extensión @tiptap-pro/extension-export-docx, añadiendo la cabecera y pie de página configurados a través de utilidades propias (htmlToDocxParagraphs, prepareImagesForDocx).
• PDF: se genera en el backend vía la mutación useExportPdfMutation, aplicando la configuración de exportación de la cuenta (portada, cabecera, pie).

Configuración de exportación

Dentro del editor, el diálogo Document export settings permite revisar la portada (CoverEditor) y la cabecera/pie que se aplicarán al exportar. La previsualización (DocumentExportPreview) muestra el aspecto final antes de generar el archivo.

Recomendación: guarda una versión nombrada del documento antes de cada revisión importante o de cada exportación oficial. Así, si más adelante necesitas demostrar qué se envió en una fecha concreta, podrás volver a esa versión exacta desde el panel de versiones.