Glosario Técnico Completo — Bimtrazer

Documento Generado mediante análisis estático del código fuente.
Fecha: 2026-05-01

Servicios

• Término: blocks
  • Significado: Microservicio Go responsable de la gestión y consulta de bloques constructivos (elementos de trabajo BIM). Es el servicio con más endpoints del sistema (31+).
  • Tipo: Servicio
  • Dónde se utiliza: /mnt/usr/src/desarrollo/gopath/bimtracer-backend/blocks/
  • Ejemplo: GET /blocks/by-project/{projectId} — obtiene todos los bloques de un proyecto
• Término: budget
  • Significado: Microservicio Go de control financiero. Gestiona tres tipos de registros: presupuesto planificado, compromisos y gasto real ejecutado.
  • Tipo: Servicio
  • Dónde se utiliza: /mnt/usr/src/desarrollo/gopath/bimtracer-backend/budget/
  • Ejemplo: POST /budget/records — crear registro de presupuesto para una etiqueta
• Término: digitaltwin
  • Significado: Microservicio Go de visualización 3D (Gemelo Digital). Provee datos para renderizar modelos BIM coloreados según estado de ejecución.
  • Tipo: Servicio
  • Dónde se utiliza: /mnt/usr/src/desarrollo/gopath/bimtracer-backend/digitaltwin/
  • Ejemplo: POST /digital-twin — retorna datos de geometría para renderizar modelo 3D
• Término: displacements
  • Significado: Motor de cálculo de desplazamientos de cronograma. Determina nuevas fechas estimadas cuando bloques se retrasan. Es el único servicio que usa Gorilla Mux en lugar de Gin.
  • Tipo: Servicio
  • Dónde se utiliza: /mnt/usr/src/desarrollo/gopath/bimtracer-backend/displacements/
  • Ejemplo: PUT /workprogress — calcula y persiste desplazamientos masivamente
• Término: ifc
  • Significado: Microservicio Go de gestión de archivos IFC (estándar BIM). Maneja carga, versionamiento e integración con Autodesk Platform Services.
  • Tipo: Servicio
  • Dónde se utiliza: /mnt/usr/src/desarrollo/gopath/bimtracer-backend/ifc/
  • Ejemplo: POST /ifc/evaluate-ifc — versiona un archivo IFC y detecta cambios
• Término: items
  • Significado: Microservicio Go de gestión de componentes presupuestarios. Permite definir items (mano de obra, materiales, equipos) y asociarlos con bloques.
  • Tipo: Servicio
  • Dónde se utiliza: /mnt/usr/src/desarrollo/gopath/bimtracer-backend/items/
  • Ejemplo: PUT /items/assign-blocks — asocia bloques constructivos a un item de presupuesto
• Término: labels
  • Significado: Servicio CORE del sistema. Gestiona etiquetas de planificación con jerarquía, pesos, cálculo de avances, proyecciones y factores de compresión. El servicio más complejo (47+ endpoints).
  • Tipo: Servicio
  • Dónde se utiliza: /mnt/usr/src/desarrollo/gopath/bimtracer-backend/labels/
  • Ejemplo: PUT /labels/graph-calculation-v2 — calcula gráficos de proyección con congelación del pasado
• Término: lblsref
  • Significado: Labels Reference. Servicio de propagación de pesos entre etiquetas jerárquicas. Se ejecuta después de labels para propagar cambios en cascada.
  • Tipo: Servicio
  • Dónde se utiliza: /mnt/usr/src/desarrollo/gopath/bimtracer-backend/lblsref/
  • Ejemplo: PUT /labels-calculation — recalcula referencias y pesos en cascada
• Término: lbp
  • Significado: Lean BIM Processing. Microservicio TypeScript/Node.js que transforma bloques IFC crudos en estructura optimizada de Lean BIM con estados calculados.
  • Tipo: Servicio
  • Dónde se utiliza: /mnt/usr/src/desarrollo/gopath/bimtracer-backend/lbp/
  • Ejemplo: POST /leanbim/blocks/map-and-update — mapea y actualiza colección leanbim_blocks
