[cm] typo: 404 페이지 문구 수정

apps/_template/tsconfig.json

@@ -19,11 +19,15 @@
       }
     ],
     "paths": {
-      "@/*": ["./src/*"],
-      "@common/components": ["../../packages/common/components/dist/"],
-      "@common/network": ["../../packages/common/network/"]
+      "@/*": ["./src/*"]
     }
   },
-  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
-  "exclude": ["node_modules"]
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    "../../packages/common/types/**/*.d.ts"
+  ],
+  "exclude": ["node_modules", ".next", "dist", "coverage", "storybook-static", "public"]
 }

apps/as/app/(with-base-layout)/design-cnstn/[id]/edit/page.tsx

@@ -0,0 +1,10 @@
+import { DesignEditPage } from "@/pages/design-cnstn";
+
+interface PageProps {
+  params: Promise<{ id: string }>;
+}
+
+export default async function Page({ params }: PageProps) {
+  const { id } = await params;
+  return <DesignEditPage id={id} />;
+}

apps/as/app/(with-base-layout)/design-cnstn/[id]/page.tsx

@@ -0,0 +1,10 @@
+import { DesignViewPage } from "@/pages/design-cnstn";
+
+interface PageProps {
+  params: Promise<{ id: string }>;
+}
+
+export default async function Page({ params }: PageProps) {
+  const { id } = await params;
+  return <DesignViewPage id={id} />;
+}

apps/as/app/(with-base-layout)/design-cnstn/page.tsx

@@ -0,0 +1,3 @@
+import { DesignListPage } from "@/pages/design-cnstn";
+
+export default DesignListPage;

apps/as/app/(with-base-layout)/design-cnstn/regist/page.tsx

@@ -0,0 +1,12 @@
+import { DesignRegistPage } from "@/pages/design-cnstn";
+import { parseTaskSeComCdFromApi } from "@/pages/design-cnstn/lib/design-cnstn-regist-schema";
+
+interface PageProps {
+  searchParams: Promise<{ taskSeComCd?: string }>;
+}
+
+export default async function Page({ searchParams }: PageProps) {
+  const params = await searchParams;
+  const taskSeComCd = parseTaskSeComCdFromApi(params.taskSeComCd);
+  return <DesignRegistPage taskSeComCd={taskSeComCd.length ? taskSeComCd : undefined} />;
+}

apps/as/package.json

@@ -32,7 +32,6 @@
     "next": "15.5.18",
     "react-hook-form": "^7.54.2",
     "tus-js-client": "^4.3.1",
-    "uuid": "^14.0.1",
     "zod": "^3.24.2"
   },
   "devDependencies": {

apps/as/src/entities/auth/api/auth-service.ts

@@ -1,8 +1,12 @@
 import { ACCESS_TOKEN, AUTH_USER_ID, CLAIM_NAME, ENDPOINT } from "@/shared/config";
-import { type AuthPayload, type AuthService, getRemainingMs } from "@common/auth";
+import {
+  type AuthPayload,
+  type AuthService,
+  clearDeviceId,
+  getOrCreateDeviceId,
+} from "@common/auth";
 
-import { clearDeviceId, getOrCreateDeviceId } from "../lib/device-id";
-import { clearRefreshTimer, setToken, setupRefreshTimer, tokenManager } from "../lib/token-manager";
+import { clearRefreshTimer, setToken, tokenManager } from "../lib/token-manager";
 
 async function login(payload: AuthPayload): Promise<void> {
   const response = await fetch(`/api/proxy${ENDPOINT.USER_SERVICE.LOGIN}`, {
@@ -26,10 +30,10 @@ async function login(payload: AuthPayload): Promise<void> {
   setToken(CLAIM_NAME, accessToken);
   setToken(AUTH_USER_ID, tokenId);
 
-  const remainingMs = getRemainingMs(accessToken);
-  if (remainingMs > 0) {
-    setupRefreshTimer(silentRefresh, remainingMs);
-  }
+  // const remainingMs = getRemainingMs(accessToken);
+  // if (remainingMs > 0) {
+  //   setupRefreshTimer(silentRefresh, remainingMs);
+  // }
 }
 
 async function silentRefresh(): Promise<void> {
@@ -58,10 +62,10 @@ async function silentRefresh(): Promise<void> {
     setToken(CLAIM_NAME, accessToken);
     setToken(AUTH_USER_ID, tokenId);
 
-    const remainingMs = getRemainingMs(accessToken);
-    if (remainingMs > 0) {
-      setupRefreshTimer(silentRefresh, remainingMs);
-    }
+    // const remainingMs = getRemainingMs(accessToken);
+    // if (remainingMs > 0) {
+    //   setupRefreshTimer(silentRefresh, remainingMs);
+    // }
   } catch (error) {
     console.error(`[silentRefresh] Failed at ${new Date().toISOString()}`, error);
     tokenManager.clearAuthToken();

apps/as/src/entities/auth/lib/device-id.ts

@@ -1,17 +0,0 @@
-import { v4 as uuidv4 } from "uuid";
-
-const DEVICE_ID_KEY = "x-device-id";
-
-export function getOrCreateDeviceId(): string {
-  if (typeof window === "undefined") return "";
-  const existing = localStorage.getItem(DEVICE_ID_KEY);
-  if (existing) return existing;
-  const id = uuidv4();
-  localStorage.setItem(DEVICE_ID_KEY, id);
-  return id;
-}
-
-export function clearDeviceId(): void {
-  if (typeof window === "undefined") return;
-  localStorage.removeItem(DEVICE_ID_KEY);
-}

apps/as/src/entities/code/ui/code-select.tsx

@@ -18,13 +18,7 @@ interface CodeSelectProps extends React.ComponentPropsWithoutRef<typeof Select>
   className?: string;
 }
 
-function CodeSelect({
-  upCd,
-  useYn,
-  placeholder = "선택",
-  className,
-  ...props
-}: CodeSelectProps) {
+function CodeSelect({ upCd, useYn, placeholder = "선택", className, ...props }: CodeSelectProps) {
   const listQuery = useCodeList(useYn ? undefined : upCd);
   const listByUseYnQuery = useCodeListByUseYn(useYn ? upCd : undefined, useYn ?? "");
 
@@ -34,7 +28,7 @@ function CodeSelect({
   return (
     <Select {...props} disabled={props.disabled || isLoading}>
       <SelectTrigger className={cn("w-[12rem]", className)}>
-        <SelectValue placeholder={isLoading ? "로딩 중…" : placeholder} />
+        <SelectValue placeholder={placeholder} />
       </SelectTrigger>
       <SelectContent>
         {codes?.map((item) => (

apps/as/src/entities/design-cnstn/api/design-cnstn-biz-cst-service.ts

@@ -0,0 +1,58 @@
+import { client } from "@/shared/api";
+import { ENDPOINT } from "@/shared/config";
+import type { PageResponse } from "@/shared/model";
+
+import type {
+  DesignCnstnBizCstId,
+  DesignCnstnBizCstResponseDto,
+  DesignCnstnBizCstSaveRequestDto,
+  DesignCnstnBizCstSearchDto,
+  DesignCnstnBizCstService,
+  DesignCnstnBizCstUpdateRequestDto,
+} from "../model/design-cnstn-biz-cst-interface";
+
+const BASE = ENDPOINT.AS_SERVICE.DESIGN_CNSTN_BIZ_CST;
+
+async function findPage(
+  searchDto: DesignCnstnBizCstSearchDto,
+): Promise<PageResponse<DesignCnstnBizCstResponseDto>> {
+  const response = await client.get<PageResponse<DesignCnstnBizCstResponseDto>>(BASE, {
+    params: searchDto,
+  });
+  return response.data;
+}
+
+async function findById(
+  designCnstnDocNo: string,
+  acntgSeCd: string,
+): Promise<DesignCnstnBizCstResponseDto> {
+  const response = await client.get<DesignCnstnBizCstResponseDto>(
+    `${BASE}/${designCnstnDocNo}/${acntgSeCd}`,
+  );
+  return response.data;
+}
+
+async function save(body: DesignCnstnBizCstSaveRequestDto): Promise<DesignCnstnBizCstId> {
+  const response = await client.post<DesignCnstnBizCstId>(BASE, body);
+  return response.data;
+}
+
+async function update(
+  designCnstnDocNo: string,
+  acntgSeCd: string,
+  body: DesignCnstnBizCstUpdateRequestDto,
+): Promise<void> {
+  await client.put<void>(`${BASE}/${designCnstnDocNo}/${acntgSeCd}`, body);
+}
+
+async function deleteDesignCnstnBizCst(designCnstnDocNo: string, acntgSeCd: string): Promise<void> {
+  await client.delete<void>(`${BASE}/${designCnstnDocNo}/${acntgSeCd}`);
+}
+
+export const designCnstnBizCstService = {
+  findPage,
+  findById,
+  save,
+  update,
+  delete: deleteDesignCnstnBizCst,
+} satisfies DesignCnstnBizCstService;

apps/as/src/entities/design-cnstn/api/design-cnstn-biz-scl-service.ts

@@ -0,0 +1,58 @@
+import { client } from "@/shared/api";
+import { ENDPOINT } from "@/shared/config";
+import type { PageResponse } from "@/shared/model";
+
+import type {
+  DesignCnstnBizSclId,
+  DesignCnstnBizSclResponseDto,
+  DesignCnstnBizSclSaveRequestDto,
+  DesignCnstnBizSclSearchDto,
+  DesignCnstnBizSclService,
+  DesignCnstnBizSclUpdateRequestDto,
+} from "../model/design-cnstn-biz-scl-interface";
+
+const BASE = ENDPOINT.AS_SERVICE.DESIGN_CNSTN_BIZ_SCL;
+
+async function findPage(
+  searchDto: DesignCnstnBizSclSearchDto,
+): Promise<PageResponse<DesignCnstnBizSclResponseDto>> {
+  const response = await client.get<PageResponse<DesignCnstnBizSclResponseDto>>(BASE, {
+    params: searchDto,
+  });
+  return response.data;
+}
+
+async function findById(
+  designCnstnDocNo: string,
+  cnstpSeCd: string,
+): Promise<DesignCnstnBizSclResponseDto> {
+  const response = await client.get<DesignCnstnBizSclResponseDto>(
+    `${BASE}/${designCnstnDocNo}/${cnstpSeCd}`,
+  );
+  return response.data;
+}
+
+async function save(body: DesignCnstnBizSclSaveRequestDto): Promise<DesignCnstnBizSclId> {
+  const response = await client.post<DesignCnstnBizSclId>(BASE, body);
+  return response.data;
+}
+
+async function update(
+  designCnstnDocNo: string,
+  cnstpSeCd: string,
+  body: DesignCnstnBizSclUpdateRequestDto,
+): Promise<void> {
+  await client.put<void>(`${BASE}/${designCnstnDocNo}/${cnstpSeCd}`, body);
+}
+
+async function deleteDesignCnstnBizScl(designCnstnDocNo: string, cnstpSeCd: string): Promise<void> {
+  await client.delete<void>(`${BASE}/${designCnstnDocNo}/${cnstpSeCd}`);
+}
+
+export const designCnstnBizSclService = {
+  findPage,
+  findById,
+  save,
+  update,
+  delete: deleteDesignCnstnBizScl,
+} satisfies DesignCnstnBizSclService;

apps/as/src/entities/design-cnstn/api/design-cnstn-esntl-atch-file-service.ts

@@ -0,0 +1,63 @@
+import { client } from "@/shared/api";
+import { ENDPOINT } from "@/shared/config";
+import type { PageResponse } from "@/shared/model";
+
+import type {
+  DesignCnstnEsntlAtchFileId,
+  DesignCnstnEsntlAtchFileResponseDto,
+  DesignCnstnEsntlAtchFileSaveRequestDto,
+  DesignCnstnEsntlAtchFileSearchDto,
+  DesignCnstnEsntlAtchFileService,
+  DesignCnstnEsntlAtchFileUpdateRequestDto,
+} from "../model/design-cnstn-esntl-atch-file-interface";
+
+const BASE = ENDPOINT.AS_SERVICE.DESIGN_CNSTN_ESNTL_ATCH_FILE;
+
+async function findPage(
+  searchDto: DesignCnstnEsntlAtchFileSearchDto,
+): Promise<PageResponse<DesignCnstnEsntlAtchFileResponseDto>> {
+  const response = await client.get<PageResponse<DesignCnstnEsntlAtchFileResponseDto>>(BASE, {
+    params: searchDto,
+  });
+  return response.data;
+}
+
+async function findById(
+  designCnstnDocNo: string,
+  esntlAtchFileId: string,
+): Promise<DesignCnstnEsntlAtchFileResponseDto> {
+  const response = await client.get<DesignCnstnEsntlAtchFileResponseDto>(
+    `${BASE}/${designCnstnDocNo}/${esntlAtchFileId}`,
+  );
+  return response.data;
+}
+
+async function save(
+  body: DesignCnstnEsntlAtchFileSaveRequestDto,
+): Promise<DesignCnstnEsntlAtchFileId> {
+  const response = await client.post<DesignCnstnEsntlAtchFileId>(BASE, body);
+  return response.data;
+}
+
+async function update(
+  designCnstnDocNo: string,
+  esntlAtchFileId: string,
+  body: DesignCnstnEsntlAtchFileUpdateRequestDto,
+): Promise<void> {
+  await client.put<void>(`${BASE}/${designCnstnDocNo}/${esntlAtchFileId}`, body);
+}
+
+async function deleteDesignCnstnEsntlAtchFile(
+  designCnstnDocNo: string,
+  esntlAtchFileId: string,
+): Promise<void> {
+  await client.delete<void>(`${BASE}/${designCnstnDocNo}/${esntlAtchFileId}`);
+}
+
+export const designCnstnEsntlAtchFileService = {
+  findPage,
+  findById,
+  save,
+  update,
+  delete: deleteDesignCnstnEsntlAtchFile,
+} satisfies DesignCnstnEsntlAtchFileService;

apps/as/src/entities/design-cnstn/api/design-cnstn-mng-service.ts

@@ -0,0 +1,61 @@
+import { client } from "@/shared/api";
+import { ENDPOINT } from "@/shared/config";
+import type { PageResponse } from "@/shared/model";
+
+import type {
+  DesignCnstnApplySaveRequestDto,
+  DesignCnstnMngDetResponseDto,
+  DesignCnstnMngResponseDto,
+  DesignCnstnMngSaveRequestDto,
+  DesignCnstnMngSearchDto,
+  DesignCnstnMngService,
+  DesignCnstnMngUpdateRequestDto,
+} from "../model/design-cnstn-mng-interface";
+
+const BASE = ENDPOINT.AS_SERVICE.DESIGN_CNSTN;
+
+async function findPage(
+  searchDto: DesignCnstnMngSearchDto,
+): Promise<PageResponse<DesignCnstnMngResponseDto>> {
+  const response = await client.get<PageResponse<DesignCnstnMngResponseDto>>(BASE, {
+    params: searchDto,
+  });
+  return response.data;
+}
+
+async function findById(id: string): Promise<DesignCnstnMngDetResponseDto> {
+  const response = await client.get<DesignCnstnMngDetResponseDto>(`${BASE}/${id}`);
+  return response.data;
+}
+
+async function save(body: DesignCnstnMngSaveRequestDto): Promise<string> {
+  const response = await client.post<string>(BASE, body);
+  return response.data;
+}
+
+async function saveApply(body: DesignCnstnApplySaveRequestDto): Promise<string> {
+  const response = await client.post<string>(`${BASE}/save-apply`, body);
+  return response.data;
+}
+
+async function update(id: string, body: DesignCnstnMngUpdateRequestDto): Promise<void> {
+  await client.put<void>(`${BASE}/${id}`, body);
+}
+
+async function techReview(id: string, body: DesignCnstnApplySaveRequestDto): Promise<void> {
+  await client.post<void>(`${BASE}/${id}/tech-review`, body);
+}
+
+async function deleteDesignCnstnMng(id: string): Promise<void> {
+  await client.delete<void>(`${BASE}/${id}`);
+}
+
+export const designCnstnMngService = {
+  findPage,
+  findById,
+  save,
+  saveApply,
+  update,
+  techReview,
+  delete: deleteDesignCnstnMng,
+} satisfies DesignCnstnMngService;

apps/as/src/entities/design-cnstn/api/design-cnstn-rvw-opnn-service.ts

@@ -0,0 +1,61 @@
+import { client } from "@/shared/api";
+import { ENDPOINT } from "@/shared/config";
+import type { PageResponse } from "@/shared/model";
+
+import type {
+  DesignCnstnRvwOpnnId,
+  DesignCnstnRvwOpnnResponseDto,
+  DesignCnstnRvwOpnnSaveRequestDto,
+  DesignCnstnRvwOpnnSearchDto,
+  DesignCnstnRvwOpnnService,
+  DesignCnstnRvwOpnnUpdateRequestDto,
+} from "../model/design-cnstn-rvw-opnn-interface";
+
+const BASE = ENDPOINT.AS_SERVICE.DESIGN_CNSTN_RVW_OPNN;
+
+async function findPage(
+  searchDto: DesignCnstnRvwOpnnSearchDto,
+): Promise<PageResponse<DesignCnstnRvwOpnnResponseDto>> {
+  const response = await client.get<PageResponse<DesignCnstnRvwOpnnResponseDto>>(BASE, {
+    params: searchDto,
+  });
+  return response.data;
+}
+
+async function findById(
+  designCnstnDocNo: string,
+  rvwOpnnSn: number,
+): Promise<DesignCnstnRvwOpnnResponseDto> {
+  const response = await client.get<DesignCnstnRvwOpnnResponseDto>(
+    `${BASE}/${designCnstnDocNo}/${rvwOpnnSn}`,
+  );
+  return response.data;
+}
+
+async function save(body: DesignCnstnRvwOpnnSaveRequestDto): Promise<DesignCnstnRvwOpnnId> {
+  const response = await client.post<DesignCnstnRvwOpnnId>(BASE, body);
+  return response.data;
+}
+
+async function update(
+  designCnstnDocNo: string,
+  rvwOpnnSn: number,
+  body: DesignCnstnRvwOpnnUpdateRequestDto,
+): Promise<void> {
+  await client.put<void>(`${BASE}/${designCnstnDocNo}/${rvwOpnnSn}`, body);
+}
+
+async function deleteDesignCnstnRvwOpnn(
+  designCnstnDocNo: string,
+  rvwOpnnSn: number,
+): Promise<void> {
+  await client.delete<void>(`${BASE}/${designCnstnDocNo}/${rvwOpnnSn}`);
+}
+
+export const designCnstnRvwOpnnService = {
+  findPage,
+  findById,
+  save,
+  update,
+  delete: deleteDesignCnstnRvwOpnn,
+} satisfies DesignCnstnRvwOpnnService;

apps/as/src/entities/design-cnstn/api/queries.ts

@@ -0,0 +1,411 @@
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+
+import { ENDPOINT } from "@/shared/config";
+
+import type {
+  DesignCnstnBizCstSaveRequestDto,
+  DesignCnstnBizCstSearchDto,
+  DesignCnstnBizCstUpdateRequestDto,
+} from "../model/design-cnstn-biz-cst-interface";
+import type {
+  DesignCnstnBizSclSaveRequestDto,
+  DesignCnstnBizSclSearchDto,
+  DesignCnstnBizSclUpdateRequestDto,
+} from "../model/design-cnstn-biz-scl-interface";
+import type {
+  DesignCnstnEsntlAtchFileSaveRequestDto,
+  DesignCnstnEsntlAtchFileSearchDto,
+  DesignCnstnEsntlAtchFileUpdateRequestDto,
+} from "../model/design-cnstn-esntl-atch-file-interface";
+import type {
+  DesignCnstnApplySaveRequestDto,
+  DesignCnstnMngSaveRequestDto,
+  DesignCnstnMngSearchDto,
+  DesignCnstnMngUpdateRequestDto,
+} from "../model/design-cnstn-mng-interface";
+import type {
+  DesignCnstnRvwOpnnSaveRequestDto,
+  DesignCnstnRvwOpnnSearchDto,
+  DesignCnstnRvwOpnnUpdateRequestDto,
+} from "../model/design-cnstn-rvw-opnn-interface";
+
+import { designCnstnBizCstService } from "./design-cnstn-biz-cst-service";
+import { designCnstnBizSclService } from "./design-cnstn-biz-scl-service";
+import { designCnstnEsntlAtchFileService } from "./design-cnstn-esntl-atch-file-service";
+import { designCnstnMngService } from "./design-cnstn-mng-service";
+import { designCnstnRvwOpnnService } from "./design-cnstn-rvw-opnn-service";
+
+export const designCnstnMngBaseKey = [ENDPOINT.AS_SERVICE.DESIGN_CNSTN] as const;
+export const designCnstnBizCstBaseKey = [ENDPOINT.AS_SERVICE.DESIGN_CNSTN_BIZ_CST] as const;
+export const designCnstnBizSclBaseKey = [ENDPOINT.AS_SERVICE.DESIGN_CNSTN_BIZ_SCL] as const;
+export const designCnstnEsntlAtchFileBaseKey = [
+  ENDPOINT.AS_SERVICE.DESIGN_CNSTN_ESNTL_ATCH_FILE,
+] as const;
+export const designCnstnRvwOpnnBaseKey = [ENDPOINT.AS_SERVICE.DESIGN_CNSTN_RVW_OPNN] as const;
+
+/* ─── DesignCnstnMng ─── */
+
+export function useDesignCnstnMngPage(params: DesignCnstnMngSearchDto) {
+  return useQuery({
+    queryKey: [...designCnstnMngBaseKey, "findPage", params],
+    queryFn: () => designCnstnMngService.findPage(params),
+  });
+}
+
+export function useDesignCnstnMng(id: string | null | undefined) {
+  return useQuery({
+    queryKey: [...designCnstnMngBaseKey, "findById", id],
+    queryFn: () => designCnstnMngService.findById(id!),
+    enabled: Boolean(id),
+  });
+}
+
+export function useSaveDesignCnstnMng() {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: (body: DesignCnstnMngSaveRequestDto) => designCnstnMngService.save(body),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: designCnstnMngBaseKey });
+    },
+  });
+}
+
+export function useSaveApplyDesignCnstnMng() {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: (body: DesignCnstnApplySaveRequestDto) => designCnstnMngService.saveApply(body),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: designCnstnMngBaseKey });
+    },
+  });
+}
+
+export function useUpdateDesignCnstnMng() {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: ({ id, body }: { id: string; body: DesignCnstnMngUpdateRequestDto }) =>
+      designCnstnMngService.update(id, body),
+    onSuccess: (_data, { id }) => {
+      queryClient.invalidateQueries({ queryKey: designCnstnMngBaseKey });
+      queryClient.invalidateQueries({
+        queryKey: [...designCnstnMngBaseKey, "findById", id],
+      });
+    },
+  });
+}
+
+export function useTechReviewDesignCnstnMng() {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: ({ id, body }: { id: string; body: DesignCnstnApplySaveRequestDto }) =>
+      designCnstnMngService.techReview(id, body),
+    onSuccess: (_data, { id }) => {
+      queryClient.invalidateQueries({ queryKey: designCnstnMngBaseKey });
+      queryClient.invalidateQueries({
+        queryKey: [...designCnstnMngBaseKey, "findById", id],
+      });
+    },
+  });
+}
+
+export function useDeleteDesignCnstnMng() {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: (id: string) => designCnstnMngService.delete(id),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: designCnstnMngBaseKey });
+    },
+  });
+}
+
+/* ─── DesignCnstnBizCst ─── */
+
+export function useDesignCnstnBizCstPage(params: DesignCnstnBizCstSearchDto) {
+  return useQuery({
+    queryKey: [...designCnstnBizCstBaseKey, "findPage", params],
+    queryFn: () => designCnstnBizCstService.findPage(params),
+  });
+}
+
+export function useDesignCnstnBizCst(
+  designCnstnDocNo: string | null | undefined,
+  acntgSeCd: string | null | undefined,
+) {
+  return useQuery({
+    queryKey: [...designCnstnBizCstBaseKey, "findById", designCnstnDocNo, acntgSeCd],
+    queryFn: () => designCnstnBizCstService.findById(designCnstnDocNo!, acntgSeCd!),
+    enabled: Boolean(designCnstnDocNo && acntgSeCd),
+  });
+}
+
+export function useSaveDesignCnstnBizCst() {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: (body: DesignCnstnBizCstSaveRequestDto) => designCnstnBizCstService.save(body),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: designCnstnBizCstBaseKey });
+      queryClient.invalidateQueries({ queryKey: designCnstnMngBaseKey });
+    },
+  });
+}
+
+export function useUpdateDesignCnstnBizCst() {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: ({
+      designCnstnDocNo,
+      acntgSeCd,
+      body,
+    }: {
+      designCnstnDocNo: string;
+      acntgSeCd: string;
+      body: DesignCnstnBizCstUpdateRequestDto;
+    }) => designCnstnBizCstService.update(designCnstnDocNo, acntgSeCd, body),
+    onSuccess: (_data, { designCnstnDocNo, acntgSeCd }) => {
+      queryClient.invalidateQueries({ queryKey: designCnstnBizCstBaseKey });
+      queryClient.invalidateQueries({
+        queryKey: [...designCnstnBizCstBaseKey, "findById", designCnstnDocNo, acntgSeCd],
+      });
+      queryClient.invalidateQueries({ queryKey: designCnstnMngBaseKey });
+    },
+  });
+}
+
+export function useDeleteDesignCnstnBizCst() {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: ({
+      designCnstnDocNo,
+      acntgSeCd,
+    }: {
+      designCnstnDocNo: string;
+      acntgSeCd: string;
+    }) => designCnstnBizCstService.delete(designCnstnDocNo, acntgSeCd),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: designCnstnBizCstBaseKey });
+      queryClient.invalidateQueries({ queryKey: designCnstnMngBaseKey });
+    },
+  });
+}
+
+/* ─── DesignCnstnBizScl ─── */
+
+export function useDesignCnstnBizSclPage(params: DesignCnstnBizSclSearchDto) {
+  return useQuery({
+    queryKey: [...designCnstnBizSclBaseKey, "findPage", params],
+    queryFn: () => designCnstnBizSclService.findPage(params),
+  });
+}
+
+export function useDesignCnstnBizScl(
+  designCnstnDocNo: string | null | undefined,
+  cnstpSeCd: string | null | undefined,
+) {
+  return useQuery({
+    queryKey: [...designCnstnBizSclBaseKey, "findById", designCnstnDocNo, cnstpSeCd],
+    queryFn: () => designCnstnBizSclService.findById(designCnstnDocNo!, cnstpSeCd!),
+    enabled: Boolean(designCnstnDocNo && cnstpSeCd),
+  });
+}
+
+export function useSaveDesignCnstnBizScl() {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: (body: DesignCnstnBizSclSaveRequestDto) => designCnstnBizSclService.save(body),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: designCnstnBizSclBaseKey });
+      queryClient.invalidateQueries({ queryKey: designCnstnMngBaseKey });
+    },
+  });
+}
+
+export function useUpdateDesignCnstnBizScl() {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: ({
+      designCnstnDocNo,
+      cnstpSeCd,
+      body,
+    }: {
+      designCnstnDocNo: string;
+      cnstpSeCd: string;
+      body: DesignCnstnBizSclUpdateRequestDto;
+    }) => designCnstnBizSclService.update(designCnstnDocNo, cnstpSeCd, body),
+    onSuccess: (_data, { designCnstnDocNo, cnstpSeCd }) => {
+      queryClient.invalidateQueries({ queryKey: designCnstnBizSclBaseKey });
+      queryClient.invalidateQueries({
+        queryKey: [...designCnstnBizSclBaseKey, "findById", designCnstnDocNo, cnstpSeCd],
+      });
+      queryClient.invalidateQueries({ queryKey: designCnstnMngBaseKey });
+    },
+  });
+}
+
+export function useDeleteDesignCnstnBizScl() {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: ({
+      designCnstnDocNo,
+      cnstpSeCd,
+    }: {
+      designCnstnDocNo: string;
+      cnstpSeCd: string;
+    }) => designCnstnBizSclService.delete(designCnstnDocNo, cnstpSeCd),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: designCnstnBizSclBaseKey });
+      queryClient.invalidateQueries({ queryKey: designCnstnMngBaseKey });
+    },
+  });
+}
+
+/* ─── DesignCnstnEsntlAtchFile ─── */
+
+export function useDesignCnstnEsntlAtchFilePage(params: DesignCnstnEsntlAtchFileSearchDto) {
+  return useQuery({
+    queryKey: [...designCnstnEsntlAtchFileBaseKey, "findPage", params],
+    queryFn: () => designCnstnEsntlAtchFileService.findPage(params),
+  });
+}
+
+export function useDesignCnstnEsntlAtchFile(
+  designCnstnDocNo: string | null | undefined,
+  esntlAtchFileId: string | null | undefined,
+) {
+  return useQuery({
+    queryKey: [
+      ...designCnstnEsntlAtchFileBaseKey,
+      "findById",
+      designCnstnDocNo,
+      esntlAtchFileId,
+    ],
+    queryFn: () =>
+      designCnstnEsntlAtchFileService.findById(designCnstnDocNo!, esntlAtchFileId!),
+    enabled: Boolean(designCnstnDocNo && esntlAtchFileId),
+  });
+}
+
+export function useSaveDesignCnstnEsntlAtchFile() {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: (body: DesignCnstnEsntlAtchFileSaveRequestDto) =>
+      designCnstnEsntlAtchFileService.save(body),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: designCnstnEsntlAtchFileBaseKey });
+      queryClient.invalidateQueries({ queryKey: designCnstnMngBaseKey });
+    },
+  });
+}
+
+export function useUpdateDesignCnstnEsntlAtchFile() {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: ({
+      designCnstnDocNo,
+      esntlAtchFileId,
+      body,
+    }: {
+      designCnstnDocNo: string;
+      esntlAtchFileId: string;
+      body: DesignCnstnEsntlAtchFileUpdateRequestDto;
+    }) => designCnstnEsntlAtchFileService.update(designCnstnDocNo, esntlAtchFileId, body),
+    onSuccess: (_data, { designCnstnDocNo, esntlAtchFileId }) => {
+      queryClient.invalidateQueries({ queryKey: designCnstnEsntlAtchFileBaseKey });
+      queryClient.invalidateQueries({
+        queryKey: [
+          ...designCnstnEsntlAtchFileBaseKey,
+          "findById",
+          designCnstnDocNo,
+          esntlAtchFileId,
+        ],
+      });
+      queryClient.invalidateQueries({ queryKey: designCnstnMngBaseKey });
+    },
+  });
+}
+
+export function useDeleteDesignCnstnEsntlAtchFile() {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: ({
+      designCnstnDocNo,
+      esntlAtchFileId,
+    }: {
+      designCnstnDocNo: string;
+      esntlAtchFileId: string;
+    }) => designCnstnEsntlAtchFileService.delete(designCnstnDocNo, esntlAtchFileId),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: designCnstnEsntlAtchFileBaseKey });
+      queryClient.invalidateQueries({ queryKey: designCnstnMngBaseKey });
+    },
+  });
+}
+
+/* ─── DesignCnstnRvwOpnn ─── */
+
+export function useDesignCnstnRvwOpnnPage(params: DesignCnstnRvwOpnnSearchDto) {
+  return useQuery({
+    queryKey: [...designCnstnRvwOpnnBaseKey, "findPage", params],
+    queryFn: () => designCnstnRvwOpnnService.findPage(params),
+  });
+}
+
+export function useDesignCnstnRvwOpnn(
+  designCnstnDocNo: string | null | undefined,
+  rvwOpnnSn: number | null | undefined,
+) {
+  return useQuery({
+    queryKey: [...designCnstnRvwOpnnBaseKey, "findById", designCnstnDocNo, rvwOpnnSn],
+    queryFn: () => designCnstnRvwOpnnService.findById(designCnstnDocNo!, rvwOpnnSn!),
+    enabled: Boolean(designCnstnDocNo && rvwOpnnSn != null),
+  });
+}
+
+export function useSaveDesignCnstnRvwOpnn() {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: (body: DesignCnstnRvwOpnnSaveRequestDto) => designCnstnRvwOpnnService.save(body),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: designCnstnRvwOpnnBaseKey });
+      queryClient.invalidateQueries({ queryKey: designCnstnMngBaseKey });
+    },
+  });
+}
+
+export function useUpdateDesignCnstnRvwOpnn() {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: ({
+      designCnstnDocNo,
+      rvwOpnnSn,
+      body,
+    }: {
+      designCnstnDocNo: string;
+      rvwOpnnSn: number;
+      body: DesignCnstnRvwOpnnUpdateRequestDto;
+    }) => designCnstnRvwOpnnService.update(designCnstnDocNo, rvwOpnnSn, body),
+    onSuccess: (_data, { designCnstnDocNo, rvwOpnnSn }) => {
+      queryClient.invalidateQueries({ queryKey: designCnstnRvwOpnnBaseKey });
+      queryClient.invalidateQueries({
+        queryKey: [...designCnstnRvwOpnnBaseKey, "findById", designCnstnDocNo, rvwOpnnSn],
+      });
+      queryClient.invalidateQueries({ queryKey: designCnstnMngBaseKey });
+    },
+  });
+}
+
+export function useDeleteDesignCnstnRvwOpnn() {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: ({
+      designCnstnDocNo,
+      rvwOpnnSn,
+    }: {
+      designCnstnDocNo: string;
+      rvwOpnnSn: number;
+    }) => designCnstnRvwOpnnService.delete(designCnstnDocNo, rvwOpnnSn),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: designCnstnRvwOpnnBaseKey });
+      queryClient.invalidateQueries({ queryKey: designCnstnMngBaseKey });
+    },
+  });
+}

