El documento de Visin

(Inception)

Jos Vargas Mery

Propsito
Comunicar breve y efectivamente las

grandes ideas relativas al proyecto:

Por qu fue propuesto?.

Cules son los problemas?.
Quines son los interesados?.
Cules son sus necesidades?.
Cmo se ve la solucin propuesta?.

Objetivo del Documento de Visin

Base para discusiones y acuerdos entre las tres

comunidades de interesados internos principales:

departamento de marketing, equipo de desarrollo,
y equipo de gestin.

Si a m se me permitiera desarrollar slo un

documento, modelo u otro artefacto como apoyo

a un proyecto de software, mi eleccin sera un
documento de Visin corto y bien elaborado
P. Kruchten

Contenido del Documento de Visin

Introduccin
Posicionamiento:
Oportunidad de negocio.
Enunciado del problema.
Enunciado del posicionamiento del producto.
Descripciones de los interesados:
Demografa del mercado.
Resumen de los interesados (no usuarios).
Resumen de los usuarios.
Objetivos y problemas de alto nivel claves de los
interesados.
Objetivos de nivel de usuario.
Entorno de usuarios.

Contenido del Documento de Visin

Descripcin del producto:

Perspectiva del producto.

Resumen de beneficios.
Suposiciones y dependencias.
Costos y precios.
Licencias e instalacin.

Resumen de los rasgos del sistema.

Otros requisitos y restricciones.

Introduccin
Propsito:
Cmo imaginamos que va a ser el sistema?
Ej.:
Una aplicacin de Punto de Venta tolerante a
fallas, de ltima generacin, y con la
flexibilidad para soportar reglas de negocio
cambiantes, mltiples mecanismos para
terminales e interfaces de usuario, e integracin
con mltiples sistemas de apoyo hechos por
terceros.

Posicionamiento
Oportunidad de negocio (ejemplo):
Los PdV existentes no son adaptables a los negocios de los
clientes, en trminos de reglas de negocio cambiantes y
diseos de redes cambiantes.
no escalan bien a medida que aumentan el negocio y los
terminales.
no permiten trabajar en modos on-line u off-line
adaptndose dinmicamente dependiendo de las fallas.
no se integran fcilmente con varios otros sistemas.
no permiten terminales de nueva tecnologa.
hay insatisfaccin en el mercado con este estado de las
cosas inflexible, y demanda por un PdV que lo rectifique.

Posicionamiento
Enunciado del problema (ejemplo):
Los sistemas PdVs tradicionales son inflexibles, intolerantes a fallas y difciles de integrar.
esto produce problemas en el procesamiento oportuno de
ventas, en la institucin de procesos mejorados que no
calzan con el software, y en la contabilidad y manejo de
datos de inventario oportunos y precisos para apoyar
mediciones y planificacin.
estos problemas afectan a cajeros, personal de bodega,
administradores del sistema y gerentes corporativos.
Enunciado del posicionamiento del producto:
Resumen de para quin es el sistema, cules son sus rasgos
sobresalientes y qu lo diferencia de la competencia.

Descripcin de los interesados

El propsito es entender quines son los jugadores y

cules son sus problemas.

Actividades:

Un taller de requisitos de un da con expertos en el tema y

otros interesados, y encuestas a varias tiendas.
Consolidar datos de la lista de Actores y Objetivos, y de las
seccin de Intereses de los Interesados de los casos de uso
(ver ejemplo en prxima transparencia).

Objetivos de nivel de usuario (lista Actor-Objetivo):

Cajero: procesar ventas y devoluciones, manejar efectivo.
Administrador del sistema: manejar usuarios y seguridad.
Gerente: iniciar y apagar el sistema.

Problemas y Objetivos de alto nivel

Objetivos de alto nivel (puede haber varios):
Procesamiento de ventas rpido, robusto e integrado.
Prioridad (para cada objetivo):
Alta.
Problemas (asociados a cada objetivo):
Aumento de carga reduce velocidad.
Prdida de capacidad de procesamiento de ventas si los
componentes fallan.
Falta de informacin actualizada de contabilidad y otros
sistemas debido a la no integracin.
Solucin vigente:
PdVs existentes no resuelven estos problemas.

Descripcin del producto

Perspectiva del producto:
Resumen del diagrama de casos de uso.
El diagrama de contexto puede tener varios formatos con
variedad de detalles, pero todos los formatos muestran a los
principales actores relativos al sistema.
Resumen de beneficios:
Una tabla similar a la lista Actor-Objetivo, que relaciona
objetivos, beneficios y soluciones, pero a un nivel ms alto
no solo relacionado a los casos de uso.
Resume el valor y las cualidades diferenciadoras del
producto.

Ejemplo de Rasgos y otros Requisitos

Rasgo

Beneficio para el interesado

Funcionalmente, el sistema proporcionar todos los servicios comunes

que requiere una tienda: captura de
ventas, autorizacin de pagos, etc.

Servicios de punto de venta

automatizados y rpidos

Deteccin automtica de fallas,

cambiando a procesamiento offline
local para servicios no disponibles

Procesamiento de ventas continuado

cuando los componentes externos fallan

Reglas de negocio enchufables en

varios puntos de los escenarios de
procesamiento de ventas

Configuracin lgica de negocios

flexible

Transacciones en tiempo real con otros Informacin oportuna y exacta de

sistemas usando protocolos
ventas, contabilidad e inventario para
estndares
mediciones y planificacin

Resumen de rasgo y otros req.

Resumen de los rasgos del sistema (ejemplo):
Captura de ventas.
Autorizacin de pagos.
Administracin de usuarios, seguridad, tablas, etc.
Procesamiento de ventas offline automtico cuando una
componente externa falla.
Transacciones en tiempo real, basadas en estndares de la
industria, con otros sistemas: inventario, contabilidad.
Definicin y ejecucin de reglas de negocio enchufables.
Otros requisitos y restricciones:
Incluye restricciones de diseo, usabilidad, confiabilidad,
desempeo, soportabilidad, documentacin, etc.

Especificacin suplementaria
Capturar otros requisitos, informacin y restricciones que

no son fcilmente capturados en los casos de uso.

Cuando los requisitos de este tipo son especficos a un

caso de uso pueden (y probablemente deben) escribirse

primero junto al caso de uso, en una seccin de Requisitos
Especiales:
Tambin pueden resumirse en la Especificacin
Suplementaria.

Elementos
Requisitos de funcionalidad, usabilidad, confiabilidad,

desempeo y soportabilidad.
Informes.
Restricciones de hardware y software (p.ej., redes, SO).
Restricciones de desarrollo (p.ej., proceso, herramientas).
Requisitos de internacionalizacin (p.ej., unidades, idiomas).
Documentacin y ayuda en lnea (p.ej., de usuario, instala-cin,
administracin).
Licenciamiento y otros temas legales.
Estndares tcnicos, de seguridad, de calidad.
Entorno fsico (p.ej., vibraciones, temperatura).
Operacional (p.ej., frecuencia de backups).
Informacin prctica y reglas del dominio de inters.