22 KiB
Rastreabilidade, utilização e formação
Matriz executável
| Menu / ecrã | Componente React | Campos / entidade / tabela | Rota ou API | Perfil / regra | Evidência |
|---|---|---|---|---|---|
| Início | PortalInvestidor |
Sectores, oportunidades, recursos publicados | /, APIs existentes de homepage |
Visitante; contagens do cadastro | PublicPortalNavigationTest, navegador |
| Catálogo / Educação | investment/catalogue |
Filtros, educação, pivots, facetas | /oportunidades, /educacao; /api/v1/investment/search |
Visitante; filtros em intersecção, montantes com moeda | InvestmentUnificationTest |
| Cluster / Corredor / Âncora | portfolio/index, portfolio/show |
Dossiers, relações, cadeias e oportunidades | /clusters, /corredores, /projectos-ancora, /carteira/{id} |
Visitante; dossier publicado; cadeia pública | InvestmentPortfolioTest, testes territoriais |
| Ficha | investment/detail |
Oportunidade, contexto, relações, fonte | /oportunidades/{slug}; /api/v1/investment/opportunities/{slug} |
Visitante; rascunhos não acessíveis | PublicPortalNavigationTest, InvestmentUnificationTest |
| Mapa | Componente Map em catálogo |
geo_locations, geo_geometries, opportunity_locations |
/api/v1/investment/map |
Visitante; dois níveis de classificação pública | Teste PostGIS e estados vazios |
| Comparar / exportar / sugerir | investment/catalogue |
IDs publicados, dados de catálogo | /compare, /export, /suggest sob prefixo da API |
Visitante; 4 comparações, 1.000 linhas/pontos; CSV protegido | Teste de publicação e fórmula CSV |
| Área do investidor | investment/workspace |
Manifestações, recibos, favoritos | /investidor/manifestacoes; /api/v1/investment/submissions |
Titular autenticado e verificado | Isolamento por dono |
| Perfil / empresas | investment/profile |
investment_accounts, investment_company_declarations |
/investidor/profile; API /profile, /companies/{id?} |
Titular; versão, encriptação, sem concessão de memberships | InvestmentWorkspaceTest e navegador |
| Conversa / versões | investment/conversation |
investment_messages, investment_submission_revisions |
API /submissions/{id}/messages, /submissions/{id}/revisions/{version} |
Titular/gestor; mensagem idempotente; histórico privado | Testes de isolamento, encriptação e reenvio; navegador |
| Notificações | investment/notifications |
investment_notifications |
/investidor/notifications; API /notifications, /{id}/read |
Destinatário; revogação de acesso a terceiros respeitada | Testes de mudança de estado e leitura; navegador |
| Manifestação | investment/submission |
investment_submissions.payload, necessidades |
PUT /submissions/{id}, POST /submissions/{id}/submit |
Titular; versão, opções activas, consentimento, idempotência | Testes de conflito, validação e reenvio |
| Anexos | Etapa 4 da manifestação | documents, investment_submission_attachments |
/submissions/{id}/attachments |
Titular/gestor lê; titular altera rascunho; checksum | Teste de anexo privado e adulteração |
| Contexto da oportunidade | investment/context |
Perfil, relações muitos-para-muitos, facetas | /management/opportunities/{id}/context |
Gestor; versão e retorno a rascunho | Teste de gestão, conflito e educação |
| Referências e formulários | investment/references |
Opções, rótulos, ordem, actividade | /management/investment/references |
Gestor; códigos estáveis, Outro preservado | Teste de referências e reexecução do seed |
| Atendimento / CRM | management/interest, gestão CRM existente |
interest_requests, outbox_events, leads |
/management/interests/{id} |
Gestor; consulta manifestação completa pelo vínculo | Testes de intake e CRM existentes |
| Apoio / documentos / parcerias | portal/services, portal/manage |
Recursos, parcerias, pedidos existentes | /apoio, /documentos, /parcerias, /balcao-virtual |
Regras existentes de publicação e dono | PublicPortalServicesTest |
Os nomes curtos /compare, /submissions, etc. nesta matriz pertencem a /api/v1/investment. O contrato detalhado está em openapi.json (OpenAPI 3.0.3).
Cobertura ainda parcial do prompt
As fichas territoriais apresentam conteúdo autorizado do documento v4, relações e cadeias cadastradas. Não existe ainda um editor unificado de todos os actores, fornecedores, contactos, infraestruturas físicas e indicadores para cada ficha. O mapa actual é de pontos de oportunidades, sem cartografia de linhas de corredores. As facetas representam classificações; não substituem inventário físico ou cálculo de lacunas.
A educação pública encontra oportunidades publicadas classificadas como educativas ou ligadas a propostas. As propostas geradas pelo módulo interno conservam a regra de publicação desse módulo; a extensão não torna públicas automaticamente necessidades internas ou alegações institucionais.
A área pessoal reúne rascunhos, manifestações, estados, favoritos, perfil de investimento, empresas declaradas, conversa bidireccional e notificações internas. As declarações empresariais são privadas e não substituem o cadastro canónico validado de organizações. Não existem candidaturas com um procedimento distinto das manifestações. Confirmação e notificações são apresentadas no portal; não se presume envio de email. O CRM local recebe o pedido pela outbox existente, mas a entrega a SuiteCRM remoto continua dependente da configuração e teste do conector.
O histórico de manifestações enumera actos e versões e permite consultar snapshots privados gravados a partir desta extensão; não restaura automaticamente versões anteriores. A gestão utiliza o gate manage-portal; separação de técnico, validador e administrador continua pendente. Os achados anteriores de concorrência/publicação em dossiers e revisão de resultados de IA permanecem registados em ../architecture-data-security-qa-product-review.md.
Manual do investidor
- No catálogo, combine sector, território, maturidade, educação e características. Para comparar montantes, seleccione a mesma moeda. Os filtros não convertem câmbio.
- Alterne entre grelha, lista e mapa. Quando não há coordenadas autorizadas, o portal informa a ausência. Marque até quatro oportunidades para comparação; use Exportar para obter as primeiras mil linhas filtradas.
- Abra uma ficha e seleccione Preparar manifestação. Entre com conta de email verificado. Nome e email são preenchidos a partir da conta; os restantes dados são declarações do investidor.
- Preencha identificação e investimento, acrescente necessidades, quantidades e prazos. Escolha Outro e descreva quando nenhuma opção servir. Mão de obra e educação apresentam campos específicos.
- Guarde o rascunho antes de sair ou carregar anexos. Na etapa Anexos, associe PDF/TXT e identifique o ficheiro nas observações da necessidade correspondente.
- Reveja, conceda consentimento de contacto e envie. O protocolo identifica um único pedido; repetir o envio não o duplica. Consulte o estado na área pessoal. O envio não constitui aprovação de investimento nem consentimento para IA.
- Se aparecer conflito de versão, recarregue para ver a versão actual antes de repetir a alteração. Nunca sobrescrever automaticamente uma sessão concorrente.
- Em Perfil e empresas, guarde dados reutilizáveis e declare as empresas que representa. Preparar manifestação desta empresa preenche os dados declarados, sem atribuir permissões sobre organizações de terceiros.
- Depois de submeter, use Conversa com o apoio para esclarecimentos. Consulte Notificações para respostas e mudanças de estado; marque-as como lidas. Em Versões guardadas, consulte o conteúdo anterior sem alterar o pedido actual.
Manual de gestão
- Em Oportunidades, crie ou edite a ficha principal e abra Contexto. Associe clusters, corredores, âncoras e localizações existentes; seleccione educação/facetas quando aplicável e registe a fonte.
- Guardar contexto retira a publicação até revisão explícita na ficha principal. Confira texto, referências, moeda e ausência de informação privada antes de publicar.
- Em Referências e formulários, acrescente opções dentro dos grupos existentes. Edite rótulos e ordem; desactive opções obsoletas. Não altere códigos já usados. Outro mantém-se activo e exige especificação.
- Em Pedidos de interesse, consulte a manifestação completa e os anexos privados. Actualize o estado pelo fluxo existente e encaminhe para o CRM com responsável e próxima acção.
- Dossiers e oportunidades são registos diferentes. A associação é explícita; não copie as quinze âncoras para o catálogo só para produzir resultados.
Design e protótipos executáveis
Os ecrãs React são os protótipos funcionais entregues: catálogo, detalhe, área pessoal, formulário de cinco etapas, contexto e referências. Não foi produzido um ficheiro Figma nem se alega validação prévia por participantes. A biblioteca local usa fundo slate-50, texto slate-900, acções emerald-800, cartões com borda, campos rotulados, foco visível, grelhas responsivas e estados vazios explícitos. Elementos partilhados: investment/shared.tsx e layouts/portal-navigation.tsx.
Verificar teclado, ordem/foco, erros, contraste, zoom 200–400%, leitura assistiva, upload e suporte fixo em cada alteração. A lista textual do mapa é alternativa ao SVG. Verificações automáticas e ausência de transbordo não equivalem a certificação WCAG 2.2 AA.
Formação e próximos critérios
Plano preparado, sessões ainda não realizadas:
| Sessão | Exercício verificável | Resultado esperado |
|---|---|---|
| Investidor — 30 min | Filtrar, comparar, guardar necessidade, anexar e enviar em ambiente de formação | Um protocolo; nenhum dado visível por outro participante |
| Gestor — 45 min | Criar opção, associar contexto, rever publicação, consultar pedido e encaminhar | Fonte registada, rascunho antes de publicar, encaminhamento com responsável |
| Operação — 45 min | Restaurar backup isolado, verificar chave/anexos, simular falha de fila | Reconciliação documentada; nenhum envio duplicado |
| Acessibilidade — 30 min | Percurso por teclado e leitor de ecrã em móvel/computador | Registo de obstáculos e correcções antes de homologação |
Backlog restante: editores territoriais completos e cartografia; ligação validada de empresas declaradas ao cadastro canónico; papéis especializados; retenção; homologação assistiva e carga; SuiteCRM no destino; sessões de formação e deploy monitorizado. A reconciliação remota foi adiada pelo proprietário para fase futura. Cada item exige implementação/evidência concreta, não nova aprovação genérica dos requisitos já autorizados.
Parques — complemento L1 pendente (DOC01, 16/10/2026)
Esta nota de cobertura não altera os procedimentos históricos acima nem encerra a ficha integral. O recorte parques-operacionais-QA-6aacf653a98e consta como disponibilizado no relatório de entrega; as novas funcionalidades L1 — responsabilidades, condições/tarifas contextualizadas, riscos/canal e revisão documental — permanecem pendentes de implementação, prova e confirmação da entrega. Não são instruções de utilização de funcionalidades já disponíveis.
O desenho reutiliza o mesmo cadastro: uma organização pode ter várias funções. Separa preparação privada de publicação expressa; contactos pessoais/notas/suporte privados ficam excluídos da projeção pública. Condições com fonte/data/âmbito/moeda/unidade aplicáveis; desconhecido não significa gratuito, disponível ou autorizado. Preservação privada e pública após guardar pelo editor anterior compatível é critério ainda por demonstrar. A estimativa é 24–36 h adicionais QA e 2–4 h operacionais futuras separadas.
Estado e critérios na mesma docs/investmoz/v2/auditoria-portal/matriz-requisitos.csv; desenho em outputs/investmoz-parques-integral-delimitacao-20261016/DOC01/. Não há implementação ou ativação decorrente desta atualização documental. Menus, duplicados, regulação Fintech e demais aceitações mantêm os seus estados.
Parques L1 — demonstração QA, disponibilização pendente (DOC02, 16/10/2026)
A nota DOC01 anterior fica como histórico do desenho antes da implementação. parques-L1-QA-fb56ec51f62e demonstra apenas em QA a reutilização de uma entidade em várias funções, preparação/divulgação separadas, condições e tarifas documentadas com desconhecidos, risco/canal e recuperação após edição anterior compatível. Ainda não é uma funcionalidade disponibilizada no ativo nem uma ficha integral concluída. Os novos anexos/manual não se presumem conferidos ou aceites pelo utilizador.
Reversão conserva oito fontes funcionais, schema/histórico e compilação compatível: os dados privados e a projeção pública permanecem recuperáveis pela API. O ecrã anterior não apresenta os grupos L1; voltam ao ecrã ao repor a candidata. Não repor todos os ficheiros antigos nem um dump anterior sobre utilização posterior. Fonte/âmbito/data e moeda/unidade aplicáveis acompanham os valores; desconhecido não é gratuito/disponível/autorizado. O apoio da Tempo é distinto da gestão do parque. Sem confirmação de dados reais por estes ensaios.
Estado na mesma matriz; provas e proposta em outputs/investmoz-parques-L1-QA-20261016/. Estimativa adicional inicial24–36h é referência, não tempo consumido; recorte QA concluído e futura operação2–4h dependente de decisão específica. Ficha integral, menus, duplicados, regulação Fintech e aceitações anteriores preservados.
18/10/2026 — L1 dos parques disponibilizado; observação do editor delimitada
Candidata parques-L1-QA-fb56ec51f62e, pacote DOC02 autorizado pela Tempo. O utilizador conferiu os cinco documentos e recibo; a inspeção do ZIP permanece verificação do Codex. Navegação separada e ficha integral aberta.
Aplicados 12 artefactos (oito substituições, três fontes novas e migration nominal) e 162 ficheiros de compilação, conferidos por hash. Troca em manutenção, apenas view:clear, cache de dados idêntica durante a troca e saída de manutenção antes do instalador. Preservados os documentos atuais, complementados com este resultado sem reposição de versões antigas.
Backup/restauro fresco do destino: 295 tabelas e 31 sequências coincidentes, 1316 ficheiros extraídos/conferidos incluindo 29 documentos; arranque do clone em leitura e chave verificada por decifragem. A primeira tentativa incompleta foi preservada; não foi usada como prova válida.
Instalação executada pelo utilizador na interface autenticada e confirmada por leitura: conta 2, recibo bffa9337-b2ca-48c6-bc6b-fbbf100f8848, apenas 2026_10_16_140000_add_investment_zone_operational_details, uma entrada no ledger e coluna JSONB nullable. Hash do recibo corresponde à candidata; zero registos de negócio alterados. Nenhuma fixture importada, ficha guardada ou publicada, grant ou flag alterado.
Preservação: comparação das 295 tabelas, sem diferenças inesperadas de negócio/histórico. Todos os detalhes operacionais permanecem nulos. Diferenças esperadas: ledger, auditoria nominal e projeção da coluna nova; cache/sessões e remember_token da conta autenticada. Sequência migrations_id_seq aumentou uma unidade. Conferidos 827 ficheiros alheios/protegidos, 12 artefactos/162 assets, 281 ficheiros geridos e 29 originais documentais. Lista pública de oito zonas e ficha Balama mantêm os campos públicos anteriores, com assets servidos iguais aos locais. B, COUNTRY02, papéis e histórico preservados.
Limite da observação: o controlo do computador não conseguiu identificar o URL com segurança; a instalação na interface foi reportada pelo utilizador e confirmada no ledger/auditoria. Abertura do editor L1 autenticado no ativo, sem guardar, não foi observada pelo Codex. Não declarar esse ponto demonstrado nem repetir testes QA para o substituir. Conferência pública HTTP e preservação de dados concluídas.
Reversão pós-uso continua parcial: conservar oito fontes funcionais, colunas/migrations/ledger/histórico e build compatível. O ecrã anterior não mostra grupos L1; os privados e a projeção pública ficam preservados na API conforme provas QA históricas, não repetidas no ativo. Nenhuma reversão ativa executada.
Saldo de troca/instalação/conferência por leitura: zero. Observação autenticada do editor permanece não demonstrada. As 2–4 h operacionais e 24–36 h QA são estimativas históricas, não horas consumidas. A disponibilização deste recorte não encerra a ficha integral.
18/10/2026 — observação do editor L1 confirmada pelo utilizador
O utilizador respondeu «feito» à instrução de abrir o editor autenticado de Balama e confirmar os grupos L1 de responsabilidades, condições/tarifas, riscos/canal e revisão documental, sem guardar nem publicar. Regista-se como observação confirmada pelo utilizador, não observação direta do Codex. Fica resolvida a pendência operacional de observação referida no registo anterior; não há repetição da 140000 ou nova alteração no ativo nesta atualização documental. A matriz conserva o registo histórico da não observação direta pelo Codex; esta confirmação posterior complementa-o. A disponibilização do recorte L1 está concluída. Ficha integral aberta; relatório local continua sem conferência do utilizador. Estimativas anteriores não representam horas consumidas.
Evidência: outputs/investmoz-parques-L1-ativacao-20261018/OBSERVACAO-EDITOR-UTILIZADOR.json.
18/10/2026 — conferência do relatório local confirmada
O utilizador confirmou expressamente a conferência de RELATORIO-ENTREGA.md, identificado como ficheiro ativo no IDE. Esta confirmação atualiza a pendência documental anterior; não declara nova inspeção do ZIP nem repetição de testes ou da 140000. Disponibilização do recorte L1 concluída; ficha integral aberta. Registo: outputs/investmoz-parques-L1-ativacao-20261018/REGISTO-CONFERENCIA-RELATORIO-UTILIZADOR.json.
18/10/2026 — rectificação documental e editor L1 observado
O ChatGPT conferiu os documentos DOC02 da candidata QA; não está confirmada a conferência pelo utilizador do relatório local da ativação. Esta rectificação substitui a atribuição anterior. Editor Balama observado diretamente pelo Codex no URL HTTPS confirmado, conta 2/Osmane Nala pelo DOM: Entidades e funções, Condições e tarifas declaradas, Riscos e canal de esclarecimento, Qualidade e revisão documental. Público v3/preparação não guardada; sem alterações, gravação, publicação ou repetição da140000. Resultado: observado. Evidência: outputs/investmoz-parques-L1-ativacao-20261018/OBSERVACAO-OPERACIONAL-FINAL.json e EDITOR-OBSERVADO-20261018.txt. Sessão autorizada existente; não se declara novo desafio MFA. Saldo operacional restante L1 zero; ficha integral aberta. Relatório e recibo finais rectificados para conferência na página privada existente.