DOCUMENTAO DO PROJETO - PROJETO I E PROJETO II

Apostila 1

Prof. Sergio de Paiva Rodas

SUMRIO
1 INTRODUO 2 - ESPECIFICAO DA DOCUMENTAO EXIGIDA NAS DISCIPLINAS PROJETO I E PROJETO II 2.1 - Disciplina: PROJETOS I Formato de apresentao da documentao 1 APRESENTAO 2 DEFINIO DO PROBLEMA 3 LOCALIZAO 4 ESTUDO DE VIABILIDADE 5 PLANO DE IMPLANTAO 6 CRONOGRAMA DE DESENVOLVIMENTO 7 CONCLUSO

Introduo
ESPECIFICAO DA DOCUMENTAO EXIGIDA NAS DISCIPLINAS PROJETO I E PROJETO II
A documentao tcnica exigida nas duas disciplinas ser especificada a seguir:

Disciplina: PROJETOS I
O detalhamento do contedo tanto para Projetos I como para Projetos II dever ser obtido nos documentos: METODOLOGIA PARA ELABORAO DE PROJETOS DE SISTEMAS e METODOLOGIA DE REFERNCIA PARA O DESENVOLVIMENTO DE PROJETOS DE SISTEMAS UNIVERSO (que devero ser obtidas com o Professor de Projetos), bem como na bibliografia e nos exemplos complementares fornecidos.

Disciplina: PROJETOS I
A documentao do Projeto I consiste na identificao da empresa onde ser implementado o sistema, das informaes sobre o problema, no levantamento de necessidades, na soluo proposta incluindo oramento, cronograma, diagramas da modelagem do sistema, avaliao da qualidade e telas do sistema proposto, devendo ser obedecidos os itens e a numerao que se segue.

Documentao do Projeto I
Os alunos devem complementar o contedo dos itens com os sub-itens encontrados nas apostilas da METODOLOGIA DE DESENVOLVIMENTO DE SISTEMAS e METODOLOGIA DE REFERNCIA PARA O DESENVOLVIMENTO DE PROJETO DE SISTEMAS UNIVERSO fornecidas em aula pelo orientador(a).

Documentao do Projeto I
1 APRESENTAO (a empresa onde ser implantado o sistema) 2 DEFINIO DO PROBLEMA 3 LOCALIZAO (organograma da empresa e localizao do sistema) 4 ESTUDO DE VIABILIDADE (soluo proposta e fatores tcnicos e econmicos) 5 PLANO DE IMPLANTAO 6 CRONOGRAMA DE DESENVOLVIMENTO 7 CONCLUSO 8 DIAGRAMAS 9 DIAGNSTICO DA QUALIDADE DO SISTEMA 10 TELAS DO SISTEMA (interface)
Obs.: Esta a ordem da documentao (ttulos principais do Sumrio), porm cada item necessita ser desdobrado em sub-itens, conforme as apostilas entregues aos alunos.

Documentao do Projeto I
1 APRESENTAO

Fazer uma breve introduo ao trabalho, apresentando o sistema, informando do que se trata. Este item equivale ao item SINOPSE nas apostilas da METODOLOGIA DE DESENVOLVIMENTO DE SISTEMAS e METODOLOGIA DE REFERNCIA PARA O DESENVOLVIMENTO DE PROJETOS DE SISTEMAS UNIVERSO.

Documentao do Projeto I
2 DEFINIO DO PROBLEMA Consiste na especificao detalhada item a item, dos problemas existentes de forma que a soluo atenda especificamente a cada tipo de problema encontrado. No fazer uma descrio genrica, em um nico pargrafo, especificando o problema em sub-itens, como exemplificado a seguir:

2.1 Problemas relacionados ao controle de estoque e das vendas 2.2 Problemas relacionados ao acesso s informaes 2.3 Problemas relacionados ao atendimento ao cliente 2.4 - Problemas relacionados a gesto estratgica do negcio etc......

Documentao do Projeto I
3 LOCALIZAO

Apresentar o organograma da Empresa, destacando a rea objeto da soluo.

4 ESTUDO DE VIABILIDADE Neste item deve ser descrita detalhadamente qual a soluo proposta, apontando os fatores econmicos, fatores financeiros, fatores tcnico-operacionais, riscos do projeto e planejamento de contingncia. Incluindo estimativa de volume de transaes em cada um dos bancos de dados.
Dividir em sub-itens, conforme a METODOLOGIA DE DESENVOLVIMENTO DE SISTEMAS e METODOLOGIA DE REFERNCIA PARA O DESENVOLVIMENTO DE PROJETOS DE SISTEMAS UNIVERSO.

