Documentação a produzir
1. Folha de resumo de progresso
A folha de resumo de progresso, descreve de forma
resumida, numa folha A4, os (re)planeamentos
efectuados (tarefas, prazos, afectação de pessoas
às tarefas) e o estado de execução das tarefas
planeadas.
2. Relatório de avaliação do produto recebido
O relatório de avaliação do
produto recebido deve
focar aspectos como a qualidade dos requisitos ("complitude",
ausência de ambiguidades, relevância prática,
etc.), a qualidade do projecto/"design" (adequação aos
requisitos, etc.) e o estado e qualidade da
implementação (obediência ao "design", manuais,
estruturação do código, erros, etc.).
3. Relatório de planeamento do projecto
O relatório de planeamento do projecto deve
conter uma primeira definição de
tarefas a levar a cabo, datas de início e fim previstos dessas
tarefas, afectação de pessoas e outros recursos
às tarefas (em horas, no caso das pessoas).
4. Relatório intermédio de gestão do
projecto
O relatório intermédio de gestão de projecto,
descreve o estado de execução das tarefas planeadas
(data de início e fim efectivo de uma tarefa, nº de horas
efectivamente despendidas por cada pessoa afecta a uma tarefa) e o
replaneamento da parte final do projecto.
5. Relatório de auditoria
Neste relatório deverão ser abordados os seguintes aspectos: modelo de
desenvolvimento adoptado; métodos de trabalho; normas utilizadas;
comunicação interna; grau de cumprimento de metas; documentação
produzida.
6. Relatório de avaliação do produto encomendado
Este relatório contém uma avaliação do grau de
conformidade do produto recebido em relação às especificações,
eventualmente referindo discrepâncias e pode conter, ou não, a aceitação
provisória do produto recebido.
7. Relatório final de gestão do projecto
O relatório final de gestão de projecto,
descreve os seguintes aspectos: tarefas executadas (datas de
início e fim efectivo, nº de horas efectivamente despendidas
por cada pessoa afecta a uma tarefa), desvios em relação
ao planeado, auto-avaliação do funcionamento do grupo
(o que correu bem, o que correu menos bem,…) incluindo
sugestões de alteração de funcionamento no grupo,
caso um projecto idêntico fosse retomado.
8. Documentação do projecto
Durante o desenrolar de cada projecto devem ser
produzidos os seguintes documentos:
- 8.1. Relatório de especificação
- deve ser fundamentado numa avaliação prévia
das deficiências e limitações (em termos de
funcionalidade, fiabilidade e eficiência) da versão de
partida;
- da responsabilidade, principalmente, do analista e do arquitecto do software;
- refere-se tanto aos requisitos como ao projecto ("design") de alto
nível do sistema de software a desenvolver
- a especificação de requisitos funcionais deve ser baseada em diagramas de
diagramas de casos de uso (com actores, casos de uso, ...),
possivelmente complementados por diagramas de sequenciação (para
descrição mais formal de cada caso de uso) e diagramas de classes (para
descrição mais formal de conceitos do domínio de aplicação); a
especificação de requisitos não funcionais inclui recursos, restrições
tecnológicas, etc
- a especificação de projecto de alto nível deve focar osseguintes
aspectos: a Arquitectura Lógica do Sistema (através de Diagramas de
Pacotes ("Packages")), o Modelo de Objectos (Diagramas de Classes), o Modelo
Dinâmico (Diagramas de Interacção, Diagramas de Estados e Diagramas de
Actividades), a Arquitectura Física do Sistema (Diagramas de
Componentes e Diagramas de Distribuição ("Deployment"))
- 8.2. Manual de desenvolvimento
- da responsabilidade, principalmente, do arquitecto do software e
do programador;
- contém o projecto detalhado, contendo refinamentos do projecto de
alto nível, mapeamentos para linguagens usadas na implementação (SQL,
Java, etc.)
- contém documentação sobre a implementação, contendo
referência e justificação das
opções de implementação, tecnologias usadas (linguagens e
ferramentas, etc), ao estado do produto desenvolvido, nomeadamente o
grau de conformidade com as especificações, e informação útil ao teste,
integração e manutenção do produto desenvolvido
- 8.3. Manual de utilização
- da responsabilidade, principalmente, do programador e da pessoa
encarregue do controlo de qualidade;
- Referência ao Guia de Utilização e às páginas HTML disponíveis na
Web (ou aos ficheiros .hlp)
- 8.4. Agendas/actas das reuniões efectuadas pelos elementos
do grupo
- da responsabilidade, principalmente, do secretário do
projecto.
9. Exemplo de documentos
[Página da disciplina]
[J. Lopes Home page]
João Correia Lopes
(jlopes AT fe.up.pt).
Last modified: Mon Dec 06 08:30:30 1999