Contagem de Tempo Automática

Nome sugerido

CONTATEM — Agente Inteligente de ******** de Tempo de Servidores

Subtítulo:
Automação, conferência e geração de ******** de Tempo para servidores da Educação.

Outras possibilidades:

TempoEdu IA
ContaTempo Educação
CTE Inteligente
ContaServidor IA
EduTempo
******** Fácil
2. Objetivo geral

Desenvolver um agente de inteligência artificial capaz de receber os dados funcionais de um servidor da Educação, interpretar as regras estabelecidas nos manuais e normativas aplicáveis, realizar automaticamente os cálculos de tempo de serviço e gerar a ******** de Tempo preenchida em modelo padronizado de Excel e/ou PDF.

O sistema deverá reduzir significativamente o trabalho manual, erros de digitação, erros de cálculo e inconsistências na montagem da documentação.

3. O problema que o agente irá resolver

Atualmente, a ******** de Tempo exige que o servidor responsável:

consulte os dados funcionais;
identifique os períodos trabalhados;
confira admissão;
identifique cargo/função;
identifique código do cargo;
confira alterações funcionais;
lance os períodos;
separe os anos;
calcule dias trabalhados;
desconte ou registre faltas;
registre licenças;
registre afastamentos;
faça as somas anuais;
faça a soma geral;
confira os resultados;
preencha o formulário;
revise;
gere o documento final.

Grande parte desse processo é repetitiva.

O agente deverá transformar isso em um fluxo semelhante a:

Dados do servidor → interpretação das informações → aplicação das regras → cálculos → conferência → Excel → PDF.

4. Conceito fundamental do sistema

Eu recomendo que o projeto tenha três componentes principais:

COMPONENTE 1 — IA

Responsável por:

interpretar documentos;
identificar informações;
entender regras;
localizar períodos;
interpretar documentos funcionais;
detectar informações incompletas;
explicar inconsistências;
solicitar informações que estejam faltando.
COMPONENTE 2 — MOTOR DE CÁLCULO

Responsável pelos cálculos matemáticos e regras objetivas.

Por exemplo:

Data inicial: 10/03/2020
Data final: 31/12/2020

O sistema calcula o período correspondente.

Mas o cálculo não deve ficar exclusivamente a cargo da IA.

O agente deve enviar os dados estruturados para um motor determinístico de cálculo.

Isso é extremamente importante.

COMPONENTE 3 — GERADOR DE DOCUMENTOS

Responsável por:

preencher o Excel oficial;
gerar PDF;
organizar tabelas;
preencher cabeçalho;
preencher campos funcionais;
inserir totais;
formatar o documento;
disponibilizar o arquivo final.
5. Fluxo ideal do agente

O usuário entraria no sistema e encontraria algo semelhante a:

NOVA ******** DE TEMPO

1. Identificação do servidor

Nome completo
CPF/matrícula
Cargo
Código do cargo
Órgão
******
Data de admissão
Número de admissão
Regime funcional
Situação funcional
2. Importação dos documentos

O usuário poderia enviar:

ficha funcional;
histórico funcional;
certidão;
contracheques, quando necessários;
relatórios;
documentos de afastamento;
documentos de licença;
planilhas;
PDFs;
documentos digitalizados.

Idealmente:

Arraste os documentos para esta área.

6. Leitura automática dos documentos

A IA faria OCR e extração dos dados.

Por exemplo, encontraria:

Servidor: **************
Cargo: Professor de Educação Básica
Admissão: 15/02/2018
Código: XXXXX
Lotação: ****** Estadual XXXXX

Depois identificaria os eventos:

Período Evento
15/02/2018 – 31/12/2018 Exercício
01/01/2019 – 31/12/2019 Exercício
10/05/2020 – 20/06/2020 Licença
01/01/2021 – 31/12/2021 Exercício
7. Base normativa e Manual do Secretário

Aqui está uma das partes mais importantes do projeto.

Você mencionou que existe um Manual do Secretário contendo as regras.

Esse manual deve ser transformado em uma base de conhecimento do agente.

O sistema deverá permitir carregar:

