Mini-Projecto · Git workflow profissional

Projecto colaborativo com PRs, CI, code review

⏱ Duração estimada: 8 horas (≈ 5 aulas) ↗ Referencial SNQ

Índice

Contexto
Requisitos
Fases
Critérios
Reflexão

Contexto

Alunos em equipas de 3-4 criam pequeno projecto colaborativo no GitHub aplicando workflow profissional. Tema: site simples (landing page, calculadora, todo list).

Requisitos

Funcionais

Repositório GitHub organizado.
README profissional.
.gitignore apropriado.
Branch protection em main.
Pelo menos 5 PRs com code review.
CI com GitHub Actions.
Issues para gestão.
Conventional commits.
Tags para releases.

Não-funcionais

Deploy funcional (Vercel/Netlify/Pages).
Documentação completa.

Fases

Fase	Tempo	Entregável
1. Setup repo + estrutura	1h	Repo inicial + README
2. Distribuir tarefas + branches	1h	Issues + branches por dev
3. Implementar (cada dev)	3h	PRs com code review
4. Resolver conflitos	1h	Merge bem-sucedido
5. CI + deploy	1h	App live
6. Documentação final	1h	README polido + docs

Critérios

Item	Peso
Organização do repo	15%
Qualidade PRs (descrições, review)	25%
Conventional commits	15%
CI funcional	15%
Branch protection respeitada	10%
Resolução de conflitos	10%
Documentação	10%

Reflexão

Em meia página: que aspecto do Git/GitHub te pareceu mais útil? Que erro cometeste e como aprendeste? Como vais aplicar no próximo projecto?