Preguntas frecuentes

Preguntas frecuentes

Todo lo que necesitas saber sobre NexDok. ¿No encuentras una respuesta? Contacta a nuestro equipo.

Conceptos básicos de la plataforma

¿Qué es NexDok?

NexDok es una plataforma de gestión e inteligencia documental de nueva generación, pensada para organizaciones que necesitan almacenar, organizar, versionar y trabajar en equipo sobre sus documentos de forma segura. Combina las capacidades de un DMS tradicional con búsqueda y respuestas impulsadas por IA, flujos de aprobación y aislamiento de espacios de trabajo multitenant, todo accesible desde una interfaz web moderna y una API REST cómoda para desarrolladores.

¿Para quién está pensado NexDok?

NexDok está diseñado para equipos y organizaciones de cualquier tamaño que gestionan documentos estructurados: desde contratos, políticas y procedimientos hasta manuales técnicos y registros de cumplimiento. Es especialmente útil para equipos legales, áreas de cumplimiento, gestión de calidad, recursos humanos y cualquier unidad de negocio que necesite control de versiones, flujos de aprobación y recuperación inteligente de documentos.

¿Qué tipos de documentos puedo cargar en NexDok?

NexDok admite una amplia variedad de formatos, entre ellos PDF, DOCX, XLSX, PPTX, DOC, XLS, PPT, CSV, TXT, Markdown, HTML, JSON y XML. Cada archivo cargado se almacena de forma segura y se puede versionar, indexar para la búsqueda con IA y organizar en colecciones.

¿Qué es un espacio de trabajo en NexDok?

Un espacio de trabajo es un entorno aislado donde tu equipo almacena y gestiona documentos. Cada espacio tiene sus propios miembros, tipos de documento, colecciones, Security Zones y configuración. Los datos están estrictamente aislados entre espacios: los usuarios de uno no pueden acceder a los documentos de otro. Un mismo usuario puede pertenecer a varios espacios de trabajo y cambiar entre ellos sin interrupciones.

¿Cómo funciona el control de versiones?

Cada documento en NexDok conserva un historial completo de versiones. Cuando cargas un archivo nuevo en un documento existente, se crea automáticamente una nueva versión con un número correlativo. Cada versión es inmutable: una vez creada, no se puede modificar. Puedes ver, descargar y comparar cualquier versión anterior. El sistema distingue la versión más reciente (head) y la versión publicada (la que ven los lectores), que pueden ser distintas.

¿Cuál es la diferencia entre la versión más reciente (head) y la versión publicada?

La versión más reciente (head) es siempre la última versión cargada de un documento. La versión publicada es la que un administrador aprobó y publicó de forma explícita. Puedes cargar varias versiones en borrador mientras la versión publicada sigue sin cambios. Así, los equipos pueden trabajar el contenido antes de ponerlo oficialmente a disposición.

¿Cómo funcionan los tipos de documento?

Los tipos de documento son plantillas que definen la estructura y el comportamiento de los documentos dentro de un espacio de trabajo. Cada tipo especifica un esquema de metadatos personalizado (con campos obligatorios y opcionales), los estados de flujo permitidos, las reglas de transición entre estados, las políticas de retención y la configuración de indexación con IA. Por ejemplo, puedes crear un tipo Contrato con campos como contraparte, fecha de vigencia y valor, y un tipo Política con campos de departamento y frecuencia de revisión.

¿Qué son las colecciones y cómo las uso?

Las colecciones son agrupaciones flexibles para organizar documentos. Un documento puede pertenecer a varias colecciones a la vez. Las colecciones admiten tres niveles de visibilidad: privada (solo la ve su propietario), restringida (tienen acceso usuarios o grupos específicos) y pública dentro del tenant (visible para todos los miembros del espacio de trabajo). También se pueden vincular a Security Zones para un control de permisos adicional.

¿Puedo organizar documentos con metadatos personalizados?

Sí. Cada tipo de documento define un esquema de metadatos con JSON Schema. Al crear o editar un documento, los usuarios completan los campos de metadatos que define su tipo. Después puedes filtrar y buscar documentos por cualquier campo. Por ejemplo, filtrar todos los contratos cuya contraparte sea Acme Corp o todas las políticas que vencen este trimestre.

¿Cuál es el ciclo de vida de un documento en NexDok?

Los documentos siguen un ciclo de vida claro: Borrador, Publicado y Archivado. Los documentos nuevos empiezan como borradores. Un administrador o propietario puede publicar una versión específica y convertirla en el registro oficial. Los documentos se pueden archivar cuando dejan de estar activos (solo lectura, de forma irreversible). Los borradores admiten eliminación lógica. En cada etapa, NexDok registra quién hizo el cambio, cuándo y por qué, lo que ofrece un registro de auditoría completo.

