Manual do Ecossistema de Movimentação de Pessoal

O Governo federal movimenta servidores entre órgãos o tempo todo: cede, requisita, redistribui cargos, autoriza afastamentos. Cada um desses atos deixa rastro no SIAPE, mas o rastro é bruto — códigos, registros duplicados por matrícula, duas pontas do mesmo movimento em linhas diferentes. Responder “quantas pessoas o Ministério X cedeu e recebeu, e isso respeita a proporcionalidade do §7º do art. 93?” exigia dias de planilha.

Este ecossistema faz esse caminho todo dia, sozinho: lê o Data Lake, reconstrói cada movimentação, aplica as regras da norma e entrega nove painéis de página única que abrem no navegador, sem servidor e sem instalação para quem consulta.

O que é, e o que não é#

É

Um retrato do SIAPE numa competência, com as regras de negócio já aplicadas e as fontes declaradas em cada tela.

Não é

Um sistema transacional. Nada aqui altera o SIAPE — o fluxo é de leitura, só.

É

Uma ferramenta de acompanhamento: indica onde olhar, quantifica, compara com a norma.

Não é

A apuração oficial de nenhum indicador. Quando um decreto manda o MGI divulgar um número, o número oficial é o do MGI; aqui é acompanhamento com fonte declarada.

Como as peças se encaixam#

Este capítulo é gerado: as contagens abaixo saem dos arquivos da última rodada, no momento em que o manual é montado. Se um número aqui estiver velho, é porque o manual não foi refeito depois da rodada — não porque alguém esqueceu de editar o texto.

Volume de cada painel#

Limites de reembolso — exercício 2026#

A execução orçamentária vem da extração manual do SIOP mais recente na pasta de dados: Extrator1788435198276.csv, de 03/09/2026 às 08:52. O painel usa só a mais recente por exercício — somar duas extrações do mesmo ano dobraria a despesa.

Planilhas internas da última rodada#

Ficam em PASTA_DADOS/planilhas_internas/ e não vão para a web — ver o capítulo das planilhas internas.

Cobertura das taxonomias da equipe#

Estes dois números dizem quanto do painel se apoia em classificação em dia. Rode Conferir taxonomias no assistente para a lista do que falta.

Por que os painéis são HTML de arquivo único#

Cada painel embute os próprios dados e o próprio JavaScript. Não há servidor, banco, API nem build. As consequências práticas:

• Quem consulta só precisa de um navegador — abre até de um pen drive.
• Publicar é copiar arquivo. Não há infraestrutura para cair às 23h de uma sexta.
• Em compensação, os arquivos são grandes (o painel de Pessoal passa de 35 MB) e todo o dado embutido é legível por quem tiver o arquivo — ver o capítulo de privacidade.

O código, em pastas#

1. Python 3.11 ou mais novo

   Confira com python --version. O projeto roda no Anaconda ou no Python oficial — tanto faz, desde que seja o mesmo interpretador em todos os passos.

2. Acesso ao Data Lake

   Credenciais do Databricks do MGI. Sem elas dá para gerar painéis a partir de uma extração que já esteja em PASTA_DADOS, mas não para atualizar a base.

3. A pasta de dados

   Um lugar fora do projeto para os dados sensíveis — tipicamente a pasta da equipe no OneDrive. Ver o capítulo seguinte.

4. As bibliotecas

   O assistente instala tudo sozinho. Manualmente: pip install -r requirements.txt.

Ambiente virtual (opcional, recomendado)#

O assistente cria e usa um ambiente virtual se você quiser, pela aba Ambiente. Na mão:

cd C:\0_Desenvolvimento\Movimentacao_pessoal\pipeline
python -m venv C:\projetos_ia\venv_ia
C:\projetos_ia\venv_ia\Scripts\activate
pip install -r requirements.txt

Na raiz do projeto existe um arquivo .env. Ele não vai para o repositório e guarda o que é específico da máquina e da pessoa.

PASTA_DADOS=C:\Users\voce\OneDrive - Ministério...\Base de Dados\Movimentações
DATABRICKS_SERVER_HOSTNAME=...
DATABRICKS_HTTP_PATH=...
DATABRICKS_TOKEN=...

O repositório de código é versionado e circula; a base do SIAPE tem nome, CPF e remuneração de mais de um milhão de pessoas. As duas coisas não podem morar juntas.

O arquivo de referência da competência#

output/referencia.json guarda a competência do último processamento. É a guarda contra um problema real que já ocorreu: o fatoServidor voltar uma competência antiga sem ninguém notar. Se a competência recuar, o painel avisa a defasagem em vez de exibir número velho como se fosse novo.

Caminho 1 — o aplicativo (recomendado)#

Dois cliques em Assistente CGMOP.vbs. Abre uma janela com as etapas marcáveis, log ao vivo, botão de cancelar e as abas de manutenção. É o caminho para quem não programa.

Caminho 2 — o menu de texto#

cd C:\0_Desenvolvimento\Movimentacao_pessoal\pipeline
python assistente.py

