= Welcome to FaSt = == Content == [WikiStart#Abstract Abstract][[BR]] [WikiStart#Background Background][[BR]] [WikiStart#Featurelist Featurelist][[BR]] [WikiStart#Demo Demo][[BR]] [WikiStart#Download Download][[BR]] [WikiStart#Installation Installation][[BR]] [WikiStart#Contribute Contribute][[BR]] ---- == Abstract == '''FaSt''' is an enhanced tracker template for the [http://roundup.sourceforge.net/ roundup] issue tracker. It was created with the goal to improve the support of typical tasks in commercial Free Software services at [http://www.intevation.org Intevation]. '''FaSt''' is an acronym for the German word '''Fa'''llannahme'''St'''elle. ---- == Background == '''FaSt''' tries to address several typical problems which occur not only in commercial Free Software service but are much more relevant there. In the following I will give a short introduction into a few typical problems which '''FaSt''' tries to solve. Below you will find an overview about the setup at Intevation: [[Image(http://www.irlaender.de/projects/fast/internal_public_tracker.png, 450,align=center)]][[BR]] ''(Picture: Overview of the setup at Intevation)'' '''1. Problem: References to other issues'''[[BR]] Because of privacy there are two trackers. On the left side an internal Tracker which documents customer related issues and is not accessible by the public. And on the right side a public tracker which documents the underlying technical problems of the customers issues. This means that there is some kind of connection between the issues in the internal and issues the public tracker. How to manage this connection in a good way? '''2. Problem: Multiuser vs. Privacy'''[[BR]] As you can see the internal Tracker holds issues for multiple customers. Additional there are three groups of people accessing the internal tracker: * Customers * Internals (Employees at Intevation) * Partners (Developers who work together with Intevation on the development of the software) This raises the question of privacy. We need to guarantee that a users can only see issues they are permitted to. Further the groups should have different views on the issues, including visibility of changenotes and single attributes of the issue. This will need a pretty complex permission system. '''3. Problem: Timetracking'''[[BR]] Timetracking is the most general problem, and almost always exists. You need to know how much time you spent on your issues, and you want to charge this time on your customers. ---- == Featurelist == '''FaSt''' comes with a bunch of features which addresses the problems mentioned above. === Timelogs and Workpackages === Keep track on the time spent on issues and organise them in logical bundles called ''workpackages''. Timelogs in combination with workpackages build the basis for detailed bills for your customer. Read more about the [wiki:workpackages workpackages] Read more about the [wiki:timelogs timelogs] === Remote events === Remote events are your connection to information sources like other bug trackers. Create a remote event and attach it to an issue to track changes on issues on the remote site. Read more about [wiki:remoteevents remote events] === Usergroups === '''FaSt''' introduces a very simple approach of usergroups in roundup which helps to organise the pretty complex permission needs. Read more about the [wiki:permissions#usergroup usergroups] === Views === User have different views on issues including visibility of changenotes down to single attributes. Read more about the [wiki:permissions#views views] === Other enhancements === Beside the major features mentioned above '''FaSt''' comes with some smaller changes. More info soon. ---- == Demo == '''Note:''' This demo is hosted on a server with a very limited upstream. So so not wonder if your connections somewhat slow. There is a tracker available at [http://fastdemo.irlaender.de:8080/fast/ http://fastdemo.irlaender.de:8080/fast/][[BR]].[[BR]] Please feel free to play around with the tracker. I have setup four users for you to test basic functionallity of '''FaSt''': 1. An internal user : login with: internal/internal 2. A partner user : login with: partner/partner 3. A customer user : login with: customer/customer 4. A manager user : login with: manager/manager ---- == Download == Currently there is a testing version available for download. This version is almost feature complete and gives a good impression of what '''FaSt''' will be. But it needs a lot of code-cleanup. '''Source'''[[BR]] Download (92kb) [[http://www.irlaender.de/projects/fast/fast-0.9beta.tar.gz fast-0.9beta.tar.gz]] ''md5sum: 785a8d24d6c730dea98090561476df78'' '''Debian'''[[BR]] There will be a .deb available soon. '''Mercurial'''[[BR]] There will be anonymous access on the repository soon. The development version is [http://trac.irlaender.de/fast/browser/ browsable] ---- == Installation == '''Prerequisite:''' You need to have [http://www.crummy.com/software/BeautifulSoup/ Beautiful Soup] available.[[BR]] Installation of the tracker template is easy. You need to follow the following thress steps: '''1. Download'''[[BR]] Download the tracker template and extract it to the directory holding your tracker templates. On a Debian system this is /usr/share/roundup/templates. Probably the most easy way is using mercurial get get a recent version directly from the repository: {{{ # First move to the directory where your tracker templates are located # and create a new directory for the fast tracker template werkbank:~# cd /usr/share/roundup/templates werkbank:/usr/share/roundup/templates# mkdir fast werkbank:/usr/share/roundup/templates# cd fast # Now you can pull fast from the mercurial repositoy werkbank:/usr/share/roundup/templates/fast# hg init werkbank:/usr/share/roundup/templates/fast# hg pull http://hg.irlaender.de/fast pulling from http://hg.irlaender.de/fast http authorization required realm: Mercurial Repository user: anonymous password: requesting all changes adding changesets adding manifests adding file changes added 183 changesets with 544 changes to 103 files (run 'hg update' to get a working copy) werkbank:/usr/share/roundup/templates/fast# hg update 82 files updated, 0 files merged, 0 files removed, 0 files unresolved }}} '''2. Patching roundup'''[[BR]] Because of the some features added to this tracker template you need to patch your roundup. There are three small patches:[[BR]] 1. For adding usergroups 2. For preventing nosymessages to users who are not allowed to see the message because of the [wiki:permission#views view] 3. Small patch enforcing that timelog alway comes with a message 4. (Not needed: privacy patch for nosymessages which removed refernces on the changenote and just added a link to the issue) {{{ # Move to the patches directory of the fast template werkbank:~# cd /usr/share/roundup/templates/fast/patches werkbank:/usr/share/roundup/templates/fast/patches# ls roundupdb.py_nosy.patch roundupdb.py_privacy.patch timelog_actions.py.patch usergroup.patch # Now apply the patches werkbank:/usr/share/roundup/templates/fast/patches# patch /usr/lib/python2.4/site-packages/roundup/roundupdb.py < roundupdb.py_nosy.patch patching file /usr/lib/python2.4/site-packages/roundup/roundupdb.py werkbank:/usr/share/roundup/templates/fast/patches# patch /usr/lib/python2.4/site-packages/roundup/security.py < security.py_usergroup.patch patching file /usr/lib/python2.4/site-packages/roundup/security.py werkbank:/usr/share/roundup/templates/fast/patches# patch /usr/lib/python2.4/site-packages/roundup/cgi/templating.py < templating.py_usergroup.patch patching file /usr/lib/python2.4/site-packages/roundup/cgi/templating.py werkbank:/usr/share/roundup/templates/fast/patches# patch /usr/lib/python2.4/site-packages/roundup/cgi/actions.py < actions.py_timelogs.patch patching file /usr/lib/python2.4/site-packages/roundup/cgi/actions.py }}} ''' 3. Creating a new tracker using Fast'''[[BR]] There is no difference to the procedure you are used to. Please consult [http://roundup.sourceforge.net/doc-1.0/installation.html#installation roundup documentation] for further instructions on installing the tracker. ---- == Contribute == Contribution is very welcome! Please send comments, critics, suggestions to torsten.irlaender (at) intevation.de. If you find defects in this template please file an issue in the tracker. If you want to contribute some code please ask for full access to the mercurial repository holding the sources of '''FaSt'''