apps/as/src/entities/design-cnstn/index.ts

@@ -0,0 +1,88 @@
+export { designCnstnBizCstService } from "./api/design-cnstn-biz-cst-service";
+export { designCnstnBizSclService } from "./api/design-cnstn-biz-scl-service";
+export { designCnstnEsntlAtchFileService } from "./api/design-cnstn-esntl-atch-file-service";
+export { designCnstnMngService } from "./api/design-cnstn-mng-service";
+export { designCnstnRvwOpnnService } from "./api/design-cnstn-rvw-opnn-service";
+export {
+  designCnstnBizCstBaseKey,
+  designCnstnBizSclBaseKey,
+  designCnstnEsntlAtchFileBaseKey,
+  designCnstnMngBaseKey,
+  designCnstnRvwOpnnBaseKey,
+  useDeleteDesignCnstnBizCst,
+  useDeleteDesignCnstnBizScl,
+  useDeleteDesignCnstnEsntlAtchFile,
+  useDeleteDesignCnstnMng,
+  useDeleteDesignCnstnRvwOpnn,
+  useDesignCnstnBizCst,
+  useDesignCnstnBizCstPage,
+  useDesignCnstnBizScl,
+  useDesignCnstnBizSclPage,
+  useDesignCnstnEsntlAtchFile,
+  useDesignCnstnEsntlAtchFilePage,
+  useDesignCnstnMng,
+  useDesignCnstnMngPage,
+  useDesignCnstnRvwOpnn,
+  useDesignCnstnRvwOpnnPage,
+  useSaveApplyDesignCnstnMng,
+  useSaveDesignCnstnBizCst,
+  useSaveDesignCnstnBizScl,
+  useSaveDesignCnstnEsntlAtchFile,
+  useSaveDesignCnstnMng,
+  useSaveDesignCnstnRvwOpnn,
+  useTechReviewDesignCnstnMng,
+  useUpdateDesignCnstnBizCst,
+  useUpdateDesignCnstnBizScl,
+  useUpdateDesignCnstnEsntlAtchFile,
+  useUpdateDesignCnstnMng,
+  useUpdateDesignCnstnRvwOpnn,
+} from "./api/queries";
+export type {
+  DesignCnstnBizCstId,
+  DesignCnstnBizCstResponseDto,
+  DesignCnstnBizCstSaveRequestDto,
+  DesignCnstnBizCstSearchDto,
+  DesignCnstnBizCstService,
+  DesignCnstnBizCstUpdateRequestDto,
+} from "./model/design-cnstn-biz-cst-interface";
+export type {
+  DesignCnstnBizSclId,
+  DesignCnstnBizSclResponseDto,
+  DesignCnstnBizSclSaveRequestDto,
+  DesignCnstnBizSclSearchDto,
+  DesignCnstnBizSclService,
+  DesignCnstnBizSclUpdateRequestDto,
+} from "./model/design-cnstn-biz-scl-interface";
+export type {
+  DesignCnstnEsntlAtchFileId,
+  DesignCnstnEsntlAtchFileResponseDto,
+  DesignCnstnEsntlAtchFileSaveRequestDto,
+  DesignCnstnEsntlAtchFileSearchDto,
+  DesignCnstnEsntlAtchFileService,
+  DesignCnstnEsntlAtchFileUpdateRequestDto,
+} from "./model/design-cnstn-esntl-atch-file-interface";
+export type {
+  AtflMngClientResponseDto,
+  BizCstItem,
+  BizCstTreeDto,
+  BizSclTreeDto,
+  BzScaleItem,
+  DesignCnstnApplySaveRequestDto,
+  DesignCnstnMngDetResponseDto,
+  DesignCnstnMngResponseDto,
+  DesignCnstnMngSaveRequestDto,
+  DesignCnstnMngSearchDto,
+  DesignCnstnMngService,
+  DesignCnstnMngUpdateRequestDto,
+  DesignCnstnRvwOpnnResponseDto,
+  DesignCnstnRvwOpnnSaveRequestDto,
+  ElaprDocPrgrsClientResponseDto,
+  EsntlAtchFileItem,
+  EsntlAtchFileMngTreeResponseDto,
+} from "./model/design-cnstn-mng-interface";
+export type {
+  DesignCnstnRvwOpnnId,
+  DesignCnstnRvwOpnnSearchDto,
+  DesignCnstnRvwOpnnService,
+  DesignCnstnRvwOpnnUpdateRequestDto,
+} from "./model/design-cnstn-rvw-opnn-interface";

apps/as/src/entities/design-cnstn/model/design-cnstn-biz-cst-interface.ts

@@ -0,0 +1,54 @@
+import type { PageableParams, PageResponse } from "@/shared/model";
+
+/** 백엔드 DesignCnstnBizCstId */
+export interface DesignCnstnBizCstId {
+  designCnstnMng: string;
+  acntgSeCd: string;
+}
+
+/** 백엔드 DesignCnstnBizCstSaveRequestDto */
+export interface DesignCnstnBizCstSaveRequestDto {
+  designCnstnDocNo: string;
+  acntgSeCd: string;
+  bscPlanAmt?: number;
+  bgtRfltAmt?: number;
+  tstmDesignAmt?: number;
+}
+
+/** 백엔드 DesignCnstnBizCstUpdateRequestDto */
+export interface DesignCnstnBizCstUpdateRequestDto {
+  bscPlanAmt?: number;
+  bgtRfltAmt?: number;
+  tstmDesignAmt?: number;
+}
+
+/** 백엔드 DesignCnstnBizCstSearchDto + Pageable */
+export interface DesignCnstnBizCstSearchDto extends PageableParams {
+  designCnstnDocNo?: string;
+  acntgSeCd?: string;
+}
+
+/** 백엔드 DesignCnstnBizCstResponseDto */
+export interface DesignCnstnBizCstResponseDto {
+  designCnstnDocNo: string;
+  acntgSeCd: string;
+  bscPlanAmt?: number;
+  bgtRfltAmt?: number;
+  tstmDesignAmt?: number;
+  regDt?: string;
+}
+
+/** Controller public 메서드명·시그니처와 동일 */
+export interface DesignCnstnBizCstService {
+  findPage(
+    searchDto: DesignCnstnBizCstSearchDto,
+  ): Promise<PageResponse<DesignCnstnBizCstResponseDto>>;
+  findById(designCnstnDocNo: string, acntgSeCd: string): Promise<DesignCnstnBizCstResponseDto>;
+  save(body: DesignCnstnBizCstSaveRequestDto): Promise<DesignCnstnBizCstId>;
+  update(
+    designCnstnDocNo: string,
+    acntgSeCd: string,
+    body: DesignCnstnBizCstUpdateRequestDto,
+  ): Promise<void>;
+  delete(designCnstnDocNo: string, acntgSeCd: string): Promise<void>;
+}

apps/as/src/entities/design-cnstn/model/design-cnstn-biz-scl-interface.ts

@@ -0,0 +1,54 @@
+import type { PageableParams, PageResponse } from "@/shared/model";
+
+/** 백엔드 DesignCnstnBizSclId */
+export interface DesignCnstnBizSclId {
+  designCnstnMng: string;
+  cnstpSeCd: string;
+}
+
+/** 백엔드 DesignCnstnBizSclSaveRequestDto */
+export interface DesignCnstnBizSclSaveRequestDto {
+  designCnstnDocNo: string;
+  cnstpSeCd: string;
+  bscPlanQty?: number;
+  bgtRfltQty?: number;
+  tstmDesignQty?: number;
+}
+
+/** 백엔드 DesignCnstnBizSclUpdateRequestDto */
+export interface DesignCnstnBizSclUpdateRequestDto {
+  bscPlanQty?: number;
+  bgtRfltQty?: number;
+  tstmDesignQty?: number;
+}
+
+/** 백엔드 DesignCnstnBizSclSearchDto + Pageable */
+export interface DesignCnstnBizSclSearchDto extends PageableParams {
+  designCnstnDocNo?: string;
+  cnstpSeCd?: string;
+}
+
+/** 백엔드 DesignCnstnBizSclResponseDto */
+export interface DesignCnstnBizSclResponseDto {
+  designCnstnDocNo: string;
+  cnstpSeCd: string;
+  bscPlanQty?: number;
+  bgtRfltQty?: number;
+  tstmDesignQty?: number;
+  regDt?: string;
+}
+
+/** Controller public 메서드명·시그니처와 동일 */
+export interface DesignCnstnBizSclService {
+  findPage(
+    searchDto: DesignCnstnBizSclSearchDto,
+  ): Promise<PageResponse<DesignCnstnBizSclResponseDto>>;
+  findById(designCnstnDocNo: string, cnstpSeCd: string): Promise<DesignCnstnBizSclResponseDto>;
+  save(body: DesignCnstnBizSclSaveRequestDto): Promise<DesignCnstnBizSclId>;
+  update(
+    designCnstnDocNo: string,
+    cnstpSeCd: string,
+    body: DesignCnstnBizSclUpdateRequestDto,
+  ): Promise<void>;
+  delete(designCnstnDocNo: string, cnstpSeCd: string): Promise<void>;
+}

apps/as/src/entities/design-cnstn/model/design-cnstn-esntl-atch-file-interface.ts

@@ -0,0 +1,51 @@
+import type { PageableParams, PageResponse } from "@/shared/model";
+
+/** 백엔드 DesignCnstnEsntlAtchFileId */
+export interface DesignCnstnEsntlAtchFileId {
+  designCnstnMng: string;
+  esntlAtchFileId: string;
+}
+
+/** 백엔드 DesignCnstnEsntlAtchFileSaveRequestDto */
+export interface DesignCnstnEsntlAtchFileSaveRequestDto {
+  designCnstnDocNo: string;
+  esntlAtchFileId: string;
+  atchFileGroupId?: string;
+}
+
+/** 백엔드 DesignCnstnEsntlAtchFileUpdateRequestDto */
+export interface DesignCnstnEsntlAtchFileUpdateRequestDto {
+  atchFileGroupId?: string;
+}
+
+/** 백엔드 DesignCnstnEsntlAtchFileSearchDto + Pageable */
+export interface DesignCnstnEsntlAtchFileSearchDto extends PageableParams {
+  designCnstnDocNo?: string;
+  esntlAtchFileId?: string;
+}
+
+/** 백엔드 DesignCnstnEsntlAtchFileResponseDto */
+export interface DesignCnstnEsntlAtchFileResponseDto {
+  designCnstnDocNo: string;
+  esntlAtchFileId: string;
+  atchFileGroupId?: string;
+  regDt?: string;
+}
+
+/** Controller public 메서드명·시그니처와 동일 */
+export interface DesignCnstnEsntlAtchFileService {
+  findPage(
+    searchDto: DesignCnstnEsntlAtchFileSearchDto,
+  ): Promise<PageResponse<DesignCnstnEsntlAtchFileResponseDto>>;
+  findById(
+    designCnstnDocNo: string,
+    esntlAtchFileId: string,
+  ): Promise<DesignCnstnEsntlAtchFileResponseDto>;
+  save(body: DesignCnstnEsntlAtchFileSaveRequestDto): Promise<DesignCnstnEsntlAtchFileId>;
+  update(
+    designCnstnDocNo: string,
+    esntlAtchFileId: string,
+    body: DesignCnstnEsntlAtchFileUpdateRequestDto,
+  ): Promise<void>;
+  delete(designCnstnDocNo: string, esntlAtchFileId: string): Promise<void>;
+}

apps/as/src/entities/design-cnstn/model/design-cnstn-mng-interface.ts

@@ -0,0 +1,124 @@
+import type {
+  BizCstSaveBase,
+  BzScaleSaveBase,
+  EsntlAtchFileSaveBase,
+  PageableParams,
+  PageResponse,
+  PbadmsApplySaveHeader,
+  PbadmsMngDetResponseBase,
+} from "@/shared/model";
+
+import type {
+  DesignCnstnRvwOpnnResponseDto,
+  DesignCnstnRvwOpnnSaveRequestDto,
+} from "./design-cnstn-rvw-opnn-interface";
+
+export type {
+  DesignCnstnRvwOpnnResponseDto,
+  DesignCnstnRvwOpnnSaveRequestDto,
+} from "./design-cnstn-rvw-opnn-interface";
+export type {
+  AtflMngClientResponseDto,
+  BizCstTreeDto,
+  BizSclTreeDto,
+  ElaprDocPrgrsClientResponseDto,
+  EsntlAtchFileMngTreeResponseDto,
+} from "@/shared/model";
+
+/** 백엔드 DesignCnstnMngSaveRequestDto */
+export interface DesignCnstnMngSaveRequestDto {
+  designCnstnDocNo?: string;
+  admdstCd?: string;
+  envoSeComCd?: string;
+  taskSeComCd?: string;
+  bizNm?: string;
+  bizBgngYr?: string;
+  bizEndYr?: string;
+  bizCn?: string;
+  aplcntNm?: string;
+  aplcntMblTelno?: string;
+  aplcntOgdpNm?: string;
+  aplcntEmlAddr?: string;
+  dsgnrNm?: string;
+  dsgnrTelno?: string;
+  dsgnrOgdpNm?: string;
+  dsgnrEmlAddr?: string;
+  atchFileGroupId?: string;
+  prgrsSttsComCd?: string;
+}
+
+/** 백엔드 DesignCnstnMngUpdateRequestDto */
+export type DesignCnstnMngUpdateRequestDto = Omit<DesignCnstnMngSaveRequestDto, "designCnstnDocNo">;
+
+/** 백엔드 DesignCnstnMngSearchDto + Pageable */
+export interface DesignCnstnMngSearchDto extends PageableParams {
+  designCnstnDocNo?: string;
+  admdstCd?: string;
+  envoSeComCd?: string;
+  taskSeComCd?: string;
+  bizNm?: string;
+  bizBgngYr?: string;
+  bizEndYr?: string;
+  bizCn?: string;
+  aplcntNm?: string;
+  aplcntMblTelno?: string;
+  aplcntOgdpNm?: string;
+  aplcntEmlAddr?: string;
+  dsgnrNm?: string;
+  dsgnrTelno?: string;
+  dsgnrOgdpNm?: string;
+  dsgnrEmlAddr?: string;
+  atchFileGroupId?: string;
+}
+
+interface DesignCnstnMngResponseExtension {
+  designCnstnDocNo: string;
+  envoSeCdNm?: string;
+  taskSeCdNm?: string;
+  prgrsSttsCdNm?: string;
+  regDt?: string;
+  rgtr?: string;
+  rgtrNm?: string;
+  mdfcnDt?: string;
+  sido?: string;
+  gugun?: string;
+}
+
+/** 백엔드 DesignCnstnMngResponseDto */
+export type DesignCnstnMngResponseDto = Omit<DesignCnstnMngSaveRequestDto, "designCnstnDocNo"> &
+  DesignCnstnMngResponseExtension;
+
+/** 백엔드 DesignCnstnApplySaveRequestDto.BzScaleItem */
+export type BzScaleItem = BzScaleSaveBase;
+
+/** 백엔드 DesignCnstnApplySaveRequestDto.BizCstItem */
+export type BizCstItem = BizCstSaveBase;
+
+/** 백엔드 DesignCnstnApplySaveRequestDto.EsntlAtchFileItem */
+export type EsntlAtchFileItem = EsntlAtchFileSaveBase;
+
+/** 백엔드 DesignCnstnMngDetResponseDto */
+export type DesignCnstnMngDetResponseDto = PbadmsMngDetResponseBase<
+  DesignCnstnMngResponseDto,
+  DesignCnstnRvwOpnnResponseDto
+>;
+
+/** 백엔드 DesignCnstnApplySaveRequestDto */
+export interface DesignCnstnApplySaveRequestDto extends PbadmsApplySaveHeader {
+  designCnstnMng: DesignCnstnMngSaveRequestDto;
+  bzScaleList?: BzScaleItem[];
+  bizCstList?: BizCstItem[];
+  esntlAtchFileList?: EsntlAtchFileItem[];
+  rvwOpnnList?: DesignCnstnRvwOpnnSaveRequestDto[];
+}
+
+/** Controller public 메서드명·시그니처와 동일 */
+export interface DesignCnstnMngService {
+  findPage(searchDto: DesignCnstnMngSearchDto): Promise<PageResponse<DesignCnstnMngResponseDto>>;
+  findById(id: string): Promise<DesignCnstnMngDetResponseDto>;
+  save(body: DesignCnstnMngSaveRequestDto): Promise<string>;
+  saveApply(body: DesignCnstnApplySaveRequestDto): Promise<string>;
+  update(id: string, body: DesignCnstnMngUpdateRequestDto): Promise<void>;
+  techReview(id: string, body: DesignCnstnApplySaveRequestDto): Promise<void>;
+  delete(id: string): Promise<void>;
+}

apps/as/src/entities/design-cnstn/model/design-cnstn-rvw-opnn-interface.ts

