Всичко необходимо за инсталиране, конфигуриране и използване на OpenConstructionERP за професионална оценка на строителни разходи.
Въвеждане → Нов проект → BoQ → Свързване с BIM → DWG → PDF takeoff → Пълна оценка → Задачи → Data Explorer → AI оценка → Портфолио.
Субтитри, глави и възпроизвеждане на 1.5х са вградени в плеъра по-горе. Предпочитате да гледате директно в YouTube? ▶ Отворете в YouTube · абонирайте се за канала за прегледи на нови версии.
Всеки блок по-долу е кратък GIF, изрязан от пълния преглед по-горе - в същия ред като видеото, така че можете да преминете към работния процес, който е най-важен за вас. Искате един непрекъснат поток? ▶ Гледайте 12-минутния преглед в YouTube.
OpenConstructionERP е цялостна платформа за оценка на строителни разходи и управление на проекти, която работи изцяло на вашата машина. Тя заменя скъпите търговски пакети за оценяване с отворена, самохоствана алтернатива. Платформата покрива целия жизнен цикъл на строителството - от първоначалните проучвания за осъществимост и определянето на количества до подробната подготовка на BOQ, тръжните процедури, сравнението на оферти, изпълнението на проекта, управлението на качеството и финансовия контрол. Всичките ви данни остават на вашия сървър. Без зависимост от облак, без абонаменти, без такси за всяко работно място.
Основно в v18.5.0: над 190 модула, покриващи целия жизнен цикъл на строителството: указател с контакти, задачи с Kanban, проследяване на RFI, финанси (фактури, бюджети, EVM), доставки, безопасност, срещи, проверки на качеството, NCR, submittals, кореспонденция, CDE (ISO 19650), transmittals, BIM Hub, регистър на активите с COBie експорт, отчети & KPI табло, markups (PDF↔DWG↔hub), pivot визуализации & избор на колони за диаграми, разширяема имейл услуга, контакти за няколко наематели, планирани отчети, Regional Packs и пълен импорт/експорт.


Йерархични количествени сметки с раздели, позиции, ресурси, сглобки и автоматични надбавки.
Ценови бази от 9 национални източника, издадени в 48 пазарни издания с местна валута и език, с 36 регионални бази данни, готови за импорт.
Генерирайте BOQ от текст, снимки, PDF, Excel или CAD/BIM модели с помощта на всеки LLM доставчик.
Извличане на количества от RVT, IFC, DWG, DGN чрез DDC конвертори.
Планиране с диаграма на Гант с CPM, управление на спечелената стойност, 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, без отделен сървър на база данни, без настройка), така че всичко работи веднага. Изисква Python 3.12+ за пътищата с pip и с една команда.
pip install --upgrade openconstructionerp
openconstructionerpИнсталира бекенда + предварително изградения React фронтенд в едно wheel. Отваря се на http://localhost:8080 с пълния интерфейс. Вграден PostgreSQL, без конфигурация. Ако нещо изглежда нередно, изпълнете openconstructionerp doctor.
На Ubuntu 23.04+ (включително Ubuntu 26) и Debian 12+ pip install директно към системния Python се проваля с 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
openconstructionerpАко pip премине към компилиране от изходен код, инсталирайте заглавните файлове: 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 | iexИзбира Docker, ако е инсталиран, иначе uv, иначе pip. Работи на http://localhost:8080.
git clone https://github.com/datadrivenconstruction/OpenConstructionERP.git
cd OpenConstructionERP
make quickstartОтваря се на http://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! | Мениджър |
5 демо проекта (Берлин, Лондон, Ню Йорк, Париж, Дубай) с пълни BOQ, графици и разходни модели.
Редакторът на количествената сметка е мястото, където прекарвате по-голямата част от времето си. Той предоставя професионален интерфейс от типа на електронна таблица, задвижван от AG Grid, с вградени специфични за строителството функции - йерархични раздели, свързване на ресурси, рецепти за сглобки и автоматични изчисления на надбавки. Всяка промяна се проследява с пълна поддръжка на отмяна/повторение. 42 правила за валидация се изпълняват автоматично на заден план, улавяйки грешки като липсващи количества, нулеви цени, дублирани позиции и проблеми със съответствието на класификацията, преди те да се превърнат в проблеми.
🎬 Вижте BOQ редактора в действие в YouTube - редактиране с акцент върху клавиатурата, 120K+ остойностени позиции, оценка за качество в реално време.



