OpenConstructionERP를 전문적인 건설 비용 견적에 설치, 구성, 사용하기 위해 필요한 모든 것.
온보딩 → 새 프로젝트 → BoQ → BIM 연결 → DWG → PDF 적산 → 전체 견적 → 작업 → 데이터 탐색기 → AI 견적 → 포트폴리오.
자막, 챕터, 1.5배속 재생 기능이 위 플레이어에 내장되어 있습니다. YouTube에서 바로 시청하시겠습니까? ▶ YouTube에서 열기 · 새 릴리스 둘러보기를 받아보려면 채널 구독하기.
아래의 각 블록은 위 전체 둘러보기에서 잘라낸 짧은 GIF이며, 영상과 동일한 순서로 배치되어 있어 가장 중요한 워크플로로 바로 이동할 수 있습니다. 끊김 없는 하나의 흐름으로 보고 싶으신가요? ▶ YouTube에서 12분 분량의 둘러보기 영상 보기.
OpenConstructionERP는 사용자의 컴퓨터에서 완전히 실행되는 완성형 건설 비용 견적 및 프로젝트 관리 플랫폼입니다. 값비싼 상용 견적 도구를 개방적이고 자체 호스팅 가능한 대안으로 대체합니다. 이 플랫폼은 초기 타당성 조사와 수량 적산부터 상세 BOQ 작성, 입찰, 입찰가 비교, 프로젝트 실행, 품질 관리, 재무 통제에 이르기까지 건설 생애주기 전체를 다룹니다. 모든 데이터는 사용자의 서버에 남습니다. 클라우드 의존성도, 구독료도, 좌석당 요금도 없습니다.
v18.5.0 주요 내용: 건설 전 과정을 다루는 190개 이상의 모듈: 연락처 디렉터리, 칸반 작업, RFI 추적, 재무(청구서, 예산, EVM), 구매, 안전, 회의, 품질 검사, NCR, submittals, 서신, CDE(ISO 19650), transmittals, BIM Hub, COBie 내보내기가 되는 자산 대장, 보고 & KPI 대시보드, markups(PDF↔DWG↔hub), 피벗 시각화 & 차트 열 선택기, 교체 가능한 이메일 서비스, 멀티테넌트 연락처, 예약 보고서, Regional Packs, 전체 가져오기/내보내기.


