적산설계 시스템

적산설계 시스템 로고

적산설계 시스템 — 건설·설비 공사 원가 산출 통합 관리

설계도면 기반의 공사비 적산 및 원가 관리 시스템입니다. 대규모 시설투자를 수행하는 제조사의 건설·설비 공사에서 자재, 노무, 장비의 수량을 체계적으로 산출하고, 단가를 적용하여 정확한 공사 원가를 산정합니다. 품셈·단가 마스터 데이터 관리부터 내역서 작성, 계약·견적 관리, 결재 시스템 연동까지 적산설계 업무 전 과정을 웹 기반으로 통합 관리합니다.


적산설계란?

적산(積算)이란 설계도면에 근거하여 공사에 필요한 자재를 공종별로 분류하고 물량을 산출한 뒤, 단가를 적용하여 공사비를 산정하는 일련의 과정입니다. 한자를 풀면 적(積)은 물량을 산출(수량 산출)하는 단계, 산(算)은 단가·노무비·경비를 적용하여 비용을 산정하는 단계를 의미합니다. 영어로는 Quantity Surveying 또는 Cost Estimation에 해당합니다.

왜 필요한가? 건설·설비 공사에서는 자재비, 노무비, 경비가 복잡하게 얽혀 있어, 체계적인 적산 없이는 정확한 공사비 산정이 불가능합니다. 특히 제조사의 대규모 시설투자(공장 신축, 설비 교체, 라인 증설 등)에서는 토목·건축·기계설치·전기계장 등 다양한 공종이 동시에 진행되므로, 공종별 물량 산출과 비용 관리가 투자 의사결정의 핵심 기초 자료가 됩니다.

제조사에서의 활용: 철강·반도체·석유화학 등 시설투자를 대규모로 수행하는 제조기업에서는 CAPEX(자본적 지출) 예산 수립 시 건축, 기계설비, 전기, 계장, 배관 등 공종별 비용을 체계적으로 산출합니다. 고정가(Lump Sum) 계약에서 비용 초과는 곧 손실로 직결되므로, 정밀한 적산이 리스크 관리의 핵심입니다. 기존 설비의 개보수·교체 공사 시에도 적산을 통해 정확한 비용을 산정하고 예산을 확보합니다.


적산 프로세스

적산설계 시스템은 설계도면에서 최종 공사원가 산출까지의 전체 프로세스를 체계적으로 지원합니다.

적산설계 업무 프로세스
설계도면
CAD/BIM 도면
수량 산출
공종별 물량 집계
단가 적용
품셈·시중단가
원가 계산
비목별 집계
내역서 작성
공사비 산출서
결재·계약
BPM 연동

시스템 아키텍처

Vue 3 기반 SPA 프론트엔드와 NestJS API 서버, MariaDB 데이터베이스로 구성된 3계층 웹 애플리케이션입니다. SSO 통합인증과 BPM 결재 시스템을 외부 연동합니다.

시스템 아키텍처
Frontend
Vue 3 Vite TypeScript Vue Router Axios ExcelJS Luxon
129개 페이지 뷰 · 34개 재사용 컴포넌트 · 49개 API 모듈
Backend
NestJS Fastify TypeORM JWT Auth BCrypt Nodemailer
51개 API 모듈 · 48개 Entity · RBAC 권한 관리
Database
MariaDB 10 TypeORM Migration
32개 마이그레이션 · 11개 시드 데이터셋
SSO 통합인증
Single Sign-On
BPM 결재
Business Process
Docker
컨테이너 배포
Nginx
Reverse Proxy

기술 스택

구성 요소기술 스택역할
FrontendVue 3, Vite 5, TypeScript 5.3SPA 프론트엔드 프레임워크
UI 컴포넌트커스텀 컴포넌트 34종 (Grid, Form, Button 등)일관된 UI/UX 제공
상태 관리Global Store (Reactive)전역 상태 및 마스터 데이터 관리
HTTP 클라이언트Axios49개 API 모듈과 통신
Backend FrameworkNestJS 10, Fastify모듈 기반 RESTful API 서버
ORMTypeORM 0.348개 Entity, 마이그레이션 관리
인증·보안JWT (Access/Refresh Token), BCrypt, XSS Prevention이중 토큰 인증, 비밀번호 암호화, XSS 방지
DatabaseMariaDB 10공사·단가·품셈·계약 데이터 저장
엑셀 처리ExcelJS, XLSX마스터 데이터 일괄 등록·다운로드
이메일Nodemailer인증코드 발송, 알림 이메일
배포Docker, Nginx, Multi-stage Build컨테이너 기반 무중단 배포

요청 처리 파이프라인

