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 borrador → diferencia → confirmación antes de que los cambios se hagan permanentes. Los registros versionados admiten la edición sin conexión, deshacer/rehacer, la detección de conflictos y un historial completo de versiones. En Aptli, los elementos cartográficos (puntos, líneas, polígonos, capas, esquemas) y los trabajos utilizan el modelo versionado.

Contrasta con: Modelo en tiempo real

Modelo en tiempo real

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

Contrasta con: Modelo con versiones

Borrador

Conjunto de cambios locales en registros con versiones que aún no se han confirmado en el servidor. Los borradores se almacenan en el navegador y se conservan aunque se actualice la página sin acceso a la red. Un usuario puede tener un borrador activo por versión. Los borradores pueden subirse al servidor para que los revise el administrador antes de su publicación.

Confirmación

Acción de aplicar de forma permanente los cambios de un borrador al conjunto de datos activo. Las confirmaciones crean una nueva entrada inmutable en el historial de versiones. Solo los usuarios con el derecho de administrador allowCommits pueden realizar confirmaciones.

Conflicto de versiones

Se produce cuando dos usuarios han editado el mismo elemento en borradores sin conexión independientes. Aptli detecta los conflictos al realizar la confirmación comparando la versión base a partir de la cual se creó cada borrador con la versión activa actual. Las confirmaciones conflictivas se marcan para que las revise el administrador y no pueden aplicarse hasta que se resuelvan; no se producen sobrescrituras silenciosas.

Inventario

Recurso

Definición de un material, consumible, tipo de equipo o categoría de mano de obra. Los recursos definen sus unidades de medida y política de recogida, y son lo que consume un trabajo consume. El trabajo realizado con los recursos se cataloga por separado como una actividad. Ejemplos: 500 m de cable de fibra óptica, perno de anclaje para hormigón, hora de trabajo del equipo de instalación.

Actividad

Definición de un tipo de trabajo que realiza un equipo: empalmes, tendido de cable, excavación, inspección. Las actividades son el equivalente, en el ámbito del trabajo, de los recursos: un registro independiente con sus propias unidades de medida (§193), al que se hace referencia en una línea de actividad de una orden de trabajo, ya sea seleccionada del catálogo o introducida de forma ad hoc. Opcional: una orden de trabajo no tiene por qué especificar ninguna. Ejemplos: empalme por fusión, tirada de fibra (m), perforación direccional (m). Se gestionan en Administración → Actividades (activitiesCreate / activitiesUpdate / activitiesDelete).

Artículo en stock

El saldo actual de un recurso específico en una ubicación concreta. Los artículos en stock se actualizan exclusivamente mediante transacciones; nunca se editan directamente. Un recurso puede tener artículos en stock en varias ubicaciones simultáneamente.

Ubicación

Una ubicación física o lógica que alberga el inventario. Las ubicaciones incluyen almacenes, patios de almacenamiento, depósitos de campo, «ubicaciones personales» de trabajadores individuales y vehículos. Cada usuario puede tener una ubicación personal que reciba inventario a partir de escaneos de recogida mediante códigos QR.

Transacción

Un asiento contable 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 transacción:

Código de recogida

Un código QR de duración limitada y a prueba de manipulaciones que se emite al asignar una orden de trabajo. Los trabajadores de campo escanean el código de recogida en un almacén para autorizar y recibir los materiales que se les han asignado. Los códigos de recogida contienen las cantidades de recursos autorizadas, la asignación a la que pertenecen y una fecha de caducidad. Solo el trabajador asignado —o un usuario con el derecho canFacilitatePickups— puede escanearlos.

Código de transferencia

Un código QR a prueba de manipulaciones que autoriza una transferencia de existencias entre centros. A diferencia de los códigos de recogida, los códigos de transferencia no están vinculados a una orden de trabajo. Se pueden generar para cualquier movimiento entre centros y el destinatario puede escanearlos para ejecutar la transferencia y registrar la transacción automáticamente.

Recurso en espera

Una designación temporal de «espera» que se utiliza al recibir un envío que contiene artículos que aún no existen en el catálogo de recursos. El personal de campo acepta el envío en el recurso en espera para que el trabajo no se vea bloqueado; posteriormente, el personal de oficina reclasifica el stock en el recurso adecuado una vez que este se haya definido. Evita el callejón sin salida de ««No puedo recibir esto porque no está en el sistema»».

Política de recogida

