From e8d58b58371b5eef99094a5188039be13d09ce90 Mon Sep 17 00:00:00 2001 From: taekyoungc Date: Mon, 8 Jun 2026 19:04:41 +0900 Subject: [PATCH] =?UTF-8?q?=ED=99=94=EB=A9=B4=EB=B3=84=20=EB=A7=A4?= =?UTF-8?q?=EB=89=B4=EC=96=BC=C2=B7=EC=9D=B4=20=ED=99=94=EB=A9=B4=20?= =?UTF-8?q?=EC=84=A4=EB=AA=85=20=EB=B2=84=ED=8A=BC=C2=B7=ED=83=AD=20?= =?UTF-8?q?=EC=83=88=EB=A1=9C=EA=B3=A0=EC=B9=A8/=EA=B2=BD=EA=B3=A0=C2=B7?= =?UTF-8?q?=EC=B5=9C=EA=B7=BC=EB=B0=A9=EB=AC=B8=20=EA=B8=B0=EB=A1=9D=20?= =?UTF-8?q?=EB=B3=B4=EA=B0=95.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 매뉴얼: 화면(소메뉴)별 용어·버튼·필드 설명으로 확장 + 기본정보 페이지 신규, 개요에 용어 사전 추가 (종량제 지식 없는 사용자 대상) - "이 화면 설명" 버튼: 화면 경로→매뉴얼 매핑(Config\Manual::screenHelp, manual_help_url_for_path). 워크스페이스 탭은 새 탭으로, 직접 페이지는 새 창으로 - 워크스페이스: 개별 탭 새로고침(↻) 버튼, 탭 2개 이상일 때만 새로고침 경고, 사이드바 하단 링크(매뉴얼 등)도 탭으로 열기 - 임베드: 탭 내 링크/폼 embed 유지(중첩 헤더 방지), 매뉴얼 리다이렉트 embed 유지 - 사이드바 하단: 종합그래프 → 사용자 매뉴얼 링크 - 최근 방문 메뉴: embed 페이지에도 방문 기록, 대시보드는 storage 이벤트로 실시간 갱신 - E2E qa_sweep 추가(주요 화면 콘솔/오버레이/매뉴얼/도움말 매핑 점검) Co-Authored-By: Claude Opus 4.8 --- app/Config/Manual.php | 41 ++++++- app/Controllers/Bag.php | 6 +- app/Docs/manual/00_overview.md | 69 ++++++------ app/Docs/manual/20_order_receiving.md | 77 ++++++++----- app/Docs/manual/30_inventory.md | 52 ++++----- app/Docs/manual/40_sales_issue.md | 101 ++++++++++++------ app/Docs/manual/50_reports.md | 83 ++++++++------ app/Docs/manual/60_basic_info.md | 69 ++++++++++++ app/Helpers/admin_helper.php | 29 +++++ app/Views/bag/dashboard_portal.php | 2 + app/Views/bag/layout/embed.php | 68 +++++++++++- app/Views/bag/layout/portal.php | 10 +- app/Views/bag/layout/workspace.php | 36 ++++++- .../home/_dashboard_gov_portal_sidebar.php | 2 +- e2e/qa_sweep.spec.js | 95 ++++++++++++++++ 15 files changed, 578 insertions(+), 162 deletions(-) create mode 100644 app/Docs/manual/60_basic_info.md create mode 100644 e2e/qa_sweep.spec.js diff --git a/app/Config/Manual.php b/app/Config/Manual.php index 6656988..21c877c 100644 --- a/app/Config/Manual.php +++ b/app/Config/Manual.php @@ -26,9 +26,46 @@ class Manual extends BaseConfig 'flow' => ['title' => '핵심 업무 흐름', 'file' => '10_workflow.md'], 'order' => ['title' => '발주·입고', 'file' => '20_order_receiving.md'], 'inventory' => ['title' => '재고·실사', 'file' => '30_inventory.md'], - 'sales' => ['title' => '판매·불출', 'file' => '40_sales_issue.md'], - 'reports' => ['title' => '판매현황·수불·통계', 'file' => '50_reports.md'], + 'sales' => ['title' => '판매·반품·불출·주문', 'file' => '40_sales_issue.md'], + 'reports' => ['title' => '현황·리포트·수불', 'file' => '50_reports.md'], + 'basic' => ['title' => '기본정보(판매소·단가·코드)', 'file' => '60_basic_info.md'], 'codes' => ['title' => '봉투·LOT·바코드 코드체계', 'file' => '90_code_system.md'], 'faq' => ['title' => '자주 묻는 질문·문의', 'file' => '99_faq.md'], ]; + + /** + * 화면 경로(접두) → 그 화면을 설명하는 매뉴얼 slug. + * "이 화면 설명" 버튼이 현재 경로로 알맞은 매뉴얼 페이지를 연다. + * 더 긴(구체적) 접두가 우선하도록 길이 내림차순으로 매칭한다. + * + * @var array + */ + public array $screenHelp = [ + 'bag/order/phone' => 'sales', + 'bag/order' => 'order', + 'bag/bag-orders' => 'order', + 'bag/receiving' => 'order', + 'bag/bag-receivings' => 'order', + 'bag/inventory' => 'inventory', + 'bag/sale' => 'sales', + 'bag/sales' => 'sales', + 'bag/issue' => 'sales', + 'bag/bag-issues' => 'sales', + 'bag/bag-sales' => 'sales', + 'bag/shop-orders' => 'sales', + 'bag/flow' => 'reports', + 'bag/reports' => 'reports', + 'bag/analytics' => 'reports', + 'bag/designated-shops' => 'basic', + 'bag/bag-prices' => 'basic', + 'bag/prices' => 'basic', + 'bag/packaging-units' => 'basic', + 'bag/code-kinds' => 'basic', + 'bag/code-details' => 'basic', + 'bag/managers' => 'basic', + 'bag/companies' => 'basic', + 'bag/sales-agencies' => 'basic', + 'bag/free-recipients' => 'basic', + 'bag/number-lookup' => 'codes', + ]; } diff --git a/app/Controllers/Bag.php b/app/Controllers/Bag.php index 44d4ffa..896eda4 100644 --- a/app/Controllers/Bag.php +++ b/app/Controllers/Bag.php @@ -3580,8 +3580,12 @@ SQL); public function manual(): \CodeIgniter\HTTP\RedirectResponse { $first = (new \App\Libraries\ManualRenderer())->firstSlug(); + $url = site_url('bag/manual/' . $first); + if ($this->isEmbeddedRequest()) { + $url .= '?embed=1'; // 워크스페이스 탭 안에서는 임베드 유지(중첩 헤더 방지) + } - return redirect()->to(site_url('bag/manual/' . $first)); + return redirect()->to($url); } /** diff --git a/app/Docs/manual/00_overview.md b/app/Docs/manual/00_overview.md index 7d0cc95..f2182e0 100644 --- a/app/Docs/manual/00_overview.md +++ b/app/Docs/manual/00_overview.md @@ -1,49 +1,48 @@ # 시작하기 · 시스템 개요 -종량제 쓰레기봉투 물류 시스템 사용자 매뉴얼입니다. 이 문서는 실제 업무를 처리하는 담당자(지자체 관리자·지정판매소)를 위한 **빠른 시작 안내서**입니다. +종량제 쓰레기봉투 물류 시스템 사용자 매뉴얼입니다. **이 시스템을 처음 쓰는 분**도 화면을 이해하고 업무를 처리할 수 있도록, 화면마다 쓰이는 용어와 버튼의 의미를 설명합니다. -## 1. 시스템은 무엇을 하나요? +## 1. 이 시스템은 무엇을 하나요? -지자체 종량제 쓰레기봉투의 **발주 → 입고 → 재고 → 판매/불출 → 정산·통계** 전 과정을 관리합니다. +지자체가 주민에게 파는 **종량제 쓰레기봉투**가 ① 제작업체에 **주문(발주)** 되고 → ② 창고로 **들어오고(입고)** → ③ **재고**로 보관되다가 → ④ 동네 가게(지정판매소)에 **팔리거나(판매)** 무료 대상자에게 **나눠지는(불출)** 전 과정을 컴퓨터로 관리합니다. 마지막엔 ⑤ 얼마나 팔렸는지 **집계·정산(현황/리포트)** 합니다. -- 봉투를 제작업체에 **발주**하고, 들어온 물량을 **입고** 처리합니다. -- 현재 **재고**를 확인하고, 실사로 실제 수량과 맞춥니다. -- 지정판매소에 **판매**하거나 무료 대상자에게 **불출**합니다. -- 일계표·기간별·연간 등 **판매현황**과 **수불·통계**를 조회합니다. +## 2. 꼭 알아야 할 기본 용어 (용어 사전) -## 2. 로그인과 화면 구성 +| 용어 | 쉬운 설명 | +|---|---| +| **발주** | 봉투를 제작업체에 "이만큼 만들어 주세요"라고 **주문**하는 것 | +| **입고** | 주문한 봉투가 창고에 **도착해 들여놓는** 것 | +| **재고** | 지금 창고에 **남아 있는 봉투 수량** | +| **불출** | 봉투를 창고에서 **꺼내 내보내는** 것 (주로 무료 배부) | +| **수불(受拂)** | **들어오고(수입)·나가는(불출)** 움직임을 적은 장부 | +| **지정판매소** | 봉투를 파는 **동네 가게**(편의점·마트 등) | +| **대행소(판매대행소)** | 봉투 **배송·유통을 대행**하는 업체 | +| **실사** | 컴퓨터 기록과 **실제 창고 수량이 맞는지 직접 세어 확인**하는 것 | +| **박스 / 팩 / 낱장** | 포장 단위. **박스 > 팩 > 낱장(봉투 1장)**. 1박스 = 여러 팩, 1팩 = 여러 낱장 | +| **LOT(로트)** | 한 번의 발주 묶음에 부여되는 **추적용 일련번호** | +| **바코드(봉투번호)** | 박스·팩·낱장마다 붙는 **고유 번호**(스캔용) | +| **무료용 / 공공용** | 주민 무료 배부용 / 공공기관 사용용 봉투 구분 | -1. 발급받은 아이디·비밀번호로 로그인합니다. -2. 관리자(지자체/슈퍼)는 보안을 위해 **2차 인증(OTP)** 이 적용될 수 있습니다. -3. 로그인하면 상단에 **대메뉴**가 보이고, 각 대메뉴에 마우스를 올리면 **소메뉴**가 펼쳐집니다. -4. 화면 상단의 제목 바에 현재 보고 있는 화면 이름이 표시됩니다. +> 박스·팩·낱장·LOT·바코드의 자세한 규칙은 좌측 목차 **[봉투·LOT·바코드 코드체계]** 참고. -> 슈퍼 관리자는 작업할 **지자체를 먼저 선택**해야 업무 화면이 열립니다. +## 3. 화면 구성과 사용법 -## 3. 사용자 역할(권한) +- 로그인하면 **워크스페이스**(탭 작업공간)가 열립니다. 상단에 대분류 메뉴, **대분류를 클릭하면 왼쪽에 소메뉴**가 펼쳐집니다. +- 메뉴를 클릭하면 **탭으로 열립니다.** 여러 화면을 열어두고 전환해도 입력하던 내용이 유지됩니다. +- 각 화면에서 **"이 화면 설명"(❓) 버튼**을 누르면, 그 화면에 해당하는 매뉴얼이 새 탭으로 열립니다. -시스템은 4단계 역할로 접근 권한을 구분합니다. +## 4. 사용자 역할(권한) -| 레벨 | 역할 | 할 수 있는 일 | -|---|---|---| -| 1 | 일반 사용자 | 기본 조회 | -| 2 | 지정판매소 | 봉투 판매·반품, 자기 판매 현황 조회 | -| 3 | 지자체 관리자 | 소속 지자체의 발주·입고·재고·불출·판매·리포트 전반 | -| 4 | 슈퍼 관리자 | 전체 시스템 관리 + 기본코드 등 마스터 관리 (지자체 선택 후 작업) | +| 역할 | 할 수 있는 일 | +|---|---| +| 일반 사용자 | 기본 조회 | +| 지정판매소 | 봉투 판매·반품, 자기 판매 현황 조회 | +| 지자체 관리자 | 소속 지자체의 발주·입고·재고·불출·판매·리포트 전반 | +| 슈퍼 관리자 | 전체 + 기본코드 등 마스터 관리(지자체 선택 후 작업) | -### 역할별 접근 한눈에 보기 +## 5. 화면별 설명은 어디에? -| 기능군 | 일반 | 판매소 | 지자체관리자 | 슈퍼 | -|---|:--:|:--:|:--:|:--:| -| 기본정보 조회(코드·단가·포장) | △ | ○ | ○ | ○ | -| 기본코드·마스터 편집 | ✕ | ✕ | △(지자체분) | ○ | -| 발주·입고·재고·불출 | ✕ | ✕ | ○ | ○ | -| 판매·반품 등록 | ✕ | ○ | ○ | ○ | -| 판매현황·수불·통계 | ✕ | △(자기분) | ○ | ○ | +좌측 목차에서 업무군을 고르면 그 안에 **화면(소메뉴)별 설명**이 있습니다. +- **발주·입고** / **재고·실사** / **판매·반품·불출·주문** / **현황·리포트·수불** / **기본정보(판매소·단가·코드)** -(○ 사용 가능 · △ 제한적 · ✕ 불가) - -## 4. 다음 단계 - -- 전체 업무가 어떻게 이어지는지 먼저 보려면 **[핵심 업무 흐름]** 으로 이동하세요. -- 특정 작업 방법은 좌측 목차에서 해당 항목(발주·입고 / 재고·실사 / 판매·불출 / 판매현황·수불·통계)을 선택하세요. +각 화면 설명은 **그 화면 고유의 용어·입력 항목·버튼·작업 순서**만 담았습니다. diff --git a/app/Docs/manual/20_order_receiving.md b/app/Docs/manual/20_order_receiving.md index ab749eb..55fd447 100644 --- a/app/Docs/manual/20_order_receiving.md +++ b/app/Docs/manual/20_order_receiving.md @@ -1,41 +1,66 @@ # 발주 · 입고 -제작업체에 봉투를 주문(발주)하고, 도착한 물량을 시스템에 등록(입고)하는 단계입니다. **지자체 관리자** 이상이 사용합니다. +봉투를 제작업체에 **주문(발주)** 하고, 도착한 봉투를 창고에 **들여놓는(입고)** 단계입니다. -## 발주 +--- -### 발주 등록 +## 발주 등록 · *발주 입고 관리 › 발주 등록* -**발주 입고 관리 › 발주 등록** +봉투를 **얼마나 주문할지** 입력해 발주서를 만드는 화면입니다. 저장하면 추적용 **LOT 번호**가 자동으로 붙습니다. -1. 봉투 **품목**(종류·용량)과 **수량**, 납품 관련 정보를 입력합니다. -2. 박스/낱장 수량과 금액·총계가 자동으로 계산됩니다. -3. 저장하면 발주 건이 생성되고, 추적용 **LOT 번호**가 자동 부여됩니다. +**이 화면의 용어** +- **발주가능봉투**: 조달청(나라장터)에 등록되어 주문할 수 있는 봉투 종류. +- **입고처**: 들어온 봉투를 받을 창고/장소. +- **조달수수료**: 발주 금액에 붙는 수수료율(%). +- **Box당 팩 / 팩당 낱장 / 1박스 총 낱장**: 포장 환산 정보(참고용 표). -> 발주 내용은 무결성 보호를 위해 버전·해시로 관리됩니다. 수정(재발주) 시 기존 LOT는 유지됩니다. +**입력 항목**: 발주월, 발주일, 협회, 제작업체, 입고처, **봉투 품목별 수량(박스 단위)**. -### 발주 변경 · 현황 +**버튼**: `발주`(저장) · `변경 저장`(수정 시) · `취소`. -| 작업 | 메뉴 | 설명 | -|---|---|---| -| 발주 변경 | 발주 변경 | 기존 발주 수정·재발주 | -| 발주 현황 | 발주 현황 | 발주 목록을 기간·상태로 조회, 엑셀 내보내기 | -| 발주 상세 | (현황에서 행 선택) | 개별 발주 상세 확인, 취소 처리 | +**작업 순서** +1. 발주월·발주일, 제작업체·입고처를 고릅니다. +2. 아래 봉투 종류별로 **주문할 박스 수량**을 입력합니다(금액·총 낱장은 자동 계산). +3. `발주` 를 누르면 발주가 생성되고 LOT 번호가 부여됩니다. -## 입고 +--- -발주분이 실제 도착하면 입고로 등록합니다. 입고 시 **박스·팩·낱장 바코드**가 생성되어 재고에 반영됩니다. +## 발주 현황 · *발주 입고 관리 › 발주 현황* -| 방식 | 메뉴 | 언제 사용 | -|---|---|---| -| 스캐너 입고 | 발주 입고[스캐너] | 바코드를 스캔하며 입고 | -| 일괄 입고 | 일괄입고 | 다량을 한 번에 입고 | -| 입고 현황 | 입고 현황 | 입고 기록 조회, 엑셀 내보내기 | +낸 발주를 **조회·관리**하는 목록 화면입니다. -### 입고 처리 순서 +**필터**: 발주기간(월~월) · 제작업체 · 품명 · **입고구분(전체/입고완료/미입고)**. -1. 입고할 발주 건(LOT)을 선택합니다. -2. 도착 수량(박스/낱장)을 확인·입력합니다. -3. 저장하면 재고가 증가하고, 단위별 바코드가 부여됩니다. +**표 컬럼**: 발주일자 · 제작업체 · 품명 · **발주수량 · 입고수량 · 미입고수량** · 발주금액 · 입고처 · 비고. +- **미입고수량** = 발주했지만 아직 안 들어온 수량. -> 입고가 끝나면 **재고 관리**에서 수량이 정상 반영됐는지 확인하세요. +**버튼**: `엑셀저장` · `인쇄` · `발주등록`. (목록에서 개별 발주의 상세·취소 가능) + +--- + +## 입고 처리 · *발주 입고 관리 › 입고[스캐너] / 일괄입고* + +도착한 봉투를 시스템에 **들여놓는** 화면입니다. 입고하면 박스·팩·낱장 **바코드가 생성**되고 재고가 늘어납니다. + +**이 화면의 용어** +- **인계자(제작업체)** / **인수자(대행소)**: 봉투를 넘기는 쪽 / 받는 쪽. +- **입고량(매)**: 실제로 들어온 **낱장 수**("매" = 장). +- **LOT NO / 발주 NO**: 어떤 발주분인지 식별하는 번호. + +**입고[스캐너]**: 발주 건을 보고 행마다 **입고량(매)** 을 직접 입력 → `입고처리`. +**일괄입고**: 여러 발주 건을 **체크박스로 골라** 한 번에 입고. 미입고량은 파란색으로 강조됩니다. + +**작업 순서** +1. 제작업체·인수자·인계자·입고일을 고릅니다. +2. 들어온 만큼 **입고량(매)** 을 입력(또는 일괄 선택)합니다. +3. `입고처리` → 재고 반영. **재고 관리**에서 수량이 늘었는지 확인하세요. + +--- + +## 입고 현황 · *발주 입고 관리 › 입고 현황* + +입고 기록을 기간별로 조회합니다. + +**필터**: 입고기간 · 제작업체 · 품명 · 입고구분(전체/완료/미완료). +**표 컬럼**: 입고일자 · 품명 · 입고수량 · 발주일자 · 발주수량 · 발주번호 · 제작업체 · **입고여부(완료/미완료)** · 입고처 · 비고. +**버튼**: `엑셀저장` · `인쇄`. diff --git a/app/Docs/manual/30_inventory.md b/app/Docs/manual/30_inventory.md index d07d7f8..d686057 100644 --- a/app/Docs/manual/30_inventory.md +++ b/app/Docs/manual/30_inventory.md @@ -1,39 +1,39 @@ # 재고 · 실사 -현재 보유 봉투 수량을 확인하고, 정기적으로 실사를 통해 실제 수량과 맞추는 단계입니다. +지금 창고에 **남은 봉투**를 확인하고, 컴퓨터 기록과 **실제 수량을 맞추는(실사)** 단계입니다. -## 재고 현황 +--- -**재고 관리 › 재고 현황** +## 재고 현황 · *재고 관리 › 재고 현황* -- 품목별·상태별 현재 재고를 조회합니다. -- 지자체·봉투 종류 등으로 필터링할 수 있습니다. -- **엑셀 내보내기**로 목록을 저장할 수 있습니다. +품목별로 **현재 남은 수량**을 봅니다. -| 항목 | 설명 | -|---|---| -| 품목 | 봉투 종류·용량 | -| 재고 수량 | 입고 − (판매 + 불출 + 파기) | -| 상태 | 재고/판매 등 단위별 상태 | +**이 화면의 용어** +- **시군구재고**: 지자체(시·군·구) **창고**에 있는 재고. +- **대행소재고**: 배송 **대행소**가 보유 중인 재고. +- **계**: 둘을 합친 총 재고. -## 실사 (재고 조사) +**필터**: 기준일자 · 대행소(전체/선택). +**표 컬럼**: 품목구분 · 봉투/스티커종류 · **계 · 시군구재고 · 대행소재고**. +**버튼**: `조회` · `엑셀저장` · `인쇄` · `실사선별조회`. -장부상 재고와 실제 창고 수량을 맞추는 작업입니다. 다음 순서로 진행합니다. +--- -``` -실사 선별 ─→ 실사 등록(작업) ─→ 적용 -``` +## 실사 (재고 확인) · *재고 관리 › 실사 선별 조회 / 실사 선별 관리* -| 단계 | 메뉴 | 하는 일 | -|---|---|---| -| ① 선별 | 실사 선별 조회 | 실사 대상 범위를 골라 선별 | -| ② 작업 | 실사 선별 관리 | 실제 수량을 입력·기록 | -| ③ 상세·적용 | 실사 상세 | 실사 결과를 확인하고 재고에 **적용** | +**실사**는 시스템에 적힌 수량(전산재고)과 **창고에서 직접 센 수량(실사재고)** 을 비교해 차이를 바로잡는 작업입니다. -### 실사 진행 순서 +**이 화면의 용어** +- **전산재고**: 시스템 기록상 수량. +- **실사재고**: 현장에서 직접 센 수량(직접 입력). +- **차이**: 실사 − 전산. (양수 = 더 많음, 음수 = 부족) +- **박스 / 팩 / 낱장**: 셀 단위. 팩코드·낱장(시작~끝) 구간으로 표시됩니다. -1. **선별**: 실사할 품목·구간을 선택해 실사 건을 만듭니다. -2. **등록**: 실제 센 수량을 입력합니다. 장부 수량과의 차이가 표시됩니다. -3. **적용**: 검토 후 적용하면 차이가 재고에 반영됩니다. +**작업 순서** +1. **실사 선별**: 실사할 기간·품목을 골라 대상 목록을 만듭니다(팝업에서 작업일자·품목 선택). +2. **실사재고 입력**: 팩/박스별로 실제 센 수량을 입력하면 **차이**가 자동 표시됩니다. +3. **저장(적용)**: 검토 후 적용하면 차이가 재고에 반영됩니다. -> 적용 전까지는 재고에 영향을 주지 않으므로, 입력 도중 중단해도 안전합니다. +**주요 표 컬럼**: 팩코드 · 포장량 · 재고(전산) · **실사재고(입력)** · 차이 · 낱장(시작) · 낱장(끝). + +> 적용 전까지는 재고에 영향을 주지 않으므로, 세는 도중 중단해도 안전합니다. diff --git a/app/Docs/manual/40_sales_issue.md b/app/Docs/manual/40_sales_issue.md index a1b48c7..d5e7872 100644 --- a/app/Docs/manual/40_sales_issue.md +++ b/app/Docs/manual/40_sales_issue.md @@ -1,46 +1,83 @@ -# 판매 · 불출 +# 판매 · 반품 · 불출 · 주문 -재고를 외부로 내보내는 두 가지 경로입니다. **판매**는 지정판매소 대상 유상 거래, **불출**은 무료 대상자에 대한 무상 지급입니다. +재고를 외부로 내보내는 단계입니다. **판매**(가게에 유상 공급)·**불출**(무료 배부)·**주문 접수**(전화 등). -## 판매 (지정판매소) +--- -**판매 관리** 메뉴에서 처리합니다. +## 지정판매소 판매 · *판매 관리 › 지정 판매소 판매* -| 작업 | 메뉴 | 설명 | -|---|---|---| -| 판매 등록 | 지정 판매소 판매 | 판매소를 선택해 판매 거래 기록 | -| 스캔 판매 | 지정 판매소 판매[스캔] | 바코드를 스캔하며 판매(판매소 현장용) | -| 판매 취소 | 지정 판매소 판매 취소 | 기존 판매 거래 취소 | -| 반품 | 지정 판매소 반품 | 판매분 반품 등록 | -| 반품 취소 | 지정 판매소 반품 취소 | 반품 취소 처리 | +동네 가게(지정판매소)에 봉투를 **판매**하고, 어떤 봉투를 줬는지 **바코드로 기록**합니다. -### 판매 등록 순서 +**이 화면의 용어** +- **판매소코드/상호/대표자**: 판매하는 가게 정보(검색해서 선택). +- **봉투코드(스캔)**: 내보내는 봉투의 바코드. 스캔/입력하면 어떤 LOT·포장단위인지 식별됩니다. +- **포장단위(Box/Pack/Sheet)**: 박스/팩/낱장. -1. 판매할 **지정판매소**를 선택합니다. -2. 봉투 **품목·수량**을 입력(또는 바코드 스캔)합니다. -3. 저장하면 재고가 감소하고 판매 내역이 기록됩니다. +**입력/순서** +1. 위에서 **판매소를 검색·선택**합니다(코드·상호·전화·주소로 검색). +2. 판매할 봉투 종류·수량을 고르거나 **봉투코드를 스캔**합니다. +3. `판매저장` → 재고가 줄고 판매 내역이 기록됩니다. -### 전화 접수(주문) +**표 컬럼**: (판매내역) 봉투종류·접수량·판매량·단가·판매금액 / (상세) 봉투종류·봉투코드·수량·포장단위. -| 작업 | 메뉴 | -|---|---| -| 전화 접수(신규) | 전화 접수 | -| 전화 접수 관리 | 전화 접수 관리(수정·취소) | +--- -## 불출 (무료 대상자) +## 지정 판매소 반품 / 판매·반품 취소 · *판매 관리* -**불출 관리** 메뉴에서 무료 대상자에게 봉투를 무상 지급합니다. +- **반품**: 가게가 안 팔린 봉투를 **되돌려 받는** 것. 스캔/선택 후 저장하면 재고가 다시 늘어납니다. +- **판매 취소 / 반품 취소**: 잘못 처리한 건을 되돌립니다. -| 작업 | 메뉴 | 설명 | -|---|---|---| -| 불출 처리 | 무료용 불출 처리 | 무료 배분 등록(재고 감소) | -| 불출 취소 | 무료용 불출 취소 | 불출 취소(재고 복원) | -| 불출 현황 | 무료 불출 현황 | 기간별 불출 기록 조회 | +--- -### 불출 처리 순서 +## 판매/반품 현황 · *판매 관리* 또는 *판매 현황* -1. 무료 **대상처**와 봉투 **품목·수량**을 선택합니다. -2. 저장하면 재고가 감소하고 불출 내역이 기록됩니다. -3. 잘못 처리한 경우 **무료용 불출 취소**로 되돌리면 재고가 복원됩니다. +기간별 판매·반품 내역을 봅니다. -> 판매·불출 모두 재고를 감소시키므로, 처리 후 **재고 현황**에서 반영 결과를 확인하세요. +**필터**: 조회기간. +**표 컬럼**: 판매소 · 판매일 · 봉투코드 · 봉투명 · 수량 · 단가 · 금액 · **구분(판매/반품/취소)**. +**버튼**: `조회` · `초기화` · `주문등록` · `판매등록`. + +--- + +## 전화 주문 접수 · *판매 관리 › 전화 접수* + +가게가 전화로 주문한 내용을 **접수**합니다(실제 출고/판매는 이후 단계). + +**이 화면의 용어** +- **접수일 / 배달일**: 주문 받은 날 / 가져다줄 날(보통 다음날 자동). +- **결제구분**: 이체 / 가상계좌. +- **1박스·1팩(낱장/판매가)**: 포장별 수량·가격 참고값. + +**입력/순서** +1. **판매소 검색·선택**(코드·사업자번호·상호·전화·주소). +2. 결제구분을 고르고, 봉투 **품목·주문수량·포장단위(박스/팩/낱장)** 를 입력(`행추가`로 여러 품목). +3. `등록` → 주문 접수 완료. + +> **주문 접수(간편)**: 판매소·배달일·결제방법과 봉투별 수량만 입력하는 간단 버전. + +--- + +## 무료용 불출 처리 · *불출 관리 › 무료용 불출 처리* + +무료 대상자(동사무소 등)에게 봉투를 **무상으로 내보내는(불출)** 화면입니다. + +**이 화면의 용어** +- **불출구분(무료용/공공용)**: 주민 무료 배부용 / 공공기관용. +- **불출처**: 봉투를 최종 전달할 곳(동사무소·구청·기타). +- **재고(낱장) / 환산(낱장)**: 현재 재고 / 입력 수량을 낱장으로 환산한 값. + +**입력/순서** +1. 불출년도·분기, 불출구분, 불출일, **불출처(동)** 를 고릅니다. +2. **바코드 스캔** 또는 `행추가`로 봉투 종류·수량·포장단위를 입력합니다. +3. `저장` → 재고가 줄고 불출 내역이 기록됩니다. + +**표 컬럼**: 봉투코드 · 봉투종류 · 수량 · 포장 · 재고(낱장) · 환산(낱장). + +--- + +## 무료용 불출 취소 · *불출 관리 › 무료용 불출 취소* + +잘못 불출한 건을 **되돌려 재고를 복원**합니다. + +**필터**: 불출월 · 불출처 · 불출구분 · 봉투종류. +**순서**: 불출 목록에서 건을 고르고, 품목 내역에서 **취소할 항목을 체크 → 취소수량 입력** 후 처리. diff --git a/app/Docs/manual/50_reports.md b/app/Docs/manual/50_reports.md index 96e6e81..c0019db 100644 --- a/app/Docs/manual/50_reports.md +++ b/app/Docs/manual/50_reports.md @@ -1,42 +1,63 @@ -# 판매현황 · 수불 · 통계 +# 현황 · 리포트 · 수불 -판매·재고 흐름을 집계해 보여주는 조회·리포트 화면 모음입니다. 대부분 **기간을 지정해 조회**하고 인쇄·엑셀로 내보낼 수 있습니다. +입고·판매·불출 기록을 **모아 보여주는** 조회 화면들입니다. 대부분 **기간을 지정해 조회**하고 `엑셀저장`·`인쇄`로 내보낼 수 있습니다. -## 판매 현황 +--- -| 메뉴 | 내용 | -|---|---| -| 지정 판매소 일/기간 판매대장 | 판매소별 일자·기간 거래 장부 | -| 일계표 | 하루 전체 판매 요약(일계 + 월 누계) | -| 기간별 판매현황 | 지정 기간의 판매 집계(일집계/기간집계) | -| 년 판매 현황 | 연간 판매 통계(월별/분기별) | -| 지정 판매소별 판매현황 | 판매소별 수량·금액 비교 | -| 홈텍스 처리 | 세금계산서용 데이터(엑셀) 생성 | +## 기간별 봉투 수불 현황 · *봉투 수불 관리 › 기간별 봉투 수불 현황* -## 봉투 수불 관리 +**수불(受拂)** = 들어오고 나간 움직임. 기간 동안 봉투가 얼마나 들어오고(입고) 나갔는지(판매·불출 등)를 한 표로 봅니다. -입고·판매·불출·반품·파기를 한데 모아 **수불(수입·불출)** 흐름을 봅니다. +**이 화면의 용어** +- **전일재고**: 조회 시작일 **전날**의 재고. +- **입고**: 입고량 + 반품 + 기타. +- **출고**: 판매 + 무료불출 + 반품 + 기타. +- **잔량**: 전일재고 + 입고 − 출고. -| 메뉴 | 내용 | -|---|---| -| 기간별 봉투 수불 현황 | 기간 내 재고/입고/판매/불출 종합(엑셀 가능) | -| 기타 입출고 | 손상·기증·폐기 등 기타 입출고 등록·조회 | -| 반품/파기 현황 | 반품 및 파기 내역 | -| LOT 수불 조회 | 봉투번호(바코드)·LOT 단위 이력 추적 | -| 쓰레기 봉투 수급 계획 | 공급·수요 계획 | +**필터**: 조회기간 · 봉투형식 · 봉투구분 · 대행소 · **집계방식(일자별/기간별)**. +**표 컬럼**: 일자 · 품목 · 전일재고 · 입고(소계) · 출고(소계) · 잔량. -### LOT 수불 조회 사용법 +--- -1. **봉투번호(바코드)** 또는 LOT 번호를 입력합니다. -2. 조회하면 해당 단위의 입고·판매·반품 이력이 표시됩니다. -3. 입력할 코드 형식이 헷갈리면 **도움말 › 번호알기**로 먼저 확인하세요. +## 일계표 · *판매 현황 › 일계표* -## 통계 분석 +하루치 판매를 **일계(당일)** 와 **누계(월 누적)** 로 집계합니다. -| 메뉴 | 내용 | -|---|---| -| 전년 대비 판매 분석 | 작년 동기 대비 비교(차트) | -| 월별 판매 추이 분석 | 월별 추이 시각화 | -| 계절별 판매 추이 분석 | 계절 패턴 분석 | +**용어**: **일계** = 그날 합계, **누계(월)** = 월초~당일 누적, **징수액** = 판매금액 − 수수료. +**필터**: 조회일자 · 대행소 · 구분. +**표**: 봉투종류별 — 일계(수량·판매금액·수수료·징수액) / 누계(월) 동일 항목. -> 리포트 화면은 조회 조건(기간·품목·판매소)을 바꿔가며 반복 조회할 수 있습니다. 결과는 인쇄 버튼 또는 엑셀 내보내기로 저장하세요. +--- + +## 지정 판매소별 판매현황 · *판매 현황 › 판매소별 판매현황* + +판매소마다 **얼마나 팔았는지**(수량 또는 금액)를 월별로 비교합니다. + +**필터**: 기간 · 읍면동 · 봉투종류 · **지표(수량/금액)**. +**표**: 판매소명 · 판매소코드 · 월별 값 · 합계. + +--- + +## LOT 수불 조회 · *봉투 수불 관리 › LOT 수불 조회* + +특정 **봉투번호(바코드)** 또는 **LOT**의 입고·판매·반품 **이력**을 추적합니다. + +**입력**: 봉투번호(바코드/팩코드/박스코드/낱장코드). +**표**: 일자 · 품목 · 포장단위 · **구분(입고/판매/반품)** · 수량 · LOT번호. +> 입력할 코드 형식이 헷갈리면 좌측 **[봉투·LOT·바코드 코드체계]** 또는 도움말의 **번호알기**를 참고하세요. + +--- + +## 반품/파기 현황 · *봉투 수불 관리 › 반품/파기 현황* + +**용어**: **반품** = 판매소가 되돌린 봉투(출고 탭) / **파기** = 반품분의 폐기(입고 탭). +**필터**: 조회기간 · 입출고구분. +**표**: 일자 · 판매소명 · 봉투종류 · 수량 · 구분(반품/파기). + +--- + +## 그 밖의 현황 +- **기간별 판매현황 / 년 판매 현황**: 기간·연도 단위 판매 집계. +- **지정 판매소 (일/기간) 판매대장**: 판매소별 거래 장부. +- **홈택스 처리**: 세금계산서용 데이터(엑셀) 생성. +- **통계 분석(전년대비·월별·계절 추이)**: 판매 추세를 그래프로. diff --git a/app/Docs/manual/60_basic_info.md b/app/Docs/manual/60_basic_info.md new file mode 100644 index 0000000..9334739 --- /dev/null +++ b/app/Docs/manual/60_basic_info.md @@ -0,0 +1,69 @@ +# 기본정보 (판매소 · 단가 · 코드) + +업무의 **기준이 되는 정보**를 관리하는 화면들입니다. 발주·판매가 이 값을 사용하므로 먼저 정확히 등록되어 있어야 합니다. + +--- + +## 지정판매소 관리 · *기본정보관리 › 지정 판매소 관리/조회* + +봉투를 파는 **가게(지정판매소)** 를 등록·조회합니다. + +**이 화면의 용어** +- **판매소번호**: 가게 고유 번호(지역코드 + 일련번호). +- **도로명주소 / 지번주소**: 두 가지 주소 체계(지도 표시·검색에 사용). +- **은행/계좌, 가상계좌**: 봉투 대금 결제용 계좌. + +**목록 표 컬럼**: 번호 · 판매소번호 · 상호명 · 대표자명 · 지역/읍면동 · 전화번호 · 주소. +**상세**: 사업자번호 · 우편번호 · 도로명/지번주소 · 이메일 · 결제 계좌 등. +> 목록에서 가게를 고르면 우측에 상세가 표시됩니다. (등록·수정은 관리자) + +--- + +## 단가 관리 · *기본정보관리 › 단가 관리* + +봉투 **가격**을 기간별로 관리합니다. + +**이 화면의 용어** +- **발주단가**: 제작업체에 주는 가격(살 때). +- **도매단가**: 대행소·판매소에 넘기는 도매 가격. +- **판매단가**: 최종 소비자 판매가. +- **수수료율**: 판매수수료율(%). +- **적용시작/종료**: 그 단가가 유효한 기간. + +**필터**: 봉투구분 · 봉투코드 · 조회기간. +**표 컬럼**: 봉투코드 · 봉투명 · 발주단가 · 도매단가 · 판매단가 · 수수료율 · 적용시작 · 적용종료 · 상태. +> 조회 전용이며, 등록·수정은 `단가관리(CRUD)` 화면에서 합니다(이력 보존). + +--- + +## 포장 단위 관리 · *기본정보관리 › 포장 단위 관리* + +봉투 1박스·1팩에 **몇 장이 들어가는지** 정의합니다. 이 값으로 박스↔낱장이 환산됩니다. + +**이 화면의 용어** +- **박스당 팩수**: 1박스 안의 팩 개수. +- **팩당 낱장수**: 1팩 안의 낱장(봉투) 수. +- **1박스 총 낱장** = 박스당 팩수 × 팩당 낱장수. + +**표 컬럼**: 봉투코드 · 봉투명 · 박스당팩수 · 팩당낱장수 · 1박스총낱장 · 적용시작/종료 · 상태(사용/만료). + +--- + +## 기본코드 관리 · *기본정보관리 › 기본 코드 관리* + +시스템 곳곳의 **선택 항목(드롭다운)** 값을 관리합니다. 왼쪽에 **코드 종류**, 오른쪽에 그 종류의 **세부코드**가 나옵니다. + +**이 화면의 용어** +- **코드 종류**: 분류(예: 봉투구분, 동코드, 결제구분, 불출구분). +- **세부코드**: 그 분류의 실제 값(예: 봉투구분 → 봉투/스티커). + +**자주 쓰는 코드 종류** +- **봉투구분**(봉투/스티커) · **동코드**(지역 동) · **결제구분**(이체/가상계좌) · **불출구분**(무료용/공공용). + +**표 컬럼**: 코드 · 코드명 · (세부코드 개수) · 상태(사용/미사용) · 작업(수정/삭제 — 관리자). +> 등록·수정·삭제는 슈퍼 관리자만 가능합니다. 조회는 누구나 가능합니다. + +--- + +## 그 밖의 기본정보 +- **판매 대행소 / 담당자 / 업체(제작·협회·회수) / 무료용 대상자 관리**: 각각 거래처·담당자·대상처를 등록·조회하는 목록 화면입니다(등록·수정은 관리자). diff --git a/app/Helpers/admin_helper.php b/app/Helpers/admin_helper.php index 853ab8b..aba61be 100644 --- a/app/Helpers/admin_helper.php +++ b/app/Helpers/admin_helper.php @@ -936,3 +936,32 @@ if (! function_exists('gov_portal_nav_partial_vars')) { return $out; } } + +if (! function_exists('manual_help_url_for_path')) { + /** + * 현재(또는 주어진) 화면 경로에 대응하는 매뉴얼 URL. 매칭 없으면 ''. + * Config\Manual::$screenHelp 의 가장 긴(구체적) 접두를 우선 매칭한다. + */ + function manual_help_url_for_path(?string $path = null): string + { + helper('url'); + $path = strtolower(trim($path ?? current_nav_request_path(), '/')); + if ($path === '') { + return ''; + } + $map = config(\Config\Manual::class)->screenHelp ?? []; + $bestSlug = ''; + $bestLen = -1; + foreach ($map as $prefix => $slug) { + $p = strtolower((string) $prefix); + if ($path === $p || str_starts_with($path . '/', $p . '/')) { + if (strlen($p) > $bestLen) { + $bestLen = strlen($p); + $bestSlug = (string) $slug; + } + } + } + + return $bestSlug !== '' ? base_url('bag/manual/' . $bestSlug) : ''; + } +} diff --git a/app/Views/bag/dashboard_portal.php b/app/Views/bag/dashboard_portal.php index 9b1f549..7da50e6 100644 --- a/app/Views/bag/dashboard_portal.php +++ b/app/Views/bag/dashboard_portal.php @@ -202,6 +202,8 @@ $donutCss = $donutStops !== [] ? implode(', ', $donutStops) : '#e5e7eb 0% 100%'; // 뒤로가기(bfcache 복원)·탭 복귀 시에도 최근 목록 갱신 window.addEventListener('pageshow', renderRecent); document.addEventListener('visibilitychange', function () { if (!document.hidden) renderRecent(); }); + // 다른 탭(iframe)에서 메뉴를 방문해 기록이 바뀌면 즉시 반영 + window.addEventListener('storage', function (e) { if (e.key === 'jrj_recent_menus') renderRecent(); }); })(); diff --git a/app/Views/bag/layout/embed.php b/app/Views/bag/layout/embed.php index fc5f8e3..cbe264d 100644 --- a/app/Views/bag/layout/embed.php +++ b/app/Views/bag/layout/embed.php @@ -9,6 +9,8 @@ declare(strict_types=1); * @var bool $bare true면 본문을 카드 래퍼 없이 그대로 출력(대시보드용) */ $bare = ! empty($bare); +helper('admin'); +$helpUrl = function_exists('manual_help_url_for_path') ? manual_help_url_for_path() : ''; ?> @@ -50,8 +52,15 @@ tailwind.config = {
- -

+ +
+

+ + + 이 화면 설명 + + +
getFlashdata('success')): ?>
getFlashdata('success')) ?>
@@ -73,6 +82,61 @@ tailwind.config = { if (window.top !== window.self && /\/login(\/|$)/.test(location.pathname)) { try { window.top.location.href = location.href; } catch (e) {} } + + // 방문한 업무 메뉴 경로 기록 (대시보드 "최근 방문 메뉴"용). localStorage 는 동일 출처 탭과 공유된다. + try { + var rp = (location.pathname || '').replace(/\/+$/, '') || '/'; + if (rp !== '/' && !/\/login|\/logout|\/register|\/manual/.test(rp)) { + var RK = 'jrj_recent_menus'; + var ra = JSON.parse(localStorage.getItem(RK) || '[]'); + if (!Array.isArray(ra)) ra = []; + ra = ra.filter(function (x) { return x && x.p && x.p !== rp; }); + ra.unshift({ p: rp, t: Date.now() }); + localStorage.setItem(RK, JSON.stringify(ra.slice(0, 12))); + } + } catch (e) {} + + // 탭(iframe) 안에서의 링크·폼 이동은 항상 embed 유지 → 중첩 헤더/사이드바 방지 + function withEmbed(href) { + try { + var u = new URL(href, location.href); + if (u.origin !== location.origin) return null; + if (u.searchParams.get('embed') === '1') return null; + u.searchParams.set('embed', '1'); + return u.href; + } catch (e) { return null; } + } + // "이 화면 설명" → 워크스페이스 새 탭으로 매뉴얼 열기(없으면 새 창) + document.addEventListener('click', function (e) { + var h = e.target.closest ? e.target.closest('a.embed-help') : null; + if (!h) return; + e.preventDefault(); e.stopPropagation(); + var url = h.getAttribute('href'); + try { + if (window.parent && window.parent !== window && typeof window.parent.wsOpenTab === 'function') { + window.parent.wsOpenTab(url, '도움말'); return; + } + } catch (err) {} + window.open(url, '_blank'); + }, true); + + document.addEventListener('click', function (e) { + var a = e.target.closest ? e.target.closest('a[href]') : null; + if (!a || a.classList.contains('embed-help')) return; + var t = (a.getAttribute('target') || '').toLowerCase(); + if (t && t !== '_self') return; + if (a.hasAttribute('download')) return; + var href = a.getAttribute('href') || ''; + if (!href || href.charAt(0) === '#' || /^(javascript:|mailto:|tel:|data:)/i.test(href)) return; + var ne = withEmbed(href); + if (ne) a.setAttribute('href', ne); + }, true); + document.addEventListener('submit', function (e) { + var f = e.target; + if (!f || f.tagName !== 'FORM') return; + var ne = withEmbed(f.getAttribute('action') || location.href); + if (ne) f.setAttribute('action', ne); + }, true); // 표 '번호' 컬럼 역순 채번 (사이트 레이아웃과 동일) var run = function () { document.querySelectorAll('table').forEach(function (table) { diff --git a/app/Views/bag/layout/portal.php b/app/Views/bag/layout/portal.php index bc1e2de..874f1ee 100644 --- a/app/Views/bag/layout/portal.php +++ b/app/Views/bag/layout/portal.php @@ -35,6 +35,7 @@ if ($effectiveLgIdx) { $lgRow = model(\App\Models\LocalGovernmentModel::class)->find($effectiveLgIdx); $lgLabel = $lgRow ? (string) $lgRow->lg_name : ''; } +$helpUrl = function_exists('manual_help_url_for_path') ? manual_help_url_for_path() : ''; ?> @@ -116,7 +117,14 @@ tailwind.config = {
-

+ getFlashdata('success')): ?>
getFlashdata('success')) ?>
diff --git a/app/Views/bag/layout/workspace.php b/app/Views/bag/layout/workspace.php index 64860c8..e809b31 100644 --- a/app/Views/bag/layout/workspace.php +++ b/app/Views/bag/layout/workspace.php @@ -47,7 +47,8 @@ if ($effectiveLgIdx) { .ws-tab { display: inline-flex; align-items: center; gap: .4rem; max-width: 200px; padding: .35rem .6rem; background: #f5f7fa; border: 1px solid var(--border); border-bottom: none; border-radius: 7px 7px 0 0; font-size: .78rem; color: #555; cursor: pointer; white-space: nowrap; } .ws-tab .t-name { overflow: hidden; text-overflow: ellipsis; max-width: 150px; } .ws-tab.active { background: #fff; color: var(--navy); font-weight: 700; box-shadow: 0 -2px 0 #007bff inset; } - .ws-tab .t-close { width: 16px; height: 16px; line-height: 14px; text-align: center; border-radius: 50%; color: #999; font-size: 12px; } + .ws-tab .t-refresh, .ws-tab .t-close { width: 16px; height: 16px; line-height: 14px; text-align: center; border-radius: 50%; color: #999; font-size: 12px; } + .ws-tab .t-refresh:hover { background: #dbeafe; color: #1d4ed8; } .ws-tab .t-close:hover { background: #e2e8f0; color: #333; } .ws-panels { flex: 1; position: relative; min-height: 0; background: #f0f4f8; } .ws-frame { position: absolute; inset: 0; width: 100%; height: 100%; border: 0; display: none; background: #f0f4f8; } @@ -114,6 +115,13 @@ if ($effectiveLgIdx) { if (empty) empty.style.display = 'none'; } + function reloadTab(id) { + var t = tabs[id]; + if (!t) return; + try { t.frame.contentWindow.location.reload(); } + catch (e) { t.frame.src = t.frame.src; } // 교차출처 등 예외 시 src 재설정 + } + function closeTab(id) { if (!tabs[id]) return; tabs[id].frame.remove(); @@ -142,11 +150,20 @@ if ($effectiveLgIdx) { var nameSpan = document.createElement('span'); nameSpan.className = 't-name'; nameSpan.textContent = title || '탭'; + var refresh = document.createElement('span'); + refresh.className = 't-refresh'; + refresh.textContent = '↻'; + refresh.title = '이 탭 새로고침'; var close = document.createElement('span'); close.className = 't-close'; close.textContent = '×'; - btn.appendChild(nameSpan); btn.appendChild(close); - btn.addEventListener('click', function (e) { if (e.target === close) { closeTab(id); } else { activate(id); } }); + close.title = '탭 닫기'; + btn.appendChild(nameSpan); btn.appendChild(refresh); btn.appendChild(close); + btn.addEventListener('click', function (e) { + if (e.target === close) { closeTab(id); } + else if (e.target === refresh) { activate(id); reloadTab(id); } + else { activate(id); } + }); bar.appendChild(btn); tabs[id] = { url: url, title: title, frame: frame, btn: btn }; @@ -160,8 +177,8 @@ if ($effectiveLgIdx) { var a = e.target.closest('a[href]'); if (!a) return; var href = a.getAttribute('href') || ''; - // 외부/특수 링크(로그아웃, 지자체선택 등 사이드바 하단 블록)는 그대로 이동 - if (a.closest('.sidebar-blocks')) return; + // 지자체 선택(sb-gray)·모바일앱(sb-teal)은 그대로 이동, 나머지(소메뉴·하단 링크)는 탭으로 + if (a.closest('.sb-gray') || a.closest('.sb-teal')) return; if (/\/logout|\/login/.test(href) || href.charAt(0) === '#' || href === '') return; e.preventDefault(); openTab(href, (a.textContent || '').trim()); @@ -177,6 +194,15 @@ if ($effectiveLgIdx) { }); }); + // 브라우저 전체 새로고침/이탈 시 경고 (기본 대시보드 외 탭이 열려 있을 때) + window.addEventListener('beforeunload', function (e) { + if (order.length > 1) { + e.preventDefault(); + e.returnValue = '열어 둔 탭이 모두 닫힙니다. 계속할까요?'; + return e.returnValue; + } + }); + // 첫 화면: 대시보드 탭 자동 열기 openTab('', '업무 현황'); })(); diff --git a/app/Views/home/_dashboard_gov_portal_sidebar.php b/app/Views/home/_dashboard_gov_portal_sidebar.php index a26e42f..8260d0a 100644 --- a/app/Views/home/_dashboard_gov_portal_sidebar.php +++ b/app/Views/home/_dashboard_gov_portal_sidebar.php @@ -52,7 +52,7 @@ $activeChildHref = strtolower(ltrim((string) ($govActiveChildHref ?? ''), '/'));
나의 할일 - 종합·그래프 + 사용자 매뉴얼 FAQ
diff --git a/e2e/qa_sweep.spec.js b/e2e/qa_sweep.spec.js new file mode 100644 index 0000000..8e51cc9 --- /dev/null +++ b/e2e/qa_sweep.spec.js @@ -0,0 +1,95 @@ +const { test, expect } = require('@playwright/test'); +const { login } = require('./helpers/auth'); + +/** + * 전체 점검 스윕 — 주요 화면 콘솔에러·차단 오버레이 점검 + 매뉴얼/도움말/워크스페이스 통합 검증. + */ +async function selectDaegu(page) { + await page.goto('/admin/select-local-government'); + await page.evaluate(() => { + const r = document.querySelector('input[name="lg_idx"][value="1"]'); + if (r) { r.checked = true; r.form.submit(); } + }); + await page.waitForTimeout(700); +} + +// kakao 외부 SDK 관련(도메인 미등록 환경) 잡음은 제외 +function appError(msg) { + return !/kakao|dapi\.kakao|sdk\.js|OPEN_MAP_AND_LOCAL|appkey/i.test(msg); +} + +const PAGES = [ + '/', '/bag/inventory', '/bag/order/create', '/bag/bag-orders', + '/bag/receiving/scanner', '/bag/receiving/batch', '/bag/sale/designated', + '/bag/issue/create', '/bag/issue', '/bag/flow', '/bag/sales', + '/bag/reports/daily-summary', '/bag/reports/lot-flow', '/bag/reports/returns', + '/bag/bag-prices', '/bag/packaging-units', '/bag/code-kinds', + '/bag/designated-shops', '/bag/designated-shops/browse', '/bag/number-lookup', + '/bag/manual', '/admin', '/admin/menus', '/admin/users', '/admin/access/login-history', +]; + +test.describe('QA 스윕', () => { + test('주요 화면 콘솔 에러·차단 오버레이 점검', async ({ page }) => { + await login(page, 'admin'); + await selectDaegu(page); + const problems = []; + for (const url of PAGES) { + const errs = []; + page.removeAllListeners('pageerror'); + page.on('pageerror', (e) => { if (appError(String(e))) errs.push(String(e)); }); + const res = await page.goto(url, { waitUntil: 'domcontentloaded' }); + await page.waitForTimeout(700); + const status = res ? res.status() : 0; + const cover = await page.evaluate(() => { + const cx = Math.floor(innerWidth / 2), cy = Math.floor(innerHeight / 2); + let n = 0; + document.querySelectorAll('*').forEach((el) => { + const s = getComputedStyle(el); + if ((s.position === 'fixed' || s.position === 'absolute') && s.display !== 'none' && + s.visibility !== 'hidden' && parseFloat(s.opacity || '1') > 0.1 && s.pointerEvents !== 'none') { + const r = el.getBoundingClientRect(); + if (r.width >= innerWidth * 0.85 && r.height >= innerHeight * 0.7 && + !/portal-header|sidebar|ws-/.test(el.className || '')) n++; + } + }); + return n; + }); + if (status >= 400) problems.push(`${url} → HTTP ${status}`); + if (errs.length) problems.push(`${url} → JS오류: ${errs[0]}`); + if (cover > 0) problems.push(`${url} → 화면 덮는 오버레이 ${cover}개`); + } + console.log('>>> SWEEP problems=' + JSON.stringify(problems, null, 0)); + expect(problems, problems.join('\n')).toEqual([]); + }); + + test('매뉴얼 전체 페이지 렌더', async ({ page }) => { + await login(page, 'user'); + const slugs = ['overview', 'flow', 'order', 'inventory', 'sales', 'reports', 'basic', 'codes', 'faq']; + for (const s of slugs) { + const res = await page.goto('/bag/manual/' + s, { waitUntil: 'domcontentloaded' }); + expect(res.status(), s).toBe(200); + await expect(page.locator('.manual-prose')).not.toBeEmpty(); + } + // 미등록 slug → 404 + const bad = await page.goto('/bag/manual/zzz-none', { waitUntil: 'domcontentloaded' }); + expect(bad.status()).toBe(404); + }); + + test('이 화면 설명 매핑 정확', async ({ page }) => { + await login(page, 'admin'); + await selectDaegu(page); + const cases = [ + ['/bag/inventory', 'inventory'], + ['/bag/order/create', 'order'], + ['/bag/sale/designated', 'sales'], + ['/bag/flow', 'reports'], + ['/bag/bag-prices', 'basic'], + ['/bag/number-lookup', 'codes'], + ]; + for (const [url, slug] of cases) { + await page.goto(url, { waitUntil: 'domcontentloaded' }); + const href = await page.locator('a.no-print', { hasText: '이 화면 설명' }).first().getAttribute('href'); + expect(href, url).toContain('/bag/manual/' + slug); + } + }); +});