Project

General

Profile

How to use ctt » History » Version 4

Jin-Guk Kwon, 01/10/2019 10:17 AM

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
* Time tracking should not exceed 180 minutes for one session of work
48
49
h3. Deleting tracked time entry
50
51
<pre>
52
rm -r ~/.ctt/$customer-$yourname/YYYY-MM-DD-HHmm
53
</pre>
54
55
Where YYYY-MM-DD-HHmm is the start time of your tracked entry.
56
57
e.g.
58
59
<pre>
60
rm -r ~/.ctt/ungleich-intern-user/2015-08-26-2030
61
</pre>
62
63
64
h3. Change the comment
65
66
The comment is stored in the following file:
67
68
<pre>
69
~/.ctt/$customer-$yourname/YYYY-MM-DD-HHmm/comment
70
</pre>
71
72
Just open this file with a text editor (e.g. vim, nano, Notepad++ etc. (NOT WORD)) and change it's content
73
74
h2. Times & Dates
75
76
* Enter times until friday every week (everybody)
77
* Verify time entries until sunday evening (Nico)
78
* Transfer times to customer systems until monday midday (David)
79
80
h2. Some time-entry examples
81
82 3 Jin-Guk Kwon
* You work for a Ticket of Customer
83 1 Jin-Guk Kwon
84
<pre>
85 4 Jin-Guk Kwon
ctt track customer-$YOURNAME
86 1 Jin-Guk Kwon
Comment = Customer; #TICKETNUMBER; Comment
87
</pre>
88
89
* You work internal hours
90
91
<pre>
92
ctt track ungleich-$YOURNAME
93
comment = Ungleich; (#TICKETNUMBER); Comment
94
</pre>
95
96 2 Jin-Guk Kwon
* You work on fix price Project of Customer
97 1 Jin-Guk Kwon
98
<pre>
99 2 Jin-Guk Kwon
ctt track ungleich-customer-$YOURNAME
100
comment = Customer; (#TICKETNUMBER); Comment
101 1 Jin-Guk Kwon
</pre>
102
103
* You worked on a project but forgot to track:
104
105
<pre>
106
ctt track ungleich-intern-$YOURNAME --sd YYYY-MM-DD-HHMM --ed YYYY-MM-DD-HHMM
107
comment = COMMENT
108
</pre>
109
You can leave the --ed part if you still working on it now
110
111
h2 Reporting your time
112
113
<pre>
114
cd .ctt
115
ctt report *${YOURNAME}
116
</pre>