From df24da8915c7a033f27f82d147bee7870b9b586b Mon Sep 17 00:00:00 2001
From: Jacek Pyziak <jacek.pyziak@project-pro.pl>
Date: Sun, 15 Feb 2026 15:03:24 +0100
Subject: [PATCH] ver. 0.274 - ShopClients Domain+DI migration

---
 .../shop-clients/clients-details.php          |  53 +---
 admin/templates/shop-clients/view-list.php    |  84 +-----
 admin/templates/site/main-layout.php          |   2 +-
 autoload/Domain/Client/ClientRepository.php   | 250 ++++++++++++++++++
 .../Controllers/ShopClientsController.php     | 222 ++++++++++++++++
 autoload/admin/class.Site.php                 |   7 +
 autoload/admin/controls/class.ShopClients.php |  28 --
 autoload/admin/factory/class.ShopClients.php  |  17 --
 docs/CHANGELOG.md                             |  10 +-
 docs/DATABASE_STRUCTURE.md                    |  22 ++
 docs/PROJECT_STRUCTURE.md                     |   7 +
 docs/REFACTORING_PLAN.md                      |   7 +-
 docs/TESTING.md                               |   9 +
 .../Domain/Client/ClientRepositoryTest.php    | 134 ++++++++++
 .../Controllers/ShopClientsControllerTest.php |  56 ++++
 updates/0.20/ver_0.274.zip                    | Bin 0 -> 13351 bytes
 updates/0.20/ver_0.274_files.txt              |   2 +
 updates/changelog.php                         |   8 +
 updates/versions.php                          |   2 +-
 19 files changed, 740 insertions(+), 180 deletions(-)
 create mode 100644 autoload/Domain/Client/ClientRepository.php
 create mode 100644 autoload/admin/Controllers/ShopClientsController.php
 delete mode 100644 autoload/admin/controls/class.ShopClients.php
 delete mode 100644 autoload/admin/factory/class.ShopClients.php
 create mode 100644 tests/Unit/Domain/Client/ClientRepositoryTest.php
 create mode 100644 tests/Unit/admin/Controllers/ShopClientsControllerTest.php
 create mode 100644 updates/0.20/ver_0.274.zip
 create mode 100644 updates/0.20/ver_0.274_files.txt

diff --git a/admin/templates/shop-clients/clients-details.php b/admin/templates/shop-clients/clients-details.php
index 8c0edb7..6028434 100644
--- a/admin/templates/shop-clients/clients-details.php
+++ b/admin/templates/shop-clients/clients-details.php
@@ -1,48 +1,9 @@
-<div class="site-title"><?php echo $this->name . ' ' . $this->surname; ?></div>
-<div class="site-subtitle">Łączne zakupy w wysokości: <?php echo $this->total_spent; ?> zł</div>
+<div class="site-title"><?= htmlspecialchars($this->name . ' ' . $this->surname, ENT_QUOTES, 'UTF-8'); ?></div>
+<div class="site-subtitle">
+  Łączne zakupy: <?= number_format((float)$this->total_spent, 2, '.', ' '); ?> zl,
+  liczba zamówień: <?= (int)$this->total_orders; ?>
+</div>
 
-<br/>
+<br />
 
-<?
-global $gdb;
-$grid = new \grid( 'pp_shop_orders' );
-$grid -> gdb_opt = $gdb;
-
-$grid->src = $this->orders_info;
-
-$grid -> debug = true;
-$grid -> order = [ 'column' => 'date_order', 'type' => 'DESC' ];
-$grid -> search = [];
-$grid -> columns_view = [
-    [
-        'name' => 'Lp.',
-        'th' => [ 'class' => 'g-lp' ],
-        'td' => [ 'class' => 'g-center' ],
-        'autoincrement' => true
-    ], [
-        'name' => 'Data zamówienia',
-        'db'   => 'date_order',
-        'td'   => [ 'class' => 'g-center' ],
-        'th'   => [ 'class' => 'g-center', 'style' => 'width: 175px;' ],
-    ], [
-        'name' => 'Wartość',
-        'db'   => 'summary',
-        'td'   => [ 'class' => 'g-right' ],
-        'th'   => [ 'class' => 'g-right', 'style' => 'width: 150px;' ],
-        'php'  => 'echo number_format( "[summary]", 2, ".", " " ) . " zł";',
-    ], [
-        'name' => 'Typ płatności',
-        'db'   => 'payment_method',
-        'th'   => [ 'style' => 'width: 350px;' ],
-    ], [
-        'name' => 'Rodzaj transportu',
-        'db'   => 'transport',
-        'th'   => [ 'style' => 'width: 350px;' ],
-    ], [
-      'name' => 'Wiadomość',
-      'db'   => 'message',
-    ],
-];
-
-echo $grid -> draw();
-?>
\ No newline at end of file
+<?= \Tpl::view('components/table-list', ['list' => $this->ordersTable]); ?>
\ No newline at end of file
diff --git a/admin/templates/shop-clients/view-list.php b/admin/templates/shop-clients/view-list.php
index 85800c6..e5f9b0c 100644
--- a/admin/templates/shop-clients/view-list.php
+++ b/admin/templates/shop-clients/view-list.php
@@ -1,84 +1,2 @@
 <div class="site-title">Lista klientów</div>
-<?php
-global $gdb;
-
-$grid = new \grid( '__shop_clients' );
-$grid -> gdb_opt = $gdb;
-
-$grid->sql = "
-    SELECT
-      MAX( client_id ) AS client_id, client_name, client_surname, client_email, MAX( client_phone ) AS client_phone, MAX( client_city ) AS client_city, COUNT(*) AS total_orders, SUM(summary) AS total_spent,
-        CASE
-          WHEN MAX(client_id) IS NOT NULL
-            THEN 'Zarejestrowany'
-          ELSE
-            'Gość'
-        END AS client_type
-    FROM pp_shop_orders
-    WHERE client_name IS NOT NULL AND client_surname IS NOT NULL AND client_email IS NOT NULL
-    GROUP BY client_name, client_surname, client_email
-    ORDER BY
-        CASE
-          WHEN MAX(client_id) IS NOT NULL THEN 1
-          ELSE 2
-        END,
-          client_name ASC";
-$grid -> sql_count = "
-    SELECT COUNT(*)
-    FROM ( SELECT client_name, client_surname, client_email
-        FROM pp_shop_orders
-        WHERE client_name IS NOT NULL AND client_surname IS NOT NULL AND client_email IS NOT NULL
-        GROUP BY client_name, client_surname, client_email
-    ) AS unique_clients";
-
-$grid -> order = [ 'column' => 'date_order', 'type' => 'DESC' ];
-$grid -> search = [];
-$grid -> columns_view = [
-    [
-      'name' => 'Lp.',
-      'th' => [ 'class' => 'g-lp' ],
-      'td' => [ 'class' => 'g-center' ],
-      'autoincrement' => true
-    ], [
-      'name' => 'Typ klienta',
-      'db'   => 'client_type',
-      'td'   => [ 'class' => 'g-center' ],
-      'th'   => [ 'class' => 'g-center', 'style' => 'width: 100px;' ],
-    ], [
-      'name' => 'Nazwisko, imię',
-      'th'   => [ 'style' => 'width: 225px;' ],
-      'php'  => 'echo "[client_surname]" . " " . "[client_name]";',
-    ], [
-      'name' => 'Email',
-      'db'   => 'client_email',
-      'th'   => [ 'style' => 'width: 150px;' ],
-    ],
-    [
-      'name' => 'Telefon',
-      'db'   => 'client_phone',
-      'th'   => [ 'style' => 'width: 150px;' ],
-    ], [
-      'name' => 'Miasto',
-      'db'   => 'client_city',
-      'th'   => [ 'style' => 'width: 150px;' ],
-    ], [
-      'name' => 'Wartość zamówień',
-      'db'   => 'total_spent',
-      'td'   => [ 'class' => 'g-right' ],
-      'th'   => [ 'class' => 'g-right', 'style' => 'width: 150px;' ],
-      'php'  => 'echo number_format( "[total_spent]", 2, ".", " " ) . " zł";',
-    ], [
-      'name' => 'Ilosc zamówień',
-      'db'   => 'total_orders',
-      'td'   => [ 'class' => 'g-center' ],
-      'th'   => [ 'class' => 'g-center', 'style' => 'width: 150px;' ],
-      'php' => 'echo "<a href=\'/admin/shop_clients/clients_details/?name=[client_name]&surname=[client_surname]&email=[client_email]&total_spent=[total_spent]\'>[total_orders]</a>";'
-    ], [
-      'name' => 'Akcje',
-      'th'   => [ 'class' => 'g-center', 'style' => 'width: 100px;' ],
-      'td'   => [ 'class' => 'g-center' ],
-      'php'  => 'echo "<a href=\'/admin/shop_clients/clients_details/?name=[client_name]&surname=[client_surname]&email=[client_email]&total_spent=[total_spent]\'>zobacz zamówienia</a>";',
-    ]
-];
-
-echo $grid -> draw();
\ No newline at end of file
+<?= \Tpl::view('components/table-list', ['list' => $this->viewModel]); ?>
\ No newline at end of file
diff --git a/admin/templates/site/main-layout.php b/admin/templates/site/main-layout.php
index ef7f00f..c8f92f0 100644
--- a/admin/templates/site/main-layout.php
+++ b/admin/templates/site/main-layout.php
@@ -55,7 +55,7 @@
           </div>
           <ul>
             <li> <a href="/admin/shop_order/view_list/"><img src="/admin/layout/icon/icon-menu/shopping-cart.svg">Zam&#243;wienia</a></li>
-            <li> <a href="/admin/shop_clients/view_list/"><img src="/admin/layout/icon/icon-menu/people-fill.svg">Klienci</a></li>
+            <li> <a href="/admin/shop_clients/list/"><img src="/admin/layout/icon/icon-menu/people-fill.svg">Klienci</a></li>
             <li><a href="/admin/shop_category/view_list/"><img src="/admin/layout/icon/icon-menu/bxs-category-alt.svg">Kategorie</a></li>
             <li><a  href="/admin/shop_product/view_list/"><img src="/admin/layout/icon/icon-menu/shopping-basket.svg">Produkty</a></li>
             <li><a href="/admin/shop_product/mass_edit/"><i class="fa fa-bars"></i>Masowa edycja</a></li>
diff --git a/autoload/Domain/Client/ClientRepository.php b/autoload/Domain/Client/ClientRepository.php
new file mode 100644
index 0000000..eefb72c
--- /dev/null
+++ b/autoload/Domain/Client/ClientRepository.php
@@ -0,0 +1,250 @@
+<?php
+namespace Domain\Client;
+
+class ClientRepository
+{
+    private const MAX_PER_PAGE = 100;
+
+    private $db;
+
+    public function __construct($db)
+    {
+        $this->db = $db;
+    }
+
+    /**
+     * @return array{items: array<int, array<string, mixed>>, total: int}
+     */
+    public function listForAdmin(
+        array $filters,
+        string $sortColumn = 'client_surname',
+        string $sortDir = 'ASC',
+        int $page = 1,
+        int $perPage = 15
+    ): array {
+        $allowedSortColumns = [
+            'client_name' => 'c.client_name',
+            'client_surname' => 'c.client_surname',
+            'client_email' => 'c.client_email',
+            'client_phone' => 'c.client_phone',
+            'client_city' => 'c.client_city',
+            'total_orders' => 'c.total_orders',
+            'total_spent' => 'c.total_spent',
+            'client_type' => 'c.is_registered',
+        ];
+
+        $sortSql = $allowedSortColumns[$sortColumn] ?? 'c.client_surname';
+        $sortDir = strtoupper(trim($sortDir)) === 'DESC' ? 'DESC' : 'ASC';
+        $page = max(1, $page);
+        $perPage = min(self::MAX_PER_PAGE, max(1, $perPage));
+        $offset = ($page - 1) * $perPage;
+
+        $where = [
+            'o.client_name IS NOT NULL',
+            'o.client_surname IS NOT NULL',
+            'o.client_email IS NOT NULL',
+        ];
+        $params = [];
+
+        $name = $this->normalizeTextFilter($filters['name'] ?? '');
+        if ($name !== '') {
+            $where[] = 'o.client_name LIKE :name';
+            $params[':name'] = '%' . $name . '%';
+        }
+
+        $surname = $this->normalizeTextFilter($filters['surname'] ?? '');
+        if ($surname !== '') {
+            $where[] = 'o.client_surname LIKE :surname';
+            $params[':surname'] = '%' . $surname . '%';
+        }
+
+        $email = $this->normalizeTextFilter($filters['email'] ?? '');
+        if ($email !== '') {
+            $where[] = 'o.client_email LIKE :email';
+            $params[':email'] = '%' . $email . '%';
+        }
+
+        $clientType = trim((string)($filters['client_type'] ?? ''));
+        if ($clientType === 'registered') {
+            $where[] = 'o.client_id IS NOT NULL';
+        } elseif ($clientType === 'guest') {
+            $where[] = 'o.client_id IS NULL';
+        }
+
+        $whereSql = implode(' AND ', $where);
+
+        $aggregatedSql = "
+            SELECT
+                MAX(o.client_id) AS client_id,
+                o.client_name,
+                o.client_surname,
+                o.client_email,
+                MAX(o.client_phone) AS client_phone,
+                MAX(o.client_city) AS client_city,
+                COUNT(*) AS total_orders,
+                COALESCE(SUM(o.summary), 0) AS total_spent,
+                CASE
+                    WHEN MAX(o.client_id) IS NOT NULL THEN 1
+                    ELSE 0
+                END AS is_registered
+            FROM pp_shop_orders AS o
+            WHERE {$whereSql}
+            GROUP BY o.client_name, o.client_surname, o.client_email
+        ";
+
+        $sqlCount = "
+            SELECT COUNT(0)
+            FROM ({$aggregatedSql}) AS c
+        ";
+
+        $stmtCount = $this->db->query($sqlCount, $params);
+        $countRows = $stmtCount ? $stmtCount->fetchAll() : [];
+        $total = isset($countRows[0][0]) ? (int)$countRows[0][0] : 0;
+
+        $sql = "
+            SELECT
+                c.client_id,
+                c.client_name,
+                c.client_surname,
+                c.client_email,
+                c.client_phone,
+                c.client_city,
+                c.total_orders,
+                c.total_spent,
+                c.is_registered
+            FROM ({$aggregatedSql}) AS c
+            ORDER BY {$sortSql} {$sortDir}, c.client_surname ASC, c.client_name ASC
+            LIMIT {$perPage} OFFSET {$offset}
+        ";
+
+        $stmt = $this->db->query($sql, $params);
+        $items = $stmt ? $stmt->fetchAll() : [];
+
+        if (!is_array($items)) {
+            $items = [];
+        }
+
+        foreach ($items as &$item) {
+            $item['client_id'] = !isset($item['client_id']) ? null : (int)$item['client_id'];
+            $item['client_name'] = (string)($item['client_name'] ?? '');
+            $item['client_surname'] = (string)($item['client_surname'] ?? '');
+            $item['client_email'] = (string)($item['client_email'] ?? '');
+            $item['client_phone'] = (string)($item['client_phone'] ?? '');
+            $item['client_city'] = (string)($item['client_city'] ?? '');
+            $item['total_orders'] = (int)($item['total_orders'] ?? 0);
+            $item['total_spent'] = (float)($item['total_spent'] ?? 0);
+            $item['is_registered'] = ((int)($item['is_registered'] ?? 0)) === 1 ? 1 : 0;
+        }
+        unset($item);
+
+        return [
+            'items' => $items,
+            'total' => $total,
+        ];
+    }
+
+    /**
+     * @return array<int, array<string, mixed>>
+     */
+    public function ordersForClient(string $name, string $surname, string $email): array
+    {
+        $name = trim($name);
+        $surname = trim($surname);
+        $email = trim($email);
+
+        if ($name === '' || $surname === '' || $email === '') {
+            return [];
+        }
+
+        $sql = "
+            SELECT
+                o.id,
+                o.date_order,
+                o.summary,
+                o.payment_method,
+                o.transport,
+                o.message
+            FROM pp_shop_orders AS o
+            WHERE o.client_name = :name
+                AND o.client_surname = :surname
+                AND o.client_email = :email
+            ORDER BY o.date_order DESC, o.id DESC
+        ";
+
+        $stmt = $this->db->query($sql, [
+            ':name' => $name,
+            ':surname' => $surname,
+            ':email' => $email,
+        ]);
+
+        $rows = $stmt ? $stmt->fetchAll() : [];
+        if (!is_array($rows)) {
+            return [];
+        }
+
+        foreach ($rows as &$row) {
+            $row['id'] = (int)($row['id'] ?? 0);
+            $row['date_order'] = (string)($row['date_order'] ?? '');
+            $row['summary'] = (float)($row['summary'] ?? 0);
+            $row['payment_method'] = (string)($row['payment_method'] ?? '');
+            $row['transport'] = (string)($row['transport'] ?? '');
+            $row['message'] = (string)($row['message'] ?? '');
+        }
+        unset($row);
+
+        return $rows;
+    }
+
+    /**
+     * @return array{total_orders: int, total_spent: float}
+     */
+    public function totalsForClient(string $name, string $surname, string $email): array
+    {
+        $name = trim($name);
+        $surname = trim($surname);
+        $email = trim($email);
+
+        if ($name === '' || $surname === '' || $email === '') {
+            return [
+                'total_orders' => 0,
+                'total_spent' => 0.0,
+            ];
+        }
+
+        $sql = "
+            SELECT
+                COUNT(*) AS total_orders,
+                COALESCE(SUM(o.summary), 0) AS total_spent
+            FROM pp_shop_orders AS o
+            WHERE o.client_name = :name
+                AND o.client_surname = :surname
+                AND o.client_email = :email
+        ";
+
+        $stmt = $this->db->query($sql, [
+            ':name' => $name,
+            ':surname' => $surname,
+            ':email' => $email,
+        ]);
+        $rows = $stmt ? $stmt->fetchAll() : [];
+
+        return [
+            'total_orders' => isset($rows[0]['total_orders']) ? (int)$rows[0]['total_orders'] : 0,
+            'total_spent' => isset($rows[0]['total_spent']) ? (float)$rows[0]['total_spent'] : 0.0,
+        ];
+    }
+
+    private function normalizeTextFilter($value): string
+    {
+        $value = trim((string)$value);
+        if ($value === '') {
+            return '';
+        }
+
+        if (strlen($value) > 255) {
+            return substr($value, 0, 255);
+        }
+
+        return $value;
+    }
+}
diff --git a/autoload/admin/Controllers/ShopClientsController.php b/autoload/admin/Controllers/ShopClientsController.php
new file mode 100644
index 0000000..08d3ac4
--- /dev/null
+++ b/autoload/admin/Controllers/ShopClientsController.php
@@ -0,0 +1,222 @@
+<?php
+namespace admin\Controllers;
+
+use Domain\Client\ClientRepository;
+use admin\ViewModels\Common\PaginatedTableViewModel;
+
+class ShopClientsController
+{
+    private ClientRepository $repository;
+
+    public function __construct(ClientRepository $repository)
+    {
+        $this->repository = $repository;
+    }
+
+    public function list(): string
+    {
+        $sortableColumns = [
+            'client_name',
+            'client_surname',
+            'client_email',
+            'client_phone',
+            'client_city',
+            'total_orders',
+            'total_spent',
+            'client_type',
+        ];
+
+        $filterDefinitions = [
+            [
+                'key' => 'name',
+                'label' => 'Imie',
+                'type' => 'text',
+            ],
+            [
+                'key' => 'surname',
+                'label' => 'Nazwisko',
+                'type' => 'text',
+            ],
+            [
+                'key' => 'email',
+                'label' => 'E-mail',
+                'type' => 'text',
+            ],
+            [
+                'key' => 'client_type',
+                'label' => 'Typ klienta',
+                'type' => 'select',
+                'options' => [
+                    '' => '- typ klienta -',
+                    'registered' => 'Zarejestrowany',
+                    'guest' => 'Gosc',
+                ],
+            ],
+        ];
+
+        $listRequest = \admin\Support\TableListRequestFactory::fromRequest(
+            $filterDefinitions,
+            $sortableColumns,
+            'client_surname'
+        );
+
+        $sortDir = $listRequest['sortDir'];
+        if (trim((string)\S::get('sort')) === '') {
+            $sortDir = 'ASC';
+        }
+
+        $result = $this->repository->listForAdmin(
+            $listRequest['filters'],
+            $listRequest['sortColumn'],
+            $sortDir,
+            $listRequest['page'],
+            $listRequest['perPage']
+        );
+
+        $rows = [];
+        $lp = ($listRequest['page'] - 1) * $listRequest['perPage'] + 1;
+
+        foreach ($result['items'] as $item) {
+            $name = trim((string)($item['client_name'] ?? ''));
+            $surname = trim((string)($item['client_surname'] ?? ''));
+            $email = trim((string)($item['client_email'] ?? ''));
+            $params = [
+                'name' => $name,
+                'surname' => $surname,
+                'email' => $email,
+            ];
+            $detailsUrl = '/admin/shop_clients/details/?' . http_build_query($params);
+
+            $rows[] = [
+                'lp' => $lp++ . '.',
+                'client_type' => ((int)($item['is_registered'] ?? 0) === 1) ? 'Zarejestrowany' : 'Gosc',
+                'full_name' => htmlspecialchars($surname, ENT_QUOTES, 'UTF-8') . ' ' . htmlspecialchars($name, ENT_QUOTES, 'UTF-8'),
+                'client_email' => $email,
+                'client_phone' => (string)($item['client_phone'] ?? ''),
+                'client_city' => (string)($item['client_city'] ?? ''),
+                'total_spent' => number_format((float)($item['total_spent'] ?? 0), 2, '.', ' ') . ' zl',
+                'total_orders' => '<a href="' . htmlspecialchars($detailsUrl, ENT_QUOTES, 'UTF-8') . '">' . (int)($item['total_orders'] ?? 0) . '</a>',
+                '_actions' => [
+                    [
+                        'label' => 'Zobacz zamowienia',
+                        'url' => $detailsUrl,
+                        'class' => 'btn btn-xs btn-primary',
+                    ],
+                ],
+            ];
+        }
+
+        $total = (int)$result['total'];
+        $totalPages = max(1, (int)ceil($total / $listRequest['perPage']));
+
+        $viewModel = new PaginatedTableViewModel(
+            [
+                ['key' => 'lp', 'label' => 'Lp.', 'class' => 'text-center', 'sortable' => false],
+                ['key' => 'client_type', 'sort_key' => 'client_type', 'label' => 'Typ klienta', 'class' => 'text-center', 'sortable' => true],
+                ['key' => 'full_name', 'label' => 'Nazwisko, imie', 'sortable' => false, 'raw' => true],
+                ['key' => 'client_email', 'sort_key' => 'client_email', 'label' => 'Email', 'sortable' => true],
+                ['key' => 'client_phone', 'sort_key' => 'client_phone', 'label' => 'Telefon', 'sortable' => true],
+                ['key' => 'client_city', 'sort_key' => 'client_city', 'label' => 'Miasto', 'sortable' => true],
+                ['key' => 'total_spent', 'sort_key' => 'total_spent', 'label' => 'Wartosc zamowien', 'class' => 'text-right', 'sortable' => true],
+                ['key' => 'total_orders', 'sort_key' => 'total_orders', 'label' => 'Ilosc zamowien', 'class' => 'text-center', 'sortable' => true, 'raw' => true],
+            ],
+            $rows,
+            $listRequest['viewFilters'],
+            [
+                'column' => $listRequest['sortColumn'],
+                'dir' => $sortDir,
+            ],
+            [
+                'page' => $listRequest['page'],
+                'per_page' => $listRequest['perPage'],
+                'total' => $total,
+                'total_pages' => $totalPages,
+            ],
+            array_merge($listRequest['queryFilters'], [
+                'sort' => $listRequest['sortColumn'],
+                'dir' => $sortDir,
+                'per_page' => $listRequest['perPage'],
+            ]),
+            $listRequest['perPageOptions'],
+            $sortableColumns,
+            '/admin/shop_clients/list/',
+            'Brak danych w tabeli.'
+        );
+
+        return \Tpl::view('shop-clients/view-list', [
+            'viewModel' => $viewModel,
+        ]);
+    }
+
+    public function view_list(): string
+    {
+        return $this->list();
+    }
+
+    public function details(): string
+    {
+        $name = (string)\S::get('name');
+        $surname = (string)\S::get('surname');
+        $email = (string)\S::get('email');
+
+        $ordersInfo = $this->repository->ordersForClient($name, $surname, $email);
+        $totals = $this->repository->totalsForClient($name, $surname, $email);
+
+        $rows = [];
+        $lp = 1;
+        foreach ($ordersInfo as $order) {
+            $rows[] = [
+                'lp' => $lp++ . '.',
+                'date_order' => (string)($order['date_order'] ?? ''),
+                'summary' => number_format((float)($order['summary'] ?? 0), 2, '.', ' ') . ' zl',
+                'payment_method' => (string)($order['payment_method'] ?? ''),
+                'transport' => (string)($order['transport'] ?? ''),
+                'message' => (string)($order['message'] ?? ''),
+                '_actions' => [],
+            ];
+        }
+
+        $ordersTable = new PaginatedTableViewModel(
+            [
+                ['key' => 'lp', 'label' => 'Lp.', 'class' => 'text-center', 'sortable' => false],
+                ['key' => 'date_order', 'label' => 'Data zamowienia', 'class' => 'text-center', 'sortable' => false],
+                ['key' => 'summary', 'label' => 'Wartosc', 'class' => 'text-right', 'sortable' => false],
+                ['key' => 'payment_method', 'label' => 'Typ platnosci', 'sortable' => false],
+                ['key' => 'transport', 'label' => 'Rodzaj transportu', 'sortable' => false],
+                ['key' => 'message', 'label' => 'Wiadomosc', 'sortable' => false],
+            ],
+            $rows,
+            [],
+            [],
+            [
+                'page' => 1,
+                'per_page' => max(1, count($rows)),
+                'total' => count($rows),
+                'total_pages' => 1,
+            ],
+            [],
+            [count($rows) > 0 ? count($rows) : 1],
+            [],
+            '/admin/shop_clients/details/?' . http_build_query([
+                'name' => $name,
+                'surname' => $surname,
+                'email' => $email,
+            ]),
+            'Brak zamowien klienta.'
+        );
+
+        return \Tpl::view('shop-clients/clients-details', [
+            'name' => $name,
+            'surname' => $surname,
+            'email' => $email,
+            'total_spent' => $totals['total_spent'],
+            'ordersTable' => $ordersTable,
+            'total_orders' => $totals['total_orders'],
+        ]);
+    }
+
+    public function clients_details(): string
+    {
+        return $this->details();
+    }
+}
diff --git a/autoload/admin/class.Site.php b/autoload/admin/class.Site.php
index 464f24d..67c8ba2 100644
--- a/autoload/admin/class.Site.php
+++ b/autoload/admin/class.Site.php
@@ -384,6 +384,13 @@ class Site
           new \Domain\Product\ProductRepository( $mdb )
         );
       },
+      'ShopClients' => function() {
+        global $mdb;
+
+        return new \admin\Controllers\ShopClientsController(
+          new \Domain\Client\ClientRepository( $mdb )
+        );
+      },
     ];
 
     return self::$newControllers;
diff --git a/autoload/admin/controls/class.ShopClients.php b/autoload/admin/controls/class.ShopClients.php
deleted file mode 100644
index 3ef3fe1..0000000
--- a/autoload/admin/controls/class.ShopClients.php
+++ /dev/null
@@ -1,28 +0,0 @@
-<?php
-namespace admin\controls;
-class ShopClients
-{
-  public static function view_list()
-  {
-    return \Tpl::view(
-        'shop-clients/view-list'
-    );
-  }
-
-  public static function clients_details()
-  {
-    $query_string = $_SERVER['REDIRECT_QUERY_STRING'];
-    parse_str($query_string, $query_array);
-
-    $orders_info = \admin\factory\ShopClients::get_order_all_info( $query_array['name'], $query_array['surname'], $query_array['email'] );
-
-    return \Tpl::view('shop-clients/clients-details', [
-      'name' => $query_array['name'],
-      'surname' => $query_array['surname'],
-      'email' => $query_array['email'],
-      'total_spent' => $query_array['total_spent'],
-      'orders_info' => $orders_info
-    ]);
-  }
-}
-?>
\ No newline at end of file
diff --git a/autoload/admin/factory/class.ShopClients.php b/autoload/admin/factory/class.ShopClients.php
deleted file mode 100644
index 8019b64..0000000
--- a/autoload/admin/factory/class.ShopClients.php
+++ /dev/null
@@ -1,17 +0,0 @@
-<?php
-namespace admin\factory;
-class ShopClients
-{
-    public static function get_order_all_info($name, $surname, $email)
-    {
-        global $mdb;
-
-        $results = $mdb->select('pp_shop_orders', '*', [
-            'client_name' => $name,
-            'client_surname' => $surname,
-            'client_email' => $email
-        ]);
-
-        return $results;}
-}
-?>
\ No newline at end of file
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index c6f6919..2319fa8 100644
--- a/docs/CHANGELOG.md
+++ b/docs/CHANGELOG.md
@@ -19,11 +19,19 @@ Logi zmian z migracji na Domain-Driven Architecture. Najnowsze na gorze.
 - **Pages / Articles UI** - ujednolicenie drzewek
   - UPDATE: `/admin/pages/list/` - nowe strzalki drzewa + `aria-expanded` + odswiezanie stanu branch/leaf
   - UPDATE: `/admin/articles/edit/*` (zakladka wyswietlania) - nowe strzalki i checkboxy (iCheck) dla drzewka stron
+- **ShopClients** - migracja `/admin/shop_clients` na Domain + DI + nowe widoki
+  - NOWE: `Domain\Client\ClientRepository` (`listForAdmin`, `ordersForClient`, `totalsForClient`)
+  - NOWE: `admin\Controllers\ShopClientsController` (DI) z akcjami `list`, `details` + aliasy legacy `view_list`, `clients_details`
+  - UPDATE: routing DI (`admin\Site`) rozszerzony o modul `ShopClients`
+  - UPDATE: menu admin przepiete na kanoniczny URL `/admin/shop_clients/list/`
+  - UPDATE: widoki `shop-clients/view-list` i `shop-clients/clients-details` przepiete na `components/table-list`
+  - CLEANUP: usuniete legacy `autoload/admin/controls/class.ShopClients.php`, `autoload/admin/factory/class.ShopClients.php`
 - TEST:
   - NOWE: `tests/Unit/admin/Controllers/ShopProductControllerTest.php`
+  - NOWE: `tests/Unit/Domain/Client/ClientRepositoryTest.php`, `tests/Unit/admin/Controllers/ShopClientsControllerTest.php`
   - UPDATE: `tests/Unit/Domain/Product/ProductRepositoryTest.php` (nowe przypadki dla mass_edit)
   - UPDATE: `tests/bootstrap.php` (stub `S::normalize_decimal()`)
