Notícias da equipa de produtos: Colaboração em tempo real em documentos
A partir da versão 17.0, lançada em janeiro de 2026, o OpenProject apresenta um módulo Documentos com design totalmente novo e capacidades de colaboração em tempo real. É um avanço significativo na forma como as equipas podem trabalhar em conjunto no OpenProject, permitindo que vários utilizadores editem documentos em simultâneo e vejam as alterações uns dos outros à medida que acontecem.
Porque precisávamos desta mudança
As equipas de projeto trabalham de forma cada vez mais distribuída e assíncrona. Quer esteja a pensar em ideias, a definir requisitos de projeto, a redigir relatórios de progresso ou a planear a fase seguinte do trabalho, a colaboração é fundamental para o sucesso dos projetos. No entanto, os fluxos de trabalho tradicionais de edição de documentos geram frequentemente fricções: os ficheiros são duplicados, as versões ficam dessincronizadas e os membros da equipa têm dificuldade em identificar a versão mais recente. A edição paralela dá origem a conflitos, perda de dados e frustração.
No OpenProject, estamos sempre a tentar encontrar formas de ajudar os nossos utilizadores a comunicar e a colaborar de melhor forma. Acreditamos que as equipas querem trabalhar em conjunto em tempo real, ver quem contribui e garantir que as suas edições não se perdem nem são substituídas. Foi precisamente por isso que trabalhámos nas atualizações do módulo Documentos.
Importante
Tenha em atenção que as alterações descritas neste artigo estavam planeadas para lançamento na versão 17.0 a 14 de janeiro de 2026.
Colaboração em tempo real no OpenProject
O módulo Documentos redesenhado traz verdadeira colaboração em tempo real ao OpenProject. Quando abre um documento, pode ver quem mais o está a editar ativamente. Os seus cursores aparecem na página, mostrando exatamente onde estão e que alterações fazem à medida que escrevem.
A colaboração em tempo real não se limita à possibilidade de ver as alterações dos outros utilizadores. Trata-se também de eliminar as barreiras que atrasam as equipas: já não precisa de esperar que alguém acabe de editar para poder dar o seu contributo, já não precisa de fundir versões contraditórias, já não precisa de procurar em anexos de e-mails ou discos partilhados para encontrar a versão mais recente de um documento. O documento mais atual está sempre no mesmo local, e todos trabalham a partir da mesma fonte de verdade.
Quais são as novidades em Documentos
O novo módulo Documentos apresenta melhorias significativas na experiência do utilizador e uma mudança tecnológica fundamental:
Edição colaborativa em tempo real: Vários utilizadores podem editar o mesmo documento em simultâneo. Pode ver quem está online, onde estão os seus cursores e o que alteram em tempo real. A complexa gestão de conflitos ocorre automaticamente em segundo plano, garantindo que não se perdem as edições de ninguém.
Moderno editor de rich text: Os documentos utilizam agora o BlockNote, um moderno editor de rich text de código aberto que torna a escrita e a formatação simples e intuitivas. Adicionar conteúdo rico como imagens, vídeos, ficheiros de áudio ou blocos de código é simples.
Referências dinâmicas a pacotes de trabalho: Agora pode incluir referências a pacotes de trabalho diretamente nos documentos com os comandos /op ou /workpackage. Estas referências são atualizadas dinamicamente, pelo que, se o nome, o estado ou o tipo de um pacote de trabalho se alterarem, são automaticamente refletidos no documento. Também facilita a ligação a funcionalidades ou erros de referência sem ter de copiar e colar manualmente informações que podem ficar desatualizadas.
Anexar ficheiros: Anexe ficheiros a qualquer documento para fornecer contexto adicional, materiais de apoio ou recursos relacionados. Tudo fica organizado num só lugar.
Melhorias no design e na utilização: Toda a interface foi recriada com foco na clareza e na facilidade de uso, em especial para garantir uma experiência de edição sem distrações.
Veja este pequeno Gif de pré-visualização que mostra as funcionalidades acima referidas:
*Pré-visualização do OpenProject 17.0: Quatro editores ativos no módulo Documentos, adicionando uma imagem de coração ao documento, ligando pacotes de trabalho, escrevendo e editando texto de forma colaborativa.
Fundamentos técnicos
Tornar possível a colaboração em tempo real exigiu um trabalho substancial na base técnica do módulo de Documentos. Adoptámos duas poderosas tecnologias de código aberto: BlockNote como editor de rich text e Hocuspocus como conjunto de ferramentas de colaboração em tempo real.
BlockNote proporciona a experiência de edição com a qual os utilizadores interagem diretamente. É extensível, moderno e concebido a pensar na colaboração. Um aspeto particularmente interessante da utilização do BlockNote é o facto de os nossos novos componentes de referência de pacotes de trabalho terem sido criados para serem genéricos e reutilizáveis, de modo a que outras ferramentas que utilizem o BlockNote possam também beneficiar destes mesmos componentes. Por exemplo, Docs, que faz parte do LaSuite francês e do [openDesk] alemão(https://www.opendesk.eu/en/product), baseia-se no BlockNote. O XWiki está também a testar uma integração com o BlockNote, que permitirá aos utilizadores destas ferramentas chamar a nossa extensão BlockNote para adicionar ligações dinâmicas aos pacotes de trabalho do OpenProject nos seus textos. A combinação da plataforma de gestão do conhecimento da XWiki com as capacidades de gestão do trabalho do OpenProject é especialmente potente como substituto do pacote Jira-Confluence da Atlassian. Estas integrações criam uma experiência mais consistente para os utilizadores que trabalham com diferentes ferramentas no seu espaço de trabalho digital.
Hocuspocus trata da complexa sincronização em tempo real e da resolução de conflitos que acontece nos bastidores. Quando vários utilizadores editam em simultâneo, o Hocuspocus garante que as alterações são combinadas corretamente, que não se perdem edições, e que a experiência de edição se mantém fluida.
Estas tecnologias formam uma base sólida para a edição colaborativa no módulo Documentos atualmente, e potencialmente noutras áreas do OpenProject no futuro.
Olhar para o futuro
O novo módulo Documentos é o primeiro passo para uma visão mais alargada da colaboração em tempo real no OpenProject. No entanto, é também um banco de ensaio. Estamos a utilizar o Documentos para aperfeiçoar a tecnologia, testar a infraestrutura e saber como os nossos utilizadores colaboram na prática.
Quando a tecnologia estiver estável e tivermos adquirido experiência no mundo real, planeamos introduzir a colaboração em tempo real noutras áreas do OpenProject onde possa trazer valor. Os pacotes de trabalho são um candidato óbvio. O nosso objetivo é permitir-lhe ver os seus colegas a editar descrições de pacotes de trabalho ou a atualizar campos personalizados em tempo real, com a mesma experiência que tem agora nos Documentos.
Como aceder ao novo módulo Documentos
Para utilizadores da Nuvem: Se tiver uma subscrição do OpenProject Cloud, o novo módulo Documentos está disponível a partir da versão 17.0. Não precisa de fazer nada. O Hocuspocus e todas as outras dependências já estão instaladas e configuradas. Basta garantir que o módulo Documentos está ativado para cada projeto onde o pretende utilizar, e pode começar a colaborar imediatamente.
Para utilizadores no local: A forma como acede aos novos documentos depende do seu tipo de instalação:
-
Instalações em contentores (Kubernetes, Docker ou gráficos Helm): Tudo funciona fora da caixa. O Hocuspocus é instalado e configurado automaticamente para si e a colaboração em tempo real é ativada por padrão.
-
Instalações baseadas em pacotes (pacotes DEB/RPM): Terá de instalar manualmente as dependências, como o Hocuspocus, e configurá-las para permitir a colaboração em tempo real.
Nota
O que acontece aos documentos existentes
Todos os documentos criados antes da versão 17.0 permanecem acessíveis exatamente como estavam, utilizando o editor de texto baseado no CKEditor. Estes documentos não suportam a colaboração em tempo real, mas estão totalmente funcionais e inalterados. Pode continuar a utilizá-los como sempre fez.
A partir da versão 17.0, todos os documentos criados recentemente utilizam o BlockNote e suportam a colaboração em tempo real (se a colaboração em tempo real estiver corretamente configurada e ativada). Isto significa que terá documentos antigos e novos a coexistir na sua instância do OpenProject. Os documentos mais antigos terão uma etiqueta “Legacy” para facilitar a sua identificação.
Importante
Se a colaboração em tempo real estiver ativada e os utilizadores criarem documentos, mas a colaboração em tempo real for posteriormente desativada (manualmente ou devido a problemas no servidor Hocuspocus), esses documentos deixarão de estar acessíveis. Sabemos que isto pode levar à perda de acesso aos dados, pelo que recomendamos vivamente que não desative a colaboração em tempo real após esta ter sido ativada.
Se a colaboração em tempo real não estiver ativada - por exemplo, porque o Hocuspocus não está disponível - os novos documentos continuarão a utilizar o estilo antigo com o CKEditor, sem funcionalidades de colaboração em tempo real.
O seu feedback
É claro que ainda há muito trabalho a fazer antes de termos colaboração em tempo real em todo o OpenProject. Gostaríamos muito que nos ajudasse a chegar lá.
O seu feedback ajudar-nos-á a compreender o que estamos a fazer bem, o que podemos melhorar e em que nos devemos focar. A edição em tempo real no OpenProject muda a sua forma de trabalhar? Vai utilizá-la nos seus próprios projetos? Quais são as formas de melhorar?
Sendo uma empresa de código aberto, desenvolvemos de forma aberta e valorizamos os contributos da nossa comunidade de utilizadores. Se tiver alguma opinião sobre o novo módulo Documentos, perguntas sobre o seu funcionamento ou ideias para o tornar ainda melhor, gostaríamos de saber. Junte-se à nossa instância comunitária e partilhe os seus comentários.
Créditos
Gostaríamos de agradecer à equipa por detrás do BlockNote - Yousef El-Dardiry, Nick Perez e Matthew Lipski - por criarem um excelente editor de rich text de código aberto. Agradecemos também à equipa da Hocuspocus por fornecer a infraestrutura robusta de colaboração em tempo real que torna isto possível.
Gostaríamos também de agradecer às equipas de design, desenvolvimento e controlo de qualidade da OpenProject pelo seu trabalho árduo para tornar tudo isto possível.
