# Catálogo inicial de indicadores do SGC

Versão de definição 1, 30/10/2026. Indicadores factuais, sem modelo de machine learning. Cada painel respeita a autorização do servidor e os filtros em vigor. Âmbito vazio significa ausência de registos visíveis nesse filtro, não ausência de actividade na empresa. Os painéis não combinam dados de Compras com candidaturas.

## Compras — Relatórios de compras (`/relatorios`)

Método `procurement_facts_v1`, mesmo snapshot de leitura do relatório. O período filtra a criação da requisição, não a data de submissão ou a execução. Contagens incluem todas as páginas. Origem: requisições autorizadas por empresa/departamento, propostas registadas e ordem visível. Actualização ao consultar/aplicar filtros; não há actualização automática em segundo plano.

| Indicador                          | Definição e base                                                                                                                               | Limite de interpretação                                                                                 |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| Requisições no âmbito              | Todos os pedidos visíveis que satisfazem os filtros                                                                                            | Não representa necessariamente toda a empresa                                                           |
| Em aprovação                       | Estado actual `pending`                                                                                                                        | Não é uma fila pessoal nem autorização para decidir                                                     |
| Antiguidade de submissão           | Dias de calendário entre submissão e instante de leitura, no fuso configurado da aplicação; até cinco pendentes mais antigos, desempate por ID | Não mede a duração da etapa actual; não estima prazo de conclusão                                       |
| Antiguidade desconhecida           | Pendentes sem submissão registada ou com data de submissão num dia futuro                                                                      | Não substitui a data de submissão pela criação nem inventa duração                                      |
| Data de necessidade ultrapassada   | `draft`/`pending` com `needed_by` anterior ao dia da leitura                                                                                   | Data de necessidade do requisitante não é prazo contratual de entrega; hoje não conta como ultrapassado |
| Aprovadas sem propostas registadas | Aprovadas com contagem de propostas igual a zero, denominador: aprovadas do filtro                                                             | Uma proposta registada não é necessariamente válida ou comparável                                       |
| Aprovadas sem ordem visível        | Aprovadas sem ordem encontrada pela mesma projecção autorizada do relatório                                                                    | Não prova incumprimento ou inexistência absoluta; pode sobrepor-se à ausência de propostas              |

As ligações das submissões antigas abrem o processo original e reaplicam a sua autorização. Relatório e exportação CSV anteriores conservam a sua estrutura; os novos indicadores são apresentados no painel, não acrescentados silenciosamente ao contrato do CSV.

## Pessoas e contratações (`/pessoas`)

Método `operational_facts_v1`, mesmo instante e snapshot da fila pessoal autorizada. Filtros por percurso, estado, título/referência e criação. Origem: processos visíveis, tarefas possíveis para o interveniente, aprovações independentes e esclarecimentos pendentes. Actualizar ou voltar a consultar para reflectir intervenções posteriores.

| Indicador                 | Definição e base                                                                               | Limite de interpretação                                                       |
| ------------------------- | ---------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| Processos no âmbito       | Processos visíveis nos filtros, todas as páginas                                               | Não equivale ao universo da organização                                       |
| Prazos vencidos           | Ocorrências de recepção ou esclarecimento ainda pendentes com prazo anterior à data de leitura | Várias ocorrências podem pertencer ao mesmo processo                          |
| Processos com vencimentos | IDs distintos nas ocorrências vencidas                                                         | Distingue carga de ocorrências de quantidade de processos                     |
| Maior atraso              | Maior diferença em dias de calendário nas ocorrências; nulo quando não existem                 | Não determina resultado de candidatura; dias corridos, sem calendário laboral |
| Tarefas por acção         | Contagem das acções disponíveis à pessoa na sua fila                                           | Não classifica desempenho de trabalhadores ou candidatos                      |
| Tarefas sem prazo próprio | Tarefas cuja data da fila é nula                                                               | Ausência de prazo não indica incumprimento                                    |
| Aprovações                | Intervenções formais pendentes para as quais o actor é elegível e independente                 | Separadas de tarefas operacionais e de conferência de esclarecimentos         |

## Evolução e qualidade

Não foram definidos limiares organizacionais, metas ou semáforos novos. Quando necessários, serão parametrizados pela empresa, versionados e acompanhados de denominador, vigência e origem. A integração futura de IA deve citar estes conceitos e os documentos autorizados, sem transformar contagens factuais em previsões ou juízos não demonstrados.