클라이언트 요청은 다단계 보안 검증과 데이터 검증을 거쳐 처리됩니다.

Backend 요청 처리 파이프라인
HTTP Request
Fastify
Host 검증
Middleware
JWT 인증
AuthGuard
권한 확인
Permission
DTO 검증
ValidationPipe
XSS 방지
Sanitize
비즈니스 로직
Service → DB

주요 화면

로그인 & 대시보드

로그인 화면에서는 ID/PW 인증 및 SSO 통합인증을 지원합니다. 대시보드에서는 진행 중인 공사 건수, 결재 현황을 한눈에 파악하고, 공지사항·FAQ·자료실에 빠르게 접근할 수 있습니다.

적산설계 시스템 로그인 화면
로그인 화면
적산설계 시스템 대시보드
메인 대시보드

적산설계 — 공사 목록 관리

투자 Code, 진행 단계, 공사명으로 공사를 검색하고 관리합니다. 각 공사의 담당자, 공사설계 Code, 투자 Code, 공사 기간, 진행 단계를 일목요연하게 표시하며, 신규 공사 정보 등록과 삭제가 가능합니다. 임시 저장 → 결재 진행 → 완료의 단계별 흐름을 추적합니다.

공사 목록 관리
적산설계 공사 목록 관리

Master 관리 — 품셈 Master

품셈(品셈)은 공사 단가 산출의 기준 데이터입니다. 기준 연월일, 분야, 중분류로 필터링하여 품셈 데이터를 관리합니다. 변압기 설치, 차단기 설치, 배전반 설치 등 전기설비·기계설비·토목·건축 분야별 품셈 코드와 상세 정보를 등록·편집합니다. 엑셀 일괄 등록으로 대량 데이터를 효율적으로 관리합니다.

품셈 Master 관리
품셈 Master 관리

Master 관리 — 단가 Master (Resource 단가)

장비, 운반, 임대장비, 등록장비 등 자원 유형별 단가 정보를 관리합니다. 불도저, 유압식 리퍼 등 건설장비의 코드, 장비명, 용량, 단위(HR), 단가(원)를 체계적으로 등록합니다. 자재·노무·장비 3대 자원의 단가를 대분류·중분류 체계로 분류하여 관리하며, 엑셀 일괄 등록·다운로드를 지원합니다.

단가 Master 관리
단가 Master – Resource 단가 관리

Master 관리 — 분류 관리 & 데이터 관리

분류 관리에서는 장비·노무·자재·품셈 자원의 코드 분류 체계(대분류→중분류)를 정의합니다. 데이터 관리에서는 기준 데이터 세트를 버전별로 관리하여, 연도별 단가 데이터나 관리비 요율 등을 일괄 적용할 수 있습니다.

분류 관리
분류 관리
데이터 관리
데이터 관리

비목 체계 관리 (시스템 코드)

공사 원가의 핵심인 비목(費目) 체계를 정의합니다. 자재비(직접재료비, 간접재료비, 작업설 부산물), 노무비(직접노무비, 간접노무비), 경비(운반비, 기계경비, 보험료, 안전관리비 등)의 산출 공식과 요율을 설정합니다.

시스템 코드 - 비목 체계
비목 체계 관리 (시스템 코드)

구분 공사 항목 관리

공종(공사 종류)을 분야별로 체계적으로 관리합니다. 공통, 토목, 건축, 기계/축로, 전기/계장/통신, 유지관리 6개 분야로 나누어, 각 분야의 구분 공사명과 세부 공종을 코드 체계로 정의합니다. 기계설치, 제철기계설비, 배관, 보온, 용접 등 제조사 시설공사에 특화된 공종 분류를 지원합니다.

구분 공사 항목 관리
구분 공사 항목 관리

계약 관리 & 견적 단가 관리

계약 관리에서는 적산이 완료된 공사의 계약 정보를 등록하고 진행 상태를 추적합니다. BPM 결재 시스템과 연동하여 결재 프로세스를 자동화합니다. 견적 단가 관리에서는 공사별 견적 항목을 생성하고, 견적 업체별 제출 단가를 비교·관리하여 최적의 비용을 산정합니다.

계약 관리
계약 관리
견적 단가 관리
견적 단가 관리

시스템 관리 & 사용자 관리

시스템 마스터에서는 공지사항, FAQ, 자료실, 변경 데이터 로그를 관리합니다. 사용자 관리에서는 비밀번호 + 이메일 인증의 2단계 인증을 통해 관리자 접근을 제어하며, 역할(Role) 기반 권한 관리(RBAC)로 세밀한 접근 제어를 구현합니다.

