chore: add db diagnostic mode on packaging units page

Expose a temporary db_diag=1 view for /bag/packaging-units so we can verify runtime DB connectivity and required table counts directly on production.

app/Controllers/Admin/Menu.php

@@ -30,18 +30,34 @@ class Menu extends BaseController
                 ->with('error', '메뉴를 관리하려면 먼저 지자체를 선택하세요.');
         }
         $types = $this->typeModel->orderBy('mt_sort', 'ASC')->findAll();
-        $mtIdx = (int) ($this->request->getGet('mt_idx') ?? 0);
+        $requestedMtIdx = (int) ($this->request->getGet('mt_idx') ?? 0);
-        if ($mtIdx <= 0 && ! empty($types)) {
+        $mtIdx = $this->resolveMtIdx($requestedMtIdx, $types);
-            // 기본 선택: 사이트 메뉴(mt_code=site), 없으면 첫 번째 타입
+        $effectiveMtIdx = $mtIdx;
-            $siteType = $this->typeModel->where('mt_code', 'site')->first();
+        $debugMode = $this->request->getGet('debug') === '1';
-            $mtIdx = $siteType ? (int) $siteType->mt_idx : (int) $types[0]->mt_idx;
+        $fallbackApplied = false;
-        }
+        $list = $effectiveMtIdx > 0 ? $this->menuModel->getAllByType($effectiveMtIdx, $lgIdx) : [];
-        $list = $mtIdx > 0 ? $this->menuModel->getAllByType($mtIdx, $lgIdx) : [];
+        $currentType = $mtIdx > 0 ? $this->typeModel->find($mtIdx) : null;
+        $currentTypeCode = (string) ($currentType->mt_code ?? '');
 
         // 현재 지자체에 메뉴가 없으면, mt_idx별로 기본 지자체(lg_idx=1)의 메뉴를 한 번 복사한다.
-        if ($mtIdx > 0 && empty($list)) {
+        if ($effectiveMtIdx > 0 && empty($list)) {
-            $this->menuModel->copyDefaultsFromLg($mtIdx, 1, $lgIdx);
+            $this->menuModel->copyDefaultsFromLg($effectiveMtIdx, 1, $lgIdx);
-            $list = $this->menuModel->getAllByType($mtIdx, $lgIdx);
+            $list = $this->menuModel->getAllByType($effectiveMtIdx, $lgIdx);
+        }
+
+        // 운영 DB 불일치 대응: site 타입인데 mt_idx 매핑이 어긋난 경우(예: menu_type=2, menu는 4 사용)
+        if (empty($list) && $currentTypeCode === 'site' && $effectiveMtIdx !== 4) {
+            $fallbackMtIdx = 4;
+            $fallbackList = $this->menuModel->getAllByType($fallbackMtIdx, $lgIdx);
+            if (empty($fallbackList)) {
+                $this->menuModel->copyDefaultsFromLg($fallbackMtIdx, 1, $lgIdx);
+                $fallbackList = $this->menuModel->getAllByType($fallbackMtIdx, $lgIdx);
+            }
+            if (! empty($fallbackList)) {
+                $effectiveMtIdx = $fallbackMtIdx;
+                $list = $fallbackList;
+                $fallbackApplied = true;
+            }
         }
 
         // 트리 순서대로 상위 메뉴 바로 아래에 하위 메뉴가 오도록 평탄화
@@ -50,16 +66,24 @@ class Menu extends BaseController
             $list = flatten_menu_tree($tree);
         }
 
-        $currentType = $mtIdx > 0 ? $this->typeModel->find($mtIdx) : null;
-
         return view('admin/layout', [
             'title'   => '메뉴 관리',
             'content' => view('admin/menu/index', [
                 'types'      => $types,
                 'mtIdx'      => $mtIdx,
-                'mtCode'     => $currentType->mt_code ?? '',
+                'mtCode'     => $currentTypeCode,
                 'list'       => $list,
                 'levelNames' => config('Roles')->levelNames,
+                'debug_mode' => $debugMode,
+                'debug_info' => [
+                    'lg_idx'           => $lgIdx,
+                    'requested_mt_idx' => $requestedMtIdx,
+                    'resolved_mt_idx'  => $mtIdx,
+                    'effective_mt_idx' => $effectiveMtIdx,
+                    'resolved_mt_code' => $currentTypeCode,
+                    'list_count'       => count($list),
+                    'fallback_applied' => $fallbackApplied ? 'Y' : 'N',
+                ],
             ]),
         ]);
     }
@@ -73,7 +97,9 @@ class Menu extends BaseController
         if ($lgIdx === null) {
             return $this->response->setJSON(['status' => 0, 'msg' => '지자체를 선택하세요.']);
         }