A mesma coisa que a janela, em perguntas numeradas no terminal. Serve para máquina sem interface gráfica ou para quem prefere teclado.

Caminho 3 — um comando para tudo#

cd C:\0_Desenvolvimento\Movimentacao_pessoal\pipeline
python atualizar_tudo.py                 # ETL → painéis → planilhas → publicação (pergunta antes do push)
python atualizar_tudo.py --atualizar     # antes, re-extrai do Data Lake (login Azure)
python atualizar_tudo.py --sem-push      # faz tudo, menos o git
python atualizar_tudo.py --sem-planilhas # pula as planilhas internas (o passo mais lento)
python atualizar_tudo.py --planilhas inconsistencias  # exporta SÓ essa(s)
python atualizar_tudo.py --planilhas-listar           # mostra as chaves e sai
python atualizar_tudo.py --sim           # não pergunta: confirma o push

É o que os botões Atualizar tudo e Re-extrair do assistente chamam por baixo. Uma etapa que falha não derruba as seguintes — exceto o ETL, que é obrigatório: se ele falha, nada adiante faz sentido e nada é publicado. Ao final, grava um relatório Excel da rodada em pipeline/relatorios_execucao/, com a aba Números e a verificação “Balanço cede == recebe?”.

Caminho 4 — comando a comando#

Sempre de dentro de pipeline/:

python -m src.main                    # 1. reprocessa a base (5 etapas)
python painel/gerar_painel.py         # 2. painel de Movimentações (interno)
python painel/gerar_painel_publico.py #    versão aberta, sem proporcionalidade
python painel/gerar_anistiados.py
python painel/gerar_pessoal.py
python painel/gerar_redistribuicao.py
python painel/gerar_lip.py
python painel/gerar_internacional.py
python painel/gerar_capacitacao.py
python painel/gerar_reembolso.py
python painel/gerar_hub.py            # 3. a home do ecossistema
python -m src.exportar_planilhas_internas   # planilhas internas (Excel, sem máscara)
python ..\manual\gerar_manual_html.py       # este manual, com os números da rodada
python painel/publicar_cgmop.py       # 4. copia para a pasta do site (NÃO faz git push)

Quanto tempo leva#

O Assistente CGMOP reúne tudo o que se faz com o ecossistema: buscar os dados, reprocessar a base, gerar os painéis, publicar, cuidar de quem entra e do que fica no ar. Abre com dois cliques em Assistente CGMOP.vbs (na pasta pipeline/) ou pelo atalho da Área de Trabalho. Este capítulo percorre cada aba e cada botão.

O que está sempre na tela#

À direita, o log

Tudo o que roda escreve ali, linha a linha, na hora. É onde se lê por que uma etapa falhou. Limpar apaga a tela do log; não apaga nada no disco.

No rodapé, ■ Cancelar

Só acende enquanto algo está rodando. Encerra o processo em andamento (e tudo o que ele abriu) e pula as etapas que faltavam. Vale para uma extração longa, para a instalação de bibliotecas e até para um git push que você percebeu cedo demais. Fechar a janela no meio de uma execução também encerra o processo — nada fica rodando escondido.

Último relatório

Abre o Excel da última rodada (pipeline/relatorios_execucao/): o que rodou, quanto tempo levou, e os números com a verificação “cede == recebe”.

Aviso de bibliotecas

Ao abrir, o assistente confere em segundo plano se todas as bibliotecas do requirements.txt estão instaladas. Se falta alguma, um aviso no topo diz qual e aponta para a aba Ambiente. A janela não trava enquanto verifica.

Memória entre sessões

Pasta de dados, ambiente virtual, dados locais e a duração de cada etapa ficam em pipeline/.assistente_prefs.json. Na próxima abertura, tudo vem como você deixou.

0 · Início — onde se começa e onde se decide#

Três cartões. O que este assistente faz explica o ciclo em três passos (a base, os painéis, a publicação). Como está o projeto agora é um diagnóstico lido dos arquivos, não uma suposição: a pasta de dados em uso, a competência (e se a folha está alinhada com ela), quando a base foi gerada e o tamanho, quantas tabelas há em cache, quantos painéis foram gerados e quando, e quantos usuários o portão tem. 🔄 Verificar de novo relê tudo.

▶ Atualizar tudo (verde)

O caminho recomendado. Reprocessa a base a partir do cache — sem baixar nada, sem pedir login —, gera os nove painéis e as planilhas internas, prepara a publicação e pergunta antes de mandar para o ar. Leva alguns minutos.

⟳ Re-extrair do Data Lake (âmbar)

Igual ao anterior, mas antes baixa os dados do Data Lake de novo. Abre o navegador para o login do Azure e demora bem mais. Use quando o SIAPE publicar uma competência nova — não para refazer um painel.

📤 Só publicar (azul)

Pula o processamento: copia os painéis já gerados para a pasta do site, injeta o login e oferece o envio. Para quando você só mexeu em usuários ou no que fica no ar.

Criar atalho

