222

p_atflCd. 추가로직 정리
2025-04-01 17:05:28 +09:00 · 2025-04-01 17:04:47 +09:00
4106 changed files with 12676 additions and 472156 deletions
@@ -1,9 +0,0 @@
-node_modules
-.next
-Dockerfile
-.dockerignore
-.env*
-apps/**/node_modules
-packages/**/node_modules
-apps/**/.next
-**/.next/cache
@@ -1,33 +0,0 @@
-name: Deploy Frontend
-
-on:
-  push:
-    branches:
-      - deploy
-
-jobs:
-  deploy:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v3
-
-      - name: Setup SSH
-        run: |
-          mkdir -p ~/.ssh
-          echo "${{ secrets.SSH_PRIVATE_KEY }}" > ~/.ssh/deploy_key
-          chmod 600 ~/.ssh/deploy_key
-          ssh-keyscan -p 28 -H 192.168.0.4 >> ~/.ssh/known_hosts
-
-      - name: Deploy
-        run: |
-          ssh -i ~/.ssh/deploy_key -p 28 onasys@192.168.0.4 << 'EOF'
-            cd ~/frontend
-            git restore .
-            git clean -fd
-            git pull origin deploy
-            pnpm install
-            pnpm turbo build
-            pm2 reload all
-          EOF
@@ -1,10 +1,12 @@
 # turbo
 .turbo/
-.vscode/**/*

 # dependencies
 node_modules/
-.idea/
+
+# build
+.next/
+dist/

 # build
 .next
@@ -12,22 +14,7 @@ dist

 # misc
 .DS_Store
-apps/wr/.next/**/*
-apps/fo/.next/**/*

 # env
-#.env*
+.env*
 .qodo
-
-# next-agents-md
-.next-docs/
-
-pnpm-lock.yaml
-settings.json
-.npmrc
-.cursor
-.agent
-
-apps/**/tsconfig.tsbuildinfo
-packages/**/tsconfig.tsbuildinfo
-logs/
@@ -1,10 +0,0 @@
-#!/bin/sh
-BRANCH=$(git rev-parse --abbrev-ref HEAD)
-if [ "$BRANCH" != "main" ]; then
-  exit 0
-fi
-echo "Branch: $BRANCH"
-echo "Changed packages (dry-run):"
-pnpm turbo run build --filter="...[origin/$BRANCH]" --dry-run
-echo "Starting build..."
-pnpm turbo run build --filter="...[origin/$BRANCH]"
@@ -1,88 +0,0 @@
-{
-    // IntelliSense를 사용하여 가능한 특성에 대해 알아보세요.
-    // 기존 특성에 대한 설명을 보려면 가리킵니다.
-    // 자세한 내용을 보려면 https://go.microsoft.com/fwlink/?linkid=830387을(를) 방문하세요.
-    "version": "0.2.0",
-    "configurations": [
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "dev:as 디버그",
-            "runtimeExecutable": "pnpm",
-            "runtimeArgs": [
-                "run",
-                "dev:as"
-            ],
-            "skipFiles": [
-                "<node_internals>/**"
-            ],
-            "cwd": "${workspaceFolder}",
-            "console": "integratedTerminal",
-            "sourceMaps": true,
-            "env": {
-                "NODE_OPTIONS": "--inspect"
-            }
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "dev:cs 디버그",
-            "runtimeExecutable": "pnpm",
-            "runtimeArgs": [
-                "run",
-                "dev:cs"
-            ],
-            "skipFiles": [
-                "<node_internals>/**"
-            ],
-            "cwd": "${workspaceFolder}",
-            "console": "integratedTerminal",
-            "sourceMaps": true,
-            "env": {
-                "NODE_OPTIONS": "--inspect"
-            }
-        },
-        {
-            "type": "node",
-            "request": "attach",
-            "name": "dev:cs 서버 연결 (attach)",
-            "port": 9229,
-            "restart": true,
-            "skipFiles": [
-                "<node_internals>/**"
-            ],
-            "sourceMaps": true,
-            "resolveSourceMapLocations": [
-                "${workspaceFolder}/apps/cs/**",
-                "!**/node_modules/**"
-            ]
-        },
-        {
-            "type": "chrome",
-            "request": "launch",
-            "name": "dev:cs 클라이언트 디버그 (Chrome)",
-            "url": "http://localhost:3000",
-            "webRoot": "${workspaceFolder}/apps/cs",
-            "sourceMaps": true
-        },
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "dev:st 디버그",
-            "runtimeExecutable": "pnpm",
-            "runtimeArgs": [
-                "run",
-                "dev:st"
-            ],
-            "skipFiles": [
-                "<node_internals>/**"
-            ],
-            "cwd": "${workspaceFolder}",
-            "console": "integratedTerminal",
-            "sourceMaps": true,
-            "env": {
-                "NODE_OPTIONS": "--inspect"
-            }
-        }
-    ]
-}
@@ -1,5 +0,0 @@
-{
-    "chat.tools.terminal.autoApprove": {
-        "pnpm": true
-    }
-}
@@ -1,93 +0,0 @@
-# ---------------------- #
-# STEP 1: Base 설치 환경 #
-# ---------------------- #
-FROM node:20-alpine AS base
-
-WORKDIR /repo
-
-# pnpm 설치 (corepack)
-RUN corepack enable && corepack prepare pnpm@10.12.1 --activate
-
-# 필요한 시스템 패키지 설치 (선택)
-RUN apk add --no-cache libc6-compat
-
-# ---------------------- #
-# STEP 2: 의존성 설치용 캐시 레이어 #
-# ---------------------- #
-FROM base AS deps
-
-# workspace 정의 복사
-COPY pnpm-workspace.yaml ./
-COPY package.json pnpm-lock.yaml ./
-COPY apps/cs/package.json ./apps/cs/
-COPY packages ./packages
-
-# 종속성 설치 (only production dependencies)
-RUN rm -rf node_modules .next
-RUN pnpm install --frozen-lockfile --node-linker=node-modules
-#RUN pnpm install --frozen-lockfile --node-linker=node-modules
-RUN ls -al .
-#RUN pnpm install --prod
-
-# ---------------------- #
-# STEP 3: 빌드 단계 #
-# ---------------------- #
-FROM base AS builder
-
-COPY --from=deps /repo /repo
-WORKDIR /repo
-
-# 전체 소스 복사
-COPY . .
-
-RUN ls -al /repo/apps/cs/.next || true
-RUN rm  -rf /repo/apps/cs/.next
-RUN ls -al /repo/apps/cs/
-# Next.js 빌드
-RUN cat /repo/apps/cs/next.config.ts || true
-RUN pnpm --filter ./apps/cs... build
-
-#RUN ls -al .next/standalone
-# 👉 실행에 필요한 모듈만 유지
-#RUN pnpm prune --prod
-
-# Next.js 빌드 내용 보기
-RUN ls -al ./apps/cs/
-RUN ls -al /repo/apps/cs/.next
-RUN ls -al /repo/apps/cs/.next/chunks || true
-
-# web browser request zip format
-#RUN find /repo/apps/cs/.next/static -type f -name '*.js' -exec gzip -k {} \;
-
-#RUN find ./apps/cs/.next -type f
-
-# ---------------------- #
-# STEP 4: 최종 러너 단계 (최소 런타임) #
-# ---------------------- #
-FROM node:20-alpine AS runner
-
-WORKDIR /app
-
-# corepack 사용 설정
-#RUN corepack enable && corepack prepare pnpm@8.15.5 --activate
-
-# 환경변수 설정
-ENV NODE_ENV=production
-ENV PORT=3000
-
-# pnpm은 런타임에 필요 없음 → corepack 설치 생략 가능
-
-# 빌드 결과만 복사
-RUN rm -rf .next
-COPY --from=builder /repo/apps/cs/.next/standalone ./
-COPY --from=builder /repo/apps/cs/public           ./public
-COPY --from=builder /repo/apps/cs/.next/static     ./apps/cs/.next/static
-COPY --from=builder /repo/apps/cs/.env     ./apps/cs/.env
-COPY --from=builder /repo/apps/cs/package.json     ./apps/cs/package.json
-COPY --from=builder /repo/apps/cs/next.config.ts     ./apps/cs/next.config.ts
-# 헬스체크 등 필요 시 추가 가능
-#HEALTHCHECK --interval=30s --timeout=3s CMD wget --spider -q http://localhost:3000 || exit 1
-
-EXPOSE 3000
-CMD ["node", "apps/cs/server.js"]
-#CMD ["pnpm", "start"]
@@ -44,12 +44,6 @@ npx create-next-app@latest ./apps/as --typescript --eslint --tailwind --app
 ```json
 {
  // 기타 설정 ...
-  "scripts": {
-    "dev": "next dev",
-    "build": "next build",
-    "start": "next start",
-    "lint": "next lint"
-  },
  "dependencies": {
    "@common/components": "workspace:*", // 추가
    "react": "^19.0.0", // 제거
@@ -67,10 +61,10 @@ npx create-next-app@latest ./apps/as --typescript --eslint --tailwind --app
 ```json
 {
  // 기타 설정 ...
-  "baseUrl": "./src",
  "paths": {
-    "@common/components": ["../../../packages/common/components/dist/"],
-    "@common/config": ["../../../packages/common/config/dist/"],
+    "@common/components/*": ["../../../packages/common/components/src/*"],
+    "@common/components": ["../../../packages/common/components/src"],
+    "@common/network/*": ["../../../packages/common/network/*"],
    "@common/network": ["../../../packages/common/network/"]
  }
 }
