[ST] - retactor: 지표 변경으로 인한 컬럼 수정

apps/as/src/entities/fnrs-cnsltn/api/fnrs-cnsltn-rvw-opnn-service.ts

@@ -0,0 +1,22 @@
+import { client } from "@/shared/api";
+import { ENDPOINT } from "@/shared/config";
+import type { RvwOpnnUpdateRequestDto } from "@/shared/model";
+
+const BASE = ENDPOINT.AS_SERVICE.FNRS_CNSLTN_RVW_OPNN;
+
+async function update(
+  fnrsCnsltnDocNo: string,
+  rvwOpnnSn: number,
+  body: RvwOpnnUpdateRequestDto,
+): Promise<void> {
+  await client.put<void>(`${BASE}/${fnrsCnsltnDocNo}/${rvwOpnnSn}`, body);
+}
+
+async function deleteFn(fnrsCnsltnDocNo: string, rvwOpnnSn: number): Promise<void> {
+  await client.delete<void>(`${BASE}/${fnrsCnsltnDocNo}/${rvwOpnnSn}`);
+}
+
+export const fnrsCnsltnRvwOpnnService = {
+  update,
+  delete: deleteFn,
+};

apps/as/src/entities/fnrs-cnsltn/index.ts

@@ -1,65 +1,66 @@
-export { fnrsCnsltnMngService } from "./api/fnrs-cnsltn-service";
-export { fnrsCnsltnKeys } from "./api/queries";
-export {
-  useChangePrgrsSttsComCd,
-  useDeleteFnrsCnsltnMng,
-  useFnrsCnsltnFileVrfcResults,
-  useFnrsCnsltnMng,
-  useFnrsCnsltnMngPage,
-  useRequestActnReviewFnrsCnsltnMng,
-  useRequestExamineFnrsCnsltnMng,
-  useSaveApplyFnrsCnsltnMng,
-  useSaveFnrsCnsltnMng,
-  useSubmitReqSupplementFnrsCnsltnMng,
-  useSubmitSupplementFnrsCnsltnMng,
-  useTechReviewFnrsCnsltnMng,
-  useUpdateFnrsCnsltnMng,
-} from "./api/queries";
-export type {
-  BizCstItem,
-  BzScaleItem,
-  CklstResultItem,
-  EsntlAtchFileItem,
-  FnrsCnsltnApplySaveRequestDto,
-  FnrsCnsltnMngSaveRequestDto,
-  FnrsCnsltnRvwOpnnSaveRequestDto,
-  FnrsCnsltnSplmntDmndItem,
-  FnrsSharItem,
-} from "./model/fnrs-cnsltn-apply-payload-schema";
-export {
-  fnrsCnsltnApplySaveSchema,
-  fnrsCnsltnBizCstItemSchema,
-  fnrsCnsltnBzScaleItemSchema,
-  fnrsCnsltnCklstResultItemSchema,
-  fnrsCnsltnEsntlAtchFileItemSchema,
-  fnrsCnsltnMngSaveSchema,
-  fnrsCnsltnRvwOpnnSaveSchema,
-  fnrsCnsltnSplmntDmndItemSchema,
-  fnrsSharItemSchema,
-} from "./model/fnrs-cnsltn-apply-payload-schema";
-export type {
-  AtflMngClientResponseDto,
-  BizCstTreeDto,
-  BizSclTreeDto,
-  CklstRvwRsltTreeDto,
-  DocPrgrsUpdateRequestDto,
-  ElaprDocPrgrsClientResponseDto,
-  EsntlAtchFileMngTreeResponseDto,
-  FnrsCnsltnFileVrfcRsltResponseDto,
-  FnrsCnsltnMngDetResponseDto,
-  FnrsCnsltnMngResponseDto,
-  FnrsCnsltnMngSearchDto,
-  FnrsCnsltnMngService,
-  FnrsCnsltnMngUpdateRequestDto,
-  FnrsCnsltnRvwOpnnResponseDto,
-  FnrsCnsltnSplmntDmndResponseDto,
-  RagIndexingInfoDto,
-} from "./model/fnrs-cnsltn-interface";
-export type {
-  EnvoActnReviewReqDto,
-  FnrsExamineRequestDto,
-} from "./model/fnrs-cnsltn-payload-schema";
-export {
-  envoActnReviewReqSchema,
-  fnrsExamineRequestSchema,
-} from "./model/fnrs-cnsltn-payload-schema";
+export { fnrsCnsltnRvwOpnnService } from "./api/fnrs-cnsltn-rvw-opnn-service";
+export { fnrsCnsltnMngService } from "./api/fnrs-cnsltn-service";
+export { fnrsCnsltnKeys } from "./api/queries";
+export {
+  useChangePrgrsSttsComCd,
+  useDeleteFnrsCnsltnMng,
+  useFnrsCnsltnFileVrfcResults,
+  useFnrsCnsltnMng,
+  useFnrsCnsltnMngPage,
+  useRequestActnReviewFnrsCnsltnMng,
+  useRequestExamineFnrsCnsltnMng,
+  useSaveApplyFnrsCnsltnMng,
+  useSaveFnrsCnsltnMng,
+  useSubmitReqSupplementFnrsCnsltnMng,
+  useSubmitSupplementFnrsCnsltnMng,
+  useTechReviewFnrsCnsltnMng,
+  useUpdateFnrsCnsltnMng,
+} from "./api/queries";
+export type {
+  BizCstItem,
+  BzScaleItem,
+  CklstResultItem,
+  EsntlAtchFileItem,
+  FnrsCnsltnApplySaveRequestDto,
+  FnrsCnsltnMngSaveRequestDto,
+  FnrsCnsltnRvwOpnnSaveRequestDto,
+  FnrsCnsltnSplmntDmndItem,
+  FnrsSharItem,
+} from "./model/fnrs-cnsltn-apply-payload-schema";
+export {
+  fnrsCnsltnApplySaveSchema,
+  fnrsCnsltnBizCstItemSchema,
+  fnrsCnsltnBzScaleItemSchema,
+  fnrsCnsltnCklstResultItemSchema,
+  fnrsCnsltnEsntlAtchFileItemSchema,
+  fnrsCnsltnMngSaveSchema,
+  fnrsCnsltnRvwOpnnSaveSchema,
+  fnrsCnsltnSplmntDmndItemSchema,
+  fnrsSharItemSchema,
+} from "./model/fnrs-cnsltn-apply-payload-schema";
+export type {
+  AtflMngClientResponseDto,
+  BizCstTreeDto,
+  BizSclTreeDto,
+  CklstRvwRsltTreeDto,
+  DocPrgrsUpdateRequestDto,
+  ElaprDocPrgrsClientResponseDto,
+  EsntlAtchFileMngTreeResponseDto,
+  FnrsCnsltnFileVrfcRsltResponseDto,
+  FnrsCnsltnMngDetResponseDto,
+  FnrsCnsltnMngResponseDto,
+  FnrsCnsltnMngSearchDto,
+  FnrsCnsltnMngService,
+  FnrsCnsltnMngUpdateRequestDto,
+  FnrsCnsltnRvwOpnnResponseDto,
+  FnrsCnsltnSplmntDmndResponseDto,
+  RagIndexingInfoDto,
+} from "./model/fnrs-cnsltn-interface";
+export type {
+  EnvoActnReviewReqDto,
+  FnrsExamineRequestDto,
+} from "./model/fnrs-cnsltn-payload-schema";
+export {
+  envoActnReviewReqSchema,
+  fnrsExamineRequestSchema,
+} from "./model/fnrs-cnsltn-payload-schema";

apps/as/src/entities/instl-sncn/api/instl-sncn-rvw-opnn-service.ts

@@ -0,0 +1,22 @@
+import { client } from "@/shared/api";
+import { ENDPOINT } from "@/shared/config";
+import type { RvwOpnnUpdateRequestDto } from "@/shared/model";
+
+const BASE = ENDPOINT.AS_SERVICE.INSTL_SNCN_RVW_OPNN;
+
+async function update(
+  instlSncnDocNo: string,
+  rvwOpnnSn: number,
+  body: RvwOpnnUpdateRequestDto,
+): Promise<void> {
+  await client.put<void>(`${BASE}/${instlSncnDocNo}/${rvwOpnnSn}`, body);
+}
+
+async function deleteFn(instlSncnDocNo: string, rvwOpnnSn: number): Promise<void> {
+  await client.delete<void>(`${BASE}/${instlSncnDocNo}/${rvwOpnnSn}`);
+}
+
+export const instlSncnRvwOpnnService = {
+  update,
+  delete: deleteFn,
+};

apps/as/src/entities/instl-sncn/index.ts

@@ -1,3 +1,4 @@
+export { instlSncnRvwOpnnService } from "./api/instl-sncn-rvw-opnn-service";
 export { instlSncnRegionService, instlSncnService } from "./api/instl-sncn-service";
 export {
   instlSncnKeys,

apps/as/src/entities/sewer-bsc-plan/api/sewer-bsc-plan-rvw-opnn-service.ts

@@ -0,0 +1,23 @@
+import { client } from "@/shared/api";
+import { ENDPOINT } from "@/shared/config";
+import type { RvwOpnnUpdateRequestDto } from "@/shared/model";
+
+const BASE = ENDPOINT.AS_SERVICE.SEWER_BSC_PLAN_RVW_OPNNS;
+
+async function update(
+  sewerBscPlanDocNo: string,
+  chgCycl: number,
+  rvwOpnnSn: number,
+  body: RvwOpnnUpdateRequestDto,
+): Promise<void> {
+  await client.put<void>(`${BASE}/${sewerBscPlanDocNo}/${chgCycl}/${rvwOpnnSn}`, body);
+}
+
+async function deleteFn(sewerBscPlanDocNo: string, chgCycl: number, rvwOpnnSn: number): Promise<void> {
+  await client.delete<void>(`${BASE}/${sewerBscPlanDocNo}/${chgCycl}/${rvwOpnnSn}`);
+}
+
+export const sewerBscPlanRvwOpnnService = {
+  update,
+  delete: deleteFn,
+};

apps/as/src/entities/sewer-bsc-plan/index.ts

@@ -1,64 +1,65 @@
-export { sewerBscPlanKeys } from "./api/queries";
-export {
-  useDeleteSewerBscPlan,
-  useSaveApplySewerBscPlan,
-  useSaveSewerBscPlan,
-  useSewerBscPlan,
-  useSewerBscPlanDetails,
-  useSewerBscPlanPage,
-  useSubmitReqSupplementSewerBscPlan,
-  useSubmitSupplementSewerBscPlan,
-  useTechReviewSewerBscPlan,
-  useUpdateSewerBscPlan,
-} from "./api/queries";
-export { sewerBscPlanService } from "./api/sewer-bsc-plan-service";
-export type {
-  CklstResultItem,
-  EsntlAtchFileItem,
-  SewerBscPlanApplySaveRequestDto,
-  SewerBscPlanBizCstItem,
-  SewerBscPlanDtlSaveRequestDto,
-  SewerBscPlanFnrsCstItem,
-  SewerBscPlanOtlnItem,
-  SewerBscPlanRvwOpnnItem,
-  SewerBscPlanSaveRequestDto,
-  SewerBscPlanSplmntDmndItem,
-  SewerBscPlanTmplntDtlItem,
-  SewerBscPlanTmplntItem,
-  SewerBscPlanTmplntTmprStrgItem,
-} from "./model/sewer-bsc-plan-apply-payload-schema";
-export {
-  sewerBscPlanApplySaveSchema,
-  sewerBscPlanBizCstItemSchema,
-  sewerBscPlanCklstResultItemSchema,
-  sewerBscPlanDtlSaveSchema,
-  sewerBscPlanEsntlAtchFileItemSchema,
-  sewerBscPlanFnrsCstItemSchema,
-  sewerBscPlanOtlnItemSchema,
-  sewerBscPlanRvwOpnnItemSchema,
-  sewerBscPlanSaveSchema,
-  sewerBscPlanSplmntDmndItemSchema,
-  sewerBscPlanTmplntDtlItemSchema,
-  sewerBscPlanTmplntItemSchema,
-  sewerBscPlanTmplntTmprStrgItemSchema,
-} from "./model/sewer-bsc-plan-apply-payload-schema";
-export type {
-  AtflMngClientResponseDto,
-  CklstRvwRsltTreeDto,
-  EsntlAtchFileMngTreeResponseDto,
-  SewerBscPlanApplySaveResponseDto,
-  SewerBscPlanBizCstResponseDto,
-  SewerBscPlanDetResponseDto,
-  SewerBscPlanDtlResponseDto,
-  SewerBscPlanFnrsCstResponseDto,
-  SewerBscPlanOtlnResponseDto,
-  SewerBscPlanResponseDto,
-  SewerBscPlanRvwOpnnResponseDto,
-  SewerBscPlanSearchRequestDto,
-  SewerBscPlanService,
-  SewerBscPlanSplmntDmndResponseDto,
-  SewerBscPlanTmplntDtlResponseDto,
-  SewerBscPlanTmplntResponseDto,
-  SewerBscPlanTmplntTmprStrgResponseDto,
-  SewerBscPlanUpdateRequestDto,
-} from "./model/sewer-bsc-plan-interface";
+export { sewerBscPlanKeys } from "./api/queries";
+export {
+  useDeleteSewerBscPlan,
+  useSaveApplySewerBscPlan,
+  useSaveSewerBscPlan,
+  useSewerBscPlan,
+  useSewerBscPlanDetails,
+  useSewerBscPlanPage,
+  useSubmitReqSupplementSewerBscPlan,
+  useSubmitSupplementSewerBscPlan,
+  useTechReviewSewerBscPlan,
+  useUpdateSewerBscPlan,
+} from "./api/queries";
+export { sewerBscPlanRvwOpnnService } from "./api/sewer-bsc-plan-rvw-opnn-service";
+export { sewerBscPlanService } from "./api/sewer-bsc-plan-service";
+export type {
+  CklstResultItem,
+  EsntlAtchFileItem,
+  SewerBscPlanApplySaveRequestDto,
+  SewerBscPlanBizCstItem,
+  SewerBscPlanDtlSaveRequestDto,
+  SewerBscPlanFnrsCstItem,
+  SewerBscPlanOtlnItem,
+  SewerBscPlanRvwOpnnItem,
+  SewerBscPlanSaveRequestDto,
+  SewerBscPlanSplmntDmndItem,
+  SewerBscPlanTmplntDtlItem,
+  SewerBscPlanTmplntItem,
+  SewerBscPlanTmplntTmprStrgItem,
+} from "./model/sewer-bsc-plan-apply-payload-schema";
+export {
+  sewerBscPlanApplySaveSchema,
+  sewerBscPlanBizCstItemSchema,
+  sewerBscPlanCklstResultItemSchema,
+  sewerBscPlanDtlSaveSchema,
+  sewerBscPlanEsntlAtchFileItemSchema,
+  sewerBscPlanFnrsCstItemSchema,
+  sewerBscPlanOtlnItemSchema,
+  sewerBscPlanRvwOpnnItemSchema,
+  sewerBscPlanSaveSchema,
+  sewerBscPlanSplmntDmndItemSchema,
+  sewerBscPlanTmplntDtlItemSchema,
+  sewerBscPlanTmplntItemSchema,
+  sewerBscPlanTmplntTmprStrgItemSchema,
+} from "./model/sewer-bsc-plan-apply-payload-schema";
+export type {
+  AtflMngClientResponseDto,
+  CklstRvwRsltTreeDto,
+  EsntlAtchFileMngTreeResponseDto,
+  SewerBscPlanApplySaveResponseDto,
+  SewerBscPlanBizCstResponseDto,
+  SewerBscPlanDetResponseDto,
+  SewerBscPlanDtlResponseDto,
+  SewerBscPlanFnrsCstResponseDto,
+  SewerBscPlanOtlnResponseDto,
+  SewerBscPlanResponseDto,
+  SewerBscPlanRvwOpnnResponseDto,
+  SewerBscPlanSearchRequestDto,
+  SewerBscPlanService,
+  SewerBscPlanSplmntDmndResponseDto,
+  SewerBscPlanTmplntDtlResponseDto,
+  SewerBscPlanTmplntResponseDto,
+  SewerBscPlanTmplntTmprStrgResponseDto,
+  SewerBscPlanUpdateRequestDto,
+} from "./model/sewer-bsc-plan-interface";

apps/as/src/pages/design-cnstn/ui/sections/tech-review-opinion-section.tsx

@@ -1,338 +1,334 @@
-"use client";
-
-import { forwardRef, useEffect, useImperativeHandle, useState } from "react";
-
-import { dayjs, getDefaultFileKey, useTus } from "@/shared/lib";
-import { TextShimmer } from "@/shared/ui";
-import { SectionCollapsible } from "@/shared/ui";
-import { Field, FieldLabel, FieldSet } from "@/shared/ui/field";
-import { AttachmentDownloadLink, attachService } from "@/entities/attach";
-import type { DesignCnstnRvwOpnnResponseDto } from "@/entities/design-cnstn";
-import {
-  Button,
-  RadioGroup,
-  RadioGroupItem,
-  Table,
-  TableBody,
-  TableCell,
-  TableHead,
-  TableHeader,
-  TableRow,
-  Textarea,
-} from "@common/components";
-
-import type {
-  ReviewOpinionFormData,
-  ReviewOpinionGetFormDataResult,
-} from "../../lib/review-opinion-utils";
-import type { ReviewStepCode } from "../../model/view-types";
-import { REVIEW_STEP_LABELS } from "../../model/view-types";
-
-const RVW_OPNN_FILE_KEY_PREFIX = "rvw-opnn::";
-
-interface TechReviewOpinionSectionProps {
-  rvwList: DesignCnstnRvwOpnnResponseDto[];
-  editableReviewStep?: ReviewStepCode;
-  atrzSeComCdList?: string[];
-  isAtrzLoading?: boolean;
-}
-
-export interface TechReviewOpinionSectionHandle {
-  getFormData: () => ReviewOpinionGetFormDataResult | null;
-  resetForm: () => void;
-}
-
-interface TechReviewOpinionTableProps {
-  items: DesignCnstnRvwOpnnResponseDto[];
-}
-
-interface UploadedOpinionFile {
-  fileName: string;
-  fileKey: string;
-  atflId?: string;
-  atflCd?: string;
-}
-
-const EMPTY_FORM_DATA: ReviewOpinionFormData = {
-  rvwRsltCn: "",
-  rvwRsltAnmlyYn: "",
-  atchFileGroupId: "",
-  opnrSeComCd: "",
-};
-
-function createRvwOpnnUploadKey(file: File) {
-  return `${RVW_OPNN_FILE_KEY_PREFIX}${getDefaultFileKey(file)}`;
-}
-
-function hasFormContent(formData: ReviewOpinionFormData) {
-  return Boolean(formData.rvwRsltCn.trim() || formData.rvwRsltAnmlyYn || formData.atchFileGroupId);
-}
-
-const TechReviewOpinionSection = forwardRef<
-  TechReviewOpinionSectionHandle,
-  TechReviewOpinionSectionProps
->(function TechReviewOpinionSection(
-  { rvwList, editableReviewStep, atrzSeComCdList = [], isAtrzLoading = false },
-  ref,
-) {
-  const canWriteOpinion = !isAtrzLoading && atrzSeComCdList.includes("ATRZ02");
-  const [formData, setFormData] = useState<ReviewOpinionFormData>({
-    ...EMPTY_FORM_DATA,
-    opnrSeComCd: editableReviewStep ?? "",
-  });
-  const [uploadedFile, setUploadedFile] = useState<UploadedOpinionFile | null>(null);
-
-  useEffect(() => {
-    setFormData((prev) => ({
-      ...prev,
-      opnrSeComCd: editableReviewStep ?? "",
-    }));
-  }, [editableReviewStep]);
-
-  const { uploadFileAsync, isUploading, uploads } = useTus({
-    onSuccess: (atflCd, atflId, _file, fileKey) => {
-      if (!atflCd || !atflId) return;
-
-      setFormData((prev) => ({ ...prev, atchFileGroupId: atflCd }));
-      setUploadedFile((prev) => (prev?.fileKey === fileKey ? { ...prev, atflCd, atflId } : prev));
-    },
-    onError: (_error, _file, fileKey) => {
-      setUploadedFile((prev) => (prev?.fileKey === fileKey ? null : prev));
-    },
-  });
-
-  useImperativeHandle(
-    ref,
-    () => ({
-      getFormData: () => {
-        if (!canWriteOpinion || !editableReviewStep || !hasFormContent(formData)) {
-          return null;
-        }
-
-        return {
-          formData: {
-            ...formData,
-            opnrSeComCd: editableReviewStep,
-          },
-          rvwList,
-        };
-      },
-      resetForm: () => {
-        setFormData({
-          ...EMPTY_FORM_DATA,
-          opnrSeComCd: editableReviewStep ?? "",
-        });
-        setUploadedFile(null);
-      },
-    }),
-    [canWriteOpinion, editableReviewStep, formData, rvwList],
-  );
-
-  const kecoRvwList = rvwList.filter((item) => item.opnrSeComCd === "KECO");
-  const hasKecoSection =
-    kecoRvwList.length > 0 || (editableReviewStep === "KECO" && canWriteOpinion);
-
-  if (!hasKecoSection) {
-    return null;
-  }
-
-  async function handleFileUpload(files: FileList | null) {
-    if (!files || files.length === 0) return;
-
-    const file = files[0];
-    const fileKey = createRvwOpnnUploadKey(file);
-    const existingAtflCd = formData.atchFileGroupId;
-
-    setUploadedFile({ fileName: file.name, fileKey });
-
-    try {
-      await uploadFileAsync(file, {
-        fileKey,
-        metadata: existingAtflCd ? { atflCd: existingAtflCd } : undefined,
-      });
-    } catch {
-      // onError callback handles cleanup
-    }
-  }
-
-  async function handleFileRemove() {
-    if (!uploadedFile) return;
-
-    uploads[uploadedFile.fileKey]?.abort();
-
-    if (uploadedFile.atflId) {
-      try {
-        await attachService.deleteAttachmentByAtflId(uploadedFile.atflId);
-      } catch (error) {
-        console.error("검토의견 첨부파일 삭제 실패:", error);
-      }
-    }
-
-    setUploadedFile(null);
-    setFormData((prev) => ({ ...prev, atchFileGroupId: "" }));
-  }
-
-  function renderOpinionForm(reviewStep: ReviewStepCode) {
-    if (editableReviewStep !== reviewStep || !canWriteOpinion) return null;
-
-    const uploading = uploadedFile ? (isUploading[uploadedFile.fileKey] ?? false) : false;
-
-    return (
-      <div className="space-y-2">
-        <h4 className="text-xl font-semibold">검토의견 작성</h4>
-        <Table caption="검토의견 작성으로 의견내용, 검토결과, 첨부파일 정보 제공" variant="secondary">
-          <TableHeader>
-            <TableRow>
-              <TableHead scope="row" className="w-[12rem]">의견내용</TableHead>
-              <TableCell>
-                <Textarea
-                  value={formData.rvwRsltCn}
-                  onChange={(event) =>
-                    setFormData((prev) => ({ ...prev, rvwRsltCn: event.target.value }))
-                  }
-                  placeholder="의견내용을 입력하세요"
-                  rows={4}
-                  className="min-h-[8rem] !text-xl"
-                />
-              </TableCell>
-            </TableRow>
-            <TableRow>
-              <TableHead scope="row">검토결과</TableHead>
-              <TableCell>
-                <FieldSet>
-                  <RadioGroup
-                    value={formData.rvwRsltAnmlyYn}
-                    onValueChange={(value) =>
-                      setFormData((prev) => ({
-                        ...prev,
-                        rvwRsltAnmlyYn: value as ReviewOpinionFormData["rvwRsltAnmlyYn"],
-                      }))
-                    }
-                  >
-                    <div className="flex flex-wrap gap-4">
-                      <FieldLabel
-                        htmlFor={`rvw-opnn-normal-${reviewStep}`}
-                        className="!w-auto border-none"
-                      >
-                        <Field orientation="horizontal" className="w-auto">
-                          <RadioGroupItem value="N" id={`rvw-opnn-normal-${reviewStep}`} />
-                          <span className="font-normal">정상</span>
-                        </Field>
-                      </FieldLabel>
-                      <FieldLabel
-                        htmlFor={`rvw-opnn-abnormal-${reviewStep}`}
-                        className="!w-auto border-none"
-                      >
-                        <Field orientation="horizontal" className="w-auto">
-                          <RadioGroupItem value="Y" id={`rvw-opnn-abnormal-${reviewStep}`} />
-                          <span className="font-normal">이상</span>
-                        </Field>
-                      </FieldLabel>
-                    </div>
-                  </RadioGroup>
-                </FieldSet>
-              </TableCell>
-            </TableRow>
-            <TableRow>
-              <TableHead scope="row">첨부파일</TableHead>
-              <TableCell>
-                {uploadedFile ? (
-                  <div className="flex items-center gap-2">
-                    <TextShimmer className="text-xl" active={uploading}>
-                      {uploadedFile.fileName}
-                    </TextShimmer>
-                    <Button
-                      size="icon"
-                      onClick={(e) => {
-                        e.preventDefault();
-                        void handleFileRemove();
-                      }}
-                      disabled={uploading}
-                      className="size-8 !bg-destructive"
-                    >
-                      <i className="diveicon di-x text-xs" aria-label="삭제" />
-                    </Button>
-                  </div>
-                ) : (
-                  <label>
-                    <input
-                      type="file"
-                      className="hidden"
-                      onChange={(event) => {
-                        void handleFileUpload(event.target.files);
-                        event.target.value = "";
-                      }}
-                    />
-                    <Button size="sm" variant="outline" type="button" asChild>
-                      <span>파일 선택</span>
-                    </Button>
-                  </label>
-                )}
-              </TableCell>
-            </TableRow>
-          </TableHeader>
-        </Table>
-      </div>
-    );
-  }
-
-  return (
-    <SectionCollapsible title={`${REVIEW_STEP_LABELS.KECO} 검토의견`}>
-      <div className="space-y-6">
-        {kecoRvwList.length > 0 ? <TechReviewOpinionTable items={kecoRvwList} /> : null}
-        {renderOpinionForm("KECO")}
-      </div>
-    </SectionCollapsible>
-  );
-});
-
-function TechReviewOpinionTable({ items }: TechReviewOpinionTableProps) {
-  return (
-    <div className="overflow-x-auto">
-      <Table caption="검토의견 목록으로 의견자명, 의견내용, 검토결과, 첨부파일, 등록일시 정보 제공" variant="secondary">
-        <colgroup>
-          <col width="10%" />
-          <col width="55%" />
-          <col width="5%" />
-          <col width="20%" />
-          <col width="10%" />
-        </colgroup>
-        <TableHeader>
-          <TableRow>
-            <TableHead>의견자명</TableHead>
-            <TableHead>의견내용</TableHead>
-            <TableHead>검토결과</TableHead>
-            <TableHead>첨부파일</TableHead>
-            <TableHead>등록일시</TableHead>
-          </TableRow>
-        </TableHeader>
-        <TableBody>
-          {items.map((item) => (
-            <TableRow key={`${item.designCnstnDocNo}_${item.rvwOpnnSn}`}>
-              <TableCell align="center">{item.opnrNm}</TableCell>
-              <TableCell align="left">{item.rvwRsltCn || "-"}</TableCell>
-              <TableCell align="center">
-                {item.rvwRsltAnmlyYn === "Y" ? "이상" : item.rvwRsltAnmlyYn === "N" ? "정상" : "-"}
-              </TableCell>
-              <TableCell align="center">
-                {item.atchFileInfo?.atflCd ? (
-                  <AttachmentDownloadLink
-                    atflCd={item.atchFileInfo.atflCd}
-                    fileName={item.atchFileInfo.orgnlFileNm || "다운로드"}
-                  />
-                ) : (
-                  "-"
-                )}
-              </TableCell>
-              <TableCell align="center">
-                {item.regDt ? dayjs(item.regDt).format("YYYY-MM-DD HH:mm:ss") : "-"}
-              </TableCell>
-            </TableRow>
-          ))}
-        </TableBody>
-      </Table>
-    </div>
-  );
-}
-
-export { TechReviewOpinionSection };
+"use client";
+
+import { forwardRef, useEffect, useImperativeHandle, useState } from "react";
+
+import { useQueryClient } from "@tanstack/react-query";
+
+import { getDefaultFileKey, useTus, useUserStore } from "@/shared/lib";
+import { TextShimmer } from "@/shared/ui";
+import { SectionCollapsible } from "@/shared/ui";
+import { Field, FieldLabel, FieldSet } from "@/shared/ui/field";
+import { attachService } from "@/entities/attach";
+import {
+  designCnstnKeys,
+  type DesignCnstnRvwOpnnResponseDto,
+  designCnstnRvwOpnnService,
+} from "@/entities/design-cnstn";
+import { RvwOpnnListTable } from "@/widgets/pbadms-sprt";
+import {
+  Button,
+  RadioGroup,
+  RadioGroupItem,
+  Table,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+  Textarea,
+} from "@common/components";
+
+import type {
+  ReviewOpinionFormData,
+  ReviewOpinionGetFormDataResult,
+} from "../../lib/review-opinion-utils";
+import type { ReviewStepCode } from "../../model/view-types";
+import { REVIEW_STEP_LABELS } from "../../model/view-types";
+
+const RVW_OPNN_FILE_KEY_PREFIX = "rvw-opnn::";
+
+interface TechReviewOpinionSectionProps {
+  rvwList: DesignCnstnRvwOpnnResponseDto[];
+  editableReviewStep?: ReviewStepCode;
+  atrzSeComCdList?: string[];
+  isAtrzLoading?: boolean;
+}
+
+export interface TechReviewOpinionSectionHandle {
+  getFormData: () => ReviewOpinionGetFormDataResult | null;
+  resetForm: () => void;
+}
+
+interface TechReviewOpinionTableProps {
+  items: DesignCnstnRvwOpnnResponseDto[];
+}
+
+interface UploadedOpinionFile {
+  fileName: string;
+  fileKey: string;
+  atflId?: string;
+  atflCd?: string;
+}
+
+const EMPTY_FORM_DATA: ReviewOpinionFormData = {
+  rvwRsltCn: "",
+  rvwRsltAnmlyYn: "",
+  atchFileGroupId: "",
+  opnrSeComCd: "",
+};
+
+function createRvwOpnnUploadKey(file: File) {
+  return `${RVW_OPNN_FILE_KEY_PREFIX}${getDefaultFileKey(file)}`;
+}
+
+function hasFormContent(formData: ReviewOpinionFormData) {
+  return Boolean(formData.rvwRsltCn.trim() || formData.rvwRsltAnmlyYn || formData.atchFileGroupId);
+}
+
+const TechReviewOpinionSection = forwardRef<
+  TechReviewOpinionSectionHandle,
+  TechReviewOpinionSectionProps
+>(function TechReviewOpinionSection(
+  { rvwList, editableReviewStep, atrzSeComCdList = [], isAtrzLoading = false },
+  ref,
+) {
+  const canWriteOpinion = !isAtrzLoading && atrzSeComCdList.includes("ATRZ02");
+  const [formData, setFormData] = useState<ReviewOpinionFormData>({
+    ...EMPTY_FORM_DATA,
+    opnrSeComCd: editableReviewStep ?? "",
+  });
+  const [uploadedFile, setUploadedFile] = useState<UploadedOpinionFile | null>(null);
+
+  useEffect(() => {
+    setFormData((prev) => ({
+      ...prev,
+      opnrSeComCd: editableReviewStep ?? "",
+    }));
+  }, [editableReviewStep]);
+
+  const { uploadFileAsync, isUploading, uploads } = useTus({
+    onSuccess: (atflCd, atflId, _file, fileKey) => {
+      if (!atflCd || !atflId) return;
+
+      setFormData((prev) => ({ ...prev, atchFileGroupId: atflCd }));
+      setUploadedFile((prev) => (prev?.fileKey === fileKey ? { ...prev, atflCd, atflId } : prev));
+    },
+    onError: (_error, _file, fileKey) => {
+      setUploadedFile((prev) => (prev?.fileKey === fileKey ? null : prev));
+    },
+  });
+
+  useImperativeHandle(
+    ref,
+    () => ({
+      getFormData: () => {
+        if (!canWriteOpinion || !editableReviewStep || !hasFormContent(formData)) {
+          return null;
+        }
+
+        return {
+          formData: {
+            ...formData,
+            opnrSeComCd: editableReviewStep,
+          },
+          rvwList,
+        };
+      },
+      resetForm: () => {
+        setFormData({
+          ...EMPTY_FORM_DATA,
+          opnrSeComCd: editableReviewStep ?? "",
+        });
+        setUploadedFile(null);
+      },
+    }),
+    [canWriteOpinion, editableReviewStep, formData, rvwList],
+  );
+
+  const kecoRvwList = rvwList.filter((item) => item.opnrSeComCd === "KECO");
+  const hasKecoSection =
+    kecoRvwList.length > 0 || (editableReviewStep === "KECO" && canWriteOpinion);
+
+  if (!hasKecoSection) {
+    return null;
+  }
+
+  async function handleFileUpload(files: FileList | null) {
+    if (!files || files.length === 0) return;
+
+    const file = files[0];
+    const fileKey = createRvwOpnnUploadKey(file);
+    const existingAtflCd = formData.atchFileGroupId;
+
+    setUploadedFile({ fileName: file.name, fileKey });
+
+    try {
+      await uploadFileAsync(file, {
+        fileKey,
+        metadata: existingAtflCd ? { atflCd: existingAtflCd } : undefined,
+      });
+    } catch {
+      // onError callback handles cleanup
+    }
+  }
+
+  async function handleFileRemove() {
+    if (!uploadedFile) return;
+
+    uploads[uploadedFile.fileKey]?.abort();
+
+    if (uploadedFile.atflId) {
+      try {
+        await attachService.deleteAttachmentByAtflId(uploadedFile.atflId);
+      } catch (error) {
+        console.error("검토의견 첨부파일 삭제 실패:", error);
+      }
+    }
+
+    setUploadedFile(null);
+    setFormData((prev) => ({ ...prev, atchFileGroupId: "" }));
+  }
+
+  function isReviewTurn(reviewStep: ReviewStepCode) {
+    return editableReviewStep === reviewStep && canWriteOpinion;
+  }
+
+  function renderOpinionForm(reviewStep: ReviewStepCode) {
+    if (!isReviewTurn(reviewStep)) return null;
+
+    const uploading = uploadedFile ? (isUploading[uploadedFile.fileKey] ?? false) : false;
+
+    return (
+      <div className="space-y-2">
+        <h4 className="text-xl font-semibold">검토의견 작성</h4>
+        <Table
+          caption="검토의견 작성으로 의견내용, 검토결과, 첨부파일 정보 제공"
+          variant="secondary"
+        >
+          <TableHeader>
+            <TableRow>
+              <TableHead scope="row" className="w-[12rem]">
+                의견내용
+              </TableHead>
+              <TableCell>
+                <Textarea
+                  value={formData.rvwRsltCn}
+                  onChange={(event) =>
+                    setFormData((prev) => ({ ...prev, rvwRsltCn: event.target.value }))
+                  }
+                  placeholder="의견내용을 입력하세요"
+                  rows={4}
+                  className="min-h-[8rem] !text-xl"
+                />
+              </TableCell>
+            </TableRow>
+            <TableRow>
+              <TableHead scope="row">검토결과</TableHead>
+              <TableCell>
+                <FieldSet>
+                  <RadioGroup
+                    value={formData.rvwRsltAnmlyYn}
+                    onValueChange={(value) =>
+                      setFormData((prev) => ({
+                        ...prev,
+                        rvwRsltAnmlyYn: value as ReviewOpinionFormData["rvwRsltAnmlyYn"],
+                      }))
+                    }
+                  >
+                    <div className="flex flex-wrap gap-4">
+                      <FieldLabel
+                        htmlFor={`rvw-opnn-normal-${reviewStep}`}
+                        className="!w-auto border-none"
+                      >
+                        <Field orientation="horizontal" className="w-auto">
+                          <RadioGroupItem value="N" id={`rvw-opnn-normal-${reviewStep}`} />
+                          <span className="font-normal">정상</span>
+                        </Field>
+                      </FieldLabel>
+                      <FieldLabel
+                        htmlFor={`rvw-opnn-abnormal-${reviewStep}`}
+                        className="!w-auto border-none"
+                      >
+                        <Field orientation="horizontal" className="w-auto">
+                          <RadioGroupItem value="Y" id={`rvw-opnn-abnormal-${reviewStep}`} />
+                          <span className="font-normal">이상</span>
+                        </Field>
+                      </FieldLabel>
+                    </div>
+                  </RadioGroup>
+                </FieldSet>
+              </TableCell>
+            </TableRow>
+            <TableRow>
+              <TableHead scope="row">첨부파일</TableHead>
+              <TableCell>
+                {uploadedFile ? (
+                  <div className="flex items-center gap-2">
+                    <TextShimmer className="text-xl" active={uploading}>
+                      {uploadedFile.fileName}
+                    </TextShimmer>
+                    <Button
+                      size="icon"
+                      onClick={(e) => {
+                        e.preventDefault();
+                        void handleFileRemove();
+                      }}
+                      disabled={uploading}
+                      className="size-8 !bg-destructive"
+                    >
+                      <i className="diveicon di-x text-xs" aria-label="삭제" />
+                    </Button>
+                  </div>
+                ) : (
+                  <label>
+                    <input
+                      type="file"
+                      className="hidden"
+                      onChange={(event) => {
+                        void handleFileUpload(event.target.files);
+                        event.target.value = "";
+                      }}
+                    />
+                    <Button size="sm" variant="outline" type="button" asChild>
+                      <span>파일 선택</span>
+                    </Button>
+                  </label>
+                )}
+              </TableCell>
+            </TableRow>
+          </TableHeader>
+        </Table>
+      </div>
+    );
+  }
+
+  return (
+    <SectionCollapsible title={`${REVIEW_STEP_LABELS.KECO} 검토의견`}>
+      <div className="space-y-6">
+        {kecoRvwList.length > 0 ? (
+          <TechReviewOpinionTable items={kecoRvwList} />
+        ) : null}
+        {renderOpinionForm("KECO")}
+      </div>
+    </SectionCollapsible>
+  );
+});
+
+function getRvwOpnnIds(item: DesignCnstnRvwOpnnResponseDto) {
+  if (!item.designCnstnDocNo || item.rvwOpnnSn == null) {
+    throw new Error("검토의견 식별값이 없습니다.");
+  }
+  return [item.designCnstnDocNo, item.rvwOpnnSn] as const;
+}
+
+function TechReviewOpinionTable({ items }: TechReviewOpinionTableProps) {
+  const queryClient = useQueryClient();
+  const currentUserUuid = useUserStore((state) => state.userInfo?.userUnqId);
+
+  return (
+    <RvwOpnnListTable
+      items={items}
+      getRowKey={(item) => `${item.designCnstnDocNo}_${item.rvwOpnnSn}`}
+      currentUserUuid={currentUserUuid}
+      onUpdate={async (item, body) => {
+        await designCnstnRvwOpnnService.update(...getRvwOpnnIds(item), body);
+        await queryClient.invalidateQueries({ queryKey: designCnstnKeys.all });
+      }}
+      onDelete={async (item) => {
+        await designCnstnRvwOpnnService.delete(...getRvwOpnnIds(item));
+        await queryClient.invalidateQueries({ queryKey: designCnstnKeys.all });
+      }}
+    />
+  );
+}
+
+export { TechReviewOpinionSection };

apps/as/src/pages/fnrs-cnsltn/ui/sections/tech-review-opinion-section.tsx

@@ -1,352 +1,345 @@
-"use client";
-
-import { forwardRef, useEffect, useImperativeHandle, useState } from "react";
-
-import { dayjs, getDefaultFileKey, useTus } from "@/shared/lib";
-import { AttachmentFileField, SectionCollapsible } from "@/shared/ui";
-import { Field, FieldLabel, FieldSet } from "@/shared/ui/field";
-import {
-  AttachmentDownloadLink,
-  attachService,
-  useDownloadAttachmentByAtflId,
-} from "@/entities/attach";
-import type { FnrsCnsltnRvwOpnnResponseDto } from "@/entities/fnrs-cnsltn";
-import {
-  RadioGroup,
-  RadioGroupItem,
-  Table,
-  TableBody,
-  TableCell,
-  TableHead,
-  TableHeader,
-  TableRow,
-  Textarea,
-} from "@common/components";
-
-import type {
-  ReviewOpinionFormData,
-  ReviewOpinionGetFormDataResult,
-} from "../../lib/review-opinion-utils";
-import type { ReviewStepCode } from "../../model/view-types";
-import { REVIEW_STEP_LABELS } from "../../model/view-types";
-
-const RVW_OPNN_FILE_KEY_PREFIX = "rvw-opnn::";
-
-interface TechReviewOpinionSectionProps {
-  rvwList: FnrsCnsltnRvwOpnnResponseDto[];
-  editableReviewStep?: ReviewStepCode;
-  atrzSeComCdList?: string[];
-  isAtrzLoading?: boolean;
-}
-
-export interface TechReviewOpinionSectionHandle {
-  getFormData: () => ReviewOpinionGetFormDataResult | null;
-  resetForm: () => void;
-}
-
-interface TechReviewOpinionTableProps {
-  items: FnrsCnsltnRvwOpnnResponseDto[];
-}
-
-interface UploadedOpinionFile {
-  fileName: string;
-  fileKey: string;
-  atflId?: string;
-  atflCd?: string;
-}
-
-const EMPTY_FORM_DATA: ReviewOpinionFormData = {
-  rvwRsltCn: "",
-  rvwRsltAnmlyYn: "",
-  atchFileGroupId: "",
-  opnrSeComCd: "",
-};
-
-function createRvwOpnnUploadKey(file: File) {
-  return `${RVW_OPNN_FILE_KEY_PREFIX}${getDefaultFileKey(file)}`;
-}
-
-function hasFormContent(formData: ReviewOpinionFormData) {
-  return Boolean(formData.rvwRsltCn.trim() || formData.rvwRsltAnmlyYn || formData.atchFileGroupId);
-}
-
-const TechReviewOpinionSection = forwardRef<
-  TechReviewOpinionSectionHandle,
-  TechReviewOpinionSectionProps
->(function TechReviewOpinionSection(
-  { rvwList, editableReviewStep, atrzSeComCdList = [], isAtrzLoading = false },
-  ref,
-) {
-  const canWriteKecoOpinion = !isAtrzLoading && atrzSeComCdList.includes("ATRZ02");
-  const [formData, setFormData] = useState<ReviewOpinionFormData>({
-    ...EMPTY_FORM_DATA,
-    opnrSeComCd: editableReviewStep ?? "",
-  });
-  const [uploadedFile, setUploadedFile] = useState<UploadedOpinionFile | null>(null);
-  const { mutate: downloadByAtflId } = useDownloadAttachmentByAtflId();
-
-  useEffect(() => {
-    setFormData((prev) => ({
-      ...prev,
-      opnrSeComCd: editableReviewStep ?? "",
-    }));
-  }, [editableReviewStep]);
-
-  const { uploadFileAsync, isUploading, uploads } = useTus({
-    onSuccess: (atflCd, atflId, _file, fileKey) => {
-      if (!atflCd || !atflId) return;
-
-      setFormData((prev) => ({ ...prev, atchFileGroupId: atflCd }));
-      setUploadedFile((prev) => (prev?.fileKey === fileKey ? { ...prev, atflCd, atflId } : prev));
-    },
-    onError: (_error, _file, fileKey) => {
-      setUploadedFile((prev) => (prev?.fileKey === fileKey ? null : prev));
-    },
-  });
-
-  useImperativeHandle(
-    ref,
-    () => ({
-      getFormData: () => {
-        if (!editableReviewStep || !hasFormContent(formData)) {
-          return null;
-        }
-        if (editableReviewStep === "KECO" && !canWriteKecoOpinion) {
-          return null;
-        }
-
-        return {
-          formData: {
-            ...formData,
-            opnrSeComCd: editableReviewStep,
-          },
-          rvwList,
-        };
-      },
-      resetForm: () => {
-        setFormData({
-          ...EMPTY_FORM_DATA,
-          opnrSeComCd: editableReviewStep ?? "",
-        });
-        setUploadedFile(null);
-      },
-    }),
-    [canWriteKecoOpinion, editableReviewStep, formData, rvwList],
-  );
-
-  const envRvwList = rvwList.filter((item) => item.opnrSeComCd === "ENV");
-  const kecoRvwList = rvwList.filter((item) => item.opnrSeComCd === "KECO");
-
-  const hasEnvSection = envRvwList.length > 0 || editableReviewStep === "ENV";
-  const hasKecoSection = kecoRvwList.length > 0 || editableReviewStep === "KECO";
-
-  if (!hasEnvSection && !hasKecoSection) {
-    return null;
-  }
-
-  async function handleFileUpload(files: FileList | null) {
-    if (!files || files.length === 0) return;
-
-    const file = files[0];
-    const fileKey = createRvwOpnnUploadKey(file);
-    const existingAtflCd = formData.atchFileGroupId;
-
-    setUploadedFile({ fileName: file.name, fileKey });
-
-    try {
-      await uploadFileAsync(file, {
-        fileKey,
-        metadata: existingAtflCd ? { atflCd: existingAtflCd } : undefined,
-      });
-    } catch {
-      // onError callback handles cleanup
-    }
-  }
-
-  async function handleFileRemove() {
-    if (!uploadedFile) return;
-
-    uploads[uploadedFile.fileKey]?.abort();
-
-    if (uploadedFile.atflId) {
-      try {
-        await attachService.deleteAttachmentByAtflId(uploadedFile.atflId);
-      } catch (error) {
-        console.error("검토의견 첨부파일 삭제 실패:", error);
-      }
-    }
-
-    setUploadedFile(null);
-    setFormData((prev) => ({ ...prev, atchFileGroupId: "" }));
-  }
-
-  function renderOpinionForm(reviewStep: ReviewStepCode) {
-    if (editableReviewStep !== reviewStep) return null;
-    if (reviewStep === "KECO" && !canWriteKecoOpinion) return null;
-
-    const uploading = uploadedFile ? (isUploading[uploadedFile.fileKey] ?? false) : false;
-
-    return (
-      <div className="space-y-2">
-        <h4 className="text-xl font-semibold">검토의견 작성</h4>
-        <Table caption="검토의견 작성으로 의견내용, 검토결과, 첨부파일 정보 제공" variant="secondary">
-          <TableHeader>
-            <TableRow>
-              <TableHead className="w-[12rem]">의견내용</TableHead>
-              <TableCell>
-                <Textarea
-                  value={formData.rvwRsltCn}
-                  onChange={(event) =>
-                    setFormData((prev) => ({ ...prev, rvwRsltCn: event.target.value }))
-                  }
-                  placeholder="의견내용을 입력하세요"
-                  rows={4}
-                  className="min-h-[8rem] !text-xl"
-                />
-              </TableCell>
-            </TableRow>
-            <TableRow>
-              <TableHead>검토결과</TableHead>
-              <TableCell>
-                <FieldSet>
-                  <RadioGroup
-                    value={formData.rvwRsltAnmlyYn}
-                    onValueChange={(value) =>
-                      setFormData((prev) => ({
-                        ...prev,
-                        rvwRsltAnmlyYn: value as ReviewOpinionFormData["rvwRsltAnmlyYn"],
-                      }))
-                    }
-                  >
-                    <div className="flex flex-wrap gap-4">
-                      <FieldLabel
-                        htmlFor={`rvw-opnn-normal-${reviewStep}`}
-                        className="!w-auto border-none"
-                      >
-                        <Field orientation="horizontal" className="w-auto">
-                          <RadioGroupItem value="N" id={`rvw-opnn-normal-${reviewStep}`} />
-                          <span className="font-normal">정상</span>
-                        </Field>
-                      </FieldLabel>
-                      <FieldLabel
-                        htmlFor={`rvw-opnn-abnormal-${reviewStep}`}
-                        className="!w-auto border-none"
-                      >
-                        <Field orientation="horizontal" className="w-auto">
-                          <RadioGroupItem value="Y" id={`rvw-opnn-abnormal-${reviewStep}`} />
-                          <span className="font-normal">이상</span>
-                        </Field>
-                      </FieldLabel>
-                    </div>
-                  </RadioGroup>
-                </FieldSet>
-              </TableCell>
-            </TableRow>
-            <TableRow>
-              <TableHead>첨부파일</TableHead>
-              <TableCell>
-                <AttachmentFileField
-                  files={
-                    uploadedFile
-                      ? [
-                          {
-                            fileKey: uploadedFile.fileKey,
-                            fileName: uploadedFile.fileName,
-                            onDownload: uploadedFile.atflId
-                              ? () => downloadByAtflId(uploadedFile.atflId!)
-                              : undefined,
-                          },
-                        ]
-                      : []
-                  }
-                  inputId={`rvw-opnn-${reviewStep}-file-input`}
-                  isUploadingByKey={isUploading}
-                  multiple={false}
-                  showAddButton={!uploadedFile}
-                  addDisabled={uploading}
-                  onAdd={(fileList) => void handleFileUpload(fileList)}
-                  onRemove={() => void handleFileRemove()}
-                />
-              </TableCell>
-            </TableRow>
-          </TableHeader>
-        </Table>
-      </div>
-    );
-  }
-
-  return (
-    <>
-      {hasEnvSection ? (
-        <SectionCollapsible title={`${REVIEW_STEP_LABELS.ENV} 검토의견`}>
-          <div className="space-y-6">
-            {envRvwList.length > 0 ? <TechReviewOpinionTable items={envRvwList} /> : null}
-            {renderOpinionForm("ENV")}
-          </div>
-        </SectionCollapsible>
-      ) : null}
-      {hasKecoSection ? (
-        <SectionCollapsible title={`${REVIEW_STEP_LABELS.KECO} 검토의견`}>
-          <div className="space-y-6">
-            {kecoRvwList.length > 0 ? <TechReviewOpinionTable items={kecoRvwList} /> : null}
-            {/* 
-            재원협의에서 환경공단 검토의견은 자동 생성
-            {renderOpinionForm("KECO")}
-            */}
-          </div>
-        </SectionCollapsible>
-      ) : null}
-    </>
-  );
-});
-
-function TechReviewOpinionTable({ items }: TechReviewOpinionTableProps) {
-  return (
-    <div className="overflow-x-auto">
-      <Table caption="검토의견 목록으로 의견자명, 의견내용, 검토결과, 첨부파일, 등록일시 정보 제공" variant="secondary">
-        <colgroup>
-          <col width="10%" />
-          <col width="55%" />
-          <col width="5%" />
-          <col width="20%" />
-          <col width="10%" />
-        </colgroup>
-        <TableHeader>
-          <TableRow>
-            <TableHead>의견자명</TableHead>
-            <TableHead>의견내용</TableHead>
-            <TableHead>검토결과</TableHead>
-            <TableHead>첨부파일</TableHead>
-            <TableHead>등록일시</TableHead>
-          </TableRow>
-        </TableHeader>
-        <TableBody>
-          {items.map((item) => (
-            <TableRow key={`${item.fnrsCnsltnDocNo}_${item.rvwOpnnSn}`}>
-              <TableCell align="center">{item.opnrNm}</TableCell>
-              <TableCell align="left">{item.rvwRsltCn || "-"}</TableCell>
-              <TableCell align="center">
-                {item.rvwRsltAnmlyYn === "Y" ? "이상" : item.rvwRsltAnmlyYn === "N" ? "정상" : "-"}
-              </TableCell>
-              <TableCell align="center">
-                {item.atchFileInfo?.atflCd ? (
-                  <AttachmentDownloadLink
-                    atflCd={item.atchFileInfo.atflCd}
-                    fileName={item.atchFileInfo.orgnlFileNm || "다운로드"}
-                  />
-                ) : (
-                  "-"
-                )}
-              </TableCell>
-              <TableCell align="center">
-                {item.regDt ? dayjs(item.regDt).format("YYYY-MM-DD HH:mm:ss") : "-"}
-              </TableCell>
-            </TableRow>
-          ))}
-        </TableBody>
-      </Table>
-    </div>
-  );
-}
-
-export { TechReviewOpinionSection };
+"use client";
+
+import { forwardRef, useEffect, useImperativeHandle, useState } from "react";
+
+import { useQueryClient } from "@tanstack/react-query";
+
+import { getDefaultFileKey, useTus, useUserStore } from "@/shared/lib";
+import { AttachmentFileField, SectionCollapsible } from "@/shared/ui";
+import { Field, FieldLabel, FieldSet } from "@/shared/ui/field";
+import { attachService, useDownloadAttachmentByAtflId } from "@/entities/attach";
+import {
+  fnrsCnsltnKeys,
+  type FnrsCnsltnRvwOpnnResponseDto,
+  fnrsCnsltnRvwOpnnService,
+} from "@/entities/fnrs-cnsltn";
+import { RvwOpnnListTable } from "@/widgets/pbadms-sprt";
+import {
+  RadioGroup,
+  RadioGroupItem,
+  Table,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+  Textarea,
+} from "@common/components";
+
+import type {
+  ReviewOpinionFormData,
+  ReviewOpinionGetFormDataResult,
+} from "../../lib/review-opinion-utils";
+import type { ReviewStepCode } from "../../model/view-types";
+import { REVIEW_STEP_LABELS } from "../../model/view-types";
+
+const RVW_OPNN_FILE_KEY_PREFIX = "rvw-opnn::";
+
+interface TechReviewOpinionSectionProps {
+  rvwList: FnrsCnsltnRvwOpnnResponseDto[];
+  editableReviewStep?: ReviewStepCode;
+  atrzSeComCdList?: string[];
+  isAtrzLoading?: boolean;
+}
+
+export interface TechReviewOpinionSectionHandle {
+  getFormData: () => ReviewOpinionGetFormDataResult | null;
+  resetForm: () => void;
+}
+
+interface TechReviewOpinionTableProps {
+  items: FnrsCnsltnRvwOpnnResponseDto[];
+}
+
+interface UploadedOpinionFile {
+  fileName: string;
+  fileKey: string;
+  atflId?: string;
+  atflCd?: string;
+}
+
+const EMPTY_FORM_DATA: ReviewOpinionFormData = {
+  rvwRsltCn: "",
+  rvwRsltAnmlyYn: "",
+  atchFileGroupId: "",
+  opnrSeComCd: "",
+};
+
+function createRvwOpnnUploadKey(file: File) {
+  return `${RVW_OPNN_FILE_KEY_PREFIX}${getDefaultFileKey(file)}`;
+}
+
+function hasFormContent(formData: ReviewOpinionFormData) {
+  return Boolean(formData.rvwRsltCn.trim() || formData.rvwRsltAnmlyYn || formData.atchFileGroupId);
+}
+
+const TechReviewOpinionSection = forwardRef<
+  TechReviewOpinionSectionHandle,
+  TechReviewOpinionSectionProps
+>(function TechReviewOpinionSection(
+  { rvwList, editableReviewStep, atrzSeComCdList = [], isAtrzLoading = false },
+  ref,
+) {
+  const canWriteKecoOpinion = !isAtrzLoading && atrzSeComCdList.includes("ATRZ02");
+  const [formData, setFormData] = useState<ReviewOpinionFormData>({
+    ...EMPTY_FORM_DATA,
+    opnrSeComCd: editableReviewStep ?? "",
+  });
+  const [uploadedFile, setUploadedFile] = useState<UploadedOpinionFile | null>(null);
+  const { mutate: downloadByAtflId } = useDownloadAttachmentByAtflId();
+
+  useEffect(() => {
+    setFormData((prev) => ({
+      ...prev,
+      opnrSeComCd: editableReviewStep ?? "",
+    }));
+  }, [editableReviewStep]);
+
+  const { uploadFileAsync, isUploading, uploads } = useTus({
+    onSuccess: (atflCd, atflId, _file, fileKey) => {
+      if (!atflCd || !atflId) return;
+
+      setFormData((prev) => ({ ...prev, atchFileGroupId: atflCd }));
+      setUploadedFile((prev) => (prev?.fileKey === fileKey ? { ...prev, atflCd, atflId } : prev));
+    },
+    onError: (_error, _file, fileKey) => {
+      setUploadedFile((prev) => (prev?.fileKey === fileKey ? null : prev));
+    },
+  });
+
+  useImperativeHandle(
+    ref,
+    () => ({
+      getFormData: () => {
+        if (!editableReviewStep || !hasFormContent(formData)) {
+          return null;
+        }
+        if (editableReviewStep === "KECO" && !canWriteKecoOpinion) {
+          return null;
+        }
+
+        return {
+          formData: {
+            ...formData,
+            opnrSeComCd: editableReviewStep,
+          },
+          rvwList,
+        };
+      },
+      resetForm: () => {
+        setFormData({
+          ...EMPTY_FORM_DATA,
+          opnrSeComCd: editableReviewStep ?? "",
+        });
+        setUploadedFile(null);
+      },
+    }),
+    [canWriteKecoOpinion, editableReviewStep, formData, rvwList],
+  );
+
+  const envRvwList = rvwList.filter((item) => item.opnrSeComCd === "ENV");
+  const kecoRvwList = rvwList.filter((item) => item.opnrSeComCd === "KECO");
+
+  const hasEnvSection = envRvwList.length > 0 || editableReviewStep === "ENV";
+  const hasKecoSection = kecoRvwList.length > 0 || editableReviewStep === "KECO";
+
+  if (!hasEnvSection && !hasKecoSection) {
+    return null;
+  }
+
+  async function handleFileUpload(files: FileList | null) {
+    if (!files || files.length === 0) return;
+
+    const file = files[0];
+    const fileKey = createRvwOpnnUploadKey(file);
+    const existingAtflCd = formData.atchFileGroupId;
+
+    setUploadedFile({ fileName: file.name, fileKey });
+
+    try {
+      await uploadFileAsync(file, {
+        fileKey,
+        metadata: existingAtflCd ? { atflCd: existingAtflCd } : undefined,
+      });
+    } catch {
+      // onError callback handles cleanup
+    }
+  }
+
+  async function handleFileRemove() {
+    if (!uploadedFile) return;
+
+    uploads[uploadedFile.fileKey]?.abort();
+
+    if (uploadedFile.atflId) {
+      try {
+        await attachService.deleteAttachmentByAtflId(uploadedFile.atflId);
+      } catch (error) {
+        console.error("검토의견 첨부파일 삭제 실패:", error);
+      }
+    }
+
+    setUploadedFile(null);
+    setFormData((prev) => ({ ...prev, atchFileGroupId: "" }));
+  }
+
+  function isReviewTurn(reviewStep: ReviewStepCode) {
+    if (editableReviewStep !== reviewStep) return false;
+    if (reviewStep === "KECO" && !canWriteKecoOpinion) return false;
+    return true;
+  }
+
+  function renderOpinionForm(reviewStep: ReviewStepCode) {
+    if (!isReviewTurn(reviewStep)) return null;
+
+    const uploading = uploadedFile ? (isUploading[uploadedFile.fileKey] ?? false) : false;
+
+    return (
+      <div className="space-y-2">
+        <h4 className="text-xl font-semibold">검토의견 작성</h4>
+        <Table
+          caption="검토의견 작성으로 의견내용, 검토결과, 첨부파일 정보 제공"
+          variant="secondary"
+        >
+          <TableHeader>
+            <TableRow>
+              <TableHead className="w-[12rem]">의견내용</TableHead>
+              <TableCell>
+                <Textarea
+                  value={formData.rvwRsltCn}
+                  onChange={(event) =>
+                    setFormData((prev) => ({ ...prev, rvwRsltCn: event.target.value }))
+                  }
+                  placeholder="의견내용을 입력하세요"
+                  rows={4}
+                  className="min-h-[8rem] !text-xl"
+                />
+              </TableCell>
+            </TableRow>
+            <TableRow>
+              <TableHead>검토결과</TableHead>
+              <TableCell>
+                <FieldSet>
+                  <RadioGroup
+                    value={formData.rvwRsltAnmlyYn}
+                    onValueChange={(value) =>
+                      setFormData((prev) => ({
+                        ...prev,
+                        rvwRsltAnmlyYn: value as ReviewOpinionFormData["rvwRsltAnmlyYn"],
+                      }))
+                    }
+                  >
+                    <div className="flex flex-wrap gap-4">
+                      <FieldLabel
+                        htmlFor={`rvw-opnn-normal-${reviewStep}`}
+                        className="!w-auto border-none"
+                      >
+                        <Field orientation="horizontal" className="w-auto">
+                          <RadioGroupItem value="N" id={`rvw-opnn-normal-${reviewStep}`} />
+                          <span className="font-normal">정상</span>
+                        </Field>
+                      </FieldLabel>
+                      <FieldLabel
+                        htmlFor={`rvw-opnn-abnormal-${reviewStep}`}
+                        className="!w-auto border-none"
+                      >
+                        <Field orientation="horizontal" className="w-auto">
+                          <RadioGroupItem value="Y" id={`rvw-opnn-abnormal-${reviewStep}`} />
+                          <span className="font-normal">이상</span>
+                        </Field>
+                      </FieldLabel>
+                    </div>
+                  </RadioGroup>
+                </FieldSet>
+              </TableCell>
+            </TableRow>
+            <TableRow>
+              <TableHead>첨부파일</TableHead>
+              <TableCell>
+                <AttachmentFileField
+                  files={
+                    uploadedFile
+                      ? [
+                          {
+                            fileKey: uploadedFile.fileKey,
+                            fileName: uploadedFile.fileName,
+                            onDownload: uploadedFile.atflId
+                              ? () => downloadByAtflId(uploadedFile.atflId!)
+                              : undefined,
+                          },
+                        ]
+                      : []
+                  }
+                  inputId={`rvw-opnn-${reviewStep}-file-input`}
+                  isUploadingByKey={isUploading}
+                  multiple={false}
+                  showAddButton={!uploadedFile}
+                  addDisabled={uploading}
+                  onAdd={(fileList) => void handleFileUpload(fileList)}
+                  onRemove={() => void handleFileRemove()}
+                />
+              </TableCell>
+            </TableRow>
+          </TableHeader>
+        </Table>
+      </div>
+    );
+  }
+
+  return (
+    <>
+      {hasEnvSection ? (
+        <SectionCollapsible title={`${REVIEW_STEP_LABELS.ENV} 검토의견`}>
+          <div className="space-y-6">
+            {envRvwList.length > 0 ? (
+              <TechReviewOpinionTable items={envRvwList} />
+            ) : null}
+            {renderOpinionForm("ENV")}
+          </div>
+        </SectionCollapsible>
+      ) : null}
+      {hasKecoSection ? (
+        <SectionCollapsible title={`${REVIEW_STEP_LABELS.KECO} 검토의견`}>
+          <div className="space-y-6">
+            {kecoRvwList.length > 0 ? (
+              <TechReviewOpinionTable items={kecoRvwList} />
+            ) : null}
+            {/* 
+            재원협의에서 환경공단 검토의견은 자동 생성
+            {renderOpinionForm("KECO")}
+            */}
+          </div>
+        </SectionCollapsible>
+      ) : null}
+    </>
+  );
+});
+
+function getRvwOpnnIds(item: FnrsCnsltnRvwOpnnResponseDto) {
+  if (!item.fnrsCnsltnDocNo || item.rvwOpnnSn == null) {
+    throw new Error("검토의견 식별값이 없습니다.");
+  }
+  return [item.fnrsCnsltnDocNo, item.rvwOpnnSn] as const;
+}
+
+function TechReviewOpinionTable({ items }: TechReviewOpinionTableProps) {
+  const queryClient = useQueryClient();
+  const currentUserUuid = useUserStore((state) => state.userInfo?.userUnqId);
+
+  return (
+    <RvwOpnnListTable
+      items={items}
+      getRowKey={(item) => `${item.fnrsCnsltnDocNo}_${item.rvwOpnnSn}`}
+      currentUserUuid={currentUserUuid}
+      onUpdate={async (item, body) => {
+        await fnrsCnsltnRvwOpnnService.update(...getRvwOpnnIds(item), body);
+        await queryClient.invalidateQueries({ queryKey: fnrsCnsltnKeys.all });
+      }}
+      onDelete={async (item) => {
+        await fnrsCnsltnRvwOpnnService.delete(...getRvwOpnnIds(item));
+        await queryClient.invalidateQueries({ queryKey: fnrsCnsltnKeys.all });
+      }}
+    />
+  );
+}
+
+export { TechReviewOpinionSection };

apps/as/src/pages/instl-sncn/lib/button-config.ts

@@ -3,7 +3,6 @@ export const INSTL_SNCN_VIEW_BUTTON_ACTION = {
   aply: "aply",
   del: "del",
   instlSncnAncmnt: "instlSncnAncmnt",
-  envoSbmsn: "envoSbmsn",
   rjct: "rjct",
   sncnAprv: "sncnAprv",
   rvwRply: "rvwRply",
@@ -33,14 +32,16 @@ const ROLE_STATUS_BUTTON_ACTIONS: Record<string, Record<string, InstlSncnViewBut
     ],
     TA: [INSTL_SNCN_VIEW_BUTTON_ACTION.instlSncnAncmnt],
   },
-  ROLE_USER04: {
-    ST: [INSTL_SNCN_VIEW_BUTTON_ACTION.envoSbmsn, INSTL_SNCN_VIEW_BUTTON_ACTION.rjct],
-    EP: [INSTL_SNCN_VIEW_BUTTON_ACTION.sncnAprv],
-  },
-  ROLE_USER03: {
-    LE: [INSTL_SNCN_VIEW_BUTTON_ACTION.rvwRply, INSTL_SNCN_VIEW_BUTTON_ACTION.rqstTechRvw],
-    TP: [INSTL_SNCN_VIEW_BUTTON_ACTION.rvwRply],
-  },
+  // 환경청 단계 제거: 기존 환경청(LE·TP) 기능을 광역자치단체가 수행
+  ROLE_USER04: {
+    ST: [
+      INSTL_SNCN_VIEW_BUTTON_ACTION.rvwRply,
+      INSTL_SNCN_VIEW_BUTTON_ACTION.rqstTechRvw,
+      INSTL_SNCN_VIEW_BUTTON_ACTION.rjct,
+    ],
+    TP: [INSTL_SNCN_VIEW_BUTTON_ACTION.rvwRply],
+    EP: [INSTL_SNCN_VIEW_BUTTON_ACTION.sncnAprv],
+  },
 };
 
 const ROLE_USER01_ATRZ_STATUS_CODES = ["ER", "TE"] as const;

apps/as/src/pages/instl-sncn/lib/instl-sncn-regist-schema.ts

@@ -55,16 +55,8 @@ export const instlSncnRegistSchema = z.object({
       tstmDesignAmt: z.number(),
     }),
   ),
-  cklstResultList: z.array(
-    instlSncnCklstResultItemSchema.extend({
-      cklstSn: z.number(),
-      cklstArtclSn: z.number(),
-      cklstRvwSn: z.number(),
-      rvwStpComCd: z.string(),
-      selected: z.enum(["Y", "N"]).nullish(),
-      picRvwCn: z.string().nullish(),
-    }),
-  ),
+  // 설치인가 화면에서 체크리스트 미사용: 숨겨진 값 때문에 신청·저장 검증이 막히지 않도록 필수값을 두지 않음
+  cklstResultList: z.array(instlSncnCklstResultItemSchema),
   esntlAtchFileList: z.array(
     instlSncnEsntlAtchFileItemSchema.extend({
       esntlAtchFileId: z.string(),

apps/as/src/pages/instl-sncn/lib/review-step-utils.ts

@@ -50,7 +50,7 @@ export function getEditableReviewStep(
   dtlInstCd?: string,
   prgrsSttsComCd?: string,
 ): ReviewStepCode | undefined {
-  if (dtlInstCd === "ROLE_USER03" && (prgrsSttsComCd === "LE" || prgrsSttsComCd === "TP")) {
+  if (dtlInstCd === "ROLE_USER04" && (prgrsSttsComCd === "ST" || prgrsSttsComCd === "TP")) {
     return "ENV";
   }
 

apps/as/src/pages/instl-sncn/model/view-types.ts

@@ -50,13 +50,13 @@ export const REVIEW_STEP_CODES: ReviewStepCode[] = ["LOCAL", "ENV", "KECO"];
 
 export const CHECKLIST_TAB_LABELS: Record<ReviewStepCode, string> = {
   LOCAL: "자가체크",
-  ENV: "환경청검토",
+  ENV: "광역자치단체검토",
   KECO: "기술검토",
 };
 
 export const REVIEW_STEP_LABELS: Record<ReviewStepCode, string> = {
   LOCAL: "지자체",
-  ENV: "환경청",
+  ENV: "광역자치단체",
   KECO: "환경공단",
 };
 
@@ -89,7 +89,7 @@ export const INSTL_PROGRESS_ORDER = [
 
 export const ROLE_TO_REVIEW_STEP: Record<string, ReviewStepCode> = {
   ROLE_USER05: "LOCAL",
-  ROLE_USER03: "ENV",
+  ROLE_USER04: "ENV",
   ROLE_USER01: "KECO",
 };
 

apps/as/src/pages/instl-sncn/ui/components/floating-action-buttons.tsx

@@ -35,7 +35,6 @@ import {
   type InstlSncnViewButtonAction,
   needsRoleUser01AtrzResolve,
 } from "../../lib/button-config";
-import { computeReviewStepChecklistProgress } from "../../lib/checklist-utils";
 import {
   buildSavePayload,
   buildSupplementReqPayload,
@@ -179,11 +178,6 @@ function FloatingActionButtons({
   }
 
   async function handleAplyClick() {
-    const { percent } = computeReviewStepChecklistProgress(
-      data.cklstResultList ?? [],
-      checklistFormState.results,
-      "LOCAL",
-    );
     const payload: InstlSncnApplySaveRequestDto = buildSavePayload(
       data,
       checklistFormState,
@@ -191,11 +185,6 @@ function FloatingActionButtons({
       "ST",
     );
 
-    if (percent !== 100) {
-      alert("모든 체크리스트 항목을 체크해야 신청이 가능합니다.");
-      return;
-    }
-
     await executeAction({
       action: INSTL_SNCN_VIEW_BUTTON_ACTION.aply,
       request: payload,
@@ -231,22 +220,6 @@ function FloatingActionButtons({
     });
   }
 
-  async function handleEnvoSbmsnClick() {
-    const payload: DocPrgrsUpdateRequestDto = {
-      docNo,
-      docSeComCd,
-      prgrsSttsComCd: "LE",
-    };
-    await executeAction({
-      action: INSTL_SNCN_VIEW_BUTTON_ACTION.envoSbmsn,
-      request: payload,
-      successMessage: "제출되었습니다.",
-    });
-    queryClient.invalidateQueries({
-      queryKey: instlSncnKeys.list(),
-    });
-  }
-
   async function handleRjctClick() {
     const payload: DocPrgrsUpdateRequestDto = {
       docNo,
@@ -284,16 +257,6 @@ function FloatingActionButtons({
   }
 
   async function handleRvwRplyClick() {
-    const { percent } = computeReviewStepChecklistProgress(
-      data.cklstResultList ?? [],
-      checklistFormState.results,
-      "ENV",
-    );
-
-    if (percent !== 100) {
-      alert("모든 체크리스트 항목을 체크해야 검토결과 회신이 가능합니다.");
-      return;
-    }
 
     const payload = buildTechReviewReplyPayload(
       data,
@@ -369,16 +332,6 @@ function FloatingActionButtons({
   }
 
   async function handleRvwCmptnClick() {
-    const { percent } = computeReviewStepChecklistProgress(
-      data.cklstResultList ?? [],
-      checklistFormState.results,
-      "KECO",
-    );
-
-    if (percent !== 100) {
-      alert("모든 체크리스트 항목을 체크해야 검토완료가 가능합니다.");
-      return;
-    }
 
     const payload = {
       ...buildTechReviewReplyPayload(
@@ -447,11 +400,6 @@ function FloatingActionButtons({
               설치인가 고시
             </Button>
           )}
-          {shouldShowButton(INSTL_SNCN_VIEW_BUTTON_ACTION.envoSbmsn) && (
-            <Button onClick={handleEnvoSbmsnClick} disabled={isProcessing}>
-              환경청제출
-            </Button>
-          )}
           {shouldShowButton(INSTL_SNCN_VIEW_BUTTON_ACTION.rjct) && (
             <Button color="red" onClick={handleRjctClick} disabled={isProcessing}>
               반려
@@ -618,7 +566,6 @@ const buttonActionHandlers: Record<InstlSncnViewButtonAction, ActionHandler> = {
   aply: handleSaveApply,
   del: handleDel,
   instlSncnAncmnt: handleChangePrgrsSttsComCd,
-  envoSbmsn: handleChangePrgrsSttsComCd,
   rjct: handleChangePrgrsSttsComCd,
   sncnAprv: handleChangePrgrsSttsComCd,
   rvwRply: handleTechReview,

apps/as/src/pages/instl-sncn/ui/instl-form-page.tsx

@@ -20,9 +20,7 @@ import {
   AttachmentsFormSection,
   BusinessCostFormSection,
   BusinessScaleFormSection,
-  ChecklistFormSection,
   ContactInfoFormSection,
-  isFormChecklistComplete,
   isFormEsntlAtchComplete,
   PrivacyConsentSection,
   ProgressStatusSection,
@@ -154,11 +152,6 @@ function InstlFormPage({ mode, initialData, createDefaults }: InstlFormPageProps
       return;
     }
 
-    if (!isFormChecklistComplete(data.cklstResultList)) {
-      alert("모든 체크리스트 항목을 체크해야 신청이 가능합니다.");
-      return;
-    }
-
     if (!isFormEsntlAtchComplete(essentialFiles, data.esntlAtchFileList)) {
       alert("필수 첨부파일을 모두 등록해야 신청이 가능합니다.");
       return;
@@ -228,7 +221,6 @@ function InstlFormPage({ mode, initialData, createDefaults }: InstlFormPageProps
             <PrivacyConsentSection />
             <BusinessScaleFormSection />
             <BusinessCostFormSection />
-            <ChecklistFormSection docSeComCd="INSTL" fieldPrefix="instlSncnMng" />
             <AttachmentsFormSection
               docSeComCd="INSTL"
               fieldPrefix="instlSncnMng"

apps/as/src/pages/instl-sncn/ui/instl-view-page.tsx

@@ -1,149 +1,141 @@
-"use client";
-
-import { useMemo, useRef } from "react";
-
-import { useUserStore } from "@/shared/lib";
-import { SectionCollapsibleGroup, SectionCollapsibleToggle } from "@/shared/ui";
-import { ElaprDocPrgrsStatus } from "@/entities/elapr";
-import { useInstlSncnDetail } from "@/entities/instl-sncn";
-import { useRvwMnpwMngLoginUserList } from "@/entities/rvw-mnpw";
-import {
-  AttachmentsViewSection,
-  ProgressStatusSection,
-  SupplementDemandSection,
-} from "@/widgets/pbadms-sprt";
-import { Skeleton } from "@common/components";
-
-import { needsRoleUser01AtrzResolve } from "../lib/button-config";
-import { getEditableReviewStep } from "../lib/review-step-utils";
-import { EMPTY_CKLST_RESULT_LIST, useChecklistFormState } from "../lib/use-checklist-form-state";
-import { PROGRESS_STATUS_COLUMNS } from "../model/columns";
-
-import { FloatingActionButtons } from "./components/floating-action-buttons";
-import { BasicInfoSection } from "./sections/basic-info-section";
-import { BusinessCostSection } from "./sections/business-cost-section";
-import { BusinessScaleSection } from "./sections/business-scale-section";
-import { ChecklistSection } from "./sections/checklist-section";
-import { ContactInfoSection } from "./sections/contact-info-section";
-import {
-  TechReviewOpinionSection,
-  type TechReviewOpinionSectionHandle,
-} from "./sections/tech-review-opinion-section";
-
-interface InstlViewPageProps {
-  id: string;
-}
-
-function InstlViewPage({ id }: InstlViewPageProps) {
-  const userInfo = useUserStore((state) => state.userInfo);
-  const techReviewOpinionRef = useRef<TechReviewOpinionSectionHandle>(null);
-  const { data, isLoading, isError } = useInstlSncnDetail(id);
-  const { formState: checklistFormState, setFormState: setChecklistFormState } =
-    useChecklistFormState(data?.cklstResultList ?? EMPTY_CKLST_RESULT_LIST);
-
-  const prgrsSttsComCd = data?.detDto?.prgrsSttsComCd || "";
-  const needsAtrzResolve = needsRoleUser01AtrzResolve(userInfo?.dtlInstCd, prgrsSttsComCd);
-  const { data: rvwLoginUserData, isLoading: isRvwLoginUserLoading } = useRvwMnpwMngLoginUserList(
-    {},
-    { enabled: needsAtrzResolve },
-  );
-  const atrzSeComCdList = useMemo(
-    () => rvwLoginUserData?.content?.map((item) => item.atrzSeComCd) ?? [],
-    [rvwLoginUserData],
-  );
-
-  if (isLoading) {
-    return (
-      <div className="mt-6 flex flex-col gap-4 px-6">
-        <div className="flex flex-col gap-2">
-          <Skeleton className="h-[4rem] rounded-xl" />
-          <Skeleton className="h-[16rem] rounded-xl" />
-        </div>
-        <div className="flex flex-col gap-2">
-          <Skeleton className="h-[4rem] rounded-xl" />
-          <Skeleton className="h-[16rem] rounded-xl" />
-        </div>
-        <div className="flex flex-col gap-2">
-          <Skeleton className="h-[4rem] rounded-xl" />
-          <Skeleton className="h-[32rem] rounded-xl" />
-        </div>
-      </div>
-    );
-  }
-
-  if (isError || !data) {
-    return <div className="mt-6 text-[1.4rem]">상세 정보를 찾을 수 없습니다.</div>;
-  }
-
-  const {
-    detDto,
-    bizSclList,
-    bizCstList,
-    cklstResultList = [],
-    esntlFileList,
-    etcFileList,
-    rvwList = [],
-    splmntDmndList = [],
-    sttsChgHstryList = [],
-  } = data;
-
-  const editableReviewStep = getEditableReviewStep(
-    userInfo?.dtlInstCd,
-    detDto.prgrsSttsComCd || "",
-  );
-
-  return (
-    <div className="mt-4">
-      <SectionCollapsibleGroup>
-        <div className="sticky top-[6rem] z-30 bg-container px-4 py-2">
-          <SectionCollapsibleToggle />
-        </div>
-        <div className="space-y-4">
-          <ProgressStatusSection
-            columns={PROGRESS_STATUS_COLUMNS}
-            sttsChgHstryList={sttsChgHstryList}
-            elaprDocNo={detDto.instlSncnDocNo}
-          />
-          <BasicInfoSection det={detDto} />
-          <ContactInfoSection det={detDto} />
-          <ElaprDocPrgrsStatus elaprDocNo={detDto.instlSncnDocNo} />
-          <BusinessScaleSection bizSclList={bizSclList} />
-          <BusinessCostSection bizCstList={bizCstList} />
-          <ChecklistSection
-            cklstResultList={cklstResultList}
-            prgrsSttsComCd={detDto.prgrsSttsComCd || ""}
-            userRoleCode={userInfo?.dtlInstCd}
-            formState={checklistFormState}
-            setFormState={setChecklistFormState}
-          />
-          <AttachmentsViewSection
-            esntlFileList={esntlFileList ?? []}
-            etcFileList={etcFileList ?? []}
-          />
-          <TechReviewOpinionSection
-            ref={techReviewOpinionRef}
-            rvwList={rvwList}
-            editableReviewStep={editableReviewStep}
-            atrzSeComCdList={atrzSeComCdList}
-            isAtrzLoading={needsAtrzResolve && isRvwLoginUserLoading}
-          />
-          <SupplementDemandSection splmntDmndList={splmntDmndList} />
-          <FloatingActionButtons
-            data={data}
-            docSeComCd="INSTL"
-            instlSncnDocNo={detDto.instlSncnDocNo}
-            prgrsSttsComCd={detDto.prgrsSttsComCd || ""}
-            dtlInstCd={userInfo?.dtlInstCd}
-            atrzSeComCdList={atrzSeComCdList}
-            isRvwLoginUserLoading={needsAtrzResolve && isRvwLoginUserLoading}
-            checklistFormState={checklistFormState}
-            techReviewOpinionRef={techReviewOpinionRef}
-            opnrNm={userInfo?.userName}
-          />
-        </div>
-      </SectionCollapsibleGroup>
-    </div>
-  );
-}
-
-export { InstlViewPage };
+"use client";
+
+import { useMemo, useRef } from "react";
+
+import { useUserStore } from "@/shared/lib";
+import { SectionCollapsibleGroup, SectionCollapsibleToggle } from "@/shared/ui";
+import { ElaprDocPrgrsStatus } from "@/entities/elapr";
+import { useInstlSncnDetail } from "@/entities/instl-sncn";
+import { useRvwMnpwMngLoginUserList } from "@/entities/rvw-mnpw";
+import {
+  AttachmentsViewSection,
+  ProgressStatusSection,
+  SupplementDemandSection,
+} from "@/widgets/pbadms-sprt";
+import { Skeleton } from "@common/components";
+
+import { needsRoleUser01AtrzResolve } from "../lib/button-config";
+import { getEditableReviewStep } from "../lib/review-step-utils";
+import { EMPTY_CKLST_RESULT_LIST, useChecklistFormState } from "../lib/use-checklist-form-state";
+import { PROGRESS_STATUS_COLUMNS } from "../model/columns";
+
+import { FloatingActionButtons } from "./components/floating-action-buttons";
+import { BasicInfoSection } from "./sections/basic-info-section";
+import { BusinessCostSection } from "./sections/business-cost-section";
+import { BusinessScaleSection } from "./sections/business-scale-section";
+import { ContactInfoSection } from "./sections/contact-info-section";
+import {
+  TechReviewOpinionSection,
+  type TechReviewOpinionSectionHandle,
+} from "./sections/tech-review-opinion-section";
+
+interface InstlViewPageProps {
+  id: string;
+}
+
+function InstlViewPage({ id }: InstlViewPageProps) {
+  const userInfo = useUserStore((state) => state.userInfo);
+  const techReviewOpinionRef = useRef<TechReviewOpinionSectionHandle>(null);
+  const { data, isLoading, isError } = useInstlSncnDetail(id);
+  const { formState: checklistFormState } = useChecklistFormState(
+    data?.cklstResultList ?? EMPTY_CKLST_RESULT_LIST,
+  );
+
+  const prgrsSttsComCd = data?.detDto?.prgrsSttsComCd || "";
+  const needsAtrzResolve = needsRoleUser01AtrzResolve(userInfo?.dtlInstCd, prgrsSttsComCd);
+  const { data: rvwLoginUserData, isLoading: isRvwLoginUserLoading } = useRvwMnpwMngLoginUserList(
+    {},
+    { enabled: needsAtrzResolve },
+  );
+  const atrzSeComCdList = useMemo(
+    () => rvwLoginUserData?.content?.map((item) => item.atrzSeComCd) ?? [],
+    [rvwLoginUserData],
+  );
+
+  if (isLoading) {
+    return (
+      <div className="mt-6 flex flex-col gap-4 px-6">
+        <div className="flex flex-col gap-2">
+          <Skeleton className="h-[4rem] rounded-xl" />
+          <Skeleton className="h-[16rem] rounded-xl" />
+        </div>
+        <div className="flex flex-col gap-2">
+          <Skeleton className="h-[4rem] rounded-xl" />
+          <Skeleton className="h-[16rem] rounded-xl" />
+        </div>
+        <div className="flex flex-col gap-2">
+          <Skeleton className="h-[4rem] rounded-xl" />
+          <Skeleton className="h-[32rem] rounded-xl" />
+        </div>
+      </div>
+    );
+  }
+
+  if (isError || !data) {
+    return <div className="mt-6 text-[1.4rem]">상세 정보를 찾을 수 없습니다.</div>;
+  }
+
+  const {
+    detDto,
+    bizSclList,
+    bizCstList,
+    esntlFileList,
+    etcFileList,
+    rvwList = [],
+    splmntDmndList = [],
+    sttsChgHstryList = [],
+  } = data;
+
+  const editableReviewStep = getEditableReviewStep(
+    userInfo?.dtlInstCd,
+    detDto.prgrsSttsComCd || "",
+  );
+
+  return (
+    <div className="mt-4">
+      <SectionCollapsibleGroup>
+        <div className="sticky top-[6rem] z-30 bg-container px-4 py-2">
+          <SectionCollapsibleToggle />
+        </div>
+        <div className="space-y-4">
+          <ProgressStatusSection
+            columns={PROGRESS_STATUS_COLUMNS}
+            sttsChgHstryList={sttsChgHstryList}
+            elaprDocNo={detDto.instlSncnDocNo}
+          />
+          <BasicInfoSection det={detDto} />
+          <ContactInfoSection det={detDto} />
+          <ElaprDocPrgrsStatus elaprDocNo={detDto.instlSncnDocNo} />
+          <BusinessScaleSection bizSclList={bizSclList} />
+          <BusinessCostSection bizCstList={bizCstList} />
+          <AttachmentsViewSection
+            esntlFileList={esntlFileList ?? []}
+            etcFileList={etcFileList ?? []}
+          />
+          <TechReviewOpinionSection
+            ref={techReviewOpinionRef}
+            rvwList={rvwList}
+            editableReviewStep={editableReviewStep}
+            atrzSeComCdList={atrzSeComCdList}
+            isAtrzLoading={needsAtrzResolve && isRvwLoginUserLoading}
+          />
+          <SupplementDemandSection splmntDmndList={splmntDmndList} />
+          <FloatingActionButtons
+            data={data}
+            docSeComCd="INSTL"
+            instlSncnDocNo={detDto.instlSncnDocNo}
+            prgrsSttsComCd={detDto.prgrsSttsComCd || ""}
+            dtlInstCd={userInfo?.dtlInstCd}
+            atrzSeComCdList={atrzSeComCdList}
+            isRvwLoginUserLoading={needsAtrzResolve && isRvwLoginUserLoading}
+            checklistFormState={checklistFormState}
+            techReviewOpinionRef={techReviewOpinionRef}
+            opnrNm={userInfo?.userName}
+          />
+        </div>
+      </SectionCollapsibleGroup>
+    </div>
+  );
+}
+
+export { InstlViewPage };

apps/as/src/pages/instl-sncn/ui/sections/tech-review-opinion-section.tsx

@@ -1,350 +1,350 @@
-"use client";
-
-import { forwardRef, useEffect, useImperativeHandle, useState } from "react";
-
-import { dayjs, getDefaultFileKey, useTus } from "@/shared/lib";
-import { TextShimmer } from "@/shared/ui";
-import { SectionCollapsible } from "@/shared/ui";
-import { Field, FieldLabel, FieldSet } from "@/shared/ui/field";
-import { AttachmentDownloadLink, attachService } from "@/entities/attach";
-import type { InstlSncnRvwOpnnResponseDto, ReviewStepCode } from "@/entities/instl-sncn";
-import {
-  Button,
-  RadioGroup,
-  RadioGroupItem,
-  Table,
-  TableBody,
-  TableCell,
-  TableHead,
-  TableHeader,
-  TableRow,
-  Textarea,
-} from "@common/components";
-
-import type { ReviewOpinionFormData } from "../../lib/review-opinion-utils";
-import { REVIEW_STEP_LABELS } from "../../model/view-types";
-
-const RVW_OPNN_FILE_KEY_PREFIX = "rvw-opnn::";
-
-interface TechReviewOpinionSectionProps {
-  rvwList: InstlSncnRvwOpnnResponseDto[];
-  editableReviewStep?: ReviewStepCode;
-  atrzSeComCdList?: string[];
-  isAtrzLoading?: boolean;
-}
-
-export interface TechReviewOpinionSectionHandle {
-  getFormData: () => ReviewOpinionFormData | null;
-  resetForm: () => void;
-}
-
-interface TechReviewOpinionTableProps {
-  items: InstlSncnRvwOpnnResponseDto[];
-}
-
-interface UploadedOpinionFile {
-  fileName: string;
-  fileKey: string;
-  atflId?: string;
-  atflCd?: string;
-}
-
-const EMPTY_FORM_DATA: ReviewOpinionFormData = {
-  rvwRsltCn: "",
-  rvwRsltAnmlyYn: "",
-  atchFileGroupId: "",
-  opnrSeComCd: "",
-};
-
-function createRvwOpnnUploadKey(file: File) {
-  return `${RVW_OPNN_FILE_KEY_PREFIX}${getDefaultFileKey(file)}`;
-}
-
-function hasFormContent(formData: ReviewOpinionFormData) {
-  return Boolean(formData.rvwRsltCn.trim() || formData.rvwRsltAnmlyYn || formData.atchFileGroupId);
-}
-
-const TechReviewOpinionSection = forwardRef<
-  TechReviewOpinionSectionHandle,
-  TechReviewOpinionSectionProps
->(function TechReviewOpinionSection(
-  { rvwList, editableReviewStep, atrzSeComCdList = [], isAtrzLoading = false },
-  ref,
-) {
-  const canWriteKecoOpinion = !isAtrzLoading && atrzSeComCdList.includes("ATRZ02");
-  const [formData, setFormData] = useState<ReviewOpinionFormData>({
-    ...EMPTY_FORM_DATA,
-    opnrSeComCd: editableReviewStep ?? "",
-  });
-  const [uploadedFile, setUploadedFile] = useState<UploadedOpinionFile | null>(null);
-
-  useEffect(() => {
-    setFormData((prev) => ({
-      ...prev,
-      opnrSeComCd: editableReviewStep ?? "",
-    }));
-  }, [editableReviewStep]);
-
-  const { uploadFileAsync, isUploading, uploads } = useTus({
-    onSuccess: (atflCd, atflId, _file, fileKey) => {
-      if (!atflCd || !atflId) return;
-
-      setFormData((prev) => ({ ...prev, atchFileGroupId: atflCd }));
-      setUploadedFile((prev) => (prev?.fileKey === fileKey ? { ...prev, atflCd, atflId } : prev));
-    },
-    onError: (_error, _file, fileKey) => {
-      setUploadedFile((prev) => (prev?.fileKey === fileKey ? null : prev));
-    },
-  });
-
-  useImperativeHandle(
-    ref,
-    () => ({
-      getFormData: () => {
-        if (!editableReviewStep || !hasFormContent(formData)) {
-          return null;
-        }
-        if (editableReviewStep === "KECO" && !canWriteKecoOpinion) {
-          return null;
-        }
-
-        return {
-          ...formData,
-          opnrSeComCd: editableReviewStep,
-        };
-      },
-      resetForm: () => {
-        setFormData({
-          ...EMPTY_FORM_DATA,
-          opnrSeComCd: editableReviewStep ?? "",
-        });
-        setUploadedFile(null);
-      },
-    }),
-    [canWriteKecoOpinion, editableReviewStep, formData],
-  );
-
-  const envRvwList = rvwList.filter((item) => item.opnrSeComCd === "ENV");
-  const kecoRvwList = rvwList.filter((item) => item.opnrSeComCd === "KECO");
-
-  const hasEnvSection = envRvwList.length > 0 || editableReviewStep === "ENV";
-  const hasKecoSection =
-    kecoRvwList.length > 0 || (editableReviewStep === "KECO" && canWriteKecoOpinion);
-
-  if (!hasEnvSection && !hasKecoSection) {
-    return null;
-  }
-
-  async function handleFileUpload(files: FileList | null) {
-    if (!files || files.length === 0) return;
-
-    const file = files[0];
-    const fileKey = createRvwOpnnUploadKey(file);
-    const existingAtflCd = formData.atchFileGroupId;
-
-    setUploadedFile({ fileName: file.name, fileKey });
-
-    try {
-      await uploadFileAsync(file, {
-        fileKey,
-        metadata: existingAtflCd ? { atflCd: existingAtflCd } : undefined,
-      });
-    } catch {
-      // onError callback handles cleanup
-    }
-  }
-
-  async function handleFileRemove() {
-    if (!uploadedFile) return;
-
-    uploads[uploadedFile.fileKey]?.abort();
-
-    if (uploadedFile.atflId) {
-      try {
-        await attachService.deleteAttachmentByAtflId(uploadedFile.atflId);
-      } catch (error) {
-        console.error("검토의견 첨부파일 삭제 실패:", error);
-      }
-    }
-
-    setUploadedFile(null);
-    setFormData((prev) => ({ ...prev, atchFileGroupId: "" }));
-  }
-
-  function renderOpinionForm(reviewStep: ReviewStepCode) {
-    if (editableReviewStep !== reviewStep) return null;
-    if (reviewStep === "KECO" && !canWriteKecoOpinion) return null;
-
-    const uploading = uploadedFile ? (isUploading[uploadedFile.fileKey] ?? false) : false;
-
-    return (
-      <div className="space-y-2">
-        <h4 className="text-xl font-semibold">검토의견 작성</h4>
-        <Table caption="검토의견 작성으로 의견내용, 검토결과, 첨부파일 정보 제공" variant="secondary">
-          <TableHeader>
-            <TableRow>
-              <TableHead scope="row" className="w-[12rem]">의견내용</TableHead>
-              <TableCell>
-                <Textarea
-                  value={formData.rvwRsltCn}
-                  onChange={(event) =>
-                    setFormData((prev) => ({ ...prev, rvwRsltCn: event.target.value }))
-                  }
-                  placeholder="의견내용을 입력하세요"
-                  rows={4}
-                  className="min-h-[8rem] !text-xl"
-                />
-              </TableCell>
-            </TableRow>
-            <TableRow>
-              <TableHead scope="row">검토결과</TableHead>
-              <TableCell>
-                <FieldSet>
-                  <RadioGroup
-                    value={formData.rvwRsltAnmlyYn}
-                    onValueChange={(value) =>
-                      setFormData((prev) => ({
-                        ...prev,
-                        rvwRsltAnmlyYn: value as ReviewOpinionFormData["rvwRsltAnmlyYn"],
-                      }))
-                    }
-                  >
-                    <div className="flex flex-wrap gap-4">
-                      <FieldLabel
-                        htmlFor={`rvw-opnn-normal-${reviewStep}`}
-                        className="!w-auto border-none"
-                      >
-                        <Field orientation="horizontal" className="w-auto">
-                          <RadioGroupItem value="N" id={`rvw-opnn-normal-${reviewStep}`} />
-                          <span className="font-normal">정상</span>
-                        </Field>
-                      </FieldLabel>
-                      <FieldLabel
-                        htmlFor={`rvw-opnn-abnormal-${reviewStep}`}
-                        className="!w-auto border-none"
-                      >
-                        <Field orientation="horizontal" className="w-auto">
-                          <RadioGroupItem value="Y" id={`rvw-opnn-abnormal-${reviewStep}`} />
-                          <span className="font-normal">이상</span>
-                        </Field>
-                      </FieldLabel>
-                    </div>
-                  </RadioGroup>
-                </FieldSet>
-              </TableCell>
-            </TableRow>
-            <TableRow>
-              <TableHead scope="row">첨부파일</TableHead>
-              <TableCell>
-                {uploadedFile ? (
-                  <div className="flex items-center gap-2">
-                    <TextShimmer className="text-xl" active={uploading}>
-                      {uploadedFile.fileName}
-                    </TextShimmer>
-                    <Button
-                      size="icon"
-                      onClick={(e) => {
-                        e.preventDefault();
-                        void handleFileRemove();
-                      }}
-                      disabled={uploading}
-                      className="size-8 !bg-destructive"
-                    >
-                      <i className="diveicon di-x text-xs" aria-label="삭제" />
-                    </Button>
-                  </div>
-                ) : (
-                  <label>
-                    <input
-                      type="file"
-                      className="hidden"
-                      onChange={(event) => {
-                        void handleFileUpload(event.target.files);
-                        event.target.value = "";
-                      }}
-                    />
-                    <Button size="sm" variant="outline" type="button" asChild>
-                      <span>파일 선택</span>
-                    </Button>
-                  </label>
-                )}
-              </TableCell>
-            </TableRow>
-          </TableHeader>
-        </Table>
-      </div>
-    );
-  }
-
-  return (
-    <>
-      {hasEnvSection ? (
-        <SectionCollapsible title={`${REVIEW_STEP_LABELS.ENV} 검토의견`}>
-          <div className="space-y-6">
-            {envRvwList.length > 0 ? <TechReviewOpinionTable items={envRvwList} /> : null}
-            {renderOpinionForm("ENV")}
-          </div>
-        </SectionCollapsible>
-      ) : null}
-      {hasKecoSection ? (
-        <SectionCollapsible title={`${REVIEW_STEP_LABELS.KECO} 검토의견`}>
-          <div className="space-y-6">
-            {kecoRvwList.length > 0 ? <TechReviewOpinionTable items={kecoRvwList} /> : null}
-            {renderOpinionForm("KECO")}
-          </div>
-        </SectionCollapsible>
-      ) : null}
-    </>
-  );
-});
-
-function TechReviewOpinionTable({ items }: TechReviewOpinionTableProps) {
-  return (
-    <div className="overflow-x-auto">
-      <Table caption="검토의견 목록으로 의견자명, 의견내용, 검토결과, 첨부파일, 등록일시 정보 제공" variant="secondary">
-        <colgroup>
-          <col width="10%" />
-          <col width="55%" />
-          <col width="5%" />
-          <col width="20%" />
-          <col width="10%" />
-        </colgroup>
-        <TableHeader>
-          <TableRow>
-            <TableHead>의견자명</TableHead>
-            <TableHead>의견내용</TableHead>
-            <TableHead>검토결과</TableHead>
-            <TableHead>첨부파일</TableHead>
-            <TableHead>등록일시</TableHead>
-          </TableRow>
-        </TableHeader>
-        <TableBody>
-          {items.map((item) => (
-            <TableRow key={`${item.instlSncnDocNo}_${item.rvwOpnnSn}`}>
-              <TableCell align="center">{item.opnrNm}</TableCell>
-              <TableCell align="left">{item.rvwRsltCn || "-"}</TableCell>
-              <TableCell align="center">
-                {item.rvwRsltAnmlyYn === "Y" ? "이상" : item.rvwRsltAnmlyYn === "N" ? "정상" : "-"}
-              </TableCell>
-              <TableCell align="center">
-                {item.atchFileInfo?.atflCd ? (
-                  <AttachmentDownloadLink
-                    atflCd={item.atchFileInfo.atflCd}
-                    fileName={item.atchFileInfo.orgnlFileNm || "다운로드"}
-                  />
-                ) : (
-                  "-"
-                )}
-              </TableCell>
-              <TableCell align="center">
-                {item.regDt ? dayjs(item.regDt).format("YYYY-MM-DD HH:mm:ss") : "-"}
-              </TableCell>
-            </TableRow>
-          ))}
-        </TableBody>
-      </Table>
-    </div>
-  );
-}
-
-export { TechReviewOpinionSection };
+"use client";
+
+import { forwardRef, useEffect, useImperativeHandle, useState } from "react";
+
+import { useQueryClient } from "@tanstack/react-query";
+
+import { getDefaultFileKey, useTus, useUserStore } from "@/shared/lib";
+import { TextShimmer } from "@/shared/ui";
+import { SectionCollapsible } from "@/shared/ui";
+import { Field, FieldLabel, FieldSet } from "@/shared/ui/field";
+import { attachService } from "@/entities/attach";
+import {
+  instlSncnKeys,
+  type InstlSncnRvwOpnnResponseDto,
+  instlSncnRvwOpnnService,
+  type ReviewStepCode,
+} from "@/entities/instl-sncn";
+import { RvwOpnnListTable } from "@/widgets/pbadms-sprt";
+import {
+  Button,
+  RadioGroup,
+  RadioGroupItem,
+  Table,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+  Textarea,
+} from "@common/components";
+
+import type { ReviewOpinionFormData } from "../../lib/review-opinion-utils";
+import { REVIEW_STEP_LABELS } from "../../model/view-types";
+
+const RVW_OPNN_FILE_KEY_PREFIX = "rvw-opnn::";
+
+interface TechReviewOpinionSectionProps {
+  rvwList: InstlSncnRvwOpnnResponseDto[];
+  editableReviewStep?: ReviewStepCode;
+  atrzSeComCdList?: string[];
+  isAtrzLoading?: boolean;
+}
+
+export interface TechReviewOpinionSectionHandle {
+  getFormData: () => ReviewOpinionFormData | null;
+  resetForm: () => void;
+}
+
+interface TechReviewOpinionTableProps {
+  items: InstlSncnRvwOpnnResponseDto[];
+}
+
+interface UploadedOpinionFile {
+  fileName: string;
+  fileKey: string;
+  atflId?: string;
+  atflCd?: string;
+}
+
+const EMPTY_FORM_DATA: ReviewOpinionFormData = {
+  rvwRsltCn: "",
+  rvwRsltAnmlyYn: "",
+  atchFileGroupId: "",
+  opnrSeComCd: "",
+};
+
+function createRvwOpnnUploadKey(file: File) {
+  return `${RVW_OPNN_FILE_KEY_PREFIX}${getDefaultFileKey(file)}`;
+}
+
+function hasFormContent(formData: ReviewOpinionFormData) {
+  return Boolean(formData.rvwRsltCn.trim() || formData.rvwRsltAnmlyYn || formData.atchFileGroupId);
+}
+
+const TechReviewOpinionSection = forwardRef<
+  TechReviewOpinionSectionHandle,
+  TechReviewOpinionSectionProps
+>(function TechReviewOpinionSection(
+  { rvwList, editableReviewStep, atrzSeComCdList = [], isAtrzLoading = false },
+  ref,
+) {
+  const canWriteKecoOpinion = !isAtrzLoading && atrzSeComCdList.includes("ATRZ02");
+  const [formData, setFormData] = useState<ReviewOpinionFormData>({
+    ...EMPTY_FORM_DATA,
+    opnrSeComCd: editableReviewStep ?? "",
+  });
+  const [uploadedFile, setUploadedFile] = useState<UploadedOpinionFile | null>(null);
+
+  useEffect(() => {
+    setFormData((prev) => ({
+      ...prev,
+      opnrSeComCd: editableReviewStep ?? "",
+    }));
+  }, [editableReviewStep]);
+
+  const { uploadFileAsync, isUploading, uploads } = useTus({
+    onSuccess: (atflCd, atflId, _file, fileKey) => {
+      if (!atflCd || !atflId) return;
+
+      setFormData((prev) => ({ ...prev, atchFileGroupId: atflCd }));
+      setUploadedFile((prev) => (prev?.fileKey === fileKey ? { ...prev, atflCd, atflId } : prev));
+    },
+    onError: (_error, _file, fileKey) => {
+      setUploadedFile((prev) => (prev?.fileKey === fileKey ? null : prev));
+    },
+  });
+
+  useImperativeHandle(
+    ref,
+    () => ({
+      getFormData: () => {
+        if (!editableReviewStep || !hasFormContent(formData)) {
+          return null;
+        }
+        if (editableReviewStep === "KECO" && !canWriteKecoOpinion) {
+          return null;
+        }
+
+        return {
+          ...formData,
+          opnrSeComCd: editableReviewStep,
+        };
+      },
+      resetForm: () => {
+        setFormData({
+          ...EMPTY_FORM_DATA,
+          opnrSeComCd: editableReviewStep ?? "",
+        });
+        setUploadedFile(null);
+      },
+    }),
+    [canWriteKecoOpinion, editableReviewStep, formData],
+  );
+
+  const envRvwList = rvwList.filter((item) => item.opnrSeComCd === "ENV");
+  const kecoRvwList = rvwList.filter((item) => item.opnrSeComCd === "KECO");
+
+  const hasEnvSection = envRvwList.length > 0 || editableReviewStep === "ENV";
+  const hasKecoSection =
+    kecoRvwList.length > 0 || (editableReviewStep === "KECO" && canWriteKecoOpinion);
+
+  if (!hasEnvSection && !hasKecoSection) {
+    return null;
+  }
+
+  async function handleFileUpload(files: FileList | null) {
+    if (!files || files.length === 0) return;
+
+    const file = files[0];
+    const fileKey = createRvwOpnnUploadKey(file);
+    const existingAtflCd = formData.atchFileGroupId;
+
+    setUploadedFile({ fileName: file.name, fileKey });
+
+    try {
+      await uploadFileAsync(file, {
+        fileKey,
+        metadata: existingAtflCd ? { atflCd: existingAtflCd } : undefined,
+      });
+    } catch {
+      // onError callback handles cleanup
+    }
+  }
+
+  async function handleFileRemove() {
+    if (!uploadedFile) return;
+
+    uploads[uploadedFile.fileKey]?.abort();
+
+    if (uploadedFile.atflId) {
+      try {
+        await attachService.deleteAttachmentByAtflId(uploadedFile.atflId);
+      } catch (error) {
+        console.error("검토의견 첨부파일 삭제 실패:", error);
+      }
+    }
+
+    setUploadedFile(null);
+    setFormData((prev) => ({ ...prev, atchFileGroupId: "" }));
+  }
+
+  function isReviewTurn(reviewStep: ReviewStepCode) {
+    if (editableReviewStep !== reviewStep) return false;
+    if (reviewStep === "KECO" && !canWriteKecoOpinion) return false;
+    return true;
+  }
+
+  function renderOpinionForm(reviewStep: ReviewStepCode) {
+    if (!isReviewTurn(reviewStep)) return null;
+
+    const uploading = uploadedFile ? (isUploading[uploadedFile.fileKey] ?? false) : false;
+
+    return (
+      <div className="space-y-2">
+        <h4 className="text-xl font-semibold">검토의견 작성</h4>
+        <Table
+          caption="검토의견 작성으로 의견내용, 검토결과, 첨부파일 정보 제공"
+          variant="secondary"
+        >
+          <TableHeader>
+            <TableRow>
+              <TableHead scope="row" className="w-[12rem]">
+                의견내용
+              </TableHead>
+              <TableCell>
+                <Textarea
+                  value={formData.rvwRsltCn}
+                  onChange={(event) =>
+                    setFormData((prev) => ({ ...prev, rvwRsltCn: event.target.value }))
+                  }
+                  placeholder="의견내용을 입력하세요"
+                  rows={4}
+                  className="min-h-[8rem] !text-xl"
+                />
+              </TableCell>
+            </TableRow>
+            <TableRow>
+              <TableHead scope="row">검토결과</TableHead>
+              <TableCell>
+                <FieldSet>
+                  <RadioGroup
+                    value={formData.rvwRsltAnmlyYn}
+                    onValueChange={(value) =>
+                      setFormData((prev) => ({
+                        ...prev,
+                        rvwRsltAnmlyYn: value as ReviewOpinionFormData["rvwRsltAnmlyYn"],
+                      }))
+                    }
+                  >
+                    <div className="flex flex-wrap gap-4">
+                      <FieldLabel
+                        htmlFor={`rvw-opnn-normal-${reviewStep}`}
+                        className="!w-auto border-none"
+                      >
+                        <Field orientation="horizontal" className="w-auto">
+                          <RadioGroupItem value="N" id={`rvw-opnn-normal-${reviewStep}`} />
+                          <span className="font-normal">정상</span>
+                        </Field>
+                      </FieldLabel>
+                      <FieldLabel
+                        htmlFor={`rvw-opnn-abnormal-${reviewStep}`}
+                        className="!w-auto border-none"
+                      >
+                        <Field orientation="horizontal" className="w-auto">
+                          <RadioGroupItem value="Y" id={`rvw-opnn-abnormal-${reviewStep}`} />
+                          <span className="font-normal">이상</span>
+                        </Field>
+                      </FieldLabel>
+                    </div>
+                  </RadioGroup>
+                </FieldSet>
+              </TableCell>
+            </TableRow>
+            <TableRow>
+              <TableHead scope="row">첨부파일</TableHead>
+              <TableCell>
+                {uploadedFile ? (
+                  <div className="flex items-center gap-2">
+                    <TextShimmer className="text-xl" active={uploading}>
+                      {uploadedFile.fileName}
+                    </TextShimmer>
+                    <Button
+                      size="icon"
+                      onClick={(e) => {
+                        e.preventDefault();
+                        void handleFileRemove();
+                      }}
+                      disabled={uploading}
+                      className="size-8 !bg-destructive"
+                    >
+                      <i className="diveicon di-x text-xs" aria-label="삭제" />
+                    </Button>
+                  </div>
+                ) : (
+                  <label>
+                    <input
+                      type="file"
+                      className="hidden"
+                      onChange={(event) => {
+                        void handleFileUpload(event.target.files);
+                        event.target.value = "";
+                      }}
+                    />
+                    <Button size="sm" variant="outline" type="button" asChild>
+                      <span>파일 선택</span>
+                    </Button>
+                  </label>
+                )}
+              </TableCell>
+            </TableRow>
+          </TableHeader>
+        </Table>
+      </div>
+    );
+  }
+
+  return (
+    <>
+      {hasEnvSection ? (
+        <SectionCollapsible title={`${REVIEW_STEP_LABELS.ENV} 검토의견`}>
+          <div className="space-y-6">
+            {envRvwList.length > 0 ? (
+              <TechReviewOpinionTable items={envRvwList} />
+            ) : null}
+            {renderOpinionForm("ENV")}
+          </div>
+        </SectionCollapsible>
+      ) : null}
+      {hasKecoSection ? (
+        <SectionCollapsible title={`${REVIEW_STEP_LABELS.KECO} 검토의견`}>
+          <div className="space-y-6">
+            {kecoRvwList.length > 0 ? (
+              <TechReviewOpinionTable items={kecoRvwList} />
+            ) : null}
+            {renderOpinionForm("KECO")}
+          </div>
+        </SectionCollapsible>
+      ) : null}
+    </>
+  );
+});
+
+function getRvwOpnnIds(item: InstlSncnRvwOpnnResponseDto) {
+  if (!item.instlSncnDocNo || item.rvwOpnnSn == null) {
+    throw new Error("검토의견 식별값이 없습니다.");
+  }
+  return [item.instlSncnDocNo, item.rvwOpnnSn] as const;
+}
+
+function TechReviewOpinionTable({ items }: TechReviewOpinionTableProps) {
+  const queryClient = useQueryClient();
+  const currentUserUuid = useUserStore((state) => state.userInfo?.userUnqId);
+
+  return (
+    <RvwOpnnListTable
+      items={items}
+      getRowKey={(item) => `${item.instlSncnDocNo}_${item.rvwOpnnSn}`}
+      currentUserUuid={currentUserUuid}
+      onUpdate={async (item, body) => {
+        await instlSncnRvwOpnnService.update(...getRvwOpnnIds(item), body);
+        await queryClient.invalidateQueries({ queryKey: instlSncnKeys.all });
+      }}
+      onDelete={async (item) => {
+        await instlSncnRvwOpnnService.delete(...getRvwOpnnIds(item));
+        await queryClient.invalidateQueries({ queryKey: instlSncnKeys.all });
+      }}
+    />
+  );
+}
+
+export { TechReviewOpinionSection };

apps/as/src/pages/sewer-bsc-plan/ui/sections/tech-review-opinion-section.tsx

@@ -1,357 +1,354 @@
-"use client";
-
-import { forwardRef, useEffect, useImperativeHandle, useState } from "react";
-
-import { dayjs, getDefaultFileKey, useTus } from "@/shared/lib";
-import { TextShimmer } from "@/shared/ui";
-import { SectionCollapsible } from "@/shared/ui";
-import { Field, FieldLabel, FieldSet } from "@/shared/ui/field";
-import { AttachmentDownloadLink, attachService } from "@/entities/attach";
-import type { SewerBscPlanRvwOpnnResponseDto } from "@/entities/sewer-bsc-plan";
-import {
-  Button,
-  RadioGroup,
-  RadioGroupItem,
-  Table,
-  TableBody,
-  TableCell,
-  TableHead,
-  TableHeader,
-  TableRow,
-  Textarea,
-} from "@common/components";
-
-import type {
-  ReviewOpinionFormData,
-  ReviewOpinionGetFormDataResult,
-} from "../../lib/review-opinion-utils";
-import type { ReviewStepCode } from "../../model/view-types";
-import { REVIEW_STEP_LABELS } from "../../model/view-types";
-
-const RVW_OPNN_FILE_KEY_PREFIX = "rvw-opnn::";
-
-interface TechReviewOpinionSectionProps {
-  rvwList: SewerBscPlanRvwOpnnResponseDto[];
-  editableReviewStep?: ReviewStepCode;
-  atrzSeComCdList?: string[];
-  isAtrzLoading?: boolean;
-}
-
-export interface TechReviewOpinionSectionHandle {
-  getFormData: () => ReviewOpinionGetFormDataResult | null;
-  resetForm: () => void;
-}
-
-interface TechReviewOpinionTableProps {
-  items: SewerBscPlanRvwOpnnResponseDto[];
-}
-
-interface UploadedOpinionFile {
-  fileName: string;
-  fileKey: string;
-  atflId?: string;
-  atflCd?: string;
-}
-
-const EMPTY_FORM_DATA: ReviewOpinionFormData = {
-  rvwRsltCn: "",
-  rvwRsltAnmlyYn: "",
-  atchFileGroupId: "",
-  opnrSeComCd: "",
-};
-
-function createRvwOpnnUploadKey(file: File) {
-  return `${RVW_OPNN_FILE_KEY_PREFIX}${getDefaultFileKey(file)}`;
-}
-
-function hasFormContent(formData: ReviewOpinionFormData) {
-  return Boolean(formData.rvwRsltCn.trim() || formData.rvwRsltAnmlyYn || formData.atchFileGroupId);
-}
-
-const TechReviewOpinionSection = forwardRef<
-  TechReviewOpinionSectionHandle,
-  TechReviewOpinionSectionProps
->(function TechReviewOpinionSection(
-  { rvwList, editableReviewStep, atrzSeComCdList = [], isAtrzLoading = false },
-  ref,
-) {
-  const canWriteKecoOpinion = !isAtrzLoading && atrzSeComCdList.includes("ATRZ02");
-  const [formData, setFormData] = useState<ReviewOpinionFormData>({
-    ...EMPTY_FORM_DATA,
-    opnrSeComCd: editableReviewStep ?? "",
-  });
-  const [uploadedFile, setUploadedFile] = useState<UploadedOpinionFile | null>(null);
-
-  useEffect(() => {
-    setFormData((prev) => ({
-      ...prev,
-      opnrSeComCd: editableReviewStep ?? "",
-    }));
-  }, [editableReviewStep]);
-
-  const { uploadFileAsync, isUploading, uploads } = useTus({
-    onSuccess: (atflCd, atflId, _file, fileKey) => {
-      if (!atflCd || !atflId) return;
-
-      setFormData((prev) => ({ ...prev, atchFileGroupId: atflCd }));
-      setUploadedFile((prev) => (prev?.fileKey === fileKey ? { ...prev, atflCd, atflId } : prev));
-    },
-    onError: (_error, _file, fileKey) => {
-      setUploadedFile((prev) => (prev?.fileKey === fileKey ? null : prev));
-    },
-  });
-
-  useImperativeHandle(
-    ref,
-    () => ({
-      getFormData: () => {
-        if (!editableReviewStep || !hasFormContent(formData)) {
-          return null;
-        }
-        if (editableReviewStep === "KECO" && !canWriteKecoOpinion) {
-          return null;
-        }
-
-        return {
-          formData: {
-            ...formData,
-            opnrSeComCd: editableReviewStep,
-          },
-          rvwList,
-        };
-      },
-      resetForm: () => {
-        setFormData({
-          ...EMPTY_FORM_DATA,
-          opnrSeComCd: editableReviewStep ?? "",
-        });
-        setUploadedFile(null);
-      },
-    }),
-    [canWriteKecoOpinion, editableReviewStep, formData, rvwList],
-  );
-
-  const envRvwList = rvwList.filter((item) => item.opnrSeComCd === "ENV");
-  const kecoRvwList = rvwList.filter((item) => item.opnrSeComCd === "KECO");
-
-  const hasEnvSection = envRvwList.length > 0 || editableReviewStep === "ENV";
-  const hasKecoSection =
-    kecoRvwList.length > 0 || (editableReviewStep === "KECO" && canWriteKecoOpinion);
-
-  if (!hasEnvSection && !hasKecoSection) {
-    return null;
-  }
-
-  async function handleFileUpload(files: FileList | null) {
-    if (!files || files.length === 0) return;
-
-    const file = files[0];
-    const fileKey = createRvwOpnnUploadKey(file);
-    const existingAtflCd = formData.atchFileGroupId;
-
-    setUploadedFile({ fileName: file.name, fileKey });
-
-    try {
-      await uploadFileAsync(file, {
-        fileKey,
-        metadata: existingAtflCd ? { atflCd: existingAtflCd } : undefined,
-      });
-    } catch {
-      // onError callback handles cleanup
-    }
-  }
-
-  async function handleFileRemove() {
-    if (!uploadedFile) return;
-
-    uploads[uploadedFile.fileKey]?.abort();
-
-    if (uploadedFile.atflId) {
-      try {
-        await attachService.deleteAttachmentByAtflId(uploadedFile.atflId);
-      } catch (error) {
-        console.error("검토의견 첨부파일 삭제 실패:", error);
-      }
-    }
-
-    setUploadedFile(null);
-    setFormData((prev) => ({ ...prev, atchFileGroupId: "" }));
-  }
-
-  function renderOpinionForm(reviewStep: ReviewStepCode) {
-    if (editableReviewStep !== reviewStep) return null;
-    if (reviewStep === "KECO" && !canWriteKecoOpinion) return null;
-
-    const uploading = uploadedFile ? (isUploading[uploadedFile.fileKey] ?? false) : false;
-
-    return (
-      <div className="space-y-2">
-        <h4 className="text-xl font-semibold">검토의견 작성</h4>
-        <Table caption="검토의견 작성으로 의견내용, 검토결과, 첨부파일 정보 제공" variant="secondary">
-          <TableHeader>
-            <TableRow>
-              <TableHead className="w-[12rem]">의견내용</TableHead>
-              <TableCell>
-                <Textarea
-                  value={formData.rvwRsltCn}
-                  onChange={(event) =>
-                    setFormData((prev) => ({ ...prev, rvwRsltCn: event.target.value }))
-                  }
-                  placeholder="의견내용을 입력하세요"
-                  rows={4}
-                  className="min-h-[8rem] !text-xl"
-                />
-              </TableCell>
-            </TableRow>
-            <TableRow>
-              <TableHead>검토결과</TableHead>
-              <TableCell>
-                <FieldSet>
-                  <RadioGroup
-                    value={formData.rvwRsltAnmlyYn}
-                    onValueChange={(value) =>
-                      setFormData((prev) => ({
-                        ...prev,
-                        rvwRsltAnmlyYn: value as ReviewOpinionFormData["rvwRsltAnmlyYn"],
-                      }))
-                    }
-                  >
-                    <div className="flex flex-wrap gap-4">
-                      <FieldLabel
-                        htmlFor={`rvw-opnn-normal-${reviewStep}`}
-                        className="!w-auto border-none"
-                      >
-                        <Field orientation="horizontal" className="w-auto">
-                          <RadioGroupItem value="N" id={`rvw-opnn-normal-${reviewStep}`} />
-                          <span className="font-normal">정상</span>
-                        </Field>
-                      </FieldLabel>
-                      <FieldLabel
-                        htmlFor={`rvw-opnn-abnormal-${reviewStep}`}
-                        className="!w-auto border-none"
-                      >
-                        <Field orientation="horizontal" className="w-auto">
-                          <RadioGroupItem value="Y" id={`rvw-opnn-abnormal-${reviewStep}`} />
-                          <span className="font-normal">이상</span>
-                        </Field>
-                      </FieldLabel>
-                    </div>
-                  </RadioGroup>
-                </FieldSet>
-              </TableCell>
-            </TableRow>
-            <TableRow>
-              <TableHead>첨부파일</TableHead>
-              <TableCell>
-                {uploadedFile ? (
-                  <div className="flex items-center gap-2">
-                    <TextShimmer className="text-xl" active={uploading}>
-                      {uploadedFile.fileName}
-                    </TextShimmer>
-                    <Button
-                      size="icon"
-                      onClick={(e) => {
-                        e.preventDefault();
-                        void handleFileRemove();
-                      }}
-                      disabled={uploading}
-                      className="size-8 !bg-destructive"
-                    >
-                      <i className="diveicon di-x text-xs" aria-label="삭제" />
-                    </Button>
-                  </div>
-                ) : (
-                  <label>
-                    <input
-                      type="file"
-                      className="hidden"
-                      onChange={(event) => {
-                        void handleFileUpload(event.target.files);
-                        event.target.value = "";
-                      }}
-                    />
-                    <Button size="sm" variant="outline" type="button" asChild>
-                      <span>파일 선택</span>
-                    </Button>
-                  </label>
-                )}
-              </TableCell>
-            </TableRow>
-          </TableHeader>
-        </Table>
-      </div>
-    );
-  }
-
-  return (
-    <>
-      {hasEnvSection ? (
-        <SectionCollapsible title={`${REVIEW_STEP_LABELS.ENV} 검토의견`}>
-          <div className="space-y-6">
-            {envRvwList.length > 0 ? <TechReviewOpinionTable items={envRvwList} /> : null}
-            {renderOpinionForm("ENV")}
-          </div>
-        </SectionCollapsible>
-      ) : null}
-      {hasKecoSection ? (
-        <SectionCollapsible title={`${REVIEW_STEP_LABELS.KECO} 검토의견`}>
-          <div className="space-y-6">
-            {kecoRvwList.length > 0 ? <TechReviewOpinionTable items={kecoRvwList} /> : null}
-            {renderOpinionForm("KECO")}
-          </div>
-        </SectionCollapsible>
-      ) : null}
-    </>
-  );
-});
-
-function TechReviewOpinionTable({ items }: TechReviewOpinionTableProps) {
-  return (
-    <div className="overflow-x-auto">
-      <Table caption="검토의견 목록으로 의견자명, 의견내용, 검토결과, 첨부파일, 등록일시 정보 제공" variant="secondary">
-        <colgroup>
-          <col width="10%" />
-          <col width="55%" />
-          <col width="5%" />
-          <col width="20%" />
-          <col width="10%" />
-        </colgroup>
-        <TableHeader>
-          <TableRow>
-            <TableHead>의견자명</TableHead>
-            <TableHead>의견내용</TableHead>
-            <TableHead>검토결과</TableHead>
-            <TableHead>첨부파일</TableHead>
-            <TableHead>등록일시</TableHead>
-          </TableRow>
-        </TableHeader>
-        <TableBody>
-          {items.map((item) => (
-            <TableRow key={`${item.sewerBscPlanDocNo}_${item.rvwOpnnSn}`}>
-              <TableCell align="center">{item.opnrNm}</TableCell>
-              <TableCell align="left">{item.rvwRsltCn || "-"}</TableCell>
-              <TableCell align="center">
-                {item.rvwRsltAnmlyYn === "Y" ? "이상" : item.rvwRsltAnmlyYn === "N" ? "정상" : "-"}
-              </TableCell>
-              <TableCell align="center">
-                {item.atchFileInfo?.atflCd ? (
-                  <AttachmentDownloadLink
-                    atflCd={item.atchFileInfo.atflCd}
-                    fileName={item.atchFileInfo.orgnlFileNm || "다운로드"}
-                  />
-                ) : (
-                  "-"
-                )}
-              </TableCell>
-              <TableCell align="center">
-                {item.regDt ? dayjs(item.regDt).format("YYYY-MM-DD HH:mm:ss") : "-"}
-              </TableCell>
-            </TableRow>
-          ))}
-        </TableBody>
-      </Table>
-    </div>
-  );
-}
-
-export { TechReviewOpinionSection };
+"use client";
+
+import { forwardRef, useEffect, useImperativeHandle, useState } from "react";
+
+import { useQueryClient } from "@tanstack/react-query";
+
+import { getDefaultFileKey, useTus, useUserStore } from "@/shared/lib";
+import { TextShimmer } from "@/shared/ui";
+import { SectionCollapsible } from "@/shared/ui";
+import { Field, FieldLabel, FieldSet } from "@/shared/ui/field";
+import { attachService } from "@/entities/attach";
+import {
+  sewerBscPlanKeys,
+  type SewerBscPlanRvwOpnnResponseDto,
+  sewerBscPlanRvwOpnnService,
+} from "@/entities/sewer-bsc-plan";
+import { RvwOpnnListTable } from "@/widgets/pbadms-sprt";
+import {
+  Button,
+  RadioGroup,
+  RadioGroupItem,
+  Table,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+  Textarea,
+} from "@common/components";
+
+import type {
+  ReviewOpinionFormData,
+  ReviewOpinionGetFormDataResult,
+} from "../../lib/review-opinion-utils";
+import type { ReviewStepCode } from "../../model/view-types";
+import { REVIEW_STEP_LABELS } from "../../model/view-types";
+
+const RVW_OPNN_FILE_KEY_PREFIX = "rvw-opnn::";
+
+interface TechReviewOpinionSectionProps {
+  rvwList: SewerBscPlanRvwOpnnResponseDto[];
+  editableReviewStep?: ReviewStepCode;
+  atrzSeComCdList?: string[];
+  isAtrzLoading?: boolean;
+}
+
+export interface TechReviewOpinionSectionHandle {
+  getFormData: () => ReviewOpinionGetFormDataResult | null;
+  resetForm: () => void;
+}
+
+interface TechReviewOpinionTableProps {
+  items: SewerBscPlanRvwOpnnResponseDto[];
+}
+
+interface UploadedOpinionFile {
+  fileName: string;
+  fileKey: string;
+  atflId?: string;
+  atflCd?: string;
+}
+
+const EMPTY_FORM_DATA: ReviewOpinionFormData = {
+  rvwRsltCn: "",
+  rvwRsltAnmlyYn: "",
+  atchFileGroupId: "",
+  opnrSeComCd: "",
+};
+
+function createRvwOpnnUploadKey(file: File) {
+  return `${RVW_OPNN_FILE_KEY_PREFIX}${getDefaultFileKey(file)}`;
+}
+
+function hasFormContent(formData: ReviewOpinionFormData) {
+  return Boolean(formData.rvwRsltCn.trim() || formData.rvwRsltAnmlyYn || formData.atchFileGroupId);
+}
+
+const TechReviewOpinionSection = forwardRef<
+  TechReviewOpinionSectionHandle,
+  TechReviewOpinionSectionProps
+>(function TechReviewOpinionSection(
+  { rvwList, editableReviewStep, atrzSeComCdList = [], isAtrzLoading = false },
+  ref,
+) {
+  const canWriteKecoOpinion = !isAtrzLoading && atrzSeComCdList.includes("ATRZ02");
+  const [formData, setFormData] = useState<ReviewOpinionFormData>({
+    ...EMPTY_FORM_DATA,
+    opnrSeComCd: editableReviewStep ?? "",
+  });
+  const [uploadedFile, setUploadedFile] = useState<UploadedOpinionFile | null>(null);
+
+  useEffect(() => {
+    setFormData((prev) => ({
+      ...prev,
+      opnrSeComCd: editableReviewStep ?? "",
+    }));
+  }, [editableReviewStep]);
+
+  const { uploadFileAsync, isUploading, uploads } = useTus({
+    onSuccess: (atflCd, atflId, _file, fileKey) => {
+      if (!atflCd || !atflId) return;
+
+      setFormData((prev) => ({ ...prev, atchFileGroupId: atflCd }));
+      setUploadedFile((prev) => (prev?.fileKey === fileKey ? { ...prev, atflCd, atflId } : prev));
+    },
+    onError: (_error, _file, fileKey) => {
+      setUploadedFile((prev) => (prev?.fileKey === fileKey ? null : prev));
+    },
+  });
+
+  useImperativeHandle(
+    ref,
+    () => ({
+      getFormData: () => {
+        if (!editableReviewStep || !hasFormContent(formData)) {
+          return null;
+        }
+        if (editableReviewStep === "KECO" && !canWriteKecoOpinion) {
+          return null;
+        }
+
+        return {
+          formData: {
+            ...formData,
+            opnrSeComCd: editableReviewStep,
+          },
+          rvwList,
+        };
+      },
+      resetForm: () => {
+        setFormData({
+          ...EMPTY_FORM_DATA,
+          opnrSeComCd: editableReviewStep ?? "",
+        });
+        setUploadedFile(null);
+      },
+    }),
+    [canWriteKecoOpinion, editableReviewStep, formData, rvwList],
+  );
+
+  const envRvwList = rvwList.filter((item) => item.opnrSeComCd === "ENV");
+  const kecoRvwList = rvwList.filter((item) => item.opnrSeComCd === "KECO");
+
+  const hasEnvSection = envRvwList.length > 0 || editableReviewStep === "ENV";
+  const hasKecoSection =
+    kecoRvwList.length > 0 || (editableReviewStep === "KECO" && canWriteKecoOpinion);
+
+  if (!hasEnvSection && !hasKecoSection) {
+    return null;
+  }
+
+  async function handleFileUpload(files: FileList | null) {
+    if (!files || files.length === 0) return;
+
+    const file = files[0];
+    const fileKey = createRvwOpnnUploadKey(file);
+    const existingAtflCd = formData.atchFileGroupId;
+
+    setUploadedFile({ fileName: file.name, fileKey });
+
+    try {
+      await uploadFileAsync(file, {
+        fileKey,
+        metadata: existingAtflCd ? { atflCd: existingAtflCd } : undefined,
+      });
+    } catch {
+      // onError callback handles cleanup
+    }
+  }
+
+  async function handleFileRemove() {
+    if (!uploadedFile) return;
+
+    uploads[uploadedFile.fileKey]?.abort();
+
+    if (uploadedFile.atflId) {
+      try {
+        await attachService.deleteAttachmentByAtflId(uploadedFile.atflId);
+      } catch (error) {
+        console.error("검토의견 첨부파일 삭제 실패:", error);
+      }
+    }
+
+    setUploadedFile(null);
+    setFormData((prev) => ({ ...prev, atchFileGroupId: "" }));
+  }
+
+  function isReviewTurn(reviewStep: ReviewStepCode) {
+    if (editableReviewStep !== reviewStep) return false;
+    if (reviewStep === "KECO" && !canWriteKecoOpinion) return false;
+    return true;
+  }
+
+  function renderOpinionForm(reviewStep: ReviewStepCode) {
+    if (!isReviewTurn(reviewStep)) return null;
+
+    const uploading = uploadedFile ? (isUploading[uploadedFile.fileKey] ?? false) : false;
+
+    return (
+      <div className="space-y-2">
+        <h4 className="text-xl font-semibold">검토의견 작성</h4>
+        <Table
+          caption="검토의견 작성으로 의견내용, 검토결과, 첨부파일 정보 제공"
+          variant="secondary"
+        >
+          <TableHeader>
+            <TableRow>
+              <TableHead className="w-[12rem]">의견내용</TableHead>
+              <TableCell>
+                <Textarea
+                  value={formData.rvwRsltCn}
+                  onChange={(event) =>
+                    setFormData((prev) => ({ ...prev, rvwRsltCn: event.target.value }))
+                  }
+                  placeholder="의견내용을 입력하세요"
+                  rows={4}
+                  className="min-h-[8rem] !text-xl"
+                />
+              </TableCell>
+            </TableRow>
+            <TableRow>
+              <TableHead>검토결과</TableHead>
+              <TableCell>
+                <FieldSet>
+                  <RadioGroup
+                    value={formData.rvwRsltAnmlyYn}
+                    onValueChange={(value) =>
+                      setFormData((prev) => ({
+                        ...prev,
+                        rvwRsltAnmlyYn: value as ReviewOpinionFormData["rvwRsltAnmlyYn"],
+                      }))
+                    }
+                  >
+                    <div className="flex flex-wrap gap-4">
+                      <FieldLabel
+                        htmlFor={`rvw-opnn-normal-${reviewStep}`}
+                        className="!w-auto border-none"
+                      >
+                        <Field orientation="horizontal" className="w-auto">
+                          <RadioGroupItem value="N" id={`rvw-opnn-normal-${reviewStep}`} />
+                          <span className="font-normal">정상</span>
+                        </Field>
+                      </FieldLabel>
+                      <FieldLabel
+                        htmlFor={`rvw-opnn-abnormal-${reviewStep}`}
+                        className="!w-auto border-none"
+                      >
+                        <Field orientation="horizontal" className="w-auto">
+                          <RadioGroupItem value="Y" id={`rvw-opnn-abnormal-${reviewStep}`} />
+                          <span className="font-normal">이상</span>
+                        </Field>
+                      </FieldLabel>
+                    </div>
+                  </RadioGroup>
+                </FieldSet>
+              </TableCell>
+            </TableRow>
+            <TableRow>
+              <TableHead>첨부파일</TableHead>
+              <TableCell>
+                {uploadedFile ? (
+                  <div className="flex items-center gap-2">
+                    <TextShimmer className="text-xl" active={uploading}>
+                      {uploadedFile.fileName}
+                    </TextShimmer>
+                    <Button
+                      size="icon"
+                      onClick={(e) => {
+                        e.preventDefault();
+                        void handleFileRemove();
+                      }}
+                      disabled={uploading}
+                      className="size-8 !bg-destructive"
+                    >
+                      <i className="diveicon di-x text-xs" aria-label="삭제" />
+                    </Button>
+                  </div>
+                ) : (
+                  <label>
+                    <input
+                      type="file"
+                      className="hidden"
+                      onChange={(event) => {
+                        void handleFileUpload(event.target.files);
+                        event.target.value = "";
+                      }}
+                    />
+                    <Button size="sm" variant="outline" type="button" asChild>
+                      <span>파일 선택</span>
+                    </Button>
+                  </label>
+                )}
+              </TableCell>
+            </TableRow>
+          </TableHeader>
+        </Table>
+      </div>
+    );
+  }
+
+  return (
+    <>
+      {hasEnvSection ? (
+        <SectionCollapsible title={`${REVIEW_STEP_LABELS.ENV} 검토의견`}>
+          <div className="space-y-6">
+            {envRvwList.length > 0 ? (
+              <TechReviewOpinionTable items={envRvwList} />
+            ) : null}
+            {renderOpinionForm("ENV")}
+          </div>
+        </SectionCollapsible>
+      ) : null}
+      {hasKecoSection ? (
+        <SectionCollapsible title={`${REVIEW_STEP_LABELS.KECO} 검토의견`}>
+          <div className="space-y-6">
+            {kecoRvwList.length > 0 ? (
+              <TechReviewOpinionTable items={kecoRvwList} />
+            ) : null}
+            {renderOpinionForm("KECO")}
+          </div>
+        </SectionCollapsible>
+      ) : null}
+    </>
+  );
+});
+
+function getRvwOpnnIds(item: SewerBscPlanRvwOpnnResponseDto) {
+  if (!item.sewerBscPlanDocNo || item.chgCycl == null || item.rvwOpnnSn == null) {
+    throw new Error("검토의견 식별값이 없습니다.");
+  }
+  return [item.sewerBscPlanDocNo, item.chgCycl, item.rvwOpnnSn] as const;
+}
+
+function TechReviewOpinionTable({ items }: TechReviewOpinionTableProps) {
+  const queryClient = useQueryClient();
+  const currentUserUuid = useUserStore((state) => state.userInfo?.userUnqId);
+
+  return (
+    <RvwOpnnListTable
+      items={items}
+      getRowKey={(item) => `${item.sewerBscPlanDocNo}_${item.rvwOpnnSn}`}
+      currentUserUuid={currentUserUuid}
+      onUpdate={async (item, body) => {
+        await sewerBscPlanRvwOpnnService.update(...getRvwOpnnIds(item), body);
+        await queryClient.invalidateQueries({ queryKey: sewerBscPlanKeys.all });
+      }}
+      onDelete={async (item) => {
+        await sewerBscPlanRvwOpnnService.delete(...getRvwOpnnIds(item));
+        await queryClient.invalidateQueries({ queryKey: sewerBscPlanKeys.all });
+      }}
+    />
+  );
+}
+
+export { TechReviewOpinionSection };

apps/as/src/shared/config/api.ts

@@ -12,11 +12,13 @@ export const ENDPOINT = {
     RVW_MNPW: "/as-service/api/v1/rvw-mnpw",
     BNS_IF: "/as-service/api/v1/if",
     INSTL_SNCN: "/as-service/api/v1/instl-sncn",
+    INSTL_SNCN_RVW_OPNN: "/as-service/api/v1/instl-sncn-rvw-opnn",
     CKLST: "/as-service/api/v1/cklst",
     CKLST_ARTCL: "/as-service/api/v1/cklst-artcl",
     CKLST_RVW: "/as-service/api/v1/cklst-rvw",
     ADSTDSTR: "/as-service/api/v1/adstdstr",
     FNRS_CNSLTN_MNG: "/as-service/api/v1/fnrs-cnsltn-mng",
+    FNRS_CNSLTN_RVW_OPNN: "/as-service/api/v1/fnrs-cnsltn-rvw-opnn",
     FNRS_SHAR_SE: "/as-service/api/v1/fnrs-shar-se-mng",
     DESIGN_CNSTN: "/as-service/api/v1/design-cnstn",
     DESIGN_CNSTN_BIZ_CST: "/as-service/api/v1/design-cnstn-biz-cst",
@@ -24,6 +26,7 @@ export const ENDPOINT = {
     DESIGN_CNSTN_ESNTL_ATCH_FILE: "/as-service/api/v1/design-cnstn-esntl-atch-file",
     DESIGN_CNSTN_RVW_OPNN: "/as-service/api/v1/design-cnstn-rvw-opnn",
     SEWER_BSC_PLAN: "/as-service/api/v1/sewer-bsc-plans",
+    SEWER_BSC_PLAN_RVW_OPNNS: "/as-service/api/v1/sewer-bsc-plan-rvw-opnns",
     DASHBOARD: "/as-service/api/v1/dashboard",
     DCRAG_TO: "/as-service/api/v1/dcrag-to",
     AI_AUTO_PRCS_MNG: "/as-service/api/v1/ai-auto-prcs-mng",

apps/as/src/shared/model/index.ts

@@ -46,6 +46,7 @@ export type {
   PbadmsMngDetResponseBase,
   RvwOpnnResponseExtension,
   RvwOpnnSaveBase,
+  RvwOpnnUpdateRequestDto,
   SplmntDmndResponseExtension,
   SplmntDmndSaveBase,
 } from "./pbadms-sprt";

apps/as/src/shared/model/pbadms-sprt.ts

@@ -231,11 +231,22 @@ export interface PbadmsApplySaveHeader {
   rvwStpCd?: string;
 }
 
+/** 검토의견 수정 공통 요청 DTO */
+export interface RvwOpnnUpdateRequestDto {
+  opnrSeComCd?: string;
+  opnrNm?: string;
+  rvwRsltCn?: string;
+  rvwRsltAnmlyYn?: string;
+  atchFileGroupId?: string;
+}
+
 /** 검토의견 응답 공통 확장 필드 */
 export interface RvwOpnnResponseExtension {
   opnrSeCdNm?: string;
   atchFileInfo?: AtflMngClientResponseDto;
   regDt?: string;
+  rgtr?: string;
+  rgtrNm?: string;
 }
 
 /** 보완요구 응답 공통 확장 필드 */

apps/as/src/widgets/pbadms-sprt/index.ts

@@ -51,6 +51,7 @@ export {
 } from "./ui/pbadms-task-apply-dialog";
 export { PrivacyConsentSection } from "./ui/privacy-consent-section";
 export { ProgressStatusSection } from "./ui/progress-status-section";
+export { RvwOpnnListTable, type RvwOpnnListTableProps } from "./ui/rvw-opnn-list-table";
 export {
   SplmntDmndDialog,
   type SplmntDmndDialogConfirmItem,

apps/as/src/widgets/pbadms-sprt/ui/rvw-opnn-list-table.tsx

@@ -0,0 +1,403 @@
+"use client";
+
+import { useState } from "react";
+
+import { useConfirm } from "@frontend-opensource/use-react-hooks";
+
+import { dayjs, getDefaultFileKey, useTus } from "@/shared/lib";
+import type { AtflMngClientResponseDto, RvwOpnnUpdateRequestDto } from "@/shared/model";
+import { AttachmentFileField } from "@/shared/ui";
+import { Field, FieldLabel, FieldSet } from "@/shared/ui/field";
+import {
+  AttachmentDownloadLink,
+  attachService,
+  useDownloadAttachmentByAtflId,
+} from "@/entities/attach";
+import {
+  Button,
+  RadioGroup,
+  RadioGroupItem,
+  Table,
+  TableBody,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+  Textarea,
+} from "@common/components";
+
+const RVW_OPNN_EDIT_FILE_KEY_PREFIX = "rvw-opnn-edit::";
+
+/** 업무별 검토의견 응답 DTO 공통 필드 (업무마다 null 허용 여부가 달라 느슨하게 정의) */
+interface RvwOpnnListItem {
+  opnrSeComCd?: string | null;
+  opnrNm?: string | null;
+  rvwRsltCn?: string | null;
+  rvwRsltAnmlyYn?: string | null;
+  atchFileGroupId?: string | null;
+  atchFileInfo?: AtflMngClientResponseDto | null;
+  regDt?: string | null;
+  rgtr?: string | null;
+}
+
+interface RvwOpnnListTableProps<T extends RvwOpnnListItem> {
+  items: T[];
+  getRowKey: (item: T) => string;
+  /** 로그인 사용자 UUID — 검토의견 등록자(rgtr)와 같을 때만 수정·삭제 버튼 노출 */
+  currentUserUuid?: string;
+  onUpdate: (item: T, body: RvwOpnnUpdateRequestDto) => Promise<void>;
+  onDelete: (item: T) => Promise<void>;
+}
+
+interface EditDraft {
+  rvwRsltCn: string;
+  rvwRsltAnmlyYn: string;
+  atchFileGroupId: string;
+}
+
+interface EditFile {
+  fileName: string;
+  fileKey: string;
+  atflId?: string;
+  atflCd?: string;
+  /** 이번 수정 중 새로 업로드한 파일 여부 (취소 시 정리 대상) */
+  isNew: boolean;
+}
+
+function formatAnmlyYn(value?: string | null) {
+  if (value === "Y") return "이상";
+  if (value === "N") return "정상";
+  return "-";
+}
+
+function RvwOpnnListTable<T extends RvwOpnnListItem>({
+  items,
+  getRowKey,
+  currentUserUuid,
+  onUpdate,
+  onDelete,
+}: RvwOpnnListTableProps<T>) {
+  const { confirm } = useConfirm();
+  const { mutate: downloadByAtflId } = useDownloadAttachmentByAtflId();
+  const [editingKey, setEditingKey] = useState<string | null>(null);
+  const [draft, setDraft] = useState<EditDraft | null>(null);
+  const [editFile, setEditFile] = useState<EditFile | null>(null);
+  const [isSubmitting, setIsSubmitting] = useState(false);
+
+  const { uploadFileAsync, isUploading, uploads } = useTus({
+    onSuccess: (atflCd, atflId, _file, fileKey) => {
+      if (!atflCd || !atflId) return;
+
+      setDraft((prev) => (prev ? { ...prev, atchFileGroupId: atflCd } : prev));
+      setEditFile((prev) => (prev?.fileKey === fileKey ? { ...prev, atflCd, atflId } : prev));
+    },
+    onError: (_error, _file, fileKey) => {
+      setEditFile((prev) => (prev?.fileKey === fileKey ? null : prev));
+    },
+  });
+
+  const editFileUploading = editFile ? (isUploading[editFile.fileKey] ?? false) : false;
+
+  function canModify(item: T) {
+    return Boolean(currentUserUuid) && item.rgtr === currentUserUuid;
+  }
+
+  async function discardNewFile(file: EditFile | null) {
+    if (!file?.isNew) return;
+
+    uploads[file.fileKey]?.abort();
+    if (file.atflId) {
+      try {
+        await attachService.deleteAttachmentByAtflId(file.atflId);
+      } catch (error) {
+        console.error("검토의견 첨부파일 삭제 실패:", error);
+      }
+    }
+  }
+
+  function resetEdit() {
+    setEditingKey(null);
+    setDraft(null);
+    setEditFile(null);
+  }
+
+  function startEdit(item: T) {
+    void discardNewFile(editFile);
+
+    setEditingKey(getRowKey(item));
+    setDraft({
+      rvwRsltCn: item.rvwRsltCn ?? "",
+      rvwRsltAnmlyYn: item.rvwRsltAnmlyYn ?? "",
+      atchFileGroupId: item.atchFileGroupId ?? "",
+    });
+    setEditFile(
+      item.atchFileInfo?.atflCd
+        ? {
+            fileName: item.atchFileInfo.orgnlFileNm || "첨부파일",
+            fileKey: `${RVW_OPNN_EDIT_FILE_KEY_PREFIX}${item.atchFileInfo.atflCd}`,
+            atflId: item.atchFileInfo.atflId,
+            atflCd: item.atchFileInfo.atflCd,
+            isNew: false,
+          }
+        : null,
+    );
+  }
+
+  function cancelEdit() {
+    void discardNewFile(editFile);
+    resetEdit();
+  }
+
+  async function handleFileAdd(files: FileList | null) {
+    if (!files || files.length === 0) return;
+
+    const file = files[0];
+    const fileKey = `${RVW_OPNN_EDIT_FILE_KEY_PREFIX}${getDefaultFileKey(file)}`;
+
+    setEditFile({ fileName: file.name, fileKey, isNew: true });
+
+    try {
+      await uploadFileAsync(file, { fileKey });
+    } catch {
+      // onError callback handles cleanup
+    }
+  }
+
+  function handleFileRemove() {
+    // 기존 파일은 저장 시점에 연결만 해제하고, 새로 올린 파일은 즉시 정리
+    void discardNewFile(editFile);
+    setEditFile(null);
+    setDraft((prev) => (prev ? { ...prev, atchFileGroupId: "" } : prev));
+  }
+
+  async function handleSave(item: T) {
+    if (!draft) return;
+    if (!draft.rvwRsltCn.trim()) {
+      alert("의견내용을 입력하세요.");
+      return;
+    }
+    if (!draft.rvwRsltAnmlyYn) {
+      alert("검토결과를 선택하세요.");
+      return;
+    }
+    if (!(await confirm("검토의견을 수정하시겠습니까?"))) return;
+
+    setIsSubmitting(true);
+    try {
+      await onUpdate(item, {
+        opnrSeComCd: item.opnrSeComCd ?? undefined,
+        opnrNm: item.opnrNm ?? undefined,
+        rvwRsltCn: draft.rvwRsltCn,
+        rvwRsltAnmlyYn: draft.rvwRsltAnmlyYn,
+        atchFileGroupId: draft.atchFileGroupId,
+      });
+      alert("수정되었습니다.");
+      resetEdit();
+    } catch (error) {
+      console.error("검토의견 수정 실패:", error);
+      alert("검토의견 수정 중 오류가 발생했습니다.");
+    } finally {
+      setIsSubmitting(false);
+    }
+  }
+
+  async function handleDelete(item: T) {
+    if (!(await confirm("검토의견을 삭제하시겠습니까?"))) return;
+
+    setIsSubmitting(true);
+    try {
+      await onDelete(item);
+      alert("삭제되었습니다.");
+      if (editingKey === getRowKey(item)) resetEdit();
+    } catch (error) {
+      console.error("검토의견 삭제 실패:", error);
+      alert("검토의견 삭제 중 오류가 발생했습니다.");
+    } finally {
+      setIsSubmitting(false);
+    }
+  }
+
+  function renderViewRow(item: T) {
+    return (
+      <>
+        <TableCell align="left">{item.rvwRsltCn || "-"}</TableCell>
+        <TableCell align="center">{formatAnmlyYn(item.rvwRsltAnmlyYn)}</TableCell>
+        <TableCell align="center">
+          {item.atchFileInfo?.atflCd ? (
+            <AttachmentDownloadLink
+              atflCd={item.atchFileInfo.atflCd}
+              fileName={item.atchFileInfo.orgnlFileNm || "다운로드"}
+            />
+          ) : (
+            "-"
+          )}
+        </TableCell>
+      </>
+    );
+  }
+
+  function renderEditRow(rowKey: string, editDraft: EditDraft) {
+    return (
+      <>
+        <TableCell align="left">
+          <Textarea
+            value={editDraft.rvwRsltCn}
+            onChange={(event) =>
+              setDraft((prev) => (prev ? { ...prev, rvwRsltCn: event.target.value } : prev))
+            }
+            placeholder="의견내용을 입력하세요"
+            rows={4}
+            className="min-h-[8rem] !text-xl"
+          />
+        </TableCell>
+        <TableCell align="center">
+          <FieldSet>
+            <RadioGroup
+              value={editDraft.rvwRsltAnmlyYn}
+              onValueChange={(value) =>
+                setDraft((prev) => (prev ? { ...prev, rvwRsltAnmlyYn: value } : prev))
+              }
+            >
+              <div className="flex flex-col gap-2">
+                <FieldLabel
+                  htmlFor={`rvw-opnn-edit-normal-${rowKey}`}
+                  className="!w-auto border-none"
+                >
+                  <Field orientation="horizontal" className="w-auto">
+                    <RadioGroupItem value="N" id={`rvw-opnn-edit-normal-${rowKey}`} />
+                    <span className="font-normal">정상</span>
+                  </Field>
+                </FieldLabel>
+                <FieldLabel
+                  htmlFor={`rvw-opnn-edit-abnormal-${rowKey}`}
+                  className="!w-auto border-none"
+                >
+                  <Field orientation="horizontal" className="w-auto">
+                    <RadioGroupItem value="Y" id={`rvw-opnn-edit-abnormal-${rowKey}`} />
+                    <span className="font-normal">이상</span>
+                  </Field>
+                </FieldLabel>
+              </div>
+            </RadioGroup>
+          </FieldSet>
+        </TableCell>
+        <TableCell align="center">
+          <AttachmentFileField
+            files={
+              editFile
+                ? [
+                    {
+                      fileKey: editFile.fileKey,
+                      fileName: editFile.fileName,
+                      onDownload: editFile.atflId
+                        ? () => downloadByAtflId(editFile.atflId!)
+                        : undefined,
+                    },
+                  ]
+                : []
+            }
+            inputId={`rvw-opnn-edit-${rowKey}-file-input`}
+            isUploadingByKey={isUploading}
+            multiple={false}
+            showAddButton={!editFile}
+            addDisabled={editFileUploading}
+            onAdd={(fileList) => void handleFileAdd(fileList)}
+            onRemove={handleFileRemove}
+          />
+        </TableCell>
+      </>
+    );
+  }
+
+  return (
+    <div className="overflow-x-auto">
+      <Table
+        caption="검토의견 목록으로 의견자명, 의견내용, 검토결과, 첨부파일, 등록일시, 관리 정보 제공"
+        variant="secondary"
+      >
+        <colgroup>
+          <col width="10%" />
+          <col width="47%" />
+          <col width="6%" />
+          <col width="17%" />
+          <col width="10%" />
+          <col width="10%" />
+        </colgroup>
+        <TableHeader>
+          <TableRow>
+            <TableHead>의견자명</TableHead>
+            <TableHead>의견내용</TableHead>
+            <TableHead>검토결과</TableHead>
+            <TableHead>첨부파일</TableHead>
+            <TableHead>등록일시</TableHead>
+            <TableHead>관리</TableHead>
+          </TableRow>
+        </TableHeader>
+        <TableBody>
+          {items.map((item) => {
+            const rowKey = getRowKey(item);
+            const isEditing = editingKey === rowKey && draft !== null;
+
+            return (
+              <TableRow key={rowKey}>
+                <TableCell align="center">{item.opnrNm}</TableCell>
+                {isEditing ? renderEditRow(rowKey, draft) : renderViewRow(item)}
+                <TableCell align="center">
+                  {item.regDt ? dayjs(item.regDt).format("YYYY-MM-DD HH:mm:ss") : "-"}
+                </TableCell>
+                <TableCell align="center">
+                  {!canModify(item) ? (
+                    "-"
+                  ) : isEditing ? (
+                    <div className="flex flex-wrap justify-center gap-1">
+                      <Button
+                        type="button"
+                        size="sm"
+                        onClick={() => void handleSave(item)}
+                        disabled={isSubmitting || editFileUploading}
+                      >
+                        저장
+                      </Button>
+                      <Button
+                        type="button"
+                        size="sm"
+                        color="white"
+                        onClick={cancelEdit}
+                        disabled={isSubmitting}
+                      >
+                        취소
+                      </Button>
+                    </div>
+                  ) : (
+                    <div className="flex flex-wrap justify-center gap-1">
+                      <Button
+                        type="button"
+                        size="sm"
+                        color="white"
+                        onClick={() => startEdit(item)}
+                        disabled={isSubmitting}
+                      >
+                        수정
+                      </Button>
+                      <Button
+                        type="button"
+                        size="sm"
+                        color="gray"
+                        onClick={() => void handleDelete(item)}
+                        disabled={isSubmitting}
+                      >
+                        삭제
+                      </Button>
+                    </div>
+                  )}
+                </TableCell>
+              </TableRow>
+            );
+          })}
+        </TableBody>
+      </Table>
+    </div>
+  );
+}
+
+export { RvwOpnnListTable, type RvwOpnnListTableProps };

apps/st/src/components/module/DataGrid.tsx

@@ -33,6 +33,7 @@ import {
     hasAdmdstCdColumn,
     isExcelImportAdmdstCdInvalid,
     mergeExcelImportWithExistingRows,
+    parseExcelImportCellValue,
     prepareGridColumnsForExcelExport,
     releaseFixedOptionsForExcelExport,
     resolveColumnStyleName,
@@ -289,14 +290,28 @@ type GridViewWithSetColumnProperty = {
 };
 
 type GridViewWithEditOptions = {
-    setEditOptions?: (options: { commitWhenLeave?: boolean }) => void;
+    setEditOptions?: (options: {
+        commitWhenLeave?: boolean;
+        appendable?: boolean;
+        insertable?: boolean;
+    }) => void;
+    setPasteOptions?: (options: { enableAppend?: boolean }) => void;
 };
 
 /** 포커스가 그리드 밖으로 나갈 때 편집 중인 값을 자동 commit */
 function applyDefaultGridEditOptions(
     gridView: GridViewWithEditOptions | null | undefined,
+    options?: { preventRowAppend?: boolean },
 ) {
-    gridView?.setEditOptions?.({ commitWhenLeave: true });
+    gridView?.setEditOptions?.({
+        commitWhenLeave: true,
+        ...(options?.preventRowAppend
+            ? { appendable: false, insertable: false }
+            : {}),
+    });
+    if (options?.preventRowAppend) {
+        gridView?.setPasteOptions?.({ enableAppend: false });
+    }
 }
 
 function isDateEditorColumn(column: {
@@ -853,6 +868,7 @@ const DataGrid = ({
     gridHeight = 55, // vh 단위
     headerHeight = 60,
     fitStyle = GridFitStyle.EVEN,
+    preventRowAppend = true,
 }: DataGridProps) => {
     const { columns, columnLayout } = columnInfo;
     const fixedColumnNameSet = useMemo(
@@ -1331,6 +1347,11 @@ useEffect(() => {
                         columnLayout,
                         { skipNonEditable: false },
                     );
+                    const valueTypeByFieldName = new Map(
+                        columns
+                            .filter((c) => c.fieldName)
+                            .map((c) => [c.fieldName as string, c.valueType]),
+                    );
 
                     // 데이터 행 읽기
                     const dataRows: Record<string, string | number>[] = [];
@@ -1352,36 +1373,13 @@ useEffect(() => {
                                 ];
                             const fieldName = excelColumnFieldNames[colIndex];
                             const allFieldName = excelColumnFieldNamesAll[colIndex];
-
-                            let cellValue: string | number = "";
-                            if (
-                                cell &&
-                                cell.v !== undefined &&
-                                cell.v !== null
-                            ) {
-                                // 엑셀 셀 타입이 숫자이거나 값이 숫자인 경우 숫자로 변환
-                                if (
-                                    cell.t === "n" ||
-                                    (typeof cell.v === "number" &&
-                                        !isNaN(cell.v))
-                                ) {
-                                    cellValue = cell.v as number;
-                                } else {
-                                    const stringValue = String(cell.v);
-                                    // 문자열이지만 숫자로 변환 가능한 경우 숫자로 변환
-                                    const numericValue = Number(
-                                        stringValue.replace(/,/g, ""),
-                                    );
-                                    if (
-                                        !isNaN(numericValue) &&
-                                        stringValue.trim() !== ""
-                                    ) {
-                                        cellValue = numericValue;
-                                    } else {
-                                        cellValue = stringValue;
-                                    }
-                                }
-                            }
+                            const typeFieldName = fieldName || allFieldName;
+                            const cellValue = parseExcelImportCellValue(
+                                cell,
+                                typeFieldName
+                                    ? valueTypeByFieldName.get(typeFieldName)
+                                    : undefined,
+                            );
 
                             if (allFieldName === "admdstCd" && cellValue !== "") {
                                 rowAdmdstCd = cellValue;
@@ -1467,7 +1465,9 @@ useEffect(() => {
         const scheduleFooterTask = (task: () => void, delayMs: number) => {
             footerTimerIds.push(setTimeout(task, delayMs));
         };
-        applyDefaultGridEditOptions(gridView as GridViewWithEditOptions);
+        applyDefaultGridEditOptions(gridView as GridViewWithEditOptions, {
+            preventRowAppend,
+        });
 
         const columnsFieldsSig = columns.map((c) => c.fieldName).join("\u0001");
         if (columnsFieldsSig !== columnsFieldsSigRef.current) {
@@ -1990,6 +1990,7 @@ useEffect(() => {
         fitStyle,
         enableSort,
         footerVerificationResult,
+        preventRowAppend,
     ]);
 
     // 행·셀 클릭 이벤트 (검증 오류 툴팁은 hover만 — onShowTooltip / 빈 셀 오버레이)
@@ -2527,6 +2528,7 @@ useEffect(() => {
                         const gridView = gridRef.current?.gridView ?? grid;
                         applyDefaultGridEditOptions(
                             gridView as GridViewWithEditOptions,
+                            { preventRowAppend },
                         );
                         if (!gridView?.columnByName) return;
                         setTimeout(() => {

apps/st/src/components/module/TabDataGrid.tsx

@@ -53,6 +53,7 @@ import {
     hasAdmdstCdColumn,
     isExcelImportAdmdstCdInvalid,
     mergeExcelImportWithExistingRows,
+    parseExcelImportCellValue,
     prepareGridColumnsForExcelExport,
     releaseFixedOptionsForExcelExport,
     resolveColumnStyleName,
@@ -611,6 +612,11 @@ const TabDataGrid = ({
                         columnLayout,
                         { skipNonEditable: false },
                     );
+                    const valueTypeByFieldName = new Map(
+                        columns
+                            .filter((c) => c.fieldName)
+                            .map((c) => [c.fieldName as string, c.valueType]),
+                    );
 
                     // 데이터 행 읽기
                     const dataRows: Record<string, string | number>[] = [];
@@ -625,23 +631,13 @@ const TabDataGrid = ({
                             const cell = worksheet[XLSX.utils.encode_cell({ r: row, c: col })];
                             const fieldName = excelColumnFieldNames[colIndex];
                             const allFieldName = excelColumnFieldNamesAll[colIndex];
-
-                            let cellValue: string | number = '';
-                            if (cell && cell.v !== undefined && cell.v !== null) {
-                                // 엑셀 셀 타입이 숫자이거나 값이 숫자인 경우 숫자로 변환
-                                if (cell.t === 'n' || (typeof cell.v === 'number' && !isNaN(cell.v))) {
-                                    cellValue = cell.v as number;
-                                } else {
-                                    const stringValue = String(cell.v);
-                                    // 문자열이지만 숫자로 변환 가능한 경우 숫자로 변환
-                                    const numericValue = Number(stringValue.replace(/,/g, ''));
-                                    if (!isNaN(numericValue) && stringValue.trim() !== '') {
-                                        cellValue = numericValue;
-                                    } else {
-                                        cellValue = stringValue;
-                                    }
-                                }
-                            }
+                            const typeFieldName = fieldName || allFieldName;
+                            const cellValue = parseExcelImportCellValue(
+                                cell,
+                                typeFieldName
+                                    ? valueTypeByFieldName.get(typeFieldName)
+                                    : undefined,
+                            );
 
                             if (allFieldName === 'admdstCd' && cellValue !== '') {
                                 rowAdmdstCd = cellValue;

apps/st/src/components/statistics/input/ExcretaTreatmentFacilityInp.tsx

@@ -20,6 +20,7 @@ import { nullableTrimmedString } from "@/components/util/input/nullableString";
 import { statisticsInputExcretaTreatmentFacilityApi } from "@/entities/statistics/api/input/statistics-input-excreta-treatment-facility-service";
 import { statisticsInputSewSupplyRateApi } from "@/entities/statistics/api/input/statistics-input-sew-supply-rate-service";
 import { statisticsApi } from "@/entities/statistics/api/statistics-service";
+import { callImrServiceWithRollbackOnFailure } from "@/components/util/input/call-imr-with-rollback";
 import {
     EXCRETA_TREATMENT_FACILITY_STATS_CD,
     type ExcretaTreatmentFacilityItem,
@@ -75,7 +76,11 @@ import { toGridRows } from "@/components/util/grid/gridFunction";
 import { formatCompactYmdForGrid, toCompactYmdOrNull } from "@/components/util/grid/ymdFormat";
 import { toExcelExportSearchContextFromSearchForm } from "@/components/util/gridExcelExport";
 import { isVerificationFailedFromCommonInfo } from "@/components/util/input/verification-failed-flag";
-import type { VerificationResultLikeMap } from "@/components/util/input/verification-result-display";
+import {
+    formatVerificationTooltip,
+    normalizeVerificationResultMap,
+    type VerificationResultLikeMap,
+} from "@/components/util/input/verification-result-display";
 import { useAdminStore } from "@/store/admin-store";
 import { useTabStore } from "@/store/tab-store";
 
@@ -207,7 +212,7 @@ function mapExcretaTreatmentFacilityListToGridRows(
             },
         ])[0] as GridRowWithVerification;
         if (item.verificationResult) {
-            row.verificationResult = item.verificationResult;
+            row.verificationResult = normalizeVerificationResultMap(item.verificationResult);
         }
         return row;
     });
@@ -502,7 +507,9 @@ const ExcretaTreatmentFacilityInp = () => {
         setStatusInfo(nextStatusInfo);
         setStatsCd(commonInfo.statsCd);
         setIsVerificationFailed(isVerificationFailedFromCommonInfo(commonInfo));
-        setFooterVerificationResult(commonInfo.verificationResult ?? null);
+        setFooterVerificationResult(
+            normalizeVerificationResultMap(commonInfo.verificationResult) ?? null,
+        );
         if (overrides?.mode !== "PRE") {
             setIsNotApplicable(gridRows.length === 0);
         } else if (gridRows.length > 0) {
@@ -784,7 +791,6 @@ const ExcretaTreatmentFacilityInp = () => {
                         lclgvIdfrTelnoCn: submitInfo.lclgvIdfrTelnoCn,
                         lclgvIdfrDeptNm: submitInfo.lclgvIdfrDeptNm,
                         lclgvIdfrJbgdNm: submitInfo.lclgvIdfrJbgdNm,
-                        ...(isAdminInfo ? { superAdmin: "superAdmin" } : {}),
                         noApplicable,
                         submitList,
                         deleteList: deleteListForSubmit,
@@ -814,7 +820,13 @@ const ExcretaTreatmentFacilityInp = () => {
                 };
 
                 try {
-                    const imrResponse = await statisticsApi.callImrService(imrParam);
+                    const imrResponse = await callImrServiceWithRollbackOnFailure(imrParam, {
+                        statsYr: lastSearchedValues.year ?? "",
+                        statsCd: statsCdForSubmit,
+                        sewerBzmnCd: lastSearchedValues?.bsnmCd ?? "",
+                        rollbackStatusCode: statusInfo?.lclgvSbmsnSttsCd ?? "",
+                        mdfrUuid: userInfo.userUnqId,
+                    });
                     if (imrResponse.job_id) {
                         await waitForImrJobCompleted(
                             imrResponse.job_id,
@@ -953,19 +965,7 @@ const ExcretaTreatmentFacilityInp = () => {
         if (!verification) return;
         const errors = verification[fieldName];
         if (Array.isArray(errors) && errors.length > 0) {
-            return errors
-                .map((e) => {
-                    const prefix =
-                        e.vrfcCd === "IMR"
-                            ? "시계열 검증 - "
-                            : e.vrfcCd === "NV"
-                              ? "일반검증 - "
-                              : "모집단 검증 -";
-                    return `${prefix}${e.rsnExpln}
-(검증 기준값: ${e.cmprCn} / 현재 입력값: ${e.nowCn})`;
-                })
-                .filter(Boolean)
-                .join("\n");
+            return formatVerificationTooltip(errors);
         }
     };
 

apps/st/src/components/statistics/input/PrivateSewageFacilityInp.tsx

@@ -9,6 +9,7 @@ import { ConfirmDialog } from "@/shared/ui/confirm-dialog";
 import { statisticsInputPrivateSewageFacilityApi } from "@/entities/statistics/api/input/statistics-input-private-sewage-facility-service";
 import { statisticsInputSewSupplyRateApi } from "@/entities/statistics/api/input/statistics-input-sew-supply-rate-service";
 import { statisticsApi } from "@/entities/statistics/api/statistics-service";
+import { callImrServiceWithRollbackOnFailure } from "@/components/util/input/call-imr-with-rollback";
 import type {
     PrivateSewageDesigStatusItem,
     PrivateSewageDesigStatusSaveItem,
@@ -68,7 +69,11 @@ import {
     patchFooterVerificationByTab,
     patchVerificationFailedByTab,
 } from "@/components/util/input/verification-failed-flag";
-import type { VerificationResultLikeMap } from "@/components/util/input/verification-result-display";
+import {
+    formatVerificationTooltip,
+    normalizeVerificationResultMap,
+    type VerificationResultLikeMap,
+} from "@/components/util/input/verification-result-display";
 import { nullableTrimmedString } from "@/components/util/input/nullableString";
 import { useAdminStore } from "@/store/admin-store";
 import { useTabStore } from "@/store/tab-store";
@@ -175,7 +180,9 @@ function mapRegionalListToGridRows<
     return filterBySelectedAdmdstCd(list, sidoListRef.current, values).map((item) => {
         const { verificationResult, ...rest } = item;
         const row = toGridRows([{ ctpvNm, ...rest }])[0] as GridRowWithVerification;
-        if (verificationResult) row.verificationResult = verificationResult;
+        if (verificationResult) {
+            row.verificationResult = normalizeVerificationResultMap(verificationResult);
+        }
         return row;
     });
 }
@@ -797,7 +804,6 @@ const PrivateSewageFacilityInp = () => {
 
         const activeTabStatus = tabStatusInfoMap.get(tabKey) ?? null;
         const statsCdForTab = tabStatsCdMap.get(tabKey) ?? tabKey;
-        const adminOpt = isAdminInfo ? { superAdmin: "superAdmin" as const } : {};
 
         const submitInfoBase = {
             statsYr: lastSearchedValues.year ?? "",
@@ -842,7 +848,6 @@ const PrivateSewageFacilityInp = () => {
                     ...submitInfoBase,
                     userUuid: userInfo.userUnqId,
                     submitList: buildSewageTreatFactStatusSaveList(currentData),
-                    ...adminOpt,
                 };
                 response =
                     await statisticsInputPrivateSewageFacilityApi.submitSewageTreatFactStatus(
@@ -853,7 +858,6 @@ const PrivateSewageFacilityInp = () => {
                     ...submitInfoBase,
                     userUuid: userInfo.userUnqId,
                     submitList: buildSepticTankStatusSaveList(currentData),
-                    ...adminOpt,
                 };
                 response =
                     await statisticsInputPrivateSewageFacilityApi.submitSepticTankStatus(param);
@@ -862,7 +866,6 @@ const PrivateSewageFacilityInp = () => {
                     ...submitInfoBase,
                     userUuid: userInfo.userUnqId,
                     submitList: buildPrivateSewageDesigStatusSaveList(currentData),
-                    ...adminOpt,
                 };
                 response =
                     await statisticsInputPrivateSewageFacilityApi.submitPrivateSewageDesigStatus(
@@ -892,7 +895,13 @@ const PrivateSewageFacilityInp = () => {
                 };
 
                 try {
-                    const imrResponse = await statisticsApi.callImrService(imrParam);
+                    const imrResponse = await callImrServiceWithRollbackOnFailure(imrParam, {
+                        statsYr: lastSearchedValues.year ?? "",
+                        statsCd: statsCdForTab,
+                        sewerBzmnCd: lastSearchedValues?.bsnmCd ?? "",
+                        rollbackStatusCode: activeTabStatus?.lclgvSbmsnSttsCd ?? "",
+                        mdfrUuid: userInfo.userUnqId,
+                    });
                     if (imrResponse.job_id) {
                         await waitForImrJobCompleted(
                             imrResponse.job_id,
@@ -1148,18 +1157,7 @@ const PrivateSewageFacilityInp = () => {
         if (!verification) return;
         const errors = verification[fieldName];
         if (Array.isArray(errors) && errors.length > 0) {
-            return errors
-                .map((e) => {
-                    const prefix =
-                        e.vrfcCd === "IMR"
-                            ? "시계열 검증 - "
-                            : e.vrfcCd === "NV"
-                              ? "일반검증 - "
-                              : "모집단 검증 - ";
-                    return `${prefix}${e.rsnExpln}(검증 기준값: ${e.cmprCn} / 현재 입력값: ${e.nowCn})`;
-                })
-                .filter(Boolean)
-                .join("\n");
+            return formatVerificationTooltip(errors);
         }
     };
 

apps/st/src/components/statistics/input/PublicSewageFacilityInp.tsx

@@ -8,6 +8,7 @@ import { useStatisticsInputPendingNavigation } from '@/shared/lib/use-statistics
 import { statisticsInputSewSupplyRateApi } from '@/entities/statistics/api/input/statistics-input-sew-supply-rate-service';
 import { statisticsInputPublicSewageFacilityApiService } from '@/entities/statistics/api/input/statistics-public-sewage-facility-input-service';
 import { statisticsApi } from '@/entities/statistics/api/statistics-service';
+import { callImrServiceWithRollbackOnFailure } from '@/components/util/input/call-imr-with-rollback';
 import type {
     PublicSewageFacilityRequestParams,
     PublicSewageFacilitySaveItem,
@@ -52,7 +53,11 @@ import { fetchColumnGuidesRecord } from '@/components/util/grid/columnGuides';
 import { toGridRows } from '@/components/util/grid/gridFunction';
 import { toExcelExportSearchContextFromSearchForm } from "@/components/util/gridExcelExport";
 import { patchFooterVerificationByTab,patchVerificationFailedByTab } from '@/components/util/input/verification-failed-flag';
-import type { VerificationResultLikeMap } from '@/components/util/input/verification-result-display';
+import {
+    formatVerificationTooltip,
+    withNormalizedVerificationResult,
+    type VerificationResultLikeMap,
+} from '@/components/util/input/verification-result-display';
 import { nullableTrimmedString } from '@/components/util/input/nullableString';
 import { useAdminStore } from '@/store/admin-store';
 import { useTabStore } from '@/store/tab-store';
@@ -438,7 +443,13 @@ const PublicSewageFacilityInp = () => {
                 };
 
                 try {
-                    const imrResponse = await statisticsApi.callImrService(imrParam);
+                    const imrResponse = await callImrServiceWithRollbackOnFailure(imrParam, {
+                        statsYr: lastSearchedValues.year ?? '',
+                        statsCd: statsCdForTab,
+                        sewerBzmnCd: lastSearchedValues?.bsnmCd ?? '',
+                        rollbackStatusCode: activeTabStatus?.lclgvSbmsnSttsCd ?? '',
+                        mdfrUuid: userInfo.userUnqId,
+                    });
                     if (imrResponse.job_id) {
                         await waitForImrJobCompleted(
                             imrResponse.job_id,
@@ -789,11 +800,13 @@ const PublicSewageFacilityInp = () => {
                     sidoListRef.current,
                     searchContext,
                 );
-                const convertedData = list.map((item) => ({
-                    ctpvNm: commonInfo.ctpvNm,
-                    ...item,
-                    rmrk: item.rmrk ?? null,
-                }));
+                const convertedData = list.map((item) =>
+                    withNormalizedVerificationResult({
+                        ctpvNm: commonInfo.ctpvNm,
+                        ...item,
+                        rmrk: item.rmrk ?? null,
+                    }),
+                );
 
                 if (list.length === 0) {
                     setShowIsNotApplicable(true);
@@ -1575,17 +1588,7 @@ const PublicSewageFacilityInp = () => {
                                         if (!verification) return;
                                         const errors = verification[fieldName];
                                         if (Array.isArray(errors) && errors.length > 0) {
-                                            return errors
-                                                .map((e) => {
-                                                    const prefix =
-                                                        e.vrfcCd === "IMR" ? "시계열 검증 - " : (e.vrfcCd === "NV" ? "일반검증 - " : "모집단 검증 - ");
-                                                    const comp = e.cmprCn ?? "";
-                                                    const now = e.nowCn ?? "";
-                                                    return `${prefix}${e.rsnExpln}
-                                                (검증 기준값: ${comp} / 현재 입력값: ${now})`;
-                                                })
-                                                .filter(Boolean)
-                                                .join("\n");
+                                            return formatVerificationTooltip(errors);
                                         }
                                     }}
                                 />

apps/st/src/components/statistics/input/PumpingStationInp.tsx

@@ -20,6 +20,7 @@ import { nullableTrimmedString } from "@/components/util/input/nullableString";
 import { statisticsInputPumpingStationApi } from "@/entities/statistics/api/input/statistics-input-pumping-station-service";
 import { statisticsInputSewSupplyRateApi } from "@/entities/statistics/api/input/statistics-input-sew-supply-rate-service";
 import { statisticsApi } from "@/entities/statistics/api/statistics-service";
+import { callImrServiceWithRollbackOnFailure } from "@/components/util/input/call-imr-with-rollback";
 import {
     PUMPING_STATION_STATS_CD,
     type PumpingStationItem,
@@ -75,7 +76,11 @@ import { toGridRows } from "@/components/util/grid/gridFunction";
 import { formatCompactYmdForGrid, toCompactYmdOrNull } from "@/components/util/grid/ymdFormat";
 import { toExcelExportSearchContextFromSearchForm } from "@/components/util/gridExcelExport";
 import { isVerificationFailedFromCommonInfo } from "@/components/util/input/verification-failed-flag";
-import type { VerificationResultLikeMap } from "@/components/util/input/verification-result-display";
+import {
+    formatVerificationTooltip,
+    normalizeVerificationResultMap,
+    type VerificationResultLikeMap,
+} from "@/components/util/input/verification-result-display";
 import { useAdminStore } from "@/store/admin-store";
 import { useTabStore } from "@/store/tab-store";
 
@@ -206,7 +211,7 @@ function mapPumpingStationListToGridRows(
             },
         ])[0] as GridRowWithVerification;
         if (item.verificationResult) {
-            row.verificationResult = item.verificationResult;
+            row.verificationResult = normalizeVerificationResultMap(item.verificationResult);
         }
         return row;
     });
@@ -493,7 +498,9 @@ const PumpingStationInp = () => {
         setStatusInfo(nextStatusInfo);
         setStatsCd(commonInfo.statsCd);
         setIsVerificationFailed(isVerificationFailedFromCommonInfo(commonInfo));
-        setFooterVerificationResult(commonInfo.verificationResult ?? null);
+        setFooterVerificationResult(
+            normalizeVerificationResultMap(commonInfo.verificationResult) ?? null,
+        );
         if (overrides?.mode !== "PRE") {
             setIsNotApplicable(gridRows.length === 0);
         } else if (gridRows.length > 0) {
@@ -768,7 +775,6 @@ const PumpingStationInp = () => {
                 lclgvIdfrTelnoCn: submitInfo.lclgvIdfrTelnoCn,
                 lclgvIdfrDeptNm: submitInfo.lclgvIdfrDeptNm,
                 lclgvIdfrJbgdNm: submitInfo.lclgvIdfrJbgdNm,
-                ...(isAdminInfo ? { superAdmin: "superAdmin" } : {}),
                 noApplicable,
                 submitList,
                 deleteList,
@@ -797,7 +803,13 @@ const PumpingStationInp = () => {
                 };
 
                 try {
-                    const imrResponse = await statisticsApi.callImrService(imrParam);
+                    const imrResponse = await callImrServiceWithRollbackOnFailure(imrParam, {
+                        statsYr: lastSearchedValues.year ?? "",
+                        statsCd: statsCdForSubmit,
+                        sewerBzmnCd: lastSearchedValues?.bsnmCd ?? "",
+                        rollbackStatusCode: statusInfo?.lclgvSbmsnSttsCd ?? "",
+                        mdfrUuid: userInfo.userUnqId,
+                    });
                     if (imrResponse.job_id) {
                         await waitForImrJobCompleted(
                             imrResponse.job_id,
@@ -936,19 +948,7 @@ const PumpingStationInp = () => {
         if (!verification) return;
         const errors = verification[fieldName];
         if (Array.isArray(errors) && errors.length > 0) {
-            return errors
-                .map((e) => {
-                    const prefix =
-                        e.vrfcCd === "IMR"
-                            ? "시계열 검증 - "
-                            : e.vrfcCd === "NV"
-                                ? "일반검증 - "
-                                : "모집단 검증 -";
-                    return `${prefix}${e.rsnExpln}
-(검증 기준값: ${e.cmprCn} / 현재 입력값: ${e.nowCn})`;
-                })
-                .filter(Boolean)
-                .join("\n");
+            return formatVerificationTooltip(errors);
         }
     };
 

apps/st/src/components/statistics/input/SewageExcretaRelatedInp.tsx

@@ -13,6 +13,7 @@ import { nullableTrimmedString } from "@/components/util/input/nullableString";
 import { statisticsInputSewSupplyRateApi } from "@/entities/statistics/api/input/statistics-input-sew-supply-rate-service";
 import { statisticsInputSewageExcretaRelatedApi } from "@/entities/statistics/api/input/statistics-input-sewage-excreta-related-service";
 import { statisticsApi } from "@/entities/statistics/api/statistics-service";
+import { callImrServiceWithRollbackOnFailure } from "@/components/util/input/call-imr-with-rollback";
 import type {
     ExcretaRelatedIndustrySaveItem,
     PrivateSewageTreatRelatedIndustrySaveItem,
@@ -84,7 +85,11 @@ import {
     patchFooterVerificationByTab,
     patchVerificationFailedByTab,
 } from "@/components/util/input/verification-failed-flag";
-import type { VerificationResultLikeMap } from "@/components/util/input/verification-result-display";
+import {
+    formatVerificationTooltip,
+    normalizeVerificationResultMap,
+    type VerificationResultLikeMap,
+} from "@/components/util/input/verification-result-display";
 import { useAdminStore } from "@/store/admin-store";
 import { useTabStore } from "@/store/tab-store";
 
@@ -552,19 +557,7 @@ function verificationCellTooltip({
     if (!verification) return;
     const errors = verification[fieldName];
     if (Array.isArray(errors) && errors.length > 0) {
-        return errors
-            .map((e) => {
-                const prefix =
-                    e.vrfcCd === "IMR"
-                        ? "시계열 검증 - "
-                        : e.vrfcCd === "NV"
-                          ? "일반검증 - "
-                          : "모집단 검증 - ";
-                return `${prefix}${e.rsnExpln}
-(검증 기준값: ${e.cmprCn} / 현재 입력값: ${e.nowCn})`;
-            })
-            .filter(Boolean)
-            .join("\n");
+        return formatVerificationTooltip(errors);
     }
 }
 
@@ -588,7 +581,7 @@ function mapListToGridRows<T extends { verificationResult?: SewageExcretaRelated
     return filterBySelectedAdmdstCd(list, sidoListRef.current, values).map((item) => {
         const row = toGridRows([{ ctpvNm, ...item }])[0] as GridRowWithVerification;
         if (item.verificationResult) {
-            row.verificationResult = item.verificationResult;
+            row.verificationResult = normalizeVerificationResultMap(item.verificationResult);
         }
         return row;
     });
@@ -1410,7 +1403,6 @@ const SewageExcretaRelatedInp = () => {
             lclgvIdfrDeptNm: submitInfo.lclgvIdfrDeptNm,
             lclgvIdfrJbgdNm: submitInfo.lclgvIdfrJbgdNm,
             ...(isPublicInstitutionTab ? { noApplicable } : {}),
-            ...(isAdminInfo ? { superAdmin: "superAdmin" as const } : {}),
         };
 
         const verificationQuery = {
@@ -1504,7 +1496,13 @@ const SewageExcretaRelatedInp = () => {
                 };
 
                 try {
-                    const imrResponse = await statisticsApi.callImrService(imrParam);
+                    const imrResponse = await callImrServiceWithRollbackOnFailure(imrParam, {
+                        statsYr: lastSearchedValues.year ?? "",
+                        statsCd: statsCdForTab,
+                        sewerBzmnCd: lastSearchedValues?.bsnmCd ?? "",
+                        rollbackStatusCode: activeTabStatus?.lclgvSbmsnSttsCd ?? "",
+                        mdfrUuid: userInfo.userUnqId,
+                    });
                     if (imrResponse.job_id) {
                         await waitForImrJobCompleted(
                             imrResponse.job_id,

apps/st/src/components/statistics/input/SewageExcretaSlurgeInp.tsx

@@ -21,6 +21,7 @@ import { nullableTrimmedString } from "@/components/util/input/nullableString";
 import { statisticsInputSewSupplyRateApi } from "@/entities/statistics/api/input/statistics-input-sew-supply-rate-service";
 import { statisticsInputSewageExcretaSlurgeApi } from "@/entities/statistics/api/input/statistics-input-sewage-excreta-slurge-service";
 import { statisticsApi } from "@/entities/statistics/api/statistics-service";
+import { callImrServiceWithRollbackOnFailure } from "@/components/util/input/call-imr-with-rollback";
 import type {
     DigestorOperatingStatusSaveItem,
     ExcretaSlurgeProcessingStatusSaveItem,
@@ -90,7 +91,11 @@ import {
     patchFooterVerificationByTab,
     patchVerificationFailedByTab,
 } from "@/components/util/input/verification-failed-flag";
-import type { VerificationResultLikeMap } from "@/components/util/input/verification-result-display";
+import {
+    formatVerificationTooltip,
+    normalizeVerificationResultMap,
+    type VerificationResultLikeMap,
+} from "@/components/util/input/verification-result-display";
 import { useAdminStore } from "@/store/admin-store";
 import { useTabStore } from "@/store/tab-store";
 
@@ -148,19 +153,7 @@ function verificationCellTooltip({
     if (!verification) return;
     const errors = verification[fieldName];
     if (Array.isArray(errors) && errors.length > 0) {
-        return errors
-            .map((e) => {
-                const prefix =
-                    e.vrfcCd === "IMR"
-                        ? "시계열 검증 - "
-                        : e.vrfcCd === "NV"
-                          ? "일반검증 - "
-                          : "모집단 검증 - ";
-                return `${prefix}${e.rsnExpln}
-(검증 기준값: ${e.cmprCn} / 현재 입력값: ${e.nowCn})`;
-            })
-            .filter(Boolean)
-            .join("\n");
+        return formatVerificationTooltip(errors);
     }
 }
 
@@ -185,7 +178,7 @@ function mapListToGridRows<T extends { verificationResult?: SewageExcretaSlurgeV
     return filterBySelectedAdmdstCd(list, sidoListRef.current, values).map((item) => {
         const row = toGridRows([{ ctpvNm, ...item }])[0] as GridRowWithVerification;
         if (item.verificationResult) {
-            row.verificationResult = item.verificationResult;
+            row.verificationResult = normalizeVerificationResultMap(item.verificationResult);
         }
         return row;
     });
@@ -627,7 +620,6 @@ function buildExcretaSlurgeProcessingStatusSaveItem(
         rcycQnt: toGridNumber(row.rcycQnt),
         olandLfvlm: toGridNumber(row.olandLfvlm),
         incnrQnt: toGridNumber(row.incnrQnt),
-        oceanInputQnt: toGridNumber(row.oceanInputQnt),
         fuelQnt: toGridNumber(row.fuelQnt),
         etcQnt: toGridNumber(row.etcQnt),
         unprcsQnt: toGridNumber(row.unprcsQnt),
@@ -1357,11 +1349,6 @@ const SewageExcretaSlurgeInp = () => {
                 : rowsForSubmit.map((row) =>
                       buildExcretaSlurgeProcessingStatusSaveItem(row, list),
                   );
-        const slurgeDeleteList = isSlurgeFacTab
-            ? (deleteListByTab.get(tabKey) ?? [])
-                  .filter((row) => isPersistedArticleRowForTab(tabKey, row))
-                  .map((row) => buildSlurgeProcessingFacStatusSaveItem(row, list))
-            : [];
         const sewageSlurgeFacDeleteList = isSewageSlurgeFacTab
             ? (deleteListByTab.get(tabKey) ?? [])
                   .filter((row) => isPersistedArticleRowForTab(tabKey, row))
@@ -1432,7 +1419,6 @@ const SewageExcretaSlurgeInp = () => {
             lclgvIdfrTelnoCn: submitInfo.lclgvIdfrTelnoCn,
             lclgvIdfrDeptNm: submitInfo.lclgvIdfrDeptNm,
             lclgvIdfrJbgdNm: submitInfo.lclgvIdfrJbgdNm,
-            ...(isAdminInfo ? { superAdmin: "superAdmin" as const } : {}),
             noApplicable,
         };
 
@@ -1445,7 +1431,6 @@ const SewageExcretaSlurgeInp = () => {
                       ...submitRequestBase,
                       userUuid: userInfo.userUnqId,
                       submitList: slurgeSubmitList,
-                      deleteList: slurgeDeleteList,
                   })
                 : isDigestorTab
                   ? await statisticsInputSewageExcretaSlurgeApi.submitDigestorOperatingStatus({
@@ -1493,7 +1478,13 @@ const SewageExcretaSlurgeInp = () => {
                 };
 
                 try {
-                    const imrResponse = await statisticsApi.callImrService(imrParam);
+                    const imrResponse = await callImrServiceWithRollbackOnFailure(imrParam, {
+                        statsYr: lastSearchedValues.year ?? "",
+                        statsCd: statsCdForSubmit,
+                        sewerBzmnCd: lastSearchedValues?.bsnmCd ?? "",
+                        rollbackStatusCode: activeTabStatus?.lclgvSbmsnSttsCd ?? "",
+                        mdfrUuid: userInfo.userUnqId,
+                    });
                     if (imrResponse.job_id) {
                         await waitForImrJobCompleted(
                             imrResponse.job_id,
@@ -1655,9 +1646,6 @@ const SewageExcretaSlurgeInp = () => {
                         : rowsForSave.map((row) =>
                               buildSlurgeProcessingFacStatusSaveItem(row, list),
                           );
-                    const deleteList = (deleteListByTab.get(tabKey) ?? [])
-                        .filter((row) => isPersistedArticleRowForTab(tabKey, row))
-                        .map((row) => buildSlurgeProcessingFacStatusSaveItem(row, list));
 
                     if (!noApplicable && saveList.length === 0 && buildSubmitOkForToolbar(searchContextByTab.get(tabKey) ?? lastSearchedValues)) {
                         alert("해당사항 없음을 체크해주세요.");
@@ -1670,7 +1658,6 @@ const SewageExcretaSlurgeInp = () => {
                                 ...baseSaveRequest,
                                 ...userFields,
                                 saveList,
-                                deleteList,
                             },
                         );
                 } else if (tabKey === DigestorOperatingStatusInpColumn.tabKey) {

apps/st/src/components/statistics/input/SewagePipeInp.tsx

@@ -10,6 +10,7 @@ import {
 import { statisticsInputSewSupplyRateApi } from "@/entities/statistics/api/input/statistics-input-sew-supply-rate-service";
 import { statisticsInputSewPipeApiService } from "@/entities/statistics/api/input/statistics-sewage-pipe-input-service";
 import { statisticsApi } from "@/entities/statistics/api/statistics-service";
+import { callImrServiceWithRollbackOnFailure } from "@/components/util/input/call-imr-with-rollback";
 import type {
     SeweragePipeInputFactInstallStatusSaveRequest,
     SeweragePipeInputFactInstallStatusSubmitRequest,
@@ -82,7 +83,10 @@ import {
 } from "@/components/util/input/verification-failed-flag";
 import { nullableTrimmedString } from "@/components/util/input/nullableString";
 import {
+    formatVerificationTooltip,
     getVerificationErrorsForField,
+    normalizeVerificationResultMap,
+    withNormalizedVerificationResult,
     type VerificationResultLikeMap,
 } from "@/components/util/input/verification-result-display";
 import { useAdminStore } from "@/store/admin-store";
@@ -289,7 +293,10 @@ function normalizePipeTypeStatusRow(
         lyngPrlg: Number(lyngPrlgWhol ?? 0),
         dmltnPrlg: Number(dmltnPrlgWhol ?? 0),
         ...yearFields,
-        verificationResult: remapPipeTypePrlgWholVerification(verificationResult) ?? undefined,
+        verificationResult:
+            normalizeVerificationResultMap(
+                remapPipeTypePrlgWholVerification(verificationResult),
+            ) ?? undefined,
     };
 }
 
@@ -350,7 +357,6 @@ function buildRegionalFactSubmitListFromGrid(
     };
     return currentData.map((d) => ({
         admdstCd: nullableTrimmedString(d.admdstCd),
-        sggNm: nullableTrimmedString(d.sggNm),
         admdstNm: nullableTrimmedString(d.admdstNm),
         goalYr: nullableTrimmedString(d.goalYr),
         wholPplMtncPlanPrlg: formatNumber(d.wholPplMtncPlanPrlg, "wholPplMtncPlanPrlg"),
@@ -720,10 +726,12 @@ const SewagePipeInp = () => {
             const response = await statisticsInputSewPipeApiService.getRegionalFactStatus(searchParam);
             if (response.status === 'success') {
                 const commonInfo = response.data.commonInfo;
-                const convertedData = filterFetched(response.data.regionalFactStatusList).map((d) => ({
-                    ctpvNm: commonInfo.ctpvNm,
-                    ...d,
-                }));
+                const convertedData = filterFetched(response.data.regionalFactStatusList).map((d) =>
+                    withNormalizedVerificationResult({
+                        ctpvNm: commonInfo.ctpvNm,
+                        ...d,
+                    }),
+                );
                 applyRowMap((m) => m.set('ST00020001', toGridRows(convertedData)));
                 setTabStatusInfoMap((prev) => new Map(prev).set(tabKey, response.data.statusInfo));
                 setTabStatsCdMap((prev) => new Map(prev).set(tabKey, commonInfo.statsCd));
@@ -750,10 +758,12 @@ const SewagePipeInp = () => {
             const response = await statisticsInputSewPipeApiService.getFactInstallStatus(searchParam);
             if (response.status === 'success') {
                 const commonInfo = response.data.commonInfo;
-                const convertedData = filterFetched(response.data.factInstallStatusList).map((d) => ({
-                    ctpvNm: commonInfo.ctpvNm,
-                    ...d,
-                }));
+                const convertedData = filterFetched(response.data.factInstallStatusList).map((d) =>
+                    withNormalizedVerificationResult({
+                        ctpvNm: commonInfo.ctpvNm,
+                        ...d,
+                    }),
+                );
                 if (convertedData.length === 0) {
                     const alreadyHandledForSameSearch =
                         factInstallNoDataHandledKeyRef.current === searchConditionKey;
@@ -830,10 +840,12 @@ const SewagePipeInp = () => {
             const response = await statisticsInputSewPipeApiService.getPipeDiameterStatus(searchParam);
             if (response.status === 'success') {
                 const commonInfo = response.data.commonInfo;
-                const convertedData = filterFetched(response.data.pipeDiameterStatusList).map((d) => ({
-                    ctpvNm: commonInfo.ctpvNm,
-                    ...d,
-                }));
+                const convertedData = filterFetched(response.data.pipeDiameterStatusList).map((d) =>
+                    withNormalizedVerificationResult({
+                        ctpvNm: commonInfo.ctpvNm,
+                        ...d,
+                    }),
+                );
                 applyRowMap((m) => m.set('ST00020004', toGridRows(convertedData)));
                 setTabStatusInfoMap((prev) => new Map(prev).set(tabKey, response.data.statusInfo));
                 setTabStatsCdMap((prev) => new Map(prev).set(tabKey, commonInfo.statsCd));
@@ -860,10 +872,12 @@ const SewagePipeInp = () => {
             const response = await statisticsInputSewPipeApiService.getManholeStatus(searchParam);
             if (response.status === 'success') {
                 const commonInfo = response.data.commonInfo;
-                const convertedData = filterFetched(response.data.manholeStatusList).map((d) => ({
-                    ctpvNm: commonInfo.ctpvNm,
-                    ...d,
-                }));
+                const convertedData = filterFetched(response.data.manholeStatusList).map((d) =>
+                    withNormalizedVerificationResult({
+                        ctpvNm: commonInfo.ctpvNm,
+                        ...d,
+                    }),
+                );
                 applyRowMap((m) => m.set('ST00020005', toGridRows(convertedData)));
                 setTabStatusInfoMap((prev) => new Map(prev).set(tabKey, response.data.statusInfo));
                 setTabStatsCdMap((prev) => new Map(prev).set(tabKey, commonInfo.statsCd));
@@ -890,13 +904,15 @@ const SewagePipeInp = () => {
             const response = await statisticsInputSewPipeApiService.getConnectionStatus(searchParam);
             if (response.status === 'success') {
                 const commonInfo = response.data.commonInfo;
-                const facilityConvertedData = filterFetched(response.data.facilityConnectionList).map((d) => ({
-                    ...d,
-                }));
-                const adminConvertedData = filterFetched(response.data.adminAreaConnectionList).map((d) => ({
-                    ...d,
-                    ctpvNm: d.ctpvNm || commonInfo.ctpvNm,
-                }));
+                const facilityConvertedData = filterFetched(response.data.facilityConnectionList).map((d) =>
+                    withNormalizedVerificationResult({ ...d }),
+                );
+                const adminConvertedData = filterFetched(response.data.adminAreaConnectionList).map((d) =>
+                    withNormalizedVerificationResult({
+                        ...d,
+                        ctpvNm: d.ctpvNm || commonInfo.ctpvNm,
+                    }),
+                );
                 applyRowMap((m) => {
                     m.set('treatmentPlantConnectionInp', toGridRows(facilityConvertedData));
                     m.set('adminAreaConnectionInp', toGridRows(adminConvertedData));
@@ -1264,7 +1280,6 @@ const SewagePipeInp = () => {
                     };
                     const submitList = currentData.map((d) => ({
                         admdstCd: nullableTrimmedString(d.admdstCd),
-                        sggNm: nullableTrimmedString(d.sggNm),
                         admdstNm: nullableTrimmedString(d.admdstNm),
                         fcltSn: nullableTrimmedString(d.fcltSn),
                         swtrmtFcltCd: nullableTrimmedString(d.swtrmtFcltCd),
@@ -1340,7 +1355,6 @@ const SewagePipeInp = () => {
                             rmrk: nullableTrimmedString(d.rmrk),
                             lyngPrlgWhol: formatNumber(d.lyngPrlg, "lyngPrlg"),
                             dmltnPrlgWhol: formatNumber(d.dmltnPrlg, "dmltnPrlg"),
-                            pipeByPrstWhol: formatNumber(d.pipeByPrstWhol, "pipeByPrstWhol"),
                         };
                     });
                     const requestData: SeweragePipeInputPipeTypeStatusSubmitRequest = {
@@ -1457,7 +1471,13 @@ const SewagePipeInp = () => {
                 };
 
                 try {
-                    const imrResponse = await statisticsApi.callImrService(imrParam);
+                    const imrResponse = await callImrServiceWithRollbackOnFailure(imrParam, {
+                        statsYr: values.year ?? "",
+                        statsCd: statsCdForTab,
+                        sewerBzmnCd: values?.bsnmCd ?? "",
+                        rollbackStatusCode: statusForTab?.lclgvSbmsnSttsCd ?? "",
+                        mdfrUuid: userInfo.userUnqId,
+                    });
                     if (imrResponse.job_id) {
                         await waitForImrJobCompleted(
                             imrResponse.job_id,
@@ -1637,7 +1657,6 @@ const SewagePipeInp = () => {
 
                     const saveList = currentData.map((d) => ({
                         admdstCd: nullableTrimmedString(d.admdstCd),
-                        sggNm: nullableTrimmedString(d.sggNm),
                         admdstNm: nullableTrimmedString(d.admdstNm),
                         goalYr: nullableTrimmedString(d.goalYr),
                         wholPplMtncPlanPrlg: formatNumber(d.wholPplMtncPlanPrlg, "wholPplMtncPlanPrlg"),
@@ -1728,7 +1747,6 @@ const SewagePipeInp = () => {
 
                     const saveList = currentData.map((d) => ({
                         admdstCd: nullableTrimmedString(d.admdstCd),
-                        sggNm: nullableTrimmedString(d.sggNm),
                         admdstNm: nullableTrimmedString(d.admdstNm),
                         fcltSn: nullableTrimmedString(d.fcltSn),
                         swtrmtFcltCd: nullableTrimmedString(d.swtrmtFcltCd),
@@ -1834,7 +1852,6 @@ const SewagePipeInp = () => {
                             rmrk: nullableTrimmedString(d.rmrk),
                             lyngPrlgWhol: formatNumber(d.lyngPrlg, "lyngPrlg"),
                             dmltnPrlgWhol: formatNumber(d.dmltnPrlg, "dmltnPrlg"),
-                            pipeByPrstWhol: formatNumber(d.pipeByPrstWhol, "pipeByPrstWhol"),
                         };
                     });
 
@@ -2241,17 +2258,7 @@ const SewagePipeInp = () => {
                                             tabKey,
                                         );
                                         if (Array.isArray(errors) && errors.length > 0) {
-                                            return errors
-                                                .map((e) => {
-                                                    const prefix =
-                                                        e.vrfcCd === "IMR" ? "시계열 검증 - " : (e.vrfcCd === "NV" ? "일반검증 - " : "모집단 검증 - ");
-                                                    const comp = e.cmprCn ?? "";
-                                                    const now = e.nowCn ?? "";
-                                                    return `${prefix}${e.rsnExpln}
-                                                    (검증 기준값: ${comp} / 현재 입력값: ${now})`;
-                                                })
-                                                .filter(Boolean)
-                                                .join("\n");
+                                            return formatVerificationTooltip(errors);
                                         }
                                     }}
                                 />

apps/st/src/components/statistics/input/SewagePipeMaintainInp.tsx

@@ -11,6 +11,7 @@ import { ConfirmDialog } from "@/shared/ui/confirm-dialog";
 import { statisticsInputSewSupplyRateApi } from "@/entities/statistics/api/input/statistics-input-sew-supply-rate-service";
 import { sewagePipeMaintainApiService } from "@/entities/statistics/api/input/statistics-input-sewage-pipe-maintain-service";
 import { statisticsApi } from "@/entities/statistics/api/statistics-service";
+import { callImrServiceWithRollbackOnFailure } from "@/components/util/input/call-imr-with-rollback";
 import type {
     SewagePipeMaintainDredgingSaveItem,
     SewagePipeMaintainDredgingSaveRequest,
@@ -69,7 +70,11 @@ import {
     patchFooterVerificationByTab,
     patchVerificationFailedByTab,
 } from "@/components/util/input/verification-failed-flag";
-import type { VerificationResultLikeMap } from "@/components/util/input/verification-result-display";
+import {
+    formatVerificationTooltip,
+    withNormalizedVerificationResult,
+    type VerificationResultLikeMap,
+} from "@/components/util/input/verification-result-display";
 import { nullableTrimmedString } from "@/components/util/input/nullableString";
 import { useAdminStore } from "@/store/admin-store";
 import { useStatisticsInputFocusStore } from "@/store/statistics-input-focus-store";
@@ -218,7 +223,6 @@ function buildRepairRowList(
 
     return currentData.map((d) => ({
         admdstCd: nullableTrimmedString(d.admdstCd),
-        sggNm: nullableTrimmedString(d.sggNm),
         admdstNm: nullableTrimmedString(d.admdstNm),
         dfrpWholPrlg: formatNumber(d.dfrpWholPrlg, "dfrpWholPrlg"),
         cbsysDfrpPrlg: formatNumber(d.cbsysDfrpPrlg, "cbsysDfrpPrlg"),
@@ -247,7 +251,6 @@ function buildDredgingRowList(
 
     return currentData.map((d) => ({
         admdstCd: nullableTrimmedString(d.admdstCd),
-        sggNm: nullableTrimmedString(d.sggNm),
         admdstNm: nullableTrimmedString(d.admdstNm),
         wholFcltPrlg: formatNumber(d.wholFcltPrlg, "wholFcltPrlg"),
         wholSwagePpl: formatNumber(d.wholSwagePpl, "wholSwagePpl"),
@@ -446,10 +449,12 @@ const SewagePipeMaintainInp = () => {
                 repairStatusList ?? [],
                 sidoListRef.current,
                 searchContext,
-            ).map((d) => ({
-                ctpvNm: commonInfo.ctpvNm,
-                ...d,
-            }));
+            ).map((d) =>
+                withNormalizedVerificationResult({
+                    ctpvNm: commonInfo.ctpvNm,
+                    ...d,
+                }),
+            );
             const gridRows = toGridRows(convertedData);
 
             applyRowMap(mergeIntoExistingMap, (m) => {
@@ -489,10 +494,12 @@ const SewagePipeMaintainInp = () => {
                 pipeDredgingStatusList ?? [],
                 sidoListRef.current,
                 searchContext,
-            ).map((d) => ({
-                ctpvNm: commonInfo.ctpvNm,
-                ...d,
-            }));
+            ).map((d) =>
+                withNormalizedVerificationResult({
+                    ctpvNm: commonInfo.ctpvNm,
+                    ...d,
+                }),
+            );
             const gridRows = toGridRows(convertedData);
 
             applyRowMap(mergeIntoExistingMap, (m) => {
@@ -680,7 +687,13 @@ const SewagePipeMaintainInp = () => {
                 };
 
                 try {
-                    const imrResponse = await statisticsApi.callImrService(imrParam);
+                    const imrResponse = await callImrServiceWithRollbackOnFailure(imrParam, {
+                        statsYr: lastSearchedValues.year ?? "",
+                        statsCd: statsCdForTab,
+                        sewerBzmnCd: lastSearchedValues?.bsnmCd ?? "",
+                        rollbackStatusCode: activeTabStatus?.lclgvSbmsnSttsCd ?? "",
+                        mdfrUuid: userInfo.userUnqId,
+                    });
                     if (imrResponse.job_id) {
                         await waitForImrJobCompleted(
                             imrResponse.job_id,
@@ -1105,14 +1118,7 @@ const SewagePipeMaintainInp = () => {
         if (!verification) return;
         const errors = verification[fieldName];
         if (Array.isArray(errors) && errors.length > 0) {
-            return errors
-                .map((e) => {
-                    const prefix =
-                        e.vrfcCd === "IMR" ? "시계열 검증 - " : e.vrfcCd === "NV" ? "일반검증 - " : "모집단 검증 - ";
-                    return `${prefix}${e.rsnExpln}(검증 기준값: ${e.cmprCn} / 현재 입력값: ${e.nowCn})`;
-                })
-                .filter(Boolean)
-                .join("\n");
+            return formatVerificationTooltip(errors);
         }
     };
 

apps/st/src/components/statistics/input/SewageReservoirPumpInp.tsx

@@ -21,6 +21,7 @@ import { nullableTrimmedString } from "@/components/util/input/nullableString";
 import { statisticsInputSewSupplyRateApi } from "@/entities/statistics/api/input/statistics-input-sew-supply-rate-service";
 import { statisticsInputSewageReservoirPumpApi } from "@/entities/statistics/api/input/statistics-input-sewage-reservoir-pump-service";
 import { statisticsApi } from "@/entities/statistics/api/statistics-service";
+import { callImrServiceWithRollbackOnFailure } from "@/components/util/input/call-imr-with-rollback";
 import {
     type RainfallPumpStationItem,
     type RainfallPumpStationSaveItem,
@@ -89,7 +90,11 @@ import {
     patchFooterVerificationByTab,
     patchVerificationFailedByTab,
 } from "@/components/util/input/verification-failed-flag";
-import type { VerificationResultLikeMap } from "@/components/util/input/verification-result-display";
+import {
+    formatVerificationTooltip,
+    normalizeVerificationResultMap,
+    type VerificationResultLikeMap,
+} from "@/components/util/input/verification-result-display";
 import { useAdminStore } from "@/store/admin-store";
 import { useTabStore } from "@/store/tab-store";
 
@@ -279,7 +284,7 @@ function mapSewageReservoirListToGridRows(
             },
         ])[0] as GridRowWithVerification;
         if (item.verificationResult) {
-            row.verificationResult = item.verificationResult;
+            row.verificationResult = normalizeVerificationResultMap(item.verificationResult);
         }
         return row;
     });
@@ -435,7 +440,7 @@ function mapRainfallPumpStationListToGridRows(
         ])[0] as GridRowWithVerification;
 
         if (item.verificationResult) {
-            row.verificationResult = item.verificationResult;
+            row.verificationResult = normalizeVerificationResultMap(item.verificationResult);
         }
         return row;
     });
@@ -864,7 +869,13 @@ const SewageReservoirPumpInp = () => {
                 };
 
                 try {
-                    const imrResponse = await statisticsApi.callImrService(imrParam);
+                    const imrResponse = await callImrServiceWithRollbackOnFailure(imrParam, {
+                        statsYr: lastSearchedValues.year ?? "",
+                        statsCd: statsCdForTab,
+                        sewerBzmnCd: lastSearchedValues?.bsnmCd ?? "",
+                        rollbackStatusCode: activeTabStatus?.lclgvSbmsnSttsCd ?? "",
+                        mdfrUuid: userInfo.userUnqId,
+                    });
                     if (imrResponse.job_id) {
                         await waitForImrJobCompleted(
                             imrResponse.job_id,
@@ -1516,19 +1527,7 @@ const SewageReservoirPumpInp = () => {
         if (!verification) return;
         const errors = verification[fieldName];
         if (Array.isArray(errors) && errors.length > 0) {
-            return errors
-                .map((e) => {
-                    const prefix =
-                        e.vrfcCd === "IMR"
-                            ? "시계열 검증 - "
-                            : e.vrfcCd === "NV"
-                                ? "일반검증 - "
-                                : "모집단 검증 -";
-                    return `${prefix}${e.rsnExpln}
-(검증 기준값: ${e.cmprCn} / 현재 입력값: ${e.nowCn})`;
-                })
-                .filter(Boolean)
-                .join("\n");
+            return formatVerificationTooltip(errors);
         }
     };
 

apps/st/src/components/statistics/input/SewerageFinanceInp.tsx

@@ -8,6 +8,7 @@ import { useStatisticsInputPendingNavigation } from "@/shared/lib/use-statistics
 import { statisticsInputSewSupplyRateApi } from "@/entities/statistics/api/input/statistics-input-sew-supply-rate-service";
 import { statisticsInputSewerageFinanceApi } from "@/entities/statistics/api/input/statistics-input-sewerage-finance-service";
 import { statisticsApi } from "@/entities/statistics/api/statistics-service";
+import { callImrServiceWithRollbackOnFailure } from "@/components/util/input/call-imr-with-rollback";
 import type {
     CauserBurdenItem,
     CauserBurdenSaveItem,
@@ -73,7 +74,11 @@ import {
     patchFooterVerificationByTab,
     patchVerificationFailedByTab,
 } from "@/components/util/input/verification-failed-flag";
-import type { VerificationResultLikeMap } from "@/components/util/input/verification-result-display";
+import {
+    formatVerificationTooltip,
+    normalizeVerificationResultMap,
+    type VerificationResultLikeMap,
+} from "@/components/util/input/verification-result-display";
 import { nullableTrimmedString } from "@/components/util/input/nullableString";
 import { useAdminStore } from "@/store/admin-store";
 import { useTabStore } from "@/store/tab-store";
@@ -174,7 +179,9 @@ function mapRegionalListToGridRows<
     return filterBySelectedAdmdstCd(list, sidoListRef.current, values).map((item) => {
         const { verificationResult, ...rest } = item;
         const row = toGridRows([{ ctpvNm, ...rest }])[0] as GridRowWithVerification;
-        if (verificationResult) row.verificationResult = verificationResult;
+        if (verificationResult) {
+            row.verificationResult = normalizeVerificationResultMap(verificationResult);
+        }
         return row;
     });
 }
@@ -215,7 +222,6 @@ function buildSewerageFinanceSettleSaveList(
 
     return currentData.map((d) => ({
         admdstCd: nullableTrimmedString(d.admdstCd),
-        sggNm: nullableTrimmedString(d.sggNm),
         admdstNm: nullableTrimmedString(d.admdstNm),
         soaGovSprtAmt: formatNumber(d.soaGovSprtAmt, "soaGovSprtAmt"),
         mctpvLcexpAmt: formatNumber(d.mctpvLcexpAmt, "mctpvLcexpAmt"),
@@ -257,7 +263,6 @@ function buildSewerageChargeSaveList(
 
     return currentData.map((d) => ({
         admdstCd: nullableTrimmedString(d.admdstCd),
-        sggNm: nullableTrimmedString(d.sggNm),
         admdstNm: nullableTrimmedString(d.admdstNm),
         anlLevyQnt: formatNumber(d.anlLevyQnt, "anlLevyQnt"),
         sewerLevyAmt: formatNumber(d.sewerLevyAmt, "sewerLevyAmt"),
@@ -276,7 +281,6 @@ function buildSewerageUsageFeeSaveList(
 
     return currentData.map((d) => ({
         admdstCd: nullableTrimmedString(d.admdstCd),
-        sggNm: nullableTrimmedString(d.sggNm),
         admdstNm: nullableTrimmedString(d.admdstNm),
         hshusLevyAmt: formatNumber(d.hshusLevyAmt, "hshusLevyAmt"),
         hshusLevyQnt: formatNumber(d.hshusLevyQnt, "hshusLevyQnt"),
@@ -312,7 +316,6 @@ function buildCauserBurdenSaveList(
 
     return currentData.map((d) => ({
         admdstCd: nullableTrimmedString(d.admdstCd),
-        sggNm: nullableTrimmedString(d.sggNm),
         admdstNm: nullableTrimmedString(d.admdstNm),
         brdnAmtLevyNocs: formatNumber(d.brdnAmtLevyNocs, "brdnAmtLevyNocs"),
         brdnAmtLevyAmt: formatNumber(d.brdnAmtLevyAmt, "brdnAmtLevyAmt"),
@@ -849,7 +852,6 @@ const SewerageFinanceInp = () => {
 
         const activeTabStatus = tabStatusInfoMap.get(tabKey) ?? null;
         const statsCdForTab = tabStatsCdMap.get(tabKey) ?? tabKey;
-        const adminOpt = isAdminInfo ? { superAdmin: "superAdmin" as const } : {};
 
         const submitInfoBase = {
             statsYr: lastSearchedValues.year ?? "",
@@ -894,7 +896,6 @@ const SewerageFinanceInp = () => {
                     ...submitInfoBase,
                     userUuid: userInfo.userUnqId,
                     submitList: buildSewerageFinanceSettleSaveList(currentData),
-                    ...adminOpt,
                 };
                 response =
                     await statisticsInputSewerageFinanceApi.submitSewerageFinanceSettle(
@@ -905,7 +906,6 @@ const SewerageFinanceInp = () => {
                     ...submitInfoBase,
                     userUuid: userInfo.userUnqId,
                     submitList: buildSewerageChargeSaveList(currentData),
-                    ...adminOpt,
                 };
                 response = await statisticsInputSewerageFinanceApi.submitSewerageCharge(param);
             } else if (isUsageFeeTab) {
@@ -913,7 +913,6 @@ const SewerageFinanceInp = () => {
                     ...submitInfoBase,
                     userUuid: userInfo.userUnqId,
                     submitList: buildSewerageUsageFeeSaveList(currentData),
-                    ...adminOpt,
                 };
                 response =
                     await statisticsInputSewerageFinanceApi.submitSewerageUsageFee(param);
@@ -922,7 +921,6 @@ const SewerageFinanceInp = () => {
                     ...submitInfoBase,
                     userUuid: userInfo.userUnqId,
                     submitList: buildCauserBurdenSaveList(currentData),
-                    ...adminOpt,
                 };
                 response = await statisticsInputSewerageFinanceApi.submitCauserBurden(param);
             }
@@ -949,7 +947,13 @@ const SewerageFinanceInp = () => {
                 };
 
                 try {
-                    const imrResponse = await statisticsApi.callImrService(imrParam);
+                    const imrResponse = await callImrServiceWithRollbackOnFailure(imrParam, {
+                        statsYr: lastSearchedValues.year ?? "",
+                        statsCd: statsCdForTab,
+                        sewerBzmnCd: lastSearchedValues?.bsnmCd ?? "",
+                        rollbackStatusCode: activeTabStatus?.lclgvSbmsnSttsCd ?? "",
+                        mdfrUuid: userInfo.userUnqId,
+                    });
                     if (imrResponse.job_id) {
                         await waitForImrJobCompleted(
                             imrResponse.job_id,
@@ -1224,18 +1228,7 @@ const SewerageFinanceInp = () => {
         if (!verification) return;
         const errors = verification[fieldName];
         if (Array.isArray(errors) && errors.length > 0) {
-            return errors
-                .map((e) => {
-                    const prefix =
-                        e.vrfcCd === "IMR"
-                            ? "시계열 검증 - "
-                            : e.vrfcCd === "NV"
-                              ? "일반검증 - "
-                              : "모집단 검증 - ";
-                    return `${prefix}${e.rsnExpln}(검증 기준값: ${e.cmprCn} / 현재 입력값: ${e.nowCn})`;
-                })
-                .filter(Boolean)
-                .join("\n");
+            return formatVerificationTooltip(errors);
         }
     };
 

apps/st/src/components/statistics/input/SeweragePenetrationRateInp.tsx

@@ -10,6 +10,7 @@ import {
 import { ConfirmDialog } from "@/shared/ui/confirm-dialog";
 import { statisticsInputSewSupplyRateApi } from "@/entities/statistics/api/input/statistics-input-sew-supply-rate-service";
 import { statisticsApi } from "@/entities/statistics/api/statistics-service";
+import { callImrServiceWithRollbackOnFailure } from "@/components/util/input/call-imr-with-rollback";
 import {
     type CheckInputPeriodItem,
     getVerificationPeriodActionBlockedMessage,
@@ -58,7 +59,11 @@ import { toGridRows } from "@/components/util/grid/gridFunction";
 import { toExcelExportSearchContextFromSearchForm } from "@/components/util/gridExcelExport";
 import { nullableTrimmedString } from "@/components/util/input/nullableString";
 import { isVerificationFailedFromCommonInfo } from "@/components/util/input/verification-failed-flag";
-import type { VerificationResultLikeMap } from "@/components/util/input/verification-result-display";
+import {
+    formatVerificationTooltip,
+    normalizeVerificationResultMap,
+    type VerificationResultLikeMap,
+} from "@/components/util/input/verification-result-display";
 import { useAdminStore } from "@/store/admin-store";
 import { useStatisticsInputFocusStore } from "@/store/statistics-input-focus-store";
 import { useTabStore } from "@/store/tab-store";
@@ -87,7 +92,7 @@ const remapCommonInfoVerificationToGridFields = (
         // API 키로도 조회 가능하도록 유지
         if (gridField !== key) remapped[key] = errors;
     }
-    return remapped;
+    return normalizeVerificationResultMap(remapped) ?? remapped;
 };
 
 /** 컬럼 가이드 API 조회용 통계코드 (하수도 보급률) */
@@ -302,7 +307,11 @@ const SeweragePenetrationRateInp = () => {
                 setRowData(
                     convertedData.map((d) => {
                         const row = toGridRows([d])[0] as GridRowWithVerification;
-                        if (d.verificationResult) row.verificationResult = d.verificationResult;
+                        if (d.verificationResult) {
+                            row.verificationResult = normalizeVerificationResultMap(
+                                d.verificationResult,
+                            );
+                        }
                         return row;
                     })
                 );
@@ -399,10 +408,6 @@ const SeweragePenetrationRateInp = () => {
             statsCd: statsCd,
         };
 
-        if (isAdminInfo) {
-            params.superAdmin = 'superAdmin';
-        }
-
         try {
             setIsLoading(true);
 
@@ -498,7 +503,6 @@ const SeweragePenetrationRateInp = () => {
             };
 
             const convertedData: SewerageSupplyRateSaveItem[] = currentData.map((d) => ({
-                sggNm: nullableTrimmedString(d.sggNm),
                 admdstCd: nullableTrimmedString(d.admdstCd),
                 admdstNm: nullableTrimmedString(d.admdstNm),
                 statsTrbtrNm: nullableTrimmedString(d.statsTrbtrNm),
@@ -563,7 +567,13 @@ const SeweragePenetrationRateInp = () => {
                     };
 
                     try {
-                        const imrResponse = await statisticsApi.callImrService(imrParam);
+                        const imrResponse = await callImrServiceWithRollbackOnFailure(imrParam, {
+                            statsYr: searchValues?.year ?? "",
+                            statsCd,
+                            sewerBzmnCd: searchValues?.bsnmCd ?? "",
+                            rollbackStatusCode: statusInfo?.lclgvSbmsnSttsCd ?? "",
+                            mdfrUuid: userInfo.userUnqId,
+                        });
                         if (imrResponse.job_id) {
                             await waitForImrJobCompleted(imrResponse.job_id, (id) =>
                                 statisticsApi.getImrStatus(id),
@@ -677,8 +687,6 @@ const SeweragePenetrationRateInp = () => {
                 };
 
                 const convertedData: SewerageSupplyRateSaveItem[] = currentData.map((d) => ({
-                    // 행정구역
-                    sggNm: nullableTrimmedString(d.sggNm),                           // 시군구
                     admdstCd: nullableTrimmedString(d.admdstCd),                     // 행정코드
                     admdstNm: nullableTrimmedString(d.admdstNm),                     // 행정구역명
                     statsTrbtrNm: nullableTrimmedString(d.statsTrbtrNm),               // 지류
@@ -874,14 +882,7 @@ const SeweragePenetrationRateInp = () => {
                         if (!verification) return;
                         const errors = verification[fieldName];
                         if (Array.isArray(errors) && errors.length > 0) {
-                            return errors
-                                .map((e) => {
-                                    const prefix = e.vrfcCd === 'IMR' ? '시계열 검증 - ' : (e.vrfcCd === 'NV' ? '일반검증 - ' : '모집단 검증 -');
-                                    return `${prefix}${e.rsnExpln}
-                                    (검증 기준값: ${e.cmprCn} / 현재 입력값: ${e.nowCn})`;
-                                })
-                                .filter(Boolean)
-                                .join('\n');
+                            return formatVerificationTooltip(errors);
                         }
                     }}
                 />

apps/st/src/components/statistics/input/SewerageServiceLevelInp.tsx

@@ -9,6 +9,7 @@ import { ConfirmDialog } from "@/shared/ui/confirm-dialog";
 import { statisticsInputSewSupplyRateApi } from "@/entities/statistics/api/input/statistics-input-sew-supply-rate-service";
 import { statisticsInputSewerageServiceLevelApi } from "@/entities/statistics/api/input/statistics-input-sewerage-service-level-service";
 import { statisticsApi } from "@/entities/statistics/api/statistics-service";
+import { callImrServiceWithRollbackOnFailure } from "@/components/util/input/call-imr-with-rollback";
 import {
     SEWERAGE_SERVICE_LEVEL_COMPLAINT_STATS_CD,
     SEWERAGE_SERVICE_LEVEL_RESIDENT_FRIENDLY_FACT_STATS_CD,
@@ -63,7 +64,11 @@ import {
     patchFooterVerificationByTab,
     patchVerificationFailedByTab,
 } from "@/components/util/input/verification-failed-flag";
-import type { VerificationResultLikeMap } from "@/components/util/input/verification-result-display";
+import {
+    formatVerificationTooltip,
+    normalizeVerificationResultMap,
+    type VerificationResultLikeMap,
+} from "@/components/util/input/verification-result-display";
 import { nullableTrimmedString } from "@/components/util/input/nullableString";
 import { useAdminStore } from "@/store/admin-store";
 import { useTabStore } from "@/store/tab-store";
@@ -187,7 +192,9 @@ function mapServiceLevelListToGridRows<
     return filterBySelectedAdmdstCd(list, sidoListRef.current, values).map((item) => {
         const { verificationResult, ...rest } = item;
         const row = toGridRows([{ ctpvNm, ...rest }])[0] as GridRowWithVerification;
-        if (verificationResult) row.verificationResult = verificationResult;
+        if (verificationResult) {
+            row.verificationResult = normalizeVerificationResultMap(verificationResult);
+        }
         return row;
     });
 }
@@ -808,13 +815,11 @@ const SewerageServiceLevelInp = () => {
                 ? await statisticsInputSewerageServiceLevelApi.submitComplaintList({
                       ...submitInfoBase,
                       userUuid: userInfo.userUnqId,
-                      ...(isAdminInfo ? { superAdmin: "superAdmin" } : {}),
                       submitList: complaintSubmitList,
                   })
                 : await statisticsInputSewerageServiceLevelApi.submitResidentFriendlyFactList({
                       ...submitInfoBase,
                       userUuid: userInfo.userUnqId,
-                      ...(isAdminInfo ? { superAdmin: "superAdmin" } : {}),
                       noApplicable,
                       submitList: residentSubmitList,
                   });
@@ -841,7 +846,13 @@ const SewerageServiceLevelInp = () => {
                 };
 
                 try {
-                    const imrResponse = await statisticsApi.callImrService(imrParam);
+                    const imrResponse = await callImrServiceWithRollbackOnFailure(imrParam, {
+                        statsYr: lastSearchedValues.year ?? "",
+                        statsCd: statsCdForTab,
+                        sewerBzmnCd: lastSearchedValues?.bsnmCd ?? "",
+                        rollbackStatusCode: activeTabStatus?.lclgvSbmsnSttsCd ?? "",
+                        mdfrUuid: userInfo.userUnqId,
+                    });
                     if (imrResponse.job_id) {
                         await waitForImrJobCompleted(
                             imrResponse.job_id,
@@ -1148,18 +1159,7 @@ const SewerageServiceLevelInp = () => {
         if (!verification) return;
         const errors = verification[fieldName];
         if (Array.isArray(errors) && errors.length > 0) {
-            return errors
-                .map((e) => {
-                    const prefix =
-                        e.vrfcCd === "IMR"
-                            ? "시계열 검증 - "
-                            : e.vrfcCd === "NV"
-                              ? "일반검증 - "
-                              : "모집단 검증 - ";
-                    return `${prefix}${e.rsnExpln}(검증 기준값: ${e.cmprCn} / 현재 입력값: ${e.nowCn})`;
-                })
-                .filter(Boolean)
-                .join("\n");
+            return formatVerificationTooltip(errors);
         }
     };
 

apps/st/src/components/statistics/input/StatisticsReviewHistory.tsx

@@ -20,8 +20,8 @@ const StatisticsReviewHistory = () => {
         { name: "ctpvNm", fieldName: "ctpvNm", header: { text: "시도" }, editable: false },
         { name: "sggNm", fieldName: "sggNm", header: { text: "시군구" }, editable: false },
         { name: "menuNm", fieldName: "menuNm", header: { text: "통계항목" }, editable: false },
-        { name: "chckerOpinionSm", fieldName: "chckerOpinionSm", header: { text: "검토자의견" }, editable: false },
-        { name: "wrterOpinionSm", fieldName: "wrterOpinionSm", header: { text: "처리내역" }, editable: false },
+        { name: "splmntOpnnCn", fieldName: "splmntOpnnCn", header: { text: "검토자의견" }, editable: false },
+        { name: "rjctOpnnCn", fieldName: "rjctOpnnCn", header: { text: "반려의견" }, editable: false },
     ];
 
     const columnLayout = [
@@ -29,8 +29,8 @@ const StatisticsReviewHistory = () => {
         "ctpvNm",
         "sggNm",
         "menuNm",
-        "chckerOpinionSm",
-        "wrterOpinionSm",
+        "splmntOpnnCn",
+        "rjctOpnnCn",
     ];
 
     const handleSearch = async (values: SearchFormValues) => {

apps/st/src/components/statistics/input/WaterReuseInp.tsx

@@ -21,6 +21,7 @@ import { nullableTrimmedString } from "@/components/util/input/nullableString";
 import { statisticsInputSewSupplyRateApi } from "@/entities/statistics/api/input/statistics-input-sew-supply-rate-service";
 import { statisticsInputWaterReuseApi } from "@/entities/statistics/api/input/statistics-input-water-reuse-service";
 import { statisticsApi } from "@/entities/statistics/api/statistics-service";
+import { callImrServiceWithRollbackOnFailure } from "@/components/util/input/call-imr-with-rollback";
 import {
     type PublicSewageTreatWaterReuseItem,
     type PublicSewageTreatWaterReuseSaveItem,
@@ -93,7 +94,11 @@ import {
     patchFooterVerificationByTab,
     patchVerificationFailedByTab,
 } from "@/components/util/input/verification-failed-flag";
-import type { VerificationResultLikeMap } from "@/components/util/input/verification-result-display";
+import {
+    formatVerificationTooltip,
+    normalizeVerificationResultMap,
+    type VerificationResultLikeMap,
+} from "@/components/util/input/verification-result-display";
 import { useAdminStore } from "@/store/admin-store";
 import { useTabStore } from "@/store/tab-store";
 
@@ -443,7 +448,9 @@ function mapPublicSewageTreatWaterReuseListToGridRows(
                 instlAprvYmd: formatCompactYmdForGrid(item.instlAprvYmd),
             },
         ])[0] as GridRowWithVerification;
-        if (verificationResult) row.verificationResult = verificationResult;
+        if (verificationResult) {
+            row.verificationResult = normalizeVerificationResultMap(verificationResult);
+        }
         return row;
     });
 }
@@ -462,7 +469,9 @@ function mapRecycledWaterStatusListToGridRows(
                 oprtngStrtYmd: formatCompactYmdForGrid(item.oprtngStrtYmd),
             },
         ])[0] as GridRowWithVerification;
-        if (verificationResult) row.verificationResult = verificationResult;
+        if (verificationResult) {
+            row.verificationResult = normalizeVerificationResultMap(verificationResult);
+        }
         return row;
     });
 }
@@ -480,7 +489,9 @@ function mapRainFallUtilFactStatusListToGridRows(
                 cmptnYmd: formatCompactYmdForGrid(item.cmptnYmd),
             },
         ])[0] as GridRowWithVerification;
-        if (verificationResult) row.verificationResult = verificationResult;
+        if (verificationResult) {
+            row.verificationResult = normalizeVerificationResultMap(verificationResult);
+        }
         return row;
     });
 }
@@ -497,7 +508,9 @@ function mapTreatWaterReuseStatusListToGridRows<
                 coRegYmd: formatCompactYmdForGrid(item.coRegYmd),
             },
         ])[0] as GridRowWithVerification;
-        if (verificationResult) row.verificationResult = verificationResult;
+        if (verificationResult) {
+            row.verificationResult = normalizeVerificationResultMap(verificationResult);
+        }
         return row;
     });
 }
@@ -1153,7 +1166,6 @@ const WaterReuseInp = () => {
             lclgvIdfrTelnoCn: submitInfo.lclgvIdfrTelnoCn,
             lclgvIdfrDeptNm: submitInfo.lclgvIdfrDeptNm,
             lclgvIdfrJbgdNm: submitInfo.lclgvIdfrJbgdNm,
-            ...(isAdminInfo ? { superAdmin: "superAdmin" } : {}),
         };
 
         let articleSggOptions: Sgg[] | null = null;
@@ -1356,7 +1368,13 @@ const WaterReuseInp = () => {
                 };
 
                 try {
-                    const imrResponse = await statisticsApi.callImrService(imrParam);
+                    const imrResponse = await callImrServiceWithRollbackOnFailure(imrParam, {
+                        statsYr: lastSearchedValues.year ?? "",
+                        statsCd: statsCdForTab,
+                        sewerBzmnCd: lastSearchedValues?.bsnmCd ?? "",
+                        rollbackStatusCode: activeTabStatus?.lclgvSbmsnSttsCd ?? "",
+                        mdfrUuid: userInfo.userUnqId,
+                    });
                     if (imrResponse.job_id) {
                         await waitForImrJobCompleted(
                             imrResponse.job_id,
@@ -2064,18 +2082,7 @@ const WaterReuseInp = () => {
         if (!verification) return;
         const errors = verification[fieldName];
         if (Array.isArray(errors) && errors.length > 0) {
-            return errors
-                .map((e) => {
-                    const prefix =
-                        e.vrfcCd === "IMR"
-                            ? "시계열 검증 - "
-                            : e.vrfcCd === "NV"
-                                ? "일반검증 - "
-                                : "모집단 검증 - ";
-                    return `${prefix}${e.rsnExpln}(검증 기준값: ${e.cmprCn} / 현재 입력값: ${e.nowCn})`;
-                })
-                .filter(Boolean)
-                .join("\n");
+            return formatVerificationTooltip(errors);
         }
     };
 

apps/st/src/components/statistics/review/ExcretaTreatmentFacilityRvw.tsx

@@ -49,7 +49,6 @@ const ExcretaTreatmentFacilityRvw = () => {
     const [reviewOpinionContext, setReviewOpinionContext] =
         useState<ReviewOpinionDialogContext | null>(null);
     const [latestReviewOpinion, setLatestReviewOpinion] = useState("");
-    const [latestProcessHistory, setLatestProcessHistory] = useState("");
     const [lastSearchValues, setLastSearchValues] = useState<SearchFormValues | null>(null);
 
     const columnInfo = useMemo(() => {
@@ -116,7 +115,6 @@ const ExcretaTreatmentFacilityRvw = () => {
         setStatsStatusInfo({});
         setReviewOpinionContext(null);
         setLatestReviewOpinion("");
-        setLatestProcessHistory("");
         setLastSearchValues(null);
         setReviewOpinionOpen(false);
         setReturnDialogOpen(false);
@@ -170,14 +168,12 @@ const ExcretaTreatmentFacilityRvw = () => {
                     statsCd: statsInfo.statsCd ?? "",
                 });
                 setLatestReviewOpinion(statsInfo.splmntOpnnCn ?? "");
-                setLatestProcessHistory(statsInfo.splmntRsltCn ?? "");
                 setRowData(toGridRows(convertedData as unknown as object[]));
             } else {
                 setRowData([]);
                 setStatsStatusInfo({});
                 setReviewOpinionContext(null);
                 setLatestReviewOpinion("");
-                setLatestProcessHistory("");
                 alert(response.message || "데이터가 없습니다.");
             }
         } catch {
@@ -216,7 +212,6 @@ const ExcretaTreatmentFacilityRvw = () => {
 
             const row = detailRes.data?.[0];
             setLatestReviewOpinion(row?.splmntOpnnCn ?? "");
-            setLatestProcessHistory(row?.splmntRsltCn ?? "");
             setReviewOpinionOpen(true);
         } catch {
             alert("검토의견 조회 중 오류가 발생했습니다.");
@@ -234,10 +229,8 @@ const ExcretaTreatmentFacilityRvw = () => {
             setStatsStatusInfo((prev) => ({
                 ...prev,
                 splmntOpnnCn: param.splmntOpnnCn,
-                splmntRsltCn: param.splmntRsltCn,
             }));
             setLatestReviewOpinion(param.splmntOpnnCn);
-            setLatestProcessHistory(param.splmntRsltCn);
         } catch {
             alert("저장 중 오류가 발생했습니다.");
         }
@@ -297,7 +290,6 @@ const ExcretaTreatmentFacilityRvw = () => {
                 onOpenChange={setReviewOpinionOpen}
                 context={reviewOpinionContext}
                 initialReviewOpinion={latestReviewOpinion}
-                initialProcessHistory={latestProcessHistory}
                 onSave={saveReviewOpinion}
             />
             <ReviewSubmitDialog

apps/st/src/components/statistics/review/PrivateSewageFacilityRvw.tsx

@@ -102,7 +102,6 @@ const PrivateSewageFacilityRvw = () => {
     }, [activeStatsStatusInfo.statsCd, lastSearchValues]);
 
     const latestReviewOpinion = activeStatsStatusInfo.splmntOpnnCn ?? "";
-    const latestProcessHistory = activeStatsStatusInfo.splmntRsltCn ?? "";
 
     const submitDialogContext = useMemo<ReviewerInfoRequest | null>(() => {
         if (lastSearchValues == null) return null;
@@ -284,7 +283,6 @@ const PrivateSewageFacilityRvw = () => {
                 next.set(activeTab, {
                     ...(next.get(activeTab) ?? {}),
                     splmntOpnnCn: row?.splmntOpnnCn ?? "",
-                    splmntRsltCn: row?.splmntRsltCn ?? "",
                 });
                 return next;
             });
@@ -307,7 +305,6 @@ const PrivateSewageFacilityRvw = () => {
                 next.set(activeTab, {
                     ...(next.get(activeTab) ?? {}),
                     splmntOpnnCn: param.splmntOpnnCn,
-                    splmntRsltCn: param.splmntRsltCn,
                 });
                 return next;
             });
@@ -411,7 +408,6 @@ const PrivateSewageFacilityRvw = () => {
                 onOpenChange={setReviewOpinionOpen}
                 context={reviewOpinionContext}
                 initialReviewOpinion={latestReviewOpinion}
-                initialProcessHistory={latestProcessHistory}
                 onSave={saveReviewOpinion}
             />
             <ReviewSubmitDialog

apps/st/src/components/statistics/review/PublicSewageFacilityRvw.tsx

@@ -41,7 +41,6 @@ const PublicSewageFacilityRvw = () => {
     const [reviewOpinionContext, setReviewOpinionContext] =
         useState<ReviewOpinionDialogContext | null>(null);
     const [latestReviewOpinion, setLatestReviewOpinion] = useState("");
-    const [latestProcessHistory, setLatestProcessHistory] = useState("");
     const [lastSearchValues, setLastSearchValues] = useState<SearchFormValues | null>(null);
 
     const columnInfo = useMemo(() => {
@@ -100,7 +99,6 @@ const PublicSewageFacilityRvw = () => {
         setStatsStatusInfo({});
         setReviewOpinionContext(null);
         setLatestReviewOpinion("");
-        setLatestProcessHistory("");
         setLastSearchValues(null);
         setSubmitDialogOpen(false);
     };
@@ -143,16 +141,12 @@ const PublicSewageFacilityRvw = () => {
                 setLatestReviewOpinion(
                     response.data.statsStatusInfo.splmntOpnnCn ?? "",
                 );
-                setLatestProcessHistory(
-                    response.data.statsStatusInfo.splmntRsltCn ?? "",
-                );
                 setRowData(toGridRows(convertedData as unknown as object[]));
             } else {
                 setRowData([]);
                 setStatsStatusInfo({});
                 setReviewOpinionContext(null);
                 setLatestReviewOpinion("");
-                setLatestProcessHistory("");
                 alert(response.message || "데이터가 없습니다.");
             }
         } catch (error) {
@@ -192,7 +186,6 @@ const PublicSewageFacilityRvw = () => {
 
             const row = detailRes.data?.[0];
             setLatestReviewOpinion(row?.splmntOpnnCn ?? "");
-            setLatestProcessHistory(row?.splmntRsltCn ?? "");
             setReviewOpinionOpen(true);
         } catch {
             alert("검토의견 조회 중 오류가 발생했습니다.");
@@ -210,10 +203,8 @@ const PublicSewageFacilityRvw = () => {
             setStatsStatusInfo((prev) => ({
                 ...prev,
                 splmntOpnnCn: param.splmntOpnnCn,
-                splmntRsltCn: param.splmntRsltCn,
             }));
             setLatestReviewOpinion(param.splmntOpnnCn);
-            setLatestProcessHistory(param.splmntRsltCn);
         } catch {
             alert("저장 중 오류가 발생했습니다.");
         }
@@ -267,7 +258,6 @@ const PublicSewageFacilityRvw = () => {
                 onOpenChange={setReviewOpinionOpen}
                 context={reviewOpinionContext}
                 initialReviewOpinion={latestReviewOpinion}
-                initialProcessHistory={latestProcessHistory}
                 onSave={saveReviewOpinion}
             />
             <ReviewSubmitDialog

apps/st/src/components/statistics/review/PumpingStationRvw.tsx

@@ -47,7 +47,6 @@ const PumpingStationRvw = () => {
     const [reviewOpinionContext, setReviewOpinionContext] =
         useState<ReviewOpinionDialogContext | null>(null);
     const [latestReviewOpinion, setLatestReviewOpinion] = useState("");
-    const [latestProcessHistory, setLatestProcessHistory] = useState("");
     const [lastSearchValues, setLastSearchValues] = useState<SearchFormValues | null>(null);
 
     const columnInfo = useMemo(() => {
@@ -111,7 +110,6 @@ const PumpingStationRvw = () => {
         setStatsStatusInfo({});
         setReviewOpinionContext(null);
         setLatestReviewOpinion("");
-        setLatestProcessHistory("");
         setLastSearchValues(null);
         setReviewOpinionOpen(false);
         setReturnDialogOpen(false);
@@ -157,14 +155,12 @@ const PumpingStationRvw = () => {
                     statsCd: statsInfo.statsCd ?? "",
                 });
                 setLatestReviewOpinion(statsInfo.splmntOpnnCn ?? "");
-                setLatestProcessHistory(statsInfo.splmntRsltCn ?? "");
                 setRowData(toGridRows(convertedData));
             } else {
                 setRowData([]);
                 setStatsStatusInfo({});
                 setReviewOpinionContext(null);
                 setLatestReviewOpinion("");
-                setLatestProcessHistory("");
                 alert(response.message || "데이터가 없습니다.");
             }
         } catch {
@@ -203,7 +199,6 @@ const PumpingStationRvw = () => {
 
             const row = detailRes.data?.[0];
             setLatestReviewOpinion(row?.splmntOpnnCn ?? "");
-            setLatestProcessHistory(row?.splmntRsltCn ?? "");
             setReviewOpinionOpen(true);
         } catch {
             alert("검토의견 조회 중 오류가 발생했습니다.");
@@ -221,10 +216,8 @@ const PumpingStationRvw = () => {
             setStatsStatusInfo((prev) => ({
                 ...prev,
                 splmntOpnnCn: param.splmntOpnnCn,
-                splmntRsltCn: param.splmntRsltCn,
             }));
             setLatestReviewOpinion(param.splmntOpnnCn);
-            setLatestProcessHistory(param.splmntRsltCn);
         } catch {
             alert("저장 중 오류가 발생했습니다.");
         }
@@ -284,7 +277,6 @@ const PumpingStationRvw = () => {
                 onOpenChange={setReviewOpinionOpen}
                 context={reviewOpinionContext}
                 initialReviewOpinion={latestReviewOpinion}
-                initialProcessHistory={latestProcessHistory}
                 onSave={saveReviewOpinion}
             />
             <ReviewSubmitDialog

apps/st/src/components/statistics/review/ReviewOpinionDialog.tsx

@@ -30,8 +30,6 @@ export interface ReviewOpinionDialogProps {
     context: ReviewOpinionDialogContext | null;
     /** 다이얼로그 열릴 때 검토의견 초기값 */
     initialReviewOpinion?: string;
-    /** 다이얼로그 열릴 때 처리내역 초기값 */
-    initialProcessHistory?: string;
     /** 저장 시 생성된 param 전달 (API 호출 등) */
     onSave?: (param: ReviewOpinionSaveRequest) => void | Promise<void>;
 }
@@ -41,18 +39,15 @@ export function ReviewOpinionDialog({
     onOpenChange,
     context,
     initialReviewOpinion = "",
-    initialProcessHistory = "",
     onSave,
 }: ReviewOpinionDialogProps) {
     const { setMessage: alert } = useAlertStore((state) => state);
     const [reviewOpinion, setReviewOpinion] = useState("");
-    const [processHistory, setProcessHistory] = useState("");
     const [isSaving, setIsSaving] = useState(false);
     const [reviewOpinionError, setReviewOpinionError] = useState(false);
 
     const resetForm = () => {
         setReviewOpinion("");
-        setProcessHistory("");
         setReviewOpinionError(false);
     };
 
@@ -64,8 +59,7 @@ export function ReviewOpinionDialog({
     useEffect(() => {
         if (!open) return;
         setReviewOpinion(initialReviewOpinion);
-        setProcessHistory(initialProcessHistory);
-    }, [open, initialReviewOpinion, initialProcessHistory]);
+    }, [open, initialReviewOpinion]);
 
     const handleSave = async () => {
         if (reviewOpinion.trim() === "") {
@@ -96,7 +90,6 @@ export function ReviewOpinionDialog({
                 sewerBzmnCd: context.sewerBzmnCd,
                 statsCd: context.statsCd,
                 splmntOpnnCn: reviewOpinion,
-                splmntRsltCn: processHistory,
                 mdfrUuid: userInfo.userUnqId,
             };
             await onSave?.(param);
@@ -136,16 +129,6 @@ export function ReviewOpinionDialog({
                             </p>
                         )}
                     </div>
-                    <div className="flex flex-col gap-2">
-                        <Label className="text-label mb-2">처리내역</Label>
-                        <Textarea
-                            value={processHistory}
-                            onChange={(e) => setProcessHistory(e.target.value)}
-                            className="min-h-[10rem] resize-y !text-[1.3rem] !leading-6"
-                            placeholder="처리내역을 입력하세요."
-                            disabled={isSaving}
-                        />
-                    </div>
                 </div>
                 <DialogFooter>
                     <DialogClose asChild>

apps/st/src/components/statistics/review/ReviewSubmitDialog.tsx

@@ -30,8 +30,8 @@ export interface ReviewSubmitDialogProps {
     context: ReviewerInfoRequest | null;
     onSubmitted?: () => void | Promise<void>;
     /**
-     * true면 검토의견·처리내역 UI를 숨기고
-     * submit body에 statsCd / splmntOpnnCn / splmntRsltCn을 넣지 않음
+     * true면 검토의견 UI를 숨기고
+     * submit body에 statsCd / splmntOpnnCn을 넣지 않음
      */
     hideOpinionFields?: boolean;
 }
@@ -116,7 +116,6 @@ export function ReviewSubmitDialog({
                       statsCd: context.statsCd,
                       mdfrUuid: userInfo.userUnqId,
                       splmntOpnnCn: reviewerInfo?.splmntOpnnCn ?? "",
-                      splmntRsltCn: reviewerInfo?.splmntRsltCn ?? "",
                   };
 
             const response = await statisticsApi.submitReview(submitParam);
@@ -175,14 +174,6 @@ export function ReviewSubmitDialog({
                                     className="min-h-[10rem] p-2 resize-none !text-xl"
                                 />
                             </div>
-                            <div className="col-span-2 flex flex-col gap-2">
-                                <Label className="text-label">처리내역</Label>
-                                <Textarea
-                                    value={reviewerInfo?.splmntRsltCn ?? "-"}
-                                    readOnly
-                                    className="min-h-[10rem] p-2 resize-none !text-xl"
-                                />
-                            </div>
                         </>
                     )}
                 </div>

apps/st/src/components/statistics/review/SewageExcretaRelatedRvw.tsx

@@ -105,7 +105,6 @@ const SewageExcretaRelatedRvw = () => {
     }, [activeStatsStatusInfo.statsCd, lastSearchValues]);
 
     const latestReviewOpinion = activeStatsStatusInfo.splmntOpnnCn ?? "";
-    const latestProcessHistory = activeStatsStatusInfo.splmntRsltCn ?? "";
 
     const submitDialogContext = useMemo<ReviewerInfoRequest | null>(() => {
         if (lastSearchValues == null) return null;
@@ -289,7 +288,6 @@ const SewageExcretaRelatedRvw = () => {
                 next.set(activeTab, {
                     ...(next.get(activeTab) ?? {}),
                     splmntOpnnCn: row?.splmntOpnnCn ?? "",
-                    splmntRsltCn: row?.splmntRsltCn ?? "",
                 });
                 return next;
             });
@@ -312,7 +310,6 @@ const SewageExcretaRelatedRvw = () => {
                 next.set(activeTab, {
                     ...(next.get(activeTab) ?? {}),
                     splmntOpnnCn: param.splmntOpnnCn,
-                    splmntRsltCn: param.splmntRsltCn,
                 });
                 return next;
             });
@@ -416,7 +413,6 @@ const SewageExcretaRelatedRvw = () => {
                 onOpenChange={setReviewOpinionOpen}
                 context={reviewOpinionContext}
                 initialReviewOpinion={latestReviewOpinion}
-                initialProcessHistory={latestProcessHistory}
                 onSave={saveReviewOpinion}
             />
             <ReviewSubmitDialog

apps/st/src/components/statistics/review/SewageExcretaSlurgeRvw.tsx

@@ -105,7 +105,6 @@ const SewageExcretaSlurgeRvw = () => {
     }, [activeStatsStatusInfo.statsCd, lastSearchValues]);
 
     const latestReviewOpinion = activeStatsStatusInfo.splmntOpnnCn ?? "";
-    const latestProcessHistory = activeStatsStatusInfo.splmntRsltCn ?? "";
 
     const submitDialogContext = useMemo<ReviewerInfoRequest | null>(() => {
         if (lastSearchValues == null) return null;
@@ -290,7 +289,6 @@ const SewageExcretaSlurgeRvw = () => {
                 next.set(activeTab, {
                     ...(next.get(activeTab) ?? {}),
                     splmntOpnnCn: row?.splmntOpnnCn ?? "",
-                    splmntRsltCn: row?.splmntRsltCn ?? "",
                 });
                 return next;
             });
@@ -313,7 +311,6 @@ const SewageExcretaSlurgeRvw = () => {
                 next.set(activeTab, {
                     ...(next.get(activeTab) ?? {}),
                     splmntOpnnCn: param.splmntOpnnCn,
-                    splmntRsltCn: param.splmntRsltCn,
                 });
                 return next;
             });
@@ -417,7 +414,6 @@ const SewageExcretaSlurgeRvw = () => {
                 onOpenChange={setReviewOpinionOpen}
                 context={reviewOpinionContext}
                 initialReviewOpinion={latestReviewOpinion}
-                initialProcessHistory={latestProcessHistory}
                 onSave={saveReviewOpinion}
             />
             <ReviewSubmitDialog

apps/st/src/components/statistics/review/SewagePipeMaintainRvw.tsx

@@ -120,7 +120,6 @@ const SewagePipeMaintainRvw = () => {
     }, [activeStatsStatusInfo.statsCd, lastSearchValues]);
 
     const latestReviewOpinion = activeStatsStatusInfo.splmntOpnnCn ?? "";
-    const latestProcessHistory = activeStatsStatusInfo.splmntRsltCn ?? "";
 
     const submitDialogContext = useMemo<ReviewerInfoRequest | null>(() => {
         if (lastSearchValues == null) return null;
@@ -302,7 +301,6 @@ const SewagePipeMaintainRvw = () => {
                 next.set(activeTab, {
                     ...(next.get(activeTab) ?? {}),
                     splmntOpnnCn: row?.splmntOpnnCn ?? "",
-                    splmntRsltCn: row?.splmntRsltCn ?? "",
                 });
                 return next;
             });
@@ -325,7 +323,6 @@ const SewagePipeMaintainRvw = () => {
                 next.set(activeTab, {
                     ...(next.get(activeTab) ?? {}),
                     splmntOpnnCn: param.splmntOpnnCn,
-                    splmntRsltCn: param.splmntRsltCn,
                 });
                 return next;
             });
@@ -429,7 +426,6 @@ const SewagePipeMaintainRvw = () => {
                 onOpenChange={setReviewOpinionOpen}
                 context={reviewOpinionContext}
                 initialReviewOpinion={latestReviewOpinion}
-                initialProcessHistory={latestProcessHistory}
                 onSave={saveReviewOpinion}
             />
             <ReviewSubmitDialog

apps/st/src/components/statistics/review/SewagePipeRvw.tsx

@@ -181,7 +181,6 @@ const SewagePipeRvw = () => {
         };
     }, [activeStatsStatusInfo.statsCd, lastSearchValues]);
     const latestReviewOpinion = activeStatsStatusInfo.splmntOpnnCn ?? "";
-    const latestProcessHistory = activeStatsStatusInfo.splmntRsltCn ?? "";
     const submitDialogContext = useMemo<ReviewerInfoRequest | null>(() => {
         if (lastSearchValues == null) return null;
 
@@ -362,7 +361,6 @@ const SewagePipeRvw = () => {
                 next.set(activeTab, {
                     ...(next.get(activeTab) ?? {}),
                     splmntOpnnCn: row?.splmntOpnnCn ?? "",
-                    splmntRsltCn: row?.splmntRsltCn ?? "",
                 });
                 return next;
             });
@@ -385,7 +383,6 @@ const SewagePipeRvw = () => {
                 next.set(activeTab, {
                     ...(next.get(activeTab) ?? {}),
                     splmntOpnnCn: param.splmntOpnnCn,
-                    splmntRsltCn: param.splmntRsltCn,
                 });
                 return next;
             });
@@ -488,7 +485,6 @@ const SewagePipeRvw = () => {
                 onOpenChange={setReviewOpinionOpen}
                 context={reviewOpinionContext}
                 initialReviewOpinion={latestReviewOpinion}
-                initialProcessHistory={latestProcessHistory}
                 onSave={saveReviewOpinion}
             />
             <ReviewSubmitDialog

apps/st/src/components/statistics/review/SewageReservoirPumpRvw.tsx

@@ -126,7 +126,6 @@ const SewageReservoirPumpRvw = () => {
     }, [activeStatsCd, lastSearchValues]);
 
     const latestReviewOpinion = activeStatsStatusInfo.splmntOpnnCn ?? "";
-    const latestProcessHistory = activeStatsStatusInfo.splmntRsltCn ?? "";
 
     const submitDialogContext = useMemo<ReviewerInfoRequest | null>(() => {
         if (lastSearchValues == null) return null;
@@ -308,7 +307,6 @@ const SewageReservoirPumpRvw = () => {
                 next.set(activeTab, {
                     ...(next.get(activeTab) ?? {}),
                     splmntOpnnCn: row?.splmntOpnnCn ?? "",
-                    splmntRsltCn: row?.splmntRsltCn ?? "",
                 });
                 return next;
             });
@@ -331,7 +329,6 @@ const SewageReservoirPumpRvw = () => {
                 next.set(activeTab, {
                     ...(next.get(activeTab) ?? {}),
                     splmntOpnnCn: param.splmntOpnnCn,
-                    splmntRsltCn: param.splmntRsltCn,
                 });
                 return next;
             });
@@ -435,7 +432,6 @@ const SewageReservoirPumpRvw = () => {
                 onOpenChange={setReviewOpinionOpen}
                 context={reviewOpinionContext}
                 initialReviewOpinion={latestReviewOpinion}
-                initialProcessHistory={latestProcessHistory}
                 onSave={saveReviewOpinion}
             />
             <ReviewSubmitDialog

apps/st/src/components/statistics/review/SewerageFinanceRvw.tsx

@@ -105,7 +105,6 @@ const SewerageFinanceRvw = () => {
     }, [activeStatsStatusInfo.statsCd, lastSearchValues]);
 
     const latestReviewOpinion = activeStatsStatusInfo.splmntOpnnCn ?? "";
-    const latestProcessHistory = activeStatsStatusInfo.splmntRsltCn ?? "";
 
     const submitDialogContext = useMemo<ReviewerInfoRequest | null>(() => {
         if (lastSearchValues == null) return null;
@@ -287,7 +286,6 @@ const SewerageFinanceRvw = () => {
                 next.set(activeTab, {
                     ...(next.get(activeTab) ?? {}),
                     splmntOpnnCn: row?.splmntOpnnCn ?? "",
-                    splmntRsltCn: row?.splmntRsltCn ?? "",
                 });
                 return next;
             });
@@ -310,7 +308,6 @@ const SewerageFinanceRvw = () => {
                 next.set(activeTab, {
                     ...(next.get(activeTab) ?? {}),
                     splmntOpnnCn: param.splmntOpnnCn,
-                    splmntRsltCn: param.splmntRsltCn,
                 });
                 return next;
             });
@@ -414,7 +411,6 @@ const SewerageFinanceRvw = () => {
                 onOpenChange={setReviewOpinionOpen}
                 context={reviewOpinionContext}
                 initialReviewOpinion={latestReviewOpinion}
-                initialProcessHistory={latestProcessHistory}
                 onSave={saveReviewOpinion}
             />
             <ReviewSubmitDialog

apps/st/src/components/statistics/review/SeweragePenetrationRateRvw.tsx

@@ -40,7 +40,6 @@ const SeweragePenetrationRateRvw = () => {
     const [reviewOpinionContext, setReviewOpinionContext] =
         useState<ReviewOpinionDialogContext | null>(null);
     const [latestReviewOpinion, setLatestReviewOpinion] = useState("");
-    const [latestProcessHistory, setLatestProcessHistory] = useState("");
     const [lastSearchValues, setLastSearchValues] = useState<SearchFormValues | null>(null);
 
     const columnInfo = useMemo(() => {
@@ -100,7 +99,6 @@ const SeweragePenetrationRateRvw = () => {
         setStatsStatusInfo({});
         setReviewOpinionContext(null);
         setLatestReviewOpinion("");
-        setLatestProcessHistory("");
         setLastSearchValues(null);
     };
 
@@ -139,15 +137,11 @@ const SeweragePenetrationRateRvw = () => {
                 setLatestReviewOpinion(
                     response.data.statsStatusInfo.splmntOpnnCn ?? "",
                 );
-                setLatestProcessHistory(
-                    response.data.statsStatusInfo.splmntRsltCn ?? "",
-                );
                 setRowData(toGridRows(convertedData));
             } else {
                 setRowData([]);
                 setReviewOpinionContext(null);
                 setLatestReviewOpinion("");
-                setLatestProcessHistory("");
                 alert(response.message || "데이터가 없습니다.");
             }
         } catch (error) {
@@ -187,7 +181,6 @@ const SeweragePenetrationRateRvw = () => {
 
             const row = detailRes.data?.[0];
             setLatestReviewOpinion(row?.splmntOpnnCn ?? "");
-            setLatestProcessHistory(row?.splmntRsltCn ?? "");
             setReviewOpinionOpen(true);
         } catch {
             alert("검토의견 조회 중 오류가 발생했습니다.");
@@ -205,10 +198,8 @@ const SeweragePenetrationRateRvw = () => {
             setStatsStatusInfo((prev) => ({
                 ...prev,
                 splmntOpnnCn: param.splmntOpnnCn,
-                splmntRsltCn: param.splmntRsltCn,
             }));
             setLatestReviewOpinion(param.splmntOpnnCn);
-            setLatestProcessHistory(param.splmntRsltCn);
         } catch {
             alert("저장 중 오류가 발생했습니다.");
         }
@@ -264,7 +255,6 @@ const SeweragePenetrationRateRvw = () => {
                 onOpenChange={setReviewOpinionOpen}
                 context={reviewOpinionContext}
                 initialReviewOpinion={latestReviewOpinion}
-                initialProcessHistory={latestProcessHistory}
                 onSave={saveReviewOpinion}
             />
             <ReviewSubmitDialog

apps/st/src/components/statistics/review/SewerageServiceLevelRvw.tsx

@@ -103,7 +103,6 @@ const SewerageServiceLevelRvw = () => {
     }, [activeStatsStatusInfo.statsCd, lastSearchValues]);
 
     const latestReviewOpinion = activeStatsStatusInfo.splmntOpnnCn ?? "";
-    const latestProcessHistory = activeStatsStatusInfo.splmntRsltCn ?? "";
 
     const submitDialogContext = useMemo<ReviewerInfoRequest | null>(() => {
         if (lastSearchValues == null) return null;
@@ -288,7 +287,6 @@ const SewerageServiceLevelRvw = () => {
                 next.set(activeTab, {
                     ...(next.get(activeTab) ?? {}),
                     splmntOpnnCn: row?.splmntOpnnCn ?? "",
-                    splmntRsltCn: row?.splmntRsltCn ?? "",
                 });
                 return next;
             });
@@ -311,7 +309,6 @@ const SewerageServiceLevelRvw = () => {
                 next.set(activeTab, {
                     ...(next.get(activeTab) ?? {}),
                     splmntOpnnCn: param.splmntOpnnCn,
-                    splmntRsltCn: param.splmntRsltCn,
                 });
                 return next;
             });
@@ -415,7 +412,6 @@ const SewerageServiceLevelRvw = () => {
                 onOpenChange={setReviewOpinionOpen}
                 context={reviewOpinionContext}
                 initialReviewOpinion={latestReviewOpinion}
-                initialProcessHistory={latestProcessHistory}
                 onSave={saveReviewOpinion}
             />
             <ReviewSubmitDialog

apps/st/src/components/statistics/review/StatsInputStatusRvw.tsx

@@ -39,22 +39,14 @@ import { toGridRows } from "@/components/util/grid/gridFunction";
 
 type ReviewHistoryRow = ReviewHistoryResponse["data"][number];
 
-const checkPrvnStatusCd = (code: string) => {
-    return (code === '0' || code === '1') ? '미작성' : (code === '2' ? '제출완료' : (code === '3' ? '승인완료' : '반려'));
-};
-
-const checkSubmitStatusCd = (code: string) => {
-    return code === '0' ? '미작성' : (code === '1' ? '작성중' : (code === '2' ? '제출완료' : (code === '3' ? '승인완료' : '보완요청')));
-};
-
 const isStatsInputStatusRowApprovable = (row: Record<string, string | number>) =>
-    String(row.submitStatusCd ?? "") === "3" && (String(row.prvnStatusCd ?? "") === "2" || String(row.prvnStatusCd ?? "") === "3");
+    String(row.lclgvSbmsnSttsCd ?? "") === "3" &&
+    (String(row.mctpvPicSbmsnSttsCd ?? "") === "2" ||
+        String(row.mctpvPicSbmsnSttsCd ?? "") === "3");
 
 const mapSewerageListToGridRows = (rawList: StatsInputStatusReviewItem[]) =>
     rawList.map((r) => ({
         ...r,
-        prvnStatusNm: checkPrvnStatusCd(r.prvnStatusCd || "0"),
-        submitStatusNm: checkSubmitStatusCd(r.submitStatusCd || "0"),
         reviewHistory: "검토이력",
     }));
 
@@ -97,7 +89,7 @@ const StatsInputStatusRvw = () => {
     const reviewHistoryColumns = useMemo(() => {
         const col = createColumnHelper<ReviewHistoryRow>();
         return [
-            col.accessor("logDt", {
+            col.accessor("regDt", {
                 header: "등록일",
                 cell: (info) => info.getValue(),
             }),
@@ -238,23 +230,23 @@ const StatsInputStatusRvw = () => {
     const allSubmitStatusApproved = useMemo(
         () =>
             rowData.length > 0 &&
-            rowData.every((row) => String(row.submitStatusCd ?? "") === "3"),
+            rowData.every((row) => String(row.lclgvSbmsnSttsCd ?? "") === "3"),
         [rowData],
     );
 
-    /** 진행상태(prvn) 코드가 모두 승인완료(3) */
+    /** 진행상태(광역) 코드가 모두 승인완료(3) */
     const allPrvnStatusApproved = useMemo(
         () =>
             rowData.length > 0 &&
-            rowData.every((row) => String(row.prvnStatusCd ?? "") === "3"),
+            rowData.every((row) => String(row.mctpvPicSbmsnSttsCd ?? "") === "3"),
         [rowData],
     );
 
-    /** 진행상태(prvn) 코드가 모두 제출완료(2) */
+    /** 진행상태(광역) 코드가 모두 제출완료(2) */
     const allPrvnStatusSubmitted = useMemo(
         () =>
             rowData.length > 0 &&
-            rowData.every((row) => String(row.prvnStatusCd ?? "") === "2"),
+            rowData.every((row) => String(row.mctpvPicSbmsnSttsCd ?? "") === "2"),
         [rowData],
     );
 
@@ -392,8 +384,8 @@ const StatsInputStatusRvw = () => {
                 setRowData={setRowData}
                 onDataCellClick={handleReviewHistoryCellClick}
                 cellStyleCallback={({ row, fieldName }) => {
-                    if (fieldName === "submitStatusNm") {
-                        const statusCd = String(row.submitStatusCd ?? "");
+                    if (fieldName === "lclgvSbmsnSttsNm") {
+                        const statusCd = String(row.lclgvSbmsnSttsCd ?? "");
 
                         if (statusCd === "0" || statusCd === "1") {
                             return "rg-cell-stats-status-pending";
@@ -408,8 +400,8 @@ const StatsInputStatusRvw = () => {
                             return "rg-cell-stats-status-rejected";
                         }
                         return undefined;
-                    } else if (fieldName === "prvnStatusNm") {
-                        const statusCd = String(row.prvnStatusCd ?? "");
+                    } else if (fieldName === "mctpvPicSbmsnSttsNm") {
+                        const statusCd = String(row.mctpvPicSbmsnSttsCd ?? "");
 
                         if (statusCd === "0" || statusCd === "1") {
                             return "rg-cell-stats-status-pending";

apps/st/src/components/statistics/review/WaterReuseRvw.tsx

@@ -108,7 +108,6 @@ const WaterReuseRvw = () => {
     }, [activeStatsStatusInfo.statsCd, lastSearchValues]);
 
     const latestReviewOpinion = activeStatsStatusInfo.splmntOpnnCn ?? "";
-    const latestProcessHistory = activeStatsStatusInfo.splmntRsltCn ?? "";
 
     const submitDialogContext = useMemo<ReviewerInfoRequest | null>(() => {
         if (lastSearchValues == null) return null;
@@ -291,7 +290,6 @@ const WaterReuseRvw = () => {
                 next.set(activeTab, {
                     ...(next.get(activeTab) ?? {}),
                     splmntOpnnCn: row?.splmntOpnnCn ?? "",
-                    splmntRsltCn: row?.splmntRsltCn ?? "",
                 });
                 return next;
             });
@@ -314,7 +312,6 @@ const WaterReuseRvw = () => {
                 next.set(activeTab, {
                     ...(next.get(activeTab) ?? {}),
                     splmntOpnnCn: param.splmntOpnnCn,
-                    splmntRsltCn: param.splmntRsltCn,
                 });
                 return next;
             });
@@ -418,7 +415,6 @@ const WaterReuseRvw = () => {
                 onOpenChange={setReviewOpinionOpen}
                 context={reviewOpinionContext}
                 initialReviewOpinion={latestReviewOpinion}
-                initialProcessHistory={latestProcessHistory}
                 onSave={saveReviewOpinion}
             />
             <ReviewSubmitDialog

apps/st/src/components/statistics/verification/generalVerification/DetailComponent.tsx

@@ -554,17 +554,20 @@ const DetailComponent = ({
                 const userInfo = await getUserInfo();
                 let response;
 
+                const vrfcSn = detailInfo?.commonInfo.vrfcSn;
+                if (vrfcSn == null) {
+                    alert("검증 일련번호가 없습니다.");
+                    return;
+                }
                 if (!hasPersistedDetails) {
                     response =
-                        await generalverificationApiService.RegistVrfcDetail({
-                            vrfcSn: detailInfo?.commonInfo.vrfcSn ?? null,
+                        await generalverificationApiService.RegistVrfcDetail(vrfcSn, {
                             detailList: rows,
                             rgtrUuid: userInfo.userUnqId,
                         });
                 } else {
                     response =
-                        await generalverificationApiService.UpdateVrfcDetail({
-                            vrfcSn: detailInfo?.commonInfo.vrfcSn ?? null,
+                        await generalverificationApiService.UpdateVrfcDetail(vrfcSn, {
                             detailList: rows,
                             mdfrUuid: userInfo.userUnqId,
                         });

apps/st/src/components/statistics/verification/generalVerification/RegistDialog.tsx

@@ -146,9 +146,15 @@ const RegistDialog = memo(
             }
         };
 
-        const handleUpdateVrfcMaster = async (data: GeneralVerificationMasterSubmitFormData) => {
+        const handleUpdateVrfcMaster = async (
+            updateVrfcSn: number,
+            body: UpdateVrfcMasterRequest,
+        ) => {
             try {
-                const response = await generalverificationApiService.UpdateVrfcMaster(data as UpdateVrfcMasterRequest);
+                const response = await generalverificationApiService.UpdateVrfcMaster(
+                    updateVrfcSn,
+                    body,
+                );
 
                 if (response.status === 'success') {
                     alert('수정되었습니다.');
@@ -258,8 +264,11 @@ const RegistDialog = memo(
             if (await confirm(confirmMessage)) {
                 const userInfo = await getUserInfo();
                 if (isVrfcSn) {
-                    const updateData = {
-                        vrfcSn: data.vrfcSn,
+                    if (data.vrfcSn == null) {
+                        alert('수정 대상이 없습니다.');
+                        return;
+                    }
+                    await handleUpdateVrfcMaster(data.vrfcSn, {
                         vrfcNm: data.vrfcNm,
                         vrfcClsfCd: data.vrfcClsfCd,
                         dcptDgt: data.dcptDgt,
@@ -267,10 +276,8 @@ const RegistDialog = memo(
                         ...(data.dcptDgt === 0
                             ? {}
                             : { dcptPrcsMthCd: data.dcptPrcsMthCd }),
-                        trgtStatsCd: data.trgtStatsCd,
                         mdfrUuid: userInfo.userUnqId,
-                    };
-                    await handleUpdateVrfcMaster(updateData);
+                    });
                 } else {
                     const registData = {
                         vrfcNm: data.vrfcNm,

apps/st/src/components/type/DataGrid.type.ts

@@ -481,6 +481,11 @@ export type DataGridProps = {
     headerHeight?: number;
     /** RealGrid `displayOptions.fitStyle` (기본 EVEN). 컬럼별 width 유지 시 NONE */
     fitStyle?: GridFitStyle;
+    /**
+     * true면 붙여넣기·편집으로 행을 추가하지 않음.
+     * 검증 결과처럼 조회 행 수가 고정된 그리드에서 사용.
+     */
+    preventRowAppend?: boolean;
 };
 
 export type TabDataGridProps = {

apps/st/src/components/util/column/input/DoList.ts

@@ -8,6 +8,7 @@ export const doList = [
     "4600000000",
     "4700000000",
     "4800000000",
+    "5000000000",
 ];
 
 export const needBsnmFrgnrPoplSmSidoList = [

apps/st/src/components/util/column/input/sewageExcretaSlurge/ExcretaSlurgeProcessingStatusInpColumn.ts

@@ -27,7 +27,6 @@ export const ExcretaSlurgeProcessingStatusInpColumn = {
                     'rcycQnt',
                     'olandLfvlm',
                     'incnrQnt',
-                    'oceanInputQnt',
                     'fuelQnt',
                     'etcQnt',
                     'unprcsQnt'
@@ -51,7 +50,6 @@ export const ExcretaSlurgeProcessingStatusInpColumn = {
                     'rcycQnt',
                     'olandLfvlm',
                     'incnrQnt',
-                    'oceanInputQnt',
                     'fuelQnt',
                     'etcQnt',
                 ],
@@ -61,7 +59,6 @@ export const ExcretaSlurgeProcessingStatusInpColumn = {
         { name: 'rcycQnt', fieldName: 'rcycQnt', header: { text: '재활용' }, footer: footerDecimal1, valueType: ValueType.NUMBER, dataFormat: '#,##0.0' },
         { name: 'olandLfvlm', fieldName: 'olandLfvlm', header: { text: '육상매립' }, footer: footerDecimal1, valueType: ValueType.NUMBER, dataFormat: '#,##0.0' },
         { name: 'incnrQnt', fieldName: 'incnrQnt', header: { text: '소각' }, footer: footerDecimal1, valueType: ValueType.NUMBER, dataFormat: '#,##0.0' },
-        { name: 'oceanInputQnt', fieldName: 'oceanInputQnt', header: { text: '해양투기' }, footer: footerDecimal1, valueType: ValueType.NUMBER, dataFormat: '#,##0.0' },
         { name: 'fuelQnt', fieldName: 'fuelQnt', header: { text: '연료화' }, footer: footerDecimal1, valueType: ValueType.NUMBER, dataFormat: '#,##0.0' },
         { name: 'etcQnt', fieldName: 'etcQnt', header: { text: '기타' }, footer: footerDecimal1, valueType: ValueType.NUMBER, dataFormat: '#,##0.0' },
 
@@ -100,7 +97,6 @@ export const ExcretaSlurgeProcessingStatusInpColumn = {
                 'rcycQnt',
                 'olandLfvlm',
                 'incnrQnt',
-                'oceanInputQnt',
                 'fuelQnt',
                 'etcQnt'
             ]

apps/st/src/components/util/column/input/sewagePipe/ManholeStatusInpColumn.ts

@@ -49,6 +49,43 @@ export const ManholeStatusInpColumn = {
             styleName: "rg-cell-readonly",
             footer: { text: "합계" },
         },
+        {
+            name: "wholMnhlCntSum",
+            fieldName: "wholMnhlCntSum",
+            header: { text: "맨홀총계" },
+            footer: footerInt,
+            editable: false,
+            valueType: ValueType.NUMBER,
+            dataFormat: "#,##0",
+            styleName: "rg-cell-readonly",
+        },
+        {
+            name: "frlvlMnhlCntSum",
+            fieldName: "frlvlMnhlCntSum",
+            header: { text: "주철계" },
+            footer: footerInt,
+            editable: false,
+            valueType: ValueType.NUMBER,
+            dataFormat: "#,##0",
+            styleName: "rg-cell-readonly",
+        },
+        {
+            name: "thlvlMnhlCntSum",
+            fieldName: "thlvlMnhlCntSum",
+            header: { text: "콘크리트계" },
+            footer: footerInt,
+            editable: false,
+            valueType: ValueType.NUMBER,
+            dataFormat: "#,##0",
+            styleName: "rg-cell-readonly",
+        },
+        {
+            name: "picNm",
+            fieldName: "picNm",
+            header: { text: "담당자명" },
+            editable: false,
+            styleName: "rg-cell-readonly",
+        },
         {
             ...intCol("wholMnhlCnt", "계", false),
             computed: {
@@ -88,6 +125,12 @@ export const ManholeStatusInpColumn = {
         },
         "admdstNm",
         "emphsMngSeNm",
+        {
+            name: "adminRefGroup",
+            hideChildHeaders: false,
+            header: { text: "행정참고자료" },
+            items: ["wholMnhlCntSum", "frlvlMnhlCntSum", "thlvlMnhlCntSum", "picNm"],
+        },
         {
             name: "mtrlGroup",
             hideChildHeaders: false,

apps/st/src/components/util/column/input/waterReuse/PublicSewageTreatWaterReuseInpColumn.ts

@@ -75,6 +75,8 @@ export const PublicSewageTreatWaterReuseInpColumn = {
                 name: 'lglYn',
                 fieldName: 'lglYn',
                 header: { text: '법적의무대상(대상/미대상)' },
+                editable: false, 
+                styleName: 'rg-cell-readonly'
             },
             PUBLIC_SEWAGE_TREAT_WATER_REUSE_LGL_YN_VALUES,
         ),

apps/st/src/components/util/column/management/GeneralVerificationColumn.tsx

@@ -32,11 +32,11 @@ export const getGeneralVerificationColumns = (
     },
     {
         accessorKey: "vrfcClsfNm",
-        header: "검증분류",
+        header: "검증 분류",
     },
     {
         accessorKey: "useYn",
-        header: "사용여부",
+        header: "사용 여부",
     },
     {
         accessorKey: "regDt",

apps/st/src/components/util/column/review/SewageExcretaSlurgeRvwColumn.ts

@@ -346,7 +346,6 @@ const rawSludgeList = [
             decimal1Col("rcycQnt", "재활용"),
             decimal1Col("olandLfvlm", "육상매립"),
             decimal1Col("incnrQnt", "소각"),
-            decimal1Col("oceanInputQnt", "해양투기"),
             decimal1Col("fuelQnt", "연료화"),
             decimal1Col("etcQnt", "기타"),
             decimal1Col("unprcsQnt", "미처분량\n(이월량)(C)"),
@@ -366,7 +365,6 @@ const rawSludgeList = [
                     "rcycQnt",
                     "olandLfvlm",
                     "incnrQnt",
-                    "oceanInputQnt",
                     "fuelQnt",
                     "etcQnt",
                 ],

apps/st/src/components/util/column/review/SewagePipeRvwColumn.ts

@@ -491,6 +491,10 @@ const rawList = [
             { name: 'sggNm', fieldName: 'sggNm', header: { text: '시군구' }, mergeCells: true, sortdisable: true },
             { name: 'admdstNm', fieldName: 'admdstNm', header: { text: '행정구역명' }, mergeCells: true, sortdisable: true },
             { name: 'emphsMngSeNm', fieldName: 'emphsMngSeNm', header: { text: '집중강우\n중점관리\n구역구분' }, mergeCells: true },
+            { name: 'wholMnhlCntSum', fieldName: 'wholMnhlCntSum', header: { text: '맨홀총계' }, footer: footerIntArrayByDivision, valueType: ValueType.NUMBER, dataFormat: '#,##0' },
+            { name: 'frlvlMnhlCntSum', fieldName: 'frlvlMnhlCntSum', header: { text: '주철계' }, footer: footerIntArrayByDivision, valueType: ValueType.NUMBER, dataFormat: '#,##0' },
+            { name: 'thlvlMnhlCntSum', fieldName: 'thlvlMnhlCntSum', header: { text: '콘크리트계' }, footer: footerIntArrayByDivision, valueType: ValueType.NUMBER, dataFormat: '#,##0' },
+            { name: 'picNm', fieldName: 'picNm', header: { text: '담당자명' } },
             {
                 name: 'displayYear',
                 fieldName: 'displayYear',
@@ -544,6 +548,12 @@ const rawList = [
                 ],
             },
             'emphsMngSeNm',
+            {
+                name: 'adminRefGroup',
+                hideChildHeaders: false,
+                header: { text: '행정참고자료' },
+                items: ['wholMnhlCntSum', 'frlvlMnhlCntSum', 'thlvlMnhlCntSum', 'picNm'],
+            },
             'displayYear',
             {
                 name: 'mtrlGroup',

apps/st/src/components/util/column/review/StatsInputStatusRvwColumn.ts

@@ -17,12 +17,12 @@ const StatsInputStatusInfoColumnRaw = {
             styleName: 'rg-cell-outline-action-btn',
         },
 
-        { name: 'chargerNm', fieldName: 'chargerNm', header: { text: '제출자' } },
-        { name: 'chargerCttpc', fieldName: 'chargerCttpc', header: { text: '연락처' } },
-        { name: 'submitStatusNm', fieldName: 'submitStatusNm', header: { text: '지자체진행상태' } },
-        { name: 'submitStatusCd', fieldName: 'submitStatusCd', header: { text: '지자체진행상태코드' }, visible: false },
-        { name: 'prvnStatusNm', fieldName: 'prvnStatusNm', header: { text: '진행상태' } },
-        { name: 'prvnStatusCd', fieldName: 'prvnStatusCd', header: { text: '진행상태코드' }, visible: false },
+        { name: 'lclgvPicNm', fieldName: 'lclgvPicNm', header: { text: '제출자' } },
+        { name: 'lclgvPicTelnoCn', fieldName: 'lclgvPicTelnoCn', header: { text: '연락처' } },
+        { name: 'lclgvSbmsnSttsNm', fieldName: 'lclgvSbmsnSttsNm', header: { text: '지자체진행상태' } },
+        { name: 'lclgvSbmsnSttsCd', fieldName: 'lclgvSbmsnSttsCd', header: { text: '지자체진행상태코드' }, visible: false },
+        { name: 'mctpvPicSbmsnSttsNm', fieldName: 'mctpvPicSbmsnSttsNm', header: { text: '진행상태' } },
+        { name: 'mctpvPicSbmsnSttsCd', fieldName: 'mctpvPicSbmsnSttsCd', header: { text: '진행상태코드' }, visible: false },
     ],
 
     columnLayout: [
@@ -30,14 +30,14 @@ const StatsInputStatusInfoColumnRaw = {
         'sggNm',
         'tabNm',
         'reviewHistory',
-        'chargerNm', 
-        'chargerCttpc', 
-        'submitStatusNm',
-        'prvnStatusNm', 
+        'lclgvPicNm',
+        'lclgvPicTelnoCn',
+        'lclgvSbmsnSttsNm',
+        'mctpvPicSbmsnSttsNm',
         'statsCd',
         'sewerBzmnCd',
-        'submitStatusCd',
-        'prvnStatusCd'
+        'lclgvSbmsnSttsCd',
+        'mctpvPicSbmsnSttsCd',
     ]
 };
 

apps/st/src/components/util/column/total/SewagePipeTotColumn.ts

@@ -710,6 +710,10 @@ const rawSewagePipeTotList = [
             { name: "sggNm", fieldName: "sggNm", header: { text: "시군구" }, editable: false },
             { name: "admdstNm", fieldName: "admdstNm", header: { text: "행정구역명" }, editable: false },
             { name: "emphsMngSeNm", fieldName: "emphsMngSeNm", header: { text: "집중강우\n중점관리\n구역구분" }, editable: false },
+            { name: "wholMnhlCntSum", fieldName: "wholMnhlCntSum", header: { text: "맨홀총계" }, valueType: ValueType.NUMBER, dataFormat: "#,##0", editable: false },
+            { name: "frlvlMnhlCntSum", fieldName: "frlvlMnhlCntSum", header: { text: "주철계" }, valueType: ValueType.NUMBER, dataFormat: "#,##0", editable: false },
+            { name: "thlvlMnhlCntSum", fieldName: "thlvlMnhlCntSum", header: { text: "콘크리트계" }, valueType: ValueType.NUMBER, dataFormat: "#,##0", editable: false },
+            { name: "picNm", fieldName: "picNm", header: { text: "담당자명" }, editable: false },
             { name: "wholMnhlCnt", fieldName: "wholMnhlCnt", header: { text: "계" }, valueType: ValueType.NUMBER, dataFormat: "#,##0", editable: false },
             { name: "frlvlMnhlCnt", fieldName: "frlvlMnhlCnt", header: { text: "주철" }, valueType: ValueType.NUMBER, dataFormat: "#,##0", editable: false },
             { name: "sclvlMnhlCnt", fieldName: "sclvlMnhlCnt", header: { text: "주철(조화)" }, valueType: ValueType.NUMBER, dataFormat: "#,##0", editable: false },
@@ -720,6 +724,11 @@ const rawSewagePipeTotList = [
         columnLayout: [
             { name: "addrGroup", header: { text: "행정구역" }, items: ["ctpvNm", "sggNm", "admdstNm"] },
             "emphsMngSeNm",
+            {
+                name: "adminRefGroup",
+                header: { text: "행정참고자료" },
+                items: ["wholMnhlCntSum", "frlvlMnhlCntSum", "thlvlMnhlCntSum", "picNm"],
+            },
             {
                 name: "mtrlGroup",
                 header: { text: "맨홀뚜껑 재질(개)" },

apps/st/src/components/util/column/total/sludgeProcessing/HumanWasteSludgeTab4Column.ts

@@ -16,7 +16,6 @@ export const HumanWasteSludgeTab4ColumnConfig = {
         { name: "rcycQnt", fieldName: "rcycQnt", header: { text: "재활용" }, valueType: ValueType.NUMBER, dataFormat: "#,##0.0", editable: false },
         { name: "olandLfvlm", fieldName: "olandLfvlm", header: { text: "육상매립" }, valueType: ValueType.NUMBER, dataFormat: "#,##0.0", editable: false },
         { name: "incnrQnt", fieldName: "incnrQnt", header: { text: "소각" }, valueType: ValueType.NUMBER, dataFormat: "#,##0.0", editable: false },
-        { name: "oceanInputQnt", fieldName: "oceanInputQnt", header: { text: "해양투기" }, valueType: ValueType.NUMBER, dataFormat: "#,##0.0", editable: false },
         { name: "fuelQnt", fieldName: "fuelQnt", header: { text: "연료화" }, valueType: ValueType.NUMBER, dataFormat: "#,##0.0", editable: false },
         { name: "etcQnt", fieldName: "etcQnt", header: { text: "기타" }, valueType: ValueType.NUMBER, dataFormat: "#,##0.0", editable: false },
         { name: "unprcsQnt", fieldName: "unprcsQnt", header: { text: "미처분량\n(이월량)(C)" }, valueType: ValueType.NUMBER, dataFormat: "#,##0.0", editable: false },
@@ -29,7 +28,7 @@ export const HumanWasteSludgeTab4ColumnConfig = {
         { 
             name: "dspsGroup", 
             header: { text: "처분량" }, 
-            items: ["wholDspsQnt", "rcycQnt", "olandLfvlm", "incnrQnt", "oceanInputQnt", "fuelQnt", "etcQnt"] 
+            items: ["wholDspsQnt", "rcycQnt", "olandLfvlm", "incnrQnt", "fuelQnt", "etcQnt"] 
         },
         "unprcsQnt",
         "swtrmtFcltNm"

apps/st/src/components/util/gridExcelExport.ts

@@ -1,4 +1,4 @@
-import type { GridView } from "realgrid";
+import { type GridView, ValueType } from "realgrid";
 
 import type {
     ColumnConfig,
@@ -124,6 +124,82 @@ export function getNonEditableColumnFieldNames(
     return fieldNames;
 }
 
+type ExcelImportCell = {
+    t?: string;
+    v?: unknown;
+    w?: string;
+};
+
+/** 엑셀 셀 → 그리드 값. NUMBER 컬럼만 숫자화하고, 코드(01)는 문자열로 유지 */
+export function parseExcelImportCellValue(
+    cell: ExcelImportCell | undefined,
+    valueType?: ColumnConfig["valueType"],
+): string | number {
+    if (!cell || cell.v === undefined || cell.v === null || cell.v === "") {
+        return "";
+    }
+
+    if (valueType === ValueType.NUMBER) {
+        if (typeof cell.v === "number" && !Number.isNaN(cell.v)) {
+            return cell.v;
+        }
+        const stringValue = String(cell.v);
+        const numericValue = Number(stringValue.replace(/,/g, ""));
+        if (!Number.isNaN(numericValue) && stringValue.trim() !== "") {
+            return numericValue;
+        }
+        return stringValue;
+    }
+
+    const formatted = typeof cell.w === "string" ? cell.w.trim() : "";
+    if (/^0\d+$/.test(formatted)) {
+        return formatted;
+    }
+    return String(cell.v);
+}
+
+function collectZeroPaddedCodeWidths(
+    rows: Record<string, string | number>[],
+): Map<string, number> {
+    const widthByField = new Map<string, number>();
+    for (const row of rows) {
+        for (const [field, value] of Object.entries(row)) {
+            const s = String(value ?? "").trim();
+            if (!/^0\d+$/.test(s)) continue;
+            widthByField.set(field, Math.max(widthByField.get(field) ?? 0, s.length));
+        }
+    }
+    return widthByField;
+}
+
+function restoreImportedCodeLeadingZeros(
+    importedRow: Record<string, string | number>,
+    existingRow: Record<string, string | number> | undefined,
+    codeWidthByField: Map<string, number>,
+): Record<string, string | number> {
+    const next: Record<string, string | number> = { ...importedRow };
+    for (const [field, value] of Object.entries(next)) {
+        if (value === "" || value == null) continue;
+        if (typeof value === "number" && !Number.isInteger(value)) continue;
+        const importedStr = String(value).trim();
+        if (!/^\d+$/.test(importedStr)) continue;
+
+        const existingStr =
+            existingRow != null ? String(existingRow[field] ?? "").trim() : "";
+        let width = codeWidthByField.get(field);
+        if (!width && /^0\d+$/.test(existingStr)) {
+            width = existingStr.length;
+        }
+        if (!width && field.endsWith("Cd") && importedStr.length <= 2) {
+            width = 2;
+        }
+        if (width && importedStr.length < width) {
+            next[field] = importedStr.padStart(width, "0");
+        }
+    }
+    return next;
+}
+
 /** 엑셀 import 결과를 기존 행과 병합 — preserveFieldNames는 기존 그리드 값 유지 */
 export function mergeExcelImportWithExistingRows(
     existingRows: Record<string, string | number>[],
@@ -134,14 +210,20 @@ export function mergeExcelImportWithExistingRows(
         options?.preserveFieldNames && options.preserveFieldNames.length > 0
             ? new Set(options.preserveFieldNames)
             : null;
+    const codeWidthByField = collectZeroPaddedCodeWidths(existingRows);
 
     return importedRows.map((importedRow, index) => {
         const existingRow = existingRows[index];
-        if (!existingRow) return { ...importedRow };
+        const normalizedImported = restoreImportedCodeLeadingZeros(
+            importedRow,
+            existingRow,
+            codeWidthByField,
+        );
+        if (!existingRow) return normalizedImported;
 
         const merged: Record<string, string | number> = {
             ...existingRow,
-            ...importedRow,
+            ...normalizedImported,
         };
         if (preserveSet) {
             for (const fieldName of preserveSet) {

apps/st/src/components/util/input/call-imr-with-rollback.ts

@@ -0,0 +1,23 @@
+import { statisticsApi } from "@/entities/statistics/api/statistics-service";
+import type {
+    ImrRequest,
+    ImrResponse,
+    rollbackStatusRequest,
+} from "@/entities/statistics/model/statistics-interface";
+
+/** 제출 직후 IMR 요청이 실패하면 검증 이전 상태로 롤백 */
+export async function callImrServiceWithRollbackOnFailure(
+    imrParam: ImrRequest,
+    rollbackParam: rollbackStatusRequest,
+): Promise<ImrResponse> {
+    try {
+        return await statisticsApi.callImrService(imrParam);
+    } catch (error) {
+        try {
+            await statisticsApi.rollbackStatus(rollbackParam);
+        } catch {
+            // 롤백 실패는 IMR 실패를 가리지 않음
+        }
+        throw error;
+    }
+}

apps/st/src/components/util/input/verification-failed-flag.ts

@@ -1,6 +1,9 @@
 import type { StatisticsInputCommonInfoBase } from "@/entities/statistics/model/statistics-interface";
 
-import type { VerificationResultLikeMap } from "./verification-result-display";
+import {
+    normalizeVerificationResultMap,
+    type VerificationResultLikeMap,
+} from "./verification-result-display";
 
 export function isVerificationFailedFromCommonInfo(
     commonInfo: Pick<StatisticsInputCommonInfoBase, "isVerificationFailed"> | null | undefined,
@@ -28,6 +31,9 @@ export function patchFooterVerificationByTab(
         | undefined,
 ): Map<string, VerificationResultLikeMap | null> {
     const next = new Map(prev);
-    next.set(tabKey, commonInfo?.verificationResult ?? null);
+    next.set(
+        tabKey,
+        normalizeVerificationResultMap(commonInfo?.verificationResult) ?? null,
+    );
     return next;
 }

apps/st/src/components/util/input/verification-result-display.ts

@@ -13,6 +13,49 @@ export type VerificationResultLikeMap = Record<
     VerificationResultLikeItem[]
 >;
 
+/** 입력 조회 verificationResult의 기준값/입력값이 null이면 "-" */
+export function displayVerificationCn(
+    value: string | null | undefined,
+): string {
+    if (value == null || String(value).trim() === "") return "-";
+    return String(value);
+}
+
+export function normalizeVerificationResultItem<T extends VerificationResultLikeItem>(
+    item: T,
+): T {
+    return {
+        ...item,
+        nowCn: displayVerificationCn(item.nowCn ?? item.nowVlCn),
+        cmprCn: displayVerificationCn(item.cmprCn ?? item.compVlCn),
+    };
+}
+
+export function normalizeVerificationResultMap<T extends VerificationResultLikeMap>(
+    result: T | null | undefined,
+): T | undefined {
+    if (!result || typeof result !== "object") return undefined;
+    const next = {} as T;
+    for (const [key, items] of Object.entries(result)) {
+        (next as VerificationResultLikeMap)[key] = Array.isArray(items)
+            ? items.map((item) => normalizeVerificationResultItem(item))
+            : [];
+    }
+    return next;
+}
+
+/** 조회 행/객체에 붙은 verificationResult의 cmprCn·nowCn null을 "-"로 바꿈 */
+export function withNormalizedVerificationResult<T extends object>(item: T): T {
+    if (!("verificationResult" in item) || item.verificationResult == null) {
+        return item;
+    }
+    const verificationResult = normalizeVerificationResultMap(
+        item.verificationResult as VerificationResultLikeMap,
+    );
+    if (!verificationResult) return item;
+    return { ...item, verificationResult };
+}
+
 /** 검증 오류 배열 → RealGrid styleName */
 export function getVerificationStyleName(
     errors: VerificationResultLikeItem[] | null | undefined,
@@ -37,8 +80,8 @@ export function formatVerificationTooltip(
                     : e.vrfcCd === "NV"
                       ? "일반검증 - "
                       : "모집단 검증 - ";
-            const comp = e.cmprCn ?? e.compVlCn ?? "";
-            const now = e.nowCn ?? e.nowVlCn ?? "";
+            const comp = displayVerificationCn(e.cmprCn ?? e.compVlCn);
+            const now = displayVerificationCn(e.nowCn ?? e.nowVlCn);
             return `${prefix}${e.rsnExpln}\n(검증 기준값: ${comp} / 현재 입력값: ${now})`;
         })
         .filter(Boolean)

apps/st/src/entities/statistics/api/general-verification-service.ts

@@ -56,10 +56,11 @@ export class GeneralverificationApiService implements GeneralverificationService
     }
 
     public async UpdateVrfcMaster(
+        vrfcSn: number,
         param: UpdateVrfcMasterRequest,
     ): Promise<UpdateVrfcMasterResponse> {
         const response = await stClient.put<UpdateVrfcMasterResponse>(
-            `${ENDPOINT.ST_SERVICE.INPUTVERIFY}/masters/${param.vrfcSn}`,
+            `${ENDPOINT.ST_SERVICE.INPUTVERIFY}/masters/${vrfcSn}`,
             param,
         );
         return response.data;
@@ -127,20 +128,22 @@ export class GeneralverificationApiService implements GeneralverificationService
     }
 
     public async RegistVrfcDetail(
+        vrfcSn: number,
         param: VerifyDetailRegistRequest,
     ): Promise<RegistVrfcMasterResponse> {
         const response = await stClient.post<RegistVrfcMasterResponse>(
-            `${ENDPOINT.ST_SERVICE.INPUTVERIFY}/${param.vrfcSn}/details`,
+            `${ENDPOINT.ST_SERVICE.INPUTVERIFY}/${vrfcSn}/details`,
             param,
         );
         return response.data;
     }
 
     public async UpdateVrfcDetail(
+        vrfcSn: number,
         param: VerifyDetailUpdateRequest,
     ): Promise<RegistVrfcMasterResponse> {
         const response = await stClient.put<RegistVrfcMasterResponse>(
-            `${ENDPOINT.ST_SERVICE.INPUTVERIFY}/${param.vrfcSn}/details`,
+            `${ENDPOINT.ST_SERVICE.INPUTVERIFY}/${vrfcSn}/details`,
             param,
         );
         return response.data;

apps/st/src/entities/statistics/api/statistics-service.ts

@@ -16,6 +16,8 @@ import {
     type ImrStatusResponse,
     type ReviewerInfoRequest,
     type ReviewerInfoResponse,
+    type rollbackStatusRequest,
+    type rollbackStatusResponse,
     type ReviewInputSaveRequest,
     type ReviewOpinionSaveRequest,
     type ReviewOpinionSaveResponse,
@@ -156,6 +158,17 @@ export class StatisticsApiService implements StatisticsService {
         return response.data;
     }
 
+    // 입력 - 검증 이전 상태로 롤백
+    public async rollbackStatus(
+        param: rollbackStatusRequest,
+    ): Promise<rollbackStatusResponse> {
+        const response = await stClient.put<rollbackStatusResponse>(
+            `${ENDPOINT.ST_SERVICE.INPUTCOMMON}/rollback-status`,
+            param,
+        );
+        return response.data;
+    }
+
     public async callImrService(param: ImrRequest): Promise<ImrResponse> {
         const response = await client.post<ImrResponse>(
             `${ENDPOINT.STATVERIFY_SERVICE.IMR}`,

apps/st/src/entities/statistics/model/dashboard/dashboard-interface.ts

@@ -1,100 +1,100 @@
-export interface DashboardSearchParams {
-    statsYr: string;
-    dtlInstCd: string;
-    enoCd?: string;
-    laeSeCd?: string;
-    sewerBzmnCd?: string;
-    sido?: string;
-    sggNm?: string;
-    unSubmitOnly?: boolean;
-}
-
-export interface DashboardApiResponse<T> {
-    status: string;
-    message: string;
-    data: T;
-    code: string;
-    httpStatus: number;
-}
-
-export interface VrfcReportResponse {
-    typeCounts: Record<string, number>;
-    list: VrfcReportSelect[];
-}
-
-export interface VrfcReportSelect {
-    vrfcCd: string;
-    statsNm: string;
-    rsnExpln: string;
-    admdstNm: string;
-    nowVlCn: string;
-    compVlCn: string;
-}
-
-export interface VrfcErrCountResponse {
-    statsYr: string;
-    vrfcErrCount: number;
-}
-
-export interface UnSubmitCountResponse {
-    statsYr: string;
-    statusList: UnSubmitStatsResponse[];
-    submittedCount: number;
-    totalCount: number;
-    unSubmittedCount: number;
-}
-
-export interface UnSubmitStatsResponse {
-    sbmsnYn: string;
-    sidoSggNm: string;
-    statsCd: string;
-    statsNm: string;
-    statusCd: string;
-    statusNm: string;
-}
-
-export interface StatsSubmissionResponse {
-    totalCount: number;
-    submittedCount: number;
-    submissionRate: number;
-    statusLevel: string;
-}
-
-export interface EcptReqCountResponse {
-    statsYr: string;
-    ecptReqCount: number;
-}
-
-export interface ThreeStageStatusResponse {
-    statsYr: string;
-    lclgvSbmsnSttsCd: string;
-    lclgvSbmsnSttsNm: string;
-    lclgvRejected: boolean;
-    mctpvPicSbmsnSttsCd: string;
-    mctpvPicSbmsnSttsNm: string;
-    mctpvRejected: boolean;
-    pbcpSbmsnSttsCd: string;
-    pbcpSbmsnSttsNm: string;
-    pbcpRejected: boolean;
-}
-
-export interface DashboardService {
-    getVrfcReport(
-        params: DashboardSearchParams,
-    ): Promise<DashboardApiResponse<VrfcReportResponse>>;
-    getVrfcErrCount(
-        params: DashboardSearchParams,
-    ): Promise<DashboardApiResponse<VrfcErrCountResponse>>;
-    getUnSubmitCount(
-        params: DashboardSearchParams,
-    ): Promise<DashboardApiResponse<UnSubmitCountResponse>>;
-    getStatsSubmissionRate(
-        params: DashboardSearchParams,
-    ): Promise<DashboardApiResponse<StatsSubmissionResponse>>;
-    getEcptReqCount(
-        params: DashboardSearchParams,
-    ): Promise<DashboardApiResponse<EcptReqCountResponse>>;
-        getThreeStageStatus(
-        params: DashboardSearchParams,
-    ): Promise<DashboardApiResponse<ThreeStageStatusResponse>>;
-}
+export interface DashboardSearchParams {
+    statsYr: string;
+    dtlInstCd: string;
+    enoCd?: string;
+    laeSeCd?: string;
+    sewerBzmnCd?: string;
+    sido?: string;
+    sggNm?: string;
+    unSubmitOnly?: boolean;
+}
+
+export interface DashboardApiResponse<T> {
+    status: string;
+    message: string;
+    data: T;
+    code: string;
+    httpStatus: number;
+}
+
+export interface VrfcReportResponse {
+    typeCounts: Record<string, number>;
+    list: VrfcReportSelect[];
+}
+
+export interface VrfcReportSelect {
+    vrfcCd: string;
+    statsNm: string;
+    rsnExpln: string;
+    admdstNm: string;
+    nowCn: string;
+    cmprCn: string | null;
+}
+
+export interface VrfcErrCountResponse {
+    statsYr: string;
+    vrfcErrCount: number;
+}
+
+export interface UnSubmitCountResponse {
+    statsYr: string;
+    statusList: UnSubmitStatsResponse[];
+    submittedCount: number;
+    totalCount: number;
+    unSubmittedCount: number;
+}
+
+export interface UnSubmitStatsResponse {
+    sbmsnYn: string;
+    sidoSggNm: string;
+    statsCd: string;
+    statsNm: string;
+    statusCd: string;
+    statusNm: string;
+}
+
+export interface StatsSubmissionResponse {
+    totalCount: number;
+    submittedCount: number;
+    submissionRate: number;
+    statusLevel: string;
+}
+
+export interface EcptReqCountResponse {
+    statsYr: string;
+    ecptReqCount: number;
+}
+
+export interface ThreeStageStatusResponse {
+    statsYr: string;
+    lclgvSbmsnSttsCd: string;
+    lclgvSbmsnSttsNm: string;
+    lclgvRejected: boolean;
+    mctpvPicSbmsnSttsCd: string;
+    mctpvPicSbmsnSttsNm: string;
+    mctpvRejected: boolean;
+    pbcpSbmsnSttsCd: string;
+    pbcpSbmsnSttsNm: string;
+    pbcpRejected: boolean;
+}
+
+export interface DashboardService {
+    getVrfcReport(
+        params: DashboardSearchParams,
+    ): Promise<DashboardApiResponse<VrfcReportResponse>>;
+    getVrfcErrCount(
+        params: DashboardSearchParams,
+    ): Promise<DashboardApiResponse<VrfcErrCountResponse>>;
+    getUnSubmitCount(
+        params: DashboardSearchParams,
+    ): Promise<DashboardApiResponse<UnSubmitCountResponse>>;
+    getStatsSubmissionRate(
+        params: DashboardSearchParams,
+    ): Promise<DashboardApiResponse<StatsSubmissionResponse>>;
+    getEcptReqCount(
+        params: DashboardSearchParams,
+    ): Promise<DashboardApiResponse<EcptReqCountResponse>>;
+        getThreeStageStatus(
+        params: DashboardSearchParams,
+    ): Promise<DashboardApiResponse<ThreeStageStatusResponse>>;
+}

apps/st/src/entities/statistics/model/general-verification-interface.ts

@@ -46,7 +46,6 @@ export interface CheckVerificationNameResponse {
 }
 
 export interface UpdateVrfcMasterRequest {
-    vrfcSn?: number | null;
     vrfcNm?: string | null;
     vrfcClsfCd?: string | null;
     dcptDgt?: number | null;
@@ -184,13 +183,11 @@ export interface VerifyDetailRegistData {
 }
 
 export interface VerifyDetailRegistRequest {
-    vrfcSn: number | null;
     detailList: VerifyDetailRegistData[];
     rgtrUuid: string;
 }
 
 export interface VerifyDetailUpdateRequest {
-    vrfcSn: number | null;
     detailList: VerifyDetailRegistData[];
     mdfrUuid: string;
 }
@@ -297,6 +294,7 @@ export interface GeneralverificationService {
         param: CheckVerificationNameRequest,
     ): Promise<CheckVerificationNameResponse>;
     UpdateVrfcMaster(
+        vrfcSn: number,
         param: UpdateVrfcMasterRequest,
     ): Promise<UpdateVrfcMasterResponse>;
     RegistVrfcMaster(
@@ -315,9 +313,11 @@ export interface GeneralverificationService {
         param: string,
     ): Promise<VerifyColumnListResponse>;
     RegistVrfcDetail(
+        vrfcSn: number,
         param: VerifyDetailRegistRequest,
     ): Promise<RegistVrfcMasterResponse>;
     UpdateVrfcDetail(
+        vrfcSn: number,
         param: VerifyDetailUpdateRequest,
     ): Promise<RegistVrfcMasterResponse>;
     CopyVrfcData(

apps/st/src/entities/statistics/model/input/statistics-input-sewage-excreta-slurge-interface.ts

@@ -117,7 +117,7 @@ export type SlurgeProcessingFacStatusApiResponse =
     };
 
 /**
- * ST00110001 저장 — `saveList` / `deleteList` 항목.
+ * ST00110001 저장 — `saveList` 항목.
  * `sggNm`·계산필드·검증결과는 저장 요청에서 제외.
  */
 export type SlurgeProcessingFacStatusSaveItem = Omit<
@@ -167,7 +167,6 @@ export interface SlurgeProcessingFacStatusSaveRequest {
     superAdmin?: string;
     noApplicable?: boolean;
     saveList: SlurgeProcessingFacStatusSaveItem[];
-    deleteList: SlurgeProcessingFacStatusSaveItem[];
 }
 
 export type SlurgeProcessingFacStatusSaveResponse = ApiResponse<unknown> & {
@@ -194,7 +193,6 @@ export interface SlurgeProcessingFacStatusSubmitRequest {
     superAdmin?: string;
     noApplicable?: boolean;
     submitList: SlurgeProcessingFacStatusSubmitItem[];
-    deleteList: SlurgeProcessingFacStatusSubmitItem[];
 }
 
 export interface SlurgeProcessingFacStatusSubmitResponse {
@@ -439,7 +437,6 @@ export interface ExcretaSlurgeProcessingStatusItem {
     rcycQnt: number;
     olandLfvlm: number;
     incnrQnt: number;
-    oceanInputQnt: number;
     fuelQnt: number;
     etcQnt: number;
     unprcsQnt: number;

apps/st/src/entities/statistics/model/input/statistics-input-sewage-pipe-maintain-interface.ts

@@ -98,7 +98,6 @@ export type SewagePipeMaintainDredgingResponse = ApiResponse<SewagePipeMaintainD
 /** ST00030001 하수관로 유지관리 > 개보수 저장·제출 API 행 */
 export interface SewagePipeMaintainRepairSaveItem {
     admdstCd: string | null;
-    sggNm: string | null;
     admdstNm: string | null;
     dfrpWholPrlg: number;
     cbsysDfrpPrlg: number;
@@ -167,7 +166,6 @@ export interface SewagePipeMaintainRepairSubmitResponse {
 /** ST00030002 하수관로 유지관리 > 관로준설 저장·제출 API 행 */
 export interface SewagePipeMaintainDredgingSaveItem {
     admdstCd: string | null;
-    sggNm: string | null;
     admdstNm: string | null;
     wholFcltPrlg: number;
     wholSwagePpl: number;

apps/st/src/entities/statistics/model/input/statistics-input-sewerage-finance-interface.ts

@@ -92,7 +92,6 @@ export interface SewerageFinanceSettleRequestParams {
  */
 export interface SewerageFinanceSettleSaveItem {
     admdstCd: string | null;
-    sggNm: string | null;
     admdstNm: string | null;
     soaGovSprtAmt: number;
     mctpvLcexpAmt: number;
@@ -255,7 +254,6 @@ export interface SewerageChargeRequestParams {
  */
 export interface SewerageChargeSaveItem {
     admdstCd: string | null;
-    sggNm: string | null;
     admdstNm: string | null;
     anlLevyQnt: number;
     sewerLevyAmt: number;
@@ -362,7 +360,6 @@ export interface SewerageUsageFeeRequestParams {
  */
 export interface SewerageUsageFeeSaveItem {
     admdstCd: string | null;
-    sggNm: string | null;
     admdstNm: string | null;
     hshusLevyAmt: number;
     hshusLevyQnt: number;
@@ -472,7 +469,6 @@ export interface CauserBurdenRequestParams {
  */
 export interface CauserBurdenSaveItem {
     admdstCd: string | null;
-    sggNm: string | null;
     admdstNm: string | null;
     brdnAmtLevyNocs: number;
     brdnAmtLevyAmt: number;

apps/st/src/entities/statistics/model/input/statistics-input-status-interface.ts

@@ -81,7 +81,6 @@ export interface ReportStatusResponseDto {
     lastCfmtnPicTelnoCn?: string | null;
     lastCfmtnPicDeptNm?: string | null;
     lastCfmtnPicJbgdNm?: string | null;
-    splmntRsltCn?: string | null;
     splmntOpnnCn?: string | null;
     rjctOpnnCn?: string | null;
 }

apps/st/src/entities/statistics/model/input/statistics-sewage-pipe-input-interface.ts

@@ -99,7 +99,6 @@ export type SeweragePipeInputRegionalFactStatusSaveItem = Omit<
     "verificationResult" | "admdstCd" | "sggNm" | "admdstNm" | "goalYr"
 > & {
     admdstCd: string | null;
-    sggNm: string | null;
     admdstNm: string | null;
     goalYr: string | null;
 };
@@ -118,7 +117,6 @@ export type SeweragePipeInputFactInstallStatusSaveItem = Omit<
     | "rmrk"
 > & {
     admdstCd: string | null;
-    sggNm: string | null;
     admdstNm: string | null;
     fcltSn: string | null;
     swtrmtFcltCd: string | null;
@@ -310,7 +308,6 @@ export interface SeweragePipeInputPipeTypeStatusSaveItem {
     rmrk: string | null;
     lyngPrlgWhol: number;
     dmltnPrlgWhol: number;
-    pipeByPrstWhol: number;
 }
 
 /** 관종별 현황 저장 API 요청 */
@@ -422,6 +419,10 @@ export interface SeweragePipeInputManholeStatusItem {
     folvlMnhlCnt: number;
     filvlMnhlCnt: number;
     rmrk: string;
+    wholMnhlCntSum: number;
+    frlvlMnhlCntSum: number;
+    thlvlMnhlCntSum: number;
+    picNm: string | null;
     verificationResult?: SeweragePipeInputVerificationResult;
 }
 

apps/st/src/entities/statistics/model/input/statistics-sewage-supply-rate-input-interface.ts

@@ -86,7 +86,6 @@ export interface SewerageSupplyRateRequestParams {
 
 /** 하수도 보급률 저장 API 요청 body (한 행) */
 export interface SewerageSupplyRateSaveItem {
-    sggNm: string | null;
     admdstCd: string | null;
     admdstNm: string | null;
     statsTrbtrNm: string | null;

apps/st/src/entities/statistics/model/statistics-input-review-interface.ts

@@ -9,12 +9,12 @@ export interface StatsInputStatusReviewItem {
     sewerBzmnCd?: string;
     tabNm?: string;
     statsCd?: string;
-    submitStatusNm?: string;
-    prvnStatusNm?: string;
-    chargerNm?: string;
-    chargerCttpc?: string;
-    submitStatusCd?: string;
-    prvnStatusCd?: string;
+    lclgvPicNm?: string;
+    lclgvPicTelnoCn?: string;
+    lclgvSbmsnSttsCd?: string;
+    lclgvSbmsnSttsNm?: string;
+    mctpvPicSbmsnSttsCd?: string;
+    mctpvPicSbmsnSttsNm?: string;
 }
 
 export interface StatsInputStatusReviewResponseData {
@@ -37,7 +37,7 @@ export interface ReviewHistoryResponse {
     status: string;
     message?: string;
     data: {
-        logDt: string;
+        regDt: string;
         historyContent: string;
     }[]
 }

apps/st/src/entities/statistics/model/statistics-interface.ts

@@ -31,6 +31,21 @@ export interface cancelSubmitResponse {
     message?: string;
 }
 
+/** 검증 이전 상태로 롤백 요청 */
+export interface rollbackStatusRequest {
+    statsYr: string;
+    statsCd: string;
+    sewerBzmnCd: string;
+    rollbackStatusCode: string;
+    mdfrUuid: string;
+}
+
+/** 검증 이전 상태로 롤백 응답 */
+export interface rollbackStatusResponse {
+    status: string;
+    message?: string;
+}
+
 export interface ApiResponse<T> {
     status: string;
     data?: T;
@@ -327,7 +342,6 @@ export interface ReviewOpinionDetailItem {
     sewerBzmnCd: string;
     statsCd: string;
     splmntOpnnCn: string | null;
-    splmntRsltCn: string | null;
     mdfrUuid: string | null;
 }
 
@@ -343,7 +357,6 @@ export interface ReviewOpinionSaveRequest {
     sewerBzmnCd: string;
     statsCd: string;
     splmntOpnnCn: string;
-    splmntRsltCn: string;
     mdfrUuid: string;
 }
 
@@ -388,7 +401,6 @@ export interface ReviewSubmitRequest {
     /** 통계항목 단위 제출 시 사용 (통계 입력 현황 일괄 제출에는 미사용) */
     statsCd?: string;
     splmntOpnnCn?: string;
-    splmntRsltCn?: string;
 }
 
 export interface ReviewSubmitResponse {
@@ -454,7 +466,6 @@ export interface ReviewerInfoResponse {
         dpmNm: string;
         cps: string;
         splmntOpnnCn: string;
-        splmntRsltCn: string;
     }
 }
 
@@ -478,9 +489,8 @@ export interface StatiscicsManagementReviewHistoryItem {
     ctpvNm: string;
     sggNm: string;
     menuNm: string;
-    wrterOpinionSm: string | null;
-    chckerOpinionSm: string | null;
-    returnOpinionSm: string | null;
+    splmntOpnnCn: string | null;
+    rjctOpnnCn: string | null;
 }
 
 export interface StatiscicsManagementReviewHistoryResponse {
@@ -557,6 +567,7 @@ export interface StatisticsService {
     saveStatsInputPeriod(param: StatsInputPeriodSaveRequest): Promise<StatsInputPeriodSaveApiResponse>;
     deleteStatsInputPeriod(param: StatsInputPeriodDeleteRequest): Promise<StatsInputPeriodDeleteApiResponse>;
     cancelSubmit(param: cancelSubmitRequest): Promise<cancelSubmitResponse>;
+    rollbackStatus(param: rollbackStatusRequest): Promise<rollbackStatusResponse>;
     callImrService(param: ImrRequest): Promise<ImrResponse>;
     submitException(param: SubmitExceptionRequest): Promise<SubmitExceptionResponse>;
     getLogList(param: StatisticsLogRequest): Promise<StatisticsLogResponse>;

apps/st/src/entities/statistics/model/statistics-sewage-excreta-slurge-review-interface.ts

@@ -127,7 +127,6 @@ export interface HumanWasteSludgeReviewItem {
     rcycQnt: number | null;
     olandLfvlm: number | null;
     incnrQnt: number | null;
-    oceanInputQnt: number | null;
     fuelQnt: number | null;
     etcQnt: number | null;
     unprcsQnt: number | null;
@@ -218,7 +217,6 @@ export function mapSewageExcretaSlurgeReviewRows(list: unknown[]): object[] {
             rcycQnt: row.rcycQnt ?? 0,
             olandLfvlm: row.olandLfvlm ?? 0,
             incnrQnt: row.incnrQnt ?? 0,
-            oceanInputQnt: row.oceanInputQnt ?? 0,
             fuelQnt: row.fuelQnt ?? 0,
             etcQnt: row.etcQnt ?? 0,
             unprcsQnt: row.unprcsQnt ?? 0,

apps/st/src/entities/statistics/model/statistics-sewage-pipe-mtc-review-interface.ts

@@ -108,5 +108,4 @@ export interface StatsStatusInfo {
     mctpvPicSbmsnSttsCd?: string;
     rjctOpnnCn?: string;
     splmntOpnnCn?: string;
-    splmntRsltCn?: string;
 }

apps/st/src/entities/statistics/model/statistics-sewage-pipe-review-interface.ts

@@ -247,6 +247,10 @@ export interface SewagePipeReviewManholeItem {
     folvlMnhlCnt: number;
     filvlMnhlCnt: number;
     rmrk: string | null;
+    wholMnhlCntSum: number;
+    frlvlMnhlCntSum: number;
+    thlvlMnhlCntSum: number;
+    picNm: string | null;
 }
 
 export interface SewagePipeManholeResponseData {
@@ -266,5 +270,4 @@ export interface StatsStatusInfo {
     mctpvPicSbmsnSttsCd?: string;
     rjctOpnnCn?: string;
     splmntOpnnCn?: string;
-    splmntRsltCn?: string;
 }

apps/st/src/entities/statistics/model/statistics-sewerage-penetration-review-interface.ts

@@ -59,7 +59,6 @@ export interface statsStatusInfo {
     mctpvPicSbmsnSttsCd?: string;
     rjctOpnnCn?: string;
     splmntOpnnCn?: string;
-    splmntRsltCn?: string;
 }
 
 export interface SewerageSupplyRateReviewResponseData {

apps/st/src/entities/statistics/model/statistics-total/statistics-sewage-pipe-total-interface.ts

@@ -168,6 +168,10 @@ export interface FcltyManholeSummaryItem {
     thlvlMnhlCnt: number;
     folvlMnhlCnt: number;
     filvlMnhlCnt: number;
+    wholMnhlCntSum: number;
+    frlvlMnhlCntSum: number;
+    thlvlMnhlCntSum: number;
+    picNm: string | null;
 }
 
 /**

apps/st/src/entities/statistics/model/statistics-total/statistics-sludge-total-interface.ts

@@ -135,7 +135,6 @@ export interface HumanWasteSludgeStatusTotalItem {
     rcycQnt: number;
     olandLfvlm: number;
     incnrQnt: number;
-    oceanInputQnt: number;
     fuelQnt: number;
     etcQnt: number;
     unprcsQnt: number;

apps/st/src/pages/statistics/ui/panels/stats-submission-panel.tsx

@@ -19,14 +19,14 @@ interface StatsSubmissionPanelProps {
 const STATUS_LEVEL_TEXT_COLOR = {
     GREAT: "text-blue-500",
     GOOD: "text-green-500",
-    WARNING: "text-yellow-500",
+    NORMAL: "text-yellow-500",
     BAD: "text-red-500",
 };
 
 const STATUS_LEVEL_EMOJI = {
     GREAT: <Laugh size={160} className={STATUS_LEVEL_TEXT_COLOR.GREAT} />,
     GOOD: <Smile size={160} className={STATUS_LEVEL_TEXT_COLOR.GOOD} />,
-    WARNING: <Meh size={160} className={STATUS_LEVEL_TEXT_COLOR.WARNING} />,
+    NORMAL: <Meh size={160} className={STATUS_LEVEL_TEXT_COLOR.NORMAL} />,
     BAD: <Frown size={160} className={STATUS_LEVEL_TEXT_COLOR.BAD} />,
 };
 

apps/st/src/pages/statistics/ui/panels/vrfc-report-panel.tsx

@@ -1,133 +1,133 @@
-"use client";
-
-import { useDashboardVrfcReport } from "@/entities/statistics";
-import type { DashboardSearchParams } from "@/entities/statistics/model/dashboard/dashboard-interface";
-import {
-    Badge,
-    type BadgeProps,
-    LoadingWithAnimation,
-} from "@common/components";
-
-import { useDragHandle } from "../sortable-panel";
-
-interface VrfcReportPanelProps {
-    params: DashboardSearchParams | null;
-}
-
-const TYPE_CODE_NAME_MAP: Record<string, string> = {
-    NV: "일반",
-    IMR: "I-MR",
-    HB: "HB",
-};
-
-const TYPE_CODE_COLOR_MAP: Record<string, BadgeProps["color"]> = {
-    NV: "gray",
-    IMR: "red",
-    HB: "blue",
-};
-
-export function VrfcReportPanel({ params }: VrfcReportPanelProps) {
-    const { dragHandleProps, isDragging } = useDragHandle();
-    const { data, isLoading, error } = useDashboardVrfcReport(params);
-
-    return (
-        <div className="card card-border !m-0 h-full border-border bg-background text-foreground">
-            <div
-                className={`card-header cursor-grab border-border active:cursor-grabbing ${isDragging ? "opacity-50" : ""}`}
-                {...dragHandleProps}
-                title="헤더를 드래그하여 패널 순서 변경"
-            >
-                <h3 className="text-2xl font-semibold">이상치 선별보고서</h3>
-            </div>
-            <div className="card-body max-h-[calc(100%-3.25rem)] py-2.5">
-                {isLoading && (
-                    <div className="flex h-full items-center justify-center">
-                        <div className="relative size-[5rem]">
-                            <LoadingWithAnimation color="primary" />
-                        </div>
-                    </div>
-                )}
-                {error && (
-                    <div className="flex h-full items-center justify-center">
-                        데이터를 불러올 수 없습니다.
-                    </div>
-                )}
-                {data && (
-                    <div className="space-y-2">
-                        {/* TBD: typeCounts 표시 방법 (탭? 필터?) */}
-                        {data.typeCounts &&
-                            Object.keys(data.typeCounts).length > 0 && (
-                                <div className="flex flex-wrap gap-2">
-                                    {Object.entries(data.typeCounts).map(
-                                        ([type, count]) => (
-                                            <Badge
-                                                key={type}
-                                                color={
-                                                    TYPE_CODE_COLOR_MAP[type]
-                                                }
-                                                className="rounded-full px-2 py-1 text-lg"
-                                            >
-                                                {TYPE_CODE_NAME_MAP[type]}:{" "}
-                                                {count}
-                                            </Badge>
-                                        ),
-                                    )}
-                                </div>
-                            )}
-
-                        {/* TBD: 테이블 컬럼 정의, 증감 표시 방법 */}
-                        <div className="max-h-[44rem] overflow-y-auto">
-                            {data.list.length === 0 ? (
-                                <div className="flex h-full items-center justify-center">
-                                    이상치 항목이 없습니다.
-                                </div>
-                            ) : (
-                                <div className="space-y-2 tracking-tight">
-                                    {data.list.map((item, index) => (
-                                        <div
-                                            key={index}
-                                            className="flex flex-col rounded-sm border border-border p-3"
-                                        >
-                                            <div className="mb-2 flex items-center justify-between">
-                                                <span className="font-medium">
-                                                    {item.statsNm}
-                                                </span>
-                                                <Badge
-                                                    color={
-                                                        TYPE_CODE_COLOR_MAP[
-                                                            item.vrfcCd
-                                                        ]
-                                                    }
-                                                    className="text-sm"
-                                                >
-                                                    {
-                                                        TYPE_CODE_NAME_MAP[
-                                                            item.vrfcCd
-                                                        ]
-                                                    }
-                                                </Badge>
-                                            </div>
-                                            <p className="text-lg text-muted-foreground">
-                                                {item.rsnExpln}
-                                            </p>
-                                            <div className="flex justify-between text-lg text-muted-foreground">
-                                                <span>{item.admdstNm}</span>
-                                                <span>
-                                                    {/* TBD: 증감 표시 방법 (nowVlCn - compVlCn 계산?) */}
-                                                    현재: {item.nowVlCn ?? "-"}{" "}
-                                                    / 비교:{" "}
-                                                    {item.compVlCn ?? "-"}
-                                                </span>
-                                            </div>
-                                            {/* TBD: 등급/점수/단계/업데이트 시각 필드 미제공 */}
-                                        </div>
-                                    ))}
-                                </div>
-                            )}
-                        </div>
-                    </div>
-                )}
-            </div>
-        </div>
-    );
-}
+"use client";
+
+import { useDashboardVrfcReport } from "@/entities/statistics";
+import type { DashboardSearchParams } from "@/entities/statistics/model/dashboard/dashboard-interface";
+import {
+    Badge,
+    type BadgeProps,
+    LoadingWithAnimation,
+} from "@common/components";
+
+import { useDragHandle } from "../sortable-panel";
+
+interface VrfcReportPanelProps {
+    params: DashboardSearchParams | null;
+}
+
+const TYPE_CODE_NAME_MAP: Record<string, string> = {
+    NV: "일반",
+    IMR: "I-MR",
+    HB: "HB",
+};
+
+const TYPE_CODE_COLOR_MAP: Record<string, BadgeProps["color"]> = {
+    NV: "gray",
+    IMR: "red",
+    HB: "blue",
+};
+
+export function VrfcReportPanel({ params }: VrfcReportPanelProps) {
+    const { dragHandleProps, isDragging } = useDragHandle();
+    const { data, isLoading, error } = useDashboardVrfcReport(params);
+
+    return (
+        <div className="card card-border !m-0 h-full border-border bg-background text-foreground">
+            <div
+                className={`card-header cursor-grab border-border active:cursor-grabbing ${isDragging ? "opacity-50" : ""}`}
+                {...dragHandleProps}
+                title="헤더를 드래그하여 패널 순서 변경"
+            >
+                <h3 className="text-2xl font-semibold">이상치 선별보고서</h3>
+            </div>
+            <div className="card-body max-h-[calc(100%-3.25rem)] py-2.5">
+                {isLoading && (
+                    <div className="flex h-full items-center justify-center">
+                        <div className="relative size-[5rem]">
+                            <LoadingWithAnimation color="primary" />
+                        </div>
+                    </div>
+                )}
+                {error && (
+                    <div className="flex h-full items-center justify-center">
+                        데이터를 불러올 수 없습니다.
+                    </div>
+                )}
+                {data && (
+                    <div className="space-y-2">
+                        {/* TBD: typeCounts 표시 방법 (탭? 필터?) */}
+                        {data.typeCounts &&
+                            Object.keys(data.typeCounts).length > 0 && (
+                                <div className="flex flex-wrap gap-2">
+                                    {Object.entries(data.typeCounts).map(
+                                        ([type, count]) => (
+                                            <Badge
+                                                key={type}
+                                                color={
+                                                    TYPE_CODE_COLOR_MAP[type]
+                                                }
+                                                className="rounded-full px-2 py-1 text-lg"
+                                            >
+                                                {TYPE_CODE_NAME_MAP[type]}:{" "}
+                                                {count}
+                                            </Badge>
+                                        ),
+                                    )}
+                                </div>
+                            )}
+
+                        {/* TBD: 테이블 컬럼 정의, 증감 표시 방법 */}
+                        <div className="max-h-[44rem] overflow-y-auto">
+                            {data.list.length === 0 ? (
+                                <div className="flex h-full items-center justify-center">
+                                    이상치 항목이 없습니다.
+                                </div>
+                            ) : (
+                                <div className="space-y-2 tracking-tight">
+                                    {data.list.map((item, index) => (
+                                        <div
+                                            key={index}
+                                            className="flex flex-col rounded-sm border border-border p-3"
+                                        >
+                                            <div className="mb-2 flex items-center justify-between">
+                                                <span className="font-medium">
+                                                    {item.statsNm}
+                                                </span>
+                                                <Badge
+                                                    color={
+                                                        TYPE_CODE_COLOR_MAP[
+                                                            item.vrfcCd
+                                                        ]
+                                                    }
+                                                    className="text-sm"
+                                                >
+                                                    {
+                                                        TYPE_CODE_NAME_MAP[
+                                                            item.vrfcCd
+                                                        ]
+                                                    }
+                                                </Badge>
+                                            </div>
+                                            <p className="text-lg text-muted-foreground">
+                                                {item.rsnExpln}
+                                            </p>
+                                            <div className="flex justify-between text-lg text-muted-foreground">
+                                                <span>{item.admdstNm}</span>
+                                                <span>
+                                                    {/* TBD: 증감 표시 방법 (nowCn - cmprCn 계산?) */}
+                                                    현재:{" "}{item.nowCn ?? "-"}
+                                                    / 비교:{" "}
+                                                    {item.cmprCn ?? "-"}
+                                                </span>
+                                            </div>
+                                            {/* TBD: 등급/점수/단계/업데이트 시각 필드 미제공 */}
+                                        </div>
+                                    ))}
+                                </div>
+                            )}
+                        </div>
+                    </div>
+                )}
+            </div>
+        </div>
+    );
+}

apps/st/src/shared/lib/statistics-tab-url.ts

@@ -1,5 +1,7 @@
 export const STATISTICS_ROUTE = "/statistics";
 export const STATISTICS_TAB_QUERY_KEY = "tab";
+/** 기본 화면(대시보드) 도움말 매칭용. URL에는 넣지 않음 */
+export const STATISTICS_DASHBOARD_TAB_ID = "Dashboard";
 
 export function buildStatisticsTabUrl(tabId: string): string {
     return `${STATISTICS_ROUTE}?${STATISTICS_TAB_QUERY_KEY}=${encodeURIComponent(tabId)}`;

apps/st/src/shared/ui/statistics-page-layout.tsx

@@ -1,13 +1,20 @@
 import { PageTitle } from "@common/components";
 
+import { findMenuItemByUrlPath } from "@/shared/lib/stats-cd-input-navigation";
+import { STATISTICS_DASHBOARD_TAB_ID } from "@/shared/lib/statistics-tab-url";
+
 import { TabBar } from "./tab-bar";
 
 import { useTabStore } from "@/store/tab-store";
 
 function StatisticsPageLayout({ children }: { children: React.ReactNode }) {
-    const { activeTabId, tabs } = useTabStore();
+    const { activeTabId, tabs, menuList } = useTabStore();
 
     const pageTitle = tabs.find((t) => t.id === activeTabId);
+    const dashboardMenu =
+        !pageTitle && menuList
+            ? findMenuItemByUrlPath(menuList, STATISTICS_DASHBOARD_TAB_ID)
+            : null;
 
     const menuPaths = pageTitle?.path?.split(">").map((path) => path.trim());
 
@@ -16,6 +23,7 @@ function StatisticsPageLayout({ children }: { children: React.ReactNode }) {
             <TabBar />
             <PageTitle
                 title={pageTitle?.label ?? ""}
+                menuCd={pageTitle?.menuItem?.menuCd ?? dashboardMenu?.menuCd}
                 menuPaths={menuPaths ?? []}
             />
             {children}

packages/common/components/src/ui/calendar/index.tsx

@@ -73,7 +73,10 @@ function Calendar({
           "has-focus:border-ring border-input shadow-xs has-focus:ring-ring/50 has-focus:ring-[3px] relative rounded-md border",
           defaultClassNames.dropdown_root,
         ),
-        dropdown: cn("absolute inset-0 opacity-0", defaultClassNames.dropdown),
+        dropdown: cn(
+          "absolute inset-0 opacity-0 [&_option]:bg-background [&_option]:text-foreground",
+          defaultClassNames.dropdown,
+        ),
         caption_label: cn(
           "select-none font-medium",
           captionLayout === "label"