Preguntas frecuentes
Preguntas frecuentes
Preguntas reales que la gente hace antes de adoptar un registro de decisiones.
¿Qué es Decretum?
Decretum es un registro de decisiones: un historial estructurado y buscable de lo que una organización decidió, quién lo aprobó y por qué. En lugar de que una decisión viva en una reunión, una cadena de correos o un mensaje de chat, vive en un registro de decisión, con su discusión, sus etiquetas y un historial de aprobación identificado adjunto.
¿Para quién es?
Para cualquier organización donde las decisiones actualmente se toman en lugares dispersos: reuniones, correo, Teams o Slack, sin una forma confiable de encontrar después el razonamiento detrás de una de ellas. Está hecho para toda la organización, no solo ingeniería: los equipos de cumplimiento normativo, compras y operaciones toman decisiones que vale la pena registrar tan a menudo como los equipos de ingeniería.
¿Pueden las personas fuera del equipo que decide ver o comentar una decisión?
Sí, de forma predeterminada. La visibilidad de una decisión es en toda la organización a menos que alguien la marque deliberadamente como restringida, así que cualquier persona de la organización puede encontrarla mediante la búsqueda y comentar directamente en el registro, incluso si no formó parte de la discusión original. Esto importa porque a menudo es alguien fuera de la sala quien tiene el contexto relevante: una norma de cumplimiento, una limitación técnica o un compromiso ya asumido con un cliente. Descubrirlo después de que la decisión se implementó es peor que descubrirlo mientras todavía se está tomando.
¿En qué se diferencia esto de una wiki como Confluence o Notion?
Una wiki está hecha para documentación abierta. No exige quién decidió, quién aprobó y por qué como datos estructurados. Esos hechos terminan como texto narrativo, si es que llegan a escribirse. Un registro de decisión hace de esa estructura el objetivo mismo: el estado, los aprobadores y la justificación son campos, no párrafos que tienes que acordarte de incluir.
¿En qué se diferencia esto de una herramienta de registro de decisiones de arquitectura (ADR)?
Las herramientas de ADR resuelven bien este problema, pero solo para equipos de ingeniería que trabajan en un repositorio de código. El mismo problema, decisiones sin un registro buscable de quién y por qué, existe con la misma frecuencia fuera de la ingeniería. Decretum está hecho para toda la organización, no solo para desarrolladores.
¿Se puede autoalojar Decretum?
Sí. Decretum se implementa como un servicio de nube administrado o como una implementación autoalojada, on-premise, mediante Docker, funcionando en tu propia infraestructura con tu propia base de datos. Ambas son la misma aplicación. Consulta la página de seguridad e implementación para más detalles.
¿Cómo inicia sesión la gente?
Con correo y contraseña, Google o Microsoft Entra ID, para que el acceso siga el proveedor de identidad que tu organización ya usa. Las implementaciones autoalojadas también pueden conectarse a cualquier proveedor de identidad compatible con OpenID Connect que operes tú mismo, como Keycloak, para un inicio de sesión que nunca necesita acceso a internet.
¿Cómo se unen las personas a una organización?
La primera persona en registrarse se convierte en el administrador de esa organización, ya sea un nuevo espacio de trabajo en la nube o la primerísima cuenta de una implementación Autoalojada recién creada. A partir de ahí, los administradores invitan al resto del equipo desde la página de Usuarios, por correo electrónico, ya sea de a una o pegando una lista completa a la vez, cada una con el rol (lector, colaborador, aprobador o administrador) con el que deben comenzar.
¿Alguien tiene que aprobar cada decisión?
La aprobación forma parte del flujo de trabajo, pero no es obligatoria para todo registro. Los equipos que quieren un historial de aprobación formal (un aprobador identificado y su justificación registrada) pueden exigirlo. Los equipos que solo quieren un registro buscable de lo que se discutió y decidió pueden usar Decretum sin ella.
¿Alguien puede eliminar su cuenta o exportar sus datos?
Sí. Cualquiera puede exportar sus propios datos como archivo JSON, o solicitar la eliminación de su propia cuenta, en cualquier momento. La eliminación es un proceso de dos etapas: la cuenta se desactiva de inmediato y es recuperable durante 14 días, luego el nombre y correo electrónico de la persona se reemplazan de forma permanente. Las decisiones y publicaciones que creó permanecen en su lugar, atribuidas a "Usuario eliminado", como parte del registro de la organización. Decretum es un registro de decisiones inmutable, así que una decisión no desaparece porque la persona que la tomó sí lo haya hecho.