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 sea rastreado, reversible y colaborativo. Ya sea que trabajes solo o en equipo, comprender 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 clave y los flujos de trabajo 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 los archivos a lo largo del tiempo para que puedas recuperar versiones específicas más adelante. En CAD ROOMS, esto significa:

Nunca perder trabajo: Cada cambio se guarda y puede recuperarse

Rastrear quién cambió qué: Visibilidad completa de las contribuciones del equipo

Prevenir conflictos: Solo una persona puede editar un archivo a la vez

Comparar versiones: Ver exactamente qué cambió entre iteraciones de diseño

Revertir errores: Volver a versiones anteriores si es necesario

Piensa en ello como una máquina del tiempo para tus archivos CAD, combinada con un sistema de colaboración que evita que los miembros del equipo sobrescriban el trabajo de los demás.

Conceptos fundamentales

1. Cloud Drive

El Cloud Drive es tu repositorio central para todos los archivos del proyecto. Funciona de manera similar a los servicios de almacenamiento en la nube que ya puedas utilizar (como Google Drive o Dropbox), pero con potentes funciones de control de versiones integradas.

Cuando ves el Cloud Drive de tu proyecto, puedes ver:

Todos los archivos y carpetas de tu proyecto

Los estados actuales de los archivos (checked out, modificados, staged)

El historial de versiones de cada archivo

Quién trabajó por última vez en cada archivo

2. Check-Out / Check-In

CAD ROOMS utiliza un sistema de check-out/check-in para prevenir cambios conflictivos.

Check-Out:

Cuando haces check-out de un archivo, lo estás reservando para editarlo

Los demás miembros del equipo pueden ver el archivo, pero no editarlo

Esto evita que dos personas realicen cambios incompatibles simultáneamente

El archivo queda "bloqueado" para ti hasta que lo devuelvas con check-in

Check-In:

Cuando terminas de editar, haces check-in del archivo

Esto libera el bloqueo y hace que tus cambios estén disponibles para el equipo

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

El archivo queda disponible para que otros hagan check-out

3. Staging

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

Así es como funciona:

Haces check-out de un archivo y realizas cambios localmente

Cuando estés listo, haces stage del archivo, marcándolo como listo para contribuir

Revisas tus archivos en stage para asegurarte de que todo es correcto

Contribuyes todos los archivos en stage a la vez con un mensaje descriptivo

Por qué el staging es útil:

Revisar múltiples cambios de archivos antes de confirmarlos juntos

Agrupar cambios relacionados en una sola contribución

Detectar errores antes de que se conviertan en parte del registro permanente

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

Indicador visual: Los archivos en stage aparecen con una insignia naranja "Staged" en la interfaz, y verás una notificación como "Tienes 1 archivo en stage listo para ser contribuido."

4. Contribuciones

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

Cada contribución incluye:

Los archivos que modificaste: Se incluyen todos los archivos en stage

Una descripción: Tu mensaje explicando qué cambió (p. ej., "Final para fabricación", "Dimensiones del soporte actualizadas")

Un commit hash: Un identificador único como "d27710" que referencia esta contribución específica

Marca de tiempo: Cuándo se realizó la contribución

Autor: Quién realizó la contribución

Las contribuciones son permanentes: Una vez contribuidos, los cambios pasan a formar parte del historial del proyecto y siempre pueden ser referenciados o restaurados.

5. Commit Hashes

Un commit hash es un identificador único asignado automáticamente a cada contribución (p. ej., "d27710", "d96d47", "f5cc92").

Por qué son importantes los commit hashes:

Referencias precisas: Puedes referirte a versiones exactas en las discusiones ("El problema comenzó en d27710")

Trazabilidad: Vincular cambios a Órdenes de Cambio de Ingeniería (ECO) o requisitos específicos

Comparación de versiones: Comparar dos versiones cualesquiera por sus commit hashes

Registro de auditoría: Rastrear la evolución completa de tu diseño

Verás commit hashes en todo CAD ROOMS:

En el feed de actividad

En las tarjetas de archivos que muestran cambios recientes

En las listas de cambios de ECO

En el historial de versiones

6. Revisiones

Las revisiones son etiquetas formales de versión como "Rev A.1" o "Rev B.1" que marcan hitos significativos en tu diseño.

La diferencia entre contribuciones y revisiones:

