Notas do usuário

As notas guardam o que a análise não tem como saber: que um procedimento não é mais usado, que uma regra atende a uma norma, quem é o responsável funcional de um módulo ou o que a equipe decidiu para a migração. Elas ficam dentro da documentação, então um agente de IA também as lê.

As notas são adicionadas pelo aplicativo (aba Visualizador). Se você abrir o visualizador em um navegador separado, elas aparecem, mas não podem ser criadas nem excluídas.

Nota sobre um objeto

1. Abra o objeto no Visualizador.
2. Em Notas do usuário, escreva a nota e, se quiser, o seu nome em Autor.
3. Clique em Salvar nota.

A nota aparece imediatamente na página e fica registrada com data e autor. Excluir a apaga.

Nota sobre vários objetos de uma vez

1. Em Objetos, filtre a lista (por exemplo, por pasta ou por cluster).
2. Marque as caixas da última coluna, ou a caixa do cabeçalho para Selecionar visíveis.
3. Na barra que aparece acima, escreva a nota e clique em Adicionar nota aos objetos selecionados.

Cada objeto recebe sua cópia da nota. A coluna Notas da lista indica quais objetos têm notas.

Onde ficam

• Em annotations/ dentro do projeto, um arquivo JSON por objeto. É a fonte da verdade: copie essa pasta se quiser levar as notas para outra máquina.
• No documento Markdown do objeto, seção Notas do usuário.
• No JSON do objeto, campo user_notes.

Quando você executa novamente o pipeline sobre o mesmo projeto (por exemplo, com um export mais recente da KB), as notas são reincorporadas aos documentos regenerados. Se um objeto sumiu da KB, o arquivo de notas dele continua em annotations/, mas não é mais exibido.