@@ -95,47 +89,61 @@ export default {
 ### 5. next.config.ts 수정
 ```json
 import type { NextConfig } from "next";
+import webpack from "webpack";

-const subDomain =
-  process.env.NEXT_PUBLIC_SUB_DOMAIN || "http://localhost:13000";
+const serverApiUrl =
+  process.env.NEXT_PUBLIC_SERVER_API_URL || "http://localhost:3000";

 const nextConfig: NextConfig = {
+  webpack: (config) => {
+    config.plugins.push(
+      // common/components의 vite 환경 변수를 next 환경 변수로 정의
+      new webpack.DefinePlugin({
+        "import.meta.env.VITE_PORT": JSON.stringify(
+          process.env.NEXT_PUBLIC_PORT,
+        ),
+        "import.meta.env.VITE_PROXY_HOST": JSON.stringify(
+          process.env.NEXT_PUBLIC_PROXY_HOST,
+        ),
+        "import.meta.env.VITE_SERVER_API_URL": JSON.stringify(
+          process.env.NEXT_PUBLIC_SERVER_API_URL,
+        ),
+        "import.meta.env.VITE_SITE_ID": JSON.stringify(process.env.SITE_ID),
+        "import.meta.env.VITE_CLAIM_NAME": JSON.stringify(
+          process.env.NEXT_PUBLIC_CLAIM_NAME,
+        ),
+        "import.meta.env.VITE_ACCESS_TOKEN": JSON.stringify(
+          process.env.NEXT_PUBLIC_ACCESS_TOKEN,
+        ),
+        "import.meta.env.VITE_REFRESH_TOKEN": JSON.stringify(
+          process.env.NEXT_PUBLIC_REFRESH_TOKEN,
+        ),
+        "import.meta.env.VITE_AUTH_USER_ID": JSON.stringify(
+          process.env.NEXT_PUBLIC_AUTH_USER_ID,
+        ),
+        "process.env.SITE_ID": JSON.stringify(process.env.NEXT_PUBLIC_SITE_ID),
+      }),
+    );
+
+    return config;
+  },
  async rewrites() {
-    return {
-      beforeFiles: [
-        {
-          source: "/_next/static/:path*",
-          destination: `${subDomain}/_next/static/:path*`,
-          has: [
-            {
-              type: "header",
-              key: "referer",
-              value: "(.*)/cms(.*)",
-            },
-          ],
-        },
-      ],
-      afterFiles: [
-        {
-          source: "/cms/:path*",
-          destination: `${subDomain}/cms/:path*`,
-        },
-      ],
-      fallback: [],
-    };
+    return [
+      {
+        source: "/server/:path*",
+        destination: `${serverApiUrl}/:path*`,
+      },
+    ];
  },
 };

 export default nextConfig;
-
 ```

 ### 6. globals.css(또는 전역 css) 수정

 ```css
-@import "@common/assets/styles/base.css";
-@import "@common/assets/styles/diveicon.css";
-@import "@common/components/index.css";
+@import "@common/assets/index.css";

@tailwind base;
@tailwind components;
@@ -151,26 +159,6 @@ rm -rf node_modules pnpm-lock.yaml
 pnpm install
 ```

-### 8.  로그아웃 처리 가이드
-
- * 참고 파일
-  - apps/cs/app/api/auth/logout/route.ts
-  - packages/common/components/src/ui/header/index.tsx (55-65 line)
-
-각 서비스 폴더에 ‘/app/api/auth/logout/route.ts’ 생성해야 합니다(코드는 cs에서 확인).
-
-** 로그아웃 처리되면 ‘/auth/login’ 페이지로 이동됩니다.
-
-### 9.  'SITE_ID’ 환경변수를 쿠키로 대체하는 가이드(공통 모듈 사용하기위한 필수 사항)
-
-  * 참고 파일: apps/cs/src/shared/api/client.ts  (쿠키 저장 처리)
-              apps/cs/src/shared/lib/cookie.ts  (쿠키 공통 모듈)
-
-   `SITE_ID` 환경변수를 처음 사용하는 파일 또는 최상단 클라이언트 컴포넌트에서 “site-id-key” 쿠키에 `SITE_ID` 저장
-   
-
-
-
 ## 기술 스택

 - React(^18)
@@ -196,9 +184,3 @@ http://dev.onasys.co.kr:8000

 ## Swagger
 http://dev.onasys.co.kr:8000/webjars/swagger-ui/index.html?urls.primaryName=attach-service
-
-## 개발 가이드
- 사이드바 메뉴 클릭 시 "menuCd" 데이터 쿠키 저장 처리 
- 쿠키명 : menu-code-key 
- 해당 메뉴 쿠키 데이터 가져와 페이지 권한 및 상당 Breadcrumb 데이터 전달 처리 
-
@@ -1,8 +0,0 @@
-# src/shared/config/env.ts 참고
-NEXT_PUBLIC_PORT=
-NEXT_PUBLIC_PROXY_HOST=
-NEXT_PUBLIC_SITE_ID=
-SERVER_API_URL=
-
-# 401 시 브라우저 리다이렉트 대상
-NEXT_PUBLIC_AUTH_LOGIN_REDIRECT_URL=/auth/login
@@ -1,3 +0,0 @@
-{
-  "extends": "next/core-web-vitals"
-}
@@ -1,36 +0,0 @@
-# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
-
-# dependencies
-/node_modules
-/.pnp
-.pnp.js
-.yarn/install-state.gz
-
-# testing
-/coverage
-
-# next.js
-/.next/
-/out/
-
-# production
-/build
-
-# misc
-.DS_Store
-*.pem
-
-# debug
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-
-# local env files
-.env*.local
-
-# vercel
-.vercel
-
-# typescript
-*.tsbuildinfo
-next-env.d.ts
@@ -1,8 +0,0 @@
-{
-  "semi": true,
-  "trailingComma": "all",
-  "singleQuote": false,
-  "printWidth": 100,
-  "tabWidth": 2,
-  "plugins": ["prettier-plugin-tailwindcss"]
-}
@@ -1,187 +0,0 @@
-# Template Application
-
-Next.js 애플리케이션 with FSD(Feature Sliced Design) 아키텍처
-
-## 기술 스택
-
- **프레임워크**: Next.js 15 + TypeScript
- **스타일링**: Tailwind CSS
- **상태관리**: Zustand
- **데이터 페칭**: TanStack Query (React Query)
- **폼 관리**: React Hook Form + Zod
- **테이블**: TanStack Table
- **HTTP 클라이언트**: Axios
- **날짜 처리**: Day.js
-
-## 프로젝트 구조 (FSD + Next.js App Router)
-
-이 프로젝트는 **Feature-Sliced Design v2.1**과 **FSD 공식 Next.js 가이드**에 맞춰 구성되어 있습니다. Next.js `app/`은 라우트만 담당하고, 실제 레이어는 `src/` 아래에 있습니다.
-
-```
-_template/
-├── app/                    # Next.js App Router (루트) — 라우트·레이아웃 진입점만
-│   ├── layout.tsx         # 루트 레이아웃 (src/app에서 providers, styles import)
-│   └── (with-base-layout)/
-│       ├── layout.tsx     # BaseLayout 래퍼 (src/app/layouts에서 import)
-│       └── page.tsx       # re-export: export { MainPage as default } from '@/pages/home'
-│
-├── pages/                  # 빈 폴더 + README (Next.js가 src/pages를 Pages Router로 쓰지 않도록)
-│   └── README.md
-│
-└── src/                    # FSD 레이어 (실제 코드)
-    ├── app/                # App 레이어 (슬라이스 없음, 세그먼트만)
-    │   ├── providers/      # 전역 Providers (QueryClient 등)
-    │   ├── styles/         # 글로벌 스타일 (globals.css)
-    │   └── layouts/        # 공통 레이아웃 컴포넌트 (BaseLayoutWrapper)
-    │
-    ├── pages/              # Pages 레이어 (페이지 슬라이스)
-    │   └── home/
-    │       ├── ui/
-    │       └── index.ts    # Public API
-    │
-    ├── widgets/            # Widgets 레이어
-    ├── features/           # Features 레이어
-    ├── entities/           # Entities 레이어
-    └── shared/             # Shared 레이어
-        ├── ui/
-        ├── api/
-        ├── lib/
-        └── config/
-```
-
-### 계층 구조 이해하기
-
-FSD는 **3단계 계층**으로 구성됩니다:
-
-1. **Layers (레이어)**: 책임과 의존성에 따른 수평적 분리 (app, pages, widgets, features, entities, shared)
-2. **Slices (슬라이스)**: 비즈니스 도메인에 따른 수직적 분리 (user, product, auth-login 등)
-3. **Segments (세그먼트)**: 기술적 목적에 따른 분리 (ui, api, model, lib 등)
-
-> 📚 각 레이어의 자세한 설명은 해당 폴더의 README.md를 참고하세요.
-
-## FSD 레이어 설명
-
-FSD는 계층적 아키텍처로, 각 레이어는 책임의 범위와 의존성의 정도에 따라 구분됩니다. 7개의 표준화된 레이어가 있으며, 프로젝트에 필요한 레이어만 사용하면 됩니다.
-
-### 레이어 계층 구조 (위에서 아래로)
-
-```
-app/       ↑ 가장 높은 책임, 가장 많은 의존성
-pages/     |
-widgets/   |
-features/  |
-entities/  |
-shared/    ↓ 가장 낮은 책임, 의존성 없음
-```
-
-### 1. App
- **목적**: 앱 전체에 영향을 주는 기술적/비즈니스적 사항
- **내용**: Context providers, 글로벌 스타일, 스토어 설정, 라우터 설정, 애널리틱스
- **특징**: 슬라이스가 없고 세그먼트로만 구성
- **의존성**: 모든 하위 레이어 사용 가능
-
-### 2. Pages (src/pages)
- **목적**: 웹사이트나 애플리케이션을 구성하는 페이지/화면
- **내용**: 페이지 UI, 로딩 상태, 에러 바운더리, 데이터 fetching
- **특징**: 한 페이지당 한 슬라이스 (유사한 페이지는 그룹화 가능). Next.js `app/`의 route 파일에서 re-export
- **의존성**: `widgets`, `features`, `entities`, `shared` 사용 가능
-
-> 💡 **FSD v2.1 권장사항**: "pages-first" 접근 방식을 따라, 재사용되지 않는 큰 UI 블록과 비즈니스 로직은 페이지 슬라이스에 유지하세요.
-
-### 3. Widgets
- **목적**: 큰 규모의 독립적인 UI 블록
- **내용**: 여러 features와 entities를 조합한 복합 UI
- **사용 시기**: 여러 페이지에서 재사용되거나, 페이지에 여러 개의 큰 독립적 블록이 있을 때
- **의존성**: `features`, `entities`, `shared` 사용 가능 (다른 `widgets` 불가)
-
-### 4. Features
- **목적**: 사용자가 수행하는 주요 상호작용과 비즈니스 기능
- **내용**: 사용자 시나리오 (예: 로그인, 상품 검색, 댓글 작성)
- **사용 시기**: 여러 페이지에서 재사용되는 기능
- **의존성**: `entities`, `shared` 사용 가능 (다른 `features` 불가)
-
-### 5. Entities
- **목적**: 비즈니스가 다루는 실제 개념 (User, Product, Order 등)
- **내용**: 데이터 모델, 타입, API 요청, 엔티티의 시각적 표현
- **특징**: 비즈니스 용어로 명명
- **의존성**: 다른 `entities`, `shared` 사용 가능
-
-### 6. Shared
- **목적**: 애플리케이션의 기반 제공
- **내용**: API 클라이언트, UI Kit, 유틸리티 라이브러리, 글로벌 설정
- **특징**: 비즈니스 로직 없음, 슬라이스가 없고 세그먼트로만 구성
- **의존성**: 외부 라이브러리만 사용 가능 (다른 레이어 불가)
-
-## 시작하기
-
-```bash
-# 의존성 설치
-pnpm install
-
-# 개발 서버 실행
-pnpm run dev
-
-# 프로덕션 빌드
-pnpm run build
-
-# 프로덕션 서버 실행
-pnpm start
-```
-
-## 환경 변수
-
-`.env.local` 파일 생성:
-
-```env
-NEXT_PUBLIC_API_URL=http://localhost:3000/api
-```
-
-## FSD 핵심 규칙
-
-### 1. Import 규칙
-
-> **슬라이스 내의 모듈(파일)은 오직 하위 레이어에 있는 슬라이스만 import할 수 있습니다.**
-
-```typescript
-// ✅ 올바른 import (하위 레이어)
-// features/auth-login/ui/form.tsx
-import { User } from "entities/user";
-import { Button } from "shared/ui/button";
-
-// ❌ 잘못된 import (같은 레이어)
-// features/auth-login/ui/form.tsx
-import { PostForm } from "features/post-create";  // 금지!
-
-// ❌ 잘못된 import (상위 레이어)
-// features/auth-login/ui/form.tsx
-import { Header } from "widgets/header";  // 금지!
-```
-
-### 2. Public API 규칙
-
-> **슬라이스 외부에서는 Public API(index.ts)를 통해서만 접근해야 합니다.**
-
-```typescript
-// ✅ 올바른 import (Public API 사용)
-import { LoginForm } from "features/auth-login";
-
-// ❌ 잘못된 import (내부 구조 직접 접근)
-import { LoginForm } from "features/auth-login/ui/login-form";
-```
-
-**Public API 작성 시 주의사항**:
- 와일드카드 re-export(`export * from`) 사용 지양
- 필요한 것만 명시적으로 export
- 슬라이스의 인터페이스를 명확하게 표현
-
-```typescript
-// ❌ 나쁜 예시
-export * from "./ui/Comment";
-export * from "./model/comments";
-
-// ✅ 좋은 예시
-export { Comment } from "./ui/comment";
-export { CommentForm } from "./ui/comment-form";
-export { useComments } from "./model/use-comments";
-export type { Comment, CommentFormData } from "./model/types";
-```
@@ -1,10 +0,0 @@
-import type { ReactNode } from "react";
-import { BaseLayoutWrapper } from "@/app/layouts/base-layout";
-
-interface WithBaseLayoutProps {
-  children: ReactNode;
-}
-
-export default function WithBaseLayout({ children }: WithBaseLayoutProps) {
-  return <BaseLayoutWrapper>{children}</BaseLayoutWrapper>;
-}
@@ -1 +0,0 @@
-export { MainPage as default } from "@/pages/home";
@@ -1,169 +0,0 @@
-# App Layer
-
-**App**은 애플리케이션 전체에 영향을 미치는 기술적, 비즈니스적 사항을 다루는 최상위 레이어입니다.
-
-## 목적
-
- 애플리케이션의 진입점(entrypoint) 제공
- 전역 Context Providers 설정
- 라우터 구성
- 글로벌 스타일 정의
- 전역 상태 저장소 설정
- 애널리틱스 및 모니터링 설정
-
-## 특징
-
- **슬라이스 없음**: App 레이어는 Shared처럼 슬라이스가 없고 세그먼트로만 구성됩니다
- **전체 앱 관심사**: 특정 비즈니스 도메인이 아닌 앱 전체와 관련된 코드만 포함
- **최상위 레이어**: 모든 하위 레이어의 모듈을 자유롭게 import 가능
-
-## 구조 (Next.js App Router)
-
-Next.js를 사용하는 경우, App 레이어는 주로 `app/` 디렉토리로 표현됩니다:
-
-```
-app/
-├── (routes)/              # 라우트 그룹 및 페이지
-│   ├── (auth)/
-│   │   ├── login/
-│   │   │   └── page.tsx
-│   │   └── register/
-│   │       └── page.tsx
-│   └── (main)/
-│       ├── dashboard/
-│       │   └── page.tsx
-│       └── settings/
-│           └── page.tsx
-├── layout.tsx            # 루트 레이아웃
-├── page.tsx              # 홈 페이지
-├── globals.css           # 글로벌 스타일
-├── providers.tsx         # 전역 Providers 설정
-└── error.tsx             # 글로벌 에러 핸들러
-```
-
-### 일반적인 FSD 세그먼트 구조
-
-FSD 표준 세그먼트를 사용하는 경우:
-
-```
-app/
-├── entrypoint/           # 애플리케이션 진입점 (프레임워크별)
-│   └── index.tsx
-├── providers/            # Context Providers
-│   ├── query-provider.tsx
-│   ├── theme-provider.tsx
-│   └── index.tsx
-├── styles/               # 글로벌 스타일
-│   ├── globals.css
-│   └── theme.css
-├── store/                # 글로벌 상태 저장소 설정
-│   └── index.ts
-└── routes/               # 라우터 설정
-    └── index.tsx
-```
-
-## 예시
-
-### Next.js Providers 설정
-
-```typescript
-// app/providers.tsx
-'use client';
-
-import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
-import { ThemeProvider } from 'next-themes';
-import { useState } from 'react';
-
-export function Providers({ children }: { children: React.ReactNode }) {
-  const [queryClient] = useState(() => new QueryClient({
-    defaultOptions: {
-      queries: {
-        staleTime: 60 * 1000,
-      },
-    },
-  }));
-
-  return (
-    <QueryClientProvider client={queryClient}>
-      <ThemeProvider attribute="class" defaultTheme="system" enableSystem>
-        {children}
-      </ThemeProvider>
-    </QueryClientProvider>
-  );
-}
-
-// app/layout.tsx
-import { Providers } from './providers';
-import './globals.css';
-
-export default function RootLayout({
-  children,
-}: {
-  children: React.ReactNode;
-}) {
-  return (
-    <html lang="ko">
-      <body>
-        <Providers>
-          {children}
-        </Providers>
-      </body>
-    </html>
-  );
-}
-```
-
-### 글로벌 설정
-
-```typescript
-// app/config/analytics.ts
-export function initAnalytics() {
-  if (typeof window !== 'undefined') {
-    // 애널리틱스 초기화
-  }
-}
-
-// app/config/monitoring.ts
-export function initMonitoring() {
-  // 에러 모니터링 설정
-}
-```
-
-## Next.js App Router와 FSD
-
-Next.js의 `app/` 디렉토리는 FSD의 **App 레이어**와 **Pages 레이어**를 동시에 담당합니다:
-
- **루트 레벨 파일들** (`layout.tsx`, `providers.tsx`, `globals.css`): App 레이어
- **라우트 폴더들** (`dashboard/`, `login/` 등): Pages 레이어
-
-각 페이지별 비즈니스 로직은:
- 재사용되지 않는 UI는 페이지 슬라이스(`app/dashboard/` 등) 안에 유지
- 재사용되는 기능은 `features/` 레이어로 분리
- 여러 페이지에서 재사용되는 큰 UI 블록은 `widgets/` 레이어로 분리
-
-## 레이어 의존성 규칙
-
-✅ **허용되는 의존성**:
- 모든 하위 레이어 (`pages`, `widgets`, `features`, `entities`, `shared`)
- 같은 `app` 레이어 내의 다른 세그먼트
- 외부 라이브러리
-
-❌ **금지된 의존성**:
- 없음 (App은 최상위 레이어)
-
-## 주의사항
-
-1. **비대화 방지**: App 레이어가 너무 커지면 관리가 어려워집니다. 대부분의 로직은 하위 레이어에 배치하세요
-2. **전역 관심사만**: 특정 페이지나 기능에만 관련된 코드는 해당 레이어로 이동
-3. **라우터 레벨 로직**: 라우터 및 서버 레벨 로직은 이 레이어에 유지
-4. **Processes 레이어 사용 지양**: Processes 레이어는 deprecated되었으므로 해당 로직은 `app`이나 `features`에 배치
-
-## FSD v2.1 권장사항
-
-최신 FSD 버전(v2.1)은 **"pages-first"** 접근 방식을 권장합니다:
-
- 더 많은 코드를 페이지 슬라이스에 유지
- 큰 UI 블록과 재사용되지 않는 비즈니스 로직은 즉시 추출하지 말고 페이지에 보관
- 실제로 재사용이 필요할 때만 `features`나 `widgets`로 분리
-
-이 접근 방식은 과도한 추상화를 방지하고 코드를 더 쉽게 탐색할 수 있게 합니다.
@@ -1,25 +0,0 @@
-import type { Metadata } from "next";
-import { cookies } from "next/headers";
-import { Providers } from "@/app/providers";
-import "@/app/styles/globals.css";
-
-export const metadata: Metadata = {
-  title: "행정지원시스템",
-  description: "행정지원시스템",
-};
-
-interface RootLayoutProps {
-  children: React.ReactNode;
-}
-
-export default async function RootLayout({ children }: RootLayoutProps) {
-  const theme = (await cookies()).get("site-theme-key");
-
-  return (
-    <html lang="ko" data-theme={theme?.value}>
-      <body>
-        <Providers>{children}</Providers>
-      </body>
-    </html>
-  );
-}
@@ -1,18 +0,0 @@
-import { defineConfig, globalIgnores } from "eslint/config";
-import nextVitals from "eslint-config-next/core-web-vitals";
-import nextTs from "eslint-config-next/typescript";
-
-const eslintConfig = defineConfig([
-  ...nextVitals,
-  ...nextTs,
-  // Override default ignores of eslint-config-next.
-  globalIgnores([
-    // Default ignores of eslint-config-next:
-    ".next/**",
-    "out/**",
-    "build/**",
-    "next-env.d.ts",
-  ]),
-]);
-
-export default eslintConfig;
@@ -1,50 +0,0 @@
-import { NextRequest, NextResponse } from "next/server";
-import { PORT, PROXY_HOST, SERVER_API_URL, SITE_ID } from "@/shared/config";
-
-const serverApiUrl = process.env.SERVER_API_URL ?? "http://localhost:3000";
-
-// CSP 헤더 설정 함수 (img-src만)
-function addSecurityHeaders(response: NextResponse): NextResponse {
-  response.headers.set("Content-Security-Policy", "img-src 'self' data: https: blob:;");
-  return response;
-}
-
-export function middleware(req: NextRequest) {
-  const pathname = req.nextUrl.pathname;
-  const searchParams = req.nextUrl.searchParams;
-
-  const logMessages: string[] = [
-    `[Middleware Request] ${new Date().toISOString()}`,
-    `[Environment]\n  Mode: ${process.env.NODE_ENV}\n  Port: ${PORT}\n  Proxy Host: ${PROXY_HOST}\n  Server API URL: ${SERVER_API_URL}\n  Site ID: ${SITE_ID}`,
-    `[Request]\n  Original Pathname: ${pathname}`,
-  ];
-
-  if (pathname.startsWith("/server")) {
-    const queryParams = searchParams.toString();
-    const newUrl = `${serverApiUrl}${pathname.replace("/server", "")}${
-      queryParams ? `?${queryParams}` : ""
-    }`;
-
-    logMessages.push(`  Rewritten URL: ${newUrl}`);
-    logMessages.push("\n--------------------------------\n");
-    console.log(logMessages.join("\n"));
-
-    const response = NextResponse.rewrite(new URL(newUrl));
-    return addSecurityHeaders(response);
-  }
-
-  // if (pathname === "/") {
-  //   const response = NextResponse.redirect(new URL("/dashboard", req.url));
-  //   return addSecurityHeaders(response);
-  // }
-
-  logMessages.push("\n--------------------------------\n");
-  console.log(logMessages.join("\n"));
-
-  const response = NextResponse.next();
-  return addSecurityHeaders(response);
-}
-
-export const config = {
-  matcher: ["/server/:path*", "/"],
-};
@@ -1,8 +0,0 @@
-import type { NextConfig } from "next";
-
-const nextConfig: NextConfig = {
-  reactStrictMode: true,
-  transpilePackages: ["@common/assets"],
-};
-
-export default nextConfig;
@@ -1,36 +0,0 @@
-{
-  "name": "template",
-  "version": "0.1.0",
-  "private": true,
-  "scripts": {
-    "dev": "next dev",
-    "build": "next build",
-    "start": "next start",
-    "lint": "next lint",
-    "lint:fsd": "steiger ."
-  },
-  "dependencies": {
-    "@common/assets": "workspace:*",
-    "@common/components": "workspace:*",
-    "@common/network": "workspace:*",
-    "@hookform/resolvers": "^4.1.3",
-    "@tanstack/react-query": "^5.75.5",
-    "@tanstack/react-query-devtools": "^5.75.5",
-    "@tanstack/react-table": "^8.21.2",
-    "axios": "^1.8.1",
-    "dayjs": "^1.11.13",
-    "next": "15.5.18",
-    "react-hook-form": "^7.54.2",
-    "zod": "^3.24.2"
-  },
-  "devDependencies": {
-    "eslint": "^9.0.0",
-    "eslint-config-next": "15.3.8",
-    "postcss": "^8.4.49",
-    "prettier": "^3.4.2",
-    "prettier-plugin-tailwindcss": "^0.6.11",
-    "steiger": "^0.5.11",
-    "tailwindcss": "^3.4.14",
-    "typescript": "^5.7.2"
-  }
-}
@@ -1,9 +0,0 @@
-# 이 폴더는 비워 둡니다 (FSD + Next.js App Router)
-
-Next.js가 `src/pages`를 **Pages Router**용 `pages` 디렉터리로 인식하지 않도록,  
-프로젝트 루트에 **빈 `pages` 폴더**를 두는 것이 FSD 공식 가이드 권장사항입니다.
-
- 실제 페이지(FSD Pages 레이어)는 **`src/pages`**에 있습니다.
- Next.js 라우트는 **`app/`** 에서 `src/pages`를 re-export 하는 방식으로 연결됩니다.
-
-[Feature-Sliced Design - Usage with Next.js (App Router)](https://feature-sliced.design/docs/guides/tech/with-nextjs)
@@ -1,8 +0,0 @@
-/** @type {import('postcss-load-config').Config} */
-const config = {
-  plugins: {
-    tailwindcss: {},
-  },
-};
-
-export default config;
@@ -1,35 +0,0 @@
-"use client";
-
-import { useCallback } from "react";
-import { usePathname, useRouter } from "next/navigation";
-import { useQueryClient } from "@tanstack/react-query";
-import { BaseLayout } from "@common/components";
-import type { MenuItem } from "@/entities/menu";
-import { PageLayout } from "@/shared/ui/page-layout";
-
-interface BaseLayoutWrapperProps {
-  children: React.ReactNode;
-}
-
-export function BaseLayoutWrapper({ children }: BaseLayoutWrapperProps) {
-  const router = useRouter();
-  const pathname = usePathname();
-  const queryClient = useQueryClient();
-
-  const handleMenuClick = useCallback(
-    (item: MenuItem) => {
-      router.push(item.urlPath);
-    },
-    [router],
-  );
-
-  return (
-    <BaseLayout
-      queryClient={queryClient}
-      currentPath={pathname ?? ""}
-      handleMenuClick={handleMenuClick}
-    >
-      <PageLayout>{children}</PageLayout>
-    </BaseLayout>
-  );
-}
@@ -1,18 +0,0 @@
-"use client";
-
-import { QueryClientProvider } from "@tanstack/react-query";
-import { ReactQueryDevtools } from "@tanstack/react-query-devtools";
-import { queryClient } from "@/shared/lib";
-
-interface ProvidersProps {
-  children: React.ReactNode;
-}
-
-export function Providers({ children }: ProvidersProps) {
-  return (
-    <QueryClientProvider client={queryClient}>
-      {children}
-      <ReactQueryDevtools initialIsOpen={false} />
-    </QueryClientProvider>
-  );
-}
@@ -1,15 +0,0 @@
-@import "@common/assets/styles/base.css";
-@import "@common/assets/styles/diveicon.css";
-@import "@common/components/index.css";
-
-@tailwind base;
-@tailwind components;
-@tailwind utilities;
-
-html,
-body {
-  color: var(--foreground);
-  background: var(--background);
-  font-family: "Noto Sans KR", sans-serif;
-  font-size: 10px;
-}
@@ -1,114 +0,0 @@
-# Entities Layer
-
-**Entities**는 프로젝트가 다루는 실제 비즈니스 개념을 나타내는 레이어입니다. 비즈니스에서 제품을 설명할 때 사용하는 용어들(예: User, Product, Order)이 주로 엔티티가 됩니다.
-
-## 목적
-
- 비즈니스 엔티티의 데이터 모델 및 타입 정의
- 엔티티 관련 API 요청 함수 관리
- 엔티티의 시각적 표현 제공 (재사용 가능한 UI)
- 여러 페이지에서 동일한 외관을 재사용할 수 있도록 지원
-
-## 구조
-
-각 엔티티 슬라이스는 다음 세그먼트로 구성됩니다:
-
-```
-entities/
-└── [entity-name]/
-    ├── model/         # 데이터 저장소, 검증 스키마, 상태 관리
-    ├── api/           # 엔티티 관련 API 요청 함수
-    ├── ui/            # 엔티티 시각적 표현 (선택적)
-    ├── lib/           # 엔티티 관련 유틸리티 (선택적)
-    ├── @x/            # 다른 엔티티로부터의 cross-import용 Public API (선택적)
-    └── index.ts       # Public API
-```
-
-### 세그먼트 설명
-
- **model**: 데이터 모델, 타입 정의, 상태 저장소 (Zustand 등)
- **api**: 백엔드 API 호출 함수
- **ui**: 엔티티를 표시하는 UI 컴포넌트 (완전한 UI 블록이 아니라 재사용 가능한 표현)
- **lib**: 엔티티 관련 유틸리티 함수
- **@x**: 다른 엔티티가 이 엔티티를 import할 때 사용하는 명시적 cross-import API
- **index.ts**: 슬라이스의 Public API (외부에서 사용할 수 있는 것만 export)
-
-## 예시
-
-```typescript
-// entities/user/model/user.ts
-export interface User {
-  id: string;
-  name: string;
-  email: string;
-  role: 'admin' | 'user';
-}
-
-// entities/user/api/get-user.ts
-import type { User } from '../model/user';
-
-export async function getUser(id: string): Promise<User> {
-  const response = await fetch(`/api/users/${id}`);
-  return response.json();
-}
-
-// entities/user/ui/user-card.tsx
-import type { User } from '../model/user';
-
-interface UserCardProps {
-  user: User;
-  onClick?: () => void;
-}
-
-export function UserCard({ user, onClick }: UserCardProps) {
-  return (
-    <div onClick={onClick}>
-      <h3>{user.name}</h3>
-      <p>{user.email}</p>
-    </div>
-  );
-}
-
-// entities/user/index.ts
-export { type User } from './model/user';
-export { getUser } from './api/get-user';
-export { UserCard } from './ui/user-card';
-```
-
-## 엔티티 간 관계
-
-엔티티가 서로 연결되어 있을 때는 `@x` 표기법을 사용하여 명시적으로 cross-import를 관리하는 것이 권장됩니다:
-
-```typescript
-// entities/artist/model/artist.ts
-import type { Song } from 'entities/song/@x/artist';
-
-export interface Artist {
-  name: string;
-  songs: Array<Song>;
-}
-
-// entities/song/@x/artist.ts
-export type { Song } from '../model/song';
-```
-
-> `@x` 폴더를 사용하면 엔티티 간 연결을 명확하게 만들어 함께 리팩터링이 필요한 코드를 쉽게 찾을 수 있습니다.
-
-## 레이어 의존성 규칙
-
-✅ **허용되는 의존성**:
- `shared` 레이어의 모듈
- 같은 엔티티 슬라이스 내의 다른 세그먼트
- 다른 엔티티 슬라이스 (필요한 경우, `@x` 표기법 권장)
-
-❌ **금지된 의존성**:
- `features` 레이어
- `widgets` 레이어
- `pages` 레이어
- `app` 레이어
-
-## 주의사항
-
-1. **UI 컴포넌트는 완전한 비즈니스 로직을 포함하지 않음**: UI는 주로 props나 slots를 통해 다양한 비즈니스 로직을 연결할 수 있도록 설계
-2. **엔티티 간 비즈니스 로직은 상위 레이어에**: 엔티티 간 상호작용의 비즈니스 로직은 Features나 Pages 레이어에서 처리
-3. **데이터 관리에 집중**: 복잡한 비즈니스 로직보다는 데이터 모델, 검증, 저장에 집중
@@ -1 +0,0 @@
-export { type MenuItem } from "./model/types";
@@ -1,19 +0,0 @@
-export interface MenuItem {
-  menuCd: number;
-  menuKornNm: string;
-  menuEngNm: string;
-  parentId: number | null;
-  sortSeq: number;
-  iconNm?: string;
-  children: MenuItem[] | null;
-  levelNo: number;
-  urlPath: string;
-  menuLnkgTypeCd: string;
-  menuLnkgSn: number;
-  menuPath: string;
-  qrcd: string;
-  useYn: string;
-  otptYn: string;
-  newWndwYn: string;
-  requiredUrlPath: boolean;
-}
@@ -1,133 +0,0 @@
-# Features Layer
-
-**Features**는 앱의 주요 사용자 상호작용과 기능을 구현하는 레이어입니다. 사용자가 실제로 수행하는 작업들로, 주로 비즈니스 엔티티와 관련이 있습니다.
-
-## 목적
-
- 사용자가 중요하게 생각하는 주요 상호작용 구현
- 재사용 가능한 비즈니스 기능 제공
- 여러 페이지에서 사용되는 기능의 중복 제거
-
-## Feature로 만들어야 하는 경우
-
-> ⚠️ **중요**: 모든 것을 feature로 만들 필요는 없습니다.
-
-Feature로 만드는 것이 좋은 지표:
-
- **여러 페이지에서 재사용됨**: 예를 들어, 여러 에디터가 있고 모두 댓글 기능이 있다면, 댓글은 재사용 가능한 feature입니다
- **중요한 비즈니스 기능**: 신규 프로젝트 참여자가 Features 폴더를 보고 앱의 주요 기능을 빠르게 파악할 수 있어야 합니다
-
-Feature가 너무 많으면 중요한 기능이 묻히므로, 신규 참여자의 경험을 최적화하여 결정하세요.
-
-## 구조
-
-각 feature 슬라이스는 다음 세그먼트로 구성됩니다:
-
-```
-features/
-└── [feature-name]/
-    ├── ui/            # 상호작용을 수행하는 UI (폼, 버튼 등)
-    ├── api/           # 액션 수행에 필요한 API 호출 (선택적)
-    ├── model/         # 검증 및 내부 상태 관리 (선택적)
-    ├── lib/           # 유틸리티 함수 (선택적)
-    ├── config/        # feature flags (선택적)
-    └── index.ts       # Public API
-```
-
-### 세그먼트 설명
-
- **ui**: 사용자 상호작용을 위한 UI 컴포넌트 (폼, 모달, 버튼 등)
- **api**: feature 실행에 필요한 API 요청 함수
- **model**: 폼 검증, 내부 상태, 비즈니스 로직
- **lib**: feature 내부에서만 사용되는 유틸리티
- **config**: feature flags, feature별 설정값
- **index.ts**: 슬라이스의 Public API (외부에서 사용할 수 있는 것만 export)
-
-## 예시
-
-```typescript
-// features/auth-login/ui/login-form.tsx
-import { useState } from 'react';
-import { loginUser } from '../api/login-user';
-import type { LoginCredentials } from '../model/types';
-
-export function LoginForm() {
-  const [credentials, setCredentials] = useState<LoginCredentials>({
-    email: '',
-    password: ''
-  });
-
-  const handleSubmit = async (e: React.SubmitEvent) => {
-    e.preventDefault();
-    await loginUser(credentials);
-  };
-
-  return (
-    <form onSubmit={handleSubmit}>
-      <input
-        type="email"
-        value={credentials.email}
-        onChange={(e) => setCredentials({ ...credentials, email: e.target.value })}
-      />
-      <input
-        type="password"
-        value={credentials.password}
-        onChange={(e) => setCredentials({ ...credentials, password: e.target.value })}
-      />
-      <button type="submit">로그인</button>
-    </form>
-  );
-}
-
-// features/auth-login/api/login-user.ts
-import type { LoginCredentials } from '../model/types';
-
-export async function loginUser(credentials: LoginCredentials) {
-  const response = await fetch('/api/auth/login', {
-    method: 'POST',
-    body: JSON.stringify(credentials),
-  });
-  return response.json();
-}
-
-// features/auth-login/model/types.ts
-export interface LoginCredentials {
-  email: string;
-  password: string;
-}
-
-// features/auth-login/index.ts
-export { LoginForm } from './ui/login-form';
-export { loginUser } from './api/login-user';
-export type { LoginCredentials } from './model/types';
-```
-
-## 레이어 의존성 규칙
-
-✅ **허용되는 의존성**:
-
- `shared` 레이어의 모듈
- `entities` 레이어의 모듈
- 같은 feature 슬라이스 내의 다른 세그먼트
-
-❌ **금지된 의존성**:
-
- 다른 `features` 슬라이스 (feature 간 직접 의존 금지)
- `widgets` 레이어
- `pages` 레이어
- `app` 레이어
-
-> 💡 **팁**: 여러 features가 공통 기능을 필요로 한다면, 그 기능을 `shared` 레이어로 이동시키거나 `entities` 레이어에서 관리하세요.
-
-## 명명 규칙
-
- 소문자와 대시 사용: `auth-login`, `post-create`, `comment-edit`
- 동사 형태 권장: 사용자 액션을 나타내는 이름 사용
- 명확하고 구체적으로: 기능의 목적이 명확하게 드러나도록
-
-## 주의사항
-
-1. **하나의 기능에만 집중**: 각 feature는 단일 사용자 시나리오를 구현해야 합니다
-2. **재사용성 고려**: 여러 페이지에서 사용될 수 있도록 설계
-3. **독립성 유지**: 다른 features에 의존하지 않고 독립적으로 작동
-4. **적절한 추상화**: 너무 많은 feature를 만들지 말고, 중요한 기능 위주로 구성
@@ -1 +0,0 @@
-export { MainPage } from "./ui/main-page";
@@ -1,9 +0,0 @@
-"use client";
-
-export function MainPage() {
-  return (
-    <div className="flex h-full flex-col items-center justify-center py-10">
-      <h1 className="mb-4 text-3xl font-bold">Home</h1>
-    </div>
-  );
-}
@@ -1,149 +0,0 @@
-# Shared Layer
-
-**Shared**는 애플리케이션의 기반을 형성하는 레이어입니다. 외부 세계(백엔드, 서드파티 라이브러리, 환경)와의 연결을 생성하고, 높은 응집력을 가진 자체 라이브러리를 정의하는 곳입니다.
-
-## 목적
-
- 외부 시스템 및 라이브러리와의 통합
- 프로젝트 전체에서 사용되는 공통 코드 제공
- 비즈니스 로직이 없는 재사용 가능한 유틸리티 및 UI 제공
- 글로벌 설정 및 환경 변수 관리
-
-## 특징
-
- **슬라이스 없음**: Shared 레이어는 비즈니스 도메인이 없으므로 슬라이스로 나뉘지 않습니다
- **세그먼트 구성**: 기술적 목적에 따라 세그먼트로 직접 구성됩니다
- **자유로운 import**: Shared 내의 모든 파일은 서로를 참조하고 import할 수 있습니다
-
-## 구조
-
-```
-shared/
-├── ui/                # 애플리케이션 UI Kit
-│   ├── button/
-│   ├── input/
-│   ├── modal/
-│   └── index.ts
-├── api/               # API 클라이언트 및 백엔드 엔드포인트 함수
-│   ├── client.ts
-│   └── index.ts
-├── lib/               # 내부 라이브러리 모음
-│   ├── dates/         # 날짜 관련 유틸리티
-│   ├── colors/        # 색상 관련 유틸리티
-│   ├── text/          # 텍스트 처리 유틸리티
-│   └── index.ts
-├── config/            # 환경 변수, 글로벌 feature flags
-│   ├── env.ts
-│   └── index.ts
-├── types/             # 공통 타입 정의
-│   └── index.ts
-├── i18n/              # 번역 설정, 글로벌 번역 문자열
-│   └── index.ts
-└── routes/            # 라우트 상수 또는 패턴
-    └── index.ts
-```
-
-## 세그먼트 설명
-
-### 📁 ui
-애플리케이션의 UI Kit로, 비즈니스 로직을 포함하지 않는 재사용 가능한 UI 컴포넌트들입니다.
-
- Button, Input, Modal 같은 기본 컴포넌트
- 비즈니스 로직은 없지만 UI 로직은 포함 가능 (예: Autocomplete, SearchBar)
- 비즈니스 테마 컴포넌트도 허용 (예: 회사 로고, 페이지 레이아웃)
-
-### 📁 api
-API 클라이언트 및 특정 백엔드 엔드포인트 요청 함수입니다.
-
- HTTP 클라이언트 설정 (Axios, Fetch 등)
- 인증 인터셉터
- 공통 에러 핸들링
-
-### 📁 lib
-내부 라이브러리 모음으로, 각 라이브러리는 **하나의 관심사**에 집중해야 합니다.
-
-> ⚠️ **중요**: `helpers`나 `utils` 폴더처럼 덤프 폴더로 만들지 마세요. 각 라이브러리는 명확한 초점 영역(예: dates, colors, text)을 가져야 하며, README로 문서화해야 합니다.
-
-### 📁 config
-환경 변수, 글로벌 feature flags 및 앱 전체 설정입니다.
-
-### 📁 types
-프로젝트 전체에서 사용되는 공통 타입 정의입니다.
-
-### 📁 i18n
-번역 설정 코드 및 글로벌 번역 문자열입니다.
-
-### 📁 routes
-라우트 상수 또는 라우트 매칭 패턴입니다.
-
-## 예시
-
-```typescript
-// shared/ui/button/button.tsx
-interface ButtonProps {
-  children: React.ReactNode;
-  variant?: 'primary' | 'secondary';
-  onClick?: () => void;
-}
-
-export function Button({ children, variant = 'primary', onClick }: ButtonProps) {
-  return (
-    <button
-      className={variant === 'primary' ? 'bg-blue-500' : 'bg-gray-500'}
-      onClick={onClick}
-    >
-      {children}
-    </button>
-  );
-}
-
-// shared/api/client.ts
-import axios from 'axios';
-
-export const apiClient = axios.create({
-  baseURL: process.env.NEXT_PUBLIC_API_URL,
-  timeout: 10000,
-});
-
-// shared/lib/dates/format-date.ts
-import dayjs from 'dayjs';
-
-export function formatDate(date: Date, format: string = 'YYYY-MM-DD'): string {
-  return dayjs(date).format(format);
-}
-
-// shared/config/env.ts
-export const ENV = {
-  apiUrl: process.env.NEXT_PUBLIC_API_URL!,
-  isDev: process.env.NODE_ENV === 'development',
-} as const;
-```
-
-## 레이어 의존성 규칙
-
-✅ **허용되는 의존성**:
- 같은 `shared` 레이어 내의 다른 세그먼트 (자유로운 cross-import)
- 외부 라이브러리 및 패키지
-
-❌ **금지된 의존성**:
- `entities` 레이어
- `features` 레이어
- `widgets` 레이어
- `pages` 레이어
- `app` 레이어
-
-> 💡 **원칙**: Shared는 가장 낮은 레이어이므로 상위 레이어에 의존하지 않습니다.
-
-## 세그먼트 명명 규칙
-
-세그먼트 이름은 **내용의 목적**을 설명해야 하며, **본질**을 설명하면 안 됩니다.
-
-❌ **나쁜 예시**: `components`, `hooks`, `types` (본질을 설명)
-✅ **좋은 예시**: `ui`, `api`, `lib/dates`, `config` (목적을 설명)
-
-## 주의사항
-
-1. **비즈니스 로직 없음**: Shared는 순수한 기술적 코드만 포함
-2. **높은 재사용성**: 앱 전체에서 사용될 수 있어야 함
-3. **명확한 라이브러리 구조**: `lib` 내부는 관심사별로 명확하게 분리
-4. **문서화**: 각 라이브러리는 README로 사용법과 목적을 문서화
@@ -1,9 +0,0 @@
-import { Client } from "@common/network";
-import { PROXY_HOST, SITE_ID } from "@/shared/config/env";
-
-const BASE_URL = `${PROXY_HOST}/server`;
-
-export const apiClient = Client.getInstance({
-  baseURL: BASE_URL,
-  siteId: SITE_ID,
-});
@@ -1 +0,0 @@
-export { apiClient } from "./client";
@@ -1,8 +0,0 @@
-export const PORT = process.env.NEXT_PUBLIC_PORT || "3000";
-export const PROXY_HOST = process.env.NEXT_PUBLIC_PROXY_HOST || `http://localhost:${PORT}`;
-export const SITE_ID = process.env.NEXT_PUBLIC_SITE_ID || "AS";
-export const SERVER_API_URL = process.env.SERVER_API_URL;
-export const CLAIM_NAME = process.env.NEXT_PUBLIC_CLAIM_NAME || "Authorization";
-export const ACCESS_TOKEN = process.env.NEXT_PUBLIC_ACCESS_TOKEN || "access-token";
-export const REFRESH_TOKEN = process.env.NEXT_PUBLIC_REFRESH_TOKEN || "refresh-token";
-export const AUTH_USER_ID = process.env.NEXT_PUBLIC_AUTH_USER_ID || "token-id";
@@ -1 +0,0 @@
-export * from "./env";
@@ -1,12 +0,0 @@
-import dayjs from "dayjs";
-import "dayjs/locale/ko";
-import utc from "dayjs/plugin/utc";
-import timezone from "dayjs/plugin/timezone";
-import relativeTime from "dayjs/plugin/relativeTime";
-
-dayjs.extend(utc);
-dayjs.extend(timezone);
-dayjs.extend(relativeTime);
-dayjs.locale("ko");
-
-export { dayjs };
@@ -1,2 +0,0 @@
-export { queryClient } from "./query-client";
-export { dayjs } from "./dayjs";
@@ -1,11 +0,0 @@
-import { QueryClient } from "@tanstack/react-query";
-
-export const queryClient = new QueryClient({
-  defaultOptions: {
-    queries: {
-      retry: 1,
-      refetchOnWindowFocus: false,
-      staleTime: 60 * 1000,
-    },
-  },
-});
@@ -1,29 +0,0 @@
-export interface BaseEntity {
-  id: string;
-  createdAt: string;
-  updatedAt: string;
-}
-
-export interface PaginationParams {
-  page: number;
-  limit: number;
-}
-
-export interface PaginationResponse<T> {
-  data: T[];
-  total: number;
-  page: number;
-  limit: number;
-}
-
-export interface ApiResponse<T> {
-  success: boolean;
-  data: T;
-  message?: string;
-}
-
-export interface ApiError {
-  message: string;
-  code?: string;
-  status?: number;
-}
@@ -1 +0,0 @@
-export { PageLayout } from "./page-layout";
@@ -1,35 +0,0 @@
-"use client";
-
-import { PageTitle } from "@common/components";
-
-const mockCurrentMenuInfo = {
-  menuCd: 0,
-  menuKornNm: "메인",
-  menuEngNm: "Main",
-  parentId: null,
-  sortSeq: 0,
-  children: null,
-  levelNo: 0,
-  urlPath: "/",
-  menuLnkgTypeCd: "",
-  menuLnkgSn: 0,
-  menuPath: "메인",
-  qrcd: "",
-  useYn: "Y",
-  otptYn: "Y",
-  newWndwYn: "N",
-  requiredUrlPath: false,
-};
-
-function PageLayout({ children }: { children: React.ReactNode }) {
-  const menuPaths = mockCurrentMenuInfo.menuPath.split(">").map((path) => path.trim());
-
-  return (
-    <div className="bg-container h-auto min-h-full pb-2">
-      <PageTitle title={mockCurrentMenuInfo.menuKornNm} menuPaths={menuPaths} />
-      {children}
-    </div>
-  );
-}
-
-export { PageLayout };
@@ -1,135 +0,0 @@
-# Widgets Layer
-
-**Widgets**는 큰 규모의 독립적인 UI 블록을 위한 레이어입니다. 여러 features와 entities를 조합하여 완전한 기능을 제공하는 복합 컴포넌트를 담습니다.
-
-## 목적
-
- 큰 규모의 독립적인 UI 블록 구성
- 여러 features와 entities를 하나의 응집력 있는 UI로 결합
- 여러 페이지에서 재사용되는 복잡한 UI 제공
- 페이지 레벨 레이아웃 및 섹션 관리
-
-## Widget으로 만들어야 하는 경우
-
-Widget은 다음 조건에 해당할 때 사용하세요:
-
-✅ **Widget으로 만들기 좋은 경우**:
- 여러 페이지에서 재사용되는 큰 UI 블록
- 페이지에 여러 개의 큰 독립적 블록이 있고, 이것이 그 중 하나인 경우
- 페이지 레벨 레이아웃 컴포넌트 (nested routing 시스템 사용 시)
-
-❌ **Widget으로 만들지 말아야 하는 경우**:
- UI 블록이 페이지의 대부분을 차지하고 재사용되지 않는 경우 → 페이지 슬라이스 내부에 직접 배치
- 작은 재사용 컴포넌트 → `shared/ui`에 배치
-
-## 구조
-
-각 widget 슬라이스는 다음 세그먼트로 구성됩니다:
-
-```
-widgets/
-└── [widget-name]/
-    ├── ui/            # 위젯의 메인 UI 컴포넌트
-    ├── model/         # 위젯 내부 상태 관리 (선택적)
-    ├── api/           # 위젯 전용 API 호출 (선택적)
-    ├── lib/           # 위젯 내부 유틸리티 (선택적)
-    └── index.ts       # Public API
-```
-
-### 세그먼트 설명
-
- **ui**: 여러 features와 entities를 조합한 위젯 UI
- **model**: 위젯 내부 상태 및 로직 (선택적)
- **api**: 위젯이 필요로 하는 데이터 fetching (선택적)
- **lib**: 위젯 내부에서만 사용되는 헬퍼 함수 (선택적)
- **index.ts**: 슬라이스의 Public API (외부에서 사용할 수 있는 것만 export)
-
-## 예시
-
-```typescript
-// widgets/header/ui/header.tsx
-import { Logo } from 'shared/ui/logo';
-import { Navigation } from 'shared/ui/navigation';
-import { UserMenu } from 'features/user-menu';
-import { NotificationBell } from 'features/notifications';
-
-export function Header() {
-  return (
-    <header>
-      <Logo />
-      <Navigation />
-      <NotificationBell />
-      <UserMenu />
-    </header>
-  );
-}
-
-// widgets/product-list/ui/product-list.tsx
-import { useProducts } from '../api/use-products';
-import { ProductCard } from 'entities/product';
-import { AddToCartButton } from 'features/cart-add-item';
-
-export function ProductList() {
-  const { data: products, isLoading } = useProducts();
-
-  if (isLoading) return <div>로딩 중...</div>;
-
-  return (
-    <div>
-      {products.map((product) => (
-        <div key={product.id}>
-          <ProductCard product={product} />
-          <AddToCartButton productId={product.id} />
-        </div>
-      ))}
-    </div>
-  );
-}
-
-// widgets/product-list/api/use-products.ts
-import { useQuery } from '@tanstack/react-query';
-import { getProducts } from 'entities/product';
-
-export function useProducts() {
-  return useQuery({
-    queryKey: ['products'],
-    queryFn: getProducts,
-  });
-}
-
-// widgets/product-list/index.ts
-export { ProductList } from './ui/product-list';
-```
-
-## 레이어 의존성 규칙
-
-✅ **허용되는 의존성**:
- `shared` 레이어의 모듈
- `entities` 레이어의 모듈
- `features` 레이어의 모듈
- 같은 widget 슬라이스 내의 다른 세그먼트
-
-❌ **금지된 의존성**:
- 다른 `widgets` 슬라이스 (widget 간 직접 의존 금지)
- `pages` 레이어
- `app` 레이어
-
-## 명명 규칙
-
- 소문자와 대시 사용: `header`, `sidebar`, `product-list`
- 명사 형태 권장: UI 블록의 성격을 나타내는 이름 사용
- 구체적으로: 위젯의 역할이 명확하게 드러나도록
-
-## Nested Routing 사용 시
-
-Remix 같은 nested routing 시스템을 사용한다면:
- Widgets 레이어를 flat routing의 Pages 레이어처럼 사용 가능
- 완전한 라우터 블록 생성 (데이터 fetching, loading states, error boundaries 포함)
- 페이지 레이아웃을 이 레이어에 저장 가능
-
-## 주의사항
-
-1. **독립성 유지**: 각 위젯은 독립적으로 작동 가능해야 합니다
-2. **적절한 크기**: 너무 작은 컴포넌트는 `shared/ui`에, 재사용되지 않으면 `pages`에 배치
-3. **응집력**: 관련된 features와 entities를 의미 있게 조합
-4. **재사용 최적화**: 여러 페이지에서 동일한 방식으로 사용될 수 있도록 설계
@@ -1,26 +0,0 @@
-import type { Config } from "tailwindcss";
-import presetConfig from "../../tailwind.config.preset";
-
-const config: Config = {
-  presets: [presetConfig],
-  content: [
-    "./pages/**/*.{js,ts,jsx,tsx,mdx}",
-    "./shared/**/*.{js,ts,jsx,tsx,mdx}",
-    "./entities/**/*.{js,ts,jsx,tsx,mdx}",
-    "./features/**/*.{js,ts,jsx,tsx,mdx}",
-    "./widgets/**/*.{js,ts,jsx,tsx,mdx}",
-    "./app/**/*.{js,ts,jsx,tsx,mdx}",
-    "../../packages/common/components/dist/**/*.{js,ts,jsx,tsx,mdx}",
-  ],
-  theme: {
-    extend: {
-      colors: {
-        background: "var(--background)",
-        foreground: "var(--foreground)",
-      },
-    },
-  },
-  plugins: [],
-};
-
-export default config;
@@ -1,33 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2017",
-    "lib": ["dom", "dom.iterable", "esnext"],
-    "allowJs": true,
-    "skipLibCheck": true,
-    "strict": true,
-    "noEmit": true,
-    "esModuleInterop": true,
-    "module": "esnext",
-    "moduleResolution": "bundler",
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "jsx": "preserve",
-    "incremental": true,
-    "plugins": [
-      {
-        "name": "next"
-      }
-    ],
-    "paths": {
-      "@/*": ["./src/*"]
-    }
-  },
-  "include": [
-    "next-env.d.ts",
-    "**/*.ts",
-    "**/*.tsx",
-    ".next/types/**/*.ts",
-    "../../packages/common/types/**/*.d.ts"
-  ],
-  "exclude": ["node_modules", ".next", "dist", "coverage", "storybook-static", "public"]
-}
@@ -1,3 +0,0 @@
-{
-  "extends": "next/core-web-vitals"
-}
@@ -1,36 +0,0 @@
-# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
-
-# dependencies
-/node_modules
-/.pnp
-.pnp.js
-.yarn/install-state.gz
-
-# testing
-/coverage
-
-# next.js
-/.next/
-/out/
-
-# production
-/build
-
-# misc
-.DS_Store
-*.pem
-
-# debug
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-
-# local env files
-.env.*
-
-# vercel
-.vercel
-
-# typescript
-*.tsbuildinfo
-next-env.d.ts
@@ -1,8 +0,0 @@
-{
-  "semi": true,
-  "trailingComma": "all",
-  "singleQuote": false,
-  "printWidth": 100,
-  "tabWidth": 2,
-  "plugins": ["prettier-plugin-tailwindcss"]
-}
@@ -1,187 +0,0 @@
-# Template Application
-
-Next.js 애플리케이션 with FSD(Feature Sliced Design) 아키텍처
-
-## 기술 스택
-
- **프레임워크**: Next.js 15 + TypeScript
- **스타일링**: Tailwind CSS
- **상태관리**: Zustand
- **데이터 페칭**: TanStack Query (React Query)
- **폼 관리**: React Hook Form + Zod
- **테이블**: TanStack Table
- **HTTP 클라이언트**: Axios
- **날짜 처리**: Day.js
-
-## 프로젝트 구조 (FSD + Next.js App Router)
-
-이 프로젝트는 **Feature-Sliced Design v2.1**과 **FSD 공식 Next.js 가이드**에 맞춰 구성되어 있습니다. Next.js `app/`은 라우트만 담당하고, 실제 레이어는 `src/` 아래에 있습니다.
-
-```
-_template/
-├── app/                    # Next.js App Router (루트) — 라우트·레이아웃 진입점만
-│   ├── layout.tsx         # 루트 레이아웃 (src/app에서 providers, styles import)
-│   └── (with-base-layout)/
-│       ├── layout.tsx     # BaseLayout 래퍼 (src/app/layouts에서 import)
-│       └── page.tsx       # re-export: export { MainPage as default } from '@/pages/home'
-│
-├── pages/                  # 빈 폴더 + README (Next.js가 src/pages를 Pages Router로 쓰지 않도록)
-│   └── README.md
-│
-└── src/                    # FSD 레이어 (실제 코드)
-    ├── app/                # App 레이어 (슬라이스 없음, 세그먼트만)
-    │   ├── providers/      # 전역 Providers (QueryClient 등)
-    │   ├── styles/         # 글로벌 스타일 (globals.css)
-    │   └── layouts/        # 공통 레이아웃 컴포넌트 (BaseLayoutWrapper)
-    │
-    ├── pages/              # Pages 레이어 (페이지 슬라이스)
-    │   └── home/
-    │       ├── ui/
-    │       └── index.ts    # Public API
-    │
-    ├── widgets/            # Widgets 레이어
-    ├── features/           # Features 레이어
-    ├── entities/           # Entities 레이어
-    └── shared/             # Shared 레이어
-        ├── ui/
-        ├── api/
-        ├── lib/
-        └── config/
-```
-
-### 계층 구조 이해하기
-
-FSD는 **3단계 계층**으로 구성됩니다:
-
-1. **Layers (레이어)**: 책임과 의존성에 따른 수평적 분리 (app, pages, widgets, features, entities, shared)
-2. **Slices (슬라이스)**: 비즈니스 도메인에 따른 수직적 분리 (user, product, auth-login 등)
-3. **Segments (세그먼트)**: 기술적 목적에 따른 분리 (ui, api, model, lib 등)
-
-> 📚 각 레이어의 자세한 설명은 해당 폴더의 README.md를 참고하세요.
-
-## FSD 레이어 설명
-
-FSD는 계층적 아키텍처로, 각 레이어는 책임의 범위와 의존성의 정도에 따라 구분됩니다. 7개의 표준화된 레이어가 있으며, 프로젝트에 필요한 레이어만 사용하면 됩니다.
-
-### 레이어 계층 구조 (위에서 아래로)
-
-```
-app/       ↑ 가장 높은 책임, 가장 많은 의존성
-pages/     |
-widgets/   |
-features/  |
-entities/  |
-shared/    ↓ 가장 낮은 책임, 의존성 없음
-```
-
-### 1. App
- **목적**: 앱 전체에 영향을 주는 기술적/비즈니스적 사항
- **내용**: Context providers, 글로벌 스타일, 스토어 설정, 라우터 설정, 애널리틱스
- **특징**: 슬라이스가 없고 세그먼트로만 구성
- **의존성**: 모든 하위 레이어 사용 가능
-
-### 2. Pages (src/pages)
- **목적**: 웹사이트나 애플리케이션을 구성하는 페이지/화면
- **내용**: 페이지 UI, 로딩 상태, 에러 바운더리, 데이터 fetching
- **특징**: 한 페이지당 한 슬라이스 (유사한 페이지는 그룹화 가능). Next.js `app/`의 route 파일에서 re-export
- **의존성**: `widgets`, `features`, `entities`, `shared` 사용 가능
-
-> 💡 **FSD v2.1 권장사항**: "pages-first" 접근 방식을 따라, 재사용되지 않는 큰 UI 블록과 비즈니스 로직은 페이지 슬라이스에 유지하세요.
-
-### 3. Widgets
- **목적**: 큰 규모의 독립적인 UI 블록
- **내용**: 여러 features와 entities를 조합한 복합 UI
- **사용 시기**: 여러 페이지에서 재사용되거나, 페이지에 여러 개의 큰 독립적 블록이 있을 때
- **의존성**: `features`, `entities`, `shared` 사용 가능 (다른 `widgets` 불가)
-
-### 4. Features
- **목적**: 사용자가 수행하는 주요 상호작용과 비즈니스 기능
- **내용**: 사용자 시나리오 (예: 로그인, 상품 검색, 댓글 작성)
- **사용 시기**: 여러 페이지에서 재사용되는 기능
- **의존성**: `entities`, `shared` 사용 가능 (다른 `features` 불가)
-
-### 5. Entities
- **목적**: 비즈니스가 다루는 실제 개념 (User, Product, Order 등)
- **내용**: 데이터 모델, 타입, API 요청, 엔티티의 시각적 표현
- **특징**: 비즈니스 용어로 명명
- **의존성**: 다른 `entities`, `shared` 사용 가능
-
-### 6. Shared
- **목적**: 애플리케이션의 기반 제공
- **내용**: API 클라이언트, UI Kit, 유틸리티 라이브러리, 글로벌 설정
- **특징**: 비즈니스 로직 없음, 슬라이스가 없고 세그먼트로만 구성
- **의존성**: 외부 라이브러리만 사용 가능 (다른 레이어 불가)
-
-## 시작하기
-
-```bash
-# 의존성 설치
-pnpm install
-
-# 개발 서버 실행
-pnpm run dev
-
-# 프로덕션 빌드
-pnpm run build
-
-# 프로덕션 서버 실행
-pnpm start
-```
-
-## 환경 변수
-
-`.env.local` 파일 생성:
-
-```env
-NEXT_PUBLIC_API_URL=http://localhost:3000/api
-```
-
-## FSD 핵심 규칙
-
-### 1. Import 규칙
-
-> **슬라이스 내의 모듈(파일)은 오직 하위 레이어에 있는 슬라이스만 import할 수 있습니다.**
-
-```typescript
-// ✅ 올바른 import (하위 레이어)
-// features/auth-login/ui/form.tsx
-import { User } from "entities/user";
-import { Button } from "shared/ui/button";
-
-// ❌ 잘못된 import (같은 레이어)
-// features/auth-login/ui/form.tsx
-import { PostForm } from "features/post-create";  // 금지!
-
-// ❌ 잘못된 import (상위 레이어)
-// features/auth-login/ui/form.tsx
-import { Header } from "widgets/header";  // 금지!
-```
-
-### 2. Public API 규칙
-
-> **슬라이스 외부에서는 Public API(index.ts)를 통해서만 접근해야 합니다.**
-
-```typescript
-// ✅ 올바른 import (Public API 사용)
-import { LoginForm } from "features/auth-login";
-
-// ❌ 잘못된 import (내부 구조 직접 접근)
-import { LoginForm } from "features/auth-login/ui/login-form";
-```
-
-**Public API 작성 시 주의사항**:
- 와일드카드 re-export(`export * from`) 사용 지양
- 필요한 것만 명시적으로 export
- 슬라이스의 인터페이스를 명확하게 표현
-
-```typescript
-// ❌ 나쁜 예시
-export * from "./ui/Comment";
-export * from "./model/comments";
-
-// ✅ 좋은 예시
-export { Comment } from "./ui/comment";
-export { CommentForm } from "./ui/comment-form";
-export { useComments } from "./model/use-comments";
-export type { Comment, CommentFormData } from "./model/types";
-```
@@ -1 +0,0 @@
-export { ApprovalLineManagementPage as default } from "@/pages/approval-line-management";
@@ -1 +0,0 @@
-export { ChecklistManagementPage as default } from "@/pages/checklist-management";
@@ -1 +0,0 @@
-export { CodeManagementPage as default } from "@/pages/code-management";
@@ -1,10 +0,0 @@
-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} />;
-}
@@ -1,10 +0,0 @@
-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} />;
-}
@@ -1,3 +0,0 @@
-import { DesignListPage } from "@/pages/design-cnstn";
-
-export default DesignListPage;
@@ -1,12 +0,0 @@
-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} />;
-}
@@ -1 +0,0 @@
-export { EsntlAtchFileMngPage as default } from "@/pages/esntl-atch-file-mng";
@@ -1,10 +0,0 @@
-import { FnrsEditPage } from "@/pages/fnrs-cnsltn";
-
-interface PageProps {
-  params: Promise<{ id: string }>;
-}
-
-export default async function Page({ params }: PageProps) {
-  const { id } = await params;
-  return <FnrsEditPage id={id} />;
-}
@@ -1,10 +0,0 @@
-import { FnrsViewPage } from "@/pages/fnrs-cnsltn";
-
-interface PageProps {
-  params: Promise<{ id: string }>;
-}
-
-export default async function Page({ params }: PageProps) {
-  const { id } = await params;
-  return <FnrsViewPage id={id} />;
-}
@@ -1,3 +0,0 @@
-import { FnrsListPage } from "@/pages/fnrs-cnsltn";
-
-export default FnrsListPage;
@@ -1,12 +0,0 @@
-import { FnrsRegistPage } from "@/pages/fnrs-cnsltn";
-import { parseTaskSeComCdFromApi } from "@/pages/fnrs-cnsltn/lib/fnrs-cnsltn-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 <FnrsRegistPage taskSeComCd={taskSeComCd.length ? taskSeComCd : undefined} />;
-}
@@ -1,10 +0,0 @@
-import { InstlEditPage } from "@/pages/instl-sncn";
-
-interface InstlSncnEditRouteProps {
-  params: Promise<{ id: string }>;
-}
-
-export default async function Page({ params }: InstlSncnEditRouteProps) {
-  const { id } = await params;
-  return <InstlEditPage id={id} />;
-}
@@ -1,6 +0,0 @@
-import { InstlViewPage } from "@/pages/instl-sncn";
-
-export default async function InstlSncnDetailPage({ params }: { params: Promise<{ id: string }> }) {
-  const { id } = await params;
-  return <InstlViewPage id={id} />;
-}
@@ -1,3 +0,0 @@
-import { InstlListPage } from "@/pages/instl-sncn";
-
-export default InstlListPage;
@@ -1,14 +0,0 @@
-import { InstlRegistPage } from "@/pages/instl-sncn";
-
-interface InstlSncnRegistRouteProps {
-  searchParams: Promise<{ taskSeComCd?: string }>;
-}
-
-export default async function Page({ searchParams }: InstlSncnRegistRouteProps) {
-  const params = await searchParams;
-  const taskSeComCd = params.taskSeComCd
-    ? params.taskSeComCd.split(",").filter(Boolean)
-    : undefined;
-
-  return <InstlRegistPage taskSeComCd={taskSeComCd} />;
-}
@@ -1,11 +0,0 @@
-import type { ReactNode } from "react";
-
-import { BaseLayoutWrapper } from "@/app/layouts/base-layout";
-
-interface WithBaseLayoutProps {
-  children: ReactNode;
-}
-
-export default function WithBaseLayout({ children }: WithBaseLayoutProps) {
-  return <BaseLayoutWrapper>{children}</BaseLayoutWrapper>;
-}
@@ -1 +0,0 @@
-export { MainPage as default } from "@/pages/home";
@@ -1 +0,0 @@
-export { RvwMnpwMngPage as default } from "@/pages/rvw-mnpw-mng";
@@ -1,169 +0,0 @@
-# App Layer
-
-**App**은 애플리케이션 전체에 영향을 미치는 기술적, 비즈니스적 사항을 다루는 최상위 레이어입니다.
-
-## 목적
-
- 애플리케이션의 진입점(entrypoint) 제공
- 전역 Context Providers 설정
- 라우터 구성
- 글로벌 스타일 정의
- 전역 상태 저장소 설정
- 애널리틱스 및 모니터링 설정
-
-## 특징
-
- **슬라이스 없음**: App 레이어는 Shared처럼 슬라이스가 없고 세그먼트로만 구성됩니다
- **전체 앱 관심사**: 특정 비즈니스 도메인이 아닌 앱 전체와 관련된 코드만 포함
- **최상위 레이어**: 모든 하위 레이어의 모듈을 자유롭게 import 가능
-
-## 구조 (Next.js App Router)
-
-Next.js를 사용하는 경우, App 레이어는 주로 `app/` 디렉토리로 표현됩니다:
-
-```
-app/
-├── (routes)/              # 라우트 그룹 및 페이지
-│   ├── (auth)/
-│   │   ├── login/
-│   │   │   └── page.tsx
-│   │   └── register/
-│   │       └── page.tsx
-│   └── (main)/
-│       ├── dashboard/
-│       │   └── page.tsx
-│       └── settings/
-│           └── page.tsx
-├── layout.tsx            # 루트 레이아웃
-├── page.tsx              # 홈 페이지
-├── globals.css           # 글로벌 스타일
-├── providers.tsx         # 전역 Providers 설정
-└── error.tsx             # 글로벌 에러 핸들러
-```
-
-### 일반적인 FSD 세그먼트 구조
-
-FSD 표준 세그먼트를 사용하는 경우:
-
-```
-app/
-├── entrypoint/           # 애플리케이션 진입점 (프레임워크별)
-│   └── index.tsx
-├── providers/            # Context Providers
-│   ├── query-provider.tsx
-│   ├── theme-provider.tsx
-│   └── index.tsx
-├── styles/               # 글로벌 스타일
-│   ├── globals.css
-│   └── theme.css
-├── store/                # 글로벌 상태 저장소 설정
-│   └── index.ts
-└── routes/               # 라우터 설정
-    └── index.tsx
-```
-
-## 예시
-
-### Next.js Providers 설정
-
-```typescript
-// app/providers.tsx
-'use client';
-
-import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
-import { ThemeProvider } from 'next-themes';
-import { useState } from 'react';
-
-export function Providers({ children }: { children: React.ReactNode }) {
-  const [queryClient] = useState(() => new QueryClient({
-    defaultOptions: {
-      queries: {
-        staleTime: 60 * 1000,
-      },
-    },
-  }));
-
-  return (
-    <QueryClientProvider client={queryClient}>
-      <ThemeProvider attribute="class" defaultTheme="system" enableSystem>
-        {children}
-      </ThemeProvider>
-    </QueryClientProvider>
-  );
-}
-
-// app/layout.tsx
-import { Providers } from './providers';
-import './globals.css';
-
-export default function RootLayout({
-  children,
-}: {
-  children: React.ReactNode;
-}) {
-  return (
-    <html lang="ko">
-      <body>
-        <Providers>
-          {children}
-        </Providers>
-      </body>
-    </html>
-  );
-}
-```
-
-### 글로벌 설정
-
-```typescript
-// app/config/analytics.ts
-export function initAnalytics() {
-  if (typeof window !== 'undefined') {
-    // 애널리틱스 초기화
-  }
-}
-
-// app/config/monitoring.ts
-export function initMonitoring() {
-  // 에러 모니터링 설정
-}
-```
-
-## Next.js App Router와 FSD
-
-Next.js의 `app/` 디렉토리는 FSD의 **App 레이어**와 **Pages 레이어**를 동시에 담당합니다:
-
- **루트 레벨 파일들** (`layout.tsx`, `providers.tsx`, `globals.css`): App 레이어
- **라우트 폴더들** (`dashboard/`, `login/` 등): Pages 레이어
-
-각 페이지별 비즈니스 로직은:
- 재사용되지 않는 UI는 페이지 슬라이스(`app/dashboard/` 등) 안에 유지
- 재사용되는 기능은 `features/` 레이어로 분리
- 여러 페이지에서 재사용되는 큰 UI 블록은 `widgets/` 레이어로 분리
-
-## 레이어 의존성 규칙
-
-✅ **허용되는 의존성**:
- 모든 하위 레이어 (`pages`, `widgets`, `features`, `entities`, `shared`)
- 같은 `app` 레이어 내의 다른 세그먼트
- 외부 라이브러리
-
-❌ **금지된 의존성**:
- 없음 (App은 최상위 레이어)
-
-## 주의사항
-
-1. **비대화 방지**: App 레이어가 너무 커지면 관리가 어려워집니다. 대부분의 로직은 하위 레이어에 배치하세요
-2. **전역 관심사만**: 특정 페이지나 기능에만 관련된 코드는 해당 레이어로 이동
-3. **라우터 레벨 로직**: 라우터 및 서버 레벨 로직은 이 레이어에 유지
-4. **Processes 레이어 사용 지양**: Processes 레이어는 deprecated되었으므로 해당 로직은 `app`이나 `features`에 배치
-
-## FSD v2.1 권장사항
-
-최신 FSD 버전(v2.1)은 **"pages-first"** 접근 방식을 권장합니다:
-
- 더 많은 코드를 페이지 슬라이스에 유지
- 큰 UI 블록과 재사용되지 않는 비즈니스 로직은 즉시 추출하지 말고 페이지에 보관
- 실제로 재사용이 필요할 때만 `features`나 `widgets`로 분리
-
-이 접근 방식은 과도한 추상화를 방지하고 코드를 더 쉽게 탐색할 수 있게 합니다.
@@ -1,94 +0,0 @@
-import { cookies } from "next/headers";
-import { NextResponse } from "next/server";
-
-import {
-  ACCESS_TOKEN,
-  AUTH_USER_ID,
-  CLAIM_NAME,
-  COOKIE_DOMAIN,
-  REFRESH_TOKEN,
-  SERVER_API_URL,
-  SITE_ID,
-} from "@/shared/config";
-
-async function handler(
-  request: Request,
-  params: { url: string[] },
-  method: "GET" | "POST" | "PUT" | "DELETE",
-) {
-  const cookieStore = await cookies();
-  const headers: Record<string, string> = {
-    "Content-Type": "application/json",
-    "X-Site-Id": SITE_ID,
-  };
-  const deviceId = request.headers.get("X-Device-Id");
-  if (deviceId) {
-    headers["X-Device-Id"] = deviceId;
-  }
-  let body = {};
-  const isRefreshHandler = params.url.includes("refresh");
-
-  // silent refresh
-  if (isRefreshHandler) {
-    const refreshToken = cookieStore.get(REFRESH_TOKEN);
-    headers[CLAIM_NAME] = refreshToken?.value ?? "";
-
-    if (!headers[CLAIM_NAME]) {
-      return NextResponse.json({ message: "Can't refresh" }, { status: 401 });
-    }
-  }
-
-  try {
-    if (!isRefreshHandler) {
-      body = await request.json();
-    }
-
-    const targetUrl = `${SERVER_API_URL}/${params.url.join("/")}`;
-    const result = await fetch(targetUrl, {
-      method,
-      headers,
-      body: JSON.stringify(body),
-    });
-
-    if (!result.ok) {
-      return NextResponse.json({ message: "Invalid Credentials" }, { status: 401 });
-    }
-
-    const accessToken = result.headers.get(ACCESS_TOKEN);
-    const refreshToken = result.headers.get(REFRESH_TOKEN);
-    const userId = result.headers.get(AUTH_USER_ID);
-
-    if (accessToken && userId) {
-      const response = NextResponse.json({
-        [ACCESS_TOKEN]: accessToken,
-        [AUTH_USER_ID]: userId,
-      });
-
-      if (refreshToken) {
-        cookieStore.set(REFRESH_TOKEN, refreshToken, {
-          httpOnly: true,
-          sameSite: "strict",
-          domain: COOKIE_DOMAIN,
-          path: "/",
-        });
-      }
-
-      return response;
-    }
-
-    return NextResponse.json({ message: "Invalid Credentials" }, { status: 401 });
-  } catch (error) {
-    console.error(`[Proxy API] Error caught in handler:`, error);
-    return NextResponse.json({ message: "Server Error", error }, { status: 500 });
-  }
-}
-
-export async function POST(request: Request, props: { params: Promise<{ url: string[] }> }) {
-  const params = await props.params;
-  return handler(request, params, "POST");
-}
-
-export async function PUT(request: Request, props: { params: Promise<{ url: string[] }> }) {
-  const params = await props.params;
-  return handler(request, params, "PUT");
-}
@@ -1,27 +0,0 @@
-import type { Metadata } from "next";
-import { cookies } from "next/headers";
-
-import { Providers } from "@/app/providers";
-
-import "@/app/styles/globals.css";
-
-export const metadata: Metadata = {
-  title: "행정지원시스템",
-  description: "행정지원시스템",
-};
-
-interface RootLayoutProps {
-  children: React.ReactNode;
-}
-
-export default async function RootLayout({ children }: RootLayoutProps) {
-  const theme = (await cookies()).get("site-theme-key");
-
-  return (
-    <html lang="ko" data-theme={theme?.value}>
-      <body>
-        <Providers>{children}</Providers>
-      </body>
-    </html>
-  );
-}
@@ -1,407 +0,0 @@
-# 화면설계서: 결재선 관리
-
-## 1. 기본 정보
-
-| 항목       | 내용                                         |
-| ---------- | -------------------------------------------- |
-| 버전       | 0.3                                          |
-| 프로세스명 | UI설계                                       |
-| 화면명     | 결재선 관리                                  |
-| 화면 유형  | [v] 조회 [v] 입력 [v] 수정 [v] 삭제 [ ] 출력 |
-| 메뉴 경로  | 디지털행정지원 > 시스템관리 > 결재선 관리    |
-
---
-
-## 2. 화면 목적
-
-전자결재 처리에 사용할 **결재서식**(템플릿)을 등록·관리하고, 각 서식별로 **결재선**(결재구분·결재자·순서)을 구성한다. 상단의 결재서식 목록에서 하나를 선택하면 하단 영역에 해당 서식의 결재선이 표시되며, 사용자는 **그리드 인라인 폼**으로 결재자를 등록·수정한다. **행 추가 또는 한 행 수정 중에는 다른 행을 편집할 수 없다**(단일 행 편집 잠금). 드래그로 순서를 변경한 뒤 **[결재선 저장]** 으로 서버에 반영한다.
-
---
-
-## 3. 화면 구성
-
-### 3-1. 전체 레이아웃
-
-```
-┌───────────────────────────────────────────────────────────────────────────────────────────────┐
-│  페이지 타이틀: 결재선 관리                                 브레드크럼: 디지털행정지원 > … >  │
-├───────────────────────────────────────────────────────────────────────────────────────────────┤
-│  [영역 A] 전자결재선 관리 목록                              [서식 등록]                       │
-│  ┌──────────────────────────────────────────────────────────────────────┐                     │
-│  │ 전자결재서식아이디 | 결재서식명 | 문서구분 | 등록일시 | 관리         │                     │
-│  ├──────────────────────────────────────────────────────────────────────┤                     │
-│  │  TMPL-0001 (선택 행 강조)  …                            [수정][삭제] │                     │
-│  └──────────────────────────────────────────────────────────────────────┘                     │
-├───────────────────────────────────────────────────────────────────────────────────────────────┤
-│  [영역 B] 결재선 관리                                선택된 서식: TMPL-0001  [결재선 저장]    │
-│  ┌─────────────────────────────────────────────────────────────────────────────────────────┐  │
-│  │ [영역 B-2] 결재선 그리드 (인라인 편집 + 행 드래그 — @dnd-kit)                           │  │
-│  │ ⋮⋮ | 결재선아이디 | 결재순서 | 결재구분 ▼  | 결재자 [선택]    | 등록일시 | 관리         │  │
-│  │ ⋮⋮ | APLN-0001    | [ 1 ]    | [검토자 ▼]  | [김민수  ][선택] | …        | [저장][삭제] │  │
-│  │ ⋮⋮ | (신규)       | [ 2 ]    | [승인자 ▼]  | [       ][선택]  | —        | [저장][취소] │  │
-│  └─────────────────────────────────────────────────────────────────────────────────────────┘  │
-│                                                                                  [행 추가]    │
-│  ※ 결재자 등록·수정은 그리드 셀에서 직접 입력. 검토인력만 [선택] 팝업/다이얼로그              │
-│  ※ 행 추가·수정 중: 해당 행만 편집 가능, 나머지 행·[행 추가]·드래그 비활성                    │
-└───────────────────────────────────────────────────────────────────────────────────────────────┘
-```
-
-### 3-2. 화면 데이터 흐름
-
-```
-BEGIN
-
-  // 최초 진입
-  CALL GET /as-elapr-service/api/v1/elapr-tmplt
-  DISPLAY 결재서식 그리드 (영역 A)
-  DISPLAY 빈 상태 안내 (영역 B)            // 서식 미선택 시 그리드·툴바 비활성
-
-  // 영역 A: 서식 행 선택
-  ON 영역 A 행 CLICK DO
-      SET 선택된 서식 = 행.elaprTmpltId
-      CALL GET /as-elapr-service/api/v1/elapr-apln?elaprTmpltId={id}
-      DISPLAY 결재선 그리드 (영역 B-2) — 조회 모드
-  END ON
-
-  // 영역 A: 신규 서식 등록
-  ON [서식 등록] 버튼 CLICK DO
-      OPEN 결재서식 등록 다이얼로그
-      ON 확인 DO
-          CALL POST /as-elapr-service/api/v1/elapr-tmplt
-          CALL GET /as-elapr-service/api/v1/elapr-tmplt
-      END ON
-  END ON
-
-  // 영역 A: 서식 수정·삭제 (다이얼로그 유지)
-  ON 영역 A [수정] / [삭제] DO
-      (기존과 동일 — PUT / DELETE elapr-tmplt)
-  END ON
-
-  // 영역 B: 행 추가 (인라인 신규 행)
-  ON [행 추가] 버튼 CLICK DO
-      VALIDATE 서식 선택됨
-      VALIDATE 편집 중인 행 없음 (editingRowKey == null)
-      ADD 영역 B-2 그리드 맨 아래 편집 가능 행
-          SET editingRowKey = rowKey (draft-{timestamp})
-          SET 편집상태 = 신규
-          SET aplnId = 미설정 (POST 저장 시 서버 fn_gen_apln_id 발급)
-          SET atrzSeqNo = 현재 행 수 + 1
-          SET atrzSeComCd, aprvrUuid = 빈 값
-      DISABLE 나머지 행 편집 · [행 추가] · 드래그 · [결재선 저장](정책에 따라)
-  END ON
-
-  // 영역 B-2: 기존 행 수정 진입
-  ON 행별 [수정] CLICK DO
-      VALIDATE 편집 중인 행 없음
-      SET editingRowId = 행.aplnId
-      SET 해당 행만 편집 모드
-      DISABLE 나머지 행 편집 · [행 추가] · 드래그
-  END ON
-
-  // 영역 B-2: 인라인 편집
-  ON 그리드 셀 변경 DO
-      VALIDATE 변경 대상 행 == editingRowId
-      SET 해당 행 dirty = true
-  END ON
-
-  ON 셀 [선택] (검토인력) CLICK DO
-      OPEN 검토인력 선택 다이얼로그 (단일 선택)
-      ON 선택 DO
-          SET 행.aprvrUuid = 선택인력.uuid
-          SET 행.aprvrNm = 선택인력.성명   // UI 표시용 (응답 DTO에 없음 — 로컬 보조 필드)
-      END ON
-  END ON
-
-  // 영역 B-2: 행별 저장
-  ON 행별 [저장] CLICK DO
-      VALIDATE atrzSeComCd, aprvrUuid, atrzSeqNo
-      IF 편집상태 = 신규 THEN
-          CALL POST /as-elapr-service/api/v1/elapr-apln
-      ELSE
-          CALL PUT /as-elapr-service/api/v1/elapr-apln/{aplnId}
-      END IF
-      CALL GET /as-elapr-service/api/v1/elapr-apln?elaprTmpltId={id}
-      CLEAR editingRowId
-      ENABLE 전체 행 조회 모드 · [행 추가] · 드래그
-  END ON
-
-  // 영역 B: 결재선 저장 (드래그 순서 일괄 반영)
-  ON [결재선 저장] 버튼 CLICK DO
-      VALIDATE 서식 선택됨
-      VALIDATE 편집 중인 행 없음
-      REORDER atrzSeqNo = 그리드 행 순서 (1..n)
-      FOR EACH dirty 또는 순서 변경된 행 DO
-          CALL PUT /as-elapr-service/api/v1/elapr-apln/{aplnId}  // atrzSeqNo 등 반영
-      END FOR
-      FOR EACH 신규 미저장 행 DO
-          CALL POST /as-elapr-service/api/v1/elapr-apln
-      END FOR
-      CALL GET /as-elapr-service/api/v1/elapr-apln?elaprTmpltId={id}
-      TOAST "결재선이 저장되었습니다."
-  END ON
-
-  // 영역 B-2: 행 드래그
-  ON 영역 B-2 행 DRAG END DO
-      VALIDATE 편집 중인 행 없음
-      REORDER 그리드 행
-      SET 각 행 atrzSeqNo = 행 인덱스 + 1 (UI 즉시 반영, 서버는 [결재선 저장] 또는 행별 [저장])
-  END ON
-
-  // 영역 B-2: 행 삭제
-  ON 행별 [삭제] CLICK DO
-      CONFIRM "선택한 결재선을 삭제하시겠습니까?"
-      IF 서버 저장된 행 THEN
-          CALL DELETE /as-elapr-service/api/v1/elapr-apln/{aplnId}
-      END IF
-      REMOVE 그리드 행 (신규 미저장 행은 API 호출 없이 제거)
-      CALL GET /as-elapr-service/api/v1/elapr-apln?elaprTmpltId={id}
-  END ON
-
-  ON 행별 [취소] CLICK DO   // 신규·수정 공통
-      IF 편집상태 = 신규 THEN REMOVE 임시 행
-      ELSE RESTORE 행 스냅샷 (수정 취소)
-      CLEAR editingRowId
-      ENABLE 전체 행 조회 모드 · [행 추가] · 드래그
-  END ON
-
-END
-```
-
---
-
-## 4. 영역 A: 전자결재선 관리 목록
-
-선택된 결재서식이 영역 B의 작업 대상이 된다. 행 클릭으로 선택 상태를 표시(좌측 컬러 바·배경 강조)한다.
-
-### 4-1. 헤더 / 툴바
-
-| 항목        | 내용                                            |
-| ----------- | ----------------------------------------------- |
-| 섹션 타이틀 | 전자결재선 관리 목록                            |
-| 우측 버튼   | **[서식 등록]** — 결재서식 등록 다이얼로그 오픈 |
-
-### 4-2. 그리드 컬럼
-
-| 컬럼명             | Field          | 타입   | 비고                                    |
-| ------------------ | -------------- | ------ | --------------------------------------- |
-| 전자결재서식아이디 | `elaprTmpltId` | string | 등록 시 서버(DB 함수) 자동 발급         |
-| 결재서식명         | `elaprTmpltNm` | string |                                         |
-| 문서구분           | `docSeComNm`   | string | 코드 `docSeComCd`, 상위코드 `ASDOCSECD` |
-| 등록일시           | `regDt`        | string | `yyyy-MM-dd HH:mm:ss`                   |
-| 관리               | —              | —      | 행별 **[수정] · [삭제]** 버튼           |
-
- 행 클릭 시: `elaprTmpltId` 선택 → 영역 B 라벨·B-2 그리드 갱신.
- 페이지네이션: Spring `Pageable` (`page`, `size`, `sort`).
-
-### 4-3. 버튼
-
-| 버튼명    | 위치           | 동작                                            |
-| --------- | -------------- | ----------------------------------------------- |
-| 서식 등록 | 섹션 우측 상단 | 결재서식 등록 다이얼로그 오픈                   |
-| 수정      | 행별           | 결재서식 수정 다이얼로그 (기존 값 초기화)       |
-| 삭제      | 행별           | 확인 후 삭제. 선택 중인 서식이면 영역 B 초기화. |
-
-### 4-4. 다이얼로그(개요)
-
-| 다이얼로그명       | 트리거      | 입력 항목                                       | 비고                                      |
-| ------------------ | ----------- | ----------------------------------------------- | ----------------------------------------- |
-| 결재서식 등록      | [서식 등록] | `elaprTmpltNm`, `docSeComCd`                    | `elaprTmpltExpln` 선택, ID는 저장 후 응답 |
-| 결재서식 수정      | 행별 [수정] | `elaprTmpltNm`, `docSeComCd`, `elaprTmpltExpln` | ID는 변경 불가                            |
-| 결재서식 삭제 확인 | 행별 [삭제] | (확인/취소)                                     |                                           |
-
---
-
-## 5. 영역 B: 결재선 관리
-
-영역 A에서 선택된 `elaprTmpltId` 기준으로 결재선을 관리한다. **등록·수정은 B-2 그리드 인라인 폼**으로 수행하며, 검토인력 지정만 **[선택]** 보조 다이얼로그를 사용한다.
-
-### 5-1. 헤더 / 툴바
-
-| 항목        | 내용                                                                                                                        |
-| ----------- | --------------------------------------------------------------------------------------------------------------------------- |
-| 섹션 타이틀 | 결재선 관리                                                                                                                 |
-| 우측 라벨   | `선택된 서식: {elaprTmpltId}` — 미선택 시 영역 B 비활성                                                                     |
-| 우측 버튼   | **[행 추가]** — 편집 중인 행이 없을 때만 활성 · **[결재선 저장]** — 편집 중인 행이 없을 때만 활성(순서·미저장 행 일괄 반영) |
-
-### 5-2. 영역 B-2: 결재선 그리드 (인라인 편집)
-
-#### 그리드 컬럼
-
-| 컬럼명        | Field         | 입력 UI (편집 모드)                                                                       | 비고                                           |
-| ------------- | ------------- | ----------------------------------------------------------------------------------------- | ---------------------------------------------- |
-| (드래그 핸들) | —             | —                                                                                         | `useSortable` 연동                             |
-| 결재선아이디  | `aplnId`      | 읽기 전용                                                                                 | 신규 행: `—`, 저장 후 서버 `aplnId` 표시       |
-| 결재순서번호  | `atrzSeqNo`   | 읽기 전용 (그리드 행 순서 1부터 표시)                                                     | 저장 시 행 순서 기준 자동 채번                 |
-| 결재구분      | `atrzSeComCd` | Select (`ATRZSECD` 공통코드)                                                              | 표시명 `atrzSeComNm` (조회 행)                 |
-| 결재자        | `aprvrUuid`   | 읽기 전용 이름 + **[선택]** 버튼                                                          | 응답에 성명 없음 — 선택 시 로컬 `aprvrNm` 유지 |
-| 등록일시      | `regDt`       | 읽기 전용                                                                                 | 신규 행은 `—`                                  |
-| 관리          | —             | 편집 중인 행: **[저장] [취소]** · 조회 행: **[수정] [삭제]** (다른 행 편집 중이면 비활성) |
-
-#### 인라인 편집 정책
-
-| 항목                | 내용                                                                                                                            |
-| ------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
-| **단일 행 편집**    | **행 추가 또는 한 행 수정 중에는 다른 행을 편집할 수 없다.** `editingRowId` 로 현재 편집 행 1건만 허용.                         |
-| 편집 잠금 시 비활성 | 다른 행: 셀·[수정]·[삭제] 비활성 · `[행 추가]` 비활성 · 행 드래그 비활성 · (선택) `[결재선 저장]` 비활성                        |
-| 편집 해제           | 행별 **[저장]** 성공 또는 **[취소]** 시 `editingRowId` 초기화 후 전체 조회 모드 복귀                                            |
-| 조회 행             | 편집 중이 아닐 때 읽기 전용. **[수정]** 클릭 시 해당 행만 편집 모드 진입                                                        |
-| 신규 행             | `[행 추가]` 시 맨 아래 편집 행 1건 생성 (`editingRowId` = 임시 키)                                                              |
-| 필수값              | `atrzSeComCd`, `aprvrUuid`                                                                                                      |
-| 순서 중복           | 저장 시 행 순서로 자동 채번하므로 중복 없음                                                                                     |
-| 결재구분 코드       | `ATRZSECD` — 예: `ATRZ01` 검토자, `ATRZ02` 승인자, `ATRZ03` 최종승인자                                                          |
-| **순서 제약**       | `ATRZ01`은 최상단 블록, `ATRZ03`은 최하단 블록. 드래그 종료·저장 시 `validateAtrzOrder`로 검증, 위반 시 적용/저장 불가 (결재구분 변경 시에는 미검증) |
-| 저장 단위           | 행별 **[저장]** (단건 POST/PUT) 또는 툴바 **[결재선 저장]** (일괄)                                                              |
-
-#### 행 드래그 정렬 (`@dnd-kit` + `useSortable`)
-
-| 항목       | 내용                                                                                                    |
-| ---------- | ------------------------------------------------------------------------------------------------------- |
-| 목적       | 결재 단계 순서를 그리드에서 직접 변경                                                                   |
-| 라이브러리 | `@dnd-kit/core`, `@dnd-kit/sortable` — 테이블 행 POC 후 확정                                            |
-| 저장 시점  | 드래그는 클라이언트 상태만 변경 → **[결재선 저장]** 또는 행별 **[저장]** 시 `atrzSeqNo` PUT             |
-| 편집 중    | `editingRowKey != null` 이면 드래그 **불가**                                                            |
-| 순서 제약  | 드래그 종료 시 `validateAtrzOrder` — 실패하면 순서 변경 미적용 + 안내. 결재구분 미선택 행은 드래그 불가 |
-
-### 5-3. 보조 다이얼로그 (검토인력만)
-
-| 다이얼로그명  | 트리거                  | 결과                               |
-| ------------- | ----------------------- | ---------------------------------- |
-| 검토인력 선택 | 그리드 결재자 셀 [선택] | `aprvrUuid` 및 UI용 `aprvrNm` 반영 |
-
-> 결재자 **등록·수정 다이얼로그는 사용하지 않음** (v0.2 변경).
-
---
-
-## 6. API/DTO 명세
-
-### 6-1. 공통
-
-| 항목        | 내용                                                          |
-| ----------- | ------------------------------------------------------------- |
-| 서비스      | `as-elapr-service`                                            |
-| Base prefix | `/as-elapr-service/api/v1` (프록시 경유)                      |
-| 인증        | JWT (`Authorization` 헤더)                                    |
-| 페이징      | Spring `Pageable`: `page`, `size`, `sort` → `PageResponse<T>` |
-| 엔티티      | `@/entities/elapr` (`elaprTmpltService`, `elaprAplnService`)  |
-
-### 6-2. 전자결재서식 (영역 A) — `elapr-tmplt`
-
-| 기능      | Method | URL                           | Request / Query                            | Response           | 클라이언트                   |
-| --------- | ------ | ----------------------------- | ------------------------------------------ | ------------------ | ---------------------------- |
-| 목록 조회 | GET    | `/elapr-tmplt`                | Query: `ElaprTmpltSearchParams` + Pageable | `Page<ElaprTmplt>` | `elaprTmpltService.findPage` |
-| 단건 조회 | GET    | `/elapr-tmplt/{elaprTmpltId}` | —                                          | `ElaprTmplt`       | `elaprTmpltService.findById` |
-| 등록      | POST   | `/elapr-tmplt`                | `ElaprTmpltSaveRequest`                    | `ElaprTmplt` (201) | `elaprTmpltService.create`   |
-| 수정      | PUT    | `/elapr-tmplt/{elaprTmpltId}` | `ElaprTmpltUpdateRequest`                  | `ElaprTmplt`       | `elaprTmpltService.update`   |
-| 삭제      | DELETE | `/elapr-tmplt/{elaprTmpltId}` | —                                          | 204                | `elaprTmpltService.remove`   |
-
-**ElaprTmplt (응답)**
-
-| Field             | 타입    | 설명               |
-| ----------------- | ------- | ------------------ |
-| `elaprTmpltId`    | string  | 전자결재서식아이디 |
-| `elaprTmpltNm`    | string  | 결재서식명         |
-| `elaprTmpltExpln` | string? | 서식 설명          |
-| `docSeComCd`      | string? | 문서구분 코드      |
-| `docSeComNm`      | string? | 문서구분명         |
-| `regDt`           | string? | 등록일시           |
-
-**ElaprTmpltSaveRequest**: `elaprTmpltNm`\_, `elaprTmpltExpln?`, `docSeComCd?`
-
-**ElaprTmpltUpdateRequest**: `elaprTmpltNm`\*, `elaprTmpltExpln?`, `docSeComCd?`
-
-**ElaprTmpltSearchParams**: `elaprTmpltNm?`, `docSeComCd?`, `regDtStart?`, `regDtEnd?` + `page`, `size`, `sort`
-
-### 6-3. 결재선 (영역 B) — `elapr-apln`
-
-| 기능      | Method | URL                    | Request / Query                 | Response          | 클라이언트                  |
-| --------- | ------ | ---------------------- | ------------------------------- | ----------------- | --------------------------- |
-| 목록 조회 | GET    | `/elapr-apln`          | Query: `elaprTmpltId`, Pageable | `Page<ElaprApln>` | `elaprAplnService.findPage` |
-| 단건 조회 | GET    | `/elapr-apln/{aplnId}` | —                               | `ElaprApln`       | `elaprAplnService.findById` |
-| 등록      | POST   | `/elapr-apln`          | `ElaprAplnSaveRequest`          | `ElaprApln` (201) | `elaprAplnService.create`   |
-| 수정      | PUT    | `/elapr-apln/{aplnId}` | `ElaprAplnUpdateRequest`        | `ElaprApln`       | `elaprAplnService.update`   |
-| 삭제      | DELETE | `/elapr-apln/{aplnId}` | —                               | 204               | `elaprAplnService.remove`   |
-
-> **일괄 저장 API 없음** — UI의 [결재선 저장]은 변경된 행에 대해 POST/PUT을 순차(또는 병렬) 호출하는 클라이언트 오케스트레이션으로 구현.
-
-**ElaprApln (응답)**
-
-| Field          | 타입    | 설명               |
-| -------------- | ------- | ------------------ |
-| `aplnId`       | string  | 결재선아이디       |
-| `elaprTmpltId` | string  | 전자결재서식아이디 |
-| `aprvrUuid`    | string? | 결재자 UUID        |
-| `atrzSeComCd`  | string? | 결재구분 코드      |
-| `atrzSeComNm`  | string? | 결재구분명         |
-| `atrzSeqNo`    | number? | 결재순서번호       |
-| `regDt`        | string? | 등록일시           |
-
-**ElaprAplnSaveRequest**: `elaprTmpltId`\_, `aprvrUuid?`, `atrzSeComCd?`, `atrzSeqNo?`
-
-**ElaprAplnUpdateRequest**: `elaprTmpltId`\*, `aprvrUuid?`, `atrzSeComCd?`, `atrzSeqNo?`
-
-### 6-4. 검토인력 (보조)
-
-| 기능               | Method | URL | 비고                        |
-| ------------------ | ------ | --- | --------------------------- |
-| 검토인력 목록 조회 | TBD    | TBD | 사용자 서비스 또는 별도 API |
-
-### 6-5. Backend ↔ 화면 필드 매핑 (구 SPEC 대비)
-
-| 구 SPEC 필드      | 백엔드 필드                                          |
-| ----------------- | ---------------------------------------------------- |
-| `elctAtrzTmpltId` | `elaprTmpltId`                                       |
-| `atrzTmpltNm`     | `elaprTmpltNm`                                       |
-| `docSeNm`         | `docSeComNm`                                         |
-| `atrzLineId`      | `aplnId`                                             |
-| `atrzSeNm`        | `atrzSeComNm`                                        |
-| `atrzUserNm`      | (없음) `aprvrUuid` + 사용자 조회/선택 시 로컬 표시명 |
-
---
-
-## 7. UI 구현 가이드
-
-### 7-1. 기술 스택·원칙
-
- **공통 컴포넌트**: `@common/components`
- **테이블**: `@tanstack/react-table` + 인라인 편집 셀 (`Select`, `Input`, `Button`)
- **드래그**: `@dnd-kit` — B-2 행 정렬 (POC 필수)
- **데이터**: React Query — `@/entities/elapr` hooks
- **상태**: 선택된 `elaprTmpltId`, `editingRowId` (단일 행 편집 잠금), B-2 행 배열(dirty·신규·`aprvrNm`·수정 전 스냅샷)
- **모의 데이터**: API 연동 전 `@faker-js/faker`
-
-### 7-2. 모듈·파일 배치(제안)
-
-| 구분   | 경로                                                                                   |
-| ------ | -------------------------------------------------------------------------------------- |
-| 라우트 | `apps/as/app/(with-base-layout)/approval-line-management/page.tsx`                     |
-| 페이지 | `apps/as/src/pages/approval-line-management/` (Public API: page만 export)              |
-| UI     | `.../ui/elapr-tmplt-list.tsx`, `elapr-tmplt-form-dialog.tsx`, `elapr-apln-grid.tsx` 등 |
-| model  | `.../model/columns.tsx`, `apln-row-types.ts`, `mock-reviewers.ts`                      |
-| lib    | `.../lib/use-apln-rows.ts`, `validators.ts`, `use-dnd-sensors.ts`                      |
-| 엔티티 | `apps/as/src/entities/elapr/`                                                          |
-
-### 7-3. 영역별 UI 매핑
-
-| 영역   | 주요 UI                                                                                      |
-| ------ | -------------------------------------------------------------------------------------------- |
-| A      | DataTable + 행 선택 + 서식 등록/수정 다이얼로그                                              |
-| B 헤더 | 상태 라벨 + `행 추가`, `결재선 저장`                                                         |
-| B-2    | 인라인 편집 DataTable + `editingRowId` 단일 행 잠금 + 드래그 핸들 + 행별 수정/저장/삭제/취소 |
-| 공통   | 서식 Dialog, 검토인력 선택 Dialog만                                                          |
-
-### 7-4. 데이터 흐름(요약)
-
- **진입**: `useElaprTmpltPage` → 영역 A. B 비활성.
- **서식 선택**: `useElaprAplnPage({ elaprTmpltId })` → B-2.
- **행 추가**: `editingRowId` 없을 때만 가능 → 신규 행 1건 편집 잠금 → 저장/취소 후 해제.
- **인라인 수정**: [수정]으로 `editingRowId` 설정 → 해당 행만 편집 → `useUpdateElaprApln` 후 해제.
- **드래그**: `editingRowId == null` 일 때만 가능 → 로컬 `atrzSeqNo` 재부여 → 일괄 PUT.
- **삭제**: `useDeleteElaprApln` 또는 신규 행 로컬 제거.
-
-### 7-5. 미확정 / 검증 필요
-
- 검토인력 API 경로·DTO.
- `@dnd-kit` + react-table 행 인라인 Input 동시 적용 POC.
- 결재자 성명 표시: `aprvrUuid` → 사용자명 조회 API.
- 영역 A·B 페이지네이션·검색 UI 노출 여부.
- 권한(역할별 CRUD).
@@ -1,487 +0,0 @@
-# 화면설계서: 체크리스트관리
-
-## 1. 기본 정보
-
-| 항목       | 내용                                         |
-| ---------- | -------------------------------------------- |
-| 버전       | 0.1                                          |
-| 프로세스명 | UI설계                                       |
-| 화면명     | 체크리스트관리                               |
-| 화면 유형  | [v] 조회 [v] 입력 [v] 수정 [v] 삭제 [ ] 출력 |
-| 메뉴 경로  | 디지털행정지원 > 시스템관리 > 체크리스트관리 |
-
---
-
-## 2. 화면 목적
-
-업무별·문서별 **점검표**(체크리스트)를 등록·관리하고, **점검항목** 마스터를 유지한다. 상단 좌측에서 점검표를 선택하면 하단 **체크리스트 항목** 영역에 해당 점검표의 검토 구성(계층형 검토내용)을 편집한다. 상단 우측 **점검항목 관리**는 점검표에 연결할 항목 풀을 등록·수정·삭제한다.
-
---
-
-## 3. 화면 구성
-
-### 3-1. 전체 레이아웃
-
-```
-┌───────────────────────────────────────────────────────────────────────────────────────────────┐
-│  페이지 타이틀: 체크리스트관리                              브레드크럼: 디지털행정지원 > … >  │
-├──────────────────────────────────────────────┬────────────────────────────────────────────────┤
-│  [영역 A] 점검표 관리                        │  [영역 B] 점검항목 관리                        │
-│                              [점검표 추가]   │                              [점검항목 추가]   │
-│  ┌────────────────────────────────────────┐  │  ┌──────────────────────────────────────────┐  │
-│  │ 점검표일련번호 | 점검표명 | 문서구분   │  │  │ 점검항목코드 | 점검항목명 | 사용여부     │  │
-│  │ 업무구분 | 사용여부 | 등록일시 | 관리  │  │  │ 등록일시 | 관리                          │  │
-│  ├────────────────────────────────────────┤  │  ├──────────────────────────────────────────┤  │
-│  │ 1 (선택 행 강조)         [관리] [삭제] │  │  │ ITEM_001 요건검토 …         [관리][삭제] │  │
-│  │                                        │  │  │ ITEM_002 법령검토 …         [관리][삭제] │  │
-│  └────────────────────────────────────────┘  │  └──────────────────────────────────────────┘  │
-├──────────────────────────────────────────────┴────────────────────────────────────────────────┤
-│  [영역 C] 체크리스트 항목                                         [미리보기]  [추가]  [저장]  │
-│  ┌─────────────────────────────────────────────────────────────────────────────────────────┐  │
-│  │ 점검항목 ▼        | 주요 검토내용            | 사용 여부            | 구분  | 관리      │  │
-│  │ L1 [요건검토 ▼]   | (입력)                   | ○예 ○아니오          | 1단계 | [하위추가]│  │
-│  │ L2 [요건검토 ▼]   | (입력)                   | ○예 ○아니오          | 2단계 | [삭제]    │  │
-│  └─────────────────────────────────────────────────────────────────────────────────────────┘  │
-└───────────────────────────────────────────────────────────────────────────────────────────────┘
-```
-
-### 3-2. 화면 데이터 흐름
-
-```
-BEGIN
-
-  // 최초 진입
-  CALL GET /as-checklist-service/api/v1/cklst
-  DISPLAY 점검표 그리드 (영역 A)
-  CALL GET /as-checklist-service/api/v1/cklst-artcl
-  DISPLAY 점검항목 그리드 (영역 B)
-  DISPLAY 빈 상태 안내 (영역 C)            // 점검표 미선택 시 C 비활성
-
-  // 영역 A: 점검표 행 선택
-  ON 영역 A 행 CLICK DO
-      SET 선택된 점검표 = 행.cklstSn
-      CALL GET /as-checklist-service/api/v1/cklst-rvw?cklstSn={cklstSn}
-      // TBD: 점검표 단위 전체 검토 트리 조회 API — 현재는 항목별 by-artcl 조합 또는 클라이언트 병합
-      DISPLAY 체크리스트 항목 그리드 (영역 C)
-  END ON
-
-  // 영역 A: 점검표 추가
-  ON [점검표 추가] 버튼 CLICK DO
-      OPEN 점검표 추가 다이얼로그
-      ON [저장] DO
-          VALIDATE cklstNm, taskSeComCd
-          CALL POST /as-checklist-service/api/v1/cklst
-          CALL GET /as-checklist-service/api/v1/cklst
-          CLOSE 다이얼로그
-      END ON
-      ON [취소] / [닫기] DO
-          CLOSE 다이얼로그
-      END ON
-  END ON
-
-  // 영역 A: 점검표 수정·삭제
-  ON 영역 A 행 [관리] CLICK DO
-      OPEN 점검표 수정 다이얼로그 (기존 값 초기화)
-      ON [저장] DO
-          CALL PUT /as-checklist-service/api/v1/cklst/{cklstSn}
-          CALL GET /as-checklist-service/api/v1/cklst
-      END ON
-  END ON
-
-  ON 영역 A 행 [삭제] CLICK DO
-      CONFIRM "선택한 점검표를 삭제하시겠습니까?"
-      CALL DELETE /as-checklist-service/api/v1/cklst/{cklstSn}
-      IF 삭제 대상 == 선택된 점검표 THEN RESET 영역 C
-      CALL GET /as-checklist-service/api/v1/cklst
-  END ON
-
-  // 영역 B: 점검항목 추가
-  ON [점검항목 추가] 버튼 CLICK DO
-      OPEN 점검항목 추가 다이얼로그
-      ON [저장] DO
-          VALIDATE cklstArtclNm
-          // TBD: cklstSn 필수 — UI에 소속 점검표 선택 없음. 백엔드 정책 확인
-          CALL POST /as-checklist-service/api/v1/cklst-artcl
-          CALL GET /as-checklist-service/api/v1/cklst-artcl
-          CLOSE 다이얼로그
-      END ON
-  END ON
-
-  // 영역 B: 점검항목 수정·삭제
-  ON 영역 B 행 [관리] CLICK DO
-      OPEN 점검항목 수정 다이얼로그
-      ON [저장] DO
-          CALL PUT /as-checklist-service/api/v1/cklst-artcl/{cklstArtclSn}/{cklstSn}
-      END ON
-  END ON
-
-  ON 영역 B 행 [삭제] CLICK DO
-      CONFIRM "선택한 점검항목을 삭제하시겠습니까?"
-      CALL DELETE /as-checklist-service/api/v1/cklst-artcl/{cklstArtclSn}/{cklstSn}
-      CALL GET /as-checklist-service/api/v1/cklst-artcl
-  END ON
-
-  // 영역 C: 검토 행 추가
-  ON [추가] 버튼 CLICK DO
-      VALIDATE 선택된 점검표 존재
-      ADD 영역 C 그리드 맨 아래 편집 가능 행 (1단계, rvwCnLvNo=1)
-  END ON
-
-  // 영역 C: 하위 검토 추가
-  ON 행 [하위추가] CLICK DO
-      ADD 부모행 하위 편집 행 (2단계, upCklstRvwSn=부모.cklstRvwSn, rvwCnLvNo=2)
-  END ON
-
-  // 영역 C: 일괄 저장
-  ON [저장] 버튼 CLICK DO
-      VALIDATE 선택된 점검표 존재
-      FOR EACH 신규·변경된 검토 행 DO
-          IF 신규 THEN
-              CALL POST /as-checklist-service/api/v1/cklst-rvw
-          ELSE
-              CALL PUT /as-checklist-service/api/v1/cklst-rvw/{cklstRvwSn}/{cklstArtclSn}/{cklstSn}
-          END IF
-      END FOR
-      CALL GET /as-checklist-service/api/v1/cklst-rvw?cklstSn={cklstSn}
-      TOAST "체크리스트 항목이 저장되었습니다."
-  END ON
-
-  // 영역 C: 행 삭제
-  ON 행 [삭제] CLICK DO
-      CONFIRM "선택한 항목을 삭제하시겠습니까?"
-      IF 서버 저장된 행 THEN
-          CALL DELETE /as-checklist-service/api/v1/cklst-rvw/{cklstRvwSn}/{cklstArtclSn}/{cklstSn}
-      END IF
-      REMOVE 그리드 행 (미저장 행은 API 호출 없이 제거)
-  END ON
-
-  // 영역 C: 미리보기
-  ON [미리보기] 버튼 CLICK DO
-      OPEN 체크리스트 미리보기 다이얼로그 (읽기 전용 트리)
-      // TBD: 미리보기 UI·API
-  END ON
-
-END
-```
-
---
-
-## 4. 영역 A: 점검표 관리
-
-선택된 점검표가 영역 C의 편집 대상이 된다. 행 클릭으로 선택 상태를 표시한다.
-
-### 4-1. 헤더 / 툴바
-
-| 항목        | 내용                                       |
-| ----------- | ------------------------------------------ |
-| 섹션 타이틀 | 점검표 관리                                |
-| 우측 버튼   | **[점검표 추가]** — 점검표 등록 다이얼로그 |
-
-### 4-2. 그리드 컬럼
-
-| 컬럼명           | Field         | 타입   | 비고                                                 |
-| ---------------- | ------------- | ------ | ---------------------------------------------------- |
-| 점검표일련번호   | `cklstSn`     | number | PK                                                   |
-| 점검표명         | `cklstNm`     | string |                                                      |
-| 문서구분공통코드 | `docSeComCd`  | string | 코드명 표시 — `ASDOCSECD` 등 공통코드 (TBD 상위코드) |
-| 업무구분공통코드 | `taskSeComCd` | string | RE/SF/SP 등 — 공통코드 (TBD 상위코드)                |
-| 사용여부         | `useYn`       | string | `Y`→예, `N`→아니오                                   |
-| 등록일시         | `regDt`       | string | `yyyy-MM-dd HH:mm:ss`                                |
-| 관리             | —             | —      | 행별 **[관리] · [삭제]**                             |
-
- 행 클릭 시: `cklstSn` 선택 → 영역 C 헤더·그리드 갱신.
- 페이지네이션: Spring `Pageable` (`page`, `size`, `sort`).
-
-### 4-3. 버튼
-
-| 버튼명      | 위치           | 동작                                              |
-| ----------- | -------------- | ------------------------------------------------- |
-| 점검표 추가 | 섹션 우측 상단 | 점검표 추가 다이얼로그 오픈                       |
-| 관리        | 행별           | 점검표 수정 다이얼로그 (기존 값 초기화)           |
-| 삭제        | 행별           | 확인 후 삭제. 선택 중인 점검표이면 영역 C 초기화. |
-
-### 4-4. 다이얼로그: 점검표 추가 / 수정
-
-| 표시명   | 입력 유형        | 필수 | 기본값 | API 파라미터 매핑 | 비고                                             |
-| -------- | ---------------- | ---- | ------ | ----------------- | ------------------------------------------------ |
-| 점검표명 | Text             | Y    | —      | `cklstNm`         | placeholder: "예: 설치인가 체크리스트"           |
-| 문서구분 | Select(공통코드) | N    | —      | `docSeComCd`      | 예: FNRS, INSTL, PWRK, DESIGN                    |
-| 업무구분 | Select(공통코드) | Y    | —      | `taskSeComCd`     | 예: RE(재이용수), SF(하수처리시설), SP(하수관로) |
-| 사용여부 | Select           | N    | Y      | `useYn`           | Y/N, UI 표시: 예/아니오                          |
-
-| 버튼명 | 동작                                   |
-| ------ | -------------------------------------- |
-| 저장   | POST(등록) 또는 PUT(수정) 후 목록 갱신 |
-| 취소   | 다이얼로그 닫기, 입력값 폐기           |
-| 닫기   | 다이얼로그 닫기                        |
-
---
-
-## 5. 영역 B: 점검항목 관리
-
-점검표 하단(영역 C)에서 선택할 **점검항목** 마스터를 관리한다.
-
-### 5-1. 헤더 / 툴바
-
-| 항목        | 내용                                           |
-| ----------- | ---------------------------------------------- |
-| 섹션 타이틀 | 점검항목 관리                                  |
-| 우측 버튼   | **[점검항목 추가]** — 점검항목 등록 다이얼로그 |
-
-### 5-2. 그리드 컬럼
-
-| 컬럼명       | Field          | 타입   | 비고                                  |
-| ------------ | -------------- | ------ | ------------------------------------- |
-| 점검항목코드 | `cklstArtclSn` | number | UI mock `ITEM_001` 형식 표시 여부 TBD |
-| 점검항목명   | `cklstArtclNm` | string |                                       |
-| 사용여부     | `useYn`        | string | `Y`→예, `N`→아니오                    |
-| 등록일시     | `regDt`        | string | `yyyy-MM-dd HH:mm:ss`                 |
-| 관리         | —              | —      | 행별 **[관리] · [삭제]**              |
-
-> **TBD**: 백엔드 `CklstArtcl`은 복합 PK(`cklstArtclSn`, `cklstSn`)이며 등록 시 `cklstSn` 필수. UI 다이얼로그에는 `cklstSn` 입력이 없음 — 소속 점검표 지정 방식·전역 마스터 여부 백엔드 정책 확인.
-
-### 5-3. 다이얼로그: 점검항목 추가 / 수정
-
-| 표시명     | 입력 유형 | 필수 | 기본값 | API 파라미터 매핑 | 비고                        |
-| ---------- | --------- | ---- | ------ | ----------------- | --------------------------- |
-| 점검항목명 | Text      | Y    | —      | `cklstArtclNm`    | placeholder: "예: 법령검토" |
-| 사용여부   | Select    | N    | Y      | `useYn`           | Y/N                         |
-
-| 버튼명 | 동작                                   |
-| ------ | -------------------------------------- |
-| 저장   | POST(등록) 또는 PUT(수정) 후 목록 갱신 |
-| 취소   | 다이얼로그 닫기                        |
-| 닫기   | 다이얼로그 닫기                        |
-
---
-
-## 6. 영역 C: 체크리스트 항목 (선택된 점검표)
-
-영역 A에서 선택된 `cklstSn` 기준으로 **점검표검토**(계층형 검토내용)를 구성한다.
-
-### 6-1. 헤더 / 툴바
-
-| 항목        | 내용                                                                 |
-| ----------- | -------------------------------------------------------------------- |
-| 섹션 타이틀 | 체크리스트 항목 (선택된 점검표: {cklstNm})                           |
-| 우측 버튼   | **[미리보기]** · **[추가]** · **[저장]** — 점검표 미선택 시 C 비활성 |
-
-### 6-2. 그리드 컬럼
-
-| 컬럼명        | Field          | 입력 UI                               | 비고                                 |
-| ------------- | -------------- | ------------------------------------- | ------------------------------------ |
-| 점검항목      | `cklstArtclSn` | Select (영역 B 항목 목록)             | L1/L2 접두 표시, `cklstArtclNm` 라벨 |
-| 주요 검토내용 | `rvwCn`        | Text / Textarea                       | 최대 4000자                          |
-| 사용 여부     | `useYn`        | Radio (예/아니오)                     | `Y` / `N`                            |
-| 구분          | `rvwCnLvNo`    | 읽기 전용                             | 1→1단계, 2→2단계, 3→3단계            |
-| 관리          | —              | **[하위추가]** (1·2단계, 저장 후) · **[삭제]** | 3단계 행은 [하위추가] 미표시         |
-
-#### 계층 정책
-
-| 항목           | 내용                                                                 |
-| -------------- | -------------------------------------------------------------------- |
-| 최대 깊이      | 3단계 (`rvwCnLvNo`: 1, 2, 3)                                         |
-| 상위-하위 연결 | `upCklstRvwSn` — 2단계 행은 부모 1단계 `cklstRvwSn` 참조             |
-| 정렬           | `sortSeq` — 동일 레벨 내 순서 (TBD: UI 드래그 정렬 여부)             |
-| 체크 사용      | `bchckUseYn` — 미리보기·실사용 화면 체크박스 노출 여부 (TBD UI 반영) |
-
-### 6-3. 버튼
-
-| 버튼명   | 동작                                                 |
-| -------- | ---------------------------------------------------- |
-| 추가     | 1단계 검토 행 1건 추가 (편집 가능)                   |
-| 저장     | 변경·신규 검토 행 일괄 POST/PUT (일괄 저장 API 없음) |
-| 미리보기 | 선택 점검표 체크리스트 읽기 전용 미리보기 (TBD)      |
-| 하위추가 | 선택 1·2단계 행 아래 하위 단계(2·3단계) 자식 행 추가 |
-| 삭제     | 확인 후 DELETE 또는 미저장 행 로컬 제거              |
-
---
-
-## 7. API/DTO 명세
-
-### 7-1. 공통
-
-| 항목          | 내용                                                          |
-| ------------- | ------------------------------------------------------------- |
-| 서비스        | `as-checklist-service`                                        |
-| Base prefix   | `/as-checklist-service/api/v1` (게이트웨이 프록시 경유)       |
-| 인증          | JWT (`Authorization` 헤더), `X-Site-Id`, `token-id`           |
-| 페이징        | Spring `Pageable`: `page`, `size`, `sort` → `PageResponse<T>` |
-| 엔티티        | `@/entities/cklst` (`cklstMngService`, `cklstArtclService`, `cklstRvwService`) |
-
-### 7-2. 점검표 (영역 A) — `cklst`
-
-| 기능      | Method | URL                | Request / Query                   | Response           | 클라이언트                 |
-| --------- | ------ | ------------------ | --------------------------------- | ------------------ | -------------------------- |
-| 목록 조회 | GET    | `/cklst`           | `CklstMngSearchParams` + Pageable | `Page<CklstMng>`   | `cklstMngService.findPage` |
-| 단건 조회 | GET    | `/cklst/{cklstSn}` | —                                 | `CklstMng`         | `cklstMngService.findById` |
-| 등록      | POST   | `/cklst`           | `CklstMngSaveRequest`             | `number` (cklstSn) | `cklstMngService.create`   |
-| 수정      | PUT    | `/cklst/{cklstSn}` | `CklstMngSaveRequest`             | `number` (cklstSn) | `cklstMngService.update`   |
-| 삭제      | DELETE | `/cklst/{cklstSn}` | —                                 | `number` (cklstSn) | `cklstMngService.remove`   |
-
-**CklstMng (응답)**
-
-| Field         | 타입    | 설명             |
-| ------------- | ------- | ---------------- |
-| `cklstSn`     | number  | 점검표일련번호   |
-| `cklstNm`     | string  | 점검표명         |
-| `taskSeComCd` | string  | 업무구분공통코드 |
-| `useYn`       | string? | 사용여부         |
-| `docSeComCd`  | string? | 문서구분공통코드 |
-| `rgtr`        | string? | 등록자 UUID      |
-| `rgtrNm`      | string? | 등록자명         |
-| `mdfr`        | string? | 수정자 UUID      |
-| `regDt`       | string? | 등록일시         |
-| `mdfcnDt`     | string? | 수정일시         |
-
-**CklstMngSaveRequest**: `cklstNm`\*, `taskSeComCd`\*, `useYn?`, `docSeComCd?`
-
-**CklstMngSearchParams**: `cklstNm?`, `taskSeComCd?`, `useYn?`, `docSeComCd?` + `page`, `size`, `sort`
-
-**React Query hooks**: `useCklstMngPage`, `useCklstMng`, `useCreateCklstMng`, `useUpdateCklstMng`, `useDeleteCklstMng`
-
-### 7-3. 점검표항목 (영역 B) — `cklst-artcl`
-
-| 기능               | Method | URL                                     | Request / Query                     | Response           | 클라이언트                        |
-| ------------------ | ------ | --------------------------------------- | ----------------------------------- | ------------------ | --------------------------------- |
-| 목록 조회 (페이징) | GET    | `/cklst-artcl`                          | `CklstArtclSearchParams` + Pageable | `Page<CklstArtcl>` | `cklstArtclService.findPage`      |
-| 점검표별 전체 목록 | GET    | `/cklst-artcl/by-cklst/{cklstSn}`       | —                                   | `CklstArtcl[]`     | `cklstArtclService.findByCklstSn` |
-| 단건 조회          | GET    | `/cklst-artcl/{cklstArtclSn}/{cklstSn}` | —                                   | `CklstArtcl`       | `cklstArtclService.findById`      |
-| 등록               | POST   | `/cklst-artcl`                          | `CklstArtclSaveRequest`             | `CklstArtclId`     | `cklstArtclService.create`        |
-| 수정               | PUT    | `/cklst-artcl/{cklstArtclSn}/{cklstSn}` | `CklstArtclUpdateRequest`           | `CklstArtclId`     | `cklstArtclService.update`        |
-| 삭제               | DELETE | `/cklst-artcl/{cklstArtclSn}/{cklstSn}` | —                                   | `CklstArtclId`     | `cklstArtclService.remove`        |
-
-**CklstArtcl (응답)**
-
-| Field             | 타입    | 설명               |
-| ----------------- | ------- | ------------------ |
-| `cklstArtclSn`    | number  | 점검표항목일련번호 |
-| `cklstSn`         | number  | 점검표일련번호     |
-| `cklstArtclNm`    | string? | 점검표항목명       |
-| `useYn`           | string? | 사용여부           |
-| `rgtr` / `rgtrNm` | string? | 등록자             |
-| `regDt`           | string? | 등록일시           |
-
-**CklstArtclSaveRequest**: `cklstSn`\*, `cklstArtclNm?`, `useYn?`
-
-**CklstArtclUpdateRequest**: `cklstArtclNm?`, `useYn?`
-
-**CklstArtclId**: `{ cklstArtclSn: number; cklstSn: number }`
-
-**React Query hooks**: `useCklstArtclPage`, `useCklstArtclList`, `useCklstArtcl`, `useCreateCklstArtcl`, `useUpdateCklstArtcl`, `useDeleteCklstArtcl`
-
-### 7-4. 점검표검토 (영역 C) — `cklst-rvw`
-
-| 기능                  | Method | URL                                                | Request / Query                | Response         | 클라이언트                      |
-| --------------------- | ------ | -------------------------------------------------- | ------------------------------ | ---------------- | ------------------------------- |
-| 목록 조회 (페이징)    | GET    | `/cklst-rvw`                                       | `CklstRvwSearchParams` + Pageable | `Page<CklstRvw>` | `cklstRvwService.findPage`      |
-| 항목별 검토 전체 목록 | GET    | `/cklst-rvw/by-artcl/{cklstSn}/{cklstArtclSn}`     | —                              | `CklstRvw[]`     | `cklstRvwService.findByArtcl`   |
-| 단건 조회             | GET    | `/cklst-rvw/{cklstRvwSn}/{cklstArtclSn}/{cklstSn}` | —                              | `CklstRvw`       | `cklstRvwService.findById`      |
-| 등록                  | POST   | `/cklst-rvw`                                       | `CklstRvwSaveRequest`          | `CklstRvwId`     | `cklstRvwService.create`        |
-| 수정                  | PUT    | `/cklst-rvw/{cklstRvwSn}/{cklstArtclSn}/{cklstSn}` | `CklstRvwUpdateRequest`        | `CklstRvwId`     | `cklstRvwService.update`        |
-| 삭제                  | DELETE | `/cklst-rvw/{cklstRvwSn}/{cklstArtclSn}/{cklstSn}` | —                              | `CklstRvwId`     | `cklstRvwService.remove`        |
-
-**CklstRvw (응답)**
-
-| Field          | 타입    | 설명                   |
-| -------------- | ------- | ---------------------- |
-| `cklstRvwSn`   | number  | 점검표검토일련번호     |
-| `cklstArtclSn` | number  | 점검표항목일련번호     |
-| `cklstSn`      | number  | 점검표일련번호         |
-| `upCklstRvwSn` | number? | 상위점검표검토일련번호 |
-| `rvwCnLvNo`    | number? | 검토내용레벨번호       |
-| `rvwCn`        | string? | 검토내용               |
-| `bchckUseYn`   | string? | 체크사용여부           |
-| `sortSeq`      | number? | 정렬순서               |
-| `useYn`        | string? | 사용여부               |
-| `regDt`        | string? | 등록일시               |
-
-**CklstRvwSaveRequest**: `cklstArtclSn`\*, `cklstSn`\*, `upCklstRvwSn?`, `rvwCnLvNo?`, `rvwCn?`, `bchckUseYn?`, `sortSeq?`, `useYn?`
-
-**CklstRvwUpdateRequest**: `upCklstRvwSn?`, `rvwCnLvNo?`, `rvwCn?`, `bchckUseYn?`, `sortSeq?`, `useYn?`
-
-**CklstRvwSearchParams**: `cklstSn?`, `cklstArtclSn?`, `useYn?` + `page`, `size`, `sort`
-
-**CklstRvwId**: `{ cklstRvwSn: number; cklstArtclSn: number; cklstSn: number }`
-
-**React Query hooks**: `useCklstRvwPage`, `useCklstRvwByArtcl`, `useCklstRvw`, `useCreateCklstRvw`, `useUpdateCklstRvw`, `useDeleteCklstRvw`
-
-### 7-5. 공통코드 (보조)
-
-| UI 필드  | 코드 그룹 (TBD) | 예시 값                                      |
-| -------- | --------------- | -------------------------------------------- |
-| 문서구분 | `ASDOCSECD` 등  | FNRS, INSTL, PWRK, DESIGN                    |
-| 업무구분 | TBD             | RE(재이용수), SF(하수처리시설), SP(하수관로) |
-| 사용여부 | 고정            | Y, N                                         |
-
-공통코드 조회: `@/entities/code` — `codeService`, `CodeSelect`
-
---
-
-## 8. UI 구현 가이드
-
-### 8-1. 기술 스택·원칙
-
- **공통 컴포넌트**: `@common/components` (`Dialog`, `Button`, `Input`, `Select`, `RadioGroup` 등)
- **테이블**: `@tanstack/react-table` + `useDataTable`
- **데이터**: React Query — `@/entities/cklst` hooks (`useCklstRvwPage` 등 영역 C 포함)
- **공통코드**: `@/entities/code` — `CodeSelect`, `findCodeLabel`
- **상태**: 선택된 `cklstSn`, 영역 C 검토 행 배열(신규·dirty·계층 트리)
- **모의 데이터**: API 연동 전 `@faker-js/faker`
-
-### 8-2. 모듈·파일 배치(제안)
-
-| 구분   | 경로                                                                                                                                                              |
-| ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| 라우트 | `apps/as/app/(with-base-layout)/checklist-management/page.tsx`                                                                                                    |
-| 페이지 | `apps/as/src/pages/checklist-management/` (Public API: page만 export)                                                                                             |
-| UI     | `.../ui/cklst-mng-list.tsx`, `cklst-mng-form-dialog.tsx`, `cklst-artcl-list.tsx`, `cklst-artcl-form-dialog.tsx`, `cklst-rvw-grid.tsx`, `cklst-preview-dialog.tsx` |
-| model  | `.../model/cklst-mng-columns.tsx`, `cklst-artcl-columns.tsx`, `cklst-rvw-row-types.ts`                                                                            |
-| lib    | `.../lib/use-cklst-rvw-rows.ts`, `validators.ts`, `build-rvw-tree.ts`                                                                                             |
-| 엔티티 | `apps/as/src/entities/cklst/` (`cklstMng`, `cklstArtcl`, `cklstRvw` 서비스·hooks)                                                                                 |
-| 페이지 | `apps/as/src/pages/checklist-management/` — `/checklist-management`                                                                                              |
-| 문서   | `apps/as/docs/checklist-management/SPEC.md`                                                                                                                       |
-
-### 8-3. 영역별 UI 매핑
-
-| 영역 | 주요 UI                                                                      |
-| ---- | ---------------------------------------------------------------------------- |
-| A    | DataTable + 행 선택 + 점검표 추가/수정 Dialog                                |
-| B    | DataTable + 점검항목 추가/수정 Dialog                                        |
-| C    | 계층형 편집 그리드(1·2단계) + [추가][저장][미리보기] + 행별 [하위추가][삭제] |
-| 공통 | `CodeSelect` (문서구분·업무구분), 사용여부 Y/N Select/Radio                  |
-
-### 8-4. 다이얼로그·라우팅
-
-| 다이얼로그명        | 트리거          | API 연동                  |
-| ------------------- | --------------- | ------------------------- |
-| 점검표 추가         | [점검표 추가]   | `useCreateCklstMng`       |
-| 점검표 수정         | 행 [관리]       | `useUpdateCklstMng`       |
-| 점검표 삭제 확인    | 행 [삭제]       | `useDeleteCklstMng`       |
-| 점검항목 추가       | [점검항목 추가] | `useCreateCklstArtcl`     |
-| 점검항목 수정       | 행 [관리]       | `useUpdateCklstArtcl`     |
-| 체크리스트 미리보기 | [미리보기]      | TBD — 읽기 전용 트리 렌더 |
-
-라우트: `/checklist-management` (메뉴 URL은 CMS 등록값과 일치시킴)
-
-### 8-5. 데이터 흐름(요약)
-
- **진입**: `useCklstMngPage` → 영역 A, `useCklstArtclPage` → 영역 B. C 비활성.
- **점검표 선택**: `cklstSn` 설정 → 영역 C 활성 → `useCklstRvwPage({ cklstSn })` → 트리 그리드 표시.
- **점검표 CRUD**: Dialog → `useCreateCklstMng` / `useUpdateCklstMng` / `useDeleteCklstMng`.
- **점검항목 CRUD**: Dialog → `useCreateCklstArtcl` / `useUpdateCklstArtcl` / `useDeleteCklstArtcl`.
- **검토 저장**: [저장] → 신규 POST / 기존 PUT 순차 호출 (일괄 API 없음).
- **영역 C 점검항목 Select**: `useCklstArtclList(cklstSn)` 또는 영역 B 전체 목록과 교차 — **TBD**.
-
-### 8-6. 미확정 / 검증 필요
-
- [ ] 영역 B 점검항목 등록 시 `cklstSn` 필수 vs UI 무소속 마스터 — 백엔드·기획 확인
- [ ] `점검항목코드`(ITEM_001) 표시 형식 vs `cklstArtclSn` 숫자 PK
- [ ] 영역 C 전체 검토 트리 조회: `cklstSn` 단위 일괄 API 부재 — `by-artcl` 다건 호출 또는 백엔드 확장
- [x] `@/entities/cklst` — `cklstRvwService`·hooks 구현
- [x] `pages/checklist-management` — 영역 A·B·C UI 구현 (`/checklist-management`)
- [ ] 문서구분·업무구분 공통코드 상위코드 ID (`ASDOCSECD` 등)
- [ ] [미리보기] 다이얼로그 UI·데이터 소스
- [ ] `bchckUseYn` UI 반영 여부
- [ ] 영역 A·B 페이지네이션·검색 UI 노출 여부
- [ ] 권한(역할별 CRUD)
@@ -1,385 +0,0 @@
-# 화면설계서: 코드관리
-
-## 1. 기본 정보
-
-| 항목       | 내용                                         |
-| ---------- | -------------------------------------------- |
-| 버전       | 0.1                                          |
-| 프로세스명 | UI설계                                       |
-| 화면명     | 코드관리                                     |
-| 화면 유형  | [v] 조회 [v] 입력 [v] 수정 [v] 삭제 [ ] 출력 |
-| 메뉴 경로  | 디지털행정지원 > 사이트관리 > 코드관리       |
-
---
-
-## 2. 화면 목적
-
-설치인가 등 AS 업무에서 참조하는 **공종구분코드**(공종코드)와 **회계구분코드**(회계코드)를 한 화면에서 조회·등록·수정·삭제한다. 좌측 **공종코드 관리**와 우측 **회계코드 관리**는 독립된 목록·CRUD 영역이며, 각 섹션은 자체 API(`cnstp-se`, `acntg-se`)와 연동한다.
-
---
-
-## 3. 화면 구성
-
-### 3-1. 전체 레이아웃
-
-```
-┌───────────────────────────────────────────────────────────────────────────────────────────────────┐
-│  페이지 타이틀: 코드관리                      브레드크럼: 디지털행정지원 > 사이트관리 > 코드관리  │
-├──────────────────────────────────────────────────┬────────────────────────────────────────────────┤
-│  [영역 A] 공종코드 관리                          │  [영역 B] 회계코드 관리                        │
-│                                         [등록]   │                                       [등록]   │
-│  ┌────────────────────────────────────────────┐  │  ┌──────────────────────────────────────────┐  │
-│  │ 코드 | 코드명 | 설명 | 사용여부 | 관리     │  │  │ 코드 | 코드명 | 설명 | 사용여부 | 관리   │  │
-│  ├────────────────────────────────────────────┤  │  ├──────────────────────────────────────────┤  │
-│  │ WC001 공공하수처리시설 …  사용 [수정][삭제]│  │  │ AC101 시설비 …         사용 [수정][삭제] │  │
-│  │ WC002 하수관로정비 …      사용 [수정][삭제]│  │  │ AC102 용역비 …         사용 [수정][삭제] │  │
-│  │ WC003 재이용시설 …        사용 [수정][삭제]│  │  │ AC103 운영비 …       미사용 [수정][삭제] │  │
-│  └────────────────────────────────────────────┘  │  └──────────────────────────────────────────┘  │
-│  « 1 2 3 … »                                     │  « 1 2 3 … »                                   │
-└──────────────────────────────────────────────────┴────────────────────────────────────────────────┘
-```
-
-### 3-2. 화면 데이터 흐름
-
-```
-BEGIN
-
-  // 최초 진입 — 좌·우 독립 조회
-  CALL cnstpSeMngService.findAll({ page, size })
-  DISPLAY 공종코드 그리드 (영역 A)
-
-  CALL acntgSeMngService.findAll({ page, size })
-  DISPLAY 회계코드 그리드 (영역 B)
-
-  // 영역 A: 공종코드 등록
-  ON 영역 A [등록] 버튼 CLICK DO
-      OPEN 공종코드 등록 다이얼로그
-      ON [저장] DO
-          VALIDATE cnstpSeCd
-          CALL cnstpSeMngService.save(CnstpSeMngSaveRequestDto)
-          CALL cnstpSeMngService.findAll
-          CLOSE 다이얼로그
-      END ON
-      ON [취소] / [닫기] DO
-          CLOSE 다이얼로그
-      END ON
-  END ON
-
-  // 영역 A: 공종코드 수정
-  ON 영역 A 행 [수정] CLICK DO
-      CALL cnstpSeMngService.findById(cnstpSeCd)
-      OPEN 공종코드 수정 다이얼로그 (기존 값 초기화)
-      ON [저장] DO
-          CALL cnstpSeMngService.update(cnstpSeCd, CnstpSeMngSaveRequestDto)
-          CALL cnstpSeMngService.findAll
-          CLOSE 다이얼로그
-      END ON
-  END ON
-
-  // 영역 A: 공종코드 삭제
-  ON 영역 A 행 [삭제] CLICK DO
-      CONFIRM "선택한 공종코드를 삭제하시겠습니까?"
-      CALL cnstpSeMngService.delete(cnstpSeCd)
-      CALL cnstpSeMngService.findAll
-  END ON
-
-  // 영역 B: 회계코드 등록
-  ON 영역 B [등록] 버튼 CLICK DO
-      OPEN 회계코드 등록 다이얼로그
-      ON [저장] DO
-          VALIDATE acntgSeCd, acntgSeCdNm
-          CALL acntgSeMngService.save(AcntgSeMngSaveRequestDto)
-          CALL acntgSeMngService.findAll
-          CLOSE 다이얼로그
-      END ON
-      ON [취소] / [닫기] DO
-          CLOSE 다이얼로그
-      END ON
-  END ON
-
-  // 영역 B: 회계코드 수정
-  ON 영역 B 행 [수정] CLICK DO
-      CALL acntgSeMngService.findById(acntgSeCd)
-      OPEN 회계코드 수정 다이얼로그 (기존 값 초기화)
-      ON [저장] DO
-          CALL acntgSeMngService.update(acntgSeCd, AcntgSeMngSaveRequestDto)
-          CALL acntgSeMngService.findAll
-          CLOSE 다이얼로그
-      END ON
-  END ON
-
-  // 영역 B: 회계코드 삭제
-  ON 영역 B 행 [삭제] CLICK DO
-      CONFIRM "선택한 회계코드를 삭제하시겠습니까?"
-      CALL acntgSeMngService.delete(acntgSeCd)
-      CALL acntgSeMngService.findAll
-  END ON
-
-END
-```
-
---
-
-## 4. 영역 A: 공종코드 관리
-
-백엔드 **공종구분코드**(`CnstpSeMng`) CRUD. 계층 구조(`upCnstpCd`, `cdLvNo`)를 지원하나, 본 화면은 **평면 목록**으로 표시.
-
-### 4-1. 헤더 / 툴바
-
-| 항목        | 내용                                  |
-| ----------- | ------------------------------------- |
-| 섹션 타이틀 | 공종코드 관리                         |
-| 우측 버튼   | **[등록]** — 공종코드 등록 다이얼로그 |
-
-### 4-2. 그리드 컬럼
-
-| 컬럼명   | Field         | 타입   | 비고                     |
-| -------- | ------------- | ------ | ------------------------ |
-| 코드     | `cnstpSeCd`   | string | PK, 최대 10자            |
-| 코드명   | `cnstpSeCdNm` | string | 최대 100자               |
-| 설명     | `expln`       | string | 최대 1000자, 선택        |
-| 사용여부 | `useYn`       | string | `Y`→사용, `N`→미사용     |
-| 관리     | —             | —      | 행별 **[수정] · [삭제]** |
-
- 행 클릭 시 별도 상세 이동 없음. 수정은 **[수정]** 버튼으로 다이얼로그 진입.
- 페이지네이션: Spring `Pageable` (`page`, `size`, `sort`) — **UI 노출**. 기본 `size: 10`, `@common/components` 공통 페이지네이션 컴포넌트 사용.
-
-### 4-3. 버튼
-
-| 버튼명 | 위치           | 동작                                     |
-| ------ | -------------- | ---------------------------------------- |
-| 등록   | 섹션 우측 상단 | 공종코드 등록 다이얼로그 오픈            |
-| 수정   | 행별           | 상세 조회 후 수정 다이얼로그 (값 초기화) |
-| 삭제   | 행별           | 확인 후 삭제, 목록 갱신                  |
-
-### 4-4. 다이얼로그: 공종코드 등록 / 수정
-
-다이얼로그 입력 필드는 **코드 · 코드명 · 설명 · 사용여부** 4개만 노출한다.
-
-| 표시명   | 입력 유형 | 필수 | 기본값 | API 파라미터 매핑 | 비고                            |
-| -------- | --------- | ---- | ------ | ----------------- | ------------------------------- |
-| 코드     | Input     | Y    | —      | `cnstpSeCd`       | 등록 시 입력, 수정 시 읽기 전용 |
-| 코드명   | Input     | N    | —      | `cnstpSeCdNm`     | 최대 100자                      |
-| 설명     | Input     | N    | —      | `expln`           | 최대 1000자                     |
-| 사용여부 | Radio     | N    | Y      | `useYn`           | `Y`→사용, `N`→미사용            |
-
-> UI에 노출하지 않는 API 필드(`upCnstpCd`, `cdLvNo`): 등록 시 `cdLvNo: 1` 등 기본값 전송, 수정 시 `findById` 응답값 유지.
-
-| 버튼명 | 동작                                             |
-| ------ | ------------------------------------------------ |
-| 저장   | POST(등록) 또는 PUT(수정) 후 `findAll` 목록 갱신 |
-| 취소   | 다이얼로그 닫기, 입력값 폐기                     |
-| 닫기   | 다이얼로그 닫기                                  |
-
---
-
-## 5. 영역 B: 회계코드 관리
-
-백엔드 **회계구분관리**(`AcntgSeMng`) CRUD. 영역 A와 동일한 **평면 목록** UI 패턴을 따른다.
-
-### 5-1. 헤더 / 툴바
-
-| 항목        | 내용                                  |
-| ----------- | ------------------------------------- |
-| 섹션 타이틀 | 회계코드 관리                         |
-| 우측 버튼   | **[등록]** — 회계코드 등록 다이얼로그 |
-
-### 5-2. 그리드 컬럼
-
-| 컬럼명   | Field         | 타입   | 비고                     |
-| -------- | ------------- | ------ | ------------------------ |
-| 코드     | `acntgSeCd`   | string | PK, 최대 10자            |
-| 코드명   | `acntgSeCdNm` | string | 최대 100자               |
-| 설명     | `expln`       | string | 최대 1000자, 선택        |
-| 사용여부 | `useYn`       | string | `Y`→사용, `N`→미사용     |
-| 관리     | —             | —      | 행별 **[수정] · [삭제]** |
-
- 페이지네이션: 영역 A와 동일 — **UI 노출**, 기본 `size: 10`.
-
-### 5-3. 버튼
-
-| 버튼명 | 위치           | 동작                                     |
-| ------ | -------------- | ---------------------------------------- |
-| 등록   | 섹션 우측 상단 | 회계코드 등록 다이얼로그 오픈            |
-| 수정   | 행별           | 상세 조회 후 수정 다이얼로그 (값 초기화) |
-| 삭제   | 행별           | 확인 후 삭제, 목록 갱신                  |
-
-### 5-4. 다이얼로그: 회계코드 등록 / 수정
-
-다이얼로그 입력 필드는 **코드 · 코드명 · 설명 · 사용여부** 4개만 노출한다. (영역 A와 동일 패턴)
-
-| 표시명   | 입력 유형 | 필수 | 기본값 | API 파라미터 매핑 | 비고                            |
-| -------- | --------- | ---- | ------ | ----------------- | ------------------------------- |
-| 코드     | Input     | Y    | —      | `acntgSeCd`       | 등록 시 입력, 수정 시 읽기 전용 |
-| 코드명   | Input     | Y    | —      | `acntgSeCdNm`     | 최대 100자                      |
-| 설명     | Input     | N    | —      | `expln`           | 최대 1000자                     |
-| 사용여부 | Radio     | N    | Y      | `useYn`           | `Y`→사용, `N`→미사용            |
-
-> UI에 노출하지 않는 API 필드(`upAcntgSeCd`, `cdLvNo`): 등록 시 `cdLvNo: 1` 등 기본값 전송, 수정 시 `findById` 응답값 유지.
-
-| 버튼명 | 동작                                             |
-| ------ | ------------------------------------------------ |
-| 저장   | POST(등록) 또는 PUT(수정) 후 `findAll` 목록 갱신 |
-| 취소   | 다이얼로그 닫기, 입력값 폐기                     |
-| 닫기   | 다이얼로그 닫기                                  |
-
---
-
-## 6. API/DTO 명세
-
-### 6-1. 공통
-
-| 항목        | 내용                                                                               |
-| ----------- | ---------------------------------------------------------------------------------- |
-| 서비스      | `as-service`                                                                       |
-| Base prefix | `/as-service/api/v1` (`ENDPOINT.AS_COMMON_SERVICE`)                                |
-| 인증        | JWT (`Authorization` 헤더), `X-Site-Id`, `token-id`                                |
-| 페이징      | Spring `Pageable`: `page`, `size`, `sort` → `PageResponse<T>`                      |
-| 엔티티      | `@/entities/cnstp` (`cnstpSeMngService`), `@/entities/acntg` (`acntgSeMngService`) |
-
-**부가 API (본 화면 목록 외 참조용)**
-
-| 리소스       | Method | URL                   | Response              | 용도                              |
-| ------------ | ------ | --------------------- | --------------------- | --------------------------------- |
-| 공종구분코드 | GET    | `/cnstp-se/list/tree` | `CnstpSeMngTreeDto[]` | 계층 트리 (타 화면·상위코드 선택) |
-| 회계구분관리 | GET    | `/acntg-se/list/tree` | `AcntgSeMngTreeDto[]` | 계층 트리 (타 화면·상위코드 선택) |
-
-### 6-2. 공종구분코드 (영역 A) — `cnstp-se`
-
-| 기능      | Method | URL                     | Request / Query                  | Response                      | 클라이언트                   |
-| --------- | ------ | ----------------------- | -------------------------------- | ----------------------------- | ---------------------------- |
-| 목록 조회 | GET    | `/cnstp-se`             | `CnstpSeMngSearchDto` + Pageable | `Page<CnstpSeMngResponseDto>` | `cnstpSeMngService.findAll`  |
-| 트리 조회 | GET    | `/cnstp-se/list/tree`   | —                                | `CnstpSeMngTreeDto[]`         | `cnstpSeMngService.findTree` |
-| 상세 조회 | GET    | `/cnstp-se/{cnstpSeCd}` | —                                | `CnstpSeMngResponseDto`       | `cnstpSeMngService.findById` |
-| 등록      | POST   | `/cnstp-se`             | `CnstpSeMngSaveRequestDto`       | `string` (cnstpSeCd)          | `cnstpSeMngService.save`     |
-| 수정      | PUT    | `/cnstp-se/{cnstpSeCd}` | `CnstpSeMngSaveRequestDto`       | `string` (cnstpSeCd)          | `cnstpSeMngService.update`   |
-| 삭제      | DELETE | `/cnstp-se/{cnstpSeCd}` | —                                | `string` (cnstpSeCd)          | `cnstpSeMngService.delete`   |
-
-**CnstpSeMngResponseDto**
-
-| Field         | 타입    | 설명               |
-| ------------- | ------- | ------------------ |
-| `cnstpSeCd`   | string  | 공종구분코드       |
-| `cnstpSeCdNm` | string  | 공종구분코드명     |
-| `upCnstpCd`   | string? | 상위공종코드       |
-| `cdLvNo`      | number  | 코드레벨번호       |
-| `useYn`       | string  | 사용여부           |
-| `expln`       | string? | 설명 (최대 1000자) |
-| `rgtr`        | string? | 등록자 UUID        |
-| `rgtrNm`      | string? | 등록자명           |
-| `mdfr`        | string? | 수정자 UUID        |
-| `regDt`       | string? | 등록일시           |
-| `mdfcnDt`     | string? | 수정일시           |
-
-**CnstpSeMngSaveRequestDto**: `cnstpSeCd`, `cnstpSeCdNm?`, `upCnstpCd?`, `cdLvNo?`, `useYn?`, `expln?`
-
-**CnstpSeMngSearchDto**: `cnstpSeCd?`, `cnstpSeCdNm?`, `useYn?` + `page`, `size`, `sort`
-
-**React Query hooks**: `useCnstpSeMngPage`, `useCnstpSeMngTree`, `useCnstpSeMng`, `useSaveCnstpSeMng`, `useUpdateCnstpSeMng`, `useDeleteCnstpSeMng`
-
-### 6-3. 회계구분관리 (영역 B) — `acntg-se`
-
-| 기능      | Method | URL                     | Request / Query                  | Response                      | 클라이언트                   |
-| --------- | ------ | ----------------------- | -------------------------------- | ----------------------------- | ---------------------------- |
-| 목록 조회 | GET    | `/acntg-se`             | `AcntgSeMngSearchDto` + Pageable | `Page<AcntgSeMngResponseDto>` | `acntgSeMngService.findAll`  |
-| 트리 조회 | GET    | `/acntg-se/list/tree`   | —                                | `AcntgSeMngTreeDto[]`         | `acntgSeMngService.findTree` |
-| 상세 조회 | GET    | `/acntg-se/{acntgSeCd}` | —                                | `AcntgSeMngResponseDto`       | `acntgSeMngService.findById` |
-| 등록      | POST   | `/acntg-se`             | `AcntgSeMngSaveRequestDto`       | `string` (acntgSeCd)          | `acntgSeMngService.save`     |
-| 수정      | PUT    | `/acntg-se/{acntgSeCd}` | `AcntgSeMngSaveRequestDto`       | `string` (acntgSeCd)          | `acntgSeMngService.update`   |
-| 삭제      | DELETE | `/acntg-se/{acntgSeCd}` | —                                | `string` (acntgSeCd)          | `acntgSeMngService.delete`   |
-
-**AcntgSeMngResponseDto**
-
-| Field         | 타입    | 설명               |
-| ------------- | ------- | ------------------ |
-| `acntgSeCd`   | string  | 회계구분코드       |
-| `acntgSeCdNm` | string  | 회계구분코드명     |
-| `upAcntgSeCd` | string? | 상위회계구분코드   |
-| `cdLvNo`      | number  | 코드레벨번호       |
-| `useYn`       | string  | 사용여부           |
-| `expln`       | string? | 설명 (최대 1000자) |
-| `rgtr`        | string? | 등록자 UUID        |
-| `rgtrNm`      | string? | 등록자명           |
-| `mdfr`        | string? | 수정자 UUID        |
-| `regDt`       | string? | 등록일시           |
-| `mdfcnDt`     | string? | 수정일시           |
-
-**AcntgSeMngSaveRequestDto**: `acntgSeCd`, `acntgSeCdNm`, `upAcntgSeCd?`, `cdLvNo`, `useYn?`, `expln?`
-
-**AcntgSeMngSearchDto**: `acntgSeCd?`, `acntgSeCdNm?`, `useYn?` + `page`, `size`, `sort`
-
-**React Query hooks**: `useAcntgSeMngPage`, `useAcntgSeMngTree`, `useAcntgSeMng`, `useSaveAcntgSeMng`, `useUpdateAcntgSeMng`, `useDeleteAcntgSeMng`
-
---
-
-## 7. UI 구현 가이드
-
-### 7-1. 기술 스택·원칙
-
- Next.js App Router, React Query (`@tanstack/react-query`)
- `@common/components` — `Card`, `Button`, `Dialog`, `DataTable` / `useDataTable`
- `@tanstack/react-table` — 컬럼 정의는 `model/*-table-columns.tsx` 분리
- 기존 entity 레이어 재사용: `@/entities/cnstp`, `@/entities/acntg` (service·queries·interface 구현 완료)
- 좌·우 2열 레이아웃: `grid grid-cols-1 lg:grid-cols-2 gap-4` (모바일 1열 스택)
- 삭제 전 `confirm` / Toast 피드백 — 프로젝트 공통 패턴 준수
- 목록 하단 **페이지네이션 UI 노출** — 영역 A·B 각각 독립 page state
- **검색 필터 UI 미제공** — `findAll` 호출 시 `page`, `size`만 전달
- **등록/수정 다이얼로그** — 코드·코드명·설명은 `Input`, 사용여부는 `Radio` (4필드만 노출)
- 상위 코드 삭제 시 **하위 코드 연쇄 삭제 UI·로직 미구현** — 단건 삭제만 수행
-
-### 7-2. 모듈·파일 배치
-
-| 구분              | 경로 (제안)                                                          |
-| ----------------- | -------------------------------------------------------------------- |
-| 라우트            | `apps/as/src/app/(authenticated)/site/code-management/page.tsx`      |
-| 페이지 컴포넌트   | `apps/as/src/pages/code-management/ui/code-management-page.tsx`      |
-| 공종 그리드 컬럼  | `apps/as/src/pages/code-management/model/cnstp-se-table-columns.tsx` |
-| 회계 그리드 컬럼  | `apps/as/src/pages/code-management/model/acntg-se-table-columns.tsx` |
-| 공종 등록/수정 폼 | `apps/as/src/pages/code-management/ui/cnstp-se-form-dialog.tsx`      |
-| 회계 등록/수정 폼 | `apps/as/src/pages/code-management/ui/acntg-se-form-dialog.tsx`      |
-| API·타입 (기존)   | `@/entities/cnstp`, `@/entities/acntg`                               |
-
-### 7-3. 영역별 UI 매핑
-
-| 영역         | UI 컴포넌트                           | 데이터 소스                                 | 비고                           |
-| ------------ | ------------------------------------- | ------------------------------------------- | ------------------------------ |
-| A            | `CnstpSeSection` + Table + Pagination | `useCnstpSeMngPage({ page, size })`         | 독립 page state·mutation       |
-| B            | `AcntgSeSection` + Table + Pagination | `useAcntgSeMngPage({ page, size })`         | A와 상호 의존 없음             |
-| A 다이얼로그 | `CnstpSeFormDialog`                   | `useCnstpSeMng`, `useSave/UpdateCnstpSeMng` | Input 4필드 + Radio 사용여부   |
-| B 다이얼로그 | `AcntgSeFormDialog`                   | `useAcntgSeMng`, `useSave/UpdateAcntgSeMng` | Input 4필드 + Radio 사용여부   |
-
-### 7-4. 다이얼로그·라우팅
-
-| 다이얼로그    | 트리거           | 라우팅               |
-| ------------- | ---------------- | -------------------- |
-| 공종코드 등록 | 영역 A [등록]    | URL 변경 없음 (모달) |
-| 공종코드 수정 | 영역 A 행 [수정] | URL 변경 없음 (모달) |
-| 회계코드 등록 | 영역 B [등록]    | URL 변경 없음 (모달) |
-| 회계코드 수정 | 영역 B 행 [수정] | URL 변경 없음 (모달) |
-
-### 7-5. 데이터 흐름 (구현 관점)
-
-```
-BEGIN
-
-  // 페이지 마운트 — 검색 조건 없이 page·size만 전달
-  const cnstpQuery = useCnstpSeMngPage({ page: 0, size: 20 })
-  const acntgQuery = useAcntgSeMngPage({ page: 0, size: 20 })
-
-  DISPLAY CodeManagementPage
-    ├─ CnstpSeSection(data=cnstpQuery.data, pagination)
-    └─ AcntgSeSection(data=acntgQuery.data, pagination)
-
-  // 페이지 변경
-  ON pagination page/size CHANGE DO
-      refetch cnstpQuery | acntgQuery with new page, size
-  END ON
-
-  // mutation 성공 시
-  ON save/update/delete SUCCESS DO
-      invalidateQueries cnstp-se | acntg-se baseKey
-      TOAST "저장되었습니다." | "삭제되었습니다."
-  END ON
-
-END
-```
@@ -1,284 +0,0 @@
-# 화면설계서: 필수첨부파일관리
-
-## 1. 기본 정보
-
-| 항목       | 내용                                           |
-| ---------- | ---------------------------------------------- |
-| 버전       | 0.1                                            |
-| 프로세스명 | UI설계                                         |
-| 화면명     | 필수첨부파일관리                               |
-| 화면 유형  | [v] 조회 [v] 입력 [v] 수정 [v] 삭제 [ ] 출력   |
-| 메뉴 경로  | 디지털행정지원 > 사이트관리 > 필수첨부파일관리 |
-
---
-
-## 2. 화면 목적
-
-문서(업무) 구분별로 **필수 첨부파일** 항목을 등록·조회·수정·삭제한다. 상단 검색 영역에서 **문서구분**으로 목록을 필터링하고, **등록** 또는 행별 **수정**·**삭제**로 마스터 데이터를 유지한다. 등록·수정 시 **필수첨부파일아이디**는 클라이언트에서 입력(또는 생성)하여 요청 본문에 포함한다.
-
---
-
-## 3. 화면 구성
-
-### 3-1. 전체 레이아웃
-
-```
-┌──────────────────────────────────────────────────────────────────────────────────────────────────────┐
-│  페이지 타이틀: 필수첨부파일관리                                 브레드크럼: 디지털행정지원 > … >    │
-├──────────────────────────────────────────────────────────────────────────────────────────────────────┤
-│  [영역 A] 검색 / 액션                                                                                │
-│  ┌────────────────────────────────────────────────────────────────────────────────────────────────┐  │
-│  │ 문서구분 [전체 ▼]  [조회]                                                              [등록]  │  │
-│  └────────────────────────────────────────────────────────────────────────────────────────────────┘  │
-├──────────────────────────────────────────────────────────────────────────────────────────────────────┤
-│  [영역 B] 필수첨부파일 목록                                                                          │
-│  ┌────────────────────────────────────────────────────────────────────────────────────────────────┐  │
-│  │ 필수첨부파일아이디 | 문서구분 | 필수첨부파일명 | 필수첨부여부 | 비고 | 등록일시 | 수정일시 | 관리 │
-│  ├────────────────────────────────────────────────────────────────────────────────────────────────┤  │
-│  │ EAF-0001 | 설치인가 | 사업계획서 | 예 | 서명본 첨부 | 2026-04-22 10:10:00 | — | [수정][삭제]   │  │
-│  │ EAF-0002 | 기본계획 | 변경사유서 | 예 | — | 2026-04-22 11:00:00 | — | [수정][삭제]             │  │
-│  └────────────────────────────────────────────────────────────────────────────────────────────────┘  │
-└──────────────────────────────────────────────────────────────────────────────────────────────────────┘
-
-  (모달) [다이얼로그 C] 필수첨부파일 등록 / 수정
-  ┌──────────────────────────────────────────────────────┐
-  │ 필수첨부파일 등록                            [닫기]  │
-  ├──────────────────────────────────────────────────────┤
-  │ 필수첨부파일아이디(자동발급)  [EAF-0004]             │
-  │ 문서구분                      [설치인가 ▼]           │
-  │ 필수첨부파일명                [예: 사업계획서]       │
-  │ 필수첨부여부                  [ ] 예 [ ] 아니오      │
-  │ 비고                          [비고를 입력하세요]    │
-  ├──────────────────────────────────────────────────────┤
-  │                                      [취소]  [저장]  │
-  └──────────────────────────────────────────────────────┘
-```
-
-### 3-2. 화면 데이터 흐름
-
-```
-BEGIN
-
-  // 최초 진입
-  CALL 필수첨부파일 목록 조회 (findPage)
-  DISPLAY 필수첨부파일 그리드 (영역 B)
-
-  // 영역 A: 검색
-  ON [조회] 버튼 CLICK DO
-      CALL 필수첨부파일 목록 조회 (문서구분 = 선택값, findPage)
-      DISPLAY 필수첨부파일 그리드 (영역 B)
-  END ON
-
-  // 영역 A: 등록
-  ON [등록] 버튼 CLICK DO
-      OPEN 필수첨부파일 등록 다이얼로그 (다이얼로그 C)
-      ON [저장] DO
-          CONFIRM "등록하시겠습니까?"
-          VALIDATE 문서구분, 필수첨부파일명, 필수첨부여부
-          CALL 필수첨부파일 등록 (create)
-          CALL 필수첨부파일 목록 조회
-          CLOSE 다이얼로그
-          TOAST "저장되었습니다."
-      END ON
-      ON [취소] / [닫기] DO
-          CLOSE 다이얼로그
-      END ON
-  END ON
-
-  // 영역 B: 수정
-  ON 행 [수정] CLICK DO
-      OPEN 필수첨부파일 수정 다이얼로그 (기존 값 초기화)
-      ON [저장] DO
-          VALIDATE 문서구분, 필수첨부파일명, 필수첨부여부
-          CALL 필수첨부파일 수정 (update)
-          CALL 필수첨부파일 목록 조회
-          CLOSE 다이얼로그
-      END ON
-  END ON
-
-  // 영역 B: 삭제
-  ON 행 [삭제] CLICK DO
-      CONFIRM "삭제하시겠습니까?"
-      CALL 필수첨부파일 삭제 (remove)
-      CALL 필수첨부파일 목록 조회
-  END ON
-
-END
-```
-
---
-
-## 4. 영역 A: 검색 / 액션
-
-문서구분 조건으로 목록을 조회하고, 신규 등록 다이얼로그를 연다.
-
-### 4-1. 검색 필드
-
-| 표시명   | 입력 유형  | 필수 | 기본값 | API 파라미터 매핑 | 비고                           |
-| -------- | ---------- | ---- | ------ | ----------------- | ------------------------------ |
-| 문서구분 | CodeSelect | N    | 전체   | `docSeComCd?`     | "전체" 선택 시 파라미터 미전송 |
-
-### 4-2. 버튼
-
-| 버튼명 | 위치           | 동작                                            |
-| ------ | -------------- | ----------------------------------------------- |
-| 조회   | 검색 필드 우측 | 현재 검색 조건으로 영역 B 목록 갱신             |
-| 등록   | 영역 우측 끝   | 필수첨부파일 등록 다이얼로그(다이얼로그 C) 오픈 |
-
---
-
-## 5. 영역 B: 필수첨부파일 목록
-
-필수 첨부파일 마스터를 테이블로 표시한다. 페이지네이션 UI 적용.
-
-### 5-1. 헤더
-
-| 항목        | 내용              |
-| ----------- | ----------------- |
-| 섹션 타이틀 | 필수첨부파일 목록 |
-
-### 5-2. 그리드 컬럼
-
-| 컬럼명             | Field               | 타입   | 비고                                  |
-| ------------------ | ------------------- | ------ | ------------------------------------- |
-| 필수첨부파일아이디 | `esntlAtchFileId`   | string | 예: `EAF-0001`, 클라이언트 생성/입력  |
-| 문서구분           | `docSeComCd`        | string | 코드명 표시 — 공통코드 (TBD 상위코드) |
-| 필수첨부파일명     | `esntlAtchFileNm`   | string |                                       |
-| 필수첨부여부       | `esntlAtchYn`       | string | `Y`→예, `N`→아니오                    |
-| 비고               | `esntlAtchFileRmrk` | string | 없으면 `—` 표시                       |
-| 등록일시           | `regDt`             | string | `yyyy-MM-dd HH:mm:ss`                 |
-| 수정일시           | `mdfcnDt`           | string | 미수정 시 빈 값 또는 `—`              |
-| 관리               | —                   | —      | 행별 **[수정] · [삭제]**              |
-
- 행 클릭 시 별도 상세 화면 없음. 편집은 **[수정]** 버튼으로 다이얼로그 C를 연다.
-
-### 5-3. 버튼
-
-| 버튼명 | 위치 | 동작                                   |
-| ------ | ---- | -------------------------------------- |
-| 수정   | 행별 | 필수첨부파일 수정 다이얼로그 (기존 값) |
-| 삭제   | 행별 | 확인 후 삭제 API 호출 → 목록 갱신      |
-
---
-
-## 6. 다이얼로그 C: 필수첨부파일 등록 / 수정
-
-등록·수정 공용 폼 다이얼로그. 등록 시 제목 **「필수첨부파일 등록」**, 수정 시 **「필수첨부파일 수정」**.
-
-### 6-1. 폼 필드
-
-| 표시명             | 입력 유형  | 필수 | 기본값 | API 파라미터 매핑   | 비고                             |
-| ------------------ | ---------- | ---- | ------ | ------------------- | -------------------------------- |
-| 필수첨부파일아이디 | (Readonly) | Y    | —      | `esntlAtchFileId`   | 등록 시 미노출                   |
-| 문서구분           | CodeSelect | Y    | —      | `docSeComCd`        | 예: 설치인가, 기본계획           |
-| 필수첨부파일명     | Text       | Y    | —      | `esntlAtchFileNm`   | placeholder: "예: 사업계획서"    |
-| 필수첨부여부       | RadioGroup | Y    | Y      | `esntlAtchYn`       | Y/N, UI 표시: 예/아니오          |
-| 비고               | Textarea   | N    | —      | `esntlAtchFileRmrk` | placeholder: "비고를 입력하세요" |
-
-### 6-2. 버튼
-
-| 버튼명 | 동작                                   |
-| ------ | -------------------------------------- |
-| 저장   | POST(등록) 또는 PUT(수정) 후 목록 갱신 |
-| 취소   | 다이얼로그 닫기, 입력값 폐기           |
-| 닫기   | 다이얼로그 닫기 (헤더 우측)            |
-
---
-
-## 7. API/DTO 명세
-
-### 7-1. 공통
-
-| 항목        | 내용                                                  |
-| ----------- | ----------------------------------------------------- |
-| 서비스      | AS Common Service                                     |
-| Base prefix | `/as-service/api/v1/esntl-atch-file`                  |
-| 인증        | JWT (`Authorization`), `X-Site-Id` 등                 |
-| 페이징      | Spring `Pageable` 사용 (`page`, `size`, `sort`)       |
-| 엔티티      | `@/entities/esntl` (`esntl-service.ts`, `queries.ts`) |
-
-### 7-2. 필수첨부파일 API
-
-| 기능      | Method | URL                  | Request DTO                   | Response DTO                        | API (클라이언트 함수명) |
-| --------- | ------ | -------------------- | ----------------------------- | ----------------------------------- | ----------------------- |
-| 트리 조회 | GET    | `/list/tree`         | Query: `docSeComCd`(필수)     | `EsntlAtchFileMngTreeResponseDto[]` | `findTree`              |
-| 목록 조회 | GET    | `/`                  | Query: Search + Pageable      | `PageResponse<EsntlAtchFileMng>`    | `findPage`              |
-| 단건 조회 | GET    | `/{esntlAtchFileId}` | Path: `esntlAtchFileId`       | `EsntlAtchFileMng`                  | `findById`              |
-| 등록      | POST   | `/`                  | `EsntlAtchFileMngSaveRequest` | `string` (생성된 ID)                | `create`                |
-| 수정      | PUT    | `/{esntlAtchFileId}` | `EsntlAtchFileMngSaveRequest` | `string` (수정된 ID)                | `update`                |
-| 삭제      | DELETE | `/{esntlAtchFileId}` | Path: `esntlAtchFileId`       | `string` (삭제된 ID)                | `remove`                |
-
-**응답 DTO**
-
-| Field               | 타입    | 설명                             |
-| ------------------- | ------- | -------------------------------- |
-| `esntlAtchFileId`   | string  | 필수첨부파일아이디               |
-| `docSeComCd`        | string  | 문서구분공통코드                 |
-| `esntlAtchFileNm`   | string  | 필수첨부파일명                   |
-| `esntlAtchYn`       | string  | 필수첨부여부 (Y/N)               |
-| `esntlAtchFileRmrk` | string? | 필수첨부파일비고                 |
-| `rgtr`              | string? | 등록자 UUID                      |
-| `rgtrNm`            | string? | 등록자명                         |
-| `mdfr`              | string? | 수정자 UUID                      |
-| `regDt`             | string? | 등록일시 (`yyyy-MM-dd HH:mm:ss`) |
-| `mdfcnDt`           | string? | 수정일시                         |
-
-**저장 Request**
-
-| Field               | 필수 | 설명               |
-| ------------------- | ---- | ------------------ |
-| `esntlAtchFileId`   | Y    | 필수첨부파일아이디 |
-| `docSeComCd`        | N    | 문서구분           |
-| `esntlAtchFileNm`   | N    | 필수첨부파일명     |
-| `esntlAtchYn`       | N    | 필수첨부여부       |
-| `esntlAtchFileRmrk` | N    | 비고               |
-
-**검색 Query**
-
-| Field             | 필수 | 설명                          |
-| ----------------- | ---- | ----------------------------- |
-| `docSeComCd`      | N    | 문서구분 (전체 시 미전송)     |
-| `esntlAtchFileNm` | N    | 필수첨부파일명 부분/일치 검색 |
-| `esntlAtchYn`     | N    | 필수첨부여부 (`Y`/`N`)        |
-| `page`            | N    | 페이지 번호 (0-base)          |
-| `size`            | N    | 페이지 크기 (기본값: 100)     |
-| `sort`            | N    | 정렬 조건 (예: `regDt,desc`)  |
-
-### 7-3. 공통코드
-
-| UI 필드      | 코드 그룹 | 예시 값            |
-| ------------ | --------- | ------------------ |
-| 문서구분     | ASDOCSECD | 설치인가, 기본계획 |
-| 필수첨부여부 | 고정      | Y(예), N(아니오)   |
-
---
-
-## 8. UI 구현 가이드
-
-### 8-1. 기술 스택·원칙
-
- **공통 컴포넌트**: `@common/components` (`Dialog`, `Button`, `Input`, `Select`, `Textarea`, `Label` 등)
- **테이블**: `@tanstack/react-table` + `useDataTable`
- **폼**: `react-hook-form`
- **데이터**: React Query — `@/entities/esntl/api/queries.ts` 훅 사용
- **공통코드**: `@/entities/code` — `CodeSelect`, `findCodeLabel`
- **확인**: `@frontend-opensource/use-react-hooks` — `useConfirm` (등록·삭제 확인)
-
-### 8-2. 모듈·파일 배치
-
-| 구분   | 경로                                                                                                 |
-| ------ | ---------------------------------------------------------------------------------------------------- |
-| 라우트 | `apps/as/app/(with-base-layout)/esntl-atch-file-mng/page.tsx`                                        |
-| 페이지 | `apps/as/src/pages/esntl-atch-file-mng/` (Public API: page만 export)                                 |
-| UI     | `.../ui/esntl-atch-file-mng-page.tsx`, `esntl-atch-file-list.tsx`, `esntl-atch-file-form-dialog.tsx` |
-| model  | `.../model/esntl-atch-file-columns.tsx`, `esntl-atch-file-search-params.ts`                          |
-| 엔티티 | `apps/as/src/entities/esntl/` (`esntl-service.ts`, `queries.ts`, `esntl-interface.ts`)               |
-| 문서   | `apps/as/docs/essential-attachment-file-management/SPEC.md`                                          |
-
-### 8-3. 데이터 흐름(요약)
-
- **진입**: 검색 params 기본값(`docSeComCd` = 전체) → 목록 query → 영역 B DataTable.
- **조회**: [조회] 클릭 시 search state 반영 → 목록 query refetch.
- **등록**: [등록] → Dialog `mode=create` → [저장] → POST → 목록 invalidate.
- **수정**: [수정] → Dialog `mode=edit` + row 초기값 → [저장] → PUT → 목록 invalidate.
- **삭제**: confirm → DELETE → 목록 invalidate.
@@ -1,367 +0,0 @@
-# 재원협의(fnrs-cnsltn) vs 설치인가(instl-sncn) 차이 분석
-
-| 항목      | 내용                                                                          |
-| --------- | ----------------------------------------------------------------------------- |
-| 작성일    | 2026-07-09                                                                    |
-| 기준 구현 | `fnrs-cnsltn` (추가 요구사항 반영 완료)                                       |
-| 비교 대상 | `instl-sncn`                                                                  |
-| 목적      | 두 페이지의 동작·구조 차이를 정리하고, 설치인가 정렬 시 이식 대상을 명확히 함 |
-
---
-
-## 1. 요약
-
-두 모듈은 **동일한 PBADMS(공공행정 지원) 업무 패턴**을 따르는 형제 페이지다.
-
-공통 흐름:
-
-```
-목록 → TaskSe 선택 후 신청 → 저장(SV) → 신청완료(ST)
-  → 환경청제출(LE) → 기술검토 → 검토결과 회신(EP)
-  → 인가승인(TA) → 고시(TB)
-```
-
-| 구분          | fnrs-cnsltn       | instl-sncn       |
-| ------------- | ----------------- | ---------------- |
-| 업무명        | 재원협의          | 설치인가         |
-| 문서번호      | `fnrsCnsltnDocNo` | `instlSncnDocNo` |
-| docSeComCd    | `FNRS`            | `INSTL`          |
-| 라우트        | `/fnrs-cnsltn/*`  | `/instl-sncn/*`  |
-| pages 파일 수 | 39                | 32               |
-
-**결론:** `fnrs-cnsltn`이 추가 요구사항이 반영된 기준(reference) 구현이고, `instl-sncn`은 동일 골격이지만 보완요청·결재선 편집·등록/수정 폼 완성도 등에서 미반영·TODO·단순화 상태다.
-
---
-
-## 2. 파일/폴더 구조
-
-### 2-1. fnrs-cnsltn에만 존재
-
-| 경로                                         | 역할                      |
-| -------------------------------------------- | ------------------------- |
-| `ui/sections/fnrs-shar-section.tsx`          | 재원분담 조회 섹션        |
-| `ui/sections/supplement-demand-section.tsx`  | 보완요청 이력 섹션        |
-| `ui/components/sortable-prgrs-stts-row.tsx`  | 결재선 DnD 편집 행        |
-| `ui/components/sortable-apln-picker-row.tsx` | 결재선 템플릿 피커 DnD 행 |
-| `ui/components/aprvr-picker-dialog.tsx`      | 결재자 선택 다이얼로그    |
-| `ui/components/elapr-apln-picker-grid.tsx`   | 결재선 편집 그리드        |
-| `ui/components/elapr-tmplt-select-table.tsx` | 결재서식 선택 테이블      |
-| `model/reviewer-option.ts`                   | 결재자 옵션 타입          |
-
-### 2-2. instl-sncn에만 존재
-
-| 경로                                   | 역할                | 비고                                       |
-| -------------------------------------- | ------------------- | ------------------------------------------ |
-| `ui/sections/history-info-section.tsx` | 등록/수정 이력 표시 | **어디에서도 import되지 않음 (dead code)** |
-
-### 2-3. 공통 구조
-
-```
-index.ts
-ui/
-  {list,view,form,regist,edit}-page.tsx
-  sections/  (basic-info, contact, scale, cost, checklist, attachments, tech-review)
-  components/ (floating-action-buttons, elapr-approval-dialog, elapr-tmplt-picker-dialog, checklist-task-panel)
-lib/   button-config, save-payload-utils, form-data-mapper, regist-schema, checklist/review utils
-model/ columns.tsx, view-types.ts
-```
-
-App Router도 동일: `page.tsx`, `regist/page.tsx`, `[id]/page.tsx`, `[id]/edit/page.tsx`
-
---
-
-## 3. 목록 페이지
-
-### 3-1. 검색 필터
-
-| 항목               | fnrs-cnsltn                               | instl-sncn                        |
-| ------------------ | ----------------------------------------- | --------------------------------- |
-| 시도/시군구 API    | `@/entities/adstdstr`                     | 동일                              |
-| 지역 검색 파라미터 | **`admdstCd`** (시군구 우선, 없으면 시도) | **`sidoComCd` + `sggComCd`** 분리 |
-| "전체" 옵션        | `ALL_SELECT_VALUE = "__ALL__"` SelectItem | 없음 (placeholder만)              |
-| 구분 CodeSelect    | `upCd="INSTL"` ※                          | `upCd="INSTL"`                    |
-| 사업명             | 동일                                      | 동일                              |
-
-> ※ fnrs 목록의 구분 필터가 `INSTL` 코드를 사용 중이며, TaskSePickerDialog는 `codeUpCd="FNRS"`를 쓴다. **불일치 가능성**이 있어 확인이 필요하다.
-
-### 3-2. 정렬·페이지네이션
-
-| 항목                     | fnrs-cnsltn            | instl-sncn                            |
-| ------------------------ | ---------------------- | ------------------------------------- |
-| 기본 sort (list-page)    | `fnrsCnsltnDocNo,desc` | `instlSncnDocNo,desc`                 |
-| fallback sort (list.tsx) | `fnrsCnsltnDocNo,desc` | **`regDt,desc`** (list-page와 불일치) |
-| 페이지 크기              | 10                     | 10                                    |
-| URL 동기화               | 없음 (`useState` 로컬) | 없음                                  |
-
-### 3-3. 테이블 컬럼
-
-`model/columns.tsx` 로직은 사실상 동일하다. DTO 타입명만 다르다.
-
-컬럼: 시도, 시군구, 사업명, 업무구분, 담당자, 해당기관, 진행상황, 신청일
-
-### 3-4. 행 클릭·신청
-
-| 항목         | fnrs-cnsltn                                                        | instl-sncn         |
-| ------------ | ------------------------------------------------------------------ | ------------------ |
-| 행 클릭      | **조건부 라우팅**: `SV`/`SL` + 등록자 본인 → `/edit`, 그 외 → view | **항상 view**      |
-| useUserStore | 사용                                                               | 미사용             |
-| 신청 버튼    | TaskSePickerDialog `codeUpCd="FNRS"`                               | `codeUpCd="INSTL"` |
-
-```46:54:apps/as/src/pages/fnrs-cnsltn/ui/fnrs-list.tsx
-  const handleRowClick = (row: FnrsCnsltnMngResponseDto) => {
-    const canEdit =
-      (row.prgrsSttsComCd === "SV" || row.prgrsSttsComCd === "SL") &&
-      row.rgtr === userInfo?.userUnqId;
-
-    router.push(
-      canEdit ? `/fnrs-cnsltn/${row.fnrsCnsltnDocNo}/edit` : `/fnrs-cnsltn/${row.fnrsCnsltnDocNo}`,
-    );
-  };
-```
-
---
-
-## 4. 상세(View) 페이지
-
-### 4-1. 섹션 구성
-
-| 섹션                            | fnrs-cnsltn                                | instl-sncn                 |
-| ------------------------------- | ------------------------------------------ | -------------------------- |
-| BasicInfo                       | 환경청구분, 확정예산사업번호, 예산신청연도 | **사업구분(`sncnSeCdNm`)** |
-| ContactInfo                     | 동일 패턴                                  | 동일                       |
-| BusinessScale / Cost            | 동일                                       | 동일                       |
-| **FnrsShar (재원분담)**         | **있음**                                   | **없음** (도메인 고유)     |
-| Checklist                       | 동일                                       | 동일                       |
-| Attachments                     | 동일                                       | 동일                       |
-| **SupplementDemand (보완요청)** | **있음**                                   | **없음**                   |
-| TechReviewOpinion               | 동일                                       | 동일                       |
-| HistoryInfo                     | 없음                                       | 파일만 존재, view 미연결   |
-| FloatingActionButtons           | `docSeComCd="FNRS"`                        | `docSeComCd="INSTL"`       |
-
-### 4-2. 데이터 훅
-
-| 항목      | fnrs-cnsltn                  | instl-sncn           |
-| --------- | ---------------------------- | -------------------- |
-| 상세 훅   | `useFnrsCnsltnMng`           | `useInstlSncnDetail` |
-| 에러 판정 | `isError \|\| !data?.detDto` | `isError \|\| !data` |
-| 로딩      | Skeleton                     | Skeleton             |
-
---
-
-## 5. 등록/수정(Form) 페이지
-
-### 5-1. 폼 완성도
-
-| 항목          | fnrs-cnsltn                       | instl-sncn      |
-| ------------- | --------------------------------- | --------------- |
-| 저장(SV)      | O                                 | O (SV 고정)     |
-| 신청완료(ST)  | O (edit 모드)                     | **없음**        |
-| 삭제          | O (edit 모드, `useConfirm`)       | **없음**        |
-| 재원분담 섹션 | `FnrsSharFormSection` + 잔액 검증 | 없음            |
-| 저장 후 이동  | **`/edit` 유지**                  | **view로 이동** |
-| 목록 버튼     | `/fnrs-cnsltn` 고정               | `router.back()` |
-
-### 5-2. 기본정보 Form 필드
-
-| 필드              | fnrs             | instl                                   |
-| ----------------- | ---------------- | --------------------------------------- |
-| taskSe 코드       | `FNRS`           | `INSTL`                                 |
-| 사업구분          | 없음             | **`sncnSeComCd` (SNCNSE 라디오, 필수)** |
-| BnsPicker 연동    | bizNm ~ bizCn    | + **`bgtBizCd`, `bgtAplyYr`**           |
-| 재이용(RE) 조건부 | rtlztnFclt / Usg | 동일                                    |
-
-### 5-3. Schema
-
-| 항목                | fnrs                | instl          |
-| ------------------- | ------------------- | -------------- |
-| 관리 객체           | `fnrsCnsltnMng`     | `instlSncnMng` |
-| 예산 필드           | `cfmtnBgtBizNo`     | `bgtBizCd`     |
-| 재원분담            | `fnrsSharList` 배열 | 없음           |
-| sharAtchFileGroupId | 있음                | 없음           |
-| privacyConsent      | 있음                | 있음           |
-
-### 5-4. Edit 페이지 래퍼
-
-| 항목               | fnrs                            | instl                           |
-| ------------------ | ------------------------------- | ------------------------------- |
-| 로딩 Skeleton      | 있음                            | **없음**                        |
-| 데이터 없음 메시지 | "상세 정보를 찾을 수 없습니다." | "수정 대상을 찾을 수 없습니다." |
-
---
-
-## 6. FloatingActionButtons / 결재 / 보완
-
-### 6-1. FAB 동작 차이
-
-공통: 역할×상태 기반 버튼(`button-config.ts`), checklist 진행률 검증, elapr pending approval 체크
-
-| 기능                            | fnrs-cnsltn                                             | instl-sncn                                              |
-| ------------------------------- | ------------------------------------------------------- | ------------------------------------------------------- |
-| 보완완료 (`splmntCmptn`)        | **`submitSupplement` API 연동**                         | **`// TODO` stub**                                      |
-| 보완요청 (`dmndSplmnt`)         | **`buildSupplementReqPayload` + `submitReqSupplement`** | **`// TODO` stub** (문자열만 전달)                      |
-| 검토완료 (`rvwCmptn`)           | `techReViewSaveCd: "SV"` 후 **결재 다이얼로그 오픈**    | `techReViewSaveCd: "CP"`, **다이얼로그 없이 즉시 완료** |
-| 검토자지정                      | `buildElaprPrgrsSttsListFromAplnRows(aplnRows)`         | `buildElaprPrgrsSttsListFromApln(aplnPage.content)`     |
-| atrzAprv / atrzRply / grndsChck | TODO handler                                            | TODO handler                                            |
-
-```576:617:apps/as/src/pages/instl-sncn/ui/components/floating-action-buttons.tsx
-async function handleSplmntCmptn(context: ActionHandlerContext): Promise<void> {
-  // TODO: 보완완료 API 호출
-  context.onSuccess?.();
-}
-// ...
-async function handleDmndSplmnt(context: ActionHandlerContext): Promise<void> {
-  // TODO: 보완요청 API 호출
-  context.onSuccess?.();
-}
-```
-
-### 6-2. ElaprApprovalDialog (가장 큰 UX 격차)
-
-| 항목             | fnrs (419줄)                                           | instl (231줄)                    |
-| ---------------- | ------------------------------------------------------ | -------------------------------- |
-| 결재선 표시      | DnD sortable 편집 테이블                               | **읽기 전용** 테이블             |
-| 결재선 추가/저장 | **지원** (`usePrgrsSttsRows`, `useSaveElaprPrgrsStts`) | 없음                             |
-| 결재자 변경      | **AprvrPickerDialog**                                  | 없음                             |
-| 전결 체크박스    | **있음** (`finalApprovalYn`)                           | 없음                             |
-| 반려 사유        | API에 `rjctRsn` 전달                                   | UI는 있으나 **payload에 미전달** |
-| 저장 전 검증     | `hasUnsavedPrgrsSttsChanges`                           | 없음                             |
-
-### 6-3. ElaprTmpltPickerDialog
-
-| 항목            | fnrs                                                                 | instl                   |
-| --------------- | -------------------------------------------------------------------- | ----------------------- |
-| UI              | 2-pane: 서식 테이블 + **결재선 편집 그리드**                         | 단일 테이블 + 선택 버튼 |
-| docSeComCd 필터 | `FNRS`                                                               | `INSTL`                 |
-| onConfirm       | `{ tmplt, aplnRows }` 편집 결과                                      | `onSelect(tmplt)`만     |
-| 검증            | `validateAllRowsForSave`, `validateAtrzOrder`, `validateUniqueSeqNo` | 없음                    |
-
---
-
-## 7. Entity / API / Hook
-
-### 7-1. Service 메서드
-
-| 메서드                  | fnrs                        | instl     |
-| ----------------------- | --------------------------- | --------- |
-| 목록                    | `findPage`                  | `getPage` |
-| 상세                    | `findById`                  | `getById` |
-| saveApply               | O                           | O         |
-| techReview              | O                           | O         |
-| changePrgrsSttsComCd    | O                           | O         |
-| remove                  | O                           | O         |
-| **submitSupplement**    | **O** (`/submitsupplement`) | **X**     |
-| **submitReqSupplement** | **O** (`/reqsupplement`)    | **X**     |
-
-### 7-2. 상세 DTO 확장
-
-**fnrs 추가 필드**
-
- `fnrsSharList`, `sharAtchFileList`
- `splmntDmndList` (typed)
-
-**instl 추가 필드**
-
- `sncnSeComCd` / `sncnSeCdNm` (인가구분)
- `bgtBizCd` (예산사업코드)
- `rtlztnFcltSeComNm`, `rtlztnUsgSeComNm`
- `splmntDmndList` 타입은 base에 존재하나 view/API 미연결
- `instlSncnRegionService` (시도/시군구 — 목록은 adstdstr 사용, 미활용)
-
-### 7-3. save-payload-utils
-
-| 함수                             | fnrs             | instl     |
-| -------------------------------- | ---------------- | --------- |
-| buildSavePayload                 | + `fnrsSharList` | shar 없음 |
-| buildTechReviewReplyPayload      | O                | O         |
-| **buildSupplementReqPayload**    | **O**            | **X**     |
-| **buildSupplementSubmitPayload** | **O**            | **X**     |
-
---
-
-## 8. 비즈니스 도메인 차이
-
-| 영역           | fnrs-cnsltn                               | instl-sncn               |
-| -------------- | ----------------------------------------- | ------------------------ |
-| 업무 코드      | `FNRS`                                    | `INSTL`                  |
-| TaskSe         | FNRS 하위                                 | INSTL 하위               |
-| 고시 버튼 라벨 | "재원협의 고시"                           | "설치인가 고시"          |
-| 재원분담       | **핵심 도메인** (`fnrs-shar-se`)          | 해당 없음                |
-| 인가구분       | 없음                                      | **`SNCNSE` 코드 (필수)** |
-| 예산 식별      | `cfmtnBgtBizNo`                           | `bgtBizCd`               |
-| 진행상태 코드  | SV, ST, LE, ER, TE, EP, TA, TB, SL, TP 등 | **동일 세트 공유**       |
-| 역할 매핑      | ROLE_USER05/04/03/01                      | 동일                     |
-
---
-
-## 9. fnrs-cnsltn에만 있는 기능 (추가 요구사항 후보)
-
-instl-sncn 정렬 시 **우선 이식 대상**:
-
-1. 목록 행 클릭 조건부 edit 라우팅 (`SV`/`SL` + 등록자)
-2. 보완요청 전체 플로우 — view 섹션, payload builder, API, FAB handler
-3. 보완완료 API 연동 (`submitSupplement`)
-4. 등록/수정 폼 완성 — 신청완료, 삭제, 저장 후 edit 유지
-5. 결재선 DnD 편집형 `ElaprApprovalDialog` (+ aprvr-picker, sortable rows)
-6. 결재선 편집형 `ElaprTmpltPickerDialog` (+ apln grid, validation)
-7. 검토완료 → 결재 다이얼로그 연계 흐름
-8. 검색 필터 "전체" 옵션 및 `admdstCd` 통합 방식 (백엔드 API에 맞게)
-9. Edit 페이지 로딩 Skeleton
-10. entity에 supplement API/hooks 추가
-
---
-
-## 10. instl-sncn에만 있는 기능 (유지 필요)
-
-1. **`sncnSeComCd` (사업구분/인가구분)** — 도메인 고유
-2. **`bgtBizCd` / `bgtAplyYr`** BnsPicker 연동
-3. **`history-info-section.tsx`** — 구현만 있고 view 미연결 (활성화 또는 삭제 결정 필요)
-4. entity **`instlSncnRegionService`** — 목록은 adstdstr 사용 중이라 중복/레거시 가능
-5. **`INSTL_SNCN_REGISTER_SELECTION_KEY`** sessionStorage 키
-
---
-
-## 11. 동일·거의 동일 패턴
-
-| 영역                                                  | 동일도                |
-| ----------------------------------------------------- | --------------------- |
-| App Router 4-route 구조                               | 100%                  |
-| `button-config.ts` 역할×상태 매트릭스                 | ~99% (액션명만 다름)  |
-| `columns.tsx` 진행상황 Badge                          | ~100%                 |
-| checklist / contact / scale / cost / attachments 섹션 | ~95% (import 경로만)  |
-| review-step-utils 로직                                | ~100% (상수명만 다름) |
-| TaskSePickerDialog 신청 플로우                        | 100%                  |
-| FAB 전체 구조·대부분 handler                          | ~85%                  |
-| checklist-form-state, business-cost-utils             | 거의 동일             |
-| shared widgets (`@/widgets/pbadms-sprt`)              | 동일                  |
-
---
-
-## 12. instl-sncn 정렬 권장 우선순위
-
-| 우선순위 | 항목                                                    | 근거                         |
-| -------- | ------------------------------------------------------- | ---------------------------- |
-| P0       | 보완요청/보완완료 API + UI                              | fnrs 완전 구현 vs instl TODO |
-| P0       | ElaprApprovalDialog 고도화                              | 결재선 편집·전결·반려사유    |
-| P0       | ElaprTmpltPickerDialog 2-pane                           | 검토자지정 품질              |
-| P1       | Form 신청완료/삭제 + 저장 후 edit 유지                  | 등록 UX parity               |
-| P1       | 목록 행 클릭 edit 라우팅                                | fnrs 추가 요구사항           |
-| P1       | 검토완료 → 결재 다이얼로그 연계                         | 흐름 통일                    |
-| P2       | sort fallback 불일치 수정 (`regDt` vs `instlSncnDocNo`) | instl 내부 버그성            |
-| P2       | history-info-section 연결 또는 삭제                     | dead code 정리               |
-| P3       | URL search params 동기화                                | 양쪽 모두 미구현 (공통 개선) |
-
---
-
-## 13. 참고 코드 위치
-
-| 주제                         | 경로                                                         |
-| ---------------------------- | ------------------------------------------------------------ |
-| 목록 edit 라우팅 (fnrs)      | `pages/fnrs-cnsltn/ui/fnrs-list.tsx`                         |
-| 목록 항상 view (instl)       | `pages/instl-sncn/ui/instl-list.tsx`                         |
-| view 추가 섹션 (fnrs)        | `pages/fnrs-cnsltn/ui/fnrs-view-page.tsx`                    |
-| FAB 보완 TODO (instl)        | `pages/instl-sncn/ui/components/floating-action-buttons.tsx` |
-| 결재 다이얼로그 (fnrs)       | `pages/fnrs-cnsltn/ui/components/elapr-approval-dialog.tsx`  |
-| 결재 다이얼로그 (instl)      | `pages/instl-sncn/ui/components/elapr-approval-dialog.tsx`   |
-| 폼 완성도 (fnrs)             | `pages/fnrs-cnsltn/ui/fnrs-form-page.tsx`                    |
-| 폼 단순화 (instl)            | `pages/instl-sncn/ui/instl-form-page.tsx`                    |
-| supplement API (fnrs entity) | `entities/fnrs-cnsltn/api/fnrs-cnsltn-service.ts`            |
@@ -1,370 +0,0 @@
-# 화면설계서: 검토인력관리
-
-## 1. 기본 정보
-
-| 항목       | 내용                                         |
-| ---------- | -------------------------------------------- |
-| 버전       | 0.2                                          |
-| 프로세스명 | UI설계                                       |
-| 화면명     | 검토인력관리                                 |
-| 화면 유형  | [v] 조회 [v] 입력 [ ] 수정 [v] 삭제 [ ] 출력 |
-| 메뉴 경로  | 디지털행정지원 > 사이트관리 > 검토인력관리   |
-
---
-
-## 2. 화면 목적
-
-조직도에서 **한 명의 사용자**를 선택한 뒤, 결재 단계(접수·검토·승인·최종승인)별 **인원 배치** 영역에 즉시 등록한다. 등록·목록 갱신은 별도 저장 버튼 없이 **[선택 인원 배치]** 클릭 시 `rvw-mnpw` API로 바로 반영한다. 좌측 조직도는 CMS 조직·사용자 트리 API를, 우측 배치 목록은 검토인력관리 API를 사용한다.
-
---
-
-## 3. 화면 구성
-
-### 3-1. 전체 레이아웃
-
-```
-┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
-│  페이지 타이틀: 검토인력관리              브레드크럼: 디지털행정지원 > 사이트관리 > 검토인력관리 │
-├─────────────────────────────────┬──────────────────────────────────────────────────────────────────┤
-│  [영역 A] 조직도                │  [영역 B] 인원 배치 (결재구분별 4블록, 세로 스택)                │
-│  제목: 조직도                   │                                                                  │
-│  [A-1] 검색:                    │  ┌─ [B-1] 접수 ───────────── count ─ [선택 인원 배치] ─┐         │
-│  [성명·부서 검색] [조회][초기화]│  │  (배치 목록 또는 빈 상태 문구)                       │        │
-│  선택 안내:                     │  └──────────────────────────────────────────────────────┘        │
-│  "선택된 인원: {이름}           │  ┌─ [B-2] 검토 ───────────── count ─ [선택 인원 배치] ──┐        │
-│   ({부서} / {직급})"            │  └──────────────────────────────────────────────────────┘        │
-│  [A-2] 조직 트리 + 사용자 행    │  ┌─ [B-3] 승인 ───────────── count ─ [선택 인원 배치] ──┐        │
-│  ┌────────────────────┐         │  └──────────────────────────────────────────────────────┘        │
-│  │ 조직 트리 + 사용자 │         │  ┌─ [B-4] 최종승인 ───────── count ─ [선택 인원 배치] ──┐        │
-│  │ (단일 선택 강조)   │         │  └──────────────────────────────────────────────────────┘        │
-│  └────────────────────┘         │                                                                  │
-└─────────────────────────────────┴──────────────────────────────────────────────────────────────────┘
-```
-
-### 3-2. 화면 데이터 흐름
-
-```
-BEGIN
-
-  // 최초 진입
-  CALL userOgnzService.findOgnzUserTree()
-  DISPLAY 조직도 트리 (영역 A)
-
-  CALL rvwMnpwMngService.findPage({ size: 충분히 큰 값 })   // 또는 atrzSeComCd별 분할 조회
-  GROUP BY atrzSeComCd
-  DISPLAY 인원 배치 4블록 (영역 B-1 ~ B-4) + 건수 뱃지
-
-  // 영역 A-1: 조직도 검색 (클라이언트 필터 — 서버 API 없음)
-  ON [조회] 버튼 CLICK / 검색 폼 SUBMIT DO
-      SET displayTree = filterOgnzUserTree(원본트리, keyword)
-      SET expandedOgnzSnIds = collectExpandedOgnzSnIds(displayTree)   // 매칭 노드 자동 펼침
-      DISPLAY 필터된 트리 (영역 A-2)
-  END ON
-
-  ON [초기화] 버튼 CLICK DO
-      RESET keyword = ""
-      RESET displayTree = 원본트리
-      RESET expandedOgnzSnIds = 빈 Set (또는 기본 접힘)
-      DISPLAY 전체 트리 (영역 A-2)
-  END ON
-
-  // 영역 A-2: 사용자 단일 선택
-  ON 조직도 사용자 행 CLICK DO
-      VALIDATE 동일 행 재클릭이 아닌 경우만 변경
-      SET selectedPerson = { userUuid, userNm, ognzSn, ognzNm, jbgdSeCd, ... }
-      DISPLAY "선택된 인원: {userNm} ({ognzNm} / {직급명})"
-  END ON
-
-  // 영역 B-k: 선택 인원 즉시 배치
-  ON [B-k] [선택 인원 배치] 버튼 CLICK DO
-      VALIDATE selectedPerson 존재
-      SET targetAtrzSeComCd = 블록 k 에 매핑된 결재구분 코드 (§4-2 표)
-      CALL rvwMnpwMngService.save({
-        atrzSeComCd: targetAtrzSeComCd,
-        ognzSn: selectedPerson.ognzSn,
-        userUuid: selectedPerson.userUuid
-      })
-      ON 성공 DO
-          CALL rvwMnpwMngService.findPage (또는 해당 블록 목록만 갱신)
-          DISPLAY [B-k] 배치 목록·건수 뱃지 갱신
-          TOAST "배치되었습니다."
-      END ON
-      ON 실패(이미 존재) DO
-          TOAST (백엔드 메시지 연동)
-      END ON
-  END ON
-
-  // 영역 B-k: 배치 인원 제거 (UI 상 삭제 UX — 스크린샷 미표기, API는 제공됨)
-  ON 배치 인원 [삭제] / [제거] CLICK DO
-      CONFIRM "해당 인원을 배치에서 제거하시겠습니까?"
-      CALL rvwMnpwMngService.delete(atrzSeComCd, ognzSn, userUuid)
-      CALL rvwMnpwMngService.findPage
-      DISPLAY [B-k] 목록·뱃지 갱신
-  END ON
-
-END
-```
-
---
-
-## 4. 영역 A — 조직도
-
-### 4-1. 표시·상호작용
-
-| 요소             | 내용                                                                  |
-| ---------------- | --------------------------------------------------------------------- |
-| 섹션 제목        | 조직도                                                                |
-| 검색 폼 (A-1)    | 성명·부서 키워드 입력 + **[조회]** + **[초기화]** — §4-3              |
-| 선택 안내 문구   | `선택된 인원: {userNm} ({ognzNm} / {직급표시})` — 미선택 시 안내 문구 |
-| 트리 (A-2)       | 본부 → 팀 계층 + 팀 소속 사용자 목록 (`displayTree` 기준 표시)        |
-| 선택 규칙        | **사용자 1명만** 선택 가능 (라디오형 단일 선택)                       |
-| 선택 시각 피드백 | 선택된 사용자 행 강조(배경·테두리)                                    |
-| 로딩/오류/빈값   | Skeleton / 오류 문구 / "등록된 조직/사용자가 없습니다."               |
-| 검색 결과 없음   | 필터 후 매칭 노드·사용자 0건. "조회된 인원이 없습니다." 문구 노출     |
-
-### 4-2. 조직도 데이터 매핑
-
-| UI 표시         | 트리 DTO 필드 (`OgnzUserTreeResponseDto`) | 비고                                      |
-| --------------- | ----------------------------------------- | ----------------------------------------- |
-| 조직명          | `ognzNm`                                  | 접기/펼치기 노드                          |
-| 사용자명        | `users[].userNm`                          | 클릭 시 선택                              |
-| 부서(안내 문구) | `ognzNm` (소속 팀 노드)                   | 선택 시 `selectedPerson.ognzNm`           |
-| 직급(안내 문구) | `users[].jbgdSeCd` 또는 `jbpsSeCd`        | 공통코드 라벨 변환                        |
-| 저장용 조직 SN  | `ognzSn`                                  | 사용자가 속한 **리프/팀 노드**의 `ognzSn` |
-| 저장용 사용자   | `users[].userUnqId`                       | API body `userUuid`로 전달 (§6-3)         |
-
-### 4-3. 조직도 검색 (영역 A-1)
-
-결재선 관리 `AprvrPickerDialog`와 동일한 **클라이언트 사이드 필터** 패턴을 사용한다. 별도 검색 API는 없으며, `useOgnzUserTree`로 받은 **원본 트리**를 `filterOgnzUserTree`로 가공해 `displayTree`에 반영한다.
-
-#### 필드 정의
-
-| 표시명         | 입력 유형 | 필수 | 기본값 | API 파라미터 매핑 | 비고                                      |
-| -------------- | --------- | ---- | ------ | ----------------- | ----------------------------------------- |
-| 성명·부서 검색 | Text      | N    | (빈값) | — (클라이언트만)  | `placeholder="성명·부서 검색"`            |
-| 조회           | Button    | —    | —      | —                 | `type="submit"` — 폼 제출 시 필터 적용    |
-| 초기화         | Button    | —    | —      | —                 | `type="button"` — 키워드·트리·펼침 초기화 |
-
-#### 필터 규칙 (`filterOgnzUserTree`)
-
-| 대상             | 매칭 조건                                             |
-| ---------------- | ----------------------------------------------------- |
-| 조직명           | `ognzNm`에 키워드 포함 (대소문자 무시)                |
-| 사용자명         | `userNm`에 키워드 포함 (대소문자 무시)                |
-| 조직 매칭 시     | 해당 노드 **소속 사용자 전원** 유지                   |
-| 사용자만 매칭 시 | 매칭 사용자만 남기고 상위 조직 노드는 유지(경로 보존) |
-| 하위 조직        | 재귀 필터 — 자식·손자 노드 매칭 시 상위도 표시        |
-| 키워드 빈값      | 원본 트리 전체 반환                                   |
-
-#### 조회 후 트리 펼침 (`collectExpandedOgnzSnIds`)
-
- **[조회]** 성공 후 필터 결과 트리의 **모든 노드** `ognzSn`을 `expandedOgnzSnIds`에 넣어 자동 펼침
- 검색 결과에서 사용자·하위 조직을 바로 확인할 수 있도록 함
-
-#### 초기화 동작
-
-| 상태                | 초기화 후 값                            |
-| ------------------- | --------------------------------------- |
-| `keyword`           | `""`                                    |
-| `displayTree`       | `useOgnzUserTree` 원본 `data`           |
-| `expandedOgnzSnIds` | `new Set()` (전체 접힘)                 |
-| `selectedPerson`    | **유지** — 검색 초기화와 선택 해제 분리 |
-
-#### 버튼
-
-| 버튼명 | 동작                                                      |
-| ------ | --------------------------------------------------------- |
-| 조회   | `filterOgnzUserTree(data, keyword)` → `displayTree` 갱신  |
-| 초기화 | 키워드·표시 트리·펼침 상태 리셋 (§3-2 `ON [초기화]` 블록) |
-
---
-
-## 5. 영역 B — 인원 배치
-
-### 5-1. 블록 공통
-
-| 요소               | 내용                                              |
-| ------------------ | ------------------------------------------------- |
-| 블록 제목          | 접수 / 검토 / 승인 / 최종승인                     |
-| 건수 뱃지          | 해당 `atrzSeComCd`에 배치된 인원 수               |
-| 액션 버튼          | **[선택 인원 배치]** — 클릭 시 즉시 `save` (§3-2) |
-| 빈 상태            | "배치된 인원이 없습니다."                         |
-| 배치 목록(있을 때) | 인원명·부서·직급 등                               |
-
-### 5-2. 결재구분 ↔ 블록 매핑
-
-| 블록 | UI 제목  | `atrzSeComCd` | 비고                                                           |
-| ---- | -------- | ------------- | -------------------------------------------------------------- |
-| B-1  | 접수     | `ATRZ00`      | 결재선 관리 `ATRZ_RECEIVER_CD`와 동일                          |
-| B-2  | 검토     | `ATRZ01`      | 결재선 `ATRZ_REVIEWER_1_CD`. `ATRZ02` 별도 블록 여부 — **TBD** |
-| B-3  | 승인     | `ATRZ03`      | 결재선 `ATRZ_APPROVER_CD`                                      |
-| B-4  | 최종승인 | `ATRZ99`      | 결재선 `ATRZ_FINAL_CD`                                         |
-
-공통코드 마스터 `ATRZSE` / 화면 셀렉트용 `ATRZSECD`와 정합성은 배포 환경 코드표로 최종 확인.
-
-### 5-3. 배치 목록 항목 (표시)
-
-| 표시명   | Field (응답 DTO) | 비고                         |
-| -------- | ---------------- | ---------------------------- |
-| 사용자명 | `userUuidNm`     | `@CodeName` 미적용 시 TBD    |
-| 결재구분 | `atrzSeComCdNm`  | 블록 제목과 중복 — 생략 가능 |
-| 조직 SN  | `ognzSn`         | 삭제 API path에 사용         |
-| 사용자   | `userUuid`       | 삭제 API path에 사용         |
-
-### 5-4. 버튼
-
-| 버튼명         | 위치        | 동작                              |
-| -------------- | ----------- | --------------------------------- |
-| 선택 인원 배치 | 각 B-k 헤더 | `save` 후 목록·뱃지 갱신 (§3-2)   |
-| 제거           | 목록 항목   | `delete` 후 목록·뱃지 갱신 (§3-2) |
-
-### 5-5. 검증·제약
-
-| 규칙          | 내용                                                                |
-| ------------- | ------------------------------------------------------------------- |
-| 선택 필수     | `[선택 인원 배치]` 시 `selectedPerson` 없으면 버튼 비활성 또는 안내 |
-| 단일 선택     | 조직도에서 사용자 1명만 `selectedPerson` 유지                       |
-| 중복 등록     | 동일 PK `(atrzSeComCd, ognzSn, userUuid)` 재등록 시 서버 오류       |
-| 다건 배치     | 동일 블록에 서로 다른 사용자·조직은 **복수 행** 가능 (PK가 다름)    |
-| 결재구분 변경 | 본 화면 주 흐름은 `save`만                                          |
-
---
-
-## 6. API/DTO 명세
-
-### 6-1. 공통
-
-| 항목          | 내용                                                          |
-| ------------- | ------------------------------------------------------------- |
-| 인증          | JWT (`Authorization` 헤더)                                    |
-| 페이징        | Spring `Pageable`: `page`, `size`, `sort` → `PageResponse<T>` |
-| 프론트 엔티티 | `@/entities/user-organization`, `@/entities/rvw-mnpw`         |
-
-### 6-2. 조직·사용자 트리 (영역 A) — `user-ognz`
-
-| 항목        | 내용                            |
-| ----------- | ------------------------------- |
-| 서비스      | `cms-service`                   |
-| Base prefix | `/cms-service/api/v1/user-ognz` |
-
-| 기능             | Method | URL         | Request DTO | Response DTO                | API                                |
-| ---------------- | ------ | ----------- | ----------- | --------------------------- | ---------------------------------- |
-| 조직·사용자 트리 | GET    | `/treeuser` | —           | `OgnzUserTreeResponseDto[]` | `userOgnzService.findOgnzUserTree` |
-
-**`OgnzUserTreeResponseDto`**: `ognzSn`, `upOgnzSn`, `ognzNm`, `users[]`, `children[]`
-
-**`OgnzUserTreeUserDto`**: `userUnqId`, `userNm`, `jbpsSeCd`, `jbgdSeCd`
-
-**React Query**: `useOgnzUserTree`
-
-### 6-3. 검토인력관리 (영역 B) — `rvw-mnpw`
-
-| 항목        | 내용                                  |
-| ----------- | ------------------------------------- |
-| 서비스      | `as-service`                          |
-| Base prefix | `/as-service/api/v1/rvw-mnpw`         |
-| ENDPOINT    | `ENDPOINT.AS_COMMON_SERVICE.RVW_MNPW` |
-
-| 기능            | Method | URL                                  | Request DTO / Query              | Response DTO                  | API                          |
-| --------------- | ------ | ------------------------------------ | -------------------------------- | ----------------------------- | ---------------------------- |
-| 목록 조회       | GET    | `/`                                  | `RvwMnpwMngSearchDto` + Pageable | `Page<RvwMnpwMngResponseDto>` | `rvwMnpwMngService.findPage` |
-| 상세 조회       | GET    | `/{atrzSeComCd}/{ognzSn}/{userUuid}` | Path                             | `RvwMnpwMngResponseDto`       | `rvwMnpwMngService.findById` |
-| 등록(즉시 배치) | POST   | `/`                                  | `RvwMnpwMngSaveRequestDto`       | `RvwMnpwMngResponseDto` (201) | `rvwMnpwMngService.save`     |
-| 결재구분 변경   | PUT    | `/{atrzSeComCd}/{ognzSn}/{userUuid}` | `RvwMnpwMngUpdateRequestDto`     | `RvwMnpwMngResponseDto`       | `rvwMnpwMngService.update`   |
-| 삭제            | DELETE | `/{atrzSeComCd}/{ognzSn}/{userUuid}` | Path                             | `string`                      | `rvwMnpwMngService.delete`   |
-
-**`RvwMnpwMngSearchDto`**: `atrzSeComCd?`, `ognzSn?`, `userUuid?` + `page`, `size`, `sort`
-
-**`RvwMnpwMngSaveRequestDto`**: `atrzSeComCd*`, `ognzSn*`, `userUuid*`
-
-**`RvwMnpwMngUpdateRequestDto`**: `newAtrzSeComCd*` — 본 화면 기본 흐름에서는 미사용
-
-**`RvwMnpwMngResponseDto`**: `atrzSeComCd`, `atrzSeComCdNm?`, `ognzSn`, `userUuid`, `userUuidNm?`, `rgtr?`, `regDt?`
-
-### 6-4. 조직도 ↔ 검토인력 필드 매핑 (저장 시)
-
-| 조직도 (`OgnzUserTreeUserDto` + 노드) | `RvwMnpwMngSaveRequestDto` | 비고                  |
-| ------------------------------------- | -------------------------- | --------------------- |
-| (블록 k의 `atrzSeComCd`)              | `atrzSeComCd`              | §5-2 표               |
-| 소속 팀 `ognzSn`                      | `ognzSn`                   |                       |
-| `userUnqId`                           | `userUuid`                 | 문자열(UUID)로 직렬화 |
-
---
-
-## 7. UI 구현 가이드
-
-### 7-1. 기술 스택·원칙
-
- **공통 컴포넌트**: `@common/components` (`Button`, `Badge`, `Card` 또는 섹션 레이아웃)
- **데이터**: React Query — `useOgnzUserTree`, `useRvwMnpwMngPage`, `useSaveRvwMnpwMng`, `useDeleteRvwMnpwMng`
- **상태**: `selectedPerson`(단일), `keyword`, `displayTree`, `expandedOgnzSnIds`, 블록별 배치 목록(서버 데이터 파생)
- **조직도 검색**: `filterOgnzUserTree`, `collectExpandedOgnzSnIds` (`widgets/ognz-user-tree/lib` 또는 페이지 `lib`)
- **저장 UX**: 별도 화면 저장 없음 — **[선택 인원 배치]** = `save` mutation 즉시 호출
- **조직도 UI**: 결재선 관리 `ognz-user-tree.tsx`를 **widgets**로 승격해 공통화
-
-### 7-2. 모듈·파일 배치(제안)
-
-| 구분     | 경로                                                                               |
-| -------- | ---------------------------------------------------------------------------------- |
-| 라우트   | `apps/as/app/(with-base-layout)/rvw-mnpw-mng/page.tsx`                             |
-| 페이지   | `apps/as/src/pages/rvw-mnpw-mng/`                                                  |
-| UI       | `.../ui/rvw-mnpw-mng-page.tsx`, `rvw-mnpw-assignment-panel.tsx` 등                 |
-| model    | `.../model/selected-ognz-user.ts`, `rvw-mnpw-block-config.ts` (`atrzSeComCd` 상수) |
-| lib      | `.../lib/group-rvw-mnpw-by-atrz-se.ts` (목록 → B-1~B-4 분배)                       |
-| **위젯** | `apps/as/src/widgets/ognz-user-tree/` — 아래 이전 대상                             |
-| 엔티티   | `entities/user-organization/`, `entities/rvw-mnpw/` (구현 완료)                    |
-
-#### widgets/ognz-user-tree 이전 (결재선 → 공통)
-
-| 현재 (결재선 관리)                                     | 이전 후 (widgets)                                                                    |
-| ------------------------------------------------------ | ------------------------------------------------------------------------------------ |
-| `pages/approval-line-management/ui/ognz-user-tree.tsx` | `widgets/ognz-user-tree/ui/ognz-user-tree.tsx`                                       |
-| `pages/.../ui/ognz-user-tree-node.tsx`                 | `widgets/ognz-user-tree/ui/ognz-user-tree-node.tsx`                                  |
-| `pages/.../model/reviewer-option.ts`                   | `widgets/ognz-user-tree/model/selected-ognz-user.ts` (이름·필드 확장: `ognzSn` 필수) |
-| `pages/.../lib/filter-ognz-user-tree.ts`               | `widgets/ognz-user-tree/lib/filter-ognz-user-tree.ts` (**필수** — 검색 공통화)       |
-| `widgets/ognz-user-tree/index.ts`                      | `OgnzUserTree`, `OgnzUserTreeNode`, 타입 export                                      |
-
-결재선 `AprvrPickerDialog`는 `@/widgets/ognz-user-tree` import로 교체. 검토인력관리 페이지는 **인라인 조직도**(다이얼로그 없음)로 동일 위젯 사용.
-
-**`SelectedOgnzUser`** — `ReviewerOption` 확장:
-
-```typescript
-export interface SelectedOgnzUser {
-  userUuid: string; // OgnzUserTreeUserDto.userUnqId
-  userNm: string;
-  ognzSn: number;
-  ognzNm: string;
-  jbgdSeCd?: string;
-  jbpsSeCd?: string;
-}
-```
-
-### 7-3. 영역별 UI 매핑
-
-| 영역 | 주요 UI                                                              |
-| ---- | -------------------------------------------------------------------- |
-| A-1  | 검색 폼 (`Input` + 조회/초기화) — `AprvrPickerDialog` 90~103행 패턴  |
-| A-2  | `OgnzUserTree(nodes={displayTree})` + 선택 안내 + `useOgnzUserTree`  |
-| B-k  | 제목·Badge(count)·`선택 인원 배치`·배치 목록(또는 empty)             |
-| 공통 | 페이지 헤더·브레드크럼·2열 레이아웃 (`grid` / `flex`, 모바일은 스택) |
-
-### 7-4. 다이얼로그·라우팅
-
-| 항목       | 내용                                |
-| ---------- | ----------------------------------- |
-| 다이얼로그 | **없음** (조직도 인라인, 즉시 저장) |
-| 라우팅     | 메뉴 `검토인력관리` 단일 페이지     |
-
-### 7-5. 데이터 흐름(구현 요약)
-
- **진입**: `useOgnzUserTree` → `displayTree = data` + `useRvwMnpwMngPage({ page: 0, size: N })` → 4패널.
- **검색**: `keyword` 로컬 상태 → **[조회]** 시 `filterOgnzUserTree` + `collectExpandedOgnzSnIds` → `OgnzUserTree`에 `displayTree` 전달.
- **초기화**: `keyword`·`displayTree`·`expandedOgnzSnIds` 리셋 (`selectedPerson` 유지).
- **선택**: 트리 `onSelect` → `selectedPerson` (반드시 `ognzSn` 포함).
- **배치**: `useSaveRvwMnpwMng().mutate({ atrzSeComCd, ognzSn, userUuid })` → `onSuccess`에서 `rvw-mnpw` query invalidate.
- **삭제**: 목록 항목에서 `useDeleteRvwMnpwMng` — UI 확정 후 연결.
-
-### 7-6. 미확정 / 검증 필요
-
- [ ] `ATRZ02`(검토2) 별도 블록 필요 여부
- [ ] 권한(역할별 CRUD)
@@ -1,33 +0,0 @@
-import { FlatCompat } from "@eslint/eslintrc";
-import { dirname } from "path";
-import { fileURLToPath } from "url";
-import baseEsLintConfig from "../../eslint.config.mjs";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-const compat = new FlatCompat({
-  baseDirectory: __dirname,
-});
-
-const eslintConfig = [
-  ...compat.extends("next/core-web-vitals", "next/typescript"),
-  ...baseEsLintConfig,
-  {
-    rules: {
-      "react-hooks/exhaustive-deps": "off",
-      "@typescript-eslint/no-unused-vars": [
-        "warn",
-        {
-          argsIgnorePattern: "^_",
-          varsIgnorePattern: "^_",
-          caughtErrorsIgnorePattern: "^_",
-        },
-      ],
-      "@typescript-eslint/no-explicit-any": "warn",
-      "@typescript-eslint/no-wrapper-object-types": "warn",
-    },
-  },
-];
-
-export default eslintConfig;
@@ -1,73 +0,0 @@
-import { NextRequest, NextResponse } from "next/server";
-
-import { AUTH_USER_ID, CLAIM_NAME, PORT, PROXY_HOST, SERVER_API_URL, SITE_ID } from "@/shared/config";
-
-const serverApiUrl = process.env.SERVER_API_URL;
-
-// CSP 헤더 설정 함수 (img-src만)
-function addSecurityHeaders(response: NextResponse): NextResponse {
-  response.headers.set("Content-Security-Policy", "img-src 'self' data: https: blob:;");
-  return response;
-}
-
-export function middleware(req: NextRequest) {
-  const pathname = req.nextUrl.pathname;
-  const searchParams = req.nextUrl.searchParams;
-
-  const logMessages: string[] = [
-    `[Middleware Request] ${new Date().toISOString()}`,
-    `[Environment]\n  Mode: ${process.env.NODE_ENV}\n  Port: ${PORT}\n  Proxy Host: ${PROXY_HOST}\n  Server API URL: ${SERVER_API_URL}\n  Site ID: ${SITE_ID}`,
-    `[Request]\n  Original Pathname: ${pathname}`,
-  ];
-
-  if (pathname.startsWith("/server")) {
-    const queryParams = searchParams.toString();
-    const newUrl = `${serverApiUrl}${pathname.replace("/server", "")}${
-      queryParams ? `?${queryParams}` : ""
-    }`;
-
-    logMessages.push(`  Rewritten URL: ${newUrl}`);
-    logMessages.push("\n--------------------------------\n");
-    console.log(logMessages.join("\n"));
-
-    const response = NextResponse.rewrite(new URL(newUrl));
-    return addSecurityHeaders(response);
-  }
-
-  
-  // tus-js-client PATCH 요청: Location 헤더로 /server 없이 반환된 경로 직접 처리
-  // (예: /attach-service/api/v1/tus/upload/{id})
-  if (pathname.startsWith("/attach-service")) {
-    const requestHeaders = new Headers(req.headers);
-    const token = req.cookies.get(CLAIM_NAME)?.value;
-    const userId = req.cookies.get(AUTH_USER_ID)?.value;
-    const newUrl = `${serverApiUrl}${pathname}`;
-
-    if (token) requestHeaders.set(CLAIM_NAME, token);
-    if (userId) requestHeaders.set(AUTH_USER_ID, userId);
-
-    logMessages.push(`  [TUS Proxy] Rewritten URL: ${newUrl}`);
-    logMessages.push("\n--------------------------------\n");
-    console.log(logMessages.join("\n"));
-
-    const response = NextResponse.rewrite(new URL(newUrl), {
-      headers: requestHeaders,
-    });
-    return addSecurityHeaders(response);
-  }
-
-  // if (pathname === "/") {
-  //   const response = NextResponse.redirect(new URL("/dashboard", req.url));
-  //   return addSecurityHeaders(response);
-  // }
-
-  logMessages.push("\n--------------------------------\n");
-  console.log(logMessages.join("\n"));
-
-  const response = NextResponse.next();
-  return addSecurityHeaders(response);
-}
-
-export const config = {
-  matcher: ["/server/:path*", "/attach-service/:path*", "/"],
-};
@@ -1,9 +0,0 @@
-import type { NextConfig } from "next";
-
-const nextConfig: NextConfig = {
-  output: "standalone",
-  reactStrictMode: true,
-  transpilePackages: ["@common/assets"],
-};
-
-export default nextConfig;
@@ -1,50 +0,0 @@
-{
-  "name": "as",
-  "version": "0.1.0",
-  "private": true,
-  "scripts": {
-    "dev": "next dev -p 3003",
-    "build": "next build",
-    "start": "next start -p 3003",
-    "lint": "next lint",
-    "lint:fsd": "steiger ."
-  },
-  "dependencies": {
-    "@common/assets": "workspace:*",
-    "@common/auth": "workspace:*",
-    "@common/components": "workspace:*",
-    "@common/network": "workspace:*",
-    "@dnd-kit/core": "^6.3.1",
-    "@dnd-kit/sortable": "^10.0.0",
-    "@dnd-kit/utilities": "^3.2.2",
-    "@faker-js/faker": "^9.9.0",
-    "@frontend-opensource/use-react-hooks": "^1.1.4",
-    "@hookform/resolvers": "^4.1.3",
-    "@radix-ui/react-tooltip": "^1.2.8",
-    "@tanstack/react-query": "^5.75.5",
-    "@tanstack/react-query-devtools": "^5.75.5",
-    "@tanstack/react-table": "^8.21.2",
-    "axios": "^1.8.1",
-    "class-variance-authority": "^0.7.1",
-    "dayjs": "^1.11.13",
-    "js-cookie": "^3.0.5",
-    "lucide-react": "^0.474.0",
-    "next": "15.5.18",
-    "react-hook-form": "^7.54.2",
-    "tus-js-client": "^4.3.1",
-    "zod": "^3.24.2"
-  },
-  "devDependencies": {
-    "@eslint/eslintrc": "^3",
-    "@types/js-cookie": "^3.0.6",
-    "eslint": "^9.0.0",
-    "eslint-config-next": "15.3.8",
-    "eslint-plugin-react-hooks": "^5.0.0",
-    "postcss": "^8.4.49",
-    "prettier": "^3.4.2",
-    "prettier-plugin-tailwindcss": "^0.6.11",
-    "steiger": "^0.5.11",
-    "tailwindcss": "^3.4.14",
-    "typescript": "^5.7.2"
-  }
-}
@@ -1,9 +0,0 @@
-# 이 폴더는 비워 둡니다 (FSD + Next.js App Router)
-
-Next.js가 `src/pages`를 **Pages Router**용 `pages` 디렉터리로 인식하지 않도록,  
-프로젝트 루트에 **빈 `pages` 폴더**를 두는 것이 FSD 공식 가이드 권장사항입니다.
-
- 실제 페이지(FSD Pages 레이어)는 **`src/pages`**에 있습니다.
- Next.js 라우트는 **`app/`** 에서 `src/pages`를 re-export 하는 방식으로 연결됩니다.
-
-[Feature-Sliced Design - Usage with Next.js (App Router)](https://feature-sliced.design/docs/guides/tech/with-nextjs)
@@ -1,8 +0,0 @@
-/** @type {import('postcss-load-config').Config} */
-const config = {
-  plugins: {
-    tailwindcss: {},
-  },
-};
-
-export default config;
@@ -1,43 +0,0 @@
-"use client";
-
-import { useCallback } from "react";
-import { usePathname, useRouter } from "next/navigation";
-
-import { useQueryClient } from "@tanstack/react-query";
-
-import { useMenuStore } from "@/shared/lib";
-import { PageLayout } from "@/shared/ui/page-layout";
-import { authService } from "@/entities/auth";
-import type { MenuItem } from "@/entities/menu";
-import { BaseLayout } from "@common/components";
-
-interface BaseLayoutWrapperProps {
-  children: React.ReactNode;
-}
-
-export function BaseLayoutWrapper({ children }: BaseLayoutWrapperProps) {
-  const router = useRouter();
-  const pathname = usePathname();
-  const queryClient = useQueryClient();
-
-  const setCurrentMenuInfo = useMenuStore((state) => state.setCurrentMenuInfo);
-
-  const handleMenuClick = useCallback(
-    (item: MenuItem) => {
-      setCurrentMenuInfo(item);
-      router.push(item.urlPath);
-    },
-    [router, setCurrentMenuInfo],
-  );
-
-  return (
-    <BaseLayout
-      queryClient={queryClient}
-      authService={authService}
-      currentPath={pathname ?? ""}
-      handleMenuClick={handleMenuClick}
-    >
-      <PageLayout>{children}</PageLayout>
-    </BaseLayout>
-  );
-}
@@ -1,35 +0,0 @@
-"use client";
-
-import { ConfirmProvider } from "@frontend-opensource/use-react-hooks";
-import { QueryClientProvider } from "@tanstack/react-query";
-import { ReactQueryDevtools } from "@tanstack/react-query-devtools";
-
-import { queryClient } from "@/shared/lib";
-import { StoreProvider } from "@/shared/providers";
-import { AlertDialog } from "@/shared/ui/alert-dialog";
-import { ConfirmDialog } from "@/shared/ui/confirm-dialog";
-import { AuthWrapper } from "@/entities/auth";
-import { MenuWrapper } from "@/entities/menu";
-
-interface ProvidersProps {
-  children: React.ReactNode;
-}
-
-export function Providers({ children }: ProvidersProps) {
-  return (
-    <QueryClientProvider client={queryClient}>
-      <StoreProvider>
-        <ConfirmProvider>
-          <AuthWrapper>
-            <MenuWrapper>{children}</MenuWrapper>
-            <AlertDialog />
-            <ConfirmDialog />
-          </AuthWrapper>
-        </ConfirmProvider>
-      </StoreProvider>
-      <div style={{ fontSize: "1.4rem" }}>
-        <ReactQueryDevtools initialIsOpen={false} />
-      </div>
-    </QueryClientProvider>
-  );
-}
@@ -1,15 +0,0 @@
-@import "@common/assets/styles/base.css";
-@import "@common/assets/styles/diveicon.css";
-@import "@common/components/index.css";
-
-@tailwind base;
-@tailwind components;
-@tailwind utilities;
-
-html,
-body {
-  color: var(--foreground);
-  background: var(--background);
-  font-family: "Noto Sans KR", sans-serif;
-  font-size: 10px;
-}
@@ -1,114 +0,0 @@
-# Entities Layer
-
-**Entities**는 프로젝트가 다루는 실제 비즈니스 개념을 나타내는 레이어입니다. 비즈니스에서 제품을 설명할 때 사용하는 용어들(예: User, Product, Order)이 주로 엔티티가 됩니다.
-
-## 목적
-
- 비즈니스 엔티티의 데이터 모델 및 타입 정의
- 엔티티 관련 API 요청 함수 관리
- 엔티티의 시각적 표현 제공 (재사용 가능한 UI)
- 여러 페이지에서 동일한 외관을 재사용할 수 있도록 지원
-
-## 구조
-
-각 엔티티 슬라이스는 다음 세그먼트로 구성됩니다:
-
-```
-entities/
-└── [entity-name]/
-    ├── model/         # 데이터 저장소, 검증 스키마, 상태 관리
-    ├── api/           # 엔티티 관련 API 요청 함수
-    ├── ui/            # 엔티티 시각적 표현 (선택적)
-    ├── lib/           # 엔티티 관련 유틸리티 (선택적)
-    ├── @x/            # 다른 엔티티로부터의 cross-import용 Public API (선택적)
-    └── index.ts       # Public API
-```
-
-### 세그먼트 설명
-
- **model**: 데이터 모델, 타입 정의, 상태 저장소 (Zustand 등)
- **api**: 백엔드 API 호출 함수
- **ui**: 엔티티를 표시하는 UI 컴포넌트 (완전한 UI 블록이 아니라 재사용 가능한 표현)
- **lib**: 엔티티 관련 유틸리티 함수
- **@x**: 다른 엔티티가 이 엔티티를 import할 때 사용하는 명시적 cross-import API
- **index.ts**: 슬라이스의 Public API (외부에서 사용할 수 있는 것만 export)
-
-## 예시
-
-```typescript
-// entities/user/model/user.ts
-export interface User {
-  id: string;
-  name: string;
-  email: string;
-  role: 'admin' | 'user';
-}
-
-// entities/user/api/get-user.ts
-import type { User } from '../model/user';
-
-export async function getUser(id: string): Promise<User> {
-  const response = await fetch(`/api/users/${id}`);
-  return response.json();
-}
-
-// entities/user/ui/user-card.tsx
-import type { User } from '../model/user';
-
-interface UserCardProps {
-  user: User;
-  onClick?: () => void;
-}
-
-export function UserCard({ user, onClick }: UserCardProps) {
-  return (
-    <div onClick={onClick}>
-      <h3>{user.name}</h3>
-      <p>{user.email}</p>
-    </div>
-  );
-}
-
-// entities/user/index.ts
-export { type User } from './model/user';
-export { getUser } from './api/get-user';
-export { UserCard } from './ui/user-card';
-```
-
-## 엔티티 간 관계
-
-엔티티가 서로 연결되어 있을 때는 `@x` 표기법을 사용하여 명시적으로 cross-import를 관리하는 것이 권장됩니다:
-
-```typescript
-// entities/artist/model/artist.ts
-import type { Song } from 'entities/song/@x/artist';
-
-export interface Artist {
-  name: string;
-  songs: Array<Song>;
-}
-
-// entities/song/@x/artist.ts
-export type { Song } from '../model/song';
-```
-
-> `@x` 폴더를 사용하면 엔티티 간 연결을 명확하게 만들어 함께 리팩터링이 필요한 코드를 쉽게 찾을 수 있습니다.
-
-## 레이어 의존성 규칙
-
-✅ **허용되는 의존성**:
- `shared` 레이어의 모듈
- 같은 엔티티 슬라이스 내의 다른 세그먼트
- 다른 엔티티 슬라이스 (필요한 경우, `@x` 표기법 권장)
-
-❌ **금지된 의존성**:
- `features` 레이어
- `widgets` 레이어
- `pages` 레이어
- `app` 레이어
-
-## 주의사항
-
-1. **UI 컴포넌트는 완전한 비즈니스 로직을 포함하지 않음**: UI는 주로 props나 slots를 통해 다양한 비즈니스 로직을 연결할 수 있도록 설계
-2. **엔티티 간 비즈니스 로직은 상위 레이어에**: 엔티티 간 상호작용의 비즈니스 로직은 Features나 Pages 레이어에서 처리
-3. **데이터 관리에 집중**: 복잡한 비즈니스 로직보다는 데이터 모델, 검증, 저장에 집중
@@ -1,58 +0,0 @@
-import { client } from "@/shared/api";
-import { ENDPOINT } from "@/shared/config";
-import type { PageResponse } from "@/shared/model";
-
-import {
-  ACNTG_SE_SAVE_MODE,
-  type AcntgSeMngPutRequestDto,
-  type AcntgSeMngResponseDto,
-  type AcntgSeMngSaveRequestDto,
-  type AcntgSeMngSearchDto,
-  type AcntgSeMngService,
-  type AcntgSeMngTreeDto,
-} from "../model/acntg-interface";
-
-const BASE = ENDPOINT.AS_SERVICE.ACNTG_SE;
-
-async function findAll(params: AcntgSeMngSearchDto): Promise<PageResponse<AcntgSeMngResponseDto>> {
-  const response = await client.get<PageResponse<AcntgSeMngResponseDto>>(BASE, { params });
-  return response.data;
-}
-
-async function findTree(): Promise<AcntgSeMngTreeDto[]> {
-  const response = await client.get<AcntgSeMngTreeDto[]>(`${BASE}/list/tree`);
-  return response.data;
-}
-
-async function findById(acntgSeCd: string): Promise<AcntgSeMngResponseDto> {
-  const response = await client.get<AcntgSeMngResponseDto>(`${BASE}/${acntgSeCd}`);
-  return response.data;
-}
-
-async function saveMulti(body: AcntgSeMngSaveRequestDto[]): Promise<AcntgSeMngResponseDto[]> {
-  const response = await client.post<AcntgSeMngResponseDto[]>(BASE, body);
-  return response.data;
-}
-
-async function update(acntgSeCd: string, body: AcntgSeMngPutRequestDto): Promise<string> {
-  const response = await client.put<string>(`${BASE}/${acntgSeCd}`, {
-    ...body,
-    acntgSeCd,
-    mode: ACNTG_SE_SAVE_MODE.UPDATE,
-  });
-  return response.data;
-}
-
-async function deleteAcntgSeCd(acntgSeCd: string): Promise<string> {
-  const response = await client.delete<string>(`${BASE}/${acntgSeCd}`);
-  return response.data;
-}
-
-export const acntgSeMngService = {
-  findAll,
-  findTree,
-  findById,
-  saveMulti,
-  update,
-  delete: deleteAcntgSeCd,
-} satisfies AcntgSeMngService;
@@ -1,73 +0,0 @@
-import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
-
-import { ENDPOINT } from "@/shared/config";
-
-import type {
-  AcntgSeMngPutRequestDto,
-  AcntgSeMngSaveRequestDto,
-  AcntgSeMngSearchDto,
-} from "../model/acntg-interface";
-
-import { acntgSeMngService } from "./acntg-service";
-
-const acntgSeMngBaseKey = [ENDPOINT.AS_SERVICE.ACNTG_SE] as const;
-
-export function useAcntgSeMngPage(params: AcntgSeMngSearchDto) {
-  return useQuery({
-    queryKey: [...acntgSeMngBaseKey, "findAll", params],
-    queryFn: () => acntgSeMngService.findAll(params),
-  });
-}
-
-export function useAcntgSeMngTree() {
-  return useQuery({
-    queryKey: [...acntgSeMngBaseKey, "findTree"],
-    queryFn: () => acntgSeMngService.findTree(),
-    staleTime: Infinity,
-  });
-}
-
-export function useAcntgSeMng(acntgSeCd: string | null | undefined) {
-  return useQuery({
-    queryKey: [...acntgSeMngBaseKey, "findById", acntgSeCd],
-    queryFn: () => acntgSeMngService.findById(acntgSeCd!),
-    enabled: Boolean(acntgSeCd),
-  });
-}
-
-export function useSaveMultiAcntgSeMng() {
-  const queryClient = useQueryClient();
-
-  return useMutation({
-    mutationFn: (body: AcntgSeMngSaveRequestDto[]) => acntgSeMngService.saveMulti(body),
-    onSuccess: () => {
-      queryClient.invalidateQueries({ queryKey: acntgSeMngBaseKey });
-    },
-  });
-}
-
-export function useUpdateAcntgSeMng() {
-  const queryClient = useQueryClient();
-
-  return useMutation({
-    mutationFn: ({ acntgSeCd, body }: { acntgSeCd: string; body: AcntgSeMngPutRequestDto }) =>
-      acntgSeMngService.update(acntgSeCd, body),
-    onSuccess: (_data, { acntgSeCd }) => {
-      queryClient.invalidateQueries({ queryKey: acntgSeMngBaseKey });
-      queryClient.invalidateQueries({
-        queryKey: [...acntgSeMngBaseKey, "findById", acntgSeCd],
-      });
-    },
-  });
-}
-
-export function useDeleteAcntgSeMng() {
-  const queryClient = useQueryClient();
-
-  return useMutation({
-    mutationFn: (acntgSeCd: string) => acntgSeMngService.delete(acntgSeCd),
-    onSuccess: () => {
-      queryClient.invalidateQueries({ queryKey: acntgSeMngBaseKey });
-    },
-  });
-}
@@ -1,19 +0,0 @@
-export { acntgSeMngService } from "./api/acntg-service";
-export {
-  useAcntgSeMng,
-  useAcntgSeMngPage,
-  useAcntgSeMngTree,
-  useDeleteAcntgSeMng,
-  useSaveMultiAcntgSeMng,
-  useUpdateAcntgSeMng,
-} from "./api/queries";
-export type {
-  AcntgSeMngResponseDto,
-  AcntgSeMngSaveRequestDto,
-  AcntgSeMngSearchDto,
-  AcntgSeMngService,
-  AcntgSeMngTreeDto,
-  AcntgSeSaveMode,
-  BizCstTreeDto,
-} from "./model/acntg-interface";
-export { ACNTG_SE_SAVE_MODE } from "./model/acntg-interface";
@@ -1,88 +0,0 @@
-import type { PageableParams, PageResponse } from "@/shared/model";
-
-export const ACNTG_SE_SAVE_MODE = {
-  CREATE: "C",
-  UPDATE: "U",
-  DELETE: "D",
-} as const;
-
-export type AcntgSeSaveMode = (typeof ACNTG_SE_SAVE_MODE)[keyof typeof ACNTG_SE_SAVE_MODE];
-
-/** 백엔드 AcntgSeMngResponseDto */
-export interface AcntgSeMngResponseDto {
-  acntgSeCd: string;
-  acntgSeCdNm: string;
-  upAcntgSeCd?: string;
-  cdLvNo: number;
-  useYn: string;
-  expln?: string;
-  sortSeq?: number;
-  rgtr?: string;
-  rgtrNm?: string;
-  mdfr?: string;
-  regDt?: string;
-  mdfcnDt?: string;
-}
-
-/** 백엔드 AcntgSeMngSearchDto + Pageable */
-export interface AcntgSeMngSearchDto extends PageableParams {
-  acntgSeCd?: string;
-  acntgSeCdNm?: string;
-  useYn?: string;
-}
-
-/** 백엔드 AcntgSeMngSaveRequestDto */
-export interface AcntgSeMngSaveRequestDto {
-  acntgSeCd: string;
-  mode: AcntgSeSaveMode;
-  acntgSeCdNm: string;
-  upAcntgSeCd?: string;
-  cdLvNo: number;
-  useYn?: string;
-  expln?: string;
-  sortSeq?: number;
-}
-
-/** PUT /{acntgSeCd} 요청 (mode는 서비스에서 U로 설정) */
-export interface AcntgSeMngPutRequestDto {
-  acntgSeCd: string;
-  acntgSeCdNm: string;
-  upAcntgSeCd?: string;
-  cdLvNo: number;
-  useYn?: string;
-  expln?: string;
-}
-
-/** 백엔드 AcntgSeMngTreeDto */
-export interface AcntgSeMngTreeDto {
-  indAcntgSeCdNm: string;
-  acntgSeCd: string;
-  acntgSeCdNm: string;
-  upAcntgSeCd?: string;
-  useYn: string;
-  treeLevel: number;
-  treePath: string;
-}
-
-/** 백엔드 BizCstTreeDto (InstlSncnMngDetResponseDto 등에서 참조) */
-export interface BizCstTreeDto {
-  indAcntgSeCdNm: string;
-  acntgSeCd: string;
-  acntgSeCdNm: string;
-  useYn: string;
-  treeLevel: number;
-  treePath: string;
-  bscPlanAmt?: number;
-  bgtRfltAmt?: number;
-  tstmDesignAmt?: number;
-}
-
-/** Controller public 메서드명·시그니처와 동일 */
-export interface AcntgSeMngService {
-  findAll(params: AcntgSeMngSearchDto): Promise<PageResponse<AcntgSeMngResponseDto>>;
-  findTree(): Promise<AcntgSeMngTreeDto[]>;
-  findById(acntgSeCd: string): Promise<AcntgSeMngResponseDto>;
-  saveMulti(body: AcntgSeMngSaveRequestDto[]): Promise<AcntgSeMngResponseDto[]>;
-  update(acntgSeCd: string, body: AcntgSeMngPutRequestDto): Promise<string>;
-  delete(acntgSeCd: string): Promise<string>;
-}
@@ -1,26 +0,0 @@
-import { client } from "@/shared/api";
-import { ENDPOINT } from "@/shared/config";
-
-import type {
-  CmCdAdstDstrComboResponseDto,
-  CmCdAdstDstrService,
-} from "../model/adstdstr-interface";
-
-const BASE = ENDPOINT.AS_SERVICE.ADSTDSTR;
-
-async function findSidoCombo(): Promise<CmCdAdstDstrComboResponseDto[]> {
-  const response = await client.get<CmCdAdstDstrComboResponseDto[]>(`${BASE}/sido`);
-  return response.data;
-}
-
-async function findGugunCombo(sido: string): Promise<CmCdAdstDstrComboResponseDto[]> {
-  const response = await client.get<CmCdAdstDstrComboResponseDto[]>(`${BASE}/gugun`, {
-    params: { sido },
-  });
-  return response.data;
-}
-
-export const cmCdAdstDstrService = {
-  findSidoCombo,
-  findGugunCombo,
-} satisfies CmCdAdstDstrService;
@@ -1,22 +0,0 @@
-import { useQuery } from "@tanstack/react-query";
-
-import { ENDPOINT } from "@/shared/config";
-
-import { cmCdAdstDstrService } from "./adstdstr-service";
-
-const cmCdAdstDstrBaseKey = [ENDPOINT.AS_SERVICE.ADSTDSTR] as const;
-
-export function useFindSidoCombo() {
-  return useQuery({
-    queryKey: [...cmCdAdstDstrBaseKey, "findSidoCombo"],
-    queryFn: () => cmCdAdstDstrService.findSidoCombo(),
-  });
-}
-
-export function useFindGugunCombo(sido: string) {
-  return useQuery({
-    queryKey: [...cmCdAdstDstrBaseKey, "findGugunCombo", sido],
-    queryFn: () => cmCdAdstDstrService.findGugunCombo(sido),
-    enabled: Boolean(sido),
-  });
-}
@@ -1,6 +0,0 @@
-export { cmCdAdstDstrService } from "./api/adstdstr-service";
-export { useFindGugunCombo, useFindSidoCombo } from "./api/queries";
-export type {
-  CmCdAdstDstrComboResponseDto,
-  CmCdAdstDstrService,
-} from "./model/adstdstr-interface";
@@ -1,11 +0,0 @@
-/** 백엔드 CmCdAdstDstrComboResponseDto */
-export interface CmCdAdstDstrComboResponseDto {
-  adstDstrCd: string;
-  adstDstrNm: string;
-}
-
-/** Controller public 메서드명·시그니처와 동일 */
-export interface CmCdAdstDstrService {
-  findSidoCombo(): Promise<CmCdAdstDstrComboResponseDto[]>;
-  findGugunCombo(sido: string): Promise<CmCdAdstDstrComboResponseDto[]>;
-}
@@ -1,22 +0,0 @@
-import { AxiosResponse } from "axios";
-
-import { client } from "@/shared/api";
-import { ENDPOINT } from "@/shared/config";
-
-import type { AttachService } from "../model/attach-interface";
-
-async function deleteAttachmentByAtflId(atflId: string): Promise<void> {
-  if (!atflId) return;
-  await client.delete(`${ENDPOINT.ATTACH_SERVICE.ATTACHMENTS}/${atflId}`);
-}
-
-async function downloadAttachmentByAtflCd(atflCd: string): Promise<AxiosResponse> {
-  return await client.get<Blob>(`${ENDPOINT.ATTACH_SERVICE.DOWNLOAD}/${atflCd}`, {
-    responseType: "blob",
-  });
-}
-
-export const attachService = {
-  deleteAttachmentByAtflId,
-  downloadAttachmentByAtflCd,
-} satisfies AttachService;
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
changwng	182af7cf09	222	2025-04-01 17:05:28 +09:00
changwng	84caaa3977	p_atflCd. 추가로직 정리	2025-04-01 17:04:47 +09:00
				`@@ -1 +0,0 @@`
				`export { MainPage as default } from "@/pages/home";`
				`@@ -1 +0,0 @@`
				`export { type MenuItem } from "./model/types";`
				`@@ -1 +0,0 @@`
				`export { PageLayout } from "./page-layout";`
				`@@ -1 +0,0 @@`
				`export { ApprovalLineManagementPage as default } from "@/pages/approval-line-management";`
				`@@ -1 +0,0 @@`
				`export { ChecklistManagementPage as default } from "@/pages/checklist-management";`
				`@@ -1 +0,0 @@`
				`export { CodeManagementPage as default } from "@/pages/code-management";`
				`@@ -1 +0,0 @@`
				`export { EsntlAtchFileMngPage as default } from "@/pages/esntl-atch-file-mng";`
				`@@ -1 +0,0 @@`
				`export { RvwMnpwMngPage as default } from "@/pages/rvw-mnpw-mng";`