--- title: "Revisiones entre repositorios · Docs · SourceAnt" description: "Documentación: Configurar la revisión de código multirrepositorio: agrupa repositorios en un sistema, encuentra las conexiones y lee una revisión que sigue un cambio hasta todo lo que alcanza." url: "https://sourceant.ai/es/docs/cross-repository-reviews/" --- # Revisiones entre repositorios La revisión entre repositorios es lo que hacen posible los Sistemas. Agrupa repositorios relacionados en un sistema y una revisión podrá comprobar cómo afecta un cambio al código de cada repositorio que ese sistema alcanza. Agrupa repositorios relacionados en un sistema y registra sus conexiones para que las revisiones puedan seguir esas relaciones. Esta guía te muestra cómo configurarlo. Para una introducción a las partes, las conexiones y los resultados de descubrimiento, consulta [Sistemas](https://sourceant.ai/es/docs/systems). ## Antes de empezar - Los repositorios están conectados, en la nube o en tu propia instancia. - Eres **propietario** o **administrador** del espacio de trabajo, o es el tuyo personal. Sin eso, los botones a continuación no se muestran en absoluto. ## 1\. Lee cada repositorio Un repositorio no entra en un sistema como una parte sin más. Al leerlo se deriva un sistema propio, llamado `owner/repo`, y el sistema mayor se compone entonces de esos sistemas más pequeños. Abrir **Sistemas** en la barra lateral. Si no se ha modelado nada verás _Nada modelado todavía_ y un botón **Crear un sistema** ; de lo contrario, usa el botón **+** en el encabezado, que tiene la información emergente _Nuevo sistema_. El panel se titula **Dibujar un sistema**. Cerca de la parte inferior, bajo **Aún no leído**, cada repositorio conectado sin un sistema detrás se lista con un botón **Leerlo** Lee los que quieras en el sistema. También puedes hacerlo desde la página del propio repositorio, donde el botón es **Inicializar desde GitHub**, o **Leer de nuevo** si ya se ha leído antes. ## 2\. Crea el sistema que los contiene En el mismo panel: 1. **Lee los repositorios**, bajo _Lo que parece un sistema_, propone agrupaciones. Cada sugerencia indica de dónde proviene: _De una dependencia declarada_, _De importaciones entre repositorios_, o _Solo de nombres_. No crea nada por sí misma. 2. **Nombra** el sistema, por ejemplo `Billing`. 3. **Qué es**: una línea sobre lo que debe entenderse en conjunto para cambiarlo. 4. **Dentro de otro sistema**: déjalo en _Nada. Este es un sistema propio_ a menos que lo estés anidando. 5. **Sistemas que contiene**: marque los sistemas de repositorio que leyó en el paso 1. Pasan a formar parte de este sistema en lugar de ser sistemas propios. 6. **Crear sistema**. _Solo de nombres_ merece una lectura atenta. Una sugerencia basada únicamente en un nombre coincidente es la evidencia más débil que existe, y es la que más conviene comprobar a mano. ## 3\. Encontrar las conexiones Abra el sistema. Haga clic en el **icono con forma de compartir** justo a la izquierda del **+** botón en el encabezado. Su información emergente es **Buscar conexiones**: _lea a qué están unidos, según lo que publica cada uno y lo que dice su código_. Aparece una vez que el sistema contiene sistemas de repositorio. Lee los repositorios en segundo plano e informa del progreso, por ejemplo _Leyendo 3 repositorios._ luego _Se leyeron 3 repositorios. No se pudo leer 1._ Cuando termina, la página pasa sola a la pestaña **Partes** . En un entorno grande puede tardar varios minutos; salir de la página no lo detiene. ## 4\. Aprobar lo que es real Todo lo que encuentra la inferencia llega como **pendiente**. Nada de lo que propone se trata como un hecho hasta que una persona lo confirma. Tres lugares para revisarlas, todos con la misma función: - La tarjeta de triaje en la parte superior de la página Sistemas, titulada **N conexiones por revisar** y ordenada _Primero la evidencia más débil_. **Aprobar** o **Rechazar** cada una. - La **Conexiones** sección debajo de cada sistema en la **Partes** pestaña. - **Arquitectura → Interactivo**, que añade **Mantener todos los N** y **Descartar todos** para gestionar un montón con rapidez. Empiece por la evidencia más débil, que es el orden en el que la tarjeta de triaje ya los presenta. Una conexión leída a partir de una dependencia declarada suele ser correcta. Una que se basa en una coincidencia de nombre merece los diez segundos que se tardan en abrir el archivo que cita. ## Qué cambia realmente aprobar Esta es la parte que merece la pena entender, porque no es lo que la mayoría supone. Una revisión cruza a otro repositorio **independientemente de si el enlace está aprobado**. La aprobación no condiciona el alcance. Cambia cómo se le permite hablar de él a la revisión. | Estado del enlace | Qué hace la revisión | | --- | --- | | **Aprobado** | Afirma el alcance como un hecho e indica dónde podría romper el otro lado el cambio. | | **Pendiente** | Plantea como pregunta lo que el enlace significaría. No lo afirma y no le adjunta ninguna sugerencia. | Así que un grafo sin aprobar no es uno roto. Es uno más discreto. Aprobar es cómo le indica al revisor que se le permite ser categórico. ## 5\. Leer una revisión Abra una solicitud de incorporación de cambios en uno de los repositorios. La revisión gana una sección sobre a qué alcanza el cambio: los sistemas del otro extremo, el código hermano que fue a leer, citado con el repositorio y la revisión de la que proviene. Un repositorio hermano se lee en la revisión en la que se indexó por última vez, porque una solicitud de incorporación de cambios fija solo la suya. Donde esa revisión es antigua, la revisión lo indica en lugar de presentarla como actual. ## Lo que no pudo leer Un repositorio al que la revisión no logró llegar se **nombra en la revisión, con el motivo**. No se omite de forma silenciosa. Esa es la diferencia entre un revisor en el que puede confiar y uno en el que no. Un revisor que se salta en silencio la mitad de su sistema parece idéntico a uno que lo leyó todo y no encontró nada. Las causas habituales, en orden de la frecuencia con la que resultan ser la respuesta: - El repositorio nunca se leyó, así que no tiene ningún sistema detrás. Vuelva al paso 1. - Está conectado, pero no dentro del mismo sistema. - La aplicación no está instalada en él, así que no hay nada que obtener. ## Partes que no son repositorios Gran parte de aquello de lo que depende un sistema no tiene código que leer. En la pestaña Partes, expanda un sistema y use **\+ Añadir** para añadir **Un recurso**: un _Servicio_, _Base de datos_, _Cola_, _API externa_, _Implementación_, _Esquema_, _Documento_, o algo más que usted mismo nombre. Delé un **Nombra** y un **Identificador**, que es como se llama donde realmente reside, para que quien lea la revisión pueda ir y encontrarlo. ## Vincular elementos manualmente La inferencia solo propone aquello para lo que puede señalar un archivo. Cuando conozca una conexión que no puede ver, use **Añadir conexiones** en la pestaña Partes: elija **Desde** y **Hacia**, luego **Cómo se vinculan**. Las opciones son _Depende de_, _Consume_, _Proporciona_, _Expone_, _Contiene_, _Despliega_, _Pruebas_ y _Documentos_. Una conexión que usted mismo añade se aprueba de inmediato. Usted es la persona que la habría aprobado. ## Siguiente - [Revisión de código](https://sourceant.ai/es/docs/code-review): contra qué más se evalúa un cambio. - [Gestión del conocimiento](https://sourceant.ai/es/docs/knowledge-management): las decisiones y restricciones que una revisión lee junto con el grafo. - [Revisiones de sistemas y entre repositorios](https://sourceant.ai/es/systems): cómo se construye el mapa y se mantiene fiel a la realidad.