Yo tambin soy partidario de ir a mtrica aunque hay muchas cosas que te puedes salt ar ya que igual no tienes tiempo

de aprender a hacer Dfds o diagramas de clases. Consigue Ms project, con el defines las actividades(analisis,diseo,construccin,imp lantac in) y las tareas de cada actividad, basandote en metrica. En anlisis te puedes limitar a sacar los requerimientos de usuario, de ah las func ionalidades y el DER(diagrama entidad-relacin), en diseo das la descripcin de tabla s y base de datos y las interficies de usuario, dialogos, pequea descripcin de cad a cual. En construccin le metes el cdigo fuente... **************** Mira, hace tiempo tuve que documentar un software y tambien estuve buscando info rmacion en internet, pero me fue muy dificil encontrar algo preciso, asi que de varios documentos tome algo que me parecia bueno, te voy a mostrar la tabla de c ontenidos, el primer capitulo es algo que no tienes que ver mucho, pero me gusto como quedo, basicamente te tienes que apoyar en los diagramas UML y algo del es tandar 830 de la IEEE, teniendo en cuenta un modelo de desarrollo puede ser proc eso unificado: Capitulo I: Alcance del Sistema 1.1 Planteamiento del problema 1.2 Justificacion 1.3 Objetivos 1.3.1 Objetivo general 1.3.2 Objetivos especificos 1.4 Desarrollo con proceso unificado Capitulo II: Analisis y especificacion de requisitos 2.1 identificacion y desccripcion de pasos 2.2 especificacion de requisitos 2.2.1 objetivos del sistema 2.2.2 requisitos de informacion 2.2.3 restricciones del sistema 2.3 requisitos funcionales 2.3.1 diagramas de casos de uso 2.3.2 definicion de actores 2.3.3 documentacion de los casos de uso 2.4 requisitos no funcionales Capitulo III: Diseo del sistema XXX 3.1 diagrama de clases 3.1.1 documentacion del diagrama de clases (CRC) 3.2 modelo entidad relacion 3.3 modelo relacional 3.4 diccionario de datos 3.5 diagrama de secuencias 3.6 diagrama de actividades Capitulo IV: Implementacion 4.1 Arquitectura del sistema 4.2 Implementacion con estandares 4.3 Arquitectura de desarrollo 4.4 estandar de codificacion 4.5 sistema de control de versiones 4.6 diagrama de componentes Capitulo V: Pruebas

5.1 Planificacion 5.2 desarrollo de las pruebas Capitulo VI: Resultados 6.1 conclusiones 6.2 trabajos futuros 6.3 anexos(puede ir el manual de usuario) ******************************************* 1. Introduccin 2. Estandarizacion y normalizacin 3. Manual Administrativo 4. Manual De Usuario 5. Manual De Captacion 1. Introduccin La documentacin de sistemas es el conjunto de informacin que nos dice qu hacen los sistemas, cmo lo hacen y para quin lo hacen. La documentacin consiste en material que explica las caractersticas tcnicas y la op eracin de un sistema. Es esencial para proporcionar entendimiento de un sistema a quien lo vaya a usar para mantenerlo, para permitir auditoria del sistema y par a ensear a los usuarios como interactuar con el sistema y a los operandos como ha cerlo funcionar. Existen varios tipos de documentacin. La de programas, que explica la lgica de un programa e incluye descripciones, diagramas de flujo, listados de programas y ot ros documentos; la del usuarios en forma general la naturaleza y capacidades del sistema y cmo usarlo. Muchas organizaciones tienen lo que se conoce como un "programa de documentacin", el cual consiste en una poltica formal cuya documentacin se muestra como algo que debe prepararse en forma rutinaria para cada programa de cmputo, archivo y nuevo s sistemas. Otra definicin sera la de registro fsico, generalmente por escrito que contiene los siguientes elementos: Polticas y normas referentes al desarrollo del sistema, su implantacin, operacin y mantenimiento. El diseo del sistema de informacin administrativo. Procedimientos para instalar el sistema de informacin administrativo. Procedimientos para operar el sistema de informacin administrativo. Procedimientos para mantener el sistema de informacin administrativo. Importancia De La Documentacin De Sistemas La importancia de la documentacin bien podra ser comparada con la importancia de l a existencia de una Pliza de Seguro; mientras todo va bien no existe la precaucin de confirmar si nuestra Pliza de Seguros est o no vigente. La documentacin adecuada y completa, de una aplicacin que se desea implantar, mant ener y actualizar en forma satisfactoria, es esencial en cualquier Sistema de In formacin, sin embargo, frecuentemente es la parte a la cual se dedica l menor tie mpo y se le presta menos atencin.

