Prólogo: A Missão é Aceita

No capítulo anterior, você testemunhou o caos iminente na Taberna do Pônei Saltitante. Seu gerente, Cevado Carrapicho, fez um chamado por um herói — um mestre da organização capaz de trazer ordem ao seu negócio em expansão.

Você aceitou o chamado.

Agora, a verdadeira jornada começa. Você cruza o primeiro limiar, deixando o “mundo comum” para trás. Sua primeira tarefa é sentar-se com o estalajadeiro, pena e pergaminho em mãos, e entender a fundo as leis que regem seu pequeno reino. Esta é a fase de levantamento de requisitos.

Capítulo 1: O Pergaminho de Regras

scroll-unfurled Cevado, aliviado com sua presença, começa a desabafar e a listar tudo o que ele precisa registrar em seu novo “sistema de organização”. Ele desenrola um longo pergaminho com as regras da taverna:

Sobre Clientes e Funcionários

  • Clientes (Clientes): Precisamos registrar os clientes, seus e-mails, endereços e a qual raça pertencem (para personalizar o atendimento). Além disso, eles são classificados por tipos: Padrão, Especial e Classe A.
  • Funcionários (Funcionarios): Cada funcionário tem um número de matrícula, um salário base e um cargo.
  • Cargos (Cargos): Os cargos possuem uma estrutura hierárquica (um gerente supervisiona um barman, por exemplo). Cada cargo também define um valor a ser acrescido no salário do funcionário.

Sobre Produtos e Pedidos

  • Pedidos (Pedidos): Os pedidos dos clientes são hoje feitos em um caderno e, atenção, nem sempre resultam em uma venda! (Isso sugere um status no pedido: em andamento, finalizado, cancelado).
  • Produtos (Produtos): Temos uma tabela de preços para nossos produtos.
  • Produtos Compostos: Alguns produtos, como uma “Espada Élfica com Gemas”, são compostos por outros itens (a espada e as gemas). É importante saber que vendemos tanto o produto final quanto os componentes em separado.

Capítulo 2: As Perguntas do Estalajadeiro

magnifying-glass Depois de listar as regras, Cevado olha para você com esperança e diz: “Com este novo sistema, eu finalmente poderei ter respostas para minhas perguntas mais urgentes!”:

  • Quantos clientes de cada raça eu tenho?
  • Quantos clientes de cada classe (Padrão, Especial, Classe A) estão registrados?
  • Qual o valor total das vendas para os clientes da classe Padrão?
  • Qual o meu volume de vendas por semana, mês e ano?
  • Quem vendeu mais? Quero saber o desempenho de cada funcionário em um determinado período.
  • Qual é a bebida (ou espada) mais popular da taverna?

Essas perguntas são o seu objetivo. O banco de dados que você construir deverá ser capaz de respondê-las.

Sua Missão: Decifrar o Enigma

Com as regras e perguntas em mãos, sua missão agora é traduzir essa narrativa em uma estrutura de dados lógica. Você irá atualizar o mapa que começou a desenhar na etapa anterior.

Edite seu arquivo README.md no GitHub com as seguintes análises:

  1. drakkar Identifique as Entidades: Liste as principais “coisas” ou “substantivos” da história. (Ex: Clientes, Funcionarios, Pedidos, Produtos, Cargos…).

  2. checklist Liste os Atributos: Para cada entidade, liste suas propriedades ou características. (Ex: Para Clientes, temos nome, email, raca, classe…).

  3. relationship-bounds Defina os Relacionamentos: Descreva como as entidades se conectam, usando “verbos”. (Ex: Um Cliente faz um Pedido. Um Pedido contém vários Produtos. Um Funcionario tem um Cargo).

  4. treasure-map Atualize o Mapa (Diagrama MERMAID): Com base na sua nova análise, melhore a primeira versão do seu diagrama de Entidade e Relacionamento no README.md. Adicione as novas entidades, atributos e os relacionamentos que você descobriu.

Ferramentas do Aventureiro

Recursos essenciais para completar sua missão: