Files
compras/docs/reutilizacao-dados.md
2026-10-30 20:52:10 +02:00

10 KiB

Registar uma vez e reutilizar no SGC

Requisito do proprietário, 30/10/2026. Cadastros são fontes reutilizáveis; cada processo conserva a referência, versão e os valores usados. Só se introduz informação nova da etapa. A reutilização respeita empresa, permissões e os roteiros separados de Compras e Pessoas e não depende de IA.

Incremento disponível — Pessoas

Menu Pessoas e contratações > Cadastro reutilizável de pessoas (/pessoas/cadastro). Guarda nome, referência própria e resumo do perfil. A referência pode ser introduzida ou gerada no primeiro registo. Permite pesquisar, corrigir por nova versão e arquivar/reactivar. Nomes iguais não causam fusão automática; a referência normalizada é única dentro da empresa.

Na recepção de uma candidatura, pode guardar o primeiro perfil no mesmo acto e seleccioná-lo nos processos seguintes. Ao seleccionar, o servidor usa nome/perfil e versão do cadastro autorizado, sem aceitar um nome forjado pelo cliente. O resumo pode receber informação específica dessa candidatura, sem actualizar o cadastro por arrasto. Referência documental da candidatura, data de recepção e fundamento são dados do evento, distintos da referência de cadastro.

A candidatura guarda person_id e person_snapshot; a matriz/relatório identifica referência e versão utilizadas. Mudar o perfil ou arquivá-lo afecta novos usos, não os nomes, resumos, notas ou decisões anteriores. Cadastro alterado entre selecção e gravação exige nova conferência da versão. Uma pessoa não pode receber duas candidaturas ligadas no mesmo processo, mesmo com referências documentais diferentes. Pode participar em processos distintos e nos dois percursos.

Quem prepara processos consulta/reutiliza os perfis que criou. A empresa pode outorgar people_registry_read para consultar o cadastro partilhado e people_registry_manage para o gerir. Ser administrador, por si só, não revela os perfis registados por outros nem concede acesso a processos individuais. As permissões do processo continuam a controlar candidaturas, entrevistas, finanças e minutas. Cadastro não inclui avaliações, resultados ou histórico de processos de outras equipas. Manutenção continua sem comandos de escrita.

Registos sem vínculo de cadastro continuam em compatibilidade; não foram ligados, fundidos ou importados automaticamente. A opção de registo apenas no processo permanece explícita. Antes de migrar históricos, é necessário reconciliar identidade e autorizações; nomes iguais não são prova de identidade. O cadastro actual não é um módulo completo de RH nem cria contas de utilizador automaticamente.

Matriz transversal de cobertura

Actualização de 30/10: o perfil externo admite vários locais de disponibilidade. A candidatura reutiliza um local guardado e conserva todos os locais da versão enviada. CV/documentos já podem acompanhar a submissão, com formato e limites do formulário preservado; o comprovativo e a recepção interna usam os mesmos anexos privados e hashes, sem novo carregamento pela equipa. Complementos e reutilização de um documento noutra candidatura ainda exigem um percurso próprio; não se associa um ficheiro de outra pessoa ou empresa por nome. Esta actualização substitui a indicação de anexos por desenvolver na linha de perfil externo abaixo.

Percurso Reutilização observada/implementada Evolução ainda necessária
Empresa, utilizadores, departamentos e centros Identificadores seleccionados; contexto do actor usado nos pedidos; regras preservadas nos processos Conferir reutilização de campos em todos os documentos e associações de funções/unidades
Fornecedor → proposta → adjudicação/ordem Cadastro por ID e linhas/fonte herdadas; dados preservados na emissão Inventariar referências/documentos repetidos e uniformizar selecção de evidências
Requisição → proposta → ordem Catálogo de artigos publicados pelo armazém/administração para insumos/outros bens; descrição, categoria, unidade e tipo vêm da fonte; versão preservada por linha e na ordem Equipamento/peças mantêm roteiro técnico; serviços continuam manuais; conferir referências documentais repetidas
Ordem → recepção/factura Linhas, fornecedor e valores de origem usados; artigo do catálogo identificado automaticamente na recepção; quantidades e datas são novos eventos Conferir os restantes formulários e associações sem reintrodução de descrições
Pessoas → candidaturas → avaliação/selecção Novo cadastro reutilizável, selecção autorizada e snapshot por candidatura; avaliações usam a mesma candidatura Reconciliação assistida dos históricos e campos de cadastro adicionais quando forem definidos
Perfil externo → candidatura electrónica → avaliação Perfil versionado com disponibilidade província/distrito/localidade; respostas pré-preenchidas e comprovativo preservado; aceitação explícita para análise aproveita nome/resumo/referência/data na candidatura interna e identifica a fonte/versão Anexos verificados, complementos/revisões, modalidades espontâneas e eventual inclusão em cadastro por decisão própria; não fundir por nome
Minutas/modelos de documentos Processos e decisões preservam os seus dados; minuta interna de Pessoas ainda recebe termos específicos Modelos versionados por empresa e preenchimento de variáveis por fontes autorizadas, mantendo termos novos editáveis
Relatórios, indicadores e sínteses Derivam dos registos originais autorizados, sem novo preenchimento Conferir cobertura funcional e visual de todos os relatórios; não confundir síntese com nova evidência

Critério para fechar cada lacuna

Identificar a fonte única, seleccionar por ID autorizado, pré-preencher os valores existentes e pedir apenas os novos. Guardar a versão usada no evento e distinguir correcção do cadastro de correcção do documento. Testar actualização posterior, duplicados, permissões, outra empresa e preservação do histórico. Não declarar o requisito integralmente concluído enquanto as lacunas da matriz permanecerem por conferir.

Instalação e provas

Catálogo de requisições: em Armazém > Existências, abrir «Catálogo para requisições» (/stock/catalogo). Publicação explícita por artigo existente, categoria/tipo, motivo e versão; solicitantes só recebem código/nome/unidade/categoria/tipo publicados da sua empresa, sem saldos. Alteração do artigo exige conferir e republicar para novos usos; rascunhos mantêm a versão anterior ou permitem seleccionar explicitamente a nova. Quantidade, preço e IVA pertencem ao pedido. Não há publicação automática nem duplicação de cadastro. A ordem conserva a origem e a recepção preenche o artigo correspondente, rejeitando substituição por outro ID. Novos comandos continuam sujeitos às permissões e auditoria usuais.

Migração 000035 instalada apenas em 8005, com backup/restauro fresco e conteúdos das 94 tabelas anteriores conferidos. Catálogo inicialmente vazio; linhas antigas sem vínculo. Provas proofs/requisition-catalogue.json, requisition-catalogue-pg.json e requisition-catalogue-install.json. Sem IA, contas/grants novos, importação histórica ou instalação no domínio. Modelos documentais versionados e reconciliação assistida dos históricos continuam pendentes.

Migração 000034 apenas na avaliação local 8005: nova tabela inicialmente vazia, duas colunas nulas em candidaturas antigas, vínculo composto por empresa e unicidade por pessoa/processo. Protecções de imutabilidade das candidaturas preservadas em PostgreSQL e restauradas após reconstrução da tabela SQLite. Backup/restauro e conteúdos anteriores das 93 tabelas conferidos. Sem contas, atribuições, importação de pessoas ou alterações de decisões. Provas proofs/people-registry-install.json, people-registry-pg.json e people-registry.json. Conferência visual e publicação no domínio continuam pendentes.