Cria DOIS atalhos com o ícone do projeto: um na sua Área de Trabalho (a real, onde quer que o Windows a tenha posto) e outro dentro da pasta pipeline/, chamado “Abrir Assistente CGMOP”. O segundo existe porque o Assistente CGMOP.vbs aparece no Explorer com o ícone do Windows Script Host e não há como mudar isso — o Explorer usa o ícone do TIPO de arquivo (.vbs), que é do registro e vale para toda a máquina. Atalho, sim, aceita ícone próprio.

1 · Pipeline — as etapas, uma a uma#

Cada linha é um programa do pipeline, agrupado em Base (o ETL), Painéis (Movimentações interno e público, Anistiados, Pessoal, Redistribuição, Hub), Estudos (LIP, Afastamento Internacional, Licença Capacitação, Limites de Reembolso), Extras (planilhas internas, conferir chaves do reembolso, conferir taxonomias) e Publicação. Ao lado de cada uma, o ▶ roda só aquela etapa — é o botão de quem mudou um painel e não quer reprocessar tudo. O tempo à direita é o da última execução, como estimativa.

Executar selecionadas

Marque a caixa das etapas que quer e rode as várias de uma vez. Elas rodam SEMPRE na ordem da lista — não na ordem em que você marcou —, porque é a ordem em que dependem umas das outras (o ETL alimenta os painéis; o hub lê o estado de todos). O assistente mostra a lista e pede confirmação antes, e guarda a seleção para a próxima abertura. «Marcar todas» e «Limpar seleção» ao lado.

Quais planilhas exportar

Na linha das Planilhas internas há um painel recolhível com uma caixa por base (movimentações, proporcionalidade, anistiados, pessoal, redistribuição, reembolso, LIP, internacional, capacitação, pós-graduação). A rodada completa leva dezenas de minutos — quase tudo em Pessoal, que são três arquivos de mais de 100 MB —, então quem mexeu só numa base não precisa esperar o resto. Nenhuma marcada = saem todas, que é o comportamento de sempre. Pela linha de comando: python -m src.exportar_planilhas_internas --bases anistiados,lip (e --listar mostra as disponíveis).

O ícone de status

○ aguardando · ◐ rodando · ✓ ok · ✕ falhou · – pulado. O ETL é obrigatório: se ele falha, as demais são puladas e nada é publicado — senão iria ao ar dado velho.

De onde vêm os dados

O caminho da PASTA_DADOS (raw e output). Normalmente é a pasta do OneDrive do .env; o botão … escolhe outra. A caixa usar dados locais troca para pipeline/data, que é para teste — desmarcar volta ao .env.

2 · Usuários — quem entra nos painéis restritos#

A tabela mostra os usuários do portão (senha mascarada; mostrar senhas revela). Clicar numa linha carrega a pessoa nos campos de baixo para editar. O usuário é nome.sobrenome e a senha é a data de nascimento em ddmmaaaa — o login aceita com ou sem barras, e não distingue maiúsculas.

＋ Incluir / Atualizar

Põe na lista da tela: usuário novo entra, usuário que já existe tem a senha trocada. Senha que não pareça uma data (8 dígitos) pede confirmação. Nada vai ao disco ainda — o rodapé passa a dizer “alterações NÃO salvas”.

✕ Remover selecionado

Tira da lista o usuário marcado. Recusa remover o último — ninguém conseguiria entrar.

Limpar campos

Esvazia os dois campos.

💾 Salvar lista

Grava em painel/.usuarios_portao.json (fora do repositório publicado), guardando a lista anterior num backup com data e hora ao lado.

🔄 Recarregar

Relê o arquivo e descarta o que não foi salvo.

📤 Salvar e publicar

Salva, regenera o login de todas as páginas e publica — perguntando antes do envio. Sem publicar, a mudança não vale no site.

3 · O que fica no ar — publicar, anunciar ou esconder#

Para cada painel, três estados: no ar (publicado com link), em revisão (o cartão aparece no hub, sem link, e o arquivo não é copiado — serve para anunciar um estudo cujo número ainda está sendo conferido) e não aparece. Um resumo abaixo da lista diz quantos estão em cada estado. A escolha fica em painel/.no_ar.json e só vale no site depois de publicar.

Salvar escolha

Grava o arquivo; não publica.

Marcar tudo como no ar

Atalho para voltar todos ao estado publicado (ainda precisa salvar).

Salvar e publicar agora

Grava, gera o hub de novo e publica com esta escolha. Painéis fora do ar são removidos da pasta publicada — o que estava no ar sai do ar.

4 · Tabelas — as bases que a equipe mantém#

Tudo o que o sistema usa e não vem do Data Lake — taxonomias, portarias, a remessa de aposentadoria do INSS — está listado aqui, com o caminho, o tamanho, a data e quem lê cada arquivo. A lista vem de um registro único no código (src/referencias.py): base nova cadastrada lá aparece aqui sozinha. Os detalhes de cada base e das três ações estão no capítulo seguinte.

Clicar no NOME da tabela

Abre a pasta onde o arquivo está, no Explorer. É o caminho mais curto para a pergunta mais frequente desta aba: “onde isso fica?”.

Abrir

Abre no programa certo (Excel para planilha e CSV). Salvar já basta — o painel usa na próxima geração.

