|
1
|
|
|
<?php |
|
2
|
|
|
/** |
|
3
|
|
|
* Project module model class. |
|
4
|
|
|
* |
|
5
|
|
|
* @package Module |
|
6
|
|
|
* |
|
7
|
|
|
* @copyright YetiForce S.A. |
|
8
|
|
|
* @license YetiForce Public License 5.0 (licenses/LicenseEN.txt or yetiforce.com) |
|
9
|
|
|
* @author Mariusz Krzaczkowski <[email protected]> |
|
10
|
|
|
*/ |
|
11
|
|
|
class Project_Module_Model extends Vtiger_Module_Model |
|
12
|
|
|
{ |
|
13
|
|
|
/** |
|
14
|
|
|
* Calculate estimated work time. |
|
15
|
|
|
* |
|
16
|
|
|
* @param int $id |
|
17
|
|
|
* @param float $estimatedWorkTime |
|
18
|
|
|
* |
|
19
|
|
|
* @throws \App\Exceptions\AppException |
|
20
|
|
|
* |
|
21
|
|
|
* @return float |
|
22
|
|
|
*/ |
|
23
|
|
|
public static function calculateEstimatedWorkTime(int $id, float $estimatedWorkTime = 0): float |
|
24
|
|
|
{ |
|
25
|
|
|
$progressInHours = 0; |
|
26
|
|
|
foreach (static::getChildren($id) as $child) { |
|
27
|
|
|
$estimatedWorkTime += static::calculateEstimatedWorkTime($child['id']); |
|
28
|
|
|
} |
|
29
|
|
|
static::calculateProgressOfMilestones($id, $estimatedWorkTime, $progressInHours); |
|
30
|
|
|
return $estimatedWorkTime; |
|
31
|
|
|
} |
|
32
|
|
|
|
|
33
|
|
|
/** |
|
34
|
|
|
* Get children by parent ID. |
|
35
|
|
|
* |
|
36
|
|
|
* @param int $id |
|
37
|
|
|
* |
|
38
|
|
|
* @return int[] |
|
39
|
|
|
*/ |
|
40
|
1 |
|
protected static function getChildren(int $id): array |
|
41
|
|
|
{ |
|
42
|
1 |
|
return (new \App\Db\Query()) |
|
43
|
1 |
|
->select(['id' => 'vtiger_project.projectid', 'vtiger_project.progress']) |
|
44
|
1 |
|
->from('vtiger_project') |
|
45
|
1 |
|
->innerJoin('vtiger_crmentity', 'vtiger_project.projectid = vtiger_crmentity.crmid') |
|
46
|
1 |
|
->where(['vtiger_crmentity.deleted' => [0, 2]]) |
|
47
|
1 |
|
->andWhere(['vtiger_project.parentid' => $id])->all(); |
|
48
|
|
|
} |
|
49
|
|
|
|
|
50
|
|
|
/** |
|
51
|
|
|
* Calculate the progress of milestones. |
|
52
|
|
|
* |
|
53
|
|
|
* @param int $id |
|
54
|
|
|
* @param float $estimatedWorkTime |
|
55
|
|
|
* @param float $progressInHours |
|
56
|
|
|
* |
|
57
|
|
|
* @throws \App\Exceptions\AppException |
|
58
|
|
|
*/ |
|
59
|
1 |
|
protected static function calculateProgressOfMilestones(int $id, float &$estimatedWorkTime, float &$progressInHours) |
|
|
|
|
|
|
60
|
|
|
{ |
|
61
|
1 |
|
$dataReader = (new \App\Db\Query()) |
|
62
|
1 |
|
->select([ |
|
63
|
1 |
|
'id' => 'vtiger_projectmilestone.projectmilestoneid', |
|
64
|
|
|
'projectmilestonename' => 'vtiger_projectmilestone.projectmilestonename', |
|
65
|
|
|
'projectmilestone_progress' => 'vtiger_projectmilestone.projectmilestone_progress', |
|
66
|
|
|
]) |
|
67
|
1 |
|
->from('vtiger_projectmilestone') |
|
68
|
1 |
|
->innerJoin('vtiger_crmentity', 'vtiger_projectmilestone.projectmilestoneid = vtiger_crmentity.crmid') |
|
69
|
1 |
|
->where(['vtiger_crmentity.deleted' => [0, 2]]) |
|
70
|
1 |
|
->andWhere(['vtiger_projectmilestone.projectid' => $id]) |
|
71
|
1 |
|
->andWhere(['or', ['vtiger_projectmilestone.parentid' => 0], ['vtiger_projectmilestone.parentid' => null]]) |
|
72
|
1 |
|
->createCommand()->query(); |
|
73
|
1 |
|
while ($row = $dataReader->read()) { |
|
74
|
|
|
$milestoneEstimatedWorkTime = ProjectMilestone_Module_Model::calculateEstimatedWorkTime($row['id']); |
|
75
|
|
|
$estimatedWorkTime += $milestoneEstimatedWorkTime; |
|
76
|
|
|
$progressInHours += ($milestoneEstimatedWorkTime * (float) $row['projectmilestone_progress']) / 100; |
|
77
|
|
|
} |
|
78
|
1 |
|
$dataReader->close(); |
|
79
|
1 |
|
} |
|
80
|
|
|
|
|
81
|
|
|
/** {@inheritdoc} */ |
|
82
|
|
|
public function getSideBarLinks($linkParams) |
|
83
|
|
|
{ |
|
84
|
|
|
$links = parent::getSideBarLinks($linkParams); |
|
85
|
|
|
$links['SIDEBARLINK'][] = Vtiger_Link_Model::getInstanceFromValues([ |
|
86
|
|
|
'linktype' => 'SIDEBARLINK', |
|
87
|
|
|
'linklabel' => 'LBL_VIEW_GANTT', |
|
88
|
|
|
'linkurl' => 'index.php?module=Project&view=Gantt', |
|
89
|
|
|
'linkicon' => 'fas fa-briefcase', |
|
90
|
|
|
]); |
|
91
|
|
|
return $links; |
|
92
|
|
|
} |
|
93
|
|
|
|
|
94
|
|
|
/** |
|
95
|
|
|
* Update progress in project. |
|
96
|
|
|
* |
|
97
|
|
|
* @param int $id |
|
98
|
|
|
* @param float $estimatedWorkTime |
|
99
|
|
|
* @param float $progressInHours |
|
100
|
|
|
* @param int|null $callerId |
|
101
|
|
|
* |
|
102
|
|
|
* @throws \App\Exceptions\AppException |
|
103
|
|
|
* |
|
104
|
|
|
* @return array |
|
105
|
|
|
*/ |
|
106
|
|
|
public static function updateProgress(int $id, float $estimatedWorkTime = 0, float $progressInHours = 0, ?int $callerId = null): array |
|
107
|
|
|
{ |
|
108
|
1 |
|
$recordModel = Vtiger_Record_Model::getInstanceById($id); |
|
109
|
|
|
foreach (static::getChildren($id) as $child) { |
|
110
|
1 |
|
if ($callerId !== $child['id']) { |
|
111
|
1 |
|
$childEstimatedWorkTime = static::calculateEstimatedWorkTime($child['id']); |
|
112
|
|
|
$estimatedWorkTime += $childEstimatedWorkTime; |
|
113
|
|
|
$progressInHours += ($childEstimatedWorkTime * $child['progress'] / 100); |
|
114
|
|
|
} |
|
115
|
|
|
} |
|
116
|
|
|
static::calculateProgressOfMilestones($id, $estimatedWorkTime, $progressInHours); |
|
117
|
|
|
$projectProgress = $estimatedWorkTime ? round((100 * $progressInHours) / $estimatedWorkTime) : 0; |
|
118
|
1 |
|
$recordModel->set('progress', $projectProgress); |
|
119
|
1 |
|
$recordModel->set('estimated_work_time', $estimatedWorkTime); |
|
120
|
1 |
|
$recordModel->save(); |
|
121
|
1 |
|
if (!$recordModel->isEmpty('parentid') && $recordModel->get('parentid') !== $callerId) { |
|
122
|
1 |
|
static::updateProgress( |
|
123
|
1 |
|
$recordModel->get('parentid'), |
|
124
|
|
|
$estimatedWorkTime, |
|
125
|
|
|
$progressInHours, |
|
126
|
|
|
$id |
|
127
|
|
|
); |
|
128
|
|
|
} |
|
129
|
|
|
return [ |
|
130
|
|
|
'estimatedWorkTime' => $estimatedWorkTime, |
|
131
|
|
|
'projectProgress' => $projectProgress |
|
132
|
1 |
|
]; |
|
133
|
1 |
|
} |
|
134
|
|
|
} |
|
135
|
|
|
|