管理人員
➤ 依照公司團隊建立根目錄的專案
➤ 在用戶清單中加入團隊成員
➤ 依照團隊默契建立問題樣板(或是直接使用全域問題樣板)
➤ 依據團隊建立大群組，依據職權建立小群組
➤ 建立子專案
➤ 建立新議題
開發人員
➤ 開發人員收到議題
➤ 新增子議題、相關議題
➤ 在看板調整工作進度
➤ 編輯議題
測試人員
➤ 驗證議題功能正確性
➤ 建立發現錯誤的議題並分派給相關群組

管理人員

通常都是由 team leader 擔任這個角色，如果公司允許讓管理人員擁有『管理者』的權限會更理想；因為管理團隊用戶/群組這些事情 team leader 會比較清楚，不需要一直麻煩 MIS 人員做處理。

依照公司團隊建立根目錄的專案

每個案子都需要新增一個專案，但如果全都放在專案清單會造成視覺上的錯亂，所以這裡會建議用團隊來區分案子。

STEP 1：網站管理 > 專案清單 > 建立新專案

STEP 2 ：填寫專案基礎資訊 > 建立

• 名稱：請填寫大家都看得懂的，如果專案有英文縮寫請放在代碼
• 代碼：這個欄位儲存後無法修改，請謹慎填寫
• 公開：除非是全公司都能看到的專案，不然請勿打勾
• 模組：建議全選

在用戶清單中加入團隊成員

需要用『管理者』的身份才能建立新用戶

STEP 1：網站管理 > 用戶清單 > 建立新用戶

STEP 2：填寫用戶基礎資訊 > 建立

• 管理者：跟『管理人員』的角色意義是不同的，有管理者權限的才能使用『網站管理』
• 產生密碼 & 必須在下次登入時變更密碼：建議都打勾避嫌
• 寄送帳戶資訊電子郵件給用戶：不寄信給對方他也不知道你幫他建好帳號了
• 電子郵件提醒選項：依照範例的選擇會收到最完整的 Email

依照團隊默契建立問題樣板

為了保證議題的格式有相同的 Style ，所以建議團隊要建立問題的樣板，以確保每個議題的內容都有精準描述減少來回溝通的成本。

STEP 1：在專案清單選擇專案 > 問題樣板 > 新增樣板

• 問題樣板：專門為這個專案設計的問題樣板
• 全域問題樣板：所有專案都能夠使用的問題樣板

STEP 2：填寫問題樣板內容 > 建立

• 追蹤標籤：這個樣板是給哪個追蹤標籤使用的
• 預設值：建議打勾，最後真正的預設值還是看排序，另外子專案設計的問題樣板會蓋過全域問題樣板
• 啟用：打勾後才能讓使用者選用
• 在專案樹狀結構中分享：建議打勾，因為模板通常都會共享

依據團隊建立大群組，依據職權建立小群組

每個專案都有獨立的成員列表，並賦予成員不同的角色；建議群組由大到小會分成三個層次：

• 全公司：有些專案或是資訊是要給全公司的人都知道的
• 部門團隊：比如網頁負責的是一個 Team，android app、windows app 是另外一個 Team
• 功能團隊：網頁團隊下會有不同的小組，有些負責 UI/UX 設計、有些負責後端 api 撰寫；這的層次是依造職權的分類

STEP 1：網站管理 > 群組清單 > 建立新群組

STEP 2：填寫群組名稱 > 建立

STEP 3：選擇剛剛建立的群組 > 用戶清單 > 建立新用戶 > 選擇要加入的用戶 > 新增

STEP 4：專案清單 > 加入專案 > 選擇欲加入的專案 & 加入的角色 > 新增

建立子專案

子專案才是真正的放專案資訊的地方

• 代碼：因為是子專案，建議代碼也要有關聯性方便識別
• 父專案：記得選擇
• 繼承父專案成員：建議打勾，通常成員的角色都是固定的，不太可能今天是『開發人員』明天就轉職成『測試人員』

STEP 1：網站管理 > 專案清單 > 建立新專案 > 填寫專案基礎資訊 > 建立

🌟專案重要設定說明🌟

• 成員：除了繼承父專案成員外，你還可以在這裡做角色權限調整，一個用戶可以有多重角色

• 版本：專案一定會有版本的更迭，每項議題如果都有對應的版本在管理及追蹤上可以容易釐清責任

• 議題分類清單：新人剛加入團隊時可能對成員的職權並不是很了解，如果在這裡建立分類的防可以快速幫助不熟悉團隊的人了解每個人的職權分配

• issue columns：設定議題的子議題要呈現哪些欄位

建立新議題

專案基礎配置完成後開始分配每個成員的任務，這裡先從 UI/UX 的設計圖開始

STEP 1：議題清單 > 建立新議題

STEP 2：填寫議題內容 > 建立

• 追蹤標籤＆問題樣板：問題樣板會跟著追蹤標籤顯示；用戶依照樣板填寫的資料填入必須資訊即可
• 概述：圖片可以用複製貼上，但上面只會顯示『!xxx.png!』，需要去『預覽』才能看到實際的結果

