공통화 작업 및 워커 해더

app/Controllers/V2/BaseV2Controller.php

@@ -0,0 +1,163 @@
+<?php
+
+namespace App\Controllers\V2;
+
+use App\Controllers\BaseController;
+use App\Models\common\CodeModel;
+
+/**
+ * BaseV2Controller
+ * V2 모듈 공통 로직: lists / getResultList / excel
+ *
+ * 하위 클래스에서 구현해야 하는 메서드:
+ *   - createModel()   : 모듈 전용 Model 인스턴스 반환
+ *   - getCodeKeys()   : lists()에서 로드할 코드 카테고리 배열 반환
+ *   - getViewName()   : lists()에서 렌더링할 뷰 경로 반환
+ *   - getSearchKeys() : getResultList/excel에서 수집할 GET 파라미터 키 배열 반환
+ */
+abstract class BaseV2Controller extends BaseController
+{
+    protected $model;
+    protected $codeModel;
+
+    public function __construct()
+    {
+        $this->codeModel = new CodeModel();
+        $this->model = $this->createModel();
+    }
+
+    abstract protected function createModel();
+    abstract protected function getCodeKeys(): array;
+    abstract protected function getViewName(): string;
+    abstract protected function getSearchKeys(): array;
+
+    public function lists(): string
+    {
+        $codes = $this->codeModel->getCodeLists($this->getCodeKeys());
+        $sido  = $this->model->getAreaList();
+        $bonbu = $this->model->getBonbuList();
+        $team  = $this->model->getTeamList();
+        $user  = $this->model->getUserList();
+
+        $this->data['codes'] = $codes;
+        $this->data['sido']  = $sido;
+        $this->data['bonbu'] = $bonbu;
+        $this->data['team']  = $team;
+        $this->data['user']  = $user;
+
+        return view($this->getViewName(), $this->data);
+    }
+
+    public function getResultList()
+    {
+        $start = (int) $this->request->getGet('start') ?: 0;
+        $end   = (int) $this->request->getGet('length') ?: 10;
+
+        $data = $this->buildSearchData();
+
+        $totalCount = $this->model->getTotalCount($data);
+        $datas      = $this->model->getResultList($start, $end, $data);
+
+        return $this->response->setJSON([
+            'recordsTotal'    => $totalCount,
+            'recordsFiltered' => $totalCount,
+            'data'            => $datas,
+        ]);
+    }
+
+    public function excel()
+    {
+        try {
+            $data  = $this->buildSearchData();
+            $datas = $this->model->getExcelList($data);
+
+            return $this->response->setJSON(['data' => $datas]);
+
+        } catch (\Exception $e) {
+            $e->getPrevious()->getTraceAsString();
+        }
+    }
+
+    /**
+     * getSearchKeys()에 정의된 키만 GET에서 수집해서 배열로 반환
+     */
+    protected function buildSearchData(): array
+    {
+        $data = [];
+        foreach ($this->getSearchKeys() as $key) {
+            $rawValue = $this->request->getGet($key);
+            $data[$key] = $this->normalizeSearchValue($key, $rawValue);
+        }
+        return $data;
+    }
+
+    /**
+     * 공통 파라미터 정규화
+     * - null/공백은 빈 문자열로 통일
+     * - 문자열은 trim 처리
+     * - 날짜 키(date 포함)는 형식 검증 실패 시 빈 문자열로 처리
+     */
+    protected function normalizeSearchValue(string $key, $value)
+    {
+        if (is_array($value)) {
+            return array_map(static function ($item) {
+                if ($item === null) {
+                    return '';
+                }
+                if (is_string($item)) {
+                    $item = trim($item);
+                    return $item === '' ? '' : $item;
+                }
+                return $item;
+            }, $value);
+        }
+
+        if ($value === null) {
+            return '';
+        }
+
+        if (is_string($value)) {
+            $value = trim($value);
+            if ($value === '') {
+                return '';
+            }
+        }
+
+        if ($this->isDateKey($key) && !$this->isValidDateValue((string) $value)) {
+            return '';
+        }
+
+        return $value;
+    }
+
+    /**
+     * 날짜 성격 파라미터 판별
+     * 예: receipt_sdate, receipt_edate, complete_sdate, stat_complete_date 등
+     */
+    protected function isDateKey(string $key): bool
+    {
+        return strpos($key, 'date') !== false;
+    }
+
+    /**
+     * 허용 날짜 형식 검증
+     * - YYYY-MM-DD
+     * - YYYYMMDD
+     */
+    protected function isValidDateValue(string $value): bool
+    {
+        if (preg_match('/^\d{4}-\d{2}-\d{2}$/', $value) === 1) {
+            [$year, $month, $day] = explode('-', $value);
+            return checkdate((int) $month, (int) $day, (int) $year);
+        }
+
+        if (preg_match('/^\d{8}$/', $value) === 1) {
+            $year = substr($value, 0, 4);
+            $month = substr($value, 4, 2);
+            $day = substr($value, 6, 2);
+            return checkdate((int) $month, (int) $day, (int) $year);
+        }
+
+        return false;
+    }
+}