01Qué es
RevitCDE es un entorno común de datos para proyectos de Revit.
Vincula las acciones de los usuarios con objetos concretos del modelo.
Crear un circuito digital auditable.
02Para quién
RevitCDE está dirigido a varios perfiles distintos.
Coordinador BIM / Director de proyecto
Ve el estado del modelo, las aprobaciones, los documentos y las tareas.
Autor (proyectista)
Trabaja en Revit sin cambiar de contexto constantemente.
Aprobador
Revisa las solicitudes entrantes junto con la instantánea y los documentos.
Observador
Acceso de lectura dentro del ámbito del proyecto.
Presupuestista
Base de datos de presupuesto, partidas y costes no vinculados al modelo.
Planificador
Calendario, actividades y procesos temporales no vinculados al modelo.
Administrador
Servidor, usuarios, proyectos, bases de datos y políticas.
03Problemas que resolvemos
Brecha entre Revit y los procesos de gestión
Las aprobaciones y las tareas están separadas del modelo.
El complemento captura los datos del modelo y vincula las solicitudes con los objetos.
Ausencia de una fuente única de verdad
Los archivos, el correo electrónico y las hojas de cálculo divergen entre versiones.
Una estructura CDE almacena proyectos, documentos, versiones e historial.
Aprobaciones opacas
Las decisiones se pierden y las rutas son informales.
ApprovalRequest, rutas de varias etapas, eventos de solo anexado e instantáneas inmutables.
El estado del modelo no es visible en Revit
El proyectista no ve qué está aprobado, pendiente o rechazado.
Los estados se reflejan en Parámetros compartidos y Extensible Storage.
3D, 4D y 5D no están conectados
El presupuesto y el calendario funcionan por separado; los trabajos no vinculados al modelo quedan fuera del control.
estimate.db y schedule.db por proyecto, con WorkPackage como núcleo 4D/5D.
Trabajo local o sin conexión, sin servidor
Los modelos separados necesitan almacenamiento local sin perder la posibilidad de migrar a un servidor.
Modo local en Extensible Storage, base de datos externa opcional de archivo único y migración posterior al servidor.
04Cómo funciona
Tres capas forman un único circuito de datos.
- El usuario trabaja en Revit. El complemento lee los elementos del modelo, planos, vistas, tablas de planificación y estados.
- El modelo se vincula a un proyecto del servidor. La vinculación se guarda dentro del modelo RVT mediante Extensible Storage.
- El complemento sincroniza con el servidor los elementos del proyecto y del modelo, los cambios, estados, solicitudes, tareas, chats y documentos.
- El servidor conserva los datos globales en la base de datos principal y los datos temáticos en bases por proyecto: model_{guid}.db, disciplines.db, estimate.db y schedule.db.
- El gabinete web muestra proyectos, documentos, aprobaciones, tareas, chats y administración; las actualizaciones en tiempo real se transmiten mediante SignalR.
- Las decisiones del aprobador, los cambios de estado, los documentos vinculados y las tareas regresan a Revit y aparecen en el complemento y en los parámetros del modelo.
El servidor es la fuente de verdad en el modo colaborativo; el modelo conserva la vinculación mínima y los datos locales para que el trabajo sobreviva a los reinicios de Revit y a los periodos sin conexión.
05Qué hace
Mapa funcional de un vistazo.
Proyectos
Configuración del proyecto, miembros, roles, estándares, disciplinas, etapas y paquetes.
Modelo
Vinculación RVT, sincronización, identificadores, huella digital, estados y seguimiento de cambios.
Aprobaciones
Solicitudes, rutas, instantáneas, decisiones, retirada, diario y tiempo real.
Documentos
Documentos CDE, versiones, carga y descarga, SHA-256, WIP→Shared→Published→Archived.
Tareas
Kanban, Gantt, importancia, estados, responsables y relaciones entre tareas.
Comunicaciones
Chats de proyecto, mensajes, reacciones, correspondencia e integración con correo electrónico.
Administración
Usuarios, roles, parámetros del servidor, bases de datos, estado y políticas de autorización.
4D/5D
Presupuesto, calendario, WorkPackage, instantáneas de cantidades y EVM/CPM.
Trabajo local
Extensible Storage, base de datos local externa opcional y migración al servidor.
Localización
Localización centralizada de la interfaz, con 22 idiomas en la hoja de ruta.
06Escenarios de uso
Envío de un plano o una vista para aprobación
- Paso 1
- Paso 2
- Paso 3
- Paso 4
- Paso 5
- Paso 6
Un documento desde WIP hasta su publicación
- Paso 1
- Paso 2
- Paso 3
- Paso 4
- Paso 5
Vinculación del modelo, el presupuesto y el calendario
- Paso 1
- Paso 2
- Paso 3
- Paso 4
- Paso 5
07Preguntas frecuentes
Pregunta 1
Respuesta 1
Pregunta 2
Respuesta 2
Pregunta 3
Respuesta 3
Pregunta 4
Respuesta 4
Pregunta 5
Respuesta 5
Pregunta 6
Respuesta 6
Pregunta 7
Respuesta 7
Pregunta 8
Respuesta 8
Pregunta 9
Respuesta 9
Pregunta 10
Respuesta 10
A continuación se presenta la capa técnica para quienes quieran conocer cómo está construido RevitCDE.
08Composición de la solución
| Componente | Finalidad | Tecnología |
|---|---|---|
RevitCDE.Addin | Punto de entrada del complemento de Revit, vinculación del modelo y registro de comandos. | C# /.NET Framework, API de Autodesk Revit |
RevitCDE.UI | Paneles de escritorio, comandos e interacción del usuario dentro de Revit. | WPF / MVVM |
RevitCDE.Core | Servicios de aplicación, sincronización, almacenamiento local y comunicación con el servidor. | Servicios C#, clientes HTTP, SQLite |
RevitCDE.Domain | Modelos de dominio compartidos, identificadores, estados y reglas de negocio. | Biblioteca netstandard2.0 |
RevitCDE.Server | API central, autenticación, datos del proyecto y servicios de integración. | ASP.NET Core 8, EF Core, PostgreSQL |
RevitCDE.Cabinet | Gabinete web para proyectos, documentos, aprobaciones, tareas, chats y administración. | Interfaz web TypeScript / React |
RevitCDE.Localization | Diccionarios de traducción centralizados y cambio de idioma para toda la interfaz visible. | Diccionarios JSON, claves i18n compartidas |
09Modos local y servidor
RevitCDE admite dos modos de ejecución.
Modo local
Los datos se almacenan en Extensible Storage del modelo.
Almacenamiento local externo
Un archivo de base de datos independiente por cada modelo RVT.
Modo servidor
Los datos activos se almacenan en el servidor.
Reglas de migración del modo local al servidor.
10Arquitectura de almacenamiento
| Almacén | Qué almacena | Por qué funciona de este modo |
|---|---|---|
| Base de datos principal del servidor | Usuarios, organizaciones, proyectos, roles, ajustes globales y datos de licencias. | Mantiene los datos de varios proyectos en una única base de datos autoritativa del servidor. |
| model_{guid}.db | Elementos del modelo, planos, vistas, tablas de planificación, cantidades y vinculaciones del modelo. | Los datos voluminosos del modelo se aíslan por archivo RVT para facilitar el rendimiento y el mantenimiento. |
| disciplines.db | Disciplinas, etapas, paquetes y estructura documental del proyecto según el estándar. | Los estándares del proyecto pueden evolucionar sin modificar el esquema global. |
| estimate.db | Documentos de presupuesto, partidas, costes no vinculados al modelo, enlaces de cantidades y vinculaciones con WorkPackage. | Los datos de costes tienen su propio ciclo de vida y deben incluir partidas que no están presentes en el modelo. |
| schedule.db | Actividades del calendario, dependencias, procesos temporales no vinculados al modelo y enlaces con WorkPackage. | Los datos de planificación requieren lógica CPM/Gantt y pueden hacer referencia tanto al modelo como al presupuesto. |
| Extensible Storage | Vinculación mínima del modelo, identificadores técnicos y datos locales de reserva dentro del RVT. | El modelo conserva su capacidad de identificación incluso fuera del entorno del servidor. |
| Base de datos local externa | Base de datos local opcional de un solo archivo para chats, aprobaciones, documentos, tareas y otros datos locales. | Los modelos separados o locales pueden conservar datos más completos sin sobrecargar Extensible Storage. |
11Seguridad y acceso
La seguridad se basa en la pertenencia, los roles, JWT y los modos de confianza.
12Aprobaciones — funcionamiento interno
Un proceso formalizado y reproducible.
Enviar para aprobación
Crea una solicitud de aprobación para la revisión seleccionada del modelo o el paquete de documentos.
Instantánea inmutable
Registra el estado exacto del modelo y de los documentos que se revisan para que la decisión siga siendo reproducible.
Rutas de aprobación
Define pasos de revisión ordenados o paralelos, participantes responsables y decisiones requeridas.
Decisiones registradas
Almacena aprobaciones, rechazos, devoluciones y comentarios junto con el autor y la fecha y hora.
Historial de eventos
Mantiene una cronología de solo anexado con envíos, asignaciones, decisiones y cambios de estado.
Sincronización de estados
Devuelve el estado de aprobación confirmado a los objetos del proyecto y al flujo de trabajo conectado de Revit.
Actualizaciones en tiempo real
Publica los cambios de aprobación en los clientes conectados sin exigir una actualización manual de la página.
13WorkPackage — el núcleo 4D/5D
El objeto central que vincula el modelo, las cantidades, el presupuesto, el calendario y el avance.
ModelElement |
Vincula el paquete de trabajo con los elementos BIM y sus identificadores estables. |
QuantityItem |
Almacena las cantidades medidas y la fuente de la que se obtuvo cada cantidad. |
EstimateItem |
Conecta las cantidades con las partidas del presupuesto, los precios unitarios y el coste calculado. |
WorkPackage |
Actúa como objeto central que une el alcance, el modelo, el coste, el calendario, la responsabilidad y las evidencias. |
ScheduleActivity |
Vincula el paquete de trabajo con las actividades previstas, fechas, dependencias y datos de la ruta crítica. |
ProgressSnapshot |
Almacena el avance real, los indicadores de valor ganado y los hechos del periodo de informe. |
Las bases de datos del proyecto se dividen por áreas temáticas.
14Estándares, disciplinas, etapas y paquetes
El estándar del proyecto determina los formatos de la documentación, el presupuesto y el calendario.
ProjectStandard
Define las reglas activas del proyecto, las convenciones de nomenclatura y la estructura de información requerida.
Discipline
Mantiene el catálogo de disciplinas del proyecto y las responsabilidades específicas de cada disciplina.
PackageType
Define estructuras de paquetes reutilizables para los trabajos de diseño, compra y construcción.
ProjectStage
Controla las etapas del proyecto, las transiciones entre etapas y los datos esperados en cada una.
ProjectRole
Define la responsabilidad, los permisos y la autoridad de aprobación dentro del proyecto.
StandardPreset
Aplica un conjunto reutilizable de estándares, disciplinas, etapas, roles y tipos de paquete.
15API REST — grupos principales
API REST por área temática, autenticada mediante JWT.
-
`/api/auth/*`· Autenticación, sesiones de cuenta, recuperación de contraseña y tokens de acceso. -
`/api/approvals/*`· Solicitudes de aprobación, rutas, decisiones, comentarios y cambios de estado. -
`/api/cde/*`· Proyectos, modelos, documentos, incidencias y datos compartidos del proyecto. -
`/api/chats/*`· Conversaciones del proyecto, participantes, mensajes y archivos adjuntos. -
`/api/tasks/*`· Tareas, responsables, fechas límite, prioridades y estados de finalización. -
`/api/standards/*`· Estándares, disciplinas, etapas, roles y preajustes de paquetes del proyecto. -
`/api/45d/*`· Paquetes de trabajo, cantidades, presupuestos, actividades del calendario y avance. -
`/api/admin/*`· Administración, configuración, diagnóstico y operaciones de mantenimiento controladas.
16Glosario
CDE- Entorno común de datos: espacio controlado para la información, la comunicación y las decisiones del proyecto.
Extensible Storage- Mecanismo de Revit para almacenar datos estructurados de aplicaciones dentro de un modelo.
Parámetros compartidos- Parámetros de Revit compartidos entre proyectos y familias mediante un archivo de definiciones común.
ProjectElement- Registro del lado del proyecto que representa un elemento BIM fuera del documento de Revit.
ModelElement- Referencia estable a un elemento de un modelo y una revisión concretos.
Instantánea- Registro inmutable del estado exacto de los datos del proyecto utilizado para revisión o aprobación.
ApprovalRequest- Solicitud formal que envía un alcance definido a través de una ruta de aprobación.
WorkPackage- Objeto central 4D/5D que une alcance, cantidades, coste, calendario y responsabilidad.
EVM- Gestión del Valor Ganado: medición del avance mediante valor planificado, valor ganado y coste real.
CPM- Método de la Ruta Crítica: análisis del calendario basado en las dependencias de las actividades y la holgura disponible.
17Próximas funciones
La implementación actual ya dispone de un núcleo operativo; a continuación se indican las áreas que se ampliarán.
Localización ampliada
Revisión completa de la terminología y redacción específica del sector para cada idioma admitido.
Flujos de trabajo documentales
Registros de documentos versionados, transmisiones, paquetes de revisión y cadenas de evidencias.
4D/5D más profundo
Planificación más detallada de paquetes de trabajo, control de costes, previsión del avance y análisis del valor ganado.
Interoperabilidad BCF
Intercambio de incidencias y puntos de vista con otras aplicaciones BIM mediante el estándar BCF.
Coordinación de modelos vinculados
Coordinación de modelos vinculados, propiedad, revisiones y dependencias entre modelos.
Observabilidad
Paneles operativos, métricas de auditoría, diagnósticos y supervisión del estado de los servicios.