Pasta

Abre a pasta onde o arquivo está — o mesmo que clicar no nome.

Substituir…

Troca o arquivo inteiro por um que você recebeu. O anterior vai para um backup datado ao lado.

Apontar…

Faz o pipeline ler de outro lugar, sem mover nada. Um selo “repontado” passa a aparecer na linha.

Soltar

Só aparece numa base repontada: volta ao lugar padrão.

Conferir chaves do reembolso

Confere se todo órgão com teto tem cadastro, se a execução do SIOP foi 100% atribuída e se todo cedido tem titular. Quando falta, diz o arquivo e a linha.

Conferir taxonomias

Lista as funções e os órgãos que estão nos dados e ainda não foram classificados, com o volume de vínculos e os códigos prontos para colar.

Apagar meses anteriores…

No cartão das pastas, na linha das planilhas internas: varre da pasta da equipe tudo o que não é da referência atual dos dados. Diz antes quantos arquivos e quantos MB vão sair, e pede confirmação. Arquivo aberto no Excel é pulado, com aviso — feche e repita.

5 · Ambiente — Python e bibliotecas#

Um ambiente virtual isola as bibliotecas deste projeto das do resto do computador. Não é obrigatório: sem ele, tudo roda no Python do sistema.

Caminho do ambiente + …

A pasta do venv (editável; … escolhe).

usar este ambiente virtual nas etapas

É o que “ativa” o ambiente aqui: as etapas passam a rodar com o Python de dentro dessa pasta. Se ele ainda não existir, o assistente avisa e usa o do sistema. Não há activate nem PATH para mexer.

Criar / instalar aqui

Cria o venv na pasta (se não existir) e instala nele todas as bibliotecas do requirements.txt, com o pip aparecendo no log.

Instalar bibliotecas

Instala ou atualiza todas as bibliotecas no ambiente em uso.

Instalar uma biblioteca específica

Campo + Instalar (ou Enter): o mesmo que pip install <nome>. Para quando o aviso do topo diz que falta só uma.

6 · Comandos — o PowerShell dentro do assistente#

De vez em quando aparece um comando para rodar à mão — --completar-cache para buscar uma tabela nova, --listar para ver as bases. Esta aba existe para você não precisar sair do assistente. E o ganho não é o console: é o console já pronto. Digite ou cole o comando, tecle Enter, e a saída aparece no mesmo log da direita, com o ■ Cancelar valendo.

Campo de comando

Enter executa. As setas ↑ e ↓ passeiam pelos comandos que você já usou (ficam guardados nas preferências); a setinha à direita abre a lista inteira.

Comandos que você mais usa

Botões para os cinco de sempre: completar cache, atualizar tudo, ver referências, listar as planilhas internas e conferir qual Python está em uso. Um clique põe o comando no campo e já roda.

Abrir PowerShell aqui

Abre uma janela separada, já na pasta do projeto e com o mesmo ambiente. Use quando o comando pergunta alguma coisa.

Boa parte do que o painel afirma não vem do Data Lake: vem de classificações que a CGMOP mantém e de arquivos que ela recebe. Portaria nova, ministério criado, agência que troca de pasta, função nova, remessa do INSS — nada disso é código, é cadastro. Todas estas bases estão na aba Tabelas do assistente, cada uma com três ações: Abrir, Substituir… e Apontar….

A extração do SIOP não é tabela — é arquivo que você baixa#

A execução orçamentária do painel de reembolso vem de uma extração manual do SIOP, salva com o nome que o próprio SIOP deu (Extrator<número>.csv). O lugar da equipe é PASTA_DADOS/ext_limites_reembolso/ — há um atalho para ela no cartão de pastas da aba Tabelas. A raiz da pasta de dados e a antiga subpasta siop/ continuam sendo lidas, para quem já guardou lá.

Substituir, apontar, soltar — e onde isso fica gravado#

Substituir…

É a operação do dia a dia (“chegou remessa nova”, “saiu portaria”). Você escolhe o arquivo; o atual é copiado para nome_backup_AAAAMMDD_HHMM.ext ao lado e o novo entra no lugar. Formato diferente do atual pede confirmação. O backup acontece sempre, também pela linha de comando — a regra mora no registro, não no botão.

Apontar…

O pipeline passa a ler de outro caminho, sem mover o arquivo. A escolha fica em reference/.caminhos.json, e a linha da aba ganha o selo “repontado”. Soltar volta ao padrão e apaga a anotação.

A escada de decisão

Para cada base, vale nesta ordem: a variável de ambiente REF_<CHAVE> (para fixar numa máquina sem editar nada) → o .caminhos.json → o caminho padrão em reference/. É a mesma escada da PASTA_DADOS e do repositório do site.

Conferir pelo terminal

python -m src.referencias lista as bases, onde cada uma está, tamanho, data e de onde veio a decisão do caminho.

Por que o limite de reembolso é procurado em dois lugares#

