Files
compras/AGENTS.tecnico.md
T
nala 12dd6df28a
tests / ci (push) Waiting to run
commit melhorias compras1
2026-11-21 21:04:40 +02:00

181 lines
37 KiB
Markdown

# Orientações permanentes do SGC
- Continuação autorizada de10/11/2026: ecrã/persistência do envioSGF entregues, ver `docs/sgf-invoice-workspace.md`. Migração000001 de10/11 preparada, NÃO aplicada ao piloto; duas tabelas novas só no livro QA existenteb4093c6f6707. Configuração workspace/transporte false, ligações vazias. Rascunho/intent/decisão/recibo auditados, estado cifrado, eventos append-only, SQL25/25, fonte/mapeamento/version/operador/contexto revalidados, lease120s com commit local antes da rede, recuperação conservaUUID/cut. Writer nativo bloqueia documento reservado mesmo desligado; não reenviarInvoice local nem criar dívida/stock/pagamento paralelo.20 casos únicos/142 asserções SQLite e14 verificações PG entre kernels/processos no receptorQAda77bb730751, sem servidor/base/role/demo nova. Duas facturas pendentes no receptor; dados/sequências antigos da origem e8085 intactos. Tipos/TSX privado/Blade passaram; sem build/activação de assets do piloto, nova conta/concessão/MFA/publicação/checkpoint. Novo pacote inactivo3bb99e866f52965dbb7d; instalação/configuração/activação exigem decisão própria. Ecrã/persistência já não pendentes no âmbito anterior; preservar provas e trabalho alheio.
- Preparação expressa de10/11/2026 para SGC→SGF8085, sem activar/publicar: ver `docs/sgf-invoice-preparation.md` e `C:/laragon/www/sgf-tempo/docs/SGC_8085_INTEGRATION_PREPARATION.md`. `SgfInvoiceGateway` e configuração novos, desligados, pacote/hashNULL/ligações vazias; sem listener/job/rota, migração, segredo ou concessão. Cliente portátil aceita só `unregistered_draft`/autoridade SGF única e mapeamentos explícitos; não reenviar `Invoice` já registadas ou duplicar autoridade financeira.16 Unit/46 asserções e seis verificações de contrato no livro de regressão SGF existente; sem comandos no piloto ou8085. Persistência/ecrã de envio/decisão/recibo ainda necessários antes de utilizar; não presumir instalação ou activação por existir gateway/pacote preparado. Preservar workflows, configurações, dados, MFA/geografia e demais aprovações existentes.
## G7 — disponibilidade recebida na ficha/dossiê de Pessoas — 03/11/2026
Sem migração: ReceivedCandidateAvailability acrescenta metadados de disponibilidade à PeopleProcessProjection, só para quem já pode consultar fontes electrónicas (CandidateTriage.canRead), relendo o utilizador actual. Usa snapshot da submissão aceite e ligação de triagem por empresa/processo; whitelist sem email/telefone/documentos/respostas. Página e dossiê partilham redacção. NUNCA acrescentar este campo a PeopleHiring.matrix ou linhas congeladas de selecção: decisões, pontuações, critérios e aprovações permanecem intactos. Não inferir localidades de candidaturas manuais. Fontes antigas mantêm texto/edição mesmo com catálogo desligado. Não criar processos/portais/contas no piloto por inferência. G3 continua pendente; MFA desligado. Docs/disponibilidade-recebida-processo-sgc.md;provas received-availability[-pg/-http/-pilot].json.
## G6 — consulta territorial das candidaturas recebidas, sem migração — 03/11/2026
Filtro opcional na caixa electrónica de Pessoas usa referências principal/adicionais do snapshot submetido, nunca perfil actual ou associação por nomes. Respeita empresa/processo e CandidateTriage.canRead; catálogo próprio no contexto Pessoas, sem abrir Compras ou conceder acessos. Paginação20 mantém território e foco submission; pendências/triagem/avaliações/aprovações continuam globais ao processo. Sem alteração de dados recebidos, exportação pessoal ou novas migrações. SQLite/PostgreSQL; demais motores conservam caixa sem este filtro. Provas candidate-territory[-pg/-pilot/-http].json e docs/territorio-candidaturas-recebidas-sgc.md. Não criar processos/portais/candidatos no piloto para demonstrar. MFA desligado e G3 continua pendente de autorização.
## G5 — disponibilidades adicionais com cartografia, sem migração — 03/11/2026
Até20locais adicionais do perfil reutilizam a cartografia e o selector de G4. Referências em lista separada noJSON da versão, alinhada com os objectos de três campos existentes;null conserva modo manual. Servidor valida referência e resolve nomes; duplicados/limites/versões e snapshots nativos mantidos. Pedidos antigos só conservam referências já conhecidas para textos inalterados,mesmo após reordenação;sem inferir novos códigos. Retirar local retira referência,sem reescrever versões/candidaturas. Não abrir portais ou criar candidatos no piloto por inferência. MFA desligado,G3 continua pendente. Docs/geografia-disponibilidades-adicionais-sgc.md;provas candidate-additional-geography[-pg/-pilot/-http].json.
## G4 — geografia do candidato sem migração — 03/11/2026
Disponibilidade principal do perfil pode reutilizar o catálogo até à localidade,com referência noJSON versionado e nomes resolvidos no servidor. Textos antigos não são classificados automaticamente; G5 estende a escolha explícita aos locais adicionais. Endpoint exige candidato da empresa e sessão actual,sem direitos de funcionário. Formulários/candidaturas reutilizam a disponibilidade e conservam snapshots/versões/triagem/aprovações. Não configurar ou abrir portal,nem criar contas no piloto para demonstrar por inferência. Piloto tem zero portais/contas/perfis de candidato; provas positivas só descartáveis. MFA desligado e G3 continua pendente de autorização. Documentação docs/geografia-candidatos-sgc.md;provas candidate-geography[-pg/-pilot/-http].json.
## G3 — geografia operacional preparada, instalação pendente — 03/11/2026
Desenvolvimento de localização administrativa em armazéns/equipamentos implementado reutilizando catálogo e selector, sem converter áreas ou históricos. Migração000005 acrescenta apenas warehouses/equipment.geography_reference anulável. Opção SGC_OPERATIONAL_GEOGRAPHY_ENABLED separada, desligada por defeito e no piloto; G1 da sede/fornecedores continua activo. Preparação em cópia restaurada114tabelas,111protegidas e colunas anteriores dos dois cadastros conferidas,campos novosNULL,base removida;nenhuma migração no piloto. Proposta docs/proposta-instalacao-geografia-operacional.md ainda exige autorização própria: a instalação anterior abrangia só sede e fornecedores. Não migrar/activar por inferência,nem alterar MFA,aprovações,stock,contas,políticas ou SGF.
## Divisão administrativa — instalada e activa no piloto com autorização — 03/11/2026
O proprietário autorizou explicitamente instalar apenas tenants.geography_reference e suppliers.geography_reference vazios e activar a selecção, preservando moradas, aprovações e MFA desligado. Aplicada apenas migração000004, com cópia consistente/restauro de114tabelas,111tabelas protegidas e todas as colunas anteriores de empresas/fornecedores conferidas. Ambas as referências continuam NULL em todos os cadastros. SGC_GEOGRAPHY_ENABLED=true apenas na configuração privada do piloto8005; valor por defeito noutros ambientes continua false. Não repetir instalação nem pedir novamente esta autorização. Provas administrative-geography-installation[-authorization/-pilot/-http].json e administrative-geography-activation.json.
Catálogo preserva20407linhas,9678seleccionáveis e10729pendentes; edição não confirmada, origem INE conforme indicação do proprietário. G2 acrescenta consulta administrativa e CSV filtrado, só de leitura, para revisão das inconsistências, sem resolver ambiguidades por inferência. Não converter moradas, classificar fichas, alterar a fonte ou activar MFA. Propostas de cancelamento e Auditoria6/8 continuam pendentes. Outros cadastros reutilizam serviço/selector; não criar clientes/facturação ou integrar SGF por inferência.
## Cancelamento de ordens — implementação autorizada, piloto desligado — 03/11/2026
O proprietário autorizou implementar o âmbito de docs/proposta-cancelamento-ordens.md,sem activar o circuito no piloto,cancelar ordens ou publicar políticas. Preservar aprovações e MFA desligado. Nova estrutura000003 e capacidade de reversão são desenvolvimento/testes descartáveis; não migrar/activar por esta autorização. AcessoAuditoria6/8 continua pendente,não foi autorizado pela continuação. Não pedir novamente autorização para implementar este âmbito;instalação/activação e operações persistentes têm recorte próprio.
## Estrutura MFA instalada, capacidade desligada — 03/11/2026
O proprietário autorizou explicitamente instalar só os três campos MFA vazios,sem mudar palavras-passe,perfis ou aprovações. Aplicada exclusivamente2026_11_03_000001;backup/restauro114tabelas,112tabelas protegidas e colunas antigas das12contas conferidas;novos campos todosNULL. Provas mfa-pilot-schema-authorization/installation.json. Não repetir a instalação nem solicitar de novo esta autorização. MFA continua desligado;activação,inscrições,credenciais e recuperação não foram autorizadas. Continuar os próximos blocos internos sem alterar decisões do piloto.
## Recepção documental instalada — 03/11/2026
O proprietário autorizou expressamente instalar o bloco documental no piloto8005 e continuar os blocos seguintes. Aplicada apenas 2026_11_03_000002_create_receipt_documents.php; backup/restauro113tabelas,112tabelas de negócio preservadas,nenhum documento de negócio criado. Provas receipt-block-installation[-http].json. Não repetir a instalação nem pedir de novo esta autorização. MFA e restantes migrações não estão autorizadas por esta instalação; aprovações/adjudicação/encomenda conservam os limites anteriores. Próximo bloco R2: reprodução imprimível da recepção reutilizando confirmação,qualidade,estornos e referências documentais.
## Desenvolvimento por blocos funcionais — 03/11/2026
O proprietário concordou em concluir blocos de funcionalidades por módulo e depois fechar a integração por percurso, evitando ciclos sucessivos de pequenos filtros/consultas e repetição de baterias. Plano corrente em docs/plano-entregas-sgc.md. Reutilizar contratos e motores existentes desde a construção; não adiar isolamento, idempotência, stock ou aprovações. Durante o bloco, verificações dirigidas necessárias; uma validação integrada no fecho. Código, instalação, activação e aceitação mantêm estados distintos. Não reabrir decisões do piloto nem activar políticas/conceder acessos por inferência.
## Ciclo contabilístico comum sintético autorizado — 02/11/2026
O proprietário respondeu «Autorizar o ciclo sintético proposto» ao recorte `C:/laragon/www/sgf-tempo/docs/GENERAL_LEDGER_COMPLETE_SYNTHETIC_SCOPE.md`, incluindo adaptador autónomo SGC, afectação/reversãoQA20 sobre obrigação60, par correctivo integral e fecho do período artificial, com direitos só em novas fixtures55439. Implementação/provas em `docs/contabilidade-ciclo-sintetico.md`; demo próprio8051, sem substituir/activar pacote instalado, piloto8005, candidatas ou dados/acessos reais. Reabertura, execução monetária, fiscalidade/contas reais, publicação, aceitação e checkpoint continuam excluídos. Preservar todo o trabalho paralelo e as autorizações do piloto abaixo; não repetir decisões já aplicadas.
## Seis avaliações fictícias autorizadas e aplicadas — 02/11/2026
O proprietário autorizou expressamente seis avaliações com notas neutras5/10 pelas contas existentes12(Finanças)e10(chefe de departamento),sem seleccionar fornecedor nem encomendar. Aplicadas uma única vez às21:09:06UTC às propostas2/3/4 da requisição2;registos1a6. Comparação pronta para conferência humana por Compras11,sem decisão automática. Provas pilot-evaluation-authorization/activation/activation-http.json. Backup/restauro113tabelas,111tabelas protegidas conferidas,sem novas contas/grants,stock,compromisso ou alteração SGF. Não reaplicar avaliações ou autorizações anteriores. Os estados pendentes/zero avaliações abaixo são históricos. A proposta original permanece preservada por hash;autorização/aplicação efectiva em provas separadas. Continuar desenvolvimento e integração interna;selecção,adjudicação e encomenda continuam fora desta autorização.
## Continuação técnica — 02/11/2026
O proprietário reiterou «contina a desenvolver e a integrar so pare quando precisr de autorização» depois da proposta de seis avaliações fictícias. Esta continuação não autoriza por si as avaliações expressamente excluídas na autorização anterior. Manter pilot-evaluation-proposal.json pendente e prosseguir desenvolvimento/integração/testes independentes, sem repetir confirmações técnicas nem transformar esse passo do piloto em bloqueio geral do desenvolvimento. As etapas de acesso, reposição, submissão, aprovação e três propostas já autorizadas/aplicadas não devem ser reaplicadas ou submetidas novamente a autorização.
## Consulta sintética autorizada e aplicada — 02/11/2026
O proprietário autorizou criar e validar2fornecedores fictícios e registar3propostas, sem avaliar/seleccionar/encomendar. Aplicado às19:56:43UTC apenas em8005: fornecedores2/3 preparados por11,activados independentemente por12; fornecedor existente1 reutilizado; propostas2/3/4 da REQ-2026-000002 com totais23,20/25,52/27,84MZN. Reserva/compromisso,requisição,stock,contas/grants eSGF preservados. Provas pilot-market-authorization/activation/activation-http.json; backup/restauro113tabelas e109tabelas protegidas conferidos. Não reaplicar nem pedir novamente esta autorização. Os estados de proposta pendente abaixo são históricos. Avaliações continuam em0; não avaliar,seleccionar,adjudicar ou encomendar por inferência. Os identificadores/cadastros/condições são explicitamente fictícios de ensaio, sem validação fiscal ou diligência comercial real. Continuar desenvolvimento/testes descartáveis e integração interna sem confirmação técnica corrente.
## Aprovação sintética autorizada e confirmada — 02/11/2026
O proprietário autorizou expressamente a aprovação de REQ-2026-000002 por10, para consulta ao mercado, sem seleccionar fornecedor nem encomendar. Decisão registada uma única vez às19:34:34UTC; compra approved,2cx/23,20MZN, reserva2320cêntimos/compromisso0 e stock1cx preservados. Recibo imutável50990058-e957-4eb2-a5c6-271d3ea63bda. Provas pilot-approval-authorization/activation/activation-http.json. A rotina de aplicação mudou de actor para verificar a tarefa do Procurement antes do callback pós-commit e recebeu403 depois de a decisão estar confirmada; corrigido o actor e verificado o recibo/restauro original sem repetir a decisão. Não reaplicar nem pedir novamente autorização da aprovação/submissão/reposição/perfis. A proposta original mantém estado histórico de preparação; a autorização e aplicação efectivas estão nas provas separadas. Não seleccionar/adjudicar/encomendar ou criar cotações/fornecedores novos por inferência desta autorização. Desenvolvimento e integração técnica continuam autorizados.
## Submissão sintética autorizada e aplicada — 02/11/2026
O proprietário respondeu «autorizo» à proposta de submeter apenas REQ-2026-000002,id2,por9,sem mudar2cx/23,20MZN nem aprovar. Aplicada às19:20:53UTC: estado pending, etapa department_head, responsável elegível10. Reserva orçamental canónica2320cêntimos,sem compromisso; stock1cx preservado. Provas pilot-submission-authorization.json, pilot-submission-activation.json e pilot-submission-activation-http.json. Backup/restauro113tabelas,106tabelas protegidas e demais requisições preservadas. Não submeter novamente nem pedir de novo esta autorização. Os estados anteriores de rascunho/pendente de autorização abaixo são históricos. A aprovação da compra, adjudicação, encomenda e movimentos físicos continuam fora desta autorização; desenvolvimento/testes descartáveis e integração interna prosseguem autonomamente.
## Reposição sintética local — autorização e aplicação, 02/11/2026
Actualização técnica posterior: instalada em8005 a migração já existente `2026_11_01_000046_add_requisition_command_versions` (recibos de operação vazios, dois triggers e process_version inicial1), com backup/restauro e comparação dos registos. Prova `pilot-command-receipts-installation.json`; não repetir. O diagnóstico passou a exigir tabela e coluna. A compra id2 continua em rascunho. `pilot-submission-proposal.json` e o respectivo dry-run preparam somente a próxima submissão, ainda não autorizada: encaminhamento previsto ao chefe sintético10, sem aprovar a compra nem mudar valores/stock. Não confundir este ensaio descartável com submissão persistente.
O proprietário autorizou expressamente a proposta `docs/proofs/pilot-replenishment-proposal.json`, hash2db14db3dbde06d1bf18ff3e2ae81bb857e5570a2baeafb36b22969e10963e1c, apenas no SGC8005 com as contas sintéticas existentes. Aplicada: ART-TEST/ARM-TEST publicado como Outro, mínimo1/alvo3/máximo3cx, estimativa10MZN/IVA16%, regra até09/11/2026, requisitante9/OPS1, publicação13/preparação11/conferência12. Criado somente o rascunho REQ-2026-000002 (id2),2cx/23,20MZN, sem submissão ou aprovação da compra e sem alterar o saldo1cx. Provas pilot-replenishment-authorization.json, pilot-replenishment-activation.json e pilot-replenishment-activation-http.json. Cópia de recuperação verificada112tabelas e106tabelas protegidas preservadas. Não reaplicar nem voltar a pedir autorização para esta parametrização já aplicada; o estado pendente da proposta original é histórico. Esta autorização complementa a autorização anterior de acessos, sem criar contas/grants, submeter/aprovar/encomendar/entregar compras, renovar a validade ou alterar SGF/contratos comerciais. Continuar o desenvolvimento e a integração interna sem novas confirmações técnicas correntes.
## Piloto sintético local — autorização e aplicação, 02/11/2026
O proprietário respondeu **«autorizo»** à proposta concreta de activação dos perfis apenas na avaliação SGC `http://127.0.0.1:8005`. Aplicada na versão27:12contas sintéticas existentes preservadas,11perfis e17atribuições; administradores actuais6/8 mantidos. Tarefas adicionais:9requisitar ao armazém,10autorizar no departamento,13entregar,11preparar reposição e12conferir reposição. Funções, preparação de compra anteriormente implícita, contextos e âmbito departamental anteriores foram preservados. Confirmadas somente para estes ensaios as mesmas alçadas25.000/150.000MZN comIVA, sem alterar valores/IVA16% ou snapshots de processos existentes.
Autorização e prova: `docs/proofs/pilot-access-authorization.json` e `docs/proofs/pilot-access-activation.json`; proposta original preservada por hash em `pilot-access-proposal.json`. O estado pendente nesse artefacto corresponde à preparação histórica, não à autorização/aplicação já registadas separadamente. Não reaplicar a instalação nem pedir novamente autorização para esta distribuição já aplicada. Não transformar estes perfis em configuração automática de clientes: a entrega mantém dois administradores nominativos e responsabilidades escolhidas pela empresa. Esta autorização não cria contas, publica artigos, define mínimos/quantidades de reposição, executa decisões de negócio nem altera o SGF ou autoriza a identidade adicional desse ambiente.
## Integração interna — clarificação do proprietário, 02/11/2026
A integração solicitada nesta etapa é **entre os módulos do próprio SGC**. Ligar armazém, necessidades de reposição, requisições de compra, aprovações, encomendas e recebimentos pelos registos e motores existentes, sem reintroduzir dados, criar motores paralelos ou pressupor uma ligação ao SGF. Manter Compras/Pessoas e respectivas competências separados. Os componentes de transporte anteriormente preparados não substituem o percurso funcional interno. Esta clarificação não instala candidatas nem autoriza identidades ou alterações no SGF.
## Validação durante o desenvolvimento — orientação do proprietário, 02/11/2026
Nesta fase ainda não se vão criar pessoas reais: o produto será comercializado após o desenvolvimento. Continuar a desenvolver e validar com contas sintéticas. Reutilizar as contas de avaliação do SGC e manter cenários técnicos adicionais em bases descartáveis, sem confundir ensaio sintético com aceitação por utilizadores reais ou configuração de cliente. Esta orientação não instala candidatas no SGF real nem autoriza por inferência a identidade adicional anteriormente proposta nesse ambiente; a instalação real mantém o seu âmbito e autorizações próprios.
## Reposição a partir do armazém — orientação do proprietário, 01/11/2026
A inexistência de stock ou o atingir do mínimo deve desencadear uma requisição de compra ligada à necessidade. Implementar geração rastreável e sem duplicações enquanto existir reposição efectiva em curso, reutilizando as regras, responsáveis e aprovações existentes. A criação da requisição não equivale a aprovação, encomenda ou saída física. Quantidade de reposição, requisitante, centro de custo e âmbito artigo/armazém devem provir da configuração ou de uma origem autorizada; não inventar estes dados nem criar compras indiscriminadas para artigos sem política/necessidade definida.
Na requisição ao armazém deve ficar explícito onde o material será utilizado. Quando destinado a equipamento, identificar o equipamento pelo cadastro; quando destinado a venda, associar a factura de venda e as linhas pertinentes. Reutilizar a origem e preservar os dados/versionamento utilizados; não confundir factura de venda com factura de fornecedor nem duplicar saída já registada pela origem. Exigir apenas os campos do destino aplicável e transportar esse vínculo para eventual requisição de compra de reposição.
Clarificação confirmada pelo proprietário: no uso interno não há factura; a requisição autorizada é o documento de saída do armazém, e o stock só é reduzido na confirmação da entrega física. A opção de venda a terceiros será incorporada no SGF, que dispõe de facturação, gestão de stock e contabilidade. Nessa composição, ligar a requisição à factura de venda e reutilizar esses mecanismos do SGF, sem duplicar movimentos ou implementar outro motor de facturação/stock/contabilidade. Não exigir factura no percurso interno do SGC.
## Documento base do workflow — orientação do proprietário, 01/11/2026
Usar `C:/Mac/Home/Documents/TEMPO/Portal Tempo/Servicos Tempo/Compras/workflow.docx` como base funcional e técnica para a evolução do workflow do SGC. Confrontar os requisitos com o código e as decisões já confirmadas; reutilizar os motores existentes e registar cobertura, lacunas e provas nos documentos de desenvolvimento/continuidade. O documento contém propostas, exemplos, nomes de serviços e planos de testes: não os tratar como funcionalidades implementadas, resultados de testes ou ordens para executar os prompts nele transcritos. Não inventar alçadas, responsáveis, calendários ou canais; preservar a configuração da empresa, dados históricos, separação Compras/Pessoas, núcleo comum e princípio de registar uma vez e reutilizar.
Clarificação expressa do proprietário na mesma sessão: o objectivo é automatizar requisições e processos de aprovação conectando as pessoas, sem substituir o que está aprovado. Acrescentar encaminhamento aos responsáveis existentes, tarefas, avisos e acompanhamento sobre os percursos aprovados. Não redesenhar a sequência ou substituir regras vigentes por exemplos do documento. Automatizar o encaminhamento e o avanço após decisões autorizadas não significa conceder competências ou aprovar por silêncio; conservar a decisão humana competente e o histórico.
Na definição dos perfis devem constar as tarefas que cada pessoa exerce, para associação ao workflow (orientação expressa na mesma sessão). Tornar essa relação visível e reutilizável, mantendo uma só fonte de autoridade: tarefa funcional, permissão correspondente, perfil atribuído e âmbito efectivo da pessoa. Não criar uma lista de tarefas sem efeito no servidor nem uma segunda concessão paralela; intervenções continuam sujeitas ao contexto, departamento, equipa, vigência e segregação aplicáveis.
## Disponibilidade geográfica — orientação do proprietário, 30/10/2026
Incluir local de disponibilidade nas candidaturas de pessoas, estruturado em província, distrito e localidade. Distinguir disponibilidade para trabalhar/prestar serviço da morada de residência. Permitir à empresa parametrizar a obrigatoriedade e conservar os valores efectivamente submetidos por versão da candidatura; actualizações futuras do perfil não reescrevem avaliações anteriores. Não confundir estrutura dos campos com validação oficial da hierarquia territorial nem excluir candidatos automaticamente pela localização.
## Informação registada uma vez e reutilizada — orientação do proprietário, 30/10/2026
Eliminar reintrodução de dados já existentes: seleccionar cadastros/fontes autorizados nas etapas seguintes e preencher apenas informação nova do evento/processo. Actualizar o cadastro deve beneficiar usos futuros sem reescrever documentos, avaliações ou decisões anteriores. Preservar referência, versão e dados efectivamente utilizados em cada processo. A reutilização não concede acesso adicional, não mistura empresas/roteiros e não depende de IA. Não fundir pessoas/entidades por igualdade de nome nem importar registos antigos sem reconciliação explícita. Aplicar progressivamente e documentar lacunas; não declarar cobertura integral sem conferir todos os percursos.
## Núcleo comercial independente da IA — orientação do proprietário, 30/10/2026
As funcionalidades prometidas do SGC base devem permanecer disponíveis à empresa sem subscrição ou consumo de IA. IA é um módulo adicional opcional, por organização; não reclassificar funcionalidades aprovadas do núcleo como exclusivas desse adicional.
- Compras, contratação de pessoas, avaliações, aprovações, gestão documental, contratos, execução e relatórios devem manter os seus percursos normais. Se IA apoiar uma tarefa do núcleo, essa tarefa continua executável pelo percurso manual ou pelas regras locais correspondentes.
- Indicadores, alertas e sínteses factuais locais não dependem de credencial, fornecedor, créditos ou orçamento de IA. Desactivação, cancelamento, esgotamento ou indisponibilidade da IA não bloqueiam leitura, edição autorizada, tramitação ou relatórios do núcleo.
- Não apagar ou esconder documentos, decisões, evidências ou resultados já incorporados e preservados no processo quando termina o adicional de IA. Manter permissões, isolamento e auditoria usuais.
- Distinguir claramente núcleo, assistência opcional e capacidades ainda por implementar. Esta orientação não declara concluídas funcionalidades pendentes, contratos formalizados ou todos os requisitos da proposta Word.
- Verificar a independência do núcleo ao introduzir integrações, contadores, reservas de consumo, activação ou cobrança de IA. A condição comercial de IA nunca substitui a autorização funcional do processo.
## Identidade aprovada pelo proprietário — 30/10/2026
Nome do produto: **SGC — Sistema de Gestão de Contratações**. Descrição: **Aquisições, serviços e pessoas**. Assinatura: **Uma solução TEMPO**. Manter a sigla SGC e os nomes funcionais dos módulos (Compras, prestadores individuais e recrutamento). A adopção do nome não autoriza renomear pastas, domínios, bases, cookies ou reescrever dados e documentos históricos.
## Separação dos roteiros — decisão do proprietário, 30/10/2026
Separar **Compras** de **Pessoas e contratações** na navegação e nos processos. Compras mantém o seu roteiro de aquisições e fornecedores; Pessoas e contratações reúne serviços individuais e recrutamento, cada um com o respectivo roteiro. Partilhar estrutura visual, parametrização, autenticação, auditoria e mecanismos comuns sem misturar dados, decisões ou critérios. Esta orientação posterior substitui a proposta do Word de colocar os serviços individuais dentro de Compras. Não criar contratações duplicadas nem transferir automaticamente uma candidatura para uma compra.
## Administração e entrega — orientação do proprietário, 30/10/2026
- O menu de Administração deve incluir «Parametrização da aplicação».
- A configuração inicial/entrega exige dois administradores nominativos da empresa. Devem poder criar utilizadores, definir perfis próprios e outorgar as permissões funcionais escolhidas pela empresa. Manter pelo menos dois administradores permanentes; acessos de manutenção não contam para esse mínimo.
- As regras e os perfis de desenvolvimento devem ser substituídos pela configuração da empresa na entrega. Não criar contas de exemplo, credenciais universais ou atribuir automaticamente perfis de desenvolvimento a novas empresas. Preservar referências históricas; a substituição da autoridade de acesso deve ser explícita e auditada, sem apagar contas/dados existentes por arrasto.
- O proprietário pediu manutenção TEMPO, referindo um «backdoor». Implementar o objectivo como acesso nominativo e autenticado, com permissões explícitas, prazo, revogação e auditoria; sem entrada oculta, palavra-passe universal ou contorno de autenticação. O incremento actual oferece diagnóstico/consulta temporários, sem administração de acessos nem comandos de negócio nesse modo.
## Parametrização integral — orientação do proprietário, 30/10/2026
A aplicação inteira deve ser parametrizável pela interface, por utilizadores com competência de configuração atribuída pela própria organização, sem intervenção no código para adaptar a organização e os processos.
- Permitir definir «quem é quem»: funções/cargos e respectivos nomes, perfis e permissões, pessoas, equipas, departamentos/centros e acumulação de funções, responsabilidades, substituições e delegações.
- Permitir definir «quando usar»: condições de aplicação, âmbito, vigência, prazos, limites, etapas e encaminhamentos, incluindo situações opcionais e obrigatórias.
- Permitir definir «como associar»: vínculos entre pessoas, funções, unidades, processos, documentos, fornecedores, políticas, etapas, aprovações e relatórios; estabelecer quem prepara, executa, consulta, revê, decide e configura em cada contexto.
- Tratar as funções e listas de perfis actualmente fixas como configuração inicial de compatibilidade. Evoluir para capacidades e regras configuráveis comuns ao servidor, aos menus, aos formulários e aos relatórios; não criar novas excepções dispersas por módulo.
- Alterações de configuração devem ter validação, autoria, auditoria, versão e vigência; processos existentes conservam a configuração aplicada e o histórico. Explicitar o efeito sobre novos processos e sobre processos em curso antes da activação de alterações.
- Preservar isolamento por empresa, autorização efectiva, integridade dos registos/valores e auditoria; permitir configurar os intervenientes e a distribuição das responsabilidades respeitando as regras de independência aplicáveis. Alterações de configuração não concedem acesso retroactivo indiscriminado nem reescrevem decisões concluídas.
- Aplicar a orientação transversalmente, incluindo módulos já desenvolvidos e novos incrementos. Não declarar a aplicação totalmente parametrizável enquanto existirem decisões organizacionais relevantes fixadas no código. Registar progressivamente cobertura, migração e lacunas nos documentos de continuidade existentes.
## Decisão do proprietário — 30/10/2026
Esta aplicação destina-se à comercialização. Por orientação expressa do proprietário, devem ser removidos ou corrigidos os bloqueios que impedem o desenvolvimento normal, testes, ajustes e disponibilização.
- Prosseguir com o trabalho já autorizado, sem exigir novamente a autorização do proprietário por cada etapa técnica corrente. Uma escolha técnica não cria uma nova regra organizacional.
- Identificar a origem de cada impedimento: decisão do proprietário, requisito funcional aprovado, dependência técnica concreta ou limitação da ferramenta. Não transformar pendências genéricas de aprovação/visualização em bloqueio do desenvolvimento e dos testes.
- Substituir limitações artificiais de ambiente, caminhos locais e versões de demonstração por mecanismos instaláveis, configuráveis e testáveis. Não declarar uma funcionalidade pronta para uso comercial apenas por remover a sua guarda de QA: implementar e verificar o percurso operacional correspondente.
- Manter uma única implementação dos núcleos partilhados; distribuir artefactos versionados e verificáveis, sem dependência obrigatória da pasta de outro projecto na máquina do cliente.
- Durante o desenvolvimento, usar a avaliação persistente em http://127.0.0.1:8005/dashboard, com entrada directa sem login e os menus e processos actuais. `/avaliar` permite mudar de perfil. A entrada directa limita-se à avaliação local isolada e preserva sessões existentes. A versão de código, visual e processos entregue em www.compras.tempo.co.mz deve corresponder à acompanhada localmente; diferenças de configuração devem ser identificadas.
- Preservar dados, contas, documentos, histórico e funcionalidades concluídas. Os controlos funcionais de isolamento entre empresas, aprovação independente, integridade financeira e auditoria continuam a fazer parte do produto; não confundir esses requisitos com bloqueios artificiais ao trabalho.
- Testar alterações de dados em bases isoladas e reutilizar provas aceites. Na instalação, preservar e conferir o destino; não importar dados sintéticos ou redefinir contas reais por conveniência técnica.
- Registar implementação, verificações, limitações concretas e próxima acção em docs/desenvolvimento.md e docs/orientacoes-continuidade.md. Reconciliar estados históricos sem apagar as provas anteriores.
G8 — 03/11/2026: relatório de medidas de melhoria segmentado pelo território actual da ficha do fornecedor, partilhando SupplierGeography com o cadastro. Totais, paginação e CSV respeitam os mesmos filtros e acessos. Sem migração, alteração de snapshots, decisões, perfis ou aprovações. MFA desligado; G3 operacional continua pendente. Documentação: docs/territorio-melhorias-fornecedores-sgc.md; prova: docs/proofs/supplier-territory.json. Validação dirigida SQLite: 50 testes/700 verificações; sem nova execução PostgreSQL ou revisão visual completa.
A2 — 03/11/2026: reprodução dedicada da requisição interna, reutilizando snapshot e WarehouseFulfilment.progress. Separação de pedido/reserva/entrega/saldo/cancelamento, histórico de autorização e recepção, ligações aos documentos individuais A1. Mesmos acessos da ficha, sem mutações ou factura. Sem migração; aprovações preservadas e MFA desligado. Docs/armazem-requisicao-impressao.md; provas warehouse-request-print.json e warehouse-request-print-pg.json. Não declara revisão visual ou aceitação comercial.
A3 — 03/11/2026: CSV integral de acompanhamento das requisições internas, com filtros aplicados e âmbito partilhado com a lista. Uma linha por artigo/unidade; quantidades e estados reutilizam progress nativo. Paginação não limita a exportação; protecção de células de folha de cálculo. Sem novas aprovações, campos, migrações ou movimentos; MFA desligado. Docs/armazem-requisicoes-exportacao.md; provas warehouse-request-export.json e warehouse-request-export-pg.json. Sem teste de carga ou revisão visual completa.
O2 — 03/11/2026: diagnóstico integrado de reposição e integridade documental pelo comando sgc:operations-check. Reutiliza verificadores nativos, consulta global só em consola sem identidade/sessão, saída agregada sem detalhes privados e continuação em falha parcial. Estado incompleto/indisponível nunca equivale a sucesso. Não instala serviços, recupera compras, corrige ficheiros ou grava telemetria. Sem migrações ou interface nova; aprovações preservadas e MFA desligado. Docs/operacao-diagnostico-integrado.md; provas operational-health.json e operational-health-pg.json. Instalação recorrente, restauro, capacidade e aceitação mantêm-se pendentes.
E2 — 03/11/2026: ficha de equipamento reúne também requisições internas ao armazém ainda pendentes, por ID nas linhas preservadas, sem associação por texto. Projecção só das linhas do equipamento, estado/reserva/entrega/saldo nativos, ligações aos processos e paginação independente de15. Acesso ao equipamento não concede acesso ao armazém; empresa/departamento/capacidades mantidos. Sem novos registos, movimentos, migração ou aprovações; MFA desligado. Docs/equipamentos-requisicoes-internas.md; provas equipment-warehouse.json e equipment-warehouse-pg.json. SQLite57testes/737verificações e PostgreSQL4/107 aprovados, sem somar a provas históricas; não declara revisão visual/carga. G3 continua pendente.