ManuelRomero/proyectos/Documentacion

Documentación que genera un proyecto

 * Evidentemente no todos los proyectos generaran la misma documentación.
 * Realizaremos la siguiente clasificación
 * 1) Documentación en la gestión del proyecto.
 * 2) Documentación de la .realización del proyecto.

Desarrollando un proyecto

 * En la imagen vemos el desarrollo de un proyecto se va a organizar o dividir en fases
 * En cada fase realizaremos una serie de actividades que a su vez se pueden descomponer en tareas
 * La idea es proponer una METODOLOGÍA de trabajo que se pueda adaptar a los diferentes tipos de proyectos.
 * Cada proyecto según su naturaleza se hace de una manera u otra, no obstante existe cierta parte común que pretendemos extraer y exponer.

Metodología

 * La metodología es la forma de llevar a cabo un trabajo.
 * Metodología para nosotros será la manera de gestionar y realizar el proyecto.

Metodología

 * Ténicas; diagramas y documentos de texto explicativos.
 * Herramientas; editor de texto, Diagramadores como Dia y herramientas de gestor de proyectos como ProjectLibre Microsoft Project
 * Procedimientos o métodos: dividir el proceso en fases

Ciclo de vida de desarrollo del proyecto

 * Seguiremos un ciclo de vida secuencial
 * Este vacío es especialmente peligros en proyecto de naturaleza lógica como de software

Ciclo de vida

 * La metodología nos va a permitir organizar ese ciclo de vida del proyecto


 * Objetivo: aplicar una metodología a ese tiempo



Fases

 * En cada fase realizaremos actividades  que van a darnos un determinado producto dentro del desarrollo del proyecto.
 * Este producto puede constar de uno o varios documentos que lo constituyen.
 * Una fase termina en un momento determinado y permite verificar el producto obtenido
 * Cada fase ha de ser identificada con un hito
 * Hito: fecha concreta marcada en la planificación.

Hito

 * Fechas importantes marcadas en la planificacion temporal del proyecto


 * Los Hitos
 * Es muy importante establecer los hitos en la planificacion del proyecto
 * Estas fechas establecidas no deben de ser muchas
 * En ellas el cliente y la empresa se juntan y evaluan el proyecto, tanto la marcha del mismo como la calidad
 * Esto implica que en esa fecha se ha de poder evaluar parte del producto, prototipo o documentación que verifique la marcha y calidad del mismo
 * Lo que se le enseñe al cliente ha de ser tangible para él.
 * Puede haber hitos en los que no intervenga el cliente


 * Un hito implica una reunión de evaluación del proyecto
 * La reunión se ha de preparar, planificar y realizar
 * El alumno nos pueden enseñar el proyecto y ellos mismo pueden ver como van
 * Al menos un hito por fase debería de ser obligatorio.

Estableciendo fases

 * Cada metodología establece una serie de fases, nosotros proponemos las siguientes
 * 1) FASE INICIAL
 * 2) FASE ACUERDO DEL PROYECTO
 * 3) FASE DE ANÁLISIS Y DISEÑO
 * 4) FASE DE IMPLEMENTACIÃÓN
 * 5) FASE DE PRUEBAS
 * 6) FASE DE FINALIZACIÓN


 * Desarrollando un proyecto
 * 1) El contexto
 * 2) La documentación
 * 3) Documentos de gestion
 * 4) Documentos de desarrollo
 * 5) Las fases
 * 6) Etapas lógicas con cierta independencia en el desarrollo del proyecto


 * Estructura de directorios


 * Esto es importante para las versiones y copias de seguridad

Antes de empezar el proyecto: El contexto

 * Antes de empezar a analizar las fases propuesta y los productos a obtener unas consideraciones
 * Pueden ser interesantes para dotar al proyecto de un contexto mas real
 * El alumno representa una empresa, por lo que sería interesante especificar
 * Nombre de la empresa
 * Logotipo de la empresa
 * Quizás pueda parecer una pérdida de tiempo, pero la experiencia demuestra el alumno se mete más en el papel de empresario desarrollador.

Creación de la empresa

 * Puede coordinarse esta acción con el docente de EIE

La documentación

 * Normalmente les entregamos en la normativa de la forma de entregar el proyecto como han de documentar (tipo de letra etc....)
 * También se les puede proponer que entregue un documento especificando este hecho
 * Está claro que todos los documentos que entreguen han de tener un formato similar
 * Tendrá que tener un Ãíndice, una cabecera con nombre de la empresa y logotipo, nombre del docuemnto, numeración ...


 * El documento de formato
 * La empresa tendrá un formato concreto de cómo para hacer los proyectos.
 * Es un documento que se puede pedir como parte de la gestión del proyecto
 * Parte serán requisitos que se les pida a los alumnos, los cuales pueden incluir en el documento
 * Es bueno que se configuren las herramientas para adaptar el proyecto con el mismo formato.
 * Por ejemplo el openoffice o word, incluir índices de forma aútomática, teclas para especificar formatos, estilo de títulos, ....



