Backend · 27 microservicios · análisis estático

Portal de Documentación Técnica.

Bimtrazer Backend

Plataforma SaaS de gestión de proyectos de construcción BIM. Esta documentación describe la arquitectura completa del backend: servicios, endpoints, modelo de datos, flujos de negocio y patrones de comunicación. Generada por inspección estática del código fuente.

Ver Arquitectura Explorar Servicios

27

Microservicios

21

Servicios Go

5

Servicios Node.js

~350

Endpoints REST

MongoDB

Multi-tenant

HTTP

Protocolo único

Documentación del Portal · Frontend

PFE-01

Arquitectura del Portal.

React SPA, mapa de rutas, comunicación con 18 microservicios, gestión de estado Redux e integración APS/Forge 3D.

PFE-03

Algoritmos y Fórmulas.

CPM/DFS con backtracking, desplazamientos de cronograma (27 casos), clasificación Lean BIM, fórmulas LaTeX con ejemplos numéricos.

PFE-04

Gráficos y Dashboards.

KPIs, curva S de avance, avance por especialidad, Gantt virtual, gemelo digital 3D, heat map de atrasos y chat IA integrado.

Documentación General · Backend

DOC-01

Arquitectura General.

Visión global de los 18 microservicios, mapa de comunicaciones, modelo de datos y patrones arquitectónicos del backend.

DOC-02

Casos de Uso · Flujos.

12 casos de uso completos con diagramas de secuencia interactivos, pantallas reconstruidas y endpoints de cada microservicio invocado.

DOC-03

Glosario Técnico.

~60 términos especializados del dominio BIM/construcción y de la plataforma Bimtrazer, con referencias cruzadas.

Arquitectura de Comunicaciones

Símbolo	Significado
Borde azul (#1d4ed8)	Microservicio Go / Gin · bt-central (15 servicios)
Borde verde (#047857)	Microservicio Node.js · bt-central (lbp, s3-manager-ms, json-block-list)
Borde magenta (#be185d)	Servicio CORE — labels (orquesta cálculos de certificación)
Borde teal (#0d9488)	Microservicio Go · newbimtrazer (7 servicios)
Borde violeta (#7c3aed)	Microservicio Node.js · newbimtrazer (open-ai, img-recognition)
Recuadro ámbar (#fef3c7)	API Gateway — api-bimtrazer :8085 (proxy JWT + WebSocket)
⚠ (texto rojo en el puerto)	Back-call: el servicio llama de vuelta al gateway en lugar de al destino directo
Línea discontinua (—·—)	Cascade HTTP directo entre microservicios, bypasea el gateway

Catálogo de Microservicios

blocks :8104 Go

Consulta y gestión de bloques constructivos BIM del modelo.

Ver documentación

budget :8118 Go

Control financiero integral: presupuesto, gasto ejecutado y compromisos.

Ver documentación

digitaltwin :8107 Go

Gemelo digital 3D, visualización BIM sobre Autodesk Viewer (URN).

Ver documentación

displacements :8105 Go

Motor de cálculo de desplazamientos de cronograma — algoritmo de frame de 7 bits.

Ver documentación

ifc :8101 Go

Gestión de modelos IFC, versionado e integración Autodesk Platform Services.

Ver documentación

items :8115 Go

Componentes presupuestarios, recursos y unidades de medida.

Ver documentación

labels :8102 CORE

Etiquetas de planificación, avances, proyecciones SPI y compresión de cronograma.

Ver documentación

lblsref :8106 Go

Propagación de pesos y recálculo jerárquico entre etiquetas de planificación.

Ver documentación

media :8114 Go

Fotografías y videos de obra, generación de thumbnails y almacenamiento.

Ver documentación

messages :8113 Go

Auditoría de eventos: receptor de notificaciones del sistema.

Ver documentación

projects :8099 Go

Ciclo de vida de proyectos: creación, configuración y estado.

Ver documentación

registry :8110 Go

Certificación de bloques de obra con validación de dependencias previas.

Ver documentación

sequences :8103 Go

Dependencias PERT/CPM entre bloques, cálculo de ruta crítica.

Ver documentación

users :var Go

Autenticación JWT, login email/Google, gestión de usuarios y permisos.

Ver documentación

worktables :var Go

Reportes, dashboards analíticos y generación de PDF con wkhtmltopdf.

Ver documentación

json-block-list :3060 Node

Comparación de catálogos de bloques contra fuente externa, soporte XML/JSON.

Ver documentación

lbp :8080 TypeScript

Transformación IFC → Lean BIM, gestión de estados de bloques y sub-elementos.

Ver documentación

s3-manager-ms :3002 Node

Upload de archivos IFC a AWS S3, soporta archivos de hasta 1.2 GB con chunking.

Ver documentación

newbimtrazer · API Gateway + Extensiones

api-bimtrazer :8085 Go · API Gateway

API Gateway central: autenticación JWT, enrutamiento de ~180 endpoints hacia todos los microservicios bt-central y newbimtrazer. WebSocket para notificaciones en tiempo real.

Ver documentación

priority-blocks :8087 Go

Gestión de bloques constructivos por prioridad de certificación. Clasificación, filtrado y actualización periódica mediante cron job.

Ver documentación

progress-certification cert-progress.* Go

Certificación de avance vía WhatsApp. Gestiona hojas de certificación, grupos WhatsApp y procesamiento de imágenes/videos de obra usando whatsmeow + SQLite.

Ver documentación

process-blocks :8112 Go

Procesamiento masivo de bloques: creación/actualización bulk, cálculo de fechas de desplazamiento, limpieza de duplicados. MongoDBManager con 4 clientes simultáneos.

Ver documentación

new-params :8095 Go

Parámetros de costos: asignación de bloques constructivos a ítems presupuestarios, generación de archivos de formato con cantidades BIM.

Ver documentación

whatsapp-bot :8116 Go

Bot de WhatsApp con asistente IA: certificar bloques, consultar avance, bitácora de obra. Webhook de WhatsApp + OpenAI function calling.

Ver documentación

dashboard estático Frontend

5 sub-aplicaciones frontend: platform (app principal), gantt (cronograma), ifcUploader (carga modelos), autodesk (visor 3D), TIIC. Todas se comunican con api-bimtrazer.

Frontend estático

open-ai :8093 Node.js

Integración con OpenAI Assistants: threads, runs, vector stores. Asistente WhatsApp especializado con prompt de 22KB. Function calling hacia endpoints BimTrazER.

Ver documentación

blocklist :3000 Node.js

Clasificación de bloques contra MongoDB: existing / new / invalid. Soporta arquitectura centralizada y tradicional (por proyecto).

Ver documentación