Primeiros passos

Este guia leva você da criação da conta até um projeto com o seu time trabalhando junto. Ele explica a configuração guiada, organizações, times, papéis e permissões, convites, notificações, o app no celular e a segurança da conta.

Serve para quem está começando no KrakenDock e para quem administra uma organização e precisa decidir quem pode fazer o quê.

Versão em Markdown puro deste guia: https://app.krakendock.com/docs/getting-started.md?lang=pt-BR. Use-a para colar num assistente de IA ou na documentação interna do seu time.

Visão geral

Dois conceitos ajudam a entender o resto:

• Conta pessoal: todo usuário tem uma. Os projetos pessoais ficam em https://app.krakendock.com/seu-usuario.
• Organização: um espaço do time, com membros, times, papéis e projetos próprios, em https://app.krakendock.com/sua-organizacao. Você pode participar de várias.

Criar a conta

E-mail e senha

1. Abra https://app.krakendock.com/signup.
2. Preencha Nome, E-mail e Senha. A senha tem de 8 a 72 caracteres, e senhas que já vazaram na internet são recusadas.
3. O Nome de usuário (opcional) forma as suas URLs. Em branco, o KrakenDock cria um a partir do seu nome (nunca do e-mail). Veja as regras em Nome de usuário e URLs.
4. Aceite os Termos de Uso e a Política de Privacidade e clique em Criar conta.

Login com Google ou GitHub

Na tela de login ou de cadastro, use os botões "Continuar com Google" ou "Continuar com GitHub".

• Se já existe uma conta com o mesmo e-mail, o login social se liga a ela, desde que o provedor confirme que o e-mail é verificado.
• Uma conta criada pelo login social não tem senha. Para também entrar com e-mail e senha, vá em Configurações → Conta e use Enviar link para definir senha.
• Se a conta tem autenticação em dois fatores, o código também é pedido depois do login social.

Verificar o e-mail

Depois do cadastro, você recebe um e-mail com um link de verificação. O link vale 48 horas.

Enquanto o e-mail não é verificado, um aviso aparece no topo do app, com o botão Reenviar e-mail. Algumas ações exigem o e-mail verificado:

• convidar pessoas e aceitar convites dentro do app;
• gerar cards com IA e enviar reuniões;
• assinar um plano;
• comentar, propor cards ou pedir para trabalhar em cards de projetos públicos de outras pessoas.

Quem se cadastra pelo link de um convite recebido por e-mail já começa com o e-mail verificado.

Esqueceu a senha? Use Esqueceu a senha? na tela de login. O link de redefinição vale 1 hora, e redefinir a senha encerra as sessões em todos os aparelhos.

Configuração guiada

Logo depois do cadastro, o KrakenDock abre a configuração guiada em /me/welcome. Ela leva cerca de 2 minutos:

• Pular configuração fecha o assistente a qualquer momento.
• O passo da IA consome créditos de IA do plano e exige o e-mail verificado.
• Depois, o início mostra o checklist Primeiros passos, até você concluir os itens ou dispensá-lo. O link Refazer configuração guiada abre o assistente de novo.
• Se você chegou por um convite, o cadastro volta para a tela do convite em vez do assistente.

Nome de usuário e URLs

Usuários e organizações dividem o mesmo espaço de nomes. O nome de usuário de uma pessoa e o identificador de uma organização formam as URLs:

https://app.krakendock.com/seu-usuario
https://app.krakendock.com/sua-organizacao/CHAVE
https://app.krakendock.com/sua-organizacao/CHAVE/cards/CHAVE-12

Regras:

• de 2 a 48 caracteres: letras minúsculas, números e hífen;
• sem hífen no início, no fim ou duplo;
• alguns nomes são reservados pelo sistema, como admin, api, settings e docs.

Você troca o nome de usuário em Configurações → Perfil, e o identificador de uma organização em Configurações da organização → Geral. Na troca, as URLs antigas param de funcionar na hora, sem redirecionamento, e o nome antigo fica livre para outra pessoa.

Organizações

Use uma organização quando mais de uma pessoa vai trabalhar nos projetos. Ela reúne membros, times, papéis, cobrança e integrações num lugar só.

Criar uma organização

1. No início, clique em Nova organização (ou abra /new e escolha Organização).
2. Preencha o Nome. O Identificador (opcional) vira a URL, e em branco é derivado do nome.
3. Se quiser, preencha descrição, site, e-mail de contato público e logo.
4. Clique em Criar organização. Você entra como Owner.

Cada pessoa pode ter só uma organização no plano gratuito. Para criar outra, assine um plano pago na primeira.

