檢視 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給對應的負責人，或是負責的一群人）。

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

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