From 27a02db0c32f4dae92742bf616eeb4f8c8bcbf83 Mon Sep 17 00:00:00 2001
From: hywznn <choihj0510@naver.com>
Date: Wed, 12 Aug 2026 01:31:01 +0900
Subject: [PATCH 1/2] =?UTF-8?q?feat(workerlink):=20=EB=AA=A8=EB=B0=94?=
 =?UTF-8?q?=EC=9D=BC=20=EC=A7=88=EB=AC=B8=EA=B3=BC=20=EC=A0=9C=EC=B6=9C=20?=
 =?UTF-8?q?=EC=84=9C=EB=A5=98=20=EA=B2=80=ED=86=A0=20=ED=9D=90=EB=A6=84=20?=
 =?UTF-8?q?=EC=97=B0=EA=B2=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

근로자가 실제 질문 내용을 작성해 전송하고, HR이 Case 소통 화면에서 제출 파일을 확인·다운로드한 뒤 공식 서류로 채택할 수 있도록 연결했습니다.
---
 src/api/workerLinks.ts                        | 35 ++++++++
 .../CaseDetailPage/CaseDetailPage.module.css  | 81 ++++++++++++++++++
 src/pages/CaseDetailPage/CaseDetailPage.tsx   | 84 +++++++++++++++++--
 .../LinkRequestPage.module.css                | 54 ++++++++++++
 src/pages/LinkRequestPage/LinkRequestPage.tsx | 48 ++++++++++-
 .../LinkUploadPage/LinkUploadPage.module.css  | 54 ++++++++++++
 src/pages/LinkUploadPage/LinkUploadPage.tsx   | 77 +++++++++++++----
 7 files changed, 410 insertions(+), 23 deletions(-)