As configurações ficam em Configurações da organização, com as seções Geral, Membros, Times, Roles, Convites, Plano e uso, Chaves de IA, Integrações e Templates de projeto. Qualquer membro vê as seções. Quem não tem a permissão vê tudo em modo só leitura, com um aviso dizendo qual permissão falta.

Times

Um time agrupa membros da organização e dá a todos eles o mesmo acesso a vários projetos.

1. Em Configurações da organização → Times, clique em Novo time.
2. Abra o time e use Adicionar membros. Só membros da organização entram em times.
3. Na aba Projetos, clique em Vincular projetos, escolha os projetos e o Papel padrão do time neles.

Também dá para fazer o caminho inverso: nas configurações do projeto, em Colaboradores e times, use Conceder acesso a um time. Times só existem em organizações, e dar acesso a um projeto exige a permissão de gerenciar os acessos dele.

Papéis e permissões

O KrakenDock controla o acesso com papéis (roles). Um papel é um conjunto de permissões. Há papéis de organização e papéis de projeto.

Papéis de projeto

Valem num projeto, dados a um colaborador direto ou a um time.

• Write é o papel do dia a dia: trabalha em cards, sprints, wiki e IA, mas não exclui cards nem mexe nas configurações.
• Triage cuida da caixa de triagem e das denúncias e edita qualquer card (labels, prioridade, duplicados). Não exclui cards nem gerencia membros, sprints, wiki ou configurações.
• Contributor comenta, propõe cards e edita ou move só os cards atribuídos a ele ou criados por ele. É pensado para quem colabora de fora. Veja Projetos open source.
• Read só lê.

Papéis de organização

Regras do Owner:

• Só um Owner dá ou tira o papel Owner, convida alguém como Owner ou remove outro Owner.
• A organização sempre mantém pelo menos um Owner. Rebaixar, remover ou deixar sair o último Owner falha.

Roles personalizadas

Numa organização, quem pode gerenciar roles cria papéis próprios em Configurações da organização → Roles → Novo role.

• Escolha o escopo (Organização ou Projeto) e marque as permissões daquele escopo.
• As permissões de organização são Gerenciar organização, Gerenciar membros, Gerenciar roles, Gerenciar times, Criar projetos, Gerenciar projetos (acesso total a todos os projetos), Gerenciar cobrança, Gerenciar credenciais de IA e Gerenciar integrações.
• O nome não pode repetir o de outro papel, nem o de um papel do sistema.
• Os papéis do sistema não podem ser editados.
• Um papel em uso por membros, times, colaboradores ou convites não pode ser excluído.

Exemplo: um papel de organização "Gestor de projetos" com Criar projetos e Gerenciar times, sem acesso à cobrança.

Projetos pessoais usam só os papéis do sistema.

Como o acesso é calculado

A permissão de uma pessoa num projeto é a soma de tudo o que ela recebeu:

1. o dono de um projeto pessoal tem todas as permissões;
2. numa organização, quem tem Gerenciar projetos tem todas as permissões em todos os projetos dela;
3. os papéis dos times da pessoa no projeto;
4. o papel de colaborador direto.

• Num projeto de organização, todo acesso exige ser membro da organização. Quem sai ou é removido da organização perde os times, as colaborações e os convites abertos dela.
• Num projeto público, qualquer pessoa, mesmo sem conta, pode ver o conteúdo. Para escrever, é preciso um papel.
• Quem não é membro de um projeto privado recebe "não encontrado", sem saber que ele existe.

Para dar a alguém acesso a só alguns projetos da organização, use o papel Member e conceda os projetos por um time ou como colaborador direto.

Criar o primeiro projeto

1. No início, clique em Novo projeto (ou abra /new).
2. Escolha o Dono: a sua conta pessoal ou uma organização em que você pode criar projetos.
3. Escolha um Template, ou Em branco.
4. Preencha o Nome e a Chave. A chave é o prefixo dos cards (por exemplo, APP-12): de 2 a 10 letras maiúsculas ou números, começando com letra. Ela não muda depois.
5. Num projeto em branco, escolha a Metodologia da primeira board: Scrum (sprints, backlog e planejamento em ciclos) ou Kanban (fluxo contínuo, sem sprints). Você pode criar outras boards depois, cada uma com a sua metodologia.
6. Escolha a Visibilidade e clique em Criar projeto.

Em Detalhes opcionais ficam a descrição, a imagem, o site e os tópicos do projeto.

Visibilidade