섹션, 항목, 자원, 어셈블리, 자동 마크업을 갖춘 계층형 수량 산출서.
9개 국가 출처의 단가 기준을 현지 통화와 언어로 48개 시장 버전으로 발행하며, 36개 지역 데이터베이스를 가져올 수 있습니다.
모든 LLM 공급자를 사용해 텍스트, 사진, PDF, Excel 또는 CAD/BIM 모델로부터 BOQ를 생성합니다.
DDC 변환기를 통해 RVT, IFC, DWG, DGN에서 수량을 추출합니다.
CPM을 활용한 간트 일정, 획득가치관리(EVM), S곡선, 몬테카를로 시뮬레이션.
재무, 안전, 품질, CDE, BIM Hub, 조달, RFI, 작업, 회의 등. 필요한 것만 활성화하세요.
OpenConstructionERP를 설치한 후, 다음 단계에 따라 첫 프로젝트를 설정하고 첫 비용 견적을 작성하세요. 전체 과정은 약 10분 정도 걸립니다.
브라우저를 열고 http://localhost:5173(로컬 개발) 또는 http://localhost:8080(Docker)으로 이동하세요. "데모 액세스" 패널이 있는 로그인 페이지가 표시됩니다. Admin을 클릭하면 데모 계정으로 즉시 로그인되며, 새 계정을 등록한 경우 자신의 자격 증명을 입력하세요.
첫 로그인 시 온보딩 마법사가 초기 설정 과정을 안내합니다:
대시보드에서 새 프로젝트를 클릭하거나 프로젝트로 이동하세요. 다음을 입력합니다:
프로젝트를 생성하면 BOQ 추가를 시작할 수 있는 프로젝트 상세 페이지로 이동합니다.
프로젝트 페이지에서 새 견적을 클릭하세요. 이름을 지정하고(예: "비용 견적 v1") 선택적으로 템플릿을 선택하세요. 첫 번째 항목을 입력할 수 있는 빈 그리드와 함께 BOQ 편집기가 열립니다.
BOQ 편집기에서 항목 추가를 클릭하거나 빈 행에서 Enter를 누르세요. 다음을 입력합니다:
합계 열은 자동으로 계산됩니다(수량 x 단가). 또한 항목 옆의 데이터베이스 아이콘을 클릭하여 120,000개 이상의 CWICR 항목에서 단가를 찾아 적용할 수 있습니다.
OpenConstructionERP는 기술적 배경에 관계없이 쉽게 설치할 수 있도록 설계되었습니다. 설정에 맞는 방법을 선택하세요 - 모든 옵션은 5분 이내에 완료됩니다. 애플리케이션은 기본적으로 내장 PostgreSQL을 사용하므로(Docker 불필요, 별도의 데이터베이스 서버 불필요, 설정 불필요) 모든 것이 즉시 작동합니다. pip 및 원라인 경로에는 Python 3.12 이상이 필요합니다.
pip install --upgrade openconstructionerp
openconstructionerp백엔드와 사전 빌드된 React 프론트엔드를 하나의 휠로 설치합니다. http://localhost:8080에서 전체 UI와 함께 열립니다. 내장 PostgreSQL, 구성 불필요. 문제가 있어 보이면 openconstructionerp doctor를 실행하세요.
Ubuntu 23.04 이상(Ubuntu 26 포함) 및 Debian 12 이상에서는 시스템 Python에 직접 pip install하면 error: externally-managed-environment(PEP 668)로 실패합니다. 대신 가상 환경을 사용하세요:
# Ubuntu 26 - install Python 3.12 explicitly if needed
sudo apt install -y python3.12 python3.12-venv
# Create and activate a venv, then install
python3.12 -m venv ~/ocerp-venv
source ~/ocerp-venv/bin/activate
pip install --upgrade openconstructionerp
openconstructionerppip가 소스 빌드로 폴백되는 경우 헤더를 설치하세요: sudo apt install -y build-essential libpq-dev libjpeg-dev zlib1g-dev libgeos-dev. 문제 해결을 포함한 전체 Linux 가이드: docs/INSTALL_LINUX.md.
# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/datadrivenconstruction/OpenConstructionERP/main/scripts/install.sh | bash
# Windows (PowerShell)
irm https://raw.githubusercontent.com/datadrivenconstruction/OpenConstructionERP/main/scripts/install.ps1 | iexDocker가 설치되어 있으면 Docker를, 없으면 uv를, 그것도 없으면 pip를 선택합니다. http://localhost:8080에서 실행됩니다.
git clone https://github.com/datadrivenconstruction/OpenConstructionERP.git
cd OpenConstructionERP
make quickstarthttp://localhost:8080에서 열립니다(첫 빌드 시 약 2분).
git clone https://github.com/datadrivenconstruction/OpenConstructionERP.git
cd OpenConstructionERP
# Backend (embedded PostgreSQL, zero config)
cd backend && pip install -r requirements.txt
uvicorn app.main:create_app --factory --reload --port 8000
# Frontend (new terminal)
cd frontend && npm install && npm run dev백엔드: http://localhost:8000 / 프론트엔드: http://localhost:5173
| 계정 | 이메일 | 비밀번호 | 역할 |
|---|---|---|---|
| Admin | demo@openconstructionerp.com | DemoPass1234! | 전체 액세스 |
| Estimator | estimator@openconstructionerp.com | DemoPass1234! | 견적 담당자 |
| Manager | manager@openconstructionerp.com | DemoPass1234! | 관리자 |
완전한 BOQ, 일정, 비용 모델을 갖춘 5개 데모 프로젝트(베를린, 런던, 뉴욕, 파리, 두바이).
수량 산출서 편집기는 가장 많은 시간을 보내는 곳입니다. AG Grid 기반의 전문적인 스프레드시트형 인터페이스에 건설 특화 기능이 내장되어 있습니다 - 계층형 섹션, 자원 연결, 어셈블리 레시피, 자동 마크업 계산. 모든 변경은 전체 실행 취소/다시 실행 지원과 함께 추적됩니다. 42개의 검증 규칙이 백그라운드에서 자동으로 실행되어 수량 누락, 단가 0, 항목 중복, 분류 준수 문제 등의 오류를 문제가 되기 전에 잡아냅니다.
🎬 YouTube에서 BOQ 편집기 작동 영상 보기 - 키보드 우선 편집, 120,000개 이상의 가격 책정 항목, 실시간 품질 점수.



섹션은 BOQ를 논리적 그룹으로 정리합니다(예: "300 구조", "400 HVAC"). 섹션을 생성하려면:
특정 공종에 집중하기 위해 섹션을 접거나 펼칠 수 있습니다. 섹션을 끌어 BOQ 전체 구조를 재배열하세요.
각 BOQ 항목은 단가를 구성 요소로 분해하는 연결된 자원을 가질 수 있습니다:
자원을 추가하려면: 항목 행을 펼치고 "자원 추가"를 클릭한 뒤 카탈로그를 검색하고 수량 계수를 설정합니다(예: 콘크리트 m3당 철근 120kg). 항목 단가는 자원의 합계로부터 자동으로 갱신됩니다.
마크업은 순 합계(모든 항목의 합계) 이후에 적용됩니다. 일반적인 마크업에는 다음이 포함됩니다:
도구 모음에서 마크업 추가를 클릭하세요. 지역 기본값을 설정하거나 프로젝트별로 맞춤 설정할 수 있습니다. 마크업은 백분율 기반 또는 고정 금액일 수 있으며, 순서대로 복리 적용됩니다(먼저 일반관리비, 그다음 일반관리비 포함 금액에 대한 이윤, 마지막으로 총액에 대한 VAT).
Ctrl+Shift+V를 누르거나 도구 모음의 방패 아이콘을 클릭하여 검증을 실행하세요. 시스템은 선택한 규칙 세트에 따라 BOQ를 확인하고 결과를 인라인으로 표시합니다:
BOQ 편집기는 여러 소스에서 가져오기를 지원합니다:
| 단축키 | 동작 |
|---|---|
Ctrl+K | 명령 팔레트 |
Ctrl+N | 새 프로젝트 |
Ctrl+Shift+V | 검증 실행 |
Ctrl+Z / Y | 실행 취소 / 다시 실행 |
세계 최대의 오픈소스 건설 원가 데이터베이스를 이용하세요: 40개 이상 지역의 원가 항목 12만 개 이상. 글로벌 CWICR 데이터베이스는 최대 9개 언어 설명이 있는 항목 55,000개 이상을 제공하며, 공종별(토공, 콘크리트, 조적, 철골, 지붕, 외장, 공조, 전기, 배관, 마감, 조경)로 정리되어 있습니다. 각 항목에는 단위, 지정 지역의 기준 단가, 분류 코드(DIN 276, NRM, MasterFormat)가 있고, 가능한 경우 자재, 노무, 장비 내역이 포함됩니다.


