帶你走進Choerodon豬齒魚的知識管理

知識管理是Choerodon豬齒魚的一個重要功能，支持在線自定義文檔編輯、成員協助共享等功能，幫助團隊集中管理創意、需求和設計。本文將會和你們聊一聊知識管理對敏捷團隊的重要性，介紹Choerodon選用XWiki做爲開發基礎的緣由，以及開發團隊如何設計Choerodon知識管理，最後會簡單介紹一下Choerodon知識管理的一些主要功能和特點。

敏捷團隊的知識管理

對於軟件開發團隊來講，每一個成員都是知識工做者，知識工做者須要具有一個很重要的能力——知識管理能力。知識是軟件行業的靈魂和生存之本，然而不少時候你們都忽略或輕視了團隊知識管理的重要性，因此Choerodon但願可以爲團隊提供一個便捷高效的知識管理方式。

Choerodon豬齒魚知識管理是爲了解決敏捷團隊在快速迭代的開發過程當中可能忽視的知識沉澱、文檔管理和團隊協做等問題而誕生的。

印第安人在趕了3天路以後，會停下來小憩一天，由於他們要等待本身的靈魂跟上來。敏捷開發過程也是如此，在經歷一個迭代或者衝刺以後，也須要作一些休整，那就是敏捷回顧。每次回顧時，團隊成員須要概括總結開發過程當中積累下來的各類問題或經驗，並將這些知識記錄在可共享的wiki上，這樣既便於團隊成員互相學習，也利於之後須要時快速查閱。

爲何基於XWiki開發Choerodon知識管理

如今常見到的wiki有不少，開源免費的如 MediaWiki、DokuWiki，企業收費的如 Confluence等。在開發Choerodon豬齒魚知識管理初期，團隊但願可以選擇一款既開源，又能針對Choerodon豬齒魚平臺的應用場景，作定製化的wiki系統。好比適應Choerodon的組織項目層級結構，以及與Choerodon豬齒魚中的敏捷管理、測試管理等作更多的互動，讓用戶可以在使用平臺時，快速準確地記錄下本身的知識，讓知識管理在應用交付和自動化運營過程當中發揮更大的價值。在通過許久對比和甄選以後，團隊選擇了一個優秀、強大的開源wiki系統——XWiki。

XWiki是由一家法國的公司XWiki SAS於2004年開發出的一款wiki系統，並於2007年開源。至今已經10多年，這個社區仍然有衆多活躍的貢獻者和使用者,而且擁有大量的客戶羣體和產品案例。XWiki有健壯的編輯器、強大的編輯語法，能提供多種拓展特性來定製化wiki。除了XWiki官方提供的功能之外，還有超過100個社區參與者貢獻的拓展項目，這些拓展均可以直接在XWiki系統的拓展市場上安裝和管理。

XWiki、Confluence以及MediaWiki對比

接下來經過XWiki與Confluence以及MediaWiki的對比，來談談Choerodon爲何選擇XWik做爲其知識管理的基礎。

XWiki是一個開源的項目，使用了LGPL開源協議，使用者可本身搭建和拓展XWiki而不須要購買任何受權。它使用java語言開發，提供了衆多面向企業的特性，而且擁有豐富的拓展庫和宏，靈活性與拓展性很強。有許多如Amazon、AFP、EDF等大型的公司使用XWiki建立知識庫或者協做工具，也有一些企業和組織使用XWiki搭建門戶網站。

Confluence是一個團隊協做軟件，由澳大利亞的公司Atlassian開發和銷售，它是一個面向業務的專業wiki，使用java開發，主要應用於企業環境。目前Confluence有許多大型客戶案例，如Facebook、eBay、Adobe等，不過使用Confluence，須要向Atlassian公司購買受權。

MediaWiki是一款使用PHP開發的開源wiki軟件，它最著名的案例就是維基百科，因此也是受衆最大的wiki。MediaWiki支持多語言管理、各類擴展和媒體格式，還可以配置wiki外觀。可是MediaWiki在權限管理，組織架構管理上並不適合Choerodon的解決方案，也不太適用企業的業務需求。

除了上面談到的三款wiki軟件以外，咱們還對比了其餘比較流行的wiki軟件，綜合考慮以後，最終選擇了開源的、有強大的拓展特性以及適應企業多種業務場景的XWiki。

Choerodon豬齒魚知識管理的設計

Choerodon豬齒魚平臺是基於spring cloud的微服務架構開發，而Choerodon知識管理選擇以XWiki做爲開發的基礎，那麼就須要作到統一的用戶、權限以及組織架構。所以開發團隊開發了微服務wiki-service，這個微服務主要用於監聽Choerodon平臺中其餘服務的操做，好比IAM的建立組織、建立項目等，而後使用http請求的形式，讓XWiki作對應的業務處理，好比建立對應的空間和頁面。另外XWiki須要使用Choerodon豬齒魚平臺統一的登陸和權限校驗，因此Choerodon在XWiki中添加了OAuth登陸認證。下圖是Choerodon豬齒魚知識管理設計示意圖：

