import { LinkChannel, PlaceCategory, factText, sanitizeUnits, selectPublishable, selectPublishableFaqs, type ChannelLink, type FactEntry, type MediaItem, type SitePayload, type UnitInfo, } from '@o2o/shared'; import {UNIT_SPEC} from '@/seo/jsonld'; /** * payload → 화면이 바로 쓰는 모양. * * 컴포넌트가 fact 배열을 직접 뒤지지 않게 한 층 둔다. 여기 한 곳에서만 * selectPublishable() 을 통과시키므로, 컴포넌트가 실수로 미검증 값을 그릴 수가 없다. */ export interface InfoRow { label: string; value: string; /** 부가 설명. 출처가 아니라 사장님이 붙인 보충 문구. */ note?: string; } /** 사업장 단위 이용 정보 표. 확인된 것만 들어간다. */ export function essentialRows(payload: SitePayload): InfoRow[] { return selectPublishable(payload.facts) .filter((fact) => fact.scope === 'place') .map((fact) => ({ label: fact.label, value: displayValue(fact, payload.facts), })) .filter((row) => row.value !== ''); } function displayValue(fact: FactEntry, all: FactEntry[]): string { const text = factText(all, fact.key); if (!text) return ''; if (fact.type !== 'bool') return text; if (text === 'true') return '가능'; if (text === 'false') return '불가'; return text; } export interface UnitView { unitId: string; slug: string; name: string; intro?: string; /** 스펙 칩 — 인원 · 침대 · 면적처럼 한눈에 보는 값. */ chips: {label: string; value: string}[]; rows: InfoRow[]; images: MediaItem[]; priceText?: string; href: string; } export function unitViews(payload: SitePayload): UnitView[] { const spec = UNIT_SPEC[payload.place.category]; const mediaById = new Map(payload.media.map((m) => [m.mediaId, m])); return sanitizeUnits(payload.units).map((unit) => { const intro = factText(unit.facts, 'room_intro') ?? factText(unit.facts, 'description'); const chipKeys = payload.place.category === PlaceCategory.LODGING ? ['max_capacity', 'bed_type', 'room_size'] : ['price', 'volume', 'origin']; return { unitId: unit.unitId, slug: unit.slug, name: unit.name, intro, chips: chipKeys .map((key) => { const value = factText(unit.facts, key); const label = unit.facts.find((f) => f.key === key)?.label ?? key; return value ? {label, value} : null; }) .filter((chip): chip is {label: string; value: string} => chip !== null), rows: unit.facts .map((fact) => ({label: fact.label, value: displayValue(fact, unit.facts)})) .filter((row) => row.value !== ''), images: unit.mediaIds .map((id) => mediaById.get(id)) .filter((m): m is MediaItem => Boolean(m?.alt?.trim())), priceText: unitPriceText(unit), href: `/${spec.path}/${unit.slug}`, }; }); } function unitPriceText(unit: UnitInfo): string | undefined { const weekday = Number(factText(unit.facts, 'weekday_price')?.replace(/[^0-9]/g, '')); const price = Number(factText(unit.facts, 'price')?.replace(/[^0-9]/g, '')); const base = Number.isFinite(weekday) && weekday > 0 ? weekday : price; if (!Number.isFinite(base) || base <= 0) return undefined; return `${base.toLocaleString('ko-KR')}원부터`; } /** 갤러리에 낼 이미지 — 대체 텍스트 없는 것은 뺀다(검색·낭독기 모두 못 읽는다). */ export function galleryImages(payload: SitePayload): MediaItem[] { return payload.media.filter((m) => m.alt?.trim() && !m.unitId); } export function faqList(payload: SitePayload) { return selectPublishableFaqs(payload.faqs); } /** 켜져 있는 섹션인지. 순서도 payload 가 정한다. */ export function enabledSections(payload: SitePayload) { return payload.theme.sections.filter((section) => section.enabled); } export function isSectionEnabled(payload: SitePayload, id: string): boolean { return payload.theme.sections.find((section) => section.id === id)?.enabled ?? false; } /** 사장님이 에디터에서 직접 쓴 섹션 본문. 빈 줄을 문단 경계로 쓴다. */ export function sectionBody(payload: SitePayload, id: string): string[] { const body = payload.theme.sections.find((section) => section.id === id)?.body; return body?.split(/\n\s*\n/).map((paragraph) => paragraph.trim()).filter(Boolean) ?? []; } export function unitSpec(payload: SitePayload) { return UNIT_SPEC[payload.place.category]; } /** * 섹션 제목 — 사장님이 [섹션] 패널에서 붙인 이름(`theme.sections[].name`)을 그대로 쓴다. * * ★ 왜 필요한가 * 지금까지 발행본 소제목은 컴포넌트에 박힌 문자열이었다. 사장님이 "객실 안내"를 * "우리 방 소개"로 바꿔도 에디터 캔버스만 바뀌고 발행본은 옛 문구로 나갔다 — * 사장님 입장에서는 고친 게 반영이 안 된 것이고, 실제로 반영이 안 된 게 맞다. * * ★ **모든 섹션이 이걸 쓰는 건 아니다.** 기준은 하나다 — 에디터 캔버스가 그 섹션에서 * 무엇을 제목으로 쓰는가. 두 화면이 같아야 하므로 발행본은 에디터를 따라간다. * * 이걸 쓰는 섹션 rules · booking · inquiry · space · exhibition · rooms/menu/programs * (에디터: `title={section.name}`) * 쓰지 않는 섹션 intro · info · photos · map · local · faq * (에디터가 자체 제목을 쓴다: "공간 갤러리", "오시는 길", `${상호} 소개` …) * * 한때 발행본에서 여섯 섹션 전부에 이걸 걸었다가 소개 제목이 "조이모텔 소개" 에서 * "소개" 로 짧아졌다. `theme.sections[].name` 은 사장님이 붙인 이름이기도 하지만, * 아직 아무것도 안 바꿨으면 서버 기본표(_DEFAULT_THEME)의 짧은 목록 라벨이다 — * 그 라벨은 좌측 패널의 navigation 용이지

용이 아니다. * * ★ 폴백을 두는 이유 * name 이 비어 있는 payload(옛 버전·손으로 만든 fixture)에서 제목 없는

가 * 나가면 문서 구조가 무너지고 검색·낭독기가 섹션을 못 읽는다. 제목은 반드시 채운다. */ export function sectionName(payload: SitePayload, id: string, fallback: string): string { const name = payload.theme.sections.find((section) => section.id === id)?.name?.trim(); return name ? name : fallback; } /** * key 목록 순서대로 확인된 place fact 를 표 행으로. * * ★ 순서가 곧 화면 순서다. 값이 없거나 미검증인 key 는 조용히 빠진다 — * "확인 중"이라는 빈 줄을 그리면 손님은 그걸 규정으로 읽는다. */ function placeRowsByKeys(payload: SitePayload, keys: readonly string[]): InfoRow[] { const map = new Map( selectPublishable(payload.facts) .filter((fact) => fact.scope === 'place') .map((fact) => [fact.key, fact] as const), ); return keys .map((key) => map.get(key)) .filter((fact): fact is FactEntry => fact !== undefined) .map((fact) => ({label: fact.label, value: displayValue(fact, payload.facts)})) .filter((row) => row.value !== ''); } /** * 이용 규정으로 읽히는 fact key. * * ★ 관리자 캔버스의 `builder/canvas/variants/common.ts` RULE_FIELD_IDS 와 같은 목록이다. * 에디터에서 규정으로 보인 항목이 발행본에서 다른 항목이 되면 사장님은 어느 쪽을 * 믿어야 할지 모른다. 목록이 바뀌면 양쪽을 같이 고친다. * ★ 여기 없는 규정은 만들어 내지 않는다. 업종 스키마(lodging.json)에 있는 key 만 적는다. */ const RULE_FACT_KEYS = [ 'check_in_time', 'check_out_time', 'cancel_policy', 'cooking_allowed', 'pet_allowed', 'smoking', 'extra_person_fee', ] as const; /** 이용 규정 줄. 확인된 fact 에서만 만든다 — 없으면 빈 목록이고 섹션 자체가 안 나간다. */ export function ruleRows(payload: SitePayload): InfoRow[] { return placeRowsByKeys(payload, RULE_FACT_KEYS); } /** * 예약 안내에 실을 fact. * * 숙박에는 없고(예약은 채널이 받는다) 음식점·관광체험 스키마에만 있는 key 다. * 값이 없는 업종에서는 그냥 빠진다. */ const BOOKING_FACT_KEYS = ['reservation_required', 'reservation_channel'] as const; export function bookingRows(payload: SitePayload): InfoRow[] { return placeRowsByKeys(payload, BOOKING_FACT_KEYS); } /** * 공간 안내에 실을 fact — "자리가 어떻게 생겼나"에 답하는 것만. * * ★ 주차·와이파이 같은 편의시설은 넣지 않는다. 그건 이용 정보(info) 표가 이미 낸다. */ const SPACE_FACT_KEYS = [ 'seat_count', 'terrace', 'room_available', 'group_seat_max', 'power_outlet', 'study_allowed', 'wheelchair_accessible', ] as const; export function spaceRows(payload: SitePayload): InfoRow[] { return placeRowsByKeys(payload, SPACE_FACT_KEYS); } /** * 관람 안내에 실을 fact — 관광체험 스키마(tour_activity.json)의 관람 관련 key. * * ★ 준비물·안전 유의사항은 뺐다. 그건 "관람 안내"가 아니라 체험 전 주의사항이고, * 이용 정보(info) 표에 이미 나간다. */ const EXHIBITION_FACT_KEYS = [ 'operating_hours', 'session_times', 'closed_days', 'age_limit', 'guide_language', ] as const; export function exhibitionRows(payload: SitePayload): InfoRow[] { return placeRowsByKeys(payload, EXHIBITION_FACT_KEYS); } /** 채널 코드 → 사람이 읽는 이름. link.title 이 있으면 그쪽이 우선이다. */ export const CHANNEL_LABEL: Record = { [LinkChannel.YANOLJA]: '야놀자', [LinkChannel.GOODCHOICE]: '여기어때', [LinkChannel.NAVER_PLACE]: '네이버 플레이스', [LinkChannel.INSTAGRAM]: '인스타그램', [LinkChannel.OFFICIAL_SITE]: '공식 사이트', [LinkChannel.BLOG]: '블로그', [LinkChannel.ETC]: '채널', }; export function channelLabel(link: ChannelLink): string { return link.title ?? CHANNEL_LABEL[link.channel] ?? '채널'; } /** * 예약을 실제로 받는 채널. * * ★ 블로그·인스타그램은 뺀다. 눌러도 예약 화면이 안 나오는 링크를 "예약하기" 자리에 * 두면 손님이 예약한 줄 알고 안 온다. 공식 사이트도 뺀다 — 지금 보고 있는 이 사이트가 * 그 자리라, 자기 자신으로 돌려보내는 버튼이 된다. */ const BOOKING_CHANNELS: readonly number[] = [ LinkChannel.YANOLJA, LinkChannel.GOODCHOICE, LinkChannel.NAVER_PLACE, ]; /** * 문의를 실제로 받을 수 있는 채널 — 네이버 톡톡·인스타 DM 처럼 말을 걸 수 있는 곳만. * * ★ 블로그·공식 사이트·기타(ETC)는 뺀다. 읽기만 되는 링크를 "문의" 버튼으로 두면 * 손님이 남긴 말이 아무 데도 도착하지 않는다. */ const CONTACT_CHANNELS: readonly number[] = [LinkChannel.NAVER_PLACE, LinkChannel.INSTAGRAM]; /** 확정된 링크만. 확정 전 URL 은 동명 업소일 수 있다(sanitizePayloadForPublish 와 같은 규칙). */ function confirmedLinks(payload: SitePayload, channels: readonly number[]): ChannelLink[] { return payload.links.filter((link) => link.confirmed && channels.includes(link.channel)); } export function bookingLinks(payload: SitePayload): ChannelLink[] { return confirmedLinks(payload, BOOKING_CHANNELS); } export function contactLinks(payload: SitePayload): ChannelLink[] { return confirmedLinks(payload, CONTACT_CHANNELS); }