PlanoDeAtaque (Windows) — gerador do PPTX por quinzena
=========================================================

O QUE TEM NESTA PASTA
----------------------
- PlanoDeAtaque.bat           -> clique duas vezes aqui para rodar
- python\                     -> Python "portatil" com tudo que o programa
                                  precisa ja embutido (nao precisa instalar
                                  Python nem nada no computador)
- gerar_plano.py               -> o programa em si
- cores.json                   -> arquivo de entrada com as cores usadas no PPTX
- 022-26_Plano-de-Ataque-Teste.pptx  -> modelo (slide 2 = layout de uma quinzena)
- 022_26-Planejamento-Teste.xlsx     -> planilha de planejamento (aba "Planejamento")

COMO USAR
---------
1. Deixe nesta pasta SEMPRE apenas 1 arquivo .json de cores, 1 .pptx modelo e
   1 .xlsx de planejamento (pode trocar o conteudo/nome dos arquivos, contanto
   que continue tendo so um de cada tipo). Nao mexa na pasta "python".
2. De dois cliques em "PlanoDeAtaque.bat".
   (Se o Windows/SmartScreen avisar "Windows protegeu o computador", clique em
   "Mais informacoes" -> "Executar assim mesmo" -- isso acontece porque o
   arquivo nao tem uma assinatura digital paga, nao porque tem algo de errado.)
3. Uma janela preta (prompt de comando) vai abrir, mostrar o andamento e gerar
   "<nome-do-modelo>_ATUALIZADO.pptx" na mesma pasta.
4. Aperte qualquer tecla para fechar a janela quando terminar.
5. Pode rodar quantas vezes quiser (sobrescreve o arquivo gerado a cada vez).

COMO EDITAR AS CORES (cores.json)
----------------------------------
Abra o cores.json com o Bloco de Notas (ou qualquer editor de texto). Para
cada estrutura (geotecnia / superestrutura / infraestrutura) existem dois
status: "andamento" e "concluido". Cada um tem:
  - "preenchimento": cor de dentro do quadrado/quadrante (hexadecimal, sem #)
  - "borda": cor do contorno (hexadecimal, sem #)
  - "alpha_preenchimento": opacidade do preenchimento no DESENHO, de 0 a 100
        (100 = solido; um valor mais baixo deixa a planta aparecer por baixo
        da cor). A legenda do slide sempre aparece solida (100%), independente
        deste valor.

Tambem da para ajustar:
  - "marcador_fracao": tamanho dos marcadores de pilar/bloco, em fracao do
        espacamento entre colunas (0.42 = 42%). Valores menores = marcadores
        menores.
  - "quinzena.duracao_dias": quantos dias tem cada quinzena (padrao 14)
  - "quinzena.data_inicio": data de inicio da primeira quinzena (AAAA-MM-DD)
  - "quinzena.numero_inicial": numero da primeira quinzena gerada (padrao 2,
        igual ao slide-modelo original "Quinzena 02")

Depois de editar e salvar o cores.json, so rodar o PlanoDeAtaque.bat de novo.

SE DER ERRO
------------
A janela preta explica o que falta (por exemplo, "nenhum arquivo .xlsx
encontrado" ou "mais de um arquivo .pptx encontrado"). Corrija a pasta
conforme a mensagem e rode novamente.

OBSERVACAO TECNICA
--------------------
Esta pasta usa o "Python embutido" (embeddable) oficial do python.org dentro
de python\, com as bibliotecas ja instaladas em python\Lib\site-packages.
Isso significa que a pasta inteira precisa ficar junta -- pode mover a pasta
toda para outro lugar, mas nao pode separar o PlanoDeAtaque.bat da pasta
python\.