La única configuración de nivel de control de un recurso que regula quién puede dispensarlo o recogerlo, en cualquier flujo (recogida de trabajo, autopréstamo, transferencia). Uno de estos tres valores:

Recogida facilitada

El comportamiento de un recurso cuya política de recogida está configurada como facilitada. Un trabajador no puede entregarlo por sí mismo; en su lugar, el personal del almacén (un titular del derecho canFacilitatePickups) realiza la recogida en nombre del trabajador mientras este está presente. La transacción registra a ambas partes y el método de escaneo utilizado.

Ejecución del trabajo

Trabajo

Una unidad de trabajo planificada con ubicación geoespacial y requisitos de recursos opcionales. Los trabajos tienen versiones: pasan de borrador a confirmación, al igual que los elementos cartográficos. Un trabajo puede ubicarse en un punto (una boca de alcantarilla), una línea (un tramo de carretera), un polígono (una subdivisión) o dejarse sin ubicar para trabajo de oficina. Los trabajos pertenecen a proyectos y se ejecutan mediante órdenes de trabajo; el trabajo realizado se registra en la línea de actividad de la orden de trabajo.

Orden de trabajo

Asignación de un trabajo a un equipo, con una fecha de vencimiento, una línea de actividad opcional (el trabajo a realizar) y un código de recogida de materiales opcional. Las órdenes de trabajo registran el estado (pendiente → en curso → completado) en tiempo real. También se denomina asignación.

Asignación

Se utiliza indistintamente con orden de trabajo en todo Aptli. Algunas interfaces de usuario siguen denominando el concepto «asignación», pero el registro subyacente y sus derechos de administración se denominan orden de trabajo (workOrdersCreate, workOrdersUpdate, workOrdersDelete). Se refieren a lo mismo.

Informe

Registro del trabajo completado por un trabajador de campo. Los informes recogen lo que se ha realizado, la ubicación GPS, los recursos realmente consumidos y las fotos. Los informes pueden enviarse en el marco de un trabajo formal o de forma ad hoc para un mantenimiento no planificado. El envío de un informe activa deducciones automáticas de stock y notifica a los supervisores.

Validación

Revisión de control de calidad realizada por un supervisor sobre un informe enviado. Las validaciones registran el resultado (aprobado / rechazado / necesita revisión / aprobado con notas) y cualquier observación. Una validación rechazada o que requiera revisión devuelve el informe al trabajador; una validación aprobada puede activar los cálculos para la liberación del pago.

Proyecto

Un grupo de trabajos relacionados que comparten una fecha de vencimiento y una asignación de equipo. Los proyectos ofrecen una visión general del progreso de todos sus trabajos e informes.

Seguridad y acceso

Derechos de administrador

Concesiones permisivas que controlan lo que un usuario puede hacer. Aptli ofrece derechos de administrador granulares que abarcan todas las acciones de creación, lectura, actualización y eliminación del sistema. Ejemplos: workOrdersCreate, reportsDelete, allowCommits, canFacilitatePickups, auditView. Los derechos de administrador son acumulativos: un usuario sin derechos solo puede leer sus propias asignaciones.

Restricción de roles

Filtros restrictivos a nivel de campo que controlan qué datos un usuario no puede ver. Las restricciones de roles se aplican del lado del servidor: los datos no autorizados nunca se envían al cliente, no se limitan a ocultarse en la interfaz de usuario. Ejemplo: una restricción sobre assignedTo = currentUser limita a un contratista a ver únicamente sus propias órdenes de trabajo. Las restricciones de roles y los derechos de administrador funcionan como dos capas independientes.

Solicitud de acceso

Una cuenta pendiente que se crea cuando alguien se registra por su cuenta a través de la página de inicio de sesión. Las solicitudes de acceso permanecen en espera en Admin → Solicitudes de acceso hasta que un administrador las apruebe o las rechace. Si se aprueban, la cuenta pasa a ser un usuario normal; si se rechazan, la solicitud se elimina temporalmente.

Sesión activa única

El modelo de sesión de Aptli permite un inicio de sesión activo por cuenta en todos los dispositivos en cualquier momento. Al iniciar sesión en un nuevo dispositivo, se cierra la sesión anterior; el dispositivo expulsado muestra un aviso único y vuelve a la página de inicio de sesión. Dos pestañas del mismo perfil de navegador comparten una sesión y no se expulsan entre sí.

Bloqueo total

