Este documento constituye la guía estratégica y operativa principal para el desarrollo del Sistema ARCO de Madrid Destino. Su propósito es establecer los fundamentos, direcciones y metodologías que orientarán todas las fases del proyecto, desde su concepción hasta su implementación y mantenimiento posterior. Servirá como referencia centralizada para todos los participantes del proyecto, garantizando coherencia en la toma de decisiones y claridad en los objetivos a alcanzar.
Madrid Destino gestiona un volumen considerable de activos audiovisuales generados por sus múltiples actividades culturales, campañas institucionales y centros asociados. La dispersión actual de estos recursos, la falta de estructuración sistemática y la ausencia de flujos de trabajo automatizados dificultan el aprovechamiento óptimo de este patrimonio audiovisual, limitando su preservación, reutilización y valor organizacional.
- Dispersión de archivos: Materiales distribuidos en múltiples sistemas sin estructura unificada
- Nomenclatura inconsistente: Ausencia de estándares en nombrado y organización
- Procesos manuales: Flujos de trabajo con excesiva intervención humana en tareas repetitivas
- Trazabilidad limitada: Dificultad para vincular archivos con sus proyectos originales
- Preservación en riesgo: Ausencia de políticas sistematizadas de backup y archivo
- Metadatos insuficientes: Información contextual escasa que limita la búsqueda y reutilización
- Problemas técnicos actuales: Errores en funcionalidades básicas (AutoUnzip, historial, etc.)
Crear un sistema modular, escalable e integrado que:
- Centralice la gestión de todos los activos audiovisuales de Madrid Destino
- Automatice progresivamente los flujos de trabajo, manteniendo supervisión humana donde sea crítico
- Establezca estructuras claras basadas en principios OAIS (Open Archival Information System)
- Integre los sistemas existentes (OpenProject, QNAP NAS) e incorpore nuevos (AXLE.ai) de manera coherente
- Garantice la preservación a largo plazo del patrimonio audiovisual de la institución
- Modelo OAIS: Adhesión a estándares internacionales de preservación digital
- Modularidad: Componentes independientes pero interconectados
- Escalabilidad: Diseño que facilite el crecimiento y la incorporación de nuevas funcionalidades
- Automatización progresiva: Implementación gradual con supervisión humana inicial
- Trazabilidad completa: Registro de todas las operaciones y cambios en los activos
- Usabilidad: Interfaces intuitivas adaptadas a diferentes perfiles de usuario
- Desarrollo modular: Construcción por módulos funcionales autónomos
- Implementación progresiva: Priorización de funcionalidades críticas y corrección de errores actuales
- Supervisión humana inicial: Validación manual de operaciones críticas antes de automatización completa
- Iteraciones cortas: Ciclos de desarrollo de 2-3 semanas con entregables verificables
- Pruebas continuas: Validación sistemática de cada componente desarrollado
- Integración: Cohesión entre sistemas existentes y nuevos componentes
- Trazabilidad: Registro completo del ciclo de vida de cada activo audiovisual
- Eficiencia: Optimización de procesos y reducción de tareas repetitivas
- Transparencia: Documentación clara y accesible de todas las decisiones y procesos
- Sostenibilidad: Diseño pensado para el mantenimiento y evolución a largo plazo
- Toma de decisiones estratégicas
- Coordinación de recursos (humanos y tecnológicos)
- Validación de fases
- Comunicación con stakeholders
- Gestión del conocimiento global del proyecto
- Implementación técnica
- Pruebas de componentes
- Integración de módulos
- Documentación de código
- Generación de código específico
- Diseño de APIs y componentes técnicos
- Generación de documentación estratégica
- Diseño de arquitecturas y flujos complejos
- Síntesis de información y conceptualización
- Creación de diagramas y modelos estructurales
- Planificación de fases y módulos
- Resolución de problemas técnicos
- Desarrollo de prompts especializados
- Revisión de documentación estratégica
- Revisión técnica crítica
- Validación de estructuras y decisiones
- Revisión de planificación de fases y módulos
- Validación de usabilidad
- Feedback sobre interfaces y flujos
- Pruebas en entornos reales
- Identificación de mejoras prácticas
- Adopción de procesos estandarizados
- Definir alcance y límites del sistema
- Establecer prioridades funcionales
- Determinar recursos necesarios
- Identificar riesgos iniciales
- Crear estructura documental base
- Recopilación de requisitos de todos los stakeholders
- Análisis de sistemas existentes
- Evaluación de infraestructura disponible
- Establecimiento de métricas de éxito
- Definición de fases y cronograma inicial
- Documento de visión y alcance
- Análisis inicial de requisitos
- Estructura de la documentación
- Roles y responsabilidades definidos
- Plan de comunicación del proyecto
- Definir módulos funcionales
- Diseñar flujos de trabajo
- Establecer reglas de negocio
- Determinar integraciones necesarias
- Crear modelos conceptuales
- Mapeo detallado de procesos actuales
- Diseño de nuevos flujos de trabajo
- Definición de interfaces entre módulos
- Establecimiento de reglas de automatización
- Validación de flujos con usuarios finales
- Diagramas de flujos de trabajo
- Especificación de módulos funcionales
- Reglas de negocio documentadas
- Modelos de interacción entre sistemas
- Requisitos de integración definidos
- Seleccionar tecnologías específicas
- Diseñar arquitectura del sistema
- Definir estructura de datos
- Establecer estándares de desarrollo
- Crear plan de despliegue
- Evaluación de tecnologías disponibles
- Diseño de arquitectura de microservicios
- Modelado de base de datos
- Definición de interfaces de API
- Establecimiento de estándares de código
- Arquitectura técnica detallada
- Modelo de datos
- Diseño de APIs
- Estándares de desarrollo
- Plan de integración continua
- Definir sprints de desarrollo
- Establecer hitos verificables
- Crear plan de validación
- Diseñar programa de formación
- Determinar métricas de seguimiento
- Desglose de tareas por sprint
- Asignación de recursos
- Establecimiento de criterios de aceptación
- Diseño de plan de pruebas
- Creación de material de capacitación
- Plan detallado de sprints
- Cronograma con hitos
- Estrategia de pruebas
- Plan de formación
- Dashboard de seguimiento
- Implementar módulos funcionales
- Integrar componentes
- Realizar pruebas unitarias
- Documentar código
- Crear entornos de prueba
- Desarrollo modular progresivo
- Implementación de APIs
- Creación de interfaces de usuario
- Integración con sistemas existentes
- Documentación técnica continua
- Código fuente documentado
- APIs implementadas
- Interfaces de usuario
- Pruebas unitarias
- Documentación técnica
- Validar funcionalidades
- Verificar integraciones
- Realizar pruebas de carga
- Ejecutar pruebas de aceptación
- Identificar y resolver problemas
- Pruebas funcionales por módulo
- Pruebas de integración entre sistemas
- Validación con usuarios reales
- Pruebas de rendimiento
- Documentación de resultados
- Informes de pruebas
- Registro de incidencias
- Documentación de soluciones
- Plan de mejoras
- Versión validada del sistema
- Implementar en producción
- Realizar formación a usuarios
- Establecer monitorización
- Crear plan de soporte
- Documentar proceso de despliegue
- Despliegue gradual por módulos
- Capacitación de usuarios finales
- Configuración de alertas y monitorización
- Establecimiento de procesos de soporte
- Documentación de operaciones
- Sistema en producción
- Manuales de usuario
- Dashboard de monitorización
- Procedimientos de soporte
- Documentación operativa
- Establecer procesos de mantenimiento
- Implementar mejoras continuas
- Asegurar backups y recuperación
- Formar continuamente a usuarios
- Evaluar y optimizar el sistema
- Revisiones periódicas de rendimiento
- Implementación de nuevas funcionalidades
- Actualización de documentación
- Formación continua
- Evaluación de satisfacción de usuarios
- Plan de mantenimiento
- Calendario de actualizaciones
- Métricas de uso y rendimiento
- Material de formación actualizado
- Informes de evaluación periódicos
| Acción |
Tipo |
Descripción |
Responsable |
| Generar documento inicial de visión |
Prompt |
"Claude, genera un documento de visión para el Sistema ARCO basado en los problemas y objetivos identificados" |
Coordinador |
| Definir alcance del primer MVP |
Decisión |
Determinar qué módulos y funcionalidades se incluirán en la primera versión |
Coordinador |
| Crear estructura de Wiki.js |
Acción |
Implementar contenedor Docker con Wiki.js y configurar estructura inicial |
Coordinador/Técnico |
| Establecer cronograma inicial |
Prompt |
"Claude, genera un cronograma realista para las fases del proyecto, considerando dependencias y recursos" |
Coordinador |
| Realizar análisis de infraestructura |
Validación |
Verificar capacidades actuales de QNAP, servidores y redes |
Técnico/Coordinador |
| Documentar problemas actuales |
Compilación |
Crear documento detallado con todos los errores conocidos y potenciales soluciones |
Coordinador |
| Identificar stakeholders clave |
Comunicación |
Listar todos los departamentos y personas implicadas en el proyecto |
Coordinador |
| Establecer canales de comunicación |
Organización |
Definir herramientas y frecuencia de comunicación del proyecto |
Coordinador |
| Acción |
Tipo |
Descripción |
Responsable |
| Desarrollar diagramas de flujo |
Prompt |
"Claude, genera diagramas de flujo para los procesos de Ingesta, Catalogación y Escena Encendida" |
Coordinador |
| Validar flujos con usuarios |
Comunicación |
Presentar diagramas a usuarios clave y recopilar feedback |
Coordinador |
| Definir integración con OpenProject |
Decisión |
Establecer campos personalizados y webhooks necesarios |
Coordinador/Técnico |
| Diseñar estructura definitiva de carpetas |
Prompt |
"Claude, diseña una estructura jerárquica completa para organizar todos los tipos de activos" |
Coordinador |
| Documentar reglas de nomenclatura |
Compilación |
Crear guía detallada con ejemplos para cada tipo de archivo y contexto |
Coordinador |
| Definir flujo completo de Escena Encendida |
Validación |
Documentar cada paso del proceso, desde creación hasta aprobación final |
Coordinador/Usuario |
| Establecer métricas de éxito funcional |
Decisión |
Definir KPIs para cada módulo y flujo del sistema |
Coordinador |
| Crear especificación de módulos |
Prompt |
"Claude, genera una especificación detallada para cada módulo del sistema" |
Coordinador |
| Acción |
Tipo |
Descripción |
Responsable |
| Definir arquitectura de microservicios |
Prompt |
"ChatGPT, diseña una arquitectura de microservicios para el Sistema ARCO con FastAPI + Celery" |
Coordinador |
| Diseñar modelo de datos |
Prompt |
"ChatGPT, crea un modelo entidad-relación para el Sistema ARCO considerando usuarios, activos y procesos" |
Coordinador |
| Establecer estándares de API |
Decisión |
Definir convenciones para endpoints, autenticación y formatos de respuesta |
Coordinador/Técnico |
| Diseñar estrategia de autenticación |
Decisión |
Configurar roles y permisos en Keycloak |
Coordinador/Técnico |
| Definir estrategia de almacenamiento |
Validación |
Establecer políticas para QNAP y estructuras de archivos |
Coordinador/Técnico |
| Documentar integración con AXLE.ai |
Investigación |
Analizar API de AXLE y definir puntos de integración |
Coordinador/Técnico |
| Crear diagramas de arquitectura |
Prompt |
"Claude, genera diagramas C4 para la arquitectura del Sistema ARCO" |
Coordinador |
| Establecer entornos de desarrollo |
Acción |
Configurar infraestructura para desarrollo, pruebas y producción |
Técnico |
| Acción |
Tipo |
Descripción |
Responsable |
| Desglosar tareas por sprint |
Prompt |
"Claude, desglosa el desarrollo en sprints de 2 semanas con objetivos específicos" |
Coordinador |
| Definir criterios de aceptación |
Decisión |
Establecer condiciones para considerar completa cada funcionalidad |
Coordinador |
| Crear plan de pruebas |
Prompt |
"ChatGPT, genera un plan de pruebas completo para cada módulo del sistema" |
Coordinador |
| Diseñar programa de formación |
Compilación |
Crear estructura de capacitación por perfiles de usuario |
Coordinador |
| Establecer canales de feedback |
Organización |
Definir mecanismos para recopilar opiniones durante el desarrollo |
Coordinador |
| Crear dashboard de seguimiento |
Acción |
Implementar herramienta para visualizar progreso del proyecto |
Coordinador/Técnico |
| Definir procedimiento de gestión de cambios |
Decisión |
Establecer proceso para evaluar e implementar cambios de alcance |
Coordinador |
| Asignar recursos por sprint |
Organización |
Determinar dedicación y responsabilidades para cada fase |
Coordinador |
| Acción |
Tipo |
Descripción |
Responsable |
| Generar estructura inicial de código |
Prompt |
"ChatGPT, genera la estructura base de directorios y archivos para el proyecto" |
Coordinador/Técnico |
| Implementar correcciones prioritarias |
Acción |
Resolver problemas actuales (botones historial, AutoUnzip, etc.) |
Técnico |
| Desarrollar API Gateway |
Acción |
Implementar punto central de acceso a microservicios |
Técnico |
| Crear módulo de ingesta |
Acción |
Desarrollar componentes para subida y procesamiento de archivos |
Técnico |
| Implementar integración con OpenProject |
Acción |
Desarrollar webhooks y sincronización bidireccional |
Técnico |
| Crear interfaz de Escena Encendida |
Acción |
Implementar frontend para gestión del flujo completo |
Técnico |
| Desarrollar sistema de aprobaciones |
Acción |
Implementar interfaz para revisión y comentarios |
Técnico |
| Documentar código continuamente |
Validación |
Asegurar documentación inline y generación automática de docs |
Técnico |
| Acción |
Tipo |
Descripción |
Responsable |
| Ejecutar pruebas unitarias |
Validación |
Verificar funcionamiento correcto de componentes individuales |
Técnico |
| Realizar pruebas de integración |
Validación |
Comprobar comunicación entre módulos y sistemas |
Técnico |
| Coordinar pruebas con usuarios reales |
Comunicación |
Organizar sesiones de testing con diferentes perfiles |
Coordinador |
| Ejecutar pruebas de carga |
Validación |
Verificar rendimiento bajo condiciones de uso intensivo |
Técnico |
| Documentar resultados de pruebas |
Compilación |
Crear informes detallados con hallazgos y soluciones |
Coordinador/Técnico |
| Implementar ajustes según feedback |
Acción |
Realizar correcciones basadas en pruebas |
Técnico |
| Validar experiencia de usuario |
Comunicación |
Recopilar opiniones sobre usabilidad e interfaces |
Coordinador |
| Verificar cumplimiento de requisitos |
Validación |
Comprobar que se cumplen todos los criterios definidos |
Coordinador |
| Acción |
Tipo |
Descripción |
Responsable |
| Crear plan de despliegue gradual |
Decisión |
Definir estrategia de implementación por módulos |
Coordinador/Técnico |
| Generar manuales de usuario |
Prompt |
"ChatGPT, crea manuales de usuario para cada perfil del sistema" |
Coordinador |
| Realizar sesiones de formación |
Comunicación |
Capacitar a usuarios según sus roles |
Coordinador |
| Configurar monitorización |
Acción |
Implementar alertas y dashboard de estado |
Técnico |
| Establecer procedimientos de soporte |
Decisión |
Definir protocolos para atención de incidencias |
Coordinador |
| Realizar despliegue en producción |
Acción |
Implementar sistema en entorno final |
Técnico |
| Documentar proceso de despliegue |
Compilación |
Crear guía detallada para futuras actualizaciones |
Técnico |
| Verificar integridad post-despliegue |
Validación |
Comprobar funcionamiento correcto en producción |
Coordinador/Técnico |
| Acción |
Tipo |
Descripción |
Responsable |
| Establecer calendario de mantenimiento |
Decisión |
Definir periodos para actualización y revisión |
Coordinador |
| Crear plan de backup |
Acción |
Implementar estrategia con Quantum y almacenamiento secundario |
Técnico |
| Definir procedimiento de actualizaciones |
Compilación |
Documentar proceso para implementar mejoras |
Coordinador/Técnico |
| Establecer métricas de rendimiento |
Decisión |
Definir KPIs para monitorización continua |
Coordinador |
| Programar sesiones periódicas de feedback |
Comunicación |
Organizar reuniones regulares con usuarios |
Coordinador |
| Crear plan de formación continua |
Compilación |
Establecer programa de capacitación para nuevos usuarios |
Coordinador |
| Documentar lecciones aprendidas |
Prompt |
"Claude, ayúdame a sintetizar las lecciones aprendidas durante el proyecto" |
Coordinador |
| Planificar evolución futura |
Decisión |
Establecer roadmap para nuevas funcionalidades |
Coordinador |
/arco/
├── README.md # Página principal del sistema ARCO
├── arquitectura/ # Documentación técnica de alto nivel
│ ├── componentes.md # Descripción de componentes del sistema
│ ├── integraciones.md # Integración con otros sistemas
│ └── infraestructura.md # Infraestructura técnica
├── desarrollo/ # Documentación para desarrolladores
│ ├── instalacion.md # Guía de instalación del entorno
│ ├── api-rest.md # Documentación de la API REST
│ └── contribucion.md # Guía para contribuir al proyecto
├── modulos/ # Documentación funcional por módulos
│ ├── ingesta/ # Módulo de ingesta
│ ├── catalogacion/ # Módulo de catalogación
│ └── escena-encendida/ # Módulo Escena Encendida
├── flujos/ # Documentación de flujos de trabajo
│ ├── escena-encendida.md # Flujo Escena Encendida
│ └── ingesta-catalogacion.md # Flujo de Ingesta y Catalogación
├── guias/ # Guías de usuario por perfil
│ ├── admin/ # Para administradores
│ ├── realizadores/ # Para realizadores audiovisuales
│ └── centros/ # Para centros culturales
├── planificacion/ # Documentación de planificación
│ ├── roadmap.md # Plan general del proyecto
│ ├── backlog.md # Lista de tareas pendientes
│ └── sprints/ # Documentación por sprint
└── referencia/ # Material de referencia
├── glosario.md # Términos y definiciones
├── troubleshooting.md # Solución de problemas comunes
└── faq.md # Preguntas frecuentes
Documento actualizado: 12 de mayo de 2025