專案中管理工具

• 介面文件管理

1、最簡單的就是拿excel表格，在收個sheet裡面建一個總的介面目錄，然後每一項（可以是單獨的介面，可以是一個模組的所有介面）設定跳轉連結，跳轉到相應的介面頁面，這個excel表格可以提交的svn上方便大家及時更新和檢視。
2、利用showdoc等第三方平臺

showdoc網站開啟看著不起眼，但裡面的內容相當的強大，重點說下特點
1：支援markdown語法（所有的api介面寫作現在都支援這個吧，因為他現在太方便了）
2：支援多使用者協作，你可以在專案下面隨意新增多個使用者一起完成api文件的寫作。
3：可以分享並匯出專案，生成需要的文件格式如doc，可以離線瀏覽
4：支援響應式，手機電腦同樣精彩
5：支援專案轉讓
6：支援模版插入
7：支援歷史版本，你可以把操作恢復到以前的版本。
8：showdoc完全開源
9：可以部署到自己的伺服器
10：如果線上使用，可以設定自己的個性域名，也可以對文件進行加密，瀏覽者需要密碼才能訪問
11：可以通過一個線上測試api的工具，直接生成markdown，你幾乎不用寫程式碼就能過所有的引數自動生成

3、springboot+swagger自己來實現一個介面管理頁面。

image.png

截圖中每一個專案是一個條目，條目下有很多個介面，每個介面有請求引數說明、返回資料說明、返回示例展示，還可以直接對引數進行編輯訪問獲取新的返回示例。

• 專案管理redmine(Redmine是用Ruby開發的基於web的專案管理軟體，是用ROR框架開發的一套跨平臺專案管理系統)

● 多專案和子專案支援
● 里程碑版本跟蹤
● 可配置的使用者角色控制
● 可配置的問題追蹤系統
● 自動日曆和甘特圖繪製
● 支援 Blog 形式的新聞釋出、Wiki 形式的文件撰寫和檔案管理
● RSS 輸出和郵件通知
● 每個專案可以配置獨立的 Wiki 和論壇模組
● 簡單的任務時間跟蹤機制
● 使用者、專案、問題支援自定義屬性
● 支援多 LDAP 使用者認證
● 支援使用者自注冊和使用者啟用
● 多語言支援（已經內建了zh簡體中文）
● 多資料庫支援（MySQL、SQLite、PostgreSQL）
● 外觀模版化定製（可以使用 Basecamp 、Ruby安裝）* 專案論壇* 簡單實時跟蹤功能* SCM in整合 (SVN, CVS, Git, Mecuial, Bazaa and Dacs)

• 程式碼管理Git，可以自己搭建一個伺服器，比如gitlab

git 是一種版本控制系統，是一個命令，是一種工具
gitlib 是用於實現git功能的開發庫
github 是一個基於git實現的線上程式碼託管倉庫，包含一個網站介面，向網際網路開放
gitlab 是一個基於git實現的線上程式碼倉庫託管軟體，你可以用gitlab自己搭建一個類似於
　　　　github一樣的系統，一般用於在企業、學校等內部網路搭建git私服