Files
frontend/apps/sn/src/features/obsltPpl/lib/obslt-ppl-excel.ts
T

355 lines
15 KiB
TypeScript

import * as XLSX from "xlsx";
import XlsxPopulate from "xlsx-populate/browser/xlsx-populate";
import { formatDate } from "@/shared/util/util";
import type { ObsltPplBusiness, ObsltPplBusinessSaveRequest } from "../model/obslt-ppl-types";
type BusinessType = ObsltPplBusinessSaveRequest["bizSe"];
type SheetContract = {
sheetName: BusinessType;
businessCodeHeader: string;
extensionHeader: string;
progressHeader: string;
startDateHeader: string;
};
const SHEET_CONTRACTS: SheetContract[] = [
{
sheetName: "정밀조사",
businessCodeHeader: "정밀조사사업코드",
extensionHeader: "조사연장(km)",
progressHeader: "정밀조사추진현황",
startDateHeader: "착수(예정)일자(yyyy.mm.dd)",
},
{
sheetName: "정비사업",
businessCodeHeader: "정비사업사업코드",
extensionHeader: "정비연장(km)",
progressHeader: "정비사업추진현황",
startDateHeader: "착공(예정)일자(yyyy.mm.dd)",
},
];
const DATA_START_ROW_INDEX = 7;
const FIRST_DATA_COLUMN_INDEX = 1;
const DATA_COLUMN_COUNT = 20;
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();
/** SheetJS 셀의 화면 표시값을 원본 양식과 같은 문자열로 읽는다. */
const cellText = (sheet: XLSX.WorkSheet, rowIndex: number, columnIndex: number) => {
const cell = sheet[XLSX.utils.encode_cell({ r: rowIndex, c: columnIndex })];
return cell ? XLSX.utils.format_cell(cell).trim() : "";
};
/** 새 업로드 양식의 공통·업무별 핵심 헤더가 정확한 위치에 있는지 확인한다. */
const validateHeaders = (sheet: XLSX.WorkSheet, contract: SheetContract) => {
const expectedHeaders: Array<[number, number, string]> = [
[5, 1, "순번"], [5, 2, "정밀조사차수"], [5, 3, contract.businessCodeHeader],
[5, 4, "시도"], [5, 5, "시군"], [5, 6, "환경청"], [5, 7, "사업명"],
[5, 8, "추진현황"], [5, 9, "착수년도"], [5, 10, "준공(예정)년도"],
[5, 11, contract.extensionHeader], [6, 11, "계획연장(km)"],
[6, 12, "상반기(예상)연장(km)"], [6, 13, "잔여연장(km)"],
[6, 14, "증빙서류제출여부"], [5, 15, contract.progressHeader],
[6, 15, contract.startDateHeader], [6, 16, "준공(예정)일자(yyyy.mm.dd)"],
[5, 17, "사업추진부진사유"], [5, 18, "사업담당자(지자체)"],
[6, 18, "이름"], [6, 19, "연락처"], [5, 20, "비고"],
];
for (const [rowIndex, columnIndex, expected] of expectedHeaders) {
const actual = normalizeHeader(cellText(sheet, rowIndex, columnIndex));
if (actual !== normalizeHeader(expected)) {
const address = XLSX.utils.encode_cell({ r: rowIndex, c: columnIndex });
throw new Error(
`${contract.sheetName} 시트 ${address} 헤더가 올바르지 않습니다. 기대값: '${expected}', 실제값: '${actual || "(빈 값)"}'`,
);
}
}
};
/** 빈 셀과 대시 표기를 API의 null 값으로 정규화한다. */
const optionalText = (value: string): string | null => {
const normalized = value.trim();
return !normalized || normalized === "-" ? null : normalized;
};
/** 필수 문자열을 검사하고 시트·행이 포함된 오류를 제공한다. */
const requiredText = (value: string, sheetName: string, rowNumber: number, fieldName: string) => {
const normalized = optionalText(value);
if (!normalized) throw new Error(`${sheetName} 시트 ${rowNumber}행의 ${fieldName} 값은 필수입니다.`);
return normalized;
};
/** 연장 셀의 콤마와 km 단위를 제거하고 유한한 숫자로 변환한다. */
const optionalDecimal = (value: string, sheetName: string, rowNumber: number, fieldName: string): number | null => {
const normalized = optionalText(value)?.replace(/,/g, "").replace(/km/gi, "").trim();
if (!normalized) return null;
const parsed = Number(normalized);
if (!Number.isFinite(parsed)) {
throw new Error(`${sheetName} 시트 ${rowNumber}행의 ${fieldName} 값이 숫자가 아닙니다.`);
}
return parsed;
};
/** 연도 셀은 DB 계약에 맞게 최초 4자리 연도를 보존한다. */
const yearText = (value: string): string | null => {
const normalized = optionalText(value);
if (!normalized) return null;
return normalized.match(/(19|20)\d{2}/)?.[0] ?? normalized.slice(0, 4);
};
/** 혼합 날짜 표기에서 숫자를 추출하고 DB 최대 길이 8자로 제한한다. */
const dateText = (value: string): string | null => {
const normalized = optionalText(value);
if (!normalized) return null;
const digits = normalized.replace(/[^0-9]/g, "");
return (digits || normalized).slice(0, 8);
};
/** B~U가 모두 비어 있는 행은 데이터가 아닌 양식 여백으로 판단한다. */
const isEmptyDataRow = (sheet: XLSX.WorkSheet, rowIndex: number) =>
Array.from({ length: DATA_COLUMN_COUNT }, (_, offset) =>
cellText(sheet, rowIndex, FIRST_DATA_COLUMN_INDEX + offset),
).every((value) => !value.trim());
/** 한 업무 시트의 데이터행을 JSON 저장 요청으로 변환한다. */
const parseSheet = (sheet: XLSX.WorkSheet, contract: SheetContract): ObsltPplBusinessSaveRequest[] => {
validateHeaders(sheet, contract);
const range = XLSX.utils.decode_range(sheet["!ref"] ?? "A1:A1");
const result: ObsltPplBusinessSaveRequest[] = [];
for (let rowIndex = DATA_START_ROW_INDEX; rowIndex <= range.e.r; rowIndex += 1) {
if (isEmptyDataRow(sheet, rowIndex)) continue;
const values = Array.from({ length: DATA_COLUMN_COUNT }, (_, offset) =>
cellText(sheet, rowIndex, FIRST_DATA_COLUMN_INDEX + offset),
);
const valueAt = (index: number) => values[index] ?? "";
const rowNumber = rowIndex + 1;
const originalBizCd = optionalText(valueAt(2));
result.push({
bizSe: contract.sheetName,
prcisExmnCycl: optionalText(valueAt(1)),
bizCd: originalBizCd ?? "",
sggCd: null,
ctpvNm: optionalText(valueAt(3)),
sigunNm: optionalText(valueAt(4)),
envoNm: optionalText(valueAt(5)),
bizNm: requiredText(valueAt(6), contract.sheetName, rowNumber, "사업명"),
prplPrst: optionalText(valueAt(7)),
bgngYr: yearText(valueAt(8)),
cmcnYr: yearText(valueAt(9)),
planPrlg: optionalDecimal(valueAt(10), contract.sheetName, rowNumber, "계획연장(km)"),
frhfyrExpcPrlg: optionalDecimal(valueAt(11), contract.sheetName, rowNumber, "상반기(예상)연장(km)"),
rmndPrlg: optionalDecimal(valueAt(12), contract.sheetName, rowNumber, "잔여연장(km)"),
evdncDcmntSbmsnStts: optionalText(valueAt(13)),
bgngYmd: dateText(valueAt(14)),
cmcnYmd: dateText(valueAt(15)),
bizPrplDlyRsnCn: optionalText(valueAt(16)),
bizPicNm: optionalText(valueAt(17)),
bizPicCnpl: optionalText(valueAt(18)),
rmrkCn: optionalText(valueAt(19)),
});
}
return result;
};
/** ArrayBuffer workbook을 검증·파싱하여 두 시트의 JSON 저장 요청을 반환한다. */
export const parseObsltPplWorkbook = (workbookData: ArrayBuffer | Uint8Array): ObsltPplBusinessSaveRequest[] => {
const workbook = XLSX.read(workbookData, { type: "array", cellDates: false });
const rows = SHEET_CONTRACTS.flatMap((contract) => {
const sheet = workbook.Sheets[contract.sheetName];
if (!sheet) throw new Error(`필수 시트가 없습니다: ${contract.sheetName}`);
return parseSheet(sheet, contract);
});
if (rows.length === 0) throw new Error("업로드할 사업 자료가 없습니다.");
return rows;
};
/** 사용자가 선택한 xlsx 파일을 브라우저에서 읽고 JSON 요청 목록으로 변환한다. */
export const parseObsltPplExcel = async (file: File): Promise<ObsltPplBusinessSaveRequest[]> => {
if (!file.name.toLowerCase().endsWith(".xlsx")) throw new Error("xlsx 파일만 업로드할 수 있습니다.");
return parseObsltPplWorkbook(await file.arrayBuffer());
};
/** 업로드 검증과 정확히 같은 B6:U7 위치에 시트별 헤더를 배치한다. */
const downloadHeaderRows = (contract: SheetContract) => {
const rows = Array.from({ length: DATA_START_ROW_INDEX }, () => Array<string | number>(21).fill(""));
const topHeaders = [
"순번", "정밀\n조사\n차수", contract.businessCodeHeader.replace("사업코드", "\n사업코드"),
"시도", "시군", "환경청", "사업명", "추진현황", "착수\n년도", "준공(예정)\n년도",
contract.extensionHeader, "", "", "", contract.progressHeader.replace("추진현황", " 추진현황"),
"", "사업추진 부진 사유", "사업 담당자(지자체)", "", "비고",
];
const bottomHeaders = [
"", "", "", "", "", "", "", "", "", "", "계획연장(km)", "상반기(예상)연장(km)",
"잔여연장(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; });
return rows;
};
/** DB에 저장하지 않는 B열 순번을 시트 출력 순서로 만들고 C~U에 업무값을 배치한다. */
const downloadDataRow = (row: ObsltPplBusiness, index: number): Array<string | number> => [
"",
index + 1,
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 ?? "",
excelTextValue(row.evdncDcmntSbmsnStts),
formatDate(row.bgngYmd),
formatDate(row.cmcnYmd),
excelTextValue(row.bizPrplDlyRsnCn),
excelTextValue(row.bizPicNm),
excelTextValue(row.bizPicCnpl),
excelTextValue(row.rmrkCn),
];
/** 조회 결과를 정밀조사·정비사업 두 시트의 재업로드 가능한 위치 구조로 생성한다. */
export const buildObsltPplWorkbook = (businesses: ObsltPplBusiness[]): XLSX.WorkBook => {
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([
...headerRows,
...data.map(downloadDataRow),
]);
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,
];
worksheet["!cols"] = widths.map((wch) => ({ wch }));
XLSX.utils.book_append_sheet(workbook, worksheet, contract.sheetName);
});
return workbook;
};
/** 확정 원본의 제목·병합 헤더·구분색과 고정 본문 높이를 적용해 브라우저 다운로드를 시작한다. */
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:U7").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:U7").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}:U${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"].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);
};