Cap 07: Especificação de Requisitos (ERS)

🎯 Objetivo do Capítulo

Aprender a estruturar um documento de especificação profissional seguindo padrões internacionais (IEEE), garantindo que todos os endpoints, regras e metadados estejam documentados antes da codificação.

🏢 O Cenário Corporativo (TecProExpress)

Na TecProExpress, um cliente externo contratou a empresa para desenvolver um módulo de Gestão de Frotas. Durante a reunião, o cliente disse: "Ah, e eu quero que o sistema seja integrado com o meu ERP antigo".

"Se você não colocar essa integração no documento de ERS, o desenvolvedor não saberá que precisa criar esse conector, e o cliente poderá cobrar a entrega sem pagar o custo extra da integração. O ERS é a sua proteção jurídica e técnica."

🧠 Estrutura Padrão da ERS

Abaixo, a organização funcional que você encontrará em ferramentas de documentação como o Confluence da sua Squad:

📊 O Papel da Documentação

🔍 Estudo de Caso: Locadora Tech (ERS.01)

Imagine uma plataforma de empréstimos digitais (Streaming). O Arquiteto da TecProExpress mapeou as seguintes entidades:

• 👤 Usuário Titular: Nome, CPF (único), Hash de Senha.
• 👥 Dependentes: Atrelados ao titular via Foreign Key. Recebem Tokens JWT limitados.
• 🎬 Catálogo de Filmes: Endpoint POST /api/movies para persistir metadados e links de Blob Storage.

💡 Checkpoint de Lógica