Files
Investidor-V2/docs/investmoz/business-marketplace-progress-2026-09-30.md
T
nala 4f35313d06
tests / ci (push) Canceled after 0s
novas funcionalidades dos formulario
2026-10-02 11:13:37 +02:00

53 lines
5.5 KiB
Markdown

# Progresso do mercado de negócios — 30/09/2026
## Implementado nesta execução
- Extensão do modelo existente `existing_businesses` e `interest_requests`; não foi criada uma segunda entidade de negócio.
- Fluxo de triagem, revisão, aprovação de nível 1, aprovação de nível 2 e publicação, com políticas por email designado, conta verificada, permissão de gestão e MFA. A aprovação de nível 1, nível 2 e publicação exigem actores distintos.
- Catálogo público servido por projecção de campos permitidos. A ficha pública não serializa payload privado, proponente, documentos nem geometria exacta.
- Registo público de manifestação de interesse com idempotência, consentimento registado e deduplicação de pedidos activos para o mesmo negócio, email e modalidade.
- Ciclo de estados de interesse validado pelo serviço `InterestWorkflow`. Cada mudança efectiva guarda actor, estados anterior/seguinte, nota cifrada e correlação no histórico; a ficha de gestão apresenta histórico e próxima acção/prazo.
- Configuração de designações documentada em `.env.example`. Listas vazias não concedem acesso.
## Limites ainda activos
- O fluxo de transição do interesse e a ficha de gestão estão implementados, mas a atribuição a responsáveis ainda não tem interface de gestão.
- O prazo é guardado, mas não há job de SLA, alertas de atraso ou escalonamento automático.
- A outbox recebe eventos de submissão. O worker CRM para este novo fluxo, reconciliação e dead-letter ainda precisam de implementação e homologação; nenhum evento foi enviado para um serviço externo nesta execução.
- Os anexos ainda não têm upload privado com antivírus, retenção automatizada ou sala segura. Não tratar referências documentais declaradas como ficheiros validados.
- Consentimento de contacto obrigatório é registado no pedido. Consentimentos separados para partilha com o proponente/terceiros e respectivos fluxos de revogação continuam pendentes.
- A disponibilização das rotas públicas não constitui autorização institucional para publicar oportunidades reais. Confirmar designações e conteúdo público antes de activar em produção.
## Evidência reproduzida
- `php artisan test --filter='PortalManagementTest|InvestmentWorkspaceTest|BusinessMarketplacePublicTest|ExistingBusinessIntakeTest'`: 20 testes, 301 verificações aprovadas, usando exclusivamente `portal_services_test` em `127.0.0.1:55441`.
- `npm.cmd run types:check`: TypeScript sem erros.
- Laravel Pint `--test` nos PHP alterados: aprovado.
- PHP 8.5.11 explícito: lint sem erros nos novos serviços/controladores/teste.
Todos os comandos PHP desta execução usaram `C:\Users\macbook\.config\investmoz\php-8.5.11\php.exe`.
## Continuação — tarefas operacionais
Esta actualização substitui a limitação anterior sobre atribuição: a ficha de gestão permite agora seleccionar um responsável entre gestores verificados incluídos nas listas de designação configuradas. A fila apresenta o responsável e o prazo.
Quando a próxima acção e o prazo são definidos, é criada uma tarefa privada em `tasks`, ligada à manifestação, com responsável, classificação confidencial e data limite no fim do dia local. A chave externa determinística impede duplicados ao guardar novamente a mesma acção. Uma acção alterada ou removida encerra a tarefa aberta anterior como `cancelled`/`superseded`, preservando o registo.
Validação adicional: mesmos 20 testes focados, agora com 323 verificações; TypeScript sem erros. Os prazos são acompanhados na fila e nas tarefas; não há ainda notificações automáticas nem escalonamento de SLA.
A fila de gestão mostra a acção, o responsável e o prazo; tarefas vencidas são destacadas visualmente. Actualizar apenas o estado preserva a atribuição e a próxima acção existentes. Guardar a mesma acção novamente não duplica a tarefa.
A fila também oferece filtros para prazos vencidos, prazos futuros e pedidos sem responsável. O filtro de prazo exclui estados terminais.
## Actualização — consentimentos separados
O formulário regista separadamente o consentimento obrigatório para responder ao pedido (`respond_to_interest`) e a autorização opcional para partilhar contacto com o proponente (`share_contact_with_proponent`). Cada registo conserva versão da política, data, referência do pedido e classificação confidencial. A opção de partilha começa desmarcada e não condiciona a submissão.
A gestão pode revogar a autorização de partilha com motivo obrigatório. A revogação actualiza o registo de consentimento, guarda o motivo cifrado no histórico e cria evento de outbox sem email, telefone ou texto da mensagem. Este procedimento administrativo implementa revogação registada; ainda falta um fluxo de auto-serviço para o titular.
Validação desta continuação: 29 testes focados / 381 verificações aprovadas; TypeScript e build aprovados; Pint aprovado nos ficheiros PHP alterados. O build continua a emitir apenas o aviso de dependência opcional `fontaine`.
## Escalada de tarefas vencidas
O comando `investmoz:escalate-overdue-tasks` eleva para prioridade 1 as tarefas `triage` e `interest_follow_up` vencidas que ainda estejam abertas/em curso, marcando `outcome=sla_overdue`. O scheduler agenda a verificação a cada 15 minutos. A função vem desactivada; habilitar `INVESTMOZ_SLA_ESCALATION_ENABLED=true` apenas quando o scheduler Laravel estiver operacional. A escalada não envia email nem integrações externas.