O limites_reembolso.csv é lido primeiro da PASTA_DADOS e só depois de reference/. Assim a equipe cadastra a portaria nova junto com os dados, sem precisar mexer no repositório; a cópia versionada fica como semente e rede de segurança. O log diz sempre qual dos dois foi usado.

Etapa 1 — Extração#

Consulta o Data Lake e grava parquet cru em raw/: o fato_servidor (o retrato de cada vínculo), as dimensões (órgão, situação, cargo, cor/raça, escolaridade, unidade organizacional…) e a ficha financeira da competência mais recente disponível.

Etapa 2 — Montagem das movimentações#

É a etapa com mais regra de negócio, porque o SIAPE não tem uma tabela de movimentações. Cada movimento deixa duas marcas, em registros diferentes: a saída no órgão de origem e a entrada no de destino. O pipeline casa as duas por CPF e data.

• Deduplicação por matrícula: o mesmo servidor tem um registro por vínculo. Sem tratar, cada matrícula geraria uma linha do mesmo movimento. Mantém-se um por (CPF, origem, destino, data de ingresso), priorizando o ativo.
• Origem == destino sai fora: não é movimentação entre órgãos, é resíduo de reforma administrativa (o órgão trocou de código, não a pessoa de casa).
• GDF e DPU: movimentos internos ao Governo do DF saem; quem tem só uma ponta no GDF fica.
• Colapso de reforma: quando o órgão se transformou (MP → ME → MGI), a trilha vira uma cadeia de siglas em vez de várias movimentações falsas.

Etapa 3 — Dimensões e taxonomias#

Códigos viram nomes legíveis, e entram as classificações da equipe: setor e poder do órgão, natureza estatal pelas listas da SEST, conceitos das situações funcionais.

Etapa 4 — Enriquecimento#

Demografia, tempo de movimentação, remuneração da ficha financeira, nível de liderança e vagas por órgão. É aqui que se aplica a taxonomia de funções.

Etapa 5 — Exportação#

Vigente ≠ ativo#

Vigente é o vínculo que ainda existe no SIAPE — inclui aposentados e pensionistas. Ativo é o vínculo em situação funcional ativa. A diferença é grande: dos 1,12 milhão de vínculos vigentes, cerca de 656 mil são ativos e 409 mil são aposentados. Usar um no lugar do outro erra por 40%.

Servidores ativos ≠ força de trabalho#

Servidor ativo é a situação do vínculo, e inclui quem está cedido para outro órgão. Força de trabalho conta só quem está em exercício no próprio órgão. O KPI de força de trabalho saiu da faixa principal do painel de Pessoal justamente porque, lado a lado com “servidores ativos”, confundia mais do que informava — mas segue como gráfico e como filtro.

Pessoas ≠ vínculos#

Um servidor pode ter matrícula em mais de um órgão. Contagens de pessoas deduplicam por CPF; gráficos por órgão contam vínculos, porque a pessoa aparece em cada órgão onde tem matrícula. São 1,12 milhão de vínculos para ~1,08 milhão de pessoas.

Origem e destino moram em linhas diferentes#

A situação funcional da origem e a do destino vêm de registros distintos do SIAPE. O pipeline preenche as duas pontas: movimento só-origem recebe no destino a mesma situação que descreve a cessão; movimento só-destino recebe na origem a situação-base do servidor. Nenhum preenchimento sobrescreve o que veio da própria ponta.

O passado não alimenta o presente#

Competência de referência#

Todo painel é um retrato de uma competência, indicada no cabeçalho. Conclusões de conformidade são sempre amarradas a ela: “na competência 06/2026, os dois grupos atendem o mínimo”. Outra competência pode dar outro resultado, e a frase precisa deixar isso evidente.

Proporcionalidade do §7º do art. 93#

A ideia da norma: o órgão que recebe pessoas para compor sua força de trabalho deve, na mesma medida, liberar. O painel calcula por órgão o que cede (A), o que recebe (B) e o saldo (C = A − B), cruzando com vagas aprovadas (D) e ocupadas (E). Cada coluna derivada vem explicada na tela e no PDF — C/E, % Ocup./Aprov., % Lib. A/E, % Oriundos B/E e % Mov. Força de Trabalho.

Todos compartilham a mesma gramática: filtros no topo, filtros aplicados no trilho lateral, gráficos clicáveis com multi-seleção, exportação em PDF e planilha.

Movimentações#

O painel central. Vigentes e histórico, quem cede e quem recebe, tipos de movimentação, setor e natureza estatal das duas pontas, tempo médio no destino, encerramentos e motivos de saída. Tem a relação nominal, com ficha individual, trajetória do servidor (todas as movimentações da mesma pessoa) e a aba de Proporcionalidade.

• Recortes: vigentes ou histórico completo, com período ajustável.
• Relatórios: executivo geral, ficha individual, trajetória e o de proporcionalidade — este último com a tabela larga, mas impresso em papel em pé.
• Versão pública: arquivo separado, sem a aba de proporcionalidade e sem os campos que não devem circular.

Pessoal#

Quadro agregado do Executivo federal — sem nome, CPF ou matrícula. É um cubo de ~560 mil combinações que responde a qualquer cruzamento das 16 dimensões.