Documentao do Projeto I
5 PLANO DE IMPLANTAO Deve ser elaborado em conformidade com a METODOLOGIA, ressaltando os controles internos e externos, relativos segurana do sistema, tanto no que se refere aos programas, como as ligadas s rotinas administrativas, manuais externas ao sistema. Descrever os mtodos de implantao, ressaltando o paralelismo na substituio dos procedimentos anteriores (se houver) e a ativao dos novos procedimentos. 6 CRONOGRAMA DE DESENVOLVIMENTO Para o Projeto I: previsto e realizado nas fases do PROJETO I e o cronograma previsto para o Projeto II. Para o projeto II: O cronograma dever ser modificado de forma a acrescentar o efetivamente realizado nas fases do Projeto II.

Documentao do Projeto I
7 CONCLUSO
Fazer uma breve concluso a respeito do que se espera com o Projeto.

8 DIAGRAMAS (sero especificados posteriormente)

Documentao do Projeto I
Documentos a serem includos, independente da modelagem utilizada:

- NORMA DE QUALIDADE ISO/IEC 9126

Acrescentar no final da documentao do Projeto, a Norma de Qualidade ISO/IEC 9126. No Projeto I ficam apenas as perguntas da parte inicial (as perguntas que forem compatveis com o PROJETO I) preenchida de acordo com a realidade (no inventada)

10 PROJETO DE INTERFACE
Tela inicial e todas as telas de entrada de dados (telas do prottipo)

ANEXO
Incluir como anexo aps o item 10, porm sem numerao, o resultado dos testes do sistema (conforme apostila 3 - TESTES)

BIBLIOGRAFIA CONSULTADA
Vem no final de tudo (Elaborar conforme as normas da ABNT)

Documentao do Projeto I
Distribuio das folhas
Sumrio 1-Apresentao
1.1 Tema 1.2 Ambiente do projeto 1.3 Escopo 1.4 Linha metodolgica 1.5 Participantes do processo de desenvolvimento 1.6 Ambientes operacionais

2-Definio do Problema
2.1 Problemas encontrados 2.2 Objetivos do projeto

3 - Localizao
3.1 Organizao da empresa 3.2 Descrio funcional resumida dos orgos ligados ao setor onde vai ser implantado o Sistema 3.3 Onde ser implantado o Sistema

4 - Estudo de Viabilidade
4.1 Sistema Proposto 4.2 Fatores Econmicos/ financeiros 4.3 Fatores Tcnicos/ Operacionais 4.4 Determinao do gru de risco 4.5 Plano de Contingncia

5 - Plano de Implantao
5.1 Controle Internos de segurana 5.2 Controles Externos de segurana 5.3 Mtodos de implantao do Sistema

6 - Cronograma de Desenvolvimento
6.1 Cronograma de desenvolvimento da fase 1 (projeto lgico) 6.2 Cronograma de desenvolvimento da fase 2 ( projeto fsico)

7 -Concluso

Descrio dos Itens da Primeira Parte do Projeto I

1. Apresentao 1.1. Tema Deve descrever a empresa, com sua identificao, rea de atuao no mercado. 1.2. Ambiente do Projeto Em que rea(s) da empresa o projeto vai atuar. 1.3. Escopo A abrangncia do projeto dentro da empresa. Est solucionando todos os problemas da empresa ?

Descrio dos Itens da Primeira Parte do Projeto I

1.4. Linha Metodolgica Qual a Metodologia utilizada para desenvolver o projeto, suas vantagens e desvantagens. 1.5. Participantes do Processo de Desenvolvimento Alm do grupo, com as funes que cada um est realizando no projeto, quem mais est participando ? Gerente, dono da empresa, amigos. Qual o grau de participao ? de que forma ? 1.6. Ambientes Operacionais Vai operar em ambiente DeskTop, Cliente/Servidor, Internet. Qual ? Por que ? Vai ser desenvolvido em que linguagem. Por que nesta linguagem ? Que tipo de banco de dados vai ser utilizado. Por que ? Vai utilizar outros tipos de Software, Utilitrios, Ferramentas. Quais e por que ?

Descrio dos Itens da Primeira Parte do Projeto I

2. Definio do Problema 1 2.1. Problemas encontrados Descrever detalhadamente (classificando por tipo de problema) os problemas encontrados na empresa, apontando as possveis causas. 2.2. Objetivos do Projeto Descrever as possveis solues encontradas para solucionar os problemas encontrados.

Descrio dos Itens da Primeira Parte do Projeto I

