From 951b6c759d9e82b208bb9578a48797f3dd86d94d Mon Sep 17 00:00:00 2001
From: HYOJIN <hjkim4@gcsc.co.kr>
Date: Thu, 26 Mar 2026 16:24:54 +0900
Subject: [PATCH 01/19] =?UTF-8?q?feat:=20BYPASS=20API=20=EB=93=B1=EB=A1=9D?=
 =?UTF-8?q?=20=ED=94=84=EB=A1=9C=EC=84=B8=EC=8A=A4=20=EC=84=A4=EA=B3=84=20?=
 =?UTF-8?q?=EB=B0=8F=20=EA=B0=9C=EB=B0=9C=20(#63)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 공통 베이스 클래스 추가 (BaseBypassService, BaseBypassController)
- 기존 Risk 모듈 베이스 클래스 상속으로 리팩토링
- BYPASS API 설정 CRUD API 구현 (/api/bypass-config)
- Java 코드 생성기 구현 (Controller, Service, DTO 자동 생성)
- JSON 샘플 파싱 기능 구현
- 프론트엔드 BYPASS API 관리 페이지 추가 (멀티스텝 등록 모달)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 frontend/src/App.tsx                          |   2 +
 frontend/src/api/bypassApi.ts                 | 123 ++++++
 frontend/src/components/Navbar.tsx            |   1 +
 .../components/bypass/BypassConfigModal.tsx   | 239 ++++++++++
 .../src/components/bypass/BypassStepBasic.tsx | 168 +++++++
 .../components/bypass/BypassStepFields.tsx    | 233 ++++++++++
 .../components/bypass/BypassStepParams.tsx    | 146 ++++++
 frontend/src/pages/BypassConfig.tsx           | 279 ++++++++++++
 .../web/controller/BaseBypassController.java  |  28 ++
 .../common/web/service/BaseBypassService.java | 101 +++++
 .../controller/BypassConfigController.java    | 133 ++++++
 .../batch/global/dto/BypassConfigRequest.java |  45 ++
 .../global/dto/BypassConfigResponse.java      |  60 +++
 .../snp/batch/global/dto/BypassFieldDto.java  |  33 ++
 .../snp/batch/global/dto/BypassParamDto.java  |  36 ++
 .../global/dto/CodeGenerationResult.java      |  28 ++
 .../batch/global/model/BypassApiConfig.java   | 135 ++++++
 .../batch/global/model/BypassApiField.java    |  69 +++
 .../batch/global/model/BypassApiParam.java    |  77 ++++
 .../repository/BypassApiConfigRepository.java |  25 ++
 .../repository/BypassApiFieldRepository.java  |  25 ++
 .../repository/BypassApiParamRepository.java  |  25 ++
 .../web/risk/controller/RiskController.java   |  23 +-
 .../web/risk/service/RiskBypassService.java   |  37 +-
 .../batch/service/BypassCodeGenerator.java    | 415 ++++++++++++++++++
 .../batch/service/BypassConfigService.java    | 228 ++++++++++
 .../snp/batch/service/JsonSchemaParser.java   | 114 +++++
 27 files changed, 2781 insertions(+), 47 deletions(-)
 create mode 100644 frontend/src/api/bypassApi.ts
 create mode 100644 frontend/src/components/bypass/BypassConfigModal.tsx
 create mode 100644 frontend/src/components/bypass/BypassStepBasic.tsx
 create mode 100644 frontend/src/components/bypass/BypassStepFields.tsx
 create mode 100644 frontend/src/components/bypass/BypassStepParams.tsx
 create mode 100644 frontend/src/pages/BypassConfig.tsx
 create mode 100644 src/main/java/com/snp/batch/common/web/controller/BaseBypassController.java
 create mode 100644 src/main/java/com/snp/batch/common/web/service/BaseBypassService.java
 create mode 100644 src/main/java/com/snp/batch/global/controller/BypassConfigController.java
 create mode 100644 src/main/java/com/snp/batch/global/dto/BypassConfigRequest.java
 create mode 100644 src/main/java/com/snp/batch/global/dto/BypassConfigResponse.java
 create mode 100644 src/main/java/com/snp/batch/global/dto/BypassFieldDto.java
 create mode 100644 src/main/java/com/snp/batch/global/dto/BypassParamDto.java
 create mode 100644 src/main/java/com/snp/batch/global/dto/CodeGenerationResult.java
 create mode 100644 src/main/java/com/snp/batch/global/model/BypassApiConfig.java
 create mode 100644 src/main/java/com/snp/batch/global/model/BypassApiField.java
 create mode 100644 src/main/java/com/snp/batch/global/model/BypassApiParam.java
 create mode 100644 src/main/java/com/snp/batch/global/repository/BypassApiConfigRepository.java
 create mode 100644 src/main/java/com/snp/batch/global/repository/BypassApiFieldRepository.java
 create mode 100644 src/main/java/com/snp/batch/global/repository/BypassApiParamRepository.java
 create mode 100644 src/main/java/com/snp/batch/service/BypassCodeGenerator.java
 create mode 100644 src/main/java/com/snp/batch/service/BypassConfigService.java
 create mode 100644 src/main/java/com/snp/batch/service/JsonSchemaParser.java

diff --git a/frontend/src/App.tsx b/frontend/src/App.tsx
index fa9d191..7e28c43 100644
--- a/frontend/src/App.tsx
+++ b/frontend/src/App.tsx
@@ -14,6 +14,7 @@ const Recollects = lazy(() => import('./pages/Recollects'));
 const RecollectDetail = lazy(() => import('./pages/RecollectDetail'));
 const Schedules = lazy(() => import('./pages/Schedules'));
 const Timeline = lazy(() => import('./pages/Timeline'));
+const BypassConfig = lazy(() => import('./pages/BypassConfig'));
 
 function AppLayout() {
   const { toasts, removeToast } = useToastContext();
@@ -32,6 +33,7 @@ function AppLayout() {
             <Route path="/recollects/:id" element={<RecollectDetail />} />
             <Route path="/schedules" element={<Schedules />} />
             <Route path="/schedule-timeline" element={<Timeline />} />
+            <Route path="/bypass-config" element={<BypassConfig />} />
           </Routes>
         </Suspense>
       </div>
diff --git a/frontend/src/api/bypassApi.ts b/frontend/src/api/bypassApi.ts
new file mode 100644
index 0000000..62ca2cc
--- /dev/null
+++ b/frontend/src/api/bypassApi.ts
@@ -0,0 +1,123 @@
+// API 응답 타입
+interface ApiResponse<T> {
+    success: boolean;
+    message: string;
+    data: T;
+    errorCode?: string;
+}
+
+// 타입 정의
+export interface BypassParamDto {
+    id?: number;
+    paramName: string;
+    paramType: string;    // STRING, INTEGER, LONG, BOOLEAN
+    paramIn: string;      // PATH, QUERY, BODY
+    required: boolean;
+    description: string;
+    sortOrder: number;
+}
+
+export interface BypassFieldDto {
+    id?: number;
+    fieldName: string;
+    jsonProperty: string | null;
+    fieldType: string;    // String, Integer, Long, Double, Boolean, LocalDateTime, List<Object>, Object
+    description: string;
+    sortOrder: number;
+}
+
+export interface BypassConfigRequest {
+    domainName: string;
+    displayName: string;
+    webclientBean: string;
+    externalPath: string;
+    httpMethod: string;
+    responseType: string;
+    description: string;
+    params: BypassParamDto[];
+    fields: BypassFieldDto[];
+}
+
+export interface BypassConfigResponse {
+    id: number;
+    domainName: string;
+    displayName: string;
+    webclientBean: string;
+    externalPath: string;
+    httpMethod: string;
+    responseType: string;
+    description: string;
+    generated: boolean;
+    generatedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+    params: BypassParamDto[];
+    fields: BypassFieldDto[];
+}
+
+export interface CodeGenerationResult {
+    controllerPath: string;
+    servicePath: string;
+    dtoPath: string;
+    message: string;
+}
+
+export interface WebClientBeanInfo {
+    name: string;
+    description: string;
+}
+
+// BASE URL
+const BASE = '/snp-api/api/bypass-config';
+
+// 헬퍼 함수 (batchApi.ts 패턴과 동일)
+async function fetchJson<T>(url: string): Promise<T> {
+    const res = await fetch(url);
+    if (!res.ok) throw new Error(`API Error: ${res.status} ${res.statusText}`);
+    return res.json();
+}
+
+async function postJson<T>(url: string, body?: unknown): Promise<T> {
+    const res = await fetch(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: body != null ? JSON.stringify(body) : undefined,
+    });
+    if (!res.ok) throw new Error(`API Error: ${res.status} ${res.statusText}`);
+    return res.json();
+}
+
+async function putJson<T>(url: string, body?: unknown): Promise<T> {
+    const res = await fetch(url, {
+        method: 'PUT',
+        headers: { 'Content-Type': 'application/json' },
+        body: body != null ? JSON.stringify(body) : undefined,
+    });
+    if (!res.ok) throw new Error(`API Error: ${res.status} ${res.statusText}`);
+    return res.json();
+}
+
+async function deleteJson<T>(url: string): Promise<T> {
+    const res = await fetch(url, { method: 'DELETE' });
+    if (!res.ok) throw new Error(`API Error: ${res.status} ${res.statusText}`);
+    return res.json();
+}
+
+export const bypassApi = {
+    getConfigs: () =>
+        fetchJson<ApiResponse<BypassConfigResponse[]>>(BASE),
+    getConfig: (id: number) =>
+        fetchJson<ApiResponse<BypassConfigResponse>>(`${BASE}/${id}`),
+    createConfig: (data: BypassConfigRequest) =>
+        postJson<ApiResponse<BypassConfigResponse>>(BASE, data),
+    updateConfig: (id: number, data: BypassConfigRequest) =>
+        putJson<ApiResponse<BypassConfigResponse>>(`${BASE}/${id}`, data),
+    deleteConfig: (id: number) =>
+        deleteJson<ApiResponse<void>>(`${BASE}/${id}`),
+    generateCode: (id: number, force = false) =>
+        postJson<ApiResponse<CodeGenerationResult>>(`${BASE}/${id}/generate?force=${force}`),
+    parseJson: (jsonSample: string) =>
+        postJson<ApiResponse<BypassFieldDto[]>>(`${BASE}/parse-json`, jsonSample),
+    getWebclientBeans: () =>
+        fetchJson<ApiResponse<WebClientBeanInfo[]>>(`${BASE}/webclient-beans`),
+};
diff --git a/frontend/src/components/Navbar.tsx b/frontend/src/components/Navbar.tsx
index fa9be55..b04af2d 100644
--- a/frontend/src/components/Navbar.tsx
+++ b/frontend/src/components/Navbar.tsx
@@ -8,6 +8,7 @@ const navItems = [
   { path: '/jobs', label: '작업', icon: '⚙️' },
   { path: '/schedules', label: '스케줄', icon: '🕐' },
   { path: '/schedule-timeline', label: '타임라인', icon: '📅' },
+  { path: '/bypass-config', label: 'Bypass API', icon: '🔗' },
 ];
 
 export default function Navbar() {
diff --git a/frontend/src/components/bypass/BypassConfigModal.tsx b/frontend/src/components/bypass/BypassConfigModal.tsx
new file mode 100644
index 0000000..edec66b
--- /dev/null
+++ b/frontend/src/components/bypass/BypassConfigModal.tsx
@@ -0,0 +1,239 @@
+import { useState, useEffect } from 'react';
+import type {
+    BypassConfigRequest,
+    BypassConfigResponse,
+    BypassParamDto,
+    BypassFieldDto,
+    WebClientBeanInfo,
+} from '../../api/bypassApi';
+import BypassStepBasic from './BypassStepBasic';
+import BypassStepParams from './BypassStepParams';
+import BypassStepFields from './BypassStepFields';
+
+interface BypassConfigModalProps {
+    open: boolean;
+    editConfig: BypassConfigResponse | null;
+    webclientBeans: WebClientBeanInfo[];
+    onSave: (data: BypassConfigRequest) => Promise<void>;
+    onClose: () => void;
+}
+
+type StepNumber = 1 | 2 | 3;
+
+const STEP_LABELS: Record<StepNumber, string> = {
+    1: '기본 정보',
+    2: '파라미터',
+    3: 'DTO 필드',
+};
+
+const DEFAULT_FORM: Omit<BypassConfigRequest, 'params' | 'fields'> = {
+    domainName: '',
+    displayName: '',
+    webclientBean: '',
+    externalPath: '',
+    httpMethod: 'GET',
+    responseType: 'LIST',
+    description: '',
+};
+
+export default function BypassConfigModal({
+    open,
+    editConfig,
+    webclientBeans,
+    onSave,
+    onClose,
+}: BypassConfigModalProps) {
+    const [step, setStep] = useState<StepNumber>(1);
+    const [domainName, setDomainName] = useState('');
+    const [displayName, setDisplayName] = useState('');
+    const [webclientBean, setWebclientBean] = useState('');
+    const [externalPath, setExternalPath] = useState('');
+    const [httpMethod, setHttpMethod] = useState('GET');
+    const [responseType, setResponseType] = useState('LIST');
+    const [description, setDescription] = useState('');
+    const [params, setParams] = useState<BypassParamDto[]>([]);
+    const [fields, setFields] = useState<BypassFieldDto[]>([]);
+    const [saving, setSaving] = useState(false);
+
+    useEffect(() => {
+        if (!open) return;
+        setStep(1);
+        if (editConfig) {
+            setDomainName(editConfig.domainName);
+            setDisplayName(editConfig.displayName);
+            setWebclientBean(editConfig.webclientBean);
+            setExternalPath(editConfig.externalPath);
+            setHttpMethod(editConfig.httpMethod);
+            setResponseType(editConfig.responseType);
+            setDescription(editConfig.description);
+            setParams(editConfig.params);
+            setFields(editConfig.fields);
+        } else {
+            setDomainName(DEFAULT_FORM.domainName);
+            setDisplayName(DEFAULT_FORM.displayName);
+            setWebclientBean(DEFAULT_FORM.webclientBean);
+            setExternalPath(DEFAULT_FORM.externalPath);
+            setHttpMethod(DEFAULT_FORM.httpMethod);
+            setResponseType(DEFAULT_FORM.responseType);
+            setDescription(DEFAULT_FORM.description);
+            setParams([]);
+            setFields([]);
+        }
+    }, [open, editConfig]);
+
+    if (!open) return null;
+
+    const handleBasicChange = (field: string, value: string) => {
+        switch (field) {
+            case 'domainName': setDomainName(value); break;
+            case 'displayName': setDisplayName(value); break;
+            case 'webclientBean': setWebclientBean(value); break;
+            case 'externalPath': setExternalPath(value); break;
+            case 'httpMethod': setHttpMethod(value); break;
+            case 'responseType': setResponseType(value); break;
+            case 'description': setDescription(value); break;
+        }
+    };
+
+    const handleSave = async () => {
+        setSaving(true);
+        try {
+            await onSave({
+                domainName,
+                displayName,
+                webclientBean,
+                externalPath,
+                httpMethod,
+                responseType,
+                description,
+                params,
+                fields,
+            });
+            onClose();
+        } finally {
+            setSaving(false);
+        }
+    };
+
+    const steps: StepNumber[] = [1, 2, 3];
+
+    return (
+        <div
+            className="fixed inset-0 z-50 flex items-center justify-center bg-wing-overlay"
+            onClick={onClose}
+        >
+            <div
+                className="bg-wing-surface rounded-xl shadow-2xl w-full max-w-3xl mx-4 flex flex-col max-h-[90vh]"
+                onClick={(e) => e.stopPropagation()}
+            >
+                {/* 헤더 */}
+                <div className="px-6 pt-6 pb-4 border-b border-wing-border shrink-0">
+                    <h3 className="text-lg font-semibold text-wing-text mb-4">
+                        {editConfig ? 'Bypass API 수정' : 'Bypass API 등록'}
+                    </h3>
+
+                    {/* 스텝 인디케이터 */}
+                    <div className="flex items-center gap-0">
+                        {steps.map((s, idx) => (
+                            <div key={s} className="flex items-center">
+                                <div className="flex items-center gap-2">
+                                    <span
+                                        className={[
+                                            'w-7 h-7 rounded-full flex items-center justify-center text-sm font-semibold transition-colors',
+                                            step === s
+                                                ? 'bg-wing-accent text-white'
+                                                : step > s
+                                                ? 'bg-wing-accent/30 text-wing-accent'
+                                                : 'bg-wing-card text-wing-muted border border-wing-border',
+                                        ].join(' ')}
+                                    >
+                                        {s}
+                                    </span>
+                                    <span
+                                        className={[
+                                            'text-sm font-medium',
+                                            step === s ? 'text-wing-text' : 'text-wing-muted',
+                                        ].join(' ')}
+                                    >
+                                        {STEP_LABELS[s]}
+                                    </span>
+                                </div>
+                                {idx < steps.length - 1 && (
+                                    <div className="w-8 h-px bg-wing-border mx-3" />
+                                )}
+                            </div>
+                        ))}
+                    </div>
+                </div>
+
+                {/* 본문 */}
+                <div className="px-6 py-5 overflow-y-auto flex-1">
+                    {step === 1 && (
+                        <BypassStepBasic
+                            domainName={domainName}
+                            displayName={displayName}
+                            webclientBean={webclientBean}
+                            externalPath={externalPath}
+                            httpMethod={httpMethod}
+                            responseType={responseType}
+                            description={description}
+                            webclientBeans={webclientBeans}
+                            isEdit={editConfig !== null}
+                            onChange={handleBasicChange}
+                        />
+                    )}
+                    {step === 2 && (
+                        <BypassStepParams params={params} onChange={setParams} />
+                    )}
+                    {step === 3 && (
+                        <BypassStepFields fields={fields} onChange={setFields} />
+                    )}
+                </div>
+
+                {/* 하단 버튼 */}
+                <div className="px-6 py-4 border-t border-wing-border flex justify-between shrink-0">
+                    <div>
+                        {step > 1 && (
+                            <button
+                                type="button"
+                                onClick={() => setStep((s) => (s - 1) as StepNumber)}
+                                className="px-4 py-2 text-sm font-medium text-wing-text bg-wing-card rounded-lg hover:bg-wing-hover transition-colors"
+                            >
+                                ← 이전
+                            </button>
+                        )}
+                    </div>
+                    <div className="flex gap-3">
+                        {step === 1 && (
+                            <button
+                                type="button"
+                                onClick={onClose}
+                                className="px-4 py-2 text-sm font-medium text-wing-text bg-wing-card rounded-lg hover:bg-wing-hover transition-colors"
+                            >
+                                취소
+                            </button>
+                        )}
+                        {step < 3 ? (
+                            <button
+                                type="button"
+                                onClick={() => setStep((s) => (s + 1) as StepNumber)}
+                                className="px-4 py-2 text-sm font-medium text-white bg-wing-accent hover:bg-wing-accent/80 rounded-lg transition-colors"
+                            >
+                                다음 →
+                            </button>
+                        ) : (
+                            <button
+                                type="button"
+                                onClick={handleSave}
+                                disabled={saving}
+                                className="px-4 py-2 text-sm font-medium text-white bg-wing-accent hover:bg-wing-accent/80 rounded-lg transition-colors disabled:opacity-60 disabled:cursor-not-allowed"
+                            >
+                                {saving ? '저장 중...' : '저장'}
+                            </button>
+                        )}
+                    </div>
+                </div>
+            </div>
+        </div>
+    );
+}
diff --git a/frontend/src/components/bypass/BypassStepBasic.tsx b/frontend/src/components/bypass/BypassStepBasic.tsx
new file mode 100644
index 0000000..969450f
--- /dev/null
+++ b/frontend/src/components/bypass/BypassStepBasic.tsx
@@ -0,0 +1,168 @@
+import type { WebClientBeanInfo } from '../../api/bypassApi';
+
+interface BypassStepBasicProps {
+    domainName: string;
+    displayName: string;
+    webclientBean: string;
+    externalPath: string;
+    httpMethod: string;
+    responseType: string;
+    description: string;
+    webclientBeans: WebClientBeanInfo[];
+    isEdit: boolean;
+    onChange: (field: string, value: string) => void;
+}
+
+export default function BypassStepBasic({
+    domainName,
+    displayName,
+    webclientBean,
+    externalPath,
+    httpMethod,
+    responseType,
+    description,
+    webclientBeans,
+    isEdit,
+    onChange,
+}: BypassStepBasicProps) {
+    return (
+        <div className="space-y-5">
+            <p className="text-sm text-wing-muted">
+                BYPASS API의 기본 정보를 입력하세요. 도메인명을 기반으로 코드가 생성됩니다.
+            </p>
+
+            <div className="grid grid-cols-1 md:grid-cols-2 gap-4">
+                {/* 도메인명 */}
+                <div>
+                    <label className="block text-sm font-medium text-wing-text mb-1">
+                        도메인명 <span className="text-red-500">*</span>
+                    </label>
+                    <input
+                        type="text"
+                        value={domainName}
+                        onChange={(e) => onChange('domainName', e.target.value)}
+                        disabled={isEdit}
+                        placeholder="예: riskByImo"
+                        pattern="[a-zA-Z][a-zA-Z0-9]*"
+                        className={[
+                            'w-full px-3 py-2 text-sm rounded-lg border',
+                            'border-wing-border bg-wing-card text-wing-text',
+                            'placeholder:text-wing-muted focus:outline-none focus:ring-2 focus:ring-wing-accent/50',
+                            isEdit ? 'opacity-50 cursor-not-allowed' : '',
+                        ].join(' ')}
+                    />
+                    <p className="mt-1 text-xs text-wing-muted">영문 소문자/숫자 조합 (수정 불가)</p>
+                </div>
+
+                {/* 표시명 */}
+                <div>
+                    <label className="block text-sm font-medium text-wing-text mb-1">
+                        표시명 <span className="text-red-500">*</span>
+                    </label>
+                    <input
+                        type="text"
+                        value={displayName}
+                        onChange={(e) => onChange('displayName', e.target.value)}
+                        placeholder="예: IMO 기반 리스크 조회"
+                        className="w-full px-3 py-2 text-sm rounded-lg border border-wing-border bg-wing-card text-wing-text placeholder:text-wing-muted focus:outline-none focus:ring-2 focus:ring-wing-accent/50"
+                    />
+                </div>
+
+                {/* WebClient */}
+                <div>
+                    <label className="block text-sm font-medium text-wing-text mb-1">
+                        WebClient Bean <span className="text-red-500">*</span>
+                    </label>
+                    <select
+                        value={webclientBean}
+                        onChange={(e) => onChange('webclientBean', e.target.value)}
+                        className="w-full px-3 py-2 text-sm rounded-lg border border-wing-border bg-wing-card text-wing-text focus:outline-none focus:ring-2 focus:ring-wing-accent/50"
+                    >
+                        <option value="">선택하세요</option>
+                        {webclientBeans.map((bean) => (
+                            <option key={bean.name} value={bean.name}>
+                                {bean.name}{bean.description ? ` — ${bean.description}` : ''}
+                            </option>
+                        ))}
+                    </select>
+                </div>
+
+                {/* 외부 API 경로 */}
+                <div>
+                    <label className="block text-sm font-medium text-wing-text mb-1">
+                        외부 API 경로 <span className="text-red-500">*</span>
+                    </label>
+                    <input
+                        type="text"
+                        value={externalPath}
+                        onChange={(e) => onChange('externalPath', e.target.value)}
+                        placeholder="/RiskAndCompliance/RisksByImos"
+                        className="w-full px-3 py-2 text-sm rounded-lg border border-wing-border bg-wing-card text-wing-text placeholder:text-wing-muted focus:outline-none focus:ring-2 focus:ring-wing-accent/50"
+                    />
+                </div>
+
+                {/* HTTP 메서드 */}
+                <div>
+                    <label className="block text-sm font-medium text-wing-text mb-1">
+                        HTTP 메서드 <span className="text-red-500">*</span>
+                    </label>
+                    <div className="flex gap-2">
+                        {['GET', 'POST'].map((method) => (
+                            <button
+                                key={method}
+                                type="button"
+                                onClick={() => onChange('httpMethod', method)}
+                                className={[
+                                    'flex-1 py-2 text-sm font-medium rounded-lg border transition-colors',
+                                    httpMethod === method
+                                        ? 'bg-wing-accent text-white border-wing-accent'
+                                        : 'bg-wing-card text-wing-muted border-wing-border hover:bg-wing-hover',
+                                ].join(' ')}
+                            >
+                                {method}
+                            </button>
+                        ))}
+                    </div>
+                </div>
+
+                {/* 응답 타입 */}
+                <div>
+                    <label className="block text-sm font-medium text-wing-text mb-1">
+                        응답 타입 <span className="text-red-500">*</span>
+                    </label>
+                    <div className="flex gap-2">
+                        {['LIST', 'OBJECT'].map((type) => (
+                            <button
+                                key={type}
+                                type="button"
+                                onClick={() => onChange('responseType', type)}
+                                className={[
+                                    'flex-1 py-2 text-sm font-medium rounded-lg border transition-colors',
+                                    responseType === type
+                                        ? 'bg-wing-accent text-white border-wing-accent'
+                                        : 'bg-wing-card text-wing-muted border-wing-border hover:bg-wing-hover',
+                                ].join(' ')}
+                            >
+                                {type}
+                            </button>
+                        ))}
+                    </div>
+                </div>
+
+                {/* 설명 */}
+                <div className="md:col-span-2">
+                    <label className="block text-sm font-medium text-wing-text mb-1">
+                        설명
+                    </label>
+                    <textarea
+                        value={description}
+                        onChange={(e) => onChange('description', e.target.value)}
+                        rows={3}
+                        placeholder="이 API에 대한 설명을 입력하세요"
+                        className="w-full px-3 py-2 text-sm rounded-lg border border-wing-border bg-wing-card text-wing-text placeholder:text-wing-muted focus:outline-none focus:ring-2 focus:ring-wing-accent/50 resize-none"
+                    />
+                </div>
+            </div>
+        </div>
+    );
+}
diff --git a/frontend/src/components/bypass/BypassStepFields.tsx b/frontend/src/components/bypass/BypassStepFields.tsx
new file mode 100644
index 0000000..db4b6d9
--- /dev/null
+++ b/frontend/src/components/bypass/BypassStepFields.tsx
@@ -0,0 +1,233 @@
+import { useState } from 'react';
+import type { BypassFieldDto } from '../../api/bypassApi';
+import { bypassApi } from '../../api/bypassApi';
+
+interface BypassStepFieldsProps {
+    fields: BypassFieldDto[];
+    onChange: (fields: BypassFieldDto[]) => void;
+}
+
+type ActiveTab = 'manual' | 'json';
+
+const FIELD_TYPES = ['String', 'Integer', 'Long', 'Double', 'Boolean', 'LocalDateTime', 'List<Object>', 'Object'];
+
+function createEmptyField(sortOrder: number): BypassFieldDto {
+    return {
+        fieldName: '',
+        jsonProperty: null,
+        fieldType: 'String',
+        description: '',
+        sortOrder,
+    };
+}
+
+export default function BypassStepFields({ fields, onChange }: BypassStepFieldsProps) {
+    const [activeTab, setActiveTab] = useState<ActiveTab>('manual');
+    const [jsonSample, setJsonSample] = useState('');
+    const [parsing, setParsing] = useState(false);
+    const [parseError, setParseError] = useState<string | null>(null);
+
+    const handleAdd = () => {
+        onChange([...fields, createEmptyField(fields.length)]);
+    };
+
+    const handleDelete = (index: number) => {
+        const updated = fields
+            .filter((_, i) => i !== index)
+            .map((f, i) => ({ ...f, sortOrder: i }));
+        onChange(updated);
+    };
+
+    const handleChange = (index: number, field: keyof BypassFieldDto, value: string | null) => {
+        const updated = fields.map((f, i) =>
+            i === index ? { ...f, [field]: value } : f,
+        );
+        onChange(updated);
+    };
+
+    const handleParseJson = async () => {
+        if (!jsonSample.trim()) {
+            setParseError('JSON 샘플을 입력하세요.');
+            return;
+        }
+        setParseError(null);
+        setParsing(true);
+        try {
+            const result = await bypassApi.parseJson(jsonSample);
+            if (result.success && result.data) {
+                onChange(result.data);
+                setActiveTab('manual');
+            } else {
+                setParseError(result.message ?? 'JSON 파싱에 실패했습니다.');
+            }
+        } catch (err) {
+            setParseError(err instanceof Error ? err.message : 'JSON 파싱 중 오류가 발생했습니다.');
+        } finally {
+            setParsing(false);
+        }
+    };
+
+    return (
+        <div className="space-y-4">
+            <p className="text-sm text-wing-muted">
+                응답 DTO에 포함할 필드를 정의하세요. JSON 샘플을 붙여넣어 자동 파싱할 수도 있습니다.
+            </p>
+
+            {/* 탭 */}
+            <div className="flex gap-1 border-b border-wing-border">
+                <button
+                    type="button"
+                    onClick={() => setActiveTab('manual')}
+                    className={[
+                        'px-4 py-2 text-sm font-medium border-b-2 -mb-px transition-colors',
+                        activeTab === 'manual'
+                            ? 'border-wing-accent text-wing-accent'
+                            : 'border-transparent text-wing-muted hover:text-wing-text',
+                    ].join(' ')}
+                >
+                    직접 입력
+                </button>
+                <button
+                    type="button"
+                    onClick={() => setActiveTab('json')}
+                    className={[
+                        'px-4 py-2 text-sm font-medium border-b-2 -mb-px transition-colors',
+                        activeTab === 'json'
+                            ? 'border-wing-accent text-wing-accent'
+                            : 'border-transparent text-wing-muted hover:text-wing-text',
+                    ].join(' ')}
+                >
+                    JSON 샘플
+                </button>
+            </div>
+
+            {/* 직접 입력 탭 */}
+            {activeTab === 'manual' && (
+                <div className="space-y-4">
+                    {fields.length === 0 ? (
+                        <div className="py-10 text-center text-sm text-wing-muted border border-dashed border-wing-border rounded-lg bg-wing-card">
+                            DTO 필드가 없습니다. 추가 버튼을 클릭하거나 JSON 샘플로 자동 파싱하세요.
+                        </div>
+                    ) : (
+                        <div className="overflow-x-auto">
+                            <table className="w-full text-sm">
+                                <thead>
+                                    <tr className="border-b border-wing-border">
+                                        <th className="pb-2 text-left font-medium text-wing-muted pr-3 min-w-[130px]">필드명</th>
+                                        <th className="pb-2 text-left font-medium text-wing-muted pr-3 min-w-[130px]">JSON Property</th>
+                                        <th className="pb-2 text-left font-medium text-wing-muted pr-3 min-w-[150px]">타입</th>
+                                        <th className="pb-2 text-left font-medium text-wing-muted pr-3">설명</th>
+                                        <th className="pb-2 w-10"></th>
+                                    </tr>
+                                </thead>
+                                <tbody className="divide-y divide-wing-border">
+                                    {fields.map((field, index) => (
+                                        <tr key={index} className="group">
+                                            <td className="py-2 pr-3">
+                                                <input
+                                                    type="text"
+                                                    value={field.fieldName}
+                                                    onChange={(e) => handleChange(index, 'fieldName', e.target.value)}
+                                                    placeholder="fieldName"
+                                                    className="w-full px-2 py-1.5 text-sm rounded border border-wing-border bg-wing-surface text-wing-text placeholder:text-wing-muted focus:outline-none focus:ring-1 focus:ring-wing-accent/50"
+                                                />
+                                            </td>
+                                            <td className="py-2 pr-3">
+                                                <input
+                                                    type="text"
+                                                    value={field.jsonProperty ?? ''}
+                                                    onChange={(e) => handleChange(index, 'jsonProperty', e.target.value || null)}
+                                                    placeholder="원본과 같으면 비워두세요"
+                                                    className="w-full px-2 py-1.5 text-sm rounded border border-wing-border bg-wing-surface text-wing-text placeholder:text-wing-muted focus:outline-none focus:ring-1 focus:ring-wing-accent/50"
+                                                />
+                                            </td>
+                                            <td className="py-2 pr-3">
+                                                <select
+                                                    value={field.fieldType}
+                                                    onChange={(e) => handleChange(index, 'fieldType', e.target.value)}
+                                                    className="w-full px-2 py-1.5 text-sm rounded border border-wing-border bg-wing-surface text-wing-text focus:outline-none focus:ring-1 focus:ring-wing-accent/50"
+                                                >
+                                                    {FIELD_TYPES.map((t) => (
+                                                        <option key={t} value={t}>{t}</option>
+                                                    ))}
+                                                </select>
+                                            </td>
+                                            <td className="py-2 pr-3">
+                                                <input
+                                                    type="text"
+                                                    value={field.description}
+                                                    onChange={(e) => handleChange(index, 'description', e.target.value)}
+                                                    placeholder="필드 설명"
+                                                    className="w-full px-2 py-1.5 text-sm rounded border border-wing-border bg-wing-surface text-wing-text placeholder:text-wing-muted focus:outline-none focus:ring-1 focus:ring-wing-accent/50"
+                                                />
+                                            </td>
+                                            <td className="py-2">
+                                                <button
+                                                    type="button"
+                                                    onClick={() => handleDelete(index)}
+                                                    className="p-1.5 text-wing-muted hover:text-red-500 hover:bg-red-50 rounded transition-colors"
+                                                    title="삭제"
+                                                >
+                                                    <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                                        <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M6 18L18 6M6 6l12 12" />
+                                                    </svg>
+                                                </button>
+                                            </td>
+                                        </tr>
+                                    ))}
+                                </tbody>
+                            </table>
+                        </div>
+                    )}
+
+                    <button
+                        type="button"
+                        onClick={handleAdd}
+                        className="flex items-center gap-1.5 px-3 py-2 text-sm font-medium text-wing-accent border border-wing-accent/30 rounded-lg hover:bg-wing-accent/10 transition-colors"
+                    >
+                        <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M12 4v16m8-8H4" />
+                        </svg>
+                        필드 추가
+                    </button>
+                </div>
+            )}
+
+            {/* JSON 샘플 탭 */}
+            {activeTab === 'json' && (
+                <div className="space-y-3">
+                    <p className="text-xs text-wing-muted">
+                        응답 JSON 샘플을 붙여넣으면 필드 구조를 자동으로 파싱합니다. 파싱 후 직접 입력 탭에서 수정할 수 있습니다.
+                    </p>
+                    <textarea
+                        value={jsonSample}
+                        onChange={(e) => {
+                            setJsonSample(e.target.value);
+                            setParseError(null);
+                        }}
+                        rows={10}
+                        placeholder={'{\n  "riskScore": 85,\n  "imoNumber": "1234567",\n  "vesselName": "EXAMPLE SHIP"\n}'}
+                        className="w-full px-3 py-2 text-sm font-mono rounded-lg border border-wing-border bg-wing-card text-wing-text placeholder:text-wing-muted focus:outline-none focus:ring-2 focus:ring-wing-accent/50 resize-none"
+                    />
+                    {parseError && (
+                        <p className="text-sm text-red-500">{parseError}</p>
+                    )}
+                    <button
+                        type="button"
+                        onClick={handleParseJson}
+                        disabled={parsing}
+                        className="flex items-center gap-2 px-4 py-2 text-sm font-medium text-white bg-wing-accent hover:bg-wing-accent/80 disabled:opacity-50 disabled:cursor-not-allowed rounded-lg transition-colors"
+                    >
+                        {parsing && (
+                            <svg className="w-4 h-4 animate-spin" fill="none" viewBox="0 0 24 24">
+                                <circle className="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" strokeWidth="4" />
+                                <path className="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8v8H4z" />
+                            </svg>
+                        )}
+                        {parsing ? '파싱 중...' : '파싱'}
+                    </button>
+                </div>
+            )}
+        </div>
+    );
+}
diff --git a/frontend/src/components/bypass/BypassStepParams.tsx b/frontend/src/components/bypass/BypassStepParams.tsx
new file mode 100644
index 0000000..6f0cf02
--- /dev/null
+++ b/frontend/src/components/bypass/BypassStepParams.tsx
@@ -0,0 +1,146 @@
+import type { BypassParamDto } from '../../api/bypassApi';
+
+interface BypassStepParamsProps {
+    params: BypassParamDto[];
+    onChange: (params: BypassParamDto[]) => void;
+}
+
+const PARAM_TYPES = ['STRING', 'INTEGER', 'LONG', 'BOOLEAN'];
+const PARAM_IN_OPTIONS = ['PATH', 'QUERY', 'BODY'];
+
+function createEmptyParam(sortOrder: number): BypassParamDto {
+    return {
+        paramName: '',
+        paramType: 'STRING',
+        paramIn: 'QUERY',
+        required: false,
+        description: '',
+        sortOrder,
+    };
+}
+
+export default function BypassStepParams({ params, onChange }: BypassStepParamsProps) {
+    const handleAdd = () => {
+        onChange([...params, createEmptyParam(params.length)]);
+    };
+
+    const handleDelete = (index: number) => {
+        const updated = params
+            .filter((_, i) => i !== index)
+            .map((p, i) => ({ ...p, sortOrder: i }));
+        onChange(updated);
+    };
+
+    const handleChange = (index: number, field: keyof BypassParamDto, value: string | boolean | number) => {
+        const updated = params.map((p, i) =>
+            i === index ? { ...p, [field]: value } : p,
+        );
+        onChange(updated);
+    };
+
+    return (
+        <div className="space-y-4">
+            <p className="text-sm text-wing-muted">
+                외부 API 호출에 필요한 파라미터를 정의하세요.
+            </p>
+
+            {params.length === 0 ? (
+                <div className="py-10 text-center text-sm text-wing-muted border border-dashed border-wing-border rounded-lg bg-wing-card">
+                    파라미터가 없습니다. 추가 버튼을 클릭하세요.
+                </div>
+            ) : (
+                <div className="overflow-x-auto">
+                    <table className="w-full text-sm">
+                        <thead>
+                            <tr className="border-b border-wing-border">
+                                <th className="pb-2 text-left font-medium text-wing-muted pr-3 min-w-[120px]">이름</th>
+                                <th className="pb-2 text-left font-medium text-wing-muted pr-3 min-w-[110px]">타입</th>
+                                <th className="pb-2 text-left font-medium text-wing-muted pr-3 min-w-[100px]">위치</th>
+                                <th className="pb-2 text-center font-medium text-wing-muted pr-3 w-14">필수</th>
+                                <th className="pb-2 text-left font-medium text-wing-muted pr-3">설명</th>
+                                <th className="pb-2 w-10"></th>
+                            </tr>
+                        </thead>
+                        <tbody className="divide-y divide-wing-border">
+                            {params.map((param, index) => (
+                                <tr key={index} className="group">
+                                    <td className="py-2 pr-3">
+                                        <input
+                                            type="text"
+                                            value={param.paramName}
+                                            onChange={(e) => handleChange(index, 'paramName', e.target.value)}
+                                            placeholder="paramName"
+                                            className="w-full px-2 py-1.5 text-sm rounded border border-wing-border bg-wing-surface text-wing-text placeholder:text-wing-muted focus:outline-none focus:ring-1 focus:ring-wing-accent/50"
+                                        />
+                                    </td>
+                                    <td className="py-2 pr-3">
+                                        <select
+                                            value={param.paramType}
+                                            onChange={(e) => handleChange(index, 'paramType', e.target.value)}
+                                            className="w-full px-2 py-1.5 text-sm rounded border border-wing-border bg-wing-surface text-wing-text focus:outline-none focus:ring-1 focus:ring-wing-accent/50"
+                                        >
+                                            {PARAM_TYPES.map((t) => (
+                                                <option key={t} value={t}>{t}</option>
+                                            ))}
+                                        </select>
+                                    </td>
+                                    <td className="py-2 pr-3">
+                                        <select
+                                            value={param.paramIn}
+                                            onChange={(e) => handleChange(index, 'paramIn', e.target.value)}
+                                            className="w-full px-2 py-1.5 text-sm rounded border border-wing-border bg-wing-surface text-wing-text focus:outline-none focus:ring-1 focus:ring-wing-accent/50"
+                                        >
+                                            {PARAM_IN_OPTIONS.map((o) => (
+                                                <option key={o} value={o}>{o}</option>
+                                            ))}
+                                        </select>
+                                    </td>
+                                    <td className="py-2 pr-3 text-center">
+                                        <input
+                                            type="checkbox"
+                                            checked={param.required}
+                                            onChange={(e) => handleChange(index, 'required', e.target.checked)}
+                                            className="w-4 h-4 rounded border-wing-border text-wing-accent focus:ring-wing-accent/50 cursor-pointer"
+                                        />
+                                    </td>
+                                    <td className="py-2 pr-3">
+                                        <input
+                                            type="text"
+                                            value={param.description}
+                                            onChange={(e) => handleChange(index, 'description', e.target.value)}
+                                            placeholder="파라미터 설명"
+                                            className="w-full px-2 py-1.5 text-sm rounded border border-wing-border bg-wing-surface text-wing-text placeholder:text-wing-muted focus:outline-none focus:ring-1 focus:ring-wing-accent/50"
+                                        />
+                                    </td>
+                                    <td className="py-2">
+                                        <button
+                                            type="button"
+                                            onClick={() => handleDelete(index)}
+                                            className="p-1.5 text-wing-muted hover:text-red-500 hover:bg-red-50 rounded transition-colors"
+                                            title="삭제"
+                                        >
+                                            <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                                <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M6 18L18 6M6 6l12 12" />
+                                            </svg>
+                                        </button>
+                                    </td>
+                                </tr>
+                            ))}
+                        </tbody>
+                    </table>
+                </div>
+            )}
+
+            <button
+                type="button"
+                onClick={handleAdd}
+                className="flex items-center gap-1.5 px-3 py-2 text-sm font-medium text-wing-accent border border-wing-accent/30 rounded-lg hover:bg-wing-accent/10 transition-colors"
+            >
+                <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M12 4v16m8-8H4" />
+                </svg>
+                파라미터 추가
+            </button>
+        </div>
+    );
+}
diff --git a/frontend/src/pages/BypassConfig.tsx b/frontend/src/pages/BypassConfig.tsx
new file mode 100644
index 0000000..4b9a8eb
--- /dev/null
+++ b/frontend/src/pages/BypassConfig.tsx
@@ -0,0 +1,279 @@
+import { useState, useEffect, useCallback } from 'react';
+import {
+    bypassApi,
+    type BypassConfigRequest,
+    type BypassConfigResponse,
+    type CodeGenerationResult,
+    type WebClientBeanInfo,
+} from '../api/bypassApi';
+import { useToastContext } from '../contexts/ToastContext';
+import BypassConfigModal from '../components/bypass/BypassConfigModal';
+import ConfirmModal from '../components/ConfirmModal';
+import InfoModal from '../components/InfoModal';
+import LoadingSpinner from '../components/LoadingSpinner';
+
+interface ConfirmAction {
+    type: 'delete' | 'generate';
+    config: BypassConfigResponse;
+}
+
+const HTTP_METHOD_COLORS: Record<string, string> = {
+    GET: 'bg-emerald-100 text-emerald-700',
+    POST: 'bg-blue-100 text-blue-700',
+    PUT: 'bg-amber-100 text-amber-700',
+    DELETE: 'bg-red-100 text-red-700',
+};
+
+export default function BypassConfig() {
+    const { showToast } = useToastContext();
+
+    const [configs, setConfigs] = useState<BypassConfigResponse[]>([]);
+    const [loading, setLoading] = useState(true);
+    const [webclientBeans, setWebclientBeans] = useState<WebClientBeanInfo[]>([]);
+
+    const [modalOpen, setModalOpen] = useState(false);
+    const [editConfig, setEditConfig] = useState<BypassConfigResponse | null>(null);
+
+    const [confirmAction, setConfirmAction] = useState<ConfirmAction | null>(null);
+    const [generationResult, setGenerationResult] = useState<CodeGenerationResult | null>(null);
+
+    const loadConfigs = useCallback(async () => {
+        try {
+            const res = await bypassApi.getConfigs();
+            setConfigs(res.data ?? []);
+        } catch (err) {
+            showToast('Bypass API 목록 조회 실패', 'error');
+            console.error(err);
+        } finally {
+            setLoading(false);
+        }
+    }, [showToast]);
+
+    useEffect(() => {
+        loadConfigs();
+        bypassApi.getWebclientBeans()
+            .then((res) => setWebclientBeans(res.data ?? []))
+            .catch((err) => console.error(err));
+    }, [loadConfigs]);
+
+    const handleCreate = () => {
+        setEditConfig(null);
+        setModalOpen(true);
+    };
+
+    const handleEdit = (config: BypassConfigResponse) => {
+        setEditConfig(config);
+        setModalOpen(true);
+    };
+
+    const handleSave = async (data: BypassConfigRequest) => {
+        if (editConfig) {
+            await bypassApi.updateConfig(editConfig.id, data);
+            showToast('Bypass API가 수정되었습니다.', 'success');
+        } else {
+            await bypassApi.createConfig(data);
+            showToast('Bypass API가 등록되었습니다.', 'success');
+        }
+        await loadConfigs();
+    };
+
+    const handleDeleteConfirm = async () => {
+        if (!confirmAction || confirmAction.type !== 'delete') return;
+        try {
+            await bypassApi.deleteConfig(confirmAction.config.id);
+            showToast('Bypass API가 삭제되었습니다.', 'success');
+            await loadConfigs();
+        } catch (err) {
+            showToast('삭제 실패', 'error');
+            console.error(err);
+        } finally {
+            setConfirmAction(null);
+        }
+    };
+
+    const handleGenerateConfirm = async () => {
+        if (!confirmAction || confirmAction.type !== 'generate') return;
+        const targetConfig = confirmAction.config;
+        setConfirmAction(null);
+        try {
+            const res = await bypassApi.generateCode(targetConfig.id, targetConfig.generated);
+            setGenerationResult(res.data);
+            showToast('코드가 생성되었습니다.', 'success');
+            await loadConfigs();
+        } catch (err) {
+            showToast('코드 생성 실패', 'error');
+            console.error(err);
+        }
+    };
+
+    if (loading) return <LoadingSpinner />;
+
+    return (
+        <div className="space-y-6">
+            {/* 헤더 */}
+            <div className="flex items-center justify-between">
+                <div>
+                    <h1 className="text-2xl font-bold text-wing-text">Bypass API 관리</h1>
+                    <p className="mt-1 text-sm text-wing-muted">
+                        외부 Maritime API를 직접 프록시하는 Bypass API를 등록하고 코드를 생성합니다.
+                    </p>
+                </div>
+                <button
+                    type="button"
+                    onClick={handleCreate}
+                    className="px-4 py-2 text-sm font-medium text-white bg-wing-accent hover:bg-wing-accent/80 rounded-lg transition-colors"
+                >
+                    + 새 API 등록
+                </button>
+            </div>
+
+            {/* 카드 그리드 */}
+            {configs.length === 0 ? (
+                <div className="py-16 text-center text-wing-muted border border-dashed border-wing-border rounded-xl bg-wing-card">
+                    <p className="text-base font-medium mb-1">등록된 BYPASS API가 없습니다.</p>
+                    <p className="text-sm">위 버튼을 눌러 새 API를 등록하세요.</p>
+                </div>
+            ) : (
+                <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4">
+                    {configs.map((config) => (
+                        <div
+                            key={config.id}
+                            className="bg-wing-card border border-wing-border rounded-xl p-5 flex flex-col gap-3 hover:border-wing-accent/40 transition-colors"
+                        >
+                            {/* 카드 헤더 */}
+                            <div className="flex items-start justify-between gap-2">
+                                <div className="min-w-0">
+                                    <p className="text-sm font-semibold text-wing-text truncate">{config.displayName}</p>
+                                    <p className="text-xs text-wing-muted font-mono mt-0.5">{config.domainName}</p>
+                                </div>
+                                <span
+                                    className={[
+                                        'shrink-0 px-2 py-0.5 text-xs font-semibold rounded-full',
+                                        config.generated
+                                            ? 'bg-emerald-100 text-emerald-700'
+                                            : 'bg-wing-card text-wing-muted border border-wing-border',
+                                    ].join(' ')}
+                                >
+                                    {config.generated ? '생성 완료' : '미생성'}
+                                </span>
+                            </div>
+
+                            {/* 카드 정보 */}
+                            <div className="space-y-1.5">
+                                <div className="flex items-center gap-2">
+                                    <span
+                                        className={[
+                                            'px-1.5 py-0.5 text-xs font-bold rounded',
+                                            HTTP_METHOD_COLORS[config.httpMethod] ?? 'bg-wing-card text-wing-muted',
+                                        ].join(' ')}
+                                    >
+                                        {config.httpMethod}
+                                    </span>
+                                    <span className="text-xs text-wing-muted font-mono truncate">
+                                        {config.externalPath}
+                                    </span>
+                                </div>
+                                <p className="text-xs text-wing-muted">
+                                    <span className="font-medium text-wing-text">WebClient:</span>{' '}
+                                    {config.webclientBean}
+                                </p>
+                                {config.description && (
+                                    <p className="text-xs text-wing-muted line-clamp-2">{config.description}</p>
+                                )}
+                            </div>
+
+                            {/* 카드 액션 */}
+                            <div className="flex gap-2 pt-1 border-t border-wing-border mt-auto">
+                                <button
+                                    type="button"
+                                    onClick={() => handleEdit(config)}
+                                    className="flex-1 py-1.5 text-xs font-medium text-wing-text bg-wing-surface hover:bg-wing-hover border border-wing-border rounded-lg transition-colors"
+                                >
+                                    수정
+                                </button>
+                                <button
+                                    type="button"
+                                    onClick={() => setConfirmAction({ type: 'generate', config })}
+                                    className="flex-1 py-1.5 text-xs font-medium text-white bg-wing-accent hover:bg-wing-accent/80 rounded-lg transition-colors"
+                                >
+                                    {config.generated ? '재생성' : '코드 생성'}
+                                </button>
+                                <button
+                                    type="button"
+                                    onClick={() => setConfirmAction({ type: 'delete', config })}
+                                    className="py-1.5 px-3 text-xs font-medium text-red-500 hover:bg-red-50 border border-red-200 rounded-lg transition-colors"
+                                >
+                                    삭제
+                                </button>
+                            </div>
+                        </div>
+                    ))}
+                </div>
+            )}
+
+            {/* 등록/수정 모달 */}
+            <BypassConfigModal
+                open={modalOpen}
+                editConfig={editConfig}
+                webclientBeans={webclientBeans}
+                onSave={handleSave}
+                onClose={() => setModalOpen(false)}
+            />
+
+            {/* 삭제 확인 모달 */}
+            <ConfirmModal
+                open={confirmAction?.type === 'delete'}
+                title="삭제 확인"
+                message={`"${confirmAction?.config.displayName}"을(를) 정말 삭제하시겠습니까?\n삭제된 데이터는 복구할 수 없습니다.`}
+                confirmLabel="삭제"
+                confirmColor="bg-red-500 hover:bg-red-600"
+                onConfirm={handleDeleteConfirm}
+                onCancel={() => setConfirmAction(null)}
+            />
+
+            {/* 코드 생성 확인 모달 */}
+            <ConfirmModal
+                open={confirmAction?.type === 'generate'}
+                title={confirmAction?.config.generated ? '코드 재생성 확인' : '코드 생성 확인'}
+                message={
+                    confirmAction?.config.generated
+                        ? `"${confirmAction?.config.displayName}" 코드를 재생성합니다.\n기존 생성된 파일이 덮어씌워집니다. 계속하시겠습니까?`
+                        : `"${confirmAction?.config.displayName}" 코드를 생성합니다.\n계속하시겠습니까?`
+                }
+                confirmLabel={confirmAction?.config.generated ? '재생성' : '생성'}
+                onConfirm={handleGenerateConfirm}
+                onCancel={() => setConfirmAction(null)}
+            />
+
+            {/* 코드 생성 결과 모달 */}
+            <InfoModal
+                open={generationResult !== null}
+                title="코드 생성 완료"
+                onClose={() => setGenerationResult(null)}
+            >
+                {generationResult && (
+                    <div className="space-y-3">
+                        <p className="text-sm text-wing-text">{generationResult.message}</p>
+                        <div className="bg-wing-card rounded-lg p-3 space-y-2">
+                            <p className="text-xs font-semibold text-wing-text mb-1">생성된 파일</p>
+                            {[
+                                { label: 'Controller', path: generationResult.controllerPath },
+                                { label: 'Service', path: generationResult.servicePath },
+                                { label: 'DTO', path: generationResult.dtoPath },
+                            ].map(({ label, path }) => (
+                                <div key={label} className="flex gap-2 text-xs">
+                                    <span className="w-20 font-medium text-wing-accent shrink-0">{label}</span>
+                                    <span className="font-mono text-wing-muted break-all">{path}</span>
+                                </div>
+                            ))}
+                        </div>
+                        <div className="flex items-start gap-2 bg-amber-50 text-amber-700 rounded-lg p-3 text-xs">
+                            <span className="shrink-0">⚠</span>
+                            <span>서버를 재시작하면 새 API가 활성화됩니다.</span>
+                        </div>
+                    </div>
+                )}
+            </InfoModal>
+        </div>
+    );
+}
diff --git a/src/main/java/com/snp/batch/common/web/controller/BaseBypassController.java b/src/main/java/com/snp/batch/common/web/controller/BaseBypassController.java
new file mode 100644
index 0000000..7563d2e
--- /dev/null
+++ b/src/main/java/com/snp/batch/common/web/controller/BaseBypassController.java
@@ -0,0 +1,28 @@
+package com.snp.batch.common.web.controller;
+
+import com.snp.batch.common.web.ApiResponse;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.reactive.function.client.WebClientResponseException;
+
+import java.util.function.Supplier;
+
+@Slf4j
+public abstract class BaseBypassController {
+
+    protected <T> ResponseEntity<ApiResponse<T>> execute(Supplier<T> action) {
+        try {
+            T result = action.get();
+            return ResponseEntity.ok(ApiResponse.success(result));
+        } catch (WebClientResponseException e) {
+            log.error("외부 API 호출 실패 - status: {}, body: {}",
+                    e.getStatusCode(), e.getResponseBodyAsString());
+            return ResponseEntity.status(e.getStatusCode())
+                    .body(ApiResponse.error("외부 API 호출 실패: " + e.getMessage()));
+        } catch (Exception e) {
+            log.error("API 처리 중 오류", e);
+            return ResponseEntity.internalServerError()
+                    .body(ApiResponse.error("처리 실패: " + e.getMessage()));
+        }
+    }
+}
diff --git a/src/main/java/com/snp/batch/common/web/service/BaseBypassService.java b/src/main/java/com/snp/batch/common/web/service/BaseBypassService.java
new file mode 100644
index 0000000..40fab88
--- /dev/null
+++ b/src/main/java/com/snp/batch/common/web/service/BaseBypassService.java
@@ -0,0 +1,101 @@
+package com.snp.batch.common.web.service;
+
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.core.ParameterizedTypeReference;
+import org.springframework.web.reactive.function.BodyInserters;
+import org.springframework.web.reactive.function.client.WebClient;
+import org.springframework.web.util.UriBuilder;
+
+import java.net.URI;
+import java.util.List;
+import java.util.function.Function;
+
+@Slf4j
+public abstract class BaseBypassService<T> {
+
+    private final WebClient webClient;
+    private final String apiPath;
+    private final String displayName;
+    private final ParameterizedTypeReference<List<T>> listTypeRef;
+    private final ParameterizedTypeReference<T> singleTypeRef;
+
+    protected BaseBypassService(WebClient webClient, String apiPath, String displayName,
+                                 ParameterizedTypeReference<List<T>> listTypeRef,
+                                 ParameterizedTypeReference<T> singleTypeRef) {
+        this.webClient = webClient;
+        this.apiPath = apiPath;
+        this.displayName = displayName;
+        this.listTypeRef = listTypeRef;
+        this.singleTypeRef = singleTypeRef;
+    }
+
+    protected List<T> fetchGetList(Function<UriBuilder, URI> uriFunction) {
+        log.info("{} API GET 호출", displayName);
+        List<T> response = webClient.get()
+                .uri(uriFunction)
+                .retrieve()
+                .bodyToMono(listTypeRef)
+                .block();
+        if (response == null || response.isEmpty()) {
+            log.warn("{} API 응답 없음", displayName);
+            return List.of();
+        }
+        log.info("{} API 응답 완료 - 건수: {}", displayName, response.size());
+        return response;
+    }
+
+    protected T fetchGetOne(Function<UriBuilder, URI> uriFunction) {
+        log.info("{} API GET 호출 (단건)", displayName);
+        T response = webClient.get()
+                .uri(uriFunction)
+                .retrieve()
+                .bodyToMono(singleTypeRef)
+                .block();
+        if (response == null) {
+            log.warn("{} API 응답 없음", displayName);
+            return null;
+        }
+        log.info("{} API 응답 완료 (단건)", displayName);
+        return response;
+    }
+
+    protected List<T> fetchPostList(Object body, Function<UriBuilder, URI> uriFunction) {
+        log.info("{} API POST 호출", displayName);
+        List<T> response = webClient.post()
+                .uri(uriFunction)
+                .body(BodyInserters.fromValue(body))
+                .retrieve()
+                .bodyToMono(listTypeRef)
+                .block();
+        if (response == null || response.isEmpty()) {
+            log.warn("{} API 응답 없음", displayName);
+            return List.of();
+        }
+        log.info("{} API 응답 완료 - 건수: {}", displayName, response.size());
+        return response;
+    }
+
+    protected T fetchPostOne(Object body, Function<UriBuilder, URI> uriFunction) {
+        log.info("{} API POST 호출 (단건)", displayName);
+        T response = webClient.post()
+                .uri(uriFunction)
+                .body(BodyInserters.fromValue(body))
+                .retrieve()
+                .bodyToMono(singleTypeRef)
+                .block();
+        if (response == null) {
+            log.warn("{} API 응답 없음", displayName);
+            return null;
+        }
+        log.info("{} API 응답 완료 (단건)", displayName);
+        return response;
+    }
+
+    protected String getApiPath() {
+        return apiPath;
+    }
+
+    protected String getDisplayName() {
+        return displayName;
+    }
+}
diff --git a/src/main/java/com/snp/batch/global/controller/BypassConfigController.java b/src/main/java/com/snp/batch/global/controller/BypassConfigController.java
new file mode 100644
index 0000000..9ff79aa
--- /dev/null
+++ b/src/main/java/com/snp/batch/global/controller/BypassConfigController.java
@@ -0,0 +1,133 @@
+package com.snp.batch.global.controller;
+
+import com.snp.batch.common.web.ApiResponse;
+import com.snp.batch.global.dto.BypassConfigRequest;
+import com.snp.batch.global.dto.BypassConfigResponse;
+import com.snp.batch.global.dto.BypassFieldDto;
+import com.snp.batch.global.dto.CodeGenerationResult;
+import com.snp.batch.global.model.BypassApiConfig;
+import com.snp.batch.global.repository.BypassApiConfigRepository;
+import com.snp.batch.service.BypassCodeGenerator;
+import com.snp.batch.service.BypassConfigService;
+import com.snp.batch.service.JsonSchemaParser;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * BYPASS API 설정 관리 및 코드 생성 컨트롤러
+ */
+@Slf4j
+@RestController
+@RequestMapping("/api/bypass-config")
+@RequiredArgsConstructor
+@Tag(name = "Bypass Config", description = "BYPASS API 설정 관리 및 코드 생성")
+public class BypassConfigController {
+
+    private final BypassConfigService bypassConfigService;
+    private final BypassCodeGenerator bypassCodeGenerator;
+    private final JsonSchemaParser jsonSchemaParser;
+    private final BypassApiConfigRepository configRepository;
+
+    @Operation(summary = "설정 목록 조회")
+    @GetMapping
+    public ResponseEntity<ApiResponse<List<BypassConfigResponse>>> getConfigs() {
+        return ResponseEntity.ok(ApiResponse.success(bypassConfigService.getConfigs()));
+    }
+
+    @Operation(summary = "설정 상세 조회")
+    @GetMapping("/{id}")
+    public ResponseEntity<ApiResponse<BypassConfigResponse>> getConfig(@PathVariable Long id) {
+        return ResponseEntity.ok(ApiResponse.success(bypassConfigService.getConfig(id)));
+    }
+
+    @Operation(summary = "설정 등록")
+    @PostMapping
+    public ResponseEntity<ApiResponse<BypassConfigResponse>> createConfig(
+            @RequestBody BypassConfigRequest request) {
+        return ResponseEntity.ok(ApiResponse.success(bypassConfigService.createConfig(request)));
+    }
+
+    @Operation(summary = "설정 수정")
+    @PutMapping("/{id}")
+    public ResponseEntity<ApiResponse<BypassConfigResponse>> updateConfig(
+            @PathVariable Long id,
+            @RequestBody BypassConfigRequest request) {
+        return ResponseEntity.ok(ApiResponse.success(bypassConfigService.updateConfig(id, request)));
+    }
+
+    @Operation(summary = "설정 삭제")
+    @DeleteMapping("/{id}")
+    public ResponseEntity<ApiResponse<Void>> deleteConfig(@PathVariable Long id) {
+        bypassConfigService.deleteConfig(id);
+        return ResponseEntity.ok(ApiResponse.success("삭제 완료", null));
+    }
+
+    @Operation(
+            summary = "코드 생성",
+            description = "등록된 설정을 기반으로 Controller, Service, DTO Java 소스 코드를 생성합니다."
+    )
+    @PostMapping("/{id}/generate")
+    public ResponseEntity<ApiResponse<CodeGenerationResult>> generateCode(
+            @PathVariable Long id,
+            @RequestParam(defaultValue = "false") boolean force) {
+        try {
+            BypassApiConfig config = configRepository.findById(id)
+                    .orElseThrow(() -> new IllegalArgumentException("설정을 찾을 수 없습니다: " + id));
+
+            CodeGenerationResult result = bypassCodeGenerator.generate(
+                    config, config.getParams(), config.getFields(), force);
+
+            bypassConfigService.markAsGenerated(id);
+
+            return ResponseEntity.ok(ApiResponse.success(result));
+        } catch (IllegalStateException e) {
+            return ResponseEntity.badRequest().body(ApiResponse.error(e.getMessage()));
+        } catch (Exception e) {
+            log.error("코드 생성 실패", e);
+            return ResponseEntity.internalServerError().body(ApiResponse.error("코드 생성 실패: " + e.getMessage()));
+        }
+    }
+
+    @Operation(
+            summary = "JSON 샘플 파싱",
+            description = "JSON 샘플에서 DTO 필드 목록을 추출합니다."
+    )
+    @PostMapping("/parse-json")
+    public ResponseEntity<ApiResponse<List<BypassFieldDto>>> parseJson(@RequestBody String jsonSample) {
+        try {
+            List<BypassFieldDto> fields = jsonSchemaParser.parse(jsonSample);
+            return ResponseEntity.ok(ApiResponse.success(fields));
+        } catch (Exception e) {
+            return ResponseEntity.badRequest().body(ApiResponse.error("JSON 파싱 실패: " + e.getMessage()));
+        }
+    }
+
+    @Operation(
+            summary = "WebClient 빈 목록",
+            description = "사용 가능한 WebClient 빈 이름 목록을 반환합니다."
+    )
+    @GetMapping("/webclient-beans")
+    public ResponseEntity<ApiResponse<List<Map<String, String>>>> getWebclientBeans() {
+        List<Map<String, String>> beans = List.of(
+                Map.of("name", "maritimeApiWebClient", "description", "Ship API (shipsapi.maritime.spglobal.com)"),
+                Map.of("name", "maritimeAisApiWebClient", "description", "AIS API (aisapi.maritime.spglobal.com)"),
+                Map.of("name", "maritimeServiceApiWebClient", "description", "Web Service API (webservices.maritime.spglobal.com)")
+        );
+        return ResponseEntity.ok(ApiResponse.success(beans));
+    }
+}
diff --git a/src/main/java/com/snp/batch/global/dto/BypassConfigRequest.java b/src/main/java/com/snp/batch/global/dto/BypassConfigRequest.java
new file mode 100644
index 0000000..0e4f50d
--- /dev/null
+++ b/src/main/java/com/snp/batch/global/dto/BypassConfigRequest.java
@@ -0,0 +1,45 @@
+package com.snp.batch.global.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+import java.util.List;
+
+/**
+ * BYPASS API 설정 등록/수정 요청 DTO
+ */
+@Getter
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class BypassConfigRequest {
+
+    /** 도메인명 (패키지명/URL 경로) */
+    private String domainName;
+
+    /** 표시명 */
+    private String displayName;
+
+    /** WebClient 빈 이름 */
+    private String webclientBean;
+
+    /** 외부 API 경로 */
+    private String externalPath;
+
+    /** HTTP 메서드 */
+    private String httpMethod;
+
+    /** 응답 타입 */
+    private String responseType;
+
+    /** 설명 */
+    private String description;
+
+    /** 파라미터 목록 */
+    private List<BypassParamDto> params;
+
+    /** 응답 필드 목록 */
+    private List<BypassFieldDto> fields;
+}
diff --git a/src/main/java/com/snp/batch/global/dto/BypassConfigResponse.java b/src/main/java/com/snp/batch/global/dto/BypassConfigResponse.java
new file mode 100644
index 0000000..2779d75
--- /dev/null
+++ b/src/main/java/com/snp/batch/global/dto/BypassConfigResponse.java
@@ -0,0 +1,60 @@
+package com.snp.batch.global.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * BYPASS API 설정 조회 응답 DTO
+ */
+@Getter
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class BypassConfigResponse {
+
+    private Long id;
+
+    /** 도메인명 (패키지명/URL 경로) */
+    private String domainName;
+
+    /** 표시명 */
+    private String displayName;
+
+    /** WebClient 빈 이름 */
+    private String webclientBean;
+
+    /** 외부 API 경로 */
+    private String externalPath;
+
+    /** HTTP 메서드 */
+    private String httpMethod;
+
+    /** 응답 타입 */
+    private String responseType;
+
+    /** 설명 */
+    private String description;
+
+    /** 코드 생성 완료 여부 */
+    private Boolean generated;
+
+    /** 코드 생성 일시 */
+    private LocalDateTime generatedAt;
+
+    /** 생성 일시 */
+    private LocalDateTime createdAt;
+
+    /** 수정 일시 */
+    private LocalDateTime updatedAt;
+
+    /** 파라미터 목록 */
+    private List<BypassParamDto> params;
+
+    /** 응답 필드 목록 */
+    private List<BypassFieldDto> fields;
+}
diff --git a/src/main/java/com/snp/batch/global/dto/BypassFieldDto.java b/src/main/java/com/snp/batch/global/dto/BypassFieldDto.java
new file mode 100644
index 0000000..241fec9
--- /dev/null
+++ b/src/main/java/com/snp/batch/global/dto/BypassFieldDto.java
@@ -0,0 +1,33 @@
+package com.snp.batch.global.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+/**
+ * BYPASS API 응답 필드 정보 DTO
+ */
+@Getter
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class BypassFieldDto {
+
+    private Long id;
+
+    /** 필드 이름 (Java 클래스 필드명) */
+    private String fieldName;
+
+    /** JSON 프로퍼티명 (null이면 fieldName 사용) */
+    private String jsonProperty;
+
+    /** 필드 타입 (String, Integer, Long, Double, Boolean, LocalDateTime) */
+    private String fieldType;
+
+    /** 필드 설명 */
+    private String description;
+
+    /** 정렬 순서 */
+    private Integer sortOrder;
+}
diff --git a/src/main/java/com/snp/batch/global/dto/BypassParamDto.java b/src/main/java/com/snp/batch/global/dto/BypassParamDto.java
new file mode 100644
index 0000000..38571bd
--- /dev/null
+++ b/src/main/java/com/snp/batch/global/dto/BypassParamDto.java
@@ -0,0 +1,36 @@
+package com.snp.batch.global.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+/**
+ * BYPASS API 파라미터 정보 DTO
+ */
+@Getter
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class BypassParamDto {
+
+    private Long id;
+
+    /** 파라미터 이름 */
+    private String paramName;
+
+    /** 파라미터 타입 (STRING, INTEGER, LONG, BOOLEAN) */
+    private String paramType;
+
+    /** 파라미터 위치 (PATH, QUERY, BODY) */
+    private String paramIn;
+
+    /** 필수 여부 */
+    private Boolean required;
+
+    /** 파라미터 설명 */
+    private String description;
+
+    /** 정렬 순서 */
+    private Integer sortOrder;
+}
diff --git a/src/main/java/com/snp/batch/global/dto/CodeGenerationResult.java b/src/main/java/com/snp/batch/global/dto/CodeGenerationResult.java
new file mode 100644
index 0000000..2c00937
--- /dev/null
+++ b/src/main/java/com/snp/batch/global/dto/CodeGenerationResult.java
@@ -0,0 +1,28 @@
+package com.snp.batch.global.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+/**
+ * 코드 자동 생성 결과 DTO
+ */
+@Getter
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class CodeGenerationResult {
+
+    /** 생성된 Controller 파일 경로 */
+    private String controllerPath;
+
+    /** 생성된 Service 파일 경로 */
+    private String servicePath;
+
+    /** 생성된 DTO 파일 경로 */
+    private String dtoPath;
+
+    /** 결과 메시지 */
+    private String message;
+}
diff --git a/src/main/java/com/snp/batch/global/model/BypassApiConfig.java b/src/main/java/com/snp/batch/global/model/BypassApiConfig.java
new file mode 100644
index 0000000..b1b209b
--- /dev/null
+++ b/src/main/java/com/snp/batch/global/model/BypassApiConfig.java
@@ -0,0 +1,135 @@
+package com.snp.batch.global.model;
+
+import jakarta.persistence.*;
+import lombok.*;
+
+import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * BYPASS API 설정 정보를 저장하는 엔티티
+ * 외부 API를 동적으로 프록시하기 위한 설정 메타데이터
+ *
+ * JPA를 사용하므로 @PrePersist, @PreUpdate로 감사 필드 자동 설정
+ */
+@Entity
+@Table(name = "bypass_api_config")
+@Getter
+@Setter
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class BypassApiConfig {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    /**
+     * 도메인명 (패키지명/URL 경로)
+     * 예: "ship-info", "port-data"
+     */
+    @Column(name = "domain_name", unique = true, nullable = false, length = 50)
+    private String domainName;
+
+    /**
+     * 표시명
+     * 예: "선박 정보 API", "항만 데이터 API"
+     */
+    @Column(name = "display_name", nullable = false, length = 100)
+    private String displayName;
+
+    /**
+     * WebClient 빈 이름
+     * 예: "maritimeWebClient", "portWebClient"
+     */
+    @Column(name = "webclient_bean", nullable = false, length = 100)
+    private String webclientBean;
+
+    /**
+     * 외부 API 경로
+     * 예: "/api/v1/ships/{imoNumber}"
+     */
+    @Column(name = "external_path", nullable = false, length = 500)
+    private String externalPath;
+
+    /**
+     * HTTP 메서드
+     * 예: "GET", "POST"
+     */
+    @Column(name = "http_method", nullable = false, length = 10)
+    @Builder.Default
+    private String httpMethod = "GET";
+
+    /**
+     * 응답 타입
+     * 예: "LIST", "SINGLE"
+     */
+    @Column(name = "response_type", nullable = false, length = 20)
+    @Builder.Default
+    private String responseType = "LIST";
+
+    /**
+     * 설명
+     */
+    @Column(name = "description", length = 1000)
+    private String description;
+
+    /**
+     * 코드 생성 완료 여부
+     */
+    @Column(name = "generated", nullable = false)
+    @Builder.Default
+    private Boolean generated = false;
+
+    /**
+     * 코드 생성 일시
+     */
+    @Column(name = "generated_at")
+    private LocalDateTime generatedAt;
+
+    /**
+     * 생성 일시 (감사 필드)
+     */
+    @Column(name = "created_at", nullable = false, updatable = false)
+    private LocalDateTime createdAt;
+
+    /**
+     * 수정 일시 (감사 필드)
+     */
+    @Column(name = "updated_at", nullable = false)
+    private LocalDateTime updatedAt;
+
+    /**
+     * API 파라미터 목록
+     */
+    @OneToMany(mappedBy = "config", cascade = CascadeType.ALL, orphanRemoval = true)
+    @Builder.Default
+    private List<BypassApiParam> params = new ArrayList<>();
+
+    /**
+     * API 응답 필드 목록
+     */
+    @OneToMany(mappedBy = "config", cascade = CascadeType.ALL, orphanRemoval = true)
+    @Builder.Default
+    private List<BypassApiField> fields = new ArrayList<>();
+
+    /**
+     * 엔티티 저장 전 자동 호출 (INSERT 시)
+     */
+    @PrePersist
+    protected void onCreate() {
+        LocalDateTime now = LocalDateTime.now();
+        this.createdAt = now;
+        this.updatedAt = now;
+    }
+
+    /**
+     * 엔티티 업데이트 전 자동 호출 (UPDATE 시)
+     */
+    @PreUpdate
+    protected void onUpdate() {
+        this.updatedAt = LocalDateTime.now();
+    }
+}
diff --git a/src/main/java/com/snp/batch/global/model/BypassApiField.java b/src/main/java/com/snp/batch/global/model/BypassApiField.java
new file mode 100644
index 0000000..7e06007
--- /dev/null
+++ b/src/main/java/com/snp/batch/global/model/BypassApiField.java
@@ -0,0 +1,69 @@
+package com.snp.batch.global.model;
+
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import jakarta.persistence.*;
+import lombok.*;
+
+/**
+ * BYPASS API 응답 필드 정보를 저장하는 엔티티
+ * BypassApiConfig에 종속되며, 외부 API 응답에서 추출할 필드 메타데이터를 정의
+ */
+@Entity
+@Table(
+    name = "bypass_api_field",
+    uniqueConstraints = @UniqueConstraint(columnNames = {"config_id", "field_name"})
+)
+@Getter
+@Setter
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class BypassApiField {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    /**
+     * 연관된 BYPASS API 설정
+     */
+    @JsonIgnore
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "config_id", nullable = false)
+    private BypassApiConfig config;
+
+    /**
+     * 필드 이름 (Java 클래스 필드명)
+     * 예: "imoNumber", "shipName", "vesselType"
+     */
+    @Column(name = "field_name", nullable = false, length = 100)
+    private String fieldName;
+
+    /**
+     * JSON 프로퍼티명 (null이면 fieldName 사용)
+     * 예: "imo_number", "ship_name"
+     */
+    @Column(name = "json_property", length = 100)
+    private String jsonProperty;
+
+    /**
+     * 필드 타입
+     * 예: "String", "Integer", "Long", "Double", "Boolean", "LocalDateTime"
+     */
+    @Column(name = "field_type", nullable = false, length = 50)
+    @Builder.Default
+    private String fieldType = "String";
+
+    /**
+     * 필드 설명
+     */
+    @Column(name = "description", length = 500)
+    private String description;
+
+    /**
+     * 정렬 순서
+     */
+    @Column(name = "sort_order", nullable = false)
+    @Builder.Default
+    private Integer sortOrder = 0;
+}
diff --git a/src/main/java/com/snp/batch/global/model/BypassApiParam.java b/src/main/java/com/snp/batch/global/model/BypassApiParam.java
new file mode 100644
index 0000000..a55e662
--- /dev/null
+++ b/src/main/java/com/snp/batch/global/model/BypassApiParam.java
@@ -0,0 +1,77 @@
+package com.snp.batch.global.model;
+
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import jakarta.persistence.*;
+import lombok.*;
+
+/**
+ * BYPASS API 파라미터 정보를 저장하는 엔티티
+ * BypassApiConfig에 종속되며, API 호출 시 사용할 파라미터 메타데이터를 정의
+ */
+@Entity
+@Table(
+    name = "bypass_api_param",
+    uniqueConstraints = @UniqueConstraint(columnNames = {"config_id", "param_name"})
+)
+@Getter
+@Setter
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class BypassApiParam {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    /**
+     * 연관된 BYPASS API 설정
+     */
+    @JsonIgnore
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "config_id", nullable = false)
+    private BypassApiConfig config;
+
+    /**
+     * 파라미터 이름
+     * 예: "imoNumber", "mmsi", "startDate"
+     */
+    @Column(name = "param_name", nullable = false, length = 100)
+    private String paramName;
+
+    /**
+     * 파라미터 타입
+     * 예: "STRING", "INTEGER", "LONG", "BOOLEAN"
+     */
+    @Column(name = "param_type", nullable = false, length = 20)
+    @Builder.Default
+    private String paramType = "STRING";
+
+    /**
+     * 파라미터 위치
+     * 예: "PATH", "QUERY", "BODY"
+     */
+    @Column(name = "param_in", nullable = false, length = 20)
+    @Builder.Default
+    private String paramIn = "QUERY";
+
+    /**
+     * 필수 여부
+     */
+    @Column(name = "required", nullable = false)
+    @Builder.Default
+    private Boolean required = true;
+
+    /**
+     * 파라미터 설명
+     */
+    @Column(name = "description", length = 500)
+    private String description;
+
+    /**
+     * 정렬 순서
+     */
+    @Column(name = "sort_order", nullable = false)
+    @Builder.Default
+    private Integer sortOrder = 0;
+}
diff --git a/src/main/java/com/snp/batch/global/repository/BypassApiConfigRepository.java b/src/main/java/com/snp/batch/global/repository/BypassApiConfigRepository.java
new file mode 100644
index 0000000..89a2322
--- /dev/null
+++ b/src/main/java/com/snp/batch/global/repository/BypassApiConfigRepository.java
@@ -0,0 +1,25 @@
+package com.snp.batch.global.repository;
+
+import com.snp.batch.global.model.BypassApiConfig;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import java.util.Optional;
+
+/**
+ * BypassApiConfig Repository
+ * JPA Repository 방식으로 자동 구현
+ */
+@Repository
+public interface BypassApiConfigRepository extends JpaRepository<BypassApiConfig, Long> {
+
+    /**
+     * 도메인명으로 BYPASS API 설정 조회
+     */
+    Optional<BypassApiConfig> findByDomainName(String domainName);
+
+    /**
+     * 도메인명 존재 여부 확인
+     */
+    boolean existsByDomainName(String domainName);
+}
diff --git a/src/main/java/com/snp/batch/global/repository/BypassApiFieldRepository.java b/src/main/java/com/snp/batch/global/repository/BypassApiFieldRepository.java
new file mode 100644
index 0000000..756629f
--- /dev/null
+++ b/src/main/java/com/snp/batch/global/repository/BypassApiFieldRepository.java
@@ -0,0 +1,25 @@
+package com.snp.batch.global.repository;
+
+import com.snp.batch.global.model.BypassApiField;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import java.util.List;
+
+/**
+ * BypassApiField Repository
+ * JPA Repository 방식으로 자동 구현
+ */
+@Repository
+public interface BypassApiFieldRepository extends JpaRepository<BypassApiField, Long> {
+
+    /**
+     * 설정 ID로 필드 목록 조회 (정렬 순서 기준 오름차순)
+     */
+    List<BypassApiField> findByConfigIdOrderBySortOrder(Long configId);
+
+    /**
+     * 설정 ID로 필드 전체 삭제
+     */
+    void deleteByConfigId(Long configId);
+}
diff --git a/src/main/java/com/snp/batch/global/repository/BypassApiParamRepository.java b/src/main/java/com/snp/batch/global/repository/BypassApiParamRepository.java
new file mode 100644
index 0000000..cff846e
--- /dev/null
+++ b/src/main/java/com/snp/batch/global/repository/BypassApiParamRepository.java
@@ -0,0 +1,25 @@
+package com.snp.batch.global.repository;
+
+import com.snp.batch.global.model.BypassApiParam;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import java.util.List;
+
+/**
+ * BypassApiParam Repository
+ * JPA Repository 방식으로 자동 구현
+ */
+@Repository
+public interface BypassApiParamRepository extends JpaRepository<BypassApiParam, Long> {
+
+    /**
+     * 설정 ID로 파라미터 목록 조회 (정렬 순서 기준 오름차순)
+     */
+    List<BypassApiParam> findByConfigIdOrderBySortOrder(Long configId);
+
+    /**
+     * 설정 ID로 파라미터 전체 삭제
+     */
+    void deleteByConfigId(Long configId);
+}
diff --git a/src/main/java/com/snp/batch/jobs/web/risk/controller/RiskController.java b/src/main/java/com/snp/batch/jobs/web/risk/controller/RiskController.java
index 6ae954d..9f4397a 100644
--- a/src/main/java/com/snp/batch/jobs/web/risk/controller/RiskController.java
+++ b/src/main/java/com/snp/batch/jobs/web/risk/controller/RiskController.java
@@ -1,19 +1,18 @@
 package com.snp.batch.jobs.web.risk.controller;
 
 import com.snp.batch.common.web.ApiResponse;
+import com.snp.batch.common.web.controller.BaseBypassController;
 import com.snp.batch.jobs.batch.risk.dto.RiskDto;
 import com.snp.batch.jobs.web.risk.service.RiskBypassService;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.Parameter;
 import io.swagger.v3.oas.annotations.tags.Tag;
 import lombok.RequiredArgsConstructor;
-import lombok.extern.slf4j.Slf4j;
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.PathVariable;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
-import org.springframework.web.reactive.function.client.WebClientResponseException;
 
 import java.util.List;
 
@@ -21,12 +20,11 @@ import java.util.List;
  * Risk 상세 조회 bypass API
  * S&P Maritime API에서 Risk 데이터를 실시간 조회하여 그대로 반환
  */
-@Slf4j
 @RestController
 @RequestMapping("/api/risk")
 @RequiredArgsConstructor
 @Tag(name = "Risk", description = "선박 Risk 상세 정보 bypass API")
-public class RiskController {
+public class RiskController extends BaseBypassController {
 
     private final RiskBypassService riskBypassService;
 
@@ -37,20 +35,7 @@ public class RiskController {
     @GetMapping("/{imo}")
     public ResponseEntity<ApiResponse<List<RiskDto>>> getRiskDetailByImo(
             @Parameter(description = "IMO 번호", example = "9321483")
-            @PathVariable String imo
-    ) {
-        try {
-            List<RiskDto> riskData = riskBypassService.getRiskDetailByImo(imo);
-            return ResponseEntity.ok(ApiResponse.success(riskData));
-        } catch (WebClientResponseException e) {
-            log.error("S&P Risk API 호출 실패 - IMO: {}, status: {}, body: {}",
-                    imo, e.getStatusCode(), e.getResponseBodyAsString());
-            return ResponseEntity.status(e.getStatusCode())
-                    .body(ApiResponse.error("S&P API 호출 실패: " + e.getMessage()));
-        } catch (Exception e) {
-            log.error("Risk 상세 조회 중 오류 - IMO: {}", imo, e);
-            return ResponseEntity.internalServerError()
-                    .body(ApiResponse.error("Risk 조회 실패: " + e.getMessage()));
-        }
+            @PathVariable String imo) {
+        return execute(() -> riskBypassService.getRiskDetailByImo(imo));
     }
 }
diff --git a/src/main/java/com/snp/batch/jobs/web/risk/service/RiskBypassService.java b/src/main/java/com/snp/batch/jobs/web/risk/service/RiskBypassService.java
index c0eae98..f20421d 100644
--- a/src/main/java/com/snp/batch/jobs/web/risk/service/RiskBypassService.java
+++ b/src/main/java/com/snp/batch/jobs/web/risk/service/RiskBypassService.java
@@ -1,7 +1,7 @@
 package com.snp.batch.jobs.web.risk.service;
 
+import com.snp.batch.common.web.service.BaseBypassService;
 import com.snp.batch.jobs.batch.risk.dto.RiskDto;
-import lombok.extern.slf4j.Slf4j;
 import org.springframework.beans.factory.annotation.Qualifier;
 import org.springframework.core.ParameterizedTypeReference;
 import org.springframework.stereotype.Service;
@@ -13,18 +13,14 @@ import java.util.List;
  * S&P Risk API bypass 서비스
  * 외부 Maritime API에서 Risk 상세 데이터를 실시간 조회하여 그대로 반환
  */
-@Slf4j
 @Service
-public class RiskBypassService {
-
-    private static final String RISK_API_PATH = "/RiskAndCompliance/RisksByImos";
-
-    private final WebClient webClient;
+public class RiskBypassService extends BaseBypassService<RiskDto> {
 
     public RiskBypassService(
-            @Qualifier("maritimeServiceApiWebClient") WebClient webClient
-    ) {
-        this.webClient = webClient;
+            @Qualifier("maritimeServiceApiWebClient") WebClient webClient) {
+        super(webClient, "/RiskAndCompliance/RisksByImos", "S&P Risk",
+                new ParameterizedTypeReference<>() {},
+                new ParameterizedTypeReference<>() {});
     }
 
     /**
@@ -34,23 +30,8 @@ public class RiskBypassService {
      * @return Risk 상세 데이터 목록
      */
     public List<RiskDto> getRiskDetailByImo(String imo) {
-        log.info("S&P Risk API 호출 - IMO: {}", imo);
-
-        List<RiskDto> response = webClient.get()
-                .uri(uriBuilder -> uriBuilder
-                        .path(RISK_API_PATH)
-                        .queryParam("imos", imo)
-                        .build())
-                .retrieve()
-                .bodyToMono(new ParameterizedTypeReference<List<RiskDto>>() {})
-                .block();
-
-        if (response == null || response.isEmpty()) {
-            log.warn("S&P Risk API 응답 없음 - IMO: {}", imo);
-            return List.of();
-        }
-
-        log.info("S&P Risk API 응답 완료 - IMO: {}, 건수: {}", imo, response.size());
-        return response;
+        return fetchGetList(uri -> uri.path(getApiPath())
+                .queryParam("imos", imo)
+                .build());
     }
 }
diff --git a/src/main/java/com/snp/batch/service/BypassCodeGenerator.java b/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
new file mode 100644
index 0000000..1880bf4
--- /dev/null
+++ b/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
@@ -0,0 +1,415 @@
+package com.snp.batch.service;
+
+import com.snp.batch.global.dto.CodeGenerationResult;
+import com.snp.batch.global.model.BypassApiConfig;
+import com.snp.batch.global.model.BypassApiField;
+import com.snp.batch.global.model.BypassApiParam;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+
+import java.io.IOException;
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.List;
+import java.util.stream.Collectors;
+
+/**
+ * BYPASS API Java 소스 코드를 자동 생성하는 서비스.
+ * RiskBypassService / RiskController 패턴을 기반으로 DTO, Service, Controller를 생성합니다.
+ */
+@Slf4j
+@Service
+public class BypassCodeGenerator {
+
+    private static final String BASE_PACKAGE = "com.snp.batch.jobs.web";
+
+    /**
+     * BYPASS API 코드를 생성합니다.
+     *
+     * @param config 설정 정보
+     * @param params 파라미터 목록
+     * @param fields DTO 필드 목록
+     * @param force  기존 파일 덮어쓰기 여부
+     * @return 생성 결과
+     */
+    public CodeGenerationResult generate(BypassApiConfig config,
+                                          List<BypassApiParam> params,
+                                          List<BypassApiField> fields,
+                                          boolean force) {
+        String projectRoot = System.getProperty("user.dir");
+        String domain = config.getDomainName();
+        String domainCapitalized = capitalize(domain);
+
+        String dtoCode = generateDtoCode(domain, domainCapitalized, fields);
+        String serviceCode = generateServiceCode(domain, domainCapitalized, config, params);
+        String controllerCode = generateControllerCode(domain, domainCapitalized, config, params);
+
+        String basePath = projectRoot + "/src/main/java/com/snp/batch/jobs/web/" + domain;
+        Path dtoPath = writeFile(basePath + "/dto/" + domainCapitalized + "BypassDto.java", dtoCode, force);
+        Path servicePath = writeFile(basePath + "/service/" + domainCapitalized + "BypassService.java", serviceCode, force);
+        Path controllerPath = writeFile(basePath + "/controller/" + domainCapitalized + "Controller.java", controllerCode, force);
+
+        log.info("코드 생성 완료 - domain: {}, dto: {}, service: {}, controller: {}",
+                domain, dtoPath, servicePath, controllerPath);
+
+        return CodeGenerationResult.builder()
+                .dtoPath(dtoPath.toString())
+                .servicePath(servicePath.toString())
+                .controllerPath(controllerPath.toString())
+                .message("코드 생성 완료. 서버를 재시작하면 새 API가 활성화됩니다.")
+                .build();
+    }
+
+    /**
+     * DTO 코드 생성.
+     * 각 field에 대해 @JsonProperty + private 필드를 생성합니다.
+     */
+    private String generateDtoCode(String domain, String domainCap, List<BypassApiField> fields) {
+        String packageName = BASE_PACKAGE + "." + domain + ".dto";
+        boolean needsLocalDateTime = fields.stream()
+                .anyMatch(f -> "LocalDateTime".equals(f.getFieldType()));
+
+        StringBuilder imports = new StringBuilder();
+        imports.append("import com.fasterxml.jackson.annotation.JsonProperty;\n");
+        imports.append("import lombok.AllArgsConstructor;\n");
+        imports.append("import lombok.Builder;\n");
+        imports.append("import lombok.Getter;\n");
+        imports.append("import lombok.NoArgsConstructor;\n");
+        imports.append("import lombok.Setter;\n");
+        if (needsLocalDateTime) {
+            imports.append("import java.time.LocalDateTime;\n");
+        }
+
+        StringBuilder fieldLines = new StringBuilder();
+        for (BypassApiField field : fields) {
+            String jsonProp = field.getJsonProperty() != null ? field.getJsonProperty() : field.getFieldName();
+            fieldLines.append("    @JsonProperty(\"%s\")\n".formatted(jsonProp));
+            fieldLines.append("    private %s %s;\n\n".formatted(field.getFieldType(), field.getFieldName()));
+        }
+
+        return """
+                package %s;
+
+                %s
+                @Getter
+                @Setter
+                @Builder
+                @NoArgsConstructor
+                @AllArgsConstructor
+                public class %sBypassDto {
+
+                %s}
+                """.formatted(packageName, imports, domainCap, fieldLines);
+    }
+
+    /**
+     * Service 코드 생성.
+     * BaseBypassService를 상속하여 GET/POST, LIST/SINGLE 조합에 맞는 fetch 메서드를 생성합니다.
+     */
+    private String generateServiceCode(String domain, String domainCap,
+                                        BypassApiConfig config, List<BypassApiParam> params) {
+        String packageName = BASE_PACKAGE + "." + domain + ".service";
+        String dtoPackage = BASE_PACKAGE + "." + domain + ".dto";
+        String dtoClass = domainCap + "BypassDto";
+        boolean isList = "LIST".equalsIgnoreCase(config.getResponseType());
+        boolean isPost = "POST".equalsIgnoreCase(config.getHttpMethod());
+
+        String returnType = isList ? "List<%s>".formatted(dtoClass) : dtoClass;
+        String methodName = "get" + domainCap + "Data";
+        String fetchMethod = buildFetchMethodCall(config, params, isList, isPost);
+        String methodParams = buildMethodParams(params);
+
+        String listImport = isList ? "import java.util.List;\n" : "";
+
+        return """
+                package %s;
+
+                import %s.%s;
+                import com.snp.batch.common.web.service.BaseBypassService;
+                %simport org.springframework.beans.factory.annotation.Qualifier;
+                import org.springframework.core.ParameterizedTypeReference;
+                import org.springframework.stereotype.Service;
+                import org.springframework.web.reactive.function.client.WebClient;
+
+                /**
+                 * %s bypass 서비스
+                 * 외부 Maritime API에서 데이터를 실시간 조회하여 그대로 반환
+                 */
+                @Service
+                public class %sBypassService extends BaseBypassService<%s> {
+
+                    public %sBypassService(
+                            @Qualifier("%s") WebClient webClient) {
+                        super(webClient, "%s", "%s",
+                                new ParameterizedTypeReference<>() {},
+                                new ParameterizedTypeReference<>() {});
+                    }
+
+                    /**
+                     * %s 데이터를 조회합니다.
+                     *
+                     * @return %s
+                     */
+                    public %s %s(%s) {
+                        %s
+                    }
+                }
+                """.formatted(
+                packageName,
+                dtoPackage, dtoClass,
+                listImport,
+                config.getDisplayName(),
+                domainCap, dtoClass,
+                domainCap,
+                config.getWebclientBean(),
+                config.getExternalPath(),
+                config.getDisplayName(),
+                config.getDisplayName(),
+                returnType, methodName, methodParams,
+                fetchMethod
+        );
+    }
+
+    /**
+     * Controller 코드 생성.
+     * BaseBypassController를 상속하여 GET/POST 엔드포인트를 생성합니다.
+     */
+    private String generateControllerCode(String domain, String domainCap,
+                                           BypassApiConfig config, List<BypassApiParam> params) {
+        String packageName = BASE_PACKAGE + "." + domain + ".controller";
+        String dtoPackage = BASE_PACKAGE + "." + domain + ".dto";
+        String servicePackage = BASE_PACKAGE + "." + domain + ".service";
+        String dtoClass = domainCap + "BypassDto";
+        String serviceClass = domainCap + "BypassService";
+        String serviceField = Character.toLowerCase(serviceClass.charAt(0)) + serviceClass.substring(1);
+
+        boolean isList = "LIST".equalsIgnoreCase(config.getResponseType());
+        boolean isPost = "POST".equalsIgnoreCase(config.getHttpMethod());
+
+        String responseGeneric = isList ? "List<%s>".formatted(dtoClass) : dtoClass;
+        String mappingAnnotation = isPost ? "@PostMapping" : "@GetMapping";
+        String listImport = isList ? "import java.util.List;\n" : "";
+
+        String paramAnnotations = buildControllerParamAnnotations(params);
+        String methodParams = buildMethodParams(params);
+        String serviceCallArgs = buildServiceCallArgs(params);
+        String pathVariableImport = params.stream().anyMatch(p -> "PATH".equalsIgnoreCase(p.getParamIn()))
+                ? "import org.springframework.web.bind.annotation.PathVariable;\n" : "";
+        String requestParamImport = params.stream().anyMatch(p -> "QUERY".equalsIgnoreCase(p.getParamIn()))
+                ? "import org.springframework.web.bind.annotation.RequestParam;\n" : "";
+        String requestBodyImport = isPost
+                ? "import org.springframework.web.bind.annotation.RequestBody;\n" : "";
+
+        String mappingPath = buildMappingPath(params);
+        String requestMappingPath = "/api/" + domain;
+
+        return """
+                package %s;
+
+                import %s.%s;
+                import %s.%s;
+                import com.snp.batch.common.web.ApiResponse;
+                import com.snp.batch.common.web.controller.BaseBypassController;
+                import io.swagger.v3.oas.annotations.Operation;
+                import io.swagger.v3.oas.annotations.Parameter;
+                import io.swagger.v3.oas.annotations.tags.Tag;
+                %simport lombok.RequiredArgsConstructor;
+                import org.springframework.http.ResponseEntity;
+                import org.springframework.web.bind.annotation.RequestMapping;
+                import org.springframework.web.bind.annotation.RestController;
+                %s%s%s%s
+                /**
+                 * %s bypass API
+                 * S&P Maritime API에서 데이터를 실시간 조회하여 그대로 반환
+                 */
+                @RestController
+                @RequestMapping("%s")
+                @RequiredArgsConstructor
+                @Tag(name = "%s", description = "%s bypass API")
+                public class %sController extends BaseBypassController {
+
+                    private final %s %s;
+
+                    @Operation(
+                            summary = "%s 조회",
+                            description = "S&P API에서 %s 데이터를 요청하고 응답을 그대로 반환합니다."
+                    )
+                    %s
+                    public ResponseEntity<ApiResponse<%s>> get%sData(%s) {
+                        return execute(() -> %s.get%sData(%s));
+                    }
+                }
+                """.formatted(
+                packageName,
+                dtoPackage, dtoClass,
+                servicePackage, serviceClass,
+                listImport,
+                pathVariableImport, requestParamImport, requestBodyImport,
+                mappingAnnotation.equals("@PostMapping") ? "" : "",
+                config.getDisplayName(),
+                requestMappingPath,
+                domainCap, config.getDisplayName(),
+                domainCap,
+                serviceClass, serviceField,
+                config.getDisplayName(), config.getDisplayName(),
+                mappingAnnotation + mappingPath,
+                responseGeneric, domainCap,
+                paramAnnotations.isEmpty() ? "" : paramAnnotations,
+                serviceField, domainCap, serviceCallArgs
+        );
+    }
+
+    /**
+     * fetch 메서드 호출 코드 생성
+     */
+    private String buildFetchMethodCall(BypassApiConfig config, List<BypassApiParam> params,
+                                         boolean isList, boolean isPost) {
+        List<BypassApiParam> pathParams = params.stream()
+                .filter(p -> "PATH".equalsIgnoreCase(p.getParamIn()))
+                .sorted((a, b) -> Integer.compare(a.getSortOrder(), b.getSortOrder()))
+                .toList();
+        List<BypassApiParam> queryParams = params.stream()
+                .filter(p -> "QUERY".equalsIgnoreCase(p.getParamIn()))
+                .sorted((a, b) -> Integer.compare(a.getSortOrder(), b.getSortOrder()))
+                .toList();
+
+        StringBuilder uriBuilder = new StringBuilder();
+        uriBuilder.append("uri -> uri.path(getApiPath())");
+        for (BypassApiParam p : pathParams) {
+            // PATH 파라미터는 path()에 직접 치환되므로 별도 처리 불필요
+        }
+        for (BypassApiParam p : queryParams) {
+            uriBuilder.append("\n                        .queryParam(\"%s\", %s)"
+                    .formatted(p.getParamName(), p.getParamName()));
+        }
+        uriBuilder.append("\n                        .build()");
+
+        String fetchName;
+        if (isPost) {
+            fetchName = isList ? "fetchPostList" : "fetchPostOne";
+            BypassApiParam bodyParam = params.stream()
+                    .filter(p -> "BODY".equalsIgnoreCase(p.getParamIn()))
+                    .findFirst().orElse(null);
+            String bodyArg = bodyParam != null ? bodyParam.getParamName() : "null";
+            return "return %s(%s, %s);".formatted(fetchName, bodyArg, uriBuilder);
+        } else {
+            fetchName = isList ? "fetchGetList" : "fetchGetOne";
+            return "return %s(%s);".formatted(fetchName, uriBuilder);
+        }
+    }
+
+    /**
+     * 메서드 파라미터 목록 생성 (Java 타입 + 이름)
+     */
+    private String buildMethodParams(List<BypassApiParam> params) {
+        return params.stream()
+                .sorted((a, b) -> Integer.compare(a.getSortOrder(), b.getSortOrder()))
+                .map(p -> toJavaType(p.getParamType()) + " " + p.getParamName())
+                .collect(Collectors.joining(", "));
+    }
+
+    /**
+     * 서비스 호출 인자 목록 생성
+     */
+    private String buildServiceCallArgs(List<BypassApiParam> params) {
+        return params.stream()
+                .sorted((a, b) -> Integer.compare(a.getSortOrder(), b.getSortOrder()))
+                .map(BypassApiParam::getParamName)
+                .collect(Collectors.joining(", "));
+    }
+
+    /**
+     * Controller 메서드 파라미터 어노테이션 포함 목록 생성
+     */
+    private String buildControllerParamAnnotations(List<BypassApiParam> params) {
+        if (params.isEmpty()) {
+            return "";
+        }
+        return params.stream()
+                .sorted((a, b) -> Integer.compare(a.getSortOrder(), b.getSortOrder()))
+                .map(p -> {
+                    String annotation;
+                    String description = p.getDescription() != null ? p.getDescription() : p.getParamName();
+                    switch (p.getParamIn().toUpperCase()) {
+                        case "PATH" -> annotation = """
+                                @Parameter(description = "%s")
+                                @PathVariable %s %s""".formatted(description, toJavaType(p.getParamType()), p.getParamName());
+                        case "BODY" -> annotation = """
+                                @Parameter(description = "%s")
+                                @RequestBody %s %s""".formatted(description, toJavaType(p.getParamType()), p.getParamName());
+                        default -> {
+                            String required = Boolean.TRUE.equals(p.getRequired()) ? "true" : "false";
+                            annotation = """
+                                @Parameter(description = "%s")
+                                @RequestParam(required = %s) %s %s""".formatted(
+                                    description, required, toJavaType(p.getParamType()), p.getParamName());
+                        }
+                    }
+                    return annotation;
+                })
+                .collect(Collectors.joining(",\n            "));
+    }
+
+    /**
+     * @GetMapping / @PostMapping에 붙는 경로 생성 (PATH 파라미터가 있는 경우)
+     */
+    private String buildMappingPath(List<BypassApiParam> params) {
+        List<BypassApiParam> pathParams = params.stream()
+                .filter(p -> "PATH".equalsIgnoreCase(p.getParamIn()))
+                .sorted((a, b) -> Integer.compare(a.getSortOrder(), b.getSortOrder()))
+                .toList();
+        if (pathParams.isEmpty()) {
+            return "";
+        }
+        String path = pathParams.stream()
+                .map(p -> "{" + p.getParamName() + "}")
+                .collect(Collectors.joining("/", "/", ""));
+        return "(\"%s\")".formatted(path);
+    }
+
+    /**
+     * 파일을 지정 경로에 씁니다.
+     *
+     * @param path    파일 경로
+     * @param content 파일 내용
+     * @param force   덮어쓰기 허용 여부
+     * @return 생성된 파일 경로
+     */
+    private Path writeFile(String path, String content, boolean force) {
+        Path filePath = Path.of(path);
+        if (Files.exists(filePath) && !force) {
+            throw new IllegalStateException("파일이 이미 존재합니다: " + path + " (덮어쓰려면 force 옵션을 사용하세요)");
+        }
+        try {
+            Files.createDirectories(filePath.getParent());
+            Files.writeString(filePath, content, StandardCharsets.UTF_8);
+            log.info("파일 생성: {}", filePath);
+        } catch (IOException e) {
+            throw new RuntimeException("파일 쓰기 실패: " + path, e);
+        }
+        return filePath;
+    }
+
+    private String capitalize(String s) {
+        if (s == null || s.isEmpty()) {
+            return s;
+        }
+        return Character.toUpperCase(s.charAt(0)) + s.substring(1);
+    }
+
+    /**
+     * param_type → Java 타입 변환
+     */
+    private String toJavaType(String paramType) {
+        if (paramType == null) {
+            return "String";
+        }
+        return switch (paramType.toUpperCase()) {
+            case "INTEGER" -> "Integer";
+            case "LONG" -> "Long";
+            case "BOOLEAN" -> "Boolean";
+            default -> "String";
+        };
+    }
+}
diff --git a/src/main/java/com/snp/batch/service/BypassConfigService.java b/src/main/java/com/snp/batch/service/BypassConfigService.java
new file mode 100644
index 0000000..b2bd54a
--- /dev/null
+++ b/src/main/java/com/snp/batch/service/BypassConfigService.java
@@ -0,0 +1,228 @@
+package com.snp.batch.service;
+
+import com.snp.batch.global.dto.BypassConfigRequest;
+import com.snp.batch.global.dto.BypassConfigResponse;
+import com.snp.batch.global.dto.BypassFieldDto;
+import com.snp.batch.global.dto.BypassParamDto;
+import com.snp.batch.global.model.BypassApiConfig;
+import com.snp.batch.global.model.BypassApiField;
+import com.snp.batch.global.model.BypassApiParam;
+import com.snp.batch.global.repository.BypassApiConfigRepository;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * BYPASS API 설정 CRUD 비즈니스 로직
+ */
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class BypassConfigService {
+
+    private final BypassApiConfigRepository configRepository;
+
+    /**
+     * 설정 목록 조회
+     *
+     * @return 전체 BYPASS API 설정 목록
+     */
+    public List<BypassConfigResponse> getConfigs() {
+        return configRepository.findAll().stream()
+                .map(this::toResponse)
+                .toList();
+    }
+
+    /**
+     * 설정 상세 조회
+     *
+     * @param id 설정 ID
+     * @return 설정 상세 정보
+     */
+    public BypassConfigResponse getConfig(Long id) {
+        BypassApiConfig config = configRepository.findById(id)
+                .orElseThrow(() -> new IllegalArgumentException("설정을 찾을 수 없습니다: " + id));
+        return toResponse(config);
+    }
+
+    /**
+     * 설정 등록
+     *
+     * @param request 등록 요청 DTO
+     * @return 등록된 설정 정보
+     */
+    @Transactional
+    public BypassConfigResponse createConfig(BypassConfigRequest request) {
+        if (configRepository.existsByDomainName(request.getDomainName())) {
+            throw new IllegalArgumentException("이미 존재하는 도메인입니다: " + request.getDomainName());
+        }
+        BypassApiConfig config = toEntity(request);
+
+        if (request.getParams() != null) {
+            request.getParams().forEach(p -> {
+                BypassApiParam param = toParamEntity(p);
+                param.setConfig(config);
+                config.getParams().add(param);
+            });
+        }
+        if (request.getFields() != null) {
+            request.getFields().forEach(f -> {
+                BypassApiField field = toFieldEntity(f);
+                field.setConfig(config);
+                config.getFields().add(field);
+            });
+        }
+        return toResponse(configRepository.save(config));
+    }
+
+    /**
+     * 설정 수정
+     *
+     * @param id      설정 ID
+     * @param request 수정 요청 DTO
+     * @return 수정된 설정 정보
+     */
+    @Transactional
+    public BypassConfigResponse updateConfig(Long id, BypassConfigRequest request) {
+        BypassApiConfig config = configRepository.findById(id)
+                .orElseThrow(() -> new IllegalArgumentException("설정을 찾을 수 없습니다: " + id));
+
+        config.setDomainName(request.getDomainName());
+        config.setDisplayName(request.getDisplayName());
+        config.setWebclientBean(request.getWebclientBean());
+        config.setExternalPath(request.getExternalPath());
+        config.setHttpMethod(request.getHttpMethod());
+        config.setResponseType(request.getResponseType());
+        config.setDescription(request.getDescription());
+
+        // params 교체 (orphanRemoval로 기존 자동 삭제)
+        config.getParams().clear();
+        if (request.getParams() != null) {
+            request.getParams().forEach(p -> {
+                BypassApiParam param = toParamEntity(p);
+                param.setConfig(config);
+                config.getParams().add(param);
+            });
+        }
+
+        // fields 교체
+        config.getFields().clear();
+        if (request.getFields() != null) {
+            request.getFields().forEach(f -> {
+                BypassApiField field = toFieldEntity(f);
+                field.setConfig(config);
+                config.getFields().add(field);
+            });
+        }
+
+        return toResponse(configRepository.save(config));
+    }
+
+    /**
+     * 설정 삭제
+     *
+     * @param id 설정 ID
+     */
+    @Transactional
+    public void deleteConfig(Long id) {
+        if (!configRepository.existsById(id)) {
+            throw new IllegalArgumentException("설정을 찾을 수 없습니다: " + id);
+        }
+        configRepository.deleteById(id);
+    }
+
+    /**
+     * 코드 생성 완료 마킹
+     *
+     * @param id 설정 ID
+     */
+    @Transactional
+    public void markAsGenerated(Long id) {
+        BypassApiConfig config = configRepository.findById(id)
+                .orElseThrow(() -> new IllegalArgumentException("설정을 찾을 수 없습니다: " + id));
+        config.setGenerated(true);
+        config.setGeneratedAt(LocalDateTime.now());
+        configRepository.save(config);
+    }
+
+    // ---- private 헬퍼 메서드 ----
+
+    private BypassConfigResponse toResponse(BypassApiConfig config) {
+        return BypassConfigResponse.builder()
+                .id(config.getId())
+                .domainName(config.getDomainName())
+                .displayName(config.getDisplayName())
+                .webclientBean(config.getWebclientBean())
+                .externalPath(config.getExternalPath())
+                .httpMethod(config.getHttpMethod())
+                .responseType(config.getResponseType())
+                .description(config.getDescription())
+                .generated(config.getGenerated())
+                .generatedAt(config.getGeneratedAt())
+                .createdAt(config.getCreatedAt())
+                .updatedAt(config.getUpdatedAt())
+                .params(config.getParams().stream().map(this::toParamDto).toList())
+                .fields(config.getFields().stream().map(this::toFieldDto).toList())
+                .build();
+    }
+
+    private BypassApiConfig toEntity(BypassConfigRequest request) {
+        return BypassApiConfig.builder()
+                .domainName(request.getDomainName())
+                .displayName(request.getDisplayName())
+                .webclientBean(request.getWebclientBean())
+                .externalPath(request.getExternalPath())
+                .httpMethod(request.getHttpMethod() != null ? request.getHttpMethod() : "GET")
+                .responseType(request.getResponseType() != null ? request.getResponseType() : "LIST")
+                .description(request.getDescription())
+                .build();
+    }
+
+    private BypassApiParam toParamEntity(BypassParamDto dto) {
+        return BypassApiParam.builder()
+                .paramName(dto.getParamName())
+                .paramType(dto.getParamType() != null ? dto.getParamType() : "STRING")
+                .paramIn(dto.getParamIn() != null ? dto.getParamIn() : "QUERY")
+                .required(dto.getRequired() != null ? dto.getRequired() : true)
+                .description(dto.getDescription())
+                .sortOrder(dto.getSortOrder() != null ? dto.getSortOrder() : 0)
+                .build();
+    }
+
+    private BypassApiField toFieldEntity(BypassFieldDto dto) {
+        return BypassApiField.builder()
+                .fieldName(dto.getFieldName())
+                .jsonProperty(dto.getJsonProperty())
+                .fieldType(dto.getFieldType() != null ? dto.getFieldType() : "String")
+                .description(dto.getDescription())
+                .sortOrder(dto.getSortOrder() != null ? dto.getSortOrder() : 0)
+                .build();
+    }
+
+    private BypassParamDto toParamDto(BypassApiParam param) {
+        return BypassParamDto.builder()
+                .id(param.getId())
+                .paramName(param.getParamName())
+                .paramType(param.getParamType())
+                .paramIn(param.getParamIn())
+                .required(param.getRequired())
+                .description(param.getDescription())
+                .sortOrder(param.getSortOrder())
+                .build();
+    }
+
+    private BypassFieldDto toFieldDto(BypassApiField field) {
+        return BypassFieldDto.builder()
+                .id(field.getId())
+                .fieldName(field.getFieldName())
+                .jsonProperty(field.getJsonProperty())
+                .fieldType(field.getFieldType())
+                .description(field.getDescription())
+                .sortOrder(field.getSortOrder())
+                .build();
+    }
+}
diff --git a/src/main/java/com/snp/batch/service/JsonSchemaParser.java b/src/main/java/com/snp/batch/service/JsonSchemaParser.java
new file mode 100644
index 0000000..1fca930
--- /dev/null
+++ b/src/main/java/com/snp/batch/service/JsonSchemaParser.java
@@ -0,0 +1,114 @@
+package com.snp.batch.service;
+
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.snp.batch.global.dto.BypassFieldDto;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * JSON 샘플 문자열에서 BypassFieldDto 목록을 추출하는 유틸리티 서비스.
+ * 1단계 깊이만 파싱하며, 중첩 객체는 Object 타입으로 처리합니다.
+ */
+@Slf4j
+@Service
+public class JsonSchemaParser {
+
+    private final ObjectMapper objectMapper;
+
+    public JsonSchemaParser(ObjectMapper objectMapper) {
+        this.objectMapper = objectMapper;
+    }
+
+    /**
+     * JSON 샘플 문자열에서 필드 목록을 추출합니다.
+     * 배열이면 첫 번째 요소를 파싱합니다.
+     * 1단계 깊이만 파싱하며, 중첩 객체는 Object 타입으로 처리합니다.
+     *
+     * @param jsonSample JSON 샘플 문자열
+     * @return 필드 목록 (파싱 실패 시 빈 목록 반환)
+     */
+    public List<BypassFieldDto> parse(String jsonSample) {
+        List<BypassFieldDto> result = new ArrayList<>();
+        try {
+            JsonNode root = objectMapper.readTree(jsonSample);
+
+            // 배열이면 첫 번째 요소 추출
+            JsonNode target = root.isArray() ? root.get(0) : root;
+            if (target == null || !target.isObject()) {
+                log.warn("JSON 파싱: 유효한 객체를 찾을 수 없습니다.");
+                return result;
+            }
+
+            int sortOrder = 0;
+            var fields = target.fields();
+            while (fields.hasNext()) {
+                var entry = fields.next();
+                String originalKey = entry.getKey();
+                String fieldName = toCamelCase(originalKey);
+                String fieldType = inferType(entry.getValue());
+
+                // jsonProperty: fieldName과 원본 키가 다를 때만 설정
+                String jsonProperty = fieldName.equals(originalKey) ? null : originalKey;
+
+                result.add(BypassFieldDto.builder()
+                        .fieldName(fieldName)
+                        .jsonProperty(jsonProperty)
+                        .fieldType(fieldType)
+                        .sortOrder(sortOrder++)
+                        .build());
+            }
+        } catch (Exception e) {
+            log.error("JSON 샘플 파싱 실패: {}", e.getMessage(), e);
+            return new ArrayList<>();
+        }
+        return result;
+    }
+
+    /**
+     * PascalCase → camelCase 변환 헬퍼
+     */
+    private String toCamelCase(String name) {
+        if (name == null || name.isEmpty()) {
+            return name;
+        }
+        if (Character.isUpperCase(name.charAt(0))) {
+            return Character.toLowerCase(name.charAt(0)) + name.substring(1);
+        }
+        return name;
+    }
+
+    /**
+     * JsonNode에서 Java 타입 추론
+     */
+    private String inferType(JsonNode node) {
+        if (node.isTextual()) {
+            return "String";
+        }
+        if (node.isInt()) {
+            return "Integer";
+        }
+        if (node.isLong() || (node.isNumber() && node.longValue() > Integer.MAX_VALUE)) {
+            return "Long";
+        }
+        if (node.isDouble() || node.isFloat()) {
+            return "Double";
+        }
+        if (node.isBoolean()) {
+            return "Boolean";
+        }
+        if (node.isNull()) {
+            return "String";
+        }
+        if (node.isArray()) {
+            return "List<Object>";
+        }
+        if (node.isObject()) {
+            return "Object";
+        }
+        return "String";
+    }
+}
-- 
2.45.2


From 9c393f9137c067972322059ed46aa331faeecdad Mon Sep 17 00:00:00 2001
From: HYOJIN <hjkim4@gcsc.co.kr>
Date: Thu, 26 Mar 2026 16:31:13 +0900
Subject: [PATCH 02/19] =?UTF-8?q?fix:=20JSON=20=EC=83=98=ED=94=8C=20?=
 =?UTF-8?q?=ED=8C=8C=EC=8B=B1=20=EC=8B=9C=20=EC=9D=B4=EC=A4=91=20=EC=A7=81?=
 =?UTF-8?q?=EB=A0=AC=ED=99=94=20=EB=AC=B8=EC=A0=9C=20=EC=88=98=EC=A0=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

parseJson API 호출 시 이미 JSON 문자열인 body를
JSON.stringify로 다시 감싸는 문제 수정

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 frontend/src/api/bypassApi.ts | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/frontend/src/api/bypassApi.ts b/frontend/src/api/bypassApi.ts
index 62ca2cc..29241e1 100644
--- a/frontend/src/api/bypassApi.ts
+++ b/frontend/src/api/bypassApi.ts
@@ -116,8 +116,15 @@ export const bypassApi = {
         deleteJson<ApiResponse<void>>(`${BASE}/${id}`),
     generateCode: (id: number, force = false) =>
         postJson<ApiResponse<CodeGenerationResult>>(`${BASE}/${id}/generate?force=${force}`),
-    parseJson: (jsonSample: string) =>
-        postJson<ApiResponse<BypassFieldDto[]>>(`${BASE}/parse-json`, jsonSample),
+    parseJson: async (jsonSample: string): Promise<ApiResponse<BypassFieldDto[]>> => {
+        const res = await fetch(`${BASE}/parse-json`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: jsonSample, // 이미 JSON 문자열이므로 JSON.stringify 하지 않음
+        });
+        if (!res.ok) throw new Error(`API Error: ${res.status} ${res.statusText}`);
+        return res.json();
+    },
     getWebclientBeans: () =>
         fetchJson<ApiResponse<WebClientBeanInfo[]>>(`${BASE}/webclient-beans`),
 };
-- 
2.45.2


From d2932f4032f097ca1c0b31169971078912f3f6a2 Mon Sep 17 00:00:00 2001
From: HYOJIN <hjkim4@gcsc.co.kr>
Date: Thu, 26 Mar 2026 16:44:50 +0900
Subject: [PATCH 03/19] =?UTF-8?q?fix:=20=EC=BD=94=EB=93=9C=20=EC=83=9D?=
 =?UTF-8?q?=EC=84=B1=EA=B8=B0=20=ED=85=9C=ED=94=8C=EB=A6=BF=20MissingForma?=
 =?UTF-8?q?tArgumentException=20=EC=88=98=EC=A0=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

String.formatted() %s 플레이스홀더 방식에서
명명된 플레이스홀더 {{}} + String.replace() 방식으로 변경

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .../batch/service/BypassCodeGenerator.java    | 179 +++++++++---------
 1 file changed, 85 insertions(+), 94 deletions(-)

diff --git a/src/main/java/com/snp/batch/service/BypassCodeGenerator.java b/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
index 1880bf4..fb7c299 100644
--- a/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
+++ b/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
@@ -84,23 +84,27 @@ public class BypassCodeGenerator {
         StringBuilder fieldLines = new StringBuilder();
         for (BypassApiField field : fields) {
             String jsonProp = field.getJsonProperty() != null ? field.getJsonProperty() : field.getFieldName();
-            fieldLines.append("    @JsonProperty(\"%s\")\n".formatted(jsonProp));
-            fieldLines.append("    private %s %s;\n\n".formatted(field.getFieldType(), field.getFieldName()));
+            fieldLines.append("    @JsonProperty(\"").append(jsonProp).append("\")\n");
+            fieldLines.append("    private ").append(field.getFieldType()).append(" ").append(field.getFieldName()).append(";\n\n");
         }
 
         return """
-                package %s;
+                package {{PACKAGE}};
 
-                %s
+                {{IMPORTS}}
                 @Getter
                 @Setter
                 @Builder
                 @NoArgsConstructor
                 @AllArgsConstructor
-                public class %sBypassDto {
+                public class {{CLASS_NAME}} {
 
-                %s}
-                """.formatted(packageName, imports, domainCap, fieldLines);
+                {{FIELDS}}}
+                """
+                .replace("{{PACKAGE}}", packageName)
+                .replace("{{IMPORTS}}", imports.toString())
+                .replace("{{CLASS_NAME}}", domainCap + "BypassDto")
+                .replace("{{FIELDS}}", fieldLines.toString());
     }
 
     /**
@@ -115,7 +119,7 @@ public class BypassCodeGenerator {
         boolean isList = "LIST".equalsIgnoreCase(config.getResponseType());
         boolean isPost = "POST".equalsIgnoreCase(config.getHttpMethod());
 
-        String returnType = isList ? "List<%s>".formatted(dtoClass) : dtoClass;
+        String returnType = isList ? "List<" + dtoClass + ">" : dtoClass;
         String methodName = "get" + domainCap + "Data";
         String fetchMethod = buildFetchMethodCall(config, params, isList, isPost);
         String methodParams = buildMethodParams(params);
@@ -123,52 +127,51 @@ public class BypassCodeGenerator {
         String listImport = isList ? "import java.util.List;\n" : "";
 
         return """
-                package %s;
+                package {{PACKAGE}};
 
-                import %s.%s;
+                import {{DTO_IMPORT}};
                 import com.snp.batch.common.web.service.BaseBypassService;
-                %simport org.springframework.beans.factory.annotation.Qualifier;
+                {{LIST_IMPORT}}import org.springframework.beans.factory.annotation.Qualifier;
                 import org.springframework.core.ParameterizedTypeReference;
                 import org.springframework.stereotype.Service;
                 import org.springframework.web.reactive.function.client.WebClient;
 
                 /**
-                 * %s bypass 서비스
+                 * {{DISPLAY_NAME}} bypass 서비스
                  * 외부 Maritime API에서 데이터를 실시간 조회하여 그대로 반환
                  */
                 @Service
-                public class %sBypassService extends BaseBypassService<%s> {
+                public class {{DOMAIN_CAP}}BypassService extends BaseBypassService<{{DTO_CLASS}}> {
 
-                    public %sBypassService(
-                            @Qualifier("%s") WebClient webClient) {
-                        super(webClient, "%s", "%s",
+                    public {{DOMAIN_CAP}}BypassService(
+                            @Qualifier("{{WEBCLIENT_BEAN}}") WebClient webClient) {
+                        super(webClient, "{{DISPLAY_NAME}}", "{{EXTERNAL_PATH}}",
                                 new ParameterizedTypeReference<>() {},
                                 new ParameterizedTypeReference<>() {});
                     }
 
                     /**
-                     * %s 데이터를 조회합니다.
+                     * {{DISPLAY_NAME}} 데이터를 조회합니다.
                      *
-                     * @return %s
+                     * @return {{DISPLAY_NAME}}
                      */
-                    public %s %s(%s) {
-                        %s
+                    public {{RETURN_TYPE}} {{METHOD_NAME}}({{METHOD_PARAMS}}) {
+                        {{FETCH_METHOD}}
                     }
                 }
-                """.formatted(
-                packageName,
-                dtoPackage, dtoClass,
-                listImport,
-                config.getDisplayName(),
-                domainCap, dtoClass,
-                domainCap,
-                config.getWebclientBean(),
-                config.getExternalPath(),
-                config.getDisplayName(),
-                config.getDisplayName(),
-                returnType, methodName, methodParams,
-                fetchMethod
-        );
+                """
+                .replace("{{PACKAGE}}", packageName)
+                .replace("{{DTO_IMPORT}}", dtoPackage + "." + dtoClass)
+                .replace("{{LIST_IMPORT}}", listImport)
+                .replace("{{DISPLAY_NAME}}", config.getDisplayName())
+                .replace("{{DOMAIN_CAP}}", domainCap)
+                .replace("{{DTO_CLASS}}", dtoClass)
+                .replace("{{WEBCLIENT_BEAN}}", config.getWebclientBean())
+                .replace("{{EXTERNAL_PATH}}", config.getExternalPath())
+                .replace("{{RETURN_TYPE}}", returnType)
+                .replace("{{METHOD_NAME}}", methodName)
+                .replace("{{METHOD_PARAMS}}", methodParams)
+                .replace("{{FETCH_METHOD}}", fetchMethod);
     }
 
     /**
@@ -187,7 +190,7 @@ public class BypassCodeGenerator {
         boolean isList = "LIST".equalsIgnoreCase(config.getResponseType());
         boolean isPost = "POST".equalsIgnoreCase(config.getHttpMethod());
 
-        String responseGeneric = isList ? "List<%s>".formatted(dtoClass) : dtoClass;
+        String responseGeneric = isList ? "List<" + dtoClass + ">" : dtoClass;
         String mappingAnnotation = isPost ? "@PostMapping" : "@GetMapping";
         String listImport = isList ? "import java.util.List;\n" : "";
 
@@ -205,59 +208,58 @@ public class BypassCodeGenerator {
         String requestMappingPath = "/api/" + domain;
 
         return """
-                package %s;
+                package {{PACKAGE}};
 
-                import %s.%s;
-                import %s.%s;
+                import {{DTO_IMPORT}};
+                import {{SERVICE_IMPORT}};
                 import com.snp.batch.common.web.ApiResponse;
                 import com.snp.batch.common.web.controller.BaseBypassController;
                 import io.swagger.v3.oas.annotations.Operation;
                 import io.swagger.v3.oas.annotations.Parameter;
                 import io.swagger.v3.oas.annotations.tags.Tag;
-                %simport lombok.RequiredArgsConstructor;
+                {{LIST_IMPORT}}import lombok.RequiredArgsConstructor;
                 import org.springframework.http.ResponseEntity;
                 import org.springframework.web.bind.annotation.RequestMapping;
                 import org.springframework.web.bind.annotation.RestController;
-                %s%s%s%s
+                {{PATH_VARIABLE_IMPORT}}{{REQUEST_PARAM_IMPORT}}{{REQUEST_BODY_IMPORT}}
                 /**
-                 * %s bypass API
+                 * {{DISPLAY_NAME}} bypass API
                  * S&P Maritime API에서 데이터를 실시간 조회하여 그대로 반환
                  */
                 @RestController
-                @RequestMapping("%s")
+                @RequestMapping("{{REQUEST_MAPPING_PATH}}")
                 @RequiredArgsConstructor
-                @Tag(name = "%s", description = "%s bypass API")
-                public class %sController extends BaseBypassController {
+                @Tag(name = "{{DOMAIN_CAP}}", description = "{{DISPLAY_NAME}} bypass API")
+                public class {{DOMAIN_CAP}}Controller extends BaseBypassController {
 
-                    private final %s %s;
+                    private final {{SERVICE_CLASS}} {{SERVICE_FIELD}};
 
                     @Operation(
-                            summary = "%s 조회",
-                            description = "S&P API에서 %s 데이터를 요청하고 응답을 그대로 반환합니다."
+                            summary = "{{DISPLAY_NAME}} 조회",
+                            description = "S&P API에서 {{DISPLAY_NAME}} 데이터를 요청하고 응답을 그대로 반환합니다."
                     )
-                    %s
-                    public ResponseEntity<ApiResponse<%s>> get%sData(%s) {
-                        return execute(() -> %s.get%sData(%s));
+                    {{MAPPING_ANNOTATION}}
+                    public ResponseEntity<ApiResponse<{{RESPONSE_GENERIC}}>> get{{DOMAIN_CAP}}Data({{PARAM_ANNOTATIONS}}) {
+                        return execute(() -> {{SERVICE_FIELD}}.get{{DOMAIN_CAP}}Data({{SERVICE_CALL_ARGS}}));
                     }
                 }
-                """.formatted(
-                packageName,
-                dtoPackage, dtoClass,
-                servicePackage, serviceClass,
-                listImport,
-                pathVariableImport, requestParamImport, requestBodyImport,
-                mappingAnnotation.equals("@PostMapping") ? "" : "",
-                config.getDisplayName(),
-                requestMappingPath,
-                domainCap, config.getDisplayName(),
-                domainCap,
-                serviceClass, serviceField,
-                config.getDisplayName(), config.getDisplayName(),
-                mappingAnnotation + mappingPath,
-                responseGeneric, domainCap,
-                paramAnnotations.isEmpty() ? "" : paramAnnotations,
-                serviceField, domainCap, serviceCallArgs
-        );
+                """
+                .replace("{{PACKAGE}}", packageName)
+                .replace("{{DTO_IMPORT}}", dtoPackage + "." + dtoClass)
+                .replace("{{SERVICE_IMPORT}}", servicePackage + "." + serviceClass)
+                .replace("{{LIST_IMPORT}}", listImport)
+                .replace("{{PATH_VARIABLE_IMPORT}}", pathVariableImport)
+                .replace("{{REQUEST_PARAM_IMPORT}}", requestParamImport)
+                .replace("{{REQUEST_BODY_IMPORT}}", requestBodyImport)
+                .replace("{{DISPLAY_NAME}}", config.getDisplayName())
+                .replace("{{DOMAIN_CAP}}", domainCap)
+                .replace("{{REQUEST_MAPPING_PATH}}", requestMappingPath)
+                .replace("{{SERVICE_CLASS}}", serviceClass)
+                .replace("{{SERVICE_FIELD}}", serviceField)
+                .replace("{{MAPPING_ANNOTATION}}", mappingAnnotation + mappingPath)
+                .replace("{{RESPONSE_GENERIC}}", responseGeneric)
+                .replace("{{PARAM_ANNOTATIONS}}", paramAnnotations.isEmpty() ? "" : paramAnnotations)
+                .replace("{{SERVICE_CALL_ARGS}}", serviceCallArgs);
     }
 
     /**
@@ -265,10 +267,6 @@ public class BypassCodeGenerator {
      */
     private String buildFetchMethodCall(BypassApiConfig config, List<BypassApiParam> params,
                                          boolean isList, boolean isPost) {
-        List<BypassApiParam> pathParams = params.stream()
-                .filter(p -> "PATH".equalsIgnoreCase(p.getParamIn()))
-                .sorted((a, b) -> Integer.compare(a.getSortOrder(), b.getSortOrder()))
-                .toList();
         List<BypassApiParam> queryParams = params.stream()
                 .filter(p -> "QUERY".equalsIgnoreCase(p.getParamIn()))
                 .sorted((a, b) -> Integer.compare(a.getSortOrder(), b.getSortOrder()))
@@ -276,12 +274,9 @@ public class BypassCodeGenerator {
 
         StringBuilder uriBuilder = new StringBuilder();
         uriBuilder.append("uri -> uri.path(getApiPath())");
-        for (BypassApiParam p : pathParams) {
-            // PATH 파라미터는 path()에 직접 치환되므로 별도 처리 불필요
-        }
         for (BypassApiParam p : queryParams) {
-            uriBuilder.append("\n                        .queryParam(\"%s\", %s)"
-                    .formatted(p.getParamName(), p.getParamName()));
+            uriBuilder.append("\n                        .queryParam(\"")
+                    .append(p.getParamName()).append("\", ").append(p.getParamName()).append(")");
         }
         uriBuilder.append("\n                        .build()");
 
@@ -292,10 +287,10 @@ public class BypassCodeGenerator {
                     .filter(p -> "BODY".equalsIgnoreCase(p.getParamIn()))
                     .findFirst().orElse(null);
             String bodyArg = bodyParam != null ? bodyParam.getParamName() : "null";
-            return "return %s(%s, %s);".formatted(fetchName, bodyArg, uriBuilder);
+            return "return " + fetchName + "(" + bodyArg + ", " + uriBuilder + ");";
         } else {
             fetchName = isList ? "fetchGetList" : "fetchGetOne";
-            return "return %s(%s);".formatted(fetchName, uriBuilder);
+            return "return " + fetchName + "(" + uriBuilder + ");";
         }
     }
 
@@ -329,24 +324,20 @@ public class BypassCodeGenerator {
         return params.stream()
                 .sorted((a, b) -> Integer.compare(a.getSortOrder(), b.getSortOrder()))
                 .map(p -> {
-                    String annotation;
                     String description = p.getDescription() != null ? p.getDescription() : p.getParamName();
-                    switch (p.getParamIn().toUpperCase()) {
-                        case "PATH" -> annotation = """
-                                @Parameter(description = "%s")
-                                @PathVariable %s %s""".formatted(description, toJavaType(p.getParamType()), p.getParamName());
-                        case "BODY" -> annotation = """
-                                @Parameter(description = "%s")
-                                @RequestBody %s %s""".formatted(description, toJavaType(p.getParamType()), p.getParamName());
+                    String javaType = toJavaType(p.getParamType());
+                    String paramName = p.getParamName();
+                    return switch (p.getParamIn().toUpperCase()) {
+                        case "PATH" -> "@Parameter(description = \"" + description + "\")\n"
+                                + "                @PathVariable " + javaType + " " + paramName;
+                        case "BODY" -> "@Parameter(description = \"" + description + "\")\n"
+                                + "                @RequestBody " + javaType + " " + paramName;
                         default -> {
                             String required = Boolean.TRUE.equals(p.getRequired()) ? "true" : "false";
-                            annotation = """
-                                @Parameter(description = "%s")
-                                @RequestParam(required = %s) %s %s""".formatted(
-                                    description, required, toJavaType(p.getParamType()), p.getParamName());
+                            yield "@Parameter(description = \"" + description + "\")\n"
+                                    + "                @RequestParam(required = " + required + ") " + javaType + " " + paramName;
                         }
-                    }
-                    return annotation;
+                    };
                 })
                 .collect(Collectors.joining(",\n            "));
     }
@@ -365,7 +356,7 @@ public class BypassCodeGenerator {
         String path = pathParams.stream()
                 .map(p -> "{" + p.getParamName() + "}")
                 .collect(Collectors.joining("/", "/", ""));
-        return "(\"%s\")".formatted(path);
+        return "(\"" + path + "\")";
     }
 
     /**
-- 
2.45.2


From aabb235ac714df8031f74d7ebd73f7528ef55316 Mon Sep 17 00:00:00 2001
From: HYOJIN <hjkim4@gcsc.co.kr>
Date: Thu, 26 Mar 2026 16:50:01 +0900
Subject: [PATCH 04/19] =?UTF-8?q?fix:=20=EC=BD=94=EB=93=9C=20=EC=83=9D?=
 =?UTF-8?q?=EC=84=B1=EA=B8=B0=20GetMapping/PostMapping=20import=20?=
 =?UTF-8?q?=EB=88=84=EB=9D=BD=20=EC=88=98=EC=A0=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

생성되는 Controller에 GetMapping/PostMapping import가
포함되지 않는 문제 수정

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .../controller/ComplianceController.java      | 39 +++++++++++++++++++
 .../batch/service/BypassCodeGenerator.java    |  6 ++-
 2 files changed, 44 insertions(+), 1 deletion(-)
 create mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/controller/ComplianceController.java

diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/controller/ComplianceController.java b/src/main/java/com/snp/batch/jobs/web/compliance/controller/ComplianceController.java
new file mode 100644
index 0000000..f1a55f2
--- /dev/null
+++ b/src/main/java/com/snp/batch/jobs/web/compliance/controller/ComplianceController.java
@@ -0,0 +1,39 @@
+package com.snp.batch.jobs.web.compliance.controller;
+
+import com.snp.batch.jobs.web.compliance.dto.ComplianceBypassDto;
+import com.snp.batch.jobs.web.compliance.service.ComplianceBypassService;
+import com.snp.batch.common.web.ApiResponse;
+import com.snp.batch.common.web.controller.BaseBypassController;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import java.util.List;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+import org.springframework.web.bind.annotation.RequestParam;
+
+/**
+ * IMO 기반 선박 Compliance 조회 bypass API
+ * S&P Maritime API에서 데이터를 실시간 조회하여 그대로 반환
+ */
+@RestController
+@RequestMapping("/api/compliance")
+@RequiredArgsConstructor
+@Tag(name = "Compliance", description = "IMO 기반 선박 Compliance 조회 bypass API")
+public class ComplianceController extends BaseBypassController {
+
+    private final ComplianceBypassService complianceBypassService;
+
+    @Operation(
+            summary = "IMO 기반 선박 Compliance 조회 조회",
+            description = "S&P API에서 IMO 기반 선박 Compliance 조회 데이터를 요청하고 응답을 그대로 반환합니다."
+    )
+    @GetMapping
+    public ResponseEntity<ApiResponse<List<ComplianceBypassDto>>> getComplianceData(@Parameter(description = "IMO(최대 100개)")
+                @RequestParam(required = true) String imos) {
+        return execute(() -> complianceBypassService.getComplianceData(imos));
+    }
+}
diff --git a/src/main/java/com/snp/batch/service/BypassCodeGenerator.java b/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
index fb7c299..56ee53c 100644
--- a/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
+++ b/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
@@ -203,6 +203,9 @@ public class BypassCodeGenerator {
                 ? "import org.springframework.web.bind.annotation.RequestParam;\n" : "";
         String requestBodyImport = isPost
                 ? "import org.springframework.web.bind.annotation.RequestBody;\n" : "";
+        String mappingImport = isPost
+                ? "import org.springframework.web.bind.annotation.PostMapping;\n"
+                : "import org.springframework.web.bind.annotation.GetMapping;\n";
 
         String mappingPath = buildMappingPath(params);
         String requestMappingPath = "/api/" + domain;
@@ -221,7 +224,7 @@ public class BypassCodeGenerator {
                 import org.springframework.http.ResponseEntity;
                 import org.springframework.web.bind.annotation.RequestMapping;
                 import org.springframework.web.bind.annotation.RestController;
-                {{PATH_VARIABLE_IMPORT}}{{REQUEST_PARAM_IMPORT}}{{REQUEST_BODY_IMPORT}}
+                {{MAPPING_IMPORT}}{{PATH_VARIABLE_IMPORT}}{{REQUEST_PARAM_IMPORT}}{{REQUEST_BODY_IMPORT}}
                 /**
                  * {{DISPLAY_NAME}} bypass API
                  * S&P Maritime API에서 데이터를 실시간 조회하여 그대로 반환
@@ -251,6 +254,7 @@ public class BypassCodeGenerator {
                 .replace("{{PATH_VARIABLE_IMPORT}}", pathVariableImport)
                 .replace("{{REQUEST_PARAM_IMPORT}}", requestParamImport)
                 .replace("{{REQUEST_BODY_IMPORT}}", requestBodyImport)
+                .replace("{{MAPPING_IMPORT}}", mappingImport)
                 .replace("{{DISPLAY_NAME}}", config.getDisplayName())
                 .replace("{{DOMAIN_CAP}}", domainCap)
                 .replace("{{REQUEST_MAPPING_PATH}}", requestMappingPath)
-- 
2.45.2


From 91cb3eea19f10c4feff7ca257187f615f26a7e14 Mon Sep 17 00:00:00 2001
From: HYOJIN <hjkim4@gcsc.co.kr>
Date: Thu, 26 Mar 2026 16:58:47 +0900
Subject: [PATCH 05/19] =?UTF-8?q?fix:=20=EC=BD=94=EB=93=9C=20=EC=83=9D?=
 =?UTF-8?q?=EC=84=B1=EA=B8=B0=20super()=20=EC=9D=B8=EC=9E=90=20=EC=88=9C?=
 =?UTF-8?q?=EC=84=9C=20=EC=88=98=EC=A0=95=20(apiPath,=20displayName)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

BaseBypassService 생성자의 apiPath와 displayName 순서가
뒤바뀌어 외부 API 경로 대신 표시명이 URL로 사용되는 문제 수정

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .../service/ComplianceBypassService.java      | 35 +++++++++++++++++++
 .../batch/service/BypassCodeGenerator.java    |  2 +-
 2 files changed, 36 insertions(+), 1 deletion(-)
 create mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/service/ComplianceBypassService.java

diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/service/ComplianceBypassService.java b/src/main/java/com/snp/batch/jobs/web/compliance/service/ComplianceBypassService.java
new file mode 100644
index 0000000..67f27d2
--- /dev/null
+++ b/src/main/java/com/snp/batch/jobs/web/compliance/service/ComplianceBypassService.java
@@ -0,0 +1,35 @@
+package com.snp.batch.jobs.web.compliance.service;
+
+import com.snp.batch.jobs.web.compliance.dto.ComplianceBypassDto;
+import com.snp.batch.common.web.service.BaseBypassService;
+import java.util.List;
+import org.springframework.beans.factory.annotation.Qualifier;
+import org.springframework.core.ParameterizedTypeReference;
+import org.springframework.stereotype.Service;
+import org.springframework.web.reactive.function.client.WebClient;
+
+/**
+ * IMO 기반 선박 Compliance 조회 bypass 서비스
+ * 외부 Maritime API에서 데이터를 실시간 조회하여 그대로 반환
+ */
+@Service
+public class ComplianceBypassService extends BaseBypassService<ComplianceBypassDto> {
+
+    public ComplianceBypassService(
+            @Qualifier("maritimeServiceApiWebClient") WebClient webClient) {
+        super(webClient, "/RiskAndCompliance/CompliancesByImos", "IMO 기반 선박 Compliance 조회",
+                new ParameterizedTypeReference<>() {},
+                new ParameterizedTypeReference<>() {});
+    }
+
+    /**
+     * IMO 기반 선박 Compliance 조회 데이터를 조회합니다.
+     *
+     * @return IMO 기반 선박 Compliance 조회
+     */
+    public List<ComplianceBypassDto> getComplianceData(String imos) {
+        return fetchGetList(uri -> uri.path(getApiPath())
+                        .queryParam("imos", imos)
+                        .build());
+    }
+}
diff --git a/src/main/java/com/snp/batch/service/BypassCodeGenerator.java b/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
index 56ee53c..c39e33d 100644
--- a/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
+++ b/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
@@ -145,7 +145,7 @@ public class BypassCodeGenerator {
 
                     public {{DOMAIN_CAP}}BypassService(
                             @Qualifier("{{WEBCLIENT_BEAN}}") WebClient webClient) {
-                        super(webClient, "{{DISPLAY_NAME}}", "{{EXTERNAL_PATH}}",
+                        super(webClient, "{{EXTERNAL_PATH}}", "{{DISPLAY_NAME}}",
                                 new ParameterizedTypeReference<>() {},
                                 new ParameterizedTypeReference<>() {});
                     }
-- 
2.45.2


From b86b063664493d36585f4cb944cf5b8d3bc05684 Mon Sep 17 00:00:00 2001
From: HYOJIN <hjkim4@gcsc.co.kr>
Date: Thu, 26 Mar 2026 17:17:16 +0900
Subject: [PATCH 06/19] =?UTF-8?q?fix:=20=EB=82=B4=EB=B6=80=20API=20?=
 =?UTF-8?q?=EA=B2=BD=EB=A1=9C=EC=97=90=20externalPath=20=EB=A7=88=EC=A7=80?=
 =?UTF-8?q?=EB=A7=89=20=EC=84=B8=EA=B7=B8=EB=A8=BC=ED=8A=B8=20=EB=B0=98?=
 =?UTF-8?q?=EC=98=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

/RiskAndCompliance/CompliancesByImos 등록 시
/api/compliance → /api/compliance/CompliancesByImos 로 생성되도록 변경

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .../controller/ComplianceController.java      |  4 +--
 .../batch/service/BypassCodeGenerator.java    | 31 ++++++++++++++-----
 2 files changed, 25 insertions(+), 10 deletions(-)

diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/controller/ComplianceController.java b/src/main/java/com/snp/batch/jobs/web/compliance/controller/ComplianceController.java
index f1a55f2..f88b107 100644
--- a/src/main/java/com/snp/batch/jobs/web/compliance/controller/ComplianceController.java
+++ b/src/main/java/com/snp/batch/jobs/web/compliance/controller/ComplianceController.java
@@ -10,9 +10,9 @@ import io.swagger.v3.oas.annotations.tags.Tag;
 import java.util.List;
 import lombok.RequiredArgsConstructor;
 import org.springframework.http.ResponseEntity;
-import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
+import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RequestParam;
 
 /**
@@ -31,7 +31,7 @@ public class ComplianceController extends BaseBypassController {
             summary = "IMO 기반 선박 Compliance 조회 조회",
             description = "S&P API에서 IMO 기반 선박 Compliance 조회 데이터를 요청하고 응답을 그대로 반환합니다."
     )
-    @GetMapping
+    @GetMapping("/CompliancesByImos")
     public ResponseEntity<ApiResponse<List<ComplianceBypassDto>>> getComplianceData(@Parameter(description = "IMO(최대 100개)")
                 @RequestParam(required = true) String imos) {
         return execute(() -> complianceBypassService.getComplianceData(imos));
diff --git a/src/main/java/com/snp/batch/service/BypassCodeGenerator.java b/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
index c39e33d..1088079 100644
--- a/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
+++ b/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
@@ -207,7 +207,7 @@ public class BypassCodeGenerator {
                 ? "import org.springframework.web.bind.annotation.PostMapping;\n"
                 : "import org.springframework.web.bind.annotation.GetMapping;\n";
 
-        String mappingPath = buildMappingPath(params);
+        String mappingPath = buildMappingPath(params, config.getExternalPath());
         String requestMappingPath = "/api/" + domain;
 
         return """
@@ -347,20 +347,35 @@ public class BypassCodeGenerator {
     }
 
     /**
-     * @GetMapping / @PostMapping에 붙는 경로 생성 (PATH 파라미터가 있는 경우)
+     * @GetMapping / @PostMapping에 붙는 경로 생성
+     * externalPath의 마지막 세그먼트를 내부 경로로 사용 + PATH 파라미터 추가
+     * 예: /RiskAndCompliance/CompliancesByImos → ("/CompliancesByImos")
+     *     PATH 파라미터 imo 추가 시 → ("/CompliancesByImos/{imo}")
      */
-    private String buildMappingPath(List<BypassApiParam> params) {
+    private String buildMappingPath(List<BypassApiParam> params, String externalPath) {
+        // externalPath에서 마지막 세그먼트 추출
+        String endpointSegment = "";
+        if (externalPath != null && !externalPath.isEmpty()) {
+            String[] segments = externalPath.split("/");
+            if (segments.length > 0) {
+                endpointSegment = "/" + segments[segments.length - 1];
+            }
+        }
+
+        // PATH 파라미터 추가
         List<BypassApiParam> pathParams = params.stream()
                 .filter(p -> "PATH".equalsIgnoreCase(p.getParamIn()))
                 .sorted((a, b) -> Integer.compare(a.getSortOrder(), b.getSortOrder()))
                 .toList();
-        if (pathParams.isEmpty()) {
+        String pathSuffix = pathParams.stream()
+                .map(p -> "{" + p.getParamName() + "}")
+                .collect(Collectors.joining("/", pathParams.isEmpty() ? "" : "/", ""));
+
+        String fullPath = endpointSegment + pathSuffix;
+        if (fullPath.isEmpty()) {
             return "";
         }
-        String path = pathParams.stream()
-                .map(p -> "{" + p.getParamName() + "}")
-                .collect(Collectors.joining("/", "/", ""));
-        return "(\"" + path + "\")";
+        return "(\"" + fullPath + "\")";
     }
 
     /**
-- 
2.45.2


From 0132408ae3d786d957ee3c26f0b3f74145d1f12a Mon Sep 17 00:00:00 2001
From: HYOJIN <hjkim4@gcsc.co.kr>
Date: Thu, 26 Mar 2026 17:43:06 +0900
Subject: [PATCH 07/19] =?UTF-8?q?feat:=20Bypass=20API=20=ED=99=94=EB=A9=B4?=
 =?UTF-8?q?=20=EA=B0=9C=EC=84=A0=20=EB=B0=8F=20Swagger=20=EA=B7=B8?=
 =?UTF-8?q?=EB=A3=B9=20=EB=B6=84=EB=A6=AC=20(#63)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

프론트엔드:
- DTO 필드 입력 폼에 필드 번호(#N) 및 총 카운트 표시
- List View(테이블 뷰) 추가 및 카드/테이블 뷰 전환
- 실시간 검색 기능 추가 (도메인명, 표시명)

Swagger:
- GroupedOpenApi로 그룹 분리 (Batch Management, Bypass Config, Bypass API)
- 코드 생성 시 @Tag에 WebClient 종류 접두사 추가
- 코드 생성 시 @Parameter에 example 기본값 설정

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .../components/bypass/BypassStepFields.tsx    |  11 +
 frontend/src/pages/BypassConfig.tsx           | 215 +++++++++++++++++-
 .../batch/global/config/SwaggerConfig.java    |  26 +++
 .../web/risk/controller/RiskController.java   |   2 +-
 .../batch/service/BypassCodeGenerator.java    |  39 +++-
 5 files changed, 284 insertions(+), 9 deletions(-)

diff --git a/frontend/src/components/bypass/BypassStepFields.tsx b/frontend/src/components/bypass/BypassStepFields.tsx
index db4b6d9..cacc8f3 100644
--- a/frontend/src/components/bypass/BypassStepFields.tsx
+++ b/frontend/src/components/bypass/BypassStepFields.tsx
@@ -110,9 +110,15 @@ export default function BypassStepFields({ fields, onChange }: BypassStepFieldsP
                         </div>
                     ) : (
                         <div className="overflow-x-auto">
+                            <div className="mb-2 flex items-center justify-between">
+                                <span className="text-xs text-wing-muted">
+                                    총 <span className="font-semibold text-wing-text">{fields.length}</span>개 필드
+                                </span>
+                            </div>
                             <table className="w-full text-sm">
                                 <thead>
                                     <tr className="border-b border-wing-border">
+                                        <th className="pb-2 text-left font-medium text-wing-muted pr-3 w-10">#</th>
                                         <th className="pb-2 text-left font-medium text-wing-muted pr-3 min-w-[130px]">필드명</th>
                                         <th className="pb-2 text-left font-medium text-wing-muted pr-3 min-w-[130px]">JSON Property</th>
                                         <th className="pb-2 text-left font-medium text-wing-muted pr-3 min-w-[150px]">타입</th>
@@ -123,6 +129,11 @@ export default function BypassStepFields({ fields, onChange }: BypassStepFieldsP
                                 <tbody className="divide-y divide-wing-border">
                                     {fields.map((field, index) => (
                                         <tr key={index} className="group">
+                                            <td className="py-2 pr-3">
+                                                <span className="text-xs font-medium text-wing-muted tabular-nums">
+                                                    #{index + 1}
+                                                </span>
+                                            </td>
                                             <td className="py-2 pr-3">
                                                 <input
                                                     type="text"
diff --git a/frontend/src/pages/BypassConfig.tsx b/frontend/src/pages/BypassConfig.tsx
index 4b9a8eb..aa211a4 100644
--- a/frontend/src/pages/BypassConfig.tsx
+++ b/frontend/src/pages/BypassConfig.tsx
@@ -1,4 +1,4 @@
-import { useState, useEffect, useCallback } from 'react';
+import { useState, useEffect, useCallback, useMemo } from 'react';
 import {
     bypassApi,
     type BypassConfigRequest,
@@ -17,6 +17,8 @@ interface ConfirmAction {
     config: BypassConfigResponse;
 }
 
+type ViewMode = 'card' | 'table';
+
 const HTTP_METHOD_COLORS: Record<string, string> = {
     GET: 'bg-emerald-100 text-emerald-700',
     POST: 'bg-blue-100 text-blue-700',
@@ -30,6 +32,8 @@ export default function BypassConfig() {
     const [configs, setConfigs] = useState<BypassConfigResponse[]>([]);
     const [loading, setLoading] = useState(true);
     const [webclientBeans, setWebclientBeans] = useState<WebClientBeanInfo[]>([]);
+    const [viewMode, setViewMode] = useState<ViewMode>('card');
+    const [searchTerm, setSearchTerm] = useState('');
 
     const [modalOpen, setModalOpen] = useState(false);
     const [editConfig, setEditConfig] = useState<BypassConfigResponse | null>(null);
@@ -106,6 +110,16 @@ export default function BypassConfig() {
         }
     };
 
+    const filteredConfigs = useMemo(() => {
+        if (!searchTerm.trim()) return configs;
+        const term = searchTerm.toLowerCase();
+        return configs.filter(
+            (c) =>
+                c.domainName.toLowerCase().includes(term) ||
+                c.displayName.toLowerCase().includes(term),
+        );
+    }, [configs, searchTerm]);
+
     if (loading) return <LoadingSpinner />;
 
     return (
@@ -127,15 +141,102 @@ export default function BypassConfig() {
                 </button>
             </div>
 
-            {/* 카드 그리드 */}
+            {/* 검색 + 뷰 전환 */}
+            <div className="bg-wing-surface rounded-xl shadow-md p-4">
+                <div className="flex gap-3 items-center flex-wrap">
+                    {/* 검색 */}
+                    <div className="relative flex-1 min-w-[200px]">
+                        <span className="absolute inset-y-0 left-3 flex items-center text-wing-muted">
+                            <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path
+                                    strokeLinecap="round"
+                                    strokeLinejoin="round"
+                                    strokeWidth={2}
+                                    d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z"
+                                />
+                            </svg>
+                        </span>
+                        <input
+                            type="text"
+                            placeholder="도메인명, 표시명으로 검색..."
+                            value={searchTerm}
+                            onChange={(e) => setSearchTerm(e.target.value)}
+                            className="w-full pl-10 pr-4 py-2 border border-wing-border rounded-lg text-sm
+                                focus:ring-2 focus:ring-wing-accent focus:border-wing-accent outline-none bg-wing-surface text-wing-text"
+                        />
+                        {searchTerm && (
+                            <button
+                                type="button"
+                                onClick={() => setSearchTerm('')}
+                                className="absolute inset-y-0 right-3 flex items-center text-wing-muted hover:text-wing-text"
+                            >
+                                <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                    <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M6 18L18 6M6 6l12 12" />
+                                </svg>
+                            </button>
+                        )}
+                    </div>
+
+                    {/* 뷰 전환 토글 */}
+                    <div className="flex rounded-lg border border-wing-border overflow-hidden">
+                        <button
+                            type="button"
+                            onClick={() => setViewMode('table')}
+                            title="테이블 보기"
+                            className={`px-3 py-2 transition-colors ${
+                                viewMode === 'table'
+                                    ? 'bg-wing-accent text-white'
+                                    : 'bg-wing-surface text-wing-muted hover:text-wing-text'
+                            }`}
+                        >
+                            <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M4 6h16M4 12h16M4 18h16" />
+                            </svg>
+                        </button>
+                        <button
+                            type="button"
+                            onClick={() => setViewMode('card')}
+                            title="카드 보기"
+                            className={`px-3 py-2 transition-colors border-l border-wing-border ${
+                                viewMode === 'card'
+                                    ? 'bg-wing-accent text-white'
+                                    : 'bg-wing-surface text-wing-muted hover:text-wing-text'
+                            }`}
+                        >
+                            <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path
+                                    strokeLinecap="round"
+                                    strokeLinejoin="round"
+                                    strokeWidth={2}
+                                    d="M4 6a2 2 0 012-2h2a2 2 0 012 2v2a2 2 0 01-2 2H6a2 2 0 01-2-2V6zM14 6a2 2 0 012-2h2a2 2 0 012 2v2a2 2 0 01-2 2h-2a2 2 0 01-2-2V6zM4 16a2 2 0 012-2h2a2 2 0 012 2v2a2 2 0 01-2 2H6a2 2 0 01-2-2v-2zM14 16a2 2 0 012-2h2a2 2 0 012 2v2a2 2 0 01-2 2h-2a2 2 0 01-2-2v-2z"
+                                />
+                            </svg>
+                        </button>
+                    </div>
+                </div>
+
+                {searchTerm && (
+                    <p className="mt-2 text-xs text-wing-muted">
+                        {filteredConfigs.length}개 API 검색됨
+                    </p>
+                )}
+            </div>
+
+            {/* 빈 상태 */}
             {configs.length === 0 ? (
                 <div className="py-16 text-center text-wing-muted border border-dashed border-wing-border rounded-xl bg-wing-card">
                     <p className="text-base font-medium mb-1">등록된 BYPASS API가 없습니다.</p>
                     <p className="text-sm">위 버튼을 눌러 새 API를 등록하세요.</p>
                 </div>
-            ) : (
+            ) : filteredConfigs.length === 0 ? (
+                <div className="py-16 text-center text-wing-muted border border-dashed border-wing-border rounded-xl bg-wing-card">
+                    <p className="text-base font-medium mb-1">검색 결과가 없습니다.</p>
+                    <p className="text-sm">다른 검색어를 사용해 보세요.</p>
+                </div>
+            ) : viewMode === 'card' ? (
+                /* 카드 뷰 */
                 <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4">
-                    {configs.map((config) => (
+                    {filteredConfigs.map((config) => (
                         <div
                             key={config.id}
                             className="bg-wing-card border border-wing-border rounded-xl p-5 flex flex-col gap-3 hover:border-wing-accent/40 transition-colors"
@@ -209,6 +310,112 @@ export default function BypassConfig() {
                         </div>
                     ))}
                 </div>
+            ) : (
+                /* 테이블 뷰 */
+                <div className="bg-wing-surface rounded-xl shadow-md overflow-hidden">
+                    <div className="overflow-x-auto">
+                        <table className="w-full text-sm">
+                            <thead>
+                                <tr className="border-b border-wing-border bg-wing-card">
+                                    <th className="text-left px-4 py-3 text-xs font-semibold text-wing-muted uppercase tracking-wider">
+                                        도메인명
+                                    </th>
+                                    <th className="text-left px-4 py-3 text-xs font-semibold text-wing-muted uppercase tracking-wider">
+                                        표시명
+                                    </th>
+                                    <th className="text-left px-4 py-3 text-xs font-semibold text-wing-muted uppercase tracking-wider">
+                                        HTTP 메서드
+                                    </th>
+                                    <th className="text-left px-4 py-3 text-xs font-semibold text-wing-muted uppercase tracking-wider">
+                                        WebClient
+                                    </th>
+                                    <th className="text-left px-4 py-3 text-xs font-semibold text-wing-muted uppercase tracking-wider">
+                                        외부 경로
+                                    </th>
+                                    <th className="text-left px-4 py-3 text-xs font-semibold text-wing-muted uppercase tracking-wider">
+                                        생성 상태
+                                    </th>
+                                    <th className="text-left px-4 py-3 text-xs font-semibold text-wing-muted uppercase tracking-wider">
+                                        등록일
+                                    </th>
+                                    <th className="text-right px-4 py-3 text-xs font-semibold text-wing-muted uppercase tracking-wider">
+                                        액션
+                                    </th>
+                                </tr>
+                            </thead>
+                            <tbody className="divide-y divide-wing-border">
+                                {filteredConfigs.map((config) => (
+                                    <tr key={config.id} className="hover:bg-wing-hover transition-colors">
+                                        <td className="px-4 py-3 font-mono text-xs text-wing-text">
+                                            {config.domainName}
+                                        </td>
+                                        <td className="px-4 py-3 font-medium text-wing-text">
+                                            {config.displayName}
+                                        </td>
+                                        <td className="px-4 py-3">
+                                            <span
+                                                className={[
+                                                    'px-2 py-0.5 text-xs font-bold rounded',
+                                                    HTTP_METHOD_COLORS[config.httpMethod] ?? 'bg-wing-card text-wing-muted',
+                                                ].join(' ')}
+                                            >
+                                                {config.httpMethod}
+                                            </span>
+                                        </td>
+                                        <td className="px-4 py-3 text-xs text-wing-muted">
+                                            {config.webclientBean}
+                                        </td>
+                                        <td className="px-4 py-3 font-mono text-xs text-wing-muted max-w-[200px] truncate">
+                                            {config.externalPath}
+                                        </td>
+                                        <td className="px-4 py-3">
+                                            <span
+                                                className={[
+                                                    'px-2 py-0.5 text-xs font-semibold rounded-full',
+                                                    config.generated
+                                                        ? 'bg-emerald-100 text-emerald-700'
+                                                        : 'bg-wing-card text-wing-muted border border-wing-border',
+                                                ].join(' ')}
+                                            >
+                                                {config.generated ? '생성 완료' : '미생성'}
+                                            </span>
+                                        </td>
+                                        <td className="px-4 py-3 text-xs text-wing-muted whitespace-nowrap">
+                                            {config.createdAt
+                                                ? new Date(config.createdAt).toLocaleDateString('ko-KR')
+                                                : '-'}
+                                        </td>
+                                        <td className="px-4 py-3">
+                                            <div className="flex justify-end gap-2">
+                                                <button
+                                                    type="button"
+                                                    onClick={() => handleEdit(config)}
+                                                    className="px-3 py-1.5 text-xs font-medium text-wing-text bg-wing-card hover:bg-wing-hover border border-wing-border rounded-lg transition-colors"
+                                                >
+                                                    수정
+                                                </button>
+                                                <button
+                                                    type="button"
+                                                    onClick={() => setConfirmAction({ type: 'generate', config })}
+                                                    className="px-3 py-1.5 text-xs font-medium text-white bg-wing-accent hover:bg-wing-accent/80 rounded-lg transition-colors"
+                                                >
+                                                    {config.generated ? '재생성' : '코드 생성'}
+                                                </button>
+                                                <button
+                                                    type="button"
+                                                    onClick={() => setConfirmAction({ type: 'delete', config })}
+                                                    className="px-3 py-1.5 text-xs font-medium text-red-500 hover:bg-red-50 border border-red-200 rounded-lg transition-colors"
+                                                >
+                                                    삭제
+                                                </button>
+                                            </div>
+                                        </td>
+                                    </tr>
+                                ))}
+                            </tbody>
+                        </table>
+                    </div>
+                </div>
             )}
 
             {/* 등록/수정 모달 */}
diff --git a/src/main/java/com/snp/batch/global/config/SwaggerConfig.java b/src/main/java/com/snp/batch/global/config/SwaggerConfig.java
index 8cb1a22..15b3971 100644
--- a/src/main/java/com/snp/batch/global/config/SwaggerConfig.java
+++ b/src/main/java/com/snp/batch/global/config/SwaggerConfig.java
@@ -5,6 +5,7 @@ import io.swagger.v3.oas.models.info.Contact;
 import io.swagger.v3.oas.models.info.Info;
 import io.swagger.v3.oas.models.info.License;
 import io.swagger.v3.oas.models.servers.Server;
+import org.springdoc.core.models.GroupedOpenApi;
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
@@ -33,6 +34,31 @@ public class SwaggerConfig {
     @Value("${server.servlet.context-path:}")
     private String contextPath;
 
+    @Bean
+    public GroupedOpenApi batchManagementApi() {
+        return GroupedOpenApi.builder()
+                .group("1. Batch Management")
+                .pathsToMatch("/api/batch/**")
+                .build();
+    }
+
+    @Bean
+    public GroupedOpenApi bypassConfigApi() {
+        return GroupedOpenApi.builder()
+                .group("2. Bypass Config")
+                .pathsToMatch("/api/bypass-config/**")
+                .build();
+    }
+
+    @Bean
+    public GroupedOpenApi bypassApi() {
+        return GroupedOpenApi.builder()
+                .group("3. Bypass API")
+                .pathsToMatch("/api/**")
+                .pathsToExclude("/api/batch/**", "/api/bypass-config/**")
+                .build();
+    }
+
     @Bean
     public OpenAPI openAPI() {
         return new OpenAPI()
diff --git a/src/main/java/com/snp/batch/jobs/web/risk/controller/RiskController.java b/src/main/java/com/snp/batch/jobs/web/risk/controller/RiskController.java
index 9f4397a..2e96d20 100644
--- a/src/main/java/com/snp/batch/jobs/web/risk/controller/RiskController.java
+++ b/src/main/java/com/snp/batch/jobs/web/risk/controller/RiskController.java
@@ -23,7 +23,7 @@ import java.util.List;
 @RestController
 @RequestMapping("/api/risk")
 @RequiredArgsConstructor
-@Tag(name = "Risk", description = "선박 Risk 상세 정보 bypass API")
+@Tag(name = "Risk", description = "[Service API] 선박 Risk 상세 정보 bypass API")
 public class RiskController extends BaseBypassController {
 
     private final RiskBypassService riskBypassService;
diff --git a/src/main/java/com/snp/batch/service/BypassCodeGenerator.java b/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
index 1088079..5e7be1b 100644
--- a/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
+++ b/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
@@ -232,7 +232,7 @@ public class BypassCodeGenerator {
                 @RestController
                 @RequestMapping("{{REQUEST_MAPPING_PATH}}")
                 @RequiredArgsConstructor
-                @Tag(name = "{{DOMAIN_CAP}}", description = "{{DISPLAY_NAME}} bypass API")
+                @Tag(name = "{{DOMAIN_CAP}}", description = "{{TAG_PREFIX}} {{DISPLAY_NAME}} bypass API")
                 public class {{DOMAIN_CAP}}Controller extends BaseBypassController {
 
                     private final {{SERVICE_CLASS}} {{SERVICE_FIELD}};
@@ -255,6 +255,7 @@ public class BypassCodeGenerator {
                 .replace("{{REQUEST_PARAM_IMPORT}}", requestParamImport)
                 .replace("{{REQUEST_BODY_IMPORT}}", requestBodyImport)
                 .replace("{{MAPPING_IMPORT}}", mappingImport)
+                .replace("{{TAG_PREFIX}}", getTagPrefix(config.getWebclientBean()))
                 .replace("{{DISPLAY_NAME}}", config.getDisplayName())
                 .replace("{{DOMAIN_CAP}}", domainCap)
                 .replace("{{REQUEST_MAPPING_PATH}}", requestMappingPath)
@@ -331,14 +332,15 @@ public class BypassCodeGenerator {
                     String description = p.getDescription() != null ? p.getDescription() : p.getParamName();
                     String javaType = toJavaType(p.getParamType());
                     String paramName = p.getParamName();
+                    String example = getDefaultExample(p.getParamType());
                     return switch (p.getParamIn().toUpperCase()) {
-                        case "PATH" -> "@Parameter(description = \"" + description + "\")\n"
+                        case "PATH" -> "@Parameter(description = \"" + description + "\", example = \"" + example + "\")\n"
                                 + "                @PathVariable " + javaType + " " + paramName;
-                        case "BODY" -> "@Parameter(description = \"" + description + "\")\n"
+                        case "BODY" -> "@Parameter(description = \"" + description + "\", example = \"" + example + "\")\n"
                                 + "                @RequestBody " + javaType + " " + paramName;
                         default -> {
                             String required = Boolean.TRUE.equals(p.getRequired()) ? "true" : "false";
-                            yield "@Parameter(description = \"" + description + "\")\n"
+                            yield "@Parameter(description = \"" + description + "\", example = \"" + example + "\")\n"
                                     + "                @RequestParam(required = " + required + ") " + javaType + " " + paramName;
                         }
                     };
@@ -401,6 +403,35 @@ public class BypassCodeGenerator {
         return filePath;
     }
 
+    /**
+     * webclientBean 이름 → Swagger @Tag description 접두사 변환
+     */
+    private String getTagPrefix(String webclientBean) {
+        if (webclientBean == null) {
+            return "[Ship API]";
+        }
+        return switch (webclientBean) {
+            case "maritimeAisApiWebClient" -> "[AIS API]";
+            case "maritimeServiceApiWebClient" -> "[Service API]";
+            default -> "[Ship API]";
+        };
+    }
+
+    /**
+     * paramType → Swagger @Parameter example 기본값 결정
+     */
+    private String getDefaultExample(String paramType) {
+        if (paramType == null) {
+            return "9876543";
+        }
+        return switch (paramType.toUpperCase()) {
+            case "INTEGER" -> "0";
+            case "LONG" -> "0";
+            case "BOOLEAN" -> "true";
+            default -> "9876543";
+        };
+    }
+
     private String capitalize(String s) {
         if (s == null || s.isEmpty()) {
             return s;
-- 
2.45.2


From ce27c6098571128137e2d06ab922f0ec5d2956a5 Mon Sep 17 00:00:00 2001
From: HYOJIN <hjkim4@gcsc.co.kr>
Date: Fri, 27 Mar 2026 08:25:03 +0900
Subject: [PATCH 08/19] =?UTF-8?q?feat:=20=EA=B0=99=EC=9D=80=20=EB=8F=84?=
 =?UTF-8?q?=EB=A9=94=EC=9D=B8=EC=97=90=20=EC=97=AC=EB=9F=AC=20BYPASS=20API?=
 =?UTF-8?q?=20=EC=97=94=EB=93=9C=ED=8F=AC=EC=9D=B8=ED=8A=B8=20=EB=93=B1?=
 =?UTF-8?q?=EB=A1=9D=20=EC=A7=80=EC=9B=90=20(#63)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- BypassApiConfig에 endpointName 필드 추가 (externalPath에서 자동 추출)
- domainName unique 제약 → domainName + endpointName 복합 unique로 변경
- 코드 생성 시 같은 도메인의 모든 설정을 합쳐 Controller 1개 생성
- Service/DTO는 엔드포인트별로 별도 생성
- CodeGenerationResult에 servicePaths/dtoPaths 목록 반환
- 프론트엔드 타입/UI 업데이트

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 frontend/src/api/bypassApi.ts                 |   5 +-
 frontend/src/pages/BypassConfig.tsx           |  26 +-
 .../controller/BypassConfigController.java    |  11 +-
 .../global/dto/BypassConfigResponse.java      |   3 +
 .../global/dto/CodeGenerationResult.java      |  11 +-
 .../batch/global/model/BypassApiConfig.java   |  32 +-
 .../repository/BypassApiConfigRepository.java |  12 +-
 .../compliance/dto/ComplianceBypassDto.java   | 122 ++++++++
 .../batch/service/BypassCodeGenerator.java    | 282 ++++++++++--------
 .../batch/service/BypassConfigService.java    |  20 +-
 10 files changed, 381 insertions(+), 143 deletions(-)
 create mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/dto/ComplianceBypassDto.java

diff --git a/frontend/src/api/bypassApi.ts b/frontend/src/api/bypassApi.ts
index 29241e1..deec912 100644
--- a/frontend/src/api/bypassApi.ts
+++ b/frontend/src/api/bypassApi.ts
@@ -41,6 +41,7 @@ export interface BypassConfigRequest {
 export interface BypassConfigResponse {
     id: number;
     domainName: string;
+    endpointName: string;
     displayName: string;
     webclientBean: string;
     externalPath: string;
@@ -57,8 +58,8 @@ export interface BypassConfigResponse {
 
 export interface CodeGenerationResult {
     controllerPath: string;
-    servicePath: string;
-    dtoPath: string;
+    servicePaths: string[];
+    dtoPaths: string[];
     message: string;
 }
 
diff --git a/frontend/src/pages/BypassConfig.tsx b/frontend/src/pages/BypassConfig.tsx
index aa211a4..ae9186a 100644
--- a/frontend/src/pages/BypassConfig.tsx
+++ b/frontend/src/pages/BypassConfig.tsx
@@ -463,19 +463,29 @@ export default function BypassConfig() {
                         <p className="text-sm text-wing-text">{generationResult.message}</p>
                         <div className="bg-wing-card rounded-lg p-3 space-y-2">
                             <p className="text-xs font-semibold text-wing-text mb-1">생성된 파일</p>
-                            {[
-                                { label: 'Controller', path: generationResult.controllerPath },
-                                { label: 'Service', path: generationResult.servicePath },
-                                { label: 'DTO', path: generationResult.dtoPath },
-                            ].map(({ label, path }) => (
-                                <div key={label} className="flex gap-2 text-xs">
-                                    <span className="w-20 font-medium text-wing-accent shrink-0">{label}</span>
+                            <div className="flex gap-2 text-xs">
+                                <span className="w-20 font-medium text-wing-accent shrink-0">Controller</span>
+                                <span className="font-mono text-wing-muted break-all">{generationResult.controllerPath}</span>
+                            </div>
+                            {generationResult.servicePaths.map((path, idx) => (
+                                <div key={`service-${idx}`} className="flex gap-2 text-xs">
+                                    <span className="w-20 font-medium text-wing-accent shrink-0">
+                                        Service {generationResult.servicePaths.length > 1 ? idx + 1 : ''}
+                                    </span>
+                                    <span className="font-mono text-wing-muted break-all">{path}</span>
+                                </div>
+                            ))}
+                            {generationResult.dtoPaths.map((path, idx) => (
+                                <div key={`dto-${idx}`} className="flex gap-2 text-xs">
+                                    <span className="w-20 font-medium text-wing-accent shrink-0">
+                                        DTO {generationResult.dtoPaths.length > 1 ? idx + 1 : ''}
+                                    </span>
                                     <span className="font-mono text-wing-muted break-all">{path}</span>
                                 </div>
                             ))}
                         </div>
                         <div className="flex items-start gap-2 bg-amber-50 text-amber-700 rounded-lg p-3 text-xs">
-                            <span className="shrink-0">⚠</span>
+                            <span className="shrink-0">&#9888;</span>
                             <span>서버를 재시작하면 새 API가 활성화됩니다.</span>
                         </div>
                     </div>
diff --git a/src/main/java/com/snp/batch/global/controller/BypassConfigController.java b/src/main/java/com/snp/batch/global/controller/BypassConfigController.java
index 9ff79aa..bea3101 100644
--- a/src/main/java/com/snp/batch/global/controller/BypassConfigController.java
+++ b/src/main/java/com/snp/batch/global/controller/BypassConfigController.java
@@ -79,7 +79,7 @@ public class BypassConfigController {
 
     @Operation(
             summary = "코드 생성",
-            description = "등록된 설정을 기반으로 Controller, Service, DTO Java 소스 코드를 생성합니다."
+            description = "등록된 설정의 도메인 전체를 기반으로 Controller, Service, DTO Java 소스 코드를 생성합니다. 같은 도메인의 모든 설정을 하나의 Controller로 합칩니다."
     )
     @PostMapping("/{id}/generate")
     public ResponseEntity<ApiResponse<CodeGenerationResult>> generateCode(
@@ -89,10 +89,13 @@ public class BypassConfigController {
             BypassApiConfig config = configRepository.findById(id)
                     .orElseThrow(() -> new IllegalArgumentException("설정을 찾을 수 없습니다: " + id));
 
-            CodeGenerationResult result = bypassCodeGenerator.generate(
-                    config, config.getParams(), config.getFields(), force);
+            // 같은 도메인의 모든 설정을 조회하여 함께 생성
+            List<BypassApiConfig> domainConfigs = configRepository.findByDomainNameOrderById(config.getDomainName());
 
-            bypassConfigService.markAsGenerated(id);
+            CodeGenerationResult result = bypassCodeGenerator.generate(domainConfigs, force);
+
+            // 같은 도메인의 모든 설정을 generated로 마킹
+            domainConfigs.forEach(c -> bypassConfigService.markAsGenerated(c.getId()));
 
             return ResponseEntity.ok(ApiResponse.success(result));
         } catch (IllegalStateException e) {
diff --git a/src/main/java/com/snp/batch/global/dto/BypassConfigResponse.java b/src/main/java/com/snp/batch/global/dto/BypassConfigResponse.java
index 2779d75..886af93 100644
--- a/src/main/java/com/snp/batch/global/dto/BypassConfigResponse.java
+++ b/src/main/java/com/snp/batch/global/dto/BypassConfigResponse.java
@@ -22,6 +22,9 @@ public class BypassConfigResponse {
     /** 도메인명 (패키지명/URL 경로) */
     private String domainName;
 
+    /** 엔드포인트명 (externalPath 마지막 세그먼트) */
+    private String endpointName;
+
     /** 표시명 */
     private String displayName;
 
diff --git a/src/main/java/com/snp/batch/global/dto/CodeGenerationResult.java b/src/main/java/com/snp/batch/global/dto/CodeGenerationResult.java
index 2c00937..d1ed597 100644
--- a/src/main/java/com/snp/batch/global/dto/CodeGenerationResult.java
+++ b/src/main/java/com/snp/batch/global/dto/CodeGenerationResult.java
@@ -5,8 +5,11 @@ import lombok.Builder;
 import lombok.Getter;
 import lombok.NoArgsConstructor;
 
+import java.util.List;
+
 /**
  * 코드 자동 생성 결과 DTO
+ * 같은 도메인에 N개의 엔드포인트를 지원하므로 Service/DTO는 목록으로 반환
  */
 @Getter
 @Builder
@@ -17,11 +20,11 @@ public class CodeGenerationResult {
     /** 생성된 Controller 파일 경로 */
     private String controllerPath;
 
-    /** 생성된 Service 파일 경로 */
-    private String servicePath;
+    /** 생성된 Service 파일 경로 목록 (엔드포인트별) */
+    private List<String> servicePaths;
 
-    /** 생성된 DTO 파일 경로 */
-    private String dtoPath;
+    /** 생성된 DTO 파일 경로 목록 (엔드포인트별) */
+    private List<String> dtoPaths;
 
     /** 결과 메시지 */
     private String message;
diff --git a/src/main/java/com/snp/batch/global/model/BypassApiConfig.java b/src/main/java/com/snp/batch/global/model/BypassApiConfig.java
index b1b209b..edd2c54 100644
--- a/src/main/java/com/snp/batch/global/model/BypassApiConfig.java
+++ b/src/main/java/com/snp/batch/global/model/BypassApiConfig.java
@@ -14,7 +14,9 @@ import java.util.List;
  * JPA를 사용하므로 @PrePersist, @PreUpdate로 감사 필드 자동 설정
  */
 @Entity
-@Table(name = "bypass_api_config")
+@Table(name = "bypass_api_config", uniqueConstraints = {
+    @UniqueConstraint(columnNames = {"domain_name", "endpoint_name"})
+})
 @Getter
 @Setter
 @Builder
@@ -30,9 +32,16 @@ public class BypassApiConfig {
      * 도메인명 (패키지명/URL 경로)
      * 예: "ship-info", "port-data"
      */
-    @Column(name = "domain_name", unique = true, nullable = false, length = 50)
+    @Column(name = "domain_name", nullable = false, length = 50)
     private String domainName;
 
+    /**
+     * 엔드포인트명 (externalPath의 마지막 세그먼트에서 자동 추출)
+     * 예: "CompliancesByImos", "CompanyCompliancesByImos"
+     */
+    @Column(name = "endpoint_name", nullable = false, length = 100)
+    private String endpointName;
+
     /**
      * 표시명
      * 예: "선박 정보 API", "항만 데이터 API"
@@ -117,12 +126,28 @@ public class BypassApiConfig {
 
     /**
      * 엔티티 저장 전 자동 호출 (INSERT 시)
+     * endpointName이 null이면 externalPath에서 자동 추출 (마이그레이션 대응)
      */
     @PrePersist
     protected void onCreate() {
         LocalDateTime now = LocalDateTime.now();
         this.createdAt = now;
         this.updatedAt = now;
+        if (this.endpointName == null || this.endpointName.isEmpty()) {
+            this.endpointName = extractEndpointName(this.externalPath);
+        }
+    }
+
+    /**
+     * 엔티티 업데이트 전 자동 호출 (UPDATE 시)
+     * endpointName이 null이면 externalPath에서 자동 추출 (마이그레이션 대응)
+     */
+    private static String extractEndpointName(String externalPath) {
+        if (externalPath == null || externalPath.isEmpty()) {
+            return "";
+        }
+        String[] segments = externalPath.split("/");
+        return segments[segments.length - 1];
     }
 
     /**
@@ -131,5 +156,8 @@ public class BypassApiConfig {
     @PreUpdate
     protected void onUpdate() {
         this.updatedAt = LocalDateTime.now();
+        if (this.endpointName == null || this.endpointName.isEmpty()) {
+            this.endpointName = extractEndpointName(this.externalPath);
+        }
     }
 }
diff --git a/src/main/java/com/snp/batch/global/repository/BypassApiConfigRepository.java b/src/main/java/com/snp/batch/global/repository/BypassApiConfigRepository.java
index 89a2322..1f19563 100644
--- a/src/main/java/com/snp/batch/global/repository/BypassApiConfigRepository.java
+++ b/src/main/java/com/snp/batch/global/repository/BypassApiConfigRepository.java
@@ -4,6 +4,7 @@ import com.snp.batch.global.model.BypassApiConfig;
 import org.springframework.data.jpa.repository.JpaRepository;
 import org.springframework.stereotype.Repository;
 
+import java.util.List;
 import java.util.Optional;
 
 /**
@@ -14,12 +15,17 @@ import java.util.Optional;
 public interface BypassApiConfigRepository extends JpaRepository<BypassApiConfig, Long> {
 
     /**
-     * 도메인명으로 BYPASS API 설정 조회
+     * 도메인명으로 BYPASS API 설정 단건 조회 (하위 호환)
      */
     Optional<BypassApiConfig> findByDomainName(String domainName);
 
     /**
-     * 도메인명 존재 여부 확인
+     * 도메인명으로 BYPASS API 설정 목록 조회 (ID 순)
      */
-    boolean existsByDomainName(String domainName);
+    List<BypassApiConfig> findByDomainNameOrderById(String domainName);
+
+    /**
+     * 도메인명 + 엔드포인트명 복합 유니크 존재 여부 확인
+     */
+    boolean existsByDomainNameAndEndpointName(String domainName, String endpointName);
 }
diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/dto/ComplianceBypassDto.java b/src/main/java/com/snp/batch/jobs/web/compliance/dto/ComplianceBypassDto.java
new file mode 100644
index 0000000..600d35d
--- /dev/null
+++ b/src/main/java/com/snp/batch/jobs/web/compliance/dto/ComplianceBypassDto.java
@@ -0,0 +1,122 @@
+package com.snp.batch.jobs.web.compliance.dto;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.Setter;
+
+@Getter
+@Setter
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class ComplianceBypassDto {
+
+    @JsonProperty("dateAmended")
+    private String dateAmended;
+
+    @JsonProperty("legalOverall")
+    private Integer legalOverall;
+
+    @JsonProperty("lrimoShipNo")
+    private String lrimoShipNo;
+
+    @JsonProperty("shipBESSanctionList")
+    private Integer shipBESSanctionList;
+
+    @JsonProperty("shipDarkActivityIndicator")
+    private Integer shipDarkActivityIndicator;
+
+    @JsonProperty("shipDetailsNoLongerMaintained")
+    private Integer shipDetailsNoLongerMaintained;
+
+    @JsonProperty("shipEUSanctionList")
+    private Integer shipEUSanctionList;
+
+    @JsonProperty("shipFlagDisputed")
+    private Integer shipFlagDisputed;
+
+    @JsonProperty("shipFlagSanctionedCountry")
+    private Integer shipFlagSanctionedCountry;
+
+    @JsonProperty("shipHistoricalFlagSanctionedCountry")
+    private Integer shipHistoricalFlagSanctionedCountry;
+
+    @JsonProperty("shipOFACAdvisoryList")
+    private Integer shipOFACAdvisoryList;
+
+    @JsonProperty("shipOFACNonSDNSanctionList")
+    private Integer shipOFACNonSDNSanctionList;
+
+    @JsonProperty("shipOFACSanctionList")
+    private Integer shipOFACSanctionList;
+
+    @JsonProperty("shipOwnerAustralianSanctionList")
+    private Integer shipOwnerAustralianSanctionList;
+
+    @JsonProperty("shipOwnerBESSanctionList")
+    private Integer shipOwnerBESSanctionList;
+
+    @JsonProperty("shipOwnerCanadianSanctionList")
+    private Integer shipOwnerCanadianSanctionList;
+
+    @JsonProperty("shipOwnerEUSanctionList")
+    private Integer shipOwnerEUSanctionList;
+
+    @JsonProperty("shipOwnerFATFJurisdiction")
+    private Integer shipOwnerFATFJurisdiction;
+
+    @JsonProperty("shipOwnerHistoricalOFACSanctionedCountry")
+    private Integer shipOwnerHistoricalOFACSanctionedCountry;
+
+    @JsonProperty("shipOwnerOFACSSIList")
+    private Integer shipOwnerOFACSSIList;
+
+    @JsonProperty("shipOwnerOFACSanctionList")
+    private Integer shipOwnerOFACSanctionList;
+
+    @JsonProperty("shipOwnerOFACSanctionedCountry")
+    private Integer shipOwnerOFACSanctionedCountry;
+
+    @JsonProperty("shipOwnerParentCompanyNonCompliance")
+    private Integer shipOwnerParentCompanyNonCompliance;
+
+    @JsonProperty("shipOwnerParentFATFJurisdiction")
+    private String shipOwnerParentFATFJurisdiction;
+
+    @JsonProperty("shipOwnerParentOFACSanctionedCountry")
+    private String shipOwnerParentOFACSanctionedCountry;
+
+    @JsonProperty("shipOwnerSwissSanctionList")
+    private Integer shipOwnerSwissSanctionList;
+
+    @JsonProperty("shipOwnerUAESanctionList")
+    private Integer shipOwnerUAESanctionList;
+
+    @JsonProperty("shipOwnerUNSanctionList")
+    private Integer shipOwnerUNSanctionList;
+
+    @JsonProperty("shipSTSPartnerNonComplianceLast12m")
+    private Integer shipSTSPartnerNonComplianceLast12m;
+
+    @JsonProperty("shipSanctionedCountryPortCallLast12m")
+    private Integer shipSanctionedCountryPortCallLast12m;
+
+    @JsonProperty("shipSanctionedCountryPortCallLast3m")
+    private Integer shipSanctionedCountryPortCallLast3m;
+
+    @JsonProperty("shipSanctionedCountryPortCallLast6m")
+    private Integer shipSanctionedCountryPortCallLast6m;
+
+    @JsonProperty("shipSecurityLegalDisputeEvent")
+    private Integer shipSecurityLegalDisputeEvent;
+
+    @JsonProperty("shipSwissSanctionList")
+    private Integer shipSwissSanctionList;
+
+    @JsonProperty("shipUNSanctionList")
+    private Integer shipUNSanctionList;
+
+}
diff --git a/src/main/java/com/snp/batch/service/BypassCodeGenerator.java b/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
index 5e7be1b..0b4049d 100644
--- a/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
+++ b/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
@@ -11,12 +11,15 @@ import java.io.IOException;
 import java.nio.charset.StandardCharsets;
 import java.nio.file.Files;
 import java.nio.file.Path;
+import java.util.ArrayList;
+import java.util.LinkedHashSet;
 import java.util.List;
+import java.util.Set;
 import java.util.stream.Collectors;
 
 /**
  * BYPASS API Java 소스 코드를 자동 생성하는 서비스.
- * RiskBypassService / RiskController 패턴을 기반으로 DTO, Service, Controller를 생성합니다.
+ * 같은 도메인의 N개 설정을 받아 N개의 DTO + Service와 1개의 Controller를 생성합니다.
  */
 @Slf4j
 @Service
@@ -25,47 +28,59 @@ public class BypassCodeGenerator {
     private static final String BASE_PACKAGE = "com.snp.batch.jobs.web";
 
     /**
-     * BYPASS API 코드를 생성합니다.
+     * 같은 도메인의 BYPASS API 코드를 생성합니다.
+     * 엔드포인트별 DTO/Service를 각각 생성하고, Controller 1개에 모든 엔드포인트 메서드를 합칩니다.
      *
-     * @param config 설정 정보
-     * @param params 파라미터 목록
-     * @param fields DTO 필드 목록
-     * @param force  기존 파일 덮어쓰기 여부
+     * @param configs 같은 domainName을 가진 설정 목록
+     * @param force   기존 파일 덮어쓰기 여부
      * @return 생성 결과
      */
-    public CodeGenerationResult generate(BypassApiConfig config,
-                                          List<BypassApiParam> params,
-                                          List<BypassApiField> fields,
-                                          boolean force) {
+    public CodeGenerationResult generate(List<BypassApiConfig> configs, boolean force) {
+        if (configs == null || configs.isEmpty()) {
+            throw new IllegalArgumentException("생성할 설정이 없습니다.");
+        }
+
         String projectRoot = System.getProperty("user.dir");
-        String domain = config.getDomainName();
-        String domainCapitalized = capitalize(domain);
-
-        String dtoCode = generateDtoCode(domain, domainCapitalized, fields);
-        String serviceCode = generateServiceCode(domain, domainCapitalized, config, params);
-        String controllerCode = generateControllerCode(domain, domainCapitalized, config, params);
-
+        String domain = configs.get(0).getDomainName();
         String basePath = projectRoot + "/src/main/java/com/snp/batch/jobs/web/" + domain;
-        Path dtoPath = writeFile(basePath + "/dto/" + domainCapitalized + "BypassDto.java", dtoCode, force);
-        Path servicePath = writeFile(basePath + "/service/" + domainCapitalized + "BypassService.java", serviceCode, force);
-        Path controllerPath = writeFile(basePath + "/controller/" + domainCapitalized + "Controller.java", controllerCode, force);
 
-        log.info("코드 생성 완료 - domain: {}, dto: {}, service: {}, controller: {}",
-                domain, dtoPath, servicePath, controllerPath);
+        List<String> dtoPaths = new ArrayList<>();
+        List<String> servicePaths = new ArrayList<>();
+
+        for (BypassApiConfig config : configs) {
+            String endpointName = config.getEndpointName();
+
+            String dtoCode = generateDtoCode(domain, endpointName, config.getFields());
+            String serviceCode = generateServiceCode(domain, endpointName, config, config.getParams());
+
+            Path dtoFilePath = writeFile(basePath + "/dto/" + endpointName + "Dto.java", dtoCode, force);
+            Path serviceFilePath = writeFile(basePath + "/service/" + endpointName + "Service.java", serviceCode, force);
+
+            dtoPaths.add(dtoFilePath.toString());
+            servicePaths.add(serviceFilePath.toString());
+        }
+
+        String controllerCode = generateControllerCode(domain, configs);
+        String domainCapitalized = capitalize(domain);
+        Path controllerFilePath = writeFile(
+                basePath + "/controller/" + domainCapitalized + "Controller.java", controllerCode, force);
+
+        log.info("코드 생성 완료 - domain: {}, endpoints: {}, controller: {}",
+                domain, configs.stream().map(BypassApiConfig::getEndpointName).toList(), controllerFilePath);
 
         return CodeGenerationResult.builder()
-                .dtoPath(dtoPath.toString())
-                .servicePath(servicePath.toString())
-                .controllerPath(controllerPath.toString())
+                .controllerPath(controllerFilePath.toString())
+                .servicePaths(servicePaths)
+                .dtoPaths(dtoPaths)
                 .message("코드 생성 완료. 서버를 재시작하면 새 API가 활성화됩니다.")
                 .build();
     }
 
     /**
      * DTO 코드 생성.
-     * 각 field에 대해 @JsonProperty + private 필드를 생성합니다.
+     * endpointName 기반 클래스명: {EndpointName}Dto
      */
-    private String generateDtoCode(String domain, String domainCap, List<BypassApiField> fields) {
+    private String generateDtoCode(String domain, String endpointName, List<BypassApiField> fields) {
         String packageName = BASE_PACKAGE + "." + domain + ".dto";
         boolean needsLocalDateTime = fields.stream()
                 .anyMatch(f -> "LocalDateTime".equals(f.getFieldType()));
@@ -103,24 +118,26 @@ public class BypassCodeGenerator {
                 """
                 .replace("{{PACKAGE}}", packageName)
                 .replace("{{IMPORTS}}", imports.toString())
-                .replace("{{CLASS_NAME}}", domainCap + "BypassDto")
+                .replace("{{CLASS_NAME}}", endpointName + "Dto")
                 .replace("{{FIELDS}}", fieldLines.toString());
     }
 
     /**
      * Service 코드 생성.
-     * BaseBypassService를 상속하여 GET/POST, LIST/SINGLE 조합에 맞는 fetch 메서드를 생성합니다.
+     * endpointName 기반 클래스명: {EndpointName}Service
+     * BaseBypassService<{EndpointName}Dto>를 상속합니다.
      */
-    private String generateServiceCode(String domain, String domainCap,
+    private String generateServiceCode(String domain, String endpointName,
                                         BypassApiConfig config, List<BypassApiParam> params) {
         String packageName = BASE_PACKAGE + "." + domain + ".service";
         String dtoPackage = BASE_PACKAGE + "." + domain + ".dto";
-        String dtoClass = domainCap + "BypassDto";
+        String dtoClass = endpointName + "Dto";
+        String serviceClass = endpointName + "Service";
         boolean isList = "LIST".equalsIgnoreCase(config.getResponseType());
         boolean isPost = "POST".equalsIgnoreCase(config.getHttpMethod());
 
         String returnType = isList ? "List<" + dtoClass + ">" : dtoClass;
-        String methodName = "get" + domainCap + "Data";
+        String methodName = "get" + endpointName + "Data";
         String fetchMethod = buildFetchMethodCall(config, params, isList, isPost);
         String methodParams = buildMethodParams(params);
 
@@ -141,9 +158,9 @@ public class BypassCodeGenerator {
                  * 외부 Maritime API에서 데이터를 실시간 조회하여 그대로 반환
                  */
                 @Service
-                public class {{DOMAIN_CAP}}BypassService extends BaseBypassService<{{DTO_CLASS}}> {
+                public class {{SERVICE_CLASS}} extends BaseBypassService<{{DTO_CLASS}}> {
 
-                    public {{DOMAIN_CAP}}BypassService(
+                    public {{SERVICE_CLASS}}(
                             @Qualifier("{{WEBCLIENT_BEAN}}") WebClient webClient) {
                         super(webClient, "{{EXTERNAL_PATH}}", "{{DISPLAY_NAME}}",
                                 new ParameterizedTypeReference<>() {},
@@ -164,7 +181,7 @@ public class BypassCodeGenerator {
                 .replace("{{DTO_IMPORT}}", dtoPackage + "." + dtoClass)
                 .replace("{{LIST_IMPORT}}", listImport)
                 .replace("{{DISPLAY_NAME}}", config.getDisplayName())
-                .replace("{{DOMAIN_CAP}}", domainCap)
+                .replace("{{SERVICE_CLASS}}", serviceClass)
                 .replace("{{DTO_CLASS}}", dtoClass)
                 .replace("{{WEBCLIENT_BEAN}}", config.getWebclientBean())
                 .replace("{{EXTERNAL_PATH}}", config.getExternalPath())
@@ -176,95 +193,126 @@ public class BypassCodeGenerator {
 
     /**
      * Controller 코드 생성.
-     * BaseBypassController를 상속하여 GET/POST 엔드포인트를 생성합니다.
+     * 같은 도메인의 모든 설정을 합쳐 하나의 Controller에 N개의 엔드포인트 메서드를 생성합니다.
      */
-    private String generateControllerCode(String domain, String domainCap,
-                                           BypassApiConfig config, List<BypassApiParam> params) {
+    private String generateControllerCode(String domain, List<BypassApiConfig> configs) {
         String packageName = BASE_PACKAGE + "." + domain + ".controller";
-        String dtoPackage = BASE_PACKAGE + "." + domain + ".dto";
         String servicePackage = BASE_PACKAGE + "." + domain + ".service";
-        String dtoClass = domainCap + "BypassDto";
-        String serviceClass = domainCap + "BypassService";
-        String serviceField = Character.toLowerCase(serviceClass.charAt(0)) + serviceClass.substring(1);
-
-        boolean isList = "LIST".equalsIgnoreCase(config.getResponseType());
-        boolean isPost = "POST".equalsIgnoreCase(config.getHttpMethod());
-
-        String responseGeneric = isList ? "List<" + dtoClass + ">" : dtoClass;
-        String mappingAnnotation = isPost ? "@PostMapping" : "@GetMapping";
-        String listImport = isList ? "import java.util.List;\n" : "";
-
-        String paramAnnotations = buildControllerParamAnnotations(params);
-        String methodParams = buildMethodParams(params);
-        String serviceCallArgs = buildServiceCallArgs(params);
-        String pathVariableImport = params.stream().anyMatch(p -> "PATH".equalsIgnoreCase(p.getParamIn()))
-                ? "import org.springframework.web.bind.annotation.PathVariable;\n" : "";
-        String requestParamImport = params.stream().anyMatch(p -> "QUERY".equalsIgnoreCase(p.getParamIn()))
-                ? "import org.springframework.web.bind.annotation.RequestParam;\n" : "";
-        String requestBodyImport = isPost
-                ? "import org.springframework.web.bind.annotation.RequestBody;\n" : "";
-        String mappingImport = isPost
-                ? "import org.springframework.web.bind.annotation.PostMapping;\n"
-                : "import org.springframework.web.bind.annotation.GetMapping;\n";
-
-        String mappingPath = buildMappingPath(params, config.getExternalPath());
+        String dtoPackage = BASE_PACKAGE + "." + domain + ".dto";
+        String domainCap = capitalize(domain);
         String requestMappingPath = "/api/" + domain;
 
-        return """
-                package {{PACKAGE}};
+        // imports 합산 (중복 제거)
+        Set<String> importSet = new LinkedHashSet<>();
+        importSet.add("import com.snp.batch.common.web.ApiResponse;");
+        importSet.add("import com.snp.batch.common.web.controller.BaseBypassController;");
+        importSet.add("import io.swagger.v3.oas.annotations.Operation;");
+        importSet.add("import io.swagger.v3.oas.annotations.Parameter;");
+        importSet.add("import io.swagger.v3.oas.annotations.tags.Tag;");
+        importSet.add("import lombok.RequiredArgsConstructor;");
+        importSet.add("import org.springframework.http.ResponseEntity;");
+        importSet.add("import org.springframework.web.bind.annotation.RequestMapping;");
+        importSet.add("import org.springframework.web.bind.annotation.RestController;");
 
-                import {{DTO_IMPORT}};
-                import {{SERVICE_IMPORT}};
-                import com.snp.batch.common.web.ApiResponse;
-                import com.snp.batch.common.web.controller.BaseBypassController;
-                import io.swagger.v3.oas.annotations.Operation;
-                import io.swagger.v3.oas.annotations.Parameter;
-                import io.swagger.v3.oas.annotations.tags.Tag;
-                {{LIST_IMPORT}}import lombok.RequiredArgsConstructor;
-                import org.springframework.http.ResponseEntity;
-                import org.springframework.web.bind.annotation.RequestMapping;
-                import org.springframework.web.bind.annotation.RestController;
-                {{MAPPING_IMPORT}}{{PATH_VARIABLE_IMPORT}}{{REQUEST_PARAM_IMPORT}}{{REQUEST_BODY_IMPORT}}
-                /**
-                 * {{DISPLAY_NAME}} bypass API
-                 * S&P Maritime API에서 데이터를 실시간 조회하여 그대로 반환
-                 */
-                @RestController
-                @RequestMapping("{{REQUEST_MAPPING_PATH}}")
-                @RequiredArgsConstructor
-                @Tag(name = "{{DOMAIN_CAP}}", description = "{{TAG_PREFIX}} {{DISPLAY_NAME}} bypass API")
-                public class {{DOMAIN_CAP}}Controller extends BaseBypassController {
+        boolean anyList = configs.stream().anyMatch(c -> "LIST".equalsIgnoreCase(c.getResponseType()));
+        boolean anyPost = configs.stream().anyMatch(c -> "POST".equalsIgnoreCase(c.getHttpMethod()));
+        boolean anyGet = configs.stream().anyMatch(c -> !"POST".equalsIgnoreCase(c.getHttpMethod()));
+        boolean anyPath = configs.stream()
+                .anyMatch(c -> c.getParams().stream().anyMatch(p -> "PATH".equalsIgnoreCase(p.getParamIn())));
+        boolean anyQuery = configs.stream()
+                .anyMatch(c -> c.getParams().stream().anyMatch(p -> "QUERY".equalsIgnoreCase(p.getParamIn())));
+        boolean anyBody = configs.stream()
+                .anyMatch(c -> c.getParams().stream().anyMatch(p -> "BODY".equalsIgnoreCase(p.getParamIn())));
 
-                    private final {{SERVICE_CLASS}} {{SERVICE_FIELD}};
+        if (anyList) {
+            importSet.add("import java.util.List;");
+        }
+        if (anyPost) {
+            importSet.add("import org.springframework.web.bind.annotation.PostMapping;");
+        }
+        if (anyGet) {
+            importSet.add("import org.springframework.web.bind.annotation.GetMapping;");
+        }
+        if (anyPath) {
+            importSet.add("import org.springframework.web.bind.annotation.PathVariable;");
+        }
+        if (anyQuery) {
+            importSet.add("import org.springframework.web.bind.annotation.RequestParam;");
+        }
+        if (anyBody) {
+            importSet.add("import org.springframework.web.bind.annotation.RequestBody;");
+        }
 
-                    @Operation(
-                            summary = "{{DISPLAY_NAME}} 조회",
-                            description = "S&P API에서 {{DISPLAY_NAME}} 데이터를 요청하고 응답을 그대로 반환합니다."
-                    )
-                    {{MAPPING_ANNOTATION}}
-                    public ResponseEntity<ApiResponse<{{RESPONSE_GENERIC}}>> get{{DOMAIN_CAP}}Data({{PARAM_ANNOTATIONS}}) {
-                        return execute(() -> {{SERVICE_FIELD}}.get{{DOMAIN_CAP}}Data({{SERVICE_CALL_ARGS}}));
-                    }
-                }
-                """
-                .replace("{{PACKAGE}}", packageName)
-                .replace("{{DTO_IMPORT}}", dtoPackage + "." + dtoClass)
-                .replace("{{SERVICE_IMPORT}}", servicePackage + "." + serviceClass)
-                .replace("{{LIST_IMPORT}}", listImport)
-                .replace("{{PATH_VARIABLE_IMPORT}}", pathVariableImport)
-                .replace("{{REQUEST_PARAM_IMPORT}}", requestParamImport)
-                .replace("{{REQUEST_BODY_IMPORT}}", requestBodyImport)
-                .replace("{{MAPPING_IMPORT}}", mappingImport)
-                .replace("{{TAG_PREFIX}}", getTagPrefix(config.getWebclientBean()))
-                .replace("{{DISPLAY_NAME}}", config.getDisplayName())
-                .replace("{{DOMAIN_CAP}}", domainCap)
-                .replace("{{REQUEST_MAPPING_PATH}}", requestMappingPath)
-                .replace("{{SERVICE_CLASS}}", serviceClass)
-                .replace("{{SERVICE_FIELD}}", serviceField)
-                .replace("{{MAPPING_ANNOTATION}}", mappingAnnotation + mappingPath)
-                .replace("{{RESPONSE_GENERIC}}", responseGeneric)
-                .replace("{{PARAM_ANNOTATIONS}}", paramAnnotations.isEmpty() ? "" : paramAnnotations)
-                .replace("{{SERVICE_CALL_ARGS}}", serviceCallArgs);
+        for (BypassApiConfig config : configs) {
+            String endpointName = config.getEndpointName();
+            importSet.add("import " + dtoPackage + "." + endpointName + "Dto;");
+            importSet.add("import " + servicePackage + "." + endpointName + "Service;");
+        }
+
+        String importsStr = importSet.stream().collect(Collectors.joining("\n"));
+
+        // 필드 선언부
+        StringBuilder fields = new StringBuilder();
+        for (BypassApiConfig config : configs) {
+            String endpointName = config.getEndpointName();
+            String serviceClass = endpointName + "Service";
+            String serviceField = Character.toLowerCase(serviceClass.charAt(0)) + serviceClass.substring(1);
+            fields.append("    private final ").append(serviceClass).append(" ").append(serviceField).append(";\n");
+        }
+
+        // 태그 description은 첫 번째 config의 webclientBean 기준
+        String tagPrefix = getTagPrefix(configs.get(0).getWebclientBean());
+        String tagDescription = tagPrefix + " " + domainCap + " bypass API";
+
+        // 엔드포인트 메서드 목록
+        StringBuilder methods = new StringBuilder();
+        for (BypassApiConfig config : configs) {
+            String endpointName = config.getEndpointName();
+            String dtoClass = endpointName + "Dto";
+            String serviceClass = endpointName + "Service";
+            String serviceField = Character.toLowerCase(serviceClass.charAt(0)) + serviceClass.substring(1);
+            boolean isList = "LIST".equalsIgnoreCase(config.getResponseType());
+            boolean isPost = "POST".equalsIgnoreCase(config.getHttpMethod());
+
+            String responseGeneric = isList ? "List<" + dtoClass + ">" : dtoClass;
+            String mappingAnnotation = isPost ? "@PostMapping" : "@GetMapping";
+            String mappingPath = buildMappingPath(config.getParams(), config.getExternalPath());
+            String paramAnnotations = buildControllerParamAnnotations(config.getParams());
+            String serviceCallArgs = buildServiceCallArgs(config.getParams());
+            String methodName = "get" + endpointName + "Data";
+
+            methods.append("\n");
+            methods.append("    @Operation(\n");
+            methods.append("            summary = \"").append(config.getDisplayName()).append(" 조회\",\n");
+            methods.append("            description = \"S&P API에서 ").append(config.getDisplayName())
+                    .append(" 데이터를 요청하고 응답을 그대로 반환합니다.\"\n");
+            methods.append("    )\n");
+            methods.append("    ").append(mappingAnnotation).append(mappingPath).append("\n");
+            methods.append("    public ResponseEntity<ApiResponse<").append(responseGeneric).append(">> ")
+                    .append(methodName).append("(");
+            if (!paramAnnotations.isEmpty()) {
+                methods.append(paramAnnotations);
+            }
+            methods.append(") {\n");
+            methods.append("        return execute(() -> ").append(serviceField)
+                    .append(".").append(methodName).append("(").append(serviceCallArgs).append("));\n");
+            methods.append("    }\n");
+        }
+
+        return "package " + packageName + ";\n\n"
+                + importsStr + "\n\n"
+                + "/**\n"
+                + " * " + domainCap + " bypass API\n"
+                + " * S&P Maritime API에서 데이터를 실시간 조회하여 그대로 반환\n"
+                + " */\n"
+                + "@RestController\n"
+                + "@RequestMapping(\"" + requestMappingPath + "\")\n"
+                + "@RequiredArgsConstructor\n"
+                + "@Tag(name = \"" + domainCap + "\", description = \"" + tagDescription + "\")\n"
+                + "public class " + domainCap + "Controller extends BaseBypassController {\n\n"
+                + fields
+                + methods
+                + "}\n";
     }
 
     /**
@@ -355,7 +403,6 @@ public class BypassCodeGenerator {
      *     PATH 파라미터 imo 추가 시 → ("/CompliancesByImos/{imo}")
      */
     private String buildMappingPath(List<BypassApiParam> params, String externalPath) {
-        // externalPath에서 마지막 세그먼트 추출
         String endpointSegment = "";
         if (externalPath != null && !externalPath.isEmpty()) {
             String[] segments = externalPath.split("/");
@@ -364,7 +411,6 @@ public class BypassCodeGenerator {
             }
         }
 
-        // PATH 파라미터 추가
         List<BypassApiParam> pathParams = params.stream()
                 .filter(p -> "PATH".equalsIgnoreCase(p.getParamIn()))
                 .sorted((a, b) -> Integer.compare(a.getSortOrder(), b.getSortOrder()))
diff --git a/src/main/java/com/snp/batch/service/BypassConfigService.java b/src/main/java/com/snp/batch/service/BypassConfigService.java
index b2bd54a..ca42345 100644
--- a/src/main/java/com/snp/batch/service/BypassConfigService.java
+++ b/src/main/java/com/snp/batch/service/BypassConfigService.java
@@ -57,8 +57,10 @@ public class BypassConfigService {
      */
     @Transactional
     public BypassConfigResponse createConfig(BypassConfigRequest request) {
-        if (configRepository.existsByDomainName(request.getDomainName())) {
-            throw new IllegalArgumentException("이미 존재하는 도메인입니다: " + request.getDomainName());
+        String endpointName = extractEndpointName(request.getExternalPath());
+        if (configRepository.existsByDomainNameAndEndpointName(request.getDomainName(), endpointName)) {
+            throw new IllegalArgumentException(
+                    "이미 존재하는 도메인+엔드포인트 조합입니다: " + request.getDomainName() + "/" + endpointName);
         }
         BypassApiConfig config = toEntity(request);
 
@@ -155,6 +157,7 @@ public class BypassConfigService {
         return BypassConfigResponse.builder()
                 .id(config.getId())
                 .domainName(config.getDomainName())
+                .endpointName(config.getEndpointName())
                 .displayName(config.getDisplayName())
                 .webclientBean(config.getWebclientBean())
                 .externalPath(config.getExternalPath())
@@ -173,6 +176,7 @@ public class BypassConfigService {
     private BypassApiConfig toEntity(BypassConfigRequest request) {
         return BypassApiConfig.builder()
                 .domainName(request.getDomainName())
+                .endpointName(extractEndpointName(request.getExternalPath()))
                 .displayName(request.getDisplayName())
                 .webclientBean(request.getWebclientBean())
                 .externalPath(request.getExternalPath())
@@ -182,6 +186,18 @@ public class BypassConfigService {
                 .build();
     }
 
+    /**
+     * externalPath의 마지막 세그먼트를 endpointName으로 추출
+     * 예: "/RiskAndCompliance/CompliancesByImos" → "CompliancesByImos"
+     */
+    private String extractEndpointName(String externalPath) {
+        if (externalPath == null || externalPath.isEmpty()) {
+            return "";
+        }
+        String[] segments = externalPath.split("/");
+        return segments[segments.length - 1];
+    }
+
     private BypassApiParam toParamEntity(BypassParamDto dto) {
         return BypassApiParam.builder()
                 .paramName(dto.getParamName())
-- 
2.45.2


From dbbf8628c56e461a51df4be73f269c1ba68c71bb Mon Sep 17 00:00:00 2001
From: HYOJIN <hjkim4@gcsc.co.kr>
Date: Fri, 27 Mar 2026 08:51:09 +0900
Subject: [PATCH 09/19] =?UTF-8?q?chore:=20BypassApiConfig=20=EC=9D=B8?=
 =?UTF-8?q?=EB=8D=B1=EC=8A=A4=20=EC=B6=94=EA=B0=80=20(domain=5Fname)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .../com/snp/batch/global/model/BypassApiConfig.java   | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/src/main/java/com/snp/batch/global/model/BypassApiConfig.java b/src/main/java/com/snp/batch/global/model/BypassApiConfig.java
index edd2c54..89d62fe 100644
--- a/src/main/java/com/snp/batch/global/model/BypassApiConfig.java
+++ b/src/main/java/com/snp/batch/global/model/BypassApiConfig.java
@@ -14,9 +14,14 @@ import java.util.List;
  * JPA를 사용하므로 @PrePersist, @PreUpdate로 감사 필드 자동 설정
  */
 @Entity
-@Table(name = "bypass_api_config", uniqueConstraints = {
-    @UniqueConstraint(columnNames = {"domain_name", "endpoint_name"})
-})
+@Table(name = "bypass_api_config",
+    uniqueConstraints = {
+        @UniqueConstraint(name = "uk_bypass_config_domain_endpoint", columnNames = {"domain_name", "endpoint_name"})
+    },
+    indexes = {
+        @Index(name = "idx_bypass_config_domain_name", columnList = "domain_name")
+    }
+)
 @Getter
 @Setter
 @Builder
-- 
2.45.2


From 6391683959d967affd0ff3c1f9066995632be07e Mon Sep 17 00:00:00 2001
From: HYOJIN <hjkim4@gcsc.co.kr>
Date: Fri, 27 Mar 2026 09:23:50 +0900
Subject: [PATCH 10/19] =?UTF-8?q?fix:=20=EA=B0=99=EC=9D=80=20=EB=8F=84?=
 =?UTF-8?q?=EB=A9=94=EC=9D=B8=EC=97=90=20=EC=83=88=20=EC=97=94=EB=93=9C?=
 =?UTF-8?q?=ED=8F=AC=EC=9D=B8=ED=8A=B8=20=EC=B6=94=EA=B0=80=20=EC=8B=9C=20?=
 =?UTF-8?q?=EC=BD=94=EB=93=9C=20=EC=83=9D=EC=84=B1=20=EC=98=A4=EB=A5=98=20?=
 =?UTF-8?q?=EC=88=98=EC=A0=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Controller는 항상 재생성 (모든 엔드포인트 합산 파일)
- Service/DTO는 이미 존재하면 스킵, force=true면 재생성

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .../controller/ComplianceController.java      |  39 ------
 .../compliance/dto/ComplianceBypassDto.java   | 122 ------------------
 .../service/ComplianceBypassService.java      |  35 -----
 .../batch/service/BypassCodeGenerator.java    |  28 +++-
 4 files changed, 21 insertions(+), 203 deletions(-)
 delete mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/controller/ComplianceController.java
 delete mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/dto/ComplianceBypassDto.java
 delete mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/service/ComplianceBypassService.java

diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/controller/ComplianceController.java b/src/main/java/com/snp/batch/jobs/web/compliance/controller/ComplianceController.java
deleted file mode 100644
index f88b107..0000000
--- a/src/main/java/com/snp/batch/jobs/web/compliance/controller/ComplianceController.java
+++ /dev/null
@@ -1,39 +0,0 @@
-package com.snp.batch.jobs.web.compliance.controller;
-
-import com.snp.batch.jobs.web.compliance.dto.ComplianceBypassDto;
-import com.snp.batch.jobs.web.compliance.service.ComplianceBypassService;
-import com.snp.batch.common.web.ApiResponse;
-import com.snp.batch.common.web.controller.BaseBypassController;
-import io.swagger.v3.oas.annotations.Operation;
-import io.swagger.v3.oas.annotations.Parameter;
-import io.swagger.v3.oas.annotations.tags.Tag;
-import java.util.List;
-import lombok.RequiredArgsConstructor;
-import org.springframework.http.ResponseEntity;
-import org.springframework.web.bind.annotation.RequestMapping;
-import org.springframework.web.bind.annotation.RestController;
-import org.springframework.web.bind.annotation.GetMapping;
-import org.springframework.web.bind.annotation.RequestParam;
-
-/**
- * IMO 기반 선박 Compliance 조회 bypass API
- * S&P Maritime API에서 데이터를 실시간 조회하여 그대로 반환
- */
-@RestController
-@RequestMapping("/api/compliance")
-@RequiredArgsConstructor
-@Tag(name = "Compliance", description = "IMO 기반 선박 Compliance 조회 bypass API")
-public class ComplianceController extends BaseBypassController {
-
-    private final ComplianceBypassService complianceBypassService;
-
-    @Operation(
-            summary = "IMO 기반 선박 Compliance 조회 조회",
-            description = "S&P API에서 IMO 기반 선박 Compliance 조회 데이터를 요청하고 응답을 그대로 반환합니다."
-    )
-    @GetMapping("/CompliancesByImos")
-    public ResponseEntity<ApiResponse<List<ComplianceBypassDto>>> getComplianceData(@Parameter(description = "IMO(최대 100개)")
-                @RequestParam(required = true) String imos) {
-        return execute(() -> complianceBypassService.getComplianceData(imos));
-    }
-}
diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/dto/ComplianceBypassDto.java b/src/main/java/com/snp/batch/jobs/web/compliance/dto/ComplianceBypassDto.java
deleted file mode 100644
index 600d35d..0000000
--- a/src/main/java/com/snp/batch/jobs/web/compliance/dto/ComplianceBypassDto.java
+++ /dev/null
@@ -1,122 +0,0 @@
-package com.snp.batch.jobs.web.compliance.dto;
-
-import com.fasterxml.jackson.annotation.JsonProperty;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Getter;
-import lombok.NoArgsConstructor;
-import lombok.Setter;
-
-@Getter
-@Setter
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class ComplianceBypassDto {
-
-    @JsonProperty("dateAmended")
-    private String dateAmended;
-
-    @JsonProperty("legalOverall")
-    private Integer legalOverall;
-
-    @JsonProperty("lrimoShipNo")
-    private String lrimoShipNo;
-
-    @JsonProperty("shipBESSanctionList")
-    private Integer shipBESSanctionList;
-
-    @JsonProperty("shipDarkActivityIndicator")
-    private Integer shipDarkActivityIndicator;
-
-    @JsonProperty("shipDetailsNoLongerMaintained")
-    private Integer shipDetailsNoLongerMaintained;
-
-    @JsonProperty("shipEUSanctionList")
-    private Integer shipEUSanctionList;
-
-    @JsonProperty("shipFlagDisputed")
-    private Integer shipFlagDisputed;
-
-    @JsonProperty("shipFlagSanctionedCountry")
-    private Integer shipFlagSanctionedCountry;
-
-    @JsonProperty("shipHistoricalFlagSanctionedCountry")
-    private Integer shipHistoricalFlagSanctionedCountry;
-
-    @JsonProperty("shipOFACAdvisoryList")
-    private Integer shipOFACAdvisoryList;
-
-    @JsonProperty("shipOFACNonSDNSanctionList")
-    private Integer shipOFACNonSDNSanctionList;
-
-    @JsonProperty("shipOFACSanctionList")
-    private Integer shipOFACSanctionList;
-
-    @JsonProperty("shipOwnerAustralianSanctionList")
-    private Integer shipOwnerAustralianSanctionList;
-
-    @JsonProperty("shipOwnerBESSanctionList")
-    private Integer shipOwnerBESSanctionList;
-
-    @JsonProperty("shipOwnerCanadianSanctionList")
-    private Integer shipOwnerCanadianSanctionList;
-
-    @JsonProperty("shipOwnerEUSanctionList")
-    private Integer shipOwnerEUSanctionList;
-
-    @JsonProperty("shipOwnerFATFJurisdiction")
-    private Integer shipOwnerFATFJurisdiction;
-
-    @JsonProperty("shipOwnerHistoricalOFACSanctionedCountry")
-    private Integer shipOwnerHistoricalOFACSanctionedCountry;
-
-    @JsonProperty("shipOwnerOFACSSIList")
-    private Integer shipOwnerOFACSSIList;
-
-    @JsonProperty("shipOwnerOFACSanctionList")
-    private Integer shipOwnerOFACSanctionList;
-
-    @JsonProperty("shipOwnerOFACSanctionedCountry")
-    private Integer shipOwnerOFACSanctionedCountry;
-
-    @JsonProperty("shipOwnerParentCompanyNonCompliance")
-    private Integer shipOwnerParentCompanyNonCompliance;
-
-    @JsonProperty("shipOwnerParentFATFJurisdiction")
-    private String shipOwnerParentFATFJurisdiction;
-
-    @JsonProperty("shipOwnerParentOFACSanctionedCountry")
-    private String shipOwnerParentOFACSanctionedCountry;
-
-    @JsonProperty("shipOwnerSwissSanctionList")
-    private Integer shipOwnerSwissSanctionList;
-
-    @JsonProperty("shipOwnerUAESanctionList")
-    private Integer shipOwnerUAESanctionList;
-
-    @JsonProperty("shipOwnerUNSanctionList")
-    private Integer shipOwnerUNSanctionList;
-
-    @JsonProperty("shipSTSPartnerNonComplianceLast12m")
-    private Integer shipSTSPartnerNonComplianceLast12m;
-
-    @JsonProperty("shipSanctionedCountryPortCallLast12m")
-    private Integer shipSanctionedCountryPortCallLast12m;
-
-    @JsonProperty("shipSanctionedCountryPortCallLast3m")
-    private Integer shipSanctionedCountryPortCallLast3m;
-
-    @JsonProperty("shipSanctionedCountryPortCallLast6m")
-    private Integer shipSanctionedCountryPortCallLast6m;
-
-    @JsonProperty("shipSecurityLegalDisputeEvent")
-    private Integer shipSecurityLegalDisputeEvent;
-
-    @JsonProperty("shipSwissSanctionList")
-    private Integer shipSwissSanctionList;
-
-    @JsonProperty("shipUNSanctionList")
-    private Integer shipUNSanctionList;
-
-}
diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/service/ComplianceBypassService.java b/src/main/java/com/snp/batch/jobs/web/compliance/service/ComplianceBypassService.java
deleted file mode 100644
index 67f27d2..0000000
--- a/src/main/java/com/snp/batch/jobs/web/compliance/service/ComplianceBypassService.java
+++ /dev/null
@@ -1,35 +0,0 @@
-package com.snp.batch.jobs.web.compliance.service;
-
-import com.snp.batch.jobs.web.compliance.dto.ComplianceBypassDto;
-import com.snp.batch.common.web.service.BaseBypassService;
-import java.util.List;
-import org.springframework.beans.factory.annotation.Qualifier;
-import org.springframework.core.ParameterizedTypeReference;
-import org.springframework.stereotype.Service;
-import org.springframework.web.reactive.function.client.WebClient;
-
-/**
- * IMO 기반 선박 Compliance 조회 bypass 서비스
- * 외부 Maritime API에서 데이터를 실시간 조회하여 그대로 반환
- */
-@Service
-public class ComplianceBypassService extends BaseBypassService<ComplianceBypassDto> {
-
-    public ComplianceBypassService(
-            @Qualifier("maritimeServiceApiWebClient") WebClient webClient) {
-        super(webClient, "/RiskAndCompliance/CompliancesByImos", "IMO 기반 선박 Compliance 조회",
-                new ParameterizedTypeReference<>() {},
-                new ParameterizedTypeReference<>() {});
-    }
-
-    /**
-     * IMO 기반 선박 Compliance 조회 데이터를 조회합니다.
-     *
-     * @return IMO 기반 선박 Compliance 조회
-     */
-    public List<ComplianceBypassDto> getComplianceData(String imos) {
-        return fetchGetList(uri -> uri.path(getApiPath())
-                        .queryParam("imos", imos)
-                        .build());
-    }
-}
diff --git a/src/main/java/com/snp/batch/service/BypassCodeGenerator.java b/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
index 0b4049d..bf9d5a6 100644
--- a/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
+++ b/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
@@ -50,20 +50,34 @@ public class BypassCodeGenerator {
         for (BypassApiConfig config : configs) {
             String endpointName = config.getEndpointName();
 
-            String dtoCode = generateDtoCode(domain, endpointName, config.getFields());
-            String serviceCode = generateServiceCode(domain, endpointName, config, config.getParams());
+            String dtoPath = basePath + "/dto/" + endpointName + "Dto.java";
+            String servicePath = basePath + "/service/" + endpointName + "Service.java";
 
-            Path dtoFilePath = writeFile(basePath + "/dto/" + endpointName + "Dto.java", dtoCode, force);
-            Path serviceFilePath = writeFile(basePath + "/service/" + endpointName + "Service.java", serviceCode, force);
+            // Service/DTO: 이미 존재하면 스킵 (force=true면 재생성)
+            if (!force && Files.exists(Path.of(dtoPath))) {
+                log.info("DTO 파일 이미 존재, 스킵: {}", dtoPath);
+                dtoPaths.add(dtoPath);
+            } else {
+                String dtoCode = generateDtoCode(domain, endpointName, config.getFields());
+                Path dtoFilePath = writeFile(dtoPath, dtoCode, true);
+                dtoPaths.add(dtoFilePath.toString());
+            }
 
-            dtoPaths.add(dtoFilePath.toString());
-            servicePaths.add(serviceFilePath.toString());
+            if (!force && Files.exists(Path.of(servicePath))) {
+                log.info("Service 파일 이미 존재, 스킵: {}", servicePath);
+                servicePaths.add(servicePath);
+            } else {
+                String serviceCode = generateServiceCode(domain, endpointName, config, config.getParams());
+                Path serviceFilePath = writeFile(servicePath, serviceCode, true);
+                servicePaths.add(serviceFilePath.toString());
+            }
         }
 
+        // Controller: 모든 엔드포인트를 합치므로 항상 재생성
         String controllerCode = generateControllerCode(domain, configs);
         String domainCapitalized = capitalize(domain);
         Path controllerFilePath = writeFile(
-                basePath + "/controller/" + domainCapitalized + "Controller.java", controllerCode, force);
+                basePath + "/controller/" + domainCapitalized + "Controller.java", controllerCode, true);
 
         log.info("코드 생성 완료 - domain: {}, endpoints: {}, controller: {}",
                 domain, configs.stream().map(BypassApiConfig::getEndpointName).toList(), controllerFilePath);
-- 
2.45.2


From 9667d3a0ac90e9710e915b62ddf2483185ede796 Mon Sep 17 00:00:00 2001
From: HYOJIN <hjkim4@gcsc.co.kr>
Date: Fri, 27 Mar 2026 09:39:23 +0900
Subject: [PATCH 11/19] =?UTF-8?q?feat:=20=EC=A4=91=EC=B2=A9=20JSON=20?=
 =?UTF-8?q?=EA=B5=AC=EC=A1=B0=20=ED=8C=8C=EC=8B=B1=20=EB=8C=80=EC=9D=91=20?=
 =?UTF-8?q?=EB=B0=8F=20DTO=20import=20=EB=B2=84=EA=B7=B8=20=EC=88=98?=
 =?UTF-8?q?=EC=A0=95=20(#63)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

백엔드:
- generateDtoCode에서 List/Map 타입 import 자동 추가
- JsonSchemaParser에 targetField 파라미터 추가 (특정 필드 내부만 파싱)
- 배열 내 객체 감지 시 List<{FieldName}Item> 타입으로 추론

프론트엔드:
- JSON 샘플 파싱 시 "전체 JSON / 특정 필드 내부" 선택 옵션 추가
- targetField 기본값 "data" (페이징 래퍼 대응)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 frontend/src/api/bypassApi.ts                 |   5 +-
 .../components/bypass/BypassStepFields.tsx    |  47 ++++++-
 .../controller/BypassConfigController.java    |   8 +-
 .../controller/ComplianceController.java      |  85 ++++++++++++
 .../dto/ComplianceValuesMeaningDto.java       |  23 ++++
 .../compliance/dto/CompliancesByImosDto.java  | 122 ++++++++++++++++++
 .../dto/PagedUpdatedComplianceListDto.java    |  45 +++++++
 .../dto/UpdatedComplianceListDto.java         | 122 ++++++++++++++++++
 .../ComplianceValuesMeaningService.java       |  34 +++++
 .../service/CompliancesByImosService.java     |  35 +++++
 .../PagedUpdatedComplianceListService.java    |  38 ++++++
 .../service/UpdatedComplianceListService.java |  36 ++++++
 .../batch/service/BypassCodeGenerator.java    |  11 ++
 .../snp/batch/service/JsonSchemaParser.java   |  57 +++++++-
 14 files changed, 659 insertions(+), 9 deletions(-)
 create mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/controller/ComplianceController.java
 create mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/dto/ComplianceValuesMeaningDto.java
 create mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/dto/CompliancesByImosDto.java
 create mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/dto/PagedUpdatedComplianceListDto.java
 create mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/dto/UpdatedComplianceListDto.java
 create mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/service/ComplianceValuesMeaningService.java
 create mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/service/CompliancesByImosService.java
 create mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/service/PagedUpdatedComplianceListService.java
 create mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/service/UpdatedComplianceListService.java

diff --git a/frontend/src/api/bypassApi.ts b/frontend/src/api/bypassApi.ts
index deec912..a90532b 100644
--- a/frontend/src/api/bypassApi.ts
+++ b/frontend/src/api/bypassApi.ts
@@ -117,8 +117,9 @@ export const bypassApi = {
         deleteJson<ApiResponse<void>>(`${BASE}/${id}`),
     generateCode: (id: number, force = false) =>
         postJson<ApiResponse<CodeGenerationResult>>(`${BASE}/${id}/generate?force=${force}`),
-    parseJson: async (jsonSample: string): Promise<ApiResponse<BypassFieldDto[]>> => {
-        const res = await fetch(`${BASE}/parse-json`, {
+    parseJson: async (jsonSample: string, targetField?: string): Promise<ApiResponse<BypassFieldDto[]>> => {
+        const params = targetField ? `?targetField=${encodeURIComponent(targetField)}` : '';
+        const res = await fetch(`${BASE}/parse-json${params}`, {
             method: 'POST',
             headers: { 'Content-Type': 'application/json' },
             body: jsonSample, // 이미 JSON 문자열이므로 JSON.stringify 하지 않음
diff --git a/frontend/src/components/bypass/BypassStepFields.tsx b/frontend/src/components/bypass/BypassStepFields.tsx
index cacc8f3..6027b18 100644
--- a/frontend/src/components/bypass/BypassStepFields.tsx
+++ b/frontend/src/components/bypass/BypassStepFields.tsx
@@ -26,6 +26,8 @@ export default function BypassStepFields({ fields, onChange }: BypassStepFieldsP
     const [jsonSample, setJsonSample] = useState('');
     const [parsing, setParsing] = useState(false);
     const [parseError, setParseError] = useState<string | null>(null);
+    const [parseMode, setParseMode] = useState<'root' | 'field'>('root');
+    const [targetField, setTargetField] = useState('data');
 
     const handleAdd = () => {
         onChange([...fields, createEmptyField(fields.length)]);
@@ -53,7 +55,8 @@ export default function BypassStepFields({ fields, onChange }: BypassStepFieldsP
         setParseError(null);
         setParsing(true);
         try {
-            const result = await bypassApi.parseJson(jsonSample);
+            const tf = parseMode === 'field' ? targetField : undefined;
+            const result = await bypassApi.parseJson(jsonSample.trim(), tf);
             if (result.success && result.data) {
                 onChange(result.data);
                 setActiveTab('manual');
@@ -220,6 +223,48 @@ export default function BypassStepFields({ fields, onChange }: BypassStepFieldsP
                         placeholder={'{\n  "riskScore": 85,\n  "imoNumber": "1234567",\n  "vesselName": "EXAMPLE SHIP"\n}'}
                         className="w-full px-3 py-2 text-sm font-mono rounded-lg border border-wing-border bg-wing-card text-wing-text placeholder:text-wing-muted focus:outline-none focus:ring-2 focus:ring-wing-accent/50 resize-none"
                     />
+
+                    {/* 파싱 옵션 */}
+                    <div className="mt-3 space-y-2">
+                        <label className="text-sm font-medium text-wing-text">파싱 대상</label>
+                        <div className="flex items-center gap-4">
+                            <label className="flex items-center gap-2 text-sm text-wing-text cursor-pointer">
+                                <input
+                                    type="radio"
+                                    name="parseMode"
+                                    checked={parseMode === 'root'}
+                                    onChange={() => setParseMode('root')}
+                                    className="accent-wing-accent"
+                                />
+                                전체 JSON
+                            </label>
+                            <label className="flex items-center gap-2 text-sm text-wing-text cursor-pointer">
+                                <input
+                                    type="radio"
+                                    name="parseMode"
+                                    checked={parseMode === 'field'}
+                                    onChange={() => setParseMode('field')}
+                                    className="accent-wing-accent"
+                                />
+                                특정 필드 내부
+                            </label>
+                        </div>
+                        {parseMode === 'field' && (
+                            <div className="flex items-center gap-2">
+                                <input
+                                    type="text"
+                                    value={targetField}
+                                    onChange={(e) => setTargetField(e.target.value)}
+                                    placeholder="필드명 (예: data, results, items)"
+                                    className="px-3 py-1.5 text-sm rounded-lg border border-wing-border bg-wing-surface text-wing-text placeholder:text-wing-muted focus:outline-none focus:ring-1 focus:ring-wing-accent/50"
+                                />
+                                <span className="text-xs text-wing-muted">
+                                    해당 필드가 배열이면 첫 번째 요소를, 객체면 그 내부를 파싱합니다.
+                                </span>
+                            </div>
+                        )}
+                    </div>
+
                     {parseError && (
                         <p className="text-sm text-red-500">{parseError}</p>
                     )}
diff --git a/src/main/java/com/snp/batch/global/controller/BypassConfigController.java b/src/main/java/com/snp/batch/global/controller/BypassConfigController.java
index bea3101..4b56b65 100644
--- a/src/main/java/com/snp/batch/global/controller/BypassConfigController.java
+++ b/src/main/java/com/snp/batch/global/controller/BypassConfigController.java
@@ -108,12 +108,14 @@ public class BypassConfigController {
 
     @Operation(
             summary = "JSON 샘플 파싱",
-            description = "JSON 샘플에서 DTO 필드 목록을 추출합니다."
+            description = "JSON 샘플에서 DTO 필드 목록을 추출합니다. targetField를 지정하면 해당 필드 내부를 파싱합니다. 예: targetField=data → root.data[0] 내부 필드 추출."
     )
     @PostMapping("/parse-json")
-    public ResponseEntity<ApiResponse<List<BypassFieldDto>>> parseJson(@RequestBody String jsonSample) {
+    public ResponseEntity<ApiResponse<List<BypassFieldDto>>> parseJson(
+            @RequestBody String jsonSample,
+            @RequestParam(required = false) String targetField) {
         try {
-            List<BypassFieldDto> fields = jsonSchemaParser.parse(jsonSample);
+            List<BypassFieldDto> fields = jsonSchemaParser.parse(jsonSample, targetField);
             return ResponseEntity.ok(ApiResponse.success(fields));
         } catch (Exception e) {
             return ResponseEntity.badRequest().body(ApiResponse.error("JSON 파싱 실패: " + e.getMessage()));
diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/controller/ComplianceController.java b/src/main/java/com/snp/batch/jobs/web/compliance/controller/ComplianceController.java
new file mode 100644
index 0000000..6668cb9
--- /dev/null
+++ b/src/main/java/com/snp/batch/jobs/web/compliance/controller/ComplianceController.java
@@ -0,0 +1,85 @@
+package com.snp.batch.jobs.web.compliance.controller;
+
+import com.snp.batch.common.web.ApiResponse;
+import com.snp.batch.common.web.controller.BaseBypassController;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+import java.util.List;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import com.snp.batch.jobs.web.compliance.dto.CompliancesByImosDto;
+import com.snp.batch.jobs.web.compliance.service.CompliancesByImosService;
+import com.snp.batch.jobs.web.compliance.dto.UpdatedComplianceListDto;
+import com.snp.batch.jobs.web.compliance.service.UpdatedComplianceListService;
+import com.snp.batch.jobs.web.compliance.dto.ComplianceValuesMeaningDto;
+import com.snp.batch.jobs.web.compliance.service.ComplianceValuesMeaningService;
+import com.snp.batch.jobs.web.compliance.dto.PagedUpdatedComplianceListDto;
+import com.snp.batch.jobs.web.compliance.service.PagedUpdatedComplianceListService;
+
+/**
+ * Compliance bypass API
+ * S&P Maritime API에서 데이터를 실시간 조회하여 그대로 반환
+ */
+@RestController
+@RequestMapping("/api/compliance")
+@RequiredArgsConstructor
+@Tag(name = "Compliance", description = "[Service API] Compliance bypass API")
+public class ComplianceController extends BaseBypassController {
+
+    private final CompliancesByImosService compliancesByImosService;
+    private final UpdatedComplianceListService updatedComplianceListService;
+    private final ComplianceValuesMeaningService complianceValuesMeaningService;
+    private final PagedUpdatedComplianceListService pagedUpdatedComplianceListService;
+
+    @Operation(
+            summary = "IMO 기반 Compliance 조회 조회",
+            description = "S&P API에서 IMO 기반 Compliance 조회 데이터를 요청하고 응답을 그대로 반환합니다."
+    )
+    @GetMapping("/CompliancesByImos")
+    public ResponseEntity<ApiResponse<List<CompliancesByImosDto>>> getCompliancesByImosData(@Parameter(description = "Comma separated IMOs up to a total of 100", example = "9876543")
+                @RequestParam(required = true) String imos) {
+        return execute(() -> compliancesByImosService.getCompliancesByImosData(imos));
+    }
+
+    @Operation(
+            summary = "기간 내 변경 Compliance 조회 조회",
+            description = "S&P API에서 기간 내 변경 Compliance 조회 데이터를 요청하고 응답을 그대로 반환합니다."
+    )
+    @GetMapping("/UpdatedComplianceList")
+    public ResponseEntity<ApiResponse<List<UpdatedComplianceListDto>>> getUpdatedComplianceListData(@Parameter(description = "Time/seconds are optional", example = "9876543")
+                @RequestParam(required = true) String fromDate,
+            @Parameter(description = "Time/seconds are optional. If unspecified, the current UTC date and time is used", example = "9876543")
+                @RequestParam(required = true) String toDate) {
+        return execute(() -> updatedComplianceListService.getUpdatedComplianceListData(fromDate, toDate));
+    }
+
+    @Operation(
+            summary = "모든 Compliance 지표 조회 조회",
+            description = "S&P API에서 모든 Compliance 지표 조회 데이터를 요청하고 응답을 그대로 반환합니다."
+    )
+    @GetMapping("/ComplianceValuesMeaning")
+    public ResponseEntity<ApiResponse<List<ComplianceValuesMeaningDto>>> getComplianceValuesMeaningData() {
+        return execute(() -> complianceValuesMeaningService.getComplianceValuesMeaningData());
+    }
+
+    @Operation(
+            summary = "PagedUpdatedComplianceList 조회",
+            description = "S&P API에서 PagedUpdatedComplianceList 데이터를 요청하고 응답을 그대로 반환합니다."
+    )
+    @GetMapping("/PagedUpdatedComplianceList")
+    public ResponseEntity<ApiResponse<List<PagedUpdatedComplianceListDto>>> getPagedUpdatedComplianceListData(@Parameter(description = "Time/seconds are optional", example = "9876543")
+                @RequestParam(required = true) String fromDate,
+            @Parameter(description = "Time/seconds are optional. If unspecified, the current UTC date and time is used", example = "9876543")
+                @RequestParam(required = true) String toDate,
+            @Parameter(description = "Page number to display.", example = "9876543")
+                @RequestParam(required = true) String pageNumber,
+            @Parameter(description = "How many elements will be on the single page. Maximum allowed is 1000.", example = "9876543")
+                @RequestParam(required = true) String pageSize) {
+        return execute(() -> pagedUpdatedComplianceListService.getPagedUpdatedComplianceListData(fromDate, toDate, pageNumber, pageSize));
+    }
+}
diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/dto/ComplianceValuesMeaningDto.java b/src/main/java/com/snp/batch/jobs/web/compliance/dto/ComplianceValuesMeaningDto.java
new file mode 100644
index 0000000..2df4695
--- /dev/null
+++ b/src/main/java/com/snp/batch/jobs/web/compliance/dto/ComplianceValuesMeaningDto.java
@@ -0,0 +1,23 @@
+package com.snp.batch.jobs.web.compliance.dto;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.Setter;
+
+@Getter
+@Setter
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class ComplianceValuesMeaningDto {
+
+    @JsonProperty("complianceValue")
+    private Integer complianceValue;
+
+    @JsonProperty("meaning")
+    private String meaning;
+
+}
diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/dto/CompliancesByImosDto.java b/src/main/java/com/snp/batch/jobs/web/compliance/dto/CompliancesByImosDto.java
new file mode 100644
index 0000000..d250ac7
--- /dev/null
+++ b/src/main/java/com/snp/batch/jobs/web/compliance/dto/CompliancesByImosDto.java
@@ -0,0 +1,122 @@
+package com.snp.batch.jobs.web.compliance.dto;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.Setter;
+
+@Getter
+@Setter
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class CompliancesByImosDto {
+
+    @JsonProperty("lrimoShipNo")
+    private String lrimoShipNo;
+
+    @JsonProperty("dateAmended")
+    private String dateAmended;
+
+    @JsonProperty("legalOverall")
+    private Integer legalOverall;
+
+    @JsonProperty("shipBESSanctionList")
+    private Integer shipBESSanctionList;
+
+    @JsonProperty("shipDarkActivityIndicator")
+    private Integer shipDarkActivityIndicator;
+
+    @JsonProperty("shipDetailsNoLongerMaintained")
+    private Integer shipDetailsNoLongerMaintained;
+
+    @JsonProperty("shipEUSanctionList")
+    private Integer shipEUSanctionList;
+
+    @JsonProperty("shipFlagDisputed")
+    private Integer shipFlagDisputed;
+
+    @JsonProperty("shipFlagSanctionedCountry")
+    private Integer shipFlagSanctionedCountry;
+
+    @JsonProperty("shipHistoricalFlagSanctionedCountry")
+    private Integer shipHistoricalFlagSanctionedCountry;
+
+    @JsonProperty("shipOFACNonSDNSanctionList")
+    private Integer shipOFACNonSDNSanctionList;
+
+    @JsonProperty("shipOFACSanctionList")
+    private Integer shipOFACSanctionList;
+
+    @JsonProperty("shipOFACAdvisoryList")
+    private Integer shipOFACAdvisoryList;
+
+    @JsonProperty("shipOwnerOFACSSIList")
+    private Integer shipOwnerOFACSSIList;
+
+    @JsonProperty("shipOwnerAustralianSanctionList")
+    private Integer shipOwnerAustralianSanctionList;
+
+    @JsonProperty("shipOwnerBESSanctionList")
+    private Integer shipOwnerBESSanctionList;
+
+    @JsonProperty("shipOwnerCanadianSanctionList")
+    private Integer shipOwnerCanadianSanctionList;
+
+    @JsonProperty("shipOwnerEUSanctionList")
+    private Integer shipOwnerEUSanctionList;
+
+    @JsonProperty("shipOwnerFATFJurisdiction")
+    private Integer shipOwnerFATFJurisdiction;
+
+    @JsonProperty("shipOwnerHistoricalOFACSanctionedCountry")
+    private Integer shipOwnerHistoricalOFACSanctionedCountry;
+
+    @JsonProperty("shipOwnerOFACSanctionList")
+    private Integer shipOwnerOFACSanctionList;
+
+    @JsonProperty("shipOwnerOFACSanctionedCountry")
+    private Integer shipOwnerOFACSanctionedCountry;
+
+    @JsonProperty("shipOwnerParentCompanyNonCompliance")
+    private Integer shipOwnerParentCompanyNonCompliance;
+
+    @JsonProperty("shipOwnerParentFATFJurisdiction")
+    private String shipOwnerParentFATFJurisdiction;
+
+    @JsonProperty("shipOwnerParentOFACSanctionedCountry")
+    private String shipOwnerParentOFACSanctionedCountry;
+
+    @JsonProperty("shipOwnerSwissSanctionList")
+    private Integer shipOwnerSwissSanctionList;
+
+    @JsonProperty("shipOwnerUAESanctionList")
+    private Integer shipOwnerUAESanctionList;
+
+    @JsonProperty("shipOwnerUNSanctionList")
+    private Integer shipOwnerUNSanctionList;
+
+    @JsonProperty("shipSanctionedCountryPortCallLast12m")
+    private Integer shipSanctionedCountryPortCallLast12m;
+
+    @JsonProperty("shipSanctionedCountryPortCallLast3m")
+    private Integer shipSanctionedCountryPortCallLast3m;
+
+    @JsonProperty("shipSanctionedCountryPortCallLast6m")
+    private Integer shipSanctionedCountryPortCallLast6m;
+
+    @JsonProperty("shipSecurityLegalDisputeEvent")
+    private Integer shipSecurityLegalDisputeEvent;
+
+    @JsonProperty("shipSTSPartnerNonComplianceLast12m")
+    private Integer shipSTSPartnerNonComplianceLast12m;
+
+    @JsonProperty("shipSwissSanctionList")
+    private Integer shipSwissSanctionList;
+
+    @JsonProperty("shipUNSanctionList")
+    private Integer shipUNSanctionList;
+
+}
diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/dto/PagedUpdatedComplianceListDto.java b/src/main/java/com/snp/batch/jobs/web/compliance/dto/PagedUpdatedComplianceListDto.java
new file mode 100644
index 0000000..cc75997
--- /dev/null
+++ b/src/main/java/com/snp/batch/jobs/web/compliance/dto/PagedUpdatedComplianceListDto.java
@@ -0,0 +1,45 @@
+package com.snp.batch.jobs.web.compliance.dto;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.Setter;
+import java.util.List;
+
+@Getter
+@Setter
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class PagedUpdatedComplianceListDto {
+
+    @JsonProperty("pageSize")
+    private Integer pageSize;
+
+    @JsonProperty("pageNumber")
+    private Integer pageNumber;
+
+    @JsonProperty("firstPage")
+    private String firstPage;
+
+    @JsonProperty("lastPage")
+    private String lastPage;
+
+    @JsonProperty("totalPages")
+    private Integer totalPages;
+
+    @JsonProperty("totalRecords")
+    private Integer totalRecords;
+
+    @JsonProperty("nextPage")
+    private String nextPage;
+
+    @JsonProperty("previousPage")
+    private String previousPage;
+
+    @JsonProperty("data")
+    private List<Object> data;
+
+}
diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/dto/UpdatedComplianceListDto.java b/src/main/java/com/snp/batch/jobs/web/compliance/dto/UpdatedComplianceListDto.java
new file mode 100644
index 0000000..5789c15
--- /dev/null
+++ b/src/main/java/com/snp/batch/jobs/web/compliance/dto/UpdatedComplianceListDto.java
@@ -0,0 +1,122 @@
+package com.snp.batch.jobs.web.compliance.dto;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.Setter;
+
+@Getter
+@Setter
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class UpdatedComplianceListDto {
+
+    @JsonProperty("lrimoShipNo")
+    private String lrimoShipNo;
+
+    @JsonProperty("dateAmended")
+    private String dateAmended;
+
+    @JsonProperty("legalOverall")
+    private Integer legalOverall;
+
+    @JsonProperty("shipBESSanctionList")
+    private Integer shipBESSanctionList;
+
+    @JsonProperty("shipDarkActivityIndicator")
+    private Integer shipDarkActivityIndicator;
+
+    @JsonProperty("shipDetailsNoLongerMaintained")
+    private Integer shipDetailsNoLongerMaintained;
+
+    @JsonProperty("shipEUSanctionList")
+    private Integer shipEUSanctionList;
+
+    @JsonProperty("shipFlagDisputed")
+    private Integer shipFlagDisputed;
+
+    @JsonProperty("shipFlagSanctionedCountry")
+    private Integer shipFlagSanctionedCountry;
+
+    @JsonProperty("shipHistoricalFlagSanctionedCountry")
+    private Integer shipHistoricalFlagSanctionedCountry;
+
+    @JsonProperty("shipOFACNonSDNSanctionList")
+    private Integer shipOFACNonSDNSanctionList;
+
+    @JsonProperty("shipOFACSanctionList")
+    private Integer shipOFACSanctionList;
+
+    @JsonProperty("shipOFACAdvisoryList")
+    private Integer shipOFACAdvisoryList;
+
+    @JsonProperty("shipOwnerOFACSSIList")
+    private Integer shipOwnerOFACSSIList;
+
+    @JsonProperty("shipOwnerAustralianSanctionList")
+    private Integer shipOwnerAustralianSanctionList;
+
+    @JsonProperty("shipOwnerBESSanctionList")
+    private Integer shipOwnerBESSanctionList;
+
+    @JsonProperty("shipOwnerCanadianSanctionList")
+    private Integer shipOwnerCanadianSanctionList;
+
+    @JsonProperty("shipOwnerEUSanctionList")
+    private Integer shipOwnerEUSanctionList;
+
+    @JsonProperty("shipOwnerFATFJurisdiction")
+    private Integer shipOwnerFATFJurisdiction;
+
+    @JsonProperty("shipOwnerHistoricalOFACSanctionedCountry")
+    private Integer shipOwnerHistoricalOFACSanctionedCountry;
+
+    @JsonProperty("shipOwnerOFACSanctionList")
+    private Integer shipOwnerOFACSanctionList;
+
+    @JsonProperty("shipOwnerOFACSanctionedCountry")
+    private Integer shipOwnerOFACSanctionedCountry;
+
+    @JsonProperty("shipOwnerParentCompanyNonCompliance")
+    private Integer shipOwnerParentCompanyNonCompliance;
+
+    @JsonProperty("shipOwnerParentFATFJurisdiction")
+    private Integer shipOwnerParentFATFJurisdiction;
+
+    @JsonProperty("shipOwnerParentOFACSanctionedCountry")
+    private Integer shipOwnerParentOFACSanctionedCountry;
+
+    @JsonProperty("shipOwnerSwissSanctionList")
+    private Integer shipOwnerSwissSanctionList;
+
+    @JsonProperty("shipOwnerUAESanctionList")
+    private Integer shipOwnerUAESanctionList;
+
+    @JsonProperty("shipOwnerUNSanctionList")
+    private Integer shipOwnerUNSanctionList;
+
+    @JsonProperty("shipSanctionedCountryPortCallLast12m")
+    private Integer shipSanctionedCountryPortCallLast12m;
+
+    @JsonProperty("shipSanctionedCountryPortCallLast3m")
+    private Integer shipSanctionedCountryPortCallLast3m;
+
+    @JsonProperty("shipSanctionedCountryPortCallLast6m")
+    private Integer shipSanctionedCountryPortCallLast6m;
+
+    @JsonProperty("shipSecurityLegalDisputeEvent")
+    private Integer shipSecurityLegalDisputeEvent;
+
+    @JsonProperty("shipSTSPartnerNonComplianceLast12m")
+    private Integer shipSTSPartnerNonComplianceLast12m;
+
+    @JsonProperty("shipSwissSanctionList")
+    private Integer shipSwissSanctionList;
+
+    @JsonProperty("shipUNSanctionList")
+    private Integer shipUNSanctionList;
+
+}
diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/service/ComplianceValuesMeaningService.java b/src/main/java/com/snp/batch/jobs/web/compliance/service/ComplianceValuesMeaningService.java
new file mode 100644
index 0000000..7a10912
--- /dev/null
+++ b/src/main/java/com/snp/batch/jobs/web/compliance/service/ComplianceValuesMeaningService.java
@@ -0,0 +1,34 @@
+package com.snp.batch.jobs.web.compliance.service;
+
+import com.snp.batch.jobs.web.compliance.dto.ComplianceValuesMeaningDto;
+import com.snp.batch.common.web.service.BaseBypassService;
+import java.util.List;
+import org.springframework.beans.factory.annotation.Qualifier;
+import org.springframework.core.ParameterizedTypeReference;
+import org.springframework.stereotype.Service;
+import org.springframework.web.reactive.function.client.WebClient;
+
+/**
+ * 모든 Compliance 지표 조회 bypass 서비스
+ * 외부 Maritime API에서 데이터를 실시간 조회하여 그대로 반환
+ */
+@Service
+public class ComplianceValuesMeaningService extends BaseBypassService<ComplianceValuesMeaningDto> {
+
+    public ComplianceValuesMeaningService(
+            @Qualifier("maritimeServiceApiWebClient") WebClient webClient) {
+        super(webClient, "/RiskAndCompliance/ComplianceValuesMeaning", "모든 Compliance 지표 조회",
+                new ParameterizedTypeReference<>() {},
+                new ParameterizedTypeReference<>() {});
+    }
+
+    /**
+     * 모든 Compliance 지표 조회 데이터를 조회합니다.
+     *
+     * @return 모든 Compliance 지표 조회
+     */
+    public List<ComplianceValuesMeaningDto> getComplianceValuesMeaningData() {
+        return fetchGetList(uri -> uri.path(getApiPath())
+                        .build());
+    }
+}
diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/service/CompliancesByImosService.java b/src/main/java/com/snp/batch/jobs/web/compliance/service/CompliancesByImosService.java
new file mode 100644
index 0000000..7be28ee
--- /dev/null
+++ b/src/main/java/com/snp/batch/jobs/web/compliance/service/CompliancesByImosService.java
@@ -0,0 +1,35 @@
+package com.snp.batch.jobs.web.compliance.service;
+
+import com.snp.batch.jobs.web.compliance.dto.CompliancesByImosDto;
+import com.snp.batch.common.web.service.BaseBypassService;
+import java.util.List;
+import org.springframework.beans.factory.annotation.Qualifier;
+import org.springframework.core.ParameterizedTypeReference;
+import org.springframework.stereotype.Service;
+import org.springframework.web.reactive.function.client.WebClient;
+
+/**
+ * IMO 기반 Compliance 조회 bypass 서비스
+ * 외부 Maritime API에서 데이터를 실시간 조회하여 그대로 반환
+ */
+@Service
+public class CompliancesByImosService extends BaseBypassService<CompliancesByImosDto> {
+
+    public CompliancesByImosService(
+            @Qualifier("maritimeServiceApiWebClient") WebClient webClient) {
+        super(webClient, "/RiskAndCompliance/CompliancesByImos", "IMO 기반 Compliance 조회",
+                new ParameterizedTypeReference<>() {},
+                new ParameterizedTypeReference<>() {});
+    }
+
+    /**
+     * IMO 기반 Compliance 조회 데이터를 조회합니다.
+     *
+     * @return IMO 기반 Compliance 조회
+     */
+    public List<CompliancesByImosDto> getCompliancesByImosData(String imos) {
+        return fetchGetList(uri -> uri.path(getApiPath())
+                        .queryParam("imos", imos)
+                        .build());
+    }
+}
diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/service/PagedUpdatedComplianceListService.java b/src/main/java/com/snp/batch/jobs/web/compliance/service/PagedUpdatedComplianceListService.java
new file mode 100644
index 0000000..7eb2091
--- /dev/null
+++ b/src/main/java/com/snp/batch/jobs/web/compliance/service/PagedUpdatedComplianceListService.java
@@ -0,0 +1,38 @@
+package com.snp.batch.jobs.web.compliance.service;
+
+import com.snp.batch.jobs.web.compliance.dto.PagedUpdatedComplianceListDto;
+import com.snp.batch.common.web.service.BaseBypassService;
+import java.util.List;
+import org.springframework.beans.factory.annotation.Qualifier;
+import org.springframework.core.ParameterizedTypeReference;
+import org.springframework.stereotype.Service;
+import org.springframework.web.reactive.function.client.WebClient;
+
+/**
+ * PagedUpdatedComplianceList bypass 서비스
+ * 외부 Maritime API에서 데이터를 실시간 조회하여 그대로 반환
+ */
+@Service
+public class PagedUpdatedComplianceListService extends BaseBypassService<PagedUpdatedComplianceListDto> {
+
+    public PagedUpdatedComplianceListService(
+            @Qualifier("maritimeServiceApiWebClient") WebClient webClient) {
+        super(webClient, "/RiskAndCompliance/PagedUpdatedComplianceList", "PagedUpdatedComplianceList",
+                new ParameterizedTypeReference<>() {},
+                new ParameterizedTypeReference<>() {});
+    }
+
+    /**
+     * PagedUpdatedComplianceList 데이터를 조회합니다.
+     *
+     * @return PagedUpdatedComplianceList
+     */
+    public List<PagedUpdatedComplianceListDto> getPagedUpdatedComplianceListData(String fromDate, String toDate, String pageNumber, String pageSize) {
+        return fetchGetList(uri -> uri.path(getApiPath())
+                        .queryParam("fromDate", fromDate)
+                        .queryParam("toDate", toDate)
+                        .queryParam("pageNumber", pageNumber)
+                        .queryParam("pageSize", pageSize)
+                        .build());
+    }
+}
diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/service/UpdatedComplianceListService.java b/src/main/java/com/snp/batch/jobs/web/compliance/service/UpdatedComplianceListService.java
new file mode 100644
index 0000000..44960ab
--- /dev/null
+++ b/src/main/java/com/snp/batch/jobs/web/compliance/service/UpdatedComplianceListService.java
@@ -0,0 +1,36 @@
+package com.snp.batch.jobs.web.compliance.service;
+
+import com.snp.batch.jobs.web.compliance.dto.UpdatedComplianceListDto;
+import com.snp.batch.common.web.service.BaseBypassService;
+import java.util.List;
+import org.springframework.beans.factory.annotation.Qualifier;
+import org.springframework.core.ParameterizedTypeReference;
+import org.springframework.stereotype.Service;
+import org.springframework.web.reactive.function.client.WebClient;
+
+/**
+ * 기간 내 변경 Compliance 조회 bypass 서비스
+ * 외부 Maritime API에서 데이터를 실시간 조회하여 그대로 반환
+ */
+@Service
+public class UpdatedComplianceListService extends BaseBypassService<UpdatedComplianceListDto> {
+
+    public UpdatedComplianceListService(
+            @Qualifier("maritimeServiceApiWebClient") WebClient webClient) {
+        super(webClient, "/RiskAndCompliance/UpdatedComplianceList", "기간 내 변경 Compliance 조회",
+                new ParameterizedTypeReference<>() {},
+                new ParameterizedTypeReference<>() {});
+    }
+
+    /**
+     * 기간 내 변경 Compliance 조회 데이터를 조회합니다.
+     *
+     * @return 기간 내 변경 Compliance 조회
+     */
+    public List<UpdatedComplianceListDto> getUpdatedComplianceListData(String fromDate, String toDate) {
+        return fetchGetList(uri -> uri.path(getApiPath())
+                        .queryParam("fromDate", fromDate)
+                        .queryParam("toDate", toDate)
+                        .build());
+    }
+}
diff --git a/src/main/java/com/snp/batch/service/BypassCodeGenerator.java b/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
index bf9d5a6..c4619b4 100644
--- a/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
+++ b/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
@@ -99,6 +99,11 @@ public class BypassCodeGenerator {
         boolean needsLocalDateTime = fields.stream()
                 .anyMatch(f -> "LocalDateTime".equals(f.getFieldType()));
 
+        boolean needsList = fields.stream()
+                .anyMatch(f -> f.getFieldType() != null && f.getFieldType().startsWith("List"));
+        boolean needsMap = fields.stream()
+                .anyMatch(f -> f.getFieldType() != null && f.getFieldType().startsWith("Map"));
+
         StringBuilder imports = new StringBuilder();
         imports.append("import com.fasterxml.jackson.annotation.JsonProperty;\n");
         imports.append("import lombok.AllArgsConstructor;\n");
@@ -109,6 +114,12 @@ public class BypassCodeGenerator {
         if (needsLocalDateTime) {
             imports.append("import java.time.LocalDateTime;\n");
         }
+        if (needsList) {
+            imports.append("import java.util.List;\n");
+        }
+        if (needsMap) {
+            imports.append("import java.util.Map;\n");
+        }
 
         StringBuilder fieldLines = new StringBuilder();
         for (BypassApiField field : fields) {
diff --git a/src/main/java/com/snp/batch/service/JsonSchemaParser.java b/src/main/java/com/snp/batch/service/JsonSchemaParser.java
index 1fca930..57db339 100644
--- a/src/main/java/com/snp/batch/service/JsonSchemaParser.java
+++ b/src/main/java/com/snp/batch/service/JsonSchemaParser.java
@@ -32,6 +32,20 @@ public class JsonSchemaParser {
      * @return 필드 목록 (파싱 실패 시 빈 목록 반환)
      */
     public List<BypassFieldDto> parse(String jsonSample) {
+        return parse(jsonSample, null);
+    }
+
+    /**
+     * JSON 샘플 문자열에서 필드 목록을 추출합니다.
+     * targetField가 지정된 경우 해당 필드 내부를 파싱 대상으로 사용합니다.
+     * 배열이면 첫 번째 요소를 파싱합니다.
+     *
+     * @param jsonSample  JSON 샘플 문자열
+     * @param targetField 파싱할 대상 필드명 (null이면 루트 파싱)
+     *                    예: "data" → root.data[0] 내부를 파싱
+     * @return 필드 목록 (파싱 실패 시 빈 목록 반환)
+     */
+    public List<BypassFieldDto> parse(String jsonSample, String targetField) {
         List<BypassFieldDto> result = new ArrayList<>();
         try {
             JsonNode root = objectMapper.readTree(jsonSample);
@@ -43,13 +57,35 @@ public class JsonSchemaParser {
                 return result;
             }
 
+            // targetField가 지정된 경우 해당 필드 내부를 파싱 대상으로 사용
+            if (targetField != null && !targetField.isEmpty()) {
+                JsonNode nested = target.get(targetField);
+                if (nested != null) {
+                    if (nested.isArray() && nested.size() > 0) {
+                        target = nested.get(0);
+                    } else if (nested.isObject()) {
+                        target = nested;
+                    } else {
+                        log.warn("JSON 파싱: targetField='{}' 가 객체나 배열이 아닙니다.", targetField);
+                        return result;
+                    }
+                    if (!target.isObject()) {
+                        log.warn("JSON 파싱: targetField='{}' 내부에서 유효한 객체를 찾을 수 없습니다.", targetField);
+                        return result;
+                    }
+                } else {
+                    log.warn("JSON 파싱: targetField='{}' 를 찾을 수 없습니다.", targetField);
+                    return result;
+                }
+            }
+
             int sortOrder = 0;
             var fields = target.fields();
             while (fields.hasNext()) {
                 var entry = fields.next();
                 String originalKey = entry.getKey();
                 String fieldName = toCamelCase(originalKey);
-                String fieldType = inferType(entry.getValue());
+                String fieldType = inferType(entry.getValue(), fieldName);
 
                 // jsonProperty: fieldName과 원본 키가 다를 때만 설정
                 String jsonProperty = fieldName.equals(originalKey) ? null : originalKey;
@@ -82,9 +118,13 @@ public class JsonSchemaParser {
     }
 
     /**
-     * JsonNode에서 Java 타입 추론
+     * JsonNode에서 Java 타입 추론.
+     * 배열 내 첫 번째 요소가 ObjectNode인 경우 "{FieldName}Item" 타입으로 처리합니다.
+     *
+     * @param node      파싱할 노드
+     * @param fieldName 필드명 (배열 내 객체 타입명 생성에 사용)
      */
-    private String inferType(JsonNode node) {
+    private String inferType(JsonNode node, String fieldName) {
         if (node.isTextual()) {
             return "String";
         }
@@ -104,6 +144,10 @@ public class JsonSchemaParser {
             return "String";
         }
         if (node.isArray()) {
+            if (node.size() > 0 && node.get(0).isObject()) {
+                String itemTypeName = capitalize(fieldName) + "Item";
+                return "List<" + itemTypeName + ">";
+            }
             return "List<Object>";
         }
         if (node.isObject()) {
@@ -111,4 +155,11 @@ public class JsonSchemaParser {
         }
         return "String";
     }
+
+    private String capitalize(String s) {
+        if (s == null || s.isEmpty()) {
+            return s;
+        }
+        return Character.toUpperCase(s.charAt(0)) + s.substring(1);
+    }
 }
-- 
2.45.2


From 96c69365d3e2ee084c452f2b4f457184797973cf Mon Sep 17 00:00:00 2001
From: HYOJIN <hjkim4@gcsc.co.kr>
Date: Fri, 27 Mar 2026 09:46:40 +0900
Subject: [PATCH 12/19] =?UTF-8?q?fix:=20=EC=84=A4=EC=A0=95=20=EC=88=98?=
 =?UTF-8?q?=EC=A0=95=20=EC=8B=9C=20params/fields=20unique=20=EC=A0=9C?=
 =?UTF-8?q?=EC=95=BD=20=EC=9C=84=EB=B0=98=20=EC=88=98=EC=A0=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Hibernate가 INSERT를 DELETE보다 먼저 실행하는 문제 해결.
clear() 후 entityManager.flush()로 DELETE를 먼저 실행

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .../java/com/snp/batch/service/BypassConfigService.java  | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/src/main/java/com/snp/batch/service/BypassConfigService.java b/src/main/java/com/snp/batch/service/BypassConfigService.java
index ca42345..deed43b 100644
--- a/src/main/java/com/snp/batch/service/BypassConfigService.java
+++ b/src/main/java/com/snp/batch/service/BypassConfigService.java
@@ -8,6 +8,7 @@ import com.snp.batch.global.model.BypassApiConfig;
 import com.snp.batch.global.model.BypassApiField;
 import com.snp.batch.global.model.BypassApiParam;
 import com.snp.batch.global.repository.BypassApiConfigRepository;
+import jakarta.persistence.EntityManager;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.stereotype.Service;
@@ -25,6 +26,7 @@ import java.util.List;
 public class BypassConfigService {
 
     private final BypassApiConfigRepository configRepository;
+    private final EntityManager entityManager;
 
     /**
      * 설정 목록 조회
@@ -101,8 +103,11 @@ public class BypassConfigService {
         config.setResponseType(request.getResponseType());
         config.setDescription(request.getDescription());
 
-        // params 교체 (orphanRemoval로 기존 자동 삭제)
+        // params/fields 교체: clear → flush(DELETE 실행) → 새로 추가
         config.getParams().clear();
+        config.getFields().clear();
+        entityManager.flush();
+
         if (request.getParams() != null) {
             request.getParams().forEach(p -> {
                 BypassApiParam param = toParamEntity(p);
@@ -111,8 +116,6 @@ public class BypassConfigService {
             });
         }
 
-        // fields 교체
-        config.getFields().clear();
         if (request.getFields() != null) {
             request.getFields().forEach(f -> {
                 BypassApiField field = toFieldEntity(f);
-- 
2.45.2


From 82e7074b1c593cdcd81be2019434300ccbdd375b Mon Sep 17 00:00:00 2001
From: HYOJIN <hjkim4@gcsc.co.kr>
Date: Fri, 27 Mar 2026 10:40:20 +0900
Subject: [PATCH 13/19] =?UTF-8?q?refactor:=20BYPASS=20API=20=EC=A0=84?=
 =?UTF-8?q?=EB=A9=B4=20RAW=20=EB=AA=A8=EB=93=9C=20=EC=A0=84=ED=99=98=20(Js?=
 =?UTF-8?q?onNode=20=ED=8C=A8=EC=8A=A4=EC=8A=A4=EB=A3=A8)=20(#63)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- DTO 생성 제거: 모든 BYPASS API가 JsonNode로 응답 패스스루
- bypass_api_field 테이블 관련 코드 삭제 (Entity, Repository, DTO, JsonSchemaParser)
- 코드 생성기: Service만 생성 (DTO 없음), JsonNode 반환
- 프론트엔드: 3단계 → 2단계 폼 축소 (기본 정보 + 파라미터)
- BypassStepFields, responseType 관련 코드 전면 제거

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 frontend/src/api/bypassApi.ts                 |  24 --
 .../components/bypass/BypassConfigModal.tsx   |  25 +-
 .../src/components/bypass/BypassStepBasic.tsx |  26 --
 .../components/bypass/BypassStepFields.tsx    | 289 ------------------
 frontend/src/pages/BypassConfig.tsx           |   8 -
 .../controller/BypassConfigController.java    |  28 +-
 .../batch/global/dto/BypassConfigRequest.java |   6 -
 .../global/dto/BypassConfigResponse.java      |   6 -
 .../snp/batch/global/dto/BypassFieldDto.java  |  33 --
 .../batch/global/model/BypassApiConfig.java   |  15 -
 .../batch/global/model/BypassApiField.java    |  69 -----
 .../repository/BypassApiFieldRepository.java  |  25 --
 .../controller/ComplianceController.java      |  85 ------
 .../dto/ComplianceValuesMeaningDto.java       |  23 --
 .../compliance/dto/CompliancesByImosDto.java  | 122 --------
 .../dto/PagedUpdatedComplianceListDto.java    |  45 ---
 .../dto/UpdatedComplianceListDto.java         | 122 --------
 .../ComplianceValuesMeaningService.java       |  34 ---
 .../service/CompliancesByImosService.java     |  35 ---
 .../PagedUpdatedComplianceListService.java    |  38 ---
 .../service/UpdatedComplianceListService.java |  36 ---
 .../batch/service/BypassCodeGenerator.java    | 203 ++----------
 .../batch/service/BypassConfigService.java    |  62 +---
 .../snp/batch/service/JsonSchemaParser.java   | 165 ----------
 24 files changed, 36 insertions(+), 1488 deletions(-)
 delete mode 100644 frontend/src/components/bypass/BypassStepFields.tsx
 delete mode 100644 src/main/java/com/snp/batch/global/dto/BypassFieldDto.java
 delete mode 100644 src/main/java/com/snp/batch/global/model/BypassApiField.java
 delete mode 100644 src/main/java/com/snp/batch/global/repository/BypassApiFieldRepository.java
 delete mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/controller/ComplianceController.java
 delete mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/dto/ComplianceValuesMeaningDto.java
 delete mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/dto/CompliancesByImosDto.java
 delete mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/dto/PagedUpdatedComplianceListDto.java
 delete mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/dto/UpdatedComplianceListDto.java
 delete mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/service/ComplianceValuesMeaningService.java
 delete mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/service/CompliancesByImosService.java
 delete mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/service/PagedUpdatedComplianceListService.java
 delete mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/service/UpdatedComplianceListService.java
 delete mode 100644 src/main/java/com/snp/batch/service/JsonSchemaParser.java

diff --git a/frontend/src/api/bypassApi.ts b/frontend/src/api/bypassApi.ts
index a90532b..046258c 100644
--- a/frontend/src/api/bypassApi.ts
+++ b/frontend/src/api/bypassApi.ts
@@ -17,25 +17,14 @@ export interface BypassParamDto {
     sortOrder: number;
 }
 
-export interface BypassFieldDto {
-    id?: number;
-    fieldName: string;
-    jsonProperty: string | null;
-    fieldType: string;    // String, Integer, Long, Double, Boolean, LocalDateTime, List<Object>, Object
-    description: string;
-    sortOrder: number;
-}
-
 export interface BypassConfigRequest {
     domainName: string;
     displayName: string;
     webclientBean: string;
     externalPath: string;
     httpMethod: string;
-    responseType: string;
     description: string;
     params: BypassParamDto[];
-    fields: BypassFieldDto[];
 }
 
 export interface BypassConfigResponse {
@@ -46,20 +35,17 @@ export interface BypassConfigResponse {
     webclientBean: string;
     externalPath: string;
     httpMethod: string;
-    responseType: string;
     description: string;
     generated: boolean;
     generatedAt: string | null;
     createdAt: string;
     updatedAt: string;
     params: BypassParamDto[];
-    fields: BypassFieldDto[];
 }
 
 export interface CodeGenerationResult {
     controllerPath: string;
     servicePaths: string[];
-    dtoPaths: string[];
     message: string;
 }
 
@@ -117,16 +103,6 @@ export const bypassApi = {
         deleteJson<ApiResponse<void>>(`${BASE}/${id}`),
     generateCode: (id: number, force = false) =>
         postJson<ApiResponse<CodeGenerationResult>>(`${BASE}/${id}/generate?force=${force}`),
-    parseJson: async (jsonSample: string, targetField?: string): Promise<ApiResponse<BypassFieldDto[]>> => {
-        const params = targetField ? `?targetField=${encodeURIComponent(targetField)}` : '';
-        const res = await fetch(`${BASE}/parse-json${params}`, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: jsonSample, // 이미 JSON 문자열이므로 JSON.stringify 하지 않음
-        });
-        if (!res.ok) throw new Error(`API Error: ${res.status} ${res.statusText}`);
-        return res.json();
-    },
     getWebclientBeans: () =>
         fetchJson<ApiResponse<WebClientBeanInfo[]>>(`${BASE}/webclient-beans`),
 };
diff --git a/frontend/src/components/bypass/BypassConfigModal.tsx b/frontend/src/components/bypass/BypassConfigModal.tsx
index edec66b..6a3b854 100644
--- a/frontend/src/components/bypass/BypassConfigModal.tsx
+++ b/frontend/src/components/bypass/BypassConfigModal.tsx
@@ -3,12 +3,10 @@ import type {
     BypassConfigRequest,
     BypassConfigResponse,
     BypassParamDto,
-    BypassFieldDto,
     WebClientBeanInfo,
 } from '../../api/bypassApi';
 import BypassStepBasic from './BypassStepBasic';
 import BypassStepParams from './BypassStepParams';
-import BypassStepFields from './BypassStepFields';
 
 interface BypassConfigModalProps {
     open: boolean;
@@ -18,21 +16,19 @@ interface BypassConfigModalProps {
     onClose: () => void;
 }
 
-type StepNumber = 1 | 2 | 3;
+type StepNumber = 1 | 2;
 
 const STEP_LABELS: Record<StepNumber, string> = {
     1: '기본 정보',
     2: '파라미터',
-    3: 'DTO 필드',
 };
 
-const DEFAULT_FORM: Omit<BypassConfigRequest, 'params' | 'fields'> = {
+const DEFAULT_FORM: Omit<BypassConfigRequest, 'params'> = {
     domainName: '',
     displayName: '',
     webclientBean: '',
     externalPath: '',
     httpMethod: 'GET',
-    responseType: 'LIST',
     description: '',
 };
 
@@ -49,10 +45,8 @@ export default function BypassConfigModal({
     const [webclientBean, setWebclientBean] = useState('');
     const [externalPath, setExternalPath] = useState('');
     const [httpMethod, setHttpMethod] = useState('GET');
-    const [responseType, setResponseType] = useState('LIST');
     const [description, setDescription] = useState('');
     const [params, setParams] = useState<BypassParamDto[]>([]);
-    const [fields, setFields] = useState<BypassFieldDto[]>([]);
     const [saving, setSaving] = useState(false);
 
     useEffect(() => {
@@ -64,20 +58,16 @@ export default function BypassConfigModal({
             setWebclientBean(editConfig.webclientBean);
             setExternalPath(editConfig.externalPath);
             setHttpMethod(editConfig.httpMethod);
-            setResponseType(editConfig.responseType);
             setDescription(editConfig.description);
             setParams(editConfig.params);
-            setFields(editConfig.fields);
         } else {
             setDomainName(DEFAULT_FORM.domainName);
             setDisplayName(DEFAULT_FORM.displayName);
             setWebclientBean(DEFAULT_FORM.webclientBean);
             setExternalPath(DEFAULT_FORM.externalPath);
             setHttpMethod(DEFAULT_FORM.httpMethod);
-            setResponseType(DEFAULT_FORM.responseType);
             setDescription(DEFAULT_FORM.description);
             setParams([]);
-            setFields([]);
         }
     }, [open, editConfig]);
 
@@ -90,7 +80,6 @@ export default function BypassConfigModal({
             case 'webclientBean': setWebclientBean(value); break;
             case 'externalPath': setExternalPath(value); break;
             case 'httpMethod': setHttpMethod(value); break;
-            case 'responseType': setResponseType(value); break;
             case 'description': setDescription(value); break;
         }
     };
@@ -104,10 +93,8 @@ export default function BypassConfigModal({
                 webclientBean,
                 externalPath,
                 httpMethod,
-                responseType,
                 description,
                 params,
-                fields,
             });
             onClose();
         } finally {
@@ -115,7 +102,7 @@ export default function BypassConfigModal({
         }
     };
 
-    const steps: StepNumber[] = [1, 2, 3];
+    const steps: StepNumber[] = [1, 2];
 
     return (
         <div
@@ -175,7 +162,6 @@ export default function BypassConfigModal({
                             webclientBean={webclientBean}
                             externalPath={externalPath}
                             httpMethod={httpMethod}
-                            responseType={responseType}
                             description={description}
                             webclientBeans={webclientBeans}
                             isEdit={editConfig !== null}
@@ -185,9 +171,6 @@ export default function BypassConfigModal({
                     {step === 2 && (
                         <BypassStepParams params={params} onChange={setParams} />
                     )}
-                    {step === 3 && (
-                        <BypassStepFields fields={fields} onChange={setFields} />
-                    )}
                 </div>
 
                 {/* 하단 버튼 */}
@@ -213,7 +196,7 @@ export default function BypassConfigModal({
                                 취소
                             </button>
                         )}
-                        {step < 3 ? (
+                        {step < 2 ? (
                             <button
                                 type="button"
                                 onClick={() => setStep((s) => (s + 1) as StepNumber)}
diff --git a/frontend/src/components/bypass/BypassStepBasic.tsx b/frontend/src/components/bypass/BypassStepBasic.tsx
index 969450f..e5b3ea2 100644
--- a/frontend/src/components/bypass/BypassStepBasic.tsx
+++ b/frontend/src/components/bypass/BypassStepBasic.tsx
@@ -6,7 +6,6 @@ interface BypassStepBasicProps {
     webclientBean: string;
     externalPath: string;
     httpMethod: string;
-    responseType: string;
     description: string;
     webclientBeans: WebClientBeanInfo[];
     isEdit: boolean;
@@ -19,7 +18,6 @@ export default function BypassStepBasic({
     webclientBean,
     externalPath,
     httpMethod,
-    responseType,
     description,
     webclientBeans,
     isEdit,
@@ -125,30 +123,6 @@ export default function BypassStepBasic({
                     </div>
                 </div>
 
-                {/* 응답 타입 */}
-                <div>
-                    <label className="block text-sm font-medium text-wing-text mb-1">
-                        응답 타입 <span className="text-red-500">*</span>
-                    </label>
-                    <div className="flex gap-2">
-                        {['LIST', 'OBJECT'].map((type) => (
-                            <button
-                                key={type}
-                                type="button"
-                                onClick={() => onChange('responseType', type)}
-                                className={[
-                                    'flex-1 py-2 text-sm font-medium rounded-lg border transition-colors',
-                                    responseType === type
-                                        ? 'bg-wing-accent text-white border-wing-accent'
-                                        : 'bg-wing-card text-wing-muted border-wing-border hover:bg-wing-hover',
-                                ].join(' ')}
-                            >
-                                {type}
-                            </button>
-                        ))}
-                    </div>
-                </div>
-
                 {/* 설명 */}
                 <div className="md:col-span-2">
                     <label className="block text-sm font-medium text-wing-text mb-1">
diff --git a/frontend/src/components/bypass/BypassStepFields.tsx b/frontend/src/components/bypass/BypassStepFields.tsx
deleted file mode 100644
index 6027b18..0000000
--- a/frontend/src/components/bypass/BypassStepFields.tsx
+++ /dev/null
@@ -1,289 +0,0 @@
-import { useState } from 'react';
-import type { BypassFieldDto } from '../../api/bypassApi';
-import { bypassApi } from '../../api/bypassApi';
-
-interface BypassStepFieldsProps {
-    fields: BypassFieldDto[];
-    onChange: (fields: BypassFieldDto[]) => void;
-}
-
-type ActiveTab = 'manual' | 'json';
-
-const FIELD_TYPES = ['String', 'Integer', 'Long', 'Double', 'Boolean', 'LocalDateTime', 'List<Object>', 'Object'];
-
-function createEmptyField(sortOrder: number): BypassFieldDto {
-    return {
-        fieldName: '',
-        jsonProperty: null,
-        fieldType: 'String',
-        description: '',
-        sortOrder,
-    };
-}
-
-export default function BypassStepFields({ fields, onChange }: BypassStepFieldsProps) {
-    const [activeTab, setActiveTab] = useState<ActiveTab>('manual');
-    const [jsonSample, setJsonSample] = useState('');
-    const [parsing, setParsing] = useState(false);
-    const [parseError, setParseError] = useState<string | null>(null);
-    const [parseMode, setParseMode] = useState<'root' | 'field'>('root');
-    const [targetField, setTargetField] = useState('data');
-
-    const handleAdd = () => {
-        onChange([...fields, createEmptyField(fields.length)]);
-    };
-
-    const handleDelete = (index: number) => {
-        const updated = fields
-            .filter((_, i) => i !== index)
-            .map((f, i) => ({ ...f, sortOrder: i }));
-        onChange(updated);
-    };
-
-    const handleChange = (index: number, field: keyof BypassFieldDto, value: string | null) => {
-        const updated = fields.map((f, i) =>
-            i === index ? { ...f, [field]: value } : f,
-        );
-        onChange(updated);
-    };
-
-    const handleParseJson = async () => {
-        if (!jsonSample.trim()) {
-            setParseError('JSON 샘플을 입력하세요.');
-            return;
-        }
-        setParseError(null);
-        setParsing(true);
-        try {
-            const tf = parseMode === 'field' ? targetField : undefined;
-            const result = await bypassApi.parseJson(jsonSample.trim(), tf);
-            if (result.success && result.data) {
-                onChange(result.data);
-                setActiveTab('manual');
-            } else {
-                setParseError(result.message ?? 'JSON 파싱에 실패했습니다.');
-            }
-        } catch (err) {
-            setParseError(err instanceof Error ? err.message : 'JSON 파싱 중 오류가 발생했습니다.');
-        } finally {
-            setParsing(false);
-        }
-    };
-
-    return (
-        <div className="space-y-4">
-            <p className="text-sm text-wing-muted">
-                응답 DTO에 포함할 필드를 정의하세요. JSON 샘플을 붙여넣어 자동 파싱할 수도 있습니다.
-            </p>
-
-            {/* 탭 */}
-            <div className="flex gap-1 border-b border-wing-border">
-                <button
-                    type="button"
-                    onClick={() => setActiveTab('manual')}
-                    className={[
-                        'px-4 py-2 text-sm font-medium border-b-2 -mb-px transition-colors',
-                        activeTab === 'manual'
-                            ? 'border-wing-accent text-wing-accent'
-                            : 'border-transparent text-wing-muted hover:text-wing-text',
-                    ].join(' ')}
-                >
-                    직접 입력
-                </button>
-                <button
-                    type="button"
-                    onClick={() => setActiveTab('json')}
-                    className={[
-                        'px-4 py-2 text-sm font-medium border-b-2 -mb-px transition-colors',
-                        activeTab === 'json'
-                            ? 'border-wing-accent text-wing-accent'
-                            : 'border-transparent text-wing-muted hover:text-wing-text',
-                    ].join(' ')}
-                >
-                    JSON 샘플
-                </button>
-            </div>
-
-            {/* 직접 입력 탭 */}
-            {activeTab === 'manual' && (
-                <div className="space-y-4">
-                    {fields.length === 0 ? (
-                        <div className="py-10 text-center text-sm text-wing-muted border border-dashed border-wing-border rounded-lg bg-wing-card">
-                            DTO 필드가 없습니다. 추가 버튼을 클릭하거나 JSON 샘플로 자동 파싱하세요.
-                        </div>
-                    ) : (
-                        <div className="overflow-x-auto">
-                            <div className="mb-2 flex items-center justify-between">
-                                <span className="text-xs text-wing-muted">
-                                    총 <span className="font-semibold text-wing-text">{fields.length}</span>개 필드
-                                </span>
-                            </div>
-                            <table className="w-full text-sm">
-                                <thead>
-                                    <tr className="border-b border-wing-border">
-                                        <th className="pb-2 text-left font-medium text-wing-muted pr-3 w-10">#</th>
-                                        <th className="pb-2 text-left font-medium text-wing-muted pr-3 min-w-[130px]">필드명</th>
-                                        <th className="pb-2 text-left font-medium text-wing-muted pr-3 min-w-[130px]">JSON Property</th>
-                                        <th className="pb-2 text-left font-medium text-wing-muted pr-3 min-w-[150px]">타입</th>
-                                        <th className="pb-2 text-left font-medium text-wing-muted pr-3">설명</th>
-                                        <th className="pb-2 w-10"></th>
-                                    </tr>
-                                </thead>
-                                <tbody className="divide-y divide-wing-border">
-                                    {fields.map((field, index) => (
-                                        <tr key={index} className="group">
-                                            <td className="py-2 pr-3">
-                                                <span className="text-xs font-medium text-wing-muted tabular-nums">
-                                                    #{index + 1}
-                                                </span>
-                                            </td>
-                                            <td className="py-2 pr-3">
-                                                <input
-                                                    type="text"
-                                                    value={field.fieldName}
-                                                    onChange={(e) => handleChange(index, 'fieldName', e.target.value)}
-                                                    placeholder="fieldName"
-                                                    className="w-full px-2 py-1.5 text-sm rounded border border-wing-border bg-wing-surface text-wing-text placeholder:text-wing-muted focus:outline-none focus:ring-1 focus:ring-wing-accent/50"
-                                                />
-                                            </td>
-                                            <td className="py-2 pr-3">
-                                                <input
-                                                    type="text"
-                                                    value={field.jsonProperty ?? ''}
-                                                    onChange={(e) => handleChange(index, 'jsonProperty', e.target.value || null)}
-                                                    placeholder="원본과 같으면 비워두세요"
-                                                    className="w-full px-2 py-1.5 text-sm rounded border border-wing-border bg-wing-surface text-wing-text placeholder:text-wing-muted focus:outline-none focus:ring-1 focus:ring-wing-accent/50"
-                                                />
-                                            </td>
-                                            <td className="py-2 pr-3">
-                                                <select
-                                                    value={field.fieldType}
-                                                    onChange={(e) => handleChange(index, 'fieldType', e.target.value)}
-                                                    className="w-full px-2 py-1.5 text-sm rounded border border-wing-border bg-wing-surface text-wing-text focus:outline-none focus:ring-1 focus:ring-wing-accent/50"
-                                                >
-                                                    {FIELD_TYPES.map((t) => (
-                                                        <option key={t} value={t}>{t}</option>
-                                                    ))}
-                                                </select>
-                                            </td>
-                                            <td className="py-2 pr-3">
-                                                <input
-                                                    type="text"
-                                                    value={field.description}
-                                                    onChange={(e) => handleChange(index, 'description', e.target.value)}
-                                                    placeholder="필드 설명"
-                                                    className="w-full px-2 py-1.5 text-sm rounded border border-wing-border bg-wing-surface text-wing-text placeholder:text-wing-muted focus:outline-none focus:ring-1 focus:ring-wing-accent/50"
-                                                />
-                                            </td>
-                                            <td className="py-2">
-                                                <button
-                                                    type="button"
-                                                    onClick={() => handleDelete(index)}
-                                                    className="p-1.5 text-wing-muted hover:text-red-500 hover:bg-red-50 rounded transition-colors"
-                                                    title="삭제"
-                                                >
-                                                    <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-                                                        <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M6 18L18 6M6 6l12 12" />
-                                                    </svg>
-                                                </button>
-                                            </td>
-                                        </tr>
-                                    ))}
-                                </tbody>
-                            </table>
-                        </div>
-                    )}
-
-                    <button
-                        type="button"
-                        onClick={handleAdd}
-                        className="flex items-center gap-1.5 px-3 py-2 text-sm font-medium text-wing-accent border border-wing-accent/30 rounded-lg hover:bg-wing-accent/10 transition-colors"
-                    >
-                        <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-                            <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M12 4v16m8-8H4" />
-                        </svg>
-                        필드 추가
-                    </button>
-                </div>
-            )}
-
-            {/* JSON 샘플 탭 */}
-            {activeTab === 'json' && (
-                <div className="space-y-3">
-                    <p className="text-xs text-wing-muted">
-                        응답 JSON 샘플을 붙여넣으면 필드 구조를 자동으로 파싱합니다. 파싱 후 직접 입력 탭에서 수정할 수 있습니다.
-                    </p>
-                    <textarea
-                        value={jsonSample}
-                        onChange={(e) => {
-                            setJsonSample(e.target.value);
-                            setParseError(null);
-                        }}
-                        rows={10}
-                        placeholder={'{\n  "riskScore": 85,\n  "imoNumber": "1234567",\n  "vesselName": "EXAMPLE SHIP"\n}'}
-                        className="w-full px-3 py-2 text-sm font-mono rounded-lg border border-wing-border bg-wing-card text-wing-text placeholder:text-wing-muted focus:outline-none focus:ring-2 focus:ring-wing-accent/50 resize-none"
-                    />
-
-                    {/* 파싱 옵션 */}
-                    <div className="mt-3 space-y-2">
-                        <label className="text-sm font-medium text-wing-text">파싱 대상</label>
-                        <div className="flex items-center gap-4">
-                            <label className="flex items-center gap-2 text-sm text-wing-text cursor-pointer">
-                                <input
-                                    type="radio"
-                                    name="parseMode"
-                                    checked={parseMode === 'root'}
-                                    onChange={() => setParseMode('root')}
-                                    className="accent-wing-accent"
-                                />
-                                전체 JSON
-                            </label>
-                            <label className="flex items-center gap-2 text-sm text-wing-text cursor-pointer">
-                                <input
-                                    type="radio"
-                                    name="parseMode"
-                                    checked={parseMode === 'field'}
-                                    onChange={() => setParseMode('field')}
-                                    className="accent-wing-accent"
-                                />
-                                특정 필드 내부
-                            </label>
-                        </div>
-                        {parseMode === 'field' && (
-                            <div className="flex items-center gap-2">
-                                <input
-                                    type="text"
-                                    value={targetField}
-                                    onChange={(e) => setTargetField(e.target.value)}
-                                    placeholder="필드명 (예: data, results, items)"
-                                    className="px-3 py-1.5 text-sm rounded-lg border border-wing-border bg-wing-surface text-wing-text placeholder:text-wing-muted focus:outline-none focus:ring-1 focus:ring-wing-accent/50"
-                                />
-                                <span className="text-xs text-wing-muted">
-                                    해당 필드가 배열이면 첫 번째 요소를, 객체면 그 내부를 파싱합니다.
-                                </span>
-                            </div>
-                        )}
-                    </div>
-
-                    {parseError && (
-                        <p className="text-sm text-red-500">{parseError}</p>
-                    )}
-                    <button
-                        type="button"
-                        onClick={handleParseJson}
-                        disabled={parsing}
-                        className="flex items-center gap-2 px-4 py-2 text-sm font-medium text-white bg-wing-accent hover:bg-wing-accent/80 disabled:opacity-50 disabled:cursor-not-allowed rounded-lg transition-colors"
-                    >
-                        {parsing && (
-                            <svg className="w-4 h-4 animate-spin" fill="none" viewBox="0 0 24 24">
-                                <circle className="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" strokeWidth="4" />
-                                <path className="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8v8H4z" />
-                            </svg>
-                        )}
-                        {parsing ? '파싱 중...' : '파싱'}
-                    </button>
-                </div>
-            )}
-        </div>
-    );
-}
diff --git a/frontend/src/pages/BypassConfig.tsx b/frontend/src/pages/BypassConfig.tsx
index ae9186a..b0ddc60 100644
--- a/frontend/src/pages/BypassConfig.tsx
+++ b/frontend/src/pages/BypassConfig.tsx
@@ -475,14 +475,6 @@ export default function BypassConfig() {
                                     <span className="font-mono text-wing-muted break-all">{path}</span>
                                 </div>
                             ))}
-                            {generationResult.dtoPaths.map((path, idx) => (
-                                <div key={`dto-${idx}`} className="flex gap-2 text-xs">
-                                    <span className="w-20 font-medium text-wing-accent shrink-0">
-                                        DTO {generationResult.dtoPaths.length > 1 ? idx + 1 : ''}
-                                    </span>
-                                    <span className="font-mono text-wing-muted break-all">{path}</span>
-                                </div>
-                            ))}
                         </div>
                         <div className="flex items-start gap-2 bg-amber-50 text-amber-700 rounded-lg p-3 text-xs">
                             <span className="shrink-0">&#9888;</span>
diff --git a/src/main/java/com/snp/batch/global/controller/BypassConfigController.java b/src/main/java/com/snp/batch/global/controller/BypassConfigController.java
index 4b56b65..28f648e 100644
--- a/src/main/java/com/snp/batch/global/controller/BypassConfigController.java
+++ b/src/main/java/com/snp/batch/global/controller/BypassConfigController.java
@@ -3,13 +3,11 @@ package com.snp.batch.global.controller;
 import com.snp.batch.common.web.ApiResponse;
 import com.snp.batch.global.dto.BypassConfigRequest;
 import com.snp.batch.global.dto.BypassConfigResponse;
-import com.snp.batch.global.dto.BypassFieldDto;
 import com.snp.batch.global.dto.CodeGenerationResult;
 import com.snp.batch.global.model.BypassApiConfig;
 import com.snp.batch.global.repository.BypassApiConfigRepository;
 import com.snp.batch.service.BypassCodeGenerator;
 import com.snp.batch.service.BypassConfigService;
-import com.snp.batch.service.JsonSchemaParser;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.tags.Tag;
 import lombok.RequiredArgsConstructor;
@@ -40,7 +38,6 @@ public class BypassConfigController {
 
     private final BypassConfigService bypassConfigService;
     private final BypassCodeGenerator bypassCodeGenerator;
-    private final JsonSchemaParser jsonSchemaParser;
     private final BypassApiConfigRepository configRepository;
 
     @Operation(summary = "설정 목록 조회")
@@ -79,7 +76,7 @@ public class BypassConfigController {
 
     @Operation(
             summary = "코드 생성",
-            description = "등록된 설정의 도메인 전체를 기반으로 Controller, Service, DTO Java 소스 코드를 생성합니다. 같은 도메인의 모든 설정을 하나의 Controller로 합칩니다."
+            description = "등록된 설정의 도메인 전체를 기반으로 Controller, Service 소스 코드를 생성합니다. 같은 도메인의 모든 설정을 하나의 Controller로 합칩니다."
     )
     @PostMapping("/{id}/generate")
     public ResponseEntity<ApiResponse<CodeGenerationResult>> generateCode(
@@ -89,12 +86,10 @@ public class BypassConfigController {
             BypassApiConfig config = configRepository.findById(id)
                     .orElseThrow(() -> new IllegalArgumentException("설정을 찾을 수 없습니다: " + id));
 
-            // 같은 도메인의 모든 설정을 조회하여 함께 생성
             List<BypassApiConfig> domainConfigs = configRepository.findByDomainNameOrderById(config.getDomainName());
 
             CodeGenerationResult result = bypassCodeGenerator.generate(domainConfigs, force);
 
-            // 같은 도메인의 모든 설정을 generated로 마킹
             domainConfigs.forEach(c -> bypassConfigService.markAsGenerated(c.getId()));
 
             return ResponseEntity.ok(ApiResponse.success(result));
@@ -106,26 +101,7 @@ public class BypassConfigController {
         }
     }
 
-    @Operation(
-            summary = "JSON 샘플 파싱",
-            description = "JSON 샘플에서 DTO 필드 목록을 추출합니다. targetField를 지정하면 해당 필드 내부를 파싱합니다. 예: targetField=data → root.data[0] 내부 필드 추출."
-    )
-    @PostMapping("/parse-json")
-    public ResponseEntity<ApiResponse<List<BypassFieldDto>>> parseJson(
-            @RequestBody String jsonSample,
-            @RequestParam(required = false) String targetField) {
-        try {
-            List<BypassFieldDto> fields = jsonSchemaParser.parse(jsonSample, targetField);
-            return ResponseEntity.ok(ApiResponse.success(fields));
-        } catch (Exception e) {
-            return ResponseEntity.badRequest().body(ApiResponse.error("JSON 파싱 실패: " + e.getMessage()));
-        }
-    }
-
-    @Operation(
-            summary = "WebClient 빈 목록",
-            description = "사용 가능한 WebClient 빈 이름 목록을 반환합니다."
-    )
+    @Operation(summary = "WebClient 빈 목록", description = "사용 가능한 WebClient 빈 이름 목록을 반환합니다.")
     @GetMapping("/webclient-beans")
     public ResponseEntity<ApiResponse<List<Map<String, String>>>> getWebclientBeans() {
         List<Map<String, String>> beans = List.of(
diff --git a/src/main/java/com/snp/batch/global/dto/BypassConfigRequest.java b/src/main/java/com/snp/batch/global/dto/BypassConfigRequest.java
index 0e4f50d..d008ecb 100644
--- a/src/main/java/com/snp/batch/global/dto/BypassConfigRequest.java
+++ b/src/main/java/com/snp/batch/global/dto/BypassConfigRequest.java
@@ -31,15 +31,9 @@ public class BypassConfigRequest {
     /** HTTP 메서드 */
     private String httpMethod;
 
-    /** 응답 타입 */
-    private String responseType;
-
     /** 설명 */
     private String description;
 
     /** 파라미터 목록 */
     private List<BypassParamDto> params;
-
-    /** 응답 필드 목록 */
-    private List<BypassFieldDto> fields;
 }
diff --git a/src/main/java/com/snp/batch/global/dto/BypassConfigResponse.java b/src/main/java/com/snp/batch/global/dto/BypassConfigResponse.java
index 886af93..a587260 100644
--- a/src/main/java/com/snp/batch/global/dto/BypassConfigResponse.java
+++ b/src/main/java/com/snp/batch/global/dto/BypassConfigResponse.java
@@ -37,9 +37,6 @@ public class BypassConfigResponse {
     /** HTTP 메서드 */
     private String httpMethod;
 
-    /** 응답 타입 */
-    private String responseType;
-
     /** 설명 */
     private String description;
 
@@ -57,7 +54,4 @@ public class BypassConfigResponse {
 
     /** 파라미터 목록 */
     private List<BypassParamDto> params;
-
-    /** 응답 필드 목록 */
-    private List<BypassFieldDto> fields;
 }
diff --git a/src/main/java/com/snp/batch/global/dto/BypassFieldDto.java b/src/main/java/com/snp/batch/global/dto/BypassFieldDto.java
deleted file mode 100644
index 241fec9..0000000
--- a/src/main/java/com/snp/batch/global/dto/BypassFieldDto.java
+++ /dev/null
@@ -1,33 +0,0 @@
-package com.snp.batch.global.dto;
-
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Getter;
-import lombok.NoArgsConstructor;
-
-/**
- * BYPASS API 응답 필드 정보 DTO
- */
-@Getter
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class BypassFieldDto {
-
-    private Long id;
-
-    /** 필드 이름 (Java 클래스 필드명) */
-    private String fieldName;
-
-    /** JSON 프로퍼티명 (null이면 fieldName 사용) */
-    private String jsonProperty;
-
-    /** 필드 타입 (String, Integer, Long, Double, Boolean, LocalDateTime) */
-    private String fieldType;
-
-    /** 필드 설명 */
-    private String description;
-
-    /** 정렬 순서 */
-    private Integer sortOrder;
-}
diff --git a/src/main/java/com/snp/batch/global/model/BypassApiConfig.java b/src/main/java/com/snp/batch/global/model/BypassApiConfig.java
index 89d62fe..1c5b64d 100644
--- a/src/main/java/com/snp/batch/global/model/BypassApiConfig.java
+++ b/src/main/java/com/snp/batch/global/model/BypassApiConfig.java
@@ -76,14 +76,6 @@ public class BypassApiConfig {
     @Builder.Default
     private String httpMethod = "GET";
 
-    /**
-     * 응답 타입
-     * 예: "LIST", "SINGLE"
-     */
-    @Column(name = "response_type", nullable = false, length = 20)
-    @Builder.Default
-    private String responseType = "LIST";
-
     /**
      * 설명
      */
@@ -122,13 +114,6 @@ public class BypassApiConfig {
     @Builder.Default
     private List<BypassApiParam> params = new ArrayList<>();
 
-    /**
-     * API 응답 필드 목록
-     */
-    @OneToMany(mappedBy = "config", cascade = CascadeType.ALL, orphanRemoval = true)
-    @Builder.Default
-    private List<BypassApiField> fields = new ArrayList<>();
-
     /**
      * 엔티티 저장 전 자동 호출 (INSERT 시)
      * endpointName이 null이면 externalPath에서 자동 추출 (마이그레이션 대응)
diff --git a/src/main/java/com/snp/batch/global/model/BypassApiField.java b/src/main/java/com/snp/batch/global/model/BypassApiField.java
deleted file mode 100644
index 7e06007..0000000
--- a/src/main/java/com/snp/batch/global/model/BypassApiField.java
+++ /dev/null
@@ -1,69 +0,0 @@
-package com.snp.batch.global.model;
-
-import com.fasterxml.jackson.annotation.JsonIgnore;
-import jakarta.persistence.*;
-import lombok.*;
-
-/**
- * BYPASS API 응답 필드 정보를 저장하는 엔티티
- * BypassApiConfig에 종속되며, 외부 API 응답에서 추출할 필드 메타데이터를 정의
- */
-@Entity
-@Table(
-    name = "bypass_api_field",
-    uniqueConstraints = @UniqueConstraint(columnNames = {"config_id", "field_name"})
-)
-@Getter
-@Setter
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class BypassApiField {
-
-    @Id
-    @GeneratedValue(strategy = GenerationType.IDENTITY)
-    private Long id;
-
-    /**
-     * 연관된 BYPASS API 설정
-     */
-    @JsonIgnore
-    @ManyToOne(fetch = FetchType.LAZY)
-    @JoinColumn(name = "config_id", nullable = false)
-    private BypassApiConfig config;
-
-    /**
-     * 필드 이름 (Java 클래스 필드명)
-     * 예: "imoNumber", "shipName", "vesselType"
-     */
-    @Column(name = "field_name", nullable = false, length = 100)
-    private String fieldName;
-
-    /**
-     * JSON 프로퍼티명 (null이면 fieldName 사용)
-     * 예: "imo_number", "ship_name"
-     */
-    @Column(name = "json_property", length = 100)
-    private String jsonProperty;
-
-    /**
-     * 필드 타입
-     * 예: "String", "Integer", "Long", "Double", "Boolean", "LocalDateTime"
-     */
-    @Column(name = "field_type", nullable = false, length = 50)
-    @Builder.Default
-    private String fieldType = "String";
-
-    /**
-     * 필드 설명
-     */
-    @Column(name = "description", length = 500)
-    private String description;
-
-    /**
-     * 정렬 순서
-     */
-    @Column(name = "sort_order", nullable = false)
-    @Builder.Default
-    private Integer sortOrder = 0;
-}
diff --git a/src/main/java/com/snp/batch/global/repository/BypassApiFieldRepository.java b/src/main/java/com/snp/batch/global/repository/BypassApiFieldRepository.java
deleted file mode 100644
index 756629f..0000000
--- a/src/main/java/com/snp/batch/global/repository/BypassApiFieldRepository.java
+++ /dev/null
@@ -1,25 +0,0 @@
-package com.snp.batch.global.repository;
-
-import com.snp.batch.global.model.BypassApiField;
-import org.springframework.data.jpa.repository.JpaRepository;
-import org.springframework.stereotype.Repository;
-
-import java.util.List;
-
-/**
- * BypassApiField Repository
- * JPA Repository 방식으로 자동 구현
- */
-@Repository
-public interface BypassApiFieldRepository extends JpaRepository<BypassApiField, Long> {
-
-    /**
-     * 설정 ID로 필드 목록 조회 (정렬 순서 기준 오름차순)
-     */
-    List<BypassApiField> findByConfigIdOrderBySortOrder(Long configId);
-
-    /**
-     * 설정 ID로 필드 전체 삭제
-     */
-    void deleteByConfigId(Long configId);
-}
diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/controller/ComplianceController.java b/src/main/java/com/snp/batch/jobs/web/compliance/controller/ComplianceController.java
deleted file mode 100644
index 6668cb9..0000000
--- a/src/main/java/com/snp/batch/jobs/web/compliance/controller/ComplianceController.java
+++ /dev/null
@@ -1,85 +0,0 @@
-package com.snp.batch.jobs.web.compliance.controller;
-
-import com.snp.batch.common.web.ApiResponse;
-import com.snp.batch.common.web.controller.BaseBypassController;
-import io.swagger.v3.oas.annotations.Operation;
-import io.swagger.v3.oas.annotations.Parameter;
-import io.swagger.v3.oas.annotations.tags.Tag;
-import lombok.RequiredArgsConstructor;
-import org.springframework.http.ResponseEntity;
-import org.springframework.web.bind.annotation.RequestMapping;
-import org.springframework.web.bind.annotation.RestController;
-import java.util.List;
-import org.springframework.web.bind.annotation.GetMapping;
-import org.springframework.web.bind.annotation.RequestParam;
-import com.snp.batch.jobs.web.compliance.dto.CompliancesByImosDto;
-import com.snp.batch.jobs.web.compliance.service.CompliancesByImosService;
-import com.snp.batch.jobs.web.compliance.dto.UpdatedComplianceListDto;
-import com.snp.batch.jobs.web.compliance.service.UpdatedComplianceListService;
-import com.snp.batch.jobs.web.compliance.dto.ComplianceValuesMeaningDto;
-import com.snp.batch.jobs.web.compliance.service.ComplianceValuesMeaningService;
-import com.snp.batch.jobs.web.compliance.dto.PagedUpdatedComplianceListDto;
-import com.snp.batch.jobs.web.compliance.service.PagedUpdatedComplianceListService;
-
-/**
- * Compliance bypass API
- * S&P Maritime API에서 데이터를 실시간 조회하여 그대로 반환
- */
-@RestController
-@RequestMapping("/api/compliance")
-@RequiredArgsConstructor
-@Tag(name = "Compliance", description = "[Service API] Compliance bypass API")
-public class ComplianceController extends BaseBypassController {
-
-    private final CompliancesByImosService compliancesByImosService;
-    private final UpdatedComplianceListService updatedComplianceListService;
-    private final ComplianceValuesMeaningService complianceValuesMeaningService;
-    private final PagedUpdatedComplianceListService pagedUpdatedComplianceListService;
-
-    @Operation(
-            summary = "IMO 기반 Compliance 조회 조회",
-            description = "S&P API에서 IMO 기반 Compliance 조회 데이터를 요청하고 응답을 그대로 반환합니다."
-    )
-    @GetMapping("/CompliancesByImos")
-    public ResponseEntity<ApiResponse<List<CompliancesByImosDto>>> getCompliancesByImosData(@Parameter(description = "Comma separated IMOs up to a total of 100", example = "9876543")
-                @RequestParam(required = true) String imos) {
-        return execute(() -> compliancesByImosService.getCompliancesByImosData(imos));
-    }
-
-    @Operation(
-            summary = "기간 내 변경 Compliance 조회 조회",
-            description = "S&P API에서 기간 내 변경 Compliance 조회 데이터를 요청하고 응답을 그대로 반환합니다."
-    )
-    @GetMapping("/UpdatedComplianceList")
-    public ResponseEntity<ApiResponse<List<UpdatedComplianceListDto>>> getUpdatedComplianceListData(@Parameter(description = "Time/seconds are optional", example = "9876543")
-                @RequestParam(required = true) String fromDate,
-            @Parameter(description = "Time/seconds are optional. If unspecified, the current UTC date and time is used", example = "9876543")
-                @RequestParam(required = true) String toDate) {
-        return execute(() -> updatedComplianceListService.getUpdatedComplianceListData(fromDate, toDate));
-    }
-
-    @Operation(
-            summary = "모든 Compliance 지표 조회 조회",
-            description = "S&P API에서 모든 Compliance 지표 조회 데이터를 요청하고 응답을 그대로 반환합니다."
-    )
-    @GetMapping("/ComplianceValuesMeaning")
-    public ResponseEntity<ApiResponse<List<ComplianceValuesMeaningDto>>> getComplianceValuesMeaningData() {
-        return execute(() -> complianceValuesMeaningService.getComplianceValuesMeaningData());
-    }
-
-    @Operation(
-            summary = "PagedUpdatedComplianceList 조회",
-            description = "S&P API에서 PagedUpdatedComplianceList 데이터를 요청하고 응답을 그대로 반환합니다."
-    )
-    @GetMapping("/PagedUpdatedComplianceList")
-    public ResponseEntity<ApiResponse<List<PagedUpdatedComplianceListDto>>> getPagedUpdatedComplianceListData(@Parameter(description = "Time/seconds are optional", example = "9876543")
-                @RequestParam(required = true) String fromDate,
-            @Parameter(description = "Time/seconds are optional. If unspecified, the current UTC date and time is used", example = "9876543")
-                @RequestParam(required = true) String toDate,
-            @Parameter(description = "Page number to display.", example = "9876543")
-                @RequestParam(required = true) String pageNumber,
-            @Parameter(description = "How many elements will be on the single page. Maximum allowed is 1000.", example = "9876543")
-                @RequestParam(required = true) String pageSize) {
-        return execute(() -> pagedUpdatedComplianceListService.getPagedUpdatedComplianceListData(fromDate, toDate, pageNumber, pageSize));
-    }
-}
diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/dto/ComplianceValuesMeaningDto.java b/src/main/java/com/snp/batch/jobs/web/compliance/dto/ComplianceValuesMeaningDto.java
deleted file mode 100644
index 2df4695..0000000
--- a/src/main/java/com/snp/batch/jobs/web/compliance/dto/ComplianceValuesMeaningDto.java
+++ /dev/null
@@ -1,23 +0,0 @@
-package com.snp.batch.jobs.web.compliance.dto;
-
-import com.fasterxml.jackson.annotation.JsonProperty;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Getter;
-import lombok.NoArgsConstructor;
-import lombok.Setter;
-
-@Getter
-@Setter
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class ComplianceValuesMeaningDto {
-
-    @JsonProperty("complianceValue")
-    private Integer complianceValue;
-
-    @JsonProperty("meaning")
-    private String meaning;
-
-}
diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/dto/CompliancesByImosDto.java b/src/main/java/com/snp/batch/jobs/web/compliance/dto/CompliancesByImosDto.java
deleted file mode 100644
index d250ac7..0000000
--- a/src/main/java/com/snp/batch/jobs/web/compliance/dto/CompliancesByImosDto.java
+++ /dev/null
@@ -1,122 +0,0 @@
-package com.snp.batch.jobs.web.compliance.dto;
-
-import com.fasterxml.jackson.annotation.JsonProperty;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Getter;
-import lombok.NoArgsConstructor;
-import lombok.Setter;
-
-@Getter
-@Setter
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class CompliancesByImosDto {
-
-    @JsonProperty("lrimoShipNo")
-    private String lrimoShipNo;
-
-    @JsonProperty("dateAmended")
-    private String dateAmended;
-
-    @JsonProperty("legalOverall")
-    private Integer legalOverall;
-
-    @JsonProperty("shipBESSanctionList")
-    private Integer shipBESSanctionList;
-
-    @JsonProperty("shipDarkActivityIndicator")
-    private Integer shipDarkActivityIndicator;
-
-    @JsonProperty("shipDetailsNoLongerMaintained")
-    private Integer shipDetailsNoLongerMaintained;
-
-    @JsonProperty("shipEUSanctionList")
-    private Integer shipEUSanctionList;
-
-    @JsonProperty("shipFlagDisputed")
-    private Integer shipFlagDisputed;
-
-    @JsonProperty("shipFlagSanctionedCountry")
-    private Integer shipFlagSanctionedCountry;
-
-    @JsonProperty("shipHistoricalFlagSanctionedCountry")
-    private Integer shipHistoricalFlagSanctionedCountry;
-
-    @JsonProperty("shipOFACNonSDNSanctionList")
-    private Integer shipOFACNonSDNSanctionList;
-
-    @JsonProperty("shipOFACSanctionList")
-    private Integer shipOFACSanctionList;
-
-    @JsonProperty("shipOFACAdvisoryList")
-    private Integer shipOFACAdvisoryList;
-
-    @JsonProperty("shipOwnerOFACSSIList")
-    private Integer shipOwnerOFACSSIList;
-
-    @JsonProperty("shipOwnerAustralianSanctionList")
-    private Integer shipOwnerAustralianSanctionList;
-
-    @JsonProperty("shipOwnerBESSanctionList")
-    private Integer shipOwnerBESSanctionList;
-
-    @JsonProperty("shipOwnerCanadianSanctionList")
-    private Integer shipOwnerCanadianSanctionList;
-
-    @JsonProperty("shipOwnerEUSanctionList")
-    private Integer shipOwnerEUSanctionList;
-
-    @JsonProperty("shipOwnerFATFJurisdiction")
-    private Integer shipOwnerFATFJurisdiction;
-
-    @JsonProperty("shipOwnerHistoricalOFACSanctionedCountry")
-    private Integer shipOwnerHistoricalOFACSanctionedCountry;
-
-    @JsonProperty("shipOwnerOFACSanctionList")
-    private Integer shipOwnerOFACSanctionList;
-
-    @JsonProperty("shipOwnerOFACSanctionedCountry")
-    private Integer shipOwnerOFACSanctionedCountry;
-
-    @JsonProperty("shipOwnerParentCompanyNonCompliance")
-    private Integer shipOwnerParentCompanyNonCompliance;
-
-    @JsonProperty("shipOwnerParentFATFJurisdiction")
-    private String shipOwnerParentFATFJurisdiction;
-
-    @JsonProperty("shipOwnerParentOFACSanctionedCountry")
-    private String shipOwnerParentOFACSanctionedCountry;
-
-    @JsonProperty("shipOwnerSwissSanctionList")
-    private Integer shipOwnerSwissSanctionList;
-
-    @JsonProperty("shipOwnerUAESanctionList")
-    private Integer shipOwnerUAESanctionList;
-
-    @JsonProperty("shipOwnerUNSanctionList")
-    private Integer shipOwnerUNSanctionList;
-
-    @JsonProperty("shipSanctionedCountryPortCallLast12m")
-    private Integer shipSanctionedCountryPortCallLast12m;
-
-    @JsonProperty("shipSanctionedCountryPortCallLast3m")
-    private Integer shipSanctionedCountryPortCallLast3m;
-
-    @JsonProperty("shipSanctionedCountryPortCallLast6m")
-    private Integer shipSanctionedCountryPortCallLast6m;
-
-    @JsonProperty("shipSecurityLegalDisputeEvent")
-    private Integer shipSecurityLegalDisputeEvent;
-
-    @JsonProperty("shipSTSPartnerNonComplianceLast12m")
-    private Integer shipSTSPartnerNonComplianceLast12m;
-
-    @JsonProperty("shipSwissSanctionList")
-    private Integer shipSwissSanctionList;
-
-    @JsonProperty("shipUNSanctionList")
-    private Integer shipUNSanctionList;
-
-}
diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/dto/PagedUpdatedComplianceListDto.java b/src/main/java/com/snp/batch/jobs/web/compliance/dto/PagedUpdatedComplianceListDto.java
deleted file mode 100644
index cc75997..0000000
--- a/src/main/java/com/snp/batch/jobs/web/compliance/dto/PagedUpdatedComplianceListDto.java
+++ /dev/null
@@ -1,45 +0,0 @@
-package com.snp.batch.jobs.web.compliance.dto;
-
-import com.fasterxml.jackson.annotation.JsonProperty;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Getter;
-import lombok.NoArgsConstructor;
-import lombok.Setter;
-import java.util.List;
-
-@Getter
-@Setter
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class PagedUpdatedComplianceListDto {
-
-    @JsonProperty("pageSize")
-    private Integer pageSize;
-
-    @JsonProperty("pageNumber")
-    private Integer pageNumber;
-
-    @JsonProperty("firstPage")
-    private String firstPage;
-
-    @JsonProperty("lastPage")
-    private String lastPage;
-
-    @JsonProperty("totalPages")
-    private Integer totalPages;
-
-    @JsonProperty("totalRecords")
-    private Integer totalRecords;
-
-    @JsonProperty("nextPage")
-    private String nextPage;
-
-    @JsonProperty("previousPage")
-    private String previousPage;
-
-    @JsonProperty("data")
-    private List<Object> data;
-
-}
diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/dto/UpdatedComplianceListDto.java b/src/main/java/com/snp/batch/jobs/web/compliance/dto/UpdatedComplianceListDto.java
deleted file mode 100644
index 5789c15..0000000
--- a/src/main/java/com/snp/batch/jobs/web/compliance/dto/UpdatedComplianceListDto.java
+++ /dev/null
@@ -1,122 +0,0 @@
-package com.snp.batch.jobs.web.compliance.dto;
-
-import com.fasterxml.jackson.annotation.JsonProperty;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Getter;
-import lombok.NoArgsConstructor;
-import lombok.Setter;
-
-@Getter
-@Setter
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class UpdatedComplianceListDto {
-
-    @JsonProperty("lrimoShipNo")
-    private String lrimoShipNo;
-
-    @JsonProperty("dateAmended")
-    private String dateAmended;
-
-    @JsonProperty("legalOverall")
-    private Integer legalOverall;
-
-    @JsonProperty("shipBESSanctionList")
-    private Integer shipBESSanctionList;
-
-    @JsonProperty("shipDarkActivityIndicator")
-    private Integer shipDarkActivityIndicator;
-
-    @JsonProperty("shipDetailsNoLongerMaintained")
-    private Integer shipDetailsNoLongerMaintained;
-
-    @JsonProperty("shipEUSanctionList")
-    private Integer shipEUSanctionList;
-
-    @JsonProperty("shipFlagDisputed")
-    private Integer shipFlagDisputed;
-
-    @JsonProperty("shipFlagSanctionedCountry")
-    private Integer shipFlagSanctionedCountry;
-
-    @JsonProperty("shipHistoricalFlagSanctionedCountry")
-    private Integer shipHistoricalFlagSanctionedCountry;
-
-    @JsonProperty("shipOFACNonSDNSanctionList")
-    private Integer shipOFACNonSDNSanctionList;
-
-    @JsonProperty("shipOFACSanctionList")
-    private Integer shipOFACSanctionList;
-
-    @JsonProperty("shipOFACAdvisoryList")
-    private Integer shipOFACAdvisoryList;
-
-    @JsonProperty("shipOwnerOFACSSIList")
-    private Integer shipOwnerOFACSSIList;
-
-    @JsonProperty("shipOwnerAustralianSanctionList")
-    private Integer shipOwnerAustralianSanctionList;
-
-    @JsonProperty("shipOwnerBESSanctionList")
-    private Integer shipOwnerBESSanctionList;
-
-    @JsonProperty("shipOwnerCanadianSanctionList")
-    private Integer shipOwnerCanadianSanctionList;
-
-    @JsonProperty("shipOwnerEUSanctionList")
-    private Integer shipOwnerEUSanctionList;
-
-    @JsonProperty("shipOwnerFATFJurisdiction")
-    private Integer shipOwnerFATFJurisdiction;
-
-    @JsonProperty("shipOwnerHistoricalOFACSanctionedCountry")
-    private Integer shipOwnerHistoricalOFACSanctionedCountry;
-
-    @JsonProperty("shipOwnerOFACSanctionList")
-    private Integer shipOwnerOFACSanctionList;
-
-    @JsonProperty("shipOwnerOFACSanctionedCountry")
-    private Integer shipOwnerOFACSanctionedCountry;
-
-    @JsonProperty("shipOwnerParentCompanyNonCompliance")
-    private Integer shipOwnerParentCompanyNonCompliance;
-
-    @JsonProperty("shipOwnerParentFATFJurisdiction")
-    private Integer shipOwnerParentFATFJurisdiction;
-
-    @JsonProperty("shipOwnerParentOFACSanctionedCountry")
-    private Integer shipOwnerParentOFACSanctionedCountry;
-
-    @JsonProperty("shipOwnerSwissSanctionList")
-    private Integer shipOwnerSwissSanctionList;
-
-    @JsonProperty("shipOwnerUAESanctionList")
-    private Integer shipOwnerUAESanctionList;
-
-    @JsonProperty("shipOwnerUNSanctionList")
-    private Integer shipOwnerUNSanctionList;
-
-    @JsonProperty("shipSanctionedCountryPortCallLast12m")
-    private Integer shipSanctionedCountryPortCallLast12m;
-
-    @JsonProperty("shipSanctionedCountryPortCallLast3m")
-    private Integer shipSanctionedCountryPortCallLast3m;
-
-    @JsonProperty("shipSanctionedCountryPortCallLast6m")
-    private Integer shipSanctionedCountryPortCallLast6m;
-
-    @JsonProperty("shipSecurityLegalDisputeEvent")
-    private Integer shipSecurityLegalDisputeEvent;
-
-    @JsonProperty("shipSTSPartnerNonComplianceLast12m")
-    private Integer shipSTSPartnerNonComplianceLast12m;
-
-    @JsonProperty("shipSwissSanctionList")
-    private Integer shipSwissSanctionList;
-
-    @JsonProperty("shipUNSanctionList")
-    private Integer shipUNSanctionList;
-
-}
diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/service/ComplianceValuesMeaningService.java b/src/main/java/com/snp/batch/jobs/web/compliance/service/ComplianceValuesMeaningService.java
deleted file mode 100644
index 7a10912..0000000
--- a/src/main/java/com/snp/batch/jobs/web/compliance/service/ComplianceValuesMeaningService.java
+++ /dev/null
@@ -1,34 +0,0 @@
-package com.snp.batch.jobs.web.compliance.service;
-
-import com.snp.batch.jobs.web.compliance.dto.ComplianceValuesMeaningDto;
-import com.snp.batch.common.web.service.BaseBypassService;
-import java.util.List;
-import org.springframework.beans.factory.annotation.Qualifier;
-import org.springframework.core.ParameterizedTypeReference;
-import org.springframework.stereotype.Service;
-import org.springframework.web.reactive.function.client.WebClient;
-
-/**
- * 모든 Compliance 지표 조회 bypass 서비스
- * 외부 Maritime API에서 데이터를 실시간 조회하여 그대로 반환
- */
-@Service
-public class ComplianceValuesMeaningService extends BaseBypassService<ComplianceValuesMeaningDto> {
-
-    public ComplianceValuesMeaningService(
-            @Qualifier("maritimeServiceApiWebClient") WebClient webClient) {
-        super(webClient, "/RiskAndCompliance/ComplianceValuesMeaning", "모든 Compliance 지표 조회",
-                new ParameterizedTypeReference<>() {},
-                new ParameterizedTypeReference<>() {});
-    }
-
-    /**
-     * 모든 Compliance 지표 조회 데이터를 조회합니다.
-     *
-     * @return 모든 Compliance 지표 조회
-     */
-    public List<ComplianceValuesMeaningDto> getComplianceValuesMeaningData() {
-        return fetchGetList(uri -> uri.path(getApiPath())
-                        .build());
-    }
-}
diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/service/CompliancesByImosService.java b/src/main/java/com/snp/batch/jobs/web/compliance/service/CompliancesByImosService.java
deleted file mode 100644
index 7be28ee..0000000
--- a/src/main/java/com/snp/batch/jobs/web/compliance/service/CompliancesByImosService.java
+++ /dev/null
@@ -1,35 +0,0 @@
-package com.snp.batch.jobs.web.compliance.service;
-
-import com.snp.batch.jobs.web.compliance.dto.CompliancesByImosDto;
-import com.snp.batch.common.web.service.BaseBypassService;
-import java.util.List;
-import org.springframework.beans.factory.annotation.Qualifier;
-import org.springframework.core.ParameterizedTypeReference;
-import org.springframework.stereotype.Service;
-import org.springframework.web.reactive.function.client.WebClient;
-
-/**
- * IMO 기반 Compliance 조회 bypass 서비스
- * 외부 Maritime API에서 데이터를 실시간 조회하여 그대로 반환
- */
-@Service
-public class CompliancesByImosService extends BaseBypassService<CompliancesByImosDto> {
-
-    public CompliancesByImosService(
-            @Qualifier("maritimeServiceApiWebClient") WebClient webClient) {
-        super(webClient, "/RiskAndCompliance/CompliancesByImos", "IMO 기반 Compliance 조회",
-                new ParameterizedTypeReference<>() {},
-                new ParameterizedTypeReference<>() {});
-    }
-
-    /**
-     * IMO 기반 Compliance 조회 데이터를 조회합니다.
-     *
-     * @return IMO 기반 Compliance 조회
-     */
-    public List<CompliancesByImosDto> getCompliancesByImosData(String imos) {
-        return fetchGetList(uri -> uri.path(getApiPath())
-                        .queryParam("imos", imos)
-                        .build());
-    }
-}
diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/service/PagedUpdatedComplianceListService.java b/src/main/java/com/snp/batch/jobs/web/compliance/service/PagedUpdatedComplianceListService.java
deleted file mode 100644
index 7eb2091..0000000
--- a/src/main/java/com/snp/batch/jobs/web/compliance/service/PagedUpdatedComplianceListService.java
+++ /dev/null
@@ -1,38 +0,0 @@
-package com.snp.batch.jobs.web.compliance.service;
-
-import com.snp.batch.jobs.web.compliance.dto.PagedUpdatedComplianceListDto;
-import com.snp.batch.common.web.service.BaseBypassService;
-import java.util.List;
-import org.springframework.beans.factory.annotation.Qualifier;
-import org.springframework.core.ParameterizedTypeReference;
-import org.springframework.stereotype.Service;
-import org.springframework.web.reactive.function.client.WebClient;
-
-/**
- * PagedUpdatedComplianceList bypass 서비스
- * 외부 Maritime API에서 데이터를 실시간 조회하여 그대로 반환
- */
-@Service
-public class PagedUpdatedComplianceListService extends BaseBypassService<PagedUpdatedComplianceListDto> {
-
-    public PagedUpdatedComplianceListService(
-            @Qualifier("maritimeServiceApiWebClient") WebClient webClient) {
-        super(webClient, "/RiskAndCompliance/PagedUpdatedComplianceList", "PagedUpdatedComplianceList",
-                new ParameterizedTypeReference<>() {},
-                new ParameterizedTypeReference<>() {});
-    }
-
-    /**
-     * PagedUpdatedComplianceList 데이터를 조회합니다.
-     *
-     * @return PagedUpdatedComplianceList
-     */
-    public List<PagedUpdatedComplianceListDto> getPagedUpdatedComplianceListData(String fromDate, String toDate, String pageNumber, String pageSize) {
-        return fetchGetList(uri -> uri.path(getApiPath())
-                        .queryParam("fromDate", fromDate)
-                        .queryParam("toDate", toDate)
-                        .queryParam("pageNumber", pageNumber)
-                        .queryParam("pageSize", pageSize)
-                        .build());
-    }
-}
diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/service/UpdatedComplianceListService.java b/src/main/java/com/snp/batch/jobs/web/compliance/service/UpdatedComplianceListService.java
deleted file mode 100644
index 44960ab..0000000
--- a/src/main/java/com/snp/batch/jobs/web/compliance/service/UpdatedComplianceListService.java
+++ /dev/null
@@ -1,36 +0,0 @@
-package com.snp.batch.jobs.web.compliance.service;
-
-import com.snp.batch.jobs.web.compliance.dto.UpdatedComplianceListDto;
-import com.snp.batch.common.web.service.BaseBypassService;
-import java.util.List;
-import org.springframework.beans.factory.annotation.Qualifier;
-import org.springframework.core.ParameterizedTypeReference;
-import org.springframework.stereotype.Service;
-import org.springframework.web.reactive.function.client.WebClient;
-
-/**
- * 기간 내 변경 Compliance 조회 bypass 서비스
- * 외부 Maritime API에서 데이터를 실시간 조회하여 그대로 반환
- */
-@Service
-public class UpdatedComplianceListService extends BaseBypassService<UpdatedComplianceListDto> {
-
-    public UpdatedComplianceListService(
-            @Qualifier("maritimeServiceApiWebClient") WebClient webClient) {
-        super(webClient, "/RiskAndCompliance/UpdatedComplianceList", "기간 내 변경 Compliance 조회",
-                new ParameterizedTypeReference<>() {},
-                new ParameterizedTypeReference<>() {});
-    }
-
-    /**
-     * 기간 내 변경 Compliance 조회 데이터를 조회합니다.
-     *
-     * @return 기간 내 변경 Compliance 조회
-     */
-    public List<UpdatedComplianceListDto> getUpdatedComplianceListData(String fromDate, String toDate) {
-        return fetchGetList(uri -> uri.path(getApiPath())
-                        .queryParam("fromDate", fromDate)
-                        .queryParam("toDate", toDate)
-                        .build());
-    }
-}
diff --git a/src/main/java/com/snp/batch/service/BypassCodeGenerator.java b/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
index c4619b4..31ded63 100644
--- a/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
+++ b/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
@@ -2,7 +2,6 @@ package com.snp.batch.service;
 
 import com.snp.batch.global.dto.CodeGenerationResult;
 import com.snp.batch.global.model.BypassApiConfig;
-import com.snp.batch.global.model.BypassApiField;
 import com.snp.batch.global.model.BypassApiParam;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.stereotype.Service;
@@ -19,7 +18,8 @@ import java.util.stream.Collectors;
 
 /**
  * BYPASS API Java 소스 코드를 자동 생성하는 서비스.
- * 같은 도메인의 N개 설정을 받아 N개의 DTO + Service와 1개의 Controller를 생성합니다.
+ * 모든 API는 RAW 모드(JsonNode 패스스루)로 생성됩니다.
+ * 같은 도메인의 N개 설정을 받아 N개의 Service와 1개의 Controller를 생성합니다.
  */
 @Slf4j
 @Service
@@ -29,11 +29,8 @@ public class BypassCodeGenerator {
 
     /**
      * 같은 도메인의 BYPASS API 코드를 생성합니다.
-     * 엔드포인트별 DTO/Service를 각각 생성하고, Controller 1개에 모든 엔드포인트 메서드를 합칩니다.
-     *
-     * @param configs 같은 domainName을 가진 설정 목록
-     * @param force   기존 파일 덮어쓰기 여부
-     * @return 생성 결과
+     * 엔드포인트별 Service를 각각 생성하고, Controller 1개에 모든 엔드포인트 메서드를 합칩니다.
+     * 모든 응답은 JsonNode로 패스스루됩니다 (DTO 없음).
      */
     public CodeGenerationResult generate(List<BypassApiConfig> configs, boolean force) {
         if (configs == null || configs.isEmpty()) {
@@ -44,25 +41,12 @@ public class BypassCodeGenerator {
         String domain = configs.get(0).getDomainName();
         String basePath = projectRoot + "/src/main/java/com/snp/batch/jobs/web/" + domain;
 
-        List<String> dtoPaths = new ArrayList<>();
         List<String> servicePaths = new ArrayList<>();
 
         for (BypassApiConfig config : configs) {
             String endpointName = config.getEndpointName();
-
-            String dtoPath = basePath + "/dto/" + endpointName + "Dto.java";
             String servicePath = basePath + "/service/" + endpointName + "Service.java";
 
-            // Service/DTO: 이미 존재하면 스킵 (force=true면 재생성)
-            if (!force && Files.exists(Path.of(dtoPath))) {
-                log.info("DTO 파일 이미 존재, 스킵: {}", dtoPath);
-                dtoPaths.add(dtoPath);
-            } else {
-                String dtoCode = generateDtoCode(domain, endpointName, config.getFields());
-                Path dtoFilePath = writeFile(dtoPath, dtoCode, true);
-                dtoPaths.add(dtoFilePath.toString());
-            }
-
             if (!force && Files.exists(Path.of(servicePath))) {
                 log.info("Service 파일 이미 존재, 스킵: {}", servicePath);
                 servicePaths.add(servicePath);
@@ -85,105 +69,40 @@ public class BypassCodeGenerator {
         return CodeGenerationResult.builder()
                 .controllerPath(controllerFilePath.toString())
                 .servicePaths(servicePaths)
-                .dtoPaths(dtoPaths)
                 .message("코드 생성 완료. 서버를 재시작하면 새 API가 활성화됩니다.")
                 .build();
     }
 
     /**
-     * DTO 코드 생성.
-     * endpointName 기반 클래스명: {EndpointName}Dto
-     */
-    private String generateDtoCode(String domain, String endpointName, List<BypassApiField> fields) {
-        String packageName = BASE_PACKAGE + "." + domain + ".dto";
-        boolean needsLocalDateTime = fields.stream()
-                .anyMatch(f -> "LocalDateTime".equals(f.getFieldType()));
-
-        boolean needsList = fields.stream()
-                .anyMatch(f -> f.getFieldType() != null && f.getFieldType().startsWith("List"));
-        boolean needsMap = fields.stream()
-                .anyMatch(f -> f.getFieldType() != null && f.getFieldType().startsWith("Map"));
-
-        StringBuilder imports = new StringBuilder();
-        imports.append("import com.fasterxml.jackson.annotation.JsonProperty;\n");
-        imports.append("import lombok.AllArgsConstructor;\n");
-        imports.append("import lombok.Builder;\n");
-        imports.append("import lombok.Getter;\n");
-        imports.append("import lombok.NoArgsConstructor;\n");
-        imports.append("import lombok.Setter;\n");
-        if (needsLocalDateTime) {
-            imports.append("import java.time.LocalDateTime;\n");
-        }
-        if (needsList) {
-            imports.append("import java.util.List;\n");
-        }
-        if (needsMap) {
-            imports.append("import java.util.Map;\n");
-        }
-
-        StringBuilder fieldLines = new StringBuilder();
-        for (BypassApiField field : fields) {
-            String jsonProp = field.getJsonProperty() != null ? field.getJsonProperty() : field.getFieldName();
-            fieldLines.append("    @JsonProperty(\"").append(jsonProp).append("\")\n");
-            fieldLines.append("    private ").append(field.getFieldType()).append(" ").append(field.getFieldName()).append(";\n\n");
-        }
-
-        return """
-                package {{PACKAGE}};
-
-                {{IMPORTS}}
-                @Getter
-                @Setter
-                @Builder
-                @NoArgsConstructor
-                @AllArgsConstructor
-                public class {{CLASS_NAME}} {
-
-                {{FIELDS}}}
-                """
-                .replace("{{PACKAGE}}", packageName)
-                .replace("{{IMPORTS}}", imports.toString())
-                .replace("{{CLASS_NAME}}", endpointName + "Dto")
-                .replace("{{FIELDS}}", fieldLines.toString());
-    }
-
-    /**
-     * Service 코드 생성.
-     * endpointName 기반 클래스명: {EndpointName}Service
-     * BaseBypassService<{EndpointName}Dto>를 상속합니다.
+     * Service 코드 생성 (RAW 모드).
+     * BaseBypassService<JsonNode>를 상속하여 fetchRawGet/fetchRawPost로 JsonNode를 반환합니다.
      */
     private String generateServiceCode(String domain, String endpointName,
                                         BypassApiConfig config, List<BypassApiParam> params) {
         String packageName = BASE_PACKAGE + "." + domain + ".service";
-        String dtoPackage = BASE_PACKAGE + "." + domain + ".dto";
-        String dtoClass = endpointName + "Dto";
         String serviceClass = endpointName + "Service";
-        boolean isList = "LIST".equalsIgnoreCase(config.getResponseType());
         boolean isPost = "POST".equalsIgnoreCase(config.getHttpMethod());
 
-        String returnType = isList ? "List<" + dtoClass + ">" : dtoClass;
         String methodName = "get" + endpointName + "Data";
-        String fetchMethod = buildFetchMethodCall(config, params, isList, isPost);
+        String fetchMethod = buildFetchMethodCall(config, params, isPost);
         String methodParams = buildMethodParams(params);
 
-        String listImport = isList ? "import java.util.List;\n" : "";
-
         return """
                 package {{PACKAGE}};
 
-                import {{DTO_IMPORT}};
+                import com.fasterxml.jackson.databind.JsonNode;
                 import com.snp.batch.common.web.service.BaseBypassService;
-                {{LIST_IMPORT}}import org.springframework.beans.factory.annotation.Qualifier;
+                import org.springframework.beans.factory.annotation.Qualifier;
                 import org.springframework.core.ParameterizedTypeReference;
                 import org.springframework.stereotype.Service;
                 import org.springframework.web.reactive.function.client.WebClient;
 
                 /**
                  * {{DISPLAY_NAME}} bypass 서비스
-                 * 외부 Maritime API에서 데이터를 실시간 조회하여 그대로 반환
+                 * 외부 Maritime API에서 데이터를 실시간 조회하여 JSON을 그대로 반환
                  */
                 @Service
-                public class {{SERVICE_CLASS}} extends BaseBypassService<{{DTO_CLASS}}> {
+                public class {{SERVICE_CLASS}} extends BaseBypassService<JsonNode> {
 
                     public {{SERVICE_CLASS}}(
                             @Qualifier("{{WEBCLIENT_BEAN}}") WebClient webClient) {
@@ -194,41 +113,35 @@ public class BypassCodeGenerator {
 
                     /**
                      * {{DISPLAY_NAME}} 데이터를 조회합니다.
-                     *
-                     * @return {{DISPLAY_NAME}}
                      */
-                    public {{RETURN_TYPE}} {{METHOD_NAME}}({{METHOD_PARAMS}}) {
+                    public JsonNode {{METHOD_NAME}}({{METHOD_PARAMS}}) {
                         {{FETCH_METHOD}}
                     }
                 }
                 """
                 .replace("{{PACKAGE}}", packageName)
-                .replace("{{DTO_IMPORT}}", dtoPackage + "." + dtoClass)
-                .replace("{{LIST_IMPORT}}", listImport)
                 .replace("{{DISPLAY_NAME}}", config.getDisplayName())
                 .replace("{{SERVICE_CLASS}}", serviceClass)
-                .replace("{{DTO_CLASS}}", dtoClass)
                 .replace("{{WEBCLIENT_BEAN}}", config.getWebclientBean())
                 .replace("{{EXTERNAL_PATH}}", config.getExternalPath())
-                .replace("{{RETURN_TYPE}}", returnType)
                 .replace("{{METHOD_NAME}}", methodName)
                 .replace("{{METHOD_PARAMS}}", methodParams)
                 .replace("{{FETCH_METHOD}}", fetchMethod);
     }
 
     /**
-     * Controller 코드 생성.
-     * 같은 도메인의 모든 설정을 합쳐 하나의 Controller에 N개의 엔드포인트 메서드를 생성합니다.
+     * Controller 코드 생성 (RAW 모드).
+     * 모든 엔드포인트가 ResponseEntity<ApiResponse<JsonNode>>를 반환합니다.
      */
     private String generateControllerCode(String domain, List<BypassApiConfig> configs) {
         String packageName = BASE_PACKAGE + "." + domain + ".controller";
         String servicePackage = BASE_PACKAGE + "." + domain + ".service";
-        String dtoPackage = BASE_PACKAGE + "." + domain + ".dto";
         String domainCap = capitalize(domain);
         String requestMappingPath = "/api/" + domain;
 
-        // imports 합산 (중복 제거)
+        // imports (중복 제거)
         Set<String> importSet = new LinkedHashSet<>();
+        importSet.add("import com.fasterxml.jackson.databind.JsonNode;");
         importSet.add("import com.snp.batch.common.web.ApiResponse;");
         importSet.add("import com.snp.batch.common.web.controller.BaseBypassController;");
         importSet.add("import io.swagger.v3.oas.annotations.Operation;");
@@ -239,7 +152,6 @@ public class BypassCodeGenerator {
         importSet.add("import org.springframework.web.bind.annotation.RequestMapping;");
         importSet.add("import org.springframework.web.bind.annotation.RestController;");
 
-        boolean anyList = configs.stream().anyMatch(c -> "LIST".equalsIgnoreCase(c.getResponseType()));
         boolean anyPost = configs.stream().anyMatch(c -> "POST".equalsIgnoreCase(c.getHttpMethod()));
         boolean anyGet = configs.stream().anyMatch(c -> !"POST".equalsIgnoreCase(c.getHttpMethod()));
         boolean anyPath = configs.stream()
@@ -249,29 +161,14 @@ public class BypassCodeGenerator {
         boolean anyBody = configs.stream()
                 .anyMatch(c -> c.getParams().stream().anyMatch(p -> "BODY".equalsIgnoreCase(p.getParamIn())));
 
-        if (anyList) {
-            importSet.add("import java.util.List;");
-        }
-        if (anyPost) {
-            importSet.add("import org.springframework.web.bind.annotation.PostMapping;");
-        }
-        if (anyGet) {
-            importSet.add("import org.springframework.web.bind.annotation.GetMapping;");
-        }
-        if (anyPath) {
-            importSet.add("import org.springframework.web.bind.annotation.PathVariable;");
-        }
-        if (anyQuery) {
-            importSet.add("import org.springframework.web.bind.annotation.RequestParam;");
-        }
-        if (anyBody) {
-            importSet.add("import org.springframework.web.bind.annotation.RequestBody;");
-        }
+        if (anyPost) importSet.add("import org.springframework.web.bind.annotation.PostMapping;");
+        if (anyGet) importSet.add("import org.springframework.web.bind.annotation.GetMapping;");
+        if (anyPath) importSet.add("import org.springframework.web.bind.annotation.PathVariable;");
+        if (anyQuery) importSet.add("import org.springframework.web.bind.annotation.RequestParam;");
+        if (anyBody) importSet.add("import org.springframework.web.bind.annotation.RequestBody;");
 
         for (BypassApiConfig config : configs) {
-            String endpointName = config.getEndpointName();
-            importSet.add("import " + dtoPackage + "." + endpointName + "Dto;");
-            importSet.add("import " + servicePackage + "." + endpointName + "Service;");
+            importSet.add("import " + servicePackage + "." + config.getEndpointName() + "Service;");
         }
 
         String importsStr = importSet.stream().collect(Collectors.joining("\n"));
@@ -279,13 +176,11 @@ public class BypassCodeGenerator {
         // 필드 선언부
         StringBuilder fields = new StringBuilder();
         for (BypassApiConfig config : configs) {
-            String endpointName = config.getEndpointName();
-            String serviceClass = endpointName + "Service";
+            String serviceClass = config.getEndpointName() + "Service";
             String serviceField = Character.toLowerCase(serviceClass.charAt(0)) + serviceClass.substring(1);
             fields.append("    private final ").append(serviceClass).append(" ").append(serviceField).append(";\n");
         }
 
-        // 태그 description은 첫 번째 config의 webclientBean 기준
         String tagPrefix = getTagPrefix(configs.get(0).getWebclientBean());
         String tagDescription = tagPrefix + " " + domainCap + " bypass API";
 
@@ -293,13 +188,10 @@ public class BypassCodeGenerator {
         StringBuilder methods = new StringBuilder();
         for (BypassApiConfig config : configs) {
             String endpointName = config.getEndpointName();
-            String dtoClass = endpointName + "Dto";
             String serviceClass = endpointName + "Service";
             String serviceField = Character.toLowerCase(serviceClass.charAt(0)) + serviceClass.substring(1);
-            boolean isList = "LIST".equalsIgnoreCase(config.getResponseType());
             boolean isPost = "POST".equalsIgnoreCase(config.getHttpMethod());
 
-            String responseGeneric = isList ? "List<" + dtoClass + ">" : dtoClass;
             String mappingAnnotation = isPost ? "@PostMapping" : "@GetMapping";
             String mappingPath = buildMappingPath(config.getParams(), config.getExternalPath());
             String paramAnnotations = buildControllerParamAnnotations(config.getParams());
@@ -313,8 +205,7 @@ public class BypassCodeGenerator {
                     .append(" 데이터를 요청하고 응답을 그대로 반환합니다.\"\n");
             methods.append("    )\n");
             methods.append("    ").append(mappingAnnotation).append(mappingPath).append("\n");
-            methods.append("    public ResponseEntity<ApiResponse<").append(responseGeneric).append(">> ")
-                    .append(methodName).append("(");
+            methods.append("    public ResponseEntity<ApiResponse<JsonNode>> ").append(methodName).append("(");
             if (!paramAnnotations.isEmpty()) {
                 methods.append(paramAnnotations);
             }
@@ -328,7 +219,7 @@ public class BypassCodeGenerator {
                 + importsStr + "\n\n"
                 + "/**\n"
                 + " * " + domainCap + " bypass API\n"
-                + " * S&P Maritime API에서 데이터를 실시간 조회하여 그대로 반환\n"
+                + " * S&P Maritime API에서 데이터를 실시간 조회하여 JSON을 그대로 반환\n"
                 + " */\n"
                 + "@RestController\n"
                 + "@RequestMapping(\"" + requestMappingPath + "\")\n"
@@ -341,10 +232,9 @@ public class BypassCodeGenerator {
     }
 
     /**
-     * fetch 메서드 호출 코드 생성
+     * RAW fetch 메서드 호출 코드 생성
      */
-    private String buildFetchMethodCall(BypassApiConfig config, List<BypassApiParam> params,
-                                         boolean isList, boolean isPost) {
+    private String buildFetchMethodCall(BypassApiConfig config, List<BypassApiParam> params, boolean isPost) {
         List<BypassApiParam> queryParams = params.stream()
                 .filter(p -> "QUERY".equalsIgnoreCase(p.getParamIn()))
                 .sorted((a, b) -> Integer.compare(a.getSortOrder(), b.getSortOrder()))
@@ -358,23 +248,17 @@ public class BypassCodeGenerator {
         }
         uriBuilder.append("\n                        .build()");
 
-        String fetchName;
         if (isPost) {
-            fetchName = isList ? "fetchPostList" : "fetchPostOne";
             BypassApiParam bodyParam = params.stream()
                     .filter(p -> "BODY".equalsIgnoreCase(p.getParamIn()))
                     .findFirst().orElse(null);
             String bodyArg = bodyParam != null ? bodyParam.getParamName() : "null";
-            return "return " + fetchName + "(" + bodyArg + ", " + uriBuilder + ");";
+            return "return fetchRawPost(" + bodyArg + ", " + uriBuilder + ");";
         } else {
-            fetchName = isList ? "fetchGetList" : "fetchGetOne";
-            return "return " + fetchName + "(" + uriBuilder + ");";
+            return "return fetchRawGet(" + uriBuilder + ");";
         }
     }
 
-    /**
-     * 메서드 파라미터 목록 생성 (Java 타입 + 이름)
-     */
     private String buildMethodParams(List<BypassApiParam> params) {
         return params.stream()
                 .sorted((a, b) -> Integer.compare(a.getSortOrder(), b.getSortOrder()))
@@ -382,9 +266,6 @@ public class BypassCodeGenerator {
                 .collect(Collectors.joining(", "));
     }
 
-    /**
-     * 서비스 호출 인자 목록 생성
-     */
     private String buildServiceCallArgs(List<BypassApiParam> params) {
         return params.stream()
                 .sorted((a, b) -> Integer.compare(a.getSortOrder(), b.getSortOrder()))
@@ -392,9 +273,6 @@ public class BypassCodeGenerator {
                 .collect(Collectors.joining(", "));
     }
 
-    /**
-     * Controller 메서드 파라미터 어노테이션 포함 목록 생성
-     */
     private String buildControllerParamAnnotations(List<BypassApiParam> params) {
         if (params.isEmpty()) {
             return "";
@@ -421,12 +299,6 @@ public class BypassCodeGenerator {
                 .collect(Collectors.joining(",\n            "));
     }
 
-    /**
-     * @GetMapping / @PostMapping에 붙는 경로 생성
-     * externalPath의 마지막 세그먼트를 내부 경로로 사용 + PATH 파라미터 추가
-     * 예: /RiskAndCompliance/CompliancesByImos → ("/CompliancesByImos")
-     *     PATH 파라미터 imo 추가 시 → ("/CompliancesByImos/{imo}")
-     */
     private String buildMappingPath(List<BypassApiParam> params, String externalPath) {
         String endpointSegment = "";
         if (externalPath != null && !externalPath.isEmpty()) {
@@ -451,14 +323,6 @@ public class BypassCodeGenerator {
         return "(\"" + fullPath + "\")";
     }
 
-    /**
-     * 파일을 지정 경로에 씁니다.
-     *
-     * @param path    파일 경로
-     * @param content 파일 내용
-     * @param force   덮어쓰기 허용 여부
-     * @return 생성된 파일 경로
-     */
     private Path writeFile(String path, String content, boolean force) {
         Path filePath = Path.of(path);
         if (Files.exists(filePath) && !force) {
@@ -474,9 +338,6 @@ public class BypassCodeGenerator {
         return filePath;
     }
 
-    /**
-     * webclientBean 이름 → Swagger @Tag description 접두사 변환
-     */
     private String getTagPrefix(String webclientBean) {
         if (webclientBean == null) {
             return "[Ship API]";
@@ -488,9 +349,6 @@ public class BypassCodeGenerator {
         };
     }
 
-    /**
-     * paramType → Swagger @Parameter example 기본값 결정
-     */
     private String getDefaultExample(String paramType) {
         if (paramType == null) {
             return "9876543";
@@ -510,9 +368,6 @@ public class BypassCodeGenerator {
         return Character.toUpperCase(s.charAt(0)) + s.substring(1);
     }
 
-    /**
-     * param_type → Java 타입 변환
-     */
     private String toJavaType(String paramType) {
         if (paramType == null) {
             return "String";
diff --git a/src/main/java/com/snp/batch/service/BypassConfigService.java b/src/main/java/com/snp/batch/service/BypassConfigService.java
index deed43b..cb40d29 100644
--- a/src/main/java/com/snp/batch/service/BypassConfigService.java
+++ b/src/main/java/com/snp/batch/service/BypassConfigService.java
@@ -2,10 +2,8 @@ package com.snp.batch.service;
 
 import com.snp.batch.global.dto.BypassConfigRequest;
 import com.snp.batch.global.dto.BypassConfigResponse;
-import com.snp.batch.global.dto.BypassFieldDto;
 import com.snp.batch.global.dto.BypassParamDto;
 import com.snp.batch.global.model.BypassApiConfig;
-import com.snp.batch.global.model.BypassApiField;
 import com.snp.batch.global.model.BypassApiParam;
 import com.snp.batch.global.repository.BypassApiConfigRepository;
 import jakarta.persistence.EntityManager;
@@ -30,8 +28,6 @@ public class BypassConfigService {
 
     /**
      * 설정 목록 조회
-     *
-     * @return 전체 BYPASS API 설정 목록
      */
     public List<BypassConfigResponse> getConfigs() {
         return configRepository.findAll().stream()
@@ -41,9 +37,6 @@ public class BypassConfigService {
 
     /**
      * 설정 상세 조회
-     *
-     * @param id 설정 ID
-     * @return 설정 상세 정보
      */
     public BypassConfigResponse getConfig(Long id) {
         BypassApiConfig config = configRepository.findById(id)
@@ -53,9 +46,6 @@ public class BypassConfigService {
 
     /**
      * 설정 등록
-     *
-     * @param request 등록 요청 DTO
-     * @return 등록된 설정 정보
      */
     @Transactional
     public BypassConfigResponse createConfig(BypassConfigRequest request) {
@@ -73,22 +63,11 @@ public class BypassConfigService {
                 config.getParams().add(param);
             });
         }
-        if (request.getFields() != null) {
-            request.getFields().forEach(f -> {
-                BypassApiField field = toFieldEntity(f);
-                field.setConfig(config);
-                config.getFields().add(field);
-            });
-        }
         return toResponse(configRepository.save(config));
     }
 
     /**
      * 설정 수정
-     *
-     * @param id      설정 ID
-     * @param request 수정 요청 DTO
-     * @return 수정된 설정 정보
      */
     @Transactional
     public BypassConfigResponse updateConfig(Long id, BypassConfigRequest request) {
@@ -100,12 +79,10 @@ public class BypassConfigService {
         config.setWebclientBean(request.getWebclientBean());
         config.setExternalPath(request.getExternalPath());
         config.setHttpMethod(request.getHttpMethod());
-        config.setResponseType(request.getResponseType());
         config.setDescription(request.getDescription());
 
-        // params/fields 교체: clear → flush(DELETE 실행) → 새로 추가
+        // params 교체: clear → flush(DELETE 실행) → 새로 추가
         config.getParams().clear();
-        config.getFields().clear();
         entityManager.flush();
 
         if (request.getParams() != null) {
@@ -116,21 +93,11 @@ public class BypassConfigService {
             });
         }
 
-        if (request.getFields() != null) {
-            request.getFields().forEach(f -> {
-                BypassApiField field = toFieldEntity(f);
-                field.setConfig(config);
-                config.getFields().add(field);
-            });
-        }
-
         return toResponse(configRepository.save(config));
     }
 
     /**
      * 설정 삭제
-     *
-     * @param id 설정 ID
      */
     @Transactional
     public void deleteConfig(Long id) {
@@ -142,8 +109,6 @@ public class BypassConfigService {
 
     /**
      * 코드 생성 완료 마킹
-     *
-     * @param id 설정 ID
      */
     @Transactional
     public void markAsGenerated(Long id) {
@@ -165,14 +130,12 @@ public class BypassConfigService {
                 .webclientBean(config.getWebclientBean())
                 .externalPath(config.getExternalPath())
                 .httpMethod(config.getHttpMethod())
-                .responseType(config.getResponseType())
                 .description(config.getDescription())
                 .generated(config.getGenerated())
                 .generatedAt(config.getGeneratedAt())
                 .createdAt(config.getCreatedAt())
                 .updatedAt(config.getUpdatedAt())
                 .params(config.getParams().stream().map(this::toParamDto).toList())
-                .fields(config.getFields().stream().map(this::toFieldDto).toList())
                 .build();
     }
 
@@ -184,14 +147,12 @@ public class BypassConfigService {
                 .webclientBean(request.getWebclientBean())
                 .externalPath(request.getExternalPath())
                 .httpMethod(request.getHttpMethod() != null ? request.getHttpMethod() : "GET")
-                .responseType(request.getResponseType() != null ? request.getResponseType() : "LIST")
                 .description(request.getDescription())
                 .build();
     }
 
     /**
      * externalPath의 마지막 세그먼트를 endpointName으로 추출
-     * 예: "/RiskAndCompliance/CompliancesByImos" → "CompliancesByImos"
      */
     private String extractEndpointName(String externalPath) {
         if (externalPath == null || externalPath.isEmpty()) {
@@ -212,16 +173,6 @@ public class BypassConfigService {
                 .build();
     }
 
-    private BypassApiField toFieldEntity(BypassFieldDto dto) {
-        return BypassApiField.builder()
-                .fieldName(dto.getFieldName())
-                .jsonProperty(dto.getJsonProperty())
-                .fieldType(dto.getFieldType() != null ? dto.getFieldType() : "String")
-                .description(dto.getDescription())
-                .sortOrder(dto.getSortOrder() != null ? dto.getSortOrder() : 0)
-                .build();
-    }
-
     private BypassParamDto toParamDto(BypassApiParam param) {
         return BypassParamDto.builder()
                 .id(param.getId())
@@ -233,15 +184,4 @@ public class BypassConfigService {
                 .sortOrder(param.getSortOrder())
                 .build();
     }
-
-    private BypassFieldDto toFieldDto(BypassApiField field) {
-        return BypassFieldDto.builder()
-                .id(field.getId())
-                .fieldName(field.getFieldName())
-                .jsonProperty(field.getJsonProperty())
-                .fieldType(field.getFieldType())
-                .description(field.getDescription())
-                .sortOrder(field.getSortOrder())
-                .build();
-    }
 }
diff --git a/src/main/java/com/snp/batch/service/JsonSchemaParser.java b/src/main/java/com/snp/batch/service/JsonSchemaParser.java
deleted file mode 100644
index 57db339..0000000
--- a/src/main/java/com/snp/batch/service/JsonSchemaParser.java
+++ /dev/null
@@ -1,165 +0,0 @@
-package com.snp.batch.service;
-
-import com.fasterxml.jackson.databind.JsonNode;
-import com.fasterxml.jackson.databind.ObjectMapper;
-import com.snp.batch.global.dto.BypassFieldDto;
-import lombok.extern.slf4j.Slf4j;
-import org.springframework.stereotype.Service;
-
-import java.util.ArrayList;
-import java.util.List;
-
-/**
- * JSON 샘플 문자열에서 BypassFieldDto 목록을 추출하는 유틸리티 서비스.
- * 1단계 깊이만 파싱하며, 중첩 객체는 Object 타입으로 처리합니다.
- */
-@Slf4j
-@Service
-public class JsonSchemaParser {
-
-    private final ObjectMapper objectMapper;
-
-    public JsonSchemaParser(ObjectMapper objectMapper) {
-        this.objectMapper = objectMapper;
-    }
-
-    /**
-     * JSON 샘플 문자열에서 필드 목록을 추출합니다.
-     * 배열이면 첫 번째 요소를 파싱합니다.
-     * 1단계 깊이만 파싱하며, 중첩 객체는 Object 타입으로 처리합니다.
-     *
-     * @param jsonSample JSON 샘플 문자열
-     * @return 필드 목록 (파싱 실패 시 빈 목록 반환)
-     */
-    public List<BypassFieldDto> parse(String jsonSample) {
-        return parse(jsonSample, null);
-    }
-
-    /**
-     * JSON 샘플 문자열에서 필드 목록을 추출합니다.
-     * targetField가 지정된 경우 해당 필드 내부를 파싱 대상으로 사용합니다.
-     * 배열이면 첫 번째 요소를 파싱합니다.
-     *
-     * @param jsonSample  JSON 샘플 문자열
-     * @param targetField 파싱할 대상 필드명 (null이면 루트 파싱)
-     *                    예: "data" → root.data[0] 내부를 파싱
-     * @return 필드 목록 (파싱 실패 시 빈 목록 반환)
-     */
-    public List<BypassFieldDto> parse(String jsonSample, String targetField) {
-        List<BypassFieldDto> result = new ArrayList<>();
-        try {
-            JsonNode root = objectMapper.readTree(jsonSample);
-
-            // 배열이면 첫 번째 요소 추출
-            JsonNode target = root.isArray() ? root.get(0) : root;
-            if (target == null || !target.isObject()) {
-                log.warn("JSON 파싱: 유효한 객체를 찾을 수 없습니다.");
-                return result;
-            }
-
-            // targetField가 지정된 경우 해당 필드 내부를 파싱 대상으로 사용
-            if (targetField != null && !targetField.isEmpty()) {
-                JsonNode nested = target.get(targetField);
-                if (nested != null) {
-                    if (nested.isArray() && nested.size() > 0) {
-                        target = nested.get(0);
-                    } else if (nested.isObject()) {
-                        target = nested;
-                    } else {
-                        log.warn("JSON 파싱: targetField='{}' 가 객체나 배열이 아닙니다.", targetField);
-                        return result;
-                    }
-                    if (!target.isObject()) {
-                        log.warn("JSON 파싱: targetField='{}' 내부에서 유효한 객체를 찾을 수 없습니다.", targetField);
-                        return result;
-                    }
-                } else {
-                    log.warn("JSON 파싱: targetField='{}' 를 찾을 수 없습니다.", targetField);
-                    return result;
-                }
-            }
-
-            int sortOrder = 0;
-            var fields = target.fields();
-            while (fields.hasNext()) {
-                var entry = fields.next();
-                String originalKey = entry.getKey();
-                String fieldName = toCamelCase(originalKey);
-                String fieldType = inferType(entry.getValue(), fieldName);
-
-                // jsonProperty: fieldName과 원본 키가 다를 때만 설정
-                String jsonProperty = fieldName.equals(originalKey) ? null : originalKey;
-
-                result.add(BypassFieldDto.builder()
-                        .fieldName(fieldName)
-                        .jsonProperty(jsonProperty)
-                        .fieldType(fieldType)
-                        .sortOrder(sortOrder++)
-                        .build());
-            }
-        } catch (Exception e) {
-            log.error("JSON 샘플 파싱 실패: {}", e.getMessage(), e);
-            return new ArrayList<>();
-        }
-        return result;
-    }
-
-    /**
-     * PascalCase → camelCase 변환 헬퍼
-     */
-    private String toCamelCase(String name) {
-        if (name == null || name.isEmpty()) {
-            return name;
-        }
-        if (Character.isUpperCase(name.charAt(0))) {
-            return Character.toLowerCase(name.charAt(0)) + name.substring(1);
-        }
-        return name;
-    }
-
-    /**
-     * JsonNode에서 Java 타입 추론.
-     * 배열 내 첫 번째 요소가 ObjectNode인 경우 "{FieldName}Item" 타입으로 처리합니다.
-     *
-     * @param node      파싱할 노드
-     * @param fieldName 필드명 (배열 내 객체 타입명 생성에 사용)
-     */
-    private String inferType(JsonNode node, String fieldName) {
-        if (node.isTextual()) {
-            return "String";
-        }
-        if (node.isInt()) {
-            return "Integer";
-        }
-        if (node.isLong() || (node.isNumber() && node.longValue() > Integer.MAX_VALUE)) {
-            return "Long";
-        }
-        if (node.isDouble() || node.isFloat()) {
-            return "Double";
-        }
-        if (node.isBoolean()) {
-            return "Boolean";
-        }
-        if (node.isNull()) {
-            return "String";
-        }
-        if (node.isArray()) {
-            if (node.size() > 0 && node.get(0).isObject()) {
-                String itemTypeName = capitalize(fieldName) + "Item";
-                return "List<" + itemTypeName + ">";
-            }
-            return "List<Object>";
-        }
-        if (node.isObject()) {
-            return "Object";
-        }
-        return "String";
-    }
-
-    private String capitalize(String s) {
-        if (s == null || s.isEmpty()) {
-            return s;
-        }
-        return Character.toUpperCase(s.charAt(0)) + s.substring(1);
-    }
-}
-- 
2.45.2


From 39858bf4e3e8e065c9d341a08471c4e3be11f3dc Mon Sep 17 00:00:00 2001
From: HYOJIN <hjkim4@gcsc.co.kr>
Date: Fri, 27 Mar 2026 10:48:49 +0900
Subject: [PATCH 14/19] =?UTF-8?q?fix:=20BaseBypassService=EC=97=90=20fetch?=
 =?UTF-8?q?RawGet/fetchRawPost=20=EB=A9=94=EC=84=9C=EB=93=9C=20=EC=B6=94?=
 =?UTF-8?q?=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

RAW 모드 코드 생성에서 사용하는 JsonNode 반환 메서드가
BaseBypassService에 누락되어 빌드 오류 발생하는 문제 수정

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .../common/web/service/BaseBypassService.java | 30 +++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/src/main/java/com/snp/batch/common/web/service/BaseBypassService.java b/src/main/java/com/snp/batch/common/web/service/BaseBypassService.java
index 40fab88..fac1099 100644
--- a/src/main/java/com/snp/batch/common/web/service/BaseBypassService.java
+++ b/src/main/java/com/snp/batch/common/web/service/BaseBypassService.java
@@ -1,5 +1,6 @@
 package com.snp.batch.common.web.service;
 
+import com.fasterxml.jackson.databind.JsonNode;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.core.ParameterizedTypeReference;
 import org.springframework.web.reactive.function.BodyInserters;
@@ -91,6 +92,35 @@ public abstract class BaseBypassService<T> {
         return response;
     }
 
+    /**
+     * RAW GET 요청 → JsonNode 반환 (응답 구조 그대로 패스스루)
+     */
+    protected JsonNode fetchRawGet(Function<UriBuilder, URI> uriFunction) {
+        log.info("{} API GET 호출 (RAW)", displayName);
+        JsonNode response = webClient.get()
+                .uri(uriFunction)
+                .retrieve()
+                .bodyToMono(JsonNode.class)
+                .block();
+        log.info("{} API 응답 완료 (RAW)", displayName);
+        return response;
+    }
+
+    /**
+     * RAW POST 요청 → JsonNode 반환 (응답 구조 그대로 패스스루)
+     */
+    protected JsonNode fetchRawPost(Object body, Function<UriBuilder, URI> uriFunction) {
+        log.info("{} API POST 호출 (RAW)", displayName);
+        JsonNode response = webClient.post()
+                .uri(uriFunction)
+                .body(BodyInserters.fromValue(body))
+                .retrieve()
+                .bodyToMono(JsonNode.class)
+                .block();
+        log.info("{} API 응답 완료 (RAW)", displayName);
+        return response;
+    }
+
     protected String getApiPath() {
         return apiPath;
     }
-- 
2.45.2


From fed2d6455a89b6046b6a794971a189137fd43677 Mon Sep 17 00:00:00 2001
From: HYOJIN <hjkim4@gcsc.co.kr>
Date: Fri, 27 Mar 2026 11:07:28 +0900
Subject: [PATCH 15/19] =?UTF-8?q?refactor:=20Risk=20bypass=20=EC=88=98?=
 =?UTF-8?q?=EB=8F=99=20=EC=BD=94=EB=93=9C=20=EC=82=AD=EC=A0=9C=20(?=
 =?UTF-8?q?=ED=99=94=EB=A9=B4=EC=97=90=EC=84=9C=20=EC=9E=AC=EB=93=B1?=
 =?UTF-8?q?=EB=A1=9D)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

기존 수동 작성된 RiskController, RiskBypassService 삭제.
화면에서 RAW 모드로 재등록하여 코드 생성 예정.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .../controller/ComplianceController.java      | 81 +++++++++++++++++++
 .../ComplianceValuesMeaningService.java       | 31 +++++++
 .../service/CompliancesByImosService.java     | 32 ++++++++
 .../PagedUpdatedComplianceListService.java    | 35 ++++++++
 .../service/UpdatedComplianceListService.java | 33 ++++++++
 .../web/risk/controller/RiskController.java   | 41 ----------
 .../web/risk/service/RiskBypassService.java   | 37 ---------
 7 files changed, 212 insertions(+), 78 deletions(-)
 create mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/controller/ComplianceController.java
 create mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/service/ComplianceValuesMeaningService.java
 create mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/service/CompliancesByImosService.java
 create mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/service/PagedUpdatedComplianceListService.java
 create mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/service/UpdatedComplianceListService.java
 delete mode 100644 src/main/java/com/snp/batch/jobs/web/risk/controller/RiskController.java
 delete mode 100644 src/main/java/com/snp/batch/jobs/web/risk/service/RiskBypassService.java

diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/controller/ComplianceController.java b/src/main/java/com/snp/batch/jobs/web/compliance/controller/ComplianceController.java
new file mode 100644
index 0000000..34fa84d
--- /dev/null
+++ b/src/main/java/com/snp/batch/jobs/web/compliance/controller/ComplianceController.java
@@ -0,0 +1,81 @@
+package com.snp.batch.jobs.web.compliance.controller;
+
+import com.fasterxml.jackson.databind.JsonNode;
+import com.snp.batch.common.web.ApiResponse;
+import com.snp.batch.common.web.controller.BaseBypassController;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import com.snp.batch.jobs.web.compliance.service.CompliancesByImosService;
+import com.snp.batch.jobs.web.compliance.service.UpdatedComplianceListService;
+import com.snp.batch.jobs.web.compliance.service.ComplianceValuesMeaningService;
+import com.snp.batch.jobs.web.compliance.service.PagedUpdatedComplianceListService;
+
+/**
+ * Compliance bypass API
+ * S&P Maritime API에서 데이터를 실시간 조회하여 JSON을 그대로 반환
+ */
+@RestController
+@RequestMapping("/api/compliance")
+@RequiredArgsConstructor
+@Tag(name = "Compliance", description = "[Service API] Compliance bypass API")
+public class ComplianceController extends BaseBypassController {
+
+    private final CompliancesByImosService compliancesByImosService;
+    private final UpdatedComplianceListService updatedComplianceListService;
+    private final ComplianceValuesMeaningService complianceValuesMeaningService;
+    private final PagedUpdatedComplianceListService pagedUpdatedComplianceListService;
+
+    @Operation(
+            summary = "IMO 기반 Compliance 조회 조회",
+            description = "S&P API에서 IMO 기반 Compliance 조회 데이터를 요청하고 응답을 그대로 반환합니다."
+    )
+    @GetMapping("/CompliancesByImos")
+    public ResponseEntity<ApiResponse<JsonNode>> getCompliancesByImosData(@Parameter(description = "Comma separated IMOs up to a total of 100", example = "9876543")
+                @RequestParam(required = true) String imos) {
+        return execute(() -> compliancesByImosService.getCompliancesByImosData(imos));
+    }
+
+    @Operation(
+            summary = "기간 내 변경 Compliance 조회 조회",
+            description = "S&P API에서 기간 내 변경 Compliance 조회 데이터를 요청하고 응답을 그대로 반환합니다."
+    )
+    @GetMapping("/UpdatedComplianceList")
+    public ResponseEntity<ApiResponse<JsonNode>> getUpdatedComplianceListData(@Parameter(description = "Time/seconds are optional", example = "9876543")
+                @RequestParam(required = true) String fromDate,
+            @Parameter(description = "Time/seconds are optional. If unspecified, the current UTC date and time is used", example = "9876543")
+                @RequestParam(required = true) String toDate) {
+        return execute(() -> updatedComplianceListService.getUpdatedComplianceListData(fromDate, toDate));
+    }
+
+    @Operation(
+            summary = "모든 Compliance 지표 조회 조회",
+            description = "S&P API에서 모든 Compliance 지표 조회 데이터를 요청하고 응답을 그대로 반환합니다."
+    )
+    @GetMapping("/ComplianceValuesMeaning")
+    public ResponseEntity<ApiResponse<JsonNode>> getComplianceValuesMeaningData() {
+        return execute(() -> complianceValuesMeaningService.getComplianceValuesMeaningData());
+    }
+
+    @Operation(
+            summary = "PagedUpdatedComplianceList 조회",
+            description = "S&P API에서 PagedUpdatedComplianceList 데이터를 요청하고 응답을 그대로 반환합니다."
+    )
+    @GetMapping("/PagedUpdatedComplianceList")
+    public ResponseEntity<ApiResponse<JsonNode>> getPagedUpdatedComplianceListData(@Parameter(description = "Time/seconds are optional", example = "9876543")
+                @RequestParam(required = true) String fromDate,
+            @Parameter(description = "Time/seconds are optional. If unspecified, the current UTC date and time is used", example = "9876543")
+                @RequestParam(required = true) String toDate,
+            @Parameter(description = "Page number to display.", example = "9876543")
+                @RequestParam(required = true) String pageNumber,
+            @Parameter(description = "How many elements will be on the single page. Maximum allowed is 1000.", example = "9876543")
+                @RequestParam(required = true) String pageSize) {
+        return execute(() -> pagedUpdatedComplianceListService.getPagedUpdatedComplianceListData(fromDate, toDate, pageNumber, pageSize));
+    }
+}
diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/service/ComplianceValuesMeaningService.java b/src/main/java/com/snp/batch/jobs/web/compliance/service/ComplianceValuesMeaningService.java
new file mode 100644
index 0000000..8b92a73
--- /dev/null
+++ b/src/main/java/com/snp/batch/jobs/web/compliance/service/ComplianceValuesMeaningService.java
@@ -0,0 +1,31 @@
+package com.snp.batch.jobs.web.compliance.service;
+
+import com.fasterxml.jackson.databind.JsonNode;
+import com.snp.batch.common.web.service.BaseBypassService;
+import org.springframework.beans.factory.annotation.Qualifier;
+import org.springframework.core.ParameterizedTypeReference;
+import org.springframework.stereotype.Service;
+import org.springframework.web.reactive.function.client.WebClient;
+
+/**
+ * 모든 Compliance 지표 조회 bypass 서비스
+ * 외부 Maritime API에서 데이터를 실시간 조회하여 JSON을 그대로 반환
+ */
+@Service
+public class ComplianceValuesMeaningService extends BaseBypassService<JsonNode> {
+
+    public ComplianceValuesMeaningService(
+            @Qualifier("maritimeServiceApiWebClient") WebClient webClient) {
+        super(webClient, "/RiskAndCompliance/ComplianceValuesMeaning", "모든 Compliance 지표 조회",
+                new ParameterizedTypeReference<>() {},
+                new ParameterizedTypeReference<>() {});
+    }
+
+    /**
+     * 모든 Compliance 지표 조회 데이터를 조회합니다.
+     */
+    public JsonNode getComplianceValuesMeaningData() {
+        return fetchRawGet(uri -> uri.path(getApiPath())
+                        .build());
+    }
+}
diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/service/CompliancesByImosService.java b/src/main/java/com/snp/batch/jobs/web/compliance/service/CompliancesByImosService.java
new file mode 100644
index 0000000..56ac002
--- /dev/null
+++ b/src/main/java/com/snp/batch/jobs/web/compliance/service/CompliancesByImosService.java
@@ -0,0 +1,32 @@
+package com.snp.batch.jobs.web.compliance.service;
+
+import com.fasterxml.jackson.databind.JsonNode;
+import com.snp.batch.common.web.service.BaseBypassService;
+import org.springframework.beans.factory.annotation.Qualifier;
+import org.springframework.core.ParameterizedTypeReference;
+import org.springframework.stereotype.Service;
+import org.springframework.web.reactive.function.client.WebClient;
+
+/**
+ * IMO 기반 Compliance 조회 bypass 서비스
+ * 외부 Maritime API에서 데이터를 실시간 조회하여 JSON을 그대로 반환
+ */
+@Service
+public class CompliancesByImosService extends BaseBypassService<JsonNode> {
+
+    public CompliancesByImosService(
+            @Qualifier("maritimeServiceApiWebClient") WebClient webClient) {
+        super(webClient, "/RiskAndCompliance/CompliancesByImos", "IMO 기반 Compliance 조회",
+                new ParameterizedTypeReference<>() {},
+                new ParameterizedTypeReference<>() {});
+    }
+
+    /**
+     * IMO 기반 Compliance 조회 데이터를 조회합니다.
+     */
+    public JsonNode getCompliancesByImosData(String imos) {
+        return fetchRawGet(uri -> uri.path(getApiPath())
+                        .queryParam("imos", imos)
+                        .build());
+    }
+}
diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/service/PagedUpdatedComplianceListService.java b/src/main/java/com/snp/batch/jobs/web/compliance/service/PagedUpdatedComplianceListService.java
new file mode 100644
index 0000000..092661f
--- /dev/null
+++ b/src/main/java/com/snp/batch/jobs/web/compliance/service/PagedUpdatedComplianceListService.java
@@ -0,0 +1,35 @@
+package com.snp.batch.jobs.web.compliance.service;
+
+import com.fasterxml.jackson.databind.JsonNode;
+import com.snp.batch.common.web.service.BaseBypassService;
+import org.springframework.beans.factory.annotation.Qualifier;
+import org.springframework.core.ParameterizedTypeReference;
+import org.springframework.stereotype.Service;
+import org.springframework.web.reactive.function.client.WebClient;
+
+/**
+ * PagedUpdatedComplianceList bypass 서비스
+ * 외부 Maritime API에서 데이터를 실시간 조회하여 JSON을 그대로 반환
+ */
+@Service
+public class PagedUpdatedComplianceListService extends BaseBypassService<JsonNode> {
+
+    public PagedUpdatedComplianceListService(
+            @Qualifier("maritimeServiceApiWebClient") WebClient webClient) {
+        super(webClient, "/RiskAndCompliance/PagedUpdatedComplianceList", "PagedUpdatedComplianceList",
+                new ParameterizedTypeReference<>() {},
+                new ParameterizedTypeReference<>() {});
+    }
+
+    /**
+     * PagedUpdatedComplianceList 데이터를 조회합니다.
+     */
+    public JsonNode getPagedUpdatedComplianceListData(String fromDate, String toDate, String pageNumber, String pageSize) {
+        return fetchRawGet(uri -> uri.path(getApiPath())
+                        .queryParam("fromDate", fromDate)
+                        .queryParam("toDate", toDate)
+                        .queryParam("pageNumber", pageNumber)
+                        .queryParam("pageSize", pageSize)
+                        .build());
+    }
+}
diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/service/UpdatedComplianceListService.java b/src/main/java/com/snp/batch/jobs/web/compliance/service/UpdatedComplianceListService.java
new file mode 100644
index 0000000..970a56f
--- /dev/null
+++ b/src/main/java/com/snp/batch/jobs/web/compliance/service/UpdatedComplianceListService.java
@@ -0,0 +1,33 @@
+package com.snp.batch.jobs.web.compliance.service;
+
+import com.fasterxml.jackson.databind.JsonNode;
+import com.snp.batch.common.web.service.BaseBypassService;
+import org.springframework.beans.factory.annotation.Qualifier;
+import org.springframework.core.ParameterizedTypeReference;
+import org.springframework.stereotype.Service;
+import org.springframework.web.reactive.function.client.WebClient;
+
+/**
+ * 기간 내 변경 Compliance 조회 bypass 서비스
+ * 외부 Maritime API에서 데이터를 실시간 조회하여 JSON을 그대로 반환
+ */
+@Service
+public class UpdatedComplianceListService extends BaseBypassService<JsonNode> {
+
+    public UpdatedComplianceListService(
+            @Qualifier("maritimeServiceApiWebClient") WebClient webClient) {
+        super(webClient, "/RiskAndCompliance/UpdatedComplianceList", "기간 내 변경 Compliance 조회",
+                new ParameterizedTypeReference<>() {},
+                new ParameterizedTypeReference<>() {});
+    }
+
+    /**
+     * 기간 내 변경 Compliance 조회 데이터를 조회합니다.
+     */
+    public JsonNode getUpdatedComplianceListData(String fromDate, String toDate) {
+        return fetchRawGet(uri -> uri.path(getApiPath())
+                        .queryParam("fromDate", fromDate)
+                        .queryParam("toDate", toDate)
+                        .build());
+    }
+}
diff --git a/src/main/java/com/snp/batch/jobs/web/risk/controller/RiskController.java b/src/main/java/com/snp/batch/jobs/web/risk/controller/RiskController.java
deleted file mode 100644
index 2e96d20..0000000
--- a/src/main/java/com/snp/batch/jobs/web/risk/controller/RiskController.java
+++ /dev/null
@@ -1,41 +0,0 @@
-package com.snp.batch.jobs.web.risk.controller;
-
-import com.snp.batch.common.web.ApiResponse;
-import com.snp.batch.common.web.controller.BaseBypassController;
-import com.snp.batch.jobs.batch.risk.dto.RiskDto;
-import com.snp.batch.jobs.web.risk.service.RiskBypassService;
-import io.swagger.v3.oas.annotations.Operation;
-import io.swagger.v3.oas.annotations.Parameter;
-import io.swagger.v3.oas.annotations.tags.Tag;
-import lombok.RequiredArgsConstructor;
-import org.springframework.http.ResponseEntity;
-import org.springframework.web.bind.annotation.GetMapping;
-import org.springframework.web.bind.annotation.PathVariable;
-import org.springframework.web.bind.annotation.RequestMapping;
-import org.springframework.web.bind.annotation.RestController;
-
-import java.util.List;
-
-/**
- * Risk 상세 조회 bypass API
- * S&P Maritime API에서 Risk 데이터를 실시간 조회하여 그대로 반환
- */
-@RestController
-@RequestMapping("/api/risk")
-@RequiredArgsConstructor
-@Tag(name = "Risk", description = "[Service API] 선박 Risk 상세 정보 bypass API")
-public class RiskController extends BaseBypassController {
-
-    private final RiskBypassService riskBypassService;
-
-    @Operation(
-            summary = "IMO 기반 Risk 상세 조회",
-            description = "S&P API에 IMO 번호로 Risk 상세 데이터를 요청하고 응답을 그대로 반환합니다."
-    )
-    @GetMapping("/{imo}")
-    public ResponseEntity<ApiResponse<List<RiskDto>>> getRiskDetailByImo(
-            @Parameter(description = "IMO 번호", example = "9321483")
-            @PathVariable String imo) {
-        return execute(() -> riskBypassService.getRiskDetailByImo(imo));
-    }
-}
diff --git a/src/main/java/com/snp/batch/jobs/web/risk/service/RiskBypassService.java b/src/main/java/com/snp/batch/jobs/web/risk/service/RiskBypassService.java
deleted file mode 100644
index f20421d..0000000
--- a/src/main/java/com/snp/batch/jobs/web/risk/service/RiskBypassService.java
+++ /dev/null
@@ -1,37 +0,0 @@
-package com.snp.batch.jobs.web.risk.service;
-
-import com.snp.batch.common.web.service.BaseBypassService;
-import com.snp.batch.jobs.batch.risk.dto.RiskDto;
-import org.springframework.beans.factory.annotation.Qualifier;
-import org.springframework.core.ParameterizedTypeReference;
-import org.springframework.stereotype.Service;
-import org.springframework.web.reactive.function.client.WebClient;
-
-import java.util.List;
-
-/**
- * S&P Risk API bypass 서비스
- * 외부 Maritime API에서 Risk 상세 데이터를 실시간 조회하여 그대로 반환
- */
-@Service
-public class RiskBypassService extends BaseBypassService<RiskDto> {
-
-    public RiskBypassService(
-            @Qualifier("maritimeServiceApiWebClient") WebClient webClient) {
-        super(webClient, "/RiskAndCompliance/RisksByImos", "S&P Risk",
-                new ParameterizedTypeReference<>() {},
-                new ParameterizedTypeReference<>() {});
-    }
-
-    /**
-     * IMO 번호로 S&P Risk 상세 데이터를 조회합니다.
-     *
-     * @param imo IMO 번호
-     * @return Risk 상세 데이터 목록
-     */
-    public List<RiskDto> getRiskDetailByImo(String imo) {
-        return fetchGetList(uri -> uri.path(getApiPath())
-                .queryParam("imos", imo)
-                .build());
-    }
-}
-- 
2.45.2


From e6e58bfc251aa352f770466a35c6b0ab13e97aef Mon Sep 17 00:00:00 2001
From: HYOJIN <hjkim4@gcsc.co.kr>
Date: Fri, 27 Mar 2026 11:20:37 +0900
Subject: [PATCH 16/19] =?UTF-8?q?feat:=20Bypass=20API=20=ED=99=94=EB=A9=B4?=
 =?UTF-8?q?=20=EA=B0=9C=EC=84=A0=20=EB=B0=8F=20SPA=20=EC=83=88=EB=A1=9C?=
 =?UTF-8?q?=EA=B3=A0=EC=B9=A8=20=EC=98=A4=EB=A5=98=20=EC=88=98=EC=A0=95=20?=
 =?UTF-8?q?(#63)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- WebClient Bean 드롭다운 표시 텍스트를 description만 표시
- bypass_api_param에 example 컬럼 추가 (Swagger placeholder 사용자 설정)
- 목록 기본 뷰를 리스트뷰(테이블)로 변경
- 도메인명 드롭다운 필터 추가
- WebViewController에 /bypass-config 경로 추가 (SPA 새로고침 404 해결)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 frontend/src/api/bypassApi.ts                 |  1 +
 .../src/components/bypass/BypassStepBasic.tsx |  2 +-
 .../components/bypass/BypassStepParams.tsx    | 11 ++++++
 frontend/src/pages/BypassConfig.tsx           | 39 ++++++++++++++-----
 .../global/controller/WebViewController.java  |  4 +-
 .../snp/batch/global/dto/BypassParamDto.java  |  3 ++
 .../batch/global/model/BypassApiParam.java    |  6 +++
 .../batch/service/BypassCodeGenerator.java    |  4 +-
 .../batch/service/BypassConfigService.java    |  2 +
 9 files changed, 59 insertions(+), 13 deletions(-)

diff --git a/frontend/src/api/bypassApi.ts b/frontend/src/api/bypassApi.ts
index 046258c..abdcab7 100644
--- a/frontend/src/api/bypassApi.ts
+++ b/frontend/src/api/bypassApi.ts
@@ -14,6 +14,7 @@ export interface BypassParamDto {
     paramIn: string;      // PATH, QUERY, BODY
     required: boolean;
     description: string;
+    example: string;      // Swagger @Parameter example 값
     sortOrder: number;
 }
 
diff --git a/frontend/src/components/bypass/BypassStepBasic.tsx b/frontend/src/components/bypass/BypassStepBasic.tsx
index e5b3ea2..5056b07 100644
--- a/frontend/src/components/bypass/BypassStepBasic.tsx
+++ b/frontend/src/components/bypass/BypassStepBasic.tsx
@@ -79,7 +79,7 @@ export default function BypassStepBasic({
                         <option value="">선택하세요</option>
                         {webclientBeans.map((bean) => (
                             <option key={bean.name} value={bean.name}>
-                                {bean.name}{bean.description ? ` — ${bean.description}` : ''}
+                                {bean.description || bean.name}
                             </option>
                         ))}
                     </select>
diff --git a/frontend/src/components/bypass/BypassStepParams.tsx b/frontend/src/components/bypass/BypassStepParams.tsx
index 6f0cf02..cd767e1 100644
--- a/frontend/src/components/bypass/BypassStepParams.tsx
+++ b/frontend/src/components/bypass/BypassStepParams.tsx
@@ -15,6 +15,7 @@ function createEmptyParam(sortOrder: number): BypassParamDto {
         paramIn: 'QUERY',
         required: false,
         description: '',
+        example: '',
         sortOrder,
     };
 }
@@ -58,6 +59,7 @@ export default function BypassStepParams({ params, onChange }: BypassStepParamsP
                                 <th className="pb-2 text-left font-medium text-wing-muted pr-3 min-w-[100px]">위치</th>
                                 <th className="pb-2 text-center font-medium text-wing-muted pr-3 w-14">필수</th>
                                 <th className="pb-2 text-left font-medium text-wing-muted pr-3">설명</th>
+                                <th className="pb-2 text-left font-medium text-wing-muted pr-3 min-w-[120px]">Example</th>
                                 <th className="pb-2 w-10"></th>
                             </tr>
                         </thead>
@@ -112,6 +114,15 @@ export default function BypassStepParams({ params, onChange }: BypassStepParamsP
                                             className="w-full px-2 py-1.5 text-sm rounded border border-wing-border bg-wing-surface text-wing-text placeholder:text-wing-muted focus:outline-none focus:ring-1 focus:ring-wing-accent/50"
                                         />
                                     </td>
+                                    <td className="py-2 pr-3">
+                                        <input
+                                            type="text"
+                                            value={param.example}
+                                            onChange={(e) => handleChange(index, 'example', e.target.value)}
+                                            placeholder="예: 9876543"
+                                            className="w-full px-2 py-1.5 text-sm rounded border border-wing-border bg-wing-surface text-wing-text placeholder:text-wing-muted focus:outline-none focus:ring-1 focus:ring-wing-accent/50"
+                                        />
+                                    </td>
                                     <td className="py-2">
                                         <button
                                             type="button"
diff --git a/frontend/src/pages/BypassConfig.tsx b/frontend/src/pages/BypassConfig.tsx
index b0ddc60..a1ea498 100644
--- a/frontend/src/pages/BypassConfig.tsx
+++ b/frontend/src/pages/BypassConfig.tsx
@@ -32,8 +32,9 @@ export default function BypassConfig() {
     const [configs, setConfigs] = useState<BypassConfigResponse[]>([]);
     const [loading, setLoading] = useState(true);
     const [webclientBeans, setWebclientBeans] = useState<WebClientBeanInfo[]>([]);
-    const [viewMode, setViewMode] = useState<ViewMode>('card');
+    const [viewMode, setViewMode] = useState<ViewMode>('table');
     const [searchTerm, setSearchTerm] = useState('');
+    const [selectedDomain, setSelectedDomain] = useState('');
 
     const [modalOpen, setModalOpen] = useState(false);
     const [editConfig, setEditConfig] = useState<BypassConfigResponse | null>(null);
@@ -110,15 +111,21 @@ export default function BypassConfig() {
         }
     };
 
+    const domainNames = useMemo(() => {
+        const names = [...new Set(configs.map((c) => c.domainName))];
+        return names.sort();
+    }, [configs]);
+
     const filteredConfigs = useMemo(() => {
-        if (!searchTerm.trim()) return configs;
-        const term = searchTerm.toLowerCase();
-        return configs.filter(
-            (c) =>
-                c.domainName.toLowerCase().includes(term) ||
-                c.displayName.toLowerCase().includes(term),
-        );
-    }, [configs, searchTerm]);
+        return configs.filter((c) => {
+            const matchesSearch =
+                !searchTerm.trim() ||
+                c.domainName.toLowerCase().includes(searchTerm.toLowerCase()) ||
+                c.displayName.toLowerCase().includes(searchTerm.toLowerCase());
+            const matchesDomain = !selectedDomain || c.domainName === selectedDomain;
+            return matchesSearch && matchesDomain;
+        });
+    }, [configs, searchTerm, selectedDomain]);
 
     if (loading) return <LoadingSpinner />;
 
@@ -177,6 +184,18 @@ export default function BypassConfig() {
                         )}
                     </div>
 
+                    {/* 도메인 드롭다운 필터 */}
+                    <select
+                        value={selectedDomain}
+                        onChange={(e) => setSelectedDomain(e.target.value)}
+                        className="px-3 py-2 text-sm rounded-lg border border-wing-border bg-wing-surface text-wing-text"
+                    >
+                        <option value="">전체 도메인</option>
+                        {domainNames.map((name) => (
+                            <option key={name} value={name}>{name}</option>
+                        ))}
+                    </select>
+
                     {/* 뷰 전환 토글 */}
                     <div className="flex rounded-lg border border-wing-border overflow-hidden">
                         <button
@@ -215,7 +234,7 @@ export default function BypassConfig() {
                     </div>
                 </div>
 
-                {searchTerm && (
+                {(searchTerm || selectedDomain) && (
                     <p className="mt-2 text-xs text-wing-muted">
                         {filteredConfigs.length}개 API 검색됨
                     </p>
diff --git a/src/main/java/com/snp/batch/global/controller/WebViewController.java b/src/main/java/com/snp/batch/global/controller/WebViewController.java
index 1c120c1..916a4ab 100644
--- a/src/main/java/com/snp/batch/global/controller/WebViewController.java
+++ b/src/main/java/com/snp/batch/global/controller/WebViewController.java
@@ -15,8 +15,10 @@ public class WebViewController {
     @GetMapping({"/", "/jobs", "/executions", "/executions/{id:\\d+}",
                  "/recollects", "/recollects/{id:\\d+}",
                  "/schedules", "/schedule-timeline", "/monitoring",
+                 "/bypass-config",
                  "/jobs/**", "/executions/**", "/recollects/**",
-                 "/schedules/**", "/schedule-timeline/**", "/monitoring/**"})
+                 "/schedules/**", "/schedule-timeline/**", "/monitoring/**",
+                 "/bypass-config/**"})
     public String forward() {
         return "forward:/index.html";
     }
diff --git a/src/main/java/com/snp/batch/global/dto/BypassParamDto.java b/src/main/java/com/snp/batch/global/dto/BypassParamDto.java
index 38571bd..0885d12 100644
--- a/src/main/java/com/snp/batch/global/dto/BypassParamDto.java
+++ b/src/main/java/com/snp/batch/global/dto/BypassParamDto.java
@@ -33,4 +33,7 @@ public class BypassParamDto {
 
     /** 정렬 순서 */
     private Integer sortOrder;
+
+    /** Swagger @Parameter example 값 */
+    private String example;
 }
diff --git a/src/main/java/com/snp/batch/global/model/BypassApiParam.java b/src/main/java/com/snp/batch/global/model/BypassApiParam.java
index a55e662..a86288c 100644
--- a/src/main/java/com/snp/batch/global/model/BypassApiParam.java
+++ b/src/main/java/com/snp/batch/global/model/BypassApiParam.java
@@ -74,4 +74,10 @@ public class BypassApiParam {
     @Column(name = "sort_order", nullable = false)
     @Builder.Default
     private Integer sortOrder = 0;
+
+    /**
+     * Swagger @Parameter example 값
+     */
+    @Column(name = "example", length = 200)
+    private String example;
 }
diff --git a/src/main/java/com/snp/batch/service/BypassCodeGenerator.java b/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
index 31ded63..6d4d447 100644
--- a/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
+++ b/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
@@ -283,7 +283,9 @@ public class BypassCodeGenerator {
                     String description = p.getDescription() != null ? p.getDescription() : p.getParamName();
                     String javaType = toJavaType(p.getParamType());
                     String paramName = p.getParamName();
-                    String example = getDefaultExample(p.getParamType());
+                    String example = (p.getExample() != null && !p.getExample().isEmpty())
+                            ? p.getExample()
+                            : getDefaultExample(p.getParamType());
                     return switch (p.getParamIn().toUpperCase()) {
                         case "PATH" -> "@Parameter(description = \"" + description + "\", example = \"" + example + "\")\n"
                                 + "                @PathVariable " + javaType + " " + paramName;
diff --git a/src/main/java/com/snp/batch/service/BypassConfigService.java b/src/main/java/com/snp/batch/service/BypassConfigService.java
index cb40d29..5e4c0d7 100644
--- a/src/main/java/com/snp/batch/service/BypassConfigService.java
+++ b/src/main/java/com/snp/batch/service/BypassConfigService.java
@@ -170,6 +170,7 @@ public class BypassConfigService {
                 .required(dto.getRequired() != null ? dto.getRequired() : true)
                 .description(dto.getDescription())
                 .sortOrder(dto.getSortOrder() != null ? dto.getSortOrder() : 0)
+                .example(dto.getExample())
                 .build();
     }
 
@@ -182,6 +183,7 @@ public class BypassConfigService {
                 .required(param.getRequired())
                 .description(param.getDescription())
                 .sortOrder(param.getSortOrder())
+                .example(param.getExample())
                 .build();
     }
 }
-- 
2.45.2


From 6b3ef513a74654435b51516831f9f653a41b0e2d Mon Sep 17 00:00:00 2001
From: HYOJIN <hjkim4@gcsc.co.kr>
Date: Fri, 27 Mar 2026 13:02:31 +0900
Subject: [PATCH 17/19] =?UTF-8?q?feat:=20Swagger=20@Operation=20descriptio?=
 =?UTF-8?q?n=EC=9D=84=20=EB=93=B1=EB=A1=9D=20=EB=AA=A8=EB=8B=AC=20?=
 =?UTF-8?q?=EC=84=A4=EB=AA=85=EC=9C=BC=EB=A1=9C=20=EC=83=9D=EC=84=B1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

코드 생성 시 @Operation description에 하드코딩 문구 대신
사용자가 API 등록 시 입력한 설명(description)을 사용

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .../java/com/snp/batch/service/BypassCodeGenerator.java     | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/src/main/java/com/snp/batch/service/BypassCodeGenerator.java b/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
index 6d4d447..5c68f41 100644
--- a/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
+++ b/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
@@ -201,8 +201,10 @@ public class BypassCodeGenerator {
             methods.append("\n");
             methods.append("    @Operation(\n");
             methods.append("            summary = \"").append(config.getDisplayName()).append(" 조회\",\n");
-            methods.append("            description = \"S&P API에서 ").append(config.getDisplayName())
-                    .append(" 데이터를 요청하고 응답을 그대로 반환합니다.\"\n");
+            String opDescription = (config.getDescription() != null && !config.getDescription().isEmpty())
+                    ? config.getDescription()
+                    : config.getDisplayName() + " 데이터를 요청하고 응답을 그대로 반환합니다.";
+            methods.append("            description = \"").append(opDescription).append("\"\n");
             methods.append("    )\n");
             methods.append("    ").append(mappingAnnotation).append(mappingPath).append("\n");
             methods.append("    public ResponseEntity<ApiResponse<JsonNode>> ").append(methodName).append("(");
-- 
2.45.2


From ea60e3a2be7840cade8ffc430b4de6a8dabc284c Mon Sep 17 00:00:00 2001
From: HYOJIN <hjkim4@gcsc.co.kr>
Date: Fri, 27 Mar 2026 13:10:39 +0900
Subject: [PATCH 18/19] =?UTF-8?q?fix:=20Swagger=20summary=EC=97=90?=
 =?UTF-8?q?=EC=84=9C=20'=EC=A1=B0=ED=9A=8C'=20=EC=A0=91=EB=AF=B8=EC=82=AC?=
 =?UTF-8?q?=20=EC=A0=9C=EA=B1=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .../controller/ComplianceController.java      | 81 -------------------
 .../ComplianceValuesMeaningService.java       | 31 -------
 .../service/CompliancesByImosService.java     | 32 --------
 .../PagedUpdatedComplianceListService.java    | 35 --------
 .../service/UpdatedComplianceListService.java | 33 --------
 .../batch/service/BypassCodeGenerator.java    |  2 +-
 6 files changed, 1 insertion(+), 213 deletions(-)
 delete mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/controller/ComplianceController.java
 delete mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/service/ComplianceValuesMeaningService.java
 delete mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/service/CompliancesByImosService.java
 delete mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/service/PagedUpdatedComplianceListService.java
 delete mode 100644 src/main/java/com/snp/batch/jobs/web/compliance/service/UpdatedComplianceListService.java

diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/controller/ComplianceController.java b/src/main/java/com/snp/batch/jobs/web/compliance/controller/ComplianceController.java
deleted file mode 100644
index 34fa84d..0000000
--- a/src/main/java/com/snp/batch/jobs/web/compliance/controller/ComplianceController.java
+++ /dev/null
@@ -1,81 +0,0 @@
-package com.snp.batch.jobs.web.compliance.controller;
-
-import com.fasterxml.jackson.databind.JsonNode;
-import com.snp.batch.common.web.ApiResponse;
-import com.snp.batch.common.web.controller.BaseBypassController;
-import io.swagger.v3.oas.annotations.Operation;
-import io.swagger.v3.oas.annotations.Parameter;
-import io.swagger.v3.oas.annotations.tags.Tag;
-import lombok.RequiredArgsConstructor;
-import org.springframework.http.ResponseEntity;
-import org.springframework.web.bind.annotation.RequestMapping;
-import org.springframework.web.bind.annotation.RestController;
-import org.springframework.web.bind.annotation.GetMapping;
-import org.springframework.web.bind.annotation.RequestParam;
-import com.snp.batch.jobs.web.compliance.service.CompliancesByImosService;
-import com.snp.batch.jobs.web.compliance.service.UpdatedComplianceListService;
-import com.snp.batch.jobs.web.compliance.service.ComplianceValuesMeaningService;
-import com.snp.batch.jobs.web.compliance.service.PagedUpdatedComplianceListService;
-
-/**
- * Compliance bypass API
- * S&P Maritime API에서 데이터를 실시간 조회하여 JSON을 그대로 반환
- */
-@RestController
-@RequestMapping("/api/compliance")
-@RequiredArgsConstructor
-@Tag(name = "Compliance", description = "[Service API] Compliance bypass API")
-public class ComplianceController extends BaseBypassController {
-
-    private final CompliancesByImosService compliancesByImosService;
-    private final UpdatedComplianceListService updatedComplianceListService;
-    private final ComplianceValuesMeaningService complianceValuesMeaningService;
-    private final PagedUpdatedComplianceListService pagedUpdatedComplianceListService;
-
-    @Operation(
-            summary = "IMO 기반 Compliance 조회 조회",
-            description = "S&P API에서 IMO 기반 Compliance 조회 데이터를 요청하고 응답을 그대로 반환합니다."
-    )
-    @GetMapping("/CompliancesByImos")
-    public ResponseEntity<ApiResponse<JsonNode>> getCompliancesByImosData(@Parameter(description = "Comma separated IMOs up to a total of 100", example = "9876543")
-                @RequestParam(required = true) String imos) {
-        return execute(() -> compliancesByImosService.getCompliancesByImosData(imos));
-    }
-
-    @Operation(
-            summary = "기간 내 변경 Compliance 조회 조회",
-            description = "S&P API에서 기간 내 변경 Compliance 조회 데이터를 요청하고 응답을 그대로 반환합니다."
-    )
-    @GetMapping("/UpdatedComplianceList")
-    public ResponseEntity<ApiResponse<JsonNode>> getUpdatedComplianceListData(@Parameter(description = "Time/seconds are optional", example = "9876543")
-                @RequestParam(required = true) String fromDate,
-            @Parameter(description = "Time/seconds are optional. If unspecified, the current UTC date and time is used", example = "9876543")
-                @RequestParam(required = true) String toDate) {
-        return execute(() -> updatedComplianceListService.getUpdatedComplianceListData(fromDate, toDate));
-    }
-
-    @Operation(
-            summary = "모든 Compliance 지표 조회 조회",
-            description = "S&P API에서 모든 Compliance 지표 조회 데이터를 요청하고 응답을 그대로 반환합니다."
-    )
-    @GetMapping("/ComplianceValuesMeaning")
-    public ResponseEntity<ApiResponse<JsonNode>> getComplianceValuesMeaningData() {
-        return execute(() -> complianceValuesMeaningService.getComplianceValuesMeaningData());
-    }
-
-    @Operation(
-            summary = "PagedUpdatedComplianceList 조회",
-            description = "S&P API에서 PagedUpdatedComplianceList 데이터를 요청하고 응답을 그대로 반환합니다."
-    )
-    @GetMapping("/PagedUpdatedComplianceList")
-    public ResponseEntity<ApiResponse<JsonNode>> getPagedUpdatedComplianceListData(@Parameter(description = "Time/seconds are optional", example = "9876543")
-                @RequestParam(required = true) String fromDate,
-            @Parameter(description = "Time/seconds are optional. If unspecified, the current UTC date and time is used", example = "9876543")
-                @RequestParam(required = true) String toDate,
-            @Parameter(description = "Page number to display.", example = "9876543")
-                @RequestParam(required = true) String pageNumber,
-            @Parameter(description = "How many elements will be on the single page. Maximum allowed is 1000.", example = "9876543")
-                @RequestParam(required = true) String pageSize) {
-        return execute(() -> pagedUpdatedComplianceListService.getPagedUpdatedComplianceListData(fromDate, toDate, pageNumber, pageSize));
-    }
-}
diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/service/ComplianceValuesMeaningService.java b/src/main/java/com/snp/batch/jobs/web/compliance/service/ComplianceValuesMeaningService.java
deleted file mode 100644
index 8b92a73..0000000
--- a/src/main/java/com/snp/batch/jobs/web/compliance/service/ComplianceValuesMeaningService.java
+++ /dev/null
@@ -1,31 +0,0 @@
-package com.snp.batch.jobs.web.compliance.service;
-
-import com.fasterxml.jackson.databind.JsonNode;
-import com.snp.batch.common.web.service.BaseBypassService;
-import org.springframework.beans.factory.annotation.Qualifier;
-import org.springframework.core.ParameterizedTypeReference;
-import org.springframework.stereotype.Service;
-import org.springframework.web.reactive.function.client.WebClient;
-
-/**
- * 모든 Compliance 지표 조회 bypass 서비스
- * 외부 Maritime API에서 데이터를 실시간 조회하여 JSON을 그대로 반환
- */
-@Service
-public class ComplianceValuesMeaningService extends BaseBypassService<JsonNode> {
-
-    public ComplianceValuesMeaningService(
-            @Qualifier("maritimeServiceApiWebClient") WebClient webClient) {
-        super(webClient, "/RiskAndCompliance/ComplianceValuesMeaning", "모든 Compliance 지표 조회",
-                new ParameterizedTypeReference<>() {},
-                new ParameterizedTypeReference<>() {});
-    }
-
-    /**
-     * 모든 Compliance 지표 조회 데이터를 조회합니다.
-     */
-    public JsonNode getComplianceValuesMeaningData() {
-        return fetchRawGet(uri -> uri.path(getApiPath())
-                        .build());
-    }
-}
diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/service/CompliancesByImosService.java b/src/main/java/com/snp/batch/jobs/web/compliance/service/CompliancesByImosService.java
deleted file mode 100644
index 56ac002..0000000
--- a/src/main/java/com/snp/batch/jobs/web/compliance/service/CompliancesByImosService.java
+++ /dev/null
@@ -1,32 +0,0 @@
-package com.snp.batch.jobs.web.compliance.service;
-
-import com.fasterxml.jackson.databind.JsonNode;
-import com.snp.batch.common.web.service.BaseBypassService;
-import org.springframework.beans.factory.annotation.Qualifier;
-import org.springframework.core.ParameterizedTypeReference;
-import org.springframework.stereotype.Service;
-import org.springframework.web.reactive.function.client.WebClient;
-
-/**
- * IMO 기반 Compliance 조회 bypass 서비스
- * 외부 Maritime API에서 데이터를 실시간 조회하여 JSON을 그대로 반환
- */
-@Service
-public class CompliancesByImosService extends BaseBypassService<JsonNode> {
-
-    public CompliancesByImosService(
-            @Qualifier("maritimeServiceApiWebClient") WebClient webClient) {
-        super(webClient, "/RiskAndCompliance/CompliancesByImos", "IMO 기반 Compliance 조회",
-                new ParameterizedTypeReference<>() {},
-                new ParameterizedTypeReference<>() {});
-    }
-
-    /**
-     * IMO 기반 Compliance 조회 데이터를 조회합니다.
-     */
-    public JsonNode getCompliancesByImosData(String imos) {
-        return fetchRawGet(uri -> uri.path(getApiPath())
-                        .queryParam("imos", imos)
-                        .build());
-    }
-}
diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/service/PagedUpdatedComplianceListService.java b/src/main/java/com/snp/batch/jobs/web/compliance/service/PagedUpdatedComplianceListService.java
deleted file mode 100644
index 092661f..0000000
--- a/src/main/java/com/snp/batch/jobs/web/compliance/service/PagedUpdatedComplianceListService.java
+++ /dev/null
@@ -1,35 +0,0 @@
-package com.snp.batch.jobs.web.compliance.service;
-
-import com.fasterxml.jackson.databind.JsonNode;
-import com.snp.batch.common.web.service.BaseBypassService;
-import org.springframework.beans.factory.annotation.Qualifier;
-import org.springframework.core.ParameterizedTypeReference;
-import org.springframework.stereotype.Service;
-import org.springframework.web.reactive.function.client.WebClient;
-
-/**
- * PagedUpdatedComplianceList bypass 서비스
- * 외부 Maritime API에서 데이터를 실시간 조회하여 JSON을 그대로 반환
- */
-@Service
-public class PagedUpdatedComplianceListService extends BaseBypassService<JsonNode> {
-
-    public PagedUpdatedComplianceListService(
-            @Qualifier("maritimeServiceApiWebClient") WebClient webClient) {
-        super(webClient, "/RiskAndCompliance/PagedUpdatedComplianceList", "PagedUpdatedComplianceList",
-                new ParameterizedTypeReference<>() {},
-                new ParameterizedTypeReference<>() {});
-    }
-
-    /**
-     * PagedUpdatedComplianceList 데이터를 조회합니다.
-     */
-    public JsonNode getPagedUpdatedComplianceListData(String fromDate, String toDate, String pageNumber, String pageSize) {
-        return fetchRawGet(uri -> uri.path(getApiPath())
-                        .queryParam("fromDate", fromDate)
-                        .queryParam("toDate", toDate)
-                        .queryParam("pageNumber", pageNumber)
-                        .queryParam("pageSize", pageSize)
-                        .build());
-    }
-}
diff --git a/src/main/java/com/snp/batch/jobs/web/compliance/service/UpdatedComplianceListService.java b/src/main/java/com/snp/batch/jobs/web/compliance/service/UpdatedComplianceListService.java
deleted file mode 100644
index 970a56f..0000000
--- a/src/main/java/com/snp/batch/jobs/web/compliance/service/UpdatedComplianceListService.java
+++ /dev/null
@@ -1,33 +0,0 @@
-package com.snp.batch.jobs.web.compliance.service;
-
-import com.fasterxml.jackson.databind.JsonNode;
-import com.snp.batch.common.web.service.BaseBypassService;
-import org.springframework.beans.factory.annotation.Qualifier;
-import org.springframework.core.ParameterizedTypeReference;
-import org.springframework.stereotype.Service;
-import org.springframework.web.reactive.function.client.WebClient;
-
-/**
- * 기간 내 변경 Compliance 조회 bypass 서비스
- * 외부 Maritime API에서 데이터를 실시간 조회하여 JSON을 그대로 반환
- */
-@Service
-public class UpdatedComplianceListService extends BaseBypassService<JsonNode> {
-
-    public UpdatedComplianceListService(
-            @Qualifier("maritimeServiceApiWebClient") WebClient webClient) {
-        super(webClient, "/RiskAndCompliance/UpdatedComplianceList", "기간 내 변경 Compliance 조회",
-                new ParameterizedTypeReference<>() {},
-                new ParameterizedTypeReference<>() {});
-    }
-
-    /**
-     * 기간 내 변경 Compliance 조회 데이터를 조회합니다.
-     */
-    public JsonNode getUpdatedComplianceListData(String fromDate, String toDate) {
-        return fetchRawGet(uri -> uri.path(getApiPath())
-                        .queryParam("fromDate", fromDate)
-                        .queryParam("toDate", toDate)
-                        .build());
-    }
-}
diff --git a/src/main/java/com/snp/batch/service/BypassCodeGenerator.java b/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
index 5c68f41..540896d 100644
--- a/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
+++ b/src/main/java/com/snp/batch/service/BypassCodeGenerator.java
@@ -200,7 +200,7 @@ public class BypassCodeGenerator {
 
             methods.append("\n");
             methods.append("    @Operation(\n");
-            methods.append("            summary = \"").append(config.getDisplayName()).append(" 조회\",\n");
+            methods.append("            summary = \"").append(config.getDisplayName()).append("\",\n");
             String opDescription = (config.getDescription() != null && !config.getDescription().isEmpty())
                     ? config.getDescription()
                     : config.getDisplayName() + " 데이터를 요청하고 응답을 그대로 반환합니다.";
-- 
2.45.2


From f5da8f22c7929e3367ac1e694cb03a4d77103604 Mon Sep 17 00:00:00 2001
From: HYOJIN <hjkim4@gcsc.co.kr>
Date: Fri, 27 Mar 2026 14:21:06 +0900
Subject: [PATCH 19/19] =?UTF-8?q?docs:=20=EB=A6=B4=EB=A6=AC=EC=A6=88=20?=
 =?UTF-8?q?=EB=85=B8=ED=8A=B8=20=EC=97=85=EB=8D=B0=EC=9D=B4=ED=8A=B8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 docs/RELEASE-NOTES.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/RELEASE-NOTES.md b/docs/RELEASE-NOTES.md
index ba14ac4..143ff32 100644
--- a/docs/RELEASE-NOTES.md
+++ b/docs/RELEASE-NOTES.md
@@ -6,6 +6,13 @@
 
 ### 추가
 - favicon 변경 (#105)
+- BY PASS API 등록 프로세스 설계 및 개발 (#63)
+  - 화면에서 API 정보 입력 → Java 코드 자동 생성 (Controller, Service)
+  - 공통 베이스 클래스 (BaseBypassService, BaseBypassController)
+  - JSON 응답 RAW 패스스루 (JsonNode)
+  - 같은 도메인 다중 엔드포인트 지원
+  - Swagger GroupedOpenApi 그룹 분리 및 사용자 설정 반영
+  - SPA 새로고침 오류 수정
 
 ### 변경
 - API 응답 처리 방식에 따른 패키지 분리 (jobs/batch, jobs/web) (#66)
-- 
2.45.2