@@ -0,0 +1,59 @@
+import type { PageableParams, PageResponse, RvwOpnnResponseExtension } from "@/shared/model";
+
+/** 백엔드 DesignCnstnRvwOpnnId */
+export interface DesignCnstnRvwOpnnId {
+  designCnstnMng: string;
+  rvwOpnnSn: number;
+}
+
+/** 백엔드 DesignCnstnRvwOpnnSaveRequestDto */
+export interface DesignCnstnRvwOpnnSaveRequestDto {
+  designCnstnDocNo: string;
+  rvwOpnnSn?: number;
+  opnrSeComCd?: string;
+  opnrNm?: string;
+  rvwRsltCn?: string;
+  rvwRsltAnmlyYn?: string;
+  atchFileGroupId?: string;
+}
+
+/** 백엔드 DesignCnstnRvwOpnnUpdateRequestDto */
+export interface DesignCnstnRvwOpnnUpdateRequestDto {
+  opnrSeComCd?: string;
+  opnrNm?: string;
+  rvwRsltCn?: string;
+  rvwRsltAnmlyYn?: string;
+  atchFileGroupId?: string;
+}
+
+/** 백엔드 DesignCnstnRvwOpnnSearchDto + Pageable */
+export interface DesignCnstnRvwOpnnSearchDto extends PageableParams {
+  designCnstnDocNo?: string;
+  opnrNm?: string;
+  opnrSeComCd?: string;
+  rvwRsltCn?: string;
+  rvwRsltAnmlyYn?: string;
+  atchFileGroupId?: string;
+}
+
+/** 백엔드 DesignCnstnRvwOpnnResponseDto */
+export type DesignCnstnRvwOpnnResponseDto = Partial<
+  Pick<DesignCnstnRvwOpnnSaveRequestDto, "designCnstnDocNo" | "rvwOpnnSn">
+> &
+  Omit<DesignCnstnRvwOpnnSaveRequestDto, "designCnstnDocNo" | "rvwOpnnSn"> &
+  RvwOpnnResponseExtension;
+
+/** Controller public 메서드명·시그니처와 동일 */
+export interface DesignCnstnRvwOpnnService {
+  findPage(
+    searchDto: DesignCnstnRvwOpnnSearchDto,
+  ): Promise<PageResponse<DesignCnstnRvwOpnnResponseDto>>;
+  findById(designCnstnDocNo: string, rvwOpnnSn: number): Promise<DesignCnstnRvwOpnnResponseDto>;
+  save(body: DesignCnstnRvwOpnnSaveRequestDto): Promise<DesignCnstnRvwOpnnId>;
+  update(
+    designCnstnDocNo: string,
+    rvwOpnnSn: number,
+    body: DesignCnstnRvwOpnnUpdateRequestDto,
+  ): Promise<void>;
+  delete(designCnstnDocNo: string, rvwOpnnSn: number): Promise<void>;
+}

apps/as/src/pages/design-cnstn/index.ts

@@ -0,0 +1,5 @@
+export { DesignEditPage } from "./ui/design-edit-page";
+export { DesignFormPage } from "./ui/design-form-page";
+export { DesignListPage } from "./ui/design-list-page";
+export { DesignRegistPage } from "./ui/design-regist-page";
+export { DesignViewPage } from "./ui/design-view-page";

apps/as/src/pages/design-cnstn/lib/button-config.ts

@@ -0,0 +1,118 @@
+export const DESIGN_CNSTN_VIEW_BUTTON_ACTION = {
+  strg: "strg",
+  aply: "aply",
+  del: "del",
+  rqstRvw: "rqstRvw",
+  rvwStrg: "rvwStrg",
+  rvwCmptn: "rvwCmptn",
+  atrzAprv: "atrzAprv",
+  atrzRply: "atrzRply",
+} as const;
+
+export type DesignCnstnViewButtonAction =
+  (typeof DESIGN_CNSTN_VIEW_BUTTON_ACTION)[keyof typeof DESIGN_CNSTN_VIEW_BUTTON_ACTION];
+
+const ROLE_STATUS_BUTTON_ACTIONS: Record<string, Record<string, DesignCnstnViewButtonAction[]>> = {
+  ROLE_USER05: {
+    "": [
+      DESIGN_CNSTN_VIEW_BUTTON_ACTION.strg,
+      DESIGN_CNSTN_VIEW_BUTTON_ACTION.aply,
+      DESIGN_CNSTN_VIEW_BUTTON_ACTION.del,
+    ],
+    CV: [
+      DESIGN_CNSTN_VIEW_BUTTON_ACTION.strg,
+      DESIGN_CNSTN_VIEW_BUTTON_ACTION.aply,
+      DESIGN_CNSTN_VIEW_BUTTON_ACTION.del,
+    ],
+  },
+};
+
+const ROLE_USER01_ATRZ_STATUS_CODES = ["CT", "CS"] as const;
+
+const ROLE_USER01_ATRZ_STATUS_ACTIONS: Record<
+  string,
+  Record<string, DesignCnstnViewButtonAction[]>
+> = {
+  CT: {
+    ATRZ01: [DESIGN_CNSTN_VIEW_BUTTON_ACTION.rqstRvw],
+  },
+  CS: {
+    ATRZ02: [DESIGN_CNSTN_VIEW_BUTTON_ACTION.rvwStrg, DESIGN_CNSTN_VIEW_BUTTON_ACTION.rvwCmptn],
+    ATRZ03: [DESIGN_CNSTN_VIEW_BUTTON_ACTION.atrzAprv],
+    ATRZ99: [DESIGN_CNSTN_VIEW_BUTTON_ACTION.atrzRply],
+  },
+};
+
+function resolveButtonConfigs(
+  actions: DesignCnstnViewButtonAction[],
+): DesignCnstnViewButtonAction[] {
+  return actions.map((action) => DESIGN_CNSTN_VIEW_BUTTON_ACTION[action]);
+}
+
+interface GetButtonConfigsOptions {
+  hasPendingApprovalRequest?: boolean;
+}
+
+function resolveRoleUser01AtrzButtonActions(
+  prgrsSttsComCd: string,
+  atrzSeComCdList: string[],
+  options?: GetButtonConfigsOptions,
+): DesignCnstnViewButtonAction[] {
+  if (prgrsSttsComCd === "CS" && options?.hasPendingApprovalRequest === false) {
+    return [];
+  }
+
+  const atrzStatusMap = ROLE_USER01_ATRZ_STATUS_ACTIONS[prgrsSttsComCd];
+  if (!atrzStatusMap || atrzSeComCdList.length === 0) return [];
+
+  const seen = new Set<DesignCnstnViewButtonAction>();
+  const actions: DesignCnstnViewButtonAction[] = [];
+
+  for (const atrzSeComCd of atrzSeComCdList) {
+    const mappedActions = atrzStatusMap[atrzSeComCd];
+    if (!mappedActions) continue;
+
+    for (const action of mappedActions) {
+      if (seen.has(action)) continue;
+      seen.add(action);
+      actions.push(action);
+    }
+  }
+
+  return actions;
+}
+
+export function needsRoleUser01AtrzResolve(
+  dtlInstCd: string | undefined,
+  prgrsSttsComCd: string,
+): boolean {
+  return (
+    dtlInstCd === "ROLE_USER01" &&
+    ROLE_USER01_ATRZ_STATUS_CODES.includes(
+      prgrsSttsComCd as (typeof ROLE_USER01_ATRZ_STATUS_CODES)[number],
+    )
+  );
+}
+
+export function getButtonConfigs(
+  dtlInstCd: string | undefined,
+  prgrsSttsComCd: string,
+  atrzSeComCdList?: string[],
+  options?: GetButtonConfigsOptions,
+): DesignCnstnViewButtonAction[] {
+  if (!dtlInstCd) return [];
+
+  if (needsRoleUser01AtrzResolve(dtlInstCd, prgrsSttsComCd)) {
+    return resolveButtonConfigs(
+      resolveRoleUser01AtrzButtonActions(prgrsSttsComCd, atrzSeComCdList ?? [], options),
+    );
+  }
+
+  const statusMap = ROLE_STATUS_BUTTON_ACTIONS[dtlInstCd];
+  if (!statusMap) return [];
+
+  const actions = statusMap[prgrsSttsComCd];
+  if (!actions) return [];
+
+  return resolveButtonConfigs(actions);
+}

apps/as/src/pages/design-cnstn/lib/design-cnstn-regist-schema.ts

@@ -0,0 +1,68 @@
+import { z } from "zod";
+
+export const designCnstnRegistSchema = z.object({
+  designCnstnMng: z.object({
+    bizNm: z.string().min(1, "사업명은 필수입니다"),
+    bizBgngYr: z.string().min(1, "사업시작연도는 필수입니다"),
+    bizEndYr: z.string().min(1, "사업종료연도는 필수입니다"),
+    bizCn: z.string().min(1, "사업내용은 필수입니다"),
+    taskSeComCd: z.array(z.string()).min(1, "구분은 필수입니다"),
+    dsgnrNm: z.string().min(1, "설계자 이름은 필수입니다"),
+    dsgnrTelno: z
+      .string()
+      .min(1, "설계자 전화번호는 필수입니다")
+      .regex(/^[0-9-]+$/, "숫자와 하이픈(-)만 입력 가능합니다"),
+    dsgnrOgdpNm: z.string().min(1, "설계자 소속은 필수입니다"),
+    dsgnrEmlAddr: z
+      .string()
+      .min(1, "설계자 이메일은 필수입니다")
+      .email("올바른 이메일 형식이 아닙니다"),
+    aplcntNm: z.string().optional(),
+    aplcntMblTelno: z.string().optional(),
+    aplcntOgdpNm: z.string().optional(),
+    aplcntEmlAddr: z.string().optional(),
+    designCnstnDocNo: z.string().optional(),
+    admdstCd: z.string().optional(),
+    envoSeComCd: z.string().optional(),
+    prgrsSttsComCd: z.string().optional(),
+    atchFileGroupId: z.string().optional(),
+    envoSeCdNm: z.string().optional(),
+    taskSeCdNm: z.string().optional(),
+    prgrsSttsCdNm: z.string().optional(),
+    sido: z.string().optional(),
+    gugun: z.string().optional(),
+    regDt: z.string().optional(),
+    rgtr: z.string().optional(),
+    rgtrNm: z.string().optional(),
+    mdfcnDt: z.string().optional(),
+  }),
+  bzScaleList: z.array(
+    z.object({
+      cnstpSeCd: z.string(),
+      bscPl: z.number(),
+      budgetReflct: z.number(),
+      thtiDsgn: z.number(),
+      diff: z.number().optional(),
+    }),
+  ),
+  esntlAtchFileList: z.array(
+    z.object({
+      esntlAtchFileId: z.string(),
+      atchFileGroupId: z.string(),
+    }),
+  ),
+  privacyConsent: z.enum(["Y", "N"], {
+    required_error: "개인정보 수집/이용 동의는 필수입니다",
+  }),
+});
+
+export type DesignCnstnRegistFormData = z.infer<typeof designCnstnRegistSchema>;
+
+export function formatTaskSeComCdForApi(taskSeComCd: string[]): string {
+  return taskSeComCd.join(",");
+}
+
+export function parseTaskSeComCdFromApi(taskSeComCd?: string): string[] {
+  if (!taskSeComCd) return [];
+  return taskSeComCd.split(",").filter(Boolean);
+}

apps/as/src/pages/design-cnstn/lib/form-data-mapper.ts

@@ -0,0 +1,97 @@
+import type { IUserInfo } from "@/shared/store";
+import type { DesignCnstnMngDetResponseDto } from "@/entities/design-cnstn";
+
+import type { DesignCnstnRegistFormData } from "./design-cnstn-regist-schema";
+import { parseTaskSeComCdFromApi } from "./design-cnstn-regist-schema";
+
+function mapEsntlAtchFileList(esntlFileList: DesignCnstnMngDetResponseDto["esntlFileList"]) {
+  const esntlMap = new Map<string, string>();
+
+  for (const item of esntlFileList ?? []) {
+    if (!item.esntlAtchFileId || !item.atflCd) continue;
+    esntlMap.set(item.esntlAtchFileId, item.atflCd);
+  }
+
+  return Array.from(esntlMap.entries()).map(([esntlAtchFileId, atchFileGroupId]) => ({
+    esntlAtchFileId,
+    atchFileGroupId,
+  }));
+}
+
+export function mapDetailToFormData(data: DesignCnstnMngDetResponseDto): DesignCnstnRegistFormData {
+  const detDto = data.detDto;
+  if (!detDto) {
+    throw new Error("상세 정보(detDto)가 없습니다.");
+  }
+
+  const bizSclList = data.bizSclList ?? [];
+
+  return {
+    designCnstnMng: {
+      designCnstnDocNo: detDto.designCnstnDocNo,
+      bizNm: detDto.bizNm ?? "",
+      bizBgngYr: detDto.bizBgngYr ?? "",
+      bizEndYr: detDto.bizEndYr ?? "",
+      bizCn: detDto.bizCn ?? "",
+      taskSeComCd: parseTaskSeComCdFromApi(detDto.taskSeComCd),
+      dsgnrNm: detDto.dsgnrNm ?? "",
+      dsgnrTelno: detDto.dsgnrTelno ?? "",
+      dsgnrOgdpNm: detDto.dsgnrOgdpNm ?? "",
+      dsgnrEmlAddr: detDto.dsgnrEmlAddr ?? "",
+      aplcntNm: detDto.aplcntNm ?? "",
+      aplcntMblTelno: detDto.aplcntMblTelno ?? "",
+      aplcntOgdpNm: detDto.aplcntOgdpNm ?? "",
+      aplcntEmlAddr: detDto.aplcntEmlAddr ?? "",
+      admdstCd: detDto.admdstCd,
+      envoSeComCd: detDto.envoSeComCd,
+      prgrsSttsComCd: detDto.prgrsSttsComCd,
+      atchFileGroupId: detDto.atchFileGroupId ?? "",
+      envoSeCdNm: detDto.envoSeCdNm,
+      taskSeCdNm: detDto.taskSeCdNm,
+      prgrsSttsCdNm: detDto.prgrsSttsCdNm,
+      sido: detDto.sido,
+      gugun: detDto.gugun,
+      regDt: detDto.regDt,
+      rgtr: detDto.rgtr,
+      rgtrNm: detDto.rgtrNm,
+      mdfcnDt: detDto.mdfcnDt,
+    },
+    bzScaleList: bizSclList.map((item) => ({
+      cnstpSeCd: item.cnstpSeCd,
+      bscPl: item.bscPlanQty,
+      budgetReflct: item.bgtRfltQty,
+      thtiDsgn: item.tstmDesignQty,
+      diff: item.tstmDesignQty - item.bgtRfltQty,
+    })),
+    esntlAtchFileList: mapEsntlAtchFileList(data.esntlFileList),
+    privacyConsent: "Y",
+  };
+}
+
+export function getCreateDefaultValues(
+  userInfo: IUserInfo | null,
+  taskSeComCd?: string[],
+): DesignCnstnRegistFormData {
+  return {
+    designCnstnMng: {
+      bizNm: "",
+      bizBgngYr: "",
+      bizEndYr: "",
+      bizCn: "",
+      taskSeComCd: taskSeComCd ?? [],
+      dsgnrNm: "",
+      dsgnrTelno: "",
+      dsgnrOgdpNm: "",
+      dsgnrEmlAddr: "",
+      aplcntNm: userInfo?.userName ?? "",
+      aplcntMblTelno: userInfo?.mphn ?? "",
+      aplcntOgdpNm: userInfo?.ogdpSeNm ?? "",
+      aplcntEmlAddr: userInfo?.email ?? "",
+      prgrsSttsComCd: "CV",
+      atchFileGroupId: "",
+    },
+    bzScaleList: [],
+    esntlAtchFileList: [],
+    privacyConsent: "N",
+  };
+}

apps/as/src/pages/design-cnstn/lib/review-opinion-utils.ts

@@ -0,0 +1,94 @@
+import type {
+  DesignCnstnMngDetResponseDto,
+  DesignCnstnRvwOpnnResponseDto,
+  DesignCnstnRvwOpnnSaveRequestDto,
+} from "@/entities/design-cnstn";
+
+export interface ReviewOpinionFormData {
+  rvwRsltCn: string;
+  rvwRsltAnmlyYn: "Y" | "N" | "";
+  atchFileGroupId: string;
+  opnrSeComCd: string;
+  rvwOpnnSn?: number;
+}
+
+export interface ReviewOpinionGetFormDataResult {
+  formData: ReviewOpinionFormData;
+  rvwList: DesignCnstnRvwOpnnResponseDto[];
+}
+
+function hasReviewOpinionContent(formData: ReviewOpinionFormData) {
+  return Boolean(formData.rvwRsltCn.trim() || formData.rvwRsltAnmlyYn || formData.atchFileGroupId);
+}
+
+function mapServerItemToSaveDto(
+  item: DesignCnstnRvwOpnnResponseDto,
+  designCnstnDocNo: string,
+): DesignCnstnRvwOpnnSaveRequestDto | null {
+  if (item.rvwOpnnSn == null) return null;
+
+  return {
+    designCnstnDocNo,
+    rvwOpnnSn: item.rvwOpnnSn,
+    opnrSeComCd: item.opnrSeComCd,
+    opnrNm: item.opnrNm,
+    rvwRsltCn: item.rvwRsltCn,
+    rvwRsltAnmlyYn: item.rvwRsltAnmlyYn || undefined,
+    atchFileGroupId: item.atchFileGroupId || undefined,
+  };
+}
+
+function mapFormDataToSaveDto(
+  formData: ReviewOpinionFormData,
+  designCnstnDocNo: string,
+  opnrNm?: string,
+): DesignCnstnRvwOpnnSaveRequestDto {
+  const base = {
+    designCnstnDocNo,
+    opnrSeComCd: formData.opnrSeComCd,
+    opnrNm: opnrNm ?? "",
+    rvwRsltCn: formData.rvwRsltCn,
+    rvwRsltAnmlyYn: formData.rvwRsltAnmlyYn || undefined,
+    atchFileGroupId: formData.atchFileGroupId || undefined,
+  };
+
+  if (formData.rvwOpnnSn != null) {
+    return { ...base, rvwOpnnSn: formData.rvwOpnnSn };
+  }
+
+  return base as DesignCnstnRvwOpnnSaveRequestDto;
+}
+
+export function toRvwOpnnSaveDto(
+  data: DesignCnstnMngDetResponseDto,
+  result: ReviewOpinionGetFormDataResult | null | undefined,
+  opnrNm?: string,
+): DesignCnstnRvwOpnnSaveRequestDto[] | undefined {
+  if (!result || !data.detDto) return undefined;
+
+  const { formData, rvwList } = result;
+  const designCnstnDocNo = data.detDto.designCnstnDocNo;
+
+  const list: DesignCnstnRvwOpnnSaveRequestDto[] = rvwList
+    .map((item) => mapServerItemToSaveDto(item, designCnstnDocNo))
+    .filter((item): item is DesignCnstnRvwOpnnSaveRequestDto => item != null);
+
+  if (!hasReviewOpinionContent(formData)) {
+    return list.length > 0 ? list : undefined;
+  }
+
+  const formDto = mapFormDataToSaveDto(formData, designCnstnDocNo, opnrNm);
+
+  if (formData.rvwOpnnSn != null) {
+    const existingIndex = list.findIndex((item) => item.rvwOpnnSn === formData.rvwOpnnSn);
+    if (existingIndex >= 0) {
+      list[existingIndex] = formDto;
+    } else {
+      list.push(formDto);
+    }
+  } else {
+    list.push(formDto);
+  }
+
+  return list.length > 0 ? list : undefined;
+}

apps/as/src/pages/design-cnstn/lib/review-step-utils.ts

@@ -0,0 +1,12 @@
+import type { ReviewStepCode } from "../model/view-types";
+
+export function getEditableReviewStep(
+  dtlInstCd?: string,
+  prgrsSttsComCd?: string,
+): ReviewStepCode | undefined {
+  if (dtlInstCd === "ROLE_USER01" && prgrsSttsComCd === "CS") {
+    return "KECO";
+  }
+
+  return undefined;
+}

apps/as/src/pages/design-cnstn/lib/save-payload-utils.ts

@@ -0,0 +1,71 @@
+import type {
+  BizSclTreeDto,
+  BzScaleItem,
+  DesignCnstnApplySaveRequestDto,
+  DesignCnstnMngDetResponseDto,
+  EsntlAtchFileItem,
+  EsntlAtchFileMngTreeResponseDto,
+} from "@/entities/design-cnstn";
+
+import type { ReviewStepCode } from "../model/view-types";
+
+import { type ReviewOpinionGetFormDataResult, toRvwOpnnSaveDto } from "./review-opinion-utils";
+
+export function toBzScaleSaveDto(bizSclList: BizSclTreeDto[]): BzScaleItem[] {
+  return bizSclList
+    .filter((node) => node.useYn === "Y")
+    .map((node) => ({
+      cnstpSeCd: node.cnstpSeCd,
+      bscPl: node.bscPlanQty,
+      budgetReflct: node.bgtRfltQty,
+      thtiDsgn: node.tstmDesignQty,
+    }));
+}
+
+export function toEsntlAtchFileSaveDto(
+  esntlFileList: EsntlAtchFileMngTreeResponseDto[],
+): EsntlAtchFileItem[] {
+  const esntlMap = new Map<string, string>();
+
+  for (const item of esntlFileList) {
+    if (!item.esntlAtchFileId || !item.atflCd) continue;
+    esntlMap.set(item.esntlAtchFileId, item.atflCd);
+  }
+
+  return Array.from(esntlMap.entries()).map(([esntlAtchFileId, atchFileGroupId]) => ({
+    esntlAtchFileId,
+    atchFileGroupId,
+  }));
+}
+
+export function buildSavePayload(
+  data: DesignCnstnMngDetResponseDto,
+  prgrsSttsComCd: string,
+): DesignCnstnApplySaveRequestDto {
+  const detDto = data.detDto;
+  if (!detDto) {
+    throw new Error("상세 정보(detDto)가 없습니다.");
+  }
+
+  return {
+    designCnstnMng: { ...detDto, prgrsSttsComCd },
+    bzScaleList: toBzScaleSaveDto(data.bizSclList ?? []),
+    esntlAtchFileList: toEsntlAtchFileSaveDto(data.esntlFileList ?? []),
+  };
+}
+
+export function buildTechReviewPayload(
+  data: DesignCnstnMngDetResponseDto,
+  prgrsSttsComCd: string,
+  techReViewSaveCd: string,
+  reviewStep: ReviewStepCode,
+  reviewOpinionFormData?: ReviewOpinionGetFormDataResult | null,
+  opnrNm?: string,
+): DesignCnstnApplySaveRequestDto {
+  return {
+    ...buildSavePayload(data, prgrsSttsComCd),
+    techReViewSaveCd,
+    rvwStpCd: reviewStep,
+    rvwOpnnList: toRvwOpnnSaveDto(data, reviewOpinionFormData, opnrNm),
+  };
+}

apps/as/src/pages/design-cnstn/model/columns.tsx

@@ -0,0 +1,161 @@
+"use client";
+
+import { Fragment } from "react";
+
+import { createColumnHelper } from "@tanstack/react-table";
+
+import { dayjs } from "@/shared/lib";
+import type { DesignCnstnMngResponseDto } from "@/entities/design-cnstn";
+import { Badge } from "@common/components";
+
+const columnHelper = createColumnHelper<DesignCnstnMngResponseDto>();
+
+const MAIN_STEP_LABELS = {
+  save: "저장",
+  apply: "신청완료",
+  review: "설계자문 검토",
+  reply: "설계검토 회신",
+} as const;
+
+const REVIEW_STATUS_CODES = new Set(["CS", "CR"]);
+
+type BadgeState = "completed" | "current" | "pending" | "action";
+
+interface ProgressBadge {
+  label: string;
+  state: BadgeState;
+}
+
+function buildProgressBadges(prgrsSttsComCd: string, prgrsSttsCdNm: string): ProgressBadge[] {
+  const reviewLabel = prgrsSttsCdNm || MAIN_STEP_LABELS.review;
+  const replyLabel = prgrsSttsCdNm || MAIN_STEP_LABELS.reply;
+
+  if (prgrsSttsComCd === "CV") {
+    return [
+      { label: MAIN_STEP_LABELS.save, state: "current" },
+      { label: MAIN_STEP_LABELS.apply, state: "pending" },
+      { label: MAIN_STEP_LABELS.review, state: "pending" },
+      { label: MAIN_STEP_LABELS.reply, state: "pending" },
+    ];
+  }
+
+  if (prgrsSttsComCd === "CT") {
+    return [
+      { label: MAIN_STEP_LABELS.save, state: "completed" },
+      { label: MAIN_STEP_LABELS.apply, state: "current" },
+      { label: MAIN_STEP_LABELS.review, state: "pending" },
+      { label: MAIN_STEP_LABELS.reply, state: "pending" },
+    ];
+  }
+
+  if (REVIEW_STATUS_CODES.has(prgrsSttsComCd)) {
+    return [
+      { label: MAIN_STEP_LABELS.save, state: "completed" },
+      { label: MAIN_STEP_LABELS.apply, state: "completed" },
+      { label: reviewLabel, state: "action" },
+      { label: MAIN_STEP_LABELS.reply, state: "pending" },
+    ];
+  }
+
+  if (prgrsSttsComCd === "CP" || prgrsSttsComCd === "EP") {
+    return [
+      { label: MAIN_STEP_LABELS.save, state: "completed" },
+      { label: MAIN_STEP_LABELS.apply, state: "completed" },
+      { label: MAIN_STEP_LABELS.review, state: "completed" },
+      { label: replyLabel, state: "action" },
+    ];
+  }
+
+  return [{ label: prgrsSttsCdNm || prgrsSttsComCd || "-", state: "current" }];
+}
+
+function getBadgeColor(state: BadgeState) {
+  switch (state) {
+    case "completed":
+      return "green";
+    case "current":
+      return "blue";
+    case "pending":
+      return "lightGray";
+    case "action":
+      return "orange";
+  }
+}
+
+function formatOptional(value: string | undefined) {
+  return value?.trim() ? value : "-";
+}
+
+interface ProgressStepBadgeProps {
+  prgrsSttsComCd: string;
+  prgrsSttsCdNm: string;
+}
+
+function ProgressStepBadge({ prgrsSttsComCd, prgrsSttsCdNm }: ProgressStepBadgeProps) {
+  const badges = buildProgressBadges(prgrsSttsComCd, prgrsSttsCdNm);
+
+  return (
+    <div className="flex flex-wrap items-center justify-start">
+      {badges.map((badge, index) => (
+        <Fragment key={`${badge.label}-${index}`}>
+          {index > 0 && <span className="mx-2">&gt;</span>}
+          <Badge color={getBadgeColor(badge.state)}>{badge.label}</Badge>
+        </Fragment>
+      ))}
+    </div>
+  );
+}
+
+export function createDesignCnstnColumns() {
+  return [
+    columnHelper.accessor("sido", {
+      header: "시도",
+      meta: { align: "center" },
+      cell: ({ getValue }) => formatOptional(getValue()),
+    }),
+    columnHelper.accessor("gugun", {
+      header: "시군구",
+      meta: { align: "center" },
+      cell: ({ getValue }) => formatOptional(getValue()),
+    }),
+    columnHelper.accessor("bizNm", {
+      header: "사업명",
+      meta: { align: "left" },
+      cell: ({ getValue }) => formatOptional(getValue()),
+    }),
+    columnHelper.accessor("taskSeCdNm", {
+      header: "업무구분",
+      meta: { align: "center" },
+      cell: ({ row }) => formatOptional(row.original.taskSeCdNm || row.original.taskSeComCd),
+    }),
+    columnHelper.accessor("aplcntNm", {
+      header: "담당자",
+      meta: { align: "center" },
+      cell: ({ getValue }) => formatOptional(getValue()),
+    }),
+    columnHelper.accessor("envoSeCdNm", {
+      header: "해당기관",
+      meta: { align: "center" },
+      cell: ({ getValue }) => formatOptional(getValue()),
+    }),
+    columnHelper.display({
+      id: "progress",
+      header: "진행상황",
+      meta: { align: "center" },
+      cell: ({ row }) => (
+        <ProgressStepBadge
+          prgrsSttsComCd={row.original.prgrsSttsComCd || ""}
+          prgrsSttsCdNm={row.original.prgrsSttsCdNm || ""}
+        />
+      ),
+    }),
+    columnHelper.accessor("regDt", {
+      header: "신청일",
+      meta: { align: "center" },
+      cell: ({ getValue }) => {
+        const value = getValue();
+        return value ? dayjs(value).format("YYYY-MM-DD") : "-";
+      },
+    }),
+  ];
+}

