From f7bf73a719948b0231c93c579c1de17ac4beca95 Mon Sep 17 00:00:00 2001 From: zenn Date: Fri, 24 Jul 2026 11:59:02 +0900 Subject: [PATCH] =?UTF-8?q?=EB=B8=8C=EB=9E=9C=EB=93=9C=20=EC=84=A4?= =?UTF-8?q?=EC=A0=95=20=EC=A0=95=EA=B7=9C=ED=99=94=20=EB=A1=9C=EC=A7=81=20?= =?UTF-8?q?=EB=B6=84=EB=A6=AC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/map.md | 1 + docs/todo.md | 2 +- docs/update.md | 6 ++++ lib/admin-brand-settings-section.js | 48 +++++++++++++++++++++++++++++ package-lock.json | 4 +-- package.json | 2 +- pages/admin/settings/index.vue | 32 +++++++++++-------- 7 files changed, 78 insertions(+), 17 deletions(-) create mode 100644 lib/admin-brand-settings-section.js diff --git a/docs/map.md b/docs/map.md index 60804c5..8117f1b 100644 --- a/docs/map.md +++ b/docs/map.md @@ -31,6 +31,7 @@ | lib/admin-social-settings-section.js | 관리자 설정 SNS 설정 필드 목록·기본 스냅샷·정규화·스냅샷 복사·변경 비교 helper | | lib/admin-post-settings-section.js | 관리자 설정 POST 설정 필드 목록·기본 스냅샷·정규화·스냅샷 복사·변경 비교 helper | | lib/admin-spam-settings-section.js | 관리자 설정 스팸 필터 필드 목록·기본 스냅샷·정규화·textarea 변환·스냅샷 복사·변경 비교 helper | +| lib/admin-brand-settings-section.js | 관리자 설정 브랜드 설정 필드 목록·기본 스냅샷·정규화·스냅샷 복사·변경 비교 helper | | lib/post-card-thumbnail-url.js | 게시물 카드 썸네일 `thumbs/*-card.webp`, Pages 커버 썸네일 `thumbs/*-page-cover.webp`, 본문 표시용 `body-1600`/`body-720`·라이트박스용 `body-2560` 파생 이미지 URL 판별과 레거시 `body`/`lightbox` 판별, 자동 생성 이미지 캐시 버전 URL 생성(대표 이미지·본문 이미지·갤러리·Pages 커버 선택 및 서버 검증 공용) | | lib/external-favicon-url.js | 외부 URL origin 기준 Google `gstatic.com/faviconV2` 파비콘 URL 생성(내부 경로는 빈 문자열) | | lib/navigation-url.js | 네비게이션 URL 접두사 분리·합성·정규화(`https://` 자동 보정, `/` 내부 경로) | diff --git a/docs/todo.md b/docs/todo.md index b006677..f8e2783 100644 --- a/docs/todo.md +++ b/docs/todo.md @@ -4,7 +4,7 @@ - 거대 컴포넌트 책임 분리 진행. - `components/admin/AdminMarkdownEditor.vue`: 미디어 모달, 슬래시 명령, 히스토리·선택 복원, 라이브/소스 전환 로직을 단계적으로 composable 또는 하위 컴포넌트로 분리. - - `pages/admin/settings/index.vue`: 정규화가 필요한 설정 섹션(브랜드·어나운스 바)의 편집 상태·스냅샷·저장 요청 로직을 composable 단위로 추가 분리. + - `pages/admin/settings/index.vue`: 정규화가 필요한 설정 섹션(어나운스 바)의 편집 상태·스냅샷·저장 요청 로직을 composable 단위로 추가 분리. - `components/content/ContentMarkdownRenderer.vue`: 파싱·블록 렌더링·라이브 편집 중개·라이트박스·광고 삽입 책임을 분리. - `components/admin/AdminPostForm.vue`: 태그 입력, 대표 이미지 선택, 발행/초안 저장 상태, 우측 설정 패널 책임을 분리. - `pages/admin/media/index.vue`: 미디어 목록, 폴더 트리, 상세 모달, 재생성 액션을 작은 단위로 분리. diff --git a/docs/update.md b/docs/update.md index 3c85671..c142faa 100644 --- a/docs/update.md +++ b/docs/update.md @@ -1,5 +1,11 @@ # 업데이트 이력 +## v1.11.38 + +- 브랜드 설정 정규화·스냅샷 복사·변경 비교 로직을 `lib/admin-brand-settings-section.js`로 분리. +- 설정 화면의 브랜드 컬러 입력 정규화와 편집 시작·취소·저장 로직을 공통 helper 기반으로 정리. +- 설정 저장 payload의 브랜드 설정 필드 정규화를 한 경로로 통합. + ## v1.11.37 - 스팸 필터 설정 정규화·스냅샷 복사·변경 비교 로직을 `lib/admin-spam-settings-section.js`로 분리. diff --git a/lib/admin-brand-settings-section.js b/lib/admin-brand-settings-section.js new file mode 100644 index 0000000..193fb44 --- /dev/null +++ b/lib/admin-brand-settings-section.js @@ -0,0 +1,48 @@ +import { + DEFAULT_BRAND_COLOR, + normalizeBrandColor +} from './brand-color.js' + +export const BRAND_SETTINGS_FIELDS = ['brandColor'] + +/** + * 브랜드 설정 기본 스냅샷을 만든다. + * @returns {Object} 기본 브랜드 설정 값 + */ +export const createDefaultBrandSettingsSnapshot = () => ({ + brandColor: DEFAULT_BRAND_COLOR +}) + +/** + * 브랜드 설정 값을 저장·비교 가능한 형태로 정규화한다. + * @param {Object} source - 원본 설정 값 + * @returns {Object} 정규화된 브랜드 설정 값 + */ +export const normalizeBrandSettingsSection = (source = {}) => ({ + brandColor: normalizeBrandColor(source.brandColor || DEFAULT_BRAND_COLOR) +}) + +/** + * 브랜드 설정 필드만 대상 객체에 복사한다. + * @param {Object} target - 값을 받을 객체 + * @param {Object} source - 값을 제공할 객체 + * @returns {void} + */ +export const assignBrandSettingsSection = (target, source = {}) => { + const normalized = normalizeBrandSettingsSection(source) + BRAND_SETTINGS_FIELDS.forEach((field) => { + target[field] = normalized[field] + }) +} + +/** + * 두 브랜드 설정 값이 다른지 확인한다. + * @param {Object} current - 현재 설정 값 + * @param {Object} snapshot - 비교할 스냅샷 + * @returns {boolean} 변경 여부 + */ +export const hasBrandSettingsSectionChanges = (current, snapshot) => { + const normalizedCurrent = normalizeBrandSettingsSection(current) + const normalizedSnapshot = normalizeBrandSettingsSection(snapshot) + return BRAND_SETTINGS_FIELDS.some((field) => normalizedCurrent[field] !== normalizedSnapshot[field]) +} diff --git a/package-lock.json b/package-lock.json index 3042e4f..205c406 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "sori.studio", - "version": "1.11.37", + "version": "1.11.38", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "sori.studio", - "version": "1.11.37", + "version": "1.11.38", "hasInstallScript": true, "dependencies": { "@nuxtjs/tailwindcss": "^6.14.0", diff --git a/package.json b/package.json index 112ae36..2abaeb1 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "sori.studio", - "version": "1.11.37", + "version": "1.11.38", "private": true, "type": "module", "imports": { diff --git a/pages/admin/settings/index.vue b/pages/admin/settings/index.vue index 655582d..8d7e078 100644 --- a/pages/admin/settings/index.vue +++ b/pages/admin/settings/index.vue @@ -5,7 +5,6 @@ import { normalizeAnnouncementAlignment, normalizeAnnouncementBackgroundColor } from '~/lib/announcement-bar.js' -import { DEFAULT_BRAND_COLOR, normalizeBrandColor } from '~/lib/brand-color.js' import { DISPLAY_COUNT_OPTIONS, POST_LIST_COUNT_OPTIONS @@ -38,6 +37,13 @@ import { normalizeSpamSettingsSection, parseSpamBlockedUsernamesText } from '~/lib/admin-spam-settings-section.js' +import { + BRAND_SETTINGS_FIELDS, + assignBrandSettingsSection, + createDefaultBrandSettingsSnapshot, + hasBrandSettingsSectionChanges, + normalizeBrandSettingsSection +} from '~/lib/admin-brand-settings-section.js' definePageMeta({ layout: 'admin' @@ -174,9 +180,7 @@ const homeCoverSnapshot = reactive({ homeCoverText: '' }) /** 편집 시작 시점의 브랜드 설정(취소 시 복원용) */ -const brandSnapshot = reactive({ - brandColor: DEFAULT_BRAND_COLOR -}) +const brandSnapshot = reactive(createDefaultBrandSettingsSnapshot()) /** 맞춤 설정 시작 시점의 어나운스 바(취소 시 복원용) */ const announcementSnapshot = reactive({ announcementEnabled: false, @@ -229,6 +233,7 @@ const { const initialPostSettings = normalizePostSettingsSection(settings.value) const initialSocialSettings = normalizeSocialSettingsSection(settings.value) const initialSpamSettings = normalizeSpamSettingsSection(settings.value) +const initialBrandSettings = normalizeBrandSettingsSection(settings.value) const form = reactive({ title: settings.value?.title || 'sori.studio', @@ -244,7 +249,7 @@ const form = reactive({ homeCoverDarkImageUrl: settings.value?.homeCoverDarkImageUrl || '', homeCoverTitle: settings.value?.homeCoverTitle || '', homeCoverText: settings.value?.homeCoverText || '', - brandColor: normalizeBrandColor(settings.value?.brandColor || DEFAULT_BRAND_COLOR), + ...initialBrandSettings, announcementEnabled: Boolean(settings.value?.announcementEnabled), announcementText: settings.value?.announcementText || '', announcementUrl: settings.value?.announcementUrl || '', @@ -314,7 +319,7 @@ const hasHomeCoverChanges = computed(() => editHomeCover.value && ( * @returns {boolean} 변경 여부 */ const hasBrandChanges = computed(() => editBrand.value - && normalizeBrandColor(form.brandColor) !== normalizeBrandColor(brandSnapshot.brandColor)) + && hasBrandSettingsSectionChanges(form, brandSnapshot)) /** * 어나운스 바 변경 여부 @@ -1078,7 +1083,7 @@ const buildSiteSettingsPayload = (fields = null) => { homeCoverDarkImageUrl: form.homeCoverDarkImageUrl || '', homeCoverTitle: form.homeCoverTitle || '', homeCoverText: form.homeCoverText || '', - brandColor: normalizeBrandColor(form.brandColor || DEFAULT_BRAND_COLOR), + ...normalizeBrandSettingsSection(form), announcementEnabled: Boolean(form.announcementEnabled), announcementText: form.announcementText || '', announcementUrl: form.announcementUrl || '', @@ -1458,8 +1463,8 @@ const saveHomeCoverSection = async () => { * @returns {void} */ const beginEditBrand = () => { - brandSnapshot.brandColor = normalizeBrandColor(form.brandColor || DEFAULT_BRAND_COLOR) - form.brandColor = brandSnapshot.brandColor + assignBrandSettingsSection(brandSnapshot, form) + assignBrandSettingsSection(form, brandSnapshot) editBrand.value = true } @@ -1468,7 +1473,7 @@ const beginEditBrand = () => { * @returns {void} */ const cancelEditBrand = () => { - form.brandColor = brandSnapshot.brandColor + assignBrandSettingsSection(form, brandSnapshot) editBrand.value = false } @@ -1477,7 +1482,7 @@ const cancelEditBrand = () => { * @returns {void} */ const normalizeBrandColorInput = () => { - form.brandColor = normalizeBrandColor(form.brandColor || DEFAULT_BRAND_COLOR) + assignBrandSettingsSection(form, form) } /** @@ -1494,11 +1499,12 @@ const saveBrandSection = async () => { const ok = await persistSiteSettings({ successToast: '브랜드 컬러가 저장되었습니다.', savingFlag: savingBrand, - fields: ['brandColor'] + fields: BRAND_SETTINGS_FIELDS }) if (ok) { - brandSnapshot.brandColor = normalizeBrandColor(form.brandColor || DEFAULT_BRAND_COLOR) + assignBrandSettingsSection(brandSnapshot, form) + assignBrandSettingsSection(form, brandSnapshot) editBrand.value = false } }