Las contribuciones ocurren frecuentemente mientras trabajas (cada vez que contribuyes cambios)

Las revisiones son publicaciones formales (cuando estás listo para revisión, fabricación o lanzamiento)

Nomenclatura de revisiones:

Revisiones mayores: A, B, C (cambios de diseño significativos)

Revisiones menores: A.1, A.2, A.3 (actualizaciones pequeñas dentro de una versión mayor)

Comprender los estados de los archivos

Los archivos en CAD ROOMS pasan por varios estados:

Estado	Insignia/Indicador	Significado	Qué puedes hacer
Disponible	Sin insignia	El archivo no está en check-out	Hacer check-out para editar
Checked Out (por ti)	Icono de candado	Tienes acceso exclusivo de edición	Hacer cambios, stage, contribuir
Checked Out (por otros)	Icono de candado + avatar del usuario	Otra persona está editando	Solo ver, esperar al check-in
Modificado	Insignia "M"	Tienes cambios locales aún no en stage	Hacer stage de los cambios
Staged	Insignia naranja "Staged"	Listo para contribuir	Contribuir o quitar del stage
Más reciente	Indicador "Latest"	Versión más reciente	Esta es la versión actual

Trabajar con commit hashes

Encontrar commit hashes

Los commit hashes aparecen en varios lugares:

Feed de actividad (pestaña Insights): Cada contribución muestra su hash

Tarjetas de archivos: Las contribuciones recientes muestran su hash

Pestaña de cambios de ECO: Los archivos vinculados a ECOs muestran su commit hash

Etiquetas de contribución: Pasa el cursor sobre las descripciones de contribución para ver el hash

Usar commit hashes

En la comunicación del equipo:

"El diseño del soporte en el commit d27710 está listo para fabricación"

"¿Puedes revisar los cambios entre f5cc92 y d96d47?"

En Órdenes de Cambio de Ingeniería (ECO):

Vincular commits específicos a solicitudes de ECO

Rastrear qué cambios abordaron qué problemas

Para comparación de versiones:

Seleccionar dos commit hashes para ver una comparación visual CAD (diff)

Identificar exactamente qué geometría cambió

Revertir a versiones anteriores

Si necesitas volver a una versión anterior:

Opción 1: Descargar una versión anterior

Navega al historial del archivo

Encuentra el commit hash o la revisión que deseas

Descarga esa versión específica

Úsala como punto de partida

Opción 2: Restaurar una versión anterior

Selecciona la versión que deseas restaurar

Haz clic en "Restaurar esta versión"

Esto crea una nueva contribución con el contenido antiguo

El historial se conserva (no se elimina nada)

Importante: CAD ROOMS nunca elimina el historial. Cuando "reviertes", en realidad estás creando una nueva contribución que coincide con una versión anterior. Esto mantiene la trazabilidad completa.

Control de versiones para equipos

Estrategias de coordinación

Consulta el feed de actividad antes de empezar a trabajar:

Ver en qué han estado trabajando los compañeros

Evitar duplicar esfuerzos

Comprender los cambios recientes

Usa @menciones en las ECOs:

Etiquetar a los miembros del equipo cuando se necesite su revisión

Notificar a las partes interesadas sobre cambios importantes

Crear rastros de comunicación claros

Establece convenciones para los mensajes de contribución:

Acordar el formato como equipo

Usar prefijos como "[ECO-123]" para vincular a órdenes de cambio

Incluir números de tickets de otros sistemas

Preguntas frecuentes

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

R: El archivo permanece bloqueado para ti. Los demás miembros del equipo verán que está en check-out y podrán 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 el Cloud Drive para ver todos los archivos en check-out y quién los tiene.

P: ¿Hasta cuándo se conserva el historial de versiones?

R: Para siempre. CAD ROOMS mantiene el historial completo durante toda la vida de tu proyecto.

P: ¿Puedo eliminar una contribución si cometí un error?

R: No, las contribuciones son permanentes por razones de trazabilidad. En su lugar, realiza una nueva contribución que corrija el error.

P: ¿Cuál es la diferencia entre una contribución y una revisión?

R: Las contribuciones ocurren cada vez que guardas cambios (frecuentes). Las revisiones son hitos formales (infrecuentes).

Comprender el control de versiones en CAD ROOMS