diff --git a/apps/sn/app/(map-layout)/map/components/sinkhole/SinkholeDetailPanel.tsx b/apps/sn/app/(map-layout)/map/components/sinkhole/SinkholeDetailPanel.tsx
new file mode 100644
index 000000000..9374c2a22
--- /dev/null
+++ b/apps/sn/app/(map-layout)/map/components/sinkhole/SinkholeDetailPanel.tsx
@@ -0,0 +1,167 @@
+"use client";
+
+import { useMemo } from "react";
+import { Button } from "@common/components";
+import { VerticalTable } from "@/components/ui/verticalTable";
+import type { SinkholeDetail, SinkholeNearbyPipe } from "./sinkholeTypes";
+
+type Props = {
+ detail: SinkholeDetail;
+ nearbyPipes: SinkholeNearbyPipe[];
+ radiusMeters: number;
+ onClose: () => void;
+ onSelectPipe: (pipe: SinkholeNearbyPipe) => void;
+};
+
+const display = (value: unknown) => {
+ const normalized = String(value ?? "").trim();
+ return normalized ? normalized : "-";
+};
+
+const displayNumber = (value: unknown, suffix = "") => {
+ if (value === null || value === undefined || value === "") return "-";
+ const normalized = Number(value);
+ if (Number.isNaN(normalized)) return display(value);
+ return `${normalized.toLocaleString()}${suffix}`;
+};
+
+export default function SinkholeDetailPanel({
+ detail,
+ nearbyPipes,
+ radiusMeters,
+ onClose,
+ onSelectPipe,
+}: Props) {
+ const canShowNearby = String(detail.coordStatus ?? "").trim() === "SUCCESS";
+ const summaryTableData = useMemo(
+ () => [
+ {
+ acdntNo: display(detail.acdntNo),
+ ocrnYmd: display(detail.ocrnYmd),
+ fullAddress: display(detail.fullAddress || detail.daddr),
+ sizeWidth: display(detail.sizeWidth),
+ sizeLength: display(detail.sizeLength),
+ sizeDepth: display(detail.sizeDepth),
+ detailCause: display(detail.detailCause),
+ restoreStatus: display(detail.restoreStatus),
+ restoreCompletedYmd: display(detail.restoreCompletedYmd),
+ },
+ ],
+ [detail],
+ );
+
+ const summaryHeadList = [
+ { id: "acdntNo", title: "사고번호" },
+ { id: "ocrnYmd", title: "발생일자" },
+ { id: "fullAddress", title: "주소" },
+ { id: "sizeWidth", title: "발생규모폭" },
+ { id: "sizeLength", title: "발생규모연장" },
+ { id: "sizeDepth", title: "발생규모깊이" },
+ { id: "detailCause", title: "상세발생원인" },
+ { id: "restoreStatus", title: "복구상태" },
+ { id: "restoreCompletedYmd", title: "복구완료일자" },
+ ];
+
+ return (
+
+ );
+}
diff --git a/apps/sn/app/(map-layout)/map/components/sinkhole/SinkholeLayerSettingPanel.tsx b/apps/sn/app/(map-layout)/map/components/sinkhole/SinkholeLayerSettingPanel.tsx
new file mode 100644
index 000000000..5dd35eb37
--- /dev/null
+++ b/apps/sn/app/(map-layout)/map/components/sinkhole/SinkholeLayerSettingPanel.tsx
@@ -0,0 +1,90 @@
+"use client";
+
+import { useEffect, useState } from "react";
+import type { SinkholeSyncSummary } from "./sinkholeTypes";
+
+type Props = {
+ radiusMeters: number;
+ onApplyRadius: (radiusMeters: number) => void;
+ lastSyncSummary?: SinkholeSyncSummary | null;
+ isAdmin?: boolean;
+};
+
+export default function SinkholeLayerSettingPanel({
+ radiusMeters,
+ onApplyRadius,
+ lastSyncSummary,
+ isAdmin = false,
+}: Props) {
+ const [isCollapsed, setIsCollapsed] = useState(false);
+ const [radiusText, setRadiusText] = useState(String(radiusMeters));
+
+ useEffect(() => {
+ setRadiusText(String(radiusMeters));
+ }, [radiusMeters]);
+
+ const commitRadius = () => {
+ const nextValue = Number(radiusText.replace(/[^0-9]/g, ""));
+ if (!Number.isFinite(nextValue) || nextValue <= 0) {
+ alert("반경은 1m 이상 입력해야 합니다.");
+ return;
+ }
+ onApplyRadius(nextValue);
+ };
+
+ return (
+
+
+
+ 지반침하정보
+
+
+ {!isCollapsed && (
+
+
+
+ event.currentTarget.select()}
+ onChange={(event) => setRadiusText(event.target.value.replace(/[^0-9]/g, ""))}
+ onKeyDown={(event) => {
+ if (event.key === "Enter") commitRadius();
+ }}
+ />
+
+
+
+ {isAdmin && lastSyncSummary ? (
+
+
최근 동기화
+
완료시각: {lastSyncSummary.finishedAt || "-"}
+
+ 성공 {lastSyncSummary.successCount}건 / 실패 {lastSyncSummary.failedCount}건
+
+
+ ) : null}
+
+ )}
+
+ );
+}
diff --git a/apps/sn/app/(map-layout)/map/components/sinkhole/SinkholePopupPage.tsx b/apps/sn/app/(map-layout)/map/components/sinkhole/SinkholePopupPage.tsx
new file mode 100644
index 000000000..19657d6f0
--- /dev/null
+++ b/apps/sn/app/(map-layout)/map/components/sinkhole/SinkholePopupPage.tsx
@@ -0,0 +1,334 @@
+"use client";
+
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { useSearchParams } from "next/navigation";
+import { Button, Input } from "@common/components";
+import { UiTable, downloadExcelWithKoreanHeaders } from "@common/business_components/ui";
+import { getRawJson } from "@/components/lib/api";
+import useStore from "@/store/useStore";
+import LoadingOverlay from "@/components/ui/LoadingBar";
+import type { SelectDataType } from "@common/business_components";
+import {
+ buildSinkholeDefaultFilters,
+ buildSinkholeListQueryString,
+ formatDateInputToYmd,
+ formatYmdToDateInput,
+ normalizeSinkholeFilters,
+ SINKHOLE_EXCEL_HEADERS,
+ SINKHOLE_FILTER_SYNC_MESSAGE,
+ SINKHOLE_RESTORE_STATUS_OPTIONS,
+ SINKHOLE_ROW_SELECT_MESSAGE,
+ type SinkholeFilters,
+ type SinkholeListItem,
+} from "./sinkholeTypes";
+
+const PAGE_SIZE = 20;
+
+type SinkholeTableRow = SinkholeListItem & {
+ rowNo: number;
+ sizeWidthDisplay: string;
+ sizeLengthDisplay: string;
+ sizeDepthDisplay: string;
+ detailCauseDisplay: string;
+ restoreCompletedYmdDisplay: string;
+ coordStatusDisplay: string;
+};
+
+const HEADLIST = [
+ { id: "rowNo", title: "NO", widthPercent: 6 },
+ { id: "ocrnYmd", title: "발생일자", widthPercent: 11 },
+ { id: "fullAddress", title: "주소", widthPercent: 22 },
+ { id: "sizeWidthDisplay", title: "발생규모폭", widthPercent: 10 },
+ { id: "sizeLengthDisplay", title: "발생규모연장", widthPercent: 10 },
+ { id: "sizeDepthDisplay", title: "발생규모깊이", widthPercent: 10 },
+ { id: "detailCauseDisplay", title: "상세발생원인", widthPercent: 12 },
+ { id: "restoreStatus", title: "복구상태", widthPercent: 9 },
+ { id: "coordStatusDisplay", title: "좌표보정상태", widthPercent: 10 },
+ { id: "restoreCompletedYmdDisplay", title: "복구완료일자", widthPercent: 10 },
+] as const;
+
+const toDisplay = (value: unknown) => {
+ const normalized = String(value ?? "").trim();
+ return normalized ? normalized : "-";
+};
+
+const toCoordStatusDisplay = (value: unknown) => {
+ const normalized = String(value ?? "").trim().toUpperCase();
+ if (normalized === "SUCCESS") return "성공";
+ if (normalized === "NO_ADDRESS") return "주소없음";
+ if (normalized === "FAILED") return "실패";
+ return normalized || "-";
+};
+
+const toTableRows = (items: SinkholeListItem[], page: number) =>
+ items.map((item, index) => ({
+ ...item,
+ rowNo: page * PAGE_SIZE + index + 1,
+ sizeWidthDisplay: toDisplay(item.sizeWidth),
+ sizeLengthDisplay: toDisplay(item.sizeLength),
+ sizeDepthDisplay: toDisplay(item.sizeDepth),
+ detailCauseDisplay: toDisplay(item.detailCause),
+ coordStatusDisplay: toCoordStatusDisplay(item.coordStatus),
+ restoreCompletedYmdDisplay: toDisplay(item.restoreCompletedYmd),
+ }));
+
+const buildDownloadRows = (rows: SinkholeTableRow[]) =>
+ rows.map((row) => ({
+ rowNo: row.rowNo,
+ ocrnYmd: row.ocrnYmd || "-",
+ fullAddress: row.fullAddress || "-",
+ sizeWidth: row.sizeWidthDisplay,
+ sizeLength: row.sizeLengthDisplay,
+ sizeDepth: row.sizeDepthDisplay,
+ detailCause: row.detailCauseDisplay,
+ restoreStatus: row.restoreStatus || "-",
+ coordStatus: row.coordStatusDisplay,
+ restoreCompletedYmd: row.restoreCompletedYmdDisplay,
+ }));
+
+const unwrapPayload = (response: any): T =>
+ (response?.data ?? response) as T;
+
+export default function SinkholePopupPage() {
+ const searchParams = useSearchParams();
+ const { ctpv, sgg, fetchCtpv, fetchSgg } = useStore();
+ const [filters, setFilters] = useState(() => {
+ const seeded = normalizeSinkholeFilters(
+ {
+ startYmd: searchParams.get("startYmd") ?? "",
+ endYmd: searchParams.get("endYmd") ?? "",
+ ctpvCd: searchParams.get("ctpvCd") ?? "0",
+ sggCd: searchParams.get("sggCd") ?? "0",
+ restoreStatus: searchParams.get("restoreStatus") ?? "0",
+ },
+ undefined,
+ );
+
+ if (!seeded.startYmd || !seeded.endYmd) {
+ return normalizeSinkholeFilters(buildSinkholeDefaultFilters(), undefined);
+ }
+ return seeded;
+ });
+ const [rows, setRows] = useState([]);
+ const [total, setTotal] = useState(0);
+ const [currentPage, setCurrentPage] = useState(1);
+ const [selectedIndex, setSelectedIndex] = useState(-1);
+ const [isLoading, setIsLoading] = useState(false);
+ const sggOptions = useMemo(
+ () =>
+ filters.ctpvCd === "0"
+ ? sgg
+ : sgg.filter((item) => String(item.val).startsWith(filters.ctpvCd.slice(0, 2))),
+ [filters.ctpvCd, sgg],
+ );
+
+ useEffect(() => {
+ if (ctpv.length === 0) fetchCtpv();
+ if (sgg.length === 0) fetchSgg();
+ }, [ctpv.length, fetchCtpv, fetchSgg, sgg.length]);
+
+ const fetchRows = useCallback(
+ async (page: number, nextFilters: SinkholeFilters) => {
+ const queryString = buildSinkholeListQueryString(nextFilters, ctpv as SelectDataType[], sgg as SelectDataType[], page - 1, PAGE_SIZE);
+ const response = await getRawJson(`/sewerage-service/api/v1/sinkholes?${queryString}`);
+ const payload = unwrapPayload<{ items?: SinkholeListItem[]; total?: number }>(response);
+ const items = Array.isArray(payload?.items) ? payload.items : [];
+ return {
+ rows: toTableRows(items, page - 1),
+ total: Number(payload?.total ?? 0),
+ };
+ },
+ [ctpv, sgg],
+ );
+
+ const loadRows = useCallback(
+ async (page = 1, nextFilters = filters) => {
+ setIsLoading(true);
+ try {
+ const normalized = normalizeSinkholeFilters(nextFilters);
+ const response = await fetchRows(page, normalized);
+ setRows(response.rows);
+ setTotal(response.total);
+ setCurrentPage(page);
+ window.opener?.postMessage(
+ {
+ type: SINKHOLE_FILTER_SYNC_MESSAGE,
+ filters: normalized,
+ },
+ window.location.origin,
+ );
+ } catch (error) {
+ console.error("지반침하 목록 조회 중 오류:", error);
+ setRows([]);
+ setTotal(0);
+ alert(error instanceof Error ? error.message : "지반침하 목록 조회 중 오류가 발생했습니다.");
+ } finally {
+ setIsLoading(false);
+ }
+ },
+ [fetchRows, filters],
+ );
+
+ useEffect(() => {
+ void loadRows(1, filters);
+ // 최초 로딩은 한 번만 수행한다.
+ // eslint-disable-next-line react-hooks/exhaustive-deps
+ }, []);
+
+ const handleSearch = async (page = 1) => {
+ const normalized = normalizeSinkholeFilters(filters);
+ setFilters(normalized);
+ await loadRows(page, normalized);
+ };
+
+ const handleRowClick = (index?: number) => {
+ if (typeof index !== "number") return;
+ const row = rows[index];
+ if (!row) return;
+
+ setSelectedIndex(index);
+ window.opener?.postMessage(
+ {
+ type: SINKHOLE_ROW_SELECT_MESSAGE,
+ row,
+ },
+ window.location.origin,
+ );
+ };
+
+ const handleDownload = async () => {
+ if (rows.length === 0) {
+ alert("다운로드할 데이터가 없습니다.");
+ return;
+ }
+
+ await downloadExcelWithKoreanHeaders({
+ data: buildDownloadRows(rows) as unknown as JSON[],
+ fileName: `지반침하정보_${new Date().toISOString().slice(0, 10)}.xlsx`,
+ sheetNameArray: ["지반침하정보"],
+ headerRange: "A1:J2",
+ headerMapping: SINKHOLE_EXCEL_HEADERS,
+ });
+ };
+
+ return (
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ headName={undefined}
+ tableData={rows}
+ headlist={HEADLIST as any}
+ pageSize={PAGE_SIZE}
+ total={total}
+ cellClick={(index) => handleRowClick(index)}
+ onPageChange={(page) => void handleSearch(page)}
+ curPage={currentPage}
+ index={selectedIndex}
+ widthFixed={true}
+ />
+
+
+ );
+}
diff --git a/apps/sn/app/(map-layout)/map/components/sinkhole/sinkholeTypes.ts b/apps/sn/app/(map-layout)/map/components/sinkhole/sinkholeTypes.ts
new file mode 100644
index 000000000..c4315223e
--- /dev/null
+++ b/apps/sn/app/(map-layout)/map/components/sinkhole/sinkholeTypes.ts
@@ -0,0 +1,401 @@
+"use client";
+
+import type { SelectDataType } from "@common/business_components";
+import type { IUserInfo } from "@/shared/store";
+
+export const SINKHOLE_CONTROL_NODE_ID = "SN_SINKHOLE";
+export const SINKHOLE_LAYER_TYPE = "tb_sn_sinkhole_info";
+export const SINKHOLE_LAYER_NAME = "지반침하정보";
+export const SINKHOLE_ALL_YEAR_NODE_ID = "SN_SINKHOLE_YEAR_ALL";
+export const SINKHOLE_YEAR_NODE_PREFIX = "SN_SINKHOLE_YEAR_";
+export const SINKHOLE_POPUP_KEY = "sinkholePopup";
+export const SINKHOLE_ROW_SELECT_MESSAGE = "SN_SINKHOLE_ROW_SELECT";
+export const SINKHOLE_FILTER_SYNC_MESSAGE = "SN_SINKHOLE_FILTER_SYNC";
+export const SINKHOLE_SYNC_COMPLETED_MESSAGE = "SN_SINKHOLE_SYNC_COMPLETED";
+export const SINKHOLE_DEFAULT_RADIUS = 100;
+export const SINKHOLE_LAYER_ID = "SN_SINKHOLE_LAYER";
+export const SINKHOLE_SELECTED_LAYER_ID = "SN_SINKHOLE_SELECTED_LAYER";
+
+export type SinkholeFilters = {
+ startYmd: string;
+ endYmd: string;
+ ctpvCd: string;
+ sggCd: string;
+ restoreStatus: string;
+};
+
+export type SinkholeListItem = {
+ acdntNo: string;
+ ctpvNm?: string;
+ sggNm?: string;
+ emdNm?: string;
+ fullAddress: string;
+ ocrnYmd: string;
+ restoreStatus?: string;
+ restoreCompletedYmd?: string;
+ coordStatus?: string;
+ geocodeStatus?: string;
+ geocodeSource?: string;
+ geocodeErrorMessage?: string;
+ latitude?: number | null;
+ longitude?: number | null;
+ x?: number | null;
+ y?: number | null;
+ sizeWidth?: number | string | null;
+ sizeLength?: number | string | null;
+ sizeDepth?: number | string | null;
+ detailCause?: string | null;
+ deathCount?: number | null;
+ injuryCount?: number | null;
+ vehicleDamageCount?: number | null;
+};
+
+export type SinkholeDetail = SinkholeListItem & {
+ daddr?: string;
+};
+
+export type SinkholeNearbyPipe = {
+ pipeId: string;
+ fid: string;
+ lyrTypeNm: string;
+ pipeTypeCd?: string;
+ pipeTypeName?: string;
+ diameter?: number | string | null;
+ length?: number | string | null;
+ distanceMeters?: number | string | null;
+};
+
+export type SinkholeSyncSummary = {
+ syncId: string;
+ startedAt: string;
+ finishedAt: string;
+ sourceCount: number;
+ successCount: number;
+ failedCount: number;
+ reGeocodedCount: number;
+ message: string;
+};
+
+export type SinkholeScope = {
+ ctpvCd: string;
+ sggCd: string;
+ ctpvLocked: boolean;
+ sggLocked: boolean;
+};
+
+const toYmd = (date: Date) =>
+ `${date.getFullYear()}${String(date.getMonth() + 1).padStart(2, "0")}${String(date.getDate()).padStart(2, "0")}`;
+
+export const buildSinkholeDefaultFilters = (scope?: SinkholeScope): SinkholeFilters => {
+ const today = new Date();
+ const threeMonthsAgo = new Date(today);
+ threeMonthsAgo.setMonth(today.getMonth() - 3);
+
+ return {
+ startYmd: toYmd(threeMonthsAgo),
+ endYmd: toYmd(today),
+ ctpvCd: scope?.ctpvCd || "0",
+ sggCd: scope?.sggCd || "0",
+ restoreStatus: "0",
+ };
+};
+
+export const buildSinkholeScope = (userInfo: IUserInfo | null): SinkholeScope => {
+ const admin = userInfo?.adminRoleYn === "Y";
+ if (admin) {
+ return {
+ ctpvCd: "0",
+ sggCd: "0",
+ ctpvLocked: false,
+ sggLocked: false,
+ };
+ }
+
+ const digits = String(userInfo?.laeSeCd ?? "").replace(/[^0-9]/g, "");
+ if (digits.length >= 5) {
+ return {
+ ctpvCd: digits.slice(0, 2),
+ sggCd: digits.slice(0, 5),
+ ctpvLocked: true,
+ sggLocked: true,
+ };
+ }
+ if (digits.length >= 2) {
+ return {
+ ctpvCd: digits.slice(0, 2),
+ sggCd: "0",
+ ctpvLocked: true,
+ sggLocked: false,
+ };
+ }
+
+ return {
+ ctpvCd: "0",
+ sggCd: "0",
+ ctpvLocked: false,
+ sggLocked: false,
+ };
+};
+
+export const normalizeSinkholeFilters = (
+ filters: SinkholeFilters,
+ scope?: SinkholeScope,
+): SinkholeFilters => {
+ const next = {
+ startYmd: String(filters.startYmd ?? "").replace(/[^0-9]/g, "").slice(0, 8),
+ endYmd: String(filters.endYmd ?? "").replace(/[^0-9]/g, "").slice(0, 8),
+ ctpvCd: String(filters.ctpvCd ?? "0") || "0",
+ sggCd: String(filters.sggCd ?? "0") || "0",
+ restoreStatus: String(filters.restoreStatus ?? "0") || "0",
+ };
+
+ if (scope?.ctpvCd && scope.ctpvCd !== "0") {
+ next.ctpvCd = scope.ctpvCd;
+ }
+ if (scope?.sggCd && scope.sggCd !== "0") {
+ next.sggCd = scope.sggCd;
+ } else if (next.ctpvCd !== "0" && next.sggCd !== "0" && !next.sggCd.startsWith(next.ctpvCd)) {
+ next.sggCd = "0";
+ }
+
+ return next;
+};
+
+export const formatYmdToDateInput = (value?: string) => {
+ const normalized = String(value ?? "").replace(/[^0-9]/g, "");
+ if (normalized.length !== 8) return "";
+ return `${normalized.slice(0, 4)}-${normalized.slice(4, 6)}-${normalized.slice(6, 8)}`;
+};
+
+export const formatDateInputToYmd = (value?: string) => String(value ?? "").replace(/[^0-9]/g, "").slice(0, 8);
+
+export const resolveRegionNameByCode = (
+ code: string,
+ options: SelectDataType[],
+ length: number,
+) => {
+ const normalized = String(code ?? "").trim();
+ if (!normalized || normalized === "0") return "";
+ const key = normalized.slice(0, length);
+ return options.find((item) => String(item.val).trim() === key)?.text ?? "";
+};
+
+export const buildSinkholeListQueryString = (
+ filters: SinkholeFilters,
+ ctpvOptions: SelectDataType[],
+ sggOptions: SelectDataType[],
+ page = 0,
+ size = 20,
+) => {
+ const params = new URLSearchParams({
+ page: String(page),
+ size: String(size),
+ });
+
+ if (filters.startYmd) params.set("startYmd", filters.startYmd);
+ if (filters.endYmd) params.set("endYmd", filters.endYmd);
+
+ const ctpvNm = resolveRegionNameByCode(filters.ctpvCd, ctpvOptions, 2);
+ const sggNm = resolveRegionNameByCode(filters.sggCd, sggOptions, 5);
+ if (ctpvNm) params.set("ctpvNm", ctpvNm);
+ if (sggNm) params.set("sggNm", sggNm);
+ if (filters.restoreStatus && filters.restoreStatus !== "0") {
+ params.set("restoreStatus", filters.restoreStatus);
+ }
+
+ return params.toString();
+};
+
+export const isSinkholeLayerNode = (node: any) => {
+ const data = node?.data ?? node;
+ const nodeId = String(node?.id ?? data?.lyrSn ?? "");
+ const layerName = String(data?.lyrNm ?? data?.name ?? "").trim();
+ const layerTypeName = String(data?.lyrTyNm ?? data?.lyrTypeNm ?? data?.lyr_type_nm ?? "").trim();
+
+ return (
+ nodeId === SINKHOLE_CONTROL_NODE_ID ||
+ nodeId === SINKHOLE_ALL_YEAR_NODE_ID ||
+ nodeId.startsWith(SINKHOLE_YEAR_NODE_PREFIX) ||
+ layerName === SINKHOLE_LAYER_NAME ||
+ layerTypeName === SINKHOLE_LAYER_TYPE
+ );
+};
+
+export const isSinkholeRootNode = (node: any) => {
+ const data = node?.data ?? node;
+ const nodeId = String(node?.id ?? data?.lyrSn ?? "");
+ const layerName = String(data?.lyrNm ?? data?.name ?? "").trim();
+ return nodeId === SINKHOLE_CONTROL_NODE_ID || layerName === SINKHOLE_LAYER_NAME;
+};
+
+export const isSinkholeYearNode = (node: any) => {
+ const data = node?.data ?? node;
+ const nodeId = String(node?.id ?? data?.lyrSn ?? "");
+ const nodeText = String(node?.text ?? data?.lyrNm ?? data?.name ?? "").trim();
+ return (
+ nodeId === SINKHOLE_ALL_YEAR_NODE_ID ||
+ nodeId.startsWith(SINKHOLE_YEAR_NODE_PREFIX) ||
+ nodeText === "전체" ||
+ /^\d{4}년$/.test(nodeText)
+ );
+};
+
+export const buildSinkholeYearNodes = (currentYear = new Date().getFullYear()) => {
+ return [
+ {
+ lyrSn: `${SINKHOLE_YEAR_NODE_PREFIX}${currentYear}`,
+ id: `${SINKHOLE_YEAR_NODE_PREFIX}${currentYear}`,
+ lyrNm: `${currentYear}년`,
+ upperLyrSn: SINKHOLE_CONTROL_NODE_ID,
+ upId: SINKHOLE_CONTROL_NODE_ID,
+ sortOrdr: "1",
+ drawOrdr: null,
+ flterSql: null,
+ gobjTy: "",
+ lyrTyNm: SINKHOLE_LAYER_TYPE,
+ sinkholeYear: String(currentYear),
+ useYn: "Y",
+ minViewSize: null,
+ iconNm: null,
+ iconSize: null,
+ lblAtrbNm: null,
+ fontNm: null,
+ fontIntnColor: null,
+ fontExtnColor: null,
+ fontExtnWdth: null,
+ lnWdth: null,
+ lnColor: null,
+ polgnColor: null,
+ initEprssYn: "Y",
+ clickPsblYn: "N",
+ exprsYn: "Y",
+ cmncNm: "all",
+ srvcNm: "api",
+ actlLyrYn: "N",
+ clckZoom: null,
+ children: null,
+ },
+ {
+ lyrSn: SINKHOLE_ALL_YEAR_NODE_ID,
+ id: SINKHOLE_ALL_YEAR_NODE_ID,
+ lyrNm: "전체",
+ upperLyrSn: SINKHOLE_CONTROL_NODE_ID,
+ upId: SINKHOLE_CONTROL_NODE_ID,
+ sortOrdr: "99",
+ drawOrdr: null,
+ flterSql: null,
+ gobjTy: "",
+ lyrTyNm: SINKHOLE_LAYER_TYPE,
+ sinkholeYear: "ALL",
+ useYn: "Y",
+ minViewSize: null,
+ iconNm: null,
+ iconSize: null,
+ lblAtrbNm: null,
+ fontNm: null,
+ fontIntnColor: null,
+ fontExtnColor: null,
+ fontExtnWdth: null,
+ lnWdth: null,
+ lnColor: null,
+ polgnColor: null,
+ initEprssYn: "Y",
+ clickPsblYn: "N",
+ exprsYn: "Y",
+ cmncNm: "all",
+ srvcNm: "api",
+ actlLyrYn: "N",
+ clckZoom: null,
+ children: null,
+ },
+ ];
+};
+
+export const applySinkholeNodeFilters = (filters: SinkholeFilters, node: any) => {
+ const data = node?.data ?? node;
+ const sinkholeYear = String(data?.sinkholeYear ?? "").trim();
+ const filterSql = String(data?.flterSql ?? data?.filterSql ?? "").trim();
+
+ if (sinkholeYear === "ALL") {
+ return {
+ ...filters,
+ startYmd: "",
+ endYmd: "",
+ };
+ }
+
+ const rangeMatch = filterSql.match(
+ /ocrn_ymd\s*>=\s*'(\d{8})'.*ocrn_ymd\s*<=\s*'(\d{8})'/i,
+ );
+ if (rangeMatch) {
+ return {
+ ...filters,
+ startYmd: rangeMatch[1] ?? "",
+ endYmd: rangeMatch[2] ?? "",
+ };
+ }
+
+ if (/^\d{4}$/.test(sinkholeYear)) {
+ return {
+ ...filters,
+ startYmd: `${sinkholeYear}0101`,
+ endYmd: `${sinkholeYear}1231`,
+ };
+ }
+
+ return filters;
+};
+
+export const applySinkholeYearFilters = (filters: SinkholeFilters, checkedNodesData: any[]) => {
+ const selectedYears = checkedNodesData
+ .map((node) => node?.data ?? node)
+ .map((data) => String(data?.sinkholeYear ?? ""))
+ .filter(Boolean);
+
+ if (selectedYears.includes("ALL")) {
+ return {
+ ...filters,
+ startYmd: "",
+ endYmd: "",
+ };
+ }
+
+ if (selectedYears.length === 0) {
+ return filters;
+ }
+
+ const numericYears = selectedYears
+ .map((year) => Number(year))
+ .filter((year) => Number.isFinite(year))
+ .sort((left, right) => left - right);
+
+ if (numericYears.length === 0) {
+ return filters;
+ }
+
+ return {
+ ...filters,
+ startYmd: `${numericYears[0]}0101`,
+ endYmd: `${numericYears[numericYears.length - 1]}1231`,
+ };
+};
+
+export const SINKHOLE_RESTORE_STATUS_OPTIONS = [
+ { value: "0", label: "전체" },
+ { value: "복구완료", label: "복구완료" },
+ { value: "복구중", label: "복구중" },
+ { value: "미복구", label: "미복구" },
+] as const;
+
+export const SINKHOLE_EXCEL_HEADERS: Record = {
+ rowNo: "NO",
+ ocrnYmd: "발생일자",
+ fullAddress: "주소",
+ sizeWidth: "발생규모폭",
+ sizeLength: "발생규모연장",
+ sizeDepth: "발생규모깊이",
+ detailCause: "상세발생원인",
+ restoreStatus: "복구상태",
+ coordStatus: "좌표보정상태",
+ restoreCompletedYmd: "복구완료일자",
+};
diff --git a/apps/sn/app/(map-layout)/map/page.tsx b/apps/sn/app/(map-layout)/map/page.tsx
index 508d8167a..6685dff0a 100644
--- a/apps/sn/app/(map-layout)/map/page.tsx
+++ b/apps/sn/app/(map-layout)/map/page.tsx
@@ -24,6 +24,7 @@ import { usePathname } from "next/navigation";
import Collection from "ol/Collection.js";
import Feature from "ol/Feature.js";
import GeoJSON from "ol/format/GeoJSON.js";
+import CircleGeom from "ol/geom/Circle.js";
import Draw from "ol/interaction/Draw.js";
import Translate from "ol/interaction/Translate.js";
import Fill from "ol/style/Fill.js";
@@ -49,6 +50,7 @@ import { Button } from "@common/components";
import { getData, getRawJson, postRawJson } from "../../components/lib/api";
import useSearchModalStore from "@/store/useSearchModalStore";
import useStore from "@/store/useStore";
+import { useUserStore } from "@/shared/lib/use-user-store";
import AgedPipeLayerSettingPanel from "./components/agedPipe/AgedPipeLayerSettingPanel";
import GisEditToolbar from "./components/gisEdit/GisEditToolbar";
@@ -75,6 +77,35 @@ import {
validateElapsedYears,
} from "./components/agedPipe/agedPipeUtils";
import { downloadAgedPipeCsv } from "./components/agedPipe/agedPipeExport";
+import SinkholeDetailPanel from "./components/sinkhole/SinkholeDetailPanel";
+import SinkholeLayerSettingPanel from "./components/sinkhole/SinkholeLayerSettingPanel";
+import {
+ applySinkholeNodeFilters,
+ applySinkholeYearFilters,
+ buildSinkholeYearNodes,
+ buildSinkholeDefaultFilters,
+ buildSinkholeListQueryString,
+ buildSinkholeScope,
+ isSinkholeLayerNode,
+ isSinkholeRootNode,
+ isSinkholeYearNode,
+ normalizeSinkholeFilters,
+ SINKHOLE_CONTROL_NODE_ID,
+ SINKHOLE_DEFAULT_RADIUS,
+ SINKHOLE_FILTER_SYNC_MESSAGE,
+ SINKHOLE_LAYER_ID,
+ SINKHOLE_LAYER_NAME,
+ SINKHOLE_LAYER_TYPE,
+ SINKHOLE_POPUP_KEY,
+ SINKHOLE_ROW_SELECT_MESSAGE,
+ SINKHOLE_SELECTED_LAYER_ID,
+ SINKHOLE_SYNC_COMPLETED_MESSAGE,
+ type SinkholeDetail,
+ type SinkholeFilters,
+ type SinkholeListItem,
+ type SinkholeNearbyPipe,
+ type SinkholeSyncSummary,
+} from "./components/sinkhole/sinkholeTypes";
import FeatureClickEventPopup from "./components/popupComponent/featureClickEventPopup";
import SearchModal from "./searchModal/searchModal";
import { WATER_DEPTH_LAYER_TYPES, WaterDepth } from "./waterDepth/waterDepth";
@@ -100,6 +131,7 @@ const AGED_PIPE_HIGHLIGHT_LAYER_ID = "SN_AGED_PIPE_HIGHLIGHT";
const AGED_PIPE_ROW_SELECT_MESSAGE = "SN_AGED_PIPE_ROW_SELECT";
const AGED_PIPE_POPUP_MINIMIZE_MESSAGE = "SN_AGED_PIPE_POPUP_MINIMIZE";
const AGED_PIPE_FILTER_SYNC_MESSAGE = "SN_AGED_PIPE_FILTER_SYNC";
+const SINKHOLE_DEFAULT_POINT_LIMIT = 2000;
const SOUTH_KOREA_VIEW_EXTENT: [number, number, number, number] = [
720000,
1445000,
@@ -208,6 +240,35 @@ const getFeatureCollection = (payload: any) => {
return { type: "FeatureCollection", features: [] };
};
+// 지반침하 목록 API가 정상일 때는 x/y를 바로 Point feature로 바꿔 geometry 전용 API 장애를 우회할 수 있다.
+const buildSinkholeFeatureCollectionFromItems = (items: SinkholeListItem[]) => ({
+ type: "FeatureCollection",
+ features: items
+ .map((item) => {
+ const x = Number(item?.x);
+ const y = Number(item?.y);
+ if (!Number.isFinite(x) || !Number.isFinite(y)) {
+ return null;
+ }
+
+ return {
+ type: "Feature",
+ id: `${SINKHOLE_LAYER_TYPE}.${String(item?.acdntNo ?? "").trim()}`,
+ geometry: {
+ type: "Point",
+ coordinates: [x, y],
+ },
+ properties: {
+ ...item,
+ lyrTypeNm: SINKHOLE_LAYER_TYPE,
+ x,
+ y,
+ },
+ };
+ })
+ .filter(Boolean),
+});
+
// 현재 지도 화면 BBOX 주변을 함께 조회해 이동 직후 가장자리 유하방향이 비어 보이는 현상을 줄인다.
const expandFlowDirectionExtent = (extent: number[]) => {
const [minX = 0, minY = 0, maxX = 0, maxY = 0] = extent;
@@ -658,6 +719,103 @@ const findInvalidPipeRequiredChange = (changes: Array<{ changeId: string; editTy
return !mngInstCd || !fcltMngNo || /^NEW-/i.test(fcltMngNo) || !instMngNo || /^NEW-/i.test(instMngNo) || !usgCd;
});
+const getSinkholeAccidentId = (data: any) =>
+ String(
+ data?.acdntNo ??
+ data?.values_?.acdntNo ??
+ data?.get?.("acdntNo") ??
+ data?.properties?.acdntNo ??
+ "",
+ ).trim();
+
+const getSinkholePointFromSelection = (data: any): { x: number; y: number } | null => {
+ const directX = Number(
+ data?.x ??
+ data?.values_?.x ??
+ data?.get?.("x") ??
+ data?.properties?.x,
+ );
+ const directY = Number(
+ data?.y ??
+ data?.values_?.y ??
+ data?.get?.("y") ??
+ data?.properties?.y,
+ );
+ if (Number.isFinite(directX) && Number.isFinite(directY)) {
+ return { x: directX, y: directY };
+ }
+
+ const geometry = data?.getGeometry?.();
+ if (geometry?.getType?.() === "Point") {
+ const coordinates = geometry.getCoordinates?.();
+ const x = Number(coordinates?.[0]);
+ const y = Number(coordinates?.[1]);
+ if (Number.isFinite(x) && Number.isFinite(y)) {
+ return { x, y };
+ }
+ }
+
+ return null;
+};
+
+const createSinkholePointStyle = (selected = false) =>
+ new Style({
+ image: new CircleStyle({
+ radius: selected ? 9 : 7,
+ fill: new Fill({
+ color: selected ? "rgba(255, 138, 0, 0.92)" : "rgba(214, 102, 31, 0.88)",
+ }),
+ stroke: new Stroke({
+ color: selected ? "rgba(120, 53, 15, 0.98)" : "rgba(255, 255, 255, 0.95)",
+ width: selected ? 2.6 : 2,
+ }),
+ }),
+ zIndex: selected ? 9997 : 9994,
+ });
+
+const createSinkholeRadiusStyle = () =>
+ new Style({
+ stroke: new Stroke({
+ color: "rgba(214, 102, 31, 0.75)",
+ width: 2.2,
+ lineDash: [8, 6],
+ }),
+ fill: new Fill({
+ color: "rgba(251, 146, 60, 0.12)",
+ }),
+ zIndex: 9993,
+ });
+
+const createSinkholeFocusedPipeStyle = () => [
+ new Style({
+ stroke: new Stroke({
+ color: "rgba(88, 28, 135, 0.22)",
+ width: 18,
+ lineCap: "round",
+ lineJoin: "round",
+ }),
+ zIndex: 9997,
+ }),
+ new Style({
+ stroke: new Stroke({
+ color: "rgba(255, 255, 255, 0.96)",
+ width: 12,
+ lineCap: "round",
+ lineJoin: "round",
+ }),
+ zIndex: 9998,
+ }),
+ new Style({
+ stroke: new Stroke({
+ color: "rgba(37, 99, 235, 0.98)",
+ width: 8,
+ lineCap: "round",
+ lineJoin: "round",
+ }),
+ zIndex: 9999,
+ }),
+];
+
const formatWaterRiskPipeField = (value: unknown, suffix: string) => {
const normalized = String(value ?? "").trim();
if (!normalized) return "-";
@@ -1522,10 +1680,112 @@ const normalizeTreeRowSpacing = (data: any[]) => {
});
};
+const appendSinkholeControlNode = (data: any[]) => {
+ if (!Array.isArray(data)) return data;
+ const existingRoot = data.find((item) => {
+ const nodeId = String(item?.lyrSn ?? item?.id ?? "");
+ const layerName = String(item?.lyrNm ?? item?.name ?? "").trim();
+ const layerTypeName = String(item?.lyrTyNm ?? item?.lyrTypeNm ?? item?.lyr_type_nm ?? "").trim();
+ return nodeId === SINKHOLE_CONTROL_NODE_ID || layerName === SINKHOLE_LAYER_NAME || layerTypeName === SINKHOLE_LAYER_TYPE;
+ });
+
+ const existingRootId = existingRoot?.lyrSn ?? existingRoot?.id ?? SINKHOLE_CONTROL_NODE_ID;
+ const existingChildren = data.filter((item) => {
+ const upperId = item?.upperLyrSn ?? item?.upId ?? null;
+ return upperId === existingRootId;
+ });
+
+ if (existingRoot && existingChildren.length > 0) {
+ return data.map((item) => {
+ const nodeId = String(item?.lyrSn ?? item?.id ?? "");
+ if (nodeId !== existingRootId) return item;
+ return {
+ ...item,
+ gobjTy: "",
+ iconNm: null,
+ clickPsblYn: "N",
+ actlLyrYn: "N",
+ };
+ });
+ }
+
+ const filtered = data.filter((item) => {
+ const nodeId = String(item?.lyrSn ?? item?.id ?? "");
+ const upperId = String(item?.upperLyrSn ?? item?.upId ?? "");
+ const layerName = String(item?.lyrNm ?? item?.name ?? "").trim();
+ const layerTypeName = String(item?.lyrTyNm ?? item?.lyrTypeNm ?? item?.lyr_type_nm ?? "").trim();
+
+ if (String(nodeId) === String(existingRootId)) return false;
+ if (String(upperId) === String(existingRootId)) return false;
+ if (!existingRoot && nodeId === SINKHOLE_CONTROL_NODE_ID) return false;
+ if (!existingRoot && upperId === SINKHOLE_CONTROL_NODE_ID) return false;
+ if (!existingRoot && layerName === SINKHOLE_LAYER_NAME) return false;
+ if (!existingRoot && layerTypeName === SINKHOLE_LAYER_TYPE) return false;
+ return true;
+ });
+
+ const rootNode = existingRoot
+ ? {
+ ...existingRoot,
+ lyrSn: existingRootId,
+ id: existingRootId,
+ gobjTy: "",
+ iconNm: null,
+ clickPsblYn: "N",
+ actlLyrYn: "N",
+ }
+ : {
+ lyrSn: SINKHOLE_CONTROL_NODE_ID,
+ id: SINKHOLE_CONTROL_NODE_ID,
+ lyrNm: SINKHOLE_LAYER_NAME,
+ upperLyrSn: null,
+ upId: null,
+ sortOrdr: "3",
+ drawOrdr: null,
+ flterSql: null,
+ gobjTy: "",
+ lyrTyNm: SINKHOLE_LAYER_TYPE,
+ useYn: "Y",
+ minViewSize: null,
+ iconNm: null,
+ iconSize: null,
+ lblAtrbNm: null,
+ fontNm: null,
+ fontIntnColor: null,
+ fontExtnColor: null,
+ fontExtnWdth: null,
+ lnWdth: null,
+ lnColor: null,
+ polgnColor: null,
+ initEprssYn: "Y",
+ clickPsblYn: "N",
+ exprsYn: "Y",
+ cmncNm: "all",
+ srvcNm: "api",
+ actlLyrYn: "N",
+ clckZoom: null,
+ children: null,
+ };
+
+ const yearNodes = buildSinkholeYearNodes().map((item) => ({
+ ...item,
+ upperLyrSn: existingRootId,
+ upId: existingRootId,
+ }));
+
+ return [
+ ...filtered,
+ rootNode,
+ ...yearNodes,
+ ];
+};
+
const Map = () => {
const pathname = usePathname();
const flowDirectionMode = useMemo(() => getFlowDirectionModeByPathname(pathname), [pathname]);
const { isSearchModalOpen, setIsSearchModalOpen } = useSearchModalStore();
+ const userInfo = useUserStore((state) => state.userInfo);
+ const sinkholeScope = useMemo(() => buildSinkholeScope(userInfo), [userInfo]);
const [treeData, setTreeData] = useState([]); // 초기값을 객체 또는 null로 설정
const [layerLoadError, setLayerLoadError] = useState(null);
@@ -1536,10 +1796,19 @@ const Map = () => {
const [isPlaying, setIsPlaying] = useState(false);
const [mapReady, setMapReady] = useState(false);
const [isAgedPipeChecked, setIsAgedPipeChecked] = useState(false);
+ const [isSinkholeChecked, setIsSinkholeChecked] = useState(false);
const [draftAgedPipeFilters, setDraftAgedPipeFilters] =
useState(AGED_PIPE_DEFAULT_FILTERS);
const [appliedAgedPipeFilters, setAppliedAgedPipeFilters] =
useState(AGED_PIPE_DEFAULT_FILTERS);
+ const [appliedSinkholeFilters, setAppliedSinkholeFilters] = useState(() =>
+ buildSinkholeDefaultFilters(sinkholeScope),
+ );
+ const [sinkholeRadiusMeters, setSinkholeRadiusMeters] = useState(SINKHOLE_DEFAULT_RADIUS);
+ const [selectedSinkholeDetail, setSelectedSinkholeDetail] = useState(null);
+ const [selectedSinkholeNearbyPipes, setSelectedSinkholeNearbyPipes] = useState([]);
+ const [lastSinkholeSyncSummary, setLastSinkholeSyncSummary] = useState(null);
+ const [sinkholeSelectionVersion, setSinkholeSelectionVersion] = useState(0);
const [isAgedPipeListOpen, setIsAgedPipeListOpen] = useState(false);
const [isAgedPipeListMinimized, setIsAgedPipeListMinimized] = useState(false);
const [agedPipeRows, setAgedPipeRows] = useState([]);
@@ -1553,6 +1822,7 @@ const Map = () => {
const gisEdit = useGisEdit(treeData);
const shouldFocusAgedPipeOnNextSelectRef = useRef(false);
const agedPipePopupWindowRef = useRef(null);
+ const sinkholePopupWindowRef = useRef(null);
const pipeAnalysisPopupWindowRef = useRef(null);
const gisEditSessionPopupWindowRef = useRef(null);
const gisEditSessionPopupCloseWatcherRef = useRef(null);
@@ -1562,6 +1832,13 @@ const Map = () => {
const gisEditIsEditModeRef = useRef(false);
const waterRiskPopupWindowRef = useRef(null);
const waterRiskPopupCloseWatcherRef = useRef(null);
+ const sinkholeLayerRef = useRef | null>(null);
+ const sinkholeSourceRef = useRef(null);
+ const sinkholeSelectedLayerRef = useRef | null>(null);
+ const sinkholeSelectedSourceRef = useRef(null);
+ const sinkholeFocusedPipeLayerRef = useRef | null>(null);
+ const sinkholeFocusedPipeSourceRef = useRef(null);
+ const restoreSinkholeDetailOnCloseRef = useRef(false);
// 유하방향 레이어 체크 여부를 React 렌더링 흐름에 반영하기 위한 state이다.
const [isFlowDirectionChecked, setIsFlowDirectionChecked] = useState(false);
// 체크된 유하방향 트리 노드의 레이어 설정을 보관해 API 조회와 vector layer 스타일에 사용한다.
@@ -1844,6 +2121,11 @@ const Map = () => {
fetchData();
}, []);
+ useEffect(() => {
+ const scopedFilters = normalizeSinkholeFilters(appliedSinkholeFilters, sinkholeScope);
+ setAppliedSinkholeFilters(scopedFilters);
+ }, [sinkholeScope]);
+
useEffect(() => {
const timer = window.setInterval(() => {
if (gisMaps.current) {
@@ -1976,11 +2258,7 @@ const Map = () => {
const fetchData = async () => {
try {
const data = await getRawJson("/sewerage-service/api/v1/map/lyrStngs/SN_NETWORK");
- setTreeData(
- appendAgedPipeControlNode(
- normalizeTreeRowSpacing(normalizeFlowDirectionLayerInfos(data)),
- ),
- );
+ setTreeData(appendAgedPipeControlNode(normalizeFlowDirectionLayerInfos(data)));
setLayerLoadError(null);
} catch (error) {
const message =
@@ -2642,6 +2920,15 @@ const Map = () => {
return;
}
+ if (clickedLayerTypeName === SINKHOLE_LAYER_TYPE) {
+ restoreSinkholeDetailOnCloseRef.current = false;
+ const acdntNo = getSinkholeAccidentId(data);
+ if (acdntNo) {
+ void loadSinkholeDetail(acdntNo, false, getSinkholePointFromSelection(data));
+ }
+ return;
+ }
+
// 편집 도구가 켜져 있을 때는 상세 팝업보다 도구별 세션 처리를 우선한다.
// ADD는 Draw interaction만 geometry를 받아야 하므로 기존 관로 선택 이벤트는 무시한다.
let editSelection: any = gisEdit.registerFeatureSelection(data);
@@ -2845,6 +3132,9 @@ const Map = () => {
console.warn("OpenLayers Feature를 찾을 수 없습니다:", data);
}
+ restoreSinkholeDetailOnCloseRef.current =
+ clickedLayerTypeName === "tb_ms_swage_ppl" && Boolean(selectedSinkholeDetail);
+
setFeatureData(data);
setIsOpen(true);
setIsSearchModalOpen(false);
@@ -2953,6 +3243,356 @@ const Map = () => {
openAgedPipePopupWindow();
}, [openAgedPipePopupWindow]);
+ const removeSinkholeLayer = useCallback(() => {
+ const core = GisApp.Module.core as any;
+ core?.deleteLayer?.(SINKHOLE_LAYER_ID);
+ sinkholeLayerRef.current = null;
+ sinkholeSourceRef.current = null;
+ }, []);
+
+ const ensureSinkholeLayer = useCallback(() => {
+ const map = gisMaps.current;
+ if (!map) return null;
+
+ if (sinkholeLayerRef.current && sinkholeSourceRef.current) {
+ return sinkholeSourceRef.current;
+ }
+
+ const source = new VectorSource();
+ const layer = new VectorLayer({
+ source,
+ zIndex: 9992,
+ updateWhileAnimating: false,
+ updateWhileInteracting: false,
+ });
+
+ layer.set("id", SINKHOLE_LAYER_ID);
+ layer.set("lyrNm", SINKHOLE_LAYER_NAME);
+ layer.set("lyrTyNm", SINKHOLE_LAYER_TYPE);
+ layer.set("clickPsblYn", "Y");
+ layer.set("chcYn", "N");
+
+ const core = GisApp.Module.core as any;
+ core?.deleteLayer?.(SINKHOLE_LAYER_ID);
+ map.addLayer(layer);
+ sinkholeLayerRef.current = layer;
+ sinkholeSourceRef.current = source;
+ return source;
+ }, []);
+
+ const clearSinkholeSelectionLayer = useCallback(() => {
+ const core = GisApp.Module.core as any;
+ core?.deleteLayer?.(SINKHOLE_SELECTED_LAYER_ID);
+ sinkholeSelectedLayerRef.current = null;
+ sinkholeSelectedSourceRef.current = null;
+ }, []);
+
+ const clearSinkholeFocusedPipeLayer = useCallback(() => {
+ const core = GisApp.Module.core as any;
+ core?.deleteLayer?.("SN_SINKHOLE_FOCUSED_PIPE_LAYER");
+ sinkholeFocusedPipeLayerRef.current = null;
+ sinkholeFocusedPipeSourceRef.current = null;
+ }, []);
+
+ const ensureSinkholeSelectionLayer = useCallback(() => {
+ const map = gisMaps.current;
+ if (!map) return null;
+
+ if (sinkholeSelectedLayerRef.current && sinkholeSelectedSourceRef.current) {
+ return sinkholeSelectedSourceRef.current;
+ }
+
+ const source = new VectorSource();
+ const layer = new VectorLayer({
+ source,
+ zIndex: 9996,
+ updateWhileAnimating: false,
+ updateWhileInteracting: false,
+ });
+
+ layer.set("id", SINKHOLE_SELECTED_LAYER_ID);
+ layer.set("lyrNm", `${SINKHOLE_LAYER_NAME}-선택`);
+ layer.set("lyrTyNm", SINKHOLE_LAYER_TYPE);
+ layer.set("clickPsblYn", "N");
+
+ const core = GisApp.Module.core as any;
+ core?.deleteLayer?.(SINKHOLE_SELECTED_LAYER_ID);
+ map.addLayer(layer);
+ sinkholeSelectedLayerRef.current = layer;
+ sinkholeSelectedSourceRef.current = source;
+ return source;
+ }, []);
+
+ const ensureSinkholeFocusedPipeLayer = useCallback(() => {
+ const map = gisMaps.current;
+ if (!map) return null;
+
+ if (sinkholeFocusedPipeLayerRef.current && sinkholeFocusedPipeSourceRef.current) {
+ return sinkholeFocusedPipeSourceRef.current;
+ }
+
+ const source = new VectorSource();
+ const layer = new VectorLayer({
+ source,
+ zIndex: 9999,
+ updateWhileAnimating: false,
+ updateWhileInteracting: false,
+ });
+
+ layer.set("id", "SN_SINKHOLE_FOCUSED_PIPE_LAYER");
+ layer.set("lyrNm", "지반침하-관로강조");
+ layer.set("lyrTyNm", "tb_ms_swage_ppl");
+ layer.set("clickPsblYn", "N");
+
+ const core = GisApp.Module.core as any;
+ core?.deleteLayer?.("SN_SINKHOLE_FOCUSED_PIPE_LAYER");
+ map.addLayer(layer);
+ sinkholeFocusedPipeLayerRef.current = layer;
+ sinkholeFocusedPipeSourceRef.current = source;
+ return source;
+ }, []);
+
+ const renderSelectedSinkhole = useCallback(
+ (detail: SinkholeDetail | null, radiusMeters: number) => {
+ if (!detail || detail.x == null || detail.y == null) {
+ clearSinkholeSelectionLayer();
+ return;
+ }
+
+ const source = ensureSinkholeSelectionLayer();
+ if (!source) return;
+ source.clear();
+
+ const pointFeature = new Feature({
+ geometry: new Point([detail.x, detail.y]),
+ });
+ pointFeature.setStyle(createSinkholePointStyle(true));
+
+ const radiusFeature = new Feature({
+ geometry: new CircleGeom([detail.x, detail.y], radiusMeters),
+ });
+ radiusFeature.setStyle(createSinkholeRadiusStyle());
+
+ source.addFeatures([radiusFeature, pointFeature]);
+ },
+ [clearSinkholeSelectionLayer, ensureSinkholeSelectionLayer],
+ );
+
+ const focusSinkholeOnMap = useCallback((detail: SinkholeDetail, radiusMeters: number) => {
+ if (!gisMaps.current || detail.x == null || detail.y == null) return;
+
+ const radiusGeometry = new CircleGeom([detail.x, detail.y], radiusMeters);
+ gisMaps.current.getView?.().fit?.(radiusGeometry.getExtent(), {
+ duration: 350,
+ padding: [100, 380, 100, 120],
+ maxZoom: 17,
+ constrainResolution: true,
+ nearest: true,
+ });
+ }, []);
+
+ const buildSinkholeQueryString = useCallback(
+ (filters: SinkholeFilters, page = 0, size = SINKHOLE_DEFAULT_POINT_LIMIT, checkedNodesData = checkedNodesDataRef.current) =>
+ buildSinkholeListQueryString(applySinkholeYearFilters(filters, checkedNodesData), ctpv, sgg, page, size),
+ [ctpv, sgg],
+ );
+
+ const loadSinkholeLayer = useCallback(
+ async (filters = appliedSinkholeFilters) => {
+ if (!mapReady || !gisMaps.current || !isSinkholeChecked) return;
+
+ const source = ensureSinkholeLayer();
+ if (!source) return;
+
+ const normalized = normalizeSinkholeFilters(filters, sinkholeScope);
+ const effectiveFilters = applySinkholeYearFilters(normalized, checkedNodesDataRef.current);
+ try {
+ const params = new URLSearchParams(buildSinkholeQueryString(effectiveFilters, 0, SINKHOLE_DEFAULT_POINT_LIMIT));
+ const rawResponse = await getRawJson(
+ `/sewerage-service/api/v1/sinkholes?${params.toString()}`,
+ );
+ const items = Array.isArray(rawResponse?.data?.items)
+ ? (rawResponse.data.items as SinkholeListItem[])
+ : Array.isArray(rawResponse?.items)
+ ? (rawResponse.items as SinkholeListItem[])
+ : [];
+ const featureCollection = buildSinkholeFeatureCollectionFromItems(items);
+
+ if (!featureCollection) {
+ console.warn("지반침하 목록 응답을 feature collection으로 변환하지 못했습니다.", rawResponse);
+ source.clear();
+ return;
+ }
+
+ const features = new GeoJSON().readFeatures(featureCollection, {
+ dataProjection: "EPSG:5179",
+ featureProjection: GisApp.TO_PROJ,
+ });
+ source.clear();
+ features.forEach((feature: any) => {
+ feature.setStyle(createSinkholePointStyle(false));
+ });
+ source.addFeatures(features);
+ } catch (error) {
+ console.error("지반침하 레이어 조회 실패:", error);
+ source.clear();
+ }
+ },
+ [appliedSinkholeFilters, buildSinkholeQueryString, ensureSinkholeLayer, isSinkholeChecked, mapReady, sinkholeScope],
+ );
+
+ const closeSinkholeDetail = useCallback(() => {
+ setSelectedSinkholeDetail(null);
+ setSelectedSinkholeNearbyPipes([]);
+ clearSinkholeSelectionLayer();
+ clearSinkholeFocusedPipeLayer();
+ restoreSinkholeDetailOnCloseRef.current = false;
+ if (getSelectedFeatureLayerTypeName(featureData) === SINKHOLE_LAYER_TYPE) {
+ setFeatureData(null);
+ setIsOpen(false);
+ }
+ }, [clearSinkholeFocusedPipeLayer, clearSinkholeSelectionLayer, featureData]);
+
+ const loadSinkholeDetail = useCallback(
+ async (acdntNo: string, focusMap = true, fallbackPoint?: { x: number; y: number } | null) => {
+ if (!acdntNo) return;
+
+ try {
+ const detailResponse = await getRawJson(
+ `/sewerage-service/api/v1/sinkholes/${encodeURIComponent(acdntNo)}`,
+ );
+ const detail = ((detailResponse?.data ?? detailResponse) as SinkholeDetail);
+ const resolvedPoint =
+ detail.x != null && detail.y != null
+ ? { x: detail.x, y: detail.y }
+ : fallbackPoint && Number.isFinite(fallbackPoint.x) && Number.isFinite(fallbackPoint.y)
+ ? fallbackPoint
+ : null;
+
+ const nearbyRawResponse = resolvedPoint
+ ? await getRawJson(
+ `/sewerage-service/api/v1/sinkholes/nearbyPipesByPoint?x=${resolvedPoint.x}&y=${resolvedPoint.y}&radiusMeters=${sinkholeRadiusMeters}`,
+ )
+ : await getRawJson(
+ `/sewerage-service/api/v1/sinkholes/${encodeURIComponent(acdntNo)}/nearbyPipes?radiusMeters=${sinkholeRadiusMeters}`,
+ );
+ const nearbyResponse = nearbyRawResponse?.data ?? nearbyRawResponse;
+ const nearbyPipes = Array.isArray(nearbyResponse?.items)
+ ? (nearbyResponse.items as SinkholeNearbyPipe[])
+ : [];
+ const normalizedDetail = resolvedPoint
+ ? {
+ ...detail,
+ x: resolvedPoint.x,
+ y: resolvedPoint.y,
+ coordStatus: "SUCCESS",
+ }
+ : detail;
+
+ setSelectedSinkholeDetail(normalizedDetail);
+ setSelectedSinkholeNearbyPipes(nearbyPipes);
+ renderSelectedSinkhole(normalizedDetail, sinkholeRadiusMeters);
+ setFeatureData({
+ lyrTypeNm: SINKHOLE_LAYER_TYPE,
+ acdntNo: normalizedDetail.acdntNo,
+ });
+ setIsOpen(true);
+ setIsSearchModalOpen(false);
+
+ if (focusMap && normalizedDetail.x != null && normalizedDetail.y != null) {
+ focusSinkholeOnMap(normalizedDetail, sinkholeRadiusMeters);
+ }
+ } catch (error) {
+ console.error("지반침하 상세 조회 중 오류:", error);
+ alert("지반침하 상세 정보를 불러오지 못했습니다.");
+ }
+ },
+ [focusSinkholeOnMap, renderSelectedSinkhole, setIsSearchModalOpen, sinkholeRadiusMeters],
+ );
+
+ const applySinkholeRadius = useCallback(
+ async (radiusMeters: number) => {
+ setSinkholeRadiusMeters(radiusMeters);
+ if (!selectedSinkholeDetail?.acdntNo) {
+ alert("반경을 적용할 지반침하 위치가 선택되지 않았습니다.");
+ return;
+ }
+
+ try {
+ const nearbyRawResponse = await getRawJson(
+ `/sewerage-service/api/v1/sinkholes/${encodeURIComponent(selectedSinkholeDetail.acdntNo)}/nearbyPipes?radiusMeters=${radiusMeters}`,
+ );
+ const nearbyResponse = nearbyRawResponse?.data ?? nearbyRawResponse;
+ setSelectedSinkholeNearbyPipes(
+ Array.isArray(nearbyResponse?.items) ? (nearbyResponse.items as SinkholeNearbyPipe[]) : [],
+ );
+ renderSelectedSinkhole(selectedSinkholeDetail, radiusMeters);
+ focusSinkholeOnMap(selectedSinkholeDetail, radiusMeters);
+ alert("분석 반경이 적용되었습니다.");
+ } catch (error) {
+ console.error("지반침하 반경 적용 중 오류:", error);
+ alert("반경 내 하수관로 정보를 다시 조회하지 못했습니다.");
+ }
+ },
+ [focusSinkholeOnMap, renderSelectedSinkhole, selectedSinkholeDetail],
+ );
+
+ const focusSinkholeNearbyPipe = useCallback(async (pipe: SinkholeNearbyPipe) => {
+ const fid = String(pipe?.fid ?? "").trim();
+ if (!fid) {
+ alert("표시할 관로 식별값이 없습니다.");
+ return;
+ }
+
+ try {
+ const source = ensureSinkholeFocusedPipeLayer();
+ if (!source) return;
+
+ const layerTypeName = String(pipe?.lyrTypeNm ?? "tb_ms_swage_ppl");
+ const params = new URLSearchParams({
+ SERVICE: "WFS",
+ VERSION: "1.1.0",
+ REQUEST: "GetFeature",
+ TYPENAME: `${GisApp.Module.layer.storageNm}${layerTypeName}`,
+ SRSNAME: GisApp.TO_PROJ,
+ OUTPUTFORMAT: "application/json",
+ FEATUREID: fid,
+ });
+ const response = await getRawJson(`${GisApp.GEOSERVER_URL}?${params.toString()}`);
+ const featureCollection = getFeatureCollection(response);
+ const features = new GeoJSON().readFeatures(featureCollection, {
+ dataProjection: GisApp.TO_PROJ,
+ featureProjection: GisApp.TO_PROJ,
+ });
+
+ source.clear();
+ features.forEach((feature: any) => feature.setStyle(createSinkholeFocusedPipeStyle()));
+ source.addFeatures(features);
+ const firstFeature = features[0];
+ if (firstFeature) {
+ restoreSinkholeDetailOnCloseRef.current = true;
+ setFeatureData(firstFeature);
+ setIsOpen(true);
+ setIsSearchModalOpen(false);
+ }
+ } catch (error) {
+ console.error("지반침하 반경 내 관로 지도 표시 실패:", error);
+ alert("선택한 관로를 지도에서 표시하지 못했습니다.");
+ }
+ }, [ensureSinkholeFocusedPipeLayer, setIsSearchModalOpen]);
+
+ const openSinkholePopupWindow = useCallback(() => {
+ const normalized = normalizeSinkholeFilters(appliedSinkholeFilters, sinkholeScope);
+ const effectiveFilters = applySinkholeYearFilters(normalized, checkedNodesDataRef.current);
+ const popup = openWindowPopup(SINKHOLE_POPUP_KEY as WindowPopupKey, effectiveFilters as Record);
+ if (!popup) {
+ alert("브라우저 팝업이 차단되었습니다. 팝업 허용 후 다시 시도해주세요.");
+ return null;
+ }
+ sinkholePopupWindowRef.current = popup;
+ return popup;
+ }, [appliedSinkholeFilters, sinkholeScope]);
+
const handleAgedPipeRowDoubleClick = useCallback(
async (row: AgedPipeRow) => {
try {
@@ -3056,6 +3696,37 @@ const Map = () => {
return () => window.removeEventListener("message", handleAgedPipePopupMessage);
}, [agedPipeTotalCount, handleAgedPipeRowDoubleClick, handlePipeAnalysisRowSelect]);
+ useEffect(() => {
+ const handleSinkholePopupMessage = (event: MessageEvent) => {
+ if (event.origin !== window.location.origin) return;
+
+ if (event.data?.type === SINKHOLE_FILTER_SYNC_MESSAGE && event.data?.filters) {
+ const normalized = normalizeSinkholeFilters(event.data.filters as SinkholeFilters, sinkholeScope);
+ setAppliedSinkholeFilters(normalized);
+ setSinkholeSelectionVersion((version) => version + 1);
+ return;
+ }
+
+ if (event.data?.type === SINKHOLE_ROW_SELECT_MESSAGE && event.data?.row) {
+ const row = event.data.row as SinkholeListItem;
+ const fallbackPoint =
+ row.x != null && row.y != null
+ ? { x: Number(row.x), y: Number(row.y) }
+ : null;
+ void loadSinkholeDetail(String(row.acdntNo ?? ""), true, fallbackPoint);
+ return;
+ }
+
+ if (event.data?.type === SINKHOLE_SYNC_COMPLETED_MESSAGE && event.data?.payload) {
+ setLastSinkholeSyncSummary(event.data.payload as SinkholeSyncSummary);
+ setSinkholeSelectionVersion((version) => version + 1);
+ }
+ };
+
+ window.addEventListener("message", handleSinkholePopupMessage);
+ return () => window.removeEventListener("message", handleSinkholePopupMessage);
+ }, [loadSinkholeDetail, sinkholeScope]);
+
// WaterDepth 표시 여부를 결정하는 함수
const handleWaterDepthVisibility = useCallback((checkedIds: string[], checkedNodesData: any[]) => {
const waterDepthLayers = checkedNodesData.filter(node =>
@@ -3105,7 +3776,16 @@ const Map = () => {
handleWaterDepthVisibility(checkedIds, checkedNodesData);
setIsAgedPipeChecked(checkedNodesData.some((node) => isAgedPipeLayerNode(node)));
- }, [handleWaterDepthVisibility, removeFlowDirectionLayer, retainFlowDirectionUsageCodes]);
+ const sinkholeChecked = checkedNodesData.some((node) => isSinkholeLayerNode(node));
+ setIsSinkholeChecked(sinkholeChecked);
+ if (sinkholeChecked) {
+ setSinkholeSelectionVersion((version) => version + 1);
+ }
+ if (!sinkholeChecked) {
+ removeSinkholeLayer();
+ closeSinkholeDetail();
+ }
+ }, [closeSinkholeDetail, handleWaterDepthVisibility, removeFlowDirectionLayer, removeSinkholeLayer, retainFlowDirectionUsageCodes]);
const handleOpenLayerPopup = useCallback(
(_layerNm: string, node?: any) => {
@@ -3113,14 +3793,34 @@ const Map = () => {
openAgedPipeList();
return false;
}
+ if (isSinkholeRootNode(node)) {
+ openSinkholePopupWindow();
+ return false;
+ }
+ if (isSinkholeYearNode(node)) {
+ return false;
+ }
return true;
},
- [openAgedPipeList],
+ [openAgedPipeList, openSinkholePopupWindow],
);
const inlineLayerSettingView = useCallback(
(node: any) => {
+ if (
+ isSinkholeYearNode(node) &&
+ String(node?.text ?? node?.data?.lyrNm ?? "").trim() === "전체"
+ ) {
+ return (
+
+ );
+ }
if (!isAgedPipeChecked || !isAgedPipeLayerNode(node)) return null;
return (
@@ -3131,7 +3831,15 @@ const Map = () => {
/>
);
},
- [draftAgedPipeFilters, handleApplyAgedPipeFilters, isAgedPipeChecked],
+ [
+ applySinkholeRadius,
+ draftAgedPipeFilters,
+ handleApplyAgedPipeFilters,
+ isAgedPipeChecked,
+ lastSinkholeSyncSummary,
+ sinkholeRadiusMeters,
+ userInfo?.adminRoleYn,
+ ],
);
useEffect(() => {
@@ -3576,6 +4284,7 @@ const Map = () => {
const currentChange = gisEditDetailChangeRef.current;
const currentFeatureData = gisEditDetailFeatureDataRef.current;
const isEditMode = gisEditIsEditModeRef.current;
+ const selectedLayerTypeName = getSelectedFeatureLayerTypeName(props.featureData);
if (isEditMode && currentChange && currentChange.layerId === "tb_ms_swage_ppl" && currentChange.editType !== "DELETE") {
return (
@@ -3591,17 +4300,57 @@ const Map = () => {
);
}
+ if (selectedLayerTypeName === SINKHOLE_LAYER_TYPE && selectedSinkholeDetail) {
+ return (
+ {
+ closeSinkholeDetail();
+ props.onClose?.();
+ }}
+ />
+ );
+ }
+
return (
{
+ const select = GisApp.Module.select as any;
setGisEditDetailChangeId(null);
+ const shouldRestoreSinkhole =
+ restoreSinkholeDetailOnCloseRef.current && Boolean(selectedSinkholeDetail);
+ restoreSinkholeDetailOnCloseRef.current = false;
+ select?.resetSelectedFeature?.();
+ clearSinkholeFocusedPipeLayer();
props.onClose?.();
+ if (shouldRestoreSinkhole && selectedSinkholeDetail) {
+ window.setTimeout(() => {
+ setFeatureData({
+ lyrTypeNm: SINKHOLE_LAYER_TYPE,
+ acdntNo: selectedSinkholeDetail.acdntNo,
+ });
+ setIsOpen(true);
+ setIsSearchModalOpen(false);
+ }, 0);
+ }
}}
/>
);
- }, [handleApplyGisEditPipeBasicInfo]);
+ }, [
+ closeSinkholeDetail,
+ clearSinkholeFocusedPipeLayer,
+ focusSinkholeNearbyPipe,
+ handleApplyGisEditPipeBasicInfo,
+ selectedSinkholeDetail,
+ selectedSinkholeNearbyPipes,
+ setIsSearchModalOpen,
+ sinkholeRadiusMeters,
+ ]);
useEffect(() => {
if (!mapReady || !gisMaps.current || !gisEdit.isEditMode) return;
@@ -4279,6 +5028,44 @@ const Map = () => {
}
}, [gisEdit.activeTool, gisEdit.isEditMode, removeGisEditDrawInteraction]);
+ useEffect(() => {
+ if (!mapReady || !isSinkholeChecked) {
+ removeSinkholeLayer();
+ return;
+ }
+
+ void loadSinkholeLayer(appliedSinkholeFilters);
+ }, [
+ appliedSinkholeFilters,
+ isSinkholeChecked,
+ loadSinkholeLayer,
+ mapReady,
+ removeSinkholeLayer,
+ sinkholeSelectionVersion,
+ ]);
+
+ useEffect(() => {
+ const popup = sinkholePopupWindowRef.current;
+ if (!popup || popup.closed) {
+ sinkholePopupWindowRef.current = null;
+ return;
+ }
+
+ const normalized = normalizeSinkholeFilters(appliedSinkholeFilters, sinkholeScope);
+ const effectiveFilters = applySinkholeYearFilters(normalized, checkedNodesDataRef.current);
+ popup.postMessage(
+ {
+ type: SINKHOLE_FILTER_SYNC_MESSAGE,
+ filters: effectiveFilters,
+ },
+ window.location.origin,
+ );
+ }, [appliedSinkholeFilters, sinkholeScope, sinkholeSelectionVersion]);
+
+ useEffect(() => {
+ renderSelectedSinkhole(selectedSinkholeDetail, sinkholeRadiusMeters);
+ }, [renderSelectedSinkhole, selectedSinkholeDetail, sinkholeRadiusMeters]);
+
return (
<>
@@ -4452,7 +5239,6 @@ const Map = () => {
}
waterDepth={showWaterDepth ? WaterDepth : undefined}
inlineLayerSettingView={inlineLayerSettingView}
- layerIconVisible={isAgedPipeLayerNode}
isPlaying={isPlaying}
setIsPlaying={setIsPlaying as any}
targetLayerTypes={WATER_DEPTH_LAYER_TYPES as any}
@@ -4463,6 +5249,7 @@ const Map = () => {
showFloatingSearchButton={false}
treeTogglePosition="top"
zoomGuide={zoomGuide}
+ layerIconVisible={(node: any) => isAgedPipeLayerNode(node) || isSinkholeRootNode(node)}
defaultZoom={7.5}
defaultLonLat={[127.75, 36]}
diff --git a/apps/sn/docs/작업검증/SFR-010-010-지반침하정보/001-qa-SFR-010-010-지반침하정보-통합검증계획.md b/apps/sn/docs/작업검증/SFR-010-010-지반침하정보/001-qa-SFR-010-010-지반침하정보-통합검증계획.md
new file mode 100644
index 000000000..0f96f672b
--- /dev/null
+++ b/apps/sn/docs/작업검증/SFR-010-010-지반침하정보/001-qa-SFR-010-010-지반침하정보-통합검증계획.md
@@ -0,0 +1,72 @@
+# SFR-010-010 지반침하정보 통합 검증 계획
+
+## 1. 문서 목적
+
+- `SFR-010-010 지반침하정보`의 검증 계획을 기능당 1개 문서로 누적 관리한다.
+- 이번 턴은 설계 단계이므로 구현 전 검증 시나리오와 차단 조건을 먼저 기록한다.
+- 승인 후 구현이 시작되면 이 문서에 라운드별 검증 계획을 계속 추가한다.
+
+## 2. 검증 기준 요약
+
+- 레이어 트리에서 `지반침하정보` 체크/해제가 동작해야 한다.
+- 목록 아이콘 클릭 시 지반침하 목록 팝업이 열려야 한다.
+- 목록 조회조건 검증이 동작해야 한다.
+ - 날짜 누락 차단
+ - 최대 1년 초과 차단
+- 목록 행 클릭 또는 지도 포인트 클릭 시 우측 상세 패널이 열려야 한다.
+- 반경 적용 시 지도 원과 반경 내 관로 목록이 함께 갱신돼야 한다.
+- 좌표 없음/좌표 변환 실패/반경 내 관로 없음 케이스가 서로 다른 안내로 분기돼야 한다.
+- 관리자만 동기화 버튼과 관련 운영 정보를 볼 수 있어야 한다.
+
+## 3. 라운드별 검증 계획
+
+### 3.1 설계 단계 사전 계획
+
+- FE 화면 구조 검증
+ - 레이어 트리 행 구성
+ - 반경 패널 위치
+ - 목록 팝업 열림 방식
+ - 우측 상세 패널 레이아웃
+- BE 계약 검증
+ - geometry/list/detail/nearby/sync/download endpoint 일치 여부
+ - 원천 부재 필드 nullable 처리 여부
+ - 관리자 권한 분리 여부
+- DB 영향 검증
+ - IL 원천 조회
+ - 반경 내 관로 조회 대상
+ - 좌표 캐시 영속화 필요 여부
+
+### 3.2 구현 후 예정 검증
+
+- 지반침하 레이어 체크/해제 시 지도 포인트 표출 여부
+- 목록 팝업 조회 / 결과 없음 / 다운로드 검증
+- 목록 행 클릭 후 지도 중심 이동과 상세 패널 오픈
+- 지도 포인트 클릭 후 상세 패널 오픈
+- 반경 값 변경 후 재조회
+- 좌표 없는 사고건 상세 표시
+- 관리자 동기화 성공/실패 검증
+
+## 4. 브라우저 검증 선행조건
+
+- `/map` 진입 가능한 로그인 상태
+- FE dev 서버와 BE API 동시 기동
+- IL 원천 데이터와 관로 데이터 접근 가능
+- 관리자/일반 사용자 계정 각각 1개 이상
+
+## 5. 차단 사유 분류 기준
+
+- `기능 결함`
+ - 화면 상태 전이 또는 API 응답 처리 오류
+- `인증 차단`
+ - 로그인/권한 부족
+- `환경 차단`
+ - 서버 미기동, 프록시, 네트워크 문제
+- `데이터 차단`
+ - 원천 데이터 또는 샘플 사고건 부족
+- `계약 미확정`
+ - 원천 부재 필드 처리, 캐시 정책, 팝업 방식 미확정
+
+## 6. 현재 보류 메모
+
+- 이번 턴은 설계 단계이므로 실제 브라우저/API 실행 검증은 수행하지 않는다.
+- 구현 승인 전에는 이 문서의 시나리오와 설계 문서의 계약 일치 여부만 점검 대상으로 둔다.
diff --git a/apps/sn/docs/작업검증/SFR-010-010-지반침하정보/002-qa-SFR-010-010-지반침하정보-통합검증결과.md b/apps/sn/docs/작업검증/SFR-010-010-지반침하정보/002-qa-SFR-010-010-지반침하정보-통합검증결과.md
new file mode 100644
index 000000000..116b875fa
--- /dev/null
+++ b/apps/sn/docs/작업검증/SFR-010-010-지반침하정보/002-qa-SFR-010-010-지반침하정보-통합검증결과.md
@@ -0,0 +1,58 @@
+# SFR-010-010 지반침하정보 통합 검증 결과
+
+## 1. 문서 목적
+
+- `SFR-010-010 지반침하정보`의 검증 결과를 기능당 1개 문서로 누적 관리한다.
+- 이번 턴은 설계 단계이므로 실행 결과 대신 사전 점검 결과와 미실행 사유를 기록한다.
+- 승인 후 구현과 실행 검증이 시작되면 이 문서에 라운드별 결과를 누적한다.
+
+## 2. 현재 수행 결과
+
+### 2.1 설계 자료 점검
+
+- 요구사항명세서, 시나리오, HTML, PNG를 읽고 화면 흐름과 API 초안을 정리했다.
+- 현재 백엔드 작업트리에서 아래 선반영 범위를 확인했다.
+ - `GET /api/v1/sinkholes/geometry`
+ - IL datasource 분리
+ - 주소 기반 지오코딩 서비스
+- 현재 프론트 코드에서는 `지반침하정보` 실구현이 없고, 실제 구현은 승인 후 착수해야 함을 확인했다.
+
+### 2.2 확인된 설계 리스크
+
+- 화면에 필요한 상세 필드 일부가 현재 원천 테이블에 없다.
+- 좌표 캐시가 현재 메모리 캐시라 최근 동기화 일시/상태 유지 요구를 그대로 만족하지 못한다.
+- 목록 팝업을 별도 popup 창으로 열지, `/map` 내부 모달로 둘지 구현 기준이 아직 확정되지 않았다.
+
+### 2.3 2026-06-05 런타임 원인 확인
+
+- 프론트에서 `GET /api/v1/sinkholes/geometry` 호출 시 500이 재현됐다.
+- 같은 시점에 로컬 `GET /api/v1/sinkholes`, `GET /api/v1/sinkholes/{acdntNo}`를 직접 확인한 결과 `geocodeErrorMessage`에 아래 예외가 내려왔다.
+ - `Unrecognized field "adresTy" ... SinkholeNgiiResponse`
+- 따라서 이번 런타임 장애의 1차 원인은 프론트 fetch 자체가 아니라 `reuse-service` 지오코딩 응답 필드 확장을 백엔드가 무시하지 못한 점으로 판정했다.
+- `./gradlew compileJava --no-daemon`는 시도했으나 로컬 점유 중인 `spring-configuration-metadata.json` 때문에 `Failed to clean up stale outputs`로 중단돼, 재기동 후 최종 확인이 필요하다.
+
+## 3. 미실행 항목
+
+- FE 브라우저 검증
+- BE API 호출 검증
+- 반경 내 관로 거리 계산 검증
+- 관리자 권한 분기 검증
+- 다운로드 파일 검증
+
+미실행 사유:
+
+- 작성자 승인 전 구현 금지 지시
+- 이번 턴 범위가 설계 및 문서 초안 작성까지로 제한됨
+
+## 4. 현재 상태 판정
+
+- 설계 검토: 진행
+- 코드 구현: 미착수
+- 브라우저/API 검증: 미실행
+
+## 5. 후속 실행 조건
+
+- 작성자 구현 승인
+- FE/BE 코드 반영 완료
+- 로그인 가능한 FE/BE 실행 환경 준비
+- 관리자/일반 사용자 테스트 계정 준비
diff --git a/apps/sn/docs/작업계획/SFR-010-010-지반침하정보/001-fe-SFR-010-010-지반침하정보-작업카드.md b/apps/sn/docs/작업계획/SFR-010-010-지반침하정보/001-fe-SFR-010-010-지반침하정보-작업카드.md
new file mode 100644
index 000000000..a0a0aeefd
--- /dev/null
+++ b/apps/sn/docs/작업계획/SFR-010-010-지반침하정보/001-fe-SFR-010-010-지반침하정보-작업카드.md
@@ -0,0 +1,192 @@
+# SFR-010-010 지반침하정보 작업카드
+
+## 1. 작업 개요
+
+- 작업 ID: SFR-010-010-FE
+- 작업명: 하수관망도 지반침하정보 프론트엔드 구현 계획
+- 상태: 설계
+- 작성일: 2026-06-02
+- 담당 역할: FE
+- 관련 역할: DE, BE, QA
+- 담당 범위: `apps/sn` 지도 화면에서 지반침하 레이어 체크/해제, 목록 팝업, 우측 상세 패널, 반경 적용, 관리자 동기화 버튼 노출 제어, BE API 연동 준비
+- 근거 문서:
+ - `COMMON_DOCS_ROOT/작업계획/SFR-010-010 지반침하정보/001-de-SFR-010-010-지반침하정보-설계.md`
+ - `COMMON_DOCS_ROOT/작업계획/SFR-010-010 지반침하정보/지반침하정보_요구사항명세서_v1_1.docx`
+ - `COMMON_DOCS_ROOT/작업계획/SFR-010-010 지반침하정보/지반침하정보-화면구성시나리오_v1_1.md`
+ - `COMMON_DOCS_ROOT/작업계획/SFR-010-010 지반침하정보/지반침하정보_업무검토시안_v1_1.html`
+ - `COMMON_DOCS_ROOT/작업계획/SFR-010-010 지반침하정보/지반침하정보_화면설계서.png`
+
+## 1-1. 공통 동기화 확인
+
+- 공통 작업현황판 확인 여부: 확인
+- 파일점유현황 확인 여부: 확인
+- 결정로그 확인 여부: 확인
+- 기존 진행 중 작업과의 관계:
+ - `map/page.tsx`는 노후관로, 유하방향표출, GIS편집 이력이 있어 충돌 주의가 필요하다.
+ - FE 문서 루트 전체는 문서 재정리 흔적이 있으므로 기존 경로/파일명은 유지한다.
+
+## 1-2. 최신 해석 메모
+
+- 현재 `apps/sn`에는 `지반침하정보` 실제 기능 구현이 없고, HTML 샘플 수준 흔적만 확인됐다.
+- 목록 팝업은 `노후관로` popup 패턴을, 우측 상세 패널은 `FeatureClickEventPopup`의 세로 패널 패턴을 우선 재사용한다.
+- 좌표 보정과 반경 내 관로 탐색은 프론트에서 계산하지 않고 `sewerage-service` 응답 기준으로만 처리한다.
+
+## 2. 작업 목적
+
+- 하수관망도 레이어 트리에서 `지반침하정보`를 실제 기능으로 연결한다.
+- 사용자는 목록 팝업에서 사고 이력을 조회하고, 행 클릭 또는 지도 포인트 클릭으로 상세정보와 반경 내 하수관로를 확인할 수 있어야 한다.
+- 관리자만 수동 동기화 버튼을 볼 수 있어야 하고, 일반 사용자는 조회/다운로드 중심 UX만 가져야 한다.
+- 실제 구현 전 문서 단계에서 FE 상태관리, 재사용 컴포넌트, API 연결 지점, 검증 포인트를 먼저 고정한다.
+
+## 3. 수정 대상 파일
+
+| 구분 | 파일 경로 | 수정 여부 | 근거 |
+| --- | --- | --- | --- |
+| 메인 화면 | `FE_APP_ROOT/app/(map-layout)/map/page.tsx` | 예정 | 레이어 트리, 지도 포인트, 반경 원, 상세 패널 상태 연결 |
+| 신규 컴포넌트 | `FE_APP_ROOT/app/(map-layout)/map/components/sinkhole/*` | 예정 | 목록 팝업, 상세 패널, 반경 패널, API 훅 분리 |
+| 팝업 정의 | `FE_APP_ROOT/src/features/windowPopup/model/popupDefinitions.ts` | 예정 | 목록 팝업을 기존 popup 체계로 열 경우 필요 |
+| 팝업 등록 | `FE_APP_ROOT/src/features/windowPopup/registry.tsx` | 예정 | popup key와 화면 등록 |
+| 팝업 UI | `FE_APP_ROOT/src/features/windowPopup/ui/*` | 예정 | `지반침하발생현황` popup content |
+| 공통 비즈니스 컴포넌트 | `FE_BC_ROOT/**` | 기본 제외 | 현재 계획은 `apps/sn` 내부 재사용 우선 |
+
+## 3-1. 쓰기 범위와 충돌 주의
+
+| 구분 | 경로 | 담당 역할 | 처리 기준 |
+| --- | --- | --- | --- |
+| 쓰기 허용 | `apps/sn/**` | FE | 신규 지도 기능과 문서 작성 |
+| 쓰기 허용 | `packages/common/business_components/**` | FE | 꼭 필요한 경우만 최소 범위 수정 |
+| 쓰기 금지 | `packages/common/business_components` 외 공통 패키지 | FE | 원인과 영향 범위만 기록 |
+| 쓰기 금지 | 타 앱 `apps/*` | FE | 보고만 수행 |
+
+- 충돌 주의 파일
+ - `FE_APP_ROOT/app/(map-layout)/map/page.tsx`
+ - `FE_APP_ROOT/src/features/windowPopup/model/popupDefinitions.ts`
+ - `FE_APP_ROOT/src/features/windowPopup/registry.tsx`
+
+## 4. 화면 흐름
+
+- 진입 경로: `하수관망도 > 지반침하정보`
+- 사용자 조작
+ - 레이어 트리에서 `지반침하정보` 체크
+ - 목록 아이콘 클릭
+ - 목록 팝업에서 조건 입력 후 조회
+ - 목록 행 클릭 또는 지도 포인트 클릭
+ - 좌측 하단 반경 입력 후 적용
+ - 관리자일 경우 동기화 클릭
+- 정상 흐름
+ - 지도에 지반침하 포인트 표시
+ - 우측 상세 패널 노출
+ - 반경 원과 반경 내 관로 목록 갱신
+ - 목록 다운로드 가능
+- 오류 흐름
+ - 날짜 미입력
+ - 기간 1년 초과
+ - 좌표 없음
+ - 상세조회 실패
+ - 반경 내 관로 없음
+ - 동기화 실패
+
+## 5. API 연동
+
+| 기능 | Method | URL | 요청 | 응답 | 확인 상태 |
+| --- | --- | --- | --- | --- | --- |
+| 지도 포인트 조회 | `GET` | `/api/v1/sinkholes/geometry` | 기간/행정구역/limit | GeoJSON `FeatureCollection` | 현재 BE 선반영 |
+| 목록 조회 | `GET` | `/api/v1/sinkholes` | 기간, 시도, 시군구, 복구상태, page, size | `items[]`, `total` | BE 신규 필요 |
+| 상세 조회 | `GET` | `/api/v1/sinkholes/{acdntNo}` | 사고번호 | 상세 DTO | BE 신규 필요 |
+| 반경 내 관로 조회 | `GET` | `/api/v1/sinkholes/{acdntNo}/nearbyPipes` | 사고번호, 반경 | 관로 목록 | BE 신규 필요 |
+| 동기화 | `POST` | `/api/v1/sinkholes/sync` | 관리자 요청 body | 처리 결과 | BE 신규 필요 |
+| 다운로드 | `GET` | `/api/v1/sinkholes/download` | 현재 조회조건 | xlsx | BE 신규 필요 |
+
+- FE 메모
+ - 좌표 보정과 반경 내 관로 거리 계산은 프론트에서 하지 않는다.
+ - 목록 행의 좌표를 바로 믿지 않고 상세 API 응답으로 다시 기준을 맞춘다.
+ - 화면에 필요한 일부 필드는 원천 부재 가능성이 있으므로 `null -> "-"` 렌더링 정책이 필요하다.
+
+## 6. 영향 범위
+
+- `apps/sn` 화면 영향
+ - 레이어 트리
+ - 지도 포인트/반경 원
+ - 중앙 목록 팝업
+ - 우측 상세 패널
+ - 좌측 하단 반경 패널
+- 공통 패키지 영향
+ - 현재 계획상 없음
+ - 지도 포인트 레이어/클러스터 공통 확장이 꼭 필요하면 별도 승인 후 검토
+- 백엔드 API 영향
+ - 지반침하 신규 목록/상세/동기화/다운로드 계약
+
+## 6-1. 멀티에이전트 작업 분리
+
+- DE 산출물
+ - 공통 설계 문서
+ - API/DTO/DB 영향 초안
+- FE 산출물
+ - 지도 상태관리 구조
+ - 목록 팝업 / 상세 패널 설계
+ - API 호출 연결 계획
+- BE 산출물
+ - 지반침하 API 세트 확장
+ - 좌표 캐시 / 동기화 구조
+ - 반경 내 관로 조회
+- QA 산출물
+ - 정상/예외/권한/환경 검증 시나리오
+
+## 7. 검증 방법
+
+- 빌드 명령
+ - 개발 서버 미실행 확인 후 `pnpm --filter sn run build`
+ - 필요 시 `pnpm turbo run build --filter=sn`
+- 브라우저 URL
+ - `/map`
+- 사용자 조작
+ - 지반침하 레이어 체크/해제
+ - 목록 아이콘 클릭
+ - 조건 조회
+ - 목록 행 클릭
+ - 지도 포인트 클릭
+ - 반경 변경
+ - 관리자 동기화
+- 기대 결과
+ - 목록/상세/반경/다운로드가 요구사항과 일치
+ - 좌표 없음/조회 결과 없음/반경 내 관로 없음이 각각 다른 안내로 표시
+
+## 7-1. 하네스 관측 포인트
+
+- 레이어 체크박스 상태
+- 목록 팝업 열림 여부
+- 우측 상세 패널 노출 여부
+- 반경 값과 적용 메시지
+- 지도 중심 이동 여부
+- 포인트와 반경 원 노출 여부
+- 관리자 버튼 노출 여부
+
+## 8. 롤백 방법
+
+- `지반침하정보` 관련 신규 컴포넌트 제거
+- 레이어 트리와 팝업 등록 분기 제거
+- `map/page.tsx`의 지반침하 상태관리 제거
+- 문서는 설계 단계 기준으로 유지하고 코드만 롤백
+
+## 9. 예상 위험
+
+- `map/page.tsx`에 또 하나의 지도 도메인 로직이 들어가면서 책임이 더 커질 수 있다.
+- 목록 팝업을 `window popup`으로 할지 인라인 모달로 할지 구현 방식이 달라질 수 있다.
+- 원천 데이터에 없는 상세 필드를 FE가 어떻게 보여줄지 합의가 필요하다.
+- 좌표 없는 사고건을 지도와 목록에서 다르게 다뤄야 해 예외 분기가 많다.
+
+## 10. 완료 기준
+
+- `지반침하정보` 체크 시 포인트 표출 가능
+- 목록 아이콘 클릭 시 조회 팝업 오픈 가능
+- 목록 조회/행 클릭/지도 포인트 클릭 흐름이 연결됨
+- 반경 적용 시 반경 원과 반경 내 관로 목록 재조회 가능
+- 관리자 전용 동기화 버튼이 권한 기준으로 분기됨
+- BE 계약 문서와 FE 작업카드가 같은 필드 기준을 사용함
+
+## 11. 구현 전 승인 필요 항목
+
+- 화면 원본이 없는 필드의 FE 표시 방식
+- 목록 팝업을 기존 popup 창으로 열지, `/map` 내부 모달로 열지
+- 최근 동기화 일시 위치와 노출 범위
+- 좌표 캐시를 메모리 캐시로만 둘지 DB 영속화까지 포함할지
diff --git a/apps/sn/docs/작업내용/SFR-010-010-지반침하정보/001-fe-SFR-010-010-지반침하정보-통합구현기록.md b/apps/sn/docs/작업내용/SFR-010-010-지반침하정보/001-fe-SFR-010-010-지반침하정보-통합구현기록.md
new file mode 100644
index 000000000..0c8ae4684
--- /dev/null
+++ b/apps/sn/docs/작업내용/SFR-010-010-지반침하정보/001-fe-SFR-010-010-지반침하정보-통합구현기록.md
@@ -0,0 +1,99 @@
+# SFR-010-010 지반침하정보 통합 구현 기록
+
+## 1. 문서 목적
+
+- `SFR-010-010 지반침하정보`의 FE 구현 이력, 설계 결정, 남은 리스크를 기능당 1개 문서로 누적 관리한다.
+- 이번 턴은 구현 전 단계이므로 설계 검토 결과와 승인 필요 항목만 먼저 기록한다.
+- 승인 후에는 새 파일을 추가하지 않고 이 문서 내부 헤더로만 구현 라운드를 누적한다.
+
+## 2. 입력 근거
+
+- `COMMON_DOCS_ROOT/작업계획/SFR-010-010 지반침하정보/001-de-SFR-010-010-지반침하정보-설계.md`
+- `COMMON_DOCS_ROOT/작업계획/SFR-010-010 지반침하정보/지반침하정보-화면구성시나리오_v1_1.md`
+- `FE_APP_DOCS_ROOT/작업계획/SFR-010-010-지반침하정보/001-fe-SFR-010-010-지반침하정보-작업카드.md`
+
+## 3. 공통 계약
+
+- 프론트는 `reuse-service`를 직접 호출하지 않고 `sewerage-service`만 호출한다.
+- 지도 포인트 좌표, 반경 내 관로 거리 계산, 좌표보정상태 판단은 백엔드 응답을 기준으로 처리한다.
+- 목록 행 클릭 후 상세 패널은 목록행 데이터가 아니라 상세 API 응답으로 다시 맞춘다.
+- 원천에 없는 상세 필드는 FE에서 `null -> "-"` 렌더링을 기본안으로 두되 승인 전까지 확정하지 않는다.
+- 목록 팝업은 기존 `노후관로` 팝업 패턴, 우측 상세는 `FeatureClickEventPopup` 패턴 재사용을 우선한다.
+
+## 4. 라운드별 기록
+
+### 4.1 2026-06-02 설계 착수
+
+- 작업지시 폴더의 요구사항명세서, 시나리오, HTML, PNG를 읽고 기능 범위를 재해석했다.
+- 백엔드 현재 작업트리에서 아래 선반영 코드를 확인했다.
+ - `GET /api/v1/sinkholes/geometry`
+ - IL datasource
+ - 주소 기반 지오코딩 서비스
+- 프론트 현재 코드에서는 `지반침하정보` 실제 기능 구현은 없고, HTML 샘플 및 레이어 명칭 흔적만 확인됐다.
+- 이번 기능의 FE 핵심 축을 아래로 정리했다.
+ - 레이어 체크/해제
+ - 목록 팝업
+ - 우측 상세 패널
+ - 반경 적용 UX
+ - 관리자 전용 동기화 버튼 노출 제어
+- 아직 구현하지 않은 항목
+ - 실제 코드 수정
+ - 브라우저 검증
+ - API 연결
+
+### 4.2 2026-06-05 좌표 응답 정합화
+
+- 프론트 목록 팝업에 `좌표보정상태` 컬럼을 추가해 지오코딩 성공/실패를 운영 화면에서 바로 볼 수 있게 했다.
+- 상세 패널에서 좌표가 없어 반경 내 관로를 조회하지 못하는 경우 `geocodeErrorMessage`를 함께 노출하도록 보강했다.
+- 같은 시점의 로컬 백엔드 응답을 확인한 결과, `reuse-service` 지오코딩 응답의 추가 필드를 무시하지 못해 `Unrecognized field "adresTy"` 예외가 나고 있었음을 확인했다.
+- 즉 프론트 좌표 표시 이상은 지도 상태관리 자체보다 백엔드 좌표 응답 실패가 선행 원인이었다.
+
+### 4.3 2026-06-05 구현 흐름 메모
+
+- 지반침하 원천 데이터에는 사고 정보는 있는데 지도에 바로 표시할 좌표가 없는 경우가 있어서, 프론트는 백엔드가 좌표보정상태까지 붙여 내려주는 구조를 전제로 구현했다.
+
+예시데이터
+
+- 사고번호: `20260024`
+- 주소: `인천광역시 서구 백석동 74-11`
+- 발생일자: `20260409`
+- 복구상태: `복구중`
+- `ocrn_txcrd`, `ocrn_tycrd`: 비어 있음
+
+프론트에서 본 처리 흐름
+
+- 목록 API에서 지반침하사고 1건을 받음
+- 백엔드가 원천 좌표 또는 주소 API 결과를 기준으로 `x`, `y`, `coordStatus`를 같이 내려줌
+- 프론트는 `coordStatus`가 성공이면 지도 포인트를 그림
+- 실패면 목록에서 `좌표보정상태 = 실패`로 보여주고 상세에서 실패 사유를 보여줌
+
+### 4.4 2026-06-05 상세 패널 유지보수
+
+- 지반침하 상세를 열었을 때 중심점과 반경 원은 그려지지만 줌이 그대로여서 사용자가 위치를 바로 확인하기 어렵다고 판단했다.
+- 그래서 상세 조회 성공 시점과 반경 재적용 시점 모두 반경 원 extent 기준으로 `fit` 하도록 보강했다.
+- `침하발생 반경내 관로정보` 표는 기존 단순 HTML 테이블에서 공용 `Table` 스타일로 바꿔 발생정보 카드와 더 비슷한 시각 톤을 맞췄다.
+- 관로 ID 행을 클릭하면 `GisApp.Module.layer.showSearchResultsFromGeoJSON`로 `tb_ms_swage_ppl`의 `fid`를 넘겨 지도 강조를 요청하도록 연결해, 반경 내 관로를 상세 패널에서 바로 따라갈 수 있게 했다.
+
+### 4.5 2026-06-05 관로 강조와 상세 복귀 유지보수
+
+- 관로 ID 클릭 시 현재 줌레벨은 유지한 채 해당 관로만 지도에 하이라이트하고, 관로 상세정보 창을 함께 열도록 수정했다.
+- 관로 상세정보 창의 닫기 버튼을 누르면 선택된 관로 하이라이트를 해제하고, 직전에 보던 지반침하 상세 패널이 다시 보이도록 복귀 흐름을 추가했다.
+
+### 4.6 2026-06-05 레이어설정 기준 지반침하 트리 재정리
+
+- 초기에는 프론트에서 `지반침하정보` 루트와 연도 노드를 임의로 만들었지만, 실제 `tb_sn_lyr_stng`에는 `지반침하정보` 루트만 있고 자식 노드가 없어서 도시침수지도와 같은 토글 구조로 보이지 않았다.
+- 그래서 프론트는 실제 루트 row를 부모 토글로 사용하고, DB 자식 노드가 없을 때만 `현재년도`, `전체` 2개를 fallback으로 붙이도록 정리했다.
+- 연도 노드 클릭 시에는 노드명 하드코딩 대신 `filter_sql`을 우선 읽어 목록 조회 조건을 만들고, `filter_sql`이 없을 때만 `sinkholeYear` 값을 fallback으로 사용하도록 수정했다.
+
+## 5. 승인 전 보류 사항
+
+- 목록 팝업을 `window popup`으로 열지 `/map` 내부 중앙 모달로 열지 확정 필요
+- 최근 동기화 일시를 관리자에게 어디에 보여줄지 확정 필요
+- 원천 부재 필드를 FE에서 `-`로 고정해도 되는지 승인 필요
+- 좌표 캐시를 메모리만 쓸지 DB 영속화까지 포함할지 BE 승인 필요
+
+## 6. 남은 리스크
+
+- `map/page.tsx`는 기존 기능이 많아 무리하게 누적하면 회귀 위험이 크다.
+- 원천 데이터에 없는 컬럼을 화면은 요구하고 있어, API/FE 표시 정책이 늦게 확정되면 구현이 되돌아갈 수 있다.
+- 좌표 없는 사고건과 좌표 실패 사고건은 UI와 QA 시나리오가 달라 예외 흐름이 많다.
diff --git a/apps/sn/src/features/windowPopup/model/popupDefinitions.ts b/apps/sn/src/features/windowPopup/model/popupDefinitions.ts
index 846d075d9..5724edd3a 100644
--- a/apps/sn/src/features/windowPopup/model/popupDefinitions.ts
+++ b/apps/sn/src/features/windowPopup/model/popupDefinitions.ts
@@ -77,6 +77,12 @@ export const windowPopupDefinitions = {
offsetLeft: 0,
offsetTop: 200,
},
+ sinkholePopup: {
+ key: "sinkholePopup",
+ title: "지반침하발생현황",
+ width: 1380,
+ height: 820,
+ },
pipeAnalysisPopup: {
key: "pipeAnalysisPopup",
title: "관로분석",
diff --git a/apps/sn/src/features/windowPopup/registry.tsx b/apps/sn/src/features/windowPopup/registry.tsx
index adfc14fc7..aa65d06d2 100644
--- a/apps/sn/src/features/windowPopup/registry.tsx
+++ b/apps/sn/src/features/windowPopup/registry.tsx
@@ -10,6 +10,7 @@ import RdiiChartPopupContent from "./ui/RdiiChartPopupContent";
import ReportFilesPopupContent from "./ui/ReportFilesPopupContent";
import ReportTabPopupContent from "./ui/ReportTabPopupContent";
import SearchModalPopupContent from "./ui/SearchModalPopupContent";
+import SinkholePopupContent from "./ui/SinkholePopupContent";
import SscDetailPopupContent from "./ui/SscDetailPopupContent";
import type { WindowPopupContentProps } from "./model/types";
import FeaturePlaceholderPopupContent from "./ui/FeaturePlaceholderPopupContent";
@@ -80,6 +81,10 @@ export const windowPopupRegistry = {
...windowPopupDefinitions.agedPipePopup,
component: AgedPipePopupContent,
},
+ sinkholePopup: {
+ ...windowPopupDefinitions.sinkholePopup,
+ component: SinkholePopupContent,
+ },
pipeAnalysisPopup: {
...windowPopupDefinitions.pipeAnalysisPopup,
component: PipeAnalysisPopupContent,
diff --git a/apps/sn/src/features/windowPopup/ui/SinkholePopupContent.tsx b/apps/sn/src/features/windowPopup/ui/SinkholePopupContent.tsx
new file mode 100644
index 000000000..387fc511e
--- /dev/null
+++ b/apps/sn/src/features/windowPopup/ui/SinkholePopupContent.tsx
@@ -0,0 +1,10 @@
+import { Suspense } from "react";
+import SinkholePopupPage from "@/app/(map-layout)/map/components/sinkhole/SinkholePopupPage";
+
+export default function SinkholePopupContent() {
+ return (
+
+
+
+ );
+}
diff --git a/apps/sn/tsconfig.json b/apps/sn/tsconfig.json
index 1634b3f08..794b8c055 100644
--- a/apps/sn/tsconfig.json
+++ b/apps/sn/tsconfig.json
@@ -12,6 +12,7 @@
"module": "esnext",
"moduleResolution": "bundler",
"verbatimModuleSyntax": true,
+ "ignoreDeprecations": "6.0",
"strictNullChecks": true,
"resolveJsonModule": true,
"isolatedModules": true,
diff --git a/packages/common/business_components/src/ui/map/GisTree.js b/packages/common/business_components/src/ui/map/GisTree.js
index 75f523cd4..79ee7c9d0 100644
--- a/packages/common/business_components/src/ui/map/GisTree.js
+++ b/packages/common/business_components/src/ui/map/GisTree.js
@@ -542,6 +542,9 @@ export default React.memo(function GisTree({
(child) =>
child.parent === node.id && child.data.exprsYn === "Y"
);
+ const isSinkholeTreeNode =
+ String(node.id).includes("SN_SINKHOLE") ||
+ String(node?.data?.lyrNm ?? "").trim() === "지반침하정보";
const showLayerActionButton = layerIconVisible?.(node);
const showLayerActionIcon = depth > 0 && imageVisible;
@@ -563,7 +566,7 @@ export default React.memo(function GisTree({
title={isOpen ? "닫기" : "열기"}
/>
) : (
-
+ (isSinkholeTreeNode ? null : )
)}
handleCheck(node.id)}
className="cursor-pointer"
/>
- {node.icon && {node.icon}}
+ {!isSinkholeTreeNode && node.icon && {node.icon}}
{node.text}