-- Testy: **OK (351 tests, 1091 assertions)**
+- Testy: **OK (361 tests, 1125 assertions)**
 
 ---
 
diff --git a/docs/DATABASE_STRUCTURE.md b/docs/DATABASE_STRUCTURE.md
index 92698bc..a4986b3 100644
--- a/docs/DATABASE_STRUCTURE.md
+++ b/docs/DATABASE_STRUCTURE.md
@@ -57,6 +57,28 @@ Przypisanie produktów do kategorii.
 
 **Aktualizacja 2026-02-15 (ver. 0.274):** akcje `/admin/shop_product/mass_edit/*` korzystają z `Domain\Product\ProductRepository` przez `admin\Controllers\ShopProductController`.
 
+## pp_shop_orders
+Zamówienia sklepu (źródło danych dla list i szczegółów klientów w panelu admin).
+
+| Kolumna | Opis |
+|---------|------|
+| id | PK |
+| client_id | FK do `pp_shop_clients` (NULL dla gościa) |
+| client_name | Imię klienta z zamówienia |
+| client_surname | Nazwisko klienta z zamówienia |
+| client_email | E-mail klienta z zamówienia |
+| client_phone | Telefon klienta |
+| client_city | Miasto klienta |
+| summary | Wartość zamówienia |
+| date_order | Data złożenia zamówienia |
+| payment_method | Nazwa metody płatności |
+| transport | Nazwa transportu |
+| message | Wiadomość klienta |
+
+**Używane w:** `Domain\Client\ClientRepository::listForAdmin()`, `Domain\Client\ClientRepository::ordersForClient()`, `Domain\Client\ClientRepository::totalsForClient()`.
+
+**Aktualizacja 2026-02-15 (ver. 0.274):** moduł `/admin/shop_clients/*` korzysta z `Domain\Client\ClientRepository` przez `admin\Controllers\ShopClientsController`.
+
 ## pp_banners
 Banery.
 
diff --git a/docs/PROJECT_STRUCTURE.md b/docs/PROJECT_STRUCTURE.md
index 30eaba2..6f2c3e9 100644
--- a/docs/PROJECT_STRUCTURE.md
+++ b/docs/PROJECT_STRUCTURE.md
@@ -298,6 +298,13 @@ Pelna dokumentacja testow: `TESTING.md`
 
 ## Dodatkowa aktualizacja 2026-02-15 (ver. 0.273)
 - Dodano modul domenowy `Domain/Producer/ProducerRepository.php`.
+
+## Dodatkowa aktualizacja 2026-02-15 (ver. 0.274)
+- Dodano modul domenowy `Domain/Client/ClientRepository.php`.
+- Dodano kontroler DI `admin/Controllers/ShopClientsController.php`.
+- Modul `/admin/shop_clients/*` dziala na nowych widokach opartych o `components/table-list`.
+- Usunieto legacy: `autoload/admin/controls/class.ShopClients.php`, `autoload/admin/factory/class.ShopClients.php`.
+- Routing i menu admin przepiete na kanoniczny URL `/admin/shop_clients/list/`.
 - Dodano kontroler DI `admin/Controllers/ShopProducerController.php`.
 - Modul `/admin/shop_producer/*` dziala na nowych widokach (`producers-list`, `producer-edit`).
 - Usunieto legacy: `autoload/admin/controls/class.ShopProducer.php`, `admin/templates/shop-producer/list.php`, `admin/templates/shop-producer/edit.php`.
diff --git a/docs/REFACTORING_PLAN.md b/docs/REFACTORING_PLAN.md
index d5a304a..6016c0d 100644
--- a/docs/REFACTORING_PLAN.md
+++ b/docs/REFACTORING_PLAN.md
@@ -154,6 +154,7 @@ grep -r "Product::getQuantity" .
 | 23 | ShopProductSets | 0.272 | listForAdmin, find, save, delete, allSets, allProductsMap, multi-select Selectize, DI kontroler |
 | 24 | ShopProducer | 0.273 | listForAdmin, find, save, delete, allProducers, producerProducts, fasada shop\Producer, DI kontroler |
 | 25 | ShopProduct (mass_edit) | 0.274 | DI kontroler + routing dla `mass_edit`, `mass_edit_save`, `get_products_by_category`, cleanup legacy akcji |
+| 26 | ShopClients | 0.274 | DI kontroler + routing dla `list/details`, nowe listy na `components/table-list`, cleanup legacy controls/factory |
 
 ### Product - szczegolowy status
 - ✅ getQuantity (ver. 0.238)
