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;