apps/as/src/pages/design-cnstn/model/view-types.ts

@@ -0,0 +1,15 @@
+export type ReviewStepCode = "LOCAL" | "ENV" | "KECO";
+
+export const REVIEW_STEP_LABELS: Record<ReviewStepCode, string> = {
+  LOCAL: "지자체",
+  ENV: "환경청",
+  KECO: "환경공단",
+};
+
+export const DESIGN_PROGRESS_ORDER = ["CV", "CT", "CS", "CR", "CP", "EP"] as const;
+
+export const ROLE_TO_REVIEW_STEP: Record<string, ReviewStepCode> = {
+  ROLE_USER05: "LOCAL",
+  ROLE_USER03: "ENV",
+  ROLE_USER01: "KECO",
+};

apps/as/src/pages/design-cnstn/ui/components/floating-action-buttons.tsx

@@ -0,0 +1,391 @@
+"use client";
+
+import { useMemo, useState } from "react";
+import { useRouter } from "next/navigation";
+
+import { useConfirm } from "@frontend-opensource/use-react-hooks";
+import { useQueryClient } from "@tanstack/react-query";
+import { AxiosError } from "axios";
+
+import { ENDPOINT } from "@/shared/config";
+import { useAlertStore, useUserStore } from "@/shared/lib";
+import {
+  type DesignCnstnApplySaveRequestDto,
+  designCnstnMngBaseKey,
+  type DesignCnstnMngDetResponseDto,
+  designCnstnMngService,
+} from "@/entities/design-cnstn";
+import {
+  buildElaprPrgrsSttsListFromAplnRows,
+  ElaprApprovalDialog,
+  type ElaprDmndSaveRequestDto,
+  elaprDmndService,
+  type ElaprTmpltPickerConfirmPayload,
+  ElaprTmpltPickerDialog,
+  hasCurrentUserPendingApprovalRequest,
+  useElaprDocPrgrsByDocNo,
+} from "@/entities/elapr";
+import { Button } from "@common/components";
+
+import {
+  DESIGN_CNSTN_VIEW_BUTTON_ACTION,
+  type DesignCnstnViewButtonAction,
+  getButtonConfigs,
+  needsRoleUser01AtrzResolve,
+} from "../../lib/button-config";
+import { buildSavePayload, buildTechReviewPayload } from "../../lib/save-payload-utils";
+import type { TechReviewOpinionSectionHandle } from "../sections/tech-review-opinion-section";
+
+interface FloatingActionButtonsProps {
+  data: DesignCnstnMngDetResponseDto;
+  docSeComCd: string;
+  designCnstnDocNo: string;
+  prgrsSttsComCd: string;
+  dtlInstCd: string | undefined;
+  atrzSeComCdList: string[];
+  isRvwLoginUserLoading: boolean;
+  techReviewOpinionRef?: React.RefObject<TechReviewOpinionSectionHandle | null>;
+  opnrNm?: string;
+}
+
+type ActiveDialog = "elaprTmplt" | "elaprApproval" | null;
+
+function FloatingActionButtons({
+  data,
+  docSeComCd,
+  designCnstnDocNo,
+  prgrsSttsComCd,
+  dtlInstCd,
+  atrzSeComCdList,
+  isRvwLoginUserLoading,
+  techReviewOpinionRef,
+  opnrNm,
+}: FloatingActionButtonsProps) {
+  const router = useRouter();
+  const { confirm } = useConfirm();
+  const queryClient = useQueryClient();
+  const userInfo = useUserStore((state) => state.userInfo);
+  const alert = useAlertStore((state) => state.setMessage);
+  const [isProcessing, setIsProcessing] = useState(false);
+  const [activeDialog, setActiveDialog] = useState<ActiveDialog>(null);
+
+  const docNo = data.detDto?.designCnstnDocNo ?? designCnstnDocNo;
+  const isRegister = data.detDto?.rgtr === userInfo?.userUnqId;
+
+  const needsAtrzResolve = needsRoleUser01AtrzResolve(dtlInstCd, prgrsSttsComCd);
+  const needsCsApprovalCheck = needsAtrzResolve && prgrsSttsComCd === "CS";
+  const { data: elaprDocPrgrsList = [], isLoading: isElaprDocPrgrsLoading } =
+    useElaprDocPrgrsByDocNo(needsCsApprovalCheck ? docNo : null);
+
+  const hasPendingApprovalRequest = hasCurrentUserPendingApprovalRequest(
+    elaprDocPrgrsList,
+    userInfo?.userUnqId,
+  );
+
+  const actionButtons = useMemo(() => {
+    if (needsAtrzResolve && isRvwLoginUserLoading) return [];
+    if (needsCsApprovalCheck && isElaprDocPrgrsLoading) return [];
+    return getButtonConfigs(dtlInstCd, prgrsSttsComCd, atrzSeComCdList, {
+      hasPendingApprovalRequest: needsCsApprovalCheck ? hasPendingApprovalRequest : undefined,
+    });
+  }, [
+    atrzSeComCdList,
+    dtlInstCd,
+    hasPendingApprovalRequest,
+    isElaprDocPrgrsLoading,
+    isRvwLoginUserLoading,
+    needsAtrzResolve,
+    needsCsApprovalCheck,
+    prgrsSttsComCd,
+  ]);
+
+  const canEdit =
+    isRegister && actionButtons.some((button) => button === DESIGN_CNSTN_VIEW_BUTTON_ACTION.strg);
+
+  function handleGoToList() {
+    router.push("/design-cnstn");
+  }
+
+  function handleEdit() {
+    router.push(`/design-cnstn/${designCnstnDocNo}/edit`);
+  }
+
+  function shouldShowButton(action: DesignCnstnViewButtonAction) {
+    return actionButtons.some((button) => button === action);
+  }
+
+  async function executeAction({
+    action,
+    request,
+    successMessage,
+  }: {
+    action: DesignCnstnViewButtonAction;
+    request?: unknown;
+    successMessage?: string;
+  }) {
+    const handler = buttonActionHandlers[action];
+    if (!handler) return;
+
+    setIsProcessing(true);
+    try {
+      await handler({
+        request,
+        data,
+        onSuccess: () => {
+          if (successMessage) alert(successMessage);
+          queryClient.invalidateQueries({
+            queryKey: [...designCnstnMngBaseKey, "findById", designCnstnDocNo],
+          });
+        },
+        onError: (error) => {
+          let errorMessage = "";
+          if (error instanceof AxiosError) {
+            errorMessage = error.response?.data?.message ?? "";
+          } else {
+            errorMessage = error.message ?? "처리 중 오류가 발생했습니다.";
+          }
+          alert(errorMessage);
+        },
+      });
+    } finally {
+      setIsProcessing(false);
+    }
+  }
+
+  async function handleStrgClick() {
+    const payload: DesignCnstnApplySaveRequestDto = buildSavePayload(data, "CV");
+    await executeAction({
+      action: DESIGN_CNSTN_VIEW_BUTTON_ACTION.strg,
+      request: payload,
+      successMessage: "저장되었습니다.",
+    });
+  }
+
+  async function handleAplyClick() {
+    const payload: DesignCnstnApplySaveRequestDto = buildSavePayload(data, "CT");
+    await executeAction({
+      action: DESIGN_CNSTN_VIEW_BUTTON_ACTION.aply,
+      request: payload,
+      successMessage: "신청 완료되었습니다.",
+    });
+    queryClient.invalidateQueries({ queryKey: designCnstnMngBaseKey });
+  }
+
+  async function handleDelClick() {
+    if (!(await confirm("삭제하시겠습니까?"))) return;
+    await executeAction({
+      action: DESIGN_CNSTN_VIEW_BUTTON_ACTION.del,
+      successMessage: "삭제되었습니다.",
+    });
+    router.push("/design-cnstn");
+  }
+
+  function getReviewOpinionFormData() {
+    return techReviewOpinionRef?.current?.getFormData() ?? null;
+  }
+
+  async function handleElaprTmpltConfirm({ aplnRows }: ElaprTmpltPickerConfirmPayload) {
+    const payload: ElaprDmndSaveRequestDto = {
+      elaprDocNo: docNo,
+      dmndTtl: data.detDto?.bizNm ?? "",
+      dmndCn: data.detDto?.bizCn ?? "",
+      elaprPrgrsSttsList: buildElaprPrgrsSttsListFromAplnRows(aplnRows),
+    };
+    await executeAction({
+      action: DESIGN_CNSTN_VIEW_BUTTON_ACTION.rqstRvw,
+      request: payload,
+      successMessage: "검토자지정이 완료되었습니다.",
+    });
+    await queryClient.invalidateQueries({
+      queryKey: [ENDPOINT.AS_ELAPR_SERVICE.ELAPR_DMND, "findDocPrgrsByDocNo", docNo],
+    });
+  }
+
+  async function handleRvwStrgClick() {
+    const payload = buildTechReviewPayload(
+      data,
+      "CS",
+      "SV",
+      "KECO",
+      getReviewOpinionFormData(),
+      opnrNm,
+    );
+
+    await executeAction({
+      action: DESIGN_CNSTN_VIEW_BUTTON_ACTION.rvwStrg,
+      request: payload,
+      successMessage: "저장되었습니다.",
+    });
+    techReviewOpinionRef?.current?.resetForm();
+  }
+
+  async function handleRvwCmptnClick() {
+    const payload = buildTechReviewPayload(
+      data,
+      "CS",
+      "CP",
+      "KECO",
+      getReviewOpinionFormData(),
+      opnrNm,
+    );
+
+    await executeAction({
+      action: DESIGN_CNSTN_VIEW_BUTTON_ACTION.rvwCmptn,
+      request: payload,
+    });
+    techReviewOpinionRef?.current?.resetForm();
+    setActiveDialog("elaprApproval");
+  }
+
+  return (
+    <>
+      <div className="sticky bottom-0 z-40 !-mb-2 border-t bg-white pb-8 pt-6 shadow-[0_-4px_12px_rgba(0,0,0,0.06)]">
+        <div className="mx-4 flex flex-wrap justify-center gap-3 sm:gap-4">
+          <Button color="white" type="button" onClick={handleGoToList} disabled={isProcessing}>
+            목록
+          </Button>
+          {canEdit && (
+            <Button color="gray" onClick={handleEdit} disabled={isProcessing}>
+              수정
+            </Button>
+          )}
+          {shouldShowButton(DESIGN_CNSTN_VIEW_BUTTON_ACTION.strg) && (
+            <Button onClick={handleStrgClick} disabled={isProcessing}>
+              저장
+            </Button>
+          )}
+          {shouldShowButton(DESIGN_CNSTN_VIEW_BUTTON_ACTION.aply) && (
+            <Button color="green" onClick={handleAplyClick} disabled={isProcessing}>
+              신청완료
+            </Button>
+          )}
+          {shouldShowButton(DESIGN_CNSTN_VIEW_BUTTON_ACTION.del) && (
+            <Button color="red" onClick={handleDelClick} disabled={isProcessing}>
+              삭제
+            </Button>
+          )}
+          {shouldShowButton(DESIGN_CNSTN_VIEW_BUTTON_ACTION.rqstRvw) && (
+            <Button onClick={() => setActiveDialog("elaprTmplt")} disabled={isProcessing}>
+              검토자지정
+            </Button>
+          )}
+          {shouldShowButton(DESIGN_CNSTN_VIEW_BUTTON_ACTION.rvwStrg) && (
+            <Button onClick={handleRvwStrgClick} disabled={isProcessing}>
+              저장
+            </Button>
+          )}
+          {shouldShowButton(DESIGN_CNSTN_VIEW_BUTTON_ACTION.rvwCmptn) && (
+            <Button color="green" onClick={handleRvwCmptnClick} disabled={isProcessing}>
+              검토완료
+            </Button>
+          )}
+          {shouldShowButton(DESIGN_CNSTN_VIEW_BUTTON_ACTION.atrzAprv) && (
+            <Button onClick={() => setActiveDialog("elaprApproval")} disabled={isProcessing}>
+              결재(승인)
+            </Button>
+          )}
+          {shouldShowButton(DESIGN_CNSTN_VIEW_BUTTON_ACTION.atrzRply) && (
+            <Button onClick={() => setActiveDialog("elaprApproval")} disabled={isProcessing}>
+              결재(회신)
+            </Button>
+          )}
+        </div>
+      </div>
+
+      <ElaprTmpltPickerDialog
+        open={activeDialog === "elaprTmplt"}
+        onClose={() => setActiveDialog(null)}
+        docSeComCd={docSeComCd}
+        onConfirm={handleElaprTmpltConfirm}
+      />
+
+      <ElaprApprovalDialog
+        open={activeDialog === "elaprApproval"}
+        onOpenChange={(open) => setActiveDialog(open ? "elaprApproval" : null)}
+        elaprDocNo={data.detDto?.designCnstnDocNo ?? designCnstnDocNo}
+        currentUserUuid={userInfo?.userUnqId ?? ""}
+        onSuccess={() => {
+          queryClient.invalidateQueries({
+            queryKey: [...designCnstnMngBaseKey, "findById", designCnstnDocNo],
+          });
+        }}
+      />
+    </>
+  );
+}
+
+export { FloatingActionButtons };
+
+async function handleSaveApply(
+  context: ActionHandlerContext<DesignCnstnApplySaveRequestDto>,
+): Promise<void> {
+  try {
+    await designCnstnMngService.saveApply(context.request);
+    context.onSuccess?.();
+  } catch (error) {
+    context.onError?.(error as Error);
+  }
+}
+
+async function handleDel(context: ActionHandlerContext): Promise<void> {
+  try {
+    await designCnstnMngService.delete(context.data.detDto?.designCnstnDocNo ?? "");
+    context.onSuccess?.();
+  } catch (error) {
+    context.onError?.(error as Error);
+  }
+}
+
+async function handleTechReview(
+  context: ActionHandlerContext<DesignCnstnApplySaveRequestDto>,
+): Promise<void> {
+  try {
+    await designCnstnMngService.techReview(
+      context.data.detDto?.designCnstnDocNo ?? "",
+      context.request,
+    );
+    context.onSuccess?.();
+  } catch (error) {
+    context.onError?.(error as Error);
+  }
+}
+
+async function handleRqstRvw(
+  context: ActionHandlerContext<ElaprDmndSaveRequestDto>,
+): Promise<void> {
+  try {
+    await elaprDmndService.save(context.request);
+    context.onSuccess?.();
+  } catch (error) {
+    context.onError?.(error as Error);
+  }
+}
+
+async function handleAtrzAprv(context: ActionHandlerContext): Promise<void> {
+  context.onSuccess?.();
+}
+
+async function handleAtrzRply(context: ActionHandlerContext): Promise<void> {
+  context.onSuccess?.();
+}
+
+const buttonActionHandlers: Record<DesignCnstnViewButtonAction, ActionHandler> = {
+  strg: handleSaveApply,
+  aply: handleSaveApply,
+  del: handleDel,
+  rqstRvw: handleRqstRvw,
+  rvwStrg: handleTechReview,
+  rvwCmptn: handleTechReview,
+  atrzAprv: handleAtrzAprv,
+  atrzRply: handleAtrzRply,
+};
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+interface ActionHandlerContext<T = any> {
+  request: T;
+  data: DesignCnstnMngDetResponseDto;
+  onSuccess?: () => void;
+  onError?: (error: Error) => void;
+}
+
+type ActionHandler = (context: ActionHandlerContext) => Promise<void>;

apps/as/src/pages/design-cnstn/ui/design-edit-page.tsx

@@ -0,0 +1,41 @@
+"use client";
+
+import { useDesignCnstnMng } from "@/entities/design-cnstn";
+import { Skeleton } from "@common/components";
+
+import { DesignFormPage } from "./design-form-page";
+
+interface DesignEditPageProps {
+  id: string;
+}
+
+function DesignEditPage({ id }: DesignEditPageProps) {
+  const { data, isLoading } = useDesignCnstnMng(id);
+
+  if (isLoading) {
+    return (
+      <div className="mt-6 space-y-6 px-4">
+        <div className="space-y-2">
+          <Skeleton className="h-[4rem] w-full" />
+          <Skeleton className="h-[20rem] w-full" />
+        </div>
+        <div className="space-y-2">
+          <Skeleton className="h-[4rem] w-full" />
+          <Skeleton className="h-[20rem] w-full" />
+        </div>
+        <div className="space-y-2">
+          <Skeleton className="h-[4rem] w-full" />
+          <Skeleton className="h-[20rem] w-full" />
+        </div>
+      </div>
+    );
+  }
+
+  if (!data?.detDto) {
+    return <div className="mt-6 text-[1.4rem]">상세 정보를 찾을 수 없습니다.</div>;
+  }
+
+  return <DesignFormPage id={id} mode="edit" initialData={data} />;
+}
+
+export { DesignEditPage };

apps/as/src/pages/design-cnstn/ui/design-form-page.tsx

@@ -0,0 +1,209 @@
+"use client";
+
+import { useState } from "react";
+import { FormProvider, useForm } from "react-hook-form";
+import { useRouter } from "next/navigation";
+
+import { useConfirm } from "@frontend-opensource/use-react-hooks";
+import { zodResolver } from "@hookform/resolvers/zod";
+import { useQueryClient } from "@tanstack/react-query";
+
+import { useAlertStore, useUserStore } from "@/shared/lib";
+import {
+  type DesignCnstnApplySaveRequestDto,
+  designCnstnMngBaseKey,
+  type DesignCnstnMngDetResponseDto,
+  designCnstnMngService,
+} from "@/entities/design-cnstn";
+import {
+  AttachmentsFormSection,
+  BusinessScaleFormSection,
+  ContactInfoFormSection,
+  PrivacyConsentSection,
+} from "@/widgets/pbadms-sprt";
+import { Button } from "@common/components";
+
+import {
+  type DesignCnstnRegistFormData,
+  designCnstnRegistSchema,
+  formatTaskSeComCdForApi,
+} from "../lib/design-cnstn-regist-schema";
+import { getCreateDefaultValues, mapDetailToFormData } from "../lib/form-data-mapper";
+
+import { BasicInfoFormSection } from "./sections/basic-info-form-section";
+
+interface DesignFormPageProps {
+  id?: string;
+  mode: "create" | "edit";
+  initialData?: DesignCnstnMngDetResponseDto;
+  taskSeComCd?: string[];
+}
+
+function DesignFormPage({ id, mode, initialData, taskSeComCd }: DesignFormPageProps) {
+  const queryClient = useQueryClient();
+  const router = useRouter();
+  const { confirm } = useConfirm();
+  const userInfo = useUserStore((state) => state.userInfo);
+  const alert = useAlertStore((state) => state.setMessage);
+  const [isSubmitting, setIsSubmitting] = useState(false);
+  const isEditMode = mode === "edit";
+
+  const form = useForm<DesignCnstnRegistFormData>({
+    resolver: zodResolver(designCnstnRegistSchema),
+    mode: "onChange",
+    defaultValues:
+      isEditMode && initialData
+        ? mapDetailToFormData(initialData)
+        : getCreateDefaultValues(userInfo, taskSeComCd),
+  });
+
+  function buildFormPayload(
+    data: DesignCnstnRegistFormData,
+    prgrsSttsComCd: "CV" | "CT",
+  ): DesignCnstnApplySaveRequestDto {
+    const { taskSeComCd: formTaskSeComCd, ...designCnstnMngRest } = data.designCnstnMng;
+
+    return {
+      designCnstnMng: {
+        ...designCnstnMngRest,
+        taskSeComCd: formatTaskSeComCdForApi(formTaskSeComCd),
+        designCnstnDocNo: isEditMode ? initialData?.detDto?.designCnstnDocNo : undefined,
+        prgrsSttsComCd,
+      },
+      bzScaleList: data.bzScaleList,
+      esntlAtchFileList: data.esntlAtchFileList,
+    };
+  }
+
+  async function submitForm(
+    data: DesignCnstnRegistFormData,
+    prgrsSttsComCd: "CV" | "CT",
+  ): Promise<string | undefined> {
+    return designCnstnMngService.saveApply(buildFormPayload(data, prgrsSttsComCd));
+  }
+
+  async function onSave(data: DesignCnstnRegistFormData) {
+    if (isSubmitting) return;
+
+    try {
+      setIsSubmitting(true);
+      const designCnstnDocNo = await submitForm(data, "CV");
+      if (!designCnstnDocNo) return;
+
+      alert("저장되었습니다.");
+      router.push(`/design-cnstn/${designCnstnDocNo}/edit`);
+      if (isEditMode && id) {
+        queryClient.invalidateQueries({
+          queryKey: [...designCnstnMngBaseKey, "findById", id],
+        });
+      }
+    } catch (error) {
+      console.error("저장 실패:", error);
+      alert("저장 중 오류가 발생했습니다.");
+    } finally {
+      setIsSubmitting(false);
+    }
+  }
+
+  async function onApply(data: DesignCnstnRegistFormData) {
+    if (isSubmitting) return;
+
+    try {
+      setIsSubmitting(true);
+      const designCnstnDocNo = await submitForm(data, "CT");
+      if (!designCnstnDocNo) return;
+
+      alert("신청 완료되었습니다.");
+      router.push(`/design-cnstn/${designCnstnDocNo}`);
+      queryClient.invalidateQueries({ queryKey: designCnstnMngBaseKey });
+      if (id) {
+        queryClient.invalidateQueries({
+          queryKey: [...designCnstnMngBaseKey, "findById", id],
+        });
+      }
+    } catch (error) {
+      console.error("신청 실패:", error);
+      alert("신청 중 오류가 발생했습니다.");
+    } finally {
+      setIsSubmitting(false);
+    }
+  }
+
+  function handleApplyClick() {
+    form.handleSubmit(onApply)();
+  }
+
+  async function handleDelClick() {
+    if (isSubmitting) return;
+
+    const docNo = initialData?.detDto?.designCnstnDocNo;
+    if (!docNo) {
+      alert("문서번호가 없습니다.");
+      return;
+    }
+
+    if (!(await confirm("삭제하시겠습니까?"))) return;
+
+    try {
+      setIsSubmitting(true);
+      await designCnstnMngService.delete(docNo);
+      alert("삭제되었습니다.");
+      router.push("/design-cnstn");
+    } catch (error) {
+      console.error("삭제 실패:", error);
+      alert("삭제 중 오류가 발생했습니다.");
+    } finally {
+      setIsSubmitting(false);
+    }
+  }
+
+  return (
+    <FormProvider {...form}>
+      <form onSubmit={form.handleSubmit(onSave)} className="mt-6 space-y-4">
+        <BasicInfoFormSection />
+        <ContactInfoFormSection fieldPrefix="designCnstnMng" />
+        <PrivacyConsentSection />
+        <BusinessScaleFormSection />
+        <AttachmentsFormSection
+          docSeComCd="CNFM"
+          fieldPrefix="designCnstnMng"
+          initialEsntlFiles={isEditMode ? initialData?.esntlFileList : undefined}
+          initialEtcFiles={isEditMode ? initialData?.etcFileList : undefined}
+        />
+
+        <div className="sticky bottom-0 z-40 !-mb-2 border-t bg-white pb-8 pt-6 shadow-[0_-4px_12px_rgba(0,0,0,0.06)]">
+          <div className="mx-4 flex flex-wrap justify-center gap-3 sm:gap-4">
+            <Button
+              color="white"
+              type="button"
+              onClick={() => router.push("/design-cnstn")}
+              disabled={isSubmitting}
+            >
+              목록
+            </Button>
+            <Button type="submit" disabled={isSubmitting}>
+              저장
+            </Button>
+            {isEditMode && (
+              <>
+                <Button
+                  color="green"
+                  type="button"
+                  onClick={handleApplyClick}
+                  disabled={isSubmitting}
+                >
+                  신청완료
+                </Button>
+                <Button color="red" type="button" onClick={handleDelClick} disabled={isSubmitting}>
+                  삭제
+                </Button>
+              </>
+            )}
+          </div>
+        </div>
+      </form>
+    </FormProvider>
+  );
+}
+
+export { DesignFormPage };

