SNS 설정 정규화 로직 분리

2026-07-24 11:33:45 +09:00
parent 47c1b02d2b
commit 6b8fd27423
7 changed files with 75 additions and 19 deletions
--- a/docs/map.md
+++ b/docs/map.md
@@ -28,6 +28,7 @@
 | 파일 | 용도 |
 |------|------|
 | lib/upload-size-limit.js | 관리자 미디어 업로드 종류별 최대 바이트 판별·1회 파일 수/총량 제한 정규화·용량 문구(서버·클라이언트 공용) |
+| lib/admin-social-settings-section.js | 관리자 설정 SNS 설정 필드 목록·기본 스냅샷·정규화·스냅샷 복사·변경 비교 helper |
 | lib/admin-post-settings-section.js | 관리자 설정 POST 설정 필드 목록·기본 스냅샷·정규화·스냅샷 복사·변경 비교 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 생성(내부 경로는 빈 문자열) |
--- a/docs/todo.md
+++ b/docs/todo.md
@@ -4,7 +4,7 @@

 - 거대 컴포넌트 책임 분리 진행.
  - `components/admin/AdminMarkdownEditor.vue`: 미디어 모달, 슬래시 명령, 히스토리·선택 복원, 라이브/소스 전환 로직을 단계적으로 composable 또는 하위 컴포넌트로 분리.
-  - `pages/admin/settings/index.vue`: 정규화가 필요한 설정 섹션(SNS·브랜드·어나운스 바·스팸 필터)의 편집 상태·스냅샷·저장 요청 로직을 composable 단위로 추가 분리.
+  - `pages/admin/settings/index.vue`: 정규화가 필요한 설정 섹션(브랜드·어나운스 바·스팸 필터)의 편집 상태·스냅샷·저장 요청 로직을 composable 단위로 추가 분리.
  - `components/content/ContentMarkdownRenderer.vue`: 파싱·블록 렌더링·라이브 편집 중개·라이트박스·광고 삽입 책임을 분리.
  - `components/admin/AdminPostForm.vue`: 태그 입력, 대표 이미지 선택, 발행/초안 저장 상태, 우측 설정 패널 책임을 분리.
  - `pages/admin/media/index.vue`: 미디어 목록, 폴더 트리, 상세 모달, 재생성 액션을 작은 단위로 분리.
--- a/docs/update.md
+++ b/docs/update.md
@@ -1,5 +1,11 @@
 # 업데이트 이력

+## v1.11.36
+
+- SNS 설정 정규화·스냅샷 복사·변경 비교 로직을 `lib/admin-social-settings-section.js`로 분리.
+- 설정 화면의 SNS 편집 시작·취소·저장 로직을 공통 SNS 설정 helper 기반으로 정리.
+- 설정 저장 payload의 SNS 설정 필드 정규화를 한 경로로 통합.
+
 ## v1.11.35

 - POST 설정 정규화·스냅샷 복사·변경 비교 로직을 `lib/admin-post-settings-section.js`로 분리.
--- a/lib/admin-social-settings-section.js
+++ b/lib/admin-social-settings-section.js
@@ -0,0 +1,45 @@
+import { normalizeSocialLinks } from './social-links.js'
+
+export const SOCIAL_SETTINGS_FIELDS = ['socialLinks']
+
+/**
+ * SNS 설정 기본 스냅샷을 만든다.
+ * @returns {Object} 기본 SNS 설정 값
+ */
+export const createDefaultSocialSettingsSnapshot = () => ({
+  socialLinks: []
+})
+
+/**
+ * SNS 설정 값을 저장·비교 가능한 형태로 정규화한다.
+ * @param {Object} source - 원본 설정 값
+ * @returns {Object} 정규화된 SNS 설정 값
+ */
+export const normalizeSocialSettingsSection = (source = {}) => ({
+  socialLinks: normalizeSocialLinks(source.socialLinks)
+})
+
+/**
+ * SNS 설정 필드만 대상 객체에 복사한다.
+ * @param {Object} target - 값을 받을 객체
+ * @param {Object} source - 값을 제공할 객체
+ * @returns {void}
+ */
+export const assignSocialSettingsSection = (target, source = {}) => {
+  const normalized = normalizeSocialSettingsSection(source)
+  SOCIAL_SETTINGS_FIELDS.forEach((field) => {
+    target[field] = normalized[field]
+  })
+}
+
+/**
+ * 두 SNS 설정 값이 다른지 확인한다.
+ * @param {Object} current - 현재 설정 값
+ * @param {Object} snapshot - 비교할 스냅샷
+ * @returns {boolean} 변경 여부
+ */
+export const hasSocialSettingsSectionChanges = (current, snapshot) => {
+  const normalizedCurrent = normalizeSocialSettingsSection(current)
+  const normalizedSnapshot = normalizeSocialSettingsSection(snapshot)
+  return JSON.stringify(normalizedCurrent.socialLinks) !== JSON.stringify(normalizedSnapshot.socialLinks)
+}
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
  "name": "sori.studio",
