← 포트폴리오 목록

공사기간 적정성 검토 자동화 콘솔

설계·구현 참고 자료 — 고객 납품 실적으로 구분된 항목이 아닙니다.

엑셀 형식 건설공사 내역서를 업로드하면 공종명을 표준품셈 명칭에 자동 매핑하고, 기상청 API 연동으로 현장 위치의 비작업일수를 자동 산출합니다.

서비스 타입Web
업종플랫폼
기술 스택
React 18TypeScriptTailwind CSSFastAPISQLAlchemyPostgreSQL + pgvector (벡터 DB)엑셀 (내역서 형식) 파싱 (xlsx)기상청 API 연동RAG 방식 (표준품셈 검색) + LLM (보고서 생성) — Claude API 연동
주요 기능
  • 내역서 업로드 및 공종명 자동 매핑
  • 기상 데이터 연동 및 비작업일수 자동 계산
  • CPM 공정표 및 간트차트 자동 생성
  • 공사기간 적정성 검토 보고서 자동 생성

프로젝트 개요

범위: 개발, 디자인, 기획

엑셀 형식 건설공사 내역서를 업로드하면 공종명을 표준품셈 명칭에 자동 매핑하고, 기상청 API 연동으로 현장 위치의 비작업일수를 자동 산출합니다. CPM 알고리즘 기반 공정표와 간트차트, LLM 기반 검토 보고서 초안까지 한 화면 흐름으로 자동 생성하는 콘솔을 React + FastAPI 기반으로 구현합니다.

작업 범위

  • 내역서 업로드 및 공종명 자동 매핑: 엑셀 형식 건설공사 내역서를 업로드하면 공종명(흙깎기·터파기·토사절취 등 현장 표기 차이)을 자동 인식해 표준품셈 표준 명칭으로 매핑 후보를 제시합니다
  • 기상 데이터 연동 및 비작업일수 자동 계산: 현장 위치를 입력하면 기상청 공공데이터포털 API에서 최근 10년 기상 데이터를 수집하고, 강수량·체감온도 임계값 기반 룰 엔진으로 월별 비작업일수를 자동 산출합니다
  • CPM 공정표 및 간트차트 자동 생성: 매핑된 공종별 순작업일수와 선후행 관계를 입력하면 CPM 알고리즘으로 주공정선을 도출하고 간트차트로 시각화합니다
  • 공사기간 적정성 검토 보고서 자동 생성: 산정 근거(표준품셈 매핑, 비작업일수, 공정표)와 현장 특성을 종합해 LLM 기반으로 공사기간 적정성 검토 보고서 초안을 자동 생성합니다

주요 업무

  • 내역서 업로드 및 공종명 자동 매핑 화면: openpyxl 계열 파서로 내역서 시트 구조를 파싱하고, OpenAI Embeddings로 공종명을 벡터화해 pgvector 코사인 유사도로 표준품셈 후보를 검색한 뒤 LLM으로 최종 보정합니다
  • 기상 데이터 연동 및 비작업일수 자동 계산 화면: 기상청 API 응답을 월 단위로 집계하고, 강수량 3mm 이상·체감온도 33℃ 이상 등 국토부 작업 제한 기준을 조건식으로 모듈화해 비작업일을 판정한 뒤 공휴일 중복분을 제외합니다
  • CPM 공정표 및 간트차트 자동 생성 화면: 작업 노드와 선후행 간선으로 구성된 방향 비순환 그래프에서 최장 경로 탐색으로 주공정선(Critical Path)과 각 작업의 여유일수(Float)를 계산합니다
  • 공사기간 적정성 검토 보고서 자동 생성 화면: 매핑 결과·비작업일수·CPM 산출값을 구조화된 프롬프트로 조합해 Claude API에 전달하고, 산정 근거가 인용된 문서를 생성한 뒤 PDF로 출력합니다
공사기간 적정성 검토 자동화 콘솔
요구사항 정의

프로젝트 핵심 과제

프로젝트 진행 시 해결한 핵심 기술 과제입니다.

현장마다 표기가 다른 공종명(예

흙깎기·터파기·토사절취)을 표준품셈 명칭에 일관되게 매핑하는 정확도 확보 필요

표준품셈 원본 자료 확보 범위에 따라 임베딩 대상 데이터 규모가 달라지는 리스크에 대응할 계획 수립

기상청 API 응답 지연·결측 구간을 보완하는 데이터 검증 및 재수집 로직 설계

비개발자인 클라이언트가 산정 근거를 직관적으로 검토할 수 있

근거 추적 UI 설계 필요

구현 내용

핵심 기능 상세

핵심 기능 1

내역서 업로드 및 공종명 자동 매핑

엑셀 형식 건설공사 내역서를 업로드하면 공종명(흙깎기·터파기·토사절취 등 현장 표기 차이)을 자동 인식해 표준품셈 표준 명칭으로 매핑 후보를 제시합니다.

  • openpyxl 기반 내역서 시트 파서로 공종·수량·단위 컬럼을 구조화 데이터로 변환
  • PostgreSQL pgvector에 표준품셈 명칭 임베딩을 저장하고 RAG 방식으로 유사 공종을 검색
  • 1차 유사도 후보 상위 N개를 LLM 프롬프트에 전달해 최종 매핑을 보정하는 2단계 파이프라인 구성

임베딩 유사도 검색과 LLM 보정을 결합한 2단계 RAG 매핑 구조를 설계해, 현장마다 다른 공종 표기를 표준품셈 체계로 일관되게 정규화합니다.

내역서 업로드 및 공종명 자동 매핑
내역서 업로드 및 공종명 자동 매핑 실제 화면
핵심 기능 2

