A PROGRAMAÇÃO NA INFORMÁTICA

Modelo para Documento de

[pic 1][pic 2]

(Baseado na norma IEEE Std 830-1993 - Recommended Practice for Software Requirements Specifications)

boa orgaiiizaçào lógica do documento e a sua redação correta são condições essenciais para que ele se torne iitil nB §f2tic a. Clínicas recoiiieiidações neste sentido. aiiies õe exaiiiiilaflTlOS O C Ollteíido propriamente dito:

• Utilizar índice. lista de tabelas e lista de figuras para facilitar a vida õo leitor.

• Referências cnizadas entre secões sao absolutamente essenciais para evitar

redundância. iiielliorar a legibilidade do documento e facilitar sua modificação.

• Os pontos ba sicos que de eiT1 S0f d0tllliõOS HO dOCUliieiiio são: fíincioiialidade,

interfaces exiefnas, restrições, critérios õe qualidade e de desempenho.

• É pfeciso garantir que o documento detine estes pontos de inaiieifa Corfeta, nào ainbigiia, completa e consistente com docuiiientos "maiores" (leis. por exemplo).

• Graticos e õiagraiiias podem ajudar bastante na especificação. Porém, irão se trata de mii documento de projeto: nào se faz particioiiamento de iiióõiilos internos, escolha de esiniiiiras õe dados, e outras atividades de projeto. Taiiipoiico se faz atividades de planejamento de sofnvare, tais corno calculo de CH StOS, CfOllograma de entrega, critério s de alidaçao, etc.

• Utilizar urna notação e uma linguagem consistente ao loiigo de todo o docuiiieiiio.

• O documento deve especifiCaf tOdas as necessidades que poderiam ser atendidas pelo soft ’are. classiticando-as eiii: Essenciais (atendimento obrigatófio), Desejáveis (atendimento foft0ltente fecoiiieiidado). e Opcionais (seria bom atender J.

• Um requisito deV0 Sef veriticà 8l. ou seja, deve haver uma maneira d8 @Bf9l1tif que o requisito ê atendido pelo sofia are (exemplo: a func ao deve llsãf HO maxiiiio 2.Mbytes de memória: contra-exemplo: a interface deve ser nmigái’el ).

• C’ada requisito especificado de e ser iinivocaineiiie identificado. de forma que docuiiieiiios posteriores possait refereiiciá-lo.

C’onteùdo Flo Documento

1. Iuti’oiluç ño

1. PfO osito (do Documento

Esiabelecer o objetivo No documento e o publico alvo.

1. Escopo (do sofnvare)

Definir o(s) produto(s) especiticado(s) rio docuiiieiiio: noite, objetivos. limites de atuaç ào. beneficios esperados,

JTisao Geral (No Documento)

Descre er ä OfgallÎzacao e o conteuüo de cada seç ào do docuinento

1. Iufoi’inaçöes de Siipoi te

°.1. Defiiiicöes

Descrever todas as siglas e abre iaç ões usadas no documento. bem conto os iefinos necess9fios ao seu enteiidiitento.

°.2. Refefências

Listar todos os üociiitentos ciiados no docuineiiio (nonnas. livros. mourrais de

oUtfOS pfodutos, ...).

1. Desc i’içao Ge i’al do Softwai e

Lembre-se que todos os iteiis desta seçào serao detalhados na próxima seçào (a idéia aqui é apresentar urna visào geral, sem detalhes).

1. Perspectiva de Produto

Descrever o contexto em que o software deverá ser executado: interconexões, interfaces externas, operações, sistemas de comunicação, restrições de memória (primária e secundária) e requisitos da plataforma. Um diagrama de arquitemra de sofnvare pode ajudar esta definição.

1. Funções do Produto

Especificar as principais funções do sofuvare, dando uma idéia de como elas cooperam para realizar os objetivos do sistema.

1. Características de Usuários

Descrever o perfil de usuário esperado, e as razões para eventuais requisitos de formação educacional, conhecimento técnico ou experiência.

1. Restrições

Definir obrigações ou limitações às opções de desenvolvimento, justificando-as (preferencialmente com o apoio de documentos).

1. Suposições e Dependências

Definir as hipóteses que são consideradas e que têm influência sobre os requisitos do soAvare. Ex: supõe-se que o SGBD Oracle estará disponível: caso contrário os requisitos de potabilidade de bases de dados deverão ser revistos.

1. Requisitos Fumros

Citar os requisitos identificados mas que não serão contemplados nesta versào do soAvare.

1. Requisitos Específicos

1. Interfaces Externas

Definir detalhes de intercâmbio de dados com entidades externas:

• UsiláfiO: tOdos os aspectos õe IHC:
• HafÔ\vare: descrevef o felacionainento õo software com a platafoflTlú   ãlvo

(dispositi os suportados, familia de pfocessador, [pic 3]

• Sofiwafe: ligacões com sistemas (SO. SGBD. oiitfOS SiSteLRaS aplicativos. [pic 4]
• Sisteiiias de C’oiiiunicaç ào: APIs, pfotocolos de fede. sofiwafe de suporte a distribuição (ex: C’ORBA J, Coiisidefaç oes sobre inter. intranet....

[pic 5]

Para cada fíinç ào descrever: