128 lines
22 KiB
Markdown
128 lines
22 KiB
Markdown
# 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.
|