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

13 KiB
Raw Blame History

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, 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.