Manual do Secretário;
legislação;
resoluções;
instruções normativas;
orientações da ***/**;
modelos oficiais;
regras internas;
documentos complementares.

A IA não deverá simplesmente “memorizar” o manual.

Ela deverá utilizar uma arquitetura de RAG — Retrieval-Augmented Generation.

Em termos simples:

Quando precisar decidir como determinada situação deve ser tratada, o agente consulta a fonte normativa cadastrada e apresenta a regra utilizada.

8. Regra de ouro do agente

O sistema deverá seguir uma hierarquia de fontes.

Por exemplo:

1º — Legislação/norma vigente
↓
2º — Orientação oficial da Secretaria
↓
3º — Manual do Secretário
↓
4º — Modelo oficial de ******** de Tempo
↓
5º — Regras internas cadastradas

Caso existam informações conflitantes, o agente não deve escolher arbitrariamente.

Deverá informar:

⚠️ INCONSISTÊNCIA IDENTIFICADA

Foram encontradas duas orientações diferentes para o tratamento deste período.

Fonte A: ...

Fonte B: ...

É necessária conferência do responsável antes da emissão definitiva.

Isso é fundamental para um sistema utilizado em documentação funcional.

9. Cadastro das regras

O sistema deverá possuir uma área chamada:

"REGRAS DE ********"

Nela poderão ser cadastradas regras como:

forma de ********;
tratamento de ano bissexto;
início e término de período;
afastamentos;
faltas;
licenças;
férias;
licença-saúde;
licença-maternidade;
afastamento;
cessão;
designação;
exercício em cargo diferente;
mudança de cargo;
mudança de função;
interrupção;
readmissão;
períodos concomitantes;
sobreposição de períodos;
situações que contam;
situações que não contam.

As regras concretas deverão ser extraídas do manual e das normas oficiais que você fornecer ao projeto.

10. Linha do tempo funcional

Eu considero essa uma das melhores funcionalidades do projeto.

O agente deverá transformar os dados do servidor em uma linha do tempo funcional.

Exemplo:

2018
│
├── 15/02 — Admissão
│
└── 31/12 — Exercício

2019
│
├── 01/01 — Exercício
│
└── 31/12 — Exercício

2020
│
├── 01/01 — Exercício
├── 10/05 — Licença
├── 20/06 — Retorno
└── 31/12 — Exercício

2021
│
└── Exercício integral

Isso facilita muito a conferência.

11. Detecção de períodos sobrepostos

O agente deverá procurar automaticamente situações como:

Servidor consta trabalhando em determinado período e, simultaneamente, aparece em licença.

Ou:

Existem dois registros diferentes para o mesmo intervalo.

O sistema deverá emitir:

⚠️ POSSÍVEL SOBREPOSIÇÃO

Período 1: 10/03/2020 a 20/05/2020
Período 2: 01/05/2020 a 15/06/2020

Verificar documentação antes da emissão definitiva.

12. Motor de cálculo

Esta é a parte que eu considero mais importante tecnicamente.

Não recomendo deixar a IA responsável diretamente pelas contas.

O sistema deverá possuir um motor matemático próprio.

Ele receberá:

Data inicial
Data final
Tipo de período
Regra aplicável
Faltas
Afastamentos
Licenças
Outras ocorrências

E produzirá:

Dias do período
Dias computáveis
Dias não computáveis
Saldo
Total anual
Total geral
13. ******** ano a ano

O sistema deverá automaticamente dividir os períodos por exercício.

Por exemplo:

Ano Período Dias Ocorrências Dias computáveis
2018 15/02–31/12 XXX — XXX
2019 01/01–31/12 XXX — XXX
2020 01/01–31/12 XXX Licença XXX
2021 01/01–31/12 XXX — XXX

E ao final:

TOTAL GERAL: XXXXX dias

14. Faltas

O sistema deverá possuir uma área específica:

FALTAS
data;
período;
quantidade;
tipo;
justificativa;
situação;
se interfere ou não na ********;
fundamento normativo.

A IA poderá identificar as faltas nos documentos.

Mas o sistema deverá aplicar a regra correspondente.

15. Licenças

Área específica:

LICENÇAS/AFASTAMENTOS

Exemplo:

Tipo Início Fim Dias Tratamento
Licença XX/XX/XXXX XX/XX/XXXX XX Conforme regra
Afastamento XX/XX/XXXX XX/XX/XXXX XX Conforme regra

O agente deverá explicar:

"Este período foi tratado dessa maneira porque a regra X determina..."

16. Mudança de cargo

Outro ponto importante no seu caso.

O servidor pode ter:

Professor → Supervisor → Professor

ou:

Cargo A → Cargo B

O sistema deverá identificar cada período.

Exemplo:

Período Cargo Código Admissão
2015–2019 Professor XXX XXX
2020–2022 Supervisor XXX XXX
2023–atual Professor XXX XXX

Isso evita uma ******** genérica incorreta.

17. Múltiplas admissões

O sistema deverá permitir:

SERVIDOR COM MAIS DE UMA ADMISSÃO

Exemplo:

Admissão 1

Cargo;
código;
data;
período.

Admissão 2

Cargo;
código;
data;
período.

O agente deverá manter as admissões separadas e verificar possíveis concomitâncias.

18. Painel de conferência

Antes de gerar o documento final, o agente deverá apresentar:

CONFERÊNCIA DA ********
Dados funcionais

🟢 Nome identificado
🟢 Cargo identificado
🟢 Admissão identificada
🟢 Código identificado

Períodos

🟢 2018
🟢 2019
🟡 2020 — licença identificada
🟢 2021

Ocorrências

🟢 Faltas identificadas
🟡 1 período requer conferência

Cálculos

🟢 Total calculado
🟢 Soma anual conferida
🟢 Soma geral conferida

19. Nível de confiança

Outra funcionalidade muito interessante:

O agente poderia classificar os dados extraídos:

🟢 CONFIRMADO

Encontrado diretamente em documento oficial.

🟡 REQUER CONFERÊNCIA

Informação parcialmente identificada ou ambígua.

🔴 NÃO IDENTIFICADO

Informação necessária não encontrada.

Isso evita que o sistema preencha silenciosamente algo que não sabe.

20. Regra importantíssima: não inventar dados

O agente deverá ter uma regra sistêmica:

Nunca preencher informação funcional que não esteja presente nos documentos ou fornecida pelo usuário.

Se faltar:

Código do cargo

o sistema deverá dizer:

"Código do cargo não localizado nos documentos fornecidos."

E solicitar o dado.

21. Formulário Excel

Ao final, o agente deverá utilizar um modelo Excel oficial/padrão.

Por exemplo:

******** DE TEMPO DE SERVIÇO

SERVIDOR:
CPF:
MASP/MATRÍCULA:
CARGO:
CÓDIGO:
ÓRGÃO:
******:
DATA DE ADMISSÃO:

------------------------------------------------

ANO | PERÍODO | CARGO | CÓDIGO | DIAS | FALTAS | LICENÇAS
------------------------------------------------

**********
TOTAL:

O sistema deverá preservar:

cabeçalho;
logotipo;
formatação;
bordas;
fórmulas;
campos;
assinaturas;
rodapé.
22. Geração do PDF

Depois da conferência:

GERAR DOCUMENTO

☑ Excel
☑ PDF
☐ Excel + PDF

O sistema produziria automaticamente:

Contagem_Tempo_Joao_Silva.xlsx

e

Contagem_Tempo_Joao_Silva.pdf

23. Sistema de auditoria

Essa funcionalidade será muito importante.

O sistema deverá guardar:

quem realizou a ********;
data;
documentos utilizados;
regras utilizadas;
alterações feitas;
cálculo anterior;
cálculo final;
versão do documento.

Por exemplo:

******** nº 000145

Servidor: ***********
Responsável: *****************
Data: 29/09/2026
Versão: 03

24. Explicação de cada cálculo

O agente deverá permitir clicar em:

"Como esse total foi calculado?"

E mostrar algo como:

Total de 3.421 dias

2018 = XXX dias
2019 = XXX dias
2020 = XXX dias
2021 = XXX dias
2022 = XXX dias

(-) Períodos não computáveis = XXX dias

Total líquido = 3.421 dias

Isso é excelente para conferência humana.

25. Interface do usuário

Eu faria uma interface muito simples.

Tela inicial

CONTATEM IA

******** Inteligente de Tempo de Servidores

[ + NOVA ******** ]

[ Consultar Contagens ]

[ Base Normativa ]

[ Modelos ]

[ Configurações ]

26. Nova ********
ETAPA 1

Identificação

ETAPA 2

Documentos

ETAPA 3

Análise automática

ETAPA 4

Conferência

ETAPA 5

Cálculo

ETAPA 6

Revisão

ETAPA 7

Gerar documento

Uma barra mostraria:

1 → 2 → 3 → 4 → 5 → 6 → 7

27. Chat interno

Além da interface tradicional, você poderia conversar com o agente.

Por exemplo:

*********: Faça a ******** desse servidor.

O agente:

Identifiquei 3 documentos e uma ficha funcional.

Encontrei:

2 admissões;
1 mudança de cargo;
2 períodos de licença;
1 período que necessita conferência.

Deseja que eu prossiga?

Você:

Sim.

Agente:

******** calculada. O total preliminar é de XXXX dias. Há uma inconsistência no período de XX/XX/XXXX a XX/XX/XXXX.

28. Base de conhecimento

O projeto deverá possuir uma estrutura semelhante a:

BASE NORMATIVA
│
├── Manual do Secretário
├── Legislação Estadual
├── Resoluções
├── Instruções Normativas
├── Orientações ***/**
├── Modelos oficiais
├── Regras de ********
└── Perguntas frequentes
29. Tecnologia recomendada