Estado de la cuenta que impide el inicio de sesión por cualquier método. Se activa automáticamente tras repetidos intentos fallidos de inicio de sesión (por defecto: 10 fallos consecutivos) o lo configura manualmente un administrador. Solo puede ser desactivado por un administrador con el derecho usersUpdate.

Modo de mantenimiento

Un modo activado por el administrador que bloquea las operaciones de escritura de los usuarios que no son administradores y muestra un banner a todos los usuarios. Está pensado para breves periodos en los que se está ejecutando una migración o un trabajo por lotes y las operaciones de escritura de los usuarios podrían interferir con el trabajo operativo. Los administradores conservan acceso completo.

Registro de auditoría

Un registro de solo adición que recoge las acciones relevantes en toda la implementación: inicios de sesión, creaciones y ediciones de registros, subidas de archivos, cambios de estado y concesiones de derechos de administrador. Visible por registro en la línea de tiempo integrada en las páginas de detalles, y de forma global en Admin → Historial de auditoría (requiere auditView). Exportable como CSV para revisión externa (requiere auditExport).

Archivado (eliminación temporal)

Un registro marcado como eliminado pero conservado físicamente. Los registros archivados quedan ocultos en las listas y consultas normales; los usuarios con el derecho viewDeleted pueden mostrarlos y recuperarlos si es necesario. Aptli rara vez elimina datos de forma definitiva: el archivo conserva el historial de auditoría y operativo.

Mapas y SIG

Capa

Una colección con nombre de elementos cartográficos que comparten un tipo de geometría (puntos, líneas o polígonos) y un estilo visual (icono, color, grosor de línea). Las capas definen lo que es un elemento; por ejemplo, una capa de «Postes telefónicos» o una capa de «Rutas de conductos». Las capas tienen versiones.

Esquema

Un diagrama de relaciones que modela las conexiones entre elementos cartográficos u objetos abstractos. Los esquemas utilizan un editor de grafos (nodos y aristas dirigidas) para representar la topología de la red, el trazado de los cables, el llenado de los conductos o cualquier otra relación que resulte difícil de expresar únicamente en un mapa geográfico. Los esquemas tienen versiones.

Área de trabajo de dibujo

Un área de edición temporal donde se dibuja y se perfecciona la geometría antes de incorporarla a los elementos cartográficos permanentes. El área de trabajo de dibujo permite revisar las ediciones complejas —dibujo a mano alzada, ajuste automático, operaciones con múltiples elementos— antes de que se publiquen.

Registros de campo

El nombre de la superficie del mapa en la navegación de Aptli, donde residen los elementos geográficos y donde se dibujan, editan y trazan. (Las herramientas del mapa se abren como ventanas desde su barra de herramientas.)

Ventana

Un panel flotante y arrastrable que se abre desde la barra de herramientas del mapa. Cada ventana activa una herramienta: Elementos seleccionados, Búsqueda, Transferencia de datos y Gestor de capas están siempre presentes; Proyectos, Relaciones entre capas y Generador aparecen cuando se dispone de licencia para su función. Una ventana se puede separar en una ventana independiente del navegador para trabajar con varios monitores.

Lente de ejecución

Una superposición del mapa que cambia el color de los elementos existentes según su estado de trabajo derivado, de modo que el estado de un área se pueda leer de un vistazo. Se pueden tener varias activas a la vez. Las lentes incluyen Progreso, Mis órdenes de trabajo, Necesita validación, Fallida, Validada, Necesita revisión, Aprobada con notas y Sin asignar. Se activan desde Gestor de capas → Superposiciones.

Lente de presencia

Un complemento de las lentes de ejecución que resalta los elementos que llevan adjunto un tipo concreto de registro: Tiene trabajo, Tiene esquema, Tiene emplazamiento.

Búsqueda universal

La paleta de comandos de toda la aplicación, que se abre con Cmd/Ctrl-K desde cualquier página. Busca tus registros en toda la aplicación y te lleva directamente a un resultado. Se diferencia de la ventana Buscar del mapa, que localiza elementos y se desplaza hasta ellos.

Trabajar desde el dispositivo

El selector de fuente de lectura (antes «Modo sin conexión») hace que las páginas de listas y el mapa se muestren a partir de una copia local del dispositivo en lugar del servidor en tiempo real, para que puedas seguir trabajando sin conexión. Se combina con Guardar automáticamente en el dispositivo (la cadencia de escritura local) y el Gestor de versiones. Consulta Gestión de versiones.

