Усе, що потрібно для встановлення, налаштування й використання OpenConstructionERP для професійного будівельного кошторисування.
Знайомство → Новий проєкт → BOQ → Прив'язка BIM → DWG → Обмір PDF → Повний кошторис → Завдання → Data Explorer → ШІ-кошторис → Портфель.
Субтитри, розділи й відтворення на 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), зведені візуалізації & вибір стовпців для графіків, підключувана поштова служба, мультиорендні контакти, звіти за розкладом, Regional Packs і повний імпорт/експорт.


Ієрархічні відомості обсягів робіт із розділами, позиціями, ресурсами, збірниками й автоматичними націнками.
Бази вартості з 9 національних джерел, опубліковані у 48 ринкових виданнях місцевою валютою й мовою, з 36 регіональними базами даних, готовими до імпорту.
Створюйте BOQ із тексту, фото, PDF, Excel або моделей CAD/BIM за допомогою будь-якого провайдера LLM.
Вилучайте обсяги з RVT, IFC, DWG, DGN через конвертери DDC.
Планування за діаграмою Ганта з CPM, управлінням освоєним обсягом, S-кривою, симуляцією Монте-Карло.
Фінанси, Безпека, Якість, CDE, BIM-хаб, Закупівлі, RFI, Завдання, Наради та інше. Вмикайте лише те, що потрібно.
Після встановлення OpenConstructionERP виконайте ці кроки, щоб налаштувати свій перший проєкт і створити перший кошторис. Весь процес займає близько 10 хвилин.
Відкрийте браузер і перейдіть на http://localhost:5173 (локальна розробка) або http://localhost:8080 (Docker). Ви побачите сторінку входу з панеллю «Демодоступ». Натисніть Admin, щоб миттєво увійти за демоакаунтом, або введіть власні дані, якщо ви зареєстрували новий акаунт.
При першому вході майстер знайомства проведе вас через початкове налаштування:
Натисніть Новий проєкт на Дашборді або перейдіть до Проєктів. Заповніть:
Після створення проєкту вас перенаправить на сторінку деталей проєкту, де можна почати додавати BOQ.
На сторінці проєкту натисніть Новий кошторис. Дайте йому назву (наприклад, «Кошторис v1») і за бажанням оберіть шаблон. Відкриється редактор BOQ із порожньою сіткою, готовою для вашої першої позиції.
У редакторі BOQ натисніть Додати позицію або натисніть Enter на порожньому рядку. Заповніть:
Колонка Разом розраховується автоматично (Кількість × Одинична розцінка). Ви також можете шукати в базі даних вартості, натиснувши іконку бази даних поруч із будь-якою позицією, щоб знайти й застосувати розцінку з понад 120 000 позицій каталогу вартості.
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 - редагування з фокусом на клавіатуру, понад 120 тис. позицій із цінами, жива оцінка якості.



Розділи організують ваш BOQ у логічні групи (наприклад, «300 Конструкції», «400 Опалення, вентиляція й кондиціювання»). Щоб створити розділ:
Ви можете згортати/розгортати розділи, щоб зосередитися на конкретних видах робіт. Перетягуйте розділи, щоб змінити порядок усієї структури BOQ.
Кожна позиція BOQ може мати прив'язані ресурси, що розкладають одиничну розцінку на складові:
Щоб додати ресурси: розгорніть рядок позиції, натисніть «Додати ресурс», знайдіть у каталозі, встановіть коефіцієнт кількості (наприклад, 120 кг арматури на м3 бетону). Одинична розцінка позиції оновлюється автоматично із суми її ресурсів.
Націнки застосовуються після чистого підсумку (суми всіх позицій). Поширені націнки включають:
Натисніть Додати націнку на панелі інструментів. Ви можете встановити регіональні значення за замовчуванням або налаштувати для кожного проєкту. Націнки можуть бути у відсотках або фіксованими сумами й нараховуються послідовно (спершу накладні витрати, потім прибуток на суму з накладними витратами, потім ПДВ на підсумок).
Натисніть 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, 24 см з опалубкою» - навіть якщо точні слова не збігаються. Це працює на ембеддингах sentence-transformer, які перетворюють описи на числові вектори й знаходять найближчі збіги у багатовимірному просторі. Підтримуються два бекенди векторної бази даних: LanceDB (вбудований, працює в тому самому процесі без окремого сервера, 384-вимірні ембеддинги) і Qdrant (продакшн-сервер із готовими 3072-вимірними знімками для завантаження з GitHub).
Вилучайте обсяги прямо з креслень і моделей вашого проєкту - без ручного підрахунку. Завантажте файли RVT, IFC, DWG або DGN, і система вилучить кожен будівельний елемент з об'ємами, площами й довжинами. Для креслень PDF відкривайте їх прямо в браузері й використовуйте калібровані інструменти вимірювання, щоб виміряти відстані, площі та кількість елементів. Усі вилучені обсяги можна перенести в BOQ для оцінки вартості.
🎬 Подивіться розділи про масову прив'язку BIM → BOQ, обмір за шарами DWG й вимірювання PDF на YouTube.





