KEPLIN Docs

Versionamento Trabalhar em equipa

Trabalhar em equipa

Cada pessoa na sua versão, e o checkout que impede duas pessoas de gravarem por cima uma da outra no mesmo ecrã.

Duas pessoas a construir a mesma app é o caso normal, não a excepção. O Keplin resolve-o em duas camadas, e vale a pena perceber cada uma antes de usar a outra:

  1. A versão separa trabalhos que não se devem misturar. Cada pessoa escolhe a sua e nada do que faz aparece na versão dos outros até haver um merge.
  2. O checkout protege um elemento dentro da mesma versão. Enquanto estiver bloqueado por alguém, mais ninguém o grava.

Cada pessoa na sua versão

A versão de trabalho é por pessoa. Se a Maria trocar para 1.1, o Rui continua na main sem dar por nada — e ao contrário. O botão do cabeçalho diz sempre em que versão tu estás.

O menu Versões: a versão de trabalho marcada é a de quem está a ver, não a da equipa
O menu Versões: a versão de trabalho marcada é a de quem está a ver, não a da equipa

A escolha fica guardada no servidor, associada à tua conta. Isso resolve o engano mais caro do versionamento — "troquei para a 1.1 e gravou na main" — porque a versão em que estás a gravar não depende do browser, do separador nem do computador de onde entraste.

Como consequência prática:

Situação O que acontece
Trocas de versão Só a tua vista muda. Ninguém é interrompido.
Um colega cria uma versão Ela aparece no teu menu, mas tu ficas onde estavas.
Alguém apaga a versão em que estás Não consegue: a versão de trabalho de alguém não se apaga por baixo dos pés.
Entras de outro computador Continuas na mesma versão.

Dica

Quando duas pessoas vão mexer em coisas diferentes da mesma app — uma nos ecrãs, outra nos relatórios — trabalhar na mesma versão é mais simples e evita o merge. É quando o trabalho se sobrepõe, ou quando é arriscado, que vale a pena separar em versões.

Checkout: bloquear um elemento para mim

Dentro da mesma versão, o checkout é a trava que impede duas gravações em cima uma da outra. É por elemento — um ecrã, um layout, um widget, um script, uma API, um relatório, um processo — e vive no menu de acções (o ícone de três pontos) de cada linha das árvores da app.

  1. Abre a árvore onde o elemento está (UI, Código, Dados).
  2. Passa o rato pela linha do elemento e clica no ícone de três pontos — Acções de ….
  3. Escolhe Checkout — bloquear para mim.
  4. A confirmação diz "Checkout feito — o elemento está bloqueado para os outros."

O menu de acções de um ecrã, com a opção Checkout — bloquear para mim
O menu de acções de um ecrã, com a opção Checkout — bloquear para mim

A partir daí, e até o libertares:

  • Tu gravas o elemento normalmente.
  • Os outros vêem-no, abrem-no e lêem-no — mas ao tentarem gravar são recusados, com o teu nome na mensagem.

O mesmo menu existe em todas as árvores da app, e funciona igual em todas — um script bloqueia-se exactamente como se bloqueia um ecrã.

O mesmo Checkout no menu de acções de um elemento da árvore Código
O mesmo Checkout no menu de acções de um elemento da árvore Código

Libertar o que bloqueaste

Quando acabares, devolve o elemento:

  1. Abre outra vez o menu de acções da linha.
  2. Escolhe Checkin — libertar.
  3. A confirmação diz "Elemento libertado."

O elemento volta a estar livre para toda a gente. Nada se perde no caminho — o checkout controla quem grava, não o que está gravado.

Atenção

Um checkout esquecido é a forma mais fácil de bloquear a equipa. Habitua-te a fazer Checkin — libertar no fim do trabalho, e não no fim do dia.

Quando o elemento está bloqueado por outra pessoa

Abre o menu de acções e a primeira linha, cinzenta e sem clique, diz de quem é: Em checkout por Maria Santos. É informação, não erro — o elemento continua a abrir-se e a ler-se.

Se tentares gravar mesmo assim, a recusa não é genérica: traz o nome e desde quando — "Bloqueado por Maria Santos desde 11/08/2026, 23:07." Sabes a quem perguntar.

Forçar a libertação

Um administrador — e só ele — vê no mesmo menu uma segunda opção, Forçar libertação. Serve para o caso em que a pessoa que bloqueou está de férias, saiu da equipa, ou simplesmente se esqueceu.

Usa-a com a mesma prudência com que se usa uma chave-mestra: se a pessoa estiver a trabalhar no elemento nesse momento, o trabalho dela deixa de estar protegido e a próxima gravação pode ser por cima.

Como saber quem está a mexer no quê

Duas fontes, e são complementares:

Onde O que responde
O menu de acções de cada elemento "Quem tem este elemento bloqueado agora?"
O histórico da versão "Quem gravou o quê, e quando?" — cada gravação traz o nome do autor.

O histórico está na página seguinte deste capítulo, e é o sítio onde a pergunta "quem mudou isto?" se responde sem perguntar a ninguém.

Perguntas frequentes

  • O checkout atravessa versões? Não. É por versão: bloquear um ecrã na 1.1 não bloqueia o mesmo ecrã na main, porque são elementos de versões diferentes.
  • Preciso de fazer checkout para gravar? Não. Sem checkout, quem gravar primeiro grava. O checkout é para quando isso não chega.
  • Perco o checkout se fechar o browser? Não. É estado do servidor e aguenta sessões, computadores e dias. Só sai com Checkin — libertar ou com uma libertação forçada.
  • Duas pessoas na mesma versão dão conflito? Só se gravarem o mesmo elemento. Zonas diferentes da mesma versão convivem sem problema.