• Término: media
  • Significado: Microservicio Go de gestión de fotografías y videos de obra. Almacena en sistema de archivos local, genera thumbnails y sincroniza con otros servicios.
  • Tipo: Servicio
  • Dónde se utiliza: /mnt/usr/src/desarrollo/gopath/bimtracer-backend/media/
  • Ejemplo: POST /upload-images — sube imagen de obra asociada a un bloque
• Término: messages
  • Significado: Microservicio Go de auditoría y notificaciones. Registra todos los eventos que ocurren en bloques (imágenes, videos, certificaciones). Consumidor pasivo.
  • Tipo: Servicio
  • Dónde se utiliza: /mnt/usr/src/desarrollo/gopath/bimtracer-backend/messages/
  • Ejemplo: POST / — registra evento “se subió imagen para el bloque XYZ”
• Término: projects
  • Significado: Microservicio Go del ciclo de vida de proyectos. Crea proyectos, gestiona configuración, asigna usuarios y provee datos de dashboard.
  • Tipo: Servicio
  • Dónde se utiliza: /mnt/usr/src/desarrollo/gopath/bimtracer-backend/projects/
  • Ejemplo: POST /projects — crea un nuevo proyecto con su base de datos dedicada
• Término: registry
  • Significado: Motor de certificación de bloques. Registra el avance real de obra, valida dependencias preladas y desencadena actualizaciones en cascada.
  • Tipo: Servicio
  • Dónde se utiliza: /mnt/usr/src/desarrollo/gopath/bimtracer-backend/registry/
  • Ejemplo: POST /registry — certifica un bloque con 85% de avance
• Término: sequences
  • Significado: Motor de análisis de dependencias entre bloques. Calcula secuencias PERT/CPM, detecta rutas críticas y verifica ausencia de ciclos.
  • Tipo: Servicio
  • Dónde se utiliza: /mnt/usr/src/desarrollo/gopath/bimtracer-backend/sequences/
  • Ejemplo: POST /sequences — regenera todas las secuencias de un proyecto
• Término: users
  • Significado: Sistema central de autenticación y gestión de usuarios. Login dual (email/password o Google), generación de JWT, gestión de permisos por proyecto.
  • Tipo: Servicio
  • Dónde se utiliza: /mnt/usr/src/desarrollo/gopath/bimtracer-backend/users/
  • Ejemplo: POST /users/login — autentica y retorna JWT + lista de proyectos del usuario
• Término: worktables
  • Significado: Sistema de reportes, dashboards y mesas de trabajo. Genera vistas configurables del avance del proyecto y exporta reportes PDF.
  • Tipo: Servicio
  • Dónde se utiliza: /mnt/usr/src/desarrollo/gopath/bimtracer-backend/worktables/
  • Ejemplo: POST /report/generate-pdf — genera PDF con wkhtmltopdf
• Término: s3-manager-ms
  • Significado: Microservicio Node.js de gestión de archivos IFC en AWS S3. Soporta archivos de hasta 1.2 GB.
  • Tipo: Servicio
  • Dónde se utiliza: /mnt/usr/src/desarrollo/gopath/bimtracer-backend/s3-manager-ms/
  • Ejemplo: POST /s3-manager/upload-ifc — sube archivo IFC grande a AWS S3
• Término: json-block-list
  • Significado: API Node.js para consulta y comparación de catálogos de bloques. Valida nuevos modelos antes de su carga.
  • Tipo: Servicio
  • Dónde se utiliza: /mnt/usr/src/desarrollo/gopath/bimtracer-backend/json-block-list/
  • Ejemplo: POST /api/blocks/compare — categoriza bloques en: existing, updatedDescription, newBlocks, withoutCode

Conceptos de Dominio BIM

• Término: blockIfc
  • Significado: Colección MongoDB que almacena los bloques (elementos constructivos) extraídos del modelo IFC. Es la colección central del sistema.
  • Tipo: Colección MongoDB
  • Dónde se utiliza: Todos los servicios la leen. ifc y registry la escriben principalmente.
  • Campos clave: code, description, executed, val_executed, start_date, end_date, displacement_date, exec_date, dependence[], critical_block, labels[], hasImage, days_late