• 提及(memtion)：在撰寫議題概述的時候很長會提到其他同事(ex:這項決議是哪位長官決定、這塊功能會由誰負責…)，可以用 @ 來操作喔

• 被分派者＆分類：調整分類就會自動填入被分派者，能幫助不熟悉用戶職權的人輕鬆的做議題分配

• Checklist：作為議題的輔助，讓你紀錄要完成的細項

• 監看者(watcher)：與任務相關的同事，通常會將直屬長官設為監看者

開發人員

開發人員的涵蓋範圍很廣，包含前端、後端、硬體工程師…UI/UX 設計師等，通常會在收到管理人員分配的議題後開始作業

開發人員收到議題

原則上只要用戶被分配議題、mention提及、設定為監看者，就會收到類似的 email 通知如下：

新增子議題、相關議題

在信箱點擊連結會直接前往該議題，但收到的信件一多還是要依照以下步驟找出自己要負責的項目

STEP 1：專案清單 > 選擇專案 > 議題追蹤

STEP 2：在篩選條件中使用追蹤標籤找到由自己負責的議題

STEP 3：新增子任務

閱讀完議題的需求後再依據自己實際的工作項目去細分子議題，操作方式非常直覺就不再多做介紹

在看板調整工作進度

請注意這裡只能調整議題的『狀態』、『進度』，並不會紀錄工作時間

一個一個議題點進去更新真的很慢，所以我們可以在『看板』用拖拉議題的方式改變他的『狀態』，且能於此『更新進度』的百分比

編輯議題

被分配到議題時要記得編輯啊！不然主管以為你沒做事😞

• 狀態：可調整為『實作中』、『已解決』
• 預估工時＆完成百分比：會有報表產出，所以請認真填寫
• 紀錄時間：為了好看的工作報表就好好填寫吧
• 筆記：因為『概述』完成後就不能修改，我們要用『筆記』做後續議題的討論和紀錄

測試人員

測試人員是系統的守護者，通常會接收到由『開發人員』、『管理人員』分配的測試任務，如果在測試過程中遇到了其他的錯誤可以自行在新增議題做分配

驗證議題功能正確性

STEP 1：先找出清單中自己被指派的任務

STEP 2：依照議題概述去完成相關測試

STEP 3：依據測試結果給予議題回應

• 測試成功：狀態改為『已結束』
• 測試失敗：狀態改為『測試不符合預期』，並增加『筆記』做說明

建立發現錯誤的議題並分派給相關群組

如果是在測試項目外發現錯誤，就是自己建立新議題，並指派議題給負責的群組，如果不清楚該功能由誰負責請使用『分類』來做自動分派。

以下是我整理 Redmine 的相關資源，想更進一步了解的朋友可以參考看看：
👍 Redmine 超詳細安裝教學：Redmine 4.1.1 on Ubuntu 16.04
👍 如何用 Redmine 做專案管理＆體驗心得
👍 Redmine Plugins & Themes 介紹：那些我成功擴充的外掛
👍 用 Redmine 做專案管理 — 管理者不可不知的設定
👍 用 Redmine 做專案管理 — 一般用戶不可不知的基礎功能

🙂 讀完這篇文章後

一、專案清單
二、專案概覽
  ➤ 議題清單
  ➤ 建立新議題
  ➤ 編輯議題
  ➤ 看板

一、專案清單

• 專案分類邏輯：以團隊做區分，子專案才是實際進行的專案

二、專案概覽

這裡介紹實際上專案高頻使用功能

議題清單

建立新議題

• 追蹤標籤＆問題樣板：問題樣板會跟著追蹤標籤顯示；用戶依照樣板填寫的資料填入必須資訊即可

• 提及(memtion)：在撰寫議題概述的時候很長會提到其他同事(ex:這項決議是哪位長官決定、這塊功能會由誰負責…)，可以用 @ 來操作喔

• 被分派者＆分類：調整分類就會自動填入被分派者，能幫助不熟悉用戶職權的人輕鬆的做議題分配

• Checklist：作為議題的輔助，讓你紀錄要完成的細項

• 監看者(watcher)：與任務相關的同事，通常會將直屬長官設為監看者

編輯議題

被分配到議題時要記得編輯啊！不然主管以為你沒做事😞

• 狀態：可調整為『實作中』
• 預估工時＆完成百分比：會有報表產出，所以請認真填寫
• 紀錄時間：為了好看的工作報表就好好填寫吧
• 筆記：因為『概述』完成後就不能修改，我們要用『筆記做後續議題的討論』和紀錄

看板

請注意這裡只能調整議題的『狀態』、『進度』，並不會紀錄工作時間

一個一個議題點進去更新真的很慢，所以我們可以在『看板』用拖拉的方式改變議題的『狀態』，且能於此『更新進度』

