Descripción General de Smart Engineering
Smart Engineering apoya la jornada de modernización de código. Usted registra un repositorio, indexa su código fuente, revisa las estadísticas, ejecuta procesos que generan documentación y artefactos de backlog, y usa los resultados para navegar por documentación, grafos técnicos, logs y métricas de uso.
Dos flujos impulsados por agentes se apoyan en esa base:
- Chat Agéntico — un workspace conversacional donde un agente responde preguntas sobre un repositorio, ejecuta flujos repetibles y propone cambios que usted aprueba en línea. Es la pantalla que la aplicación abre después de iniciar sesión.
- Modernización de Código — un chat guiado que usa la documentación finalizada para analizar la aplicación actual, preparar un plan de modernización y generar los archivos de una nueva aplicación.
Lo que ve depende de la organización activa, el estado del repositorio, las opciones de proceso disponibles y los permisos asignados a su cuenta.
Cuándo usar
- Documentar sistemas existentes a partir del código fuente.
- Entender estructura, dependencias, lenguajes y volumen de código.
- Generar documentación técnica, diagramas y artefactos de backlog.
- Investigar relaciones técnicas en el grafo del repositorio.
- Preguntar a un agente sobre un repositorio o ejecutar un flujo estandarizado sobre él.
- Recuperar conocimiento sobre un sistema heredado o poco documentado.
Antes de empezar
- Confirme la organización activa.
- Asegúrese de que se creará o seleccionará el repositorio correcto.
- Prepare el código fuente en un archivo
.zipo tenga acceso al repositorio Git. - Confirme que su cuenta puede acceder al módulo y ejecutar procesos.
Acceso
La aplicación usa el modelo de autenticación y permisos configurado para el entorno. Cuando se requiere iniciar sesión, los usuarios no autenticados son redirigidos a la pantalla de inicio de sesión. Tras iniciar sesión, la aplicación valida la sesión activa antes de mostrar pantallas protegidas.
Si falta el acceso a su organización o al módulo, contacte al administrador del workspace o al responsable del proyecto antes de crear repositorios.
Navegación
La barra lateral agrupa el módulo en secciones:
- Agéntico — Chat. Abre el Chat Agéntico; el elemento Personalizar dentro de él gestiona los agentes personalizados y el Recipe Engine.
- Repositorios — ver todos los repositorios y crear uno nuevo.
- Modernización — proyectos de Code Modernization y Nueva Modernización.
- Administración — Claves de API y Explorador de Costos.
El header expone controles globales, el selector de organización y el command palette. El command palette (buscar pantallas y acciones) puede abrir elementos de navegación, agéntico, personalizar, modernización, repositorio actual y administración, según el contexto y los permisos.
Workspace del repositorio
El workspace del repositorio está disponible en /repositories/:repositoryId. Muestra un encabezado, breadcrumb, estado actual y pestañas para el ciclo de vida del repositorio:
- Resumen
- Indexación
- Estadísticas
- Código fuente
- Procesos
- Documentación
- Grafo
- Ajustes
Algunas pestañas quedan bloqueadas hasta que exista código fuente o preanálisis. El Explorador de Costos está en el área de Administración, no es una pestaña del workspace.
Paso a paso
- Inicie sesión y confirme la organización activa.
- Cree o abra un repositorio.
- Abra Indexación y conecte un repositorio Git o suba un archivo
.zip. - Espere el procesamiento y confirme el preanálisis; revise las Estadísticas.
- Cree un proceso y seleccione las salidas que necesite.
- Supervise estado, logs y acciones disponibles.
- Lea la documentación generada.
- Inicie un proyecto de Modernización de Código cuando quiera planificar y generar una nueva aplicación.
- Use el Chat Agéntico para hacer preguntas o ejecutar flujos sobre el repositorio.
- Explore el grafo, las referencias y el inspector de código para obtener contexto técnico.
- Consulte el Explorador de Costos o descargue el paquete de resultados cuando sea necesario.
Resultado esperado
Al final del flujo, el repositorio debería tener código procesado, estadísticas disponibles, uno o más procesos ejecutados, documentación generada y referencias de grafo. Los proyectos de Modernización de Código mantienen el plan, los documentos y los archivos generados disponibles para revisión o descarga.