Workspace del Repositorio
El workspace del repositorio en /repositories/:repositoryId es donde el usuario retoma el trabajo después de crear el repositorio. Reúne el encabezado del repositorio, el breadcrumb, el estado, las pestañas del ciclo de vida, la actividad reciente, las estadísticas, los procesos, la documentación y el grafo.
Cuándo usar
- Para entender el estado actual de un repositorio.
- Para moverse entre indexación, estadísticas, código fuente, procesos, documentación y grafo.
- Use el resumen cuando no esté seguro de cuál es el siguiente paso.
- Use las pestañas bloqueadas como guía de lo que aún falta completar.
Antes de empezar
- Confirme la organización activa.
- Abra el repositorio correcto desde
/repositories. - Compruebe si el código fuente y el preanálisis ya están disponibles.
Pestañas del workspace
| Pestaña | Para qué sirve |
|---|---|
| Resumen | Resume el estado del repositorio, el checklist de primeros pasos y el siguiente paso recomendado. |
| Indexación | Conecta un repositorio Git o sube un ZIP, y reindexa cuando el código cambia. |
| Estadísticas | Distribución por lenguaje, estadísticas de archivos, stack detectada y estimaciones de costo del código indexado. |
| Código fuente | Explora los archivos indexados. |
| Procesos | Lista, crea y gestiona procesos (salidas de documentación y de backlog). |
| Documentación | Abre la documentación Markdown generada. |
| Grafo | Explora las relaciones encontradas en el código analizado. |
| Ajustes | Gestiona las integraciones del repositorio, incluido el Git CI. |
Las pestañas Estadísticas y Código fuente se desbloquean cuando termina el análisis. La Documentación se desbloquea después de que un proceso produce salida, y el Grafo se desbloquea cuando existe una versión de origen activa.
El Explorador de Costos no es una pestaña del workspace del repositorio. Está disponible desde el área de Administración, donde selecciona el repositorio dentro de la pantalla.
Resumen del repositorio
Abra la raíz del workspace (/repositories/:repositoryId) para revisar:
- Información general del repositorio y la organización activa.
- Fechas de creación y de actualización, y el tipo de almacenamiento.
- Estado actual y la jornada del repositorio.
- El checklist de primeros pasos que muestra lo que está hecho, en curso o pendiente.
- La siguiente acción recomendada.
- Procesos recientes.
- Datos de preanálisis, estimaciones de costo de LLM y recomendaciones de modelo cuando estén disponibles.
- Mensajes de error cuando hay una falla.
El resumen es la mejor pantalla para retomar el trabajo porque consolida el estado actual y señala la siguiente acción recomendada.
Secuencia de estado del repositorio
| Estado | Qué significa | Siguiente paso |
|---|---|---|
CREATED | El repositorio se creó. | Abra la Indexación y conecte o suba el código fuente. |
UPLOADED | El código fuente se proporcionó. | Espere el procesamiento o revise el preanálisis. |
PROCESSING | El código fuente se está procesando. | Espere a que termine. |
PRE_ANALYZED | El preanálisis está disponible, pero aún no confirmado. | Abra la Indexación, revise el preanálisis en el cuadro de diálogo de confirmación y confírmelo. |
READY | El repositorio está listo para nuevo trabajo. | Cree procesos, lea la documentación o explore el grafo. |
ERROR | Falló la creación, la validación o el procesamiento. | Revise el paso de Indexación o reintente con un código corregido. |
FAIL | Falló un paso posterior del repositorio. | Revise el estado, proporcione un código corregido o reintente el flujo afectado. |
Resultado esperado
El workspace debe dejar claro el estado del repositorio, mostrar qué áreas están disponibles y guiar al usuario hasta la siguiente acción sin necesidad de descubrir rutas manualmente.