Разделите организират вашата BOQ в логически групи (напр. "300 Конструкция", "400 ОВК"). За да създадете раздел:
Можете да свивате/разгъвате раздели, за да се съсредоточите върху конкретни строителни дейности. Плъзгайте раздели, за да пренаредите цялата структура на BOQ.
Всяка BOQ позиция може да има свързани ресурси, които разбиват единичната цена на компоненти:
За да добавите ресурси: разгънете ред с позиция, кликнете "Добави ресурс", потърсете в каталога, задайте количествен коефициент (напр. 120 kg армировка на m3 бетон). Единичната цена на позицията се обновява автоматично от сумата на нейните ресурси.
Надбавките се прилагат след нетната сума (сумата на всички позиции). Често срещаните надбавки включват:
Кликнете Добавяне на надбавка в лентата с инструменти. Можете да зададете регионални стойности по подразбиране или да ги персонализирате за всеки проект. Надбавките могат да бъдат процентни или фиксирани суми и се натрупват по ред (първо режийни, после печалба върху сумата с включени режийни, после ДДС върху общата сума).
Натиснете Ctrl+Shift+V или кликнете върху иконата на щит в лентата с инструменти, за да стартирате валидация. Системата проверява вашия BOQ спрямо избраните набори от правила и показва резултатите на място:
BOQ редакторът поддържа импортиране от множество източници:
| Комбинация | Действие |
|---|---|
Ctrl+K | Команден панел |
Ctrl+N | Нов проект |
Ctrl+Shift+V | Стартиране на валидация |
Ctrl+Z / Y | Отмяна / Повторение |
Получете достъп до най-голямата база с разходи за строителство с отворен код в света: над 120 000 ценови позиции в над 40 региона. Глобалната база CWICR добавя над 55 000 позиции с описания на до 9 езика, подредени по специалности (земни работи, бетон, зидария, стомана, покриви, фасади, ОВК, електро, ВиК, довършителни работи, озеленяване). Всяка позиция включва мерна единица, базова цена за посочения регион, кодове за класификация (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 |
| ОАЕ | AED | Локален | 55,719 |
| Китай | CNY | GB/T | 55,719 |
| Индия | INR | CPWD | 55,719 |
Базата данни с разходи е проектирана за два основни работни процеса:
Всяка разходна позиция съдържа:
Активирайте семантичното търсене, за да намирате разходни позиции по смисъл, а не само по точно съвпадение на ключова дума. Когато търсите "бетонна стена", системата намира и позиции като "армирана преграда C30/37, 24cm с кофраж" - дори когато точните думи не се появяват. Това се задвижва от вграждания на sentence-transformer, които преобразуват описанията в числови вектори и намират най-близките съвпадения в многомерно пространство. Поддържат се два бекенда за векторна база данни: LanceDB (вграден, работи в процеса като SQLite, 384-измерни вграждания) и Qdrant (производствен сървър с предварително изградени 3072-измерни снимки, изтегляеми от GitHub).
Извличайте количества директно от вашите проектни чертежи и модели - без нужда от ръчно броене. Качете RVT, IFC, DWG или DGN файлове и системата извлича всеки строителен елемент с обеми, площи и дължини. За PDF чертежи ги отваряйте директно в браузъра и използвайте калибрирани инструменти за измерване, за да определите разстояния, площи и брой елементи. Всички извлечени количества могат да бъдат прехвърлени в BOQ за остойностяване.





| Формат | Софтуер | Конвертор |
|---|---|---|
| .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 - качете строителна снимка и получете остойностен BOQ за секунди.


| Доставчик | Модели | Функции |
|---|---|---|
| Anthropic | Claude Sonnet / Opus | Текст, зрение, документи |
| OpenAI | GPT-4o | Текст, зрение, документи |
| Gemini Pro | Текст, зрение | |
| Mistral / Groq / DeepSeek | Различни | Текст |
Опишете проекта си с обикновен текст и AI генерира 15-30 BOQ позиции с количества и пазарни ставки.
Съпоставете AI оценките с базата данни CWICR, за да замените предполагаемите ставки с реални пазарни цени.
Чатете с AI за разходи, материали и ценообразуване, използвайки вашата база данни с разходи като контекст.

Планирайте времевата линия на строителния си проект и проследявайте разходите във времето с интегрирани инструменти за планиране и финансово моделиране.
Модулът за планиране предоставя професионална диаграма на Гант за управление на вашата строителна времева линия. Създавайте дейности, задавайте продължителности, дефинирайте зависимости и системата автоматично изчислява критичния път, показвайки кои дейности не трябва да се забавят.
Разходният модел свързва вашите 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 типа задачи и визуална Kanban дъска. Задачите могат да бъдат възлагани на членове на екипа, свързвани с конкретни BOQ позиции, документи или RFI и проследявани през персонализируеми работни етапи. Всеки тип задача има собствено цветово кодиране и полета по подразбиране.

| Метод | Крайна точка | Описание |
|---|---|---|
| GET | /api/v1/tasks/ | Списък на задачите (филтрируем по проект, изпълнител, статус) |
| POST | /api/v1/tasks/ | Създаване на задача |
| PATCH | /api/v1/tasks/{id} | Обновяване на задача (статус, изпълнител, приоритет) |
| GET | /api/v1/tasks/board/{project_id} | Получаване на данни за Kanban дъската |
Проследявайте официалните искания за информация между страните по проекта с разпределение по принципа 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 | Записване на потвърждение от получател |
Централен център за управление на BIM модели с достъп до данни на ниво елемент и пряка връзка с BOQ. Качвайте IFC/RVT модели, преглеждайте строителните елементи с техните свойства и количества и свързвайте елементите с позиции от BOQ за 5D интеграция на разходите. Осигурява мост между проектните данни и оценката на разходите.
🎬 Демо за масово свързване в BIM в YouTube - 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 според вашия работен процес. Всеки модул може да се превключва независимо, без да засяга другите модули. Деактивираните модули са скрити от интерфейса, техните 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 | Русия, ОНД | 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 | Получаване на съдържанието и конфигурацията на пакет |
Цялостни възможности за импорт и експорт на данни във всички модули. Импортирайте контакти, бюджети, BOQ и бази с разходи от Excel и CSV файлове с интелигентно съпоставяне на колоните. Експортирайте данните на проекта в 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, който захранва фронтенда и може да се използва за интеграции, автоматизация и персонализирани работни процеси. Всяко действие, налично в потребителския интерфейс - създаване на проекти, редактиране на BOQ, изпълнение на AI оценки, търсене на разходи - е достъпно като API крайна точка. Интерактивна документация Swagger с бутони try-it-out е налична на /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/ | Управление на задачи, Kanban дъска |
| 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/ | Масов импорт и експорт на данни |
Вижте всеки раздел за модул по-горе за подробна документация на крайните точки с параметри и описания.
Анализ на проекта, задвижван от AI, който оценява вашия проект в 9 претеглени области и генерира оценка за пълнота от 0 до 100 (оценки от A до F).
API: GET /api/v1/project_intelligence/score/?project_id=X - връща обща оценка, оценки по области, критични пропуски и постижения.
Управлявайте членовете на екипа, ролите и контрола на достъпа за всеки модул.
Администраторите могат да конфигурират видимостта на модулите и нивата на достъп за всеки потребител (Без, Преглед, Редактиране, Пълен) чрез страницата /users. Могат да се задават персонализирани имена на роли (напр. "Строителен инженер", "Мениджър разходи").
Поставете звезда на хранилището, за да помогнете на другите да открият проекта.
Абонирайте се за прегледи на изданията и уроци. Започнете с 12-минутния продуктов преглед.
Отворете проблем в GitHub.
Присъединете се към общността в Telegram, за да задавате въпроси.
Свържете се с нас за внедряване и обучение.
Лиценз: AGPL-3.0. Търговско лицензиране: info@datadrivenconstruction.io
OpenConstructionERP
Създадено от екипа на DataDrivenConstruction
2026 Data Driven Construction. AGPL-3.0
Коментари
Система за коментари в нишки, която може да бъде прикачена към всеки обект в платформата - позиции от BOQ, задачи, RFI, подавани документи, документи, проверки и други. Поддържа @споменавания за уведомяване на членовете на екипа, прикачени файлове и проследяване на разрешаването за дискусии, ориентирани към действие.
Основни функции
API крайни точки
/api/v1/comments/?entity_type=task&entity_id=.../api/v1/comments//api/v1/comments/{id}/reply/api/v1/comments/{id}/resolve