• Término: leanbim_blocks
  • Significado: Colección MongoDB que almacena bloques en formato Lean BIM procesado por lbp. Incluye estados calculados de ejecución y estados visuales.
  • Tipo: Colección MongoDB
  • Dónde se utiliza: lbp la lee y escribe; json-block-list la consulta.
  • Campos clave: code, execution (BLOCKED/ON_TIME/LATE/etc.), status (AVAILABLE/NOT_AVAILABLE), executedValue, forecast_date
• Término: label / etiqueta
  • Significado: Agrupación de bloques constructivos con pesos de contribución al avance total. Pueden contener otras etiquetas (jerarquía). Son la unidad de planificación y reporte.
  • Tipo: Concepto de dominio / Colección MongoDB (labels)
  • Dónde se utiliza: labels, lblsref, digitaltwin, blocks, registry, lbp
  • Ejemplo: Etiqueta “ESTRUCTURA” contiene bloques B001-B050 con pesos de contribución
• Término: IFC
  • Significado: Industry Foundation Classes. Estándar ISO (ISO 16739) para intercambio de modelos BIM. Formato .ifc que describe geometría, propiedades y relaciones de elementos constructivos.
  • Tipo: Estándar / Formato de archivo
  • Dónde se utiliza: Servicio ifc, s3-manager-ms, json-block-list, digitaltwin
• Término: URN
  • Significado: Uniform Resource Name. Identificador que Autodesk Platform Services asigna a un modelo 3D procesado. Permite al viewer 3D del frontend cargar el modelo desde la nube de Autodesk.
  • Tipo: Parámetro de configuración
  • Dónde se utiliza: Servicio ifc (PUT /ifc/urn), digitaltwin
  • Ejemplo: urn:adsk.objects:os.object:bucket/modelo.ifc
• Término: dbId
  • Significado: ID numérico que Autodesk Viewer asigna a cada elemento de un modelo 3D. Se usa para seleccionar/colorear elementos individuales en la visualización 3D.
  • Tipo: Campo de base de datos
  • Dónde se utiliza: Colección blockIfc, servicio ifc (PUT /ifc/assign-blocks-dbIds), digitaltwin
• Término: GUID / guid
  • Significado: Globally Unique Identifier del elemento en el archivo IFC. Es el identificador persistente del elemento en el estándar IFC, usado para mapear con dbId de Autodesk.
  • Tipo: Campo de base de datos
  • Dónde se utiliza: blockIfc, ifc, digitaltwin
• Término: val_executed
  • Significado: Porcentaje de avance de ejecución de un bloque (0.0 a 100.0). Es el valor clave que certifica el progreso de un elemento constructivo.
  • Tipo: Campo numérico
  • Dónde se utiliza: blockIfc (columna principal), registry (lo actualiza), blocks, lbp, digitaltwin
  • Ejemplo: val_executed: 75.5 — el bloque está ejecutado al 75.5%
• Término: displacement_date
  • Significado: Fecha estimada desplazada de un bloque. Calculada por el servicio displacements considerando el retraso del bloque y sus dependencias.
  • Tipo: Campo de fecha
  • Dónde se utiliza: blockIfc (campo), displacements (lo calcula), digitaltwin (lo expone)
• Término: days_late
  • Significado: Número de días de atraso calculados para un bloque respecto a su fecha planificada.
  • Tipo: Campo numérico entero
  • Dónde se utiliza: blockIfc (campo), displacements (lo calcula), blocks (lo expone)
• Término: dependence
  • Significado: Array de códigos de bloques que son predecesores del bloque actual. Define las relaciones de precedencia para el cálculo de secuencias y desplazamientos.
  • Tipo: Campo array
  • Dónde se utiliza: blockIfc, sequences, displacements, registry
  • Ejemplo: dependence: ["B001", "B002"] — este bloque no puede empezar hasta que B001 y B002 finalicen
• Término: critical_block
  • Significado: Boolean que indica si el bloque está en la ruta crítica del proyecto (slack = 0). Los bloques críticos tienen retraso directo en cascada.
  • Tipo: Campo booleano
  • Dónde se utiliza: blockIfc, sequences (lo calcula), blocks (lo consulta)