Siempre se debe documentar un sistema como si estuviera a punto de irse a Siberi a el siguiente mes, para nunca volver. Si la documentacin del sistema es incomple ta el diseador continuamente estar involucrado y no podr moverse a otra asignacin. 2. Estandarizacion y normalizacion Estandarizacion Significa que los smbolos convencionales se usan en todos los diagramas de flujo para prescribir el sistema y que en la documentacin se usen formas estandarizadas . An cuando las normas de documentacin varan de una instalacin a otra, es esencial que dentro de una organizacin, se utilice un solo mtodo. El uso de procedimientos y d ocumentacin estandarizada proporciona la base de una comunicacin clara y rpida, adi estramiento menos costoso del personal de sistemas, reduccin de costos de almacen amiento, y otros. Ventajas De La Estandarizacion Ayuda al entrenamiento del nuevo personal dentro y fuera de la organizacin de Sis temas. Es til para cualquiera que tenga la responsabilidad del mantenimiento de los sist emas. Ayuda a los analistas y diseadores de sistemas en el trabajo de integracin de sist emas. Asegura que el sistema opere correctamente. Se utilizan eficientemente los recursos que se dispongan. Estandares Bsicos De Documentacin Toda documentacin que se relacione con un sistema, ya sea manual o por computador a, sencillo o complejo debe reunir los siguientes requisitos bsicos: Debe ser rotulada con claridad y bien organizada, con secciones claramente indic adas, almacenarlas en carpetas e ndice. Los diagramas debern ser claros, no aglomerados y la escritura manuscrita deber se r legible. La documentacin deber ser completa. Se incluir una leyenda o explicacin de los trminos utilizados. La documentacin siempre se conserva actualizada. Normalizacin Asegrese de que los estndares sean completos, actualizados, documentados y legible s. Auditar permanentemente para que se cumplan los estndares. Evaluar si los estndares establecidos son los requeridos y hacer los cambios nece sarios para que dichos estndares sean los apropiados. Teoria General De Los Manuales De Documentacin Durante el desarrollo de un sistema, desde su concepcin hasta su puesta en marcha se ha generado gran cantidad de documentos, que en muchas ocasiones se han vist o modificados por documentos posteriores debido a cambios en el sistema. Para evitar confusiones en las revisiones de la documentacin se desarrollan difer