apps/as/src/pages/design-cnstn/ui/design-list-page.tsx

@@ -0,0 +1,152 @@
+"use client";
+
+import { useState } from "react";
+
+import type { PaginationState } from "@tanstack/react-table";
+
+import {
+  type CmCdAdstDstrComboResponseDto,
+  useFindGugunCombo,
+  useFindSidoCombo,
+} from "@/entities/adstdstr";
+import { CodeSelect } from "@/entities/code";
+import type { DesignCnstnMngSearchDto } from "@/entities/design-cnstn";
+import {
+  Button,
+  Input,
+  Label,
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "@common/components";
+
+import { DesignList } from "./design-list";
+
+const DEFAULT_PAGE_INDEX = 0;
+const DEFAULT_PAGE_SIZE = 10;
+const DEFAULT_SORT = "designCnstnDocNo,desc";
+const EMPTY_ADST_LIST: CmCdAdstDstrComboResponseDto[] = [];
+
+const DEFAULT_SEARCH_PARAMS: DesignCnstnMngSearchDto = {
+  bizNm: "",
+  taskSeComCd: "",
+  admdstCd: "",
+  page: DEFAULT_PAGE_INDEX,
+  size: DEFAULT_PAGE_SIZE,
+  sort: DEFAULT_SORT,
+};
+
+const ALL_SELECT_VALUE = "__ALL__";
+
+function DesignListPage() {
+  const [bizNm, setBizNm] = useState("");
+  const [taskSeComCd, setTaskSeComCd] = useState("");
+  const [sidoComCd, setSidoComCd] = useState("");
+  const [sggComCd, setSggComCd] = useState("");
+  const [pagination, setPagination] = useState<PaginationState>({
+    pageIndex: DEFAULT_PAGE_INDEX,
+    pageSize: DEFAULT_PAGE_SIZE,
+  });
+  const [searchParams, setSearchParams] = useState<DesignCnstnMngSearchDto>(DEFAULT_SEARCH_PARAMS);
+
+  const { data: sidoData } = useFindSidoCombo();
+  const { data: gugunData } = useFindGugunCombo(sidoComCd);
+  const sidoOptions = sidoData ?? EMPTY_ADST_LIST;
+  const gugunOptions = gugunData ?? EMPTY_ADST_LIST;
+
+  const handleSearch = (event: React.FormEvent<HTMLFormElement>) => {
+    event.preventDefault();
+    setPagination((prev) => ({ ...prev, pageIndex: DEFAULT_PAGE_INDEX }));
+    setSearchParams({
+      ...DEFAULT_SEARCH_PARAMS,
+      bizNm,
+      taskSeComCd,
+      admdstCd: sggComCd || sidoComCd || "",
+      page: DEFAULT_PAGE_INDEX,
+      size: pagination.pageSize,
+    });
+  };
+
+  return (
+    <div className="space-y-4 px-[1.8rem] pb-6">
+      <section className="card card-border mx-0 bg-background">
+        <form className="flex flex-wrap items-center gap-4 p-2" onSubmit={handleSearch}>
+          <div className="flex items-center gap-2">
+            <Label htmlFor="sidoComCd" className="whitespace-nowrap">
+              시도
+            </Label>
+            <Select
+              value={sidoComCd}
+              onValueChange={(value) => {
+                setSidoComCd(value === ALL_SELECT_VALUE ? "" : value);
+                setSggComCd("");
+              }}
+            >
+              <SelectTrigger id="sidoComCd" className="w-[12rem]">
+                <SelectValue placeholder="전체" />
+              </SelectTrigger>
+              <SelectContent>
+                <SelectItem value={ALL_SELECT_VALUE}>전체</SelectItem>
+                {sidoOptions.map((option) => (
+                  <SelectItem key={option.adstDstrCd} value={option.adstDstrCd}>
+                    {option.adstDstrNm}
+                  </SelectItem>
+                ))}
+              </SelectContent>
+            </Select>
+          </div>
+          <div className="flex items-center gap-2">
+            <Label htmlFor="sggComCd" className="whitespace-nowrap">
+              시군구
+            </Label>
+            <Select
+              value={sggComCd}
+              onValueChange={(value) => setSggComCd(value === ALL_SELECT_VALUE ? "" : value)}
+              disabled={!sidoComCd}
+            >
+              <SelectTrigger id="sggComCd" className="w-[12rem]">
+                <SelectValue placeholder="전체" />
+              </SelectTrigger>
+              <SelectContent>
+                <SelectItem value={ALL_SELECT_VALUE}>전체</SelectItem>
+                {gugunOptions.map((option) => (
+                  <SelectItem key={option.adstDstrCd} value={option.adstDstrCd}>
+                    {option.adstDstrNm}
+                  </SelectItem>
+                ))}
+              </SelectContent>
+            </Select>
+          </div>
+          <div className="flex items-center gap-2">
+            <Label htmlFor="taskSeComCd" className="whitespace-nowrap">
+              구분
+            </Label>
+            <CodeSelect upCd="CNFM" value={taskSeComCd} onValueChange={setTaskSeComCd} />
+          </div>
+          <div className="flex w-[24rem] items-center gap-2">
+            <Label htmlFor="bizNm" className="whitespace-nowrap">
+              사업명
+            </Label>
+            <Input
+              id="bizNm"
+              value={bizNm}
+              onChange={(event) => setBizNm(event.target.value)}
+              placeholder="사업명"
+            />
+          </div>
+          <Button type="submit">조회</Button>
+        </form>
+      </section>
+
+      <DesignList
+        searchParams={searchParams}
+        pagination={pagination}
+        onPaginationChange={setPagination}
+      />
+    </div>
+  );
+}
+
+export { DesignListPage };

apps/as/src/pages/design-cnstn/ui/design-list.tsx

@@ -0,0 +1,101 @@
+"use client";
+
+import { useMemo, useState } from "react";
+import { useRouter } from "next/navigation";
+
+import { getCoreRowModel, type PaginationState } from "@tanstack/react-table";
+
+import { useDataTable, useUserStore } from "@/shared/lib";
+import {
+  type DesignCnstnMngResponseDto,
+  type DesignCnstnMngSearchDto,
+  useDesignCnstnMngPage,
+} from "@/entities/design-cnstn";
+import { TaskSePickerDialog } from "@/widgets/pbadms-sprt";
+import { Button } from "@common/components";
+
+import { formatTaskSeComCdForApi } from "../lib/design-cnstn-regist-schema";
+import { createDesignCnstnColumns } from "../model/columns";
+
+interface DesignListProps {
+  searchParams: DesignCnstnMngSearchDto;
+  pagination: PaginationState;
+  onPaginationChange: (pagination: PaginationState) => void;
+}
+
+function DesignList({ searchParams, pagination, onPaginationChange }: DesignListProps) {
+  const userInfo = useUserStore((state) => state.userInfo);
+  const router = useRouter();
+  const [isTaskSeDialogOpen, setIsTaskSeDialogOpen] = useState(false);
+
+  const queryParams = useMemo(
+    () => ({
+      bizNm: searchParams.bizNm,
+      taskSeComCd: searchParams.taskSeComCd,
+      admdstCd: searchParams.admdstCd,
+      page: pagination.pageIndex,
+      size: pagination.pageSize,
+      sort: searchParams.sort ?? "designCnstnDocNo,desc",
+    }),
+    [searchParams, pagination],
+  );
+
+  const pageQuery = useDesignCnstnMngPage(queryParams);
+  const columns = useMemo(() => createDesignCnstnColumns(), []);
+
+  const handleRowClick = (row: DesignCnstnMngResponseDto) => {
+    const canEdit = row.prgrsSttsComCd === "CV" && row.rgtr === userInfo?.userUnqId;
+
+    router.push(
+      canEdit
+        ? `/design-cnstn/${row.designCnstnDocNo}/edit`
+        : `/design-cnstn/${row.designCnstnDocNo}`,
+    );
+  };
+
+  const { tableComponent } = useDataTable({
+    query: pageQuery,
+    tableOptions: {
+      columns,
+      state: { pagination },
+      onPaginationChange: (updater) => {
+        const next = typeof updater === "function" ? updater(pagination) : updater;
+        onPaginationChange(next);
+      },
+      getCoreRowModel: getCoreRowModel(),
+      manualPagination: true,
+    },
+    dataTableOptions: {
+      viewPagination: true,
+      onRowClick: handleRowClick,
+    },
+  });
+
+  const handleConfirmTaskSe = (selectedCodes: string[]) => {
+    setIsTaskSeDialogOpen(false);
+    router.push(`/design-cnstn/regist?taskSeComCd=${formatTaskSeComCdForApi(selectedCodes)}`);
+  };
+
+  return (
+    <>
+      <section className="card card-border mx-0 bg-background pb-8 pt-0">
+        <div className="card-header flex items-center justify-between">
+          <h3 className="text-2xl font-semibold">설계자문 목록</h3>
+          <Button type="button" color="green" onClick={() => setIsTaskSeDialogOpen(true)}>
+            신청
+          </Button>
+        </div>
+        {tableComponent}
+      </section>
+      <TaskSePickerDialog
+        open={isTaskSeDialogOpen}
+        onOpenChange={setIsTaskSeDialogOpen}
+        onConfirm={handleConfirmTaskSe}
+        title="설계자문 신청"
+        codeUpCd="CNFM"
+      />
+    </>
+  );
+}
+
+export { DesignList };

apps/as/src/pages/design-cnstn/ui/design-regist-page.tsx

@@ -0,0 +1,11 @@
+import { DesignFormPage } from "./design-form-page";
+
+interface DesignRegistPageProps {
+  taskSeComCd?: string[];
+}
+
+function DesignRegistPage({ taskSeComCd }: DesignRegistPageProps) {
+  return <DesignFormPage mode="create" taskSeComCd={taskSeComCd} />;
+}
+
+export { DesignRegistPage };

apps/as/src/pages/design-cnstn/ui/design-view-page.tsx

@@ -0,0 +1,110 @@
+"use client";
+
+import { useMemo, useRef } from "react";
+
+import { useUserStore } from "@/shared/lib";
+import { useDesignCnstnMng } from "@/entities/design-cnstn";
+import { ElaprDocPrgrsStatus } from "@/entities/elapr";
+import { useRvwMnpwMngLoginUserList } from "@/entities/rvw-mnpw";
+import { SectionCollapsible } from "@/widgets/pbadms-sprt";
+import { Skeleton } from "@common/components";
+
+import { needsRoleUser01AtrzResolve } from "../lib/button-config";
+import { getEditableReviewStep } from "../lib/review-step-utils";
+
+import { FloatingActionButtons } from "./components/floating-action-buttons";
+import { AttachmentsSection } from "./sections/attachments-section";
+import { BasicInfoSection } from "./sections/basic-info-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 DesignViewPageProps {
+  id: string;
+}
+
+function DesignViewPage({ id }: DesignViewPageProps) {
+  const userInfo = useUserStore((state) => state.userInfo);
+  const techReviewOpinionRef = useRef<TechReviewOpinionSectionHandle>(null);
+  const { data, isLoading, isError } = useDesignCnstnMng(id);
+
+  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?.detDto) {
+    return <div className="mt-6 text-[1.4rem]">상세 정보를 찾을 수 없습니다.</div>;
+  }
+
+  const detDto = data.detDto;
+  const bizSclList = data.bizSclList ?? [];
+  const esntlFileList = data.esntlFileList ?? [];
+  const etcFileList = data.etcFileList ?? [];
+  const rvwList = data.rvwList ?? [];
+
+  const editableReviewStep = getEditableReviewStep(
+    userInfo?.dtlInstCd,
+    detDto.prgrsSttsComCd || "",
+  );
+
+  return (
+    <div className="mt-6 space-y-4">
+      <BasicInfoSection det={detDto} />
+      <ContactInfoSection det={detDto} />
+      <SectionCollapsible title="결재현황">
+        <ElaprDocPrgrsStatus elaprDocNo={detDto.designCnstnDocNo} />
+      </SectionCollapsible>
+      <BusinessScaleSection bizSclList={bizSclList} />
+      <AttachmentsSection esntlFileList={esntlFileList} etcFileList={etcFileList} />
+      <TechReviewOpinionSection
+        ref={techReviewOpinionRef}
+        rvwList={rvwList}
+        editableReviewStep={editableReviewStep}
+        atrzSeComCdList={atrzSeComCdList}
+        isAtrzLoading={needsAtrzResolve && isRvwLoginUserLoading}
+      />
+      <FloatingActionButtons
+        data={data}
+        docSeComCd="CNFM"
+        designCnstnDocNo={detDto.designCnstnDocNo}
+        prgrsSttsComCd={detDto.prgrsSttsComCd || ""}
+        dtlInstCd={userInfo?.dtlInstCd}
+        atrzSeComCdList={atrzSeComCdList}
+        isRvwLoginUserLoading={needsAtrzResolve && isRvwLoginUserLoading}
+        techReviewOpinionRef={techReviewOpinionRef}
+        opnrNm={userInfo?.userName}
+      />
+    </div>
+  );
+}
+
+export { DesignViewPage };

apps/as/src/pages/design-cnstn/ui/sections/attachments-section.tsx

@@ -0,0 +1,112 @@
+"use client";
+
+import { formatFileSize } from "@/shared/lib/file-utils";
+import { useDownloadAttachmentByAtflCd } from "@/entities/attach";
+import type {
+  AtflMngClientResponseDto,
+  EsntlAtchFileMngTreeResponseDto,
+} from "@/entities/design-cnstn";
+import { SectionCollapsible } from "@/widgets/pbadms-sprt";
+import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "@common/components";
+
+interface AttachmentsSectionProps {
+  esntlFileList: EsntlAtchFileMngTreeResponseDto[];
+  etcFileList: AtflMngClientResponseDto[];
+}
+
+function AttachmentsSection({ esntlFileList, etcFileList }: AttachmentsSectionProps) {
+  const { mutate: downloadAttachment } = useDownloadAttachmentByAtflCd();
+
+  return (
+    <>
+      {esntlFileList.length > 0 && (
+        <SectionCollapsible title="필수 첨부파일">
+          <div className="overflow-x-auto">
+            <Table variant="secondary">
+              <TableHeader>
+                <TableRow>
+                  <TableHead>필수 자료명</TableHead>
+                  <TableHead>파일명</TableHead>
+                  <TableHead className="w-[8rem] text-right">크기</TableHead>
+                </TableRow>
+              </TableHeader>
+              <TableBody>
+                {esntlFileList.map((file) => (
+                  <TableRow key={file.esntlAtchFileId}>
+                    <TableCell className="pl-2 text-left">
+                      {file.esntlAtchFileNm}
+                      {file.esntlAtchYn === "Y" ? (
+                        <span className="ml-1 text-red-500">*</span>
+                      ) : null}
+                    </TableCell>
+                    <TableCell className="text-left">
+                      {file.atflCd ? (
+                        <a
+                          className="cursor-pointer text-blue-600 hover:underline"
+                          onClick={() => downloadAttachment(file.atflCd ?? "")}
+                          target="_blank"
+                          rel="noreferrer"
+                        >
+                          {file.orgnlFileNm || "다운로드"}
+                        </a>
+                      ) : (
+                        <span className="text-gray-500">첨부없음</span>
+                      )}
+                    </TableCell>
+                    <TableCell className="text-right">{formatFileSize(file.atflFlieSz)}</TableCell>
+                  </TableRow>
+                ))}
+              </TableBody>
+            </Table>
+          </div>
+        </SectionCollapsible>
+      )}
+
+      <SectionCollapsible title="기타 첨부파일">
+        <div className="overflow-x-auto">
+          <Table variant="secondary">
+            <TableHeader>
+              <TableRow>
+                <TableHead>파일명</TableHead>
+                <TableHead className="w-[8rem] text-right">크기</TableHead>
+              </TableRow>
+            </TableHeader>
+            <TableBody>
+              {etcFileList.length === 0 ? (
+                <TableRow>
+                  <TableCell colSpan={2} className="py-12 text-center text-muted-foreground">
+                    등록된 기타첨부파일이 없습니다.
+                  </TableCell>
+                </TableRow>
+              ) : (
+                etcFileList.map((file) => (
+                  <TableRow key={file.atflId}>
+                    <TableCell className="text-left">
+                      {file.atflCd ? (
+                        <a
+                          className="cursor-pointer text-blue-600 hover:underline"
+                          onClick={() => downloadAttachment(file.atflCd)}
+                          target="_blank"
+                          rel="noreferrer"
+                        >
+                          {file.orgnlFileNm || file.physFileNm || file.atflId}
+                        </a>
+                      ) : (
+                        <span>{file.orgnlFileNm || file.physFileNm || file.atflId}</span>
+                      )}
+                    </TableCell>
+                    <TableCell className="text-right text-gray-500">
+                      {formatFileSize(file.atflFlieSz)}
+                    </TableCell>
+                  </TableRow>
+                ))
+              )}
+            </TableBody>
+          </Table>
+        </div>
+      </SectionCollapsible>
+    </>
+  );
+}
+
+export { AttachmentsSection };

apps/as/src/pages/design-cnstn/ui/sections/basic-info-form-section.tsx

@@ -0,0 +1,159 @@
+"use client";
+
+import { useState } from "react";
+import { Controller, useFormContext } from "react-hook-form";
+
+import { useUserStore } from "@/shared/lib";
+import { Field, FieldError, FieldGroup } from "@/shared/ui/field";
+import { findCodeLabel, useCodeList } from "@/entities/code";
+import { type BnsApplyData, BnsPickerDialog } from "@/widgets/bns-picker";
+import { SectionCollapsible } from "@/widgets/pbadms-sprt";
+import {
+  Button,
+  Input,
+  Table,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+} from "@common/components";
+
+import type { DesignCnstnRegistFormData } from "../../lib/design-cnstn-regist-schema";
+
+function BasicInfoFormSection() {
+  const userInfo = useUserStore((state) => state.userInfo);
+  const { control, watch, setValue } = useFormContext<DesignCnstnRegistFormData>();
+  const [isPickerOpen, setIsPickerOpen] = useState(false);
+  const taskSeComCd = watch("designCnstnMng.taskSeComCd");
+  const { data: taskOptions } = useCodeList("CNFM");
+
+  function handleBnsSelect(data: BnsApplyData) {
+    setValue("designCnstnMng.bizNm", data.bizNm);
+    setValue("designCnstnMng.bizBgngYr", data.bizBgngYr);
+    setValue("designCnstnMng.bizEndYr", data.bizEndYr);
+    setValue("designCnstnMng.bizCn", data.bizCn);
+  }
+
+  const taskSeComCdLabel =
+    taskSeComCd
+      .map((code) => findCodeLabel(taskOptions, code))
+      .filter(Boolean)
+      .join(", ") || "-";
+
+  return (
+    <SectionCollapsible title="기본 정보">
+      <Table variant="secondary">
+        <colgroup>
+          <col width="15%" />
+          <col width="35%" />
+          <col width="15%" />
+          <col width="35%" />
+        </colgroup>
+        <TableHeader>
+          <TableRow>
+            <TableHead className="w-[20rem]" data-required>
+              사업명
+            </TableHead>
+            <TableCell colSpan={3}>
+              <Controller
+                name="designCnstnMng.bizNm"
+                control={control}
+                render={({ field, fieldState }) => (
+                  <Field data-invalid={fieldState.invalid}>
+                    <div className="flex gap-2">
+                      <Input
+                        {...field}
+                        id={field.name}
+                        placeholder="사업명 입력"
+                        aria-invalid={fieldState.invalid}
+                        className="w-[40rem]"
+                      />
+                      <Button type="button" onClick={() => setIsPickerOpen(true)}>
+                        사업찾기
+                      </Button>
+                    </div>
+                    <FieldError errors={[fieldState.error]} />
+                  </Field>
+                )}
+              />
+            </TableCell>
+          </TableRow>
+          <TableRow>
+            <TableHead data-required>사업기간</TableHead>
+            <TableCell colSpan={3}>
+              <FieldGroup className="flex-row items-center gap-2">
+                <Controller
+                  name="designCnstnMng.bizBgngYr"
+                  control={control}
+                  render={({ field, fieldState }) => (
+                    <Field data-invalid={fieldState.invalid} className="w-auto">
+                      <Input
+                        {...field}
+                        id={field.name}
+                        placeholder="시작연도"
+                        className="max-w-[12rem]"
+                        aria-invalid={fieldState.invalid}
+                      />
+                      <FieldError errors={[fieldState.error]} />
+                    </Field>
+                  )}
+                />
+                <span>~</span>
+                <Controller
+                  name="designCnstnMng.bizEndYr"
+                  control={control}
+                  render={({ field, fieldState }) => (
+                    <Field data-invalid={fieldState.invalid} className="w-auto">
+                      <Input
+                        {...field}
+                        id={field.name}
+                        placeholder="종료연도"
+                        className="max-w-[12rem]"
+                        aria-invalid={fieldState.invalid}
+                      />
+                      <FieldError errors={[fieldState.error]} />
+                    </Field>
+                  )}
+                />
+              </FieldGroup>
+            </TableCell>
+          </TableRow>
+          <TableRow>
+            <TableHead data-required>사업내용</TableHead>
+            <TableCell colSpan={3}>
+              <Controller
+                name="designCnstnMng.bizCn"
+                control={control}
+                render={({ field, fieldState }) => (
+                  <Field data-invalid={fieldState.invalid}>
+                    <Input
+                      {...field}
+                      id={field.name}
+                      placeholder="사업내용 입력"
+                      aria-invalid={fieldState.invalid}
+                    />
+                    <FieldError errors={[fieldState.error]} />
+                  </Field>
+                )}
+              />
+            </TableCell>
+          </TableRow>
+          <TableRow>
+            <TableHead data-required>구분</TableHead>
+            <TableCell>{taskSeComCdLabel}</TableCell>
+            <TableHead>신청 지자체</TableHead>
+            <TableCell>{userInfo?.instSeNm}</TableCell>
+          </TableRow>
+        </TableHeader>
+      </Table>
+
+      <BnsPickerDialog
+        open={isPickerOpen}
+        onClose={() => setIsPickerOpen(false)}
+        onSelect={handleBnsSelect}
+      />
+    </SectionCollapsible>
+  );
+}
+
+export { BasicInfoFormSection };

apps/as/src/pages/design-cnstn/ui/sections/basic-info-section.tsx

@@ -0,0 +1,50 @@
+"use client";
+
+import type { DesignCnstnMngResponseDto } from "@/entities/design-cnstn";
+import { SectionCollapsible } from "@/widgets/pbadms-sprt";
+import { Table, TableCell, TableHead, TableHeader, TableRow } from "@common/components";
+
+interface BasicInfoSectionProps {
+  det: DesignCnstnMngResponseDto;
+}
+
+function BasicInfoSection({ det }: BasicInfoSectionProps) {
+  return (
+    <SectionCollapsible title="기본 정보">
+      <Table variant="secondary">
+        <colgroup>
+          <col width="15%" />
+          <col width="35%" />
+          <col width="15%" />
+          <col width="35%" />
+        </colgroup>
+        <TableHeader>
+          <TableRow>
+            <TableHead>사업명</TableHead>
+            <TableCell>{det.bizNm || "-"}</TableCell>
+            <TableHead>사업기간</TableHead>
+            <TableCell>{(det.bizBgngYr || "-") + " ~ " + (det.bizEndYr || "-")}</TableCell>
+          </TableRow>
+          <TableRow>
+            <TableHead>사업내용</TableHead>
+            <TableCell colSpan={3}>{det.bizCn || "-"}</TableCell>
+          </TableRow>
+          <TableRow>
+            <TableHead>환경청구분</TableHead>
+            <TableCell>{det.envoSeCdNm || "-"}</TableCell>
+            <TableHead>구분</TableHead>
+            <TableCell>{det.taskSeCdNm || "-"}</TableCell>
+          </TableRow>
+          <TableRow>
+            <TableHead>신청지자체</TableHead>
+            <TableCell colSpan={3}>
+              {det.sido || "-"} {det.gugun || "-"}
+            </TableCell>
+          </TableRow>
+        </TableHeader>
+      </Table>
+    </SectionCollapsible>
+  );
+}
+
+export { BasicInfoSection };

apps/as/src/pages/design-cnstn/ui/sections/business-scale-section.tsx

