Mublo Framework v1.4.0 을 릴리즈했습니다. 이번 버전은 전자상거래법이 요구하는 상품정보제공고시를 상품 등록 화면에서 입력하고 상세페이지에 표로 보여주는 것이 중심입니다. 관리자 메뉴 이름 두 개를 하는 일에 맞춰 고쳤고, 쇼핑몰 매뉴얼의 잘못된 안내와 관리자 화면의 정렬 문제를 고쳤습니다. 데이터베이스 마이그레이션 1건(Shop 034)이 포함됩니다. 파일 삭제는 없습니다.

상품정보제공고시를 상품에 입력하고, 상세페이지가 표로 보여줍니다

전자상거래법이 요구하는 상품정보제공고시는 그동안 운영자가 상세설명 이미지 안에 직접 그려 넣는 수밖에 없었습니다. 품목마다 어떤 항목이 필요한지 매번 찾아봐야 했고, 이미지라 검색도 복사도 되지 않았습니다.

• 상품 등록·수정 화면에 상품정보제공고시 탭이 생깁니다. 품목을 고르면 그 품목의 고시 항목이 입력란으로 펼쳐집니다 — 의류를 고르면 제품 소재·색상·치수·제조국처럼.
• 현행 고시(공정거래위원회고시 제2022-15호, 2023-01-01 시행)의 품목 40개와 항목 336개를 기본으로 싣습니다. 의류·구두/신발·가방·가구·화장품·가공식품·건강기능식품·어린이제품부터 여행패키지·항공권·모바일 쿠폰·기타 용역까지 고시가 정한 품목을 그대로 담았습니다.
• 입력한 값은 상품 상세의 상세설명 아래에 표로 나옵니다.
• 비워 둔 항목은 상세설명 참조로 채웁니다. 고시는 항목을 생략하는 대신 어디를 보라고 안내하는 것을 허용하며, 빈 칸으로 두면 안내 자체가 없는 것이 되기 때문입니다. 모든 항목은 선택 입력이고, 품목을 고르지 않으면 아무것도 저장하지 않습니다.

고시가 개정되어도 이미 등록한 상품은 그대로입니다

항목이 바뀌는 개정이 있어도 기존 상품은 등록 당시의 양식과 값을 그대로 보여줍니다. 어제 등록한 상품의 상세페이지가 오늘 개정 때문에 빈 칸투성이가 되는 일을 막기 위해서입니다.

관리자 화면에는 양식 버전을 노출하지 않습니다. 운영자가 할 일은 품목을 고르고 값을 적는 것이지 양식 버전을 관리하는 것이 아니기 때문입니다. 예전 양식으로 저장된 상품을 열면 품목 이름 옆에 (기존 양식)만 붙습니다. 값은 항목 코드로 저장하므로 나중에 최신 양식으로 옮길 때 같은 코드의 값은 그대로 승계됩니다.

관리자 메뉴 이름 두 개가 바뀝니다

• 쇼핑몰 → 옵션 프리셋 → 상품옵션 프리셋. 옵션만으로는 주문 옵션·배송 옵션과 헷갈릴 자리가 있어, 이 프리셋이 무엇의 옵션인지를 이름이 말하게 했습니다.
• 쇼핑몰 → 쿠폰 관리 → 할인쿠폰. 옆에 선 등급별 혜택·기획전이 다 관리 없이 대상만 부르는데 쿠폰만 관리가 붙어 있었습니다.

바뀌는 것은 메뉴 라벨과 화면 문구, 안내 메시지뿐입니다. 주소(/admin/shop/options, /admin/shop/coupons)와 데이터는 그대로라 북마크를 고칠 필요가 없습니다.

고친 것

• 쇼핑몰 매뉴얼이 없어진 화면을 계속 안내하던 것을 고쳤습니다. 등급별 혜택 화면은 값을 입력받기만 하고 어떤 계산에도 연결되지 않아 1.2.0 에서 제거됐는데, 매뉴얼은 그대로 남아 /admin/shop/level-pricing 으로 가라고 안내했습니다 — 열리지 않는 주소입니다. 등급별 할인·적립은 쇼핑몰 설정의 할인·적립 유형에서 레벨별을 고르는 방식이며, 그 자리를 가리키도록 고쳤습니다. 제공하지 않는 등급별 무료배송·자동 쿠폰도 명시했습니다. 이미 매뉴얼을 가져간 사이트는 관리자 → 매뉴얼 관리에서 개정본을 반영할 수 있습니다.
• 관리자 사이드바 하위메뉴의 아이콘이 글자보다 크게 보이던 것을 고쳤습니다. 1뎁스 메뉴의 아이콘 크기를 고정하는 규칙이 후손 선택자여서 하위메뉴 링크의 아이콘까지 함께 잡았고, 하위메뉴는 글자가 작은데 아이콘만 1뎁스 크기로 남아 한 칸 튀었습니다. 코어 메뉴의 하위 항목에는 아직 아이콘이 없어 기본 화면은 달라지지 않으며, 메뉴 라벨에 아이콘 마크업을 넣어 쓰는 경우에 적용됩니다.
• 관리자 목록 상단의 현황 카운터가 옆 컨트롤과 높이를 맞춥니다. 같은 줄의 form-select-sm·form-control-sm 은 1px 테두리를 가지는데 카운터에는 테두리가 없어, 세로 가운데는 맞아도 위아래 끝선이 2px 어긋났습니다. 이제 카운터도 같은 두께의 투명 테두리를 가집니다. 색과 여백은 그대로입니다.