-        $mtIdx = (int) $this->request->getGet('mt_idx');
+        $types = $this->typeModel->orderBy('mt_sort', 'ASC')->findAll();
+        $requestedMtIdx = (int) $this->request->getGet('mt_idx');
+        $mtIdx = $this->resolveMtIdx($requestedMtIdx, $types);
         if ($mtIdx <= 0) {
             return $this->response->setJSON(['status' => 0, 'msg' => 'mt_idx required']);
         }
@@ -210,4 +236,34 @@ class Menu extends BaseController
 
         return implode(',', array_values($levels));
     }
+
+    /**
+     * 요청된 mt_idx를 현재 DB 상태에 맞게 보정.
+     * - 유효한 mt_idx면 그대로 사용
+     * - 레거시 site 값(2) 요청 시 site 타입의 실제 mt_idx로 치환
+     * - 그 외 미지정/잘못된 값은 site 우선, 없으면 첫 타입으로 보정
+     *
+     * @param array<int,object> $types
+     */
+    private function resolveMtIdx(int $requestedMtIdx, array $types): int
+    {
+        if (empty($types)) {
+            return 0;
+        }
+
+        $validTypeIds = array_map(static fn ($t): int => (int) ($t->mt_idx ?? 0), $types);
+        if ($requestedMtIdx > 0 && in_array($requestedMtIdx, $validTypeIds, true)) {
+            return $requestedMtIdx;
+        }
+
+        $siteType = $this->typeModel->where('mt_code', 'site')->first();
+        if ($siteType !== null) {
+            // 과거 링크(/admin/menus?mt_idx=2) 호환
+            if ($requestedMtIdx === 2 || $requestedMtIdx <= 0 || ! in_array($requestedMtIdx, $validTypeIds, true)) {
+                return (int) $siteType->mt_idx;
+            }
+        }
+
+        return (int) $types[0]->mt_idx;
+    }
 }

app/Controllers/Bag.php