原本以為用戶需要知道很多操作，但發現只要會上面的基礎操作後，其他延伸的功能都可以舉一反三。

以下是我整理 Redmine 的相關資源，想更進一步了解的朋友可以參考看看：
👍 Redmine 超詳細安裝教學：Redmine 4.1.1 on Ubuntu 16.04
👍 如何用 Redmine 做專案管理＆體驗心得
👍 Redmine Plugins & Themes 介紹：那些我成功擴充的外掛
👍 用 Redmine 做專案管理 — 管理者不可不知的設定
👍 Redmine 教育訓練 — 依角色權限說明

🙂 讀完這篇文章後

注：本篇文章新增外掛如文章

🌐 網站管理
  ➤ 專案清單
  ➤ 用戶清單
  ➤ 群組清單
  ➤ 角色與權限
  ➤ 追蹤標籤清單
  ➤ 議題狀態清單
  ➤ 流程
  ➤ 設定
  ➤ 全域問題樣板
  ➤ 外掛程式

🌐 網站管理

只有用戶『管理者』權限開啟時才能操作『網站管理』

專案清單

你可以設定某些角色有『建立新專案』的權限，但只有管理者可以做：

• 封存：被封存的專案將不予顯示，通常是專案完成後不希望有人再做更動時使用，若要恢復可以用『取消封存』
• 複製：有很多專案細節的選項可以自己微調做複製
• 刪除：按下去就真的會刪除了，除非是建立錯誤，否則建議用『封存即可』

用戶清單

用來新增/管理用戶，除了設定基礎資訊外，還可管理他們所屬的『群組』、『專案』

• 管理者：有打勾的才能做『網站管理』
• 鎖定：當員工離職時建議使用鎖定，這樣只會讓他無法登入但仍可保留使用者的過往紀錄
• 刪除：除非真的建立錯誤的用戶，不然不建議使用

• 電子郵件提醒選項：建議選擇『只提醒我觀察中或參與中的事物』，這樣收到的資訊最為完整

• 專案清單 & 角色：如果你只創建用戶，但沒有把他加入到專案當中，他是完全沒有功能的。

群組清單

適當的建立群組可以加快『任務派發』、『選擇專案成員』的速度

角色與權限

• 建立新角色：根據公司規模的不同，實際上可能需要更多的角色分割權限
• 權限報表：管理每個角色的權限細節

追蹤標籤清單

你可以把他當成『議題種類』的區分，標籤名稱越明確，日後管理會越精確

議題狀態清單

這個是『議題流程』會經過的『狀態』，每個角色可以使用的議題狀態是不同的，ex：只有『測試人員』才能將議題狀態改為『測試不符合』預期

流程

這塊就是用來設定每個角色在不同追蹤標籤下可以操作流程的狀態；這塊設定起來有點繁瑣，建議流程上卡關再來這裡調整會比較方便

設定

★ 一般

• 歡迎詞：如果你覺得『網站首頁』空白很難看，可以在這裡編輯
• 主機名稱：可以填寫網站的 ip 或者是 Domain name
• 協定：建議使用『HTTPS』
• 文字格式：建議選擇『Markdown』讓工程師方便協作（直接貼上 .md 類型的資訊）

★ 顯示

• 畫面主題：你可以在這裡改變 Redmine 的顯示主題
• 預設語言：你之後創建使用者時都會默認選擇

★ 驗證

• 需要驗證：建議選擇『是』，否則公開的專案會被陌生人看光光
• 註冊選項：建議選擇『停用』，儘管要管理者審核才能正式登入系統，但如果有人瘋狂亂註冊也會造成管理上的困難。

★ 專案清單

• 新建立之專案預設為「公開」：不要打勾，因為個組織間如果有要合作將成員加入專案是比較好的做法
• 新專案預設啟用的模組、新專案預設使用的追蹤標籤：基本上都是全選，要不要用還是看自己

★ 議題追蹤

• 允許關聯至其它專案的議題：因為跨組合作是可預期的，所以會打勾
• 允許議題被分派至群組：有些議題可能會需要需要小組討論、內部分配，所以會打勾

全域問題樣板

讓用戶在『建立議題』時有統一的格式，避免用戶依照自己喜好建立議題導致必要信息缺失造成溝通成本增加。

外掛程式

這裡會顯示安裝成功的 Plugins，『檢查更新』的按鈕參考就好，因為有些外掛不是直接關連到官方的。

官方網站有提供許多的 Plugins，但安裝需要注意 Ruby、Redmine 的版本，如果沒有相容通常會安裝失敗，安裝失敗會導致整個 Redmine 的網站掛掉，所以在擴充外掛前最好向全公司發個通知，並且盡量於工作作業離峰期做擴充。

以下是我整理 Redmine 的相關資源，想更進一步了解的朋友可以參考看看：
👍 Redmine 超詳細安裝教學：Redmine 4.1.1 on Ubuntu 16.04
👍 如何用 Redmine 做專案管理＆體驗心得
👍 Redmine Plugins & Themes 介紹：那些我成功擴充的外掛
👍 用 Redmine 做專案管理 — 一般用戶不可不知的基礎功能
👍 Redmine 教育訓練 — 依角色權限說明

