Solicitudes de cambio de arquitectura

Las solicitudes de cambio de arquitectura le permiten proponer modificaciones a su modelo C4 a través de un flujo de revisión estructurado. En lugar de editar la arquitectura directamente, los miembros del equipo crean solicitudes que pueden ser revisadas, discutidas y fusionadas.

Cómo funciona

Una solicitud de cambio agrupa una o más modificaciones propuestas a su modelo de arquitectura. Sigue un ciclo de vida similar a un pull request en repositorios de código:

1. Crear una solicitud con un título y una descripción
2. Agregar cambios — crear, actualizar o eliminar elementos C4 (sistemas, contenedores, componentes, elementos de código, relaciones, overlays)
3. Abrir para revisión cuando la propuesta este lista
4. Revisar — los miembros del equipo aprueban, solicitan cambios o dejan comentarios
5. Fusionar para aplicar todos los cambios a la arquitectura

Ciclo de vida de una solicitud

Cada solicitud pasa por estos estados:

Crear una solicitud

Desde la pestaña Solicitudes

1. Navegue a su proyecto
2. Abra la pestaña Solicitudes
3. Haga clic en Nueva solicitud
4. Ingrese un título (máximo 200 caracteres) y una descripción opcional
5. La solicitud comienza en estado Borrador

Agregar cambios

Dentro de una solicitud en borrador o abierta, agregue cambios seleccionando:

• Operación: Crear, Actualizar o Eliminar
• Tipo de elemento: Sistema, Contenedor, Componente, Código, Relación u Overlay
• Datos del elemento: Las propiedades del elemento nuevo o modificado

Los cambios se agrupan por tipo de operación (creaciones, actualizaciones, eliminaciones) para facilitar la revisión.

Editar una solicitud

El autor puede editar el título y la descripción de una solicitud en cualquier momento, siempre que no haya sido fusionada. Haga clic en el icono de lápiz junto al título para entrar en modo de edición.

Revisar una solicitud

Enviar una revisión

Los miembros del equipo con acceso de edición pueden revisar solicitudes abiertas:

• Aprobar — la propuesta es satisfactoria
• Solicitar cambios — se necesitan modificaciones antes de fusionar
• Comentar — dejar retroalimentación sin una decisión formal

Feed de actividad

La pestaña de actividad muestra todas las revisiones y comentarios en orden cronológico. Use el compositor de comentarios en la parte inferior para dejar comentarios rápidos sin una revisión formal.

Fusionar una solicitud

Cuando una solicitud ha sido revisada y aprobada:

1. Abra la página de detalle de la solicitud
2. Haga clic en Fusionar
3. Todos los cambios se aplican atómicamente al modelo C4

Solo los miembros del equipo con permisos de edición pueden fusionar solicitudes.

Previsualizar cambios

La pestaña Vista previa muestra una representación visual de como se vera la arquitectura después de aplicar los cambios, para que los revisores comprendan el impacto antes de fusionar.

Buenas prácticas

Escriba títulos claros

Use títulos descriptivos que expliquen la intención:

• "Agregar servicio de pagos e integración con Stripe"
• "Dividir la API monolítica en servicios de usuario y pedidos"
• "Eliminar el componente de notificación obsoleto"

Mantenga las solicitudes enfocadas

• Un cambio lógico por solicitud
• Evite mezclar modificaciones no relacionadas
• Las solicitudes más pequeñas son más fáciles de revisar

Use las descripciones

Explique el razonamiento detrás de los cambios propuestos:

• Por qué es necesario este cambio arquitectónico
• Qué alternativas se consideraron
• Enlaces a ADR o documentación relacionada

Revise antes de fusionar

• Se recomienda al menos una aprobación
• Use los comentarios para discutir compromisos
• Verifique la pestaña de vista previa para validar el resultado

Próximos pasos

• Vista general del modelo C4 — Comprender el modelo de arquitectura
• Equipos — Configurar su equipo para revisiones colaborativas
• Documentación — Vincular ADR a decisiones de arquitectura