호환성 주의 (커스텀 확장·스킨 개발자)

번들 스킨은 모두 대응되어 있습니다. 직접 만든 것이 있다면 확인해 주세요.

• 커스텀 관리자 상품 등록·수정 스킨을 쓴다면 확인이 필요합니다. 상품 저장은 폼이 보낸 product_notice 값을 그대로 반영하므로, 고시 입력 필드가 없는 커스텀 폼으로 상품을 저장하면 값이 비어 온 것으로 보고 그 상품의 고시가 지워집니다. 고시를 쓸 계획이라면 폼에 product_notice[template_id] 와 product_notice[values][{field_code}] 를 추가하세요. 참고할 마크업은 packages/Shop/views/Admin/Product/Form.php 의 고시 탭에 있습니다.
• 커스텀 프론트 상품 스킨은 상품 상세 데이터에 product_notice 키가 추가되었습니다(fields — 항목 목록, values — 항목 코드별 입력값). 스킨이 이 값을 그리지 않으면 고시 표가 나오지 않을 뿐 화면이 깨지지는 않습니다. 표 마크업은 packages/Shop/views/Front/Product/basic/View.php 를 참고하세요.
• 커스텀 관리자 프레임 스킨을 쓴다면 이번 CSS 수정 두 건(views/Admin/frame/basic/_assets/css/admin.css)을 옮겨야 적용됩니다.
• 새로 생긴 확장 지점: ProductService::getCurrentNoticeTemplates(), ProductRepository 의 getCurrentNoticeTemplates()·getProductNotice()·saveProductNotice()·deleteProductNotice()·noticeTemplateExists(). 기존 메서드의 시그니처가 바뀐 것은 없습니다.
• 상품옵션 프리셋(구 옵션 프리셋) 변경은 라벨과 안내 문구뿐입니다. 클래스명·메서드명·라우트·테이블은 그대로입니다.

업그레이드 방법

새로 설치: 릴리스 페이지의 전체 배포본 MubloFramework-v1.4.0.zip 을 사용하세요. vendor 가 포함되어 있어 composer 없이 설치할 수 있습니다.

v1.3.0 에서 업그레이드: 패치 zip(mublo-1.3.0-to-1.4.0-patch.zip, 변경 파일 27개)을 설치 루트에 덮어쓰고 마이그레이션을 실행하면 됩니다. 이번 릴리즈는 삭제할 파일이 없습니다.

마이그레이션 1건을 반드시 실행하세요.
관리자 → 시스템 → 마이그레이션 에서 대기 중인 항목(Shop 034)을 실행합니다. 마이그레이션은 자동으로 적용되지 않으며, 파일만 바꾸고 실행하지 않으면 고시 탭에 품목이 하나도 뜨지 않고 상품 상세 조회가 없는 테이블을 읽습니다. 대시보드에 알림이 뜨지 않으므로 직접 확인해야 합니다.

이 마이그레이션은 기존 데이터를 고쳐 쓰지 않습니다. 표 4개(shop_product_notice_templates, shop_product_notice_template_fields, shop_product_notices, shop_product_notice_values)를 새로 만들고 고시 품목 40개·항목 336개를 넣습니다.

이번 릴리즈는 composer 의존성 변경이 없으므로 vendor 디렉토리는 건드리지 않아도 됩니다. 자세한 절차는 패치 zip 안의 PATCH-NOTES.txt 를 참고하세요.

v1.3.0 미만에서 올라오는 경우에는 먼저 v1.3.0 까지의 업그레이드 절차를 완료한 뒤 이 패치를 적용하거나, 전체 배포본으로 파일을 교체하세요.

상세 변경 내역

• 릴리스 페이지 (배포 zip 다운로드): github.com/wwiz-mublo/mublo/releases/tag/v1.4.0
• 전체 코드 변경 비교 (v1.3.0 → v1.4.0, 파일 단위 diff): github.com/wwiz-mublo/mublo/compare/v1.3.0...v1.4.0
• CHANGELOG: CHANGELOG.md 의 [1.4.0] 섹션

이번 릴리즈에 포함된 PR 목록입니다. 각 링크에서 해당 변경의 코드와 논의를 볼 수 있습니다.

• #46 — Shop: 관리자 메뉴 이름을 하는 일에 맞춰 정리
• #47 — Shop: 상품에 상품정보제공고시를 입력하고 상세페이지에 표시
• #48 — 관리자: 사이드바 아이콘 크기 규칙이 하위메뉴로 새지 않게 수정
• #49 — 관리자: 현황 카운터가 옆 컨트롤과 높이를 맞추게 수정