공지사항 관리 - 장애/점검 등록 UI 추가

- PortalNoticeUI: 장애/점검 필드 신설 (시작/종료/상태/영향API)
- PortalNoticeManService: djb_apistatus_incident 연동 분기
- 등록 폼: 동적 유형별 UI + 영향 API 팝업 (showModal)

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

WebContent/jsp/onl/apim/portalnotice/portalNoticeManDetail.jsp

@@ -19,10 +19,23 @@
 <script language="javascript" >
 	var url = '<c:url value="/onl/apim/portalnotice/portalNoticeMan.json" />';
 	var url_view = '<c:url value="/onl/apim/portalnotice/portalNoticeMan.view" />';
+	var apiPopupUrl = '<c:url value="/onl/apim/apigroup/apiGroupMan.view" />';
 	var file_download = '<c:url value="/file/download.do" />';
 	var isDetail = false;
 	var fileInfo = null;
 
+	// 코드 상수 — PortalNoticeUI 와 동기화
+	var NOTICE_TYPE_NORMAL = '1';
+	var NOTICE_TYPE_MAINTENANCE = '2';
+	var NOTICE_TYPE_INCIDENT = '3';
+
+	// 영향 API 목록 (UI 상태)
+	var affectedApis = [];
+
+	function isIncidentType(t) {
+		return t === NOTICE_TYPE_INCIDENT || t === NOTICE_TYPE_MAINTENANCE;
+	}
+
 	function init() {
 		var key = "${param.id}";
 		isDetail = key != "" && key != "null";
@@ -35,8 +48,7 @@
 			$("#btn_modify").html('<i class="material-icons">save</i> <%= localeMessage.getString("button.register") %>');
 			buttonControl(false);
 		}
-		
+
-		// 초기화 로직
 		$.ajax({
 			type : "POST",
 			url:url,
@@ -45,7 +57,8 @@
 			success:function(json){
 				combo = json;
 				new makeOptions("CODE","NAME").setObj($("select[name=noticeType]")).setNoValueInclude(false).setData(json.noticeTypeList).rendering();
-				
+				toggleIncidentFields();
+
 				if (key) {
 					detail(key);
 				}
@@ -56,6 +69,22 @@
 		});
 	}
 
+	function toggleIncidentFields() {
+		var t = $('#noticeType').val();
+		if (isIncidentType(t)) {
+			$('.incident-row').show();
+			// INCIDENT 만 상태 영역 표시
+			if (t === NOTICE_TYPE_INCIDENT) {
+				$('.incident-state-row').show();
+			} else {
+				$('.incident-state-row').hide();
+			}
+		} else {
+			$('.incident-row').hide();
+			$('.incident-state-row').hide();
+		}
+	}
+
 	function decodeHTMLEntities(text) {
 		var textArea = document.createElement('textarea');
 		textArea.innerHTML = text;
@@ -73,57 +102,100 @@
 	function displayAttachFile(file) {
 		var $attachFiles = $('#attachFiles');
 		$attachFiles.empty();
-
 		if (file) {
 			var iconPath = '${pageContext.request.contextPath}/images/icon_file.png';
 			var fileItem = $('<div>').addClass('file-item');
-
 			$('<img>').attr('src', iconPath).css({'marginLeft': '15px','marginRight': '5px' ,'height': '1.2em'}).appendTo(fileItem);
-
+			var fileNameSpan = $('<span>').addClass('fileName')
-			var fileNameSpan = $('<span>')
+				.text(file.originalFileName + '.' + file.fileExtension + ' (' + formatFileSize(file.size) + ')')
-					.addClass('fileName')
+				.css('cursor', 'pointer')
-					.text(file.originalFileName + '.' + file.fileExtension + ' (' + formatFileSize(file.size) + ')')
+				.on('click', function() { if (file.fileId) downloadFile(file.fileId); });
-					.css('cursor', 'pointer')
-					.on('click', function() {
-						if (file.fileId) {
-							downloadFile(file.fileId);
-						}
-					});
-
 			fileNameSpan.appendTo(fileItem);
 			$('<button>').text('X').addClass('delete-file').css('marginLeft', '15px')
-					.on('click', function() {
+				.on('click', function() {
-						fileInfo = null;
+					fileInfo = null;
-						displayAttachFile(null);
+					displayAttachFile(null);
-						// 폼에 삭제 플래그 추가
+					$('<input>').attr({type: 'hidden', name: 'fileDeleted', value: 'true'}).appendTo('#ajaxForm');
-						$('<input>').attr({
+				}).appendTo(fileItem);
-							type: 'hidden',
-							name: 'fileDeleted',
-							value: 'true'
-						}).appendTo('#ajaxForm');
-					})
-					.appendTo(fileItem);
-
 			fileItem.appendTo($attachFiles);
 		}
 	}
 
 	function downloadFile(fileId) {
 		if (fileId) {
-			var fileSn = 1;  // 단일 파일이므로 시리얼 넘버를 1로 고정
+			window.location.href = file_download + '?fileId=' + fileId + '&fileSn=1';
-			window.location.href = file_download + '?fileId=' + fileId + '&fileSn=' + fileSn;
-		} else {
-			console.log("File not yet uploaded or doesn't have an ID");
 		}
 	}
 
+	function renderAffectedApis() {
+		var $tb = $('#affectedApiTbody');
+		$tb.empty();
+		if (!affectedApis.length) {
+			$tb.append('<tr><td colspan="3" style="text-align:center;color:#999;">선택된 영향 API가 없습니다.</td></tr>');
+			return;
+		}
+		$.each(affectedApis, function(idx, api) {
+			var $tr = $('<tr>');
+			$tr.append('<td style="text-align:center;width:40px;"><input type="checkbox" class="affected-api-check" data-idx="' + idx + '"></td>');
+			$tr.append('<td>' + (api.apiId || '') + '</td>');
+			$tr.append('<td>' + (api.apiName || '') + '</td>');
+			$tb.append($tr);
+		});
+	}
+
+	function openApiPopup() {
+		// showModal 헬퍼는 urlAddServiceType + &menuId=getMenuId() + &pop=true 를 자동 부여 →
+		// AuthorizeInterceptor 가 정상적으로 권한 인식. window.open 직접 호출 시 권한 부족 발생.
+		// 본 페이지는 summernote 본문 에디터 등 다른 iframe 이 함께 존재할 수 있어
+		// frames[0] 가정은 위험 → DOM 에서 .ui-dialog 내 iframe 중 src=apiGroupMan 인 것을 식별.
+		var selectedIds = affectedApis.map(function(a) { return a.apiId; }).join(',');
+		var url2 = apiPopupUrl + '?cmd=POPUP&selectedApiIds=' + encodeURIComponent(selectedIds);
+		var args = {};
+		showModal(url2, args, 1280, 860, function () {
+			var doc = args.self && args.self.document;
+			if (!doc) return;
+			var popupFrame = null;
+			var iframes = doc.querySelectorAll('iframe');
+			for (var i = 0; i < iframes.length; i++) {
+				var src = iframes[i].getAttribute('src') || '';
+				if (src.indexOf('apiGroupMan') >= 0) {
+					popupFrame = iframes[i].contentWindow;
+					break;
+				}
+			}
+			if (!popupFrame) return;
+			var rv = popupFrame.returnValue;
+			if (!rv) return;
+			var rows = Array.isArray(rv) ? rv : [rv];
+			$.each(rows, function(_, item) {
+				if (!item || !item.apiId) return;
+				var exists = affectedApis.some(function(a){ return a.apiId === item.apiId; });
+				if (!exists) {
+					affectedApis.push({apiId: item.apiId, apiName: item.apiDesc || item.apiName || ''});
+				}
+			});
+			renderAffectedApis();
+		});
+	}
+
+	function removeSelectedAffectedApis() {
+		var idxes = [];
+		$('.affected-api-check:checked').each(function() {
+			idxes.push(parseInt($(this).data('idx'), 10));
+		});
+		if (!idxes.length) {
+			alert('삭제할 항목을 선택해주세요.');
+			return;
+		}
+		// 역순 삭제
+		idxes.sort(function(a,b){return b-a;}).forEach(function(i){ affectedApis.splice(i, 1); });
+		renderAffectedApis();
+	}
 
 	function detail(key) {
 		if (!isDetail) return;
 		$.ajax({
-			type: "POST",
+			type: "POST", url: url, dataType: "json",
-			url: url,
-			dataType: "json",
 			data: {cmd: 'DETAIL', id: key},
 			success: function (data) {
 				$("#id").val(key);
@@ -135,7 +207,18 @@
 				var decodedContent = decodeHTMLEntities(data.noticeDetail);
 				$('#contents').summernote('code', decodedContent);
 
-				// 파일 정보 표시
+				// 장애/점검 필드
+				$('#summary').val(data.summary || '');
+				$('#startedAt').val(data.startedAt || '');
+				$('#endAt').val(data.endAt || '');
+				$('#state').val(data.state || 'INVESTIGATING');
+				$('#previousState').text(data.previousState || '없음');
+				affectedApis = (data.affectedApis || []).map(function(a){
+					return {apiId: a.apiId, apiName: a.apiName || ''};
+				});
+				renderAffectedApis();
+				toggleIncidentFields();
+
 				if (data.fileInfo) {
 					fileInfo = {
 						originalFileName: data.fileInfo.fileDetails[0].originalFileName,
@@ -146,24 +229,21 @@
 					displayAttachFile(fileInfo);
 				}
 			},
-			error: function (e) {
+			error: function (e) { alert(e.responseText); }
-				alert(e.responseText);
-			}
 		});
 	}
 
 	$(document).ready(function () {
 		var returnUrl = getReturnUrlForReturn();
-		
+
 		init();
-		
 
-		// Summernote 에디터 초기화 (이미지 붙여넣기 data-uri 방식, 리사이징 지원)
+		initSummernote('#contents', { placeholder: '여기에 내용을 입력하세요.', height: 300 });
-		initSummernote('#contents', {
-			placeholder: '여기에 내용을 입력하세요.',
-			height: 300
-		});
 
+		$('#noticeType').on('change', toggleIncidentFields);
+
+		$('#btn_addAffectedApi').click(openApiPopup);
+		$('#btn_removeAffectedApi').click(removeSelectedAffectedApis);
 
 		$('#fileInput').change(function(e) {
 			var file = e.target.files[0];
@@ -171,52 +251,66 @@
 				fileInfo = {
 					originalFileName: file.name.split('.').slice(0, -1).join('.'),
 					fileExtension: file.name.split('.').pop(),
-					file: file,
+					file: file, size: file.size
-					size: file.size
 				};
 				displayAttachFile(fileInfo);
 			}
-			this.value = '';  // 입력 필드 초기화
+			this.value = '';
-		});
-
-		$('#addFile').click(function() {
-			$('#fileInput').click();
 		});
 
+		$('#addFile').click(function() { $('#fileInput').click(); });
 
 		$("#btn_modify").click(function () {
 			if (!checkRequired("ajaxForm")) return;
 
-			if (confirm("<%= localeMessage.getString("common.checkSave")%>") != true)
+			var noticeType = $('#noticeType').val();
-				return;
+			if (isIncidentType(noticeType)) {
+				if (!$('#startedAt').val()) {
+					alert('시작 시각을 입력해 주십시오.');
+					return;
+				}
+				if (noticeType === NOTICE_TYPE_MAINTENANCE && !$('#endAt').val()) {
+					alert('점검 종료 시각을 입력해 주십시오.');
+					return;
+				}
+				if (affectedApis.length === 0) {
+					alert('영향 API를 1건 이상 선택해 주십시오.');
+					return;
+				}
+			}
+
+			if (confirm("<%= localeMessage.getString("common.checkSave")%>") != true) return;
 
 			var formData = new FormData($("#ajaxForm")[0]);
-
 			formData.set("useYn", $("#useYn").is(":checked") ? "Y" : "N");
 			formData.set("fixYn", $("#fixYn").is(":checked") ? "Y" : "N");
 			formData.set("noticeDetail", $('#contents').summernote('code'));
 
+			// 시작/종료 시각이 비어 있으면 전송하지 않음 (서버 파싱 오류 방지)
+			if (!$('#startedAt').val()) formData.delete('startedAt');
+			if (!$('#endAt').val()) formData.delete('endAt');
+
+			// 영향 API → affectedApis[i].apiId/apiName 으로 전송
+			$.each(affectedApis, function(i, api) {
+				formData.set('affectedApis[' + i + '].apiId', api.apiId);
+				formData.set('affectedApis[' + i + '].apiName', api.apiName || '');
+			});
+
 			formData.append("cmd", isDetail ? "UPDATE" : "INSERT");
 
-			// 파일 처리
 			if (fileInfo && fileInfo.file) {
 				formData.set("files", fileInfo.file);
 				formData.set("fileName", fileInfo.originalFileName + '.' + fileInfo.fileExtension);
 			}
 
 			$.ajax({
-				type: "POST",
+				type: "POST", url: url, data: formData,
-				url: url,
+				processData: false, contentType: false,
-				data: formData,
+				success: function () {
-				processData: false,
-				contentType: false,
-				success: function (json) {
 					alert("<%= localeMessage.getString("common.saveMsg") %>");
 					goNav(returnUrl);
 				},
-				error: function (e) {
+				error: function (e) { alert(e.responseText); }
-					alert(e.responseText);
-				}
 			});
 		});
 
@@ -224,25 +318,18 @@
 			if (confirm("<%= localeMessage.getString("common.confirmMsg")%>")) {
 				var postData = $('#ajaxForm').serializeArray();
 				postData.push({name: "cmd", value: "DELETE"});
-
 				$.ajax({
-					type: "POST",
+					type: "POST", url: url, data: postData,
-					url: url,
+					success: function () {
-					data: postData,
-					success: function (args) {
 						alert("<%= localeMessage.getString("common.deleteMsg") %>");
 						goNav(returnUrl);
 					},
-					error: function (e) {
+					error: function (e) { alert(e.responseText); }
-						alert(e.responseText);
-					}
 				});
 			}
 		});
 
-		$("#btn_previous").click(function () {
+		$("#btn_previous").click(function () { goNav(returnUrl); });
-			goNav(returnUrl);
-		});
 	});
 </script>
 </head>
@@ -252,7 +339,7 @@
 		<ul class="path">
 			<li><a href="#">${rmsMenuPath}</a></li>
 		</ul>
-	</div><!-- end content_top -->
+	</div>
 	<div class="content_middle">
 		<div class="search_wrap">
 			<button type="button" class="cssbtn" id="btn_modify" level="W" status="DETAIL,NEW"><i class="material-icons">save</i> <%= localeMessage.getString("button.modify") %></button>
@@ -270,9 +357,9 @@
 					<col style="width: 40%"/>
 				</colgroup>
 				<tr>
-					<th>게시유형</th>
+					<th>게시유형 <font color="red">*</font></th>
-					<td colspan="3">		
+					<td colspan="3">
-						<div class="select-style" >
+						<div class="select-style">
 							<select name="noticeType" id="noticeType"></select>
 						</div>
 					</td>
@@ -286,7 +373,7 @@
 					<td>
 						<input type="checkbox" name="useYn" id="useYn" value="Y" ${portalNoticeUI.useYn eq 'Y' ? 'checked' : ''}> 사용
 					</td>
-					<th>고정여부</th>
+					<th>상단고정</th>
 					<td>
 						<input type="checkbox" name="fixYn" id="fixYn" value="Y" ${portalNoticeUI.fixYn eq 'Y' ? 'checked' : ''}> 고정
 					</td>
@@ -297,19 +384,58 @@
 						<textarea id="contents" name="noticeDetail" style="width:100%;height:300px" data-required data-warning="본문을 입력하여 주십시오."></textarea>
 					</td>
 				</tr>
-				<!-- <tr>
+
-					<th>첨부파일</th>
+				<!-- ───── 장애/점검 전용 영역 ───── -->
-					<td colspan="3">
+				<tr class="incident-row" style="display:none;">
-						<div style="margin: 5px 0px;  display: inline-block;">
+					<th>시작 <font color="red">*</font></th>
-							<input type="file" id="fileInput" name="files" style="display:none;" />
+					<td>
-							<button type="button" id="addFile" class="cssbtn smallBtn">파일 선택</button>
+						<input type="datetime-local" id="startedAt" name="startedAt" style="width:90%">
-						</div>
-						<div id="attachFiles" style="margin: 5px 0px; display: inline-block;"></div>
 					</td>
-				</tr> -->
+					<th>종료</th>
+					<td>
+						<input type="datetime-local" id="endAt" name="endAt" style="width:90%" placeholder="해소시 자동 채움">
+					</td>
+				</tr>
+				<tr class="incident-row incident-state-row" style="display:none;">
+					<th>상태</th>
+					<td>
+						<div class="select-style">
+							<select id="state" name="state">
+								<option value="INVESTIGATING">INVESTIGATING - 조사중</option>
+								<option value="IDENTIFIED">IDENTIFIED - 원인 파악</option>
+								<option value="MONITORING">MONITORING - 모니터링</option>
+								<option value="RESOLVED">RESOLVED - 해소</option>
+								<option value="CANCELED">CANCELED - 취소</option>
+							</select>
+						</div>
+					</td>
+					<th>이전 상태</th>
+					<td><span id="previousState">없음</span></td>
+				</tr>
+				<tr class="incident-row" style="display:none;">
+					<th>영향 API 선택</th>
+					<td colspan="3">
+						<div style="margin-bottom:5px;">
+							<button type="button" class="cssbtn smallBtn" id="btn_removeAffectedApi"><i class="material-icons">delete</i> 삭제</button>
+							<button type="button" class="cssbtn smallBtn" id="btn_addAffectedApi"><i class="material-icons">add</i> 추가</button>
+						</div>
+						<table class="table_row" cellspacing="0" style="width:100%;">
+							<thead>
+								<tr>
+									<th style="width:40px;text-align:center;"><input type="checkbox" id="affectedApiAll" onclick="$('.affected-api-check').prop('checked', this.checked);"></th>
+									<th>API ID</th>
+									<th>API 명</th>
+								</tr>
+							</thead>
+							<tbody id="affectedApiTbody">
+								<tr><td colspan="3" style="text-align:center;color:#999;">선택된 영향 API가 없습니다.</td></tr>
+							</tbody>
+						</table>
+					</td>
+				</tr>
 			</table>
 		</form>
 	</div>
 </div>
 </body>
-</html>
+</html>

src/main/java/com/eactive/eai/rms/onl/apim/portalnotice/IncidentAffectedApiUI.java

@@ -0,0 +1,11 @@
+package com.eactive.eai.rms.onl.apim.portalnotice;
+
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Data
+@NoArgsConstructor
+public class IncidentAffectedApiUI {
+    private String apiId;
+    private String apiName;
+}

src/main/java/com/eactive/eai/rms/onl/apim/portalnotice/PortalNoticeManService.java

@@ -1,5 +1,13 @@
 package com.eactive.eai.rms.onl.apim.portalnotice;
 
+import com.eactive.apim.portal.djb.apistatus.incident.entity.DjbApistatusIncident;
+import com.eactive.apim.portal.djb.apistatus.incident.entity.DjbApistatusIncidentApi;
+import com.eactive.apim.portal.djb.apistatus.incident.entity.DjbApistatusIncidentApiId;
+import com.eactive.apim.portal.djb.apistatus.incident.entity.IncidentKind;
+import com.eactive.apim.portal.djb.apistatus.incident.entity.IncidentState;
+import com.eactive.apim.portal.djb.apistatus.incident.repository.DjbApistatusIncidentApiRepository;
+import com.eactive.apim.portal.djb.apistatus.incident.repository.DjbApistatusIncidentRepository;
+import com.eactive.apim.portal.djb.apistatus.incident.repository.DjbApistatusIncidentTimelineRepository;
 import com.eactive.apim.portal.file.entity.FileDetail;
 import com.eactive.apim.portal.file.entity.FileInfo;
 import com.eactive.apim.portal.file.service.FileService;
@@ -23,7 +31,12 @@ import java.io.IOException;
 import java.io.UnsupportedEncodingException;
 import java.nio.charset.Charset;
 import java.nio.charset.StandardCharsets;
+import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
 import java.util.Optional;
+import java.util.stream.Collectors;
 
 @Service
 @Transactional(transactionManager = "transactionManagerForEMS")
@@ -32,6 +45,9 @@ public class PortalNoticeManService extends BaseService {
 	private final PortalNoticeService portalNoticeService;
 	private final PortalNoticeUIMapper portalNoticeUIMapper;
   	private final FileService fileService;
+	private final DjbApistatusIncidentRepository incidentRepository;
+	private final DjbApistatusIncidentApiRepository incidentApiRepository;
+	private final DjbApistatusIncidentTimelineRepository incidentTimelineRepository;
 
 	private String decodeString(String value) {
 		if (ContainerUtil.get() == ContainerUtil.TOMCAT) {
@@ -48,10 +64,27 @@ public class PortalNoticeManService extends BaseService {
 	@Autowired
 	public PortalNoticeManService(PortalNoticeService portalNoticeService,
 								  PortalNoticeUIMapper portalNoticeUIMapper,
-								  FileService fileService){
+								  FileService fileService,
+								  DjbApistatusIncidentRepository incidentRepository,
+								  DjbApistatusIncidentApiRepository incidentApiRepository,
+								  DjbApistatusIncidentTimelineRepository incidentTimelineRepository){
 		this.portalNoticeService = portalNoticeService;
 		this.portalNoticeUIMapper = portalNoticeUIMapper;
 		this.fileService = fileService;
+		this.incidentRepository = incidentRepository;
+		this.incidentApiRepository = incidentApiRepository;
+		this.incidentTimelineRepository = incidentTimelineRepository;
+	}
+
+	private static boolean isIncidentKind(String noticeType) {
+		return PortalNoticeUI.NOTICE_TYPE_INCIDENT.equals(noticeType)
+				|| PortalNoticeUI.NOTICE_TYPE_MAINTENANCE.equals(noticeType);
+	}
+
+	private static IncidentKind toKind(String noticeType) {
+		if (PortalNoticeUI.NOTICE_TYPE_INCIDENT.equals(noticeType)) return IncidentKind.INCIDENT;
+		if (PortalNoticeUI.NOTICE_TYPE_MAINTENANCE.equals(noticeType)) return IncidentKind.MAINTENANCE;
+		return null;
 	}
 
 
@@ -89,9 +122,39 @@ public class PortalNoticeManService extends BaseService {
 
 		PortalNoticeUI ui = portalNoticeUIMapper.toVo(portalNotice);
 		setFileInfo(portalNotice, ui);
+		populateIncident(portalNotice, ui);
 		return ui;
 	}
 
+	private void populateIncident(PortalNotice portalNotice, PortalNoticeUI ui) {
+		if (!isIncidentKind(portalNotice.getNoticeType())) {
+			ui.setAffectedApis(Collections.emptyList());
+			return;
+		}
+		Optional<DjbApistatusIncident> incidentOpt = incidentRepository.findByNoticeId(portalNotice.getId());
+		if (!incidentOpt.isPresent()) {
+			ui.setAffectedApis(Collections.emptyList());
+			return;
+		}
+		DjbApistatusIncident incident = incidentOpt.get();
+		ui.setIncidentId(incident.getIncidentId());
+		ui.setSummary(incident.getSummary());
+		ui.setStartedAt(incident.getStartedAt());
+		ui.setEndAt(incident.getEndAt());
+		ui.setState(incident.getState() == null ? null : incident.getState().name());
+		ui.setPreviousState(incident.getPreviousState() == null ? null : incident.getPreviousState().name());
+
+		List<IncidentAffectedApiUI> apis = incidentApiRepository
+				.findByIncidentIdOrderByApiId(incident.getIncidentId()).stream()
+				.map(api -> {
+					IncidentAffectedApiUI vo = new IncidentAffectedApiUI();
+					vo.setApiId(api.getApiId());
+					vo.setApiName(api.getApiName());
+					return vo;
+				}).collect(Collectors.toList());
+		ui.setAffectedApis(apis);
+	}
+
 	public void insert(PortalNoticeUI portalNoticeUI) throws IOException {
 		//portalNoticeUI.setNoticeSubject(decodeString(portalNoticeUI.getNoticeSubject()));
 		//portalNoticeUI.setNoticeDetail(decodeString(StringEscapeUtils.unescapeHtml(portalNoticeUI.getNoticeDetail())));
@@ -106,6 +169,61 @@ public class PortalNoticeManService extends BaseService {
 		}
 
 		portalNoticeService.save(portalNotice);
+
+		if (isIncidentKind(portalNoticeUI.getNoticeType())) {
+			persistIncident(portalNoticeUI, portalNotice, true);
+		}
+	}
+
+	private void persistIncident(PortalNoticeUI portalNoticeUI, PortalNotice portalNotice, boolean isCreate) {
+		IncidentKind kind = toKind(portalNoticeUI.getNoticeType());
+
+		DjbApistatusIncident incident = incidentRepository.findByNoticeId(portalNotice.getId())
+				.orElseGet(DjbApistatusIncident::new);
+
+		incident.setKind(kind);
+		incident.setTitle(portalNotice.getNoticeSubject());
+		incident.setSummary(portalNoticeUI.getSummary());
+		incident.setStartedAt(portalNoticeUI.getStartedAt() != null
+				? portalNoticeUI.getStartedAt() : LocalDateTime.now());
+		incident.setEndAt(portalNoticeUI.getEndAt());
+		incident.setDetectedBy("MANUAL");
+		incident.setNoticeId(portalNotice.getId());
+		incident.setDraftYn("N");
+		incident.setFixYn(StringUtils.defaultIfBlank(portalNotice.getFixYn(), "N"));
+
+		if (kind == IncidentKind.INCIDENT) {
+			IncidentState newState = StringUtils.isNotBlank(portalNoticeUI.getState())
+					? IncidentState.valueOf(portalNoticeUI.getState())
+					: IncidentState.INVESTIGATING;
+			if (!isCreate && incident.getState() != newState) {
+				incident.setPreviousState(incident.getState());
+			}
+			incident.setState(newState);
+		} else {
+			incident.setState(null);
+			incident.setPreviousState(null);
+		}
+
+		DjbApistatusIncident saved = incidentRepository.save(incident);
+
+		// 영향 API 동기화 — 단순 전체 삭제 후 재삽입
+		incidentApiRepository.deleteByIncidentId(saved.getIncidentId());
+		List<IncidentAffectedApiUI> affected = portalNoticeUI.getAffectedApis();
+		if (affected != null && !affected.isEmpty()) {
+			List<DjbApistatusIncidentApi> rows = new ArrayList<>();
+			for (IncidentAffectedApiUI src : affected) {
+				if (StringUtils.isBlank(src.getApiId())) continue;
+				DjbApistatusIncidentApi api = new DjbApistatusIncidentApi();
+				api.setIncidentId(saved.getIncidentId());
+				api.setApiId(src.getApiId());
+				api.setApiName(src.getApiName());
+				rows.add(api);
+			}
+			if (!rows.isEmpty()) {
+				incidentApiRepository.saveAll(rows);
+			}
+		}
 	}
 
 	private void handleFileUpload(PortalNoticeUI portalNoticeUI, PortalNotice portalNotice) throws IOException {
@@ -129,6 +247,7 @@ public class PortalNoticeManService extends BaseService {
 		portalNoticeUI.setNoticeDetail(StringEscapeUtils.unescapeHtml(portalNoticeUI.getNoticeDetail()));
 
 		PortalNotice portalNotice = portalNoticeService.getById(portalNoticeUI.getId());
+		String previousNoticeType = portalNotice.getNoticeType();
 
 		if (portalNoticeUI.getFiles() != null && !portalNoticeUI.getFiles().isEmpty()) {
 			handleFileUpload(portalNoticeUI, portalNotice);
@@ -139,11 +258,27 @@ public class PortalNoticeManService extends BaseService {
 
 		portalNoticeUIMapper.updateToEntity(portalNoticeUI, portalNotice);
 		portalNoticeService.save(portalNotice);
+
+		if (isIncidentKind(portalNotice.getNoticeType())) {
+			persistIncident(portalNoticeUI, portalNotice, false);
+		} else if (isIncidentKind(previousNoticeType)) {
+			// 일반 공지로 유형 변경 → 기존 incident 정리
+			deleteIncidentIfExists(portalNotice.getId());
+		}
+	}
+
+	private void deleteIncidentIfExists(String noticeId) {
+		incidentRepository.findByNoticeId(noticeId).ifPresent(incident -> {
+			incidentApiRepository.deleteByIncidentId(incident.getIncidentId());
+			incidentTimelineRepository.deleteByIncidentId(incident.getIncidentId());
+			incidentRepository.delete(incident);
+		});
 	}
 
 	public void delete(String id) {
 		PortalNotice portalNotice = portalNoticeService.getById(id);
 		Optional.ofNullable(portalNotice.getFileId()).ifPresent(fileService::deleteFile);
+		deleteIncidentIfExists(id);
 		portalNoticeService.deleteById(id);
 	}
 

src/main/java/com/eactive/eai/rms/onl/apim/portalnotice/PortalNoticeUI.java

@@ -8,11 +8,16 @@ import org.springframework.format.annotation.DateTimeFormat;
 import org.springframework.web.multipart.MultipartFile;
 
 import java.time.LocalDateTime;
+import java.util.List;
 
 
 @Data
 public class PortalNoticeUI {
 
+	public static final String NOTICE_TYPE_NORMAL = "1";
+	public static final String NOTICE_TYPE_MAINTENANCE = "2";
+	public static final String NOTICE_TYPE_INCIDENT = "3";
+
 	private String id;
 
 	private String noticeSubject;
@@ -53,4 +58,23 @@ public class PortalNoticeUI {
 	private boolean hasAttachment;	// 첨부파일 여부
 
 	private boolean fileDeleted; // 파일 삭제 여부
+
+	// ───── 장애/점검(djb_apistatus_incident) 연동 필드 ─────
+	private Long incidentId;
+
+	private String summary;
+
+	@JsonFormat(pattern = "yyyy-MM-dd HH:mm")
+	@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm")
+	private LocalDateTime startedAt;
+
+	@JsonFormat(pattern = "yyyy-MM-dd HH:mm")
+	@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm")
+	private LocalDateTime endAt;
+
+	private String state;          // INCIDENT 한정 (INVESTIGATING/IDENTIFIED/MONITORING/RESOLVED/CANCELED)
+
+	private String previousState;  // 직전 상태
+
+	private List<IncidentAffectedApiUI> affectedApis;
 }

src/main/java/com/eactive/eai/rms/onl/apim/portalnotice/PortalNoticeUIMapper.java

@@ -3,7 +3,9 @@ package com.eactive.eai.rms.onl.apim.portalnotice;
 import com.eactive.apim.portal.portalNotice.entity.PortalNotice;
 import org.mapstruct.*;
 
-@Mapper(componentModel = "spring", unmappedTargetPolicy = ReportingPolicy.IGNORE)
+@Mapper(componentModel = "spring",
+		unmappedTargetPolicy = ReportingPolicy.IGNORE,
+		unmappedSourcePolicy = ReportingPolicy.IGNORE)
 public interface PortalNoticeUIMapper {
 
     PortalNoticeUI toVo(PortalNotice entity);