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

@@ -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