Backend · 18 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
18
Microservicios
15
Servicios Go
3
Servicios Node.js
~160
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
Frontend · React SPA · cliente HTTP REST MICROSERVICIOS GO / GIN · 15 users var projects :8099 ifc :8101 labels · CORE :8102 sequences :8103 blocks :8104 displacements :8105 lblsref :8106 digitaltwin :8107 registry :8110 messages :8113 media :8114 items :8115 budget :8118 worktables var MICROSERVICIOS NODE.JS · 3 lbp · TypeScript / Express :8080 — IFC → Lean BIM s3-manager-ms · Node.js :3002 — uploads IFC a S3 json-block-list · Node.js :3060 — catálogos XML/JSON MongoDB · Multi-tenant colecciones segregadas por projectId / tenantId Autodesk Platform Services ifc · digitaltwin → OAuth2 + Model Derivative AWS S3 s3-manager-ms → almacenamiento IFC Go / Gin Node.js CORE MongoDB / Externos — — — HTTP interno ───── HTTP cliente
SímboloSignificado
Borde azul (#1d4ed8)Microservicio Go / Gin
Borde verde (#047857)Microservicio Node.js / TypeScript
Borde magenta (#be185d)Servicio CORE — labels
Borde ámbar (#b45309)Almacenamiento o servicio externo
Línea discontinuaComunicación HTTP entre microservicios
Línea sólida azulTráfico desde frontend / cliente externo
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