@@ -0,0 +1,70 @@
+"use client";
+
+import type { BizSclTreeDto } from "@/entities/design-cnstn";
+import { fmtNumber, indentPx, SectionCollapsible } from "@/widgets/pbadms-sprt";
+import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "@common/components";
+
+interface BusinessScaleSectionProps {
+  bizSclList: BizSclTreeDto[];
+}
+
+function BusinessScaleSection({ bizSclList }: BusinessScaleSectionProps) {
+  return (
+    <SectionCollapsible title="사업규모">
+      <div className="overflow-x-auto">
+        <Table variant="secondary">
+          <TableHeader>
+            <TableRow>
+              <TableHead className="w-[30rem]">구분</TableHead>
+              <TableHead>기본계획(A)</TableHead>
+              <TableHead>예산반영(B)</TableHead>
+              <TableHead>금회설계시(C)</TableHead>
+              <TableHead>증감(C-B)</TableHead>
+            </TableRow>
+          </TableHeader>
+          <TableBody>
+            {bizSclList.length === 0 ? (
+              <TableRow>
+                <TableCell colSpan={5} className="py-12 text-center text-muted-foreground">
+                  조회된 사업규모 항목이 없습니다.
+                </TableCell>
+              </TableRow>
+            ) : (
+              bizSclList.map((node) => {
+                const pl = indentPx(node.indCnstpSeCdNm);
+                const bscPlanQty = Number(node.bscPlanQty) || 0;
+                const budgetReflct = Number(node.bgtRfltQty) || 0;
+                const tstmDesignQty = Number(node.tstmDesignQty) || 0;
+                const diff = tstmDesignQty - budgetReflct;
+
+                return (
+                  <TableRow key={node.cnstpSeCd}>
+                    <TableHead className="text-left" style={{ paddingLeft: `${pl + 8}px` }}>
+                      {node.cnstpSeCdNm}
+                    </TableHead>
+                    <TableCell>
+                      <div className="text-right">{fmtNumber(bscPlanQty)}</div>
+                    </TableCell>
+                    <TableCell>
+                      <div className="text-right">{fmtNumber(budgetReflct)}</div>
+                    </TableCell>
+                    <TableCell>
+                      <div className="text-right">{fmtNumber(tstmDesignQty)}</div>
+                    </TableCell>
+                    <TableCell>
+                      <div className="text-right">
+                        {diff > 0 ? `+${fmtNumber(diff)}` : fmtNumber(diff)}
+                      </div>
+                    </TableCell>
+                  </TableRow>
+                );
+              })
+            )}
+          </TableBody>
+        </Table>
+      </div>
+    </SectionCollapsible>
+  );
+}
+
+export { BusinessScaleSection };

apps/as/src/pages/design-cnstn/ui/sections/contact-info-section.tsx

@@ -0,0 +1,56 @@
+"use client";
+
+import type { DesignCnstnMngResponseDto } from "@/entities/design-cnstn";
+import { SectionCollapsible } from "@/widgets/pbadms-sprt";
+import { Table, TableCell, TableHead, TableHeader, TableRow } from "@common/components";
+
+interface ContactInfoSectionProps {
+  det: DesignCnstnMngResponseDto;
+}
+
+function ContactInfoSection({ det }: ContactInfoSectionProps) {
+  return (
+    <SectionCollapsible title="담당자 정보">
+      <Table variant="secondary">
+        <TableHeader>
+          {det.aplcntNm && (
+            <>
+              <TableRow>
+                <TableHead rowSpan={2}>신청자</TableHead>
+                <TableHead>이름</TableHead>
+                <TableCell>{det.aplcntNm || "-"}</TableCell>
+                <TableHead>연락처</TableHead>
+                <TableCell>{det.aplcntMblTelno || "-"}</TableCell>
+              </TableRow>
+              <TableRow>
+                <TableHead>소속</TableHead>
+                <TableCell>{det.aplcntOgdpNm || "-"}</TableCell>
+                <TableHead>이메일</TableHead>
+                <TableCell>{det.aplcntEmlAddr || "-"}</TableCell>
+              </TableRow>
+            </>
+          )}
+          {det.dsgnrNm && (
+            <>
+              <TableRow>
+                <TableHead rowSpan={2}>설계자</TableHead>
+                <TableHead>이름</TableHead>
+                <TableCell>{det.dsgnrNm || "-"}</TableCell>
+                <TableHead>연락처</TableHead>
+                <TableCell>{det.dsgnrTelno || "-"}</TableCell>
+              </TableRow>
+              <TableRow>
+                <TableHead>소속</TableHead>
+                <TableCell>{det.dsgnrOgdpNm || "-"}</TableCell>
+                <TableHead>이메일</TableHead>
+                <TableCell>{det.dsgnrEmlAddr || "-"}</TableCell>
+              </TableRow>
+            </>
+          )}
+        </TableHeader>
+      </Table>
+    </SectionCollapsible>
+  );
+}
+
+export { ContactInfoSection };

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

@@ -0,0 +1,342 @@
+"use client";
+
+import { forwardRef, useEffect, useImperativeHandle, useState } from "react";
+
+import { PROXY_HOST } from "@/shared/config";
+import { dayjs, getDefaultFileKey, useTus } from "@/shared/lib";
+import { Field, FieldLabel, FieldSet } from "@/shared/ui/field";
+import { attachService } from "@/entities/attach";
+import type { DesignCnstnRvwOpnnResponseDto } from "@/entities/design-cnstn";
+import { SectionCollapsible } from "@/widgets/pbadms-sprt";
+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 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">
+                    <span className="text-xl">{uploadedFile.fileName}</span>
+                    <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 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 ? (
+                  <a
+                    className="text-blue-600 hover:underline"
+                    href={`${PROXY_HOST}/attach-service/api/v1/atflcd/download/${item.atchFileInfo.atflCd}`}
+                    target="_blank"
+                    rel="noreferrer"
+                  >
+                    {item.atchFileInfo.orgnlFileNm || "다운로드"}
+                  </a>
+                ) : (
+                  "-"
+                )}
+              </TableCell>
+              <TableCell align="center">
+                {item.regDt ? dayjs(item.regDt).format("YYYY-MM-DD HH:mm:ss") : "-"}
+              </TableCell>
+            </TableRow>
+          ))}
+        </TableBody>
+      </Table>
+    </div>
+  );
+}
+
+export { TechReviewOpinionSection };

apps/as/src/pages/fnrs-cnsltn/ui/components/floating-action-buttons.tsx

@@ -26,7 +26,6 @@ import {
   type FnrsCnsltnMngDetResponseDto,
   fnrsCnsltnMngService,
 } from "@/entities/fnrs-cnsltn";
-import { useRvwMnpwMngLoginUserList } from "@/entities/rvw-mnpw";
 import { SplmntDmndDialog, type SplmntDmndDialogConfirmPayload } from "@/widgets/pbadms-sprt";
 import { Button } from "@common/components";
 
