Project

General

Profile

How to use ctt » History » Version 5

Sanghee Kim, 02/01/2020 10:56 PM

1 1 Jin-Guk Kwon
h1. How to use ctt
2
3
h2. General Ticket handling
4
5
* Tickets which are not in progress for the moment needs to be set as unassigned & seen
6
* New Tickets, should be unassigned & new
7
** these tickets need to be watched and changed in 1 day
8
9
h2. Introduction
10
11
* Installation of "ctt":https://code.ungleich.ch/ungleich-public/ctt.git (or compatible) (*[[for windows user]])
12
** clone the repository to a location you whish
13
<pre>
14
git clone https://code.ungleich.ch/ungleich-public/ctt.git ~/Work/bin/ctt
15
</pre>
16
** Edit your PATH environment variable
17
*** e.g. open your ~/.bashrc and append
18
<pre>
19
export PATH=$PATH:~/Work/bin/ctt/bin
20
</pre>
21
*** source your ~/.bashrc
22
<pre>
23
source ~/.bashrc
24
</pre>
25
** if you run "ctt" now you should see the usage of it
26
* *Send Dominique your ssh key, otherwise the next steps won't work*
27
* Clone the dot-ctt repository from git@code.ungleich.ch:ungleich/dot-ctt.git
28
<pre>
29
git clone git@code.ungleich.ch:ungleich/dot-ctt.git ~/.ctt
30
</pre>
31
* Track your time to "$customer-$yourname" (ctt track $customer-$yourname <ENTER>) for instance
32
** ungleich-$YOURNAME
33
** customer1-$YOURNAME
34
** customer2-$YOURNAME
35
* When you finished working, press <ENTER> once again then give a comment what you worked on (See details below)
36
* All times need to be pushed every friday
37
<pre>
38
cd ~/.ctt
39
git pull
40
git add ./*
41
git commit -m "added times"
42
git push
43
</pre>
44
* If working for a customer of a customer, include the customer/project name:
45
** IDENTIFIER; normal text
46
* When working on a *fixed budget* project for a customer, book the hours to ungleich
47 5 Sanghee Kim
* Time tracking *should not exceed 180* minutes for one session of work
48
** Write a good and concise description of the work done per entry.
49
** Show your transparent progress of your task in the description.
50
** If working on the same task for a long period of time, break it down in session description: avoid giving the same, repeated description for many entries happened over extensive hours. 
51 1 Jin-Guk Kwon
52
h3. Deleting tracked time entry
53
54
<pre>
55
rm -r ~/.ctt/$customer-$yourname/YYYY-MM-DD-HHmm
56
</pre>
57
58
Where YYYY-MM-DD-HHmm is the start time of your tracked entry.
59
60
e.g.
61
62
<pre>
63
rm -r ~/.ctt/ungleich-intern-user/2015-08-26-2030
64
</pre>
65
66
67
h3. Change the comment
68
69
The comment is stored in the following file:
70
71
<pre>
72
~/.ctt/$customer-$yourname/YYYY-MM-DD-HHmm/comment
73
</pre>
74
75
Just open this file with a text editor (e.g. vim, nano, Notepad++ etc. (NOT WORD)) and change it's content
76
77
h2. Times & Dates
78
79
* Enter times until friday every week (everybody)
80
* Verify time entries until sunday evening (Nico)
81
* Transfer times to customer systems until monday midday (David)
82
83
h2. Some time-entry examples
84
85 3 Jin-Guk Kwon
* You work for a Ticket of Customer
86 1 Jin-Guk Kwon
87
<pre>
88 4 Jin-Guk Kwon
ctt track customer-$YOURNAME
89 1 Jin-Guk Kwon
Comment = Customer; #TICKETNUMBER; Comment
90
</pre>
91
92
* You work internal hours
93
94
<pre>
95
ctt track ungleich-$YOURNAME
96
comment = Ungleich; (#TICKETNUMBER); Comment
97
</pre>
98
99 2 Jin-Guk Kwon
* You work on fix price Project of Customer
100 1 Jin-Guk Kwon
101
<pre>
102 2 Jin-Guk Kwon
ctt track ungleich-customer-$YOURNAME
103
comment = Customer; (#TICKETNUMBER); Comment
104 1 Jin-Guk Kwon
</pre>
105
106
* You worked on a project but forgot to track:
107
108
<pre>
109
ctt track ungleich-intern-$YOURNAME --sd YYYY-MM-DD-HHMM --ed YYYY-MM-DD-HHMM
110
comment = COMMENT
111
</pre>
112
You can leave the --ed part if you still working on it now
113
114
h2 Reporting your time
115
116
<pre>
117
cd .ctt
118
ctt report *${YOURNAME}
119
</pre>