commit14
This commit is contained in:
+180
-1
@@ -1,5 +1,173 @@
|
||||
# Transferência de Compras e actualizações do SGF
|
||||
|
||||
## Consultas/cotações/adjudicação — estado actual, 02/11/2026
|
||||
|
||||
[Entrega para revisão, mapeamento, hashes, testes e recuperação](consultas-adjudicacao-sgf.md). Candidata **`OPERATIONAL-CANDIDATE-040fb0cb67a77d61`**, ZIP SHA-256 `dfb122bc4532ce730d500ddec0112fe4d93cb1197fa5aef21b576f4049e7312a`, manifesto `040fb0cb67a77d618011bc7ab365c53d3d4b1a787c4c0c0a2d54f315b3658e58`.
|
||||
|
||||
| Percurso/capacidade | Estado na demonstração 8039 | Prova/pendência |
|
||||
| --- | --- | --- |
|
||||
| Requisição → reserva → aprovação independente → leitura Consulta | **Transferido e preservado** | Origem ID 1/100 MZN/versão 3, três eventos e reserva única intactos. |
|
||||
| Seleccionar fornecedores → registar/rever cotações → comparar | **Transferido no contexto sintético 1/1/1** | Três fornecedores/cotações; leitura e recusas no servidor verificadas. |
|
||||
| Avaliar → propor → confirmar adjudicação independente | **Parcialmente transferido** | Fluxo completo passou na cópia isolada, incluindo concorrência e obsolescência. Em 8039 há um avaliador por cotação e nenhum confirmador; permanece bloqueado conforme decisão de não criar quarta conta, sem reduzir as regras de Compras. |
|
||||
| Direitos | **Três acréscimos autorizados aplicados** | ID 1: `purchasing_sourcing.prepare`; ID 2: `purchasing_sourcing.evaluate` e `purchasing_sourcing.propose`, no âmbito 1/1/1. Consulta sem acréscimos; nenhum confirm concedido. |
|
||||
| Schema/actualização/recuperação | **Preparados e ensaiados** | Quatro tabelas SS, CHECK de catálogo e ledger próprio; código revertido e dados/schema restaurados em cópias, sem confundir ambas as recuperações. |
|
||||
| Valores cotados diferentes da reserva / cadeia acima do primeiro limite | **Pendente** | Sinalizados/bloqueados; nenhuma regra, reforço ou efeito financeiro inventado. |
|
||||
| Encomenda, recepção, pagamentos e implantação real | **Fora deste incremento / pendentes** | Nenhum efeito criado; SGF real permanece **0.1.1**. |
|
||||
|
||||
**Não é integração integral nem adjudicação concluída em 8039.** O proprietário autorizou apenas os direitos propostos para as identidades existentes e escolheu preparar sem criar outra conta. Foram preservados requerente fora da avaliação/adjudicação, dois avaliadores mínimos e proponente diferente do confirmador. [Prova agregada](proofs/sgf-sourcing-delivery.json), [cópias isoladas](proofs/sgf-sourcing-isolated.json), [HTTP 8039](proofs/sgf-sourcing-demo-http.json), [preservação 8039](proofs/sgf-sourcing-demo.json). Revisão visual separada. Sem novas contas persistentes, 8041, GRANT/REVOKE SQL, publicação ou contactos externos. Os estados abaixo conservam o histórico anterior.
|
||||
|
||||
## Primeiro percurso integrado fechado em 8039 — leitura corrigida
|
||||
|
||||
**02/11/2026: concluído no âmbito funcional sintético autorizado**, sem declarar integração integral de Compras. Preparação → submissão/reserva → aprovação independente → listagem/detalhe/histórico, incluindo Consulta, estão verificados na demonstração existente **8039 / 55439 / contexto 1/1/1**. Reutilizada a requisição ID 1 de **100 MZN**, versão 3; uma reserva preservada. A limitação de leitura registada abaixo fica resolvida neste incremento. Revisão visual permanece separada.
|
||||
|
||||
A correcção só altera `Port::authorize()` do adaptador SGF: `view` autoriza leitura dos registos carregados no contexto permitido, mantendo pertença, permissão efectiva, empresa/unidade, opção, token e validações próprias de escrita. Sem novos direitos, contas, DCL SQL, schema, configuração ou dados de negócio. Recusas ao Consulta para preparar/gravar/submeter/decidir/configurar/aprovar e tentativas de contexto/opção/empresa/unidade indevidos verificadas por HTTP.
|
||||
|
||||
### Candidata sucessora e provas afectadas
|
||||
|
||||
| Elemento | Identificação |
|
||||
| --- | --- |
|
||||
| Candidata | `OPERATIONAL-CANDIDATE-166e397e3ca63f02` |
|
||||
| ZIP SHA-256 | `620660d76329c800f3c6b18a521c03ccdadce09502d2a7744e1e91b77560f785` |
|
||||
| Manifesto SHA-256 | `166e397e3ca63f02d3dc57651c8eecf50e1fc314410c78e05386b518d3a661de` |
|
||||
| Mudança face à anterior 401ce31ae5f2dd20 | Somente `integrations/sgf/internal-requisitions/Port.php`; restante conteúdo preservado byte a byte |
|
||||
| Aplicação final na demonstração | `3afbba5e3ed60b853d62b869` — após reversão e reaplicação verificadas |
|
||||
| Provas | [Entrega](proofs/sgf-read-8039-delivery.json), [HTTP corrigida](proofs/sgf-read-8039-http.json), [versão anterior recuperada](proofs/sgf-read-8039-rollback.json), [reconciliação de dados](proofs/sgf-read-8039-data.json), [artefacto](proofs/sgf-read-candidate.json) |
|
||||
|
||||
O ensaio aplicou a sucessora, reverteu para a anterior (404 e omissão do Consulta reproduzidos) e reaplicou a sucessora (leitura restabelecida). Nenhuma recriação/submissão/reserva foi necessária. Foram reconciliadas as **109 tabelas efectivamente presentes nesta demonstração**: preservados dados de negócio, contas, direitos e auditoria anterior; novos eventos de auditoria foram apenas acrescentados pelos testes de recusa. Não confundir esta contagem com as 103 da reprodução descartável anterior. Configuração e ponteiro 0.1.1 preservados. Não foi necessário novo ensaio de migração/restauro de schema: não houve mudança de schema. Provas anteriores válidas de concorrência, migração, restauro, revogação e caches reutilizadas, sem repetir suites integrais.
|
||||
|
||||
Antes de aplicar foi criado backup custom privado da base sintética, SHA-256 `e07756b650d44361c0b2fce0eb170d0b54e7753b61c624a21b2524104e397055`, com índice conferido. Recuperação/journals em `C:\laragon\data\sgf-tempo\run\modular-regression-2576427d1939\private\read-correction-recovery`; backups nativos de código na pasta privada da demonstração. A reversão de código foi efectivamente exercitada; não se declara novo restauro integral desse dump. Credenciais e dumps não fazem parte da candidata.
|
||||
|
||||
### Matriz actual e próximo percurso escolhido
|
||||
|
||||
| Processo | Demonstração 8039 | Implantação real |
|
||||
| --- | --- | --- |
|
||||
| Requisição interna → reserva → aprovação independente → consulta | **Transferido e verificado no âmbito sintético**; leitura Consulta corrigida, recusas mantidas | **Pendente**, nenhuma candidata activada |
|
||||
| Orçamento/centro/dotação necessários ao percurso | **Transferido e configurado sinteticamente** | Pendente configuração empresarial própria |
|
||||
| Actualização/reversão de código desta correcção | **Verificadas**, sem alterar schema/direitos/dados de negócio | Não executadas |
|
||||
| Consulta de fornecedores, cotações/comparação e adjudicação | **Próximo percurso completo escolhido**, ainda pendente de incorporação | Pendente |
|
||||
| Encomenda/contrato, recepção, conferência de factura e liquidação | Pendentes ou parciais conforme matriz histórica; não cobertos por requisições | Sem nova implantação |
|
||||
|
||||
Próximo incremento escolhido: **requisição aprovada → abertura do processo de compra → consulta/recolha de cotações → comparação → decisão independente de adjudicação → consulta do histórico**. Reutilizar os processos já existentes de Compras e as suas origens/versionamento, sem criar outra requisição nem reservar duas vezes o mesmo montante. Primeiro mapear adaptadores/ecrãs e lacunas desse percurso; não activar 0.1.2 por arrasto nem declarar entregues encomenda, recepção ou pagamento. Este registo escolhe a sequência de trabalho, não inicia alterações de acesso/instalação real.
|
||||
|
||||
O SGF real continua em **0.1.1**, com `sgf_tempo_dev` e configuração Tempo preservados. Não foi criada 8041, não houve publicação, browser ou alteração de direitos públicos. As propostas/hashes anteriores abaixo permanecem como histórico; a candidata actual de requisições é a sucessora identificada nesta secção.
|
||||
|
||||
## Demonstração 8039 habilitada — confirmação executada em 02/11/2026
|
||||
|
||||
O proprietário confirmou os 14 direitos, o centro/dotação sintéticos e a habilitação em **8039 / base sgf_modules_dev_2576427d1939 / porta 55439 / contexto 1/1/1**. [Resultado e recuperação](demonstracao-requisicoes-8039.md): exactamente 14 acréscimos, contas/direitos anteriores preservados; centro SINTETICO-REPRO/OPER, dotação 10.000 MZN/2026 aprovada por outra identidade; requisição 1 de 100,00 aprovada pelo Revisor, uma reserva após retry e recusas de escrita ao Consulta. **Limitação:** a Consulta com apenas view não lê a requisição de outra identidade pela regra actual (404); nenhuma ampliação de direitos/regra feita por arrasto. Revisão visual separada. Sem 8041, novas contas ou GRANT/REVOKE SQL. Configuração da Tempo e implantação real permanecem preservadas em 0.1.1; esta execução não activa candidata no destino real. A proposta pendente abaixo fica sucedida exclusivamente para o âmbito sintético autorizado.
|
||||
|
||||
## Próximo âmbito substituído pelo proprietário — desenvolvimento isolado
|
||||
|
||||
Não avançar com a instalação técnica desactivada no destino real. A [proposta única de desenvolvimento](proposta-desenvolvimento-sgf.md) reutiliza a instância persistente existente em 8039, pasta `modular-regression-2576427d1939/development-app`, base `sgf_modules_dev_2576427d1939` no cluster exclusivo 55439, e suas identidades sintéticas. Especifica empresa/unidade, centro/dotação/política de demonstração e direitos por identidade, todos pendentes de confirmação. Não propõe novos GRANT/REVOKE: explicita a reutilização e a limitação da role proprietária existente nessa instância. Não exige segundo administrador na demonstração; identifica a regra empresarial de entrega separadamente. Nenhuma alteração de acesso foi executada. SGF real/Tempo preservados em **0.1.1**; proposta de implantação real abaixo fica adiada, não autorizada.
|
||||
|
||||
## Candidata corrigida em reprodução isolada — 02/11/2026
|
||||
|
||||
**Estado actual:** candidata `OPERATIONAL-CANDIDATE-401ce31ae5f2dd20` preparada e verificada; **SGF permanece em 0.1.1, sem instalação, activação ou alterações SQL no destino**. Esta secção sucede aos bloqueantes da proposta anterior, preservada abaixo. [Decisão actualizada e procedimento de instalação/recuperação](decisao-instalacao-sgf.md); [prova com 157 controlos](proofs/sgf-corrected-delivery.json); [proposta SQL não aplicada](proofs/sgf-corrected-sql-plan.json).
|
||||
|
||||
[ZIP privado](../storage/app/private/candidate-archives/OPERATIONAL-CANDIDATE-401ce31ae5f2dd20.zip): SHA-256 `59dbdc64c4d9f14dfb4025a6177b829d136a4e2cb633ca036b10b5ae3197e703`; manifesto `a6478223e17a5430652f0fcbf31a44a931ae2a99cd90b151c98d2df5df43c10b`. Distribuição autónoma com assets compilados; não depende da pasta Compras no cliente, nem inclui fixtures, credenciais ou dados de desenvolvimento.
|
||||
|
||||
### Matriz reconciliada — prevalece sobre estados históricos abaixo
|
||||
|
||||
| Processo/adaptador/ecrã | Estado no destino | Resultado da candidata corrigida |
|
||||
| --- | --- | --- |
|
||||
| Projecção partilhada de stock 0.1.1 | **Transferido** | Ponteiro e comportamento instalado preservados. |
|
||||
| Requisição interna → submissão → aprovação independente → consulta | **Parcialmente transferido — candidata não instalada** | Motor partilhado e adaptador SGF ensaiados com três tipos básicos, reserva existente, origem/versões/histórico e permissões no servidor; provas anteriores de concorrência reutilizadas. |
|
||||
| Migração e dependências do orçamento | **Parcialmente transferido — candidata não instalada** | Revisão 2: 16 tabelas, incluindo `cb_ui_commands`/`cb_consumption_sources`; falha e restauro de schema/dados ensaiados em reprodução das 87 tabelas actuais. |
|
||||
| Centros/dotações pela interface | **Parcialmente transferido — candidata não instalada** | Novo ecrã de preparação; APIs autorizadas reutilizam o orçamento existente e aprovação independente. Valores reais continuam pendentes; nenhum seed sintético no pacote. |
|
||||
| Catálogo administrativo e ecrãs SGF | **Parcialmente transferido — candidata não instalada** | Catálogo/rótulos do servidor consumidos pelo frontend compilado; integração na entrada modular e gestão de concessões testadas sem outorga automática. |
|
||||
| Ligação migradora e SQL mínimo | **Pendente de confirmação da operação real** | Roles separadas ensaiadas; plano GRANT/REVOKE apenas para novos objectos, nunca executado no destino. Não promover runtime nem mudar direitos públicos por arrasto. |
|
||||
| Instalação/actualização/recuperação | **Parcialmente transferido — candidata não instalada** | Aplicação em cópia isolada, sucessora de código e reversão preservam dados; restauro reconcilia 103 tabelas e runtime restrito. Backup/restauro dos dados reais continua obrigatório na janela aprovada. |
|
||||
| Navegação modular SGF | **Transferido — aceitação técnica própria documentada** | Provas anteriores reutilizadas; entrada/assets e guardas conferidos na composição corrigida. Revisão visual, associações antigas e volume separados. |
|
||||
| Equipamentos/peças | **Fora do âmbito básico** | Tipos rejeitados no servidor; não impedem consumíveis/serviços/outros, nem são convertidos silenciosamente. |
|
||||
| Entrega/configuração real e activação | **Pendente** | Dois administradores nominativos, centros/dotações reais, perfis, política e âmbito definidos pela empresa; sem criação ou promoção automática. Contratações para terceiros continuam excluídas. |
|
||||
|
||||
A reprodução exportou **apenas estrutura/metadados**, não dados de negócio/contas do destino. Criou centros/dotações sintéticos através das APIs, testou com runtime sem ownership/CREATE e restaurou em segunda base descartável. Bases e roles sintéticas removidas; destino reconferido sem alteração de schema, segurança ou ponteiro. Não se repetiram as suites integrais já aceites nem a via de navegador bloqueada. As referências à candidata antiga e às lacunas abaixo conservam valor histórico; não descrevem a cobertura actual.
|
||||
|
||||
## Decisão de instalação — proposta sem execução, 02/11/2026
|
||||
|
||||
O âmbito escolhido pelo proprietário é **decidir a instalação, sem a executar**. A [decisão concreta](decisao-instalacao-sgf.md) identifica projecto/base efectivos, candidata/hashes, schema/catálogos, bloqueantes e backup/restauro/recuperação. Os planos de leitura de código/schema passaram e o ZIP foi reconferido. O [inventário do destino](proofs/sgf-installation-decision-inventory.json) foi obtido em transacção PostgreSQL READ ONLY; nenhuma suite foi repetida.
|
||||
|
||||
**Recomendação: não instalar esta candidata como percurso operacional ainda.** O destino `C:\laragon\www\sgf-tempo`, base `sgf_tempo_dev` em `127.0.0.1:55432`, tem 87 tabelas e usa `sgf_dev_app`, sem CREATE/ALTER necessários. Faltam a execução migradora/mapa de privilégios mínimos runtime e a preparação operacional de centros/dotações: não existem tabelas `cb_*`, a interface candidata apenas selecciona centros existentes e a interface orçamental actual depende de duas tabelas ausentes do schema candidato. As provas isoladas com role proprietária/cadastros preparados não cobriam esses aspectos do destino. Preservar o ZIP aprovado como evidência e resolver essas lacunas antes de propor a operação executável; novos bytes exigem novos hashes/provas.
|
||||
|
||||
**Catálogo administrativo:** implementado/testado na candidata, ainda não instalado; não é falta de implementação, mas não constitui direitos já atribuídos. **Equipamentos/peças:** fora do recorte básico de consumíveis/serviços/outros, não são o seu bloqueio. Há uma concessão de administração da empresa no destino; a regra de dois administradores permanece pendente para entrega/activação, sem criar conta ou atribuir direitos por conveniência. A eventual instalação técnica desactivada é diferente de abrir o percurso aos utilizadores.
|
||||
|
||||
**Navegação modular: tecnicamente aceite em 02/11/2026**, conforme [registo próprio do SGF](../../sgf-tempo/docs/MODULAR_NAVIGATION_DELIVERY.md). Manter separadas revisão visual/recargas, associações antigas e volume/paginação. Essa aceitação não autoriza instalar a candidata, alterar direitos públicos ou publicar. O SGF continua em **0.1.1**. Não foram executados `migrate`, `apply`, `cache`, backups, concessões, manutenção ou paragem/reinício de serviços.
|
||||
|
||||
## Reconciliação com a entrega modular do SGF — 02/11/2026
|
||||
|
||||
A conferência documental posterior encontrou uma entrega própria de navegação modular no SGF: [implementação e estado](../../sgf-tempo/docs/MODULAR_NAVIGATION_DELIVERY.md), [conclusão técnica](../../sgf-tempo/docs/MODULAR_NAVIGATION_COMPLETION.md) e [conferência de 02/11/2026](../../sgf-tempo/docs/proofs/modular-navigation-recheck-20261102.json). Portanto, **a indicação anterior «sem resultado apresentado» fica sucedida por «entrega técnica documentada, com encerramento pendente»**. Não repetir implementação ou testes já registados com base naquele estado histórico.
|
||||
|
||||
Segundo essa entrega, os módulos são Comercial, Compras, Stock, Oficinas, Financeiro e Contabilidade; Início e Opções gerais estão separados do módulo activo. A entrega regista 185 testes/3.220 asserções de regressão, 8 testes/90 asserções focados e três perfis sintéticos num ambiente próprio. A conferência registada comparou 184 ficheiros com a cópia validada, confirmou hashes de JUnit e preservação de concessões/pertenças/auditoria/guarda/ponteiro, sem repetir testes ou provisionamento. Esta retoma de Compras **leu e reconciliou essas provas**, não executou novamente essa conferência nem as suites. Instância isolada documentada: `http://127.0.0.1:8039`.
|
||||
|
||||
Continuam separados: [revisão visual pendente](../../sgf-tempo/docs/MODULAR_NAVIGATION_VISUAL_REVIEW.md), incluindo recargas de páginas autónomas; reconciliação humana das associações antigas; avaliação de volume/paginação antes de implantação. A interface usa «Opções gerais», não um submenu único literalmente chamado «Configuração». Não declarar aceitação visual, cobertura operacional dos módulos em preparação ou disponibilização comercial integral.
|
||||
|
||||
Esta entrega modular não instala a candidata de requisições nem substitui as suas provas de código/schema/caches. A integração candidata continua preparada e verificada no âmbito descrito abaixo; o SGF de destino permanece em 0.1.1. **Não houve instalação, activação, alteração de código/permissões ou nova tentativa de navegador nesta reconciliação.** A decisão de instalar continua separada, conforme instrução do proprietário.
|
||||
|
||||
## Actualização entre bundles e caches nativos — 02/11/2026
|
||||
|
||||
**Concluído neste incremento candidato:** transição de código entre bundles já instalados, reversão para o anterior e compilação/recuperação dos caches Laravel nativos. **32 controlos novos aprovados**, sem repetir as suites anteriores. Prova e hashes em [proofs/sgf-update-cache-delivery.json](proofs/sgf-update-cache-delivery.json). A candidata é `OPERATIONAL-CANDIDATE-5fae7cf7f99c42ba`, com [ZIP de revisão](../storage/app/private/candidate-archives/OPERATIONAL-CANDIDATE-5fae7cf7f99c42ba.zip); SHA-256 do ZIP `d14a3261d5aaab80f96250af781c700ab53376021f4638e3aee43c15ff37ceed` e do manifesto `b1ec47f7a9ad87e0b232bac41e402d4a00ee5f03f00a79b93effc692ce8b39a2`. Não foi publicado no canal, instalado ou activado no destino. SGF mantém **0.1.1**.
|
||||
|
||||
As pendências históricas de transição entre versões e ensaio dos caches padrão, registadas nas secções seguintes, são sucedidas por este resultado. Não se altera o âmbito das provas anteriores nem se declara concluída a reorganização modular do SGF.
|
||||
|
||||
### Transição com proveniência local
|
||||
|
||||
`plan` reconhece a versão de código seleccionada pelo registo privado `storage/app/private/module-deployments/current.json`, distinto do ponteiro `packages/purchasing/current.json` que permanece intacto. Confere o journal, os bytes e o manifesto do bundle instalado; rejeita alterações locais, conteúdo extra, bundle sem proveniência, mudança de baseline/composição dos ficheiros nativos ou diferenças nos ficheiros de preparação do schema/catálogo. A transição implementada cobre código sob o **mesmo contrato de schema**. Alterar esse contrato exige plano/revisão de migração próprios; não executa uma migração implicitamente.
|
||||
|
||||
`apply` guarda o bundle anterior na instalação, troca o código sob manutenção/serviços parados e actualiza atomicamente o registo privado da versão seleccionada. `rollback` repõe o bundle, ficheiros nativos e proveniência anteriores, sem depender da pasta de Compras, base de desenvolvimento ou ficheiros da origem. Recusa reversão fora de ordem e replay de uma versão que já não está seleccionada. Uma nova tentativa depois de uma reversão recebe outro ID; os journals anteriores permanecem preservados. A repetição de uma reversão já concluída não volta a alterar código/caches da versão anterior.
|
||||
|
||||
O registo privado é criado pela rotina actual. Uma cópia antiga/manual de bundle, sem esse registo, não é adoptada automaticamente: exige reconciliação explícita da proveniência. Este requisito preserva os ficheiros existentes e não atribui direitos funcionais. Continua a não haver outorga automática, alteração do perfil ou importação de dados de desenvolvimento.
|
||||
|
||||
### Compilação nativa e recuperação de caches
|
||||
|
||||
A CLI tem agora a acção `cache`, que usa o mesmo PHP fixado para executar **`config:cache`, `route:cache` e `event:cache` no próprio host**, com manutenção/serviços parados. Arquiva os caches anteriores em armazenamento privado, invalida-os antes de arrancar Artisan e regista comandos/resultado/hashes dos ficheiros produzidos, incluindo resultados parciais quando uma compilação falha. Assim, um `config.php` truncado não impede a CLI de o preservar e reconstruir a configuração a partir das fontes actuais. Os logs e cópias compiladas ficam privados e não são incluídos no ZIP cliente.
|
||||
|
||||
Se tiver havido compilação registada, a reversão invalida esses caches e conserva-os em arquivo privado; não repõe silenciosamente valores compilados antigos sobre configuração posterior. Depois de repor o bundle anterior, executar `cache` para o ID dessa versão e reiniciar os seus serviços antes de reabrir. Se não tiver havido recompilação, mantém-se a reposição exacta dos caches anteriores já ensaiada. Alterações aos caches após a compilação registada continuam a bloquear uma reversão cega e exigem reconciliação. Caches com caminhos personalizados continuam fora do contrato actual e são recusados antes de aplicação/recuperação.
|
||||
|
||||
```text
|
||||
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "<raiz-SGF>/scripts/sgf.ps1" php "<candidata>/scripts/sgf-code-deploy.php" plan "<raiz-SGF>" "<candidata>" <manifest-sha256>
|
||||
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "<raiz-SGF>/scripts/sgf.ps1" php "<candidata>/scripts/sgf-code-deploy.php" apply "<raiz-SGF>" "<candidata>" <manifest-sha256> <target-codigo-sha256> "<operador>" --offline
|
||||
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "<raiz-SGF>/scripts/sgf.ps1" php "<candidata>/scripts/sgf-code-deploy.php" cache "<raiz-SGF>" <deployment-id-seleccionado> "<operador>" --offline
|
||||
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "<raiz-SGF>/scripts/sgf.ps1" php "<candidata>/scripts/sgf-code-deploy.php" rollback "<raiz-SGF>" <deployment-id-a-reverter> "<operador>" --offline
|
||||
```
|
||||
|
||||
Para uma actualização: conferir a origem aprovada, os hashes e o plano; preservar o destino e parar os serviços em manutenção; aplicar o bundle; compilar os caches para o ID devolvido; reiniciar apenas os serviços dessa instalação e conferir o seu arranque; reabrir só pela decisão de activação separada. Para reverter: parar serviços em manutenção, reverter o ID seleccionado, compilar os caches da versão anterior reposta e reiniciar/conferir antes de reabrir. Dados/schema/permissões não são restaurados por estes comandos. A preparação de schema continua no executor separado, apenas quando houver uma migração prevista e ensaiada.
|
||||
|
||||
### Âmbito exacto das novas provas
|
||||
|
||||
Ensaiada transição real entre a candidata anterior `10dce6cd57fa1f31` e a nova, recuperação de falha entre preservação/troca dos bundles, reversão e nova tentativa com histórico distinto. Confirmadas recusas de origem desconhecida, schema divergente, alteração local/conteúdo extra e reversão fora de ordem. A segunda cópia inclui aplicação e dependências, sem `.env` ou dados reais; para acelerar o ensaio, as dependências imutáveis usam hardlinks **apenas para uma cópia descartável anterior**, nunca para o vendor do SGF de destino. Não se executam comandos Composer que alterem essas dependências.
|
||||
|
||||
Na cópia isolada foram executados os três comandos de cache nativos, falha injectada após `config:cache`, recuperação de cache inválido pela CLI e reinícios efectivos do servidor PHP local de teste. A rota em cache manteve autenticação (401 para anónimo), manutenção manteve bloqueio (503) e o host voltou a responder após reversão, sem a rota retirada (404) e com healthcheck 200. Os reinícios cobrem o servidor de teste, **não certificam todos os gestores de serviços de clientes**. Nenhum serviço, base, direito público ou ponteiro do SGF de destino foi alterado. Nenhuma contratação para terceiros foi incluída.
|
||||
|
||||
O ZIP contém código/manifesto locais com integridade conferida, sem base, credenciais, documentos, cache de cliente ou dependências copiadas de desenvolvimento. Pode ser transportado e extraído para uma pasta de preparação no cliente; conferir hashes e executar as ferramentas pelo PHP do próprio SGF. Não extrair directamente sobre a raiz do host. A aprovação do canal de confiança e a decisão de instalar/activar continuam separadas; a preparação do ZIP não é publicação ou autorização de implantação.
|
||||
|
||||
## Aplicação e reversão offline do código — 02/11/2026
|
||||
|
||||
Implementadas `integrations/sgf/operational/CodeDeployment.php` e CLI `scripts/sgf-code-deploy.php`, incluídas na candidata `OPERATIONAL-CANDIDATE-10dce6cd57fa1f31`. **42 controlos novos aprovados** com PHP 8.4.27 fixado do SGF, apenas sobre cópias descartáveis de ficheiros; sem abrir bases, reiniciar serviços ou repetir suites anteriores. Ver [proofs/sgf-code-deploy-delivery.json](proofs/sgf-code-deploy-delivery.json). O SGF instalado continua em **0.1.1** e nenhuma aplicação/reversão foi executada nesse destino.
|
||||
|
||||
A rotina distingue `plan` read-only, `apply` e `rollback`. Confere manifesto e conteúdo, hashes anteriores dos ficheiros do host e impressão do destino, mantém lock exclusivo e prepara cópias anteriores em `storage/app/private/module-deployments/<id>`. O journal durável é escrito antes de começar a substituir código; cada ficheiro é preparado e trocado por rename no seu directório e o bundle é preparado separadamente antes da troca. **Isto não é uma transacção de filesystem sobre todos os ficheiros:** a consistência visível exige manutenção e serviços de escrita parados durante toda a implantação/recuperação. Uma interrupção deixa o journal para recuperação explícita, sem reabrir o serviço automaticamente.
|
||||
|
||||
`apply` exige manutenção Laravel baseada em `storage/framework/down` e `--offline`, que é a declaração do operador de que parou web/workers/schedulers responsáveis por escritas. A rotina não detecta nem termina processos. Guarda os caches padrão `config.php`, `events.php`, `packages.php`, `services.php` e `routes*.php` existentes em `bootstrap/cache`, invalida-os e preserva outros ficheiros. Os backups de configuração compilada podem conter segredos e ficam exclusivamente no armazenamento privado local, com permissões restritas do sistema; não integram o artefacto distribuído. Caches configurados por `APP_*_CACHE` fora das localizações padrão são recusados antes da aplicação: não são apagados nem presumidos cobertos.
|
||||
|
||||
`rollback` confere código, backup e caches antes de restaurar; recusa alterações locais desconhecidas e caches recriados, em vez de sobrescrever trabalho ou configuração posterior. Repõe os bytes anteriores dos ficheiros/caches e retira o bundle para arquivo privado de diagnóstico. Recupera igualmente aplicação interrompida a meio dos ficheiros ou depois da troca do bundle. Não apaga schema, dados, recibos de negócio, permissões ou operações posteriores. Conserva o ponteiro `packages/purchasing/current.json` e deixa manutenção activa. A existência de `restart_required=true` é uma obrigação operacional, não prova de reinício automático.
|
||||
|
||||
### Sequência de implantação, após decisão separada
|
||||
|
||||
1. Produzir/conferir a candidata e manifesto por canal de confiança. Executar `plan` de schema e `plan` de código e registar as duas impressões de destino. Conferir o destino e preservar dados/documentos/configuração. A rotina de código não substitui o backup/restauro de PostgreSQL.
|
||||
2. Entrar em manutenção pelo procedimento do host (`artisan down`, driver de ficheiro) e parar os serviços de escrita daquela instalação. Não usar comandos de demonstração que também parem outras instalações. Não executar `apply` com serviços em funcionamento.
|
||||
3. Executar a preparação de schema `sgf-internal-install.php migrate`, com backup/manifesto/destino conferidos, conforme secção própria. Nenhuma concessão é atribuída por essa preparação.
|
||||
4. Executar `sgf-code-deploy.php apply` com o hash do manifesto, impressão do plano de código, operador nominativo e `--offline`. Registar `deployment_id`. A rotina confere e aplica apenas código/bundle e invalida caches conhecidos; não activa configuração comercial nem concede direitos.
|
||||
5. Mantendo a manutenção, conferir os ficheiros e o journal, configurar explicitamente o destino/âmbitos e os acessos aprovados pelo percurso administrativo, e reiniciar os processos persistentes pelo gestor de serviços daquela instalação para descartar código/opcache antigo. A atribuição administrativa que requer HTTP terá de usar uma janela controlada depois do arranque; não contornar os middlewares nem inserir concessões por SQL para evitar essa etapa. Remover a manutenção e abrir aos utilizadores só depois de conferir a instalação e da decisão de activação. Estas acções de serviços/configuração/abertura são do operador e não são executadas pela CLI.
|
||||
6. Em falha de código, manter/parar novamente os serviços em manutenção, executar `rollback` com o ID registado, conferir a reposição, reiniciar os serviços e só então decidir reabrir. Se houver código ou caches alterados depois da aplicação, a rotina recusa a recuperação: preservar esses estados e reconciliar explicitamente antes de tentar novamente. Não executar `down` de migrações nem restaurar backup de dados por efeito de rollback de código.
|
||||
|
||||
CLI pelo PHP fixado do host; exemplos com parâmetros, **não executados no SGF de destino**:
|
||||
|
||||
```text
|
||||
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "<raiz-SGF>/scripts/sgf.ps1" php "<candidata>/scripts/sgf-code-deploy.php" plan "<raiz-SGF>" "<candidata>" <manifest-sha256>
|
||||
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "<raiz-SGF>/scripts/sgf.ps1" php "<candidata>/scripts/sgf-code-deploy.php" apply "<raiz-SGF>" "<candidata>" <manifest-sha256> <target-codigo-sha256> "<operador>" --offline
|
||||
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "<raiz-SGF>/scripts/sgf.ps1" php "<candidata>/scripts/sgf-code-deploy.php" rollback "<raiz-SGF>" <deployment-id> "<operador>" --offline
|
||||
```
|
||||
|
||||
**Limites exactos:** esta versão cobre primeira instalação sobre o baseline conferido e recusa um bundle já existente ou ficheiros nativos divergentes. Ainda não implementa transição entre versões do novo bundle; o updater anterior de código 0.1.1 conserva apenas o seu âmbito já demonstrado. Os controlos de caches deste incremento verificam invalidação e restauro byte a byte dos ficheiros padrão, não regeneração de todos os caches em Laravel nem automação de gestores de serviços. A prova HTTP anterior de 27 controlos mantém o seu âmbito; não foi repetida sobre cada combinação de caches. Não declarar disponibilização comercial completa nem aceitar actualizações futuras sem a respectiva transição/compatibilidade. A reorganização modular permanece entrega distinta.
|
||||
|
||||
## Arranque e integração HTTP em cópia isolada — 02/11/2026
|
||||
|
||||
Preparada a candidata `OPERATIONAL-CANDIDATE-4b25f81932efd69d`, preservando os artefactos anteriores. A composição já inclui sobreposição do provider nativo para carregar o bundle local e registar as rotas, sem registo manual de rotas pelo harness HTTP. O bundle fica em `packages/internal-requisitions`, com classes e ficheiros próprios; a sobreposição do SGF reconhece `purchasing_requisitions.view` como autorização de descoberta do módulo Compras, sem conceder direitos nem substituir o catálogo/controlo funcional.
|
||||
@@ -40,10 +208,11 @@ Estados: **Transferido** identifica a capacidade exacta instalada e executada no
|
||||
| Cálculo de projecção de reposição | **Transferido** | Mesmo motor de consumo manual, média racional, reservas/entregas e lotes; sem persistência própria | Carregamento local independente do checkout de Compras; não concede acesso a dados | Sem novo ecrã; capacidade de cálculo instalada | Pacote activo `0.1.1`, dois testes SGF e prova de cliente independente |
|
||||
| Orçamento de Compras no núcleo comum | **Parcialmente transferido** | `packages/budget-control` comum anterior; mesmo motor de reserva | Composição operacional candidata com destino/schema/âmbito explícitos; adaptador instalado continua QA | Interface anterior e candidata de requisições; arranque/rotas operacionais ainda não integrados | 20 controlos novos de preparação; restauro em production/base fora do prefixo QA verificado; sem instalação/activação no destino |
|
||||
| Preparação de schema da integração | **Parcialmente transferido — candidata não instalada** | Migração transaccional, contrato do orçamento, registo imutável de revisão/hashes/operadores/backup | CLI `plan`/`migrate` local ao host, sem cópia de dados sintéticos ou concessões | Sem ecrã ou activação implícita; CLI de preparação não substitui instalação de código/rotas | Prova nova `sgf-operational-delivery.json`; destino 0.1.1 preservado |
|
||||
| Aplicação/actualização/reversão do código da nova integração | **Parcialmente transferido — candidata não instalada** | Journal/backups e registo privado da versão, lock, preservação do bundle anterior; sem efeitos de dados/schema | CLI `plan/apply/cache/rollback`, com proveniência e contrato de schema iguais; serviços parados pelo operador | Transição, falhas e reversão ensaiadas; caches nativos compilados e servidor isolado reiniciado; nenhuma abertura automática no cliente | 32 controlos novos em `sgf-update-cache-delivery.json`, além das provas anteriores; caches personalizados e migrações futuras exigem plano próprio; destino 0.1.1 |
|
||||
| Factura conferida → obrigação a fornecedor | **Parcialmente transferido** | Núcleo comum de obrigações anterior, com origem única | Adaptador SGF e API no âmbito sintético; sem passagem automática de tabelas/IDs de Compras | Consulta/decisão do percurso anterior; sem workflow integral de recepção/conferência de facturas de Compras | `SupplierPayables` conserva guarda de ensaio; fornecedor de histórico SGF não concluído conforme entregas anteriores |
|
||||
| Pagamentos e afectações a fornecedores | **Parcialmente transferido** | Núcleo comum e entregas anteriores preservados | Adaptadores/autorizações delimitados nas respectivas entregas; não representam migração de contas ou histórico de cliente | Percurso anterior existe no âmbito documentado; integração completa com novas origens de Compras pendente | `SUPPLIER_SETTLEMENT_DELIVERY.md` e limites de histórico/origens; não afirmar financeiro integral |
|
||||
| Identidade, empresa/unidade, perfis e módulos adquiridos | **Parcialmente transferido** | Fundações próprias existentes nos dois hosts; não se fundiram tabelas-base | SGF mantém tenant/empresa fiscal/unidade/concessões; correspondência explícita com o contexto Purchasing por concluir | Sessão/contexto SGF existentes; selector SGC não foi incorporado automaticamente | Sem associação por igualdade de nome, email ou ID; parametrização comercial e permissões continuam distintas |
|
||||
| Reorganização modular do SGF pedida posteriormente | **Pendente — sem resultado apresentado** | Entrega distinta da integração candidata de requisições | Não avaliada nem concluída por esta conferência | Não inferir reorganização entregue a partir dos ecrãs candidatos | Exige apresentação própria do âmbito, alterações e resultado; não executada por arrasto |
|
||||
| Navegação modular do SGF, entrega própria | **Tecnicamente aceite — 02/11/2026** | Seis módulos, Início/Opções gerais separados; não equivale a todos os processos comerciais concluídos | Provas SGF próprias de contexto, autorização e perfis sintéticos; sem outorga adicional por escolha de módulo | Revisão visual/recargas, associações antigas e volume/paginação mantêm pendências próprias | Aceitação expressa em `MODULAR_NAVIGATION_DELIVERY/COMPLETION`; 185 testes/3.220 asserções preservados; não autoriza a instalação da candidata |
|
||||
| Requisição interna: rascunho, submissão, aprovação independente e consulta | **Parcialmente transferido — candidata; não activa** | Motor único `InternalRequisitions`, adaptadores dos dois hosts; recibos, versões e histórico; reserva existente na mesma transacção | Contexto interno, empresa/unidade, autorização renovada e identidade independente; composição no provider e associação do novo direito de consulta ao módulo preparadas | Ecrãs e percurso integrados na cópia isolada pelo arranque nativo; nenhuma rota/menu novo activo no destino | Provas anteriores preservadas; novo ensaio de composição HTTP em `sgf-composition-delivery.json`; aplicação operacional do código/caches e equipamentos/peças pendentes; destino 0.1.1 |
|
||||
| Planeamento de compras | **Pendente** | Itens, marcos e associação a requisições permanecem em Compras | Adaptar unidades, centros, intervenientes e vínculos de origem no SGF | Planeamento e acompanhamento de marcos SGF do roteiro de Compras pendentes | Não gerar requisições duplicadas nem inferir reserva/decisão a partir de um plano |
|
||||
| Fornecedores, documentos e dados bancários | **Pendente** | Cadastros/versionamento de Compras ainda não extraídos | Definir correspondências autorizadas de fontes e permissões, sem fundir entidades por nome | Cadastro, validações e consulta SGF de todo o percurso pendentes | Preservar fotografias utilizadas e validação bancária independente |
|
||||
@@ -244,3 +413,13 @@ O manifesto exige `database_changes=false` e o formato não aceita pastas de mig
|
||||
- Fachada e motor comum passaram análise PHP dirigida. Fonte do mecanismo e artefactos SGF conferidos em `packages/module-updates/runtime-manifest.json`.
|
||||
|
||||
**Limitação central:** este mecanismo actualiza as capacidades já extraídas para o pacote; não transfere automaticamente melhorias ainda confinadas aos controladores/serviços/ecrãs de Compras. Continuar a migração pela matriz acima, sem declarar todo o SGF actualizado só porque a versão do pacote mudou. Não há publicação no domínio ou conclusão de integração de RH nesta entrega.
|
||||
|
||||
## 02/11/2026 — candidata utilizável SGF, sem instalação
|
||||
|
||||
Preparada `OPERATIONAL-CANDIDATE-401ce31ae5f2dd20` (schema revisão 2); ZIP SHA-256 `59dbdc64c4d9f14dfb4025a6177b829d136a4e2cb633ca036b10b5ae3197e703`, manifesto `a6478223e17a5430652f0fcbf31a44a931ae2a99cd90b151c98d2df5df43c10b`. Não substituir por candidata anterior nem declarar release comercial nova.
|
||||
|
||||
Resolve cb_ui_commands/cb_consumption_sources, ecrã nativo de Acessos ligado ao catálogo, centros/dotações pela interface e aprovação independente. Assets compilados incluídos no bundle; nove overlays exactos com baselines, sem escrita no código instalado. Mapa SQL mínimo separado, revogando defaults excessivos apenas nos objectos novos; não aplicado ao destino. Nenhum utilizador real recebe direitos.
|
||||
|
||||
Reprodução schema-only do SGF actual (87 tabelas, zero linhas exportadas), roles sintéticas restritas separadas: 157 controlos integrados; 17 controlos React/render/assets; 54 aplicação/interrupção/recuperação. Backup restaurado em segunda base, 103 tabelas reconciliadas e origem/reserva/decisão preservadas. Actualização de código compatível e rollback conferidos sem alterações de dados. Bases/roles de prova removidas. Provas em docs/proofs/sgf-corrected-delivery.json e sgf-code-deploy-delivery.json; prova consolidada e proposta vinculativa em `C:/laragon/www/sgf-tempo/docs/PURCHASING_INSTALLATION_PROPOSAL.md`.
|
||||
|
||||
Não houve instalação/activação/publicação; SGF mantém 0.1.1 e sgf_tempo_dev/direitos públicos preservados. Equipamentos/peças excluídos; básico consumíveis/serviços/outros provado. Revisão visual, associações antigas e volume/paginação continuam pendentes. Código funcional modular a preservar: 2a4169162bb4621a42a2ea1df627d52f860e7176; fcf0ada é documental. Instalação e configuração real dependem de decisão posterior; nunca confundir bundles anteriores com recuperação de dados.
|
||||
|
||||
Reference in New Issue
Block a user