檢視 Trac/Manual 的原始碼

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

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

=== 常見追蹤項目 ===

最常見的幾種開票項目：

; Bug
: 軟體的bug，或是網站功能的bug。
; Feature
: 通常是開發新功能。
; Enhancement
: 通常是改善既有功能。

=== 其他項目 ===

另外有些事情也會開票：

; 檢查項目
: 通常是用在有自動開票機時。這通常是發生在稽核要求，或是定期檢查項目（像是UPS電池電力確認）。
; 把事情拆細
: 母票事情太大張不知道從合作起時，通常我們會把事情拆細，然後每件小事情都開成子票。

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

; 票的Owner就是負責人
: 被指派到就是負責人，沒有理由卸責。如果這張票不是屬於自己業務範圍就應該要轉回去（轉回給上一個人，或是轉回給開票人）。
; 開票的人（Reporter）負責關票
: 開票的人通常是最清楚知道開這張Ticket需要處理的項目，由他來關票可以確保問題有被解決。

== 常用功能 ==
=== My Tickets ===
[[Image:Trac-Report-My-Tickets.png|thumb|right|400px|My Tickets]]

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

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

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

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

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

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

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

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

== 開票操作 ==
[[Image:Trac-New-Ticket.png|thumb|right|400px|New Ticket]]

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

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

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

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

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

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

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

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

== 子母票與專案管理 ==
[[Image:Trac-Subtickets.png|right|thumb|400px|有子票的票]]
子母票可以建立票的相依性，讓使用者可以有階層式的概念把大票拆細。對一個專案來說，這個作法可以讓專案管理者有全局性的概念，了解目前執行的情況。

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

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

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

== 相關連結 ==
* [[Trac]]