entes tipos de documentos dirigidos a las personas que trabajarn con el sistema y para facilitar el mantenimiento del mismo. La documentacin de un sistema debe se r marcada adecuadamente, bien organizada actualizada y completa; todos los trmino s utilizados deben explicarse. La documentacin se har disponible a todos los usuar ios dc acuerdo a sus necesidades. El estilo de redaccin de los manuales de documentacin debe ser: Concreto. Ser preciso y definir los trminos utilizados. Utilizar prrafos cortos. Utilizar ttulos y subttulos. Utilizar formas activas en lugar de pasivas. No emplear frases largas que presenten hechos distintos. No hacer referencia a una informacin solamente con el nmero de referencia 3. Manual Administrativo Sirve como punto de partida al Sistema propuesto, ya que ser funcin de la gerencia , de acuerdo con los usuarios de dicho Sistema, determinar silo expuesto en l sat isface los requerimientos del propio sistema. Una vez lograda la aprobacin, se es tar en condiciones de iniciar el desarrollo del Sistema propuesto e ir integrando el resto de la documentacin. El manual tiene como finalidad el permitir a la alta gerencia tener la informacin necesaria y suficiente sobre un sistema en particular y servir como fuente dc c onsulta una vez que el Sistema ha sido implantado. Contenido Nombre del sistema Describir el nombre del sistema a implantar en la empresa. Equipo Encargado Del Sistema Nombre del personal encargado del anlisis y diseo del sistema. Resumen Administrativo Compendio de lo puntos que se describen en el manual, el cual tiene como propsito permitir a los altos ejecutivos enterarse en forma somera de la propuesta del s istema. En este punto aparece por primera vez el nombre del sistema, el cual deb e ser nico, este deber conservarse invariable en todos los documentos referentes a ese sistema. Planteamiento Este punto tiene como finalidad registrar los antecedentes que servirn de partida al desarrollo del anlisis del sistema. Se debe mencionar: Dependencia que requiri el trabajo. Personas y / o puestos ocupados por estas al momento de requerirse el trabajo (a cuerdos, disposiciones legales, memorandos, y otros) Condiciones y criterios que normaron el desarrollo del trabajo. Fechas correspondientes. Objetivos Del Sistema Aqu se dejarn establecidos los objetivos que debe cubrir el sistema, en forma clar

a y precisa para evitar errores de interpretacin. Entradas Del Sistema (Informacin A Captar) Debe quedar especificado en este punto, los documentos fuentes que inician las o peraciones del sistema as como la informacin detallada de aquellos conceptos que s ern los datos a captar por el sistema. Se debern mencionar todos los datos que en forma secundaria originan una entrada importante al sistema. Ejemplo: Nombre del Documento Fuente Mdulo o Procedimiento donde entra el documento Usuarios que manejan el documento Origen del documento Salidas Del Sistema (Resultados A Obtener) En este punto, solamente se describirn los resultados de mayor importancia obteni dos a travs de todo el proceso. En esta seccin se debe dar mayor nfasis a la inform acin que el sistema proporciona cuidando de no hacer tan slo mencin de los resultad os a obtener. Ejemplo: Nombre de la salida Destino Periodicidad en que se genera Usuarios que lo requieren Diagramacion General Del Sistema Es la representacin grfica de las fases del Sistema y su flujo a travs de las depen dencias que intervienen en el mismo, aunque en forma generalizada. La tcnica a ut ilizar y la simbologa debe ser seleccionada por los interesados. Explicaciones De Las Fases Del Sistema Este punto se encuentra relacionado con el anterior ya que lo que se muestra grfi camente, ahora se describe en forma genrica, explicando los procesos que se lleva n a cabo en cada dependencia sin profundizar en detalles tcnicos o especficos. Se deber resaltar aquellas fases del proceso en las cules se obtengan resultados de i mportancia as como aquellas que requieran una supervisin especial. Requerimientos Del Sistema Se establecen los recursos, tanto humanos como materiales que son necesarios par a poder llevar a cabo el sistema. Presentar costos y descripcin, adems de las cant idades que se requieran. Estimacin De La Fecha Probable De Implementacion Del Sistema Es necesario que exista una fecha probable de implantacin cuya base ser la termina cin de todas las actividades para la creacin del sistema, tales como: anlisis, prog ramacin, elaboracin de formas, y otros. Se recomienda utilizar diagrama de Grantt o de Pert para establecer el perodo de las actividades requeridas para el desarrollo del sistema.

Ejemplo: Escala del tiempo en semanas Actividades a realizar 1 2 3 4 Presentacin de la Propuesta *****

Anlisis Costo / Beneficio *****