-  "version": "1.11.35",
+  "version": "1.11.36",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sori.studio",
-      "version": "1.11.35",
+      "version": "1.11.36",
      "hasInstallScript": true,
      "dependencies": {
        "@nuxtjs/tailwindcss": "^6.14.0",
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
  "name": "sori.studio",
-  "version": "1.11.35",
+  "version": "1.11.36",
  "private": true,
  "type": "module",
  "imports": {
--- a/pages/admin/settings/index.vue
+++ b/pages/admin/settings/index.vue
@@ -10,9 +10,6 @@ import {
  normalizeSignupBlockedUsernames,
  parseSignupBlockedUsernamesFromText
 } from '~/lib/signup-blocked-usernames.js'
-import {
-  normalizeSocialLinks
-} from '~/lib/social-links.js'
 import {
  DISPLAY_COUNT_OPTIONS,
  POST_LIST_COUNT_OPTIONS
@@ -29,6 +26,13 @@ import {
  hasPostSettingsSectionChanges,
  normalizePostSettingsSection
 } from '~/lib/admin-post-settings-section.js'
+import {
+  SOCIAL_SETTINGS_FIELDS,
+  assignSocialSettingsSection,
+  createDefaultSocialSettingsSnapshot,
+  hasSocialSettingsSectionChanges,
+  normalizeSocialSettingsSection
+} from '~/lib/admin-social-settings-section.js'

 definePageMeta({
  layout: 'admin'
@@ -154,9 +158,7 @@ const miscSnapshot = reactive({
  copyrightText: ''
 })
 /** 편집 시작 시점의 SNS 정보(취소 시 복원용) */
-const socialSnapshot = reactive({
-  socialLinks: []
-})
+const socialSnapshot = reactive(createDefaultSocialSettingsSnapshot())
 /** 편집 시작 시점의 POST 설정(취소 시 복원용) */
 const postSnapshot = reactive(createDefaultPostSettingsSnapshot())
 /** 편집 시작 시점의 메인 화면 커버(취소 시 복원용) */
@@ -222,6 +224,7 @@ const {
  default: () => null
 })
 const initialPostSettings = normalizePostSettingsSection(settings.value)
+const initialSocialSettings = normalizeSocialSettingsSection(settings.value)

 const form = reactive({
  title: settings.value?.title || 'sori.studio',
@@ -231,7 +234,7 @@ const form = reactive({
  logoUrl: settings.value?.logoUrl || '',
  faviconUrl: settings.value?.faviconUrl || '',
  copyrightText: settings.value?.copyrightText || '©2026 sori.studio',
-  socialLinks: normalizeSocialLinks(settings.value?.socialLinks || []),
+  ...initialSocialSettings,
  ...initialPostSettings,
  homeCoverImageUrl: settings.value?.homeCoverImageUrl || '',
  homeCoverDarkImageUrl: settings.value?.homeCoverDarkImageUrl || '',
@@ -282,7 +285,7 @@ const hasMiscChanges = computed(() => editMisc.value && (
 * @returns {boolean} 변경 여부
 */
 const hasSocialChanges = computed(() => editSocial.value
-  && JSON.stringify(normalizeSocialLinks(form.socialLinks)) !== JSON.stringify(normalizeSocialLinks(socialSnapshot.socialLinks)))
+  && hasSocialSettingsSectionChanges(form, socialSnapshot))

 /**
 * POST 설정 변경 여부
@@ -1065,7 +1068,7 @@ const buildSiteSettingsPayload = (fields = null) => {
    logoUrl: form.logoUrl,
    faviconUrl: form.faviconUrl,
    copyrightText: form.copyrightText,
-    socialLinks: normalizeSocialLinks(form.socialLinks),
+    ...normalizeSocialSettingsSection(form),
    ...normalizePostSettingsSection(form),
    homeCoverImageUrl: form.homeCoverImageUrl || '',
    homeCoverDarkImageUrl: form.homeCoverDarkImageUrl || '',
@@ -1243,8 +1246,8 @@ const saveMiscSection = async () => {
 * @returns {void}
 */
 const beginEditSocial = () => {
-  socialSnapshot.socialLinks = normalizeSocialLinks(form.socialLinks)
-  form.socialLinks = normalizeSocialLinks(form.socialLinks)
+  assignSocialSettingsSection(socialSnapshot, form)
+  assignSocialSettingsSection(form, socialSnapshot)
  editSocial.value = true
 }

@@ -1253,7 +1256,7 @@ const beginEditSocial = () => {
 * @returns {void}
 */
 const cancelEditSocial = () => {
-  form.socialLinks = normalizeSocialLinks(socialSnapshot.socialLinks)
+  assignSocialSettingsSection(form, socialSnapshot)
  editSocial.value = false
 }

@@ -1266,16 +1269,17 @@ const saveSocialSection = async () => {
    return
  }

-  form.socialLinks = normalizeSocialLinks(form.socialLinks)
+  assignSocialSettingsSection(form, form)

  const ok = await persistSiteSettings({
    successToast: 'SNS 정보가 저장되었습니다.',
    savingFlag: savingSocial,
-    fields: ['socialLinks']
+    fields: SOCIAL_SETTINGS_FIELDS
  })

  if (ok) {
-    socialSnapshot.socialLinks = normalizeSocialLinks(form.socialLinks)
+    assignSocialSettingsSection(socialSnapshot, form)
+    assignSocialSettingsSection(form, socialSnapshot)
    editSocial.value = false
  }
 }