Alinha modelo ao Grupo 32: MILP multiobjetivo, lógica binária operacional e documentação técnica

[leticiasdrummond]

Motivation

• Alinhar a implementação ao escopo do Grupo 32 implementando um núcleo MILP que suporte objetivos econômicos, ambientais e de qualidade de serviço EV.
• Melhorar robustez e rastreabilidade adicionando validação de cenário, documentação matemática e parâmetros configuráveis no YAML.
• Evitar comportamentos fisicamente inconsistentes (carga/descarga simultânea, importação/exportação simultâneas) através de lógica MILP realista.

Description

• Atualiza src/model.py para uma FO soma-ponderada (custo obj_cost, emissões obj_ghg, proxy de ociosidade EV obj_idle), adiciona P_ev_unserved e introduz binárias operacionais para bloquear carga/descarga do BESS e importação/exportação de rede (Big-M configurável).
• Adiciona src/config_utils.py com validações de consistência de cenário (chaves obrigatórias, tamanhos de séries, limites físicos e bloco opcional pesos_objetivo).
• Atualiza src/run_scenario.py para reaproveitar validate_config, exportar EV_Unserved no CSV de despacho e escrever decomposição da FO em summary.txt.
• Inclui documentação e artefatos: docs/formulacao_grupo32.md com a formulação, data_dictionary.md, assumptions.md, changelog.md (v0.2.0), README.md atualizado, configs/*.yaml estendidos (pesos_objetivo, fator_emissao_grid, penalidade_oportunidade_ev, grid_big_m), scripts utilitários e exportações de notebooks em src/notebook_exports/.

Testing

• Verificação de sintaxe com python -m py_compile src/config_utils.py src/model.py src/run_scenario.py scripts/extract_notebook_code.py src/__init__.py foi bem-sucedida.
• scripts/extract_notebook_code.py foi executado e gerou os arquivos em src/notebook_exports/ com sucesso.
• Validação programática de validate_config usando um dicionário sintético via importlib passou (validate_config(cfg) retornou sem erro).
• Execução fim-a-fim do solver não foi possível no ambiente devido à ausência de dependências (pyomo, PyYAML) e restrições de rede, portanto a resolução com cbc/solver não foi testada aqui.

---

Codex Task

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f1c213b840

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".