• Órgão de lotação e órgão de exercício são coisas diferentes: 96% coincidem, e os 4% restantes são quem está cedido ou requisitado.
• UF de exercício vem do município de exercício (código IBGE), com 99,6% de cobertura, e aparece como mapa de blocos. A antiga “UF da UPAG” saiu: a UPAG é unidade pagadora, não diz onde a pessoa trabalha.
• Natureza jurídica é a do órgão de lotação — está dito no rótulo.
• Fora do grupo “Composição do quadro”, cada barra, coluna ou fatia mostra também a remuneração média daquele grupo.
• Dois cartões de liderança: mulheres e homens por nível, e o acompanhamento do Decreto 11.443/2023. Cada um declara o próprio universo, porque contam populações diferentes — ver o capítulo da norma.

Anistiados#

Ficha funcional do público da Lei 8.878/94: de onde vieram, por onde passaram, onde estão hoje, remuneração e tempo de retorno. A situação atual está em três botões com o respectivo quantitativo, acima da primeira linha de filtros. Desde 09/09/2026 há também a aposentadoria pelo INSS — espécie, DIB e situação do benefício —, com filtro, gráfico e colunas próprias na relação nominal.

Redistribuição#

Cargos redistribuídos entre órgãos (art. 37 da Lei 8.112/90): de onde para onde, saldo por órgão, série histórica, perfis e a matriz origem × destino — 12 maiores origens nas linhas contra 12 maiores destinos nas colunas, com a célula colorida pela intensidade e clicável para filtrar o par.

LIP — Interesse Particular#

Licenças do art. 91 desde 2011: órgão, cargo, carreira, duração e situação de cada afastamento, com a lista nominal.

Radar do Exterior e Quinquênio#

Dois painéis de conformidade, não de contagem. O Radar cruza quem está fora do País (art. 96) com a folha e com a fila do que a lei manda conferir. O Quinquênio acompanha o teto de 90 dias por quinquênio (art. 87) e a carência de 2 anos antes da pós (art. 96-A).

Mara Legis — o acervo jurídico#

Acervo de inteligência jurídica sobre movimentação de servidores (legislação, pareceres e as respostas de sempre), montado no NotebookLM. Não é um painel: mora fora do domínio e abre noutra aba, sem passar pelo portão. Está no hub e na barra de navegação de todos os painéis — a ideia é que quem está lendo uma ficha e precisa da norma não tenha de procurar o link noutro lugar.

Limites de Reembolso#

Junta duas metades da mesma história: quanto cada órgão já gastou do teto da portaria conjunta MGI/MPO (execução do SIOP) e quem são os empregados de estatal cedidos por trás dessa despesa (SIAPE).

• Termômetro do teto: liquidado, empenhado a liquidar e saldo na escala do teto, com a marca de onde o calendário está — vê-se num golpe se o gasto está adiantado ou atrasado.
• IHE (Índice Histórico de Execução): média do percentual do teto usado por ano, com o ano em curso proporcional aos dias decorridos.
• Simulação de custo com parâmetros editáveis e um campo para projetar entradas além do efetivo — a projeção entra no total e fica registrada no relatório.
• Simulação de reajuste de convenção coletiva, com as duas bases explicadas.
• Três grupos de órgãos, pela cor da barra e por filtro próprio: serviços compartilhados (azul), agências reguladoras (verde) e demais órgãos (âmbar). A legenda abaixo do gráfico de gasto diz quanto do liquidado cabe a cada grupo.

A taxonomia de liderança é nossa, não da norma#

A separação Alta × Baixa/Média vem da planilha FUNÇÕES.xlsx, mantida pela CGMOP. Onde a função tem equivalência ao DAS, a planilha conta DAS 4, 5, 6 e Natureza Especial como alta liderança, e DAS 1, 2 e 3 como baixa/média.

O que foi conferido contra a lei, e o que não#

O Decreto nº 11.443/2023#

Como o painel afere — e o que ele não alcança#

Entram os vínculos vigentes do SIAPE nas famílias FEX e CCX, com o nível nos dois últimos dígitos do código. A cor/raça está preenchida em 100% desses vínculos, e o denominador inclui os nomeados sem vínculo anterior.

Na competência de referência 06/2026, com o prazo do §1º já vencido, os dois grupos atendem. Mas o detalhe por nível mostra o que a apuração global esconde: o topo está abaixo da meta, e o cumprimento se apoia na base da pirâmide.

Dois cartões, dois universos#

O cartão de gênero conta todas as famílias de função (≈265,6 mil vínculos). O do decreto conta só CCE e FCE (≈53,3 mil) — cinco vezes menos, e um subconjunto do primeiro. Cada cartão declara o próprio universo na tela, porque comparar os percentuais como se fossem a mesma base leva à conclusão errada.

O que fica embutido em cada painel#

Painéis de arquivo único carregam o dado dentro do HTML. Esconder na interface não é o mesmo que não publicar: quem tem o arquivo pode ler o código-fonte. As decisões atuais:

O portão de acesso#

O que fica no ar#

