Files
frontend/apps/sn/src/features/obsltPpl/ui/ObsltPplListPage.tsx
T

686 lines
22 KiB
TypeScript

/**
* 노후 하수관로 정비사업
*/
"use client";
import { useCallback, useEffect, useMemo, useRef, useState } from "react";
import { useRouter, useSearchParams } from "next/navigation";
import {
StandardDataTable,
StandardTableSortHeader,
getStandardRowNumber,
type UiTableSort,
} from "@common/business_components";
import {
Button,
Input,
Label,
Select,
SelectContent,
SelectItem,
SelectTrigger,
SelectValue,
} from "@common/components";
import {
getCoreRowModel,
useReactTable,
type ColumnDef,
type PaginationState,
} from "@tanstack/react-table";
import {
getAllObsltPplBusinesses,
getObsltPplBusinesses,
uploadObsltPplExcel,
} from "../api/obslt-ppl-api";
import { appendApiSearchParams, formatDate } from "@/shared/util/util";
import {
downloadObsltPplExcel,
parseObsltPplExcel,
} from "../lib/obslt-ppl-excel";
import {
buildObsltPplRepresentativeSggOptions,
normalizeObsltPplSigunName,
} from "../lib/obslt-ppl-region";
import type { ObsltPplBusiness, ObsltPplPage } from "../model/obslt-ppl-types";
import LoadingOverlay from "@/components/ui/LoadingBar";
import { useOperBusinessCommonCodes } from "@/shared/lib/use-oper-business-common-codes";
import useStore from "@/store/useStore";
import { openWindowPopup } from "../../windowPopup/lib/openWindowPopup";
import { WINDOW_POPUP_MESSAGE_TYPE } from "../../windowPopup/model/types";
const DEFAULT_LIST_SIZE = 10;
const ALL_REGION_OPTION = { text: "전체", val: "0" };
type ObsltPplTableRow = ObsltPplBusiness & {
rowNumber: number;
};
type ObsltPplTableColumn = {
id: keyof ObsltPplTableRow;
title: string;
width: number;
align?: "left" | "center" | "right";
};
type ObsltPplSearch = {
bizSe: string;
ctpvNm: string;
sigunNm: string;
bizNm: string;
};
/** 조회조건·지역 선택 코드·페이지를 목록 복귀에 사용할 URL query로 만든다. */
const createListQueryString = (
page: number,
search: ObsltPplSearch,
ctpvCd: string,
sggCd: string,
) => {
const params = new URLSearchParams();
if (page > 1) params.set("page", String(page));
Object.entries(search).forEach(([key, value]) => {
if (value.trim()) params.set(key, value.trim());
});
if (ctpvCd !== "0") params.set("ctpvCd", ctpvCd);
if (sggCd !== "0") params.set("sggCd", sggCd);
return params.toString();
};
/** 다열 목록은 화면별 CSS 대신 공통 스크롤 표에 전달할 실제 컬럼 폭만 정의한다. */
const TABLE_COLUMNS: ObsltPplTableColumn[] = [
{ id: "rowNumber", title: "순번", width: 60 },
{ id: "bizSe", title: "사업구분", width: 85 },
{ id: "prcisExmnCycl", title: "정밀조사\n차수", width: 85 },
{ id: "bizCd", title: "사업코드", width: 105 },
{ id: "ctpvNm", title: "시도", width: 90 },
{ id: "sigunNm", title: "시군구", width: 90 },
{ id: "envoNm", title: "환경청", width: 120 },
{ id: "bizNm", title: "사업명", width: 240, align: "left" },
{ id: "prplPrst", title: "추진현황", width: 85 },
{ id: "bgngYr", title: "착수년도", width: 75 },
{ id: "cmcnYr", title: "준공(예정)\n년도", width: 90 },
{ id: "planPrlg", title: "계획연장\n(km)", width: 95, align: "right" },
{
id: "frhfyrExpcPrlg",
title: "상반기(예상)\n연장(km)",
width: 120,
align: "right",
},
{ id: "rmndPrlg", title: "잔여연장\n(km)", width: 95, align: "right" },
{ id: "evdncDcmntSbmsnStts", title: "증빙서류\n제출여부", width: 90 },
{ id: "bgngYmd", title: "착수일자", width: 105 },
{ id: "cmcnYmd", title: "준공(예정)\n일자", width: 110 },
{
id: "bizPrplDlyRsnCn",
title: "사업추진 부진사유",
width: 300,
align: "left",
},
{ id: "bizPicNm", title: "담당자 이름", width: 90 },
{ id: "bizPicCnpl", title: "담당자 연락처", width: 120 },
{ id: "rmrkCn", title: "비고", width: 160, align: "left" },
{ id: "pbcpOpnnCn", title: "공단\n의견", width: 90, align: "left" },
];
const TABLE_MIN_WIDTH = "280rem";
const EMPTY_PAGE: ObsltPplPage = {
content: [],
totalElements: 0,
totalPages: 0,
number: 0,
size: DEFAULT_LIST_SIZE,
};
/** 목록 표시값을 공통 포맷으로 정리한다. */
const formatBusinessForDisplay = (row: ObsltPplBusiness): ObsltPplBusiness => ({
...row,
sigunNm: normalizeObsltPplSigunName(row.sigunNm) || null,
bgngYmd: formatDate(row.bgngYmd) || null,
cmcnYmd: formatDate(row.cmcnYmd) || null,
});
/** 공통 DataTable 셀에 표시할 문자열을 null과 숫자까지 일관되게 변환한다. */
const formatTableValue = (value: unknown) => {
if (typeof value === "number") return value.toLocaleString("ko-KR");
if (value === null || value === undefined) return "";
return String(value);
};
/** 노후하수관로 사업 목록, 검색, xlsx 업로드·다운로드 진입점을 제공한다. */
export function ObsltPplListPage() {
const router = useRouter();
const searchParams = useSearchParams();
// 검색값·원본 행은 유지하고 사업구분·추진·증빙 표시명만 CMS 기준으로 변환한다.
const {
obsltBusinessTypeOptions,
evidenceStatusLabels,
businessProgressLabels,
} = useOperBusinessCommonCodes();
const { ctpv, sgg, fetchCtpv, fetchSgg } = useStore();
const fileInputRef = useRef<HTMLInputElement>(null);
const initialSearch = useMemo<ObsltPplSearch>(
() => ({
bizSe: searchParams.get("bizSe") ?? "정밀조사",
ctpvNm: searchParams.get("ctpvNm") ?? "",
sigunNm: searchParams.get("sigunNm") ?? "",
bizNm: searchParams.get("bizNm") ?? "",
}),
[searchParams],
);
const [page, setPage] = useState(() =>
Math.max(Number(searchParams.get("page")) || 1, 1),
);
const [data, setData] = useState<ObsltPplPage>(EMPTY_PAGE);
const [rows, setRows] = useState<ObsltPplTableRow[]>([]);
const displayRows = useMemo(
() =>
rows.map((row) => ({
...row,
prplPrst:
businessProgressLabels[String(row.prplPrst ?? "")] || row.prplPrst,
evdncDcmntSbmsnStts:
evidenceStatusLabels[String(row.evdncDcmntSbmsnStts ?? "")] ||
row.evdncDcmntSbmsnStts,
})),
[
businessProgressLabels,
evidenceStatusLabels,
rows,
],
);
const [loading, setLoading] = useState(false);
const [notice, setNotice] = useState("");
// 선택박스의 코드와 API 검색에 사용하는 행정구역명을 함께 관리한다.
const [ctpvCd, setCtpvCd] = useState(() => searchParams.get("ctpvCd") ?? "0");
const [sggCd, setSggCd] = useState(() => searchParams.get("sggCd") ?? "0");
const [appliedCtpvCd, setAppliedCtpvCd] = useState(
() => searchParams.get("ctpvCd") ?? "0",
);
const [appliedSggCd, setAppliedSggCd] = useState(
() => searchParams.get("sggCd") ?? "0",
);
const [search, setSearch] = useState<ObsltPplSearch>(initialSearch);
const [appliedSearch, setAppliedSearch] =
useState<ObsltPplSearch>(initialSearch);
const [sort, setSort] = useState<UiTableSort>();
/** 현재 선택한 시도에 속한 시군구만 선택 후보로 제공한다. */
const availableSgg = useMemo(() => {
return buildObsltPplRepresentativeSggOptions(sgg, ctpvCd);
}, [ctpvCd, sgg]);
/** 정렬 변경 시 동일 검색조건으로 서버 첫 페이지를 다시 조회한다. */
const handleSortChange = useCallback(
(nextSort?: UiTableSort) => {
setSort(nextSort);
setPage(1);
const queryString = createListQueryString(
1,
appliedSearch,
appliedCtpvCd,
appliedSggCd,
);
router.replace(
`/oper/obsltPplBiz${queryString ? `?${queryString}` : ""}`,
{ scroll: false },
);
},
[appliedCtpvCd, appliedSearch, appliedSggCd, router],
);
/** 공통 DataTable이 표시할 22개 업무 컬럼과 폭·정렬 규칙을 구성한다. */
const columns = useMemo<ColumnDef<ObsltPplTableRow>[]>(
() =>
TABLE_COLUMNS.map((column) => ({
id: column.id,
accessorFn: (row) => row[column.id],
header: () => (
<StandardTableSortHeader
label={column.title.replace(/\n/g, " ")}
title={
<span className="whitespace-pre-line">{column.title}</span>
}
sortKey={
column.id === "rowNumber"
? "obsltSwagePplBizSn"
: String(column.id)
}
sort={sort}
onSortChange={handleSortChange}
/>
),
cell: ({ getValue }) => {
const displayValue = formatTableValue(getValue());
return (
<span
className="block whitespace-normal break-words"
title={displayValue}
>
{displayValue}
</span>
);
},
meta: {
width: column.width,
align: column.align ?? "center",
},
})),
[handleSortChange, sort],
);
const pagination: PaginationState = {
pageIndex: page - 1,
pageSize: DEFAULT_LIST_SIZE,
};
/** 서버 페이지 번호와 URL 복귀 조건을 공통 DataTable 페이지 상태에 연결한다. */
const table = useReactTable({
data: displayRows,
columns,
state: { pagination },
rowCount: data.totalElements,
manualPagination: true,
getCoreRowModel: getCoreRowModel(),
getRowId: (row) => String(row.obsltSwagePplBizSn),
onPaginationChange: (updater) => {
const next =
typeof updater === "function" ? updater(pagination) : updater;
const nextPage = next.pageIndex + 1;
if (nextPage === page) return;
setPage(nextPage);
const queryString = createListQueryString(
nextPage,
appliedSearch,
appliedCtpvCd,
appliedSggCd,
);
router.replace(
`/oper/obsltPplBiz${queryString ? `?${queryString}` : ""}`,
{ scroll: false },
);
},
});
/** 공통 레이아웃에서 아직 지역 데이터를 불러오지 못한 경우 공통 store 조회를 보완한다. */
useEffect(() => {
if (ctpv.length === 0) void fetchCtpv();
if (sgg.length === 0) void fetchSgg();
}, [ctpv.length, fetchCtpv, fetchSgg, sgg.length]);
/** 확정 검색조건과 페이지를 서버 요청 파라미터로 변환해 목록을 갱신한다. */
const load = useCallback(
async (
targetPage = page,
targetSearch = appliedSearch,
nextSort: UiTableSort | undefined = sort,
) => {
const params = new URLSearchParams({
page: String(Math.max(targetPage - 1, 0)),
size: String(DEFAULT_LIST_SIZE),
sort: nextSort
? `${nextSort.key},${nextSort.direction}`
: "obsltSwagePplBizSn,desc",
});
appendApiSearchParams(params, targetSearch);
setLoading(true);
try {
const result = await getObsltPplBusinesses(params);
setData(result);
setRows(
result.content.map((row, index) => ({
...formatBusinessForDisplay(row),
rowNumber: getStandardRowNumber({
total: result.totalElements,
rowIndex: index,
pageIndex: targetPage - 1,
pageSize: DEFAULT_LIST_SIZE,
}),
})),
);
} catch (error) {
setNotice(
error instanceof Error
? error.message
: "목록을 조회하지 못했습니다.",
);
setData(EMPTY_PAGE);
setRows([]);
} finally {
setLoading(false);
}
},
[appliedSearch, page, sort],
);
useEffect(() => {
void load();
}, [load]);
/** 팝업 등록 완료 메시지를 받으면 기존 적용 조회조건을 유지한 채 첫 페이지를 재조회한다. */
useEffect(() => {
const receivePopupMessage = (event: MessageEvent) => {
if (event.origin !== window.location.origin) return;
if (event.data?.type !== WINDOW_POPUP_MESSAGE_TYPE.CFMTN_BGT_REGISTERED)
return;
const inserted = Number(event.data?.payload?.insertedCount ?? 0);
const skipped = Number(event.data?.payload?.skippedCount ?? 0);
setNotice(
`최종확정예산사업 ${inserted.toLocaleString()}건을 등록했습니다.${skipped ? ` 이미 등록된 ${skipped.toLocaleString()}건은 제외했습니다.` : ""}`,
);
setPage(1);
if (page === 1) void load(1, appliedSearch);
};
window.addEventListener("message", receivePopupMessage);
return () => window.removeEventListener("message", receivePopupMessage);
}, [appliedSearch, load]);
/** 부모 화면의 필수 사업구분을 전달하여 최종확정예산사업 선택 팝업을 연다. */
const handleOpenCfmtnBgt = () => {
if (search.bizSe !== "정밀조사" && search.bizSe !== "정비사업") {
setNotice("사업구분에서 정밀조사 또는 정비사업을 먼저 선택해 주세요.");
return;
}
const popup = openWindowPopup("cfmtnBgt", { bizSe: search.bizSe });
if (!popup)
setNotice(
"팝업이 차단되었습니다. 브라우저의 팝업 허용 설정을 확인해 주세요.",
);
};
/** 선택한 xlsx를 브라우저에서 검증·파싱한 뒤 JSON으로 교체 업로드한다. */
const handleUpload = async (file?: File) => {
if (!file) return;
if (!file.name.toLowerCase().endsWith(".xlsx")) {
setNotice("xlsx 파일만 업로드할 수 있습니다.");
return;
}
setLoading(true);
try {
const parsedRows = await parseObsltPplExcel(file);
const result = await uploadObsltPplExcel(parsedRows);
setNotice(
`총 ${result.importedCount.toLocaleString()}건을 저장했습니다. (정밀조사 ${result.precisionSurveyCount.toLocaleString()}건, 정비사업 ${result.maintenanceCount.toLocaleString()}건)`,
);
setPage(1);
if (page === 1) await load(1, appliedSearch);
} catch (error) {
setNotice(
error instanceof Error ? error.message : "업로드하지 못했습니다.",
);
} finally {
setLoading(false);
if (fileInputRef.current) fileInputRef.current.value = "";
}
};
/** 적용된 조회조건 전체를 두 업무 시트의 업로드 호환 위치로 내려받는다. */
const handleDownload = async () => {
setLoading(true);
try {
const params = new URLSearchParams();
appendApiSearchParams(params, appliedSearch);
const exportRows = await getAllObsltPplBusinesses(
params,
sort ? `${sort.key},${sort.direction}` : undefined,
);
await downloadObsltPplExcel(exportRows);
} catch (error) {
setNotice(
error instanceof Error ? error.message : "엑셀을 내려받지 못했습니다.",
);
} finally {
setLoading(false);
}
};
/** 입력 중 조건을 실제 조회조건으로 확정하고 첫 페이지를 다시 조회한다. */
const handleSearch = () => {
const nextSearch = { ...search };
setNotice("");
setAppliedSearch(nextSearch);
setAppliedCtpvCd(ctpvCd);
setAppliedSggCd(sggCd);
const queryString = createListQueryString(1, nextSearch, ctpvCd, sggCd);
router.replace(`/oper/obsltPplBiz${queryString ? `?${queryString}` : ""}`, {
scroll: false,
});
setPage(1);
};
/** CS 목록 화면과 같은 초기화 동작으로 기본 사업구분과 전체 지역을 다시 조회한다. */
const handleReset = () => {
const nextSearch: ObsltPplSearch = {
bizSe: "정밀조사",
ctpvNm: "",
sigunNm: "",
bizNm: "",
};
setSearch(nextSearch);
setAppliedSearch(nextSearch);
setCtpvCd("0");
setSggCd("0");
setAppliedCtpvCd("0");
setAppliedSggCd("0");
setSort(undefined);
setNotice("");
setPage(1);
router.replace("/oper/obsltPplBiz?bizSe=정밀조사", { scroll: false });
};
/** 적용된 목록 조건을 보존한 채 신규 등록 화면으로 이동한다. */
const handleRegister = () => {
const queryString = createListQueryString(
page,
appliedSearch,
appliedCtpvCd,
appliedSggCd,
);
router.push(
`/oper/obsltPplBiz/register${queryString ? `?${queryString}` : ""}`,
);
};
/** 선택한 목록 행의 수정·상세 화면을 현재 목록 복귀 조건과 함께 연다. */
const handleOpenDetail = (row: ObsltPplTableRow) => {
const queryString = createListQueryString(
page,
appliedSearch,
appliedCtpvCd,
appliedSggCd,
);
router.push(
`/oper/obsltPplBiz/register/${row.obsltSwagePplBizSn}${queryString ? `?${queryString}` : ""}`,
);
};
return (
<>
<LoadingOverlay isLoading={loading} />
<div className="card card-border !mt-6">
<form
className="flex flex-wrap items-center gap-2 p-2"
onSubmit={(event) => {
event.preventDefault();
handleSearch();
}}
>
<div className="flex items-center gap-2">
<Label className="mr-2 whitespace-nowrap text-label">
사업구분
</Label>
<Select
value={search.bizSe}
onValueChange={(value) =>
setSearch((current) => ({
...current,
bizSe: String(value),
}))
}
>
<SelectTrigger className="w-[12rem]">
<SelectValue />
</SelectTrigger>
<SelectContent>
<SelectItem value="0">전체</SelectItem>
{obsltBusinessTypeOptions.map((option) => (
<SelectItem key={option.code} value={option.value}>
{option.label}
</SelectItem>
))}
</SelectContent>
</Select>
</div>
<div className="flex items-center gap-2">
<Label className="mr-2 whitespace-nowrap text-label">시도</Label>
<Select
value={ctpvCd}
onValueChange={(value) => {
const nextCtpvCd = String(value);
setCtpvCd(nextCtpvCd);
setSggCd("0");
setSearch((current) => ({
...current,
ctpvNm:
ctpv.find((option) => String(option.val) === nextCtpvCd)
?.text ?? "",
sigunNm: "",
}));
}}
>
<SelectTrigger className="w-[14rem]">
<SelectValue />
</SelectTrigger>
<SelectContent>
{[ALL_REGION_OPTION, ...ctpv].map((option) => (
<SelectItem
key={String(option.val)}
value={String(option.val)}
>
{option.text}
</SelectItem>
))}
</SelectContent>
</Select>
</div>
<div className="flex items-center gap-2">
<Label className="mr-2 whitespace-nowrap text-label">시군구</Label>
<Select
value={sggCd}
onValueChange={(value) => {
const nextSggCd = String(value);
setSggCd(nextSggCd);
const selectedOption = availableSgg.find(
(option) => String(option.val) === nextSggCd,
);
setSearch((current) => ({
...current,
sigunNm: selectedOption?.text ?? "",
}));
}}
>
<SelectTrigger className="w-[14rem]">
<SelectValue />
</SelectTrigger>
<SelectContent>
{[ALL_REGION_OPTION, ...availableSgg].map((option) => (
<SelectItem
key={String(option.val)}
value={String(option.val)}
>
{option.text}
</SelectItem>
))}
</SelectContent>
</Select>
</div>
<div className="flex items-center gap-2">
<Label
htmlFor="obslt-ppl-biz-name"
className="mr-2 whitespace-nowrap text-label"
>
사업명
</Label>
<Input
id="obslt-ppl-biz-name"
className="w-[22rem] rounded-sm !text-[1.3rem]"
value={search.bizNm}
onChange={(event) =>
setSearch((current) => ({
...current,
bizNm: event.target.value,
}))
}
/>
</div>
<div className="flex min-w-fit flex-1 items-center justify-end gap-2">
<Button type="submit" className="w-[7.4rem]">
조회
</Button>
<Button
type="button"
color="white"
className="w-[8.8rem]"
onClick={handleReset}
>
초기화
</Button>
</div>
</form>
</div>
{notice && (
<div
role="status"
className="mx-[1.2rem] mt-4 rounded-sm border border-primary bg-primary-transparent px-4 py-3 text-[1.3rem] text-primary"
>
{notice}
</div>
)}
<div className="mt-4 w-full min-w-0 max-w-full overflow-hidden">
<StandardDataTable
table={table}
title="노후 하수관로 정비사업 목록"
scrollMode="horizontal"
minTableWidth={TABLE_MIN_WIDTH}
className="table-fixed"
onRowClick={handleOpenDetail}
actions={
<>
<Button type="button" onClick={handleOpenCfmtnBgt}>
최종확정예산사업
</Button>
<Button type="button" onClick={handleRegister}>
등록
</Button>
<input
ref={fileInputRef}
type="file"
accept=".xlsx"
className="hidden"
onChange={(event) => void handleUpload(event.target.files?.[0])}
/>
<Button
type="button"
onClick={() => fileInputRef.current?.click()}
>
업로드
</Button>
<Button type="button" onClick={() => void handleDownload()}>
엑셀다운로드
</Button>
</>
}
/>
</div>
</>
);
}