重构初始化

2026-04-28 21:14:32 +08:00 · 2026-04-15 11:45:46 +08:00
parent 72d72d735b
commit 7612026773
381 changed files with 28287 additions and 14717 deletions
--- a/app/service/merchant/group/MerchantGroupService.php
+++ b/app/service/merchant/group/MerchantGroupService.php
@@ -0,0 +1,120 @@
+<?php
+
+namespace app\service\merchant\group;
+
+use app\common\base\BaseService;
+use app\exception\ValidationException;
+use app\model\merchant\MerchantGroup;
+use app\repository\merchant\base\MerchantGroupRepository;
+
+/**
+ * 商户分组管理服务。
+ */
+class MerchantGroupService extends BaseService
+{
+    /**
+     * 构造函数，注入对应依赖。
+     */
+    public function __construct(
+        protected MerchantGroupRepository $merchantGroupRepository
+    ) {
+    }
+
+    /**
+     * 获取启用中的商户分组选项。
+     *
+     * 前端筛选框直接使用 `label / value` 结构即可。
+     */
+    public function enabledOptions(): array
+    {
+        return $this->merchantGroupRepository->enabledList(['id', 'group_name'])
+            ->map(function (MerchantGroup $group): array {
+                return [
+                    'label' => (string) $group->group_name,
+                    'value' => (int) $group->id,
+                ];
+            })
+            ->values()
+            ->all();
+    }
+
+    /**
+     * 分页查询商户分组。
+     */
+    public function paginate(array $filters = [], int $page = 1, int $pageSize = 10)
+    {
+        $query = $this->merchantGroupRepository->query();
+
+        $keyword = trim((string) ($filters['keyword'] ?? ''));
+        if ($keyword !== '') {
+            $query->where('group_name', 'like', '%' . $keyword . '%');
+        }
+
+        $groupName = trim((string) ($filters['group_name'] ?? ''));
+        if ($groupName !== '') {
+            $query->where('group_name', 'like', '%' . $groupName . '%');
+        }
+
+        if (array_key_exists('status', $filters) && $filters['status'] !== '') {
+            $query->where('status', (int) $filters['status']);
+        }
+
+        return $query
+            ->orderByDesc('id')
+            ->paginate(max(1, $pageSize), ['*'], 'page', max(1, $page));
+    }
+
+    /**
+     * 根据 ID 查询商户分组。
+     */
+    public function findById(int $id): ?MerchantGroup
+    {
+        return $this->merchantGroupRepository->find($id);
+    }
+
+    /**
+     * 新增商户分组。
+     */
+    public function create(array $data): MerchantGroup
+    {
+        $this->assertGroupNameUnique((string) ($data['group_name'] ?? ''));
+        return $this->merchantGroupRepository->create($data);
+    }
+
+    /**
+     * 更新商户分组。
+     */
+    public function update(int $id, array $data): ?MerchantGroup
+    {
+        $this->assertGroupNameUnique((string) ($data['group_name'] ?? ''), $id);
+        if (!$this->merchantGroupRepository->updateById($id, $data)) {
+            return null;
+        }
+
+        return $this->merchantGroupRepository->find($id);
+    }
+
+    /**
+     * 删除商户分组。
+     */
+    public function delete(int $id): bool
+    {
+        return $this->merchantGroupRepository->deleteById($id);
+    }
+
+    /**
+     * 校验商户分组名称唯一。
+     */
+    private function assertGroupNameUnique(string $groupName, int $ignoreId = 0): void
+    {
+        $groupName = trim($groupName);
+        if ($groupName === '') {
+            return;
+        }
+
+        if ($this->merchantGroupRepository->existsByGroupName($groupName, $ignoreId)) {
+            throw new ValidationException('分组名称已存在');
+        }
+    }
+}
+