api.tasksqualrep.php 20 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537
  1. <?php
  2. /**
  3. * Tasks quality control report
  4. */
  5. class TasksQualRep {
  6. /**
  7. * Current date
  8. *
  9. * @var string
  10. */
  11. protected $dateCurrentDay = '';
  12. /**
  13. * Date of start of current month
  14. *
  15. * @var string
  16. */
  17. protected $dateMonthBegin = '';
  18. /**
  19. * Date of end of current month
  20. *
  21. * @var string
  22. */
  23. protected $dateMonthEnd = '';
  24. /**
  25. * Date of begin of current week
  26. *
  27. * @var string
  28. */
  29. protected $dateWeekBegin = '';
  30. /**
  31. * Date of end of current week
  32. *
  33. * @var string
  34. */
  35. protected $dateWeekEnd = '';
  36. /**
  37. * Date of begin of the current year
  38. *
  39. * @var string
  40. */
  41. protected $dateYearBegin = '';
  42. /**
  43. * Date of end of current year
  44. *
  45. * @var string
  46. */
  47. protected $dateYearEnd = '';
  48. /**
  49. * Contains current year tasks array for future rendering
  50. *
  51. * @var array
  52. */
  53. protected $allTasksData = array();
  54. /**
  55. * Contains all employee names from database as id=>name
  56. *
  57. * @var array
  58. */
  59. protected $allEmployeeNames = array();
  60. /**
  61. * System message helper placeholder
  62. *
  63. * @var object
  64. */
  65. protected $messages = '';
  66. /**
  67. * Task ranks (score) stigma source placeholder
  68. *
  69. * @var object
  70. */
  71. protected $taskRanks = '';
  72. /**
  73. * Task fails (anomalies) stigma source placeholder
  74. *
  75. * @var object
  76. */
  77. protected $taskFails = '';
  78. /**
  79. * What was done on tasks stigma source placeholder
  80. *
  81. * @var object
  82. */
  83. protected $tasksWhatDone = '';
  84. /**
  85. * Routes, URLs, etc..
  86. */
  87. const URL_TASKVIEW = '?module=taskman&edittask=';
  88. const URL_ME = '?module=tasksqualreport';
  89. const ROUTE_TASKRENDER = 'showtasks';
  90. const ROUTE_CALLSRENDER = 'showcalls';
  91. public function __construct() {
  92. $this->setDates();
  93. $this->initMessages();
  94. $this->initDataSources();
  95. }
  96. /**
  97. * Inits system messages object instance for further usage
  98. *
  99. * @return void
  100. */
  101. protected function initMessages() {
  102. $this->messages = new UbillingMessageHelper();
  103. }
  104. /**
  105. * Sets dates intervals to use it for report data filtering
  106. *
  107. * @return void
  108. */
  109. protected function setDates() {
  110. $this->dateCurrentDay = curdate();
  111. $this->dateMonthBegin = curmonth() . '-01';
  112. $this->dateMonthEnd = curmonth() . '-' . date("t");
  113. $this->dateWeekBegin = date("Y-m-d", strtotime('monday this week'));
  114. $this->dateWeekEnd = date("Y-m-d", strtotime('sunday this week'));
  115. $this->dateYearBegin = curyear() . '-01-01';
  116. $this->dateYearEnd = curyear() . '-12-31';
  117. }
  118. /**
  119. * Inits datasources for reports
  120. *
  121. * @return void
  122. */
  123. protected function initDataSources() {
  124. $this->taskRanks = new Stigma('TASKRANKS');
  125. $this->taskFails = new Stigma('TASKFAILS');
  126. $this->tasksWhatDone = new Stigma('TASKWHATIDO');
  127. }
  128. /**
  129. * Loads all tasks data from database
  130. *
  131. * @return void
  132. */
  133. protected function loadTasks() {
  134. $this->allTasksData = ts_GetAllTasksQuickData();
  135. }
  136. /**
  137. * Loads all existing employee names from database
  138. *
  139. * @return void
  140. */
  141. protected function loadEmployee() {
  142. $this->allEmployeeNames = ts_GetAllEmployee();
  143. }
  144. /**
  145. * Renders tasks list from stigma report data as modal
  146. *
  147. * @param array $reportData
  148. * @param string $stateId
  149. * @param string $stateLabel
  150. *
  151. * @return string
  152. */
  153. protected function renderTasksModal($reportData, $stateId, $stateLabel = '') {
  154. $result = '';
  155. $tasksList = '';
  156. $tasksCount = 0;
  157. if (!empty($reportData)) {
  158. if (isset($reportData[$stateId])) {
  159. if (isset($reportData[$stateId]['itemids'])) {
  160. if (!empty($reportData[$stateId]['itemids'])) {
  161. $cells = wf_TableCell(__('ID'));
  162. $cells .= wf_TableCell(__('Date'));
  163. $cells .= wf_TableCell(__('Address'));
  164. $cells .= wf_TableCell(__('Worker'));
  165. $rows = wf_TableRow($cells, 'row1');
  166. foreach ($reportData[$stateId]['itemids'] as $eachTaskId => $eachTaskAdmin) {
  167. if (isset($this->allTasksData[$eachTaskId])) {
  168. $taskLink = wf_Link(self::URL_TASKVIEW . $eachTaskId, $this->allTasksData[$eachTaskId]['address'], false, '', 'TARGET="_BLANK"');
  169. $taskEmployee = @$this->allEmployeeNames[$this->allTasksData[$eachTaskId]['employee']];
  170. $cells = wf_TableCell($eachTaskId);
  171. $cells .= wf_TableCell($this->allTasksData[$eachTaskId]['startdate']);
  172. $cells .= wf_TableCell($taskLink);
  173. $cells .= wf_TableCell($taskEmployee);
  174. $rows .= wf_TableRow($cells, 'row5');
  175. $tasksCount++;
  176. }
  177. }
  178. $tasksList .= wf_TableBody($rows, '100%', 0, 'sortable');
  179. }
  180. }
  181. }
  182. }
  183. if ($tasksCount > 0) {
  184. $result .= wf_modalAuto($tasksCount, $stateLabel, $tasksList);
  185. } else {
  186. $result .= '0';
  187. }
  188. return($result);
  189. }
  190. /**
  191. * Returns text representation of task execution ranks
  192. *
  193. * @return string
  194. */
  195. public function getDailyRanksText($eol = '') {
  196. $result = '';
  197. $availRanks = $this->taskRanks->getAllStates();
  198. $dataDay = $this->taskRanks->getReportData($this->dateCurrentDay, $this->dateCurrentDay);
  199. if (!empty($dataDay)) {
  200. $employeeLogins = ts_GetAllEmployeeLoginsAssocCached();
  201. $totalCount = 0;
  202. foreach ($dataDay as $stateId => $stateData) {
  203. $totalCount += $stateData['count'];
  204. }
  205. $result .= __('Tasks processed') . ': ' . $totalCount . $eol . $eol;
  206. $result .= __('Score') . ':' . $eol;
  207. foreach ($dataDay as $stateId => $stateData) {
  208. $result .= __($availRanks[$stateId]) . ' - ' . $stateData['count'] . ' ' . $eol;
  209. }
  210. $result .= $eol;
  211. $result .= __('Calls') . ':' . $eol;
  212. $adminStats = $this->getAdminStats($dataDay);
  213. foreach ($adminStats as $eachAdmin => $eachCalls) {
  214. $result .= @$employeeLogins[$eachAdmin] . ' - ' . $eachCalls . $eol;
  215. }
  216. }
  217. return($result);
  218. }
  219. /**
  220. * Renders user scores of tasks execution
  221. *
  222. * @return string
  223. */
  224. public function renderRanks() {
  225. $result = '';
  226. $tasksRenderFlag = (ubRouting::checkGet(self::ROUTE_TASKRENDER)) ? true : false;
  227. if ($tasksRenderFlag) {
  228. $this->loadTasks();
  229. $this->loadEmployee();
  230. }
  231. $availRanks = $this->taskRanks->getAllStates();
  232. $dataDay = $this->taskRanks->getReportData($this->dateCurrentDay, $this->dateCurrentDay);
  233. $dataWeek = $this->taskRanks->getReportData($this->dateWeekBegin, $this->dateWeekEnd);
  234. $dataMonth = $this->taskRanks->getReportData($this->dateMonthBegin, $this->dateMonthEnd);
  235. $dataYear = $this->taskRanks->getReportData($this->dateYearBegin, $this->dateYearEnd);
  236. $dataAllTime = $this->taskRanks->getReportData();
  237. if (!empty($availRanks)) {
  238. $cells = wf_TableCell(__('Score'), '30%');
  239. $cells .= wf_TableCell(__('Day'));
  240. $cells .= wf_TableCell(__('Week'));
  241. $cells .= wf_TableCell(__('Month'));
  242. $cells .= wf_TableCell(__('Year'));
  243. $cells .= wf_TableCell(__('All time'));
  244. $rows = wf_TableRow($cells, 'row1');
  245. foreach ($availRanks as $eachRankId => $eachRankDesc) {
  246. $rankLabel = __($eachRankDesc);
  247. $rankIcon = $this->taskRanks->getStateIcon($eachRankId);
  248. if ($tasksRenderFlag) {
  249. $dayCount = $this->renderTasksModal($dataDay, $eachRankId, $rankLabel);
  250. $weekCount = $this->renderTasksModal($dataWeek, $eachRankId, $rankLabel);
  251. $monthCount = $this->renderTasksModal($dataMonth, $eachRankId, $rankLabel);
  252. $yearCount = isset($dataYear[$eachRankId]['count']) ? $dataYear[$eachRankId]['count'] : 0;
  253. $allTimeCount = isset($dataAllTime[$eachRankId]['count']) ? $dataAllTime[$eachRankId]['count'] : 0;
  254. } else {
  255. $dayCount = isset($dataDay[$eachRankId]['count']) ? $dataDay[$eachRankId]['count'] : 0;
  256. $weekCount = isset($dataWeek[$eachRankId]['count']) ? $dataWeek[$eachRankId]['count'] : 0;
  257. $monthCount = isset($dataMonth[$eachRankId]['count']) ? $dataMonth[$eachRankId]['count'] : 0;
  258. $yearCount = isset($dataYear[$eachRankId]['count']) ? $dataYear[$eachRankId]['count'] : 0;
  259. $allTimeCount = isset($dataAllTime[$eachRankId]['count']) ? $dataAllTime[$eachRankId]['count'] : 0;
  260. }
  261. $cells = wf_TableCell(wf_img_sized($rankIcon, '', '10') . ' ' . $rankLabel);
  262. $cells .= wf_TableCell($dayCount);
  263. $cells .= wf_TableCell($weekCount);
  264. $cells .= wf_TableCell($monthCount);
  265. $cells .= wf_TableCell($yearCount);
  266. $cells .= wf_TableCell($allTimeCount);
  267. $rows .= wf_TableRow($cells, 'row5');
  268. }
  269. $result .= wf_TableBody($rows, '100%', 0, '');
  270. } else {
  271. $result .= $this->messages->getStyledMessage(__('Nothing to show'), 'warning');
  272. }
  273. return($result);
  274. }
  275. /**
  276. * Renders user anomalies of tasks execution
  277. *
  278. * @return string
  279. */
  280. public function renderFails() {
  281. $result = '';
  282. $tasksRenderFlag = (ubRouting::checkGet(self::ROUTE_TASKRENDER)) ? true : false;
  283. $availFails = $this->taskFails->getAllStates();
  284. $dataDay = $this->taskFails->getReportData($this->dateCurrentDay, $this->dateCurrentDay);
  285. $dataWeek = $this->taskFails->getReportData($this->dateWeekBegin, $this->dateWeekEnd);
  286. $dataMonth = $this->taskFails->getReportData($this->dateMonthBegin, $this->dateMonthEnd);
  287. $dataYear = $this->taskFails->getReportData($this->dateYearBegin, $this->dateYearEnd);
  288. $dataAllTime = $this->taskFails->getReportData();
  289. if (!empty($availFails)) {
  290. $cells = wf_TableCell(__('Fail'), '30%');
  291. $cells .= wf_TableCell(__('Day'));
  292. $cells .= wf_TableCell(__('Week'));
  293. $cells .= wf_TableCell(__('Month'));
  294. $cells .= wf_TableCell(__('Year'));
  295. $cells .= wf_TableCell(__('All time'));
  296. $rows = wf_TableRow($cells, 'row1');
  297. foreach ($availFails as $eachFailId => $eachFailDesc) {
  298. $failLabel = __($eachFailDesc);
  299. $failIcon = $this->taskFails->getStateIcon($eachFailId);
  300. if ($tasksRenderFlag) {
  301. $dayCount = $this->renderTasksModal($dataDay, $eachFailId, $failLabel);
  302. $weekCount = $this->renderTasksModal($dataWeek, $eachFailId, $failLabel);
  303. $monthCount = $this->renderTasksModal($dataMonth, $eachFailId, $failLabel);
  304. $yearCount = isset($dataYear[$eachFailId]['count']) ? $dataYear[$eachFailId]['count'] : 0;
  305. $allTimeCount = isset($dataAllTime[$eachFailId]['count']) ? $dataAllTime[$eachFailId]['count'] : 0;
  306. } else {
  307. $dayCount = isset($dataDay[$eachFailId]['count']) ? $dataDay[$eachFailId]['count'] : 0;
  308. $weekCount = isset($dataWeek[$eachFailId]['count']) ? $dataWeek[$eachFailId]['count'] : 0;
  309. $monthCount = isset($dataMonth[$eachFailId]['count']) ? $dataMonth[$eachFailId]['count'] : 0;
  310. $yearCount = isset($dataYear[$eachFailId]['count']) ? $dataYear[$eachFailId]['count'] : 0;
  311. $allTimeCount = isset($dataAllTime[$eachFailId]['count']) ? $dataAllTime[$eachFailId]['count'] : 0;
  312. }
  313. $cells = wf_TableCell(wf_img_sized($failIcon, '', '10') . ' ' . $failLabel);
  314. $cells .= wf_TableCell($dayCount);
  315. $cells .= wf_TableCell($weekCount);
  316. $cells .= wf_TableCell($monthCount);
  317. $cells .= wf_TableCell($yearCount);
  318. $cells .= wf_TableCell($allTimeCount);
  319. $rows .= wf_TableRow($cells, 'row5');
  320. }
  321. $result .= wf_TableBody($rows, '100%', 0, '');
  322. } else {
  323. $result .= $this->messages->getStyledMessage(__('Nothing to show'), 'warning');
  324. }
  325. return($result);
  326. }
  327. /**
  328. * Renders what was done on tasks
  329. *
  330. * @return string
  331. */
  332. public function renderWhatDone() {
  333. $result = '';
  334. $tasksRenderFlag = (ubRouting::checkGet(self::ROUTE_TASKRENDER)) ? true : false;
  335. $availStates = $this->tasksWhatDone->getAllStates();
  336. $dataDay = $this->tasksWhatDone->getReportData($this->dateCurrentDay, $this->dateCurrentDay);
  337. $dataWeek = $this->tasksWhatDone->getReportData($this->dateWeekBegin, $this->dateWeekEnd);
  338. $dataMonth = $this->tasksWhatDone->getReportData($this->dateMonthBegin, $this->dateMonthEnd);
  339. $dataYear = $this->tasksWhatDone->getReportData($this->dateYearBegin, $this->dateYearEnd);
  340. $dataAllTime = $this->tasksWhatDone->getReportData();
  341. if (!empty($availStates)) {
  342. $cells = wf_TableCell(__('Job'), '30%');
  343. $cells .= wf_TableCell(__('Day'));
  344. $cells .= wf_TableCell(__('Week'));
  345. $cells .= wf_TableCell(__('Month'));
  346. $cells .= wf_TableCell(__('Year'));
  347. $cells .= wf_TableCell(__('All time'));
  348. $rows = wf_TableRow($cells, 'row1');
  349. foreach ($availStates as $eachStateId => $eachStateDesc) {
  350. $stateLabel = __($eachStateDesc);
  351. $stateIcon = $this->tasksWhatDone->getStateIcon($eachStateId);
  352. if ($tasksRenderFlag) {
  353. $dayCount = $this->renderTasksModal($dataDay, $eachStateId, $stateLabel);
  354. $weekCount = $this->renderTasksModal($dataWeek, $eachStateId, $stateLabel);
  355. $monthCount = $this->renderTasksModal($dataMonth, $eachStateId, $stateLabel);
  356. $yearCount = isset($dataYear[$eachStateId]['count']) ? $dataYear[$eachStateId]['count'] : 0;
  357. $allTimeCount = isset($dataAllTime[$eachStateId]['count']) ? $dataAllTime[$eachStateId]['count'] : 0;
  358. } else {
  359. $dayCount = isset($dataDay[$eachStateId]['count']) ? $dataDay[$eachStateId]['count'] : 0;
  360. $weekCount = isset($dataWeek[$eachStateId]['count']) ? $dataWeek[$eachStateId]['count'] : 0;
  361. $monthCount = isset($dataMonth[$eachStateId]['count']) ? $dataMonth[$eachStateId]['count'] : 0;
  362. $yearCount = isset($dataYear[$eachStateId]['count']) ? $dataYear[$eachStateId]['count'] : 0;
  363. $allTimeCount = isset($dataAllTime[$eachStateId]['count']) ? $dataAllTime[$eachStateId]['count'] : 0;
  364. }
  365. $cells = wf_TableCell(wf_img_sized($stateIcon, '', '10') . ' ' . $stateLabel);
  366. $cells .= wf_TableCell($dayCount);
  367. $cells .= wf_TableCell($weekCount);
  368. $cells .= wf_TableCell($monthCount);
  369. $cells .= wf_TableCell($yearCount);
  370. $cells .= wf_TableCell($allTimeCount);
  371. $rows .= wf_TableRow($cells, 'row5');
  372. }
  373. $result .= wf_TableBody($rows, '100%', 0, '');
  374. } else {
  375. $result .= $this->messages->getStyledMessage(__('Nothing to show'), 'warning');
  376. }
  377. return($result);
  378. }
  379. /**
  380. * Extracts per admin states changes count from states data array
  381. *
  382. * @param array $dataArray
  383. *
  384. * @return array
  385. */
  386. protected function getAdminStats($dataArray) {
  387. $result = array();
  388. if (!empty($dataArray)) {
  389. foreach ($dataArray as $io => $each) {
  390. if (isset($each['admins'])) {
  391. foreach ($each['admins'] as $adminLogin => $statesCount) {
  392. if (isset($result[$adminLogin])) {
  393. $result[$adminLogin] += $statesCount;
  394. } else {
  395. $result[$adminLogin] = $statesCount;
  396. }
  397. }
  398. }
  399. }
  400. }
  401. return($result);
  402. }
  403. /**
  404. * Renders stats around callers/unique tasks processed
  405. *
  406. * @return string
  407. */
  408. public function renderCallsReport() {
  409. $result = '';
  410. $allEmployeeLogins = ts_GetAllEmployeeLoginsAssocCached();
  411. $activeEmployeeLogins = ts_GetActiveEmployeeLogins();
  412. if (!empty($activeEmployeeLogins)) {
  413. $activeEmployeeLogins = array_flip($activeEmployeeLogins);
  414. }
  415. $dataDay = $this->taskRanks->getReportData($this->dateCurrentDay, $this->dateCurrentDay);
  416. $dataWeek = $this->taskRanks->getReportData($this->dateWeekBegin, $this->dateWeekEnd);
  417. $dataMonth = $this->taskRanks->getReportData($this->dateMonthBegin, $this->dateMonthEnd);
  418. $dataYear = $this->taskRanks->getReportData($this->dateYearBegin, $this->dateYearEnd);
  419. $dataAllTime = $this->taskRanks->getReportData();
  420. $adminsDay = $this->getAdminStats($dataDay);
  421. $adminsWeek = $this->getAdminStats($dataWeek);
  422. $adminsMonth = $this->getAdminStats($dataMonth);
  423. $adminsYear = $this->getAdminStats($dataYear);
  424. $adminsAllTime = $this->getAdminStats($dataAllTime);
  425. if (!empty($adminsAllTime)) {
  426. $cells = wf_TableCell(__('Administrator'), '30%');
  427. $cells .= wf_TableCell(__('Day'));
  428. $cells .= wf_TableCell(__('Week'));
  429. $cells .= wf_TableCell(__('Month'));
  430. $cells .= wf_TableCell(__('Year'));
  431. $cells .= wf_TableCell(__('All time'));
  432. $rows = wf_TableRow($cells, 'row1');
  433. foreach ($adminsAllTime as $eachAdmin => $allTimeCount) {
  434. if (isset($activeEmployeeLogins[$eachAdmin])) {
  435. $adminName = (isset($allEmployeeLogins[$eachAdmin])) ? $allEmployeeLogins[$eachAdmin] : $eachAdmin;
  436. $dayCount = (isset($adminsDay[$eachAdmin])) ? $adminsDay[$eachAdmin] : 0;
  437. $weekCount = (isset($adminsWeek[$eachAdmin])) ? $adminsWeek[$eachAdmin] : 0;
  438. $monthCount = (isset($adminsMonth[$eachAdmin])) ? $adminsMonth[$eachAdmin] : 0;
  439. $yearCount = (isset($adminsYear[$eachAdmin])) ? $adminsYear[$eachAdmin] : 0;
  440. $cells = wf_TableCell($adminName, '30%');
  441. $cells .= wf_TableCell($dayCount);
  442. $cells .= wf_TableCell($weekCount);
  443. $cells .= wf_TableCell($monthCount);
  444. $cells .= wf_TableCell($yearCount);
  445. $cells .= wf_TableCell($allTimeCount);
  446. $rows .= wf_TableRow($cells, 'row5');
  447. }
  448. }
  449. $result .= wf_TableBody($rows, '100%', 0, 'sortable');
  450. } else {
  451. $this->messages->getStyledMessage(__('Nothing to show'), 'warning');
  452. }
  453. return($result);
  454. }
  455. /**
  456. * Renders module controls
  457. *
  458. * @return string
  459. */
  460. public function renderControls() {
  461. $result = '';
  462. if (ubRouting::checkGet(self::ROUTE_TASKRENDER) OR ubRouting::checkGet(self::ROUTE_CALLSRENDER)) {
  463. $result .= wf_Link(self::URL_ME, web_icon_charts() . ' ' . __('Stats'), false, 'ubButton') . ' ';
  464. } else {
  465. $result .= wf_Link(self::URL_ME . '&' . self::ROUTE_TASKRENDER . '=true', wf_img('skins/task_icon_small.png') . ' ' . __('Tasks'), false, 'ubButton') . ' ';
  466. }
  467. $result .= wf_Link(self::URL_ME . '&' . self::ROUTE_CALLSRENDER . '=true', wf_img('skins/icon_mobile.gif') . ' ' . __('Calls'), false, 'ubButton') . ' ';
  468. return($result);
  469. }
  470. }