Escrita clínica e de propostas de financiamento: privacidade, rascunhos rastreáveis e LaTeX offline

Por que quem escreve na área médica, de saúde pública e de financiamento se importa com o local onde o rascunho fica guardado, e como um editor de pesquisa local, com Git de verdade, compilação offline e sem conta, se encaixa nos ciclos de revisão.

Manuscritos clínicos e textos de propostas de financiamento muitas vezes contêm detalhes sensíveis antes mesmo de a desidentificação estar concluída. Colocar cada tecla digitada em um editor de terceiros é tanto uma decisão de política quanto uma preferência de ferramenta. Comitês de ética em pesquisa (IRBs), acordos de uso de dados e a TI do hospital não se importam que um editor na nuvem fosse conveniente às 23h.

Este post trata de redigir e compor o texto de um jeito que você consiga explicar ao setor de conformidade. Considere-o um conselho de fluxo de trabalho, não uma revisão jurídica.

Arquivos simples são mais fáceis de avaliar

Uma pasta com .tex e figuras pode ficar dentro de um disco criptografado, da imagem de um notebook do hospital ou de uma máquina isolada da rede (air-gapped). Você pode apontar um caminho para a conformidade. Projetos no navegador exigem que você confie no modelo de acesso, no caminho de exportação e na lista de subprocessadores de um fornecedor.

O Oleafly (abre em uma nova guia) foi feito assim de propósito: sem conta, sem telemetria do produto, com projetos como pastas comuns e um repositório Git de verdade. A página de privacidade é curta porque o documento não precisa de um servidor do Oleafly para existir. A rede serve para ações que você executa (pacotes, busca opcional de citações, IA hospedada se você a ativar, GitHub), não para cada tecla digitada no rascunho.

Se a política proíbe IA na nuvem, deixe o assistente desligado ou aponte-o para um modelo local. O editor, o ciclo de compilação e o Git continuam funcionando.

Controle de alterações sem viver no Word

Pesquisadores principais (PIs) de propostas de financiamento ainda pedem o “controle de alterações”. No mundo do LaTeX, isso costuma significar histórico do Git mais comentários em PDF dos coautores, ou uma exportação curta para Word para quem se recusa a instalar qualquer coisa. Mantenha o .tex como fonte da verdade; veja coautores que só falam Word.

No Oleafly, todo projeto é um repositório Git desde o primeiro dia: pontos de verificação automáticos depois de compilações bem-sucedidas e de edições paradas, diffs lado a lado, restauração com um clique e GitHub opcional quando você quiser um remoto privado. Você pode bifurcar o pacote inteiro de uma candidatura em um segundo projeto (com o histórico completo) para testar um corte arriscado sem mexer na cópia que será submetida. Se você usar o assistente de IA opcional, ele cria um ponto de verificação antes da primeira edição e só aplica alterações por meio de diffs de aprovação.

Dê aos commits nomes de objetivos ou de seções (aim2-methods-cut) para que um PI consiga percorrer o histórico sem ler diffs como um engenheiro de software.

Trabalhar offline é útil em hospitais

As redes clínicas bloqueiam domínios de SaaS aleatórios. Um compilador local permite continuar escrevendo entre uma sessão e outra do prontuário eletrônico (EHR). O Oleafly já traz o Tectonic (e o Typst) dentro do app; os pacotes ficam em cache depois do primeiro uso, e o modo offline pode bloquear o acesso do compilador à rede. A correção ortográfica e gramatical roda localmente sobre a prosa (ignora comandos e matemática). Essas são as restrições com que a TI de hospitais costuma se preocupar, por isso os editores de pesquisa locais surgem com frequência.

O SyncTeX e um PDF ao lado do código-fonte fazem diferença quando você está ajustando o limite de páginas no computador de um posto de enfermagem com Wi-Fi instável.

Modelos, limites de páginas e pré-verificação

Os modelos no estilo NIH e os de fundações giram em torno de margens, fontes e limites de páginas. Os pacotes de geometria e de fontes importam mais do que macros engenhosas. Compile em PDF e confira o número de páginas depois de cada corte importante, não na noite anterior ao fechamento do portal. Comece por um modelo conhecido da galeria quando houver um adequado; mesmo assim, confira o edital (FOA) vigente quanto a fontes, margens e estrutura (os Specific Aims em uma página significam uma página).

Quando o PDF precisa sobreviver a um leitor automático (currículos, alguns portais institucionais), a Pré-verificação mostra, antes do envio, resultados sobre a estrutura e sobre a extração de texto no estilo de um parser. São sinais heurísticos de risco que você pode ler e tratar.

Colaboração entre vários PIs

Distribua a responsabilidade pelos arquivos por seção ou por objetivo. Uma pessoa fica responsável pelo .bib principal ou pela exportação do grupo compartilhado do Zotero. Combine se os coautores editam o TeX ou devolvem comentários no PDF. Use remotos privados apenas em hospedagens Git institucionais aprovadas quando a política exigir; nem todo rascunho de proposta de financiamento deve ficar no GitHub público.

Gerenciadores de referências

Grupos compartilhados do Zotero exportam um .bib que vários PIs podem atualizar. Importe-o no projeto, cole DOIs ao adicionar novas citações e valide os campos ausentes antes do envio, para que os anos não apareçam como [?] no PDF final: validador de BibTeX. O Oleafly completa e confere as chaves de citação com a bibliografia do projeto enquanto você escreve, então chaves \cite quebradas aparecem antes do log.

Figuras e PHI

Nunca coloque dados identificáveis de pacientes em figuras ou legendas destinadas a um repositório que outras pessoas possam clonar. Use esquemas desidentificados. Guarde tudo o que ainda for sensível sob os mesmos controles do conjunto de dados clínicos, e não ao lado do diagrama público de métodos.

O que isto não é

O local-first continua sujeito à revisão do IRB, aos acordos de uso de dados e à desidentificação. Se você ativar a IA hospedada ou enviar para um remoto, alguns bytes saem da máquina sob as políticas desses serviços. O que o local-first muda é o caminho padrão para redigir um texto sensível: uma pasta que você controla, um editor que roda offline e um histórico que você pode restaurar sem pedir uma exportação a um fornecedor.

Configuração inicial prática

  1. Crie um projeto local; ative a compilação offline depois que os pacotes estiverem em cache.
  2. Deixe a IA desligada, a menos que a política e a equipe concordem com um provedor.
  3. Remoto privado somente em um host aprovado.
  4. Responsáveis por seção e um único responsável pela bibliografia.
  5. Conferência do número de páginas depois de cada corte importante em objetivos e estratégia de pesquisa.

Escreva como se um responsável pela conformidade fosse perguntar onde o rascunho ficava. Se a resposta for “uma pasta no notebook criptografado, histórico do Git local, remoto privado opcional”, você está em melhor situação do que com “uma conta em um serviço que nunca revisamos”.

Todas as postagens