¿NexDok admite cargas masivas de documentos?

Sí. NexDok ofrece una función de carga masiva que te permite cargar varios documentos a la vez. Durante la carga puedes seleccionar un tipo de documento y asignar metadatos, lo que agiliza la incorporación de grandes conjuntos de documentos.

¿Puedo descargar documentos de NexDok?

Sí. NexDok genera URL firmadas, seguras y de duración limitada para descargar documentos. Estas URL vencen a los 10 minutos y no contienen credenciales. Cualquier miembro del espacio de trabajo puede descargar la versión más reciente; para descargar versiones anteriores se necesita el rol de Administrador o Propietario.

¿Hay una API disponible para integraciones?

Sí. NexDok expone una API REST completa que cubre toda la funcionalidad de la plataforma: CRUD de documentos, gestión de versiones, carga de archivos, búsqueda, consultas de IA, flujos de aprobación, gestión de miembros y más. La API admite autenticación con JWT (para aplicaciones de usuario) y con claves de API (para integraciones de servidor a servidor), con alcances y límites de uso configurables.

¿Qué pasa cuando elimino un documento?

En NexDok, la eliminación es lógica: el documento se marca como eliminado, pero no se borra físicamente del almacenamiento. Solo se pueden eliminar documentos en estado de borrador. Los documentos publicados o archivados deben archivarse primero. Este diseño evita la pérdida accidental de datos y facilita el cumplimiento de los requisitos de retención documental.

¿NexDok tiene un panel?

Sí. El panel ofrece una vista rápida de tu espacio de trabajo: cantidad de documentos por estado, actividad reciente, aprobaciones pendientes asignadas a ti, uso de almacenamiento, avance de la indexación con IA y actividad de los miembros, todo actualizado en tiempo real.

Búsqueda e IA

¿Cómo funciona la búsqueda con IA en NexDok?

NexDok usa búsqueda semántica basada en embeddings de OpenAI (text-embedding-3-small, 1536 dimensiones). Cuando se indexa un documento, se extrae su contenido, se divide en fragmentos y cada fragmento se convierte en un embedding vectorial. Cuando buscas, tu consulta también se convierte en un embedding y se compara con todos los fragmentos mediante similitud de coseno en pgvector. Así puedes encontrar documentos por su significado, no solo por coincidencias exactas de palabras clave.

¿Qué es la función Ask?

Ask es un sistema de generación aumentada por recuperación (RAG). Escribes una pregunta en lenguaje natural, NexDok recupera los fragmentos más relevantes mediante búsqueda semántica y los envía, junto con tu pregunta, a un modelo de lenguaje de gran tamaño (GPT-4o-mini). La IA genera una respuesta fundamentada que cita los documentos y pasajes específicos que utilizó. Es especialmente útil para encontrar información rápidamente en bibliotecas documentales grandes.

¿Qué tipos de archivo admiten indexación con IA?

La indexación con IA está disponible para PDF, DOCX, CSV, TXT, Markdown (.md), HTML, JSON, XML y RDF/XML. En estos formatos el contenido se extrae, se fragmenta y se convierte en embeddings automáticamente. Los demás tipos de archivo (como imágenes, hojas de cálculo sin texto o presentaciones) se almacenan y versionan con normalidad, pero no se indexan para la búsqueda con IA.

¿Cómo se extrae el contenido de los documentos para la IA?

NexDok aplica distintas estrategias de extracción según el tipo de archivo: los PDF se procesan con extracción de texto especializada (por página), de los DOCX se extraen párrafos y tablas, y los formatos de texto plano (TXT, MD, HTML, JSON, XML) se decodifican directamente. Luego el texto extraído se divide en fragmentos con una ventana deslizante (512 palabras con 64 de superposición) para conservar el contexto entre fragmentos.

¿Qué significa el estado de indexación con IA?

Cada versión de un documento tiene un estado de indexación: Creado (recién cargado), Cargando (transferencia en curso), Cargado (listo para indexar), En cola (esperando al worker de indexación), Indexando (en proceso), Indexado (se puede buscar por completo, con embeddings), Solo texto (texto extraído sin embeddings) o Fallido (ocurrió un error durante el proceso). Puedes reintentar una indexación fallida en cualquier momento.

¿Puedo buscar dentro de una colección o un tipo de documento específicos?