공지사항 관리
시스템 마스터 – 공지사항 관리
사용자 관리
사용자 관리 – 2단계 인증

비목 체계 아키텍처

공사 원가는 자재비·노무비·경비의 3대 비목으로 구성되며, 각 비목의 산출 공식과 요율을 시스템 코드로 정의합니다.

공사 원가 비목 체계
자재비 (A)
A1. 직접재료비수량×단가
A2. 간접재료비수량×단가
A3. 작업설 부산물수량×단가
AS. 소계 = A1+A2+A3
노무비 (B)
B1. 직접노무비인원×단가
B2. 간접노무비인원×단가
BS. 소계 = B1+B2
경비 (C)
C1. 운반비
C2. 기계경비
C3. 재료시험비
C4. 산재보험료 = BS×요율
C5. 고용보험료 = BS×요율
C6. 건강보험료 = B1×요율
C7. 연금보험료 = B1×요율
C8. 장기요양보험 = C6×요율
CA. 안전관리비 = (A1+A2+B1)×요율
CS. 소계
자재비 + 노무비 + 경비 + 일반관리비 + 이윤 + 부가세 = 총 공사원가

데이터 모델 구조

48개 Entity로 구성된 데이터 모델은 적산설계, 자원 관리, 계약, 견적, 사용자 5개 도메인으로 구분됩니다.

도메인 모델 구조 (48 Entities)
적산설계 (10 Entities)
Construction ConstructionDetail DetailTypeCart CartHistory Version Category AccessManager
자원 관리 (8 Entities)
Work WorkType WorkResource Resource ResourceCategory UnitPrice ResourceDate
비용 관리 (8 Entities)
Expenditure ExpenditureRate IndirectLaborRate SafetyManageCost Investment BudgetMst
계약·견적 (8 Entities)
Contract ContractEstimate Approval Quotation QuotationItem QuotationPrice QuotationCompany
사용자·시스템 (10 Entities)
User SsoUser Role Permission Log Notice FAQ File
공사 분류 (4 Entities)
ConstructionType DetailType CategoryField ManageCostSection

모듈 아키텍처

백엔드 51개 API 모듈은 도메인별로 그룹화되어, 각 모듈이 Controller → Service → Entity의 일관된 CRUD 패턴을 따릅니다.

Backend API 모듈 아키텍처 (51 Modules)
적산설계 관리
constructions · construction_details · construction_categories · construction_versions · construction_detail_types · construction_detail_type_carts · cart_histories · construction_access_managers · construction_expenditure_rates · construction_category_fields
10 modules
작업·자원 관리
works · work_types · work_resources · work_resource_quantities · resource_categories · resource_dates · unit_prices
7 modules
비용·투자 관리
expenditures · expenditure_rates · indirect_labor_rates · safety_manage_cost_types · safety_manage_cost_rates · manage_cost_sections · investments · investment_budget_mst · investment_budget_act
9 modules
계약·견적 관리
contracts · contract_estimates · contract_estimate_items · approvals · quotations · quotation_categories · quotation_companies · quotation_items · quotation_prices
9 modules
사용자·인증
auth · users · roles · permissions · role_permissions · sso_users · user_menu_moves
7 modules
시스템·기타
notices · faqs · files · logs · batch_scheduling · construction_types · construction_detail_types
9 modules

보안 아키텍처

다층 보안 체계로 인증·인가·데이터 보호를 구현합니다.

보안 아키텍처
인증 (Authentication)
• JWT 이중 토큰 (Access 1분 / Refresh 30분)
• SSO 통합인증 연동
• BCrypt 비밀번호 해싱
• 이메일 2단계 인증
• 임시 비밀번호 강제 변경
인가 (Authorization)
• RBAC (Role-Based Access Control)
• 15개 권한 카테고리 (PermissionType)
• @RequirePermission 데코레이터
• 공사별 접근 권한 관리
• @Public() 데코레이터 (예외 처리)
데이터 보호
• XSS Prevention Pipe (sanitize-html)
• Host Verification Middleware
• CORS Origin 제한
• DTO 검증 (class-validator)
• 감사 로그 (CRUD 전체 기록)

프로젝트 규모

지표수량설명
Backend API 모듈51개NestJS 도메인별 모듈
Database Entity48개TypeORM Entity (테이블)
DB 마이그레이션32개스키마 변경 이력
Frontend 페이지129개Vue 3 페이지 뷰
Frontend 컴포넌트34개재사용 UI 컴포넌트
API 클라이언트 모듈49개Axios 기반 HTTP 클라이언트
권한 카테고리15종RBAC 기반 접근 제어
공종 분야6개공통/토목/건축/기계·축로/전기·계장·통신/유지관리