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}