Glosario

Referencia rápida de los términos específicos de Aptli utilizados en toda la plataforma y en esta guía.

Datos y registros

Modelo versionado

Registros que pasan por un ciclo de borrador → comparación → confirmación antes de que los cambios sean permanentes. Los registros versionados admiten edición sin conexión, deshacer/rehacer, detección de conflictos y un historial completo de versiones. En Aptli, los elementos del mapa (puntos, líneas, polígonos, capas, esquemas) y las tareas utilizan el modelo versionado.

Contraste con: Modelo en tiempo real

Modelo en tiempo real

Registros que se guardan inmediatamente en el servidor sin ningún paso intermedio. Los cambios son visibles para todos los usuarios al instante. Las órdenes de trabajo, informes, validaciones, transacciones y sitios utilizan el modelo en tiempo real.

Contraste con: Modelo versionado

Borrador

Un conjunto de cambios locales en registros versionados que aún no se han confirmado en el servidor. Los borradores se almacenan en el navegador (IndexedDB) y persisten entre recargas de página sin acceso a la red. Un usuario puede tener un borrador activo por versión. Los borradores pueden subirse al servidor para revisión del administrador antes de publicarse.

Confirmación (commit)

El acto de aplicar permanentemente los cambios de un borrador al conjunto de datos en producción. Las confirmaciones crean una nueva entrada inmutable en el historial de versiones. Solo los usuarios con el derecho de administrador allowCommits pueden confirmar.

Conflicto de versión

Ocurre cuando dos usuarios han editado el mismo elemento en borradores sin conexión separados. Aptli detecta conflictos al confirmar comparando la versión base sobre la que se construyó cada borrador con la versión en producción actual. Las confirmaciones en conflicto se marcan para revisión del administrador y no se pueden aplicar hasta que se resuelvan — sin sobrescrituras silenciosas.

Inventario

Recurso

Una definición de un material, consumible, tipo de equipo o categoría de mano de obra. Los recursos definen la unidad de medida, conversiones de unidades opcionales y si la recogida del recurso requiere un facilitador. Ejemplos: cable de fibra de 500 m, perno de anclaje de concreto, hora de equipo de instalación.

Artículo en stock

El saldo actual de un recurso específico en un sitio específico. Los artículos en stock se actualizan exclusivamente mediante transacciones — nunca se editan directamente. Un recurso puede tener artículos en stock en varios sitios simultáneamente.

Sitio

Una ubicación física o lógica que contiene inventario. Los sitios incluyen almacenes, patios de almacenamiento, depósitos de campo, «sitios personales» de trabajadores individuales y vehículos. Cada usuario puede tener un sitio personal que recibe inventario mediante escaneos QR de códigos de retiro.

Transacción

Una entrada de registro inmutable que registra cada movimiento de inventario. Las transacciones no se pueden editar ni eliminar — las correcciones siempre se realizan creando una nueva transacción de ajuste. Tipos de transacciones:

Código de retiro

Un código QR firmado por JWT con límite de tiempo, emitido cuando se asigna una orden de trabajo. Los trabajadores de campo escanean el código de retiro en un almacén para autorizar y recibir los materiales asignados. Los códigos de retiro codifican las cantidades de recursos autorizadas, la asignación a la que pertenecen y un tiempo de vencimiento. Solo el trabajador asignado — o un usuario con el derecho canFacilitatePickups — puede escanearlos.

Código de transferencia

Un código QR firmado por JWT que autoriza una transferencia de stock entre pares. A diferencia de los códigos de retiro, los códigos de transferencia no están vinculados a una orden de trabajo. Pueden generarse para cualquier movimiento entre sitios y ser escaneados por el destinatario para ejecutar la transferencia y registrar la transacción automáticamente.

Gestión de trabajos

Tarea

Una unidad de trabajo planificado con ubicación geoespacial y requisitos de recursos definidos. Las tareas están versionadas — pasan por borrador → confirmación como los elementos del mapa. Una tarea puede ubicarse en un punto (un pozo de inspección), una línea (un tramo de carretera), un polígono (una urbanización), o dejarse sin ubicar para trabajo de oficina. Las tareas pertenecen a proyectos y se realizan mediante órdenes de trabajo.

Orden de trabajo

Una asignación de una o más tareas a un equipo, con una fecha de vencimiento y un código de retiro opcional para materiales. Las órdenes de trabajo rastrean el estado (pendiente → en progreso → completado) en tiempo real. También se denomina asignación.

Informe

El registro de un trabajador de campo sobre el trabajo completado. Los informes capturan qué se hizo, la ubicación GPS, los recursos realmente consumidos y las fotos. Los informes pueden enviarse para una tarea formal o de forma ad hoc para mantenimiento no planificado. El envío de un informe activa las deducciones automáticas de stock y notifica a los supervisores.

Validación

La revisión de calidad de un informe enviado por parte de un supervisor. Las validaciones registran el resultado (aprobado / reprobado / necesita revisión / aprobado) y cualquier hallazgo. Una validación reprobada o que necesita revisión devuelve el informe al trabajador; una validación aprobada puede activar los cálculos de liberación de pago.

Proyecto

Un grupo de tareas relacionadas que comparten una fecha de vencimiento y una asignación de equipo. Los proyectos proporcionan una vista de progreso de alto nivel de todas sus tareas e informes.

Seguridad y acceso

Derechos de administrador

Permisos que controlan lo que un usuario puede hacer. Aptli tiene más de 40 derechos de administrador granulares que cubren cada acción de crear, leer, actualizar y eliminar en el sistema. Ejemplos: workOrdersCreate, reportsDelete, allowCommits, canFacilitatePickups, canRunAiQueries. Los derechos de administrador son aditivos — un usuario sin derechos solo puede ver sus propias asignaciones.

Restricción de rol

Filtros restrictivos a nivel de campo que controlan qué datos un usuario no puede ver. Las restricciones de rol se aplican en el servidor: los datos no autorizados nunca se envían al cliente, no se ocultan simplemente en la interfaz. Ejemplo: una restricción en assignedTo = currentUser limita a un contratista a ver solo sus propias órdenes de trabajo. Las restricciones de rol y los derechos de administrador operan como dos capas independientes.

Mapa y SIG

Capa

Una colección nombrada de elementos del mapa que comparten un tipo de geometría (puntos, líneas o polígonos) y un estilo visual (ícono, color, grosor de línea). Las capas definen lo que es un elemento — por ejemplo, una capa «Postes telefónicos» o una capa «Rutas de conductos». Las capas están versionadas.

Esquema

Un diagrama de relaciones que modela las conexiones entre elementos del mapa u objetos abstractos. Los esquemas usan un editor de grafos (nodos y aristas dirigidas) para representar la topología de red, rutas de cables, llenado de conductos o cualquier otra relación difícil de expresar únicamente en un mapa geográfico. Los esquemas están versionados.

Área de borrador

Un área de edición temporal donde se dibuja y refina la geometría antes de confirmarla en elementos del mapa permanentes. El área de borrador permite realizar ediciones complejas — dibujo a mano alzada, ajuste, operaciones de múltiples elementos — para revisarlas antes de publicarlas.