🙂 讀完這篇文章後

一、Redmine Dashboard plugin
二、Redmine Checklists plugin (Light version)
三、Redmine Issues Tree plugin
四、Redmine Issue Templates plugin
五、Redmine Issue View Columns
六、Redmine Lightbox 2
七、Redmine Mentions
八、Redmine A1 theme
九、備註

提供安裝套件時的參數給大家參考：

rvm version：1.29.12

ruby version：2.6.6

Redmine version：4.1.1

這篇文章是介紹套件為主，如果你想知道怎麼安裝可以參考『Redmine 超詳細安裝教學』的 STEP 9

一、Redmine Dashboard plugin

Resource：https://github.com/jgraichen/redmine_dashboard

推薦程度：⭐⭐⭐⭐⭐

這是一款必須安裝的套件！透過 看板的呈現 讓使用者更能全盤掌握專案的進度、利用 Filter 條件篩選出想要的議題、直覺的 拖拉議題 改變狀態

二、Redmine Checklists plugin (Light version)

Resource：https://www.redmineup.com/pages/plugins/checklists

推薦程度：⭐⭐⭐⭐⭐

有時一個議題內容比較複雜的時候，除了新增子議題外，你也可以用 Checklist 的方式來提醒自己有哪些任務需要完成。

另外對於測試人員來說這個 Checklist 的功能是非常有幫助的，可以用來幫助他們紀錄已經測試過的項目及更精準的追蹤測試進度。

備註：套件可設定除非 Checklist 全部打勾 才能關閉議題

三、Redmine Issues Tree plugin

Resource：https://github.com/Loriowar/redmine_issues_tree

推薦程度：⭐⭐⭐⭐

這個套件在一個專案議題數量很多的時候幫助很大，透過樹狀圖的顯示每個議題之間的關係讓使用者找到所需資源

Before：在系統預設的畫面會顯得有點混亂

After：樹狀圖檢視降低閱讀壓力

四、Redmine Issue Templates plugin

Resource：https://github.com/Loriowar/redmine_issues_tree

推薦程度：⭐⭐⭐⭐⭐

專案進行時最害怕開議題時每個人的風格都不一樣，並且對於議題的描述不夠精準忘東忘西；本套件就是為了減少這部分的溝通成本，讓每個參與者都必須依照特定格式來新增議題/筆記。

五、Redmine Issue View Columns

Resource：https://github.com/kenan3008/redmine_issue_view_columns

推薦程度：⭐⭐⭐⭐

這個套件是設定議題下面子議題要呈現哪些欄位的 Plugin

Before：原本呈現的資訊不符合使用者的實際需求，且有些欄位不清楚作用

After：自訂想要呈現的欄位，欄位功能清晰

六、Redmine Lightbox 2

Resource：https://github.com/paginagmbh/redmine_lightbox2

推薦程度：⭐⭐⭐

有時議題會附加一些照片、PDF 做為參考資料，原本預設這些附加檔案都需要下載或是開新分頁才能閱讀，安裝這個外掛後就能透過預覽檢視照片、PDF

七、Redmine Mentions

Resource：https://github.com/arkhitech/redmine_mentions

推薦程度：⭐⭐⭐⭐⭐

我們在撰寫議題描述/筆記時常常需要提到某些人(會議決策者、功能開發人員…)，讓這些人了解目前議題執行的進度，或是紀錄他們說過的話。

加入這個套件之後可以透過 @someone_name 的方式標記對方

如果希望被標記時也會收到信件，要調整帳號設定如下

八、Redmine A1 theme

Resource：https://www.redmineup.com/pages/zh/themes

推薦程度：⭐⭐⭐⭐⭐

如果覺得系統預設的主題(Theme)太醜，可以到這個網站上找自己喜歡的主題

我這次選擇的是 A1主題 ，如果要更換主題需要由管理者做設定喔！

九、備註

今天所操作的這些 plugins 有些是默認全域作用、有些是針對專案作用，如果你發現 Plugin 安裝成功但是沒看到功能時請依照下面的步驟打開 Plugin：

STEP 1：進入專案清單

STEP 2：選擇你要設定的專案

STEP 3：設定專案

STEP 4：滑到下面選擇啟用模組並儲存

以下是我整理 Redmine 的相關資源，想更進一步了解的朋友可以參考看看：
👍 Redmine 超詳細安裝教學：Redmine 4.1.1 on Ubuntu 16.04
👍 如何用 Redmine 做專案管理＆體驗心得
👍 用 Redmine 做專案管理 — 管理者不可不知的設定
👍 用 Redmine 做專案管理 — 一般用戶不可不知的基礎功能
👍 Redmine 教育訓練 — 依角色權限說明

🙂 讀完這篇文章後

一、管理者在專案創建前的準備
  ➤ 角色與權限
  ➤ 議題狀態清單
  ➤ 追蹤標籤清單
  ➤ 設定