Para uma primeira versão profissional, eu recomendaria uma arquitetura como:

Front-end

Next.js / React

Interface web.

Back-end

Python + FastAPI

Excelente para:

cálculos;
processamento de documentos;
Excel;
PDF;
IA.
Banco de dados

PostgreSQL

Para armazenar:

servidores;
contagens;
períodos;
regras;
usuários;
documentos;
histórico.
IA

Um modelo de linguagem moderno para:

interpretação;
extração;
classificação;
consulta à base normativa;
explicação.
RAG

Banco vetorial para consultar:

Manual;
legislação;
orientações;
documentos.
OCR

Para documentos digitalizados.

Excel

Biblioteca para:

abrir modelo;
preencher células;
manter formatação;
gerar fórmulas;
criar arquivo final.
PDF

Gerador de PDF baseado no modelo oficial.

30. Arquitetura resumida

Eu desenharia assim:

USUÁRIO
│
▼
INTERFACE WEB
│
▼
AGENTE IA
│
┌───────────┼───────────┐
▼ ▼ ▼
DOCUMENTOS REGRAS DADOS
│ │ │
▼ ▼ ▼
OCR RAG BANCO DE DADOS
│ │ │
└───────────┼───────────┘
▼
MOTOR DE ********
│
▼
MOTOR DE VALIDAÇÃO
│
▼
CONFERÊNCIA HUMANA
│
▼
GERADOR DE DOCUMENTO
│ │
▼ ▼
EXCEL PDF
31. O ponto mais importante: IA + regras determinísticas

