Control de versiones en CAD ROOMS: guía completa

El control de versiones en CAD ROOMS garantiza que cada cambio en tus archivos de diseño quede registrado, sea reversible y facilite la colaboración. Tanto si trabajas en solitario como en equipo, entender cómo funciona el control de versiones te ayudará a mantener la integridad del diseño y evitar conflictos.

Esta guía explica los conceptos y flujos de trabajo clave que mantienen tus archivos CAD organizados y seguros.

¿Qué es el control de versiones?

El control de versiones es un sistema que registra los cambios en archivos a lo largo del tiempo para que puedas recuperar versiones específicas más adelante. En CAD ROOMS, esto significa:

No perder trabajo: cada cambio se guarda y puede recuperarse

Saber quién cambió qué: visibilidad completa de las contribuciones del equipo

Evitar conflictos: solo una persona puede editar un archivo a la vez

Comparar versiones: ver exactamente qué cambió entre iteraciones

Deshacer errores: volver a versiones anteriores si es necesario

Piénsalo como una “máquina del tiempo” para tus archivos CAD, combinada con un sistema de colaboración que evita que el equipo sobrescriba el trabajo de otras personas.

Conceptos clave

1. Cloud Drive

El Cloud Drive es el repositorio central de todos los archivos del proyecto. Funciona de forma similar a servicios de almacenamiento en la nube (como Google Drive o Dropbox), pero con control de versiones integrado.

Cuando ves el Cloud Drive del proyecto, encontrarás:

Todos los archivos y carpetas del proyecto

Estados actuales (checked out, modified, staged)

Historial de versiones de cada archivo

Quién fue la última persona en trabajar en cada archivo

2. Check-Out / Check-In

CAD ROOMS usa un sistema de check-out/check-in para evitar cambios en conflicto.

Check-Out:

Al hacer check-out de un archivo, lo reservas para editar

Otras personas pueden verlo, pero no pueden editarlo

Evita que dos personas hagan cambios incompatibles a la vez

El archivo queda “bloqueado” para ti hasta que lo vuelvas a hacer check-in

Check-In:

Cuando terminas de editar, haces check-in

Esto libera el bloqueo y hace tus cambios disponibles para el equipo

Añadirás una descripción de lo que cambiaste (mensaje de contribución)

El archivo vuelve a estar disponible para que otras personas hagan check-out

Por qué es importante en CAD: a diferencia de documentos de texto (donde los cambios pueden fusionarse), los archivos CAD contienen datos geométricos y paramétricos complejos. Si dos personas modifican la misma pieza al mismo tiempo, los cambios no pueden combinarse automáticamente. El sistema check-out/check-in evita este problema.

3. Staging

Staging es el paso intermedio entre realizar cambios y contribuirlos oficialmente al proyecto.

Así funciona:

Haces check-out del archivo y editas localmente

Cuando estés listo, lo pones en staging (marcándolo como listo para contribuir)

Revisas los archivos en staging para asegurarte de que todo está correcto

Contribute todos los archivos en staging a la vez con un mensaje descriptivo

Por qué staging es útil:

Revisar múltiples cambios antes de confirmarlos

Agrupar cambios relacionados en una sola contribución

Detectar errores antes de que formen parte del registro permanente

Añadir una descripción completa que abarque todos los cambios

Indicador visual: los archivos en staging aparecen con una etiqueta naranja “Staged” y verás un aviso como “You have 1 staged file ready to be contributed.”

4. Contributions

Una contribución es una "instantánea" de tus cambios que pasa a formar parte del historial permanente del proyecto.

Cada contribution incluye:

Los archivos que cambiaste: se incluyen todos los archivos en staging

Una descripción: mensaje explicando qué cambió (p. ej., “Final for manufacturing”)

Un commit hash: identificador único como “d27710”

Marca de tiempo: cuándo se realizó

Autor: quién la realizó

Las contributions son permanentes: una vez contribuidas, siempre pueden consultarse o restaurarse.

5. Commit hashes

Un commit hash es un identificador único que se asigna automáticamente a cada contribution (p. ej., “d27710”, “d96d47”, “f5cc92”).

Por qué son importantes:

Referencias precisas: puedes referirte a versiones exactas ("El problema empezó en d27710")

Trazabilidad: enlazar cambios con ECOs o requisitos

Comparación de versiones: comparar dos versiones por su hash

Registro de auditoría: seguir la evolución completa del diseño

Verás commit hashes en:

El feed de actividad

Tarjetas de archivos con cambios recientes

Listas de cambios de ECO

Historial de versiones

6. Revisions

Las Revisiones son etiquetas formales como "Rev A.1" o "Rev B.1" que marcan hitos importantes.

Diferencia entre contributions y revisions:

Contributions ocurren con frecuencia durante el trabajo

Revisions son lanzamientos formales (revisión, manufactura o release)

Nomenclatura de revisions:

Revisiones mayores: A, B, C

Revisiones menores: A.1, A.2, A.3

Se usan normalmente para:

Revisiones de diseño

Releases a manufactura

Entregables a clientes

Envíos regulatorios

Comprender los estados de archivo

