자주 묻는 질문
자주 묻는 질문
결정 대장을 도입하기 전에 실제로 나오는 질문들입니다.
Decretum은 무엇인가요?
Decretum은 결정 대장입니다: 조직이 무엇을 결정했고, 누가 승인했으며, 왜 그랬는지를 기록하는 구조화된 검색 가능한 기록입니다. 회의나 이메일 스레드, 채팅 메시지 속에 묻히는 대신, 결정은 논의와 태그, 그리고 실명이 명시된 승인 이력과 함께 결정 기록 안에 남습니다.
누구를 위한 것인가요?
현재 결정이 회의, 이메일, Teams, Slack 등 여러 곳에 흩어져 내려지고, 나중에 그 이유를 확실히 찾을 방법이 없는 모든 조직을 위한 것입니다. 엔지니어링뿐 아니라 조직 전체를 위해 만들어졌습니다. 구매, 컴플라이언스, 운영 팀도 엔지니어링 팀만큼이나 자주 기록할 가치가 있는 결정을 내립니다.
결정을 내린 팀 외부의 사람도 결정을 보거나 코멘트할 수 있나요?
네, 기본적으로 가능합니다. 결정의 공개 범위는 의도적으로 제한 공개로 표시되지 않는 한 조직 전체이므로, 조직 내 누구나 검색을 통해 찾고, 원래 논의에 참여하지 않았더라도 기록에 직접 코멘트를 남길 수 있습니다. 이것이 중요한 이유는, 관련 배경을 알고 있는 사람이 종종 그 자리에 없던 사람이기 때문입니다: 컴플라이언스 규정, 기술적 제약, 또는 이미 고객과 맺은 약속 같은 것들입니다. 결정이 실행된 후에야 이를 알게 되는 것은, 아직 결정 중일 때 아는 것보다 더 나쁩니다.
Confluence나 Notion 같은 위키와는 어떻게 다른가요?
위키는 자유 형식의 문서화를 위해 만들어졌습니다. 누가 결정했고, 누가 승인했고, 왜 그랬는지를 구조화된 데이터로 강제하지 않습니다. 애초에 기록된다 해도 이런 사실들은 서술형 글 속에 묻히게 됩니다. 결정 기록은 바로 이 구조 자체를 핵심으로 삼습니다. 상태, 승인자, 근거는 기억해서 써넣어야 하는 문단이 아니라 필드입니다.
아키텍처 결정 기록(ADR) 도구와는 어떻게 다른가요?
ADR 도구는 이 문제를 잘 해결하지만, 코드 저장소에서 작업하는 엔지니어링 팀에 한정됩니다. 누가, 왜 결정했는지에 대한 검색 가능한 기록이 없다는 같은 문제는 엔지니어링 밖에서도 똑같이 흔합니다. Decretum은 개발자만이 아니라 조직 전체를 위해 만들어졌습니다.
Decretum을 자체 호스팅할 수 있나요?
네. Decretum은 관리형 클라우드 서비스로, 또는 Docker를 통해 자체 인프라와 자체 데이터베이스 위에서 실행되는 자체 호스팅형 온프레미스 배포로 제공됩니다. 둘 다 동일한 애플리케이션입니다. 자세한 내용은 보안 및 배포 페이지를 참고하세요.
로그인은 어떻게 하나요?
이메일과 비밀번호, Google, Microsoft Entra ID로 로그인합니다. 접근 권한은 조직이 이미 사용 중인 자격 증명 제공업체를 따릅니다. 자체 호스팅형 배포는 Keycloak처럼 직접 운영하는 OpenID Connect 호환 자격 증명 제공업체에도 연결할 수 있어, 인터넷 연결이 전혀 필요 없는 로그인이 가능합니다.
조직에는 어떻게 합류하나요?
처음 가입한 사람이 해당 조직의 관리자가 됩니다. 새로운 클라우드 워크스페이스든, 새로 구축한 셀프 호스팅 배포의 첫 번째 계정이든 마찬가지입니다. 이후 관리자는 사용자 페이지에서 이메일로 나머지 팀원을 초대할 수 있으며, 한 명씩 초대하거나 목록 전체를 한 번에 붙여넣을 수 있고, 각각 시작할 역할(리더, 기여자, 승인자, 관리자)을 지정할 수 있습니다.
모든 결정을 반드시 승인받아야 하나요?
승인은 워크플로우의 일부이지만 모든 기록에 필수는 아닙니다. 지정된 승인자와 그 이유의 기재라는 정식 승인 이력을 원하는 팀은 이를 필수로 설정할 수 있습니다. 논의되고 결정된 내용을 검색 가능한 형태로 남기고 싶을 뿐인 팀은 승인 절차 없이 Decretum을 사용할 수 있습니다.
계정을 삭제하거나 데이터를 내보낼 수 있나요?
네. 누구나 언제든지 자신의 데이터를 JSON 파일로 내보내거나, 자신의 계정 삭제를 요청할 수 있습니다. 삭제는 2단계로 진행됩니다. 계정은 즉시 비활성화되며 14일 동안 복구할 수 있고, 이후 해당 사용자의 이름과 이메일이 영구적으로 대체됩니다. 해당 사용자가 작성한 결정과 게시물은 조직의 기록 일부로서 "삭제된 사용자"로 표시된 채 그대로 남습니다. Decretum은 변경할 수 없는 결정 대장이므로, 결정을 내린 사람이 사라져도 그 결정 자체는 사라지지 않습니다.