Sí. Tanto la búsqueda como Ask permiten filtrar por colección, tipo de documento, estado del flujo y estado de indexación con IA. Así puedes limitar tus consultas a partes concretas de tu biblioteca; por ejemplo, buscar solo entre contratos publicados o preguntar solo sobre políticas de recursos humanos.

¿La indexación con IA es automática?

La indexación con IA se inicia automáticamente cuando se publica una versión de un documento. En las versiones no publicadas puedes iniciarla manualmente desde la página de detalle del documento. El proceso se ejecuta de forma asíncrona en un worker en segundo plano, así que no bloquea tu trabajo. La página de detalle consulta periódicamente el estado y muestra el avance en tiempo real.

¿Qué tan precisa es la búsqueda con IA?

La búsqueda semántica encuentra documentos por su significado y no por palabras clave exactas, lo que mejora mucho la exhaustividad en consultas en lenguaje natural. La precisión depende de la calidad y la estructura de tus documentos: los que están bien estructurados, con títulos claros y terminología coherente, dan los mejores resultados. Ask incluye citas de las fuentes para que siempre puedas verificar la respuesta de la IA contra el documento original.

¿Hay límites de uso en las funciones de IA?

Sí. Para asegurar un uso justo y controlar los costos, NexDok aplica límites a la búsqueda (60 consultas por minuto por usuario, 2,000 por día), a Ask (10 consultas por minuto por usuario, 300 por día) y a la indexación (5 activaciones por minuto por usuario). Los límites se pueden ajustar por espacio de trabajo. Las respuestas de la API incluyen el estado de los límites para que las aplicaciones gestionen la limitación sin errores.

¿Puedo usar las funciones de IA mediante la API?

Sí. El endpoint de búsqueda (POST /api/v1/query) y el de Ask (POST /api/v1/ask) están disponibles con autenticación JWT y con claves de API. Las claves de API necesitan el alcance query para la búsqueda y el alcance ask para Ask.

¿NexDok almacena mis consultas de IA?

NexDok registra métricas de uso de la IA (cantidad de consultas por mes) para los informes de uso. El contenido de tus consultas y las respuestas de la IA no se almacenan de forma persistente. Todo el procesamiento de IA ocurre en tiempo real y los resultados se devuelven directamente a quien hace la consulta.

¿Qué modelo de IA usa NexDok?

NexDok usa el modelo text-embedding-3-small de OpenAI (1536 dimensiones) para los embeddings de documentos y la búsqueda semántica, y GPT-4o-mini para la función Ask (RAG). Los modelos se pueden configurar a nivel de plataforma para futuras actualizaciones.

Acceso y seguridad

¿Cómo funciona la autenticación en NexDok?

NexDok usa autenticación estándar de la industria con tokens JWT firmados con ES256 (criptografía asimétrica). Los tokens se validan contra endpoints JWKS públicos, lo que garantiza que no se puedan falsificar. En cada solicitud se verifican el vencimiento, la audiencia y el emisor del token. La plataforma admite inicio de sesión con correo y contraseña, con flujos seguros de restablecimiento de contraseña.

¿Qué roles de usuario hay en un espacio de trabajo?

NexDok ofrece cuatro roles a nivel de espacio de trabajo, con una jerarquía estricta: Lector (acceso de solo lectura a documentos y colecciones), Editor (puede crear y editar documentos, cargar versiones y solicitar aprobaciones), Administrador (gestión completa de documentos y miembros, publicación y archivo, configuración de seguridad) y Propietario (igual que Administrador, con la protección adicional de que el último propietario no se puede eliminar ni degradar).

¿Cómo se aíslan los datos entre espacios de trabajo?

El aislamiento de datos se aplica en todos los niveles. Cada tabla de la base de datos incluye una columna tenant_id y todas las consultas filtran por tenant. Las políticas de Row-Level Security (RLS) están activas en todas las tablas para impedir el acceso entre tenants incluso a nivel de base de datos. El almacenamiento de archivos usa rutas por tenant. La API valida la pertenencia al espacio de trabajo en cada solicitud antes de devolver cualquier dato.

¿Qué son las Security Zones?

Las Security Zones son límites de permisos dentro de un espacio de trabajo. Te permiten crear áreas lógicas (por ejemplo, Departamento Legal, Dirección, Público) y controlar qué usuarios o grupos pueden acceder a los documentos y colecciones de cada zona. Las zonas admiten permisos por usuario y por grupo, con niveles de lector, editor y gestor.

¿Qué son los grupos de acceso?

Los grupos de acceso son conjuntos de usuarios con nombre dentro de un espacio de trabajo. En lugar de otorgar permisos a cada usuario uno por uno, puedes crear un grupo (por ejemplo, Equipo de Finanzas, Auditores Externos), agregarle miembros y luego dar al grupo acceso a colecciones o Security Zones. Cuando se agrega o se quita un usuario del grupo, su acceso se actualiza automáticamente.