En CAD ROOMS, los archivos pasan por varios estados:

Estado	Etiqueta/indicador	Significado	Qué puedes hacer
Disponible	Sin etiqueta	No está checked out	Hacer check-out para editar
Checked Out (por ti)	Icono de candado	Tienes acceso exclusivo de edición	Hacer cambios, stage, contribute
Checked Out (por otros)	Candado + avatar	Otra persona está editando	Solo ver, esperar check-in
Modified	Etiqueta “M”	Tienes cambios locales sin staging	Poner cambios en staging
Staged	Etiqueta naranja “Staged”	Listo para contribuir	Contribute o quitar de staging
Latest	Indicador “Latest”	Versión más reciente	Esta es la versión actual

Trabajar con commit hashes

Dónde encontrar commit hashes

Aparecen en varios lugares:

Activity Feed (Insights): cada contribution muestra su hash

File Cards: contributions recientes muestran su hash

ECO Changes: archivos vinculados a ECOs muestran su hash

Etiquetas de contribution: al pasar el cursor por descripciones

Cómo usar commit hashes

En comunicación del equipo:

“El diseño del bracket en d27710 parece listo para manufactura”

“¿Puedes revisar los cambios entre f5cc92 y d96d47?”

En ECOs:

Enlazar commits concretos con solicitudes

Rastrear qué cambios resolvieron qué problemas

Para comparar versiones:

Selecciona dos hashes para ver un diff visual

Identifica exactamente qué geometría cambió

Buenas prácticas

1. Escribe mensajes claros de contribution

Los mensajes crean un historial consultable de decisiones.

Ejemplos buenos:

“Aumenté el espesor de pared de 2 mm a 3 mm según análisis de esfuerzos”

“Reposicioné agujeros de montaje para alinearlos con el chasis rev B”

“Geometría final para manufactura, aprobada en revisión de ingeniería”

Ejemplos malos:

“Update”

“Changes”

“v2”

2. Contribuye cambios relacionados juntos

Usa staging para agrupar:

Archivos afectados por una misma decisión

Implementación completa de un ECO

Componentes de un ensamblaje que cambiaron juntos

3. Haz check-in regularmente

No mantengas archivos en check-out más tiempo del necesario:

Check-out, modificar, contribute, check-in

Si pausas el trabajo, haz check-in

Otras personas pueden necesitar acceso

4. Revisa antes de contribuir

Antes de hacer Contribute:

Verifica que estén en staging todos los archivos correctos

Revisa que el mensaje sea claro

Asegúrate de no incluir archivos de prueba por error

5. Usa revisions para hitos

Crea revisions formales cuando:

Termines una revisión de diseño

Libres a manufactura

Entregues a clientes

Cumplas requisitos regulatorios

Volver a versiones anteriores

Si necesitas regresar a una versión previa:

Opción 1: Descargar una versión anterior

Ve al historial del archivo

Encuentra el commit hash o revision

Descarga esa versión

Úsala como punto de partida

Opción 2: Restaurar una versión anterior

Selecciona la versión a restaurar

Haz clic en “Restore this version”

Esto crea una nueva contribution con el contenido antiguo

El historial se conserva (no se elimina nada)

Importante: CAD ROOMS nunca elimina historial. “Revertir” en realidad crea una nueva contribution que coincide con una versión antigua.

Control de versiones para equipos

Estrategias de coordinación

Revisa el activity feed antes de empezar:

Ver qué ha estado haciendo el equipo

Evitar trabajo duplicado

Entender cambios recientes

Usa @menciones en ECOs:

Avisar cuando se necesita revisión

Notificar cambios importantes

Dejar trazabilidad en la comunicación

Define convenciones de mensajes:

Acordar un formato

Usar prefijos como "[ECO-123]"

Incluir números de tickets de otros sistemas

Manejar bloqueos

Si otra persona tiene un archivo en check-out:

Revisa el activity feed

Comunícate: pregunta cuándo harán check-in

Avanza en archivos relacionados

Planifica la coordinación

El sistema evita conflictos técnicos, pero la comunicación evita conflictos de flujo de trabajo.

Preguntas comunes

P: ¿Qué pasa si olvido hacer check-in?

R: El archivo queda bloqueado para ti. El equipo verá que está checked out y puede contactarte. Puedes hacer check-in en cualquier momento.

P: ¿Puedo ver quién tiene archivos en check-out?

R: Sí. Usa el filtro “Checkout By” en Cloud Drive para ver quién tiene qué.

P: ¿Hasta dónde llega el historial?

R: Para siempre. CAD ROOMS mantiene el historial completo durante la vida del proyecto.

P: ¿Puedo borrar una contribution si me equivoqué?

R: No. Las contributions son permanentes por trazabilidad. En su lugar, crea una contribution que lo corrija.

P: ¿Cuál es la diferencia entre contribution y revision?

R: Contribution ocurre cada vez que guardas cambios (frecuente). Revision es un hito formal (menos frecuente).

P: ¿Necesito saber Git?

R: No. Aunque CAD ROOMS usa conceptos similares (staging, commits), la interfaz está pensada para CAD.

Comprender el control de versiones en CAD ROOMS