• Num projeto público, você escolhe se permite Permitir comentários de não-membros e Permitir sugestões de cards de não-membros. Os dois exigem login com e-mail verificado.
• Tornar um projeto público expõe cards (inclusive os arquivados), comentários, sprints, o histórico da wiki e a lista de membros. Reuniões, transcrições, IA e a lista de acessos continuam privados.
• A visibilidade muda depois em Configurações do projeto → Visibilidade. Num projeto pessoal, só o dono muda. Numa organização, só quem tem Gerenciar projetos.

Templates

O template define a metodologia e a estrutura inicial: boards e colunas, labels, campos, templates de card e a sprint inicial. Cards, páginas da wiki e membros não são copiados.

Além dos templates prontos, você pode salvar um projeto existente como template e reusá-lo nos próximos. Veja Campos e templates.

O projeto também pode nascer com as issues de um repositório do GitHub. Veja GitHub.

Convidar pessoas

Todo convite vai por e-mail, vale 7 dias e precisa ser aceito pela pessoa. Nada é aceito sozinho: nem o cadastro, nem o login aceitam um convite.

Quem convida precisa ter o e-mail verificado. O formulário aceita até 20 e-mails por envio, separados por vírgula, ponto e vírgula, espaço ou linha.

Convidar para a organização

1. Em Configurações da organização → Membros, clique em Convidar pessoas (ou vá direto em Convites).
2. Informe os e-mails e o Papel de organização.
3. Clique em Enviar convites.

É preciso a permissão Gerenciar membros. Só um Owner convida alguém como Owner.

Convidar para um projeto

1. Em Configurações do projeto → Colaboradores e times, use Convidar por e-mail.
2. Informe os e-mails e o Papel de projeto, e envie.

O que acontece depende de quem é a pessoa:

Convidar para um projeto exige a permissão Gerenciar acessos. Se o convite traz alguém novo para a organização, é preciso também Gerenciar membros.

Aceitar um convite

A pessoa convidada recebe um e-mail com o botão para ver o convite.

• Sem conta: escolhe Criar conta. O e-mail fica travado no endereço convidado e, depois do cadastro, ela volta ao convite para aceitar.
• Com conta: escolhe Já tenho conta, entra e responde.
• Logada com outro e-mail: o KrakenDock avisa e oferece trocar de conta. O convite só pode ser aceito pela conta do e-mail convidado.

Na tela do convite, use Aceitar convite ou Recusar. Quem já tem conta também vê os convites pendentes num aviso no início, no sino de notificações e em Configurações → Convites.

Gerenciar convites pendentes

A lista Convites pendentes fica em Configurações da organização → Convites e, para projetos, em Colaboradores e times.

• Reenviar gera um link novo, renova a validade e manda o e-mail de novo. Espere 1 minuto entre dois envios para o mesmo e-mail.
• Copiar link gera um link novo sem mandar e-mail, para você enviar por outro canal. O link anterior para de funcionar. Quem aceita por esse link precisa ter o e-mail já verificado.
• Revogar cancela o convite.

Um convite pendente já ocupa vaga no limite do plano. Se o limite acabar, o envio é recusado com um link para os planos.

Notificações

O sino no topo mostra as notificações mais recentes e o número de não lidas. A página completa fica em https://app.krakendock.com/notifications, com filtro de não lidas e por tipo. Tudo se atualiza em tempo real, sem recarregar a página.

Preferências

