feat(110): statistics summary

Phase 110 complete:
- add Statistics -> Podsumowanie page
- add monthly order count and value charts per integration plus total
- use Chart.js with table fallback and 04-2026 default history start
- update PAUL and DOCS technical documentation
This commit is contained in:
2026-04-28 22:47:14 +02:00
parent 1156ce046c
commit 0b4ffb7146
21 changed files with 2454 additions and 26 deletions

View File

@@ -0,0 +1,208 @@
<?php
declare(strict_types=1);
$filters = is_array($filters ?? null) ? $filters : [];
$channelOptions = is_array($channelOptions ?? null) ? $channelOptions : [];
$statusGroupOptions = is_array($statusGroupOptions ?? null) ? $statusGroupOptions : [];
$summary = is_array($summary ?? null) ? $summary : [];
$selectedChannels = is_array($filters['selected_channels'] ?? null) ? $filters['selected_channels'] : [];
$selectedStatusGroups = is_array($filters['selected_status_groups'] ?? null) ? $filters['selected_status_groups'] : [];
$rows = is_array($summary['rows'] ?? null) ? $summary['rows'] : [];
$hasData = (bool) ($summary['hasData'] ?? false);
$countChart = is_array($summary['countChart'] ?? null) ? $summary['countChart'] : ['labels' => [], 'series' => []];
$valueChart = is_array($summary['valueChart'] ?? null) ? $summary['valueChart'] : ['labels' => [], 'series' => []];
$chartPayload = [
'count' => $countChart,
'value' => $valueChart,
];
$chartJson = json_encode(
$chartPayload,
JSON_UNESCAPED_UNICODE | JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT
);
if (!is_string($chartJson)) {
$chartJson = '{}';
}
$displayMonth = static function (string $month): string {
$date = DateTimeImmutable::createFromFormat('Y-m-d', $month . '-01');
if (!$date instanceof DateTimeImmutable) {
return $month;
}
return $date->format('m-Y');
};
?>
<section class="card statistics-summary-page">
<div class="statistics-orders-head">
<div>
<h2 class="section-title"><?= $e($t('statistics.summary.title')) ?></h2>
<p class="muted mt-12"><?= $e($t('statistics.summary.description')) ?></p>
</div>
</div>
<form method="get" action="/statistics/summary" class="statistics-orders-filters mt-16">
<label class="form-field">
<span class="field-label"><?= $e($t('statistics.summary.filters.date_from')) ?></span>
<input class="form-control" type="date" name="date_from" value="<?= $e((string) ($filters['date_from'] ?? '')) ?>">
</label>
<label class="form-field">
<span class="field-label"><?= $e($t('statistics.summary.filters.date_to')) ?></span>
<input class="form-control" type="date" name="date_to" value="<?= $e((string) ($filters['date_to'] ?? '')) ?>">
</label>
<label class="form-field">
<span class="field-label"><?= $e($t('statistics.summary.filters.channels')) ?></span>
<select class="form-control statistics-orders-multiselect js-checkbox-multiselect"
name="channels[]"
multiple
size="6"
data-checkbox-multiselect
data-all-label="Wszystkie"
data-empty-label="Nic nie wybrano"
data-selected-label-singular="zaznaczono"
data-selected-label-plural="zaznaczono">
<?php foreach ($channelOptions as $channelOption): ?>
<?php
$key = (string) ($channelOption['key'] ?? '');
$label = (string) ($channelOption['label'] ?? $key);
if ($key === '') {
continue;
}
?>
<option value="<?= $e($key) ?>"<?= in_array($key, $selectedChannels, true) ? ' selected' : '' ?>>
<?= $e($label) ?>
</option>
<?php endforeach; ?>
</select>
</label>
<label class="form-field">
<span class="field-label"><?= $e($t('statistics.summary.filters.status_groups')) ?></span>
<select class="form-control statistics-orders-multiselect js-checkbox-multiselect"
name="status_groups[]"
multiple
size="6"
data-checkbox-multiselect
data-all-label="Wszystkie"
data-empty-label="Nic nie wybrano"
data-selected-label-singular="zaznaczono"
data-selected-label-plural="zaznaczono">
<?php foreach ($statusGroupOptions as $groupOption): ?>
<?php
$groupId = (int) ($groupOption['id'] ?? 0);
$groupName = (string) ($groupOption['name'] ?? '');
if ($groupId <= 0) {
continue;
}
?>
<option value="<?= $e((string) $groupId) ?>"<?= in_array($groupId, $selectedStatusGroups, true) ? ' selected' : '' ?>>
<?= $e($groupName) ?>
</option>
<?php endforeach; ?>
</select>
</label>
<div class="form-field statistics-orders-filters__actions">
<span class="field-label">&nbsp;</span>
<div class="filters-actions">
<button type="submit" class="btn btn--primary"><?= $e($t('statistics.summary.actions.apply_filters')) ?></button>
<a href="/statistics/summary" class="btn btn--secondary"><?= $e($t('statistics.summary.actions.reset_filters')) ?></a>
</div>
</div>
</form>
</section>
<section class="statistics-summary-section mt-16">
<?php if (!$hasData): ?>
<div class="card statistics-summary-card">
<p class="muted"><?= $e($t('statistics.summary.empty')) ?></p>
</div>
<?php else: ?>
<div class="statistics-summary-chart-grid">
<article class="card statistics-summary-card">
<div class="statistics-summary-card__head">
<h3 class="section-title"><?= $e($t('statistics.summary.charts.orders_count')) ?></h3>
</div>
<div class="statistics-summary-chart" data-statistics-chart="count">
<canvas aria-label="<?= $e($t('statistics.summary.charts.orders_count')) ?>"></canvas>
</div>
</article>
<article class="card statistics-summary-card">
<div class="statistics-summary-card__head">
<h3 class="section-title"><?= $e($t('statistics.summary.charts.orders_value')) ?></h3>
</div>
<div class="statistics-summary-chart" data-statistics-chart="value">
<canvas aria-label="<?= $e($t('statistics.summary.charts.orders_value')) ?>"></canvas>
</div>
</article>
</div>
<div class="statistics-summary-table-grid mt-16">
<article class="card statistics-summary-card">
<div class="statistics-summary-card__head">
<h3 class="section-title"><?= $e($t('statistics.summary.charts.orders_count')) ?></h3>
</div>
<div class="table-wrap statistics-summary-fallback">
<table class="table statistics-summary-table">
<thead>
<tr>
<th><?= $e($t('statistics.summary.columns.month')) ?></th>
<?php foreach ($countChart['series'] ?? [] as $series): ?>
<th><?= $e((string) ($series['label'] ?? '')) ?></th>
<?php endforeach; ?>
</tr>
</thead>
<tbody>
<?php foreach ($rows as $rowIndex => $row): ?>
<tr>
<td><?= $e($displayMonth((string) ($row['month'] ?? ''))) ?></td>
<?php foreach ($countChart['series'] ?? [] as $series): ?>
<?php $values = is_array($series['values'] ?? null) ? $series['values'] : []; ?>
<td><?= $e((string) ((int) ($values[$rowIndex] ?? 0))) ?></td>
<?php endforeach; ?>
</tr>
<?php endforeach; ?>
</tbody>
</table>
</div>
</article>
<article class="card statistics-summary-card">
<div class="statistics-summary-card__head">
<h3 class="section-title"><?= $e($t('statistics.summary.charts.orders_value')) ?></h3>
</div>
<div class="table-wrap statistics-summary-fallback">
<table class="table statistics-summary-table">
<thead>
<tr>
<th><?= $e($t('statistics.summary.columns.month')) ?></th>
<?php foreach ($valueChart['series'] ?? [] as $series): ?>
<th><?= $e((string) ($series['label'] ?? '')) ?></th>
<?php endforeach; ?>
</tr>
</thead>
<tbody>
<?php foreach ($rows as $rowIndex => $row): ?>
<tr>
<td><?= $e($displayMonth((string) ($row['month'] ?? ''))) ?></td>
<?php foreach ($valueChart['series'] ?? [] as $series): ?>
<?php $values = is_array($series['values'] ?? null) ? $series['values'] : []; ?>
<td><?= $e(number_format((float) ($values[$rowIndex] ?? 0), 2, '.', ' ')) ?></td>
<?php endforeach; ?>
</tr>
<?php endforeach; ?>
</tbody>
</table>
</div>
</article>
</div>
<?php endif; ?>
</section>
<script type="application/json" id="js-statistics-summary-data"><?= $chartJson ?></script>