O que é a Documentação de Requisitos?
É o processo de registrar formalmente os requisitos levantados junto aos stakeholders. Serve como guia para o desenvolvimento, testes e validação do sistema.
Principais Seções da Documentação
- Introdução: Objetivo do sistema, definições
- Escopo: O que o sistema fará (e não fará)
- Stakeholders: Quem são os envolvidos
- Requisitos Funcionais e Não Funcionais
- Regras de Negócio: Restrições da organização
- Critérios de Aceitação e User Stories
- Protótipos e Diagramas (opcional)
Exemplo Prático – Sistema de Escola de Idiomas
1. Introdução
Objetivo: Desenvolver um sistema para gerenciar matrículas e agendamento de aulas na escola XYZ.
2. Stakeholders
Nome | Papel | Interesse |
---|---|---|
Ana Oliveira | Coordenadora | Gerenciar cursos e professores |
João Silva | Professor | Organizar turmas e horários |
Maria Santos | Secretária | Relatórios e matrículas |
Carlos Mendes | Aluno | Matricular-se e agendar aulas |
3. Requisitos Funcionais
- RF01 – Cadastro de alunos
- RF02 – Matrícula em cursos
- RF03 – Escolha de modalidade
- RF04 – Exibição de horários disponíveis
- RF05 – Reagendamento de aulas
- RF06 – Lançamento de presença
- RF07 – Emissão de relatórios
- RF08 – Upload de comprovantes
4. Requisitos Não Funcionais
- RNF01 – Disponibilidade 24/7
- RNF02 – Interface responsiva
- RNF03 – Dados criptografados
- RNF04 – Tempo de resposta < 2s
5. Regras de Negócio
- RB01 – Sem sobreposição de horários
- RB02 – Apenas alunos ativos agendam aulas
- RB03 – Cancelamentos em menos de 24h não geram reembolso
- RB04 – Máximo de 10 alunos por turma
6. User Stories
- US01: Como aluno, quero agendar aulas online, para estudar no melhor horário.
- US02: Como professor, quero ver minha agenda, para planejar melhor minhas aulas.
- US03: Como secretária, quero emitir relatórios, para acompanhar o desempenho das turmas.