그리드 정렬기능

This commit is contained in:
2026-08-26 16:25:29 +09:00
parent ccfbe6ae32
commit e0cdba00be
61 changed files with 1777 additions and 590 deletions
@@ -11,6 +11,7 @@ import {
postRawJson,
putData,
} from "@/components/lib/api";
import { fetchAllPages } from "@/shared/lib/fetch-all-pages";
const API_PATH = "v1/obsltPplBiz";
const EXCEL_DOWNLOAD_PAGE_SIZE = 500;
@@ -24,30 +25,35 @@ const unwrapData = <T>(body: unknown): T => {
};
/** 목록 검색조건과 페이지 번호로 활성 사업 목록을 조회한다. */
export const getObsltPplBusinesses = async (params: URLSearchParams): Promise<ObsltPplPage> =>
export const getObsltPplBusinesses = async (
params: URLSearchParams,
): Promise<ObsltPplPage> =>
getData(`${API_PATH}?${params.toString()}`) as Promise<ObsltPplPage>;
/** 적용된 조회조건을 유지하며 모든 페이지를 순회해 Excel 다운로드 대상 전체를 모은다. */
export const getAllObsltPplBusinesses = async (searchParams: URLSearchParams): Promise<ObsltPplBusiness[]> => {
const rows: ObsltPplBusiness[] = [];
let page = 0;
let totalPages = 1;
while (page < totalPages) {
const params = new URLSearchParams(searchParams);
params.set("page", String(page));
params.set("size", String(EXCEL_DOWNLOAD_PAGE_SIZE));
params.set("sort", "obsltSwagePplBizSn,asc");
const result = await getObsltPplBusinesses(params);
rows.push(...result.content);
totalPages = result.totalPages;
page += 1;
}
return rows;
export const getAllObsltPplBusinesses = async (
searchParams: URLSearchParams,
sort = "obsltSwagePplBizSn,desc",
): Promise<ObsltPplBusiness[]> => {
const result = await fetchAllPages<ObsltPplPage, ObsltPplBusiness>({
batchSize: EXCEL_DOWNLOAD_PAGE_SIZE,
fetchPage: (page, size) => {
const params = new URLSearchParams(searchParams);
params.set("page", String(page));
params.set("size", String(size));
params.set("sort", sort);
return getObsltPplBusinesses(params);
},
getItems: (page) => page.content ?? [],
getTotal: (page) => Number(page.totalElements ?? 0),
});
return result.items;
};
/** 수정 화면에서 사업 상세 한 건을 조회한다. */
export const getObsltPplBusiness = async (id: string): Promise<ObsltPplBusiness> =>
export const getObsltPplBusiness = async (
id: string,
): Promise<ObsltPplBusiness> =>
getData(`${API_PATH}/${encodeURIComponent(id)}`) as Promise<ObsltPplBusiness>;
/** 등록 화면의 입력값으로 사업 한 건을 생성한다. */
@@ -61,7 +67,10 @@ export const updateObsltPplBusiness = async (
id: string,
request: ObsltPplBusinessSaveRequest,
): Promise<ObsltPplBusiness> =>
putData(`${API_PATH}/${encodeURIComponent(id)}`, request) as Promise<ObsltPplBusiness>;
putData(
`${API_PATH}/${encodeURIComponent(id)}`,
request,
) as Promise<ObsltPplBusiness>;
/** 수정 화면에서 선택 사업을 논리삭제한다. */
export const deleteObsltPplBusiness = async (id: string): Promise<void> => {
@@ -72,4 +81,6 @@ export const deleteObsltPplBusiness = async (id: string): Promise<void> => {
export const uploadObsltPplExcel = async (
rows: ObsltPplBusinessSaveRequest[],
): Promise<ObsltPplImportResult> =>
unwrapData<ObsltPplImportResult>(await postRawJson(`${API_PATH}/excel/upload`, rows));
unwrapData<ObsltPplImportResult>(
await postRawJson(`${API_PATH}/excel/upload`, rows),
);
@@ -1,4 +1,5 @@
import * as XLSX from "xlsx";
import XlsxPopulate from "xlsx-populate/browser/xlsx-populate";
import { formatDate } from "../../common/util";
import type { ObsltPplBusiness, ObsltPplBusinessSaveRequest } from "../model/obslt-ppl-types";
@@ -35,6 +36,13 @@ const FIRST_DATA_COLUMN_INDEX = 1;
const DATA_COLUMN_COUNT = 21;
const DOWNLOAD_FILENAME = "노후하수관로 정밀조사 및 정비사업 현황.xlsx";
/** API 문자열에 남은 Excel 개행 이스케이프를 실제 줄바꿈으로 정리한다. */
const excelTextValue = (value: unknown) =>
String(value ?? "")
.replace(/_x000d_/gi, "")
.replace(/\r\n?/g, "\n")
.trim();
/** 줄바꿈과 공백이 포함된 병합 헤더를 비교 가능한 문자열로 정규화한다. */
const normalizeHeader = (value: string) => value.replace(/\s+/g, "").trim();
@@ -179,14 +187,16 @@ export const parseObsltPplExcel = async (file: File): Promise<ObsltPplBusinessSa
const downloadHeaderRows = (contract: SheetContract) => {
const rows = Array.from({ length: DATA_START_ROW_INDEX }, () => Array<string | number>(22).fill(""));
const topHeaders = [
"순번", "정밀조사차수", contract.businessCodeHeader, "시도", "시군", "환경청", "사업명",
"추진현황", "착수년도", "준공(예정)년도", contract.extensionHeader, "", "", "",
contract.progressHeader, "", "사업추진부진사유", "사업담당자(지자체)", "", "비고", "",
"순번", "정밀\n조사\n차수", contract.businessCodeHeader.replace("사업코드", "\n사업코드"),
"시도", "시군", "환경청", "사업명", "추진현황", "착수\n년도", "준공(예정)\n년도",
contract.extensionHeader, "", "", "", contract.progressHeader.replace("추진현황", " 추진현황"),
"", "사업추진 부진 사유", "사업 담당자(지자체)", "", "비고", "",
];
const bottomHeaders = [
"", "", "", "", "", "", "", "", "", "", "계획연장(km)", "상반기(예상)연장(km)",
"잔여연장(km)", "증빙서류제출여부", contract.startDateHeader, "준공(예정)일자(yyyy.mm.dd)",
"", "이름", "연락처", "", "공단의견",
"잔여연장(km)", "증빙서류\n제출여부", contract.startDateHeader.replace("(yyyy.mm.dd)", "\n(yyyy.mm.dd)"),
"준공(예정)일자\n(yyyy.mm.dd)", "", "이름", "연락처",
"(필요시 사업 담당자 추가 작성)", "공단의견",
];
topHeaders.forEach((value, index) => { rows[5]![index + FIRST_DATA_COLUMN_INDEX] = value; });
bottomHeaders.forEach((value, index) => { rows[6]![index + FIRST_DATA_COLUMN_INDEX] = value; });
@@ -197,26 +207,26 @@ const downloadHeaderRows = (contract: SheetContract) => {
const downloadDataRow = (row: ObsltPplBusiness, index: number): Array<string | number> => [
"",
index + 1,
row.prcisExmnCycl ?? "",
row.bizCd ?? "",
row.ctpvNm ?? "",
row.sigunNm ?? "",
row.envoNm ?? "",
row.bizNm ?? "",
row.prplPrst ?? "",
row.bgngYr ?? "",
row.cmcnYr ?? "",
excelTextValue(row.prcisExmnCycl),
excelTextValue(row.bizCd),
excelTextValue(row.ctpvNm),
excelTextValue(row.sigunNm),
excelTextValue(row.envoNm),
excelTextValue(row.bizNm),
excelTextValue(row.prplPrst),
excelTextValue(row.bgngYr),
excelTextValue(row.cmcnYr),
row.planPrlg ?? "",
row.frhfyrExpcPrlg ?? "",
row.rmndPrlg ?? "",
row.evdncDcmntSbmsnStts ?? "",
excelTextValue(row.evdncDcmntSbmsnStts),
formatDate(row.bgngYmd),
formatDate(row.cmcnYmd),
row.bizPrplDlyRsnCn ?? "",
row.bizPicNm ?? "",
row.bizPicCnpl ?? "",
row.rmrkCn ?? "",
row.pbcpOpnnCn ?? "",
excelTextValue(row.bizPrplDlyRsnCn),
excelTextValue(row.bizPicNm),
excelTextValue(row.bizPicCnpl),
excelTextValue(row.rmrkCn),
excelTextValue(row.pbcpOpnnCn),
];
/** 조회 결과를 정밀조사·정비사업 두 시트의 재업로드 가능한 위치 구조로 생성한다. */
@@ -224,17 +234,123 @@ export const buildObsltPplWorkbook = (businesses: ObsltPplBusiness[]): XLSX.Work
const workbook = XLSX.utils.book_new();
SHEET_CONTRACTS.forEach((contract) => {
const data = businesses.filter((row) => row.bizSe === contract.sheetName);
const headerRows = downloadHeaderRows(contract);
headerRows[1]![2] =
contract.sheetName === "정밀조사"
? "노후하수관로 정밀조사(2차) 사업추진 현황"
: "노후하수관로 정비사업 사업추진 현황";
headerRows[4]![1] = "조회 건수";
headerRows[4]![4] = `${data.length.toLocaleString("ko-KR")}건`;
headerRows[4]![7] = `${contract.extensionHeader} 합계`;
headerRows[4]![11] =
Math.round(
data.reduce((sum, row) => sum + (row.planPrlg ?? 0), 0) * 1000,
) / 1000;
const worksheet = XLSX.utils.aoa_to_sheet([
...downloadHeaderRows(contract),
...headerRows,
...data.map(downloadDataRow),
]);
worksheet["!cols"] = Array.from({ length: 22 }, (_, index) => ({ wch: index === 7 ? 30 : 16 }));
worksheet["!merges"] = [
{ s: { r: 1, c: 2 }, e: { r: 2, c: 10 } },
{ s: { r: 4, c: 1 }, e: { r: 4, c: 3 } },
{ s: { r: 4, c: 4 }, e: { r: 4, c: 6 } },
{ s: { r: 4, c: 7 }, e: { r: 4, c: 10 } },
{ s: { r: 4, c: 11 }, e: { r: 4, c: 13 } },
...[1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 17].map((column) => ({
s: { r: 5, c: column },
e: { r: 6, c: column },
})),
{ s: { r: 5, c: 11 }, e: { r: 5, c: 13 } },
{ s: { r: 5, c: 15 }, e: { r: 5, c: 16 } },
{ s: { r: 5, c: 18 }, e: { r: 5, c: 19 } },
];
const widths = [
3, 7, 9, 16, 12, 12, 16, 34, 10, 9, 11, 13, 16, 13, 11, 16, 16,
34, 11, 16, 34, 24,
];
worksheet["!cols"] = widths.map((wch) => ({ wch }));
XLSX.utils.book_append_sheet(workbook, worksheet, contract.sheetName);
});
return workbook;
};
/** 생성한 두 시트 workbook을 브라우저 다운로드로 저장한다. */
export const downloadObsltPplExcel = (businesses: ObsltPplBusiness[]) => {
XLSX.writeFileXLSX(buildObsltPplWorkbook(businesses), DOWNLOAD_FILENAME);
/** 확정 원본의 제목·병합 헤더·구분색과 고정 본문 높이를 적용해 브라우저 다운로드를 시작한다. */
export const downloadObsltPplExcel = async (
businesses: ObsltPplBusiness[],
) => {
const workbook = buildObsltPplWorkbook(businesses);
const data = XLSX.write(workbook, { type: "array", bookType: "xlsx" });
const styledWorkbook = await XlsxPopulate.fromDataAsync(data);
SHEET_CONTRACTS.forEach((contract) => {
const rowCount = businesses.filter(
(business) => business.bizSe === contract.sheetName,
).length;
const styledSheet = styledWorkbook.sheet(contract.sheetName);
styledSheet.range("C2:K3").style({
bold: true,
fontFamily: "맑은 고딕",
fontSize: 16,
horizontalAlignment: "center",
verticalAlignment: "center",
border: true,
});
styledSheet.range("B5:N5").style({
bold: true,
fontFamily: "맑은 고딕",
fontSize: 10,
horizontalAlignment: "center",
verticalAlignment: "center",
fill: "FFF2CC",
border: true,
});
styledSheet.range("B6:V7").style({
bold: true,
fontFamily: "맑은 고딕",
fontSize: 10,
horizontalAlignment: "center",
verticalAlignment: "center",
wrapText: true,
border: true,
});
styledSheet.range("B6:H7").style("fill", "B4C6E7");
styledSheet.range("I6:Q7").style("fill", "FFF2CC");
styledSheet.range("R6:V7").style("fill", "FCE4D6");
styledSheet.row(2).height(26);
styledSheet.row(3).height(26);
styledSheet.row(5).height(22);
styledSheet.row(6).height(30);
styledSheet.row(7).height(34);
if (rowCount > 0) {
const dataStartRow = DATA_START_ROW_INDEX + 1;
const dataEndRow = DATA_START_ROW_INDEX + rowCount;
styledSheet.range(`B${dataStartRow}:V${dataEndRow}`).style({
fontFamily: "맑은 고딕",
fontSize: 10,
horizontalAlignment: "center",
verticalAlignment: "center",
wrapText: false,
border: true,
});
styledSheet
.range(`L${dataStartRow}:N${dataEndRow}`)
.style("numberFormat", "#,##0.###");
["H", "R", "U", "V"].forEach((column) =>
styledSheet
.range(`${column}${dataStartRow}:${column}${dataEndRow}`)
.style({ horizontalAlignment: "left", wrapText: true }),
);
for (let row = dataStartRow; row <= dataEndRow; row += 1)
styledSheet.row(row).height(22);
}
});
const blob = await styledWorkbook.outputAsync();
const url = URL.createObjectURL(blob);
const link = document.createElement("a");
link.href = url;
link.download = DOWNLOAD_FILENAME;
link.click();
setTimeout(() => URL.revokeObjectURL(url), 0);
};
@@ -8,7 +8,9 @@ import { useRouter, useSearchParams } from "next/navigation";
import {
StandardDataTable,
StandardTableSortHeader,
getStandardRowNumber,
type UiTableSort,
} from "@common/business_components";
import {
Button,
@@ -183,12 +185,32 @@ export function ObsltPplListPage() {
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>[]>(
() =>
@@ -196,7 +218,19 @@ export function ObsltPplListPage() {
id: column.id,
accessorFn: (row) => row[column.id],
header: () => (
<span className="whitespace-pre-line">{column.title}</span>
<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());
@@ -214,7 +248,7 @@ export function ObsltPplListPage() {
align: column.align ?? "center",
},
})),
[],
[handleSortChange, sort],
);
const pagination: PaginationState = {
pageIndex: page - 1,
@@ -258,11 +292,17 @@ export function ObsltPplListPage() {
/** 확정 검색조건과 페이지를 서버 요청 파라미터로 변환해 목록을 갱신한다. */
const load = useCallback(
async (targetPage = page, targetSearch = appliedSearch) => {
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: "obsltSwagePplBizSn,desc",
sort: nextSort
? `${nextSort.key},${nextSort.direction}`
: "obsltSwagePplBizSn,desc",
});
Object.entries(targetSearch).forEach(([key, value]) => {
if (value.trim()) params.set(key, value.trim());
@@ -295,7 +335,7 @@ export function ObsltPplListPage() {
setLoading(false);
}
},
[appliedSearch, page],
[appliedSearch, page, sort],
);
useEffect(() => {
@@ -368,8 +408,11 @@ export function ObsltPplListPage() {
Object.entries(appliedSearch).forEach(([key, value]) => {
if (value.trim()) params.set(key, value.trim());
});
const exportRows = await getAllObsltPplBusinesses(params);
downloadObsltPplExcel(exportRows);
const exportRows = await getAllObsltPplBusinesses(
params,
sort ? `${sort.key},${sort.direction}` : undefined,
);
await downloadObsltPplExcel(exportRows);
} catch (error) {
setNotice(
error instanceof Error ? error.message : "엑셀을 내려받지 못했습니다.",
@@ -407,6 +450,7 @@ export function ObsltPplListPage() {
setSggCd("0");
setAppliedCtpvCd("0");
setAppliedSggCd("0");
setSort(undefined);
setNotice("");
setPage(1);
router.replace("/oper/obsltPplBiz?bizSe=정밀조사", { scroll: false });