Preparación de la instalación · Estándares de documentación · Manuales · Formación
| Fase previa | ↓ Entrada a CSI | CSI produce | ↓ Salida a | Fase siguiente |
|---|---|---|---|---|
| DSI — Diseño del Sistema | Especificación de Diseño, Modelo físico de datos, Diseño de interfaces | Código fuente, ejecutables, pruebas realizadas, documentación técnica y de usuario | Sistema construido, verificado y documentado | IAS — Implantación y Aceptación |
| Actividad | Descripción | Producto resultante |
|---|---|---|
| CSI 1 — Preparación del entorno de construcción | Configurar el entorno de desarrollo, herramientas, control de versiones y estándares de codificación | Entorno de construcción preparado |
| CSI 2 — Generación del código de los componentes | Codificación de los módulos según las especificaciones de diseño y los estándares definidos | Código fuente de los componentes |
| CSI 3 — Ejecución de las pruebas unitarias | Verificación individual de cada componente desarrollado | Resultados de pruebas unitarias |
| CSI 4 — Ejecución de las pruebas de integración | Verificación del funcionamiento conjunto de los componentes integrados | Resultados de pruebas de integración |
| CSI 5 — Ejecución de las pruebas del sistema | Verificación del sistema completo (funcional, rendimiento, seguridad…) | Resultados de pruebas del sistema |
| CSI 6 — Elaboración de los manuales de usuario | Redacción de la documentación destinada a los usuarios finales | Manual de usuario |
| CSI 7 — Definición de la formación de usuarios finales | Diseño del plan de formación para los usuarios | Plan de formación |
| CSI 8 — Construcción de los componentes y procedimientos de migración y carga inicial | Preparación de la carga de datos iniciales y migración desde sistemas anteriores | Procedimientos de migración |
| CSI 9 — Preparación de la instalación | Elaboración del plan de implantación y preparación del entorno de producción | Plan de implantación |
| Tipo de prueba | Objetivo | Responsable | Técnica habitual |
|---|---|---|---|
| Prueba unitaria | Verificar cada componente/módulo de forma aislada | Programador/Analista-programador | Caja blanca, caja negra |
| Prueba de integración | Verificar que los módulos funcionan correctamente al integrarse | Equipo de desarrollo | Big Bang, top-down, bottom-up, sandwich |
| Prueba del sistema | Verificar el sistema completo contra los requisitos | Responsable de pruebas / Equipo técnico | Pruebas funcionales, de rendimiento, de seguridad, de regresión |
| Prueba de aceptación | Verificación final por parte del usuario (en IAS) | Usuario final / Responsable de implantación | Pruebas alpha, beta, UAT |
El producto clave de la preparación de la instalación es el Plan de Implantación, que debe recoger:
| Apartado del Plan | Contenido |
|---|---|
| Alcance y objetivos | Qué sistemas se instalan, qué usuarios se ven afectados, cuáles son los criterios de éxito |
| Cronograma | Planificación temporal detallada de todas las actividades de implantación, con hitos y responsables |
| Estrategia de implantación | Tipo de corte elegido (ver tabla siguiente) |
| Entorno técnico de producción | Infraestructura hardware, software de base, redes, seguridad necesarios |
| Procedimientos de migración | Carga inicial de datos, conversión desde sistemas anteriores, verificación de la migración |
| Plan de contingencia | Qué se hace si la implantación falla (vuelta atrás, rollback) |
| Plan de formación | Acciones formativas para usuarios y personal técnico (ver sección 6) |
| Plan de comunicación | Cómo y cuándo se informa a los afectados del cambio de sistema |
| Criterios de aceptación | Condiciones que deben cumplirse para dar el sistema por aceptado en producción |
El tipo de corte define la estrategia de transición del sistema antiguo al nuevo:
| Estrategia | Descripción | Ventajas | Inconvenientes | Cuándo usar |
|---|---|---|---|---|
| Corte directo (Big Bang) | En un momento determinado, el sistema antiguo se apaga y el nuevo entra en funcionamiento inmediatamente | Simple, sin costes de doble operación, transición rápida | Riesgo muy alto: si falla el nuevo sistema no hay vuelta atrás inmediata | Sistemas pequeños, poco críticos o con escasa continuidad respecto al anterior |
| Implantación en paralelo | Ambos sistemas (antiguo y nuevo) funcionan simultáneamente durante un período. Los resultados se comparan para validar el nuevo | Muy seguro: el antiguo actúa de red de seguridad, se pueden comparar resultados | Coste elevado (doble esfuerzo), sobrecarga de los usuarios, puede durar mucho tiempo | Sistemas críticos donde el riesgo no se puede asumir (nóminas, contabilidad, seguridad) |
| Implantación gradual (piloto) | El nuevo sistema se instala primero en un subconjunto de usuarios o unidades organizativas (piloto) y se va extendiendo progresivamente | Permite detectar problemas en un ámbito controlado antes de la extensión total | Más lenta, requiere gestionar dos sistemas en distintas unidades | Organizaciones grandes con muchas unidades o delegaciones |
| Implantación por fases (incremental) | Se implantan sucesivamente los distintos módulos o subsistemas del nuevo sistema, no todo a la vez | Permite priorizar funcionalidades críticas, distribuye el riesgo en el tiempo | Requiere interfaces temporales entre módulos nuevos y antiguos | Sistemas grandes descomponibles en módulos independientes |
Verificación de la capacidad de los servidores, almacenamiento, equipos cliente. Instalación y configuración si no existe infraestructura previa.
Sistema operativo, SGBD, servidor de aplicaciones, middleware: instalación, configuración y prueba en el entorno de producción.
Configuración de redes, cortafuegos, VPN, accesos remotos y anchos de banda necesarios para soportar el nuevo sistema.
Configuración de perfiles de acceso, certificados, políticas de seguridad, copias de seguridad y procedimientos de recuperación.
Entorno de pre-producción (staging) para pruebas de aceptación previas al paso a producción real.
Ejecución de los procedimientos de carga inicial, conversión de datos desde el sistema anterior y verificación de la integridad de los datos migrados.
Una vez ejecutado el Plan de Implantación, la fase IAS de Métrica v3 incluye:
Validación final del plan y asignación de responsabilidades para el paso a producción.
Ejecución de las acciones formativas para usuarios y personal técnico (ver sección 6).
Instalación definitiva del software en producción, configuración del entorno y carga de datos iniciales.
Migración de datos del sistema anterior y verificación de su integridad.
Pruebas funcionales sobre el entorno de producción real para verificar que el sistema funciona correctamente.
Pruebas realizadas por los usuarios con el fin de validar que el sistema cumple sus necesidades y aprobar su paso a producción definitivo.
Traspaso al equipo de mantenimiento (MSI): documentación, procedimientos de soporte, niveles de servicio.
Acta de aceptación formal firmada por el responsable del cliente o usuario. Cierre del proyecto.
Todos los documentos del proyecto siguen el mismo formato, facilitando su lectura y comprensión por cualquier miembro del equipo.
Garantizan que la documentación es completa, coherente y verificable. Facilitan las auditorías y revisiones de calidad.
Un sistema bien documentado es más fácil de mantener y evolucionar, reduciendo el coste del ciclo de vida.
Permiten que nuevos miembros del equipo o empresas externas puedan entender y continuar el trabajo.
En la AGE, la documentación es un requisito legal y metodológico (Métrica v3, ENS, RGPD).
La documentación es activo de la organización: preserva el conocimiento más allá de las personas que participaron en el proyecto.
| Norma / Estándar | Organismo | Ámbito |
|---|---|---|
| ISO/IEC/IEEE 26511 | ISO / IEEE | Requisitos para gestores de documentación de usuario |
| ISO/IEC/IEEE 26512 | ISO / IEEE | Requisitos para adquirentes y proveedores de documentación de usuario |
| ISO/IEC/IEEE 26513 | ISO / IEEE | Requisitos para prueba y revisión de documentación de usuario |
| ISO/IEC/IEEE 26514 | ISO / IEEE | Diseño y desarrollo de documentación de usuario |
| ISO/IEC/IEEE 26515 | ISO / IEEE | Documentación en desarrollo ágil |
| ISO/IEC 12207 | ISO | Procesos del ciclo de vida del software (incluye documentación) |
| IEEE 1063 | IEEE | Estándar para documentación de usuario de software |
| MIL-STD-498 | DoD (EE.UU.) | Estándar militar para documentación software (histórico, muy influyente) |
| Criterio | Descripción |
|---|---|
| Completa | Cubre todos los aspectos necesarios sin omisiones relevantes |
| Correcta | Refleja fielmente el sistema tal como está implementado |
| Concisa | Sin información redundante o irrelevante. Fácil de consultar |
| Clara | Lenguaje comprensible para su audiencia objetivo (usuario o técnico) |
| Coherente | Sin contradicciones internas ni con otros documentos del proyecto |
| Actualizada | Refleja la versión actual del sistema. Versionada y fechada |
| Trazable | Relacionada con los requisitos y el diseño del sistema |
| Accesible | Disponible para quien la necesita, en el formato adecuado |
| Sección | Contenido |
|---|---|
| Portada | Título del documento, nombre del proyecto, versión, fecha, organismo/empresa, clasificación |
| Control de versiones | Historial de cambios: versión, fecha, autor, descripción del cambio |
| Índice de contenidos | Tabla de contenidos con numeración de secciones y páginas |
| Introducción y alcance | Objeto del documento, audiencia a la que va dirigido, documentos relacionados |
| Cuerpo del documento | Contenido específico según el tipo de documento (ver secciones 4 y 5) |
| Glosario | Definición de términos técnicos y acrónimos utilizados |
| Referencias | Documentos, normas y fuentes referenciadas en el texto |
| Anexos | Información complementaria (pantallas, listados, formularios...) |
Métrica v3 define los productos documentales que debe generar cada fase:
| Fase | Documentos principales |
|---|---|
| EVS | Informe de Viabilidad del Sistema |
| ASI | Especificación de Requisitos Software (ERS), Catálogo de Requisitos, Modelo de Datos Conceptual, Modelo de Casos de Uso |
| DSI | Especificación de Diseño, Modelo Físico de Datos, Diseño de Interfaces, Plan de Pruebas |
| CSI | Código fuente, Manual de Usuario, Manual de Explotación, Manual Técnico, Resultados de pruebas |
| IAS | Plan de Implantación, Acta de Aceptación, Manual de Mantenimiento |
| Característica | Descripción |
|---|---|
| Orientado a tareas | Organizado por las tareas que el usuario necesita realizar, no por la estructura técnica del sistema |
| Lenguaje no técnico | Vocabulario del dominio del negocio, no jerga informática. Frases cortas y directas |
| Ilustrado | Capturas de pantalla, iconos, diagramas de flujo de trabajo del usuario |
| Estructurado por niveles | Desde lo básico (primeros pasos) hasta lo avanzado (funcionalidades complejas) |
| Incluye ejemplos | Casos prácticos y ejemplos con datos reales o representativos |
| Incluye resolución de problemas | Sección de preguntas frecuentes (FAQ) y solución a errores comunes |
| Versionado | Debe mantenerse actualizado con cada nueva versión del sistema |
| Tipo | Descripción | Formato habitual |
|---|---|---|
| Manual de usuario completo | Documentación exhaustiva de todas las funcionalidades | PDF, HTML, Word |
| Guía de inicio rápido | Resumen de las operaciones más frecuentes para nuevos usuarios | PDF de pocas páginas, tarjeta de referencia |
| Ayuda en línea (online help) | Ayuda contextual integrada en la propia aplicación, accesible desde cada pantalla | HTML, CHM, tooltips |
| Tutoriales / videotutoriales | Guías paso a paso para aprender funcionalidades específicas | Vídeo, GIF animado, presentación |
| Referencia rápida (cheatsheet) | Atajos de teclado, comandos más usados, campos más importantes | Tarjeta plastificada, póster |
| Manual del administrador funcional | Para usuarios con rol de administrador: gestión de usuarios, parámetros, tablas maestras | PDF, HTML |
En Métrica v3 y en la práctica habitual se distinguen tres grandes manuales técnicos:
| Manual | Destinatario | Objetivo principal |
|---|---|---|
| Manual de Instalación | Técnico de sistemas / Administrador de sistemas | Guiar la instalación y configuración inicial del sistema en cualquier entorno |
| Manual de Explotación (operación) | Operador / Administrador de sistemas | Guiar la operación diaria del sistema en producción (arranque, parada, copias de seguridad, monitorización) |
| Manual Técnico (de mantenimiento) | Analista / Programador de mantenimiento | Describir la arquitectura, el diseño y el código para facilitar el mantenimiento y la evolución del sistema |
| Aspecto | Manual de Usuario | Manual de Explotación | Manual Técnico |
|---|---|---|---|
| Destinatario | Usuario final (no técnico) | Operador / Sysadmin | Analista / Programador |
| Lenguaje | No técnico, orientado al negocio | Técnico, orientado a operaciones | Muy técnico, orientado al código |
| Foco | Cómo usar las funcionalidades | Cómo operar el sistema en producción | Cómo está construido el sistema |
| Contenido típico | Capturas de pantalla, pasos, FAQ | Procedimientos de arranque, backup, monitorización | Arquitectura, código, modelo de datos |
| Actualización | Con cada cambio de interfaz o funcionalidad | Con cada cambio en la infraestructura | Con cada cambio en el código o diseño |
| Elaborado en fase | CSI | CSI / IAS | CSI |
El Plan de Formación debe definir para cada colectivo destinatario:
| Elemento del Plan | Descripción |
|---|---|
| Colectivos destinatarios | Identificación de los grupos de personas que necesitan formación: usuarios básicos, usuarios avanzados, administradores funcionales, técnicos de sistemas, personal de mantenimiento |
| Objetivos de aprendizaje | Qué debe saber hacer cada colectivo al finalizar la formación (competencias a adquirir) |
| Contenidos | Temario detallado adaptado a cada colectivo |
| Modalidad | Presencial, on-line (e-learning), mixta (blended), autoformación |
| Metodología | Clases magistrales, talleres prácticos, simulaciones, casos prácticos |
| Duración y calendario | Horas de formación por colectivo, fechas y lugar de impartición |
| Materiales | Manual de usuario, guías rápidas, ejercicios prácticos, entorno de formación |
| Evaluación | Cómo se medirá que los objetivos de aprendizaje se han alcanzado |
| Responsable | Quién imparte la formación: personal interno, empresa proveedora, formadores externos |
| Colectivo | Contenido de formación | Duración típica |
|---|---|---|
| Usuario básico / estándar |
|
4-16 horas |
| Usuario avanzado / power user |
|
16-24 horas |
| Administrador funcional |
|
16-40 horas |
Instructor imparte la formación con el sistema real o un entorno de formación. Alta interacción, adecuada para grupos.
Cursos virtuales a ritmo propio. Escalable para grandes colectivos dispersos geográficamente (común en AGE).
Un formador acompaña al usuario en su trabajo real durante los primeros días. Alta efectividad pero costosa.
Se forma a un grupo de usuarios clave que luego forman al resto. Muy eficaz para implantaciones en grandes organizaciones.
| Colectivo técnico | Contenido de formación |
|---|---|
| Técnico de sistemas / Administrador de sistemas |
|
| Analista / Programador de mantenimiento |
|
| Responsable de seguridad |
|
| Personal del CAU (Centro de Atención al Usuario) |
|
| Factor | Descripción |
|---|---|
| Impartir la formación en el momento adecuado | No demasiado antes de la puesta en producción (se olvida) ni demasiado tarde (genera inseguridad). Lo ideal es justo antes del corte |
| Usar datos y casos reales o representativos | La formación con datos ficticios o irreales reduce la eficacia |
| Entorno de formación equivalente al real | Formar con el mismo sistema que se va a usar, o una réplica idéntica |
| Adaptar el nivel al colectivo | No dar la misma formación a un usuario básico y a un administrador funcional |
| Material de apoyo disponible | Que el usuario se lleve la guía rápida o el acceso al manual después de la formación |
| Soporte post-formación | Habilitar un período de soporte intensivo (superusuarios, CAU reforzado) los primeros días en producción |
| Evaluación de la formación | Medir si los objetivos de aprendizaje se han alcanzado (test, observación, indicadores de uso del sistema) |
La formación no es solo técnica: también es un instrumento de gestión del cambio organizativo. Un nuevo sistema implica cambios en los procesos de trabajo, en los roles y en los hábitos de los usuarios. La formación debe:
| Documento | Fase Métrica | Destinatario | Contenido principal |
|---|---|---|---|
| Manual de Usuario | CSI | Usuario final | Cómo usar el sistema: acceso, funcionalidades, errores, FAQ |
| Guía de inicio rápido | CSI | Usuario final | Operaciones más frecuentes resumidas |
| Manual de Instalación | CSI | Técnico de sistemas | Requisitos, procedimiento de instalación, configuración |
| Manual de Explotación | CSI / IAS | Operador / Sysadmin | Arranque, parada, backup, monitorización, incidencias |
| Manual Técnico | CSI | Analista / Programador | Arquitectura, modelo de datos, módulos, interfaces, despliegue |
| Plan de Implantación | CSI / IAS | Jefe de proyecto / Responsable implantación | Estrategia de corte, cronograma, contingencia, formación |
| Plan de Formación | CSI / IAS | Responsable de formación | Colectivos, objetivos, contenidos, calendario, evaluación |
| Acta de Aceptación | IAS | Usuario / Directivo | Aprobación formal del sistema. Cierre del proyecto |