🧰 CAPÍTULO 00: KIT DE SOBREVIVÊNCIA — FUNDAMENTOS COMUNS

🎯 Objetivos de Aprendizagem

Estimativa de dedicação: 3 horas de estudo autoguiado. Ao final deste capítulo, você será capaz de:

• 🔹 Navegar pastas e executar scripts pelo terminal do VS Code.
• 🔹 Versionar um projeto com Git e enviá-lo para o GitHub (clone, add, commit, push).
• 🔹 Ler e escrever classes Python com @dataclass, @property e validação de dados.
• 🔹 Interpretar um payload JSON e montar/entender um comando curl contra uma API REST.

🏢 Por que isso importa (Cenário TecProExpress)

Todas as atividades práticas do curso — Engenharia de Software e Banco de Dados — giram em torno da TecProExpress, uma empresa fictícia de logística. Desde a primeira semana, os roteiros já pedem para você "clonar o repositório", "rodar python script.py" ou "testar com curl" sem parar para explicar esses três movimentos. Este capítulo existe para que, quando isso acontecer, você já tenha feito esse gesto pelo menos uma vez.

🧠 1. Terminal e VS Code

Um terminal é apenas um jeito de conversar com o computador por texto em vez de cliques. Os três comandos que você vai repetir centenas de vezes neste curso:

Instale também as extensões recomendadas do projeto: abra a pasta do repositório no VS Code e aceite a notificação para instalar o pacote definido em .vscode/extensions.json (Python, SQLTools, Docker, Draw.io).

🧠 2. Git e GitHub do Zero

Git guarda o histórico do seu código no seu computador. GitHub guarda uma cópia desse histórico na nuvem, para o professor avaliar e para você nunca perder o trabalho.

flowchart LR
    A["📁 Pasta local"] -->|"git init / git clone"| B["📦 Repositório Git local"]
    B -->|"git add ."| C["🗂️ Área de Stage"]
    C -->|"git commit -m '...'"| D["📌 Commit (snapshot local)"]
    D -->|"git push"| E["☁️ GitHub (remoto)"]

    style A fill:#e3f2fd,stroke:#1e88e5
    style D fill:#fff8e1,stroke:#fbc02d
    style E fill:#e8f5e9,stroke:#43a047

🛠️ O ciclo que você vai repetir toda semana

# 1. Clone o repositório de atividades (uma única vez)
git clone https://github.com/SEU-USUARIO/atividades-banco-de-dados.git
cd atividades-banco-de-dados

# 2. Depois de editar/criar arquivos, veja o que mudou
git status

# 3. Selecione o que vai entrar no commit
git add .

# 4. Registre um snapshot com uma mensagem clara
git commit -m "feat: adiciona script da atividade 01"

# 5. Envie para o GitHub
git push

🔍 Detalhamento do Comando:

• git status: mostra o que mudou desde o último commit — rode antes de qualquer outro comando, sempre.
• git add .: coloca todos os arquivos modificados na fila do próximo commit.
• git commit -m "...": a mensagem deve dizer o quê e por quê (ex: fix: corrige cálculo de frete, não mudanças).
• git push: só depois disso o professor consegue ver seu trabalho no GitHub.

🧠 3. Python Essencial e POO

Praticamente todo capítulo teórico do curso (Engenharia de Software e Banco de Dados) usa classes Python para modelar entidades do mundo real. Os quatro ingredientes que você precisa reconhecer:

💻 Código Completo e Autocontido (produto.py)

"""
Módulo: produto.py
Domínio: Representação de um produto do catálogo da TecProExpress.
Execução: python produto.py
"""
from dataclasses import dataclass, field

@dataclass
class Produto:
    nome: str
    preco: float
    tags: list[str] = field(default_factory=list)

    @property
    def preco_formatado(self) -> str:
        """Atributo calculado: formata o preço como moeda brasileira."""
        return f"R$ {self.preco:.2f}"

    def aplicar_desconto(self, percentual: float) -> None:
        if not 0 <= percentual <= 100:
            raise ValueError("Percentual de desconto deve estar entre 0 e 100.")
        self.preco -= self.preco * (percentual / 100)


if __name__ == "__main__":
    produto = Produto(nome="Notebook TecPro X1", preco=3500.00, tags=["eletronico", "oferta"])
    print(f"Antes do desconto: {produto.preco_formatado}")

    produto.aplicar_desconto(10)
    print(f"Depois de 10% de desconto: {produto.preco_formatado}")

🚀 Como Executar

python produto.py

🖥️ Saída Esperada no Terminal

Antes do desconto: R$ 3500.00
Depois de 10% de desconto: R$ 3150.00

🔍 Detalhamento do Código:

• field(default_factory=list): evita o erro clássico de usar uma lista vazia ([]) diretamente como valor padrão em Python.
• aplicar_desconto: valida o percentual antes de aplicar — o objeto nunca fica em um estado inconsistente (preço negativo, por exemplo).
• @property: repare que chamamos produto.preco_formatado, sem parênteses — para quem usa a classe, parece um atributo comum.

🧠 4. JSON e HTTP/REST na Prática

Desde a Atividade 06 (Engenharia de Software) e a Atividade 06 (Banco de Dados), os roteiros pedem para testar uma API com curl. Aqui está o que você precisa para não ficar copiando sem entender.

JSON é só um dicionário Python escrito como texto:

{
  "nome": "Notebook TecPro X1",
  "preco": 3500.00,
  "tags": ["eletronico", "oferta"]
}

HTTP é o "idioma" que o navegador (ou o curl) usa para conversar com um servidor:

🔍 Anatomia de um curl

curl -X POST "http://127.0.0.1:5000/api/pacotes" \
     -H "Content-Type: application/json" \
     -d '{"codigo": "BR123456", "peso_kg": 2.5}'

• -X POST: qual verbo HTTP usar.
• "http://127.0.0.1:5000/...": o endereço do servidor — 127.0.0.1 é "meu próprio computador"; 5000 é a porta onde o servidor está escutando.
• -H "Content-Type: application/json": avisa ao servidor que o corpo da requisição é JSON.
• -d '{...}': o corpo (body) da requisição — os dados que você está enviando.

💡 Checkpoint de Lógica

🧪 Quiz de Fixação e Autoavaliação

🛠️ Ponte para a Sua Trilha

📌 Resumo Executivo & Key Takeaways

• Terminal: cd para navegar, python arquivo.py para executar — é só isso que você precisa para começar.
• Git: o ciclo status → add → commit -m "..." → push se repete em toda entrega do curso.
• POO em Python: @dataclass gera o construtor; @property cria atributos calculados; valide dados no construtor para evitar objetos inconsistentes.
• HTTP/REST: verbo (GET/POST/...) + endereço + corpo JSON é a receita de toda requisição que você vai testar com curl neste curso.