diff --git a/src/api/workerLinks.ts b/src/api/workerLinks.ts
index b596e67..12507fa 100644
--- a/src/api/workerLinks.ts
+++ b/src/api/workerLinks.ts
@@ -59,11 +59,21 @@ export interface WorkerResponseSubmitResponse {
 
 export type WorkerConversationStatus = 'WAITING_WORKER' | 'NEEDS_FOLLOWUP' | 'REOPENED'
 
+export interface WorkerResponseUploadItem {
+  file_id: string
+  file_name: string
+  mime_type: string
+  size: number
+  document_type: DocumentType | null
+  adopted: boolean
+}
+
 export interface WorkerResponseItemResponse {
   response_id: string
   response_type: WorkerResponseType
   message: string | null
   upload_ids: string[]
+  uploads: WorkerResponseUploadItem[]
   conversation_status: WorkerConversationStatus
   unread: boolean
   received_at: string
@@ -77,6 +87,17 @@ export interface WorkerResponsePageResponse {
   total_pages: number
 }
 
+export interface WorkerResponseDocumentAdoptionResponse {
+  response_id: string
+  adopted_documents: Array<{
+    worker_document_id: string
+    file_id: string
+    document_type: DocumentType
+  }>
+  task_status: string
+  task_version: number
+}
+
 export function issueWorkerLink(
   taskId: string,
   body: WorkerLinkIssueBody,
@@ -180,6 +201,20 @@ export function markTaskWorkerResponsesRead(taskId: string): Promise<void> {
   })
 }
 
+export function adoptWorkerResponseDocuments(
+  taskId: string,
+  responseId: string,
+  expectedTaskVersion: number,
+): Promise<WorkerResponseDocumentAdoptionResponse> {
+  return apiFetch<WorkerResponseDocumentAdoptionResponse>(
+    `/tasks/${encodeURIComponent(taskId)}/worker-responses/${encodeURIComponent(responseId)}/documents/adopt`,
+    {
+      method: 'POST',
+      body: JSON.stringify({ expected_task_version: expectedTaskVersion }),
+    },
+  )
+}
+
 export function resolveWorkerPortalUrl(workerUrlOrToken: string, origin: string): string {
   if (/^https?:\/\//i.test(workerUrlOrToken)) return workerUrlOrToken
   if (workerUrlOrToken.startsWith('/')) return new URL(workerUrlOrToken, origin).toString()
diff --git a/src/pages/CaseDetailPage/CaseDetailPage.module.css b/src/pages/CaseDetailPage/CaseDetailPage.module.css
index 0419b14..f025282 100644
--- a/src/pages/CaseDetailPage/CaseDetailPage.module.css
+++ b/src/pages/CaseDetailPage/CaseDetailPage.module.css
@@ -677,6 +677,77 @@
   color: var(--text-secondary);
 }
 
+.responseFiles {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  margin-top: 12px;
+}
+
+.responseFileRow {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 16px;
+  padding: 10px 12px;
+  background: var(--surface-subtle);
+  border: 1px solid var(--border-default);
+  border-radius: var(--fowoco-radius-8);
+}
+
+.responseFileCopy {
+  display: flex;
+  min-width: 0;
+  flex-direction: column;
+  gap: 3px;
+}
+
+.responseFileName {
+  overflow: hidden;
+  color: var(--text-primary);
+  font-size: 13px;
+  font-weight: 600;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.responseFileMeta {
+  color: var(--text-secondary);
+  font-size: 12px;
+}
+
+.responseFileAction,
+.adoptDocumentsAction {
+  flex-shrink: 0;
+  border-radius: var(--fowoco-radius-6);
+  cursor: pointer;
+  font-size: 12px;
+  font-weight: 600;
+}
+
+.responseFileAction {
+  min-height: 34px;
+  padding: 0 12px;
+  background: var(--surface-default);
+  border: 1px solid var(--border-default);
+  color: var(--text-primary);
+}
+
+.adoptDocumentsAction {
+  align-self: flex-end;
+  min-height: 38px;
+  padding: 0 16px;
+  background: var(--brand-primary);
+  border: 0;
+  color: var(--fowoco-white);
+}
+
+.responseFileAction:disabled,
+.adoptDocumentsAction:disabled {
+  cursor: not-allowed;
+  opacity: 0.5;
+}
+
 .timeline {
   display: flex;
   flex-direction: column;
@@ -803,6 +874,16 @@
     align-items: center;
     flex-direction: row;
   }
+
+  .responseFileRow {
+    align-items: stretch;
+    flex-direction: column;
+  }
+
+  .responseFileAction,
+  .adoptDocumentsAction {
+    align-self: stretch;
+  }
 }
 
 .contextSection + .contextSection {
diff --git a/src/pages/CaseDetailPage/CaseDetailPage.tsx b/src/pages/CaseDetailPage/CaseDetailPage.tsx
index 1dabca8..4d8b99a 100644
--- a/src/pages/CaseDetailPage/CaseDetailPage.tsx
+++ b/src/pages/CaseDetailPage/CaseDetailPage.tsx
@@ -24,6 +24,7 @@ import { ApiError, getErrorMessage } from '../../api/errors'
 import { downloadFile } from '../../api/files'
 import { cancelTask, fetchTaskById, updateChecklistItem } from '../../api/tasks'
 import {
+  adoptWorkerResponseDocuments,
   fetchTaskWorkerLinkDelivery,
   fetchTaskWorkerResponses,
   issueWorkerLink,
@@ -119,6 +120,11 @@ const CASE_LIFECYCLE_LABEL: Record<CaseProjectionResponse['lifecycle_status'], s
   CANCELLED: '취소',
 }
 
+function formatResponseFileSize(bytes: number): string {
+  if (bytes < 1024 * 1024) return `${Math.max(1, Math.round(bytes / 1024))}KB`
+  return `${(bytes / (1024 * 1024)).toFixed(1)}MB`
+}
+
 async function fetchTaskWorkerLinkDeliveryOrNull(
   taskId: string,
 ): Promise<WorkerLinkDeliveryResponse | null> {
@@ -209,6 +215,7 @@ export function CaseDetailPage() {
   const [markingLinkSent, setMarkingLinkSent] = useState(false)
   const [markingResponsesRead, setMarkingResponsesRead] = useState(false)
   const [downloadingFileId, setDownloadingFileId] = useState<string | null>(null)
+  const [adoptingResponseId, setAdoptingResponseId] = useState<string | null>(null)
   const [savingDocumentRequestDraft, setSavingDocumentRequestDraft] = useState(false)
   const [documentRequestDraftForm, setDocumentRequestDraftForm] =
     useState<DocumentRequestDraftForm | null>(null)
@@ -611,7 +618,7 @@ export function CaseDetailPage() {
           expires_at: issued.expires_at,
         },
       })
-      refetchWorkerLinkDelivery()
+      await Promise.all([refetchTask(), refetchWorkerLinkDelivery(), refetchActivities()])
       setLinkOverlay('reissued')
       showToast(
         issued.worker_url
@@ -710,6 +717,31 @@ export function CaseDetailPage() {
     }
   }
 
+  async function handleAdoptResponseDocuments(responseId: string) {
+    if (!task || adoptingResponseId) return
+    setAdoptingResponseId(responseId)
+    try {
+      await adoptWorkerResponseDocuments(task.task_id, responseId, task.version)
+      await Promise.all([
+        refetchTask(),
+        refetchWorkerResponses(),
+        refetchDocuments(),
+        refetchReadiness(),
+        refetchWorkerLinkDelivery(),
+        refetchActivities(),
+      ])
+      showToast('제출 파일을 공식 근로자 서류로 등록했습니다.')
+    } catch (error) {
+      showToast(
+        error instanceof ApiError
+          ? getErrorMessage(error)
+          : '제출 파일을 공식 서류로 등록하지 못했습니다.',
+      )
+    } finally {
+      setAdoptingResponseId(null)
+    }
+  }
+
   if (taskStatus === 'loading') {
     return (
       <div className={styles.stateWrap}>
@@ -1379,10 +1411,52 @@ export function CaseDetailPage() {
                           <p className={styles.commMessage}>
                             {response.message?.trim() || '별도 메시지 없이 응답했습니다.'}
                           </p>
-                          {response.upload_ids.length > 0 && (
-                            <p className={styles.commFiles}>
-                              제출 파일 {response.upload_ids.length}개
-                            </p>
+                          {response.uploads.length > 0 && (
+                            <div className={styles.responseFiles}>
+                              {response.uploads.map((upload) => (
+                                <div key={upload.file_id} className={styles.responseFileRow}>
+                                  <div className={styles.responseFileCopy}>
+                                    <span className={styles.responseFileName}>
+                                      {upload.file_name}
+                                    </span>
+                                    <span className={styles.responseFileMeta}>
+                                      {upload.document_type
+                                        ? DOCUMENT_TYPE_LABEL[upload.document_type]
+                                        : '서류 유형 미확인'}
+                                      {' · '}
+                                      {formatResponseFileSize(upload.size)}
+                                      {upload.adopted ? ' · 공식 서류 등록됨' : ' · 검토 필요'}
+                                    </span>
+                                  </div>
+                                  <button
+                                    type="button"
+                                    className={styles.responseFileAction}
+                                    disabled={downloadingFileId !== null}
+                                    onClick={() =>
+                                      handleDownloadDocument(upload.file_id, upload.file_name)
+                                    }
+                                  >
+                                    {downloadingFileId === upload.file_id ? '받는 중…' : '다운로드'}
+                                  </button>
+                                </div>
+                              ))}
+                              {response.response_type === 'DOCUMENT_SUBMITTED' &&
+                                response.uploads.some((upload) => !upload.adopted) &&
+                                userRole !== 'VIEWER' && (
+                                  <button
+                                    type="button"
+                                    className={styles.adoptDocumentsAction}
+                                    disabled={adoptingResponseId !== null}
+                                    onClick={() =>
+                                      handleAdoptResponseDocuments(response.response_id)
+                                    }
+                                  >
+                                    {adoptingResponseId === response.response_id
+                                      ? '등록 중…'
+                                      : '확인 후 공식 서류로 등록'}
+                                  </button>
+                                )}
+                            </div>
                           )}
                         </div>
                       </article>
diff --git a/src/pages/LinkRequestPage/LinkRequestPage.module.css b/src/pages/LinkRequestPage/LinkRequestPage.module.css
index d5f7d29..9127788 100644
--- a/src/pages/LinkRequestPage/LinkRequestPage.module.css
+++ b/src/pages/LinkRequestPage/LinkRequestPage.module.css
@@ -164,6 +164,60 @@
   font-size: 13px;
 }
 
+.questionComposer {
+  margin-top: 20px;
+  padding: 16px;
+  background: var(--surface-subtle);
+  border: 1px solid var(--border-default);
+  border-radius: var(--fowoco-radius-8);
+}
+
+.questionLabel {
+  display: block;
+  margin-bottom: 8px;
+  color: var(--text-primary);
+  font-size: 13px;
+  font-weight: 700;
+}
+
+.questionInput {
+  width: 100%;
+  min-height: 104px;
+  padding: 12px;
+  resize: vertical;
+  background: var(--surface-default);
+  border: 1px solid var(--border-default);
+  border-radius: var(--fowoco-radius-6);
+  color: var(--text-primary);
+  font: inherit;
+  line-height: 1.5;
+}
+
+.questionFooter {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+  margin-top: 10px;
+  color: var(--text-secondary);
+  font-size: 12px;
+}
+
+.questionSubmit {
+  min-height: 38px;
+  padding: 0 16px;
+  background: var(--brand-primary);
+  border: 0;
+  border-radius: var(--fowoco-radius-6);
+  color: var(--fowoco-white);
+  cursor: pointer;
+}
+
+.questionSubmit:disabled {
+  cursor: not-allowed;
+  opacity: 0.5;
+}
+
 .footnote {
   margin: 12px 0 0;
   font-size: 12px;
diff --git a/src/pages/LinkRequestPage/LinkRequestPage.tsx b/src/pages/LinkRequestPage/LinkRequestPage.tsx
index 16fd7e8..d5c9261 100644
--- a/src/pages/LinkRequestPage/LinkRequestPage.tsx
+++ b/src/pages/LinkRequestPage/LinkRequestPage.tsx
@@ -45,6 +45,8 @@ function WorkerLinkRequest({ token }: { token: string }) {
   const [submittingQuestion, setSubmittingQuestion] = useState(false)
   const [submittingAcknowledgement, setSubmittingAcknowledgement] = useState(false)
   const [questionSent, setQuestionSent] = useState(false)
+  const [questionComposerOpen, setQuestionComposerOpen] = useState(false)
+  const [question, setQuestion] = useState('')
   const [responseError, setResponseError] = useState<string | null>(null)
   const fetcher = useCallback(() => fetchWorkerLink(token), [token])
   const { status, data, error, refetch } = useApiQuery(fetcher)
@@ -57,11 +59,17 @@ function WorkerLinkRequest({ token }: { token: string }) {
 
   async function handleQuestion() {
     if (submittingQuestion) return
+    const message = question.trim()
+    if (!message) {
+      setResponseError('담당자에게 보낼 질문을 입력해 주세요.')
+      return
+    }
     setSubmittingQuestion(true)
     setResponseError(null)
     try {
       await submitWorkerResponse(token, {
         response_type: 'QUESTION',
+        message,
         idempotency_key: crypto.randomUUID(),
       })
       setQuestionSent(true)
@@ -118,7 +126,9 @@ function WorkerLinkRequest({ token }: { token: string }) {
       <MobileShell right={<span>보안 링크</span>}>
         <EmptyState
           kind="error"
-          title={contentNotReady ? '요청 내용을 준비하고 있습니다' : '요청 내용을 불러오지 못했습니다'}
+          title={
+            contentNotReady ? '요청 내용을 준비하고 있습니다' : '요청 내용을 불러오지 못했습니다'
+          }
           body={
             contentNotReady
               ? '회사 담당자가 안내문을 준비 중입니다. 잠시 후 같은 링크에서 다시 확인해 주세요.'
@@ -176,7 +186,34 @@ function WorkerLinkRequest({ token }: { token: string }) {
         <p className={styles.privacyBody}>선택한 파일은 이 보안 링크의 업무에만 연결됩니다.</p>
       </div>
 
-      {questionSent && <p className={styles.responseNotice}>담당자에게 질문 의사를 전했습니다.</p>}
+      {questionComposerOpen && !questionSent && (
+        <section className={styles.questionComposer}>
+          <label className={styles.questionLabel} htmlFor="worker-question">
+            담당자에게 물어볼 내용
+          </label>
+          <textarea
+            id="worker-question"
+            className={styles.questionInput}
+            value={question}
+            maxLength={1000}
+            placeholder="예: 여권 사진은 어느 면을 찍어야 하나요?"
+            disabled={submittingQuestion}
+            onChange={(event) => setQuestion(event.target.value)}
+          />
+          <div className={styles.questionFooter}>
+            <span>{question.length}/1000</span>
+            <button
+              type="button"
+              className={styles.questionSubmit}
+              disabled={submittingQuestion || !question.trim()}
+              onClick={handleQuestion}
+            >
+              {submittingQuestion ? '전송 중…' : '질문 보내기'}
+            </button>
+          </div>
+        </section>
+      )}
+      {questionSent && <p className={styles.responseNotice}>담당자에게 질문을 전송했습니다.</p>}
       {responseError && (
         <p className={styles.responseError} role="alert">
           {responseError}
@@ -190,9 +227,12 @@ function WorkerLinkRequest({ token }: { token: string }) {
           disabled={
             !canAskQuestion || submittingQuestion || submittingAcknowledgement || questionSent
           }
-          onClick={handleQuestion}
+          onClick={() => {
+            setQuestionComposerOpen(true)
+            setResponseError(null)
+          }}
         >
-          {questionSent ? '질문 의사 전송됨' : '질문이 있습니다'}
+          {questionSent ? '질문 전송됨' : questionComposerOpen ? '질문 작성 중' : '질문이 있습니다'}
         </button>
         <button
           type="button"
diff --git a/src/pages/LinkUploadPage/LinkUploadPage.module.css b/src/pages/LinkUploadPage/LinkUploadPage.module.css
index 91859e5..2a1f39e 100644
--- a/src/pages/LinkUploadPage/LinkUploadPage.module.css
+++ b/src/pages/LinkUploadPage/LinkUploadPage.module.css
@@ -103,6 +103,60 @@
   font-size: 13px;
 }
 
+.questionComposer {
+  margin-top: 16px;
+  padding: 16px;
+  background: var(--surface-subtle);
+  border: 1px solid var(--border-default);
+  border-radius: var(--fowoco-radius-8);
+}
+
+.questionLabel {
+  display: block;
+  margin-bottom: 8px;
+  color: var(--text-primary);
+  font-size: 13px;
+  font-weight: 700;
+}
+
+.questionInput {
+  width: 100%;
+  min-height: 104px;
+  padding: 12px;
+  resize: vertical;
+  background: var(--surface-default);
+  border: 1px solid var(--border-default);
+  border-radius: var(--fowoco-radius-6);
+  color: var(--text-primary);
+  font: inherit;
+  line-height: 1.5;
+}
+
+.questionFooter {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+  margin-top: 10px;
+  color: var(--text-secondary);
+  font-size: 12px;
+}
+
+.questionSubmit {
+  min-height: 38px;
+  padding: 0 16px;
+  background: var(--brand-primary);
+  border: 0;
+  border-radius: var(--fowoco-radius-6);
+  color: var(--fowoco-white);
+  cursor: pointer;
+}
+
+.questionSubmit:disabled {
+  cursor: not-allowed;
+  opacity: 0.5;
+}
+
 .successCard {
   margin-top: 48px;
   padding: 32px 24px;
diff --git a/src/pages/LinkUploadPage/LinkUploadPage.tsx b/src/pages/LinkUploadPage/LinkUploadPage.tsx
index bf0554f..cae21b1 100644
--- a/src/pages/LinkUploadPage/LinkUploadPage.tsx
+++ b/src/pages/LinkUploadPage/LinkUploadPage.tsx
@@ -36,6 +36,8 @@ export function LinkUploadPage() {
   const [submitting, setSubmitting] = useState(false)
   const [submission, setSubmission] = useState<WorkerResponseSubmitResponse | null>(null)
   const [responseMessage, setResponseMessage] = useState<string | null>(null)
+  const [questionComposerOpen, setQuestionComposerOpen] = useState(false)
+  const [question, setQuestion] = useState('')
   const [submissionError, setSubmissionError] = useState<string | null>(null)
   const fetcher = useCallback(
     () => (token ? fetchWorkerLink(token) : Promise.reject(new Error('missing token'))),
@@ -105,12 +107,7 @@ export function LinkUploadPage() {
         if (!file) throw new Error('missing selected file')
         const requestId = uploadRequestIds.current[documentType] ?? crypto.randomUUID()
         uploadRequestIds.current[documentType] = requestId
-        const upload = await uploadWorkerLinkDocument(
-          token,
-          file,
-          requestId,
-          documentType,
-        )
+        const upload = await uploadWorkerLinkDocument(token, file, requestId, documentType)
         nextUploadedIds[documentType] = upload.upload_id
         setUploadedIds({ ...nextUploadedIds })
       }
@@ -135,16 +132,25 @@ export function LinkUploadPage() {
     }
   }
 
-  async function handleHelpResponse(responseType: WorkerResponseType, successMessage: string) {
+  async function handleHelpResponse(
+    responseType: WorkerResponseType,
+    successMessage: string,
+    message?: string,
+  ) {
     if (!token || submitting) return
     setSubmitting(true)
     setSubmissionError(null)
     try {
       await submitWorkerResponse(token, {
         response_type: responseType,
+        ...(message ? { message } : {}),
         idempotency_key: crypto.randomUUID(),
       })
       setResponseMessage(successMessage)
+      if (responseType === 'QUESTION') {
+        setQuestionComposerOpen(false)
+        setQuestion('')
+      }
     } catch (caught) {
       if (caught instanceof ApiError && caught.status === 410) {
         navigate(`/worker-portal/${encodeURIComponent(token)}/expired`, { replace: true })
@@ -189,7 +195,9 @@ export function LinkUploadPage() {
       <MobileShell title="서류 제출" onBack={() => navigate(-1)}>
         <EmptyState
           kind="error"
-          title={contentNotReady ? '요청 내용을 준비하고 있습니다' : '제출 링크를 확인하지 못했습니다'}
+          title={
+            contentNotReady ? '요청 내용을 준비하고 있습니다' : '제출 링크를 확인하지 못했습니다'
+          }
           body={
             contentNotReady
               ? '회사 담당자가 안내문을 준비 중입니다. 잠시 후 같은 링크에서 다시 확인해 주세요.'
@@ -240,16 +248,18 @@ export function LinkUploadPage() {
     <MobileShell
       title="요청 서류 제출"
       onBack={() => navigate(-1)}
-      right={<span>{selectedCount} / {requestedTypes.length}</span>}
+      right={
+        <span>
+          {selectedCount} / {requestedTypes.length}
+        </span>
+      }
     >
       <h1 className={styles.headline}>
         요청받은 서류를
         <br />
         추가해 주세요
       </h1>
-      <p className={styles.subtext}>
-        각 서류의 글자와 사진이 선명하게 보이는지 확인해 주세요.
-      </p>
+      <p className={styles.subtext}>각 서류의 글자와 사진이 선명하게 보이는지 확인해 주세요.</p>
 
       <div className={styles.requestList}>
         {requestedTypes.map((documentType) => {
@@ -269,7 +279,9 @@ export function LinkUploadPage() {
                 onClick={() => fileInputRefs.current[documentType]?.click()}
               >
                 <p className={styles.dropzonePlus}>{file ? '↻' : '＋'}</p>
-                <p className={styles.dropzoneLabel}>{file ? '다른 파일 선택' : '파일 또는 사진 선택'}</p>
+                <p className={styles.dropzoneLabel}>
+                  {file ? '다른 파일 선택' : '파일 또는 사진 선택'}
+                </p>
                 <p className={styles.dropzoneHint}>JPG, PNG, WEBP, PDF · 최대 20MB</p>
               </button>
               <input
@@ -318,6 +330,36 @@ export function LinkUploadPage() {
       )}
       {responseMessage && <p className={styles.responseNotice}>{responseMessage}</p>}
 
+      {questionComposerOpen && (
+        <section className={styles.questionComposer}>
+          <label className={styles.questionLabel} htmlFor="upload-question">
+            담당자에게 물어볼 내용
+          </label>
+          <textarea
+            id="upload-question"
+            className={styles.questionInput}
+            value={question}
+            maxLength={1000}
+            placeholder="제출이 어려운 이유나 궁금한 내용을 입력해 주세요."
+            disabled={submitting}
+            onChange={(event) => setQuestion(event.target.value)}
+          />
+          <div className={styles.questionFooter}>
+            <span>{question.length}/1000</span>
+            <button
+              type="button"
+              className={styles.questionSubmit}
+              disabled={submitting || !question.trim()}
+              onClick={() =>
+                handleHelpResponse('QUESTION', '담당자에게 질문을 전송했습니다.', question.trim())
+              }
+            >
+              질문 보내기
+            </button>
+          </div>
+        </section>
+      )}
+
       <p className={styles.helpLabel}>제출이 어렵다면</p>
       <div className={styles.helpLinks}>
         {helpResponses.map((response, index) => (
@@ -326,7 +368,14 @@ export function LinkUploadPage() {
             type="button"
             className={`${styles.helpLink} ${index === 0 ? styles.helpLinkPrimary : ''}`}
             disabled={!data.allowed_responses.includes(response.type) || submitting}
-            onClick={() => handleHelpResponse(response.type, response.message)}
+            onClick={() => {
+              if (response.type === 'QUESTION') {
+                setQuestionComposerOpen(true)
+                setSubmissionError(null)
+                return
+              }
+              handleHelpResponse(response.type, response.message)
+            }}
           >
             <span>{response.label}</span>
             <span>→</span>

From 0d476f08968ffde615eb6bc05b05d93a91c8ecfe Mon Sep 17 00:00:00 2001
From: hywznn <choihj0510@naver.com>
Date: Wed, 12 Aug 2026 01:31:01 +0900
Subject: [PATCH 2/2] =?UTF-8?q?test(workerlink):=20=EB=AA=A8=EB=B0=94?=
 =?UTF-8?q?=EC=9D=BC=20=EC=A7=88=EB=AC=B8=EA=B3=BC=20=EC=84=9C=EB=A5=98=20?=
 =?UTF-8?q?=EC=B1=84=ED=83=9D=20=ED=99=94=EB=A9=B4=20=EA=B2=80=EC=A6=9D?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

질문 문장 전송, 복수 파일 제출, 재시도 멱등성, HR 공식 서류 채택 화면 흐름을 검증합니다.
---
 .../CaseDetailPage/CaseDetailPage.test.tsx    |  85 ++++++++-
 .../LinkRequestPage/LinkRequestPage.test.tsx  |  58 +++++-
 .../LinkUploadPage/LinkUploadPage.test.tsx    | 172 ++++++++++++------
 3 files changed, 253 insertions(+), 62 deletions(-)

diff --git a/src/pages/CaseDetailPage/CaseDetailPage.test.tsx b/src/pages/CaseDetailPage/CaseDetailPage.test.tsx
index 1f61ba3..18b78e6 100644
--- a/src/pages/CaseDetailPage/CaseDetailPage.test.tsx
+++ b/src/pages/CaseDetailPage/CaseDetailPage.test.tsx
@@ -182,6 +182,7 @@ function mockTaskAndActivities(
   savedDocumentRequestDraft: DocumentRequestDraftResponse | null = null,
 ) {
   let responsesReviewed = false
+  let currentWorkerResponses = workerResponses
   let currentWorkerLinkDelivery = workerLinkDelivery
   let currentDocumentRequestDraft = savedDocumentRequestDraft
   vi.mocked(fetch).mockImplementation((input, init) => {
@@ -198,8 +199,27 @@ function mockTaskAndActivities(
       responsesReviewed = true
       return Promise.resolve(new Response(null, { status: 204 }))
     }
+    if (url.includes('/worker-responses/') && url.endsWith('/documents/adopt')) {
+      currentWorkerResponses = currentWorkerResponses.map((response) => ({
+        ...response,
+        uploads: response.uploads.map((upload) => ({ ...upload, adopted: true })),
+      }))
+      return Promise.resolve(
+        jsonResponse({
+          response_id: 'response-1',
+          adopted_documents:
+            currentWorkerResponses[0]?.uploads.map((upload) => ({
+              worker_document_id: `document-${upload.file_id}`,
+              file_id: upload.file_id,
+              document_type: upload.document_type,
+            })) ?? [],
+          task_status: 'APPROVED',
+          task_version: 2,
+        }),
+      )
+    }
     if (url.includes('/worker-responses?')) {
-      const items = workerResponses.map((response) =>
+      const items = currentWorkerResponses.map((response) =>
         responsesReviewed
           ? { ...response, unread: false, conversation_status: 'REOPENED' as const }
           : response,
@@ -605,6 +625,16 @@ describe('CaseDetailPage', () => {
           response_type: 'DOCUMENT_SUBMITTED',
           message: '여권 사본을 제출했습니다.',
           upload_ids: ['upload-1'],
+          uploads: [
+            {
+              file_id: 'upload-1',
+              file_name: 'passport.pdf',
+              mime_type: 'application/pdf',
+              size: 2048,
+              document_type: 'PASSPORT_COPY',
+              adopted: false,
+            },
+          ],
           conversation_status: 'NEEDS_FOLLOWUP',
           unread: true,
           received_at: '2026-07-20T01:00:00Z',
@@ -618,7 +648,8 @@ describe('CaseDetailPage', () => {
 
     expect(screen.getByText('승인대기')).toBeInTheDocument()
     expect(screen.getByText('여권 사본을 제출했습니다.')).toBeInTheDocument()
-    expect(screen.getByText('제출 파일 1개')).toBeInTheDocument()
+    expect(screen.getByText('passport.pdf')).toBeInTheDocument()
+    expect(screen.getByText(/여권 사본 · 2KB · 검토 필요/)).toBeInTheDocument()
     expect(screen.queryByText('여권 사본 요청문 초안을 준비했습니다.')).not.toBeInTheDocument()
 
     await user.click(screen.getByRole('button', { name: '응답 확인 완료' }))
@@ -689,6 +720,7 @@ describe('CaseDetailPage', () => {
           response_type: 'QUESTION',
           message: '어떤 서류가 필요한가요?',
           upload_ids: [],
+          uploads: [],
           conversation_status: 'NEEDS_FOLLOWUP',
           unread: true,
           received_at: '2026-07-20T01:00:00Z',
@@ -704,6 +736,55 @@ describe('CaseDetailPage', () => {
     expect(screen.queryByRole('button', { name: '응답 확인 완료' })).not.toBeInTheDocument()
   })
 
+  it('adopts a submitted file as an official worker document', async () => {
+    const user = userEvent.setup()
+    useAuthStore.setState({
+      user: { name: 'hr', workplace: 'FOWOCO', role: 'HR' },
+      status: 'ready',
+    })
+    mockTaskAndActivities(
+      { status: 'WAITING_WORKER', version: 3 },
+      [],
+      {},
+      [],
+      [
+        {
+          response_id: 'response-1',
+          response_type: 'DOCUMENT_SUBMITTED',
+          message: '여권을 제출했습니다.',
+          upload_ids: ['upload-1'],
+          uploads: [
+            {
+              file_id: 'upload-1',
+              file_name: 'passport.pdf',
+              mime_type: 'application/pdf',
+              size: 2048,
+              document_type: 'PASSPORT_COPY',
+              adopted: false,
+            },
+          ],
+          conversation_status: 'NEEDS_FOLLOWUP',
+          unread: true,
+          received_at: '2026-07-20T01:00:00Z',
+        },
+      ],
+    )
+    renderPage()
+    await screen.findByText('응웬반A 체류연장 준비')
+
+    await user.click(screen.getByRole('tab', { name: CASE_TABS[3] }))
+    await user.click(screen.getByRole('button', { name: '확인 후 공식 서류로 등록' }))
+
+    expect(
+      await screen.findByText('제출 파일을 공식 근로자 서류로 등록했습니다.'),
+    ).toBeInTheDocument()
+    await waitFor(() => expect(screen.getByText(/공식 서류 등록됨/)).toBeInTheDocument())
+    const adoptionCall = vi
+      .mocked(fetch)
+      .mock.calls.find(([url]) => String(url).endsWith('/documents/adopt'))
+    expect(JSON.parse(String(adoptionCall?.[1]?.body))).toEqual({ expected_task_version: 3 })
+  })
+
   it('switches to the activity tab and shows real activity content', async () => {
     const user = userEvent.setup()
     mockTaskAndActivities({}, [activity()])
diff --git a/src/pages/LinkRequestPage/LinkRequestPage.test.tsx b/src/pages/LinkRequestPage/LinkRequestPage.test.tsx
index bf1dab7..f6a223b 100644
--- a/src/pages/LinkRequestPage/LinkRequestPage.test.tsx
+++ b/src/pages/LinkRequestPage/LinkRequestPage.test.tsx
@@ -41,15 +41,20 @@ describe('LinkRequestPage', () => {
   })
 
   it('shows a retryable preparing state for a link without ready draft content', async () => {
-    vi.mocked(fetch).mockResolvedValue(jsonResponse({
-      timestamp: '2026-08-08T00:00:00Z',
-      status: 409,
-      code: 'WORKER_LINK_CONTENT_NOT_READY',
-      message: '근로자에게 표시할 요청 안내가 아직 준비되지 않았습니다.',
-      path: '/api/v1/public/worker-links/token-1',
-      request_id: 'request-1',
-      field_errors: [],
-    }, 409))
+    vi.mocked(fetch).mockResolvedValue(
+      jsonResponse(
+        {
+          timestamp: '2026-08-08T00:00:00Z',
+          status: 409,
+          code: 'WORKER_LINK_CONTENT_NOT_READY',
+          message: '근로자에게 표시할 요청 안내가 아직 준비되지 않았습니다.',
+          path: '/api/v1/public/worker-links/token-1',
+          request_id: 'request-1',
+          field_errors: [],
+        },
+        409,
+      ),
+    )
     render(
       <MemoryRouter initialEntries={['/worker-portal/token-1']}>
         <Routes>
@@ -85,6 +90,41 @@ describe('LinkRequestPage', () => {
     })
   })
 
+  it('sends the question text instead of only a question type', async () => {
+    const user = userEvent.setup()
+    vi.mocked(fetch).mockImplementation((input) => {
+      if (String(input).endsWith('/responses')) {
+        return Promise.resolve(
+          jsonResponse({ response_id: 'R-1', received_at: '2026-08-10T00:00:00Z' }, 201),
+        )
+      }
+      return Promise.resolve(jsonResponse(VIEW))
+    })
+    render(
+      <MemoryRouter initialEntries={['/worker-portal/token-1']}>
+        <Routes>
+          <Route path="/worker-portal/:token" element={<LinkRequestPage />} />
+        </Routes>
+      </MemoryRouter>,
+    )
+
+    await user.click(await screen.findByRole('button', { name: '질문이 있습니다' }))
+    await user.type(
+      screen.getByLabelText('담당자에게 물어볼 내용'),
+      '여권 어느 면을 찍어야 하나요?',
+    )
+    await user.click(screen.getByRole('button', { name: '질문 보내기' }))
+
+    expect(await screen.findByText('담당자에게 질문을 전송했습니다.')).toBeInTheDocument()
+    const responseCall = vi
+      .mocked(fetch)
+      .mock.calls.find(([url]) => String(url).endsWith('/responses'))
+    expect(JSON.parse(String(responseCall?.[1]?.body))).toMatchObject({
+      response_type: 'QUESTION',
+      message: '여권 어느 면을 찍어야 하나요?',
+    })
+  })
+
   it('shows an explicit state when opened without a token', () => {
     render(
       <MemoryRouter initialEntries={['/worker-portal']}>
diff --git a/src/pages/LinkUploadPage/LinkUploadPage.test.tsx b/src/pages/LinkUploadPage/LinkUploadPage.test.tsx
index 140d7a4..fd7dca4 100644
--- a/src/pages/LinkUploadPage/LinkUploadPage.test.tsx
+++ b/src/pages/LinkUploadPage/LinkUploadPage.test.tsx
@@ -5,7 +5,10 @@ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
 import { LinkUploadPage } from './LinkUploadPage'
 
 function jsonResponse(body: unknown, status = 200) {
-  return new Response(JSON.stringify(body), { status, headers: { 'Content-Type': 'application/json' } })
+  return new Response(JSON.stringify(body), {
+    status,
+    headers: { 'Content-Type': 'application/json' },
+  })
 }
 
 function renderPage() {
@@ -19,20 +22,39 @@ function renderPage() {
 }
 
 beforeEach(() => {
-  vi.stubGlobal('fetch', vi.fn((input) => {
-    const url = String(input)
-    if (url.endsWith('/documents')) {
-      return Promise.resolve(jsonResponse({ upload_id: 'U-1', file_name: 'passport.jpg', size: 8, expires_at: '2026-08-07T00:00:00Z' }, 201))
-    }
-    if (url.endsWith('/responses')) {
-      return Promise.resolve(jsonResponse({ response_id: 'R-1', received_at: '2026-08-04T00:00:00Z' }, 201))
-    }
-    return Promise.resolve(jsonResponse({
-      guidance: '여권 사본을 제출해 주세요.', language: 'ko', due_date: '2026-08-10',
-      requested_document_types: ['PASSPORT_COPY'],
-      allowed_responses: ['QUESTION', 'NOT_UNDERSTOOD', 'DIFFICULT', 'DOCUMENT_SUBMITTED'],
-    }))
-  }))
+  vi.stubGlobal(
+    'fetch',
+    vi.fn((input) => {
+      const url = String(input)
+      if (url.endsWith('/documents')) {
+        return Promise.resolve(
+          jsonResponse(
+            {
+              upload_id: 'U-1',
+              file_name: 'passport.jpg',
+              size: 8,
+              expires_at: '2026-08-07T00:00:00Z',
+            },
+            201,
+          ),
+        )
+      }
+      if (url.endsWith('/responses')) {
+        return Promise.resolve(
+          jsonResponse({ response_id: 'R-1', received_at: '2026-08-04T00:00:00Z' }, 201),
+        )
+      }
+      return Promise.resolve(
+        jsonResponse({
+          guidance: '여권 사본을 제출해 주세요.',
+          language: 'ko',
+          due_date: '2026-08-10',
+          requested_document_types: ['PASSPORT_COPY'],
+          allowed_responses: ['QUESTION', 'NOT_UNDERSTOOD', 'DIFFICULT', 'DOCUMENT_SUBMITTED'],
+        }),
+      )
+    }),
+  )
 })
 
 afterEach(() => vi.unstubAllGlobals())
@@ -68,7 +90,9 @@ describe('LinkUploadPage', () => {
 
     await user.upload(await screen.findByLabelText('여권 사본 제출할 파일 선택'), file)
 
-    expect(screen.getByRole('alert')).toHaveTextContent('JPG, PNG, WEBP, PDF 파일만 선택할 수 있습니다.')
+    expect(screen.getByRole('alert')).toHaveTextContent(
+      'JPG, PNG, WEBP, PDF 파일만 선택할 수 있습니다.',
+    )
     expect(screen.queryByText('worker.exe')).not.toBeInTheDocument()
   })
 
@@ -88,7 +112,8 @@ describe('LinkUploadPage', () => {
     expect((uploadCall?.[1]?.body as FormData).get('documentType')).toBe('PASSPORT_COPY')
     const responseCall = calls.find(([url]) => String(url).endsWith('/responses'))
     expect(JSON.parse(responseCall?.[1]?.body as string)).toMatchObject({
-      response_type: 'DOCUMENT_SUBMITTED', upload_ids: ['U-1'],
+      response_type: 'DOCUMENT_SUBMITTED',
+      upload_ids: ['U-1'],
     })
   })
 
@@ -99,26 +124,38 @@ describe('LinkUploadPage', () => {
       const url = String(input)
       if (url.endsWith('/documents')) {
         uploadCount += 1
-        return Promise.resolve(jsonResponse({
-          upload_id: `U-${uploadCount}`,
-          file_name: `document-${uploadCount}.jpg`,
-          size: 8,
-          expires_at: '2026-08-07T00:00:00Z',
-        }, 201))
+        return Promise.resolve(
+          jsonResponse(
+            {
+              upload_id: `U-${uploadCount}`,
+              file_name: `document-${uploadCount}.jpg`,
+              size: 8,
+              expires_at: '2026-08-07T00:00:00Z',
+            },
+            201,
+          ),
+        )
       }
       if (url.endsWith('/responses')) {
-        return Promise.resolve(jsonResponse({
-          response_id: 'R-1',
-          received_at: '2026-08-04T00:00:00Z',
-        }, 201))
+        return Promise.resolve(
+          jsonResponse(
+            {
+              response_id: 'R-1',
+              received_at: '2026-08-04T00:00:00Z',
+            },
+            201,
+          ),
+        )
       }
-      return Promise.resolve(jsonResponse({
-        guidance: '여권과 계약서를 제출해 주세요.',
-        language: 'ko',
-        due_date: '2026-08-10',
-        requested_document_types: ['PASSPORT_COPY', 'CONTRACT'],
-        allowed_responses: ['DOCUMENT_SUBMITTED'],
-      }))
+      return Promise.resolve(
+        jsonResponse({
+          guidance: '여권과 계약서를 제출해 주세요.',
+          language: 'ko',
+          due_date: '2026-08-10',
+          requested_document_types: ['PASSPORT_COPY', 'CONTRACT'],
+          allowed_responses: ['DOCUMENT_SUBMITTED'],
+        }),
+      )
     })
     renderPage()
 
@@ -152,28 +189,40 @@ describe('LinkUploadPage', () => {
     vi.mocked(fetch).mockImplementation((input) => {
       const url = String(input)
       if (url.endsWith('/documents')) {
-        return Promise.resolve(jsonResponse({
-          upload_id: 'U-1',
-          file_name: 'passport.jpg',
-          size: 8,
-          expires_at: '2026-08-07T00:00:00Z',
-        }, 201))
+        return Promise.resolve(
+          jsonResponse(
+            {
+              upload_id: 'U-1',
+              file_name: 'passport.jpg',
+              size: 8,
+              expires_at: '2026-08-07T00:00:00Z',
+            },
+            201,
+          ),
+        )
       }
       if (url.endsWith('/responses')) {
         responseAttempts += 1
         if (responseAttempts === 1) return Promise.reject(new TypeError('network failed'))
-        return Promise.resolve(jsonResponse({
-          response_id: 'R-1',
-          received_at: '2026-08-04T00:00:00Z',
-        }, 201))
+        return Promise.resolve(
+          jsonResponse(
+            {
+              response_id: 'R-1',
+              received_at: '2026-08-04T00:00:00Z',
+            },
+            201,
+          ),
+        )
       }
-      return Promise.resolve(jsonResponse({
-        guidance: '여권을 제출해 주세요.',
-        language: 'ko',
-        due_date: '2026-08-10',
-        requested_document_types: ['PASSPORT_COPY'],
-        allowed_responses: ['DOCUMENT_SUBMITTED'],
-      }))
+      return Promise.resolve(
+        jsonResponse({
+          guidance: '여권을 제출해 주세요.',
+          language: 'ko',
+          due_date: '2026-08-10',
+          requested_document_types: ['PASSPORT_COPY'],
+          allowed_responses: ['DOCUMENT_SUBMITTED'],
+        }),
+      )
     })
     renderPage()
     await user.upload(
@@ -193,4 +242,25 @@ describe('LinkUploadPage', () => {
     const responseBodies = responseCalls.map(([, init]) => JSON.parse(String(init?.body)))
     expect(responseBodies[0].idempotency_key).toBe(responseBodies[1].idempotency_key)
   })
+
+  it('lets the worker write and submit the actual question', async () => {
+    const user = userEvent.setup()
+    renderPage()
+
+    await user.click(await screen.findByRole('button', { name: /질문이 있습니다/ }))
+    await user.type(
+      screen.getByLabelText('담당자에게 물어볼 내용'),
+      '계약서도 사진으로 보내도 되나요?',
+    )
+    await user.click(screen.getByRole('button', { name: '질문 보내기' }))
+
+    expect(await screen.findByText('담당자에게 질문을 전송했습니다.')).toBeInTheDocument()
+    const responseCall = vi
+      .mocked(fetch)
+      .mock.calls.find(([url]) => String(url).endsWith('/responses'))
+    expect(JSON.parse(String(responseCall?.[1]?.body))).toMatchObject({
+      response_type: 'QUESTION',
+      message: '계약서도 사진으로 보내도 되나요?',
+    })
+  })
 })