261008_01_ENH: 알림톡 템플릿 관련내용 구현 및 발송 구현

This commit is contained in:
2026-10-08 11:20:42 +09:00
parent f12c374a84
commit 264707ac56
33 changed files with 803 additions and 143 deletions

View File

@@ -0,0 +1,447 @@
'use client'
import { useEffect, useMemo, useRef, useState } from "react";
import {
ChannelType,
isKkoTemplateSavable,
MessageType,
TemplatePurpose,
type KkoTemplateDetail,
type KkoTemplateSummary,
type TemplateKko,
} 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,
useKkoTemplateDetailQuery,
useKkoTemplateListQuery,
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 type { ProjectMainTemplateUpdateRequest } from "@/types/project";
import type { TemplateSummaryWithPurpose, TemplateWithPurpose } from "@/types/message";
// 템플릿 명은 선택한 알림톡 템플릿 명을, 발신자 명은 KKO_SENDER_NAME을 그대로 쓴다.
type KkoTemplateDraft = {
tmplatIdx?: number;
tmplatNm: string;
sendTel: string;
kkoTmplatCd: string;
};
const EMPTY_DRAFT: KkoTemplateDraft = {
tmplatIdx: undefined,
tmplatNm: "",
sendTel: "",
kkoTmplatCd: "",
};
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 TemplateKko & { 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<number | null>(null);
const [draft, setDraft] = useState<KkoTemplateDraft>(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<KkoTemplateSummary | null>(null);
const [mainDesired, setMainDesired] = useState(false);
const mainTemplateAppliedRef = useRef(false);
// Queries
const templateListQuery = useTemplateListQuery(CHNNL_TY, itrntPrjctCd, enabled);
const mainTemplateQuery = useMainTemplateIdxQuery(prjctIdx, CHNNL_TY, enabled);
const templateDetailQuery = useTemplateQuery(selectedTemplateIdx ?? 0, enabled && !!selectedTemplateIdx);
const kkoListQuery = useKkoTemplateListQuery(searchKeyword, enabled);
const kkoDetailQuery = useKkoTemplateDetailQuery(selectedCode, enabled);
const templateList = useMemo<TemplateSummaryWithPurpose[]>(() => templateListQuery.data ?? [], [templateListQuery.data]);
const mainTemplateIdx = mainTemplateQuery.data ?? null;
const externalList = useMemo<KkoTemplateSummary[]>(() => {
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;
// Mutations
const saveTemplateMutation = useSaveTemplateMutation(CHNNL_TY, itrntPrjctCd);
const updateMainTemplateMutation = useUpdateMainTemplateMutation(prjctIdx, CHNNL_TY);
const resetToNew = () => {
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;
setDraft({
tmplatIdx: d.tmplatIdx,
tmplatNm: d.tmplatNm ?? "",
sendTel: d.sendTel ?? "",
kkoTmplatCd: d.kkoTmplatCd ?? "",
});
setSavedPreview({ body: d.tmplatBody ?? "", title: d.tmplatTitle ?? "" });
setSelectedCode("");
setSelectedSummary(
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;
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 handleSelectExternal = (item: KkoTemplateSummary | null) => {
if (!item) return;
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 (!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") => {
const v = validateDraft(draft);
if (!v.success) {
alert(v.errMessage);
return;
}
// 저장 직전에 외부 상세를 다시 조회해 저장 가능 여부를 확인한다.
// 화면에서 고른 뒤 상태가 바뀌었을 수 있고, 저장된 템플릿을 수정할 때는 상세를 아직 조회하지 않았기 때문이다.
try {
const latestDetail = await fetchKkoTemplateDetail(draft.kkoTmplatCd);
const warning = getUnsavableWarning(latestDetail);
if (warning) {
alert(warning);
return;
}
} catch (e) {
// 조회 오류는 공통 HTTP 오류 처리로 안내된다. 입력값은 유지한다.
console.log(e);
return;
}
// 본문·제목·senderKey·첨부는 보내지 않는다. 서버가 저장 시 외부 상세를 재조회해 채운다.
const template: TemplateKko & { 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,
};
try {
const res = await saveTemplateMutation.mutateAsync({ method, template });
if (!isKkoTemplate(res)) return;
// 저장 응답의 본문·제목·코드를 최종 화면 값으로 쓴다.
setDraft({
tmplatIdx: res.tmplatIdx,
tmplatNm: res.tmplatNm ?? draft.tmplatNm,
sendTel: res.sendTel ?? draft.sendTel,
kkoTmplatCd: res.kkoTmplatCd ?? draft.kkoTmplatCd,
});
setSavedPreview({ body: res.tmplatBody ?? "", title: res.tmplatTitle ?? "" });
setSelectedTemplateIdx(res.tmplatIdx ?? null);
setSelectedCode("");
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 previewBody = externalDetail ? externalDetail.templateContent : savedPreview?.body ?? "";
const previewTitle = externalDetail ? externalDetail.templateTitle ?? "" : savedPreview?.title ?? "";
const unsavableWarning = externalDetail ? getUnsavableWarning(externalDetail) : null;
return (
<div className="w-full mx-auto p-6 max-w-7xl">
<Card>
<CardHeader className="border-b">
<CardTitle className="text-center text-lg font-bold">알림톡 템플릿 관리</CardTitle>
</CardHeader>
<CardContent className="pt-6">
<div className="grid grid-cols-1 lg:grid-cols-[1fr_340px] gap-6 items-start">
<div className="space-y-6">
<div className="space-y-2">
<div className="flex items-center justify-between">
<Label className="text-base">템플릿</Label>
<div className="flex items-center gap-2">
<Checkbox id="kkoMainTemplate" checked={mainDesired} onClick={toggleMainTemplate} />
<label htmlFor="kkoMainTemplate" className="text-base cursor-pointer">
대표 템플릿
</label>
</div>
</div>
<KriSingleSelect
items={templateList}
value={String(draft.tmplatIdx || "")}
onChange={handleSelectTemplate}
placeholder="템플릿을 선택해 주세요"
heightClassName="h-9"
widthClassName="w-full"
getLabel={(item) => item.tmplatNm}
getValue={(item) => String(item.tmplatIdx)}
preventDeselect
useClear
clearLabel="새 템플릿 생성"
/>
</div>
<div className="space-y-2">
<Label className="text-base">알림톡 템플릿</Label>
<KriSingleSelect<KkoTemplateSummary>
items={externalList}
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
/>
<p className="text-xs text-muted-foreground">
{kkoListQuery.isFetching
? "알림톡 템플릿을 조회하는 중입니다."
: kkoListQuery.isError
? "알림톡 템플릿 목록을 불러오지 못했습니다."
: `검색어는 ${KKO_TEMPLATE_KEYWORD_MIN_LENGTH}~${KKO_TEMPLATE_KEYWORD_MAX_LENGTH}자로 입력해 주세요.`}
</p>
</div>
<div className="space-y-2">
<Label className="text-base">템플릿 명</Label>
<p className="text-sm rounded-md border px-3 py-2 min-h-9 flex items-center bg-muted/30 wrap-anywhere">
{draft.tmplatNm || "알림톡 템플릿을 선택하면 템플릿 명이 그대로 사용됩니다."}
</p>
</div>
<div className="space-y-2">
<Label htmlFor="kkoSendTel" className="text-base">발신 번호</Label>
<Input
id="kkoSendTel"
placeholder="발신 번호를 입력하세요"
value={formatKoreanPhoneNumber(draft.sendTel)}
onChange={(e) => setDraft((prev) => ({ ...prev, sendTel: e.target.value.replace(/\D/g, "") }))}
/>
<p className="text-sm text-red-600 font-medium">
⚠️ 비즈 뿌리오에 등록된 발신 번호가 아니면 전송되지 않습니다.
</p>
</div>
<div className="space-y-2">
<Label className="text-base">발신자 명</Label>
<p className="text-sm rounded-md border px-3 py-2 h-9 flex items-center bg-muted/30">{KKO_SENDER_NAME}</p>
<p className="text-sm text-red-600 font-medium">
⚠️ 본문과 제목은 저장 시 서버가 최신 알림톡 템플릿을 다시 조회해 저장합니다. 변수 #{"{이름}"}은 리스트 헤더 이름과 같아야 값이 채워집니다.
</p>
</div>
</div>
<div className="mt-6 lg:mt-0 lg:border-l lg:pl-6 space-y-3">
<div className="flex items-center justify-between">
<p className="text-base font-semibold">미리보기</p>
{selectedCode && (
<Button
type="button"
variant="ghost"
size="sm"
className="gap-1"
onClick={() => void kkoDetailQuery.refetch()}
disabled={kkoDetailQuery.isFetching}
>
<RefreshCw className="h-3.5 w-3.5" />
상세 다시 조회
</Button>
)}
</div>
{selectedCode && kkoDetailQuery.isFetching && !externalDetail ? (
<p className="text-sm text-muted-foreground">상세를 불러오는 중입니다.</p>
) : (
<KriEditor
mode="kko"
value={previewBody}
onChange={() => {}}
kkoTitle={previewTitle || undefined}
kkoSenderName={KKO_SENDER_NAME}
placeholder="미리볼 내용이 없습니다."
className="max-w-none mx-0"
/>
)}
{selectedCode && kkoDetailQuery.isError && (
<p className="text-sm text-red-600" role="alert">상세를 불러오지 못했습니다. 다시 조회해 주세요.</p>
)}
{unsavableWarning && (
<p className="text-sm text-red-600" role="status">⚠️ {unsavableWarning}</p>
)}
</div>
</div>
<div className="flex justify-center gap-3 pt-6">
<Button onClick={() => void submitTemplate("put")} className="w-32 h-10" disabled={saveTemplateMutation.isPending || !!unsavableWarning}>
{draft.tmplatIdx ? "복사 후 저장" : "저장"}
</Button>
{draft.tmplatIdx && (
<Button
onClick={() => void submitTemplate("patch")}
className="w-32 h-10 bg-blue-500 text-white hover:bg-blue-600"
disabled={saveTemplateMutation.isPending || !!unsavableWarning}
>
수정
</Button>
)}
</div>
</CardContent>
</Card>
</div>
);
};
export default KkoMessageTemplate;

View File

@@ -1,16 +1,16 @@
'use client'
import { ChannelType, type TemplateSms } from '@kri/common/noti-hub'
import { ChannelType } from '@kri/common/noti-hub'
import { KriEditor } from '@/components/kri-editor'
import { applyLinkPreviewClass } from '@/components/kri-editor/utils/linkPreview'
import { sanitizeEmailHtml } from '@/components/message-template/emailHtmlPolicy'
import { normalizeQrCodeForEditor, renderQrCodePreviewHtml } from '@/components/message-template/qrcode'
import TemplateAttachmentList from '@/components/message-template/TemplateAttachmentList'
import { PHONE_VERIFICATION_PREVIEW_SUFFIX, TEMPLATE_PURPOSE } from '@/const/messageTemplateConst'
import { escapeHtml, substituteVariables } from '@/lib/variableSubstitution'
import { KKO_SENDER_NAME, PHONE_VERIFICATION_PREVIEW_SUFFIX, TEMPLATE_PURPOSE } from '@/const/messageTemplateConst'
import { escapeHtml, substituteKkoVariables, substituteVariables } from '@/lib/variableSubstitution'
import { cn } from '@/lib/utils'
import { useTemplateAttachmentImagesQuery } from '@/query/message'
import type { TemplateEmailWithAttachments, TemplateSmsWithAttachments, TemplateWithPurpose } from '@/types/message'
import { getTemplateAttachmentNames, type TemplateWithPurpose } from '@/types/message'
// 다이얼로그(max-h 90vh)의 헤더·푸터·미리보기 제목을 뺀 높이에 맞추되,
// 본문 입력칸 최소 높이(360px)가 잘리지 않도록 480px 아래로는 줄이지 않는다.
@@ -19,19 +19,22 @@ const SMS_PREVIEW_FRAME_CLASS_NAME = 'h-[clamp(480px,calc(90vh-240px),600px)]'
export type MessageSendPreviewProps = {
chnnlTy: ChannelType
template: TemplateWithPurpose | null
/** 지정하면 [$변수] 토큰을 값으로 치환한다(없는 값은 빈 문자열). 생략하면 토큰을 그대로 보여준다. */
/**
* 지정하면 변수 토큰을 값으로 치환한다. 생략하면 토큰을 그대로 보여준다.
* 문자·메일은 [$변수]를 치환하고 없는 값은 빈 문자열로, 알림톡은 #{변수}·[$변수]를 치환하고 없는 값은 원문을 유지한다.
*/
variableValues?: Record<string, string>
}
/**
* 문자/메일 발송 다이얼로그 공용 미리보기.
* 문자/메일/알림톡 발송 다이얼로그 공용 미리보기.
* 이메일 본문은 템플릿 관리 미리보기(KriEditor)와 같은 순서로 sanitize → 링크 스타일 → QR 예시 이미지 변환을 거친다.
* 알림톡 본문은 KriEditor(mode="kko")가 텍스트로만 렌더링한다.
*/
const MessageSendPreview = ({ chnnlTy, template, variableValues }: MessageSendPreviewProps) => {
const isSms = chnnlTy === ChannelType.SMS
const attachmentNames = template
? ((template as TemplateEmailWithAttachments | TemplateSmsWithAttachments).atchFl?.split('|').filter(Boolean) ?? [])
: []
const isKko = chnnlTy === ChannelType.KKO
const attachmentNames = template ? getTemplateAttachmentNames(template) : []
const smsAttachmentImages = useTemplateAttachmentImagesQuery(
template?.tmplatIdx ?? 0,
isSms ? attachmentNames : [],
@@ -48,6 +51,24 @@ const MessageSendPreview = ({ chnnlTy, template, variableValues }: MessageSendPr
const resolvedTitle = template ? substitute(template.tmplatTitle ?? '') : ''
if (isKko) {
const substituteKko = (contents: string) => (variableValues ? substituteKkoVariables(contents, variableValues) : contents)
return (
// min-w-0: 다이얼로그 grid 칸 너비를 넘지 않도록 한다.
<div className="min-w-0 space-y-2 rounded-md border p-4">
<p className="text-lg font-semibold">미리보기</p>
<KriEditor
mode="kko"
value={substituteKko(template?.tmplatBody ?? '')}
onChange={() => {}}
kkoTitle={template?.tmplatTitle ? substituteKko(template.tmplatTitle) : undefined}
kkoSenderName={KKO_SENDER_NAME}
placeholder="선택된 템플릿이 없습니다."
/>
</div>
)
}
return (
// min-w-0: 다이얼로그 grid 칸 너비를 넘지 않도록 한다.
<div className="min-w-0 space-y-2 rounded-md border p-4">
@@ -65,7 +86,7 @@ const MessageSendPreview = ({ chnnlTy, template, variableValues }: MessageSendPr
<div className="flex flex-col items-center">
<KriEditor
mode="sms"
value={substitute((template as TemplateSms).tmplatBody ?? '')}
value={substitute(template.tmplatBody ?? '')}
onChange={() => {}}
isSmsReadOnly
smsPreviewSuffix={

View File

@@ -6,6 +6,7 @@ import {
ChannelType,
MessageType,
SMS_TYPE_ARRAY,
TemplatePurpose,
TemplateSms,
} from "@kri/common/noti-hub";
import {Paperclip, X} from "lucide-react";
@@ -35,12 +36,11 @@ import {ProjectMainTemplateUpdateRequest, ProjectSurvey} from "@/types/project";
import type { DataVerification } from "@kri/common";
import {COMMON_TEXT_REGEX, EMAIL_REGEX} from "@/const/validationConst";
import {formatKoreanPhoneNumber} from "@/utils/phone";
import type {
TemplateAttachmentImage,
TemplateEmailWithAttachments,
TemplateSmsWithAttachments,
TemplateSummaryWithPurpose,
TemplateWithPurpose,
import {
getTemplateAttachmentNames,
type SmsEmailTemplateWithPurpose,
type TemplateAttachmentImage,
type TemplateSummaryWithPurpose,
} from "@/types/message";
import {
useTemplateListQuery,
@@ -73,7 +73,7 @@ import {
interface MessageTemplateProps {
pageTitle: string;
defaultTemplate: TemplateWithPurpose;
defaultTemplate: SmsEmailTemplateWithPurpose;
}
const MESSAGE_EDITOR_EXTENSIONS = [QrCode];
@@ -90,7 +90,7 @@ const MessageTemplate = ({ pageTitle, defaultTemplate }: MessageTemplateProps) =
const editorCmdRef = useRef<KriEditorCommand | null>(null);
const sessionTempUrlsRef = useRef<Set<string>>(new Set());
const [selectedTemplate, setSelectedTemplate] = useState<TemplateWithPurpose>(defaultTemplate);
const [selectedTemplate, setSelectedTemplate] = useState<SmsEmailTemplateWithPurpose>(defaultTemplate);
const [selectedTemplateIdx, setSelectedTemplateIdx] = useState<number | null>(null);
// 이메일 첨부파일 draft (신규 첨부 / 기존 첨부 삭제 예정). 저장 성공 시, 템플릿 전환 시 초기화된다.
@@ -98,7 +98,7 @@ const MessageTemplate = ({ pageTitle, defaultTemplate }: MessageTemplateProps) =
const [deletedAttachmentNames, setDeletedAttachmentNames] = useState<string[]>([]);
const attachmentInputRef = useRef<HTMLInputElement | null>(null);
const isSmsTemplate = (t: TemplateWithPurpose): t is TemplateSms & Pick<TemplateWithPurpose, "tmplatPurpose"> =>
const isSmsTemplate = (t: SmsEmailTemplateWithPurpose): t is TemplateSms & { tmplatPurpose: TemplatePurpose } =>
(SMS_TYPE_ARRAY as readonly MessageType[]).includes(t.tmplatTy);
const isSms = isSmsTemplate(defaultTemplate);
@@ -129,10 +129,7 @@ const MessageTemplate = ({ pageTitle, defaultTemplate }: MessageTemplateProps) =
const surveys = useMemo<ProjectSurvey[]>(() => projectInfoQuery.data?.surveys ?? [], [projectInfoQuery.data?.surveys])
// 서버에 저장된 첨부파일명 목록 (파이프(|) 구분, 이메일·문자 템플릿 공통)
const existingAttachmentNames = useMemo<string[]>(() => {
const atchFl = (selectedTemplate as TemplateEmailWithAttachments | TemplateSmsWithAttachments).atchFl;
return atchFl ? atchFl.split("|").filter(Boolean) : [];
}, [selectedTemplate]);
const existingAttachmentNames = useMemo<string[]>(() => getTemplateAttachmentNames(selectedTemplate), [selectedTemplate]);
// 교체 대상(같은 이름의 새 파일)도 삭제 예정에 들어가 있으므로 여기서 제외된다.
const keptAttachmentNames = existingAttachmentNames.filter((name) => !deletedAttachmentNames.includes(name));
@@ -195,7 +192,7 @@ const MessageTemplate = ({ pageTitle, defaultTemplate }: MessageTemplateProps) =
// 템플릿 상세가 도착하면 draft에 주입
useEffect(() => {
const d = templateDetailQuery.data;
if (!d) return;
if (!d || d.tmplatTy === MessageType.KKO) return;
if (selectedTemplateIdx && d.tmplatIdx === selectedTemplateIdx) {
setSelectedTemplate(d);
resetAttachmentDraft();
@@ -209,14 +206,14 @@ const MessageTemplate = ({ pageTitle, defaultTemplate }: MessageTemplateProps) =
}
}, [selectedTemplate.tmplatIdx, mainTemplateIdx]);
const handleChange = <K extends KeysOfUnion<TemplateWithPurpose>>(
const handleChange = <K extends KeysOfUnion<SmsEmailTemplateWithPurpose>>(
field: K,
value: ValueOfUnionKey<TemplateWithPurpose, K>
value: ValueOfUnionKey<SmsEmailTemplateWithPurpose, K>
) => {
setSelectedTemplate((prev) => {
const next = { ...prev } as any;
next[field] = value;
return next as TemplateWithPurpose;
return next as SmsEmailTemplateWithPurpose;
});
};
@@ -233,7 +230,7 @@ const MessageTemplate = ({ pageTitle, defaultTemplate }: MessageTemplateProps) =
});
};
const validateTemplate = (tpl: TemplateWithPurpose): DataVerification => {
const validateTemplate = (tpl: SmsEmailTemplateWithPurpose): DataVerification => {
const ok = (): DataVerification => ({ success: true, fieldName: "", errMessage: "" });
const fail = (fieldName: string, errMessage: string): DataVerification => ({
success: false,
@@ -444,6 +441,8 @@ const MessageTemplate = ({ pageTitle, defaultTemplate }: MessageTemplateProps) =
deleteFileNames: method === "patch" ? deletedAttachmentNames : undefined,
});
// 이메일·문자 화면에서 저장했으므로 알림톡 응답은 오지 않는다. 타입 좁히기용 방어 코드.
if (res.tmplatTy === MessageType.KKO) return;
setSelectedTemplate(res);
setSelectedTemplateIdx(res.tmplatIdx ?? null);
resetAttachmentDraft();
@@ -532,7 +531,7 @@ const MessageTemplate = ({ pageTitle, defaultTemplate }: MessageTemplateProps) =
<RadioGroup
value={String(selectedTemplate.tmplatPurpose ?? TEMPLATE_PURPOSE.NORMAL)}
onValueChange={(value) =>
handleChange("tmplatPurpose", Number(value) as 0 | 1)
handleChange("tmplatPurpose", Number(value) as TemplatePurpose)
}
className="flex flex-wrap gap-4"
>
@@ -769,7 +768,7 @@ const MessageTemplate = ({ pageTitle, defaultTemplate }: MessageTemplateProps) =
<KriEditor
mode="sms"
label={selectedTemplate.tmplatTy === MessageType.SMS ? "️️* 발송 시 길이에 따라 LMS/MMS로 발송 될 수 있음" : undefined}
value={(selectedTemplate as TemplateSms).tmplatBody ?? ""}
value={selectedTemplate.tmplatBody ?? ""}
onChange={(html: string) => setTemplateBody(html)}
placeholder="문자 내용을 입력해 주세요"
className="max-w-none mx-0"
@@ -777,7 +776,7 @@ const MessageTemplate = ({ pageTitle, defaultTemplate }: MessageTemplateProps) =
onCommandReady={(cmd) => {
editorCmdRef.current = cmd;
}}
smsTitle={(selectedTemplate as TemplateSms).tmplatTitle}
smsTitle={selectedTemplate.tmplatTitle}
smsPreviewSuffix={
selectedTemplate.tmplatPurpose === TEMPLATE_PURPOSE.PHONE_VERIFICATION
? PHONE_VERIFICATION_PREVIEW_SUFFIX