3. Localizao 1 3.1. Organograma da Empresa Montar o organograma de toda a empresa, marcando o depto(s) ou setor(es) onde o Sistema atuar. 3.2. Descrio funcional resumida dos depto(s) ou setor(es) ligados ao setor onde vai ser implantado o Sistema. Descrever , somente o(s) depto(s) ou setor(es) envolvidos com o Sistema. 3.3. Onde ser implantado o Sistema Qual o(s) depto(s) ou setor(es) que ter o controle do Sistema (gerncia).

Descrio dos Itens da Primeira Parte do Projeto I

4. Estudo de Viabilidade

4.1. Sistema Proposto Descrever como o Sistema ir resolver a soluo proposta. 4.2. Fatores Econmicos e Financeiros Descrever o custo estimado para implementar o Sistema proposto, incluindo compra de Hardware e Software.

Descrio dos Itens da Primeira Parte do Projeto I

4.3. Fatores Tcnicos Operacionais Descrever os fatores que podem prejudicar a implantao do Sistema, tais como treinamento de funcionrios, problemas de rejeio dos funcionrios, etc... 4.4. Determinao do grau de risco Descrever se o local da implantao do Sistema seguro, sobre diversos aspectos, tais como: Incndio, faltas de Energia constante, etc... 4.5. Plano de Contingncia Descrever situaes de emergncias que devem ser implementadas, caso haja algum imprevisto para operar o Sistema.

Descrio dos Itens da Primeira Parte do Projeto I

5. Plano de Implantao 5.1. Controle Interno de segurana Descrever planos de senhas para o Acesso ao Sistema, se tiver. 5.2. Controles externos de segurana Descrever mtodos para garantir a segurana dos dados e do Sistema, se tiver. 5.3. Mtodo de implantao do Sistema Explicar como o Sistema ser implantado na Empresa. (De uma nica vez ou gradativamente em paralelo com o Sistema atual.)

Descrio dos Itens da Primeira Parte do Projeto I

6. Cronograma de Desenvolvimento 6.1. Cronograma de desenvolvimento do Projeto de Sistema I Montar em mapa contendo todas as fases de construo e desenvolvimento de Sistemas em forma de calendrio semanal corrido. Levantamento dos dados, Reunies com o cliente, apresentao de prottipo, entre outros. 6.2. Cronograma de desenvolvimento do Projeto de Sistema II Todos j descritos anteriormente mais o tempo de desenvolvimento, testes e implantao. (No Projeto I o tempo previsto, no Projeto II o previsto e o realizado)

Descrio dos Itens da Primeira Parte do Projeto I

7 CONCLUSO Fazer uma breve concluso a respeito do que se espera com o Projeto. 8 DIAGRAMAS (sero detalhados posteriormente)

Descrio dos Itens da Primeira Parte do Projeto I

Documentos a serem includos, independente da modelagem utilizada:

9 - NORMA DE QUALIDADE ISO/IEC 9126

Acrescentar no final da documentao do Projeto, a Norma de Qualidade ISO/IEC 9126. No Projeto I ficam apenas as perguntas da parte inicial (as perguntas que forem compatveis com o PROJETO I) preenchida de acordo com a realidade (no inventada) 10 PROJETO DE INTERFACE Tela inicial e todas as telas de entrada de dados (telas do prottipo) 11- RESULTADO DOS TESTES DOS PROGRAMAS

Diagramas a serem includos no Projeto I

So especificados a seguir os diagramas mnimos exigidos (nada impede que haja mais diagramas, a seguir listado o mnimo exigido). Os diagramas variam conforme a linguagem usada para modelar o sistema. Assim temos: a) Documentos para a Anlise Essencial
b) Documentos para a Anlise Orientada a Objetos c) Documentos a serem acrescentados caso haja interface de Hipermdia (projetos que envolvam a internet/intranet/extranet) d) Documentos para o caso do desenvolvimento utilizar Inteligncia Artificial

Diagramas do Projeto I
(item 8 do Projeto I)

a) DOCUMENTOS PARA A ANLISE ESSENCIAL

(pode usar o Power Designer ) Tabela de Eventos Diagrama de Contexto DFD Particionado D.E.R - Diagrama de Entidades e Relacionamentos Modelo Lgico de Projeto de Sistemas usando o Power Design em Anlise Essencial Diagrama de Entidades e Relacionamentos (ERA) Modelo Fsico de Projeto de Sistemas usando o Power Design ou outro equivalente em Anlise Essencial Dicionrio de Fluxos de Dados Dicionrio de Dados dos Atributos Entidades do Sistema Lista de Entidades Relacionamentos