Fase Inicial

 * Es la primera fase.


 * En esta fase suele haber mucha incertidumbre
 * A veces es difícil proponer proyectos (largo, corto, fácil, difícil).
 * La experiencia nos irá eneñando en este aspecto
 * Es posible que se asignen proyectos y durante su realización se tengan que acortar


 * El Calendario en la Fase inicial, cuando realizarla.
 * Para nuestro proyecto sería bueno que esta fase la cubriera la alumna en una fecha concreta.
 * Según legislación en enero los alumnos deben conocer la lista de posibles proyectos a realizar.
 * El alumno ha de presentar la propuesta de su proyecto.
 * Es posible que un alumno/a tenga una idea de proyecto incluso empezado y cuando va a la empresa cambia de proyecto.
 * Es una realidad frecuente.


 * El Calendario en la Fase inicial
 * Se debe poner una fecha para que el alumno haga su propuesta de proyecto al departamento de informática por medio del tutor.


 * Entrada a esta fase
 * 1) Lista de posibles proyectos que el departamento proponga
 * 2) Lista de posibles proyectos de empresas donde se realicen las FCT's
 * 3) Propuesta directo de alumnos/as del ciclo
 * Actividad
 * Consiste en la elección de un proyecto


 * Salida
 * La propuesta del proyecto: Título y objetivo principal


 * Ejemplo de lista de proyectos de nuestro centro informática para alumnos de DAW y DAM
 * El siguiente es un documento que se entrega a los alumnos y podemos analizar en él diferentes apartados
 * Lo podemos ver para ver títulos de proyectos

El título del proyecto

 * El título no ha de ser muy largo, el título no son los objetivos, Representa lo qué queremos realizar.
 * Debe ser conciso y expresar de la manera más precisa posible el trabajo a realizar.
 * Debe ser válido durante todo el ciclo de vida del proyecto.


 * Propuesta de MIDEPLAN


 * Ejemplos de títulos

Objtivo general

 * Es un resumen de todos los objetivos específicos que puediera haber y guardará una relación directo con el título del proyecto.
 * Consiste en reflejar la meta a la que deeamos llegar con la realización del proyecto
 * Objetivo una descripción un poco más larga del título. Podríamos pensar en uno o dos párrafos de no más de 4 o 5 líneas cada uno, aunque dependiendo del tipo de proyecto y forma de expresarse de la alumna podría alargarse más.

}

Fase inicial: Documento de propuesta

 * La salida de la fase inicial es un documento de propuesta dle proyecto
 * En una hoja o bien la primera hoja de dosier del proyecto debe ser la propuesta del mismo
 * Debe de especificar el título del proyecto y el objetivo general
 * Debe de ir fechado.

Fase de Acuerdo

 * Esta es la fase qué más nos interesa
 * Es una fase común para todos los proyectos
 * Culmina en el documento de contrato entre cliente y desarrollador

Actividades en la fase de Acuerdo

 * Presupuesto
 * Planificacion
 * Lista de requisitos
 * Pliego de condiciones
 * Contrato firmado

Lista de Requisitos

 * Consite en establecer los requisitos del sistema


 * Entradas
 * Son muchas la técnicas para obetener información
 * Esta es una actividad primordial
 * De ella depende todo el proyecto
 * Debe de haber entendimiento y compresión.
 * Es mejor repetir los puntos importantes para asegurar la comprensión del problema
 * Muchos problemas no se pueden resolver por que no se entiende bien el planteamiento, no por que no se sepan resolver

Se que tu crees que yo entiendo lo que tu dices pero de lo que no estoy tan seguro es de que lo que tú has querido decir es lo que yo he creído entender
 * Aparecen problemas de comunicación


 * Entrevistas
 * En nuestro caso son reuniones con el alumno/profesor o el alumno en su centro de trabajo con la empresa
 * Es importante que las entrevistas estén preparadas
 * Debería de quedar documentado el resultado de cada una de ellas por escrito


 * Salida: Lista de requisitos
 * En un documento de texto detallamos una tabla cada requisito perfectamente identificado
 * Un requisito a de responder a un objetivo claro del producto
 * Ha de ser perfectamente evaluable con el producto final
 * No puede haber ambiguedades

