Files
compras/docs/matriz-sgc-reconciliada.md
T
2026-11-03 11:51:44 +02:00

62 lines
13 KiB
Markdown

# Matriz reconciliada do SGC — 03/11/2026
Esta revisão confronta a matriz histórica de `compatibilidade.md` com código e provas posteriores. É uma reconciliação documental e de código, não uma nova execução de todos os testes, revisão visual ou aceitação comercial. As provas citadas conservam a data, composição e limites originais; os seus números não se somam.
O âmbito é o SGC autónomo em `C:/laragon/www/compras`, com o piloto sintético existente em 8005. InvestMoz e a instalação real do SGF são distintos. A instalação real SGF permanece 0.1.1; desenvolvimento de adaptadores ou ensaios separados não autoriza implantação. As decisões do piloto já aplicadas não devem ser repetidas.
## Confronto com a matriz histórica
| Área da matriz | Código/prova consultados | Estado reconciliado e pendência |
| --- | --- | --- |
| Acesso e organização | `config/fortify.php`, `OrganizationAccess`, `CurrentActor`; `proofs/pilot-replenishment-activation-http.json` | Perfis, tarefas, contexto e vigência existem. Fortify activa registo e recuperação de palavra-passe; os campos MFA no modelo não provam MFA activo. MFA e validação comercial do ciclo de acessos continuam pendentes. Não impor regras novas às contas existentes por inferência. |
| Requisições e aprovações | `RequisitionWorkflow`; `InternalRequisitionCandidateTest`; `proofs/pilot-approval-activation.json` | Circuito versionado e recibos de comandos implementados; aprovação sintética aplicada uma vez. Valores e segregação continuam a pertencer à configuração da empresa. Não significa aceitação empresarial nem autorização de adjudicação. |
| Fornecedores | `SupplierParticipation`, `SupplierBankWorkflow`, `SupplierEvaluationWorkflow`; `proofs/supplier-quality-task-integration.json` | Cadastro, validação, avaliação qualitativa, contraditório e tarefas têm implementação posterior à matriz. Múltiplas contas bancárias e verificação externa não ficam comprovadas pelas provas aqui consultadas. |
| Cotações | `QuotationController`, `QuotationPricing`; `SupplierQuotationTest`; `proofs/pilot-evaluation-activation.json` | Preços/descontos reutilizam núcleo comum e as seis avaliações fictícias estão registadas. O controlador ainda grava moeda MZN: multimoeda de propostas continua uma lacuna real, distinta do registo de acordos de importação. Não inventar câmbios ou aprovar propostas novas. |
| Conflitos RF-AF-01 | `ConflictGuard`; `compatibilidade.md` | Há controlo no servidor. Não foi comprovado nesta revisão o ciclo completo de periodicidade/validade/levantamento; manter pendente, sem desactivar impedimentos. |
| Adjudicação e ordens | `routes/web.php`, `PurchaseAwardOrderTest`; `proposta-cancelamento-ordens.md` | Emissão e aprovações existentes preservadas. Cancelamento de ordem emitida continua descrito como proposta não activada; é distinto da revisão anterior à emissão e do estorno físico. Não cancelar nem libertar compromisso por analogia com uma correcção de stock. |
| Recepção | `ReceiptWorkflow`; provas de recepção e `proofs/inventory-corrections.json` | Recepção e correcções físicas têm implementação. Substituições/anexos e percurso operacional integral ainda exigem cobertura própria; correcção física não equivale a nota de crédito. |
| Stock | `StockWorkflow`, `InventoryLots`, `InventoryReversals`, `InventoryDispositions`; `proofs/inventory-task-integration.json` | Lotes, qualidade, correcções e tarefas já existem; «estornos ausentes» seria uma conclusão incorrecta para stock. Conversões gerais de unidade e revisão visual não foram encerradas. |
| Requisições internas | `WarehouseRequests`, `WarehouseReservations`, `WarehouseFulfilment`; `proofs/warehouse-task-pilot-status-http.json` | Autorização, reserva e entrega usam a requisição como documento de saída, sem factura. Venda a terceiros pertence à composição SGF; não desenvolver facturação paralela no SGC. |
| Devolução interna de excedente | `WarehouseReturns`; `warehouse-unused-return.md` | Implementação sintética própria, desactivada por defeito. Não confundir existência de código/prova com funcionalidade activa no piloto; não habilitar por esta revisão. |
| Equipamentos e peças | `EquipmentWorkflow`; `EquipmentSparePartsTest`, `InvestmentPolicyTest` | Cadastros e regras técnicas existem. Configuração empresarial, agregação por projecto e fraccionamento continuam sem encerramento comprovado nesta revisão. |
| Orçamento | `CommonBudget`, `BudgetWorkflow`, `BudgetReinforcementWorkflow`; `compatibilidade.md` e provas orçamentais | Núcleo comum, dotações, reforços, reservas e compromissos têm provas históricas. Reduções/transferências e aceitação operacional não devem ser inferidas dessas provas. |
| Facturas e pagamentos | `SupplierPayables`, `SupplierPayablePage`; `financeiro-consulta-paginada.md`, `contabilidade-ciclo-sintetico.md` | Há adaptadores e entregas comuns posteriores. Algumas capacidades continuam restritas a QA ou desligadas; não declarar estornos/notas universalmente disponíveis no piloto nem instalar pacote por inferência. |
| Planeamento e formalização | `PurchasePlanningWorkflow`, `ProposalOpeningWorkflow`, `FormalAdmission`, `FormalRecommendation`; `validacao-tecnica.md` | Preservar adopções e políticas independentes. Não há prova nesta revisão de assinaturas digitais verificadas, propostas seladas ou aprovação financeira de planos. |
| Pessoas e contratações | `PeopleHiring`, `PeopleRegistry`, `PeopleReportController`; `reutilizacao-dados.md` e `PeopleHiringTest` | Cadastro reutilizável, relatórios e caixa de tarefas são distintos dos de Compras. Uma referência antiga a «sem relatórios» não descreve o código actual. Aceitação visual e cobertura empresarial continuam separadas. |
| Navegação e relatórios | Páginas `workflow/tasks`, `workflow/notices`, `supply/coordination`; `proofs/task-deadlines.json`, `proofs/notice-consultation.json`, `proofs/coordination-export.json` | Filtros, prazos e CSV de acompanhamento entregues. Isto não encerra revisão visual, impressão ou todos os relatórios exigidos pelo produto. |
| Auditoria | `AuditLog`, auditoria dos comandos e relatórios por processo | Histórico existe. CSV de acompanhamento não é exportação geral de auditoria. Retenção, protecção face a administrador SQL e exportação integral continuam sem encerramento comprovado. |
| Reposição periódica | `AutomaticPurchases`, `ReplenishmentQueue`, `ReplenishmentProcessLock`; `proofs/replenishment-process-lock.json`, `operacao-reposicao.md` | Recuperação durável, reavaliação temporal e exclusão local existem. A pendência deixou de ser «implementar reposição»: é instalar/conferir operação comercial após reinício e validar capacidade. O bloqueio local não prova exclusão distribuída. |
## Lacuna escolhida nesta revisão
Na preparação de políticas do calendário, o controlador carregava integralmente todos os acordos aprovados, sem pesquisa de referência/fornecedor no servidor. O formulário filtrava apenas por artigo/local no navegador. Esta é uma lacuna de consulta e escala, não ausência de acordos nem falha das aprovações.
Implementada pesquisa no servidor por referência/fornecedor e âmbito artigo/armazém, com janela de 100 resultados e conservação das fontes aprovadas já usadas/seleccionadas. O formulário conserva os dados e separa as opções de cada preparação. A validade, versão, prazo conhecido e decisão independente continuam a ser conferidos pelo motor nativo; aparecer no selector não certifica vigência contratual. Fonte suspensa não é reintroduzida pela selecção. Provas e resultado final desta entrega: `proofs/agreement-source.json` e variantes PostgreSQL/HTTP.
## Pendências por natureza
Actualização posterior de 03/11: entregue `sgc:replenishment-health`, consulta técnica sem processamento de compras, com resultado JSON/código de saída, associação da passagem à instalação e reutilização do estado da fila. [Operação](operacao-reposicao.md) e provas `proofs/replenishment-health.json`/variantes. Instalação do serviço Windows, monitorização recorrente, reinício e aceitação comercial continuam pendentes; a consulta não os executa ou certifica.
Actualização posterior de 03/11: entregues as [consultas de aprovadas sem propostas registadas ou ordem visível](relatorios-aprovadas-sem-documentos.md), ligadas aos indicadores e CSV, com a mesma fonte e âmbito de leitura. Provas `proofs/approved-attention.json` e variantes. As contagens podem sobrepor-se e não representam decisões de elegibilidade, selecção ou emissão.
Actualização posterior de 03/11: o indicador de necessidades ultrapassadas ainda por aprovar está ligado à lista filtrada e ao CSV, com a data já registada e revalidação do acesso à exportação. [Âmbito e evidências](relatorios-necessidades-por-aprovar.md), `proofs/needed-attention.json` e variantes. Não cria prazos de aprovação, decisões ou comprovação de atraso do fornecedor.
Actualização posterior de 03/11: paginação do histórico da requisição entregue com 25 eventos por página, contagem integral e conservação dos formulários na navegação parcial. CSV integral preservado. Provas `proofs/audit-pagination.json` e variantes; não constitui validação de capacidade, auditoria geral ou aceitação visual.
Actualização posterior de 03/11: entregue [CSV dos metadados do histórico por requisição](auditoria-metadados-requisicao.md), usando o mesmo âmbito e projecção do ecrã, com acesso actual, consulta sem mutações e conteúdo privado excluído. Provas `proofs/requisition-audit.json` e variantes PostgreSQL/HTTP. Exportação geral, retenção, certificação e protecção face a administradores SQL continuam sem encerramento por esta entrega.
Actualização posterior de 03/11: a [adesão voluntária MFA](mfa-adesao.md) está agora implementada e testada com o Fortify nativo, incluindo interface, privacidade, recuperação e CSRF. Migração/activação não aplicadas ao piloto; obrigatoriedade empresarial, recuperação administrativa, revisão visual e aceitação continuam pendentes. A prova `proofs/mfa-management.json` sucede à preparação técnica `mfa-foundation.json`; não somar os resultados sobrepostos nem interpretar esta actualização como activação.
1. Desenvolvimento: multimoeda de propostas, conversões gerais, restantes relatórios/impressões, exportação/retenção de auditoria e cobertura ainda não comprovada dos documentos base. Requisitos com parâmetros financeiros ou regras novas precisam de definição explícita; a matriz não os inventa.
2. Instalação/configuração: tarefa periódica comercial e ensaio após reinício; capacidades comuns ou devoluções desligadas continuam desligadas. Preparar operação exacta e evidências antes de pedir autorização para a instalação/activação concreta.
3. Validação: percursos, capacidade/carga sustentada, revisão visual, impressão e aceitação comercial. Código ou teste dirigido não substitui estas etapas.
4. Decisões humanas: seleccionar fornecedor, adjudicar, encomendar, alterar direitos ou parâmetros do piloto e intervir na instalação real SGF permanecem fora da autorização genérica de desenvolvimento. Não são bloqueio para desenvolver outras lacunas autorizadas.
Não foi declarado o SGC completo. Esta tabela actualiza estados sustentados pelas fontes consultadas e identifica explicitamente o que continua por comprovar; não certifica cobertura integral de cada linha ou de todos os documentos originais.
## 03/11/2026 — entrega por bloco R1: recepção documental
Adoptado o plano docs/plano-entregas-sgc.md: construir blocos funcionais e validar em conjunto no fecho, mantendo verificações críticas dirigidas durante a implementação. R1 acrescenta evidências privadas à recepção confirmada, reutilizando origem e responsabilidades nativas, com repetição segura, integridade na descarga, auditoria e navegação para o processo. Não repete stock, aprovação ou recepção física.
Validação final: ReceiptDocumentBlockTest + ReceiptStockTest, 36 testes/271 verificações; PostgreSQL descartável 5/78, base removida. PHPStan sem erros, TypeScript, compilação de produção, Pint, diff e 18 hashes de execução conferidos. Prova docs/proofs/receipt-block.json e limites em docs/recepcao-documental.md. Sem revisão visual completa, carga ou instalação no piloto. Migração documental 2026_11_03_000002 pendente de autorização específica; não aplicar incidentalmente MFA. Sem novas contas, permissões ou decisões de negócio. R1 não declara todo o módulo Recepção concluído.