Diagramas do Projeto I
Mini-mundo Descrio dos Casos de Uso Diagrama de Caso de Uso Diagrama de Seqncia Diagrama de Colaborao ou Diagrama de Interao entre os Objetos DIO (opcional) Diagrama de Classes (completo, com o nome das classes, atributos, mtodos,
relacionamentos) b) DOCUMENTOS PARA A ANLISE ORIENTADA A OBJETOS (pode usar o Rational Rose ou o Poseidon)

Diagrama de Classes Bsicas Simplificado (somente com o nome da classe,

os relacionamentos e um label indicando o tipo de relao entre as classes) Diagrama de classes das Telas (com seus atributos, mtodos e mensagens, ligados ao modelo de classes simplificado, indicando a quais telas cada tabela possui acesso e qual a relao de cardinalidade entre elas)

Dicionrio de Dados dos Atributos, dos Mtodos e das Mensagens

OBS: Ver ordem de apresentao detalhada da primeira parte do Projeto I nas apostilas

Diagramas do Projeto I
c) DOCUMENTOS PARA A ORIENTAO A AGENTES (INTELIGNCIA ARTIFICIAL) rvore de Deciso

Diagramas do Projeto I
OBSERVAO: Se o projeto a ser desenvolvido envolver - no todo ou em parte - a internet, intranet, extranet, isto , se tiver uma parte em hipermdia, alm da documentao referente metodologia escolhida pelo grupo (objetos, essencial, inteligncia artificial) dever ser apresentada a modelagem OOHDM para documentar a navegao ser necessrio incluir portanto os seguintes diagramas, que devero vir imediatamente aps os diagramas da metodologia escolhida, apenas para a parte referente internet/intranet/extranet: MODELO CONCEITUAL; MODELO DE NAVEGAO; CONTEXTO DE NAVEGAO.

Exigncias para entrega do Projeto I

QUANTO DOCUMENTAO: A documentao de PROJETOS I dever ser entregue em duas vias encadernadas (como brochura); Uma cpia ser devolvida ao grupo, a outra ficar com o (a) orientador(a)
ATENO! No Projeto II as telas devero ser retiradas do Manual do Sistema (que ser na realidade a documentao j entregue no Projeto I, passando a constar do Manual do Usurio)

Exigncias para entrega do Projeto I

QUANTO AO PROTTIPO:

Dever ser elaborado prottipo com as telas contendo TODAS as classes e atributos nos padres definidos segundo a metodologia adotada. As telas sero ainda apresentadas no micro ao Professor no dia marcado para apresentao do projeto I. As mesmas telas devero vir impressas no final do manual (Projeto I).

Exigncias para Apresentao Oral do Projeto I

APRESENTAO EM POWER POINT CONTENDO NO MNIMO: Primeiro slide: Nome do projeto, a autoria e a orientao
acadmica; Segundo slide: Nome da Empresa e a localizao do projeto na organizao; Terceiro slide: Situao Atual e Problemas Encontrados; Quarto slide: Soluo Proposta e Objetivos do Projeto; Quinto slide: Diagrama de Classes, ou Diagrama de Contexto ou rvore de Deciso (dependendo da modelagem utilizada); Sexto slide: Concluso e agradecimentos.

Exigncias para Apresentao Oral do Projeto I

ATENO! Durante a apresentao oral a equipe dever explicar como pensa em fazer a implementao da entrada de dados e das buscas (recuperao da informao) do sistema. Falar sobre as crticas e batimentos de consistncia na entrada e sobre as estratgias de busca e recuperao e relatrios (impressos e em tela) na sada. Isto dever ser planejado durante a elaborao do Projeto I.

Exigncias para Apresentao Oral do Projeto I

Sempre que possvel a busca dever permitir recuperao por parte da palavra ou da frase; por todos os elementos da tabela, caso o usurio no conhea nenhum. Na entrada de dados deve haver quando necessrio, busca em lista de nomes j existentes na tabela; as telas de entrada devero ter botes que indiquem que o usurio pode pesquisar antes de entrar com os dados. Tanto a entrada de dados como a recuperao devero possuir recursos que facilitem o usurio e evitem erros e redundncia.

Onde obter mais informaes