二、專案管理的實際應用
  STEP 1：建立新專案
  STEP 2：分配議題(issue)
  STEP 3：組員收到議題的分配通知，根據需求細分子議題
  STEP 4：UIUX 完成設計，PM 分配後續工作給前端工程師
  STEP 5：前端工程師細分子議題，並開 api 需求給後端工程師
  STEP 6：後端工程師回復議題
  STEP 7：PM 規劃測試流程
  STEP 8：SIT 測試新系統功能
  🤔 流程總結
三、個人使用心得

一、管理者在專案創建前的準備

以下操作皆在『網站管理』分頁，僅列出重要功能，其他請自行摸索

角色與權限

系統僅會提供如下角色，但專案管理的流程中通常還會有『測試人員』、『UI/UX 人員』等角色，這裡就按造公司需求新增及分配權限即可

新增角色後會要定義他的工作流程，畢竟每個角色要做的任務不同

以測試人員來說，他們通常是要驗證已解決的議題是否處理完成，所以我會賦予的權限如下圖

議題狀態清單

如果你在剛剛操作角色權限設定時覺得狀態不敷使用可以在這裡增加

像測試人員就可能有『測試不符合預期』之類的狀態，新增後記得套用到對應的角色身上

追蹤標籤清單

這些標籤可以幫助你在尋找、歸納議題時的速度

設定

在『顯示』的地方可以調整語言

在『驗證』頁面參考調整以下選項：

• 需要驗證(是)：如果你沒改又忘記調整專案為不公開會讓一般民眾都可以瀏覽喔！
• 註冊選項(關閉)：如果開放註冊可能會被有心人士狂註冊，多了一堆垃圾帳號造成日後管理困難

二、專案管理的實際應用

以下用實際專案流程模擬操作，模擬公司實際職位如下

• PM(管理人員) — 開 issue 並且分配 issue
• UI/UX(開發人員) — 網頁設計相關任務
• frontend(開發人員) — 依據 UI/UX 設計完成前端
• backend(開發人員) — 配合前端需求給予資料
• SIT(測試人員) — 測試開發人員完成的功能並給予回饋

STEP 1 ：建立新專案

了解客戶需求後，由 PM 建立新專案

職位/角色：PM/管理人員

由 PM 建立一個新的專案並設定裡面的參數

建立專案時請注意：

• 名稱請填寫大家都看得懂的，如果專案有英文縮寫請放在代碼
• 『代碼』這個欄位儲存後無法修改，請謹慎
• 如果專案沒有要公開，請記得把公開的選項拿掉，避免無關人士看到

分配角色權限：建立專案後要加入成員並給予對應的角色權限

完成權限分配後的畫面如下，一個用戶可以有多重角色

建立專案版本：專案一定會有版本的更迭，每項議題如果都有對應的版本在管理及追蹤上可以容易釐清責任

建立議題分類：新人剛加入團隊時可能對成員的職權並不是很了解，如果在這裡建立分類的防可以快速幫助不熟悉團隊的人了解每個人的職權分配

STEP 2：分配議題(issue)

專案基礎配置完成後開始分配每個成員的任務，這裡先從 UI/UX 的設計圖開始

職位/角色：PM/管理人員

在建立議題的時候有幾點提醒一下：

• 概述：圖片可以用複製貼上，但上面只會顯示『!xxx.png!』，需要去『預覽』才能看到實際的結果
• 分類：如果選擇分類就會自動帶出被分派者
• 狀態：他的選項會跟之前賦予的角色權限有關，如果發現需要新的流程可以後續再做調整

STEP 3：組員收到議題的分配通知，根據需求細分子議題

PM 給予議題的大方向任務，組員再依據自己的專業將工作項目細分，這樣更方便追蹤議題的作業進度並評估個人績效

職位/角色：UIUX/開發人員

如果有設定郵件通知的話會收到跟下面類似的信件

閱讀完議題的需求後再依據自己實際的工作項目去細分子議題，操作方式非常直覺就不在多做介紹

議題清單：在這個頁面可以瀏覽所有議題，依據自己的工作完成進度去編輯『任務完成百分比』、『狀態』、『紀錄時間』，方便PM了解實際的工作狀況

STEP 4：UIUX 完成設計，PM 分配後續工作給前端工程師

PM 在議題狀態轉換時也會收到 email 通知，這時他可以做後續的議題分配

職位/角色：PM/管理人員

相關的議題清單：PM 新增議題的方式不再贅述，但這個議題因為需要參考 UI 設計的草圖，所以要在『相關的議題清單』與 UI 設計的議題作關聯

STEP 5：前端工程師細分子議題，並開 api 需求給後端工程師

前端工程師在設計前端頁面的同時也會開 api 的需求給後端工程師，兩者間配合才能完善網頁

職位/角色：前端工程師/開發人員

