← Voltar ao curso
Nível 2 — Ferramenta de trabalho · Módulo 2.8 — Faixas por perfil (eletivas)

2.8.B3 · Documentação de paisagem e integração

4 min de vídeo BASIS

Objetivo: ao final, o consultor gera e mantém atualizada a documentação de landscape e integrações do projeto, com tarefa agendada e consciência do risco de documentação desatualizada em massa.

O que você precisa levar desta aula

  1. Gere diagrama e catálogo de integração a partir da configuração real (RFC destinations, planilhas de mapeamento) — não da memória de alguém do time.
  2. Configure uma tarefa agendada que compare a configuração atual com o catálogo documentado, semanalmente, e avise sobre diferença.
  3. Documentação gerada em massa sem esse loop de verificação recorrente fica desatualizada do mesmo jeito que a documentação manual antiga — só que mais rápido de produzir, não mais confiável.

Manter a documentação viva

Sem tarefa agendada Com tarefa agendada
Diagrama gerado uma vez, nunca revisitado Comparação semanal entre configuração real e catálogo
Desatualiza silenciosamente Avisa quando há diferença
Risco: parece confiável, mas não é Confiabilidade sustentada pelo loop, não pela geração inicial

O risco de documentação em massa

A capacidade de gerar diagrama e catálogo rapidamente cria uma tentação: documentar tudo de uma vez e considerar resolvido. Sem o mecanismo de verificação recorrente, isso produz mais documentação desatualizada, só que mais rápido — o problema original, com um verniz novo.

📖 Sessões longas sem babá — módulo 2.6

Quiz — 3 questões

1.Qual é a fonte correta para gerar o diagrama de integrações do sistema MRD?
  • a)As configurações reais (RFC destinations, planilhas de mapeamento de interface)

    Correto.

  • b)A memória de quem já trabalhou no projeto há mais tempo

    Sujeita a erro e desatualização; a aula recomenda a configuração real como fonte.

  • c)O diagrama antigo em PowerPoint, atualizado apenas visualmente

    Reproduziria informação já desatualizada, só com aparência renovada.

Ver resposta e por quê
a) Correto.
b) Sujeita a erro e desatualização; a aula recomenda a configuração real como fonte.
c) Reproduziria informação já desatualizada, só com aparência renovada.
2.Por que uma tarefa agendada de comparação semanal é importante depois de gerar o catálogo de integrações?
  • a)Porque o catálogo gerado pelo Claude normalmente vem incompleto na primeira vez

    Não é sobre completude inicial; é sobre manter a documentação alinhada com mudanças futuras na configuração.

  • b)Porque sem verificação recorrente, o catálogo desatualiza silenciosamente conforme a configuração real muda

    Correto.

  • c)Porque é uma exigência de auditoria externa do projeto Meridiano

    Não é mencionada como exigência externa; é uma prática recomendada pela aula.

Ver resposta e por quê
a) Não é sobre completude inicial; é sobre manter a documentação alinhada com mudanças futuras na configuração.
b) Correto.
c) Não é mencionada como exigência externa; é uma prática recomendada pela aula.
3.Qual é o risco específico de gerar documentação de landscape em massa, de uma vez só? --- > Status report, proposta comercial, comitê de risco — onde o julgamento continua sendo do PM, e o Claude entra como estrutura e desafio, não como decisão.
  • a)O Claude não consegue processar múltiplas fontes de configuração ao mesmo tempo

    Consegue, como mostrado na geração do diagrama e catálogo a partir de várias fontes.

  • b)Documentação gerada em massa não pode ser versionada em repositório

    Pode ser versionada normalmente; o risco descrito é de desatualização, não de versionamento.

  • c)Sem o loop de verificação recorrente, a documentação gerada em massa fica desatualizada do mesmo jeito que a documentação manual antiga

    Correto.

Ver resposta e por quê
a) Consegue, como mostrado na geração do diagrama e catálogo a partir de várias fontes.
b) Pode ser versionada normalmente; o risco descrito é de desatualização, não de versionamento.
c) Correto.