| Формат | Софт | Конвертер |
|---|---|---|
| .rvt / .rfa | BIM | DDC RvtExporter |
| .ifc | IFC (будь-який BIM) | DDC IfcExporter |
| .dwg / .dxf | CAD | DDC DwgExporter |
| .dgn | CAD | DDC DgnExporter |
Підключіть будь-якого провайдера LLM, щоб створювати будівельні кошториси з простих текстових описів, фото будівель, сканованих PDF, таблиць Excel або моделей CAD/BIM. Система ШІ створює повні позиції BOQ з обсягами й ринковими цінами. Після генерації ви можете зіставити кожну позицію з базою даних вартості CWICR, щоб замінити оцінені ШІ розцінки перевіреними регіональними ринковими цінами. Функції ШІ повністю опційні - платформа повністю працює й без них.
🎬 Перегляньте «ШІ-кошторис із фото» на YouTube - завантажте фото будівництва, отримайте готовий BOQ за секунди.


| Провайдер | Моделі | Можливості |
|---|---|---|
| Anthropic | Claude Sonnet / Opus | Текст, зображення, документи |
| OpenAI | GPT-4o | Текст, зображення, документи |
| Gemini Pro | Текст, зображення | |
| Mistral / Groq / DeepSeek | Різні | Текст |
Опишіть свій проєкт простим текстом, і ШІ створить 15-30 позицій BOQ з обсягами й ринковими розцінками.
Зіставте оцінки ШІ з базою даних CWICR, щоб замінити приблизні розцінки реальними ринковими цінами.
Спілкуйтеся з ШІ про вартість, матеріали й ціноутворення, використовуючи вашу базу даних вартості як контекст.

Плануйте графік свого будівельного проєкту й відстежуйте вартість у часі за допомогою інтегрованих інструментів планування та фінансового моделювання.
Модуль планування надає професійну діаграму Ганта для управління графіком будівництва. Створюйте роботи, задавайте тривалість, визначайте залежності, а система автоматично розраховує критичний шлях, показуючи, які роботи не можна затримувати.
Модель вартості пов'язує дані вашого BOQ із графіком проєкту, даючи вам розподілений у часі погляд на вартість будівництва з метриками управління освоєним обсягом.
Керуйте повним процесом закупівель - від створення тендерних пакетів до порівняння пропозицій і присудження договорів субпідрядникам.
Перейдіть до Закупівель, оберіть проєкт і натисніть «Створити пакет». Вкажіть назву пакета, опис обсягу робіт, кінцевий термін подання й оберіть, які позиції BOQ включити. Ви можете створити кілька пакетів на проєкт (наприклад, будівельні роботи, інженерні системи, оздоблення).
Додавайте пропозиції від субпідрядників із назвою компанії, контактними даними й запропонованими цінами для кожної позиції 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} | Отримати дані канбан-дошки |
Відстежуйте офіційні запити на інформацію між сторонами проєкту з призначенням відповідального за м'яч. RFI проходять через структурований життєвий цикл від чернетки до закриття, гарантуючи, що кожне питання отримає задокументовану відповідь. Відстеження «м'яча» показує, хто саме зараз відповідає за дію.
| Метод | Точка доступу | Опис |
|---|---|---|
| GET | /api/v1/rfis/ | Список RFI |
| POST | /api/v1/rfis/ | Створити RFI |
| POST | /api/v1/rfis/{id}/respond | Подати відповідь |
| PATCH | /api/v1/rfis/{id}/status | Оновити статус / м'яч |
Повне фінансове управління проєктом, що охоплює рахунки, бюджети, платежі й управління освоєним обсягом (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, запуск ШІ-кошторисів, пошук вартості - доступна як точка доступу 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 | ШІ-кошторисування |
| 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).
API: GET /api/v1/project_intelligence/score/?project_id=X - повертає загальну оцінку, оцінки за доменами, критичні прогалини й досягнення.
Керуйте членами команди, ролями й контролем доступу по кожному модулю.
Адміністратори можуть налаштовувати видимість і рівень доступу до модулів для кожного користувача (Немає, Перегляд, Редагування, Повний) на сторінці /users. Можна призначати власні назви ролей (наприклад, «Інженер об'єкта», «Менеджер з вартості»).
Поставте зірку репозиторію, щоб допомогти іншим дізнатися про проєкт.
Підпишіться на огляди релізів і туторіали. Почніть з 12-хвилинного огляду продукту.
Відкрийте issue на 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