Capítulo 35 — Ateliê de projeto II
Mapa da aula
Aula 35 publicada. Mapa, exemplo, EX103.
flowchart TD
N0["35.1 Problema"]
N1["35.2 Texto"]
N2["35.3 Revisão"]
N3["35.2b Acessibilidade da honestidade"]
N4["35.3b A exportação como fonte da verdade"]
N5["35.1b Exportações narrativas"]
N6["Nota de prática"]
N7["35.4b Testar o texto com leitores reais"]
N0 --> N1 --> N2 --> N3 --> N4 --> N5 --> N6 --> N7
N7 --> EX["Exemplo resolvido"]
EX --> Q["Exercício EX103"]
Desenho lógico
flowchart LR
N0["35.1 Problema"]
N1["35.2 Texto"]
N2["35.3 Revisão"]
N3["35.2b Acessibilidade da honestidade"]
N4["35.3b A exportação como fonte da verdade"]
N5["35.1b Exportações narrativas"]
N6["Nota de prática"]
N7["35.4b Testar o texto com leitores reais"]
N0 --> N1 --> N2 --> N3 --> N4 --> N5 --> N6 --> N7 --> Q["EX103"]
[35.1 Problema]
|
v
[35.2 Texto]
|
v
[35.3 Revisão]
|
v
[35.2b Acessibilidade da honestidade]
|
v
[35.3b A exportação como fonte da verdade]
|
v
[35.1b Exportações narrativas]
|
v
[Nota de prática]
|
v
[35.4b Testar o texto com leitores reais]
|
v
[Exemplo resolvido] --> [Exercício EX103]
Objetivos de aprendizagem
Você vai (1) redesenhar a interface de cobertura do PulseMap segundo os princípios de subestimação; (2) defender o desenho numa revisão; (3) produzir textos de interface que recusem pontuações vazias.
35.1 Problema
As partes interessadas querem uma grande porcentagem verde. Desenhe uma interface que mostre planejado/observado/não visto e recuse uma "pontuação de segurança" única. O Ateliê II pede textos honestos sobre cobertura que as pessoas consigam de fato ler sob pressão de tempo. Pontuações vazias e selos de vaidade são o inimigo. Sam entrega de propósito um primeiro rascunho ruim, para que as equipes pratiquem apagar afirmações. Apagar afirmações conta como progresso quando a afirmação não tinha evidência. O progresso na exclusão é mostrado na galeria ao lado das equipes que só reescreveram adjetivos.
35.2 Texto
"71% das técnicas planejadas observadas — não é uma pontuação de risco residual." Aponte para Albrecht & Jensen no texto de ajuda. Botão: exportar denominador. Palavras como seguro e totalmente coberto são proibidas, a menos que haja uma fórmula ao lado. Linguagem simples vence o jargão quando os gestores leem na diagonal. A rubrica de Sam põe a honestidade acima de metáforas espertas. Palavras proibidas como "seguro" e "totalmente coberto" disparam um lint da CI nas strings de texto da interface. O lint imprime o termo e o caminho; no ateliê, as equipes precisam substituí-los por uma fração e uma ressalva no estilo de "71% das técnicas planejadas observadas — não é uma pontuação de risco residual" antes que a interface possa entrar.
35.3 Revisão
Os revisores tentam impor um selo de risco vermelho/amarelo/verde; o ateliê precisa segurar a linha com as regras do capítulo de medição. Leitores de fora do esquadrão marcam toda frase que não conseguem verificar. Frases inverificáveis são cortadas ou ganham fórmulas. Sam trata as marcas dos leitores como bloqueadores de merge iguais a testes reprovados, e guarda o texto marcado no dossiê, para que a passada de honestidade deixe um rastro.
Caso sintético — Riverstone Transit. O Ateliê II matou o selo; o painel agora lista pelo id as duas técnicas planejadas e não vistas.
35.4 Erros e limites
Padrões enganosos ("só para os executivos") reintroduzem pontuações vazias — rejeite-os no CODEOWNERS da interface. Prosa bonita que esconde um denominador ausente reprova no ateliê. A honestidade é uma propriedade de segurança da interface. Os facilitadores de Sam podem congelar uma equipe que defenda um selo sem conjunto planejado, e o congelamento dura até que o selo seja removido ou a fórmula seja escrita ao lado. Equipes congeladas podem continuar redigindo fórmulas, mas não podem apresentar até que um facilitador assine que a fração planejado/observado/não visto aparece sem passar o mouse, que é a mesma regra que bloqueia ressalvas só em tooltip na lista de verificação de acessibilidade.
35.2b Acessibilidade da honestidade
Métricas que subestimam ainda precisam ser legíveis: letra grande para a fração, linguagem simples para a ressalva, acesso por teclado à exportação do denominador. Esconder a ressalva num tooltip reintroduz o problema da pontuação vazia para quem não passa o mouse. Leitores de tela precisam ouvir a fórmula, não só ver uma cor. Sinais de perigo só por cor reprovam em acessibilidade e em honestidade ao mesmo tempo. Sam testa as exportações com um navegador só de texto na lista de verificação do ateliê. Os resultados do navegador só de texto são colados nas notas do ateliê ao lado da captura de tela da interface. Se o leitor de tela ouvir só "verde" enquanto a captura mostra 5/7, o texto reprova até que a fração esteja no texto acessível.
35.3b A exportação como fonte da verdade
Se a interface e a exportação em CSV discordarem, a exportação vence para o relatório. Construa as exportações primeiro; trate a interface como uma visão. Isso acaba com discussões sobre o que "71%" queria dizer numa captura de tela. Os revisores conferem os números a partir do arquivo. A lista de verificação de release de Sam compara as legendas da interface com os cabeçalhos da exportação. Não se pode criar tags enquanto essas diferenças estiverem vermelhas, o que mantém a exportação em CSV — a fonte da verdade para o número de 71% — alinhada com o que a interface afirma. Uma captura de tela num relatório precisa trazer o nome e o hash do arquivo de exportação de onde foi tirada.
35.1b Exportações narrativas
Ao lado do CSV, exporte uma breve narrativa em Markdown gerada pela mesma consulta da interface ("planejadas 7, observadas 5, não vistas: T1059, T1021"). As narrativas entram nos relatórios sem a ambiguidade das capturas de tela. Narrativas curtas que repetem a fórmula ajudam quem não é engenheiro sem substituir os números. Sam limita as narrativas a cinco linhas, para que não contrabandeiem afirmações novas. O limite de linhas é imposto por um linter no modelo de exportação narrativa. Quando uma narrativa passa de cinco linhas, o job de exportação grava um esboço dizendo quais linhas precisam encolher — em geral, um adjetivo de severidade contrabandeado — em vez de emitir um arquivo Markdown pronto para o relatório.
Nota de prática
A pesquisa com usuários do PulseMap inclui uma tarefa: explicar este número a um diretor financeiro sem dizer que estamos seguros. Se os usuários não conseguem, o texto da interface falhou, seja qual for o design visual. Grave essas sessões (com consentimento) como evidência qualitativa ao lado da fórmula quantitativa de cobertura.
35.4b Testar o texto com leitores reais
Sam pede a dois gestores e um operador da Riverstone Transit, nenhum dos quais participou do desenho, que leiam em voz alta o resumo do relatório e expliquem o que ele significa. Onde eles hesitam ou interpretam mal uma severidade, a redação muda; testes de leitura pegam ambiguidades que os revisores que escreveram o texto não conseguem ver. Leitores reais encontram jargão e denominadores ausentes mais rápido que os autores. Sam reserva dois gestores e um operador para o teste de texto de cada ateliê e arquiva as notas deles com o ADR. As notas podem omitir nomes a pedido de um gestor, mas cada problema ainda leva um id como COPY-12, para que a correção que esclareceu "não é uma pontuação de risco residual" possa ser rastreada sem uma trilha de culpa.
Exercícios
- EX103 — Texto. Escreva o subtítulo sob o número de cobertura. Rubrica: 3 = nega a leitura como risco residual; 2 = ressalva fraca; 1 = nenhuma; 0 = sugere segurança.
- EX104 — Recusa do selo. Uma frase recusando um selo RAG. Rubrica: 3 = clara + alternativa; 2 = só recusa; 1 = aceita; 0 = nada.
- EX105 — Exportação. Que colunas a exportação do denominador inclui? Rubrica: 3 = id da técnica, planejada, observada, notas; 2 = parcial; 1 = só %; 0 = nada.
Síntese
Uma interface que ensina a métrica, não um semáforo de impressões.
Continue estudando — capítulo 35 de 50
← Capítulo 34 (rascunho) · Índice de capítulos do curso · Capítulo 36 (rascunho) →