Choerodon豬齒魚平臺中有三層組織層次，即全局層、組織層和項目層。Choerodon 使用三層組織結構來管理用戶、權限、項目、環境資源、菜單，以及其餘系統資源和功能。其中全局層包含了系統的一些基本設置，例如組織管理、菜單管理、全局角色管理等；組織層管理用戶、權限、項目、環境資源，以及其它系統資源和功能；項目層用來管理軟件的開發，項目屬於組織。Choerodon知識管理也是按照組織層和項目層，以及組織和項目下的空間來管理wiki的。爲了保證XWiki與Choerodon平臺有統一的組織和項目以及組織、項目對應的人員、權限等，須要將每一個組織項目的建立、角色分配等都在XWiki中作對應的處理。下圖是當IAM建立一個組織時，wiki-service爲保證數據一致性作的處理：

Choerodon豬齒魚知識管理功能介紹

Choerodon知識管理實現了一個強大的Wiki平臺，容許用戶根據本身的特定需求自定義Wiki，爲企業、IT團隊提供方便的項目協做平臺和強大的項目內容管理平臺，集中式管理產品相關內容，例如需求收集、架構設計、功能設計、開發規範、命名規範、會議記錄、計劃安排等。目前Choerodon知識管理除基礎的空間頁面建立、文檔編輯、文檔共享等，還開發了一些特點功能，如我的空間、組織項目文檔權限控制、匿名分享、文檔模板等。

基本概念簡介

• 空間

空間至關於一個分組，它是一類文檔的集合，組織和項目下均可以建立空間。在空間下能夠建立對應類型的文檔樹，實現各種文檔的分別維護和管理。

• 頁面

頁面是Wiki中的基本內容單元，也就是使用者在空間下建立的文檔。頁面能夠建立在空間下或者在其餘頁面之下，這樣用戶就能夠隨意地組織團隊的文檔結構。頁面能夠進行編輯、分享、評論、收藏等操做，還支持使用多語法編輯和多人協做編輯，另外每一個頁面均可以有版本控制。

我的空間

Choerodon知識管理中除了組織項目下的共享空間以外，Choerodon還設計了一種特殊的空間——我的空間。這個空間爲每一個wiki用戶提供了一個私人的編輯區域，用戶能夠在我的空間中隨意編輯和記錄文檔，而且能夠選擇將一些文檔發佈到須要的公開區域，好比某個組織或者項目下。

空間、頁面權限

在Choerodon知識管理中，空間和頁面採用相同的權限模型，以用戶組的形式配置權限。對於組織和項目下的空間、以及空間下的頁面，在不單獨配置權限的狀況下，默認是繼承組織和項目的權限的，也就是隻有組織或者項目成員才能夠查看。

同時，用戶能夠針對某個頁面或者空間，個性化配置權限，能夠是對某個用戶組開放，也能夠對全部人或者匿名用戶開放，權限包括視圖查看、評論、編輯、修改腳本、刪除和設置管理員。以下圖的權限配置頁面所示：

匿名訪問

Choerodon知識管理的內容使用空間和頁面的形式組織，而且受到組織項目權限的管控，當用戶想將文檔分享給未註冊用戶時，能夠將一些須要公開的文檔設置成可匿名訪問，既不影響其餘頁面的權限，也保證了文檔的安全。在權限設置中選擇未註冊用戶勾選相應權限便可。

文檔模板

Choerodon知識管理預置了產品需求和敏捷回顧會議記錄等文檔的模板，能夠直接進行編輯，簡化了用戶編輯排版操做。平臺管理員也能夠自定義建立團隊經常使用文檔模板、修改頁面佈局界面。

其餘功能概述

除了上面提到的幾個特點之外，Choerodon知識管理還提供了好比：

• 全部更新、熱門：用戶能夠查看最近wiki中發生的文檔建立、編輯、評論等操做，以及一些瀏覽量較高的文檔，可以瞭解到一些新的文檔動態，及時的學習和共享。

• 最近工做、最近訪問：用戶能夠在wiki中查看到本身最近編輯以及查看的文章，方便用戶查看本身的歷史操做記錄。

• 通知：頁面的操做能夠經過站內信或者郵件的形式通知到關注者，幫助用戶及時跟進文檔的狀態。

• 搜索：wiki系統提供了強大的文章搜索引擎，能夠搜索到文章中的關鍵字，提升搜索精度。

• 導入、導出：頁面還能夠進行批量的導入導出，能夠導入office文檔，wiki會自動解析文檔內容，並添加到頁面中。

瞭解更多功能，請查看Choerodon知識管理用戶手冊。

總結

Choerodon知識管理。自發布以來，經歷了多個版本的更新和迭代，提供了愈來愈便捷和完善的功能，但願可以讓用戶在敏捷開發和項目管理過程當中，沉澱各類知識與經驗，提升團隊協做的便捷性和積極性，從此也會持續優化，歡迎各位朋友前來社區交流。

關於Choerodon豬齒魚

Choerodon豬齒魚做爲開源多雲應用平臺，是基於Kubernetes的容器編排和管理能力，整合DevOps工具鏈、微服務和移動應用框架，來幫助企業實現敏捷化的應用交付和自動化的運營管理，同時提供IoT、支付、數據、智能洞察、企業應用市場等業務組件，致力幫助企業聚焦於業務，加速數字化轉型。

你們也能夠經過如下社區途徑瞭解豬齒魚的最新動態、產品特性，以及參與社區貢獻：

• 官網：choerodon.io
• 論壇：forum.choerodon.io
• Github：github.com/choerodon
• 微信公衆號：Choerodon豬齒魚
• 微博：Choerodon豬齒魚

歡迎加入Choerodon豬齒魚社區，共同爲企業數字化服務打造一個開放的生態平臺。