| 지역 | 통화 | 표준 | 항목 |
|---|---|---|---|
| 독일 (DACH) | EUR | DIN 276 | 55,719 |
| 영국 | GBP | NRM 1/2 | 55,719 |
| 미국 | USD | MasterFormat | 55,719 |
| 프랑스 | EUR | DPGF | 55,719 |
| 러시아 | RUB | GESN | 55,719 |
| UAE | AED | 로컬 | 55,719 |
| 중국 | CNY | GB/T | 55,719 |
| 인도 | INR | CPWD | 55,719 |
비용 데이터베이스는 두 가지 주요 워크플로를 위해 설계되었습니다:
각 비용 항목에는 다음이 포함됩니다:
의미 기반 검색을 활성화하면 정확한 키워드 일치뿐 아니라 의미로 비용 항목을 찾을 수 있습니다. "콘크리트 벽체"를 검색하면 정확한 단어가 등장하지 않더라도 "거푸집 포함 철근 칸막이벽 C30/37, 24cm" 같은 항목도 찾아냅니다. 이는 설명을 수치 벡터로 변환하고 다차원 공간에서 가장 가까운 일치 항목을 찾는 sentence-transformer 임베딩으로 구동됩니다. 두 가지 벡터 데이터베이스 백엔드가 지원됩니다: LanceDB(임베디드, SQLite처럼 인프로세스로 실행, 384차원 임베딩)와 Qdrant(GitHub에서 다운로드 가능한 사전 구축 3072차원 스냅샷을 갖춘 프로덕션 서버).
프로젝트 도면과 모델에서 직접 수량을 추출하세요 - 수작업 집계가 필요 없습니다. RVT, IFC, DWG 또는 DGN 파일을 업로드하면 시스템이 모든 건축 요소를 체적, 면적, 길이와 함께 추출합니다. PDF 도면의 경우 브라우저에서 직접 열고 보정된 측정 도구로 거리, 면적, 요소 개수를 적산합니다. 추출된 모든 수량은 단가 책정을 위해 BOQ로 전송할 수 있습니다.
🎬 YouTube에서 BIM → BOQ 대량 연결, DWG 레이어 물량 산출, PDF 측정 챕터 보기.





| 포맷 | 소프트웨어 | 변환기 |
|---|---|---|
| .rvt / .rfa | BIM | DDC RvtExporter |
| .ifc | IFC (모든 BIM) | DDC IfcExporter |
| .dwg / .dxf | CAD | DDC DwgExporter |
| .dgn | CAD | DDC DgnExporter |
모든 LLM 공급자를 연결하여 일반 텍스트 설명, 건물 사진, 스캔된 PDF, Excel 스프레드시트 또는 CAD/BIM 모델로부터 건설 비용 견적을 생성하세요. AI 시스템은 수량과 시장 단가를 갖춘 완전한 BOQ 항목을 만듭니다. 생성 후, 각 항목을 CWICR 비용 데이터베이스와 매칭하여 AI가 추정한 단가를 검증된 지역 시장 가격으로 대체할 수 있습니다. AI 기능은 전적으로 선택 사항입니다 - 플랫폼은 AI 없이도 완전하게 작동합니다.
🎬 YouTube에서 "사진으로 AI 견적" 보기 - 건설 현장 사진을 업로드하면 몇 초 만에 범위가 지정된 BOQ를 받습니다.


| 공급자 | 모델 | 기능 |
|---|---|---|
| Anthropic | Claude Sonnet / Opus | 텍스트, 비전, 문서 |
| OpenAI | GPT-4o | 텍스트, 비전, 문서 |
| Gemini Pro | 텍스트, 비전 | |
| Mistral / Groq / DeepSeek | 다양 | 텍스트 |
프로젝트를 일반 텍스트로 설명하면 AI가 수량과 시장 단가를 갖춘 15-30개의 BOQ 항목을 생성합니다.
AI 견적을 CWICR 데이터베이스와 매칭하여 추정 단가를 실제 시장 가격으로 대체합니다.
비용 데이터베이스를 맥락으로 활용해 비용, 자재, 가격에 대해 AI와 대화하세요.