Adquisicin del Equipo ***** Entrenamiento

***** Consideraciones Generales Del Nuevo Sistema En este punto se deber sealar las ventajas, desventajas, y principales diferencias del nuevo sistema con el anterior, tales cmo seguridad, disminucin de costo, ahor ro de tiempo, flexibilidad, confiabilidad y otros. Adems, desarrollar en cualquie r aspecto de la propuesta del sistema que no file considerado en el desarrollo d e los puntos antes mencionados. 4. Manual De Usuario Expone los procesos que el usuario puede realizar con el sistema implantado. Par a lograr esto, es necesario que se detallen todas y cada una de las caracterstica s que tienen los programas y la forma de acceder e introducir informacin. Permite a los usuarios conocer el detalle de qu actividades ellos debern desarrollar para la consecucin de los objetivos del sistema. Rene la informacin, normas y documenta cin necesaria para que el usuario conozca y utilice adecuadamente la aplicacin des arrollada. Objetivos Que el usuario conozca cmo preparar los datos de entrada.

Que el usuario aprenda a obtener los resultados y los datos de salida. Servir como manual de aprendizaje. Servir como manual de referencia. Definir las funciones que debe realizar el usuario. Informar al usuario de la respuesta a cada mensaje de error. Pasos a seguir para definir como desarrollar el manual de usuario. Identificar los usuarios del sistema: personal que se relacionar con el sistema. Definir los diferentes tipo de usuarios: se presentan los diferentes tipos de us uarios que usaran el sistema. Ejemplo: usuarios directos, indirectos. Definir los mdulos en que cada usuario participar: Se describen los mdulos o proces os que se ejecutarn por cada usuario en forma narrativa breve y clara. Importancia Del Manual De Usuario El Manual de Usuario facilita el conocimiento de: Los documentos a los que se puede dar entrada por computadora. Los formatos de los documentos. Las operaciones que utiliza de entrada y salida de los datos. El orden del tratamiento de la computadora con los datos introducidos. El momento en que se debe solicitar una operacin deseada. Los resultados de las operaciones realizadas a partir de los datos introducidos. Al elaborar el Manual de Usuario, hay que tener en cuenta a quin va dirigido es d ecir, el manual puede ser manejado desde el director de la empresa hasta el intr oductor de datos. Por consiguiente, debe redactarse de forma clara y sencilla pa ra que lo entienda cualquier tipo de usuario. Contenido Diagrama general del sistema Muestra en forma condensada el flujo general de la informacin y de las actividade s que se realizan en el sistema. Proporciona una visin general del sistema. Repre sentar los diagramas utilizando para ello diagramas de bloques. Diagrama particular detallado. Presentar grficamente todos los pasos que se efecten dentro del departamento usuar io a quien est dirigido este manual. Deben especificarse los archivos de entrada, salida, los resultados, revisiones y procesos manuales. Explicacin Genrica De Las Fases Del Sistema En este punto se explica en forma especfica y detallada todas las operaciones que aparecen representadas en forma grfica en el diagrama particular. Se analizan ca da una de las fases sealando: El La La El proceso principal que se desarrolla. entrada de la informacin. obtencin de un resultado parcial. envo de informacin a otra dependencia.

Instalacin Del Sistema La instalacin del sistema proporciona detalles completos sobre la forma de instal ar el sistema en un ambiente particular.

