260806_01_ENH: 이메일 첨부파일 등록 추가

This commit is contained in:
2026-08-06 14:55:27 +09:00
parent cf94ea21b7
commit 86b626b5ea
8 changed files with 336 additions and 27 deletions

View File

@@ -10,20 +10,23 @@ import {
TemplateSms,
TemplateSummary
} from "@kri/common/noti-hub";
import {Paperclip, X} from "lucide-react";
import {Card, CardContent, CardHeader, CardTitle} from "@/components/ui/card";
import {Label} from "@/components/ui/label";
import {KriSingleSelect} from "@/components/common/KriAutoComplete";
import {SMS_TYPE_OPTIONS} from "@/const/messageTemplateConst";
import {SMS_TYPE_OPTIONS, TEMPLATE_ATTACHMENT_MAX_BYTES, TEMPLATE_ATTACHMENT_MAX_COUNT} from "@/const/messageTemplateConst";
import {Input} from "@/components/ui/input";
import {Checkbox} from "@/components/ui/checkbox";
import {KriEditor, KriEditorCommand} from "@/components/kri-editor";
import {Button} from "@/components/ui/button";
import { isBlank } from "@kri/common";
import { downloadFile } from "@kri/common/browser";
import {cn} from "@/lib/utils";
import {ProjectMainTemplateUpdateRequest, ProjectSurvey} from "@/types/project";
import type { DataVerification } from "@kri/common";
import {COMMON_TEXT_REGEX} from "@/const/validationConst";
import {formatKoreanPhoneNumber} from "@/utils/phone";
import type {TemplateEmailWithAttachments} from "@/types/message";
import {
useTemplateListQuery,
useMainTemplateIdxQuery,
@@ -31,6 +34,7 @@ import {
useSaveTemplateMutation,
useUpdateMainTemplateMutation,
useUploadTemplateBodyImageMutation,
useDownloadTemplateAttachmentMutation,
} from "@/query/message";
import {listHeader} from "@/types/list";
import {useListHeaderQuery} from "@/query/list";
@@ -61,6 +65,11 @@ const MessageTemplate = ({ pageTitle, defaultTemplate }: MessageTemplateProps) =
const [selectedTemplate, setSelectedTemplate] = useState<Template>(defaultTemplate);
const [selectedTemplateIdx, setSelectedTemplateIdx] = useState<number | null>(null);
// 이메일 첨부파일 draft (신규 첨부 / 기존 첨부 삭제 예정). 저장 성공 시, 템플릿 전환 시 초기화된다.
const [newAttachmentFiles, setNewAttachmentFiles] = useState<File[]>([]);
const [deletedAttachmentNames, setDeletedAttachmentNames] = useState<string[]>([]);
const attachmentInputRef = useRef<HTMLInputElement | null>(null);
const isSmsTemplate = (t: Template): t is TemplateSms =>
(SMS_TYPE_ARRAY as readonly MessageType[]).includes(t.tmplatTy);
@@ -89,8 +98,21 @@ const MessageTemplate = ({ pageTitle, defaultTemplate }: MessageTemplateProps) =
const listHderList = useMemo<listHeader[]>(() => listHeaderQuery.data ?? [], [listHeaderQuery.data])
const surveys = useMemo<ProjectSurvey[]>(() => projectInfoQuery.data?.surveys ?? [], [projectInfoQuery.data?.surveys])
// 서버에 저장된 첨부파일명 목록 (파이프(|) 구분, 이메일 템플릿만 해당)
const existingAttachmentNames = useMemo<string[]>(() => {
if (isSmsTemplate(selectedTemplate)) return [];
const atchFl = (selectedTemplate as TemplateEmailWithAttachments).atchFl;
return atchFl ? atchFl.split("|").filter(Boolean) : [];
}, [selectedTemplate]);
const resetAttachmentDraft = () => {
setNewAttachmentFiles([]);
setDeletedAttachmentNames([]);
};
// Mutations
const saveTemplateMutation = useSaveTemplateMutation(chnnlTy, itrntPrjctCd);
const downloadAttachmentMutation = useDownloadTemplateAttachmentMutation(selectedTemplate.tmplatIdx ?? 0);
const updateMainTemplateMutation = useUpdateMainTemplateMutation(prjctIdx, chnnlTy);
const uploadBodyImageMutation = useUploadTemplateBodyImageMutation(itrntPrjctCd);
@@ -111,6 +133,7 @@ const MessageTemplate = ({ pageTitle, defaultTemplate }: MessageTemplateProps) =
setSelectedTemplate(projectDefaultTemplate);
setMainDesired(false);
mainTemplateAppliedRef.current = false;
resetAttachmentDraft();
}, [selectedProject, defaultTemplate]);
@@ -127,6 +150,7 @@ const MessageTemplate = ({ pageTitle, defaultTemplate }: MessageTemplateProps) =
if (!d) return;
if (selectedTemplateIdx && d.tmplatIdx === selectedTemplateIdx) {
setSelectedTemplate(d);
resetAttachmentDraft();
}
}, [templateDetailQuery.data, selectedTemplateIdx]);
@@ -207,12 +231,14 @@ const MessageTemplate = ({ pageTitle, defaultTemplate }: MessageTemplateProps) =
setSelectedTemplateIdx(null);
setSelectedTemplate(projectDefaultTemplate);
setMainDesired(false);
resetAttachmentDraft();
return;
}
const idx = Number(templateIdxString);
if (!Number.isFinite(idx)) return;
setSelectedTemplateIdx(idx);
resetAttachmentDraft();
};
const toggleMainTemplate = async () => {
@@ -254,6 +280,78 @@ const MessageTemplate = ({ pageTitle, defaultTemplate }: MessageTemplateProps) =
[selectedProject, uploadBodyImageMutation]
);
const handlePickAttachmentFiles = () => {
attachmentInputRef.current?.click();
};
const handleAttachmentFilesSelected = (e: React.ChangeEvent<HTMLInputElement>) => {
const picked = Array.from(e.target.files ?? []);
e.target.value = "";
if (picked.length === 0) return;
const nextFiles = [...newAttachmentFiles];
const nextDeleted = [...deletedAttachmentNames];
for (const file of picked) {
if (file.size === 0) {
alert(`${file.name}: 빈 파일은 첨부할 수 없습니다.`);
continue;
}
if (file.size >= TEMPLATE_ATTACHMENT_MAX_BYTES) {
const alertFileSize = TEMPLATE_ATTACHMENT_MAX_BYTES / 1_000_000;
alert(`${file.name}: 파일 크기는 ${alertFileSize.toLocaleString()}MB 미만이어야 합니다.`);
continue;
}
if (nextFiles.some((f) => f.name === file.name)) {
alert(`${file.name}: 이미 추가된 파일명입니다.`);
continue;
}
// 기존 첨부와 같은 이름이면 "교체"로 처리 (deleteFileNames에도 같은 이름을 포함해야 함)
const isReplacingExisting = existingAttachmentNames.includes(file.name) && !nextDeleted.includes(file.name);
const finalNames = new Set([
...existingAttachmentNames.filter((name) => !nextDeleted.includes(name) && name !== file.name),
...nextFiles.map((f) => f.name),
file.name,
]);
if (finalNames.size > TEMPLATE_ATTACHMENT_MAX_COUNT) {
alert(`첨부파일은 최대 ${TEMPLATE_ATTACHMENT_MAX_COUNT}개까지 가능합니다.`);
continue;
}
if (isReplacingExisting) nextDeleted.push(file.name);
nextFiles.push(file);
}
setNewAttachmentFiles(nextFiles);
setDeletedAttachmentNames(nextDeleted);
};
const handleRemoveNewAttachmentFile = (fileName: string) => {
setNewAttachmentFiles((prev) => prev.filter((f) => f.name !== fileName));
// 교체 목적으로 같은 이름을 삭제 예정에 넣었던 것이라면, 새 파일을 취소했으니 삭제 예정도 취소한다.
if (existingAttachmentNames.includes(fileName)) {
setDeletedAttachmentNames((prev) => prev.filter((name) => name !== fileName));
}
};
const handleDownloadAttachment = async (fileName: string) => {
try {
const buffer = await downloadAttachmentMutation.mutateAsync(fileName);
downloadFile(new Blob([buffer], { type: "application/octet-stream" }), fileName);
} catch (e) {
console.error(e);
alert("첨부파일 다운로드에 실패했습니다.");
}
};
const handleToggleDeleteExistingAttachment = (fileName: string) => {
setDeletedAttachmentNames((prev) =>
prev.includes(fileName) ? prev.filter((name) => name !== fileName) : [...prev, fileName],
);
};
const submitTemplate = async (method: "put" | "patch") => {
const v = validateTemplate(selectedTemplate);
if (!v.success) {
@@ -272,10 +370,14 @@ const MessageTemplate = ({ pageTitle, defaultTemplate }: MessageTemplateProps) =
const res = await saveTemplateMutation.mutateAsync({
method,
template: templateToSave,
newFiles: newAttachmentFiles,
// 신규 생성(복사 포함)에서는 deleteFileNames를 사용하지 않는다.
deleteFileNames: method === "patch" ? deletedAttachmentNames : undefined,
});
setSelectedTemplate(res);
setSelectedTemplateIdx(res.tmplatIdx ?? null);
resetAttachmentDraft();
// 대표 템플릿 의도가 true면 저장된 템플릿을 대표로 반영
if (mainDesired && selectedProject?.prjctIdx && res.tmplatIdx) {
@@ -453,6 +555,93 @@ const MessageTemplate = ({ pageTitle, defaultTemplate }: MessageTemplateProps) =
)}
/>
)}
{!isSms && (
<div className="space-y-2">
<div className="flex items-center justify-between">
<Label className="text-base">
첨부파일 ({existingAttachmentNames.filter((name) => !deletedAttachmentNames.includes(name)).length + newAttachmentFiles.length}/{TEMPLATE_ATTACHMENT_MAX_COUNT})
</Label>
<Button type="button" variant="outline" size="sm" className="gap-2" onClick={handlePickAttachmentFiles}>
<Paperclip className="h-4 w-4" />
파일 추가
</Button>
</div>
<input
ref={attachmentInputRef}
type="file"
multiple
className="hidden"
onChange={handleAttachmentFilesSelected}
/>
{(existingAttachmentNames.length > 0 || newAttachmentFiles.length > 0) && (
<ul className="space-y-1 rounded-md border p-2">
{existingAttachmentNames.map((name) => {
const markedForDelete = deletedAttachmentNames.includes(name);
const isReplaced = newAttachmentFiles.some((f) => f.name === name);
return (
<li key={`existing-${name}`} className="flex items-center justify-between gap-2 text-sm">
<Button
type="button"
variant="link"
className={cn(
"h-auto max-w-full justify-start truncate p-0 underline",
markedForDelete && "text-muted-foreground line-through",
)}
onClick={() => handleDownloadAttachment(name)}
disabled={downloadAttachmentMutation.isPending}
title={name}
>
{name}
</Button>
{isReplaced ? (
<span className="shrink-0 text-xs text-muted-foreground">교체됨</span>
) : (
<Button
type="button"
variant="ghost"
size="sm"
className="h-6 shrink-0 px-2 text-xs"
onClick={() => handleToggleDeleteExistingAttachment(name)}
>
{markedForDelete ? "복원" : "삭제"}
</Button>
)}
</li>
);
})}
{newAttachmentFiles.map((file) => (
<li key={`new-${file.name}`} className="flex items-center justify-between gap-2 text-sm">
<span className="truncate text-green-700">
{file.name} <span className="text-muted-foreground">(신규, {(file.size / 1024).toFixed(1)}KB)</span>
</span>
<Button
type="button"
variant="ghost"
size="icon-sm"
className="h-6 w-6 shrink-0"
onClick={() => handleRemoveNewAttachmentFile(file.name)}
aria-label={`${file.name} 제거`}
>
<X className="h-3.5 w-3.5" />
</Button>
</li>
))}
</ul>
)}
<p className="text-xs text-muted-foreground">
파일당 {(TEMPLATE_ATTACHMENT_MAX_BYTES / 1000).toLocaleString()}KB 미만, 최대 {TEMPLATE_ATTACHMENT_MAX_COUNT}개까지 첨부할 수 있습니다.
</p>
{selectedTemplate.tmplatIdx && (
<p className="text-xs text-red-600">
⚠️ 복사 후 저장시 첨부파일은 복사 되지 않습니다.
</p>
)}
</div>
)}
</div>
{isSms && (

View File

@@ -0,0 +1,53 @@
'use client'
import { downloadFile } from '@kri/common/browser'
import { useDownloadTemplateAttachmentMutation } from '@/query/message'
import { Button } from '@/components/ui/button'
import { cn } from '@/lib/utils'
export type TemplateAttachmentListProps = {
tmplatIdx?: number
atchFl?: string
className?: string
}
const TemplateAttachmentList = ({ tmplatIdx, atchFl, className }: TemplateAttachmentListProps) => {
const attachmentNames = atchFl?.split('|').filter(Boolean) ?? []
const downloadMutation = useDownloadTemplateAttachmentMutation(tmplatIdx ?? 0)
if (!tmplatIdx || attachmentNames.length === 0) return null
const handleDownload = async (fileName: string) => {
try {
const buffer = await downloadMutation.mutateAsync(fileName)
downloadFile(new Blob([buffer], { type: 'application/octet-stream' }), fileName)
} catch (e) {
console.error(e)
alert('첨부파일 다운로드에 실패했습니다.')
}
}
return (
<div className={cn('space-y-1', className)}>
<p className="text-sm font-semibold">첨부파일</p>
<ul className="space-y-1">
{attachmentNames.map((fileName) => (
<li key={fileName}>
<Button
type="button"
variant="link"
className="h-auto max-w-full justify-start truncate p-0 underline"
onClick={() => handleDownload(fileName)}
disabled={downloadMutation.isPending}
title={fileName}
>
{fileName}
</Button>
</li>
))}
</ul>
</div>
)
}
export default TemplateAttachmentList