Perguntas frequentes

O Decretum é um registro de decisões: um histórico estruturado e pesquisável do que uma organização decidiu, quem aprovou e por quê. Em vez de uma decisão viver numa reunião, numa troca de e-mails ou numa mensagem de chat, ela vive num registro de decisão, com sua discussão, suas tags e uma trilha de aprovação nomeada anexada.

Para qualquer organização em que decisões hoje são tomadas em lugares dispersos: reuniões, e-mail, Teams ou Slack, sem uma forma confiável de encontrar depois o raciocínio por trás de uma delas. Foi feito para a organização inteira, não só engenharia: equipes de compliance, compras e operações tomam decisões que valem a pena registrar tanto quanto as equipes de engenharia.

Sim, por padrão. A visibilidade de uma decisão é em toda a organização, a menos que alguém a marque deliberadamente como restrita, então qualquer pessoa na organização pode encontrá-la pela pesquisa e comentar diretamente no registro, mesmo que não tenha participado da discussão original. Isso importa porque muitas vezes é alguém fora da sala que tem o contexto relevante: uma regra de compliance, uma limitação técnica ou um compromisso já assumido com um cliente. Descobrir isso depois que a decisão já foi implementada é pior do que descobrir enquanto ela ainda está sendo tomada.

Uma wiki é feita para documentação aberta. Ela não exige quem decidiu, quem aprovou e por quê como dados estruturados. Esses fatos acabam virando texto corrido, quando chegam a ser escritos. Um registro de decisão torna essa estrutura o próprio objetivo: status, aprovadores e justificativa são campos, não parágrafos que você precisa lembrar de incluir.

Ferramentas de ADR resolvem bem esse problema, mas só para equipes de engenharia trabalhando num repositório de código. O mesmo problema, decisões sem um registro pesquisável de quem e por quê, existe com a mesma frequência fora da engenharia. O Decretum é feito para a organização inteira, não só para desenvolvedores.

Sim. O Decretum pode ser implantado como um serviço de nuvem gerenciado ou como uma implantação self-hosted, on-premise, via Docker, rodando na sua própria infraestrutura com seu próprio banco de dados. Ambos são o mesmo aplicativo. Veja a página de segurança e implantação para mais detalhes.

Com e-mail e senha, Google ou Microsoft Entra ID, para que o acesso siga o provedor de identidade que sua organização já usa. Implantações self-hosted também podem se conectar a qualquer provedor de identidade compatível com OpenID Connect operado por você mesmo, como o Keycloak, para um login que nunca precisa de acesso à internet.

A primeira pessoa a se cadastrar se torna a administradora dessa organização, seja um novo workspace na nuvem ou a primeiríssima conta de uma implantação Autogerenciada recém-criada. A partir daí, os administradores convidam o restante da equipe pela página de Usuários, por e-mail, um de cada vez ou colando uma lista inteira de uma só vez, cada um com a função (leitor, colaborador, aprovador ou administrador) com a qual deve começar.

A aprovação faz parte do fluxo de trabalho, mas não é obrigatória para todo registro. Equipes que querem uma trilha de aprovação formal (um aprovador nomeado e sua justificativa registrada) podem exigi-la. Equipes que só querem um histórico pesquisável do que foi discutido e decidido podem usar o Decretum sem ela.

Sim. Qualquer pessoa pode exportar seus próprios dados como um arquivo JSON, ou solicitar a exclusão da própria conta, a qualquer momento. A exclusão é um processo em duas etapas: a conta é desativada imediatamente e pode ser recuperada por 14 dias, depois o nome e e-mail da pessoa são substituídos permanentemente. As decisões e publicações que ela criou permanecem no lugar, atribuídas a "Usuário excluído", como parte do registro da organização. O Decretum é um registro de decisões imutável, então uma decisão não desaparece porque a pessoa que a tomou desapareceu.