@@ -174,11 +175,11 @@ grep -r "Product::getQuantity" .
 
 ## Kolejność refaktoryzacji (priorytet)
 
-1-25: ✅ Cache, Product, Banner, Settings, Dictionaries, ProductArchive, Filemanager, Users, Pages, Integrations, ShopPromotion, ShopCoupon, ShopStatuses, ShopPaymentMethod, ShopTransport, ShopAttribute, ShopProductSets, ShopProducer, ShopProduct (mass_edit)
+1-26: ✅ Cache, Product, Banner, Settings, Dictionaries, ProductArchive, Filemanager, Users, Pages, Integrations, ShopPromotion, ShopCoupon, ShopStatuses, ShopPaymentMethod, ShopTransport, ShopAttribute, ShopProductSets, ShopProducer, ShopProduct (mass_edit), ShopClients
 
 Nastepne:
-26. **Order**
-27. **Category**
+27. **Order**
+28. **Category**
 
 ## Form Edit System
 
diff --git a/docs/TESTING.md b/docs/TESTING.md
index ece1e28..911c00e 100644
--- a/docs/TESTING.md
+++ b/docs/TESTING.md
@@ -39,6 +39,15 @@ Ostatnio zweryfikowano: 2026-02-15
 OK (351 tests, 1091 assertions)
 ```
 
+Aktualizacja po migracji ShopClients (2026-02-15, ver. 0.274) - testy punktowe:
+```text
+OK (10 tests, 34 assertions)
+```
+
+Nowe testy dodane 2026-02-15:
+- `tests/Unit/Domain/Client/ClientRepositoryTest.php`
+- `tests/Unit/admin/Controllers/ShopClientsControllerTest.php`
+
 ## Struktura testow
 
 ```text
