De un Excel a Issues Manager: por qué estoy reconstruyendo esta herramienta
El origen de Issues Manager está en mi experiencia en Axpo y en el trabajo con incidencias preparadas desde Excel. Quiero aprovechar ese problema para enseñar cómo se construye una aplicación que llegue hasta Autodesk y permita revisar lo que va a enviar. En Código BIM estoy haciendo una reconstrucción independiente y ampliándola por entregas, con ejemplos sintéticos y un código que puedas seguir desde su primera versión.
Una hoja prepara los datos, pero deja decisiones abiertas
Excel permite reunir títulos, descripciones y responsables sin introducir cada incidencia en una pantalla. Al convertir esas filas en operaciones aparecen otras preguntas: a qué proyecto pertenecen, cómo se identifica a la persona y qué debe ocurrir si una fila tiene un error.
La decisión importante es conservar la relación entre la fila preparada y el resultado que devuelve Autodesk. Si se acepta una incidencia y falla la siguiente, necesitamos distinguirlas para saber cómo continuar. Volver a enviar toda la hoja puede repetir una creación que ya había terminado.
Ese será el hilo de la serie: partir de datos que una persona pueda revisar y llevarlos hasta una operación cuyo resultado se pueda consultar.
El antecedente de Axpo y la aplicación de la serie
El trabajo en Axpo es el antecedente profesional que quiero contar. La aplicación de Código BIM utiliza código nuevo y datos de prueba; no es una publicación de la herramienta corporativa ni una copia de sus configuraciones o reglas internas.
La reconstrucción permite enseñar decisiones que en una herramienta terminada quedan escondidas detrás de un botón. Antes de importar una hoja hay que reconocer a la persona, encontrar su proyecto y comprobar qué datos y operaciones permite Autodesk. Explicar ese recorrido tiene más valor que mostrar únicamente el resultado final.
También separa dos momentos: lo que hice en aquel contexto y lo que estamos implementando y probando ahora. Las funciones nuevas de la serie pertenecen a esta reconstrucción.
Empezar por la cuenta y el proyecto
He elegido que cada persona conecte su cuenta Autodesk. La aplicación utiliza sus permisos para consultar el proyecto y preparar operaciones. Compartir la herramienta no debe convertir la conexión de quien la instaló en la cuenta de todos los demás.
Por eso la primera entrega resuelve el login y el acceso restringido. Después consultamos los hubs y proyectos y comprobamos los miembros y las capacidades de asignación. Son los datos que necesitará una incidencia antes de poder enviarse.
La web utiliza React y el servidor FastAPI concentra la integración con Autodesk. He mantenido en el servidor la identidad, las validaciones y la ejecución para poder reutilizar el mismo criterio desde las distintas formas de aportar datos.
Revisar una operación antes de enviarla
La creación y actualización de incidencias se divide en preparar, revisar y confirmar. La revisión muestra el proyecto y los campos concretos. Cuando se confirma, el servidor comprueba otra vez las condiciones y vuelve a leer la incidencia si Autodesk acepta la escritura.
La importación desde Excel utiliza ese mismo servicio por fila. En la prueba de la serie, una fila válida creó una incidencia en Snowdon Towers y otra quedó bloqueada por falta de título. Ese resultado permite observar qué se envía y qué permanece pendiente.
Los ejemplos de prueba se identifican como tales. Un título con «Prueba Código BIM» nos sirve para seguir la operación en la aplicación y en Autodesk, sin presentarla como un problema real del proyecto.
Ampliar la herramienta sin duplicar sus reglas
La ampliación prevista lleva esas operaciones a un agente de IA mediante MCP, el protocolo con el que puede descubrir y utilizar herramientas. El agente podrá ayudar a consultar y preparar; la aplicación conservará las comprobaciones y la revisión humana antes de escribir.
Para llegar ahí conviene que el formulario y el Excel tengan ya un recorrido claro. Cambiar quién solicita una operación no debería obligarnos a mantener otra versión de las reglas sobre proyectos, responsables y campos permitidos.
La serie distingue los incrementos que prueban un contrato con respuestas simuladas de los que consultan o escriben en Autodesk. Cada entrega indica qué se ha comprobado para que puedas reproducirla con el alcance que explica.
Seguir el código al ritmo de los artículos
El repositorio codigo-bim-issues-manager conserva etiquetas con nombres descriptivos. Cada una fija cómo queda la aplicación al terminar una entrega, aunque la rama principal siga creciendo. El índice de versiones permite elegir el punto correspondiente y el README explica cómo arrancarlo.
Necesitarás configurar tu propia aplicación APS y trabajar con una cuenta y un proyecto de prueba. Las credenciales se guardan en la configuración privada; el ejemplo público contiene las instrucciones y los valores de muestra.
Puedes empezar por el login y recorrer después proyectos, permisos, incidencias y Excel. La hoja es el origen del problema; el objetivo de la reconstrucción es que puedas entender y mantener toda la operación que hay detrás de enviarla.
Respuestas