Automatizaciones y supervisión

Hook

Un destino saliente firmado suscrito a los eventos que elijas: indícale una URL y un secreto de firma, y cada evento que coincida se enviará allí mediante un método POST. La integración saliente más sencilla. Consulta Automatizaciones y supervisión.

Desencadenante de eventos

Una regla de automatización que sigue un modelo desencadenante → condiciones → acciones: cuando se activa un evento y se cumplen las condiciones, se ejecutan una o más acciones (notificar, crear una orden de trabajo, llamar a un webhook, escribir en Postgres y más).

Conector de ingesta

Una fuente de datos externa que envía lecturas de sensores o dispositivos a Aptli, ya sea mediante pull (Aptli consulta la API de un proveedor según una programación) o mediante push (el remitente envía un POST a un punto final del conector utilizando una clave de API de ingesta).

Estación

Un elemento cartográfico sobre el que informa un sensor. Una vez que llegan las lecturas, el registro del elemento muestra el valor más reciente de cada métrica y una gráfica de tendencia de 7 días.

Alarma

Un registro que se genera cuando una lectura supervisada supera un umbral (con histéresis, para evitar oscilaciones) o cuando una fuente deja de enviar datos (detección de sensor inactivo). Las alarmas pasan por las fases Activa → Reconocida → Resuelta, notifican a los destinatarios y pueden escalarse a un segundo nivel si no se reconocen a tiempo.

Resultado

En un proyecto, un gráfico que muestra las series de métricas supervisadas frente a los hitos de trabajo completado: las lecturas se muestran junto al trabajo que puede haberlas influido (correlación para contextualizar, no una afirmación causal). Se puede publicar como un enlace para compartir de solo lectura y revocable.

Límite de conexiones

El contador comercial para las automatizaciones: cada conector de ingesta, clave API y hook reutilizable consume una unidad de un fondo común compartido (las reglas internas de activación por eventos no se contabilizan). Las automatizaciones en sí mismas están incluidas en todos los planes.

Admisión pública (Portal de servicios)

Envío

Un registro que se crea cuando un ciudadano presenta una solicitud a través de un portal de servicios público —no es necesario iniciar sesión—. Incluye un número de referencia público, geometría opcional y archivos adjuntos. El personal lo clasifica y puede convertirlo en una orden de trabajo, un informe o un elemento cartográfico.

Número de referencia

El código breve y compartible que recibe la persona que presenta la solicitud. No contiene identificadores internos y es la forma más duradera de realizar un seguimiento o responder a una solicitud —y, en el dispositivo de la persona que la presenta, de ver una lista de todas sus solicitudes («Mis solicitudes»).

Reenvío para seguimiento

Transferencia de un envío a un sistema externo como un traspaso unidireccional, con un enlace de respuesta de un solo uso y caducable para que el sistema externo pueda enviar su resultado una sola vez. No cambia el estado de la solicitud; se muestra como Reenviado → A la espera de respuesta → Respondido (o Caducado / Revocado).

Responder para actuar

Envío de una orden de trabajo por correo electrónico o SMS para que el destinatario pueda presentar el informe de finalización respondiendo al mensaje, sin necesidad de iniciar sesión. Los enlaces de respuesta son de un solo uso y caducan.

Colaboración y sostenibilidad

Sesión multijugador

Una sesión de coedición en directo y en tiempo real (el complemento de codiseño) identificada mediante un código de 6 dígitos: dos o más personas editan el mismo mapa o registro juntas con cursores visibles, y el anfitrión guarda el resultado acordado en la línea principal. Véase Multijugador.

Recurso de la Comisión / Perfil de emisiones

La funcionalidad del complemento Carbon (en el registro de un elemento del mapa) que adjunta un perfil de emisiones —vinculando el elemento a lo que consume a un ritmo determinado— para que su huella de gases de efecto invernadero se supervise en función de factores de emisión estándar. Véase Carbon.

Indicador de carga de solicitudes

Un pequeño medidor integrado en la aplicación que muestra lo cerca que estás del límite de solicitudes: ámbar a medida que te acercas a él, rojo al alcanzar el límite máximo, con el estado «Poniéndose al día...» cuando la aplicación regula deliberadamente el ritmo de las solicitudes. Es meramente informativo; protege la capacidad de respuesta en caso de uso intensivo.