A aba O que fica no ar do assistente decide painel a painel. “Em revisão” mantém o cartão no hub, sem link, e remove o arquivo da pasta publicada — o link volta 404. Serve para anunciar que o estudo existe enquanto os números são conferidos.

Publicar#

python painel/publicar_cgmop.py     # copia + injeta o portão
cd C:\0_Apresentacoes\dadosrgb
git add painel_CGMOP
git commit -m "..."
git push

Os painéis mascaram e agregam. Internamente às vezes é preciso o dado completo — por pessoa, com nome, CPF e matrícula. A cada rodada o pipeline grava um arquivo por base em PASTA_DADOS/planilhas_internas/.

O que é gerado#

Cada arquivo tem três abas: Painel (KPIs e gráficos), Dados (a base com autofiltro e painel congelado) e Dicionário (o que é cada coluna). A de referências é a exceção: tem um Índice e uma aba por tabela.

Três decisões que valem conhecer#

Pessoal vem separado

Ativos, aposentados e demais em arquivos distintos. Não é capricho: 1,12 milhão de vínculos não cabe numa aba do Excel, que aceita 1.048.576 linhas.

Base grande sai em streaming

Acima de 250 mil linhas o arquivo é escrito sem manter as células na memória (a primeira tentativa consumiu 5 GB e não terminou) e vem com um CSV ao lado, que é o que serve para carregar o volume inteiro de uma vez. Nesse modo não há gráficos.

GDF e DPU entram

Os painéis excluem o Governo do DF (e forças) e a DPU; as planilhas internas trazem o quadro completo. Nas bases de movimentação o que os painéis tiram é só o que tem as duas pontas nesse conjunto — quem tem uma ponta federal sempre esteve lá.

O CPF completo#

O movimentacoes_painel.csv guarda CPF mascarado, de propósito: é ele que alimenta os painéis publicados. O CPF inteiro vai para uma tabela pequena em output/interno/movimentacoes_cpf.csv, gravada pelo pipeline, e a planilha interna junta as duas na hora de montar o arquivo.

Checklist antes de publicar#

1. A competência é a esperada?

   Confira no cabeçalho de qualquer painel.

2. O log tem WARNING?

   Coluna ausente e taxonomia incompleta aparecem lá.

3. Rodou as duas conferências?

   Chaves do reembolso e taxonomias, na aba Tabelas.

4. Os totais fecham?

   Cede e recebe têm de bater; o teto do reembolso tem de bater com a soma dos anexos da portaria.

5. Abriu um PDF e uma planilha?

   São os dois caminhos que mais quebram em silêncio.

6. Conferiu o arquivo publicado?

   Não só o gerado — a publicação altera a página.

A faixa etária parece atrasada, ou a legenda mostra uma data antiga#

A idade dos painéis de Anistiados e Pessoal é contada na data de processamento gravada pelo ETL em referencia.json (processado_em). Se você gerou o painel sem rodar o ETL antes, a data é a da rodada anterior — e a legenda do gráfico de faixa etária mostra exatamente qual. Rode o Pipeline ETL (ou Atualizar tudo) e gere o painel de novo. Sem referencia.json nenhum, o gerador avisa no log e usa a data de hoje.

Cadastrei uma base nova e ela não aparece na aba Tabelas#

A aba lê o registro src/referencias.py, não a pasta reference/. Cadastre a base lá (chave, título, quando mexer, quem lê, caminho padrão) e faça o consumidor ler o caminho por referencias.caminho("chave"). Aí ela aparece com os botões Abrir, Substituir e Apontar, e passa a aceitar repontamento.

O painel abre com o JavaScript aparecendo como texto#

Acontece só no arquivo publicado. Causa: a injeção do portão de login entrou no meio de um bloco de script. Verifique se algum texto do gerador contém um </body> ou <script> literal dentro de uma string JavaScript.

O relatório em PDF sai em branco, ou com folhas vazias no fim#

Regra de impressão. O conteúdo tem de estar em #pdf-doc, que precisa ser filho direto do <body>, e os irmãos dele têm de sair com display:none — visibility:hidden esconde mas mantém o espaço, e é isso que produz dezenas de folhas em branco.

A planilha não abre, ou o Excel pede para reparar#

Foi um defeito real e antigo: o gerador de XLSX escrevia o diretório central do ZIP com 44 bytes em vez de 46 (faltavam os dois bytes de “atributos internos”), e toda planilha do ecossistema saía corrompida. Corrigido. Se voltar a acontecer, valide abrindo o arquivo com openpyxl — baixar sem erro não prova nada.

Só consigo selecionar uma barra do gráfico#

O gráfico de uma dimensão está aplicando o filtro dela mesma — aí sobra uma barra só e não há o que clicar. Ele precisa aplicar todos os filtros menos o próprio.

Um órgão aparece com execução zero sem explicação#

Falta de-para entre SIAPE e SIOP. Rode Conferir chaves do reembolso: ele aponta a linha exata que falta, com o volume de dinheiro e de gente em jogo.

“Função fora da taxonomia” com volume alto#