@@ -52,6 +51,8 @@ interface FloatingActionButtonsProps {
   fnrsCnsltnDocNo: string;
   prgrsSttsComCd: string;
   dtlInstCd: string | undefined;
+  atrzSeComCdList: string[];
+  isRvwLoginUserLoading: boolean;
   checklistFormState: ChecklistFormState;
   techReviewOpinionRef?: React.RefObject<TechReviewOpinionSectionHandle | null>;
   opnrNm?: string;
@@ -65,6 +66,8 @@ function FloatingActionButtons({
   fnrsCnsltnDocNo,
   prgrsSttsComCd,
   dtlInstCd,
+  atrzSeComCdList,
+  isRvwLoginUserLoading,
   checklistFormState,
   techReviewOpinionRef,
   opnrNm,
@@ -82,18 +85,9 @@ function FloatingActionButtons({
 
   const needsAtrzResolve = needsRoleUser01AtrzResolve(dtlInstCd, prgrsSttsComCd);
   const needsTeApprovalCheck = needsAtrzResolve && prgrsSttsComCd === "TE";
-  const { data: rvwLoginUserData, isLoading: isRvwLoginUserLoading } = useRvwMnpwMngLoginUserList(
-    {},
-    { enabled: needsAtrzResolve },
-  );
   const { data: elaprDocPrgrsList = [], isLoading: isElaprDocPrgrsLoading } =
     useElaprDocPrgrsByDocNo(needsTeApprovalCheck ? docNo : null);
 
-  const atrzSeComCdList = useMemo(
-    () => rvwLoginUserData?.content?.map((item) => item.atrzSeComCd) ?? [],
-    [rvwLoginUserData],
-  );
-
   const hasPendingApprovalRequest = hasCurrentUserPendingApprovalRequest(
     elaprDocPrgrsList,
     userInfo?.userUnqId,

apps/as/src/pages/fnrs-cnsltn/ui/fnrs-view-page.tsx

@@ -1,13 +1,15 @@
 "use client";
 
-import { useRef } from "react";
+import { useMemo, useRef } from "react";
 
 import { useUserStore } from "@/shared/lib";
 import { ElaprDocPrgrsStatus } from "@/entities/elapr";
 import { useFnrsCnsltnMng } from "@/entities/fnrs-cnsltn";
+import { useRvwMnpwMngLoginUserList } from "@/entities/rvw-mnpw";
 import { SectionCollapsible, 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";
 
@@ -35,6 +37,17 @@ function FnrsViewPage({ id }: FnrsViewPageProps) {
   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">
@@ -96,6 +109,8 @@ function FnrsViewPage({ id }: FnrsViewPageProps) {
         ref={techReviewOpinionRef}
         rvwList={rvwList}
         editableReviewStep={editableReviewStep}
+        atrzSeComCdList={atrzSeComCdList}
+        isAtrzLoading={needsAtrzResolve && isRvwLoginUserLoading}
       />
       <FloatingActionButtons
         data={data}
@@ -103,6 +118,8 @@ function FnrsViewPage({ id }: FnrsViewPageProps) {
         fnrsCnsltnDocNo={detDto.fnrsCnsltnDocNo}
         prgrsSttsComCd={detDto.prgrsSttsComCd || ""}
         dtlInstCd={userInfo?.dtlInstCd}
+        atrzSeComCdList={atrzSeComCdList}
+        isRvwLoginUserLoading={needsAtrzResolve && isRvwLoginUserLoading}
         checklistFormState={checklistFormState}
         techReviewOpinionRef={techReviewOpinionRef}
         opnrNm={userInfo?.userName}

apps/as/src/pages/fnrs-cnsltn/ui/sections/basic-info-section.tsx

@@ -12,6 +12,12 @@ function BasicInfoSection({ det }: BasicInfoSectionProps) {
   return (
     <SectionCollapsible title="기본 정보">
       <Table variant="secondary">
+        <colgroup>
+          <col width="15%" />
+          <col width="35%" />
+          <col width="15%" />
+          <col width="35%" />
+        </colgroup>
         <TableHeader>
           <TableRow>
             <TableHead>사업명</TableHead>

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

@@ -33,6 +33,8 @@ const RVW_OPNN_FILE_KEY_PREFIX = "rvw-opnn::";
 interface TechReviewOpinionSectionProps {
   rvwList: FnrsCnsltnRvwOpnnResponseDto[];
   editableReviewStep?: ReviewStepCode;
+  atrzSeComCdList?: string[];
+  isAtrzLoading?: boolean;
 }
 
 export interface TechReviewOpinionSectionHandle {
@@ -69,7 +71,13 @@ function hasFormContent(formData: ReviewOpinionFormData) {
 const TechReviewOpinionSection = forwardRef<
   TechReviewOpinionSectionHandle,
   TechReviewOpinionSectionProps
->(function TechReviewOpinionSection({ rvwList, editableReviewStep }, ref) {
+>(function TechReviewOpinionSection({
+  rvwList,
+  editableReviewStep,
+  atrzSeComCdList = [],
+  isAtrzLoading = false,
+}, ref) {
+  const canWriteKecoOpinion = !isAtrzLoading && atrzSeComCdList.includes("ATRZ02");
   const [formData, setFormData] = useState<ReviewOpinionFormData>({
     ...EMPTY_FORM_DATA,
     opnrSeComCd: editableReviewStep ?? "",
@@ -102,6 +110,9 @@ const TechReviewOpinionSection = forwardRef<
         if (!editableReviewStep || !hasFormContent(formData)) {
           return null;
         }
+        if (editableReviewStep === "KECO" && !canWriteKecoOpinion) {
+          return null;
+        }
 
         return {
           formData: {
@@ -119,14 +130,15 @@ const TechReviewOpinionSection = forwardRef<
         setUploadedFile(null);
       },
     }),
-    [editableReviewStep, formData, rvwList],
+    [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";
+  const hasKecoSection =
+    kecoRvwList.length > 0 || (editableReviewStep === "KECO" && canWriteKecoOpinion);
 
   if (!hasEnvSection && !hasKecoSection) {
     return null;
@@ -170,6 +182,7 @@ const TechReviewOpinionSection = forwardRef<
 
   function renderOpinionForm(reviewStep: ReviewStepCode) {
     if (editableReviewStep !== reviewStep) return null;
+    if (reviewStep === "KECO" && !canWriteKecoOpinion) return null;
 
     const uploading = uploadedFile ? (isUploading[uploadedFile.fileKey] ?? false) : false;
 

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

@@ -26,7 +26,6 @@ import {
   type InstlSncnMngDetResponse,
   instlSncnService,
 } from "@/entities/instl-sncn";
-import { useRvwMnpwMngLoginUserList } from "@/entities/rvw-mnpw";
 import { SplmntDmndDialog, type SplmntDmndDialogConfirmPayload } from "@/widgets/pbadms-sprt";
 import { Button } from "@common/components";
 
@@ -52,6 +51,8 @@ interface FloatingActionButtonsProps {
   instlSncnDocNo: string;
   prgrsSttsComCd: string;
   dtlInstCd: string | undefined;
+  atrzSeComCdList: string[];
+  isRvwLoginUserLoading: boolean;
   checklistFormState: ChecklistFormState;
   techReviewOpinionRef?: React.RefObject<TechReviewOpinionSectionHandle | null>;
   opnrNm?: string;
@@ -65,6 +66,8 @@ function FloatingActionButtons({
   instlSncnDocNo,
   prgrsSttsComCd,
   dtlInstCd,
+  atrzSeComCdList,
+  isRvwLoginUserLoading,
   checklistFormState,
   techReviewOpinionRef,
   opnrNm,
@@ -82,18 +85,9 @@ function FloatingActionButtons({
 
   const needsAtrzResolve = needsRoleUser01AtrzResolve(dtlInstCd, prgrsSttsComCd);
   const needsTeApprovalCheck = needsAtrzResolve && prgrsSttsComCd === "TE";
-  const { data: rvwLoginUserData, isLoading: isRvwLoginUserLoading } = useRvwMnpwMngLoginUserList(
-    {},
-    { enabled: needsAtrzResolve },
-  );
   const { data: elaprDocPrgrsList = [], isLoading: isElaprDocPrgrsLoading } =
     useElaprDocPrgrsByDocNo(needsTeApprovalCheck ? docNo : null);
 
-  const atrzSeComCdList = useMemo(
-    () => rvwLoginUserData?.content?.map((item) => item.atrzSeComCd) ?? [],
-    [rvwLoginUserData],
-  );
-
   const hasPendingApprovalRequest = hasCurrentUserPendingApprovalRequest(
     elaprDocPrgrsList,
     userInfo?.userUnqId,

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

@@ -1,13 +1,15 @@
 "use client";
 
-import { useRef } from "react";
+import { useMemo, useRef } from "react";
 
 import { useUserStore } from "@/shared/lib";
 import { ElaprDocPrgrsStatus } from "@/entities/elapr";
 import { useInstlSncnDetail } from "@/entities/instl-sncn";
+import { useRvwMnpwMngLoginUserList } from "@/entities/rvw-mnpw";
 import { SectionCollapsible, 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";
 
@@ -34,6 +36,17 @@ function InstlViewPage({ id }: InstlViewPageProps) {
   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">
@@ -94,6 +107,8 @@ function InstlViewPage({ id }: InstlViewPageProps) {
         ref={techReviewOpinionRef}
         rvwList={rvwList}
         editableReviewStep={editableReviewStep}
+        atrzSeComCdList={atrzSeComCdList}
+        isAtrzLoading={needsAtrzResolve && isRvwLoginUserLoading}
       />
       <SupplementDemandSection splmntDmndList={splmntDmndList} />
       <FloatingActionButtons
@@ -102,6 +117,8 @@ function InstlViewPage({ id }: InstlViewPageProps) {
         instlSncnDocNo={detDto.instlSncnDocNo}
         prgrsSttsComCd={detDto.prgrsSttsComCd || ""}
         dtlInstCd={userInfo?.dtlInstCd}
+        atrzSeComCdList={atrzSeComCdList}
+        isRvwLoginUserLoading={needsAtrzResolve && isRvwLoginUserLoading}
         checklistFormState={checklistFormState}
         techReviewOpinionRef={techReviewOpinionRef}
         opnrNm={userInfo?.userName}

apps/as/src/pages/instl-sncn/ui/sections/basic-info-section.tsx

@@ -12,6 +12,12 @@ function BasicInfoSection({ det }: BasicInfoSectionProps) {
   return (
     <SectionCollapsible title="기본 정보">
       <Table variant="secondary">
+        <colgroup>
+          <col width="15%" />
+          <col width="35%" />
+          <col width="15%" />
+          <col width="35%" />
+        </colgroup>
         <TableHeader>
           <TableRow>
             <TableHead>사업명</TableHead>

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

@@ -29,6 +29,8 @@ const RVW_OPNN_FILE_KEY_PREFIX = "rvw-opnn::";
 interface TechReviewOpinionSectionProps {
   rvwList: InstlSncnRvwOpnnResponseDto[];
   editableReviewStep?: ReviewStepCode;
+  atrzSeComCdList?: string[];
+  isAtrzLoading?: boolean;
 }
 
 export interface TechReviewOpinionSectionHandle {
@@ -65,7 +67,13 @@ function hasFormContent(formData: ReviewOpinionFormData) {
 const TechReviewOpinionSection = forwardRef<
   TechReviewOpinionSectionHandle,
   TechReviewOpinionSectionProps
->(function TechReviewOpinionSection({ rvwList, editableReviewStep }, ref) {
+>(function TechReviewOpinionSection({
+  rvwList,
+  editableReviewStep,
+  atrzSeComCdList = [],
+  isAtrzLoading = false,
+}, ref) {
+  const canWriteKecoOpinion = !isAtrzLoading && atrzSeComCdList.includes("ATRZ02");
   const [formData, setFormData] = useState<ReviewOpinionFormData>({
     ...EMPTY_FORM_DATA,
     opnrSeComCd: editableReviewStep ?? "",
@@ -98,6 +106,9 @@ const TechReviewOpinionSection = forwardRef<
         if (!editableReviewStep || !hasFormContent(formData)) {
           return null;
         }
+        if (editableReviewStep === "KECO" && !canWriteKecoOpinion) {
+          return null;
+        }
 
         return {
           ...formData,
@@ -112,14 +123,15 @@ const TechReviewOpinionSection = forwardRef<
         setUploadedFile(null);
       },
     }),
-    [editableReviewStep, formData],
+    [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";
+  const hasKecoSection =
+    kecoRvwList.length > 0 || (editableReviewStep === "KECO" && canWriteKecoOpinion);
 
   if (!hasEnvSection && !hasKecoSection) {
     return null;
@@ -163,6 +175,7 @@ const TechReviewOpinionSection = forwardRef<
 
   function renderOpinionForm(reviewStep: ReviewStepCode) {
     if (editableReviewStep !== reviewStep) return null;
+    if (reviewStep === "KECO" && !canWriteKecoOpinion) return null;
 
     const uploading = uploadedFile ? (isUploading[uploadedFile.fileKey] ?? false) : false;
 

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

@@ -17,6 +17,11 @@ export const ENDPOINT = {
     ADSTDSTR: "/as-service/api/v1/adstdstr",
     FNRS_CNSLTN_MNG: "/as-service/api/v1/fnrs-cnsltn-mng",
     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",
+    DESIGN_CNSTN_BIZ_SCL: "/as-service/api/v1/design-cnstn-biz-scl",
+    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",
   },
   USER_SERVICE: {
     LOGIN: "/user-service/login",

apps/as/src/widgets/pbadms-sprt/lib/attachments-form-utils.ts

@@ -1,6 +1,6 @@
 import { getDefaultFileKey } from "@/shared/lib";
 
-export type FieldPrefix = "fnrsCnsltnMng" | "instlSncnMng";
+export type FieldPrefix = "fnrsCnsltnMng" | "instlSncnMng" | "designCnstnMng";
 
 export const ETC_FILE_KEY_PREFIX = "etc::";
 

apps/as/src/widgets/pbadms-sprt/ui/checklist-form-section.tsx

@@ -29,7 +29,7 @@ import { buildChecklistTabs, syncCklstResultListFromTree } from "../lib/checklis
 
 import { SectionCollapsible } from "./section-collapsible";
 
-type FieldPrefix = "fnrsCnsltnMng" | "instlSncnMng";
+type FieldPrefix = "fnrsCnsltnMng" | "instlSncnMng" | "designCnstnMng";
 
 interface CklstResultListItem {
   cklstSn: number;

apps/as/src/widgets/pbadms-sprt/ui/contact-info-form-section.tsx

@@ -7,7 +7,7 @@ import { Field, FieldError } from "@/shared/ui/field";
 import { SectionCollapsible } from "@/widgets/pbadms-sprt";
 import { Input, Table, TableCell, TableHead, TableHeader, TableRow } from "@common/components";
 
-type FieldPrefix = "fnrsCnsltnMng" | "instlSncnMng";
+type FieldPrefix = "fnrsCnsltnMng" | "instlSncnMng" | "designCnstnMng";
 
 interface ContactInfoFormSectionProps {
   fieldPrefix: FieldPrefix;

apps/as/tsconfig.json

@@ -22,6 +22,12 @@
       "@/*": ["./src/*"]
     }
   },
-  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
-  "exclude": ["node_modules"]
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    "../../packages/common/types/**/*.d.ts"
+  ],
+  "exclude": ["node_modules", ".next", "dist", "coverage", "storybook-static", "public"]
 }

apps/cm/app/(auth)/layout.tsx

@@ -0,0 +1,17 @@
+import "@/app/styles/base.css";
+
+export const metadata = {
+  title: "유역하수도 포탈",
+};
+
+export default function AuthLayout({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
+  return (
+    <html lang="ko">
+      <body>{children}</body>
+    </html>
+  );
+}

apps/cm/app/(main)/layout.tsx

@@ -2,7 +2,7 @@ import type { Metadata } from "next";
 import { App } from "@/app";
 
 export const metadata: Metadata = {
-  title: "유역하수도 통합 정보플랫폼",
+  title: "유역하수도 포탈",
 };
 
 export default App;

apps/cm/app/api/auth/logout/route.ts

@@ -1,17 +1,9 @@
 import { cookies } from "next/headers";
 import { NextResponse } from "next/server";
-import {
-  ACCESS_TOKEN,
-  AUTH_USER_ID,
-  CLAIM_NAME,
-  REFRESH_TOKEN,
-} from "@/shared/config";
+import { COOKIE_DOMAIN, REFRESH_TOKEN } from "@/shared/config";
 
 export async function POST() {
   const cookieStore = await cookies();
-  cookieStore.delete(ACCESS_TOKEN);
-  cookieStore.delete(REFRESH_TOKEN);
-  cookieStore.delete(AUTH_USER_ID);
-  cookieStore.delete(CLAIM_NAME);
+  cookieStore.delete({ name: REFRESH_TOKEN, domain: COOKIE_DOMAIN });
   return NextResponse.json({ message: "Logged out" }, { status: 200 });
 }

apps/cm/app/global-not-found.tsx

@@ -0,0 +1,46 @@
+import type { Metadata } from "next";
+import Image from "next/image";
+
+import "@/app/styles/base.css";
+import "@/app/styles/components.css";
+
+export const metadata: Metadata = {
+  title: "유역하수도 포탈",
+  description: "페이지가 존재하지 않습니다. 관리자에게 문의하여 주십시오.",
+};
+
+export default function GlobalNotFound() {
+  return (
+    <html lang="ko">
+      <body>
+        <main className="flex min-h-screen flex-col items-center justify-center bg-[#f0f4f8] px-4 py-16">
+          <div className="mb-16 text-center">
+            <h1 className="text-[3.2rem] font-bold leading-snug tracking-tight">
+              <span className="text-primary">유역하수도 포탈</span>에 오신 것을
+              환영합니다.
+            </h1>
+            <p className="mt-6 text-[2rem] text-[#666]">
+              오류가 발생하였습니다.
+            </p>
+          </div>
+
+          <section className="card card-border flex w-full max-w-[72rem] flex-col items-center !rounded-2xl !py-16">
+            <Image
+              src="/images/magnifying-glass-with-warning.png"
+              alt=""
+              width={280}
+              height={280}
+              className="size-[28rem] object-contain"
+            />
+            <p className="mt-4 text-[2.4rem] font-bold text-[#444]">
+              페이지가 존재하지 않습니다.
+            </p>
+            <p className="mt-2 text-[1.6rem] text-[#666]">
+              관리자에게 문의하여 주십시오
+            </p>
+          </section>
+        </main>
+      </body>
+    </html>
+  );
+}

apps/cm/next.config.ts

@@ -7,6 +7,7 @@ const nextConfig: NextConfig = {
   output: "standalone",
   experimental: {
     proxyTimeout: 600000,
+    globalNotFound: true,
   },
   eslint: {
     ignoreDuringBuilds: true,

apps/cm/package.json

@@ -12,7 +12,7 @@
     "@common/assets": "workspace:*",
     "@common/auth": "workspace:*",
     "@common/components": "workspace:*",
-    "@common/config": "workspace:*",
+    "@common/network": "workspace:*",
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
@@ -47,7 +47,6 @@
     "sonner": "^2.0.1",
     "tailwindcss-animate": "^1.0.7",
     "tus-js-client": "^4.3.1",
-    "uuid": "^14.0.1",
     "zod": "^3.24.2",
     "zustand": "^5.0.3"
   },

apps/cm/src/entities/auth/api/auth-service.ts

@@ -5,59 +5,42 @@ import {
   ENDPOINT,
 } from "@/shared/config";
 import {
+  clearDeviceId,
+  getOrCreateDeviceId,
   type AuthPayload,
   type AuthService,
-  getRemainingMs,
 } from "@common/auth";
 
 import {
   clearRefreshTimer,
   setToken,
-  setupRefreshTimer,
   tokenManager,
 } from "../lib/token-manager";
-import { clearDeviceId } from "../lib/device-id";
-
-function resolveLoginError(message: string | undefined): string {
-  switch (message) {
-    case "Invalid Credentials":
-      return "아이디와 비밀번호가 일치하지 않습니다.";
-    case "User not found":
-      return "존재하지 않는 아이디입니다.";
-    case "User is not active":
-      return "활성화되지 않은 계정입니다.";
-    case "User is not verified":
-      return "이메일 인증이 필요합니다.";
-    default:
-      return message ?? "로그인에 실패했습니다.";
-  }
-}
 
 function completeSession(accessToken: string, tokenId: string): void {
   setToken(CLAIM_NAME, accessToken);
   setToken(AUTH_USER_ID, tokenId);
 
-  const remainingMs = getRemainingMs(accessToken);
-  if (remainingMs > 0) {
-    setupRefreshTimer(silentRefresh, remainingMs);
-  }
+  // const remainingMs = getRemainingMs(accessToken);
+  // if (remainingMs > 0) {
+  //   setupRefreshTimer(silentRefresh, remainingMs);
+  // }
 }
 
 async function login(payload: AuthPayload): Promise<void> {
   const response = await fetch(`/api/proxy${ENDPOINT.USER_SERVICE.LOGIN}`, {
     method: "POST",
-    headers: { "Content-Type": "application/json" },
+    headers: {
+      "Content-Type": "application/json",
+      "X-Device-Id": getOrCreateDeviceId(),
+    },
     body: JSON.stringify(payload),
   });
 
   const data = await response.json();
 
-  if (!response.ok) {
-    throw new Error(resolveLoginError(data?.message));
-  }
-
-  const accessToken = data[ACCESS_TOKEN] as string | undefined;
-  const tokenId = data[AUTH_USER_ID] as string | undefined;
+  const accessToken = data[ACCESS_TOKEN];
+  const tokenId = data[AUTH_USER_ID];
 
   if (!accessToken || !tokenId) {
     throw new Error("인증 토큰을 받지 못했습니다.");
@@ -71,7 +54,12 @@ async function silentRefresh(): Promise<void> {
   try {
     const response = await fetch(
       `/api/proxy${ENDPOINT.USER_SERVICE.SILENT_REFRESH}`,
-      { method: "PUT" },
+      {
+        method: "PUT",
+        headers: {
+          "X-Device-Id": getOrCreateDeviceId(),
+        },
+      },
     );
 
     const data = await response.json();
@@ -80,8 +68,8 @@ async function silentRefresh(): Promise<void> {
       throw new Error(data?.message ?? "토큰 갱신에 실패했습니다.");
     }
 
-    const accessToken = data[ACCESS_TOKEN] as string | undefined;
-    const tokenId = data[AUTH_USER_ID] as string | undefined;
+    const accessToken = data[ACCESS_TOKEN];
+    const tokenId = data[AUTH_USER_ID];
 
     if (!accessToken || !tokenId) {
       throw new Error("갱신된 인증 토큰을 받지 못했습니다.");
@@ -101,6 +89,7 @@ async function silentRefresh(): Promise<void> {
 }
 
 async function logout(): Promise<void> {
+  await fetch("/api/auth/logout", { method: "POST" });
   tokenManager.clearAuthToken();
   clearDeviceId();
 

apps/cm/src/entities/auth/lib/device-id.ts

@@ -1,20 +0,0 @@
-import { v4 as uuidv4 } from "uuid";
-
-const DEVICE_ID_KEY = "x-device-id";
-
-export function getOrCreateDeviceId(): string {
-  if (typeof window === "undefined") return "";
-
-  const existing = localStorage.getItem(DEVICE_ID_KEY);
-  if (existing) return existing;
-
-  const id = uuidv4();
-  localStorage.setItem(DEVICE_ID_KEY, id);
-  return id;
-}
-
-export function clearDeviceId(): void {
-  if (typeof window === "undefined") return;
-
-  localStorage.removeItem(DEVICE_ID_KEY);
-}

apps/cm/tailwind.config.ts

@@ -5,6 +5,7 @@ import presetConfig from "../../tailwind.config.preset";
 export default {
   presets: [presetConfig],
   content: [
+    "./app/**/*.{js,ts,jsx,tsx}",
     "./src/**/*.{js,ts,jsx,tsx}",
     "../../packages/common/components/src/ui/**/*.{js,ts,jsx,tsx}",
   ],

apps/cm/tsconfig.json

@@ -22,26 +22,23 @@
         "name": "next"
       }
     ],
-    "baseUrl": "./src",
     "paths": {
-      "@/*": ["./*"],
-      "@common/components": ["../../../packages/common/components/src/"],
-      "@common/config": ["../../../packages/common/config/dist/"],
-      "@common/network": ["../../../packages/common/network/"]
+      "@/*": ["./src/*"]
     }
   },
   "include": [
-    ".eslintrc.*",
     "next-env.d.ts",
     "**/*.ts",
     "**/*.tsx",
-    "**/*.mts",
-    "**/*.js",
-    "**/*.cjs",
-    "**/*.mjs",
-    "**/*.jsx",
-    "**/*.json",
-    ".next/types/**/*.ts"
+    ".next/types/**/*.ts",
+    "../../packages/common/types/**/*.d.ts"
   ],
-  "exclude": ["**/node_modules", "**/.*/*"]
+  "exclude": [
+    "node_modules",
+    ".next",
+    "dist",
+    "coverage",
+    "storybook-static",
+    "public"
+  ]
 }

apps/common/features/tsconfig.json

@@ -22,26 +22,17 @@
         "name": "next"
       }
     ],
-    "baseUrl": "./src",
     "paths": {
-      "@/*": ["./*"],
-      "@common/assets": ["../../../../packages/common/assets/dist/"],
-      "@common/components": ["../../../../packages/common/components/dist/"],
-      "@common/network": ["../../../../packages/common/network/"]
+      "@/*": ["./src/*"]
     }
   },
-  "include": [
-    ".eslintrc.*",
-    "next-env.d.ts",
-    "**/*.ts",
-    "**/*.tsx",
-    "**/*.mts",
-    "**/*.js",
-    "**/*.cjs",
-    "**/*.mjs",
-    "**/*.jsx",
-    "**/*.json",
-    ".next/types/**/*.ts"
-  ],
-  "exclude": ["**/node_modules", "**/.*/*"]
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": [
+    "node_modules",
+    ".next",
+    "dist",
+    "coverage",
+    "storybook-static",
+    "public"
+  ]
 }

apps/cs/package.json

@@ -45,7 +45,6 @@
     "sonner": "^2.0.1",
     "tailwindcss-animate": "^1.0.7",
     "tus-js-client": "^4.3.1",
-    "uuid": "^14.0.1",
     "zod": "^3.24.2",
     "zustand": "^5.0.3"
   },

apps/cs/src/entities/auth/api/auth-service.ts

@@ -7,32 +7,16 @@ import {
 import {
   type AuthPayload,
   type AuthService,
-  getRemainingMs,
+  clearDeviceId,
+  getOrCreateDeviceId,
 } from "@common/auth";
 
-import { clearDeviceId, getOrCreateDeviceId } from "../lib/device-id";
 import {
   clearRefreshTimer,
   setToken,
-  setupRefreshTimer,
   tokenManager,
 } from "../lib/token-manager";
 
-function resolveLoginError(message: string | undefined): string {
-  switch (message) {
-    case "Invalid Credentials":
-      return "아이디와 비밀번호가 일치하지 않습니다.";
-    case "User not found":
-      return "존재하지 않는 아이디입니다.";
-    case "User is not active":
-      return "활성화되지 않은 계정입니다.";
-    case "User is not verified":
-      return "이메일 인증이 필요합니다.";
-    default:
-      return message ?? "로그인에 실패했습니다.";
-  }
-}
-
 async function login(payload: AuthPayload): Promise<void> {
   const response = await fetch(`/api/proxy${ENDPOINT.USER_SERVICE.LOGIN}`, {
     method: "POST",
@@ -45,12 +29,8 @@ async function login(payload: AuthPayload): Promise<void> {
 
   const data = await response.json();
 
-  if (!response.ok) {
-    throw new Error(resolveLoginError(data?.message));
-  }
-
-  const accessToken = data[ACCESS_TOKEN] as string | undefined;
-  const tokenId = data[AUTH_USER_ID] as string | undefined;
+  const accessToken = data[ACCESS_TOKEN];
+  const tokenId = data[AUTH_USER_ID];
 
   if (!accessToken || !tokenId) {
     throw new Error("인증 토큰을 받지 못했습니다.");
@@ -59,10 +39,10 @@ async function login(payload: AuthPayload): Promise<void> {
   setToken(CLAIM_NAME, accessToken);
   setToken(AUTH_USER_ID, tokenId);
 
-  const remainingMs = getRemainingMs(accessToken);
-  if (remainingMs > 0) {
-    setupRefreshTimer(silentRefresh, remainingMs);
-  }
+  // const remainingMs = getRemainingMs(accessToken);
+  // if (remainingMs > 0) {
+  //   setupRefreshTimer(silentRefresh, remainingMs);
+  // }
 }
 
 async function silentRefresh(): Promise<void> {
@@ -84,8 +64,8 @@ async function silentRefresh(): Promise<void> {
       throw new Error(data?.message ?? "토큰 갱신에 실패했습니다.");
     }
 
-    const accessToken = data[ACCESS_TOKEN] as string | undefined;
-    const tokenId = data[AUTH_USER_ID] as string | undefined;
+    const accessToken = data[ACCESS_TOKEN];
+    const tokenId = data[AUTH_USER_ID];
 
     if (!accessToken || !tokenId) {
       throw new Error("갱신된 인증 토큰을 받지 못했습니다.");
@@ -94,10 +74,10 @@ async function silentRefresh(): Promise<void> {
     setToken(CLAIM_NAME, accessToken);
     setToken(AUTH_USER_ID, tokenId);
 
-    const remainingMs = getRemainingMs(accessToken);
-    if (remainingMs > 0) {
-      setupRefreshTimer(silentRefresh, remainingMs);
-    }
+    // const remainingMs = getRemainingMs(accessToken);
+    // if (remainingMs > 0) {
+    //   setupRefreshTimer(silentRefresh, remainingMs);
+    // }
   } catch (error) {
     console.error(
       `[silentRefresh] Failed at ${new Date().toISOString()}`,

apps/cs/src/entities/auth/lib/device-id.ts

@@ -1,20 +0,0 @@
-import { v4 as uuidv4 } from "uuid";
-
-const DEVICE_ID_KEY = "x-device-id";
-
-export function getOrCreateDeviceId(): string {
-  if (typeof window === "undefined") return "";
-
-  const existing = localStorage.getItem(DEVICE_ID_KEY);
-  if (existing) return existing;
-
-  const id = uuidv4();
-  localStorage.setItem(DEVICE_ID_KEY, id);
-  return id;
-}
-
-export function clearDeviceId(): void {
-  if (typeof window === "undefined") return;
-
-  localStorage.removeItem(DEVICE_ID_KEY);
-}

apps/cs/tsconfig.json

@@ -27,17 +27,18 @@
     }
   },
   "include": [
-    ".eslintrc.*",
     "next-env.d.ts",
     "**/*.ts",
     "**/*.tsx",
-    "**/*.mts",
-    "**/*.js",
-    "**/*.cjs",
-    "**/*.mjs",
-    "**/*.jsx",
-    "**/*.json",
-    ".next/types/**/*.ts"
+    ".next/types/**/*.ts",
+    "../../packages/common/types/**/*.d.ts"
   ],
-  "exclude": ["**/node_modules", "**/.*/*"]
+  "exclude": [
+    "node_modules",
+    ".next",
+    "dist",
+    "coverage",
+    "storybook-static",
+    "public"
+  ]
 }

apps/fo/package.json

@@ -35,8 +35,7 @@
     "react-hook-form": "^7.54.2",
     "zod": "^3.24.2",
     "axios": "^1.8.1",
-    "proj4": "^2.9.0",
-    "uuid": "^14.0.1"
+    "proj4": "^2.9.0"
   },
   "devDependencies": {
     "@eslint/eslintrc": "^3",

apps/fo/src/entities/auth/api/auth-service.ts

@@ -1,47 +1,82 @@
 import {
-    ACCESS_TOKEN,
-    AUTH_USER_ID,
-    CLAIM_NAME,
-    ENDPOINT,
+  ACCESS_TOKEN,
+  AUTH_USER_ID,
+  CLAIM_NAME,
+  ENDPOINT,
 } from "@/src/shared/config";
 import { getCookie } from "@/src/shared/lib";
 import {
-    type AuthPayload,
-    type AuthService,
-    getRemainingMs,
+  clearDeviceId,
+  getOrCreateDeviceId,
+  type AuthPayload,
+  type AuthService,
+  getRemainingMs,
 } from "@common/auth";
-import { clearDeviceId, getOrCreateDeviceId } from "../lib/device-id";
 import {
-    clearRefreshTimer,
-    setToken,
-    setupRefreshTimer,
-    tokenManager,
+  clearRefreshTimer,
+  setToken,
+  setupRefreshTimer,
+  tokenManager,
 } from "../lib/token-manager";
-
 import { clearTabStorePersist } from "@/src/store/tab-store";
 
 async function login(payload: AuthPayload): Promise<void> {
-    const response = await fetch(`/api/proxy${ENDPOINT.USER_SERVICE.LOGIN}`, {
-        method: "POST",
+  const response = await fetch(`/api/proxy${ENDPOINT.USER_SERVICE.LOGIN}`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "X-Device-Id": getOrCreateDeviceId(),
+    },
+    body: JSON.stringify(payload),
+  });
+
+  const data = await response.json();
+
+  const accessToken = data[ACCESS_TOKEN];
+  const tokenId = data[AUTH_USER_ID];
+
+  if (!accessToken || !tokenId) {
+    throw new Error("인증 토큰을 받지 못했습니다.");
+  }
+
+  const prevTokenId = getCookie(AUTH_USER_ID);
+  if (prevTokenId !== undefined && prevTokenId !== tokenId) {
+    clearTabStorePersist();
+  }
+
+  setToken(CLAIM_NAME, accessToken);
+  setToken(AUTH_USER_ID, tokenId);
+
+  const remainingMs = getRemainingMs(accessToken);
+  if (remainingMs > 0) {
+    setupRefreshTimer(silentRefresh, remainingMs);
+  }
+}
+
+async function silentRefresh(): Promise<void> {
+  console.log(`[silentRefresh] Called at ${new Date().toISOString()}`);
+  try {
+    const response = await fetch(
+      `/api/proxy${ENDPOINT.USER_SERVICE.SILENT_REFRESH}`,
+      {
+        method: "PUT",
         headers: {
-            "Content-Type": "application/json",
-            "X-Device-Id": getOrCreateDeviceId(),
+          "X-Device-Id": getOrCreateDeviceId(),
         },
-        body: JSON.stringify(payload),
-    });
+      },
+    );
 
     const data = await response.json();
 
+    if (!response.ok) {
+      throw new Error(data?.message ?? "토큰 갱신에 실패했습니다.");
+    }
+
     const accessToken = data[ACCESS_TOKEN];
     const tokenId = data[AUTH_USER_ID];
 
     if (!accessToken || !tokenId) {
-        throw new Error("인증 토큰을 받지 못했습니다.");
-    }
-
-    const prevTokenId = getCookie(AUTH_USER_ID);
-    if (prevTokenId !== undefined && prevTokenId !== tokenId) {
-        clearTabStorePersist();
+      throw new Error("갱신된 인증 토큰을 받지 못했습니다.");
     }
 
     setToken(CLAIM_NAME, accessToken);
@@ -49,67 +84,32 @@ async function login(payload: AuthPayload): Promise<void> {
 
     const remainingMs = getRemainingMs(accessToken);
     if (remainingMs > 0) {
-        setupRefreshTimer(silentRefresh, remainingMs);
+      setupRefreshTimer(silentRefresh, remainingMs);
     }
-}
-
-async function silentRefresh(): Promise<void> {
-    console.log(`[silentRefresh] Called at ${new Date().toISOString()}`);
-    try {
-        const response = await fetch(
-            `/api/proxy${ENDPOINT.USER_SERVICE.SILENT_REFRESH}`,
-            {
-                method: "PUT",
-                headers: {
-                    "X-Device-Id": getOrCreateDeviceId(),
-                },
-            },
-        );
-
-        const data = await response.json();
-
-        if (!response.ok) {
-            throw new Error(data?.message ?? "토큰 갱신에 실패했습니다.");
-        }
-
-        const accessToken = data[ACCESS_TOKEN];
-        const tokenId = data[AUTH_USER_ID];
-
-        if (!accessToken || !tokenId) {
-            throw new Error("갱신된 인증 토큰을 받지 못했습니다.");
-        }
-
-        setToken(CLAIM_NAME, accessToken);
-        setToken(AUTH_USER_ID, tokenId);
-
-        const remainingMs = getRemainingMs(accessToken);
-        if (remainingMs > 0) {
-            setupRefreshTimer(silentRefresh, remainingMs);
-        }
-    } catch (error) {
-        console.error(
-            `[silentRefresh] Failed at ${new Date().toISOString()}`,
-            error,
-        );
-        tokenManager.clearAuthToken();
-        if (typeof window !== "undefined") {
-            window.dispatchEvent(new CustomEvent("auth:logout"));
-        }
+  } catch (error) {
+    console.error(
+      `[silentRefresh] Failed at ${new Date().toISOString()}`,
+      error,
+    );
+    tokenManager.clearAuthToken();
+    if (typeof window !== "undefined") {
+      window.dispatchEvent(new CustomEvent("auth:logout"));
     }
+  }
 }
 
 export async function logout(): Promise<void> {
-    tokenManager.clearAuthToken();
-    clearDeviceId();
+  tokenManager.clearAuthToken();
+  clearDeviceId();
 
-    if (typeof window !== "undefined") {
-        window.dispatchEvent(new CustomEvent("auth:logout"));
-    }
+  if (typeof window !== "undefined") {
+    window.dispatchEvent(new CustomEvent("auth:logout"));
+  }
 }
 
 export const authService: AuthService = {
-    login,
-    silentRefresh,
-    declineSessionExtend: clearRefreshTimer,
-    logout,
+  login,
+  silentRefresh,
+  declineSessionExtend: clearRefreshTimer,
+  logout,
 };

apps/fo/src/entities/auth/lib/device-id.ts

@@ -1,20 +0,0 @@
-import { v4 as uuidv4 } from "uuid";
-
-const DEVICE_ID_KEY = "x-device-id";
-
-export function getOrCreateDeviceId(): string {
-    if (typeof window === "undefined") return "";
-
-    const existing = localStorage.getItem(DEVICE_ID_KEY);
-    if (existing) return existing;
-
-    const id = uuidv4();
-    localStorage.setItem(DEVICE_ID_KEY, id);
-    return id;
-}
-
-export function clearDeviceId(): void {
-    if (typeof window === "undefined") return;
-
-    localStorage.removeItem(DEVICE_ID_KEY);
-}

apps/sn/package.json

@@ -37,7 +37,6 @@
     "react-hook-form": "^7.54.2",
     "tailwindcss-animate": "^1.0.7",
     "tus-js-client": "^4.3.1",
-    "uuid": "^14.0.1",
     "xlsx": "^0.18.5",
     "xlsx-populate": "^1.21.0",
     "zod": "^3.24.2",

apps/sn/src/entities/auth/api/auth-service.ts

@@ -1,47 +1,83 @@
 import {
-    ACCESS_TOKEN,
-    AUTH_USER_ID,
-    CLAIM_NAME,
-    ENDPOINT,
+  ACCESS_TOKEN,
+  AUTH_USER_ID,
+  CLAIM_NAME,
+  ENDPOINT,
 } from "@/shared/config";
 import { getCookie } from "@/shared/lib";
 import {
-    type AuthPayload,
-    type AuthService,
-    getRemainingMs,
+  clearDeviceId,
+  getOrCreateDeviceId,
+  type AuthPayload,
+  type AuthService,
+  getRemainingMs,
 } from "@common/auth";
-import { clearDeviceId, getOrCreateDeviceId } from "../lib/device-id";
 import {
-    clearRefreshTimer,
-    setToken,
-    setupRefreshTimer,
-    tokenManager,
+  clearRefreshTimer,
+  setToken,
+  setupRefreshTimer,
+  tokenManager,
 } from "../lib/token-manager";
 
 import { clearTabStorePersist } from "../../../store/tab-store";
 
 async function login(payload: AuthPayload): Promise<void> {
-    const response = await fetch(`/api/proxy${ENDPOINT.USER_SERVICE.LOGIN}`, {
-        method: "POST",
+  const response = await fetch(`/api/proxy${ENDPOINT.USER_SERVICE.LOGIN}`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "X-Device-Id": getOrCreateDeviceId(),
+    },
+    body: JSON.stringify(payload),
+  });
+
+  const data = await response.json();
+
+  const accessToken = data[ACCESS_TOKEN];
+  const tokenId = data[AUTH_USER_ID];
+
+  if (!accessToken || !tokenId) {
+    throw new Error("인증 토큰을 받지 못했습니다.");
+  }
+
+  const prevTokenId = getCookie(AUTH_USER_ID);
+  if (prevTokenId !== undefined && prevTokenId !== tokenId) {
+    clearTabStorePersist();
+  }
+
+  setToken(CLAIM_NAME, accessToken);
+  setToken(AUTH_USER_ID, tokenId);
+
+  const remainingMs = getRemainingMs(accessToken);
+  if (remainingMs > 0) {
+    setupRefreshTimer(silentRefresh, remainingMs);
+  }
+}
+
+async function silentRefresh(): Promise<void> {
+  console.log(`[silentRefresh] Called at ${new Date().toISOString()}`);
+  try {
+    const response = await fetch(
+      `/api/proxy${ENDPOINT.USER_SERVICE.SILENT_REFRESH}`,
+      {
+        method: "PUT",
         headers: {
-            "Content-Type": "application/json",
-            "X-Device-Id": getOrCreateDeviceId(),
+          "X-Device-Id": getOrCreateDeviceId(),
         },
-        body: JSON.stringify(payload),
-    });
+      },
+    );
 
     const data = await response.json();
 
+    if (!response.ok) {
+      throw new Error(data?.message ?? "토큰 갱신에 실패했습니다.");
+    }
+
     const accessToken = data[ACCESS_TOKEN];
     const tokenId = data[AUTH_USER_ID];
 
     if (!accessToken || !tokenId) {
-        throw new Error("인증 토큰을 받지 못했습니다.");
-    }
-
-    const prevTokenId = getCookie(AUTH_USER_ID);
-    if (prevTokenId !== undefined && prevTokenId !== tokenId) {
-        clearTabStorePersist();
+      throw new Error("갱신된 인증 토큰을 받지 못했습니다.");
     }
 
     setToken(CLAIM_NAME, accessToken);
@@ -49,67 +85,32 @@ async function login(payload: AuthPayload): Promise<void> {
 
     const remainingMs = getRemainingMs(accessToken);
     if (remainingMs > 0) {
-        setupRefreshTimer(silentRefresh, remainingMs);
+      setupRefreshTimer(silentRefresh, remainingMs);
     }
-}
-
-async function silentRefresh(): Promise<void> {
-    console.log(`[silentRefresh] Called at ${new Date().toISOString()}`);
-    try {
-        const response = await fetch(
-            `/api/proxy${ENDPOINT.USER_SERVICE.SILENT_REFRESH}`,
-            {
-                method: "PUT",
-                headers: {
-                    "X-Device-Id": getOrCreateDeviceId(),
-                },
-            },
-        );
-
-        const data = await response.json();
-
-        if (!response.ok) {
-            throw new Error(data?.message ?? "토큰 갱신에 실패했습니다.");
-        }
-
-        const accessToken = data[ACCESS_TOKEN];
-        const tokenId = data[AUTH_USER_ID];
-
-        if (!accessToken || !tokenId) {
-            throw new Error("갱신된 인증 토큰을 받지 못했습니다.");
-        }
-
-        setToken(CLAIM_NAME, accessToken);
-        setToken(AUTH_USER_ID, tokenId);
-
-        const remainingMs = getRemainingMs(accessToken);
-        if (remainingMs > 0) {
-            setupRefreshTimer(silentRefresh, remainingMs);
-        }
-    } catch (error) {
-        console.error(
-            `[silentRefresh] Failed at ${new Date().toISOString()}`,
-            error,
-        );
-        tokenManager.clearAuthToken();
-        if (typeof window !== "undefined") {
-            window.dispatchEvent(new CustomEvent("auth:logout"));
-        }
+  } catch (error) {
+    console.error(
+      `[silentRefresh] Failed at ${new Date().toISOString()}`,
+      error,
+    );
+    tokenManager.clearAuthToken();
+    if (typeof window !== "undefined") {
+      window.dispatchEvent(new CustomEvent("auth:logout"));
     }
+  }
 }
 
 export async function logout(): Promise<void> {
-    tokenManager.clearAuthToken();
-    clearDeviceId();
+  tokenManager.clearAuthToken();
+  clearDeviceId();
 
-    if (typeof window !== "undefined") {
-        window.dispatchEvent(new CustomEvent("auth:logout"));
-    }
+  if (typeof window !== "undefined") {
+    window.dispatchEvent(new CustomEvent("auth:logout"));
+  }
 }
 
 export const authService: AuthService = {
-    login,
-    silentRefresh,
-    declineSessionExtend: clearRefreshTimer,
-    logout,
+  login,
+  silentRefresh,
+  declineSessionExtend: clearRefreshTimer,
+  logout,
 };

apps/sn/src/entities/auth/lib/device-id.ts

@@ -1,20 +0,0 @@
-import { v4 as uuidv4 } from "uuid";
-
-const DEVICE_ID_KEY = "x-device-id";
-
-export function getOrCreateDeviceId(): string {
-    if (typeof window === "undefined") return "";
-
-    const existing = localStorage.getItem(DEVICE_ID_KEY);
-    if (existing) return existing;
-
-    const id = uuidv4();
-    localStorage.setItem(DEVICE_ID_KEY, id);
-    return id;
-}
-
-export function clearDeviceId(): void {
-    if (typeof window === "undefined") return;
-
-    localStorage.removeItem(DEVICE_ID_KEY);
-}

apps/st/app/(main)/(with-base-layout)/layout.tsx

@@ -9,7 +9,7 @@ import {
 } from "@rsone/components";
 import { useQuery, useQueryClient } from "@tanstack/react-query";
 
-import { ENDPOINT } from "@/shared/config";
+import { ENDPOINT, CLAIM_NAME } from "@/shared/config";
 import { getCookie, useAlertStore, useMenuStore } from "@/shared/lib";
 import { isBbsNoticeMenu } from "@/shared/lib/bbs-notice-menu";
 import {
@@ -20,8 +20,10 @@ import { useStatisticsTabUrlSync } from "@/shared/lib/use-statistics-tab-url-syn
 import { isVerificationSelectionReportMenu } from "@/shared/lib/verification-selection-report";
 import { StatisticsPageLayout } from "@/shared/ui/statistics-page-layout";
 import { authService } from "@/entities/auth";
+import { getToken } from "@/entities/auth/lib/token-manager";
 import type { MenuItem } from "@/entities/menu";
 import { MenuApi } from "@/entities/menu";
+import { statisticsApi } from "@/entities/statistics/api/statistics-service";
 import { BaseLayout } from "@common/components";
 import { getConfig } from "@common/config";
 
@@ -93,6 +95,13 @@ function WithBaseLayoutInner({ children }: { children: React.ReactNode }) {
         enabled: isLoggedIn,
     });
 
+    useEffect(() => {
+        if (!getToken(CLAIM_NAME)) return;
+        void statisticsApi.refreshCommonCodes().catch(() => {
+            // 캐시 동기화 실패는 화면 진입을 막지 않음
+        });
+    }, []);
+
     useEffect(() => {
         if (menuListData) {
             setMenuList(menuListData);

apps/st/package.json

@@ -57,7 +57,6 @@
         "swr": "^2.3.7",
         "tailwindcss-animate": "^1.0.7",
         "tus-js-client": "^4.3.1",
-        "uuid": "^14.0.1",
         "xlsx": "^0.18.5",
         "zod": "^3.24.2",
         "zustand": "^5.0.3"

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

@@ -69,6 +69,7 @@ function buildSearchFormValues(
             isDetail: false,
             isSummary: d.isSummary || "",
             clsfCd: initialClsfCd,
+            capacityGbn: d.capacityGbn || "ALL",
         };
     }
 
@@ -85,6 +86,7 @@ function buildSearchFormValues(
         isDetail: false,
         isSummary: d?.isSummary || "",
         clsfCd: initialClsfCd,
+        capacityGbn: d?.capacityGbn || "ALL",
     };
 }
 
@@ -362,6 +364,26 @@ const SearchForm = (props: SearchFormProps = {}) => {
                             />
                         </div>
                     )}
+                    {mergedProps.capacityGbn && (
+                        <div className="flex items-center gap-2">
+                            <Label className="text-label">구분</Label>
+                            <Select
+                                value={values.capacityGbn}
+                                onValueChange={(value) =>
+                                    setValues({ ...values, capacityGbn: value })
+                                }
+                            >
+                                <SelectTrigger className="w-[10rem]">
+                                    <SelectValue placeholder="전체"></SelectValue>
+                                </SelectTrigger>
+                                <SelectContent>
+                                    <SelectItem value='ALL'>전체</SelectItem>
+                                    <SelectItem value='500톤이상'>500톤이상</SelectItem>
+                                    <SelectItem value='500톤미만'>500톤미만</SelectItem>
+                                </SelectContent>
+                            </Select>
+                        </div>
+                    )}
                     {mergedProps.isDetail && (
                         <div className="flex items-center gap-2">
                             <Label className="text-label cursor-pointer" htmlFor="isDetail">

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

@@ -311,15 +311,24 @@ export function VerificationResultDialog({
     }, [rows, loading]);
 
     const handleExceptionSubmitClick = useCallback(async () => {
+        if (checkedIndices.size === 0) {
+            alert("작성된 예외 제출 항목이 없습니다.");
+            return;
+        }
+
         const gridRows = getGridDataRef.current?.() ?? [];
         const payload: VerificationExceptionSubmitItem[] = [];
-        checkedIndices.forEach((idx) => {
+        for (const idx of checkedIndices) {
             const prcsOpnnExpln = String(gridRows[idx]?.prcsOpnnExpln ?? "").trim();
-            if (!prcsOpnnExpln) return;
+            if (!prcsOpnnExpln) {
+                alert("예외 제출 사유를 작성해주세요.");
+                return;
+            }
             const vrfcSn = Number(rows[idx]?.vrfcSn);
-            if (!Number.isFinite(vrfcSn)) return;
+            if (!Number.isFinite(vrfcSn)) continue;
             payload.push({ vrfcSn, prcsOpnnExpln });
-        });
+        }
+
         if (payload.length === 0) {
             alert("작성된 예외 제출 항목이 없습니다.");
             return;

apps/st/src/components/statistics/VerificationSelectionReport.tsx

@@ -357,16 +357,16 @@ const VerificationSelectionReport = ({
                                 }
                             }}
                         >
-                            <div className="mb-2 flex items-center justify-between">
-                                <span className="font-medium">
+                            <div className="mb-2">
+                                <div className="font-medium">
                                     {formatReportItemTitle(item)}
-                                </span>
+                                </div>
                                 <Badge
                                     color={
                                         TYPE_CODE_COLOR_MAP[item.vrfcMthdCd] ??
                                         "gray"
                                     }
-                                    className="text-sm"
+                                    className="text-sm float-end"
                                 >
                                     {TYPE_CODE_NAME_MAP[item.vrfcMthdCd] ??
                                         item.vrfcMthdNm}
@@ -397,8 +397,8 @@ const VerificationSelectionReport = ({
     );
 
     return (
-        <div className="w-1/5 bg-container p-4 !pb-2 flex border-r border-border">
-            <div className="card card-border flex-1 bg-background !px-0 max-h-[1000px] flex flex-col">
+        <div className="w-1/5 min-w-0 bg-container p-4 !pb-2 flex border-r border-border">
+            <div className="card card-border min-w-0 flex-1 bg-background !px-0 max-h-[1000px] flex flex-col">
                 <div className="border-b border-border flex justify-between">
                     <div className="flex justify-center items-center text-[2.4rem] ">
                         <h2 className="font-semibold text-title p-4 pr-1">이상치 선별 보고서</h2>
@@ -434,14 +434,14 @@ const VerificationSelectionReport = ({
                         <i className="ri-close-line" />
                     </span>
                 </div>
-                <div className="flex items-center gap-2 pt-2.5 px-4">
+                <div className="flex min-w-0 items-center gap-2 pt-2.5 px-4">
                     <Label className="text-label shrink-0">통계항목</Label>
                     <CodeSelectWithAll
                         upCd="STITEM"
                         value={statsCd}
                         onValueChange={handleStatsCdChange}
                         placeholder="전체"
-                        className="w-full"
+                        className="min-w-0 flex-1 overflow-hidden"
                     />
                 </div>
                 <div className="card-body p-2.5 flex-1 flex flex-col overflow-hidden relative min-h-0">

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

@@ -872,6 +872,7 @@ const ExcretaTreatmentFacilityInp = () => {
         flushSync(() => {
             setSggOptions(list);
             setRowData([...currentRows, newRow]);
+            setIsNotApplicable(false);
         });
     };
 

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

@@ -1,10 +1,13 @@
 "use client";
 
 import { useEffect, useState } from "react";
+import { CalendarIcon } from "lucide-react";
+import dayjs from "dayjs";
 
 import { useAlertStore } from "@/shared/lib";
 import {
     Button,
+    Calendar,
     Dialog,
     DialogClose,
     DialogContent,
@@ -12,8 +15,10 @@ import {
     DialogHeader,
     DialogTitle,
     Input,
-    InputDatePicker,
     Label,
+    Popover,
+    PopoverContent,
+    PopoverTrigger,
 } from "@common/components";
 
 export interface MainFacilityMappingSaveDialogValues {
@@ -79,6 +84,95 @@ function validateContractRange(start: Date | undefined, end: Date | undefined):
     return null;
 }
 
+const CONTRACT_DATE_END_MONTH = new Date(new Date().getFullYear() + 10, 11);
+
+function isValidDate(date: Date | undefined) {
+    if (!date) return false;
+    return !Number.isNaN(date.getTime());
+}
+
+/** 이 다이얼로그 전용 — 연도 드롭다운을 현재+10년까지 허용 */
+function ContractDatePicker({
+    value,
+    onChange,
+    disabled,
+    className,
+}: {
+    value?: Date;
+    onChange: (date: Date | undefined) => void;
+    disabled?: boolean;
+    className?: string;
+}) {
+    const [open, setOpen] = useState(false);
+    const [month, setMonth] = useState<Date | undefined>(value);
+    const [displayValue, setDisplayValue] = useState<Date | undefined>(value);
+
+    useEffect(() => {
+        setDisplayValue(value);
+        setMonth(value);
+    }, [value]);
+
+    return (
+        <div className="relative flex gap-2">
+            <Input
+                type="date"
+                value={displayValue ? dayjs(displayValue).format("YYYY-MM-DD") : ""}
+                disabled={disabled}
+                max={dayjs(CONTRACT_DATE_END_MONTH).format("YYYY-MM-DD")}
+                className={`bg-background pr-10 ${className ?? ""}`}
+                onChange={(e) => {
+                    const newDate = new Date(e.target.value);
+                    setDisplayValue(newDate);
+                    if (isValidDate(newDate)) {
+                        onChange(newDate);
+                        setMonth(newDate);
+                    }
+                }}
+                onKeyDown={(e) => {
+                    if (e.key === "ArrowDown") {
+                        e.preventDefault();
+                        setOpen(true);
+                    }
+                }}
+            />
+            <Popover open={open} onOpenChange={setOpen}>
+                <PopoverTrigger asChild>
+                    <Button
+                        type="button"
+                        variant="ghost"
+                        color="white"
+                        disabled={disabled}
+                        className="absolute right-2 top-1/2 size-7 -translate-y-1/2 rounded-[0.4rem] border-none p-0"
+                    >
+                        <CalendarIcon className="!size-full" />
+                        <span className="sr-only">Select date</span>
+                    </Button>
+                </PopoverTrigger>
+                <PopoverContent
+                    className="w-auto overflow-hidden p-0"
+                    align="end"
+                    alignOffset={-8}
+                    sideOffset={10}
+                >
+                    <Calendar
+                        mode="single"
+                        selected={value}
+                        captionLayout="dropdown"
+                        month={month}
+                        onMonthChange={setMonth}
+                        endMonth={CONTRACT_DATE_END_MONTH}
+                        onSelect={(newDate) => {
+                            onChange(newDate);
+                            setDisplayValue(newDate);
+                            setOpen(false);
+                        }}
+                    />
+                </PopoverContent>
+            </Popover>
+        </div>
+    );
+}
+
 export function MainFacilityMappingSaveDialog({
     open,
     onOpenChange,
@@ -220,7 +314,7 @@ export function MainFacilityMappingSaveDialog({
                         <div className="flex flex-col gap-3 sm:flex-row sm:items-end sm:gap-4">
                             <div className="flex min-w-0 flex-1 flex-col gap-2">
                                 <Label className="text-label text-[1.2rem]">시작일</Label>
-                                <InputDatePicker
+                                <ContractDatePicker
                                     value={prxyCtrtStart}
                                     onChange={setPrxyCtrtStart}
                                     className="w-full"
@@ -229,7 +323,7 @@ export function MainFacilityMappingSaveDialog({
                             </div>
                             <div className="flex min-w-0 flex-1 flex-col gap-2">
                                 <Label className="text-label text-[1.2rem]">종료일</Label>
-                                <InputDatePicker
+                                <ContractDatePicker
                                     value={prxyCtrtEnd}
                                     onChange={setPrxyCtrtEnd}
                                     className="w-full"

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

@@ -856,6 +856,7 @@ const PumpingStationInp = () => {
         flushSync(() => {
             setSggOptions(list);
             setRowData([...currentRows, newRow]);
+            setIsNotApplicable(false);
         });
     };
 

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

@@ -1681,12 +1681,6 @@ const SewageExcretaRelatedInp = () => {
             return;
         }
 
-        const noApplicable = isNotApplicableByTab.get(tabKey) ?? false;
-        if (noApplicable) {
-            alert("해당사항 없음이 체크된 상태에서는 항목을 추가할 수 없습니다.");
-            return;
-        }
-
         let list = sggOptions;
         if (sggOptionsSidoRef.current !== ctx.sido || list.length === 0) {
             list = await loadSggOptions(ctx.sido);
@@ -1715,6 +1709,7 @@ const SewageExcretaRelatedInp = () => {
                 next.set(tabKey, [...currentRows, newRow]);
                 return next;
             });
+            setIsNotApplicableForTab(tabKey, false);
         });
 
         commitToolbarSnapshotForLoadedTab(

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

@@ -1809,6 +1809,7 @@ const SewageExcretaSlurgeInp = () => {
                 next.set(tabKey, [...currentRows, newRow]);
                 return next;
             });
+            setIsNotApplicableForTab(tabKey, false);
         });
 
         const statusInfo = tabStatusInfoMap.get(tabKey) ?? null;

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

@@ -1426,6 +1426,7 @@ const SewageReservoirPumpInp = () => {
                 next.set(tabKey, [...currentRows, newRow]);
                 return next;
             });
+            setIsNotApplicableForTab(tabKey, false);
         });
 
         const statusInfo = tabStatusInfoMap.get(tabKey) ?? null;

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

@@ -44,6 +44,9 @@ const StatisticsReviewHistory = () => {
                 statsYr: values.year.trim(),
                 ...(values.bsnmCd?.trim() ? { sewerBzmnCd: values.bsnmCd.trim() } : {}),
                 ...(values.sido && values.sido !== "ALL" ? { ctpvNm: values.sido } : {}),
+                ...(values.gugun?.trim() && values.gugun !== "ALL"
+                    ? { sggNm: values.gugun.trim() }
+                    : {}),
             });
 
             if (res.status === "success" && Array.isArray(res.data)) {

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

@@ -117,7 +117,10 @@ const ARTICLE_EDIT_TAB_KEYS = new Set<string>([
     TreatWaterReuseBusinessApprStatusInpColumn.tabKey,
 ]);
 
-const NO_APPLICABLE_TAB_KEYS = ARTICLE_EDIT_TAB_KEYS;
+const NO_APPLICABLE_TAB_KEYS = new Set<string>([
+    PublicSewageTreatWaterReuseInpColumn.tabKey,
+    ...ARTICLE_EDIT_TAB_KEYS,
+]);
 
 const WATER_REUSE_TAB_BY_KEY = new Map(
     WaterReuseInpTabList.map((tab) => [tab.tabKey, tab]),
@@ -1073,19 +1076,11 @@ const WaterReuseInp = () => {
                 return;
             }
 
-            if (isPublicSewageTab) {
-                const currentData = getTabGridRows(tabKey);
-                if (currentData.length === 0) {
-                    alert("제출할 데이터가 없습니다.");
-                    return;
-                }
-            } else {
-                const noApplicable = isNotApplicableByTab.get(tabKey) ?? false;
-                const currentData = getTabGridRows(tabKey);
-                if (!noApplicable && currentData.length === 0) {
-                    alert("해당사항 없음을 체크해주세요.");
-                    return;
-                }
+            const noApplicable = isNotApplicableByTab.get(tabKey) ?? false;
+            const currentData = getTabGridRows(tabKey);
+            if (!noApplicable && currentData.length === 0) {
+                alert("해당사항 없음을 체크해주세요.");
+                return;
             }
 
             if (await confirm("제출 하시겠습니까?")) {
@@ -1179,17 +1174,20 @@ const WaterReuseInp = () => {
             };
 
             if (isPublicSewageTab) {
+                const noApplicable = isNotApplicableByTab.get(tabKey) ?? false;
                 const currentData = getTabGridRows(tabKey);
-                const submitList = currentData.map(buildPublicSewageTreatWaterReuseSaveItem);
-                if (submitList.length === 0) {
-                    alert("제출할 데이터가 없습니다.");
+                const submitList = noApplicable
+                    ? []
+                    : currentData.map(buildPublicSewageTreatWaterReuseSaveItem);
+                if (!noApplicable && submitList.length === 0) {
+                    alert("해당사항 없음을 체크해주세요.");
                     return;
                 }
 
                 response = await statisticsInputWaterReuseApi.submitPublicSewageTreatWaterReuse({
                     ...submitRequestBase,
                     userId: userInfo.userUnqId,
-                    noApplicable: false,
+                    noApplicable,
                     submitList,
                 });
             } else {
@@ -1420,9 +1418,13 @@ const WaterReuseInp = () => {
             };
 
             if (tabKey === PublicSewageTreatWaterReuseInpColumn.tabKey) {
+                const noApplicable = isNotApplicableByTab.get(tabKey) ?? false;
                 const currentData = getTabGridRows(tabKey);
-                if (currentData.length === 0) {
-                    alert("저장할 데이터가 없습니다.");
+                const saveList = noApplicable
+                    ? []
+                    : currentData.map(buildPublicSewageTreatWaterReuseSaveItem);
+                if (!noApplicable && saveList.length === 0) {
+                    alert("해당사항 없음을 체크해주세요.");
                     return;
                 }
 
@@ -1433,8 +1435,8 @@ const WaterReuseInp = () => {
                         await statisticsInputWaterReuseApi.savePublicSewageTreatWaterReuse({
                             ...requestBase,
                             userId: userInfo.userUnqId,
-                            noApplicable: false,
-                            saveList: currentData.map(buildPublicSewageTreatWaterReuseSaveItem),
+                            noApplicable,
+                            saveList,
                         });
 
                     if (response.status === "success") {
@@ -1792,6 +1794,7 @@ const WaterReuseInp = () => {
                 next.set(tabKey, [...currentRows, newRow]);
                 return next;
             });
+            setIsNotApplicableForTab(tabKey, false);
         });
 
         const statusInfo = tabStatusInfoMap.get(tabKey) ?? null;

apps/st/src/components/statistics/management/StatisticsInputManagement.tsx

@@ -199,12 +199,6 @@ const StatisticsInputManagement = () => {
             header: { text: "분류" },
             editable: false,
         },
-        {
-            name: "seCd",
-            fieldName: "seCd",
-            header: { text: "구분" },
-            editable: false,
-        },
         {
             name: "inptBgngYmd",
             fieldName: "inptBgngYmd",
@@ -230,7 +224,6 @@ const StatisticsInputManagement = () => {
     const columnLayout = [
         "statsYr",
         "seType",
-        "seCd",
         "inptBgngYmd",
         "inptEndYmd",
         PERIOD_DETAIL_FIELD,

apps/st/src/components/statistics/total/PublicSewageFacilityTot.tsx

@@ -21,6 +21,7 @@ const PublicSewageFacilityTot = () => {
             setIsLoading(true);
 
             const isSummaryEnabled = values.isSummary !== 'ALL';
+            const isCapacityGbn = values.capacityGbn !== 'ALL'
             const summaryYearCnt = isSummaryEnabled ? Number(values.isSummary) : undefined;
 
             const param = {
@@ -29,6 +30,7 @@ const PublicSewageFacilityTot = () => {
                 sewerBzmnCd: values.bsnmCd,
                 statsYr: values.year,
                 rowDataYn: values.isDetail,
+                ...(isCapacityGbn ? { capacityGbn: values.capacityGbn } : {}),
                 summaryYn: isSummaryEnabled,
                 ...(isSummaryEnabled ? { summaryYearCnt } : {}),
             };
@@ -50,7 +52,7 @@ const PublicSewageFacilityTot = () => {
 
     return (
         <>
-            <SearchForm isDetail={true} isSummary={true} onSubmit={handleSearch} sidoSelectText="전체" />
+            <SearchForm isDetail={true} capacityGbn={true} isSummary={true} onSubmit={handleSearch} sidoSelectText="전체" />
             {isLoading && (
                 <div className="absolute inset-0 z-50 [data-theme='black']:bg-transparent rounded-lg p-10 flex justify-center items-center">
                     <div className="relative size-[5rem]">

apps/st/src/components/statistics/verification/ApprovalInputDialog.tsx

@@ -141,16 +141,6 @@ export function ApprovalInputDialog({
                             disabled={isSubmitting}
                         />
                     </div>
-                    <div className="flex flex-col gap-2">
-                        <Label className="text-label">반려 의견 내용</Label>
-                        <Textarea
-                            value={rjctOpnnCn}
-                            onChange={(e) => setRjctOpnnCn(e.target.value)}
-                            className="min-h-[10rem] resize-y !text-[1.3rem] !leading-6"
-                            placeholder="반려 의견 내용을 입력하세요. (선택사항)"
-                            disabled={isSubmitting}
-                        />
-                    </div>
                 </div>
                 <DialogFooter>
                     <DialogClose asChild>

apps/st/src/components/statistics/verification/StatisticsVerificationReport.tsx

@@ -213,7 +213,14 @@ function StatisticsVerificationReport() {
                 })),
     });
 
-    const statisticsVerificationReportQuery = useStatsVrfcRptData(filters);
+    const {
+        ctpvSewerBzmnCd: _,
+        sggSewerBzmnCd: __,
+        ...statisticsVerificationReportFilters
+    } = filters;
+    const statisticsVerificationReportQuery = useStatsVrfcRptData(
+        statisticsVerificationReportFilters,
+    );
     const statisticsVerificationResultQuery =
         useStatsVrfcRsltData(detailParams);
 
@@ -399,12 +406,16 @@ function StatisticsVerificationReport() {
             optionData?: { label: string; value: string },
         ) => {
             resetReportState();
-            if (key === "sewerBzmnCd") {
+
+            // 시도 변경 시
+            if (key === "ctpvNm") {
                 setFilters((prev) => ({
                     ...prev,
+                    sewerBzmnCd: value,
                     ctpvNm: optionData?.label,
-                    sewerBzmnCd: optionData?.value,
+                    ctpvSewerBzmnCd: value,
                     sggNm: "",
+                    sggSewerBzmnCd: "",
                 }));
                 setSubFilters((prev) => ({
                     ...prev,
@@ -414,6 +425,18 @@ function StatisticsVerificationReport() {
                 }));
                 return;
             }
+
+            // 시군구 변경 시
+            if (key === "sggNm") {
+                setFilters((prev) => ({
+                    ...prev,
+                    sewerBzmnCd: value,
+                    sggNm: optionData?.label,
+                    sggSewerBzmnCd: value,
+                }));
+                return;
+            }
+
             if (key === "statsCd") {
                 setSubFilters((prev) => ({ ...prev, statsCd: "" }));
             }
@@ -540,8 +563,8 @@ function StatisticsVerificationReport() {
                 <div className="flex items-center gap-6">
                     <FilterSelect
                         label="시도"
-                        value={filters.sewerBzmnCd ?? ""}
-                        onChange={handleFilterChange("sewerBzmnCd")}
+                        value={filters.ctpvSewerBzmnCd ?? ""}
+                        onChange={handleFilterChange("ctpvNm")}
                         options={
                             sidoData?.map((item) => ({
                                 label: item.adstNm,
@@ -551,7 +574,7 @@ function StatisticsVerificationReport() {
                     />
                     <FilterSelect
                         label="시군구"
-                        value={filters.sggNm ?? ""}
+                        value={filters.sggSewerBzmnCd ?? ""}
                         onChange={handleFilterChange("sggNm")}
                         options={
                             sigunguData?.map((item) => ({

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

@@ -12,6 +12,7 @@ export type SearchFormValues = {
     isSummary?: string;
     /** 분류: 전체(ALL), 입력(INPT), 검증(VRFC) */
     clsfCd?: SearchFormClsfCd;
+    capacityGbn?: string;
 };
 
 export type SearchFormProps = {
@@ -24,6 +25,7 @@ export type SearchFormProps = {
     /** 분류(입력/검증) 셀렉트 표시 */
     clsf?: boolean;
     userMenual?: boolean;
+    capacityGbn?: boolean;
     isDetail?: boolean;
     isSummary?: boolean;
     onSubmit?: (values: SearchFormValues) => void;
@@ -44,6 +46,7 @@ export const defaultSearchFormProps: Required<
     fctName: false,
     clsf: false,
     userMenual: false,
+    capacityGbn: false,
     isDetail: false,
     isSummary: false,
     isReset: true,