這塊比較不一樣的是前端工程師應該要更細節具體的描述每個 api 所需要的內容，所以除了『後端 api 需求』這個父議題外，也需要增加細部需求的子議題。

STEP 6：後端工程師回復議題

後端工程師在依據前端工程師的需求完善後用回應的方式說明 api 的格式讓前端工程師完成最後的串接

職位/角色：後端工程師/開發人員

後端 api 不是完成就好，要附上相關說明文件才能節省雙方溝通時間並留存紀錄。

STEP 7：PM 規劃測試流程

在前端工程師與後端工程師串接完成，也確定基礎的操作都穩定後就可以請 SIT 人員做測試了，相關的測試項目及流程一般會由 PM 做後續安排

職位/角色：PM/管理人員

STEP 8：SIT 測試新系統功能

SIT 依照 PM 分配的測試流程進行測試，如果正式成功就能把該議題狀態改為『已解決』

職位/角色：SIT/測試人員

SIT 測試過程中如果發現問題除了把議題狀態改為『測試不符合預期』以及回覆哪裡錯誤外；額外發現的問題也可以新增子任務詳細說明問題，並將子任務都先指派給 PM 讓 PM 再分配給相關人員做處理

🤔 流程總結

基本上就是測試到這個專案版本沒有任何問題後會再開新的專案版本，依據新的功能需求去實作；上面所敘述的流程僅供參考，實際的步驟還是需要公司內部有足夠共識才能真正讓這個專案管理工具發揮作用。

三、個人使用心得

1. 相比之前文章介紹的 Microsoft List、Planner ，這套系統我個人認為是完勝的，各種功能都非常完善，如果想要更多的功能也能透過 plugin 去做擴充，而且還是免費的XD
2. 但如果跟 Jira 相比，他功能就少了一點，比如：缺少 Sprint 的概念、沒辦法於文章中用@來tag相關人員、一個議題只能有一種追蹤標籤。但基本上功能已經夠用了，也許上面的功能都能透過 plugin 處理，這些就要後續再做研究了。
3. 功能擴充自由度相當高，公司如果想要導入這個專案管理系統建議要有工程師與 PM 一起配合研究，因為一些資訊的顯示還有流程要自己手動修改才能符合真實的需求。

想要導入 Redmine 可以參考我之前分享的文章：
👍 Redmine 超詳細安裝教學：Redmine 4.1.1 on Ubuntu 16.04
👍 Redmine Plugins & Themes 介紹：那些我成功擴充的外掛
👍 用 Redmine 做專案管理 — 管理者不可不知的設定
👍 用 Redmine 做專案管理 — 一般用戶不可不知的基礎功能
👍 Redmine 教育訓練 — 依角色權限說明

🙂 讀完這篇文章後

一、安裝環境
二、安裝順序
  STEP 1：安裝 MySQL
  STEP 2：建立 Redmine 使用者帳號
  STEP 3：安裝 RVM
  STEP 4：安裝 Ruby
  STEP 5：安裝 Passenger and Nginx
  STEP 6：設定 Nginx
  STEP 7：在 MySQL 增加 redmine 的使用者
  STEP 8：安裝 Redmine
  STEP 9：安裝 Redmine 外掛
  STEP 10：設定 Redmine 寄信功能
三、備註

一、安裝環境

官方沒有建議的硬體規格，但是看到有 文章分享 最低硬體配置如下：

• Processor: Intel Celeron (min 300 MHz)
• RAM: 1–2 GB RAM
• HDD: 30–40 GB

但通常使用最低硬體配置得到的結果就是容易卡，很多人同時上線使用時會讓卡到讓你懷疑人生，下面是我安裝時的配置目前使用起來算是流暢給大家參考用：

• Processor: 使用 VMWARE 的虛擬單核心
• RAM: 8GB RAM
• HDD: 500 GB
• OS: ubuntu 16.04

二、安裝順序

操作時請注意角色權限(root、redmine)，否則安裝到一半會卡住

STEP 1：安裝 MySQL

角色： root

1. 安裝 MySQL 套件
    ```
    apt install build-essential mysql-server libmysqlclient-dev imagemagick libmagickwand-dev
    ```
2. 安裝後驗證 MySQL Version
    ```
    mysql -u root -p
    ```

原始碼：mysql_install.md（GitHub Gist）

STEP 2：建立 Redmine 使用者帳號

角色： root

1. 建立 Redmine 使用者，資料放在 `/data/redmine`
    ```
    adduser --system \
        --shell /bin/bash \
        --gecos 'Redmine Administrator' \
        --group \
        --home /data/redmine redmine;
    ```
2. 建立 rvm group
    ```
    groupadd rvm
    ```

3. 允許 redmine 可以 sudo
    ```
    adduser redmine sudo
    ```

4. 設定 redmine 密碼
    ```
    passwd redmine
    ```

5. 將 redmine 使用者加入 rvm 群組
    ```
    usermod -a -G rvm redmine
    ```

原始碼：add_redmine_user.md（GitHub Gist）

STEP 3：安裝 RVM

角色： redmine