diff --git a/tests/Unit/Domain/Client/ClientRepositoryTest.php b/tests/Unit/Domain/Client/ClientRepositoryTest.php
new file mode 100644
index 0000000..f5981ad
--- /dev/null
+++ b/tests/Unit/Domain/Client/ClientRepositoryTest.php
@@ -0,0 +1,134 @@
+<?php
+namespace Tests\Unit\Domain\Client;
+
+use PHPUnit\Framework\TestCase;
+use Domain\Client\ClientRepository;
+
+class ClientRepositoryTest extends TestCase
+{
+    public function testListForAdminWhitelistsSortAndPagination(): void
+    {
+        $mockDb = $this->createMock(\medoo::class);
+        $queries = [];
+
+        $mockDb->method('query')
+            ->willReturnCallback(function ($sql, $params = []) use (&$queries) {
+                $queries[] = ['sql' => $sql, 'params' => $params];
+
+                if (strpos($sql, 'COUNT(0)') !== false) {
+                    return new class {
+                        public function fetchAll() { return [[1]]; }
+                    };
+                }
+
+                return new class {
+                    public function fetchAll() {
+                        return [[
+                            'client_id' => 5,
+                            'client_name' => 'Jan',
+                            'client_surname' => 'Kowalski',
+                            'client_email' => 'jan@example.com',
+                            'client_phone' => '123',
+                            'client_city' => 'Warszawa',
+                            'total_orders' => 3,
+                            'total_spent' => 199.99,
+                            'is_registered' => 1,
+                        ]];
+                    }
+                };
+            });
+
+        $repository = new ClientRepository($mockDb);
+        $result = $repository->listForAdmin(
+            [],
+            'client_name DESC; DROP TABLE pp_shop_orders; --',
+            'DESC; DELETE FROM pp_users; --',
+            1,
+            999
+        );
+
+        $this->assertCount(2, $queries);
+        $dataSql = $queries[1]['sql'];
+
+        $this->assertMatchesRegularExpression('/ORDER BY\s+c\.client_surname\s+ASC,\s+c\.client_surname\s+ASC,\s+c\.client_name\s+ASC/i', $dataSql);
+        $this->assertStringNotContainsString('DROP TABLE', $dataSql);
+        $this->assertMatchesRegularExpression('/LIMIT\s+100\s+OFFSET\s+0/i', $dataSql);
+
+        $this->assertSame(1, $result['total']);
+        $this->assertCount(1, $result['items']);
+        $this->assertSame('Jan', $result['items'][0]['client_name']);
+    }
+
+    public function testOrdersForClientReturnsEmptyOnMissingInput(): void
+    {
+        $mockDb = $this->createMock(\medoo::class);
+        $mockDb->expects($this->never())->method('query');
+
+        $repository = new ClientRepository($mockDb);
+
+        $this->assertSame([], $repository->ordersForClient('', 'Kowalski', 'jan@example.com'));
+        $this->assertSame([], $repository->ordersForClient('Jan', '', 'jan@example.com'));
+        $this->assertSame([], $repository->ordersForClient('Jan', 'Kowalski', ''));
+    }
+
+    public function testOrdersForClientNormalizesRows(): void
+    {
+        $mockDb = $this->createMock(\medoo::class);
+        $mockDb->expects($this->once())
+            ->method('query')
+            ->willReturn(new class {
+                public function fetchAll() {
+                    return [[
+                        'id' => '10',
+                        'date_order' => '2026-02-15 10:00:00',
+                        'summary' => '149.50',
+                        'payment_method' => 'Przelew',
+                        'transport' => 'Kurier',
+                        'message' => null,
+                    ]];
+                }
+            });
+
+        $repository = new ClientRepository($mockDb);
+        $rows = $repository->ordersForClient('Jan', 'Kowalski', 'jan@example.com');
+
+        $this->assertCount(1, $rows);
+        $this->assertSame(10, $rows[0]['id']);
+        $this->assertSame(149.50, $rows[0]['summary']);
+        $this->assertSame('Przelew', $rows[0]['payment_method']);
+        $this->assertSame('', $rows[0]['message']);
+    }
+
+    public function testTotalsForClientReturnsZeroForMissingInput(): void
+    {
+        $mockDb = $this->createMock(\medoo::class);
+        $mockDb->expects($this->never())->method('query');
+
+        $repository = new ClientRepository($mockDb);
+        $totals = $repository->totalsForClient('', 'Kowalski', 'jan@example.com');
+
+        $this->assertSame(0, $totals['total_orders']);
+        $this->assertSame(0.0, $totals['total_spent']);
+    }
+
+    public function testTotalsForClientReturnsAggregatedValues(): void
+    {
+        $mockDb = $this->createMock(\medoo::class);
+        $mockDb->expects($this->once())
+            ->method('query')
+            ->willReturn(new class {
+                public function fetchAll() {
+                    return [[
+                        'total_orders' => '4',
+                        'total_spent' => '456.78',
+                    ]];
+                }
+            });
+
+        $repository = new ClientRepository($mockDb);
+        $totals = $repository->totalsForClient('Jan', 'Kowalski', 'jan@example.com');
+
+        $this->assertSame(4, $totals['total_orders']);
+        $this->assertSame(456.78, $totals['total_spent']);
+    }
+}
diff --git a/tests/Unit/admin/Controllers/ShopClientsControllerTest.php b/tests/Unit/admin/Controllers/ShopClientsControllerTest.php
new file mode 100644
index 0000000..b1f7226
--- /dev/null
+++ b/tests/Unit/admin/Controllers/ShopClientsControllerTest.php
@@ -0,0 +1,56 @@
+<?php
+namespace Tests\Unit\admin\Controllers;
+
+use PHPUnit\Framework\TestCase;
+use admin\Controllers\ShopClientsController;
+use Domain\Client\ClientRepository;
+
+class ShopClientsControllerTest extends TestCase
+{
+    private $repository;
+    private $controller;
+
+    protected function setUp(): void
+    {
+        $this->repository = $this->createMock(ClientRepository::class);
+        $this->controller = new ShopClientsController($this->repository);
+    }
+
+    public function testConstructorAcceptsRepository(): void
+    {
+        $controller = new ShopClientsController($this->repository);
+        $this->assertInstanceOf(ShopClientsController::class, $controller);
+    }
+
+    public function testHasMainActionMethods(): void
+    {
+        $this->assertTrue(method_exists($this->controller, 'list'));
+        $this->assertTrue(method_exists($this->controller, 'details'));
+    }
+
+    public function testHasLegacyAliasMethods(): void
+    {
+        $this->assertTrue(method_exists($this->controller, 'view_list'));
+        $this->assertTrue(method_exists($this->controller, 'clients_details'));
+    }
+
+    public function testActionMethodReturnTypes(): void
+    {
+        $reflection = new \ReflectionClass($this->controller);
+
+        $this->assertEquals('string', (string)$reflection->getMethod('list')->getReturnType());
+        $this->assertEquals('string', (string)$reflection->getMethod('view_list')->getReturnType());
+        $this->assertEquals('string', (string)$reflection->getMethod('details')->getReturnType());
+        $this->assertEquals('string', (string)$reflection->getMethod('clients_details')->getReturnType());
+    }
+
+    public function testConstructorRequiresClientRepository(): void
+    {
+        $reflection = new \ReflectionClass(ShopClientsController::class);
+        $constructor = $reflection->getConstructor();
+        $params = $constructor->getParameters();
+
+        $this->assertCount(1, $params);
+        $this->assertEquals('Domain\\Client\\ClientRepository', $params[0]->getType()->getName());
+    }
+}
diff --git a/updates/0.20/ver_0.274.zip b/updates/0.20/ver_0.274.zip
new file mode 100644
index 0000000000000000000000000000000000000000..38fb33cd800655ac5e698d3ebd7281c541984aef
GIT binary patch
literal 13351
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%0AtXPz3|8PH{$ur^@j#VI3>wsXYH)MbdyDs$1M?<
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

literal 0
HcmV?d00001

diff --git a/updates/0.20/ver_0.274_files.txt b/updates/0.20/ver_0.274_files.txt
new file mode 100644
index 0000000..8326c1d
--- /dev/null
+++ b/updates/0.20/ver_0.274_files.txt
@@ -0,0 +1,2 @@
+F: ../autoload/admin/controls/class.ShopClients.php
+F: ../autoload/admin/factory/class.ShopClients.php
diff --git a/updates/changelog.php b/updates/changelog.php
index 1f3d23e..6ef340d 100644
--- a/updates/changelog.php
+++ b/updates/changelog.php
@@ -1,3 +1,11 @@
+<b>ver. 0.274 - 15.02.2026</b><br />
+- NEW - migracja modulu `ShopClients` do architektury Domain + DI (`Domain\Client\ClientRepository`, `admin\Controllers\ShopClientsController`)
+- UPDATE - modul `/admin/shop_clients/*` przepiety na `components/table-list` (lista klientow i szczegoly zamowien)
+- UPDATE - routing i menu admin przepiete na kanoniczny URL `/admin/shop_clients/list/`
+- CLEANUP - usuniete legacy klasy/pliki: `autoload/admin/controls/class.ShopClients.php`, `autoload/admin/factory/class.ShopClients.php`
+- UPDATE - testy: `OK (361 tests, 1125 assertions)`
+- UPDATE - pliki aktualizacji: `updates/0.20/ver_0.274.zip`, `ver_0.274_files.txt`
+<hr>
 <b>ver. 0.273 - 15.02.2026</b><br />
 - NEW - migracja `/admin/shop_product/mass_edit/*` do `Domain\Product\ProductRepository` + `admin\Controllers\ShopProductController` (DI + routing)
 - UPDATE - nowy widok/skrypt masowej edycji (`mass-edit`, `mass-edit-custom-script`) z iCheck i ujednoliconymi strzalkami drzewa
diff --git a/updates/versions.php b/updates/versions.php
index 22241a8..da37de0 100644
--- a/updates/versions.php
+++ b/updates/versions.php
@@ -1,5 +1,5 @@
 <?
-$current_ver = 273;
+$current_ver = 274;
 
 for ($i = 1; $i <= $current_ver; $i++)
 {