통합된 일정 관리 및 재무 모델링 도구로 건설 프로젝트 일정을 계획하고 시간에 따른 비용을 추적하세요.
일정 관리 모듈은 건설 일정 관리를 위한 전문 간트 차트를 제공합니다. 작업을 생성하고 기간을 설정하고 종속성을 정의하면, 시스템이 지연되어서는 안 되는 작업을 보여주는 주공정선(critical path)을 자동으로 계산합니다.
비용 모델은 BOQ 데이터를 프로젝트 일정에 연결하여 획득가치관리 지표와 함께 시간 단계별 건설 비용 뷰를 제공합니다.
입찰 패키지 생성부터 제안서 비교, 하도급업체 계약 체결까지 전체 조달 워크플로를 관리하세요.
조달로 이동하여 프로젝트를 선택하고 "패키지 생성"을 클릭합니다. 패키지 이름, 범위 설명, 제출 마감일을 지정하고 포함할 BOQ 항목을 선택합니다. 프로젝트당 여러 패키지를 만들 수 있습니다(예: 구조 공사, MEP, 마감).
회사명, 연락처 정보, 각 BOQ 항목에 대한 견적 가격과 함께 하도급업체의 입찰을 추가합니다. 시스템은 나란히 비교할 수 있도록 패키지당 여러 입찰을 지원합니다.
가격 미러는 항목별 단가와 합계를 갖춘 비교 표에 모든 입찰을 표시합니다. 시각적 표시기가 최저가와 최고가 입찰을 강조합니다. 이해관계자 검토를 위해 비교 결과를 CSV로 내보냅니다.
낙찰 버튼으로 낙찰 입찰을 표시하고 사유 메모를 추가합니다. 패키지 상태는 초안, 발행, 수집 중, 평가 중, 낙찰, 종료 순으로 추적됩니다.
확률-영향 매트릭스를 사용해 프로젝트 리스크를 식별, 평가, 관리하세요. 리스크 노출도를 정량화하고 식별된 각 리스크에 대한 완화 전략을 계획합니다.
매트릭스는 색상으로 구분된 확률(0.1-0.9) 대 영향(낮음/중간/높음/심각) 격자에 모든 리스크를 표시합니다. 각 리스크는 계산된 노출 점수(확률에 영향 비용을 곱한 값)를 보여줍니다.
각 리스크에 대해 고유 코드(R-001), 제목, 범주(기술, 재무, 일정, 규제, 환경, 안전), 완화 전략, 비상 계획, 리스크 담당자, 비용 영향, 일수 단위 일정 영향을 기록합니다. 상태는 식별됨, 평가됨, 완화 중, 종료, 발생 순으로 추적합니다.
범위 변경과 그것이 프로젝트 비용 및 일정에 미치는 영향을 추적하세요. 변경 지시서는 초기 견적 이후 이루어진 모든 수정 사항에 대한 감사 추적을 제공합니다.
코드(CO-001), 제목, 사유 범주(고객 요청, 설계 변경, 예측하지 못한 조건, 규제)와 함께 변경 지시서를 생성합니다. 원래 및 신규 수량/단가와 함께 영향받는 BOQ 항목을 지정하는 라인 항목을 추가합니다. 시스템이 비용 차이를 자동으로 계산합니다. 상태는 초안, 제출됨, 검토 중, 승인/반려 순으로 진행됩니다.

BOQ에 대한 자동 품질 점검을 실행하여 오류가 문제가 되기 전에 잡아내세요. 검증 엔진은 견적 데이터에 대해 42개의 구성 가능한 규칙을 적용합니다.
각 검증은 색상으로 구분된 발견 항목과 함께 품질 점수(0-100%)를 생성합니다: 오류(빨강, 반드시 수정), 경고(노랑, 검토 필요), 정보(파랑, 제안). 발견 항목을 클릭하면 영향받는 BOQ 항목으로 바로 이동합니다.



이해관계자, 고객, 규제 준수를 위해 프로젝트 데이터로부터 전문 문서를 생성하세요.

모든 프로젝트 문서를 중앙화하세요. 자동 분류 및 검색과 함께 도면, 계약서, 사양서, 사진을 업로드합니다.


프로젝트 간 예산 성과를 확인하세요. 대시보드는 모든 프로젝트의 재무 데이터를 집계하여 추세, 차이, 위험에 처한 예산을 식별합니다.
모든 프로젝트 이해관계자를 중앙화된 디렉터리에서 관리하세요. 전체 연락처 정보, 회사 연결, 역할 기반 분류와 함께 고객, 하도급업체, 공급업체, 건축가, 컨설턴트를 추적합니다. 완전한 추적성을 위해 연락처를 프로젝트, 입찰, 발주서, 서신에 연결합니다.
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
| GET | /api/v1/contacts/ | 모든 연락처 목록 조회 |
| POST | /api/v1/contacts/ | 연락처 생성 |
| GET | /api/v1/contacts/{id} | 연락처 상세 조회 |
| PUT | /api/v1/contacts/{id} | 연락처 업데이트 |
| POST | /api/v1/contacts/import | 연락처 일괄 가져오기 |
5가지 유형의 작업 분류 체계와 시각적 칸반 보드로 프로젝트 업무를 정리하세요. 작업은 팀원에게 할당하고, 특정 BOQ 항목, 문서 또는 RFI에 연결하고, 사용자 지정 가능한 워크플로 단계로 추적할 수 있습니다. 각 작업 유형에는 고유한 색상 구분과 기본 필드가 있습니다.

| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
| GET | /api/v1/tasks/ | 작업 목록 조회(프로젝트, 담당자, 상태별 필터링 가능) |
| POST | /api/v1/tasks/ | 작업 생성 |
| PATCH | /api/v1/tasks/{id} | 작업 업데이트(상태, 담당자, 우선순위) |
| GET | /api/v1/tasks/board/{project_id} | 칸반 보드 데이터 가져오기 |
공식 정보 요청을 ball-in-court 배정과 함께 프로젝트 당사자 간에 추적합니다. RFI는 초안에서 종료까지 구조화된 라이프사이클을 따라 흐르며, 모든 질문이 문서화된 답변을 받도록 보장합니다. Ball-in-court 추적은 언제든 현재 누가 조치 책임을 지고 있는지 보여줍니다.
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
| GET | /api/v1/rfis/ | RFI 목록 조회 |
| POST | /api/v1/rfis/ | RFI 생성 |
| POST | /api/v1/rfis/{id}/respond | 응답 제출 |
| PATCH | /api/v1/rfis/{id}/status | 상태 / ball-in-court 업데이트 |
송장, 예산, 지급, 획득가치관리(EVM)를 아우르는 전체 프로젝트 재무 관리. 계획 대비 실제 비용을 추적하고, 기성 청구서를 생성하며, 실시간 차이 분석으로 예산 건전성을 모니터링합니다. BOQ 데이터와 통합되어 비용 기준선을 자동으로 생성합니다.
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
| GET | /api/v1/finance/invoices/ | 송장 목록 조회 |
| POST | /api/v1/finance/invoices/ | 송장 생성 |
| GET | /api/v1/finance/budgets/ | 예산 목록 조회 |
| POST | /api/v1/finance/budgets/import | Excel에서 예산 가져오기 |
| GET | /api/v1/finance/evm/{project_id} | EVM 지표 가져오기 |
| GET | /api/v1/finance/payments/ | 지급 목록 조회 |
건설 자재 및 서비스에 대한 발주서와 입고를 관리합니다. BOQ 항목에 연결된 발주서를 생성하고, 납품 상태를 추적하며, 수량 확인과 함께 입고를 기록합니다. 공급업체 관리를 위해 연락처 모듈과 통합됩니다.
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
| GET | /api/v1/procurement/orders/ | 발주서 목록 조회 |
| POST | /api/v1/procurement/orders/ | 발주서 생성 |
| POST | /api/v1/procurement/orders/{id}/receive | 입고 기록 |
| GET | /api/v1/procurement/receipts/ | 입고 목록 조회 |
위험 점수 시스템과 함께 안전 사고, 아차사고, 행동 관찰을 기록합니다. 프로젝트 전반의 안전 성과 지표를 추적하고, 추세를 파악하며, 산업안전보건 규정 준수를 보장합니다.
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
| GET | /api/v1/safety/incidents/ | 사고 목록 조회 |
| POST | /api/v1/safety/incidents/ | 사고 보고 |
| GET | /api/v1/safety/observations/ | 관찰 목록 조회 |
| POST | /api/v1/safety/observations/ | 관찰 기록 |
| GET | /api/v1/safety/dashboard/{project_id} | 안전 KPI 가져오기 |
구조화된 안건과 추적되는 조치 항목으로 회의록을 관리합니다. 반복 회의 시리즈(예: 주간 현장 회의)를 생성하고, 참석자를 기록하며, 논의 사항을 정리하고, 작업 모듈과 통합되는 조치 항목을 자동으로 생성합니다.
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
| GET | /api/v1/meetings/ | 회의 목록 조회 |
| POST | /api/v1/meetings/ | 회의 생성 |
| GET | /api/v1/meetings/{id}/minutes | 회의록 가져오기 |
| POST | /api/v1/meetings/{id}/actions | 조치 항목 추가 |
구성 가능한 체크리스트를 사용하여 품질 검측을 수행합니다. 공종이나 활동 유형별로 검측 템플릿을 정의하고, 현장에서 작성하며, 사진을 첨부하고, 하자 해결을 추적합니다. 검측 결과는 프로젝트 품질 점수와 NCR 워크플로에 반영됩니다.
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
| GET | /api/v1/inspections/ | 검측 목록 조회 |
| POST | /api/v1/inspections/ | 템플릿에서 검측 생성 |
| GET | /api/v1/inspections/templates/ | 체크리스트 템플릿 목록 조회 |
| PATCH | /api/v1/inspections/{id}/items | 체크리스트 항목 결과 업데이트 |
작업이 사양에 부합하지 않을 때 품질 부적합을 문서화하고 추적합니다. NCR은 식별에서 근본 원인 분석을 거쳐 시정 조치 확인에 이르는 공식 라이프사이클을 따르며, 모든 품질 편차가 적절히 해결되고 문서화되도록 보장합니다.
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
| GET | /api/v1/ncr/ | NCR 목록 조회 |
| POST | /api/v1/ncr/ | NCR 생성 |
| PATCH | /api/v1/ncr/{id}/status | NCR 상태 업데이트 |
| POST | /api/v1/ncr/{id}/actions | 시정 조치 추가 |
건설 자재, 시공 상세도, 제품 데이터에 대한 제출물 검토 프로세스를 관리합니다. 제출물이 최종 승인 전 여러 검토자를 거치는 다단계 검토 워크플로를 추적합니다. 모든 검토 주기와 개정 이력에 대한 완전한 감사 추적을 유지합니다.
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
| GET | /api/v1/submittals/ | 제출물 목록 조회 |
| POST | /api/v1/submittals/ | 제출물 생성 |
| POST | /api/v1/submittals/{id}/review | 검토 결정 제출 |
| POST | /api/v1/submittals/{id}/revise | 새 개정본 업로드 |
모든 프로젝트 교신에 대한 공식 통신 대장을 유지합니다. 프로젝트 당사자 간 서신, 이메일, 통지, 지시를 고유 참조 번호, 응답 추적, 전문 검색과 함께 추적합니다. 계약상 통신이 적절히 문서화되고 추적 가능하도록 보장합니다.
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
| GET | /api/v1/correspondence/ | 교신 목록 조회 |
| POST | /api/v1/correspondence/ | 교신 항목 생성 |
| GET | /api/v1/correspondence/{id} | 첨부 파일 포함 상세 정보 가져오기 |
| GET | /api/v1/correspondence/{id}/thread | 연결된 교신 체인 가져오기 |
제어된 상태 전환으로 프로젝트 정보를 관리하는 ISO 19650 준수 공통 데이터 환경. 문서는 승인 게이트를 거쳐 작업 중(WIP), 공유됨, 발행됨, 보관됨 상태를 통과합니다. 정보 관리가 협업 인도를 위한 BIM 표준을 따르도록 보장합니다.
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
| GET | /api/v1/cde/documents/ | CDE 문서 목록 조회(상태, 적합성으로 필터링 가능) |
| POST | /api/v1/cde/documents/ | CDE에 문서 업로드 |
| PATCH | /api/v1/cde/documents/{id}/status | 문서 상태 전환 |
| GET | /api/v1/cde/documents/{id}/history | 개정 이력 가져오기 |
추적되는 납품 및 확인과 함께 외부 당사자에게 문서를 공식 배포합니다. 여러 문서를 포함하는 발송 패키지를 생성하고, 수신자를 지정하며, 각 수신자가 문서를 수신하고 확인했는지 추적합니다. 정보 교환에 대한 계약상 기록을 제공합니다.
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
| GET | /api/v1/transmittals/ | 발송 대장 목록 조회 |
| POST | /api/v1/transmittals/ | 발송 생성 |
| POST | /api/v1/transmittals/{id}/send | 수신자에게 발송 전송 |
| PATCH | /api/v1/transmittals/{id}/acknowledge | 수신자 확인 기록 |
요소 수준 데이터 액세스와 직접적인 BOQ 연계를 갖춘 BIM 모델 관리 중앙 허브. IFC/RVT 모델을 업로드하고, 속성 및 수량과 함께 건물 요소를 탐색하며, 5D 비용 통합을 위해 요소를 BOQ 항목에 연결합니다. 설계 데이터와 비용 산출 간의 가교를 제공합니다.
🎬 YouTube의 BIM 일괄 연결 데모 - 100개의 BIM 벽 → 면적, 체적 및 길이가 집계된 하나의 BOQ 라인.
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
| GET | /api/v1/bim/models/ | BIM 모델 목록 조회 |
| POST | /api/v1/bim/models/ | BIM 모델 업로드 |
| GET | /api/v1/bim/models/{id}/elements | 모델 요소 목록 조회 |
| POST | /api/v1/bim/elements/{id}/link-boq | 요소를 BOQ 항목에 연결 |
KPI 대시보드, 사용자 정의 가능한 보고서 템플릿, 예약된 보고서 생성을 갖춘 종합 리포팅 엔진. 포트폴리오 수준의 인사이트를 위해 프로젝트 전반의 데이터를 집계합니다. 모든 모듈(BOQ, 재무, 일정, 안전, 품질)의 데이터를 결합한 맞춤형 보고서 템플릿을 생성합니다.
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
| GET | /api/v1/reporting/kpi/{project_id} | 프로젝트 KPI 가져오기 |
| GET | /api/v1/reporting/templates/ | 보고서 템플릿 목록 조회 |
| POST | /api/v1/reporting/generate | 템플릿에서 보고서 생성 |
| GET | /api/v1/reporting/portfolio/ | 포트폴리오 대시보드 데이터 가져오기 |
사용자에게 관련 이벤트를 알려주는 인앱 알림 시스템. 알림은 작업 배정, RFI 응답, 제출물 검토, 승인 요청, 기한 초과 항목 등 모든 모듈의 작업에 의해 트리거됩니다. 사용자는 카테고리별로 알림 환경설정을 제어합니다.
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
| GET | /api/v1/notifications/ | 알림 목록 조회(미읽음 우선) |
| PATCH | /api/v1/notifications/{id}/read | 알림을 읽음으로 표시 |
| POST | /api/v1/notifications/read-all | 모두 읽음으로 표시 |
| GET | /api/v1/notifications/preferences | 알림 환경설정 가져오기 |
건설 일정 시각화를 위한 순수 SVG 기반 간트 차트. 외부 라이브러리 없이 타임라인, 종속성, 마일스톤, 주공정선을 브라우저에서 직접 렌더링합니다. 일 단위에서 연 단위 뷰까지 줌을 지원하며, 리포팅을 위해 PDF/PNG로 내보냅니다.
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
| GET | /api/v1/schedule/gantt/{project_id} | 간트 차트 데이터 가져오기(활동, 종속성) |
| PATCH | /api/v1/schedule/activities/{id} | 활동 날짜/진척도 업데이트 |
| POST | /api/v1/schedule/dependencies/ | 종속성 생성 |
사용자별 및 프로젝트별로 시간대, 통화, 숫자 형식, 날짜 형식 환경설정을 구성합니다. 지역 설정은 시스템 기본값에서 프로젝트 수준 재정의를 거쳐 사용자 수준 환경설정으로 단계적으로 적용되어, 각 팀원이 자신의 로케일에 맞게 형식화된 데이터를 보도록 보장합니다.
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
| GET | /api/v1/settings/regional/ | 현재 지역 설정 가져오기 |
| PUT | /api/v1/settings/regional/ | 지역 설정 업데이트 |
| GET | /api/v1/settings/regional/timezones | 사용 가능한 시간대 목록 조회 |
| GET | /api/v1/settings/regional/currencies | 지원되는 통화 목록 조회 |
플랫폼 모듈을 활성화하거나 비활성화하여 OpenConstructionERP를 워크플로에 맞게 맞춤화합니다. 각 모듈은 다른 모듈에 영향을 주지 않고 독립적으로 전환할 수 있습니다. 비활성화된 모듈은 UI에서 숨겨지고, API 엔드포인트는 404를 반환하며, 데이터베이스 테이블은 재활성화를 위해 그대로 유지됩니다.
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
| GET | /api/v1/modules/ | 상태와 함께 모든 모듈 목록 조회 |
| PATCH | /api/v1/modules/{name}/toggle | 모듈 활성화 또는 비활성화 |
| GET | /api/v1/modules/{name}/dependencies | 모듈 종속성 확인 |
특정 시장을 위한 분류 표준, 세금 규칙, 비용 데이터베이스 기본값, 보고서 템플릿, 규제 준수 규칙을 설정하는 사전 구성된 지역 패키지. 지역 팩을 설치하면 해당 국가나 지역에 맞게 플랫폼을 즉시 구성할 수 있습니다.
| 팩 | 지역 | 표준 | 통화 |
|---|---|---|---|
| US | 미국 | MasterFormat, UniFormat, CSI | USD |
| DACH | 독일, 오스트리아, 스위스 | DIN 276, GAEB, VOB, HOAI | EUR/CHF |
| UK | 영국 | NRM 1/2, RICS, JCT | GBP |
| Russia | 러시아, CIS | GESN, FER, TER, SNIP | RUB |
| 중동 | 아랍에미리트, 사우디아라비아, 카타르 | RICS, CESMM, FIDIC | AED/SAR/QAR |
| Asia-Pacific | 중국, 일본, 호주 | GB/T, AS 4000, JASS | CNY/AUD/JPY |
| India | 인도 | CPWD, IS standards, DSR | INR |
| LatAm | 브라질, 멕시코, 콜롬비아 | SINAPI, CMIC, local norms | BRL/MXN/COP |
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
| GET | /api/v1/regional-packs/ | 사용 가능한 지역 팩 목록 조회 |
| POST | /api/v1/regional-packs/{name}/install | 지역 팩 설치 |
| GET | /api/v1/regional-packs/{name}/details | 팩 콘텐츠 및 구성 가져오기 |
모든 모듈에 걸친 종합적인 데이터 가져오기 및 내보내기 기능. 지능형 열 매핑으로 Excel 및 CSV 파일에서 연락처, 예산, BOQ, 비용 데이터베이스를 가져옵니다. 사용자 정의 가능한 템플릿으로 프로젝트 데이터를 Excel, PDF, CSV로 내보냅니다. 모든 내보내기는 서식을 보존하고 메타데이터 헤더를 포함합니다.
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
| POST | /api/v1/import/contacts | 파일에서 연락처 가져오기 |
| POST | /api/v1/import/budget | Excel에서 예산 가져오기 |
| POST | /api/v1/export/boq/{id} | BOQ 내보내기(형식: excel, pdf, gaeb, csv) |
| POST | /api/v1/export/report | 보고서 생성 및 내보내기 |