Em Configurações → Notificações (https://app.krakendock.com/settings/notifications), escolha os canais de cada tipo: No app, Por e-mail e Push. As mudanças são salvas na hora.

• Você nunca é notificado das próprias ações.
• Comentários seguidos no mesmo card, em 5 minutos, viram uma notificação só.
• Os lembretes de prazo seguem o seu fuso horário, que o KrakenDock sincroniza com o do navegador.
• Todo e-mail de notificação tem um link para cancelar aquele tipo de e-mail com um clique.
• Avisos neste navegador liga ou desliga o aviso na tela quando chega uma notificação. Vale só para o navegador em uso.

App no celular (PWA)

O KrakenDock pode ser instalado na tela inicial do celular ou do computador e abre em janela própria, como um aplicativo.

Instalar o app

• Android e computador (Chrome, Edge): no menu do usuário, use Instalar app. No celular, um aviso também oferece Instalar.
• iPhone e iPad: abra no Safari, toque em Compartilhar e escolha Adicionar à Tela de Início. O aviso Como instalar mostra o passo a passo.

Quando sai uma versão nova, o app mostra Nova versão disponível. Clique em Atualizar quando quiser: o app nunca recarrega sozinho, para você não perder o que está editando.

Sem conexão, o app mostra o que já foi carregado, mas não salva alterações até a rede voltar.

Notificações push

Quando o push está disponível, Configurações → Notificações mostra o interruptor Notificações neste aparelho e a coluna Push na tabela.

1. Ligue Notificações neste aparelho. O navegador pede permissão.
2. Escolha na coluna Push quais tipos devem chegar no aparelho.

• Vale para cada aparelho e navegador separadamente.
• No iPhone e no iPad, o push só funciona com o app instalado na tela de início (iOS 16.4 ou mais novo).
• Redefinir a senha desliga o push em todos os aparelhos. Trocar a senha desliga nos outros aparelhos e mantém o atual.

Segurança da conta

Autenticação em dois fatores

Com a autenticação em dois fatores (2FA), o login pede um código de 6 dígitos do seu aplicativo autenticador além da senha (ou do login social).

1. Vá em Configurações → Conta → Autenticação em dois fatores e clique em Ativar.
2. Escaneie o QR code com um aplicativo autenticador, como Google Authenticator, 1Password ou Authy. Se preferir, digite a chave mostrada.
3. Digite o código de 6 dígitos que o aplicativo mostra.
4. Guarde os 10 códigos de recuperação (Baixar .txt) e clique em Já guardei. Eles não aparecem de novo.

• Sem o celular, use Usar um código de recuperação na tela do código. Cada código vale uma vez.
• Com poucos códigos sobrando, use Gerar novos códigos. Os antigos deixam de valer.
• Desativar pede um código e, se a conta tem senha, a senha atual.

Na mesma página você altera a senha (Alterar senha encerra as outras sessões), exporta os seus dados e exclui a conta.

Exigir 2FA na organização

No plano Business, o Owner pode exigir 2FA de todos os membros em Configurações da organização → Geral → Exigir 2FA.

• O Owner precisa ter o 2FA ativo na própria conta antes.
• Antes de confirmar, o KrakenDock lista quem ainda não usa 2FA.
• Membros sem 2FA perdem o acesso à organização e aos projetos dela até ativarem. Eles veem um aviso com o atalho para ativar.
• A lista de Membros mostra quem usa 2FA.

Atalhos de teclado

Aperte ? em qualquer página para ver os atalhos disponíveis ali, ou use Atalhos de teclado no menu do usuário. Os atalhos não funcionam enquanto você digita num campo.

Usa leitor de tela ou atalhos próprios? Desligue em Ativar atalhos de teclado, na janela de atalhos.

Limites por plano

Projetos, projetos públicos e times não têm limite de plano. O que o plano limita são as pessoas com acesso a projetos privados.

Conta pessoal:

Organização:

• Na conta pessoal, contam os colaboradores e os e-mails com convite pendente nos projetos privados.
• Na organização, contam os membros e os e-mails com convite pendente. O limite só vale enquanto a organização tem algum projeto privado: uma organização só com projetos públicos não tem limite de membros.
• Cada pessoa cria no máximo uma organização no plano Free.
• O uso fica em Plano e uso, nas configurações da conta ou da organização.

Veja os planos e os preços em https://app.krakendock.com/pricing.

Perguntas frequentes

Não recebi o e-mail de verificação. E agora?

Confira a caixa de spam. Depois, use Reenviar e-mail no aviso do topo do app. O link vale 48 horas.

Conta pessoal ou organização?

Comece pela conta pessoal se você trabalha sozinho ou quer só experimentar. Crie uma organização quando o time chegar: ela tem membros, times, papéis personalizados e cobrança própria.

Como dou acesso a só alguns projetos da organização?

Convide a pessoa com o papel Member, que não tem nenhuma permissão de organização. Depois, conceda os projetos por um time ou como colaborador direto, com um papel de projeto.

Por que não consigo convidar ninguém?

Confira, nesta ordem:

1. Seu e-mail está verificado?
2. Você tem a permissão (Gerenciar membros na organização, Gerenciar acessos no projeto)?
3. O limite do plano acabou? Convites pendentes também ocupam vaga.
4. Você reenviou para o mesmo e-mail há menos de 1 minuto?

O convite expirou. O que faço?

Peça a quem convidou para usar Reenviar ou Copiar link na lista de convites pendentes. O convite volta a valer por mais 7 dias.

Perdi o celular com o aplicativo autenticador

Entre com um código de recuperação (Usar um código de recuperação). Depois, desative e ative o 2FA de novo no celular novo, e gere novos códigos.

Como saio de uma organização ou de um projeto?

Na organização, use Sair da organização em Configurações da organização → Geral. Num projeto, use Sair do projeto em Colaboradores e times. O último Owner de uma organização não pode sair antes de passar o papel a outra pessoa.

Próximos passos

Ainda com dúvidas? Fale com a gente em https://app.krakendock.com/help.