Iniciacin Al Uso Del Sistema En este punto se explica cmo iniciarse en el sistema y cmo se pueden utilizar sus cualidades comunes. Esta documentacin debe decir al usuario cmo salir de un proble ma cuando las cosas funcionan mal. Manual De Referencia Es el documento definitivo de cara al usuario y debe ser completo. Describe con detalle las cualidades del sistema y su uso, los informes de error generados y l as situaciones en que surgen esos errores. Dependiendo del sistema, los documentos al usuario se pueden proporcionar por se parado o reunidos en varios volmenes. Los sistemas de ayuda en lnea evitan que el usuario pierda tiempo en consultas manuales. Caducidad De Documento Fuente Y Destino Final Como el usuario trabajar con documentos fuentes, stos podrn tener un perodo de reten cin y un destino especificado. 5. Manual De Captacion Permite tener una clara visin del proceso de Captacin de los latos fuentes previo al procesamiento electrnico de los mismos. Objetivos Documentar al usuario a cerca del recorrido a travs de las pantallas del sistema. Conocer la forma cmo el usuario puede utilizar el equipo necesario para la ejecuc in del sistema. Contenido Diagrama General Del Sistema Este diagrama debe ser presentado grficamente y en forma sencilla. Representar lo s diagramas utilizando para ello diagramas de bloques ( es el mismo diagrama que se presenta en el Manual Administrativo). Diagramas De Pantalla Presentar en este punto el flujo del sistema en las pantallas utilizadas por cad a mdulo. Puntos a documentar en una pantalla: Explicacin del recorrido para llegar a la pantalla. Formato de los datos a captar. Formato en que son captados los datos. Explicacin Genrica De Las Fases Del Sistema Es una explicacin clara, breve de todos los mdulos que se presentan en el diagrama general. Equipo Utilizado Para La Captacin Se debe crear un instructivo que permita al usuario el entrenamiento del sistema . Debe contener los siguientes puntos:

Uso del equipo: Describir detalladamente el uso correcto del equipo utilizado para la captacin de la informacin, dando una explicacin del encendido, manejo, control y del material que se usa como medio de captacin de los datos. Entrenamiento del Software de la aplicacin: Explicacin del software utilizado en complemento al sistema. Ejemplo: como entrar y salir del sistema. Situaciones Anormales Se presentan mensajes que se emiten al momento de la captura de los datos o cual quier condicin fuera dc lo normal. Ejemplo: Situacin anormal Mensaje Causas Soluciones Entregas Al Computador Establecer un calendario con fechas de entrega al computador, al igual que un ho rario para la obtencin de resultados. El calendario determina marca cundo las actividades deben llevarse a cabo dc mane ra que la gestin del sistema no se vea afectado. Si es un sistema en lnea no se re quiere. Ejemplo: Operacin Frecuencia Objetivo Hora de Entrada Hora de salida Solicitud de reporte Semanal Mensual Actualizar informe del departamento X Antes de las 2:00 p.m. 3:00 p.m. Caducidad De Documentos Fuentes Establecer por escrito la fecha de caducidad de los documentos fuentes, el fin a que han de destinarse ya sea para su destruccin, devolucin o conservacin en un arc hivo. Manual de operacin Objetivo Contiene la informacin que permite al personal de operacin utilizar en forma efici ente la operacin de los sistemas de procesamiento electrnico.

Contenido Diagrama general del sistema Este diagrama debe ser presentado grficamente y en forma sencilla. Representar lo s diagramas utilizando para ello diagramas de bloques (es el mismo diagrama que se presenta en el Manual Administrativo ). Diagrama general del flujo del proceso electrnico. Se representa en este diagrama todo el ambiente perifrico que interacta en el sist ema en cuanto a: entradas manuales, medios magnticos y dispositivos de salida. La simbologa a utilizar debe ser establecida como estndar. (Ejemplos: cintas, discos , disquetes). Explicacin Genrica De Las Fases Del Sistema Es una explicacin clara, breve de todos los mdulos que se presentan en el Diagrama general descrito anteriormente. Diagrama De Pantallas Del Sistema Se presenta en este punto el flujo del sistema en las pantallas utilizadas por c ada mdulo. Puntos a documentar en una pantalla: Explicacin del recorrido en pantalla. Formato en que son captados los datos. Instruciwo De Operacin Por Programa Se debe desarrollar por cada programa dcl sistema. Incluye: Diagrama electrnico del programa.