'use client' import { useEffect, useMemo, useRef, useState } from "react"; import { ChannelType, isKkoTemplateSavable, MessageType, TemplatePurpose, type KkoTemplateDetail, type KkoTemplateSummary, } from "@kri/common/noti-hub"; import { isBlank, type DataVerification } from "@kri/common"; import { RefreshCw } from "lucide-react"; import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card"; import { Label } from "@/components/ui/label"; import { Input } from "@/components/ui/input"; import { Button } from "@/components/ui/button"; import { Checkbox } from "@/components/ui/checkbox"; import { KriSingleSelect } from "@/components/common/KriAutoComplete"; import { KriEditor } from "@/components/kri-editor"; import { useSelectedProject } from "@/hooks/useSelectedProject"; import { fetchKkoTemplateDetail, resolveDeleteTemplateErrorMessage, useDeleteTemplateMutation, useKkoTemplateDetailQuery, useKkoTemplateListQuery, useKkoSenderProfilesQuery, useMainTemplateIdxQuery, useSaveTemplateMutation, useTemplateListQuery, useTemplateQuery, useUpdateMainTemplateMutation, } from "@/query/message"; import { KKO_SENDER_NAME, KKO_TEMPLATE_CODE_REGEX, KKO_TEMPLATE_KEYWORD_MAX_LENGTH, KKO_TEMPLATE_KEYWORD_MIN_LENGTH, } from "@/const/messageTemplateConst"; import { formatKoreanPhoneNumber } from "@/utils/phone"; import {ProjectMainTemplateUpdateRequest, ProjectSurvey} from "@/types/project"; import type { KkoSenderProfile, KkoTemplateWithProfile, TemplateSummaryWithPurpose, TemplateWithPurpose } from "@/types/message"; import {MessageVariableList} from "@/components/message-template/MessageVariableList"; import {listHeader} from "@/types/list"; import {useListHeaderQuery} from "@/query/list"; import {useProjectInfoQuery} from "@/query/project"; // 템플릿 명은 선택한 알림톡 템플릿 명을, 발신자 명은 KKO_SENDER_NAME을 그대로 쓴다. type KkoTemplateDraft = { tmplatIdx?: number; tmplatNm: string; sendTel: string; kkoTmplatCd: string; senderKey: string; }; const EMPTY_DRAFT: KkoTemplateDraft = { tmplatIdx: undefined, tmplatNm: "", sendTel: "", kkoTmplatCd: "", senderKey: "", }; const CHNNL_TY = ChannelType.KKO; const KEYWORD_DEBOUNCE_MS = 400; const isValidKeyword = (keyword: string) => keyword === "" || (keyword.length >= KKO_TEMPLATE_KEYWORD_MIN_LENGTH && keyword.length <= KKO_TEMPLATE_KEYWORD_MAX_LENGTH); const isKkoTemplate = (template: TemplateWithPurpose | undefined | null): template is KkoTemplateWithProfile & { tmplatPurpose: TemplatePurpose } => template?.tmplatTy === MessageType.KKO; // 저장 불가 안내. 공용 isKkoTemplateSavable 기준으로 판단하고, 해당하면 저장 요청을 보내지 않는다. const getUnsavableWarning = (detail: KkoTemplateDetail): string | null => { if (isKkoTemplateSavable(detail)) return null; const status = [ `검수 ${detail.inspectionStatus ?? "-"}`, `상태 ${detail.status ?? "-"}`, `유형 ${detail.templateMessageType ?? "-"}/${detail.templateEmphasizeType ?? "-"}`, detail.block ? "차단" : null, detail.dormant ? "휴면" : null, ].filter(Boolean).join(", "); return `저장할 수 없는 템플릿입니다. 승인 상태가 아니거나 지원하지 않는 형식(버튼·이미지·강조 등 추가 요소 포함)입니다. (${status})`; }; const KkoMessageTemplate = () => { const { selectedProject } = useSelectedProject(); const prjctIdx = selectedProject?.prjctIdx ?? 0; const itrntPrjctCd = selectedProject?.itrntPrjctCd ?? ""; const enabled = !!selectedProject && prjctIdx > 0 && !!itrntPrjctCd; const [selectedTemplateIdx, setSelectedTemplateIdx] = useState(null); const [draft, setDraft] = useState(EMPTY_DRAFT); // 저장된 템플릿 기준 미리보기(서버가 외부 상세를 재조회해 저장한 본문·제목) const [savedPreview, setSavedPreview] = useState<{ body: string; title: string } | null>(null); // 외부 템플릿 검색: 입력값과 실제 조회에 쓰는 검색어를 분리한다. const [keywordInput, setKeywordInput] = useState(""); const [searchKeyword, setSearchKeyword] = useState(""); // 사용자가 외부 목록에서 고른 템플릿 코드. 값이 있으면 외부 상세를 미리보기한다. const [selectedCode, setSelectedCode] = useState(""); // 검색어가 바뀌어 목록에서 빠져도 선택값 라벨이 유지되도록 현재 선택 항목을 따로 둔다. const [selectedSummary, setSelectedSummary] = useState(null); const [mainDesired, setMainDesired] = useState(false); const mainTemplateAppliedRef = useRef(false); const templateDetailAppliedRef = useRef(null); const selectionRevisionRef = useRef(0); const [checkingTemplate, setCheckingTemplate] = useState(false); // Queries const templateListQuery = useTemplateListQuery(CHNNL_TY, itrntPrjctCd, enabled); const mainTemplateQuery = useMainTemplateIdxQuery(prjctIdx, CHNNL_TY, enabled); const templateDetailQuery = useTemplateQuery(selectedTemplateIdx ?? 0, enabled && !!selectedTemplateIdx); const profilesQuery = useKkoSenderProfilesQuery(enabled); const kkoListQuery = useKkoTemplateListQuery(draft.senderKey, searchKeyword, enabled); const kkoDetailQuery = useKkoTemplateDetailQuery(draft.senderKey, selectedCode, enabled); const listHeaderQuery = useListHeaderQuery(prjctIdx, enabled) const projectInfoQuery = useProjectInfoQuery(prjctIdx, enabled) const templateList = useMemo(() => templateListQuery.data ?? [], [templateListQuery.data]); const mainTemplateIdx = mainTemplateQuery.data ?? null; const externalList = useMemo(() => { const list = kkoListQuery.data ?? []; if (!selectedSummary || list.some((item) => item.templateCode === selectedSummary.templateCode)) return list; return [selectedSummary, ...list]; }, [kkoListQuery.data, selectedSummary]); const externalDetail = selectedCode && kkoDetailQuery.data?.templateCode === selectedCode ? kkoDetailQuery.data : null; const listHderList = useMemo(() => listHeaderQuery.data ?? [], [listHeaderQuery.data]) const surveys = useMemo(() => projectInfoQuery.data?.surveys ?? [], [projectInfoQuery.data?.surveys]) // Mutations const saveTemplateMutation = useSaveTemplateMutation(CHNNL_TY, itrntPrjctCd); const updateMainTemplateMutation = useUpdateMainTemplateMutation(prjctIdx, CHNNL_TY); const deleteTemplateMutation = useDeleteTemplateMutation(CHNNL_TY, itrntPrjctCd, prjctIdx); const isSaving = checkingTemplate || saveTemplateMutation.isPending; const resetToNew = () => { selectionRevisionRef.current += 1; templateDetailAppliedRef.current = null; setSelectedTemplateIdx(null); setDraft(EMPTY_DRAFT); setSavedPreview(null); setSelectedCode(""); setSelectedSummary(null); setMainDesired(false); }; // 검색어 입력이 멈추면 조회한다. 길이 조건(빈 값 또는 2~50자)을 벗어나면 기존 목록을 유지한다. useEffect(() => { const keyword = keywordInput.trim(); if (!isValidKeyword(keyword)) return; const timer = setTimeout(() => setSearchKeyword(keyword), KEYWORD_DEBOUNCE_MS); return () => clearTimeout(timer); }, [keywordInput]); // selectedProject 변경 시 초기화 useEffect(() => { if (!selectedProject) return; resetToNew(); mainTemplateAppliedRef.current = false; }, [selectedProject]); // 대표 템플릿이 있으면 최초 1회 자동 선택 useEffect(() => { if (!enabled || mainTemplateAppliedRef.current || !mainTemplateQuery.isSuccess) return; mainTemplateAppliedRef.current = true; if (mainTemplateIdx) setSelectedTemplateIdx(mainTemplateIdx); }, [enabled, mainTemplateQuery.isSuccess, mainTemplateIdx]); // 저장된 템플릿 상세가 도착하면 입력값과 미리보기에 반영 useEffect(() => { const d = templateDetailQuery.data; if (!isKkoTemplate(d) || !selectedTemplateIdx || d.tmplatIdx !== selectedTemplateIdx) return; if (templateDetailAppliedRef.current === selectedTemplateIdx) return; templateDetailAppliedRef.current = selectedTemplateIdx; const senderKey = typeof d.senderKey === "string" ? d.senderKey.trim() : ""; setDraft({ tmplatIdx: d.tmplatIdx, tmplatNm: d.tmplatNm ?? "", sendTel: d.sendTel ?? "", kkoTmplatCd: senderKey ? d.kkoTmplatCd ?? "" : "", senderKey, }); selectionRevisionRef.current += 1; setSavedPreview(senderKey ? { body: d.tmplatBody ?? "", title: d.tmplatTitle ?? "" } : null); setSelectedCode(senderKey ? d.kkoTmplatCd ?? "" : ""); setSelectedSummary( senderKey && d.kkoTmplatCd ? { templateCode: d.kkoTmplatCd, templateName: d.tmplatNm ?? "", serviceStatus: null, createdAt: null, modifiedAt: null } : null, ); }, [templateDetailQuery.data, selectedTemplateIdx]); // 대표 템플릿 체크 동기화(현재 선택 템플릿이 id를 가진 경우에만) useEffect(() => { if (draft.tmplatIdx) setMainDesired(draft.tmplatIdx === mainTemplateIdx); }, [draft.tmplatIdx, mainTemplateIdx]); const handleSelectTemplate = (value: string) => { if (!value) { resetToNew(); return; } const idx = Number(value); if (!Number.isFinite(idx)) return; selectionRevisionRef.current += 1; templateDetailAppliedRef.current = null; setDraft(EMPTY_DRAFT); setSelectedCode(""); setSelectedSummary(null); setSavedPreview(null); setSelectedTemplateIdx(idx); }; const toggleMainTemplate = async () => { if (!selectedProject) return; const next = !mainDesired; setMainDesired(next); const tmplatIdx = draft.tmplatIdx ?? null; if (!tmplatIdx) return; // 새 템플릿(미저장)은 저장 후 대표 적용 const updateTemplateIdx = next ? tmplatIdx : (mainTemplateIdx === tmplatIdx ? null : mainTemplateIdx); if (updateTemplateIdx === mainTemplateIdx) return; const req: ProjectMainTemplateUpdateRequest = { prjctIdx: selectedProject.prjctIdx, chnnlTy: CHNNL_TY, tmplatIdx: updateTemplateIdx, }; await updateMainTemplateMutation.mutateAsync(req); }; const handleSelectProfile = (senderKey: string) => { if (senderKey === draft.senderKey) return; selectionRevisionRef.current += 1; setDraft((prev) => ({ ...prev, senderKey, kkoTmplatCd: "", tmplatNm: "" })); setSelectedCode(""); setSelectedSummary(null); setSavedPreview(null); setKeywordInput(""); setSearchKeyword(""); }; const handleSelectExternal = (item: KkoTemplateSummary | null) => { if (!item || !draft.senderKey) return; selectionRevisionRef.current += 1; setSavedPreview(null); setSelectedSummary(item); setSelectedCode(item.templateCode); // 템플릿 명은 선택한 알림톡 템플릿 명을 그대로 쓴다. setDraft((prev) => ({ ...prev, kkoTmplatCd: item.templateCode, tmplatNm: item.templateName ?? "" })); }; const validateDraft = (d: KkoTemplateDraft): DataVerification => { const ok = (): DataVerification => ({ success: true, fieldName: "", errMessage: "" }); const fail = (fieldName: string, errMessage: string): DataVerification => ({ success: false, fieldName, errMessage }); if (isBlank(itrntPrjctCd)) return fail("itrntPrjctCd", "인트라넷 프로젝트 코드가 없습니다."); if (isBlank(d.senderKey)) return fail("senderKey", "발신 프로필을 선택해 주세요."); if (!profilesQuery.data?.some((profile) => profile.senderKey === d.senderKey)) return fail("senderKey", "사용 가능한 발신 프로필을 다시 선택해 주세요."); if (!d.kkoTmplatCd) return fail("kkoTmplatCd", "알림톡 템플릿을 선택해 주세요."); if (!KKO_TEMPLATE_CODE_REGEX.test(d.kkoTmplatCd)) return fail("kkoTmplatCd", "알림톡 템플릿 코드 형식이 올바르지 않습니다."); if (isBlank(d.tmplatNm)) return fail("tmplatNm", "알림톡 템플릿 명이 없습니다."); if (d.tmplatNm.length > 32) return fail("tmplatNm", "알림톡 템플릿 명이 32자를 초과해 저장할 수 없습니다."); if (isBlank(d.sendTel)) return fail("sendTel", "발신 전화번호를 입력해 주세요."); if (d.sendTel.length > 16) return fail("sendTel", "발신 전화번호는 16자 이하로 입력해주세요."); return ok(); }; const submitTemplate = async (method: "put" | "patch") => { if (isSaving) return; const revision = selectionRevisionRef.current; const v = validateDraft(draft); if (!v.success) { alert(v.errMessage); return; } // 저장 직전에 외부 상세를 다시 조회해 저장 가능 여부를 확인한다. // 화면에서 고른 뒤 상태가 바뀌었을 수 있으므로 최신 상태를 확인한다. setCheckingTemplate(true); try { const latestDetail = await fetchKkoTemplateDetail(draft.senderKey, draft.kkoTmplatCd); if (revision !== selectionRevisionRef.current) return; const warning = getUnsavableWarning(latestDetail); if (warning) { alert(warning); return; } } catch (e) { // 조회 오류는 공통 HTTP 오류 처리로 안내된다. 입력값은 유지한다. console.log(e); return; } finally { setCheckingTemplate(false); } // 본문·제목·첨부는 서버가 선택한 프로필의 외부 상세를 재조회해 채운다. const template: KkoTemplateWithProfile & { tmplatPurpose: TemplatePurpose } = { ...(method === "patch" ? { tmplatIdx: draft.tmplatIdx } : {}), itrntPrjctCd, tmplatTy: MessageType.KKO, tmplatPurpose: TemplatePurpose.NORMAL, tmplatNm: draft.tmplatNm, sendNm: KKO_SENDER_NAME, sendTel: draft.sendTel, kkoTmplatCd: draft.kkoTmplatCd, senderKey: draft.senderKey, }; try { const res = await saveTemplateMutation.mutateAsync({ method, template }); if (!isKkoTemplate(res) || revision !== selectionRevisionRef.current) return; // 저장 응답의 본문·제목·코드를 최종 화면 값으로 쓴다. setDraft({ tmplatIdx: res.tmplatIdx, tmplatNm: res.tmplatNm ?? draft.tmplatNm, sendTel: res.sendTel ?? draft.sendTel, kkoTmplatCd: res.kkoTmplatCd ?? draft.kkoTmplatCd, senderKey: res.senderKey ?? draft.senderKey, }); setSavedPreview({ body: res.tmplatBody ?? "", title: res.tmplatTitle ?? "" }); setSelectedTemplateIdx(res.tmplatIdx ?? null); setSelectedCode(res.kkoTmplatCd ?? draft.kkoTmplatCd); if (mainDesired && selectedProject?.prjctIdx && res.tmplatIdx) { await updateMainTemplateMutation.mutateAsync({ prjctIdx: selectedProject.prjctIdx, chnnlTy: CHNNL_TY, tmplatIdx: res.tmplatIdx, }); } alert(method === "put" ? "저장되었습니다." : "수정되었습니다."); } catch (e) { // 입력값은 그대로 두고, 외부 상세를 다시 조회할 수 있게 한다. console.log(e); } }; const handleDelete = async () => { const tmplatIdx = draft.tmplatIdx; if (!tmplatIdx) return; if (!window.confirm(`'${draft.tmplatNm}' 템플릿을 삭제하시겠습니까?`)) return; try { await deleteTemplateMutation.mutateAsync(tmplatIdx); resetToNew(); alert("삭제되었습니다."); } catch (e) { // 삭제 불가·권한 없음 등은 안내만 하고 선택 템플릿과 대표 상태는 유지한다. alert(resolveDeleteTemplateErrorMessage(e)); } }; const previewBody = externalDetail ? externalDetail.templateContent : savedPreview?.body ?? ""; const previewTitle = externalDetail ? externalDetail.templateTitle ?? "" : savedPreview?.title ?? ""; const unsavableWarning = externalDetail ? getUnsavableWarning(externalDetail) : null; return (
알림톡 템플릿 관리

