feat: integrate private offers with existing editorial workflow
This commit is contained in:
@@ -10152,4 +10152,15 @@ Verificação: 14 testes novos. Bateria de regressão de Oportunidades/perfis/ed
|
||||
|
||||
Limitações: conferência visual manual não efectuada. npm run check global acusa formatação preexistente em 61 ficheiros alheios ao delta; esses ficheiros não foram alterados e a falha não foi dispensada. A bateria canónica extensa foi interrompida, não contabilizada como aprovada e substituída pela verificação do cenário afectado. Uma prova antiga de divulgação exige outra base pelo seu próprio controlo de segurança; esse controlo foi preservado, sem tocar nessa base, e a compatibilidade do âmbito nativo foi testada na nova preparação sintética.
|
||||
|
||||
Saldo de RF-MN-003: Fase 1 de Ofertas implementada e verificada tecnicamente em QA, sem instalação. Não encerra o requisito integral nem Procuras. Fase 2 e seguintes permanecem por autorizar; NDA, comprovativos, fotografias, validade, moderação e publicação não são simulados nesta entrega. A autorização anterior de validador jurídico para legislação não é estendida a Ofertas. Instalação em homologação ou produção exige verificação e autorização expressa separada.
|
||||
Saldo de RF-MN-003: Fase 1 de Ofertas implementada e verificada tecnicamente em QA, sem instalação. Não encerra o requisito integral nem Procuras. Fase 2 e seguintes permanecem por autorizar; NDA, comprovativos, fotografias, validade, moderação e publicação não são simulados nesta entrega. A autorização anterior de validador jurídico para legislação não é estendida a Ofertas. Instalação em homologação ou produção exige verificação e autorização expressa separada.
|
||||
## 14/11/2026 — Ofertas Fase 2, circuito editorial privado em QA
|
||||
|
||||
Autorização expressa da Tempo, após encerramento técnico da F1 com ressalva visual. Implementação limitada ao plano 6e302db6, mantendo Oportunidades como cadastro principal. Dashboard existente → Ofertas/revisão privada → validador inicia ou coordenação atribui → pede correcção/rejeita com fundamento → promotor corrige/reenvia no mesmo identificador → aprovação interna independente. Preserva versões, rejeições, aprovação histórica e tarefas. Reatribuição guarda quem alterou, anterior e novo responsável, sem conceder papéis.
|
||||
|
||||
Snapshots/hash, revisão e ciclo vinculam cada decisão aos campos e referências conferidos. Mudança no contacto/localização bloqueia decisão ou assinala reconferência; não substitui a conclusão. Primeira revisão explícita de submissão F1 preserva autor/data/revisão e regista a vinculação actual sem inventar fingerprints históricos do CRM. Estados editoriais privados não tornam a oferta pública; status de publicação mantém-se privado, marca/exclusão pública e percursos alternativos bloqueados. Os percursos nativos conservam a versão pública anterior durante alterações pendentes. Desactivar o circuito não permite submeter v2 pelo fallback v1 nem apagar histórico.
|
||||
|
||||
Reutiliza perfis/MFA/independência, workflow, tarefas, auditoria e caixa de notificações. Email pelo transporte existente, depois do commit e com revalidação, activação/lista operacional nativas; em QA apenas memória, sem mensagens reais ou SMS. Configurações de entrega e designações operacionais não são inventadas. Sem migrações/tabelas novas, mudanças em mne, dados operacionais, menu principal ou instalação.
|
||||
|
||||
QA sintética offers_phase1_20261114_test:55441: regressão 35/499, final F2 11/160, complemento de contribuidores 1/14 e HTML final 1/10 aprovados; grupos sobrepostos, não somar. Pint, PHPStan, tipos, lint/formatação focados e build QA aprovados. Testa autoria/contribuidores/âmbito/MFA/revogação, snapshots, rejeição/correcção/reenvio, reatribuição, fila sem duplicação, rollback, notificações idempotentes, fonte alterada, recuperação e recusa de publicação. Conferência visual mantém a ressalva da ferramenta; formatação global continua nos 61 ficheiros preexistentes exteriores ao delta, sem dispensa. Entregabilidade real não demonstrada. Relatório: docs/investmoz/v2/auditoria-portal/ofertas-fase2-entrega-qa-20261114.md. Recibo: outputs/offers-private-phase2-20261114/qa-result.json.
|
||||
|
||||
Saldo RF-MN-003: F1/F2 implementadas e verificadas tecnicamente em QA, não instaladas; requisito integral/Procuras permanecem parciais. Fase 3 e instalação em homologação/produção dependem de autorização expressa própria. Não foram iniciados catálogo público, NDA, comprovativos, fotografias ou validade. Próximo passo é rever esta entrega e conferir visualmente quando o ambiente permitir, sem reabrir provas técnicas aceites.
|
||||
File diff suppressed because one or more lines are too long
@@ -0,0 +1,75 @@
|
||||
# Ofertas — Fase 2, circuito editorial privado em QA
|
||||
|
||||
14/11/2026. Autorização expressa da Tempo nesta sessão, limitada à Fase 2 do plano `6e302db6`. Base: Fase 1 `1f2990e4`, mantida no histórico Git. Referência: RF-MN-003 da matriz existente.
|
||||
|
||||
**Implementado e verificado tecnicamente em QA. Sem instalação em homologação ou produção. A aprovação é interna; a publicação de Ofertas permanece bloqueada. Fase 3 não iniciada.**
|
||||
|
||||
## Percurso que ficou utilizável
|
||||
|
||||
No Dashboard Colaborativo existente, a área de Oportunidades inclui a entrada «Ofertas — revisão privada». Abre a mesma lista privada da Fase 1, agora com filtros por estado. Não há outro dashboard, outra tabela de ofertas, outro login ou alteração ao menu principal. As contagens de Oportunidades continuam a contar cada registo uma vez; a entrada filtrada não acrescenta outro contador ao total.
|
||||
|
||||
O promotor cria/guarda/recupera/submete. Um validador autorizado inicia a revisão, pede correcções nos campos comuns ou rejeita com fundamento. O promotor prepara a revisão após rejeição ou aprovação, conserva a decisão anterior, corrige e reenvia no mesmo identificador. O validador independente aprova a nova versão em privado. A coordenação de validação existente pode atribuir/reassociar um revisor elegível, com fundamento, histórico do responsável anterior e do novo responsável; não são criadas designações ou atribuições por inferência.
|
||||
|
||||
Estados: rascunho → submetida → em revisão → correcções solicitadas/rejeitada/aprovada internamente. Correcção e reenvio abrem novo ciclo; não eliminam rejeições, aprovações, snapshots ou tarefas encerradas. Aprovação não publica nem certifica titularidade, licenciamento ou viabilidade do negócio.
|
||||
|
||||
## Integração e garantias
|
||||
|
||||
- O mesmo `OpportunityProfileWorkflow` executa as transições. O adaptador privado valida os campos comerciais comuns; não exige nem fabrica os perfis normativos completos e não enfraquece o contrato dos investimentos existentes.
|
||||
- Oportunidades continua a ser o cadastro principal. `management_draft`, versões, etag, workflow_context, tarefas CRM, auditoria e notificações existentes são reutilizados. Não há novas migrações, tabelas ou mudanças em `mne`.
|
||||
- O estado editorial da Oferta é projectado a partir de uma única origem privada e sincronizado com as filas. O estado de publicação conserva a barreira privada: `status=draft`, `published_at=null` e a marca de preparação permanece. Nenhuma operação F2 remove a exclusão do catálogo.
|
||||
- Cada submissão regista versão do contrato, snapshot, hash determinístico, versão do registo submetido e ciclo de revisão. Cada decisão conserva actor, instante UTC, fundamento, hash e revisão a que respeita. O snapshot da decisão também fica cifrado na auditoria existente.
|
||||
- Contacto e localização são referenciados pelos cadastros existentes. O hash inclui os dados efectivamente conferidos nas referências; uma mudança posterior impede a aprovação dessa submissão ou sinaliza reconferência se a aprovação já ocorreu. A leitura não substitui silenciosamente a decisão.
|
||||
- Ofertas antigas da Fase 1 só são vinculadas na primeira operação explícita de revisão. Conservam autor, data e revisão originais. A vinculação regista quem/quando estabeleceu o fingerprint: a Fase 1 não tinha esse fingerprint de referências, pelo que não se inventa um estado histórico do CRM na data original.
|
||||
- As permissões são verificadas no servidor, na transacção e nos destinos das notificações. Autor, contribuidores e representantes em conflito não aprovam; acumulação de papéis não remove os bloqueios. Revisão/decisões internas exigem MFA recente. O papel de auditor permanece sem escrita operacional.
|
||||
- Tentativas de publicação são recusadas na rota privada, nas rotas alternativas nativas e no workflow chamado directamente. Os bloqueios anteriores do modelo e da divulgação e a exclusão da pesquisa pública permanecem. Não se implementou um publicador para Ofertas.
|
||||
- A versão pública anterior dos percursos nativos mantém-se durante edições pendentes; o ramo nativo não foi convertido para a preparação comercial. A regressão dos registos publicados confirma a preservação dos valores públicos. Não existem Ofertas públicas aceites nesta fase para simular uma publicação nova.
|
||||
|
||||
## Notificações e recuperação
|
||||
|
||||
A caixa editorial existente recebe as ocorrências por oportunidade/versão/acção e destinatário. A restrição de unicidade existente evita ocorrências repetidas. Submissões notificam coordenação elegível já designada; sem designação, a fila fica por atribuir. Decisões notificam autor e responsáveis efectivos, e a reatribuição inclui o responsável anterior se continuar autorizado. As ligações abrem a Oferta privada correcta e revalidam o acesso.
|
||||
|
||||
O novo job é apenas o consumidor do transporte de email/fila já existente: usa a activação e a lista de destinatários operacionais actuais, consulta a notificação novamente, reconfirma acesso e não envia conteúdo da Oferta. É agendado após a confirmação da transacção. Falhas imediatas de despacho/entrega ficam auditadas sem converter a decisão já confirmada numa resposta incerta. O job usa as tentativas/backoff do padrão existente. Não existe transporte SMS novo, envio real em QA ou promessa de entrega exactamente uma vez.
|
||||
|
||||
Se o circuito editorial ficar indisponível, uma Oferta v2 não é submetida pelo fallback v1: responde com indisponibilidade e conserva versão e histórico. Ofertas genuinamente v1 continuam com a preparação anterior. Não se faz rollback destrutivo de dados para regressar ao código precedente.
|
||||
|
||||
## Ficheiros do delta
|
||||
|
||||
| Ficheiros | Finalidade |
|
||||
| --- | --- |
|
||||
| `app/Services/PrivateOfferPreparation.php` | Adaptador, snapshots, vinculação F1, apresentação e histórico privado |
|
||||
| `app/Services/OpportunityProfileWorkflow.php` | Revisão, atribuição, decisões por versão e ciclos no motor existente |
|
||||
| `app/Services/PortalProfileAccess.php` | Projecção do estado e edição nos estados permitidos |
|
||||
| `app/Services/OpportunityManagement.php` | Guardar a correcção privada sem perder categoria/âmbito/localização actuais |
|
||||
| `app/Services/PortalEditorialWorkflow.php` | Destinatários, unicidade, destino privado e agendamento de notificações |
|
||||
| `app/Jobs/NotifyPrivateOfferDecision.php` | Email pelo transporte existente, com revalidação de acesso |
|
||||
| `app/Http/Controllers/PrivateOfferPreparationController.php` | Filtros e endpoint privado de decisões |
|
||||
| `app/Http/Controllers/PortalEditorialWorkflowController.php` | Entrada de Ofertas na área existente de Oportunidades |
|
||||
| `routes/web.php` | Endpoint privado de revisão, sob autenticação/perfis/resposta privada |
|
||||
| `resources/js/components/offer-editorial-review.tsx` | Fundamento, campos a corrigir, responsável, decisões e histórico |
|
||||
| `resources/js/lib/offer-editorial.ts` | Tipos e rótulos partilhados, sem importar uma página como biblioteca |
|
||||
| `resources/js/pages/offers/preparation.tsx` e `preparation-index.tsx` | Revisão, recuperação e filtros na preparação existente |
|
||||
| `resources/js/pages/management/editorial-workflow.tsx` | Entrada integrada, sem duplicar contagens |
|
||||
| `tests/Feature/PrivateOfferEditorialTest.php` | 11 testes novos do circuito e dos bloqueios |
|
||||
| Matriz, manual, este relatório e recibo QA | Saldo e evidência da entrega, sem outro inventário funcional |
|
||||
|
||||
## Verificação
|
||||
|
||||
Base sintética isolada: `offers_phase1_20261114_test:55441`, com as guardas existentes. Não foram utilizados processos reais, contas operacionais ou notificações externas.
|
||||
|
||||
- Integração e regressão: **35 testes / 499 asserções aprovados**, incluindo Fase 1, permissões, gravação/publicação nativa e o cenário canónico/editorial afectado.
|
||||
- Passagem final F2: **11 testes / 160 asserções aprovados**. O teste de conflito de contribuidores foi ainda reforçado e verificado separadamente: **1 teste / 14 asserções aprovado**.
|
||||
- HTML completo das duas páginas privadas com o build final: **1 teste / 10 asserções aprovado**.
|
||||
- Pint, PHPStan, tipos, lint/formatação focados e compilação QA aprovados. A análise PHP foi repetida para o motor após o ajuste final do ramo privado. Sem enfraquecer testes, baseline ou guardas.
|
||||
- Os grupos sobrepõem-se; não somar os totais. Execuções interrompidas ou anteriores com falhas não são contadas como aprovadas.
|
||||
|
||||
Os testes cobrem fila existente sem contagem duplicada, rejeição/correcção/reenvio, aprovação vinculada ao snapshot, decisão desactualizada, âmbito/MFA/contribuidores/auto-aprovação, perda de acesso, contacto alterado, reatribuição restrita, rollback conjunto, notificação repetida, email no transporte local em memória, revogação antes da entrega, vinculação explícita F1, indisponibilidade sem downgrade e recusa de publicação por percursos alternativos. O histórico recuperado conserva o título/preço e a decisão de cada versão.
|
||||
|
||||
## Riscos e pendências
|
||||
|
||||
1. Conferência visual manual continua pendente: a última prova da ferramenta registou host de navegador indisponível e falha de captura nativa GPU `0x887A0005`. Não foram repetidos reinícios ou desactivadas verificações. HTML e compilação não são apresentados como aceite visual.
|
||||
2. A verificação global de formatação continua a falhar nos 61 ficheiros preexistentes. A lista foi novamente confrontada com este delta, sem intersecção. Não foi reformatado conteúdo exterior ao âmbito nem dispensada a falha global.
|
||||
3. Email real, configuração operacional da fila, destinatários e entregabilidade não foram activados nem demonstrados. Os testes utilizam transporte em memória e os papéis sintéticos existentes no cenário.
|
||||
4. Atribuição/reassociação exige coordenação já designada e candidatos elegíveis. A inexistência de uma designação não autoriza criar papéis; bloqueia apenas essa atribuição e mantém a fila por tratar.
|
||||
5. O recorte aprovado é moderação dos campos comerciais comuns. NDA, comprovativos, fotografias, validade, catálogo público, destaque e restantes fases não são declarados concluídos. Não se atribui a Ofertas a designação jurídica da legislação.
|
||||
|
||||
**Saldo:** Fase 2 implementada e verificada tecnicamente em QA; não instalada. O módulo integral/RF-MN-003 e Procuras continuam parciais. A Fase 3 e qualquer instalação exigem autorização expressa separada. Próximo passo: revisão desta entrega e conferência visual quando o ambiente permitir, sem reabrir as provas técnicas aceites.
|
||||
Reference in New Issue
Block a user