• Término: hasImage
  • Significado: Flag booleano en blockIfc que indica si el bloque tiene al menos una fotografía de obra asociada.
  • Tipo: Campo booleano
  • Dónde se utiliza: blockIfc, media (lo actualiza), lbp (lo refleja en leanbim_blocks)
• Término: lbl_blocks
  • Significado: Array dentro de un documento de etiqueta que contiene los bloques asignados con sus pesos de contribución.
  • Tipo: Campo array en colección labels
  • Dónde se utiliza: labels, lblsref, digitaltwin, lbp
  • Ejemplo: lbl_blocks: [{code: "B001", weight: 0.15, exec: 75.5}]
• Término: lbl_labels
  • Significado: Array dentro de un documento de etiqueta que contiene sub-etiquetas con pesos. Define la jerarquía de etiquetas.
  • Tipo: Campo array en colección labels
  • Dónde se utiliza: labels, lblsref
  • Ejemplo: lbl_labels: [{code: "01A", weight: 0.40}] — etiqueta “01” contiene a “01A” con peso del 40%

Endpoints y Parámetros Críticos

• Término: isCentralized
  • Significado: Parámetro de query booleano que indica si la operación debe usar la base de datos centralizada o la base de datos específica del proyecto.
  • Tipo: Parámetro HTTP
  • Dónde se utiliza: displacements, blocks, labels, registry, sequences
  • Ejemplo: PUT /workprogress?isCentralized=true
• Término: projectId
  • Significado: Identificador del proyecto. Es al mismo tiempo el nombre de la base de datos MongoDB del proyecto y el subdominio para conexión: {projectId}.bimtrazer.com.
  • Tipo: Parámetro de ruta / Base de datos
  • Dónde se utiliza: Todos los endpoints de todos los servicios
• Término: labelCode
  • Significado: Código único de una etiqueta dentro de un proyecto (ej: “01”, “02A”, “ESTRUCTURA”).
  • Tipo: Parámetro de ruta / Campo
  • Dónde se utiliza: labels, blocks, budget, digitaltwin, worktables
• Término: shouldWaitGraphs
  • Significado: Parámetro boolean del endpoint de displacements. Si true, el endpoint espera a que los cálculos de gráficos terminen antes de responder. Si false, los cálculos corren en background.
  • Tipo: Campo del body JSON
  • Dónde se utiliza: displacements (PUT /workprogress)

Colecciones MongoDB Clave

• Término: blockIfc_sequences
  • Significado: Colección que almacena las secuencias de dependencias calculadas por el servicio sequences. Cada documento contiene una cadena de bloques dependientes.
  • Tipo: Colección MongoDB
  • Dónde se utiliza: sequences (escritura), displacements (lectura)
  • Ejemplo: { "data": "B001-B003-B007-B012" } — cadena de dependencia
• Término: plan_records
  • Significado: Colección que almacena el historial de registros de planificación (porcentajes scheduled y executed por período) para calcular gráficos de curva S.
  • Tipo: Colección MongoDB
  • Dónde se utiliza: labels (escritura y lectura), lblsref (lectura)
• Término: plan_freezing_past
  • Significado: Colección que almacena los registros históricos de planificación congelados. Una vez guardados en esta colección, no se modifican en cálculos futuros.
  • Tipo: Colección MongoDB
  • Dónde se utiliza: labels
• Término: compressions
  • Significado: Colección que almacena factores de compresión históricos calculados por labels. Estos factores ajustan las proyecciones futuras.
  • Tipo: Colección MongoDB
  • Dónde se utiliza: labels
• Término: label_report
  • Significado: Colección con reportes precalculados de avance por etiqueta. Es actualizada por worktables después de cada certificación y leída por el dashboard.
  • Tipo: Colección MongoDB
  • Dónde se utiliza: worktables (escritura y lectura), registry (trigger de actualización)
• Término: free_days
  • Significado: Colección de días festivos/no laborales del proyecto. Usada por displacements y sequences para excluir estos días del cálculo de duración.
  • Tipo: Colección MongoDB
  • Dónde se utiliza: displacements, sequences
• Término: project_config
  • Significado: Colección con la configuración específica de cada proyecto: fechas, zona horaria, etiquetas del digitaltwin, flags de procesos en progreso.
  • Tipo: Colección MongoDB
  • Dónde se utiliza: projects (escritura), múltiples servicios (lectura)
  • Campos clave: in_certification, wp_in_progress, gantt_change, displacements_in_progress, bucket