⚠️ 알림톡 템플릿에 대한 수정 및 등록은 비즈 뿌리오에서 가능하며 여기서는 템플릿을 프로젝트에 등록만 가능합니다.

item.tmplatNm} getValue={(item) => String(item.tmplatIdx)} preventDeselect useClear clearLabel="새 템플릿 생성" />
items={profilesQuery.data ?? []} value={draft.senderKey} onChange={handleSelectProfile} placeholder="발신 프로필을 선택해 주세요" heightClassName="h-9" widthClassName="w-full" getLabel={(item) => item.uuid} getValue={(item) => item.senderKey} disabled={!enabled || isSaving || profilesQuery.isFetching || templateDetailQuery.isFetching} preventDeselect />

{profilesQuery.isFetching ? "발신 프로필을 조회하는 중입니다." : profilesQuery.isError ? "발신 프로필을 불러오지 못했습니다." : !profilesQuery.data?.length ? "선택할 발신 프로필이 없습니다." : draft.senderKey && !profilesQuery.data.some((profile) => profile.senderKey === draft.senderKey) ? "저장된 발신 프로필을 사용할 수 없습니다. 프로필을 다시 선택해 주세요." : "발신 프로필을 선택한 뒤 알림톡 템플릿을 선택해 주세요."}

{profilesQuery.isError && ( )}
key={draft.senderKey} items={externalList} disabled={!draft.senderKey || isSaving || templateDetailQuery.isFetching} value={draft.kkoTmplatCd} onChange={() => {}} onItemChange={handleSelectExternal} searchMode="inputOnly" onSearchValueChange={setKeywordInput} placeholder="알림톡 템플릿을 선택해 주세요" heightClassName="h-9" widthClassName="w-full" getLabel={(item) => `${item.templateName} (${item.templateCode})`} getValue={(item) => item.templateCode} withInfo preventDeselect />

