260303_01_ENH: TanStack Query 적용

This commit is contained in:
2026-03-03 16:07:41 +09:00
parent 4b22120f45
commit d8e894b136
29 changed files with 1631 additions and 1143 deletions

View File

@@ -2,7 +2,7 @@
import {useSelectedProject} from "@/hooks/useSelectedProject";
import {useCallback, useEffect, useRef, useState} from "react";
import {listHder, ListHeaderGrade, ListHeaderType} from "@/types/list";
import {listHder} from "@/types/list";
import {
ChannelType,
MessageType,
@@ -11,8 +11,6 @@ import {
TemplateSms,
TemplateSummary
} from "@/types/messageTemplate";
import {isTextAreaElement, isTipTapEditor} from "@/components/kri-editor/utils/editorTypeGuards";
import {nextApi} from "@/lib/http-client";
import {Card, CardContent, CardHeader, CardTitle} from "@/components/ui/card";
import {Label} from "@/components/ui/label";
import {KriSingleSelect} from "@/components/common/KriAutoComplete";
@@ -22,63 +20,100 @@ import {Checkbox} from "@/components/ui/checkbox";
import {KriEditor, KriEditorCommand} from "@/components/kri-editor";
import {Button} from "@/components/ui/button";
import {cn, isBlank} from "@/lib/utils";
import _ from "lodash";
import {ProjectMainTemplateUpdateRequest} from "@/types/project";
import {toast} from "sonner";
import { DataVerification } from "@/types/common";
import {
useTemplateListQuery,
useMainTemplateIdxQuery,
useTemplateQuery,
useSaveTemplateMutation,
useUpdateMainTemplateMutation,
useUploadTemplateBodyImageMutation,
} from "@/query/message";
interface MessageTemplateProps {
pageTitle: string;
defaultTemplate: Template;
}
const MessageTemplate = ({
pageTitle,
defaultTemplate,
}: MessageTemplateProps) => {
const MessageTemplate = ({ pageTitle, defaultTemplate }: MessageTemplateProps) => {
const { selectedProject } = useSelectedProject();
const editorCmdRef = useRef<KriEditorCommand | null>(null);
const sessionTempUrlsRef = useRef<Set<string>>(new Set());
const [mainTemplateIdx, setMainTemplateIdx] = useState<number|null>(null);
const [listHderList, setListHderList] = useState<listHder[]>([])
const [templateList, setTemplateList] = useState<TemplateSummary[]>([]);
const [listHderList, setListHderList] = useState<listHder[]>([]);
const [selectedTemplate, setSelectedTemplate] = useState<Template>(defaultTemplate);
const [isMainTemplate, setIsMainTemplate] = useState(false);
const [selectedTemplateIdx, setSelectedTemplateIdx] = useState<number | null>(null);
const isSmsTemplate = (t: Template): t is TemplateSms =>
const isSmsTemplate = (t: Template): t is TemplateSms =>
(SMS_TYPE_ARRAY as readonly MessageType[]).includes(t.tmplatTy);
const isSms = isSmsTemplate(defaultTemplate);
const chnnlTy:ChannelType = isSms? ChannelType.SMS : ChannelType.EMAIL;
const chnnlTy: ChannelType = isSms ? ChannelType.SMS : ChannelType.EMAIL;
// 유니온의 키를 합집합으로 뽑기
type KeysOfUnion<T> = T extends unknown ? keyof T : never;
// 특정 키의 값 타입을 유니온에서 안전하게 뽑기
type ValueOfUnionKey<T, K extends KeysOfUnion<T>> =
T extends unknown ? (K extends keyof T ? T[K] : never) : never;
const handleSelectTemplate = (templateIdxString: string) => {
if(!selectedProject) return
const prjctIdx = selectedProject?.prjctIdx ?? 0;
const itrntPrjctCd = selectedProject?.itrntPrjctCd ?? "";
const enabled = !!selectedProject && prjctIdx > 0 && !!itrntPrjctCd;
if(!templateIdxString){
const projectDefaultTemplate = _.cloneDeep(defaultTemplate);
projectDefaultTemplate.itrntPrjctCd = selectedProject.itrntPrjctCd;
setSelectedTemplate(projectDefaultTemplate);
// Queries
const templateListQuery = useTemplateListQuery(chnnlTy, itrntPrjctCd, enabled);
const mainTemplateQuery = useMainTemplateIdxQuery(prjctIdx, chnnlTy, enabled);
const templateDetailQuery = useTemplateQuery(selectedTemplateIdx ?? 0, enabled && !!selectedTemplateIdx);
const templateList: TemplateSummary[] = templateListQuery.data ?? [];
const mainTemplateIdx = mainTemplateQuery.data ?? null;
// Mutations
const saveTemplateMutation = useSaveTemplateMutation(chnnlTy, itrntPrjctCd);
const updateMainTemplateMutation = useUpdateMainTemplateMutation(prjctIdx, chnnlTy);
const uploadBodyImageMutation = useUploadTemplateBodyImageMutation(itrntPrjctCd);
// 대표 템플릿 체크 상태(사용자 의도)
const [mainDesired, setMainDesired] = useState(false);
// selectedProject 변경 시 초기화
useEffect(() => {
if (!selectedProject) return;
const projectDefaultTemplate = structuredClone(defaultTemplate);
projectDefaultTemplate.itrntPrjctCd = selectedProject.itrntPrjctCd;
setSelectedTemplateIdx(null);
setSelectedTemplate(projectDefaultTemplate);
setMainDesired(false);
// TODO: 프로젝트별 리스트 헤더 조회로 교체
setListHderList([]);
}, [selectedProject, defaultTemplate]);
// 템플릿 상세가 도착하면 draft에 주입
useEffect(() => {
const d = templateDetailQuery.data;
if (!d) return;
if (selectedTemplateIdx && d.tmplatIdx === selectedTemplateIdx) {
setSelectedTemplate(d);
}
else{
nextApi.get<Template>(`/message-template/${templateIdxString}`).then(setSelectedTemplate);
}, [templateDetailQuery.data, selectedTemplateIdx]);
// 대표 템플릿 동기화(현재 선택 템플릿이 id를 가진 경우에만)
useEffect(() => {
if (selectedTemplate.tmplatIdx) {
setMainDesired(selectedTemplate.tmplatIdx === mainTemplateIdx);
}
}
}, [selectedTemplate.tmplatIdx, mainTemplateIdx]);
const handleChange = <K extends KeysOfUnion<Template>>(
field: K,
value: ValueOfUnionKey<Template, K>
) => {
setSelectedTemplate(prev => {
setSelectedTemplate((prev) => {
const next = { ...prev } as any;
next[field] = value;
return next as Template;
@@ -86,66 +121,20 @@ const MessageTemplate = ({
};
const setTemplateBody = (newString: string) => {
setSelectedTemplate(prev => ({ ...prev, tmplatBody: newString }));
setSelectedTemplate((prev) => ({ ...prev, tmplatBody: newString }));
};
const setSmsType = (smsTypeString: "SMS" | "LMS") => {
const smsType =
smsTypeString === "SMS" ? MessageType.SMS : MessageType.LMS_MMS;
const smsType = smsTypeString === "SMS" ? MessageType.SMS : MessageType.LMS_MMS;
setSelectedTemplate((prev) => {
if (!isSmsTemplate(prev)) return prev;
return {
...prev,
tmplatTy: smsType,
};
return { ...prev, tmplatTy: smsType };
});
};
const handleCreate = async () => {
await submitTemplate("put");
};
const handleUpdate = async () => {
if (!selectedTemplate.tmplatIdx) return;
await submitTemplate("patch");
};
const submitTemplate = async (method: "put" | "patch") => {
const v = validateTemplate(selectedTemplate);
if (!v.success) {
alert(v.errMessage);
// 필요 시: 특정 필드 focus 처리도 가능
// focusField(v.fieldName);
return;
}
try {
const res =
method === "put"
? await nextApi.put<Template>(`/message-template`, selectedTemplate)
: await nextApi.patch<Template>(`/message-template`, selectedTemplate);
settingTemplateList();
setSelectedTemplate(res);
updateMainTemplate(res.tmplatIdx!);
alert(method === "put" ? "저장되었습니다." : "수정되었습니다.");
} catch (e) {
console.log(e);
alert(method === "put" ? "저장에 실패했습니다." : "수정에 실패했습니다.");
}
};
const validateTemplate = (tpl: Template): DataVerification => {
const ok = (): DataVerification => ({
success: true,
fieldName: "",
errMessage: "",
});
const ok = (): DataVerification => ({ success: true, fieldName: "", errMessage: "" });
const fail = (fieldName: string, errMessage: string): DataVerification => ({
success: false,
fieldName,
@@ -157,108 +146,132 @@ const MessageTemplate = ({
if (isBlank(tpl.tmplatBody)) return fail("tmplatBody", "본문을 입력해 주세요.");
if (isBlank(tpl.sendNm)) return fail("sendNm", "발신자명을 입력해 주세요.");
// Email 전용
if (tpl.tmplatTy === MessageType.EMAIL) {
if (isBlank(tpl.tmplatTitle)) return fail("tmplatTitle", "이메일 제목을 입력해 주세요.");
if (isBlank(tpl.sendEml)) return fail("sendEml", "발신 이메일을 입력해 주세요.");
return ok();
}
// SMS 전용
if (isBlank(tpl.sendTel)) return fail("sendTel", "발신 전화번호를 입력해 주세요.");
return ok();
};
const updateMainTemplate = (templatIdx:number):void => {
if(!selectedProject || !selectedProject.prjctIdx) return;
const handleSelectTemplate = (templateIdxString: string) => {
if (!selectedProject) return;
let updateFlag = false;
let updateTemplateIdx: number | null = null;
if (!templateIdxString) {
const projectDefaultTemplate = structuredClone(defaultTemplate);
projectDefaultTemplate.itrntPrjctCd = selectedProject.itrntPrjctCd;
if(isMainTemplate && mainTemplateIdx !== templatIdx){
updateFlag = true;
updateTemplateIdx = templatIdx;
setSelectedTemplateIdx(null);
setSelectedTemplate(projectDefaultTemplate);
setMainDesired(false);
return;
}
if(!isMainTemplate && mainTemplateIdx === templatIdx){
updateFlag = true;
}
const idx = Number(templateIdxString);
if (!Number.isFinite(idx)) return;
setSelectedTemplateIdx(idx);
};
if(updateFlag){
const req:ProjectMainTemplateUpdateRequest = {
prjctIdx: selectedProject.prjctIdx,
chnnlTy:chnnlTy,
tmplatIdx:updateTemplateIdx,
}
const toggleMainTemplate = async () => {
if (!selectedProject) return;
nextApi.patch(`/project/main-template`, req);
setMainTemplateIdx(updateTemplateIdx);
}
}
const next = !mainDesired;
setMainDesired(next);
const tmplatIdx = selectedTemplate.tmplatIdx ?? null;
if (!tmplatIdx) return; // 새 템플릿(미저장)은 저장 후 대표 적용
// next=true => 이 템플릿을 대표로
// next=false => 이 템플릿이 현재 대표일 때만 해제(null)
const updateTemplateIdx = next ? tmplatIdx : (mainTemplateIdx === tmplatIdx ? null : mainTemplateIdx);
// 변화 없으면 요청 X
if (updateTemplateIdx === mainTemplateIdx) return;
const req: ProjectMainTemplateUpdateRequest = {
prjctIdx: selectedProject.prjctIdx,
chnnlTy,
tmplatIdx: updateTemplateIdx,
};
await updateMainTemplateMutation.mutateAsync(req);
};
const handleVariableClick = (placeholder: string) => {
editorCmdRef.current?.insertText(placeholder);
};
const toggleIsMainTemplate = () => {
setIsMainTemplate(!isMainTemplate);
}
const handleImageUpload = useCallback(
async (file: File): Promise<{ url: string }> => {
if (!selectedProject) return { url: "" };
const url = await uploadBodyImageMutation.mutateAsync(file);
sessionTempUrlsRef.current.add(url);
return { url };
},
[selectedProject, uploadBodyImageMutation]
);
const handleImageUpload = useCallback(async (file: File): Promise<{ url: string }> => {
if(selectedProject) {
const formData = new FormData();
formData.append("file", file);
const url = await nextApi.putForm<string>(`/message-template/body-image/${selectedProject?.itrntPrjctCd}`, formData);
// 이 세션에서 업로드한 temp 파일 목록에 기록
sessionTempUrlsRef.current.add(url);
return { url }
const submitTemplate = async (method: "put" | "patch") => {
const v = validateTemplate(selectedTemplate);
if (!v.success) {
alert(v.errMessage);
return;
}
return { url: '' }
}, [selectedProject]);
try {
const res = await saveTemplateMutation.mutateAsync({
method,
template: selectedTemplate,
});
const settingTemplateList = useCallback(() => {
if(!selectedProject) return;
setSelectedTemplate(res);
setSelectedTemplateIdx(res.tmplatIdx ?? null);
nextApi.get<TemplateSummary[]>(`/message-template/list/${chnnlTy}/${selectedProject.itrntPrjctCd}`).then(setTemplateList);
}, [selectedProject, chnnlTy]);
// 대표 템플릿 의도가 true면 저장된 템플릿을 대표로 반영
if (mainDesired && selectedProject?.prjctIdx && res.tmplatIdx) {
await updateMainTemplateMutation.mutateAsync({
prjctIdx: selectedProject.prjctIdx,
chnnlTy,
tmplatIdx: res.tmplatIdx,
});
}
useEffect(() => {
if(!selectedProject) return;
alert(method === "put" ? "저장되었습니다." : "수정되었습니다.");
} catch (e) {
console.log(e);
alert(method === "put" ? "저장에 실패했습니다." : "수정에 실패했습니다.");
}
};
settingTemplateList();
nextApi.get<number | null>(`/project/main-template/${selectedProject.prjctIdx}/${chnnlTy}`).then(setMainTemplateIdx);
const handleCreate = async () => {
await submitTemplate("put");
};
const projectDefaultTemplate = _.cloneDeep(defaultTemplate);
projectDefaultTemplate.itrntPrjctCd = selectedProject.itrntPrjctCd;
setSelectedTemplate(projectDefaultTemplate);
//Todo: 프로젝트 별 리스트 헤더 조회해서 세팅하기
setListHderList([]);
}, [selectedProject]);
useEffect(() => {
setIsMainTemplate(selectedTemplate.tmplatIdx === mainTemplateIdx);
}, [selectedTemplate.tmplatIdx]);
const handleUpdate = async () => {
if (!selectedTemplate.tmplatIdx) return;
await submitTemplate("patch");
};
return (
<div className={cn(
"w-full mx-auto p-6",
isSms ? "max-w-7xl" : "max-w-4xl"
)}>
<div
className={cn(
"w-full mx-auto p-6",
isSms ? "max-w-7xl" : "max-w-4xl"
)}
>
<Card>
<CardHeader className="border-b">
<CardTitle className="text-center content-text-lg font-bold">{pageTitle}</CardTitle>
<CardTitle className="text-center content-text-lg font-bold">
{pageTitle}
</CardTitle>
</CardHeader>
<CardContent className="pt-6 relative">
<div
className={cn(
isSms
? "grid grid-cols-1 lg:grid-cols-[1fr_340px] gap-6 items-start"
: ""
isSms ? "grid grid-cols-1 lg:grid-cols-[1fr_340px] gap-6 items-start" : ""
)}
>
<div className="space-y-6">
@@ -267,17 +280,19 @@ const MessageTemplate = ({
<Label htmlFor="tmplatNm" className="content-text-base">
템플릿
</Label>
<div className="flex items-center gap-2">
<Checkbox
id="mainTemplate"
checked={isMainTemplate}
onClick={toggleIsMainTemplate}
checked={mainDesired}
onClick={toggleMainTemplate}
/>
<label htmlFor="mainTemplate" className="content-text-base cursor-pointer">
대표 템플릿
</label>
</div>
</div>
<KriSingleSelect
items={templateList}
value={String(selectedTemplate.tmplatIdx || "")}
@@ -287,8 +302,8 @@ const MessageTemplate = ({
widthClassName="w-full"
getLabel={(item) => item.tmplatNm}
getValue={(item) => String(item.tmplatIdx)}
preventDeselect={true}
useClear={true}
preventDeselect
useClear
clearLabel="새 테플릿 생성"
/>
</div>
@@ -299,7 +314,7 @@ const MessageTemplate = ({
<KriSingleSelect
items={[...SMS_TYPE_OPTIONS]}
value={String(selectedTemplate.tmplatTy || MessageType.SMS)}
onChange={(value) => handleChange('tmplatTy', Number(value))}
onChange={(value) => handleChange("tmplatTy", Number(value) as any)}
placeholder="템플릿 타입을 선택해 주세요"
heightClassName="h-9"
widthClassName="w-full"
@@ -308,6 +323,7 @@ const MessageTemplate = ({
/>
</div>
)}
<div className="space-y-2">
<Label htmlFor="tmplatNm" className="content-text-base">
템플릿 명
@@ -316,9 +332,10 @@ const MessageTemplate = ({
id="tmplatNm"
placeholder="템플릿 명을 입력하세요"
value={selectedTemplate.tmplatNm}
onChange={(e) => handleChange('tmplatNm', e.target.value)}
onChange={(e) => handleChange("tmplatNm", e.target.value as any)}
/>
</div>
<div className="space-y-2">
<Label htmlFor="tmplatTitle" className="content-text-base">
제목
@@ -326,49 +343,61 @@ const MessageTemplate = ({
<Input
id="tmplatTitle"
placeholder="제목을 입력하세요"
value={selectedTemplate.tmplatTitle || ''}
onChange={(e) => handleChange('tmplatTitle', e.target.value)}
value={selectedTemplate.tmplatTitle || ""}
onChange={(e) => handleChange("tmplatTitle", e.target.value as any)}
/>
</div>
<div className="space-y-3">
<div className="flex items-center">
<Label className="content-text-base">변수 리스트</Label>
</div>
<div className="border rounded-md overflow-hidden">
<div className="bg-blue-100 grid grid-cols-2 border-b">
<div className="py-2 px-3 text-center font-medium border-r content-text-base">리스트 헤더명</div>
<div className="py-2 px-3 text-center font-medium content-text-base">치환 문자</div>
<div className="py-2 px-3 text-center font-medium border-r content-text-base">
리스트 헤더명
</div>
<div className="py-2 px-3 text-center font-medium content-text-base">
치환 문자
</div>
</div>
<div className="max-h-32 overflow-y-auto">
{listHderList.map((listHder) =>
{
const placeholder = `[\$${listHder.listHderNm}]`
return (
<div
key={listHder.listHderId}
className="grid grid-cols-2 border-b last:border-b-0 hover:bg-blue-50 cursor-pointer transition-colors"
onPointerDown={(e) => {
e.preventDefault();
handleVariableClick(placeholder);
}}
>
<div className="py-2 px-3 text-center border-r content-text-base">{listHder.listHderNm}</div>
<div className="py-2 px-3 text-center content-text-base">{placeholder}</div>
</div>
)
}
)}
{listHderList.map((h) => {
const placeholder = `[\$${h.listHderNm}]`;
return (
<div
key={h.listHderId}
className="grid grid-cols-2 border-b last:border-b-0 hover:bg-blue-50 cursor-pointer transition-colors"
onPointerDown={(e) => {
e.preventDefault();
handleVariableClick(placeholder);
}}
>
<div className="py-2 px-3 text-center border-r content-text-base">
{h.listHderNm}
</div>
<div className="py-2 px-3 text-center content-text-base">
{placeholder}
</div>
</div>
);
})}
</div>
</div>
</div>
{selectedTemplate && (
isSmsTemplate(selectedTemplate)?
{selectedTemplate ? (
isSmsTemplate(selectedTemplate) ? (
<div className="space-y-2">
<Label htmlFor="sendTel" className="content-text-base">발신 번호</Label>
<Label htmlFor="sendTel" className="content-text-base">
발신 번호
</Label>
<Input
id="sendTel"
value={selectedTemplate.sendTel}
onChange={(e) => handleChange('sendTel', e.target.value)}
onChange={(e) => handleChange("sendTel", e.target.value as any)}
placeholder="발신 번호를 입력하세요"
className="w-full"
/>
@@ -376,18 +405,21 @@ const MessageTemplate = ({
⚠️ 비즈 뿌리오에 등록된 발신 번호가 아니면 전송되지 않습니다.
</p>
</div>
:
) : (
<div className="space-y-2">
<Label htmlFor="sendEmail" className="content-text-base">발신 이메일</Label>
<Label htmlFor="sendEmail" className="content-text-base">
발신 이메일
</Label>
<Input
id="sendEmail"
value={selectedTemplate.sendEml}
onChange={(e) => handleChange('sendEml', e.target.value)}
onChange={(e) => handleChange("sendEml", e.target.value as any)}
placeholder="발신 이메일을 입력하세요"
className="w-full"
/>
</div>
)}
)
) : null}
<div className="space-y-2">
<Label htmlFor="sendNm" className="content-text-base">
@@ -397,20 +429,22 @@ const MessageTemplate = ({
id="sendNm"
placeholder="발신자 명을 입력하세요"
value={selectedTemplate.sendNm}
onChange={(e) => handleChange('sendNm', e.target.value)}
onChange={(e) => handleChange("sendNm", e.target.value as any)}
/>
</div>
{!isSms && (
<KriEditor
editorMode={'both'}
editorMode={"both"}
value={selectedTemplate.tmplatBody ?? "<p></p>"}
onChange={(html: string) => setTemplateBody(html)}
placeholder="이메일 내용을 입력해 주세요"
className="w-full"
debounceMs={600}
onCommandReady={(cmd) => { editorCmdRef.current = cmd; }}
onImageUpload={async (file) => await handleImageUpload(file)} // 사용 시만
onCommandReady={(cmd) => {
editorCmdRef.current = cmd;
}}
onImageUpload={async (file) => await handleImageUpload(file)}
/>
)}
</div>
@@ -424,13 +458,16 @@ const MessageTemplate = ({
placeholder="문자 내용을 입력해 주세요"
className="max-w-none mx-0"
debounceMs={600}
onCommandReady={(cmd) => { editorCmdRef.current = cmd; }}
onCommandReady={(cmd) => {
editorCmdRef.current = cmd;
}}
smsTitle={(selectedTemplate as TemplateSms).tmplatTitle}
changeSmsType={(smsTypeString) => setSmsType(smsTypeString)}
/>
</div>
)}
</div>
<div className="flex justify-center gap-3 pt-4">
<Button onClick={handleCreate} className="w-32 h-10">
{selectedTemplate.tmplatIdx ? "복사 후 저장" : "저장"}
@@ -448,7 +485,7 @@ const MessageTemplate = ({
</CardContent>
</Card>
</div>
)
}
);
};
export default MessageTemplate
export default MessageTemplate;