• Término: execution_history
  • Significado: Colección de auditoría que registra cada cambio en el estado de ejecución de bloques, incluyendo quién hizo el cambio y cuándo.
  • Tipo: Colección MongoDB
  • Dónde se utiliza: registry
• Término: manager_person
  • Significado: Colección que almacena datos de usuarios con permisos de certificación por proyecto, incluyendo flags de certify y whatsappAssistant.
  • Tipo: Colección MongoDB
  • Dónde se utiliza: registry, users

Algoritmos y Conceptos Técnicos

• Término: frame (7-bit state frame)
  • Significado: Estructura de 7 bits que representa el estado de un bloque en un instante del tiempo. Usado por displacements para mapear a casos de reglas de desplazamiento.
  • Tipo: Concepto algorítmico
  • Dónde se utiliza: displacements (displacements/logic.go)
  • Ejemplo: "0101001" — cada bit representa una condición booleana del bloque
• Término: SPI (Schedule Performance Index)
  • Significado: Índice de rendimiento de cronograma. SPI = executed / scheduled. SPI < 1 indica retraso; SPI > 1 indica adelanto respecto al plan.
  • Tipo: Indicador de negocio / Constante de cálculo
  • Dónde se utiliza: labels (calculateSpi.go), blocks
• Término: Freezing Past
  • Significado: Mecanismo que “congela” los valores históricos de planificación para evitar revisión retroactiva. Los datos pasados se guardan en plan_freezing_past y no se modifican.
  • Tipo: Concepto de negocio
  • Dónde se utiliza: labels (múltiples endpoints con sufijo -freezing-past)
• Término: compression factor
  • Significado: Factor multiplicativo calculado por labels para ajustar proyecciones futuras en base a la desviación histórica entre lo planeado y lo ejecutado.
  • Tipo: Concepto algorítmico
  • Dónde se utiliza: labels (calculateCompressionFactors)
• Término: DatabasePool
  • Significado: Patrón de gestión de conexiones MongoDB implementado en todos los servicios Go. Mantiene un pool thread-safe de conexiones por proyecto, reutilizándolas entre requests.
  • Tipo: Patrón de diseño
  • Dónde se utiliza: databases/dbConnections.go en todos los servicios Go
• Término: BulkWrite
  • Significado: Operación MongoDB que ejecuta múltiples escrituras en una sola llamada. Usado por displacements para actualizar N bloques en 2 operaciones en lugar de N.
  • Tipo: Operación de base de datos
  • Dónde se utiliza: displacements (engine/persistence.go)
• Término: CCA
  • Significado: Coordinador de Control de Obra. Rol especial de usuario con permisos extendidos en el sistema. Identificado mediante el endpoint GET /all-cca/:projectId del servicio users.
  • Tipo: Rol de usuario
  • Dónde se utiliza: users, registry
• Término: AUX-50
  • Significado: Metodología específica de planificación. Nombre de un conjunto de endpoints especializados en labels para cálculo de pesos y avances según esta metodología.
  • Tipo: Concepto de negocio
  • Dónde se utiliza: labels (endpoints con prefijo /labels/aux-50/)
• Término: SequencesOptimized
  • Significado: Función de sequences que implementa el algoritmo PERT/CPM para calcular el orden óptimo de ejecución de bloques y detectar la ruta crítica.
  • Tipo: Función / Algoritmo
  • Dónde se utiliza: sequences (internal/sequencesOptimized.go)

Variables de Entorno Clave

• Término: ENVIRONMENT
  • Significado: Variable que selecciona el conjunto de configuraciones activo. Valores: dev, qa, prod, local.
  • Tipo: Variable de entorno
  • Dónde se utiliza: Todos los servicios Go
• Término: {ENV}_DB_PASSWORD
  • Significado: Contraseña de MongoDB para el ambiente seleccionado. CRÍTICO: debe migrarse a sistema de secretos.
  • Tipo: Variable de entorno sensible
  • Dónde se utiliza: Todos los servicios Go (env/setEnv.go, config/env.go)