El sistema debería de .... El producto debe de ser amigable
 * Los requisitos
 * Evitar los condicionales y verbos imprecisos
 * Amigable para quién, cuanto de amigable ????
 * No puede haber requisitos ambiguos o incompletos, no se pueden dejar cosas abiertas


 * Los requistos
 * Los requisitos no son el pedido del cliente, no es el objetivo que pretende del proyecto.
 * Los requisitos los determina el desarrollador a partir de la información que obtiene del cliente.
 * 1) Entrevistas(personales, colectivas, lluvia de ideas, ...)
 * 2) cuestionarios
 * 3) En general cualquier técnica que nos aclarare qué es lo que realmente tiene que hacer el proyecto.


 * Los requisitos
 * Al determinar los requisitos el desarrollador a veces abre los ojos al cliente de qué es lo que quiere
 * En muchas ocasiones se verifica la viabilidad/inviabilidad de determinadas pretensiones.


 * Ejemplo de lista de requisitos

Lista de tareas



 * Lista de tareas entradas
 * A partir de la lista de requisitos identificamos cada tarea.
 * Cada tarea estará identificada con un nombre de sigla por ejemplo T1, .. Tn.
 * Cada tarea tendrá de una pequeña descripción.
 * Tendrá un tiempo de realización que hay que asignar.
 * El tiempo que determinemos estará basado.
 * En nuestra experiencia.
 * En registros de tiempos que tengamos.
 * Hay que intentar asignar cada tiempo de forma real y lo mas aproximado posible.


 * Dependencia entre tareas
 * Normalmente las tareas son dependientes
 * Esto implica que hasta que no terminemos una determinada tarea, no podremos empezar otra
 * En la lista de tareas es importante especificar esta dependencia de prelaciones entre tareas
 * También es importante tener en cuenta los recursos necesarios para cada tarea
 * Este recurso también se asociará a la tarea que lo necesite


 * Ejemplo donde podemos ver tareas

El Pert

 * Este método es una técnica gráfica de grafo dirigido, el cual permite establecer la dependencia de las tareas y marcar el tiempo que se tarda en realizar el proyecto planificado.
 * En este método los cículos del grafo representan la etapa en la que se encuentra el proyecto habiendo terminado en una etapa un número determinado de tareas
 * El arco con nombre representa una tarea que me lleva de una etapa a otra

https://docs.google.com/document/d/12e3_JwQKaQICz-y0Y5Xg4RVgHGPfgLNTqwlOe_h9vqI/edit?hl=en
 * El pert
 * Podemos ver el siguiente fichero para entender esta sencilla técnica
 * Para hacer el pert necesitaremos una tabla de prelaciones  de las tareas o matriz de encadenamientos
 * Para ver estos conceptos miramos el siguiente fichero

La planifiacion:Diagrama de Gantt

 * Es otro forma de represnetar el espacio temporal en hacer el proyecto
 * en este caso no se represnetan la prelaciones aunque lógicamente hay que respetarlas

http://es.wikipedia.org/wiki/Diagrama_de_Gantt
 * El diagrama de Gantt
 * Es una herramienta gráfica soportada por casi todos los gestores de proyectos que permite establecer el espacio temporal del desarrollo del mimos
 * A partir de él se establece el calendario de hitos
 * Al finalizar determinadas tareas es conveniente establecer una verificación del producto

El diagrama de Gantt y el calendario de hitos

 * Ralizar revisiones durante la realización del proyecto es importante y necesario
 * Permite ver si el proyecto va marchando según lo establecido
 * Permite establecer momentos en los que se verifica la calidad del producto.
 * Un hito debería de implicar una reunión con el cliente, en este caso con el profesor
 * Esa reunión debería de estar preparada y generar un acta o registro de dicha reunión
 * Esto se pude recoger en un documento de reuniones

http://wiki.es.it-processmaps.com/index.php/Gesti%C3%B3n_de_proyectos_-_plantillas,_listas_de_control_y_recomendaciones
 * Registro de reuniones
 * De la siguiente url podemos sacar ideas para las plantillas de las reuniones


 * Reuniones


 * El presupuesto
 * Para su elaboración contamos con el diagrama de tareas
 * Obtener el precio/hora según la labor realizada
 * Debemos saber los recursos que utilizamos
 * Este tema es importante elaborarlo teniendo en cuenta los contenidos impartidos en EIE
 * No olvidar precio/hora en difernetes roles
 * Aplicar los impuestos
 * Obtener el total neto (Sin impuestos) y el total bruto (aplicando impuestos)