¿Cómo funciona el flujo de aprobación?

NexDok ofrece un flujo opcional de aprobación de documentos. Un editor puede enviar a aprobación una versión específica de un documento y elegir uno o más aprobadores entre los miembros del espacio de trabajo. Cada aprobador revisa de forma independiente y aprueba o rechaza. Un solo rechazo cierra la solicitud de inmediato. Cuando todos los aprobadores aprueban, el documento queda listo para publicarse. La aprobación es por versión: cargar una versión nueva no afecta una aprobación pendiente de una versión anterior.

¿Puedo controlar quién publica documentos?

Sí. Solo los usuarios con rol de Administrador o Propietario pueden publicar documentos. Además, cuando hay un flujo de aprobación activo para una versión, la publicación queda bloqueada hasta que todos los aprobadores designados la aprueben. Este doble control (rol + aprobación) garantiza que los documentos pasen por la revisión adecuada antes de ser oficiales.

¿Cómo funcionan las claves de API?

Las claves de API permiten integraciones de servidor a servidor sin necesidad de tokens JWT de usuario. Cada clave está limitada a un espacio de trabajo específico y tiene permisos configurables (upload, query, ask). Las claves se almacenan como hashes SHA-256: la clave original se muestra una sola vez al crearla y nunca se guarda. Las claves pueden tener fecha de vencimiento y se pueden revocar en cualquier momento.

¿NexDok mantiene un registro de auditoría?

Sí. NexDok mantiene varias capas de información de auditoría: una tabla de eventos que registra todos los eventos del ciclo de vida de los documentos (creado, publicado, archivado, eliminado) con el autor, la marca de tiempo y el payload; una tabla de historial del flujo que registra todas las transiciones de estado con instantáneas de antes y después; y un log de auditoría de gobernanza para las operaciones a nivel de cuenta (cambios de miembros, gestión de tenants). Todas las escrituras de auditoría son transaccionales: ocurren de forma atómica con las operaciones que registran.

¿Qué pasa cuando se desactiva a un miembro del espacio de trabajo?

Cuando un administrador desactiva a un miembro, ese usuario recibe de inmediato un error 403 en todas las llamadas a la API de ese espacio de trabajo. Sus datos se conservan y se puede reactivar en cualquier momento sin perder su rol ni su historial. El último propietario activo de un espacio de trabajo no se puede desactivar, lo que evita bloqueos accidentales.

¿Cómo funciona el flujo de invitación de miembros?

Cuando se invita a un nuevo miembro a un espacio de trabajo, queda en estado pendiente. Con su primera llamada autenticada a la API (normalmente al iniciar sesión y cargar la aplicación), su estado se activa automáticamente. Gracias a esta activación diferida no hace falta un paso aparte para aceptar la invitación: el miembro simplemente inicia sesión y empieza a trabajar.

¿Los roles a nivel de cuenta pueden acceder a los documentos del espacio de trabajo?

No. Los roles a nivel de cuenta (Propietario de facturación, Administrador de facturación, Administrador de cuenta) están estrictamente separados de los roles del espacio de trabajo. Un Propietario de facturación puede gestionar suscripciones, crear espacios de trabajo y suspender tenants, pero no puede acceder a ningún documento a menos que también se le agregue explícitamente como miembro de ese espacio. Esta separación evita que los administradores de facturación obtengan acceso automático a contenido sensible.

¿NexDok admite permisos por documento?

Sí. Además de los roles del espacio de trabajo y la visibilidad de las colecciones, NexDok admite listas de control de acceso (ACL) por documento. Los permisos se pueden otorgar a usuarios o roles específicos, o de forma pública dentro del espacio de trabajo. Los tipos de permiso disponibles son lectura, escritura, gestión y publicación. Cuando un documento tiene entradas de ACL, solo pueden acceder a él quienes recibieron el permiso (y los administradores del espacio).

¿Cómo se almacenan los archivos de forma segura?

Todos los archivos se guardan en almacenamiento de objetos en la nube, con rutas por tenant que impiden el acceso entre tenants. Los archivos nunca se entregan directamente: el backend genera URL firmadas de duración limitada (vencen a los 10 minutos) para las descargas. Las credenciales de servicio que acceden al almacenamiento nunca se exponen al frontend ni a quienes consumen la API.

¿Todavía tienes preguntas?

Si tu pregunta no aparece aquí, contáctanos o escribe a support@nexdok.com.