• Término: MONGO_URI
  • Significado: URI completa de conexión MongoDB usada por servicios Node.js (lbp, json-block-list). CRÍTICO: contiene credenciales.
  • Tipo: Variable de entorno sensible
  • Dónde se utiliza: lbp, json-block-list
• Término: PARSER_URL
  • Significado: URL del servicio externo de parseo de archivos XML generados desde IFC. Usado por json-block-list.
  • Tipo: Variable de entorno
  • Dónde se utiliza: json-block-list
  • Valor por defecto: https://manager.bimtrazer.com/xml-parser/parse-xml
• Término: AWS_BUCKET_NAME
  • Significado: Nombre del bucket S3 de AWS donde se almacenan los archivos IFC.
  • Tipo: Variable de entorno
  • Dónde se utiliza: s3-manager-ms
• Término: {ENV}_BUDGET_API_KEY
  • Significado: API Key para acceder al servicio externo de presupuestos. Sensible.
  • Tipo: Variable de entorno sensible
  • Dónde se utiliza: items

Headers y Campos de APIs

• Término: certify
  • Significado: Flag boolean en el perfil de usuario que indica si tiene permiso para certificar bloques de construcción.
  • Tipo: Campo de permisos
  • Dónde se utiliza: users (colección users / manager_person), registry
• Término: whatsappAssistant
  • Significado: Flag boolean que indica si el usuario recibe notificaciones por WhatsApp al ocurrir eventos de certificación.
  • Tipo: Campo de permisos
  • Dónde se utiliza: users, registry
• Término: scope
  • Significado: Array en el documento de usuario que define los proyectos a los que tiene acceso, con sus etiquetas, vistas y estado por cada proyecto.
  • Tipo: Campo array en colección users
  • Dónde se utiliza: users, registry (validación de permisos)
• Término: eventType
  • Significado: Array de strings en los mensajes que categoriza el tipo de evento: "Image", "Video", "Manual", etc.
  • Tipo: Campo array
  • Dónde se utiliza: messages (colección blockMsgs)
• Término: importance
  • Significado: Nivel de importancia de un mensaje: "L" (Low), "M" (Medium), "H" (High).
  • Tipo: Constante / Enum
  • Dónde se utiliza: messages (colección blockMsgs)

Constantes de Negocio

• Término: BLOCKED
  • Significado: Estado de ejecución de un bloque en Lean BIM que indica que no puede ejecutarse porque sus dependencias no están completas.
  • Tipo: Constante de estado
  • Dónde se utiliza: lbp (handleExecution)
• Término: ON_TIME
  • Significado: Estado que indica que el bloque fue ejecutado dentro del plazo planificado.
  • Tipo: Constante de estado
  • Dónde se utiliza: lbp
• Término: LATE
  • Significado: Estado que indica que el bloque fue ejecutado pero con retraso respecto a la fecha planificada.
  • Tipo: Constante de estado
  • Dónde se utiliza: lbp
• Término: OVERDUE
  • Significado: Estado que indica que el plazo planificado ya venció y el bloque no ha sido ejecutado.
  • Tipo: Constante de estado
  • Dónde se utiliza: lbp
• Término: AVAILABLE
  • Significado: Estado visual del bloque en Lean BIM: puede ejecutarse porque sus dependencias están satisfechas.
  • Tipo: Constante de estado visual
  • Dónde se utiliza: lbp (handleStatus)
• Término: NOT_AVAILABLE
  • Significado: Estado visual del bloque: no puede ejecutarse, dependencias pendientes.
  • Tipo: Constante de estado visual
  • Dónde se utiliza: lbp (handleStatus)
• Término: managerv2centralized
  • Significado: Identificador especial de proyecto que en varios servicios redirige la conexión a la base de datos centralizada de gestión (managerv2.bimtrazer.com).
  • Tipo: Constante de proyecto
  • Dónde se utiliza: digitaltwin, projects, labels
• Término: DataRecursiveLabel
  • Significado: Función que recorre el árbol jerárquico de etiquetas recursivamente. Distingue entre etiquetas hoja (con bloques) y nodos intermedios (con sub-etiquetas).
  • Tipo: Función
  • Dónde se utiliza: lblsref, digitaltwin, blocks