ManuelRomero/proyectos/DAW/Documentacion

De WikiEducator
Saltar a: navegación, buscar



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.

Forma de desarrollar un proyecto

ProyectoFuncionActividad.png


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.


Icon define.gif

Definición

Metodología' conjunto de procedimientos (actividades y tareas), herramientas y técnicas utilizadas con el objetivo de llegar a la realización correcta de un proyecto planteado


Metodología

Metodología.png

  • 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
CicloVida.png
  • 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


Icon define.gif
Definición
Ciclo de vida tiempo que transcurre desde que se plantea el proyecto hasta que éste se entrega de forma correcta (cumpliendo las especificaciones planteadas)


  • Objetivo: aplicar una metodología a ese tiempo


Icon define.gif
Definición
El ciclo de vida son las diferentes etapas o fases por las que va pasar el proyecto desde su concepción hasta su implantación o entrega al cliente


CicloVida2.png

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
Hito.png
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.
ReunionHito.png

Estableciendo fases

  • Cada metodología establece una serie de fases, nosotros proponemos las siguientes
Fases.png
  1. FASE INICIAL
  2. FASE ACUERDO DEL PROYECTO
  3. FASE DE ANÁLISIS Y DISEÑO
  4. FASE DE IMPLEMENTACIAÓN
  5. FASE DE PRUEBAS
  6. FASE DE FINALIZACIÓN
Desarrollando un proyecto
  1. El contexto
  2. La documentación
    1. Documentos de gestion
    2. Documentos de desarrollo
  3. Las fases
    1. Etapas lógicas con cierta independencia en el desarrollo del proyecto
Estructura de directorios


Icon activity.jpg
Actividad
pensar en una estructura de directorios para un proyecto


  • 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


Icon casestudy.gif
Idea
  • En el módulo e Empresa e Iniciativa Emprendedora puede crear su empresa
  • Después usar esa empresa para el proyecto que quiran o vayan a realizar


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, ....


Icon casestudy.gif
Ejemplo
documento de formato

Archivo:Formato.pdf

Fase Inicial

  • Es la primera fase.


Icon objectives.jpg
Objetivo
El alumno/a propone/selecciona un proyecto
  • 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.
FaseInicial.png
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

Archivo:EjemploListadoProyectos.pdf

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.




Icon qmark.gif
Pregunta
El título del proyecto
  • Propuesta de MIDEPLAN
TituloProyecto.png
Ejemplos de títulos

EjemploTitulos.png


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.

Archivo:PropuestaProyecto.pdf

Fase de Acuerdo

FaseAcuerdo.png
  • 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

button
Presupuesto
Planificacion
Lista de requisitos
Pliego de condiciones
Contrato firmado

Lista de Requisitos

ListaRequisitos.png

  • 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
Aparecen problemas de comunicación
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

Comunicacion.png


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
Los requisitos
  • Evitar los condicionales y verbos imprecisos
El sistema debería de ....

El producto debe de ser amigable
    • 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

RequisitosArtigas.png


Lista de tareas

ListaTareas.png

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

TareasArtiagas.png



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

Archivo:EjemploPert.pdf


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
https://docs.google.com/document/d/12e3_JwQKaQICz-y0Y5Xg4RVgHGPfgLNTqwlOe_h9vqI/edit?hl=en


Icon activity.jpg
Actividad
*A partir de la lista anterior, realizamos el pert
  • Para ello usaremos el programa día, un sencillo diagramador




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

DiagramaGannt.png


El diagrama de Gantt
http://es.wikipedia.org/wiki/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
Registro de reuniones
  • De la siguiente url podemos sacar ideas para las plantillas de las reuniones
http://wiki.es.it-processmaps.com/index.php/Gesti%C3%B3n_de_proyectos_-_plantillas,_listas_de_control_y_recomendaciones


Reuniones


Icon activity.jpg
Actividad
Proponer como sería una reunión ficticia.
  • Suponemos que tenemos que debatir si contratar a más personas o hacer horas extras
  • Llegar a un acuerdo de forma consensuada y razonada
  • Realizar la preparación
  • Realizar el acta de la reunión usando las plantillas propuestas



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 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
En el acuerdo todos somos muy positivos y cedemos mucho, 
pero luego hay que acarrear con las consecuencias 
de lo que hayamos pactado


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

FaseAnalisisDiseno.png

  • 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

  • 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
Quiero un sistema de automatización en mi casa con control 
de presencia para alarmas
  • 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

Incertidumbre.png


La fase de análisis


Icon casestudy.gif
Idea
  • Todo aquello encaminado a aclarar y planificar qué es lo que queremos hacer correspondería a hacer un análisis del mismo.
  • Los prototipos pueden ayudar de forma clara esta fase.


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

DiseñoProyecto.png

Fase de implementación o desarrollo y pruebas

FaseImplementacionPruebas.png


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

FaseEntrega.png

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

Documentos a entregar al alumno

  1. Lista de proyectos. Mes de diciembre:Archivo:EjemploListadoProyectos.pdf.

Lista de documentos a entregar por parte del alumno

  1. Fase inicial: propuesta del proyecto. finales de enero: Archivo:PropuestaProyecto.pdf
  2. Acuerdo del proyecto o contrato Archivo
    1. Planificación
      1. Diagrama de Gantt
      2. Pert como diagrama de[ prelaciones
      3. Calendario de hitos
    2. Lista de tareas
      1. Diagrama Pert Archivo:EjemploPert.pdf
Lista de documentos a entregar
    1. Presupuesto
      1. Amortización del material/recursos/inmovilizado/seguros a utilizar en el proyecto
      2. Impuestos según corresponda
      3. Cantidad total neta/bruto del proyecto
    2. Lista de requisitos (concretos y verificables)
    3. Pliego de condiciones
    4. Contrato
Lista de documentos a entregar
  1. Documentos de análisis y diseño
  2. Documentos de implementación y manuales de uso según proceda
  3. Documento de pruebas (Plan de pruebas y realización de la mismas
Otros documentos de la gestión
    1. Diario de bitácora
    2. Documento de reuniones (de cada hito debería haber una especie de acta)
    3. Documento de formato Archivo:Formato.pdf
    4. Documento de postmorten


FIN

Fin.png
FinProyectos2.png