Eu faria uma divisão muito clara:

IA

Pode:

ler;
interpretar;
localizar;
classificar;
explicar;
perguntar;
identificar inconsistências.
Sistema matemático

Deve:

contar dias;
somar períodos;
subtrair períodos;
verificar sobreposição;
dividir por ano;
calcular totais;
validar datas.
Humano

Deve:

conferir;
corrigir;
aprovar;
emitir definitivamente.

Essa arquitetura é muito mais segura do que simplesmente pedir:

"ChatGPT, faça a ******** de tempo."

32. Segurança e LGPD

Como o sistema trabalhará com informações funcionais de servidores, deverá ter preocupação com proteção de dados.

Recomendo:

login;
senha;
controle de acesso;
criptografia;
registro de acesso;
armazenamento seguro;
política de retenção;
controle de documentos;
backups;
histórico de alterações.

E principalmente:

A IA não deve utilizar dados de um servidor para responder ou preencher informações de outro servidor.

33. Diferencial que eu acrescentaria

Criaria um botão:

🔍 "AUDITAR ********"

Depois de gerar o documento, o sistema faria uma segunda análise independente.

Ele verificaria:

datas;
períodos;
soma;
duplicidade;
sobreposição;
campos vazios;
cargo;
código;
admissões;
faltas;
licenças;
total anual;
total geral.

E retornaria:

RESULTADO DA AUDITORIA

🟢 97% dos campos conferidos
🟢 Cálculos matemáticos conferidos
🟢 Nenhuma sobreposição identificada
🟡 1 informação necessita conferência humana

Isso elevaria bastante a qualidade do projeto.

34. Versão inicial — MVP

Não tentaria construir tudo de uma vez.

