Agência Nacional
de Vigilância Sanitária
Padronização de Documentação de Sistemas
Projeto a ser desenvolvido no âmbito da
Gerência de Sistemas/GGTIN e ANVISA
Brasília, junho de 2006.
1. IDENTIFICAÇÃO DO PROJETO
1.1. Título do Projeto
Padronização de Documentação de Sistemas
1.2. Duração
y Elaboração do projeto básico: Junho a Julho de 2006.
y Elaboração dos Modelos de Documentos: Agosto a Setembro de 2007
1.3. Custo Estimado
y Elaboração do projeto básico: R$ 0,00
y Elaboração dos Modelos de Documentos: R$ 72.800,00 (Valor aproximado)
1.4. Área(s) Responsável(is) e participantes
1. Diretoria Maria Cecília Martins Brito - DMCMB
Titular: Maria Cecília Martins Brito
Cargo: Diretora
2. Gerência-Geral de Gestão do Conhecimento e Documentação - GGTIN
Titular: Dulcelina Mara Said Pereira
Cargo: Gerente–Geral
3. Gerência de Sistemas - GESIS
Titular: Nelci dos Santos
Cargo: Gerente
Endereço: SEPN 515, Bloco B, Edifício Ômega - Unidade 1
Brasília (DF) - 70.770-502
e-mail:
Tel.: +55 (61)
Fax: +55 (61)
2
2. INTRODUÇÃO
2.1. Antecedentes
Os diversos sistemas de informação, existentes no âmbito da Anvisa, em sua
grande maioria mão possuem uma documentação formal, o que dificulta as atividades de
manutenção e correção destes sistemas. Os sistemas novos que estão em
desenvolvimento, quer seja pelo prestador de serviço (Politec) ou através de convênios
(Bireme e Instituto Stela) não seguem uma padronização de documentação única, ou
seja, cada desenvolver utiliza a seu próprio padrão de documentação, criando uma
diversidade de documentações despadronizadas de difícil manutenção e entendimento.
2.2. Justificativa
Para prover uma forma mais adequada de se trabalhar as atividades de
manutenção e correção dos sistemas de informação, necessita-se de uma documentação
padronizada e de fácil entendimento.
A definição de um conjunto de modelos de documentação de sistemas de
informação possibilita que novos sistemas a serem desenvolvidos tenham sua
documentação padronizada. Estes modelos podem ser seguidos pelos diversos
prestadores de serviço de desenvolvimento de sistemas. Através desta padronização da
documentação existe também a possibilidade de documentação dos sistemas já
existentes no âmbito da Anvisa.
2.3. Descrição do projeto
Este projeto tem como objetivo principal, a elaboração de um conjunto de modelos
de documentação de sistemas de informação para a Anvisa. Primeiramente serão
definidos os modelos de documentação, observando a Metodologia de Desenvolvimento
de Sistemas – MDS da Anvisa. Após a elaboração dos modelos, os mesmos serão
testados, sendo utilizados em um projeto piloto de sistema de informação, visando realizar
os ajustes necessários aos modelos de documentação.
3
3. OBJETIVOS, RESULTADOS E ATIVIDADES
3.1. Objetivo Geral
y Padronizar a documentação dos Sistemas de Informação da Anvisa,
através da definição de modelos de documentos, em conformidade
com a Metodologia de Desenvolvimento de Sistemas da Anvisa.
3.2. Objetivo(s) Específico(s)
y Elaborar os modelos de documentos a serem observados para o desenvolvimento
de sistemas de informação para a Anvisa;
y Validar os modelos de documentação de sistemas, através de sua utilização no
desenvolvimento de um sistema piloto.
3.3. Resultados
y Modelos de documentação de sistemas de informação desenvolvidos;
y Sistema documentado conforme os modelos de documentação de sistemas
definido;
3.4. Atividades do Projeto
y Definir os documentos a serem utilizados, observando a MDS da Anvisa;
y Elaborar os modelos da documentação de sistemas;
y Ajustar os modelos ao padrão de documentos da Anvisa (Layout)
y Documentar um projeto de sistema de informação usando os modelos de
documentação de sistemas da Anvisa;
y Ajustar os modelos de documentação de sistema da Anvisa, se necessário.
4
4. MATRIZ LÓGICA
Objetivo geral: Padronizar a documentação dos Sistemas de Informação da Anvisa,
através da definição de modelos de documentos, em conformidade com a
Metodologia de Desenvolvimento de Sistemas da Anvisa.
Objetivo específico (1): Elaborar os modelos de documentos a serem observados para o
desenvolvimento de sistemas de informação para a Anvisa;
INDICADORES
Resultado
1.1:
Modelos
documentação
de
sistemas
informação desenvolvidos.
de
de
Atividades:
Atividade 1.1.1 – Definir os documentos a
serem utilizados, observando a MDS da
Anvisa;
Atividade 1.1.2 – Elaborar os modelos da
documentação de sistemas;
Atividade 1.1.3 – Ajustar os modelos ao
padrão visual de documentos da Anvisa
(Layout)
MEIOS DE
VERIFICAÇÃO
PRESSUPOSTOS
y Modelos de
documentação
elaborados.
y Modelos de
documentação
impressa ou em
meio magnético.
y Elaboração dos
modelos de
documentação.
y Modelos de
documentação
de sistemas
definidos.
y Modelos de
documentação
impressa ou em
meio magnético.
y Modelos
ajustados ao
padrão visual
da Anvisa.
y Modelos de
documentação
ajustada ao
padrão visual da
Anvisa, impressa
ou em meio
magnético.
y Observar as
definições da
MDS na
elaboração dos
modelos de
documentação.
Objetivo específico (2): Validar os modelos de documentação de sistemas, através de sua
utilização no desenvolvimento de um sistema piloto.
INDICADORES
Resultado 2.1: Sistema documentado
conforme os modelos de documentação
de sistemas definido.
Atividades:
Atividade 2.1.1 – Documentar um projeto
de sistema de informação usando os
modelos de documentação de sistemas da
Anvisa;
Atividade 2.1.2 – Ajustar os modelos de
documentação de sistema da Anvisa, se
necessário.
MEIOS DE
VERIFICAÇÃO
PRESSUPOSTOS
y Documentação
de sistema
piloto
elaborada.
y Documentação
de sistema piloto
elaborada e
impressa.
y Utilizar os
y Sistema piloto
Documentado.
y Documentação
de sistema piloto
elaborada e
impressa.
y Modelos de
documentação
ajustados,
impressos ou em
meio magnético.
y Utilizar os
modelos de
documentação
de sistemas na
especificação
do sistema
piloto. Realizar
ajustes se
necessário.
y Modelos de
documentação
de sistemas
ajustados.
modelos de
documentação
de sistemas na
especificação
do sistema
piloto.
5
4.1. Indicadores
y Modelos de documentação de sistemas elaborados.
y Modelos de documentação de sistemas definidos.
y Modelos ajustados ao padrão visual de documentação da Anvisa.
y Documentação de sistema piloto elaborada.
y Sistema Piloto Documentado.
y Modelos de documentação de sistemas ajustados.
4.2. Meios de Verificação
y Modelos de documentação impressa ou em meio magnético.
y Modelos de documentação ajustada ao padrão visual da Anvisa, impressa ou em
meio magnético.
y Documentação de sistema piloto elaborada e impressa.
y Modelos de documentação ajustados, impressos ou em meio magnético.
4.3. Pressupostos
y Elaboração dos modelos de documentação por analistas de sistemas;
y Observar as definições da MDS na elaboração dos modelos de documentação:
y Utilizar os modelos de documentação de sistemas na especificação do sistema
piloto.
6
5. Cronograma de execução
Ano/Trimestre
Junho
Julho
Agosto
Setembro
1 2 3 4 1 2 3 4 1 2 3 4 1 2 3 4
Resultado 1.1: Modelos de documentação de sistemas de informação desenvolvidos.
Atividade 1.1.1 – Definir os
documentos a serem utilizados,
observando a MDS da Anvisa.
Atividade 1.1.2 – Elaborar os
modelos
da
documentação
de
sistemas.
Atividade 1.1.3 – Ajustar os modelos
ao padrão de documentos da Anvisa
(Layout)
RESULTADOS E ATIVIDADES
Ano/Trimestre
Junho
Julho
Agosto
Setembro
1 2 3 4 1 2 3 4 1 2 3 4 1 2 3 4
Resultado 2.1: Sistema documentado conforme os modelos de documentação de sistemas definido.
Atividade 2.1.1 – Documentar um
projeto de sistema de informação
usando os modelos de documentação
de sistemas da Anvisa;
Atividade 2.1.2 – Ajustar os modelos
de documentação de sistema da
Anvisa, se necessário.
RESULTADOS E ATIVIDADES
7
6. ORÇAMENTO
INSUMOS
QUANTIDADE
VALORES
FONTE
Resultado 1.1: Modelos de documentação de sistemas de informação desenvolvidos.
Atividade 1.1.1 – Definir os
documentos a serem
utilizados, observando a MDS
da Anvisa.
Atividade 1.1.2 – Elaborar os
modelos da documentação de
sistemas.
Atividade 1.1.3 – Ajustar os
modelos ao padrão de
documentos da Anvisa
(Layout)
Total Resultado 1.1
Analista de
Sistemas
Dois por 20 horas
cada
R$ 65,00 por
hora.
R$ 2.600,00
GESIS/Politec
Analista de
Sistemas
Dois por 20 horas
cada
GESIS/Politec
Analista de
Sistema
Um por 40 horas
cada
R$ 65,00 por
hora.
R$ 2.600,00
R$ 65,00 por
hora.
R$ 2.600,00
120 horas
GESIS/Politec
R$ 7.800,00
Resultado 2.1: Sistema documentado conforme os modelos de documentação de
sistemas definido.
Atividade 2.1.1 – Documentar
Analista de
Três por 320
R$ 65,00 por
um projeto de sistema de
Sistemas
horas cada
hora.
informação usando os
R$ 62.400,00*
modelos de documentação de
sistemas da Anvisa;
Atividade 2.1.2 – Ajustar os
Analista de
Um por 40 horas
R$ 65,00 por
modelos de documentação de
Sistemas
hora.
sistema da Anvisa, se
R$ 2.600,00
necessário.
Total Resultado 2.1
1.000 horas
R$ 65.000,00
Total Geral
1.120 horas
R$ 72.800,00
* Parte de analise do sistema de informação para registro de demandas.
GESIS/Politec
GESIS/Politec
8
7.
AVALIAÇÃO E ACOMPANHAMENTO
y Atas de reunião dos analistas responsáveis pela definição dos modelos de
documentação dos sistemas de informação da Anvisa;
y Avaliação dos modelos propostos para a documentação dos sistemas de
informação da Anvisa;
y Acompanhamento da utilização dos modelos de documentação de sistemas de
informação em um projeto piloto de sistema de informação;
y Verificar os ajustes realizado na documentação de sistemas de informação, após
sua utilização no projeto piloto, caso sejam necessários.
9
8.
Anexo
y Documentação a ser desenvolvida e padronizada, segundo a Metodologia de
Desenvolvimento de Software da Anvisa.
Solicitação de Atendimento
Artefato de Registro da demanda de Sistemas para ser encaminhado,
pelas Áreas Usuárias para a GGCON/GESIS.
Projeto Básico
Artefato de detalhamento das Solicitações de Atendimento.
Plano do Projeto
Este artefato define uma visão de todo o processo de atividades de
desenvolvimento e infra-estrutura no que diz respeito às Fases e iterações
necessárias para a implementação e implantação do Software.
Visão do Projeto (Artefato
de Visão)
Este artefato define as necessidades do Projeto, bem como os envolvidos
no mesmo.
Lista de Riscos
Este artefato descreve os riscos técnicos e negociais conhecidos do
projeto.
Cronograma do Projeto
(WBS)
Este artefato apresenta o cronograma do Projeto, bem como as
funcionalidades que deverão ser consideradas no mesmo. (WBS – Vide
Glossário).
Modelo de Caso de Negócio Identifica todos dos casos de uso de negócio que fazem parte do escopo
do projeto.
Modelo de Domínio
Este artefato engloba os Diagramas de Objetos e de Classe (Nível
Conceitual).
Plano da Fase
Este artefato descreve os processos detalhados para a Fase.
Avaliação da Fase
Este artefato apresenta uma avaliação da Fase, desde o tempo estimado x
realizado, curso do projeto e problemas surgidos no decorrer de sua
execução.
Estimativa APF
Apresenta a planilha contendo o resultado da Estimativa da Análise de
Ponto de Função.
Termo de Aceite de
Elaboração de Projeto
Este artefato define o termo de aceite inicial para a construção do projeto.
Guia de Produtividade
Artefato que indica a produtividade em relação a um determinado ponto de
função, por cada perfil profissional.
Glossário
Identifica o Glossário do Projeto.
Modelo de Caso de Uso
Este artefato faz uma descrição abrangente das funções do projeto,
demonstrando a estrutura do modelo em pacotes, casos de uso e atores. O
artefato demonstra a estrutura de pacotes de forma hierárquica.
Especificação de Caso de
Uso
Este artefato descreve os objetivos e as atividades que serão
desenvolvidas no caso de uso.
Especificação das Regras
de Negócio
Este artefato descreve as regras de negócios dos casos de uso.
Modelo de Análise e Projeto Este artefato descreve os procedimentos e os resultados da subfase de
Análise e Projeto.
Modelo de Interface
(Protótipo)
Este artefato descreve o protótipo do Software.
10
Diagramas UML
Diagramas referentes à UML; Atividades, Seqüência, Estados,
Colaboração, Componentes, Integração, Casos de Uso.
Projeto de Banco de Dados
Este artefato representa todos os quesitos relativos ao Banco de Dados
Plano de Teste
Este artefato identifica as informações de projeto existentes e os
componentes de software que devem ser testados; bem como os requisitos
e estratégia de teste.
Planilha de Teste
Apresenta a planilha contendo os cenários de teste do Sistema.
Resultado APF
Apresenta a planilha contendo o resultado da Análise de Ponto de Função.
Termo de Aceite Técnico
Este artefato apresenta o Termo de Aceite que o usuário deverá preencher.
Lista de Riscos
Este artefato descreve os riscos técnicos e negociais conhecidos do
projeto.
Componentes/ Programas
Fontes
Descreve os componentes e programas do Software.
Resultado dos Testes
Apresenta os resultados dos testes do Software.
Termo de Aceite Definitivo
do Produto
Este artefato apresenta o Termo de Aceite Definitivo do Produto.
Plano de Homologação
Este artefato descreve o Plano de Homologação do Sistema.
Manual de Treinamento
Este artefato descreve o manual de treinamento para o usuário.
Plano de Implantação
Este artefato descreve o plano de implantação do Sistema na produção.
Manual do Usuário
Este artefato descreve usualmente todo o processo de execução do
Sistema.
Guia de Produtividade
Artefato que indica a produtividade em relação a um determinado ponto de
função, por cada perfil profissional.
11