O Lucro na Calçada

Objetivos da Fase

6.1 — Dividindo o Lucro com Código

A metáfora final do Circuito: os 6 amigos na calçada, dividindo o que ganharam. No código, isso significa distribuir o valor em partes iguais.

# distribuir_lucro() — a calçada em código
def distribuir_lucro(
    total: float,
    participantes: list[str] | None = None,
) -> dict[str, float]:
    """Distribui lucro igualmente entre os participantes.

    Args:
        total: Valor total a distribuir, em reais.
        participantes: Lista de nomes. Padrão: os 6 amigos.

    Returns:
        Dicionário no formato {nome: valor_recebido}.
    """
    if participantes is None:
        participantes = [
            "Ciclano",
            "Tobias",
            "Marieta",
            "Zelão",
            "Pimenta",
            "Grilo",
        ]

    centavos = int(round(total * 100))
    base, resto = divmod(centavos, len(participantes))
    return {
        nome: (base + (1 if i < resto else 0)) / 100
        for i, nome in enumerate(participantes)
    }

resultado = distribuir_lucro(120.0)
for nome, valor in resultado.items():
    print(f"  {nome}: R$ {valor:.2f}")
  Ciclano: R$ 20.00
  Tobias: R$ 20.00
  Marieta: R$ 20.00
  Zelão: R$ 20.00
  Pimenta: R$ 20.00
  Grilo: R$ 20.00

6.2 — Commits Semânticos

Um histórico Git limpo é tão importante quanto o código. Commits semânticos contam a história do projeto — cada um sabe o que foi feito e por quê.

# Padrão: tipo(escopo): descrição concisa

git commit -m "feat(fase01): adiciona função calcular_abaco()"
git commit -m "fix(fase02): corrige colisão da bola na borda inferior"
git commit -m "docs(readme): adiciona badges de versão e licença"
git commit -m "refactor(bot): extrai lógica de predição para BotFerradura"
git commit -m "test(distribuir): adiciona testes para valores extremos"
git commit -m "chore(deps): atualiza scikit-learn para 1.4.0"

6.3 — README.md simples

O README é a calçada do seu projeto — a primeira coisa que qualquer pessoa vê. Ele deve contar o que é, como rodar e o que você aprendeu.

# Estrutura recomendada para README.md

# 🏁 Circuito Ferradura

!Version
!Python
!License

> Trilha introdutória de lógica e Python inspirada nas corridas de bicicleta
> de Palotina-PR, 1993. Material em evolução da Cara Core Informática.

## 🚀 Como rodar

```bash
pip install -r requirements.txt
python circuito_ferradura/demo.py
```

## 📁 Estrutura

```
├── circuito_ferradura/   # Código-fonte do simulador
├── docs/                 # GitHub Pages: raiz, /docs ou Actions
└── testes/               # Suíte de testes pytest
```

## Registro de conclusão

Ao concluir as 6 fases, você pode gerar um registro local de conclusão:
https://circuito.caracore.com.br/curso/conclusao.html

✅ Checklist da Fase 6