기상 데이터 연동 및 비작업일수 자동 계산

현장 위치를 입력하면 기상청 공공데이터포털 API에서 최근 10년 기상 데이터를 수집하고, 강수량·체감온도 임계값 기반 룰 엔진으로 월별 비작업일수를 자동 산출합니다.

  • 기상청 공공데이터포털 API를 일자별로 배치 수집하고 지역 코드 기반 캐싱으로 재수집 비용 절감
  • 강수량·체감온도·풍속·적설량 임계값을 설정 가능한 룰 엔진으로 모듈화해 비작업일 판정 로직 구현
  • 공휴일 데이터와 비작업일 산출 결과를 교차 검증해 중복 카운트를 제거하는 집계 로직 설계

임계값 기반 룰 엔진과 공휴일 중복 제거 로직을 분리 설계해, 기상 기준이 바뀌어도 계산 로직을 재사용할 수 있는 구조를 구현합니다.

기상 데이터 연동 및 비작업일수 자동 계산
기상 데이터 연동 및 비작업일수 자동 계산 실제 화면
핵심 기능 3

CPM 공정표 및 간트차트 자동 생성

매핑된 공종별 순작업일수와 선후행 관계를 입력하면 CPM 알고리즘으로 주공정선을 도출하고 간트차트로 시각화합니다.

  • 작업 노드·선후행 관계를 방향 그래프로 모델링하고 최장 경로 탐색 알고리즘으로 주공정선 도출
  • Forward/Backward Pass 계산으로 각 작업의 여유일수(Total Float)를 산출해 지연 위험 작업 식별
  • Recharts 커스텀 렌더링으로 시간축 기반 간트차트를 구현해 주공정선을 강조 색상으로 표시

CPM 알고리즘을 직접 구현해 선후행 관계 변경 시 주공정선과 여유일수가 즉시 재계산되는 인터랙티브 간트차트를 구현합니다.

CPM 공정표 및 간트차트 자동 생성
CPM 공정표 및 간트차트 자동 생성 실제 화면
핵심 기능 4

공사기간 적정성 검토 보고서 자동 생성

산정 근거(표준품셈 매핑, 비작업일수, 공정표)와 현장 특성을 종합해 LLM 기반으로 공사기간 적정성 검토 보고서 초안을 자동 생성합니다.

  • 매핑·비작업일수·CPM 산출 데이터를 구조화 프롬프트로 변환하는 템플릿 엔진 설계
  • Claude API 기반 LLM으로 산정 근거가 인용된 검토 보고서 초안 섹션별 자동 생성
  • jsPDF 기반 보고서 PDF 변환 및 산정 근거 표·간트차트 이미지 삽입 렌더링

산정 데이터를 근거 인용 구조로 프롬프트화하는 템플릿 엔진을 설계해, LLM이 임의로 수치를 지어내지 않고 실제 계산 결과만 인용하도록 구현합니다.

공사기간 적정성 검토 보고서 자동 생성
공사기간 적정성 검토 보고서 자동 생성 실제 화면
구현 과정

프로젝트 진행 단계

STEP 1

표준품셈 데이터 적재 및 임베딩 파이프라인 구축 · 2026.09

표준품셈 원본 자료 정제, OpenAI Embeddings로 벡터화 후 pgvector 테이블 설계·적재

STEP 2

공종명 매핑 및 기상청 API 연동 개발 · 2026.09

RAG 기반 공종명 매핑 API 구현, 기상청 공공데이터포털 연동 및 비작업일수 룰 엔진 개발

STEP 3

CPM 공정표·간트차트 엔진 구현 · 2026.09

선후행 관계 그래프 모델링, 주공정선 탐색 알고리즘과 Recharts 간트차트 뷰 구현

STEP 4

LLM 보고서 생성 및 통합 테스트 · 2026.09

Claude API 기반 보고서 템플릿 엔진 구현, 전체 파이프라인 통합 테스트 및 PDF 출력 검증

개발 결과

표준품셈 임베딩 매칭 파이프라인 구현pgvector 코사인 유사도 검색으로 현장 공종명을 표준품셈 명칭에 자동 매핑, LLM 보정 단계로 상위 후보를 재순위화
비작업일수 룰 엔진 설계강수량 3mm·체감온도 33℃ 등 국토부 기준을 조건식으로 모듈화해 월별 비작업일수를 자동 산출, 공휴일 중복 제거 로직 구현
CPM 주공정선 알고리즘 구현작업 선후행 관계 그래프에서 최장 경로를 탐색하는 CPM 알고리즘을 직접 구현해 주공정선과 여유일수 자동 계산
LLM 기반 보고서 초안 생성 파이프라인 구축산정 근거·기상 분석·공정표 데이터를 구조화 프롬프트로 변환해 Claude API로 검토 보고서 초안을 자동 생성

기술적 주안점

  • 임베딩 유사도 검색과 LLM 보정을 결합한 2단계 RAG 매핑 구조를 설계해, 현장마다 다른 공종 표기를 표준품셈 체계로 일관되게 정규화합니다
  • 임계값 기반 룰 엔진과 공휴일 중복 제거 로직을 분리 설계해, 기상 기준이 바뀌어도 계산 로직을 재사용할 수 있는 구조를 구현합니다
  • CPM 알고리즘을 직접 구현해 선후행 관계 변경 시 주공정선과 여유일수가 즉시 재계산되는 인터랙티브 간트차트를 구현합니다

유사한 프로젝트를 기획하고 계신가요?

필요한 기능과 일정을 알려주시면 개발 범위를 함께 정리하겠습니다.

프로젝트 문의