/* This file is part of the KDE project Copyright (C) 2001 Thomas Zander zander@kde.org Copyright (C) 2004 - 2006 Dag Andersen This library is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public License for more details. You should have received a copy of the GNU Library General Public License along with this library; see the file COPYING.LIB. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, * Boston, MA 02110-1301, USA. */ #ifndef KPTPROJECT_H #define KPTPROJECT_H #include "kptnode.h" #include "kptaccount.h" #include "kptcalendar.h" #include "kptdatetime.h" #include "kptduration.h" #include "kptresource.h" #include #include #include #include #include namespace KPlato { class Part; class Schedule; class StandardWorktime; //#define DEBUGPERT /** * Project is the main node in a project, it contains child nodes and * possibly sub-projects. A sub-project is just another instantion of this * node however. */ class Project : public Node { public: Project(Node *parent = 0); ~Project(); /// Returns the node type. Can be Type_Project or Type_Subproject. virtual int type() const; /** * Calculate the whole project. * * @param schedule Schedule to use */ void calculate(Schedule *scedule); /** * Calculate the whole project. * * @param use Calculate using expected-, optimistic- or pessimistic estimate. */ void calculate(Effort::Use use); /// Calculate current schedule void calculate(); virtual bool calcCriticalPath(bool fromEnd); virtual DateTime startTime() const; virtual DateTime endTime() const; /// Returns the duration calculated as latestFinish - earliestStart. Duration *getExpectedDuration(); /** * Instead of using the expected duration, generate a random value using * the Distribution of each Task. This can be used for Monte-Carlo * estimation of Project duration. */ Duration *getRandomDuration(); virtual bool load(TQDomElement &element); virtual void save(TQDomElement &element) const; TQPtrList &resourceGroups(); virtual void addResourceGroup(ResourceGroup *resource); virtual void insertResourceGroup(unsigned int index, ResourceGroup *resource); void removeResourceGroup(ResourceGroup *resource); void removeResourceGroup(int number); ResourceGroup *takeResourceGroup(ResourceGroup *resource) { return m_resourceGroups.take(m_resourceGroups.findRef(resource)); } bool addTask( Node* task, Node* position ); bool addSubTask( Node* task, Node* position ); bool addSubTask( Node* task, int index, Node* parent ); void delTask(Node *node); bool canIndentTask(Node* node); bool indentTask( Node* node ); bool canUnindentTask( Node* node ); bool unindentTask( Node* node ); bool canMoveTaskUp( Node* node ); bool moveTaskUp( Node* node ); bool canMoveTaskDown( Node* node ); bool moveTaskDown( Node* node ); Task *createTask(Node* parent); Task *createTask(Task &def, Node* parent); /// Returns the resourcegroup with identity id. ResourceGroup *group(TQString id); /// Returns the resource with identity id. Resource *resource(TQString id); virtual EffortCostMap plannedEffortCostPrDay(const TQDate &start, const TQDate &end) const; /// Returns the total planned effort for this project (or subproject) virtual Duration plannedEffort(); /// Returns the total planned effort for this project (or subproject) on date virtual Duration plannedEffort(const TQDate &date); /// Returns the planned effort up to and including date virtual Duration plannedEffortTo(const TQDate &date); /// Returns the actual effort virtual Duration actualEffort(); /// Returns the actual effort on date virtual Duration actualEffort(const TQDate &date); /// Returns the actual effort up to and including date virtual Duration actualEffortTo(const TQDate &date); /** * Returns the total planned cost for this project */ virtual double plannedCost(); /// Planned cost on date virtual double plannedCost(const TQDate &date); /// Planned cost up to and including date virtual double plannedCostTo(const TQDate &date); /** * Returns the actually reported cost for this project */ virtual double actualCost(); /// Actual cost on date virtual double actualCost(const TQDate &date); /// Actual cost up to and including date virtual double actualCostTo(const TQDate &date); Calendar *defaultCalendar() { return m_standardWorktime->calendar(); } TQPtrList calendars(); void addCalendar(Calendar *calendar); /// Returns the calendar with identity id. Calendar *calendar(const TQString id) const; /** * Defines the length of days, weeks, months and years * and the standard working week. * Used for estimation and calculation of effort, * and presentation in gantt chart. */ StandardWorktime *standardWorktime() { return m_standardWorktime; } void setStandardWorktime(StandardWorktime * worktime); /// Check if node par can be linked to node child. bool legalToLink(Node *par, Node *child); virtual const TQDict &nodeDict() { return nodeIdDict; } /// Find the node with identity id virtual Node *findNode(const TQString &id) const { return (m_parent ? m_parent->findNode(id) : nodeIdDict.find(id)); } /// Remove the node with identity id from the register virtual bool removeId(const TQString &id); /// Insert the node with identity id virtual void insertId(const TQString &id, const Node *node); /// Register node. The nodes id must be unique and non-empty. bool registerNodeId(Node *node); /// Create a unique id. TQString uniqueNodeId(int seed=1); ResourceGroup *findResourceGroup(const TQString &id) const { return resourceGroupIdDict.find(id); } /// Remove the resourcegroup with identity id from the register bool removeResourceGroupId(const TQString &id) { return resourceGroupIdDict.remove(id); } /// Insert the resourcegroup with identity id void insertResourceGroupId(const TQString &id, const ResourceGroup* group) { resourceGroupIdDict.insert(id, group); } Resource *findResource(const TQString &id) const { return resourceIdDict.find(id); } /// Remove the resource with identity id from the register bool removeResourceId(const TQString &id) { return resourceIdDict.remove(id); } /// Insert the resource with identity id void insertResourceId(const TQString &id, const Resource *resource) { resourceIdDict.insert(id, resource); } /// Find the calendar with identity id virtual Calendar *findCalendar(const TQString &id) const { return id.isEmpty() ? 0 : calendarIdDict.find(id); } /// Remove the calendar with identity id from the register virtual bool removeCalendarId(const TQString &id); /// Insert the calendar with identity id virtual void insertCalendarId(const TQString &id, const Calendar *calendar); /** * Setting a project to be baselined means the project data can not be edited anymore. * @param on the new baseline value */ void setBaselined(bool on) { m_baselined = on; } /** * @return if the project is baselined; a baselined project becomes uneditable. */ bool isBaselined() const { return m_baselined; } void generateWBS(int count, WBSDefinition &def, TQString wbs=TQString()); Accounts &accounts() { return m_accounts; } /// Set current schedule to schedule with identity id, for me and my children virtual void setCurrentSchedule(long id); /// Create new schedule with unique id. MainSchedule *createSchedule(TQString name, Schedule::Type type); /// Set parent schedule for my children virtual void setParentSchedule(Schedule *sch); protected: Accounts m_accounts; TQPtrList m_resourceGroups; TQPtrList m_calendars; StandardWorktime *m_standardWorktime; DateTime calculateForward(int use); DateTime calculateBackward(int use); DateTime scheduleForward(const DateTime &earliest, int use); DateTime scheduleBackward(const DateTime &latest, int use); void adjustSummarytask(); void initiateCalculation(Schedule &sch); void initiateCalculationLists(TQPtrList &startnodes, TQPtrList &endnodes, TQPtrList &summarytasks); bool legalParents(Node *par, Node *child); bool legalChildren(Node *par, Node *child); private: void init(); TQPtrList m_startNodes; TQPtrList m_endNodes; TQPtrList m_summarytasks; bool m_baselined; TQDict resourceGroupIdDict; TQDict resourceIdDict; TQDict nodeIdDict; TQDict calendarIdDict; #ifndef NDEBUG #include public: void printDebug(bool children, TQCString indent); void printCalendarDebug(TQCString indent=""); #ifdef DEBUGPERT static void pert_test(); static void printTree(Node *n, TQString s); #endif #endif }; } //KPlato namespace #endif