{kkoListQuery.isFetching ? "알림톡 템플릿을 조회하는 중입니다." : kkoListQuery.isError ? "알림톡 템플릿 목록을 불러오지 못했습니다." : `검색어는 ${KKO_TEMPLATE_KEYWORD_MIN_LENGTH}~${KKO_TEMPLATE_KEYWORD_MAX_LENGTH}자로 입력해 주세요.`}

{draft.tmplatNm || "알림톡 템플릿을 선택하면 템플릿 명이 그대로 사용됩니다."}

setDraft((prev) => ({ ...prev, sendTel: e.target.value.replace(/\D/g, "") }))} />

⚠️ 비즈 뿌리오(KRi 계정)에 등록된 발신 번호가 아니면 전송되지 않습니다.

{KKO_SENDER_NAME}

{}} />

⚠️ 변수 #{"{변수명}"}은 리스트 헤더명, 프로젝트에 연동된 설문명과 같아야 값이 채워집니다.

미리보기

{selectedCode && ( )}
{selectedCode && kkoDetailQuery.isFetching && !externalDetail ? (

상세를 불러오는 중입니다.

) : ( {}} kkoTitle={previewTitle || undefined} kkoSenderName={KKO_SENDER_NAME} placeholder="미리볼 내용이 없습니다." className="max-w-none mx-0" /> )} {selectedCode && kkoDetailQuery.isError && (

상세를 불러오지 못했습니다. 다시 조회해 주세요.

)} {unsavableWarning && (

⚠️ {unsavableWarning}

)}
{draft.tmplatIdx && ( )} {draft.tmplatIdx && ( )}
); }; export default KkoMessageTemplate;