feat: verify active opportunity management and prepare versioned resources
This commit is contained in:
@@ -221,3 +221,11 @@ Todos mantêm estado editorial `published` e inclusão no filtro público do cat
|
||||
### Gestão de Oportunidades — confirmação da instalação ativa
|
||||
|
||||
Leitura em 09/10/2026 06:34:48 UTC: migration aplicada uma vez; evento `opportunity_management_installed` em 06:29:42 UTC, conta 13. Seis IDs classificados real, dados originais e relações iguais ao backup, 124 eventos históricos intactos; apenas um evento de instalação novo. [Confirmação detalhada](gestao-oportunidades-dashboard.md#confirmação-ativa--9-de-outubro-063448-utc). Nenhuma reinstalação ou escrita ativa pelo Codex. Imagens/documentos/multilocalização passam ao próximo incremento QA; workflow final e módulos especializados continuam pendentes.
|
||||
|
||||
### V2 — imagens, documentos e multilocalização: incremento QA
|
||||
|
||||
[Requisitos por secção, evidência e plano único](recursos-oportunidades.md). Originais em `documents`, territórios em `geo_locations`, metadados associados à mesma oportunidade; recuperação, versões/ETag, motivo/confirmação, exclusão lógica/restauro e retenção implementados. Localizações até 50, papéis/unidades/áreas/distribuição, fonte/data e GeoJSON; implantação/contexto/impacto/abrangência separados. Relações existentes não são reinterpretadas. Cifragem de novos originais/derivados, scan pelo job existente e URLs autenticadas temporárias. Derivadas GD testadas apenas em QA; PHP ativo sem GD carregado e ClamD real indisponível.
|
||||
|
||||
**QA:** 80 testes passaram, 1 252 asserções, três casos reais de ClamD saltados; percurso desktop/móvel e nova sessão sem armazenamento local passaram. Restauro/reversão de 288 tabelas/cinco ficheiros; 14 conjuntos preservados após navegador. **Ativo:** gestão básica confirmada; seis IDs reais e 124 eventos anteriores preservados, dois eventos posteriores; recursos ainda não instalados, zero eventos próprios. Plano `/management/opportunity-resources-install`, válido até 10/10/2026 11:09:13 UTC, exclusivamente autenticado.
|
||||
|
||||
**Lacunas mantidas:** publicação/revisão segregada, direitos/dados pessoais, editor cartográfico integral/limites oficiais em falta, catálogos pesquisáveis, evidências por campo, módulos especializados e critérios integrais da especificação. Cobertura do inventário, questões jurídicas, ClamD real, fontes institucionais específicas e primeiro pedido real continuam separados. Fontes oficiais já aceites não exigem segunda validação.
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Gestão de Oportunidades integrada no Dashboard
|
||||
|
||||
Entrega de 9 de outubro de 2026. **Primeiro incremento implementado e validado em QA; não instalado na base ativa. A especificação integral não está concluída.**
|
||||
Entrega de 9 de outubro de 2026. **Primeiro incremento instalado pelo utilizador e confirmado por leitura. O incremento de recursos está preparado em QA, ainda não aplicado. A especificação integral não está concluída.**
|
||||
|
||||
## Fonte e reconciliação
|
||||
|
||||
@@ -12,7 +12,7 @@ Disponibilidade: consulta interna autorizada pelo pedido. Situação documental:
|
||||
|
||||
O cadastro anterior usava `Opportunity`, setores, territórios e relações existentes, mas exigia título/setor/moeda para guardar e permitia publicação pelo editor genérico. O incremento reutiliza essas entidades, dashboard, gate `manage-portal`, `audit_events` e geografia. Não executa SQL documental: mantém IDs bigint existentes em vez dos UUID dos exemplos. Referências técnicas novas são geradas pelo servidor; título, setor e moeda desconhecidos permanecem nulos.
|
||||
|
||||
## Matriz de cobertura
|
||||
## Matriz de cobertura da primeira entrega
|
||||
|
||||
| Fonte / requisito | Estado | Implementação e lacuna |
|
||||
| --- | --- | --- |
|
||||
@@ -45,7 +45,7 @@ Após navegador: oportunidades originais, relações, favoritos, pedidos, recibo
|
||||
|
||||
## Plano único de ativação
|
||||
|
||||
Abrir com conta autorizada [a página de instalação](http://127.0.0.1:8000/management/opportunity-management-install), rever plano/backup/destino, assinalar confirmação e executar **Aplicar plano de gestão**. **Não executado pelo Codex.** Até instalar, lista/editor serve o cadastro anterior, pois o esquema novo está ausente.
|
||||
Plano inicial na [página de instalação](http://127.0.0.1:8000/management/opportunity-management-install), **já executado pelo utilizador** em 09/10/2026 06:29:42 UTC. Não repetir. As provas abaixo registam a preparação histórica; o novo plano de recursos está no relatório ligado no final desta página. O Codex apenas confirmou a instalação por leitura.
|
||||
|
||||
Migration única `2026_10_09_020000_extend_opportunity_management`: permitir nulos em título/setor/moeda para drafts; acrescentar versão, categoria, proposta, chave idempotente, primeira submissão e marca histórica de fecho; instalar guarda de eliminação física. Não altera valores de negócio, classificações ou relações existentes. A página confere hash do plano/código, identidade, integridade do backup/restauro e QA desta versão, validade de 24 h; exige autenticação/permissão e audita aplicação.
|
||||
|
||||
@@ -60,3 +60,9 @@ Pendências separadas: cobertura do inventário, questões jurídicas específic
|
||||
Leitura transacional `READ ONLY` confirma a migration aplicada uma vez. Evento `opportunity_management_installed`, ID `08c433b9-ba6d-4270-9034-78ec5b69e2f9`, conta 13, em 06:29:42 UTC, hash `1ae520dcb5427e0dbfb3fcbfbb75b188acb949a54248a39fc38b71241ca54f26`. Nenhuma reinstalação executada.
|
||||
|
||||
Os seis IDs continuam classificados real. Comparação do conteúdo original das oportunidades (excluindo apenas colunas acrescentadas pela migration) e dez conjuntos relacionados confirma hashes iguais ao backup: seis registos, 28 localizações de projetos, 13 relações cluster–projeto, quatro pedidos/recibos, uma mensagem e 124 eventos anteriores preservados. Zero novas relações oportunidade–projeto/cluster. Apenas o evento de instalação foi acrescentado. Evidência privada `opportunity-management-active-read-only.json`; leitor versionado `tools/opportunity-management-active-preview.php`. O estado atual da primeira entrega é **aplicado pelo utilizador e confirmado por leitura**; as lacunas funcionais mantêm-se.
|
||||
|
||||
## Próximo incremento — recursos em QA
|
||||
|
||||
[Imagens, documentos e multilocalização: matriz, QA, lacunas e plano](recursos-oportunidades.md). Guardar/recuperar recursos, originais cifrados, versões e exclusão lógica/restauro implementados; coleção territorial até 50 itens com hierarquia/papéis, áreas/distribuição e GeoJSON validado. Relações existentes conservadas; novas associações são preparação privada até workflow explícito. Processador GD gera WebP/miniaturas sem EXIF e scan independente; GD ativo e ClamD real mantêm dependências concretas. Não publicar automaticamente.
|
||||
|
||||
Leitura ativa em 11:10:21 UTC confirmou novamente os seis IDs reais, dados/relações e 124 eventos anteriores intactos; dois eventos posteriores explicam diferença global do histórico. Novo esquema de recursos ausente, zero eventos deste incremento. QA: 80 testes passaram/1 252 asserções, três ClamD reais saltados; navegador desktop/móvel passou. Plano único `/management/opportunity-resources-install`, backup/restauro e reversão em cópia, validade até 10/10/2026 11:09:13 UTC. Não aplicado automaticamente.
|
||||
|
||||
@@ -0,0 +1,56 @@
|
||||
# Recursos das oportunidades — imagens, documentos e multilocalização
|
||||
|
||||
Entrega de 9 de outubro de 2026, após a instalação confirmada da gestão básica. **Implementação e QA preparados; novo incremento não instalado na base ativa.** Mantém a especificação DOCX SHA-256 `9f173ed3024d2beddef7888b692d8b81fc5e4700249955f2bae9bdd2eb2be504`, as fontes oficiais aceites e as classificações reais dos IDs 1–6. Não certifica a especificação integral.
|
||||
|
||||
## Reutilização e limites de publicação
|
||||
|
||||
As oportunidades, IDs e relações existentes são mantidos. `documents` continua a guardar os originais e cada nova versão binária. `geo_locations` fornece os territórios e a hierarquia. As três coleções dedicadas são metadados da mesma oportunidade: `opportunity_documents`, `opportunity_images` e `opportunity_location_drafts`. A última é preparação da associação, não um segundo cadastro territorial; as relações `opportunity_locations` já aceites são apresentadas e conservadas, sem inferir papéis ou converter contexto em implantação.
|
||||
|
||||
Recursos novos permanecem em preparação privada, inclusive quando o campo de visibilidade proposto for público. Alterar estes metadados de uma oportunidade já publicada não modifica automaticamente a ficha pública. A revisão/submissão/publicação de uma versão completa continua no incremento de workflow. Não há aprovação institucional inferida nem publicação automática.
|
||||
|
||||
## Cobertura e requisitos ainda abertos
|
||||
|
||||
| Fonte | Implementado e testado | Lacuna concreta |
|
||||
| --- | --- | --- |
|
||||
| §11 — localizações | Coleção até 50 itens; hierarquia província/distrito/posto/localidade; múltiplos papéis/unidades; localização principal; áreas/unidades/distribuição; fonte/data; endereço; fundamento multidistrito; implantação/contexto/impacto/abrangência separados. Locais sem coordenadas guardados e recuperados. | Grelha/cartografia interativa integral, unidades de catálogo pesquisáveis e ligação a documento/página por seleção ainda pendentes. Requisitos finais são pendências visíveis, não bloqueiam rascunho. |
|
||||
| §11 — coerência territorial | Duplicação por hierarquia/papel/unidade rejeitada; principal duplicada rejeitada. Resumo confere exatamente uma principal, soma de distribuição 100% ±0,01, âmbito derivado, lacunas e fundamento multidistrito. | Compatibilidade espacial com limites oficiais ausentes mantém-se indeterminada; não reabre aceitação das fontes oficiais. |
|
||||
| §11 — geometrias | GeoJSON Point, LineString, Polygon/MultiPolygon EPSG:4326; PostGIS verifica validade, vazio e limites de coordenadas. Consulta por metadados; coordenadas não são inventadas. | Sem limites correspondentes, não declara compatibilidade territorial. Área poligonal/requisitos finais completos e desenho no mapa pendentes. |
|
||||
| §13 — documentos | PDF/DOCX/XLSX/PNG/JPEG, conteúdo/MIME e limites, checksum, original cifrado, categoria/emissor/edição/data/validade/classificação, secção/afirmação; substituição gera outro documento, preservando o anterior. | Evidências com proprietário/data de verificação e associação por campo, catálogos completos e workflow de aprovação documental pendentes. Fonte pendente não invalida um documento oficial já aceite. |
|
||||
| §16 — imagens | JPEG/PNG/WebP, dimensões mínimas 400×400, conteúdo básico, deteção de animação/código, checksum e repetição na mesma oportunidade; título/legenda/alt/autor/data/direitos/comprovativo/visibilidade/ordem/capa e ligação a localização. | Descodificação integral ocorre no processador GD; revisão humana de dados pessoais/direitos e aprovação não foram simuladas. Aviso de duplicados entre oportunidades, catálogo pesquisável e edição por arrastar pendentes. |
|
||||
| §16.1 — derivados | Processador GD explícito após scan do original; WebP responsivo sem metadados originais, sem deformar ou ampliar; originais preservados. Cada derivada recebe o próprio documento/hash/cifragem e scan independente. Pré-visualização autenticada com URL assinada por dez minutos. | GD não está carregado no PHP ativo; validação do processador feita apenas em processo QA com extensão carregada. ClamD real indisponível; nenhum ficheiro real declarado limpo. |
|
||||
| §15.2/15.3 — ciclo/versionamento | Recuperação no servidor, versão por recurso e ETag da oportunidade, conflitos preservam preenchimento, permissões de gestão existentes, confirmação/motivo para exclusão lógica/restauro, retenção de binários, snapshots cifrados anterior/novo. Trigger proíbe eliminação física. Ligações a local/comprovativo impedem exclusão inadvertida do recurso usado. | Restauração não retoma automaticamente capa/principal/ordem; responsável deve reconciliar a seleção. Comparação visual detalhada dos snapshots e RBAC especializado permanecem no workflow futuro. |
|
||||
| §20/21/24–28 | Guardar, preparar derivados e conferência distinguidos de validar/submeter/aprovar/publicar. Mesma origem e relações mantidas. | Submissão, revisão segregada, aprovação/publicação transacional com capa autorizada, módulos especializados e critérios integrais REQ/DT continuam pendentes. |
|
||||
|
||||
A seleção de `asset`, `product` ou `evidence` numa imagem é rascunho; associação ao módulo correspondente ainda aparece pendente. Não declara a entidade ligada por semelhança. Metadados de consulta, situação documental e uso em regras/cálculos continuam independentes. Nada ativa um cálculo fiscal.
|
||||
|
||||
## Segurança e indisponibilidade
|
||||
|
||||
Originais e derivados novos ficam fora da pasta pública e cifrados com a chave da aplicação. A coluna nova `documents.storage_encryption` é nula para ficheiros antigos: esses originais e os seus scans não são alterados. O job existente `ScanDocumentForMalware` descifra apenas para ficheiro temporário privado, confere hash antes/depois e elimina o temporário em `finally`. Falha de fila conserva o original e regista scan falhado; nunca elimina um original já persistido para esconder a falha.
|
||||
|
||||
Download exige autenticação/permissão, associação à mesma oportunidade/recurso ativo, scan limpo do hash atual e integridade dos bytes. Scan pendente/inconclusivo/falhado bloqueia apenas acesso ao binário/processamento que depende dele; guardar metadados e preparar locais continuam funcionais. URL de pré-visualização também exige assinatura válida e scan da derivada; visibilidade proposta não autoriza divulgação.
|
||||
|
||||
`malware:health` confirmou **scanner_unavailable**, sem versão nem assinaturas disponíveis. Três testes reais continuam saltados. `QA-Test-Double` é usado exclusivamente em testes de bytes sintéticos e identificado como tal; não constitui scan de ficheiros reais. Não foi alterada a configuração do PHP ativo, nem ativado serviço externo.
|
||||
|
||||
## Evidência QA
|
||||
|
||||
**83 casos: 80 passaram, três saltados; 1 252 asserções.** Inclui regressão da gestão, origem, territórios/relações, zonas/anexos, portfólio e unificação. O processador foi ensaiado com `php -d extension=gd` apenas em QA: gera derivadas de imagem sintética, preserva original, retira metadados e exige scan próprio; URLs assinadas e permissões verificadas. TypeScript, PHPStan e build passaram. Um teste de renderização falhou durante build concorrente e passou na repetição isolada e na regressão com build concluído; não foi contornado.
|
||||
|
||||
Navegador QA em `127.0.0.1:18096`: dashboard → nova oportunidade incompleta → recursos → duas localizações sem coordenadas com 60%/40% → PDF → PNG → erro visível de processamento, com dados preservados → nova sessão móvel sem armazenamento local → recuperação → exclusão lógica/restauro da imagem. Desktop e 390×844, sem overflow nem erros de execução. As capturas foram inspecionadas; rótulos corrigidos para português e hash legível no telemóvel. PHP servidor QA com GD apresentou falha de arranque; servidor sem GD passou, mostrando a dependência pendente. O processamento com GD foi comprovado no processo CLI isolado, não apresentado como sucesso no PHP ativo.
|
||||
|
||||
Base `desk_restore_20261009_110903_test:55441`; backup/restauro de **288 tabelas/cinco ficheiros**, verificado em **11:09:13 UTC**. Migração/reversão antes de uso comparadas por hashes das 288 tabelas. Após navegador, comparação de 14 conjuntos confirma oportunidades, documentos originais, territórios, relações, favoritos, pedidos/recibos, mensagens, tarefas, localizações e histórico preservados. Não houve escrita na base ativa.
|
||||
|
||||
Provas/capturas privadas em `storage/app/private/investmoz-v2/opportunity-resources-*`. Não publicar backups, configuração/chaves ou extração integral da fonte.
|
||||
|
||||
## Plano único de ativação
|
||||
|
||||
Abrir com conta autorizada [a instalação de recursos](http://127.0.0.1:8000/management/opportunity-resources-install), rever alterações e dependências, assinalar confirmação e executar **Aplicar plano de gestão**. A primeira instalação de gestão não é repetida. Migration única `2026_10_09_030000_extend_opportunity_resources`: três coleções de metadados, FK para oportunidades/documentos, coluna de cifragem opcional e proteção de eliminação física. Nenhum recurso criado automaticamente e nenhuma relação territorial ou classificação alterada.
|
||||
|
||||
O plano exige prova de código `dcdfa8511b6b3554dd44ab236264822da8aaf2dd09eb8c66dcea78b0f2215e53`, backup/restauro, compatibilidade/reversão e QA correspondentes. Prova válida até **10/10/2026 11:09:13 UTC**; expiração ou alteração do código requer atualização. A ação autentica, confere hash/destino e audita `opportunity_resources_installed`. Não executada pelo Codex.
|
||||
|
||||
Reversão direta apenas com coleções vazias e sem originais cifrados. Após uso, não apagar binários, relações ou versões: reconciliar/preservar antes de ação autenticada; restauro integral exige janela e consideração de escritas posteriores. A CLI da migration recusa a base ativa.
|
||||
|
||||
## Estado ativo e pendências separadas
|
||||
|
||||
Leitura em **09/10/2026 11:10:21 UTC**: gestão básica instalada uma vez pela conta 13; seis IDs reais e dados/relações preservados. Os 124 eventos anteriores foram comparados individualmente: **zero ausentes, zero modificados**. Dois eventos posteriores, incluindo a instalação, explicam a diferença do hash global do histórico; não é perda de histórico.
|
||||
|
||||
Novo esquema de recursos ausente e zero eventos deste incremento na base ativa. ClamD real, fontes/limites concretos em falta, questões jurídicas específicas, diferença de cobertura do inventário e primeiro pedido real no Balcão mantêm estados independentes. Não revalidar proveniência oficial já aceite.
|
||||
Reference in New Issue
Block a user