From a603f6ad6f5b4cf9313f55db7036986fd6d470a1 Mon Sep 17 00:00:00 2001 From: kric_jspark Date: Wed, 26 Aug 2026 12:46:26 +0900 Subject: [PATCH] =?UTF-8?q?260826=5F01=5FENH:=20notihub=20=EC=88=98?= =?UTF-8?q?=EC=A0=95=EC=9C=BC=EB=A1=9C=20=EC=9D=B8=ED=95=9C=20=ED=9B=84?= =?UTF-8?q?=EC=86=8D=20=EC=A1=B0=EC=B9=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 11 +++ .../(main)/message/template/email/page.tsx | 4 +- .../(main)/message/template/sms/page.tsx | 4 +- src/components/dialog/MessageSendDialog.tsx | 10 ++- .../dialog/SingleMessageSendDialog.tsx | 68 +++++++++++++------ src/components/kri-editor/KriEditorSms.tsx | 12 +++- src/components/kri-editor/types.ts | 1 + .../message-template/MessageTemplate.tsx | 63 +++++++++++++---- src/const/messageTemplateConst.ts | 12 ++++ src/query/message.ts | 16 ++--- src/types/message.ts | 23 ++++++- 11 files changed, 173 insertions(+), 51 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index caab611..eb92115 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -250,6 +250,17 @@ When implementation is complete, report in Korean: - Validate external data at runtime; a shared TypeScript type alone does not validate an API response or persisted value. - Prefer named public exports and retain the consumer project's current module system and bundler conventions. +### React Compiler and Manual Memoization + +- `createKriNextConfig` enables `reactCompiler: true` unless the project overrides it; confirm the effective configuration. +- When enabled, rely on React Compiler instead of adding `useMemo`, `useCallback`, or `React.memo` as a routine performance precaution. +- Use manual memoization only for required reference stability, an Effect or third-party contract, compiler-incompatible code, or a measured performance problem. +- Preserve existing memoization unless approved and verified for removal. Use `"use memo"` or `"use no memo"` only for a documented compiler boundary. + +### Project Instruction Budget + +- Keep `.agent/project.md` at or below 8 KiB (8,192 bytes) as the normal target. Do not delete material rules merely to meet the budget; move schemas, endpoint inventories, examples, and temporary issue history to linked project documentation, and keep concise read-routing instructions here. + ### Change Safety - Pin or constrain the package version according to the consumer repository's dependency policy and commit its lockfile changes. diff --git a/src/app/(pages)/(main)/message/template/email/page.tsx b/src/app/(pages)/(main)/message/template/email/page.tsx index 2a8ef38..8c083d2 100644 --- a/src/app/(pages)/(main)/message/template/email/page.tsx +++ b/src/app/(pages)/(main)/message/template/email/page.tsx @@ -1,12 +1,14 @@ import { MessageType, type TemplateEmail } from "@kri/common/noti-hub"; import MessageTemplate from "@/components/message-template/MessageTemplate"; +import type { TemplateWithPurpose } from "@/types/message"; const EmailTemplatePage = () => { - const defaultEmailTemplate : TemplateEmail = { + const defaultEmailTemplate : TemplateWithPurpose & TemplateEmail = { tmplatIdx: undefined, itrntPrjctCd: '', tmplatTy: MessageType.EMAIL, + tmplatPurpose: 0, tmplatNm: '', tmplatTitle: '', tmplatBody: '', diff --git a/src/app/(pages)/(main)/message/template/sms/page.tsx b/src/app/(pages)/(main)/message/template/sms/page.tsx index 4d384ff..6927e1a 100644 --- a/src/app/(pages)/(main)/message/template/sms/page.tsx +++ b/src/app/(pages)/(main)/message/template/sms/page.tsx @@ -2,13 +2,15 @@ import { MessageType, type TemplateSms } from "@kri/common/noti-hub"; import MessageTemplate from "@/components/message-template/MessageTemplate"; +import type { TemplateWithPurpose } from "@/types/message"; const SmsTemplatePage = () => { - const defaultSmsTemplate : TemplateSms = { + const defaultSmsTemplate : TemplateWithPurpose & TemplateSms = { tmplatIdx: undefined, itrntPrjctCd: '', tmplatTy: MessageType.SMS, + tmplatPurpose: 0, tmplatNm: '', tmplatTitle: undefined, tmplatBody: '', diff --git a/src/components/dialog/MessageSendDialog.tsx b/src/components/dialog/MessageSendDialog.tsx index 880a897..5e74bea 100644 --- a/src/components/dialog/MessageSendDialog.tsx +++ b/src/components/dialog/MessageSendDialog.tsx @@ -15,7 +15,7 @@ import { useTemplateListQuery, useTemplateQuery, } from '@/query/message' -import { ChannelType, TemplateSms, type TemplateSummary } from '@kri/common/noti-hub' +import { ChannelType, TemplateSms } from '@kri/common/noti-hub' import { sanitizeHtmlForPreview } from '@/components/kri-editor/utils/sanitizeHtml' import { cn } from '@/lib/utils' import { getNearestFutureDateTime } from '@/lib/datetime' @@ -28,7 +28,8 @@ import { KriEditor } from '@/components/kri-editor' import { normalizeQrCodeForEditor, QR_CODE_ALLOWED_HTML, renderQrCodePreviewHtml } from '@/components/message-template/qrcode' import { applyLinkPreviewClass } from '@/components/kri-editor/utils/linkPreview' import TemplateAttachmentList from '@/components/message-template/TemplateAttachmentList' -import type { TemplateEmailWithAttachments } from '@/types/message' +import type { TemplateEmailWithAttachments, TemplateSummaryWithPurpose } from '@/types/message' +import { TEMPLATE_PURPOSE } from '@/const/messageTemplateConst' export type MessageSendMode = 'email' | 'sms' @@ -79,7 +80,10 @@ const MessageSendDialog = ({ const enabled = resolvedOpen && !!selectedProject && prjctIdx > 0 const templateListQuery = useTemplateListQuery(chnnlTy, itrntPrjctCd, enabled) - const templateList: TemplateSummary[] = templateListQuery.data ?? [] + // 대량 발송 및 bulk key 생성 경로에서는 휴대전화번호 인증 템플릿(tmplatPurpose === 1)을 선택할 수 없다. + const templateList: TemplateSummaryWithPurpose[] = (templateListQuery.data ?? []).filter( + (t) => t.tmplatPurpose !== TEMPLATE_PURPOSE.PHONE_VERIFICATION, + ) const templateDetailQuery = useTemplateQuery(templateIdx ?? 0, enabled && !!templateIdx) const selectedTemplate = templateDetailQuery.data ?? null const mainTemplateQuery = useMainTemplateIdxQuery(prjctIdx, chnnlTy, enabled) diff --git a/src/components/dialog/SingleMessageSendDialog.tsx b/src/components/dialog/SingleMessageSendDialog.tsx index a4909e8..1274c53 100644 --- a/src/components/dialog/SingleMessageSendDialog.tsx +++ b/src/components/dialog/SingleMessageSendDialog.tsx @@ -20,8 +20,9 @@ import { KriEditor } from '@/components/kri-editor' import { getNearestFutureDateTime } from '@/lib/datetime' import { escapeHtml, substituteVariables } from '@/lib/variableSubstitution' import type { DialogId } from '@/store/jotai/dialog' -import type { MessageSendChannel, TemplateEmailWithAttachments } from '@/types/message' +import type { MessageSendChannel, PhoneVerificationSendData, TemplateEmailWithAttachments } from '@/types/message' import TemplateAttachmentList from '@/components/message-template/TemplateAttachmentList' +import { TEMPLATE_PURPOSE } from '@/const/messageTemplateConst' const titleMap: Record = { email: '메일 발송', @@ -74,6 +75,9 @@ const SingleMessageSendDialog = ({ const previewValues = variableValues ?? {} const resolvedTitle = selectedTemplate ? substituteVariables(selectedTemplate.tmplatTitle ?? '', previewValues) : '' + // tmplatPurpose === 1(휴대전화번호 인증) 템플릿은 SMS/LMS 단건 즉시 발송만 허용한다. + const isPhoneVerificationTemplate = selectedTemplate?.tmplatPurpose === TEMPLATE_PURPOSE.PHONE_VERIFICATION + const sendSingleMutation = useSendSingleMessageMutation(channel, prjctIdx) const mainTemplateAppliedRef = useRef(false) @@ -86,6 +90,11 @@ const SingleMessageSendDialog = ({ mainTemplateAppliedRef.current = false }, [resolvedOpen]) + // 인증 템플릿 선택 시 예약 발송 옵션을 강제로 즉시 발송으로 되돌린다. + useEffect(() => { + if (isPhoneVerificationTemplate) setScheduleType('instant') + }, [isPhoneVerificationTemplate]) + // 대표 템플릿이 있으면 최초 1회 자동 선택 useEffect(() => { if (!enabled || mainTemplateAppliedRef.current || !mainTemplateQuery.isSuccess) return @@ -126,7 +135,7 @@ const SingleMessageSendDialog = ({ setSubmitting(true) try { - await sendSingleMutation.mutateAsync({ + const res = await sendSingleMutation.mutateAsync({ tmplatIdx: templateIdx, resve: scheduleType === 'reserve', sendDt: scheduleType === 'reserve' ? new Date(reserveAt).toISOString() : undefined, @@ -134,6 +143,17 @@ const SingleMessageSendDialog = ({ destHeaderIds: [destHeaderId], }) + // cmid는 발송 CMID이며 verificationId와는 다른 식별자이므로 혼용하지 않는다. + const cmid = res.cmid + if (isPhoneVerificationTemplate) { + // 휴대전화번호 인증 응답. verificationId/expireDt는 이후 인증 단계에서 사용할 값이나, + // 이 시스템에서는 인증번호 확인 절차를 사용하지 않으므로 현재는 별도로 활용하지 않는다. + const { verificationId, expireDt } = res.data as PhoneVerificationSendData + void verificationId + void expireDt + } + void cmid + alert('발송 요청이 완료되었습니다.') onSent?.() handleOpenChange(false) @@ -177,26 +197,30 @@ const SingleMessageSendDialog = ({ /> -
- - handleScheduleTypeChange(v as 'instant' | 'reserve')} - className="flex items-center gap-4" - > -
- - -
-
- - -
-
- {scheduleType === 'reserve' && ( - - )} -
+ {isPhoneVerificationTemplate ? ( +

휴대전화번호 인증 템플릿은 즉시 발송만 가능합니다.

+ ) : ( +
+ + handleScheduleTypeChange(v as 'instant' | 'reserve')} + className="flex items-center gap-4" + > +
+ + +
+
+ + +
+
+ {scheduleType === 'reserve' && ( + + )} +
+ )}
diff --git a/src/components/kri-editor/KriEditorSms.tsx b/src/components/kri-editor/KriEditorSms.tsx index 91a2365..ad913af 100644 --- a/src/components/kri-editor/KriEditorSms.tsx +++ b/src/components/kri-editor/KriEditorSms.tsx @@ -26,6 +26,7 @@ export function KriEditorSms({ isSmsReadOnly = false, smsMaxBytes = 90, lmsMaxBytes = 2000, + smsPreviewSuffix = '', }: SmsEditorProps) { const [text, setText] = React.useState(value || '') const textareaRef = React.useRef(null) @@ -33,7 +34,8 @@ export function KriEditorSms({ const lastTypeRef = React.useRef<'SMS' | 'LMS' | null>(null) const { scheduleChange, flushChange } = useDebouncedChange(onChange, debounceMs) const textareaInsert = useTextareaInsert(textareaRef) - const byteSize = React.useMemo(() => calculateBytes(text), [text]) + const previewText = smsPreviewSuffix ? `${text}\n${smsPreviewSuffix}` : text + const byteSize = React.useMemo(() => calculateBytes(previewText), [previewText]) const messageType: 'SMS' | 'LMS' = byteSize > smsMaxBytes || Boolean(smsTitle) ? 'LMS' : 'SMS' const maxBytes = messageType === 'SMS' ? smsMaxBytes : lmsMaxBytes @@ -97,7 +99,8 @@ export function KriEditorSms({ value={text} onChange={(event) => { const next = event.target.value - if (calculateBytes(next) <= lmsMaxBytes) commitText(next) + const nextPreview = smsPreviewSuffix ? `${next}\n${smsPreviewSuffix}` : next + if (calculateBytes(nextPreview) <= lmsMaxBytes) commitText(next) }} onBlur={() => flushChange(latestTextRef.current)} placeholder={placeholder} @@ -105,6 +108,11 @@ export function KriEditorSms({ style={{ minHeight: smsTitle ? '320px' : '360px' }} {...textareaInsert.bindSelectionHandlers} /> + {smsPreviewSuffix ? ( +
+ {smsPreviewSuffix} +
+ ) : null}
{byteSize > maxBytes ? (

diff --git a/src/components/kri-editor/types.ts b/src/components/kri-editor/types.ts index c428190..bdd5c2f 100644 --- a/src/components/kri-editor/types.ts +++ b/src/components/kri-editor/types.ts @@ -74,6 +74,7 @@ export type KriEditorProps = { isSmsReadOnly?: boolean smsMaxBytes?: number lmsMaxBytes?: number + smsPreviewSuffix?: string toolbar?: KriEditorToolbarConfig | false fontFamilyOptions?: KriEditorFontFamilyOption[] renderToolbarEnd?: (context: KriEditorToolbarContext) => ReactNode diff --git a/src/components/message-template/MessageTemplate.tsx b/src/components/message-template/MessageTemplate.tsx index ca7e96e..df6cfca 100644 --- a/src/components/message-template/MessageTemplate.tsx +++ b/src/components/message-template/MessageTemplate.tsx @@ -6,17 +6,22 @@ import { ChannelType, MessageType, SMS_TYPE_ARRAY, - Template, 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, TEMPLATE_ATTACHMENT_MAX_BYTES, TEMPLATE_ATTACHMENT_MAX_COUNT} from "@/const/messageTemplateConst"; +import { + PHONE_VERIFICATION_PREVIEW_SUFFIX, + TEMPLATE_ATTACHMENT_MAX_BYTES, + TEMPLATE_ATTACHMENT_MAX_COUNT, + TEMPLATE_PURPOSE, + TEMPLATE_PURPOSE_OPTIONS, +} from "@/const/messageTemplateConst"; import {Input} from "@/components/ui/input"; import {Checkbox} from "@/components/ui/checkbox"; +import {RadioGroup, RadioGroupItem} from "@/components/ui/radio-group"; import {KriEditor, KriEditorCommand} from "@/components/kri-editor"; import {Button} from "@/components/ui/button"; import { isBlank } from "@kri/common"; @@ -26,7 +31,11 @@ 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 type { + TemplateEmailWithAttachments, + TemplateSummaryWithPurpose, + TemplateWithPurpose, +} from "@/types/message"; import { useTemplateListQuery, useMainTemplateIdxQuery, @@ -51,7 +60,7 @@ import { interface MessageTemplateProps { pageTitle: string; - defaultTemplate: Template; + defaultTemplate: TemplateWithPurpose; } const MESSAGE_EDITOR_EXTENSIONS = [QrCode]; @@ -62,7 +71,7 @@ const MessageTemplate = ({ pageTitle, defaultTemplate }: MessageTemplateProps) = const editorCmdRef = useRef(null); const sessionTempUrlsRef = useRef>(new Set()); - const [selectedTemplate, setSelectedTemplate] = useState