1. 安裝gnupg2
    ```
    sudo apt install gnupg2
    ```
2. 安裝 GPG keys:
    ```
    gpg2 --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB
    ```
3. 安裝 RVM
    ```
    \curl -sSL https://get.rvm.io | bash -s stable
    ```
4. 讓 rvm 指令生效
    ```
    source /data/redmine/.rvm/scripts/rvm
    ```
5. 確認安裝的RVM版本
    ```
    rvm --version
    ```

原始碼：install_RVM.md（GitHub Gist）

STEP 4：安裝 Ruby

角色： redmine

作者的 RUBY_VERSION 為 2.3.8，這裡安裝的版本請參考 Redmine 的官方建議，如果安裝其他的版本後續安裝 Redmine 時會發生錯誤

1. 檢查 rvm 必要的套件
    ```
    rvm requirements
    ```
2. 安裝指定的 ruby version
    ```
    rvm install ${RUBY_VERSION}
    ```
3. 將此版本設定為預設
    ```
    rvm use ${RUBY_VERSION} --default
    ```
4. 確認安裝的 Ruby 版本
    ```
    ruby --version
    ```

原始碼：intsall_ruby.md（GitHub Gist）

STEP 5：安裝 Passenger and Nginx

角色： root

1. 安裝 Passenger PGP key 和 HTTPS support for package manager
    ```
    apt install -y dirmngr gnupg
    ```
    ```
    apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 561F9B9CAC40B2F7 
    ```
    ```
    apt install -y apt-transport-https ca-certificates
    ```
2. Add passenger APT repository
    ```
    sh -c 'echo deb https://oss-binaries.phusionpassenger.com/apt/passenger xenial main > /etc/apt/sources.list.d/passenger.list'
    ```
    ```
    apt update
    ```
3. 安裝 Passenger and NGINX
    ```
    apt install -y nginx-extras passenger
    ```

原始碼：install_Passenger_Nginx.md（GitHub Gist）

STEP 6：設定 Nginx

角色： root

1. 編輯 Nginx 設定檔案
    ```
    vi /etc/nginx/nginx.conf
    ```
2. 移除此行註解#：`include /etc/nginx/passenger.conf;`
    ```conf
    ...
    ##
    # Phusion Passenger config
    ##
    # Uncomment it if you installed passenger or passenger-enterprise
    ##

    include /etc/nginx/passenger.conf;
    ```
3. 接下來要調整 Nginx 的網站設定，所以建議先備份原本的設定
    ```
    cp /etc/nginx/sites-available/default /etc/nginx/sites-available/default.orig
    ```
5. 編輯 Nginx 的網站設定
    ```
    vi /etc/nginx/sites-available/default
    ```
6. 調整網站的根目錄位置以及 Passenger 設定
    ```
    #root /var/www/html; #將原本的註解或是移除
    root /data/redmine/current/public;
    passenger_enabled on;
    client_max_body_size 10m;
    ```
7. 把 location 段落註解
    ```
    #location / {
            # First attempt to serve request as file, then
            # as directory, then fall back to displaying a 404.
    #       try_files $uri $uri/ =404;
    #}
    ```

原始碼：set_nginx.md（GitHub Gist）

完成上述步驟後再做以下驗證：

1. 更改目錄權限： chown -R www-data /var/www
2. 重啟 Nginx： systemctl restart nginx
3. 驗證 Passenger and NGINX: /usr/bin/passenger-config validate-install

4. 檢查 Ngninx 狀態與 Passenger process: /usr/sbin/passenger-memory-stats

STEP 7：在 MySQL 增加 redmine 的使用者

角色： root

1. 登入 MySQL
    ```
    mysql -u root -p
    ```
3. 創建 redmine 資料庫
    ```
    CREATE DATABASE redmine CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
    ```
4. 創建 redmine 使用者，密碼記得自行調整
    ```
    CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'password';
    ```
5. 給予使用者權限
    ```
    GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';
    ```
6. 使權限生效
    ```
    FLUSH PRIVILEGES;
    ```
7. 離開 MySQL
    ```
    quit;
    ```

原始碼：mysql_add_redmine_user.md（GitHub Gist）

STEP 8：安裝 Redmine

角色： redmine

下載官方 image