Nas apostilas e exemplos fornecidos em aula (documentos encontrados no servidor do Laboratrio da Universo, na pasta do professor(a) orientador(a)
Em livros, artigos, fontes eletrnicas Junto a Professores, colegas, outras fontes

Disciplina: PROJETOS II
No Projeto II, a documentao do Projeto I um deve ter sido corrigida, conforme avaliao o Professor quando da concluso da disciplina Projeto I e passa a constituir o Manual do Sistema a ser includo como parte da documentao do Projeto II.
Independente da metodologia utilizada o Projeto II deve possuir os documentos especificados a seguir:

Disciplina: PROJETOS II
a) Manual do Sistema com a Documentao de Projeto I (ATENO! Devem ser retiradas as telas que fizeram do documento entregue no Projeto I as telas iro para o manual do usurio). Ficam todos os demais itens j relacionados em Projeto de Sistemas I (que devero ser revistos e corrigidos os eventuais erros/problemas/ falhas); Iinclui as Norma de Qualidade ISO/IEC 9126 completa, com grfico no final de pizza preferencialmente, indicando os valores percentuais obtidos na QUALIDADE. A norma ISO deve vir ao final do PROJETO DO SISTEMA, encadernada junto.

Disciplina: PROJETOS II
b) Manual do Usurio impresso. O manual subdivide-se em duas partes:
1 PROCEDIMENTOS DE INSTALAO DO SISTEMA - como o sistema deve ser operado, passo-a-passo, como instalar, atualizar, atribuir senhas, precaues a serem adotadas, como backup, etc 2 PROCEDIMENTOS DE UTILIZAO E OPERAO DO SISTEMA - guia de referncia ordenado, mostrando ao usurio final as telas, os itens, os botes e o que eles fazem.

Exigncias para Entrega do PROJETO II

Seguem-se algumas recomendaes e observaes importantes para a entrega do Projeto II:

a) O MANUAL DO USURIO contendo os PROCEDIMENTOS DE INSTALAO DO SISTEMA e os PROCEDIMENTOS DE UTILIZAO E OPERAO DO SISTEMA devem vir encadernados juntos, em uma s unidade. Os exemplos devem estar completos, claros, representando situaes reais, para que um leigo possa entendlos (sem xxxx, yyyy etc).

Exigncias para Entrega do PROJETO II

b) J o MANUAL DO SISTEMA (o mesmo entregue em PROJETOS I, s que atualizado e corrigido), deve ser encadernado parte. A data que aparece na documentao do PROJETO I dever ser revista quando do Projeto II (trocar a conta-capa e a folha de rosto).

c) Dever ser inserida aps a folha de rosto, no Manual do Sistema, uma folha com o nome da equipe padro a ser fornecido pelo professor da disciplina. Esta folha dever ser assinada por todos os participantes do grupo.

Exigncias para Entrega do PROJETO II

d) Devero ser entregues 3 cpias dos manuais, sendo 1 em capa dura cor: azul (se no houver, a cor poder ser PRETA) e 2 em capa branca transparente em cima e azul no fundo. Na capa dura colocar o nome da Universidade, o nome do curso, o ttulo do projeto (do sistema) e a data.

e) O sistema dever ser entregue (com 3 cpias) de um Kit de Instalao completo em cd-rom. Contedo do cd: O programa em modo de instalao, os Fontes, os Arquivos (Word) com os Manuais do Sistema e do Usurio, a apresentao em Power Point.

Exigncias para Entrega do PROJETO II

Observao: Como requisito para aprovao, alm do cumprimento das demais exigncias, o Sistema deve poder ser instalado e estar funcionando, com cadastros, relatrios, utilitrios necessrios, acrescido de Help (para o Help utilizar ferramentas como visual help, rob help ou outra.)

ATENO!
A limpeza, aparncia geral e qualidade da impresso (papel, tinta, ilustraes, diagramas, paginao, apresentao visual, limpeza, Portugus correto, etc.) devem ser boas, pois so levadas em considerao na avaliao. Cuidado, portanto, com a concordncia, acentuao, crases, etc. Uma boa reviso ortogrfica e conferncia visual devem ser feitas. Isto significa que a impresso do manual no deve ser deixada para a ltima hora. Uma prova necessria com antecedncia suficiente para as devidas correes.

Exigncias para Entrega do PROJETO II

O Sumrio deve ser gerado AUTOMATICAMENTE no Word, para evitar erros e aumentar a produtividade. Ferramentas de produtividade devem ser usadas para melhorar o desempenho do grupo. A participao equilibrada de TODOS os membros da equipe ser exigida. As notas sero INDIVIDUAIS e o aluno que no comparecer ou no mostrar envolvimento, comprometimento com o trabalho ser avaliado negativamente, independente do resto do grupo. O PROJETO deve ser feito com esmero, pois trata-se do carto de visitas de um profissional.