@@ -331,6 +331,7 @@ class Bag extends BaseController
     {
         $lgIdx           = $this->lgIdx();
         $packagingUnits = [];
+        $dbDiag          = null;
         if ($lgIdx) {
             try {
                 $packagingUnits = model(PackagingUnitModel::class)->where('pu_lg_idx', $lgIdx)->orderBy('pu_bag_code', 'ASC')->findAll();
@@ -339,7 +340,34 @@ class Bag extends BaseController
             }
         }
 
-        return $this->render('포장 단위', 'bag/packaging_units', ['packagingUnits' => $packagingUnits]);
+        if ($this->request->getGet('db_diag') === '1') {
+            $dbDiag = [
+                'lg_idx'            => $lgIdx,
+                'db_name'           => null,
+                'packaging_unit'    => null,
+                'code_kind'         => null,
+                'code_detail'       => null,
+                'error'             => null,
+            ];
+            try {
+                $db = db_connect();
+                $dbDiag['db_name'] = $db->database;
+                $dbDiag['packaging_unit'] = (int) $db->table('packaging_unit')->where('pu_lg_idx', (int) $lgIdx)->countAllResults();
+                $dbDiag['code_kind'] = (int) $db->table('code_kind')->countAllResults();
+                $dbDiag['code_detail'] = (int) $db->table('code_detail')->countAllResults();
+            } catch (\Throwable $e) {
+                $dbDiag['error'] = $e->getMessage();
+                log_message('error', '[packagingUnits][db_diag] {type}: {message}', [
+                    'type'    => $e::class,
+                    'message' => $e->getMessage(),
+                ]);
+            }
+        }
+
+        return $this->render('포장 단위', 'bag/packaging_units', [
+            'packagingUnits' => $packagingUnits,
+            'dbDiag'         => $dbDiag,
+        ]);
     }
 
     /**
@@ -349,13 +377,27 @@ class Bag extends BaseController
     {
         $kindModel   = model(CodeKindModel::class);
         $detailModel = model(CodeDetailModel::class);
-        $kinds       = $kindModel->orderBy('ck_code', 'ASC')->findAll();
+        $kinds       = [];
-        $lgIdx       = $this->lgIdx();
         $countMap    = [];
-        foreach ($kinds as $row) {
+        $lgIdx       = $this->lgIdx();
-            $countMap[$row->ck_idx] = (int) $detailModel->where('cd_ck_idx', $row->ck_idx)
+        try {
-                ->filterByTenantScope($lgIdx)
+            $kinds = $kindModel->orderBy('ck_code', 'ASC')->findAll();
-                ->countAllResults();
+            foreach ($kinds as $row) {
+                $countMap[$row->ck_idx] = (int) $detailModel->where('cd_ck_idx', $row->ck_idx)
+                    ->filterByTenantScope($lgIdx)
+                    ->countAllResults();
+            }
+        } catch (\Throwable $e) {
+            log_message('error', '[codeKinds] 실패: {type} {message} @ {file}:{line} / lg={lg}, user={user}, level={level}', [
+                'type'    => $e::class,
+                'message' => $e->getMessage(),
+                'file'    => $e->getFile(),
+                'line'    => $e->getLine(),
+                'lg'      => $lgIdx !== null ? (string) $lgIdx : 'null',
+                'user'    => (string) (session()->get('mb_id') ?? ''),
+                'level'   => (string) (session()->get('mb_level') ?? ''),
+            ]);
+            session()->setFlashdata('error', '기본코드 조회 중 오류가 발생했습니다. 관리자에게 로그 확인을 요청해 주세요.');
         }
 
         $level = (int) session()->get('mb_level');
@@ -374,18 +416,46 @@ class Bag extends BaseController
     {
         $kindModel   = model(CodeKindModel::class);
         $detailModel = model(CodeDetailModel::class);
-        $kind        = $kindModel->find($ckIdx);
+        $kind        = null;
+        try {
+            $kind = $kindModel->find($ckIdx);
+        } catch (\Throwable $e) {
+            log_message('error', '[codeDetails] kind 조회 실패: {type} {message} @ {file}:{line} / ck={ck}, user={user}, level={level}', [
+                'type'    => $e::class,
+                'message' => $e->getMessage(),
+                'file'    => $e->getFile(),
+                'line'    => $e->getLine(),
+                'ck'      => (string) $ckIdx,
+                'user'    => (string) (session()->get('mb_id') ?? ''),
+                'level'   => (string) (session()->get('mb_level') ?? ''),
+            ]);
+            return redirect()->to(site_url('bag/code-kinds'))->with('error', '세부코드 조회 중 오류가 발생했습니다. 관리자에게 로그 확인을 요청해 주세요.');
+        }
         if ($kind === null) {
             return redirect()->to(site_url('bag/code-kinds'))->with('error', '코드 종류를 찾을 수 없습니다.');
         }
 
         $lgIdx = $this->lgIdx();
-        $list  = $detailModel->where('cd_ck_idx', $ckIdx)
+        try {
-            ->filterByTenantScope($lgIdx)
+            $list  = $detailModel->where('cd_ck_idx', $ckIdx)
-            ->orderBy('cd_sort', 'ASC')
+                ->filterByTenantScope($lgIdx)
-            ->orderBy('cd_idx', 'ASC')
+                ->orderBy('cd_sort', 'ASC')
-            ->paginate(20);
+                ->orderBy('cd_idx', 'ASC')
-        $pager = $detailModel->pager;
+                ->paginate(20);
+            $pager = $detailModel->pager;
+        } catch (\Throwable $e) {
+            log_message('error', '[codeDetails] list 조회 실패: {type} {message} @ {file}:{line} / ck={ck}, lg={lg}, user={user}, level={level}', [
+                'type'    => $e::class,
+                'message' => $e->getMessage(),
+                'file'    => $e->getFile(),
+                'line'    => $e->getLine(),
+                'ck'      => (string) $ckIdx,
+                'lg'      => $lgIdx !== null ? (string) $lgIdx : 'null',
+                'user'    => (string) (session()->get('mb_id') ?? ''),
+                'level'   => (string) (session()->get('mb_level') ?? ''),
+            ]);
+            return redirect()->to(site_url('bag/code-kinds'))->with('error', '세부코드 조회 중 오류가 발생했습니다. 관리자에게 로그 확인을 요청해 주세요.');
+        }
 
         helper('admin');
         $level      = (int) session()->get('mb_level');

app/Helpers/admin_helper.php

@@ -151,17 +151,30 @@ if (! function_exists('get_site_nav_tree')) {
     {
         try {
             $lgIdx = resolve_site_menu_lg_idx();
-            $typeRow = model(\App\Models\MenuTypeModel::class)->getByCode('site');
-            if (! $typeRow) {
-                return [];
-            }
             $mbLevel = (int) session()->get('mb_level');
             $menuModel = model(\App\Models\MenuModel::class);
-            $flat      = $menuModel->getVisibleByLevel((int) $typeRow->mt_idx, $mbLevel, (int) $lgIdx);
+            $typeRow = model(\App\Models\MenuTypeModel::class)->getByCode('site');
+            $siteMtIdx = $typeRow ? (int) $typeRow->mt_idx : 0;
+            if ($siteMtIdx <= 0) {
+                // 운영 DB 불일치 대비: menu_type 누락 시 legacy site mt_idx(4)로 시도
+                $siteMtIdx = 4;
+            }
+
+            $flat = $menuModel->getVisibleByLevel($siteMtIdx, $mbLevel, (int) $lgIdx);
             // 현재 지자체에 site 메뉴가 없으면, 기본 지자체(1)의 메뉴를 한 번 복사한 뒤 다시 시도
             if (empty($flat)) {
-                $menuModel->copyDefaultsFromLg((int) $typeRow->mt_idx, 1, (int) $lgIdx);
+                $menuModel->copyDefaultsFromLg($siteMtIdx, 1, (int) $lgIdx);
-                $flat = $menuModel->getVisibleByLevel((int) $typeRow->mt_idx, $mbLevel, (int) $lgIdx);
+                $flat = $menuModel->getVisibleByLevel($siteMtIdx, $mbLevel, (int) $lgIdx);
+            }
+
+            // site 타입 매핑 불일치(예: menu_type=2, menu 데이터=4) 보정
+            if (empty($flat) && $siteMtIdx !== 4) {
+                $legacyMtIdx = 4;
+                $flat = $menuModel->getVisibleByLevel($legacyMtIdx, $mbLevel, (int) $lgIdx);
+                if (empty($flat)) {
+                    $menuModel->copyDefaultsFromLg($legacyMtIdx, 1, (int) $lgIdx);
+                    $flat = $menuModel->getVisibleByLevel($legacyMtIdx, $mbLevel, (int) $lgIdx);
+                }
             }
             if (empty($flat)) {
                 return [];

app/Views/admin/menu/index.php

@@ -4,6 +4,8 @@ $list = $list ?? [];
 $mtIdx = (int) ($mtIdx ?? 0);
 $mtCode = (string) ($mtCode ?? '');
 $levelNames = $levelNames ?? [];
+$debugMode = (bool) ($debug_mode ?? false);
+$debugInfo = is_array($debug_info ?? null) ? $debug_info : [];
 helper('admin');
 $adminMenusNavPath = current_nav_request_path();
 
@@ -44,6 +46,19 @@ $adminMenuListResolveHref = static function (string $rawLink) use ($adminMenusNa
   </div>
 </section>
 
+<?php if ($debugMode): ?>
+<section class="mt-2 border border-amber-300 bg-amber-50 text-amber-900 rounded p-2 text-xs">
+  <strong>[DEBUG]</strong>
+  lg_idx=<?= esc((string) ($debugInfo['lg_idx'] ?? '')) ?>,
+  requested_mt_idx=<?= esc((string) ($debugInfo['requested_mt_idx'] ?? '')) ?>,
+  resolved_mt_idx=<?= esc((string) ($debugInfo['resolved_mt_idx'] ?? '')) ?>,
+  effective_mt_idx=<?= esc((string) ($debugInfo['effective_mt_idx'] ?? '')) ?>,
+  resolved_mt_code=<?= esc((string) ($debugInfo['resolved_mt_code'] ?? '')) ?>,
+  list_count=<?= esc((string) ($debugInfo['list_count'] ?? '')) ?>,
+  fallback_applied=<?= esc((string) ($debugInfo['fallback_applied'] ?? 'N')) ?>
+</section>
+<?php endif; ?>
+
 <div class="flex gap-4 mt-2 flex-wrap">
   <div class="border border-gray-300 bg-white rounded p-4 flex-1 min-w-0" style="min-width: 320px;">
     <h3 class="text-sm font-bold text-gray-700 mb-2">메뉴 목록</h3>

app/Views/bag/packaging_units.php

@@ -1,4 +1,17 @@
 <div class="space-y-4">
+  <?php if (isset($dbDiag) && is_array($dbDiag)): ?>
+  <section class="rounded border border-amber-300 bg-amber-50 px-3 py-2 text-xs text-amber-900">
+    <div class="font-semibold mb-1">DB 진단 모드</div>
+    <div>lg_idx: <?= esc((string) ($dbDiag['lg_idx'] ?? 'null')) ?></div>
+    <div>database: <?= esc((string) ($dbDiag['db_name'] ?? '')) ?></div>
+    <div>packaging_unit(현재 lg): <?= esc((string) ($dbDiag['packaging_unit'] ?? 'null')) ?></div>
+    <div>code_kind: <?= esc((string) ($dbDiag['code_kind'] ?? 'null')) ?></div>
+    <div>code_detail: <?= esc((string) ($dbDiag['code_detail'] ?? 'null')) ?></div>
+    <?php if (! empty($dbDiag['error'])): ?>
+    <div class="mt-1 text-red-700">error: <?= esc((string) $dbDiag['error']) ?></div>
+    <?php endif; ?>
+  </section>
+  <?php endif; ?>
   <p class="text-sm text-gray-600">
     <a href="<?= base_url('bag/basic-info') ?>" class="text-blue-600 hover:underline">&larr; 기본정보관리</a>
     <span class="mx-2 text-gray-300">|</span>