Pipeline GitLab CI verde — corrigir flake8 e validar build

Objetivo

Fazer a pipeline GitLab CI passar verde. Actualmente falha no validate:python (flake8) com 111 erros em 24 ficheiros. Corrigir todos e garantir que os stages seguintes (build, test) tambem passam.

Scope

1. Corrigir 111 erros flake8 (E501, F841, F811) em 24 ficheiros Python
2. Verificar que a pipeline passa localmente antes de push
3. Ajustar .gitlab-ci.yml se necessario (jobs que dependem de Docker registry)

Fora de Scope

• Novos endpoints ou features
• Deploy para ambientes remotos
• Alteracoes aos testes E2E

Passos de Execucao

1. Correr flake8 localmente e corrigir todos os erros
2. Correr pytest para garantir que as correcoes nao partem nada
3. Ajustar pipeline se necessario para jobs que nao podem correr ainda
4. Push e verificar pipeline no GitLab

Evidencia Esperada

• flake8 local: 0 erros
• pytest: 33/33
• Pipeline GitLab: verde (pelo menos validate + test)