13 KiB
Entregas por blocos funcionais do SGC
Continuação de 21/11/2026
Decisão posterior: extensão de inventário autorizada apenas em desenvolvimento/QA. A fonte comum C:/laragon/www/sgf-tempo/packages/inventory-write/src foi ampliada, sem editar o arquivo publicado 0.1.0. A adaptação e artefacto de desenvolvimento em Compras mantêm a configuração desligada; o carregamento exige testing e base descartável identificada. A primeira recepção aceite congela factor/fonte/versão por linha/artigo; parcelas seguintes conservam essa base. A compra e a factura mantêm as quantidades e preços documentais; stock/lotes/devoluções usam a quantidade física e a equivalência documental exacta. A autorização não instala nem activa no piloto/SGF.
Bloco de multimoeda implementado e validado localmente: Finanças regista taxa para MZN com data/fonte, congelada por processo/moeda; proposta/ordem mantêm valores originais, comparação/alçadas/orçamento usam referência em MZN. Facturas parciais, pagamentos externos na mesma moeda e reversão do compromisso estão ligados aos motores existentes. Migração nova apenas em QA, sem instalação no piloto ou activação SGF. Limite actual: valores com duas casas decimais, sem diferenças cambiais ou conversão bancária.
Conferência integrada: CSV completo da projecção já usada na impressão; integridade e revalidação de acesso dos documentos de fornecedores. Critérios e provas em matriz-sgc-reconciliada.md, actualização de 21/11. Não repetir instalações, avaliações, aprovações ou decisões do piloto. Prosseguir com as restantes lacunas e a validação global; este bloco não encerra o produto.
03/11/2026 — orientação acordada com o proprietário. Substitui a sequência de pequenos incrementos de consulta. A matriz reconciliada continua a fonte de cobertura e provas; este plano organiza a execução, sem declarar módulos completos por terem menus.
| Módulo | Base existente | Bloco a concluir | Critério de fecho |
|---|---|---|---|
| Cadastros e território | Fonte cartográfica fornecida pelo proprietário | G1 instalado/activo; G2 revisão/CSV entregue; G3 armazéns/equipamentos pendente de instalação; G4/G5 disponibilidades, G6 consulta territorial e G7 disponibilidade recebida na ficha/dossiê integrados sem migração | Backup/restauro114tabelas,111protegidas e colunas anteriores intactas. Referências ainda vazias; MFA desligado. Diagnósticos apenas em leitura, dados originais preservados; provas administrative-geography-installation/review.json |
| Recepção | Ordem emitida, recepção/qualidade, stock e histórico nativos | R1 instalado com autorização; R2 implementado e validado: reprodução imprimível da recepção | R1: receipt-block-installation.json. R2: receipt-print.json, bateria integrada 39/295 e PostgreSQL 3/24; confirmação original, qualidade, estornos e referências documentais, sem novos movimentos ou decisões |
| Compras | Requisição, aprovações, propostas, avaliação, adjudicação e ordens | C2 entregue: cancelamento integral de ordens emitidas,desligado no piloto;multimoeda e revisão comercial continuam pendentes | Política própria,Finanças independente,reversão única e original preservado;prova issued-order-cancellation.json. Não inventar câmbios ou novas alçadas |
| Armazém e reposição | Requisições internas, reserva, entrega, mínimos, recuperação e qualidade | A1 entregue: documento individual por entrega interna, reutilizando requisição, autorização e operação de stock; depois conversões gerais e fecho operacional das devoluções preparadas | 20 testes/363 verificações de requisições e entregas; prova warehouse-delivery-print.json. Conversões e activação mantêm critérios próprios |
| Equipamentos e peças | Cadastro, associações, validação técnica e saídas ligadas | E1/E2 entregues: ficha de compras, requisições internas pendentes e movimentos por equipamento | 48testes/571verificações integradas,PostgreSQL4/99;prova equipment-integration.json. Âmbito nativo,operação única da entrega interna;projecto/fraccionamento conservam âmbito próprio |
| Financeiro | Núcleo comum, orçamento, facturas, pagamentos e entregas sintéticas | Consolidar cobertura efectiva da composição e dos percursos financeiros pendentes | Reconciliar funcionalidades activas/QA, sem duplicar motores ou instalar pacotes por inferência; preservar trabalho paralelo |
| Pessoas | Cadastro, candidaturas, workflow e relatórios | P1 entregue: dossiê portátil de preparação com a mesma projecção autorizada da consulta; formalização contratual mantém âmbito próprio | 56testes/1684verificações integradas,PostgreSQL3/72. Percursos serviço/trabalhador, selecção e minuta preservadas; sem admissão ou envioRH. Prova people-dossier.json |
| Segurança | Adesão MFA voluntária implementada e desligada no piloto | S1: estrutura dos três campos vazios instalada com autorização; capacidade continua desligada | mfa-pilot-schema-installation.json:114tabelas restauradas/conferidas,12contas preservadas. Activação posterior exige acesso/recuperação e autorização próprios |
| Auditoria e documentos | Histórico por processo, metadados/CSV e paginação | D1 entregue: consulta/CSV de metadados dos módulos com competência própria; proposta de acesso no piloto pendente | 41testes/410verificações integradas,PostgreSQL7/85. Prova audit-metadata.json;retenção/exportação integral mantêm âmbito próprio |
| Operação comercial | Recuperação, exclusão local, heartbeat e healthcheck | O1 entregue: integridade documental e ficheiros sem referência; instalação do serviço, reinício, backup/restauro, capacidade e revisão visual continuam pendentes | 14 testes/135 verificações integradas e PostgreSQL6/33; consulta sem mutações e incompletude explícita. Prova receipt-document-health.json; implantação/recuperação e aceitação exigem ensaios próprios |
Execução de R1
Reutilizar a recepção confirmada como origem, sem pedir novamente fornecedor, ordem, artigo, quantidades ou armazém. O armazém acrescenta apenas tipo de evidência e ficheiro. As mesmas regras de consulta da recepção protegem os anexos; escrita respeita competência de recepção, independência do emissor e manutenção. Documentos anexados são preservados, sem substituir a confirmação física ou alterar a sua decisão de qualidade.
Construir em conjunto armazenamento privado, metadados, repetição/reutilização, descarga, interface no detalhe e referências de navegação. Testes dirigidos de ficheiros, acesso, repetição e rollback acompanham a construção. No fecho, executar uma bateria integrada de recepção documental e recepção/stock afectados; actualizar uma prova e a matriz. Sem baterias gerais ou reverificação de todos os outros módulos entre componentes.
Substituições de artigos, reabertura de qualidade e cancelamento/estorno financeiro têm regras próprias e não são introduzidos implicitamente por anexar um documento. O fecho de R1 não declara todo o módulo Recepção, instalação ou produto comercial completos. Manter os percursos já aprovados e as autorizações 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.
Conversões de unidades — proposta concreta para decisão, 21/11/2026
O contrato instalado do escritor partilhado (packages/inventory-write/releases/0.1.0/src/ReceiptMovementWriter.php) exige que a quantidade do movimento seja exactamente a quantidade aceite da recepção. O percurso actual exige unidades coincidentes. Activar conversões apenas no formulário, reescrever a quantidade documental ou criar outro escritor perderia a relação com a compra/factura ou duplicaria a autoridade sobre stock.
Proposta: conservar quantidades e preços da compra/factura na unidade original e converter apenas a quantidade física para a unidade-base do artigo, com factor racional explícito por artigo, fonte e versão congelados na operação. Exemplo sintético de aceitação: 2 caixas de 12 unidades, a 100 MZN/caixa, conservam compra/factura de 200 MZN e originam 24 unidades em stock. Uma recepção parcial de 1,5 caixas origina 18 unidades, sem alterar o preço ou o documento. Não associar artigos por nome nem inferir factores.
Preparar uma versão seguinte do contrato na fonte comum aprovada e a adaptação de Compras, com uma única implementação/escrita, compatibilidade e repetição dos movimentos antigos, sem editar o arquivo publicado 0.1.0. O snapshot deve distinguir unidade/quantidade documental, unidade/quantidade de stock e factor/fonte/versão. Lotes, qualidade, devoluções, saídas e reposição devem usar a mesma base, sem arredondamento silencioso. Uma quantidade não representável em milésimos é recusada para correcção explícita. O hash/replay das origens antigas deve conservar-se quando não há conversão.
Aritmética exacta já preparada, isolada e sem escrita, em packages/purchasing/src/QuantityConversion.php; não está ligada ao bootstrap, aos escritores ou ao produto. Dez testes/18 asserções e PHPStan dirigido aprovados. A localização final na fonte comum e o contrato operacional dependem da autorização. Testes seguintes: percurso compra→recepção→stock→factura com conversão, parcelas/reenvio sem duplicação, conflitos de versão, qualidade/lotes/retornos e regressão dos efeitos antigos, em QA isolada. Instalação, publicação de pacotes, activação no piloto ou SGF e operações de negócio ficam excluídas. Após operações convertidas, qualquer reversão de código terá de conservar a sua leitura/repetição; não apagar nem reclassificar movimentos para recuar.
Estado: autorização da alteração concreta do contrato pendente, conforme §6 de AGENTS.md. Nenhuma alteração ao escritor ou versão publicada foi executada.