Akaunting/app/Abstracts/Report.php

694 lines
19 KiB
PHP

<?php
namespace App\Abstracts;
use Akaunting\Apexcharts\Chart;
use App\Events\Report\DataLoaded;
use App\Events\Report\DataLoading;
use App\Events\Report\FilterApplying;
use App\Events\Report\FilterShowing;
use App\Events\Report\GroupApplying;
use App\Events\Report\GroupShowing;
use App\Events\Report\RowsShowing;
use App\Events\Report\TotalCalculating;
use App\Events\Report\TotalCalculated;
use App\Exports\Common\Reports as Export;
use App\Models\Common\Report as Model;
use App\Models\Document\Document;
use App\Models\Setting\Category;
use App\Traits\Charts;
use App\Traits\DateTime;
use App\Traits\SearchString;
use App\Traits\Translations;
use App\Utilities\Date;
use App\Utilities\Export as ExportHelper;
use Illuminate\Support\Str;
abstract class Report
{
use Charts, DateTime, SearchString, Translations;
public $model;
public $default_name = '';
public $category = 'reports.income_expense';
public $icon = 'donut_small';
public $type = 'detail';
public $has_money = true;
public $group;
public $groups = [];
public $year;
public $views = [];
public $tables = [];
public $dates = [];
public $row_names = [];
public $row_values = [];
public $footer_totals = [];
public $filters = [];
public $loaded = false;
public $bar_formatter_type = 'money';
public $donut_formatter_type = 'percent';
public $chart = [
'bar' => [
'colors' => [
'#6da252',
],
'yaxis' => [
'labels' => [
'formatter' => '',
],
],
],
'donut' => [
'yaxis' => [
'labels' => [
'formatter' => '',
],
],
],
];
public $column_name_width = 'report-column-name';
public $column_value_width = 'report-column-value';
public $row_tree_nodes = [];
public function __construct(Model $model = null, $load_data = true)
{
$this->setGroups();
if (!$model) {
return;
}
$this->model = $model;
if (!$load_data) {
return;
}
$this->load();
}
abstract public function setData();
public function load()
{
$this->setYear();
$this->setViews();
$this->setTables();
$this->setDates();
$this->setFilters();
$this->setRows();
$this->loadData();
$this->setColumnWidth();
$this->setChartLabelFormatter();
$this->loaded = true;
}
public function loadData()
{
event(new DataLoading($this));
$this->setData();
event(new DataLoaded($this));
}
public function getDefaultName()
{
if (!empty($this->default_name)) {
return trans($this->default_name);
}
return Str::title(str_replace('_', ' ', Str::snake((new \ReflectionClass($this))->getShortName())));
}
public function getCategory()
{
return trans($this->category);
}
public function getCategoryDescription()
{
if (! empty($this->category_description)) {
return trans($this->category_description);
}
return $this->findTranslation([
$this->category . '_desc',
$this->category . '_description',
str_replace('general.', 'reports.', $this->category) . '_desc',
str_replace('general.', 'reports.', $this->category) . '_description',
]);
}
public function getIcon()
{
return $this->icon;
}
public function getCharts($table_key)
{
return [
'bar' => $this->getBarChart($table_key),
'donut' => $this->getDonutChart($table_key),
];
}
public function getBarChart($table_key)
{
$chart = new Chart();
if (empty($this->chart)) {
return $chart;
}
$options = !empty($this->chart[$table_key]) ? $this->chart[$table_key]['bar'] : $this->chart['bar'];
$chart->setType('bar')
->setOptions($options)
->setDefaultLocale($this->getDefaultLocaleOfChart())
->setLocales($this->getLocaleTranslationOfChart())
->setLabels(array_values($this->dates))
->setDataset($this->tables[$table_key], 'column', array_values($this->footer_totals[$table_key]));
return $chart;
}
public function getDonutChart($table_key)
{
$chart = new Chart();
if (empty($this->chart)) {
return $chart;
}
$tmp_values = [];
if (! empty($this->row_values[$table_key])) {
foreach ($this->row_values[$table_key] as $id => $dates) {
$tmp_values[$id] = 0;
foreach ($dates as $date) {
$tmp_values[$id] += $date;
}
}
}
$tmp_values = collect($tmp_values)->sort()->reverse()->take(10)->all();
$total = array_sum($tmp_values);
$total = !empty($total) ? $total : 1;
$group = $this->getSetting('group');
$labels = $colors = $values = [];
foreach ($tmp_values as $id => $value) {
$labels[$id] = $this->row_names[$table_key][$id];
$colors[$id] = ($group == 'category')
? Category::withSubCategory()->find($id)?->colorHexCode
: $this->randHexColor();
$values[$id] = round(($value * 100 / $total), 0);
}
$options = !empty($this->chart[$table_key]) ? $this->chart[$table_key]['donut'] : $this->chart['donut'];
$chart->setType('donut')
->setOptions($options)
->setDefaultLocale($this->getDefaultLocaleOfChart())
->setLocales($this->getLocaleTranslationOfChart())
->setLabels(array_values($labels))
->setColors(array_values($colors))
->setDataset($this->tables[$table_key], 'donut', array_values($values));
$chart->options['legend']['width'] = 105;
$chart->options['legend']['position'] = 'right';
return $chart;
}
public function show()
{
return view($this->views['show'], ['print' => false])->with('class', $this);
}
public function print()
{
return view($this->views['print'], ['print' => true])->with('class', $this);
}
public function array(): array
{
$data = [];
$group = Str::plural($this->group ?? $this->getSetting('group'));
foreach ($this->tables as $table_key => $table_name) {
if (! isset($this->row_values[$table_key])) {
continue;
}
foreach ($this->row_values[$table_key] as $key => $values) {
if (empty($this->row_names[$table_key][$key])) {
continue;
}
if ($this->has_money) {
$values = array_map(fn($value) => money($value)->format(), $values);
}
$data[$table_key][$group][$this->row_names[$table_key][$key]] = $values;
}
$footer_totals = $this->footer_totals[$table_key];
if ($this->has_money) {
$footer_totals = array_map(fn($value) => money($value)->format(), $footer_totals);
}
$data[$table_key]['totals'] = $footer_totals;
}
return $data;
}
public function pdf()
{
$view = view($this->views['print'], ['print' => true])->with('class', $this)->render();
$html = mb_convert_encoding($view, 'HTML-ENTITIES', 'UTF-8');
$pdf = app('dompdf.wrapper');
$pdf->loadHTML($html);
$pdf->setPaper('A4', 'landscape');
$file_name = $this->model->name . ' - ' . company()->name . '.pdf';
return $pdf->download($file_name);
}
public function export()
{
return ExportHelper::toExcel(new Export($this->views[$this->type], $this), $this->model->name);
}
public function setColumnWidth()
{
if (! $period = $this->getPeriod()) {
return;
}
$width = '';
switch ($period) {
case 'quarterly':
$width = 'w-2/12 col-2';
break;
case 'yearly':
$width = 'w-4/12 col-4';
break;
case 'monthly':
$width = 'col-1 w-20';
break;
case 'weekly':
$width = 'col-1 w-20';
break;
}
if (empty($width)) {
return;
}
$this->column_name_width = $this->column_value_width = $width;
}
public function setChartLabelFormatter()
{
if (count($this->tables) > 1) {
foreach ($this->tables as $table_key => $table) {
if (empty($this->chart[$table_key])) {
continue;
}
$this->chart[$table_key]['bar']['yaxis']['labels']['formatter'] = $this->getChartLabelFormatter($this->bar_formatter_type);
$this->chart[$table_key]['donut']['yaxis']['labels']['formatter'] = $this->getChartLabelFormatter($this->donut_formatter_type);
}
} else {
$this->chart['bar']['yaxis']['labels']['formatter'] = $this->getChartLabelFormatter($this->bar_formatter_type);
$this->chart['donut']['yaxis']['labels']['formatter'] = $this->getChartLabelFormatter($this->donut_formatter_type);
}
}
public function setYear()
{
$this->year = request()->filled('start_date') ? Date::parse(request('start_date'))->year : Date::now()->year;
}
public function setViews()
{
$this->views = [
'show' => 'components.reports.show',
'print' => 'components.reports.print',
'filter' => 'components.reports.filter',
'detail' => 'components.reports.detail',
'detail.content.header' => 'components.reports.detail.content.header',
'detail.content.footer' => 'components.reports.detail.content.footer',
'detail.table' => 'components.reports.detail.table',
'detail.table.header' => 'components.reports.detail.table.header',
'detail.table.body' => 'components.reports.detail.table.body',
'detail.table.row' => 'components.reports.detail.table.row',
'detail.table.footer' => 'components.reports.detail.table.footer',
'summary' => 'components.reports.summary',
'summary.content.header' => 'components.reports.summary.content.header',
'summary.content.footer' => 'components.reports.summary.content.footer',
'summary.table' => 'components.reports.summary.table',
'summary.table.header' => 'components.reports.summary.table.header',
'summary.table.body' => 'components.reports.summary.table.body',
'summary.table.row' => 'components.reports.summary.table.row',
'summary.table.footer' => 'components.reports.summary.table.footer',
'summary.chart' => 'components.reports.summary.chart',
];
}
public function setTables()
{
$this->tables = [
'default' => trans_choice('general.totals', 1),
];
}
public function setDates()
{
if (! $period = $this->getPeriod()) {
return;
}
[$start, $end] = $this->getStartAndEndDates($this->year);
$counter = match ($period) {
'weekly' => $end->diffInWeeks($start),
'quarterly' => $end->diffInQuarters($start),
'yearly' => $end->diffInYears($start),
default => $end->diffInMonths($start),
};
for ($j = 0; $j <= $counter; $j++) {
$date = $this->getPeriodicDate($start, $this->getPeriod(), $this->year);
$this->dates[] = $date;
foreach ($this->tables as $table_key => $table_name) {
$this->footer_totals[$table_key][$date] = 0;
}
match ($period) {
'weekly' => $start->addWeek(),
'quarterly' => $start->addQuarter(),
'yearly' => $start->addYear(),
default => $start->addMonth(),
};
}
}
public function setFilters()
{
event(new FilterShowing($this));
}
public function setGroups()
{
event(new GroupShowing($this));
}
public function setRows()
{
event(new RowsShowing($this));
}
public function setTotals($items, $date_field, $check_type = false, $table = 'default', $with_tax = true)
{
event(new TotalCalculating($this, $items, $date_field, $check_type, $table, $with_tax));
$group_field = $this->getSetting('group') . '_id';
foreach ($items as $item) {
// Make groups extensible
$item = $this->applyGroups($item);
$date = $this->getPeriodicDate(Date::parse($item->$date_field), $this->getPeriod(), $this->year);
if (!isset($item->$group_field)) {
continue;
}
$group = $item->$group_field;
if (
!isset($this->row_values[$table][$group])
|| !isset($this->row_values[$table][$group][$date])
|| !isset($this->footer_totals[$table][$date])
) {
continue;
}
$amount = $item->getAmountConvertedToDefault(false, $with_tax);
$type = ($item->type === Document::INVOICE_TYPE || $item->type === 'income') ? 'income' : 'expense';
if (($check_type == false) || ($type == 'income')) {
$this->row_values[$table][$group][$date] += $amount;
$this->footer_totals[$table][$date] += $amount;
} else {
$this->row_values[$table][$group][$date] -= $amount;
$this->footer_totals[$table][$date] -= $amount;
}
}
event(new TotalCalculated($this, $items, $date_field, $check_type, $table, $with_tax));
}
public function setArithmeticTotals($items, $date_field, $operator = 'add', $table = 'default', $amount_field = 'amount')
{
$group_field = $this->getSetting('group') . '_id';
$function = $operator . 'ArithmeticAmount';
foreach ($items as $item) {
// Make groups extensible
$item = $this->applyGroups($item);
$date = $this->getPeriodicDate(Date::parse($item->$date_field), $this->getPeriod(), $this->year);
if (!isset($item->$group_field)) {
continue;
}
$group = $item->$group_field;
if (
!isset($this->row_values[$table][$group])
|| !isset($this->row_values[$table][$group][$date])
|| !isset($this->footer_totals[$table][$date])
) {
continue;
}
$amount = isset($item->$amount_field) ? $item->$amount_field : 1;
$this->$function($this->row_values[$table][$group][$date], $amount);
$this->$function($this->footer_totals[$table][$date], $amount);
}
}
public function addArithmeticAmount(&$current, $amount)
{
$current = $current + $amount;
}
public function subArithmeticAmount(&$current, $amount)
{
$current = $current - $amount;
}
public function mulArithmeticAmount(&$current, $amount)
{
$current = $current * $amount;
}
public function divArithmeticAmount(&$current, $amount)
{
$current = $current / $amount;
}
public function modArithmeticAmount(&$current, $amount)
{
$current = $current % $amount;
}
public function expArithmeticAmount(&$current, $amount)
{
$current = $current ** $amount;
}
public function applyFilters($model, $args = [])
{
event(new FilterApplying($this, $model, $args));
return $model;
}
public function applyGroups($model, $args = [])
{
event(new GroupApplying($this, $model, $args));
return $model;
}
public function getUrl($action = 'print')
{
$url = company_id() . '/common/reports/' . $this->model->id . '/' . $action;
$request = request()->all();
$parameters = '';
foreach ($request as $key => $value) {
$parameters .= empty($parameters) ? ('?' . $key . '=' . $value) : ('&' . $key . '=' . $value);
}
if (!empty($parameters)) {
$url .= $parameters;
}
return $url;
}
public function getSetting($name, $default = '')
{
return $this->model->settings->$name ?? $default;
}
public function getBasis()
{
return $this->getSearchStringValue('basis', $this->getSetting('basis'));
}
public function getPeriod()
{
return $this->getSearchStringValue('period', $this->getSetting('period'));
}
public function getDiscount()
{
return $this->getSearchStringValue('discount');
}
public function getFields()
{
return [
$this->getGroupField(),
$this->getPeriodField(),
$this->getBasisField(),
];
}
public function getGroupField()
{
$this->setGroups();
return [
'type' => 'select',
'name' => 'group',
'title' => trans('general.group_by'),
'icon' => 'folder',
'values' => $this->groups,
'selected' => 'category',
'attributes' => [
'required' => 'required',
],
];
}
public function getPeriodField()
{
return [
'type' => 'select',
'name' => 'period',
'title' => trans('general.period'),
'icon' => 'calendar',
'values' => [
'weekly' => trans('general.weekly'),
'monthly' => trans('general.monthly'),
'quarterly' => trans('general.quarterly'),
'yearly' => trans('general.yearly'),
],
'selected' => 'quarterly',
'attributes' => [
'required' => 'required',
],
];
}
public function getBasisField()
{
return [
'type' => 'select',
'name' => 'basis',
'title' => trans('general.basis'),
'icon' => 'file',
'values' => [
'accrual' => trans('general.accrual'),
'cash' => trans('general.cash'),
],
'selected' => 'accrual',
'attributes' => [
'required' => 'required',
],
];
}
public function randHexColorPart(): string
{
return str_pad( dechex( mt_rand( 0, 255 ) ), 2, '0', STR_PAD_LEFT);
}
public function randHexColor(): string
{
return '#' . $this->randHexColorPart() . $this->randHexColorPart() . $this->randHexColorPart();
}
// @deprecated 3.1
public function getFormattedDate($date)
{
return $this->getPeriodicDate($date, $this->getPeriod(), $this->year);
}
}