Files
Investidor-V2/docs/investmoz/v2/recursos-oportunidades.md
T
nala 6ddafc95ba
tests / ci (push) Canceled after 0s
oportunidades 4
2026-10-10 07:03:59 +02:00

57 lines
13 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.