常見問題

常見問題

人們在導入決定登記簿之前實際會問的問題。

Decretum 是什麼?

Decretum 是一份決定登記簿:一份結構化、可搜尋的紀錄,記載組織做出的決定、核准者,以及原因。決定不會存在於會議、電子郵件往來或聊天訊息中,而是存在於一份決定紀錄裡,附有其討論內容、標籤,以及具名的核准紀錄。

適合誰使用?

適合目前決定分散在會議、電子郵件、Teams 或 Slack 等各處,事後又沒有可靠方法找到背後理由的任何組織。它是為整個組織打造的,而不僅是工程部門:採購、法規遵循與營運團隊做出值得記錄的決定,頻率並不亞於工程團隊。

決定團隊以外的人可以檢視或留言嗎?

可以,這是預設行為。除非有人刻意將決定標記為限制存取,否則其公開範圍為整個組織,任何人都能透過搜尋找到它,並直接在紀錄上留言,即使他們並未參與原始討論。這很重要,因為往往是不在現場的人握有相關背景:一項法規遵循規定、一項技術限制,或是已經對客戶做出的承諾。等到決定上線後才發現,比在決定仍在討論時就發現,情況更糟。

這與 Confluence 或 Notion 這類 Wiki 有何不同?

Wiki 是為開放式文件撰寫而設計的,它不會將「誰決定的」「誰核准的」以及「為什麼」,以結構化資料的形式強制記錄下來。這些事實即使真的被寫下來,也只會淪為一段敘述性文字。決定紀錄則將這樣的結構本身當作重點:狀態、核准人與理由都是欄位,而不是需要自己記得補上的段落。

這與架構決策紀錄(ADR)工具有何不同?

ADR 工具很好地解決了這個問題,但僅限於在程式碼儲存庫中工作的工程團隊。同樣的問題,也就是缺乏可搜尋的「誰、為什麼」紀錄,在工程部門之外同樣普遍。Decretum 不只是為開發者打造,而是為整個組織打造。

Decretum 可以自行代管嗎?

可以。Decretum 可以作為代管的雲端服務,或透過 Docker 以自行代管的地端部署方式,在您自己的基礎架構與資料庫上執行。兩者都是相同的應用程式。詳情請參閱安全性與部署頁面。

使用者如何登入?

可透過電子郵件與密碼、Google 或 Microsoft Entra ID 登入,讓存取權限沿用組織既有的身分識別提供者。自行代管的部署也能連接您自行運作、符合 OpenID Connect 標準的身分識別提供者(例如 Keycloak),實現完全不需要網際網路連線的登入方式。

使用者如何加入組織?

第一位註冊的人會成為該組織的管理員,無論是全新的雲端工作區,還是全新自行架設部署的第一個帳戶都是如此。之後,管理員可從「使用者」頁面以電子郵件邀請其餘團隊成員,可以一次邀請一人,也可以一次貼上整份名單,並分別指定各自一開始的角色(讀者、貢獻者、核准者或管理員)。

是否每項決定都必須經過核准?

核准是工作流程的一部分,但並非每份紀錄都強制要求。想要正式核准紀錄(一位具名核准人及其說明的理由)的團隊可以要求執行此步驟。只想保留一份可搜尋的討論與決定紀錄的團隊,則可以在不使用核准功能的情況下使用 Decretum。

使用者可以刪除自己的帳戶或匯出自己的資料嗎?

可以。任何人都能隨時將自己的資料匯出為 JSON 檔案,或申請刪除自己的帳戶。刪除分為兩個階段:帳戶會立即停用,並在 14 天內可以復原,之後該使用者的姓名與電子郵件會被永久取代。該使用者撰寫的決定與貼文仍會保留,並在組織紀錄中歸屬為「已刪除的使用者」。Decretum 是不可變更的決定登記簿,因此不會因為做出決定的人已刪除帳戶,該決定本身就跟著消失。