| 변수 | 기본값 | 설명 |
|---|---|---|
DATABASE_URL | (미설정 = 내장 PostgreSQL) | 데이터베이스(기본값은 내장 PostgreSQL, 외부 PostgreSQL을 쓰려면 설정). 내장 PostgreSQL을 쓰려면 비워 두고, 외부 데이터베이스를 쓰려면 값을 지정하세요. 예: postgresql+asyncpg://oe:oe@localhost:5432/openestimate |
JWT_SECRET | dev-key | JWT 시크릿(운영 환경에서 변경하세요!) |
SEED_DEMO | true | 데모 계정 생성 |
VECTOR_BACKEND | lancedb | 벡터 검색 백엔드 |
OpenConstructionERP는 프런트엔드를 구동하며 통합, 자동화 및 사용자 정의 워크플로에 사용할 수 있는 포괄적인 REST API를 제공합니다. UI에서 사용 가능한 모든 작업 - 프로젝트 생성, BOQ 편집, AI 견적 실행, 비용 검색 - 이 API 엔드포인트로 제공됩니다. 백엔드를 실행할 때 직접 시도 버튼이 있는 대화형 Swagger 문서를 /api/docs에서 사용할 수 있습니다.
| 메서드 | 엔드포인트 | 설명 |
|---|---|---|
| POST | /api/v1/users/auth/login | 로그인 |
| GET | /api/v1/projects/ | 프로젝트 목록 조회 |
| GET | /api/v1/boq/boqs/?project_id=... | BOQ 목록 조회 |
| GET | /api/v1/costs/?q=concrete | 비용 검색 |
| POST | /api/v1/ai/quick-estimate | AI 견적 |
| POST | /api/v1/takeoff/cad-extract | CAD 추출 |
| GET | /api/health | 헬스 체크 |
| 모듈 | 접두사 | 설명 |
|---|---|---|
| Contacts | /api/v1/contacts/ | 연락처 디렉터리 CRUD, 가져오기 |
| Tasks | /api/v1/tasks/ | 작업 관리, 칸반 보드 |
| RFI | /api/v1/rfis/ | 정보 요청 |
| Finance | /api/v1/finance/ | 송장, 예산, 지급, EVM |
| Procurement | /api/v1/procurement/ | 발주서, 입고 |
| Safety | /api/v1/safety/ | 사고, 관찰, 위험 점수 |
| Meetings | /api/v1/meetings/ | 회의록, 안건, 조치 항목 |
| Inspections | /api/v1/inspections/ | 품질 검측, 체크리스트 |
| NCR | /api/v1/ncr/ | 부적합 보고서 |
| Submittals | /api/v1/submittals/ | 다단계 제출물 검토 |
| Correspondence | /api/v1/correspondence/ | 통신 대장 |
| CDE | /api/v1/cde/ | ISO 19650 문서 환경 |
| Transmittals | /api/v1/transmittals/ | 문서 배포 |
| BIM Hub | /api/v1/bim/ | BIM 모델, 요소, BOQ 연계 |
| Reporting | /api/v1/reporting/ | KPI 대시보드, 보고서 템플릿 |
| Notifications | /api/v1/notifications/ | 인앱 알림 시스템 |
| Comments | /api/v1/comments/ | 모든 엔터티에 대한 스레드형 댓글 |
| Gantt | /api/v1/schedule/gantt/ | SVG 일정 시각화 |
| Regional | /api/v1/settings/regional/ | 시간대, 통화, 형식 환경설정 |
| Modules | /api/v1/modules/ | 모듈 활성화/비활성화 |
| Regional Packs | /api/v1/regional-packs/ | 지역 구성 설치 |
| Import/Export | /api/v1/import/ / /api/v1/export/ | 대량 데이터 가져오기 및 내보내기 |
매개변수와 설명이 포함된 자세한 엔드포인트 문서는 위의 각 모듈 섹션을 참조하세요.
프로젝트를 9개의 가중 도메인에 걸쳐 점수화하고 0에서 100까지의 완성도 점수(A부터 F까지의 등급)를 생성하는 AI 기반 프로젝트 분석.
API: GET /api/v1/project_intelligence/score/?project_id=X - 전체 점수, 도메인 점수, 치명적 격차 및 성과를 반환합니다.
팀원, 역할, 모듈별 액세스 제어를 관리합니다.
관리자는 /users 페이지를 통해 사용자별 모듈 가시성 및 접근 수준(없음, 보기, 편집, 전체)을 구성할 수 있습니다. 사용자 정의 역할 이름을 할당할 수 있습니다(예: "현장 엔지니어", "비용 관리자").
리포지토리에 별표를 추가하여 다른 사람들이 프로젝트를 발견하도록 도와주세요.
GitHub에서 이슈를 등록하세요.
질문을 위해 Telegram 커뮤니티에 참여하세요.
배포 및 교육을 위해 문의하세요.
라이선스: AGPL-3.0. 상업용 라이선스: info@datadrivenconstruction.io
댓글
BOQ 항목, 작업, RFI, 제출물, 문서, 검측 등 플랫폼의 모든 엔터티에 첨부할 수 있는 스레드형 댓글 시스템. 팀원에게 알리는 @멘션, 파일 첨부, 조치 중심 논의를 위한 해결 추적을 지원합니다.
주요 기능
API 엔드포인트
/api/v1/comments/?entity_type=task&entity_id=.../api/v1/comments//api/v1/comments/{id}/reply/api/v1/comments/{id}/resolve