Lab 01 — Engenharia de Requisitos: PRD e SDD

Microservice and Web Engineering & IT Services Prof. José Romualdo da Costa Filho | FIAP Sistemas de Informação | 1º semestre de 2026-2

Aula 01 — SDLC, Git, Requisitos (PRD/SDD), DDD e Modelo OSI · 04/08/2026 60 minutos, em dupla

---

O Mini Mundo

A LogiTech Enterprise é uma transportadora com 400 caminhões operando no Sudeste. Hoje, entre a coleta e a entrega, ninguém sabe onde a carga está: o cliente liga perguntando, o atendente liga para o motorista, o motorista atende quando pode.

A diretoria aprovou a construção de um serviço de telemetria de frota. Você foi chamado para especificá-lo.

Hoje ninguém escreve código. Equipes que usam técnicas de desenvolvimento modernas não escrevem mais código à mão: escrevem a especificação, e o código é derivado dela. A parte que continua sendo humana é especificar bem e revisar criticamente — é isso que vocês vão exercitar.

Na Aula 02 vocês implementam exatamente o que especificaram hoje.

---

Passo 1 — Fork deste repositório (5 min)

1. Clique em Fork, no canto superior direito desta página.
2. Renomeie o fork para mwe-2026-2-lab01-duplaXX — XX é o número da dupla com dois dígitos (dupla07, não dupla7).
3. Em Settings → Collaborators, adicione o colega de dupla e o professor.

Por que fork e não repositório novo? O fork mantém o vínculo com o original. Se algo for corrigido no Lab Kit durante a aula, vocês trazem a correção com git pull upstream main.

---

Passo 2 — Abrir o ambiente (5 min)

Este repositório tem um Dev Container que já vem com Python, GitHub CLI, o cliente de IA e o Ollama com o modelo qwen2.5:1.5b baixado. Nada para instalar.

Opção A — GitHub Codespaces (recomendado)

No seu fork: Code → Codespaces → Create codespace on main.

A primeira criação leva alguns minutos porque baixa o modelo (~1 GB). Depois disso, abre em segundos.

Opção B — Local, com Docker

git clone https://github.com/SEU-USUARIO/mwe-2026-2-lab01-duplaXX.git
cd mwe-2026-2-lab01-duplaXX
code .                              # aceite "Reopen in Container"

Verifique antes de seguir

python ai/ask.py "diga apenas: ambiente ok"
ollama list                          # qwen2.5:1.5b deve aparecer

O ask.py fala com o Ollama local que já vem instalado no devcontainer, com o modelo qwen2.5:1.5b baixado na criação do ambiente. Para escolher outro modelo local:

OLLAMA_MODEL=qwen2.5:1.5b python ai/ask.py "..."

---

Passo 3 — Instalar a skill de PRD (5 min)