Colabore com os seus colegas para escrever e editar documentos em tempo real

Notícias da secção de produtos: Colaboração em tempo real nos Documentos

Tempo estimado de leitura: 9 minutos

A partir da versão 17.0 - atualmente prevista para janeiro de 2026, o OpenProject introduz um módulo Documentos completamente redesenhado com capacidades de colaboração em tempo real. Isto marca 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 vão acontecendo.

Porque é que precisamos desta mudança

As equipas de projeto trabalham de forma cada vez mais distribuída e assíncrona. Quer esteja a fazer brainstorming de ideias, a elaborar requisitos de projeto, a redigir relatórios de estado ou a planear a fase seguinte do trabalho, a colaboração está no centro do sucesso dos projectos. No entanto, os fluxos de trabalho tradicionais de edição de documentos criam frequentemente fricção: os ficheiros são duplicados, as versões ficam dessincronizadas e os membros da equipa têm dificuldade em saber qual é a versão mais atual. 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 está a contribuir e ter a certeza de que as suas edições não se perdem nem são substituídas. Foi precisamente por isso que trabalhámos nas actualizações do módulo Documentos.

[!IMPORTANTE] Tenha em atenção que as alterações descritas neste artigo estão planeadas para lançamento na versão 17.0, que está atualmente agendada para 14 de janeiro de 2026.

Colaboração em tempo real no OpenProject

O módulo Documents redesenhado traz uma 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 estão a fazer, à 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 correio eletrónico ou unidades partilhadas 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.

O que há de novo em Documentos

O novo módulo Documentos representa uma melhoria significativa da 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 estão a mudar em tempo real. A complexa gestão de conflitos ocorre automaticamente em segundo plano, garantindo que as edições de ninguém se perdem.

Moderno editor de texto rico: Os documentos utilizam agora o BlockNote, um moderno editor de texto rico de fonte aberta 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 utilizando os comandos /op ou /workpackage. Estas referências são actualizadas dinamicamente, pelo que, se o nome, o estado ou o tipo de um pacote de trabalho se alterarem, são automaticamente reflectidos no documento. Isto também facilita a ligação a funcionalidades ou bugs de referência sem ter de copiar e colar manualmente informações que podem ficar desactualizadas.

Anexe ficheiros: Anexe ficheiros a qualquer documento para fornecer contexto adicional, materiais de apoio ou recursos relacionados. Tudo fica organizado num só lugar.

Design e usabilidade melhorados: Toda a interface foi redesenhada com foco na clareza e facilidade de uso, com foco especial em fornecer uma experiência de edição sem distrações.

Veja este pequeno Gif de pré-visualização que mostra as funcionalidades acima referidas:

Gif mostrando 4 editores activos no módulo OpenProject Documents, adicionando uma imagem de coração ao documento, ligando pacotes de trabalho e escrevendo e editando texto de forma colaborativa

*Pré-visualização do OpenProject 17.0: Quatro editores activos no módulo Documentos, adicionando uma imagem de coração ao documento, ligando pacotes de trabalho e 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 Documentos. Adoptámos duas poderosas tecnologias de fonte aberta: BlockNote como o nosso editor de texto rico e Hocuspocus como o nosso conjunto de ferramentas de colaboração em tempo real.

A 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, o 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 estão a editar 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 Documentions atualmente, e potencialmente noutras áreas do OpenProject no futuro.

Olhando para o futuro

O novo módulo Documentos é o primeiro passo de 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 Documents para aperfeiçoar a nossa tecnologia, testar a nossa 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 certificar-se de 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 contêineres (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 é activada por predefiniçã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

Consulte este guia de administração para obter mais informações sobre a colaboração em tempo real para instalações baseadas em pacotes.

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 o 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 activada). Isto significa que terá documentos antigos e novos coexistindo na sua instância 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 activada e os utilizadores criarem novos documentos, mas a colaboração em tempo real for posteriormente desactivada (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 desactive a colaboração em tempo real depois de esta ter sido activada.

Se a colaboração em tempo real não estiver activada - 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 concentrar. A edição em tempo real no OpenProject muda a sua forma de trabalhar? Vai utilizá-lo nos seus próprios projectos? Quais são as formas de o 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 o ouvir. 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 criar um excelente editor de texto rico 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 conceção, desenvolvimento e controlo de qualidade da OpenProject pelo seu trabalho árduo para tornar tudo isto possível.

Mantenha a ligação com OpenProject

Fique a par das últimas notícias, funcionalidades e alterações de produtos do OpenProject. Inscreva-se no nosso boletim mensal para nunca perder uma atualização.

Abrir a ligação num novo separador