Servicio: lblsref (Labels Reference)

Información General

• Propósito: Cálculo y propagación de referencias entre etiquetas jerárquicas. Se ejecuta como “finalizador” después de que el servicio labels calcula sus datos, propagando cambios de pesos en cascada hacia arriba en la jerarquía.
• Tecnología: Go 1.24.1 / Gin v1.11.0
• Puerto: :8099 (QA/PROD) / :8106 (DEV)
• Módulo: lblsref

Propósito de Negocio

Cuando una etiqueta contiene sub-etiquetas (jerarquía padre-hijo), los cambios en el avance de una etiqueta hija deben propagarse hacia la etiqueta padre. Este servicio: - Calcula pesos de referencia entre etiquetas en la jerarquía - Propaga cambios de pesos hacia arriba (bottom-up) - Actualiza el total_weight acumulado en cada nodo de la jerarquía - Se ejecuta siempre DESPUÉS de labels completa sus cálculos

Endpoints Expuestos

Nota: Servicio muy reducido (1 endpoint), pero crítico para la consistencia de datos.

Base de Datos

• Motor: MongoDB
• Conexión: Pool dinámico por proyecto

Colecciones Usadas

Estructura de LblsLabelsRef

{
  "codep": "string (código etiqueta padre)",
  "code": "string (código etiqueta hijo)",
  "weight": "float64 (peso en la relación padre-hijo)"
}

Variables de Entorno

Algoritmo de Propagación

PUT /labels-calculation ejecuta:

1. Obtiene todas las etiquetas activas del proyecto
2. Para cada etiqueta con sub-etiquetas (lbl_labels[] no vacío):
   • Identifica relaciones padre-hijo
   • Calcula peso propagado: peso_hijo × peso_en_padre
3. Recorre árbol de etiquetas (recursivamente con DataRecursiveLabel)
4. Distingue tipos de nodo:
   • CanBlo = 0, CanLbl = 0: etiqueta vacía
   • CanBlo > 0, CanLbl = 0: etiqueta hoja (tiene bloques directamente)
   • CanLbl > 0: nodo intermedio (tiene sub-etiquetas)
5. Actualiza total_weight acumulado en cada nodo
6. Almacena factores en labels_ref

Controllers

Cors

Restringido a dominios específicos: - apibt.bimtrazer.com - apibt-dev.bimtrazer.com - apibt-qa.bimtrazer.com

Nota sobre Puertos

Este servicio usa el mismo puerto 8099 que projects en QA/PROD. Esto sugiere que se despliegan en ambientes separados o detrás de un proxy/API Gateway que los distingue por path o subdominio. [inferido]

Rol en Casos de Uso