1. 到[官方網站](https://www.redmine.org/projects/redmine/wiki/Download)了解最新的stable版本（筆者安裝版本為 4.1.1）
2. 前往放置 redmine image 的目錄
    ```
    cd /data/redmine
    ```
3. 下載官方 image 並解壓縮
    ```
    wget https://www.redmine.org/releases/redmine-4.1.1.tar.gz
    ```
    ```
    tar zxvf redmine-4.1.1.tar.gz
    ```
4. 建立連結資料夾 current
    ```
    ln -s redmine-4.1.1 current
    ```
5. 前往連結資料夾
    ```
    cd current
    ```

原始碼：redmine_download.md（GitHub Gist）

調整 redmine 裡面的資料庫設定

1. 將 redmine 的資料庫範例設定檔複製一份
    ```
    cp -pR config/database.yml.example config/database.yml
    ```
2. 編輯資料庫設定檔案
    ```
    vi config/database.yml
    ```  
3.  調整 production 的資訊即可，內容填上 STEP7 建立的使用者資訊即可
    ```yml
    production:
      adapter: mysql2
      database: redmine
      host: localhost
      username: redmine
      password: "your password"
      # Use "utf8" instead of "utfmb4" for MySQL prior to 5.7.7
      encoding: utf8mb4
    ```

原始碼：redmine_database_config.md（GitHub Gist）

下載相關套件

1. 先確認當前資料夾為 `/data/redmine/current`
    ```
    pwd
    ```
2. 執行 gem, bundle 安裝依賴套件
    ```
    gem install bundler
    ```
    ```
    bundle install --without development test
    ```
    > 如果安裝過程中遇到錯誤可能是因為沒有安裝到 ruby 的套件  
    > 1. 先安裝 `sudo apt-get install ruby-dev`  
    > 2. 再執行一次 `bundle install --without development test` 確認有無報錯

原始碼：redmine_install_package.md（GitHub Gist）

初始化 redmine

1. 先確認當前資料夾為 /data/redmine/current
    ```
    pwd
    ```
2. 用 Rake 啟動 redmine
    ```
    bundle exec rake generate_secret_token
    ```
3. Migrate Database Schema(初始化資料庫)
    ```
    RAILS_ENV=production bundle exec rake db:migrate
    ```
4. Load Initial Data(下面會請你選擇語言，預設為英文，語言後續都能再做調整)
    ```
    RAILS_ENV=production bundle exec rake redmine:load_default_data
    ```
5. 用 Nginx 重啟 Redmine
    ```
    sudo systemctl restart nginx
    ```

原始碼：redmine_init.md（GitHub Gist）

接下來你可以瀏覽 http:<server_ip> ，如果順利的話可以看到 Redmine 登入畫面如下：

STEP 9：安裝 Redmine 外掛

角色： redmine

Plugin 安裝方式雷同，下面以 Redmine Dashboard 2為範例安裝

1. 先進入 redmine 的 plugin 資料夾
    ```
    cd /current/plugins
    ```
2. 下載 plugin，最新的 release 請參考[官方](https://github.com/jgraichen/redmine_dashboard)
    ```
    wget https://github.com/jgraichen/redmine_dashboard/archive/v2.9.0.tar.gz
    ```
3. 解壓縮檔案
    ```
    tar zxvf v2.9.0.tar.gz
    ```
4. 移除壓縮檔
    ```
    rm v2.9.0.tar.gz
    ```
6.  安裝相關套件
    ```
    bundle install
    ```
7. 將套件相關 DB 進行 migrate 到 production
    ```
    rake db:migrate RAILS_ENV=production
    ```
8. 將套件安裝至 production
    ```
    bundle exec rake redmine:plugins:migrate RAILS_ENV=production
    ```
9. 安裝完畢後重啟讓設定生效
    ```
    sudo systemctl restart nginx
    ```

原始碼：redmine_plugin.md（GitHub Gist）

STEP 10：設定 Redmine 寄信功能

角色： redmine

如果沒做這個步驟是寄不出信的，需要做下面的調整即可

1. 進入 redmine 設定的資料夾
    ```
    cd /current/config
    ```
2. 將 redmine 的設定範例設定檔複製一份
    ```
    cp -pR configuration.yml.example configuration.yml
    ```
3. 編輯 redmine 設定檔案
    ```
    vi configuration.yml
    ```
4. 調整 production 的資訊即可，下面用 Gmail 作為範例
    ```
    production:
      delivery_method: :smtp
      smtp_settings:
        enable_starttls_auto: true
        address: "smtp.gmail.com"
        port: 587
        domain: "smtp.gmail.com" # 'your.domain.com' for GoogleApps
        authentication: :plain
        user_name: "email"
        password: "email pw"
     ```
5. 設定完畢後重啟生效
    ```
    sudo systemctl restart nginx
    ```

原始碼：redmine_email.md（GitHub Gist）

三、備註

1. 如果進入網頁時畫面沒有顯示應該是因為防火牆問題，可以用下面指令嘗試：sudo ufw allow http 、sudo ufw allow https
2. 參考資源：Redmine 安裝篇：Redmine 4.0.x on Ubuntu 16.04、Redmine Plugins and Themes、HowTo Install Redmine on Ubuntu step by step

安裝完後如果想進一步了解如何使用 Redmine，可以參考以下文章：
👍 如何用 Redmine 做專案管理＆體驗心得
👍 Redmine Plugins & Themes 介紹：那些我成功擴充的外掛
👍 用 Redmine 做專案管理 — 管理者不可不知的設定
👍 用 Redmine 做專案管理 — 一般用戶不可不知的基礎功能
👍 Redmine 教育訓練 — 依角色權限說明

🙂 讀完這篇文章後