ELABORAÇÃO E ARMAZENAMENTO DE
DOCUMENTAÇÃO DE SISTEMAS INFORMATIZADOS
Elisabeth Hoffmann
Roteiro
• Empresa
• Motivação da Pesquisa
• Objetivo
• Metodologia de Desenvolvimento
• Hipóteses
• Conclusão
CELEPAR - Companhia de Informática do Paraná
• Empresa pública que atua no planejamento e
desenvolvimento de soluções de tecnologia da
informação para órgãos públicos do Estado do Paraná.
Motivação para a pesquisa
• Atuação Profissional na Área de Documentação de
Sistemas da CELEPAR.
• Trabalho Importante
A documentação de um sistema visa oferecer aos seus
usuários, sejam eles desenvolvedores, do ambiente de
produção ou cliente, informações precisas e confiáveis
que forneçam suporte no momento de manutenção e na
entrega do produto, com a certeza de sua qualidade.
• Resistência
Objetivo
• Analisar se o processo de documentação atualmente
utilizado pela CELEPAR é similar ao processo utilizado
por outras empresas que desenvolvem sistemas na
região de Curitiba.
• Analisar a opinião dos técnicos que trabalham na
CELEPAR em relação ao processo de documentação
atualmente utilizado.
Metodologia de Desenvolvimento
• Pesquisas Teóricas
• Pesquisas de campo
Pesquisas Teóricas
• Conceito
A documentação nos conta toda a história de um
sistema, desde sua concepção, passando pelo seu
desenvolvimento e acompanhando sua manutenção,
mostrando-nos o que fazem, como fazem e para quem
fazem.
• Dos roteiros/projeto aos manuais
• Importância
• Empresa independente.
• Manutenção (ex. Bug do ano 2000).
• Profissionais atrelados a determinado projeto.
• Na ausência do analista responsável.
• Na passagem do sistema de um analista para outro.
• Usuários - Produto de Qualidade.
• Execução de sistemas na Produção.
• Reuso.
• Direito Autoral - Registro no INPI.
• Certificação de Qualidade - Exigência ISO 9000.
...Importância
“Muitos projetos não nos legaram sua documentação nem qualquer de
seus registros. De alguns, não se conhece nem mesmo seu objetivo,
como os megálitos de Stonehenge, por exemplo. De outros, não se
sabe como foram executados: as pirâmides egípcias, as das
civilizações pré- colombianas e os monumentos da Ilha de Páscoa,
apesar de serem muito admirados.
Entretanto, da Arca de Noé, quer tenha sido real ou não, conhecem-se
suas “especificações” bíblicas, o que permitiria construir uma
“réplica”, com razoável segurança.”
[VALERIANO,1998]
A
Pesquisas de Campo
• Visita a três empresas
Omitidos os nomes - denominadas - A, B e C
Critério - Metodologia e documentação
Objetivo - Elaboração e Armazenamento
Análise - Relatórios e Tabelas
Comparação - Relatório sobre Processo CELEPAR
...Pesquisas de Campo
• Questionário
Base de Dados (Software - Lotus Notes)
Enviado aos analistas da CELEPAR - Correio
Eletrônico
Índice de Retorno - 43%
Objetivo - Grau de satisfação e sugestões
Respostas depositadas na base - mantidas na íntegra
visando análise fiel
Análise - Gráficos e Tabelas
Verificação das Hipóteses
 Não existe preocupação por parte das empresas com uma
estrutura de armazenamento única da documentação para
permitir acesso de todos os usuários que dela necessitam.
 Falsa
 O foco dos desenvolvedores de sistemas não é a
documentação, mas sim o resultado dos seus projetos.
 Verdadeira
40% - cliente não utiliza a documentação
29% - falta tempo e disciplina - documentar
39% - falta tempo e disciplina - atualizar
... Verificação das Hipóteses
 Os técnicos da CELEPAR estão descontentes com o
processo de documentação atualmente utilizado pela
empresa.
Falsa
Conhecem o processo
Dificuldades apontadas (não relacionadas com o processo)
Trabalho do grupo de documentadores (bom)
Baixo índice de sugestões de melhoria
... Verificação das Hipóteses
• Os técnicos da CELEPAR têm sugestões que podem
contribuir para a melhoria do processo de
documentação atualmente utilizado.
Verdadeira
... Verificação das Hipóteses
 Desconhecimento, por parte dos desenvolvedores, do
processo de documentação utilizado pela CELEPAR.
Falsa
87% utilizam a metodologia
88% conhecem o meio de armazenamento
69% conhecem os produtos elaborados pelo grupo
73% já solicitaram serviços ao grupo
... Verificação das Hipóteses
 Baixa rotatividade do pessoal de desenvolvimento,
fazendo com que o conhecimento da organização
fique atrelado ao conhecimento e a experiência de
pessoas.
61,5% mais de 10 anos
CONCLUSÃO
Avaliação - CELEPAR x Empresas Visitadas
• Processo semelhante
 uso de metodologia
 Padrões pré-elaborados
 Editor de textos (MS WORD)
 Armazenamento através de base de dados
• Destaque - CELEPAR - Grupo de técnicos
... Conclusão
Avaliação - Questionário
• Processo é conhecido
• Existe consciência da importância do trabalho
• Atendimento - Grupo de Documentadores:
Bom
Restrições quanto ao tempo para entrega dos trabalhos
 Sugestões
... conclusão
Contribuições do trabalho
• Visitas - enriqueceram o conhecimento
• Questionários - Contribuição e colaboração dos técnicos
• Existem sugestões que poderão ser aplicadas a curto prazo
• Ambiente mutável torna necessária uma constante
reavaliação do processo.