Pliego de condiciones y contrato
En el acuerdo todos somos muy positivos y cedemos mucho, pero luego hay que acarrear con las consecuencias de lo que hayamos pactado
 * En los proyectos de empresas el pliego de condiciones normalmente siempre existe
 * Para nosostros sería interesante añadir alguna condición
 * Por ejemplo que el desarrollador no se hace cargo del mantenimiento si no se realiza un uso correcto del producto o si manipula los fuentes o la maquinaria, ...
 * Tampoco interesa mucho extenderse, pero sí que exista y haya algún punto.presencia


 * El contrato
 * Puede parecer un poco frívolo, pero es interesante realizarlo
 * En él debe de aparecer el nombre de la empresa ficticia que representa el alumno, y el nombre del cliente, en este caso el ciclo formativo que está cursando y módulo del proyecto
 * Debe aparecer explícitamente
 * 1) Nombre del proyecto
 * 2) Nombre de la empresa con su representante legal que en este caso es el alumno,
 * 3) Nombre del cliente con su represnetante que sería el tutor del ciclo


 * El contrato:
 * 1) El importe total al que asiciende el presupuesto tanto en neto como en bruto
 * 2) La fecha de comienzo y de finalización
 * 3) Fecha y lugar de entrega
 * 4) Es recomendado que esté firmado, constituyendo la fecha de la firma del proyecto el primer hito importante para la realización del proyecto.

Fase de análisis y diseño

 * Estas fases ya dependen mucho de la naturaleza del proyecto a realizar
 * No obstante deberían de existir siempre
 * La idea es que antes de hacer algo,
 * 1) Hay que investigar alternativas, opciones, diseñarlo
 * 2) Construir prototipos
 * 3) Evaluarlos según los requisitos

Fase de análisis
Quiero un sistema de automatización en mi casa con control de presencia para alarmas
 * Todos los documentos generados que van encaminados a dejar claro qué es lo que se pretende hacer con el proyecto.
 * Hay proyectos que esto está claro con el pedido que hace el cliente
 * Hay proyectos como en el caso del software que esto hay que refinarlo y hacerlo, acercando las pretensiones del cliente al mundo real para su elaboración
 * Está claro qué es lo que quiere el cliente


 * Fase de análisis y diseño
 * Quizá en el ejemplo anterior no está tan claro que es lo que tiene que hacer el proyecto.
 * Esto es de lo que trata el análisis, es una fase de investigación y descubrimiento


 * La fase de análisis


 * Fase de diseño
 * El diseño puede considerarse otra fase o estar dentro de la fase anterior
 * Esta fase sería una evolución de la parte anterior
 * Una vez que sabemos qué queremos hacer pasamos a un segundo estado en el que vemos cómo lo vamos a hacer.
 * Usar diagramadores es una técnica muy buena para estos casos

Fase de implementación o desarrollo y pruebas



 * Implementacion
 * Consiste en el desarrollo del proyecto
 * Se lleva a cabo la implementación de sus partes
 * Debe de ser una continuación de la fase anterior
 * Normalmente las fase de implementación va fluyendo en espiral con las anteriores
 * Es decir no es muy habitual hacer un análisis y diseño completo y luego la implementación


 * Las pruebas
 * La fase de pruebas debe de estar presente en todo el proyecto
 * En cada uno de los hitos del mismo
 * Deben de analizarse y verificarse los requisitos planteados
 * Al final ha de verificarse de forma satisfactoria cada uno de los requisitos pactados

Fase de entrega



 * La entrega
 * El sitio y la forma son importantes
 * Esta información se le debe de entregar al alumno
 * Normalmente queda establecido previamente

Lista de documentos a entregar

 * 1) Acuerdo del proyecto o contrato
 * 2) Planificación
 * 3) Diagrama de Gantt
 * 4) Pert como diagrama de prelaciones
 * 5) Calendario de hitos
 * 6) Lista de tareas
 * 7) Diagrama Pert


 * Lista de documentos a entregar
 * 1) Presupuesto
 * 2) Amortización del material/recursos/inmovilizado/seguros a utilizar en el proyecto
 * 3) Impuestos según corresponda
 * 4) Cantidad total neta/bruto del proyecto
 * 5) Lista de requisitos (concretos y verificables)
 * 6) Pliego de condiciones
 * 7) Contrato


 * Lista de documentos a entregar
 * 1) Documentos de análisis y diseño
 * 2) Documento de implementación y manuales de uso según proceda
 * 3) Documento de pruebas (Plan de pruebas y realización de la mismas
 * 4) Otros documentos de la gestión
 * 5) Diario de bitácora
 * 6) Documento de reuniones (de cada hito debería haber una especie de acta)
 * 7) Documento de formato
 * 8) Documento de postmorten

FIN