Files
Investidor-V2/docs/investmoz/unification/traceability-and-manual.md
T
nala 6bc0cc6f52
tests / ci (push) Canceled after 0s
versao nrgocios 3
2026-10-18 11:17:35 +02:00

128 lines
22 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.
# 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
1. 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.
2. 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.
3. 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.
4. 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.
5. 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.
6. 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.
7. 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.
8. 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.
9. 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
1. 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.
2. 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.
3. 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.
4. 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.
5. 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.