Project

General

Profile

PluginBudget » History » Version 1

Eric Davis, 2008-09-10 19:31
Adding first draft of the plugin docs based on it's README

1 1 Eric Davis
h1. Budget Plugin
2
3
Budget is a plugin to manage the set of deliverables for each project, automatically calculating key performance indicators.
4
5
h2. Features
6
7
* Add new deliverable to a project - Fixed bid or Time Based
8
** New issues appended using JavaScript to the top of the deliverables list
9
** Clearing the New Deliverable form after a successful save using JavaScript
10
* Listing of deliverables on a project
11
** Column sorting by: ID, Score, Subject, Budget, Spent, Due date, Progress
12
* JavaScript drop down panel for each deliverable displaying
13
** Deliverable details
14
** Link to edit the deliverable
15
** Link to see the issues assigned to the deliverable, using a issue filter
16
** Mass assignment of all issues on a specific version to a deliverable
17
** Button to Delete the deliverable
18
* Edit a deliverable on a project
19
* Automatic calculations for deliverables based on the existing Redmine issue and timelog data
20
* Calculations for the whole project, based on the deliverables
21
* Flexible role based permissions using Redmine's permissions and roles system
22
** (none) - Can assign issues to a deliverable and filter on them. 
23
** View - Can see the Budget tab and specific deliverable data: name, dates, progress, total budget 
24
** Manage - Can do everything 
25
* Company defaults for:
26
** Non billable overhead - in dollars or as a %
27
** Materials - in dollars or as a %
28
** Deliverable profit - in dollars or as a %
29
* Ability to add the Deliverable column to the Main Issues list, including sorting and filtering by Deliverable name
30
* Adding the billable rate to project members on a per project basis
31
32
h2. Install
33
34
# Before installing, make sure you are running Redmine after r1796.
35
# Follow the Redmine plugin installation steps at: http://www.redmine.org/wiki/redmine/Plugins
36
# Login to your Redmine install as an Administrator
37
# Enable the permissions for your Roles
38
# Setup your companies defaults in the Plugins' configuration panel
39
# Add the "Budget module" to the enabled modules for the projects you want to manage
40
# The link to the plugin should appear on that project's navigation
41
42
h2. Usage
43
44
h3.  Adding deliverables
45
46
# Use the "New Deliverable" link on sidebar of the Budget page to add a new deliverable
47
# The deliverable can be a Fixed Bid or an Hourly deliverable.  The type can be changed later.
48
# Saving the deliverable will add it to the Deliverable list.
49
50
h3.  Viewing deliverables
51
52
# Clicking the pencil icon will drop down the deliverable details, with summary and calculations about the deliverable.
53
# Links on the left can be used to edit or delete a deliverable and well as view the issue list for the deliverable.
54
55
h3.  Assignment of an issue to a deliverable
56
57
Edit an issue and select the deliverable from the dropdown
58
59
h3.  Bulk assignment of issues to a deliverable
60
61
# Select multiple issues on the issue list
62
# Right click and select the edit option
63
# Select the deliverable from the dropdown and save
64
65
h3.  Bulk Assignment of issues by Version
66
67
Issues can be bulk assigned to a deliverable based on a Version.
68
69
# Expand the Deliverable to view it
70
# Select the Version in the drop down box
71
# Click the Bulk Assign button
72
# All issues for that version will now be assigned to that Deliverable
73
74
h2. License
75
76
This plugin is licensed under the GNU GPL v2.  See LICENSE.txt and GPL.txt for details.
77
78
h2. Project help
79
80
If you need help you can contact the maintainer at his email address (See CREDITS.txt) or create an issue in the Bug Tracker.
81
82
h3.  Bug tracker
83
84
If you would like to report a bug or request a new feature the bug tracker is located at https://projects.littlestreamsoftware.com/projects/show/redmine-budget