Famílias de função que não estão na FUNÇÕES.xlsx. Rode Conferir taxonomias; com --csv ele grava a lista pronta para preencher.

O painel some do ar (404)#

Provavelmente está marcado como em revisão na aba “O que fica no ar” — nesse estado o arquivo é removido da pasta publicada de propósito.

O PDF sai com as letras grossas, e não dá para selecionar o texto#

O destino da impressão era o “Microsoft Print to PDF”. Esse driver recebe a página já desenhada e grava cada letra como traçado vetorial preenchido: não há fonte embutida, o texto engrossa e não se seleciona nem se busca. Escolha o destino “Salvar como PDF” do próprio Chrome/Edge — sai com a fonte de verdade, mais leve e pesquisável.

O texto do relatório encosta (ou passa) da borda do papel#

Acontece quando a impressão é feita com Margens: Nenhuma. Nessa opção o Chrome ignora o @page{margin:12mm} do painel e imprime até o fio do papel — e a impressora ainda tem 1 a 2 mm de área não imprimível, que come as últimas letras. Use Margens: Padrão.

Desde 21/09/2026 o relatório tem uma folga interna de 4 mm (no CSS compartilhado, _comum.py), que vale mesmo com margem zero — então o conteúdo não encosta mais na borda em nenhuma configuração. Painéis gerados antes dessa data precisam ser regerados para receber a folga.

“SEM ACESSO À TABELA DO FATO” (INSUFFICIENT_PERMISSIONS)#

Desde 15/09/2026 o retrato do servidor vem de mgi-ouro.bd_siape_delta.fatoservidor. Se o seu usuário não tem leitura nessa tabela, o Data Lake responde User does not have SELECT on Table. Não é defeito do pipeline: a equipe do Data Lake precisa rodar GRANT SELECT ON TABLE `mgi-ouro`.`bd_siape_delta`.`fatoservidor` para o seu usuário (e USE SCHEMA no schema, se faltar).

Enquanto isso: re-extrair (--atualizar) para logo no começo, sem baixar nada e sem tocar no cache; Completar cache segue com o retrato que está em cache e completa o resto; e a rodada sem re-extrair funciona normalmente — com o aviso de “cache de outra origem” no topo do log, que só some depois da primeira extração bem-sucedida da tabela nova.

Competência de referência

O mês do retrato do SIAPE em que o painel se baseia.

Vínculo

Uma matrícula. Uma pessoa pode ter mais de um.

Vigente

Vínculo que ainda existe no SIAPE — inclui aposentado e pensionista.

Ativo

Vínculo em situação funcional ativa. Inclui quem está cedido.

Força de trabalho

Quem está em exercício no próprio órgão. Exclui cedidos.

Órgão de lotação

Onde está o vínculo.

Órgão de exercício

Onde a pessoa efetivamente trabalha. Difere da lotação em ~4% dos casos.

UPAG

Unidade pagadora. Diz quem paga, não onde a pessoa está.

UORG

Unidade organizacional — a caixinha do organograma.

Proporcionalidade

A regra do §7º do art. 93: quem recebe para compor força de trabalho deve liberar na mesma medida.

Redistribuição

Deslocamento do cargo efetivo, com o servidor, de um órgão para outro (art. 37).

Cessão / requisição

A pessoa vai trabalhar em outro órgão; o cargo permanece no de origem.

Anexo I e II

Da portaria de reembolso: Anexo I são órgãos e entidades exceto agências reguladoras; Anexo II são agências reguladoras.

IHE

Índice Histórico de Execução — média do percentual do teto usado por ano.

CCE / FCE

Cargo Comissionado Executivo e Função Comissionada Executiva, que substituíram DAS e FCPE.

Alta liderança

Classificação da CGMOP: onde há equivalência ao DAS, corresponde a DAS 4, 5, 6 e Natureza Especial.

Sinc

Sistema Integrado de Nomeações e Consultas, onde fica a autodeclaração de que trata o Decreto 11.443.

Piso de anonimato

Regra do painel: gráfico demográfico não é desenhado abaixo de 10 pessoas no recorte.

Este documento é gerado. O conteúdo mora em manual/_conteudo1.py e manual/_conteudo2.py, em blocos declarativos — parágrafo, tabela, passo a passo, caixa de aviso. O layout mora em manual/_render.py.

cd C:\0_Desenvolvimento\Movimentacao_pessoal
python manual\gerar_manual_html.py    # este manual (HTML)
python manual\gerar_manual.py         # a versão .docx

O que precisa entrar aqui quando algo muda#

• Regra de negócio nova ou alterada → capítulo Conceitos que mudam o número.
• Norma nova → capítulo Base legal, e o painel onde ela aparece.
• Base de referência nova → cadastre em src/referencias.py (é isso que a põe na aba Tabelas) e descreva-a no capítulo As tabelas que a equipe mantém.
• Botão ou aba nova no assistente → capítulo O assistente, aba por aba, dizendo o que o botão faz e quando usar.
• Defeito que custou tempo para achar → capítulo Solução de problemas, com o sintoma primeiro. Quem procura socorro busca pelo sintoma, não pela causa.