A primeira versão poderia fazer somente:

MVP 1

Entrada:

ficha funcional;
manual;
modelo Excel.

Processamento:

leitura;
identificação do servidor;
identificação da admissão;
identificação do cargo;
identificação dos períodos;
cálculo;
conferência.

Saída:

Excel preenchido;
PDF.

Depois acrescentaria:

V2
múltiplas admissões;
afastamentos;
licenças;
faltas;
sobreposições.
V3
banco histórico;
auditoria;
painel;
assinatura;
controle de usuários.
V4
integração com sistemas existentes, se houver API/autorização;
importação automática de dados;
processamento em lote.
35. Exemplo de funcionamento completo

Imagine que você receba:

Servidor: **************

Você simplesmente envia:

📎 Ficha ************
📎 Histórico.pdf
📎 Documento de ************

O agente responde:

ANÁLISE CONCLUÍDA

Servidor: **************

Admissões identificadas: 2
Cargos identificados: 2
Períodos analisados: 2015–2026
Licenças identificadas: 3
Faltas identificadas: 7
Sobreposições: 1

⚠️ Existe uma divergência no período de 12/05/2020 a 30/05/2020.

Deseja revisar?

Você corrige:

O período correto termina em 28/05/2020.

O agente recalcula.

Depois:

******** ATUALIZADA

Total bruto: XXXX dias
Períodos não computáveis: XX dias
Total computável: XXXX dias

✔ Cálculos conferidos
✔ Períodos conferidos
✔ Regras aplicadas

Gerar documento?

Você:

Sim. Excel e PDF.

E o sistema gera os dois.

36. O que você precisará fornecer ao desenvolvedor

Para transformar essa ideia em um sistema real, eu começaria reunindo cinco coisas:

1. Manual do Secretário

O documento que você mencionou.

2. Modelo real da ******** de Tempo

Preferencialmente o Excel que vocês utilizam atualmente.

3. Exemplos reais

Idealmente alguns casos anonimizados:

******** simples;
servidor com licença;
servidor com faltas;
servidor com mudança de cargo;
servidor com mais de uma admissão;
caso problemático.
4. Normas utilizadas

Legislação e orientações que vocês realmente consultam.

5. Fluxo atual

Explicar:

"Hoje eu recebo isso → consulto isso → faço isso → calculo isso → preencho aquilo → confiro dessa maneira."

Isso permitirá ao desenvolvedor transformar seu conhecimento prático em regras do sistema.

37. Um detalhe muito importante

Eu não começaria pelo desenvolvimento do agente.

Começaria pela engenharia das regras da ******** de Tempo.

Ou seja:

FASE 1 — MAPEAR O PROCESSO

Pegamos o Manual do Secretário + seu modelo de Excel + exemplos reais.

Depois construímos uma matriz:

Situação Regra Conta? Como calcular? Fonte
Exercício normal Regra X Sim ... Manual
Falta Regra Y ... ... Norma
Licença Regra Z ... ... Norma
Afastamento ... ... ... ...

Essa matriz será o "cérebro operacional" do sistema.

Depois disso, a IA fica muito mais fácil de desenvolver.

38. Resultado final esperado

O projeto deverá entregar algo muito próximo de:

"Envie os documentos do servidor e receba a ******** de Tempo pronta, calculada, conferida e formatada."

Com a ressalva fundamental:

A emissão definitiva deve continuar sob responsabilidade do servidor responsável, com conferência humana antes da assinatura/uso oficial.

39. Minha recomendação para o seu caso

Pelo tipo de trabalho que você descreveu, eu não faria inicialmente um aplicativo enorme.

Eu desenvolveria um Agente Especializado de ******** de Tempo para a Secretaria/******, inicialmente para uso interno.

O projeto poderia começar como:

CONTATEM IA

******** Inteligente de Tempo de Servidores

Entrada: documentos + informações do servidor
↓
IA: interpretação dos documentos
↓
RAG: consulta ao Manual/legislação
↓
Motor: cálculo determinístico
↓
Auditoria: conferência automática
↓
Servidor responsável: validação
↓
Saída: Excel + PDF

Esse desenho tem potencial para economizar muito trabalho repetitivo e, principalmente, transformar um procedimento que hoje depende bastante de conhecimento individual em um processo padronizado e auditável.