Trac/Manual

Trac/Manual這頁是Trac的使用手冊，裡面包含了Trac自己的設計，以及後來使用所累積的經驗建議。

簡介

Trac是一套Issue Tracking System（問題追蹤系統），任何的「問題」都會在系統內開一張Ticket（票），藉由軟體系統幫助使用者（通常是員工）追蹤問題。

常見追蹤項目

最常見的幾種開票項目：

Bug

軟體的bug，或是網站功能的bug。

Feature

通常是開發新功能。

Enhancement

通常是改善既有功能。

其他項目

另外有些事情也會開票：

檢查項目

通常是用在有自動開票機時。這通常是發生在稽核要求，或是定期檢查項目（像是UPS電池電力確認）。

把事情拆細

母票事情太大張不知道從合作起時，通常我們會把事情拆細，然後每件小事情都開成子票。

基本概念

用Trac有一些基本概念要注意：

票的Owner就是負責人

被指派到就是負責人，沒有理由卸責。如果這張票不是屬於自己業務範圍就應該要轉回去（轉回給上一個人，或是轉回給開票人）。

開票的人（Reporter）負責關票

開票的人通常是最清楚知道開這張Ticket需要處理的項目，由他來關票可以確保問題有被解決。

常用功能

My Tickets

My Tickets

最常用的功能應該是看掛在自己身上的票（通常是在內建的Report 7，或是看各組織另外設定的Report），並且依照到期時間（Due Date）排序。

我通常會依據不同的狀態表示進度：

• 把要做的事情搬到Accepted（內建）或是Started（需要系統底層另外設定）。
• 其他的事情放在Assigned或是Others。

這個模式可以讓其他人知道你目前正在處理那些票。

在Report表格最上方的Ticket、Summary、Component、Priority、Due都是可以按的（表示希望依照這些欄位排序），當然，用Ctrl-F（或是Cmd-F）還是可以針對這些表格內容搜尋。

另外我會在系統底層會設定一些跟到期日有關的樣式：

• 有框線的是今天到期的票。
• 粗體為超過到期日的票。

這些可以幫助使用者快速了解目前的狀況。

開票操作

New Ticket

通常遇到任何狀況（甚至是已經解決了），我們都會開一張票記錄追蹤，讓事情留下記錄。

Trac的開票在系統上只有限制Summary一定要填寫，其他的沒有強制規定。一般來說，在組織裡面會另外要求以下的行為：

• 一定要指定給一個人，這樣才能後續追蹤。

也有可能會有其他的要求：

• 設定可能的Due Date（通常開票時不一定知道精準的Due Date，可以再改）。
• 設定合理的Component（因為每個Component會自動Cc給對應的負責人，或是負責的一群人）。

要注意的是，不需要擔心重複開票，如果真的發生了只需要在票上記錄跟哪張重複，再關掉其中一張就好了（通常留下資訊比較完整的的那張，或是比較先開的那張）。

關票操作

當這張票不需要再被追蹤時我們會把票關掉，而關票需要注意以下事情：

• 讓「開票」的人關票。如果你不是開票人，把票轉回（reassign）給開票人讓他關。
  • 這樣的好處是讓開票人可以確認內容是否正確（而通常開票的需求人對需求的了解是最完整的）。
• 關票可以選擇關閉的狀態，常用的有：
  • fixed：票上的事情做完搞定。
  • wontfix：票上的事情合理，但不打算做。
  • invalid：票上的事情不合理，所以不打算做。
  • duplicate：票上的事情跟其他票重複了，通常我們會在留言的地方描述跟哪張重複。
• 雖然Trac內建有worksforme可以選，但這個選項常常會拿掉（因為其實是很攻擊性的選項，會給人有種「我懶得管你」的感覺）。

子母票與專案管理

有子票的票

子母票可以建立票的相依性，讓使用者可以有階層式的概念把大票拆細。對一個專案來說，這個作法可以讓專案管理者有全局性的概念，了解目前執行的情況。

使用子母票時需要注意這些事情：

• 一張母票可以開很多子票（這個比較好理解），一張子票也可以開很多母票。
  • 把票號用逗號隔開就可以了（像是1,2,3這樣）。
  • 同一張票可以掛到很多母票上這點可以善用在很多地方，像是一張實做的票可以掛在「部門2018年執行項目」的母票，以及「XX專案」下，對於不同單位來說有不同追蹤的方法。
• 子票還可以再開子票（孫票？），不受限只有一層。
  • 這樣彈性會比較大，舉例來說，一個大型專案的設計相關部份可以掛到某個部門主管身上，再由那個單位拆給部門內的各個設計師實做，這樣追蹤也比較清楚。
• 系統會阻擋loop行為。
  • 像是自己掛自己為母票，或是把母票掛到子票上。
• 系統會阻擋關票行為。
  • 當子票沒關時，母票是不能關的。

最後可以說，子母票的用法不受限於上面所說的項目，Trac只是一個工具，如果有其他用法可以幫助到你自己就可以用用看（當然，前提是不會造成別人爆炸）。

相關連結

• Trac