Wszystko, czego potrzebujesz, aby zainstalować, skonfigurować i korzystać z OpenConstructionERP do profesjonalnego kosztorysowania w budownictwie.
Wdrożenie → Nowy projekt → BoQ → Powiązanie BIM → DWG → Przedmiar z PDF → Pełny kosztorys → Zadania → Eksplorator Danych → Kosztorys AI → Portfolio.
Napisy, rozdziały i odtwarzanie z prędkością 1,5x są wbudowane w odtwarzacz powyżej. Wolisz oglądać bezpośrednio na YouTube? ▶ Otwórz na YouTube · subskrybuj kanał, aby zobaczyć przewodniki po nowych wersjach.
Każdy blok poniżej to krótki GIF wycięty z pełnego przewodnika powyżej - w tej samej kolejności co film, dzięki czemu możesz przejść do procesu pracy, który interesuje Cię najbardziej. Chcesz jeden ciągły przepływ? ▶ Obejrzyj 12-minutowy przewodnik na YouTube.
OpenConstructionERP to kompletna platforma do kosztorysowania w budownictwie i zarządzania projektami, która działa w całości na Twoim komputerze. Zastępuje kosztowne komercyjne pakiety kosztorysowe otwartą, samodzielnie hostowaną alternatywą. Platforma obejmuje cały cykl życia inwestycji budowlanej - od wstępnych studiów wykonalności i przedmiarowania robót, przez szczegółowe przygotowanie BOQ, przetargi, porównanie ofert, realizację projektu, zarządzanie jakością, aż po kontrolę finansową. Wszystkie Twoje dane pozostają na Twoim serwerze. Bez zależności od chmury, bez subskrypcji, bez opłat za stanowisko.
Najważniejsze w v18.5.0: ponad 190 modułów obejmujących cały cykl życia budowy: książka kontaktów, zadania z Kanbanem, śledzenie RFI, finanse (faktury, budżety, EVM), zakupy, bezpieczeństwo, spotkania, kontrole jakości, NCR, submittals, korespondencja, CDE (ISO 19650), transmittals, BIM Hub, rejestr aktywów z eksportem COBie, raportowanie & pulpit KPI, markups (PDF↔DWG↔hub), wizualizacje przestawne & wybór kolumn do wykresów, rozszerzalna usługa e-mail, kontakty wielodzierżawne, raporty cykliczne, Regional Packs i pełny import/eksport.


Hierarchiczne przedmiary robót z sekcjami, pozycjami, zasobami, recepturami i automatycznymi narzutami.
Bazy kosztowe z 9 krajowych źródeł, publikowane w 48 edycjach rynkowych w lokalnej walucie i języku, z 36 regionalnymi bazami danych gotowymi do importu.
Generuj BOQ z tekstu, zdjęć, plików PDF, Excel lub modeli CAD/BIM, korzystając z dowolnego dostawcy LLM.
Pozyskuj ilości z RVT, IFC, DWG i DGN za pomocą konwerterów DDC.
Harmonogramowanie Gantta z CPM, zarządzanie wartością wypracowaną (EVM), krzywą S i symulacją Monte Carlo.
Finanse, Bezpieczeństwo, Jakość, CDE, Centrum BIM, Zaopatrzenie, RFI, Zadania, Spotkania i więcej. Włącz tylko to, czego potrzebujesz.
Po zainstalowaniu OpenConstructionERP wykonaj poniższe kroki, aby skonfigurować swój pierwszy projekt i utworzyć pierwszy kosztorys. Cały proces zajmuje około 10 minut.
Otwórz przeglądarkę i przejdź do http://localhost:5173 (lokalne środowisko deweloperskie) lub http://localhost:8080 (Docker). Zobaczysz stronę logowania z panelem "Dostęp demonstracyjny". Kliknij Admin, aby natychmiast zalogować się na konto demonstracyjne, lub wprowadź własne dane uwierzytelniające, jeśli zarejestrowałeś nowe konto.
Przy pierwszym logowaniu kreator wdrożenia przeprowadzi Cię przez wstępną konfigurację:
Kliknij Nowy projekt na Pulpicie lub przejdź do Projektów. Wypełnij:
Po utworzeniu projektu zostaniesz przekierowany na stronę szczegółów projektu, gdzie możesz zacząć dodawać przedmiary BOQ.
Na stronie projektu kliknij Nowy kosztorys. Nadaj mu nazwę (np. "Kosztorys v1") i opcjonalnie wybierz szablon. Otworzy się edytor BOQ z pustą siatką gotową na Twoją pierwszą pozycję.
W edytorze BOQ kliknij Dodaj pozycję lub naciśnij Enter w pustym wierszu. Wypełnij:
Kolumna Suma oblicza się automatycznie (Ilość x Cena jednostkowa). Możesz również przeszukać bazę danych kosztów, klikając ikonę bazy danych obok dowolnej pozycji, aby znaleźć i zastosować stawkę spośród ponad 120 000 pozycji CWICR.
OpenConstructionERP został zaprojektowany tak, aby był łatwy w instalacji niezależnie od Twojego zaplecza technicznego. Wybierz metodę pasującą do Twojej konfiguracji - wszystkie opcje zajmują mniej niż 5 minut. Aplikacja domyślnie używa wbudowanego PostgreSQL (bez Dockera, bez osobnego serwera bazy danych, bez konfiguracji), więc wszystko działa od razu po wyjęciu z pudełka. Wymaga Python 3.12+ dla ścieżek pip oraz instalacji jednoliniowej.
pip install --upgrade openconstructionerp
openconstructionerpInstaluje backend + gotowy frontend React w jednym pliku wheel. Otwiera się pod adresem http://localhost:8080 z pełnym interfejsem. Wbudowany PostgreSQL, bez konfiguracji. Jeśli coś wygląda nie tak, uruchom openconstructionerp doctor.
W Ubuntu 23.04+ (w tym Ubuntu 26) i Debian 12+ pip install bezpośrednio do systemowego Pythona kończy się błędem error: externally-managed-environment (PEP 668). Zamiast tego użyj środowiska wirtualnego:
# 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
openconstructionerpJeśli pip przełączy się na budowanie ze źródeł, zainstaluj nagłówki: sudo apt install -y build-essential libpq-dev libjpeg-dev zlib1g-dev libgeos-dev. Pełny przewodnik dla Linuksa wraz z rozwiązywaniem problemów: 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 | iexWybiera Docker, jeśli jest zainstalowany, w przeciwnym razie uv, a w ostateczności pip. Działa pod adresem http://localhost:8080.
git clone https://github.com/datadrivenconstruction/OpenConstructionERP.git
cd OpenConstructionERP
make quickstartOtwiera się pod adresem http://localhost:8080 (~2 min przy pierwszym budowaniu).
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 devBackend: http://localhost:8000 / Frontend: http://localhost:5173
| Konto | Hasło | Rola | |
|---|---|---|---|
| Admin | demo@openconstructionerp.com | DemoPass1234! | Pełny dostęp |
| Estimator | estimator@openconstructionerp.com | DemoPass1234! | Kosztorysant |
| Manager | manager@openconstructionerp.com | DemoPass1234! | Kierownik |
5 projektów demonstracyjnych (Berlin, Londyn, Nowy Jork, Paryż, Dubaj) z kompletnymi przedmiarami BOQ, harmonogramami i modelami kosztów.
Edytor przedmiaru robót to miejsce, w którym spędzasz najwięcej czasu. Zapewnia profesjonalny, arkuszowy interfejs oparty na AG Grid, z wbudowanymi funkcjami specyficznymi dla budownictwa - hierarchicznymi sekcjami, powiązaniami zasobów, recepturami i automatycznym wyliczaniem narzutów. Każda zmiana jest śledzona z pełną obsługą cofnij/ponów. 42 reguły walidacji działają automatycznie w tle, wychwytując błędy takie jak brakujące ilości, ceny zerowe, zduplikowane pozycje i problemy ze zgodnością klasyfikacji, zanim staną się problemem.
🎬 Zobacz edytor BOQ w akcji na YouTube - edycja zorientowana na klawiaturę, ponad 120 tys. wycenionych pozycji, wskaźnik jakości na żywo.



Sekcje porządkują BOQ w logiczne grupy (np. "300 Konstrukcja", "400 HVAC"). Aby utworzyć sekcję:
Możesz zwijać/rozwijać sekcje, aby skupić się na konkretnych branżach. Przeciągaj sekcje, aby zmienić kolejność całej struktury BOQ.
Każda pozycja BOQ może mieć powiązane zasoby, które rozbijają cenę jednostkową na składniki:
Aby dodać zasoby: rozwiń wiersz pozycji, kliknij "Dodaj zasób", przeszukaj katalog, ustaw współczynnik ilościowy (np. 120 kg zbrojenia na m3 betonu). Cena jednostkowa pozycji aktualizuje się automatycznie na podstawie sumy jej zasobów.
Narzuty są naliczane po sumie netto (suma wszystkich pozycji). Typowe narzuty obejmują:
Kliknij Dodaj narzut na pasku narzędzi. Możesz ustawić domyślne wartości regionalne lub dostosować je do projektu. Narzuty mogą być procentowe lub kwotowe i naliczają się kolejno (najpierw koszty ogólne, następnie zysk od kwoty zawierającej koszty ogólne, a na końcu VAT od sumy).
Naciśnij Ctrl+Shift+V lub kliknij ikonę tarczy na pasku narzędzi, aby uruchomić walidację. System sprawdza Twój BOQ względem wybranych zestawów reguł i wyświetla wyniki w miejscu:
Edytor BOQ obsługuje import z wielu źródeł:
| Skrót | Działanie |
|---|---|
Ctrl+K | Paleta poleceń |
Ctrl+N | Nowy projekt |
Ctrl+Shift+V | Uruchom walidację |
Ctrl+Z / Y | Cofnij / Ponów |
Skorzystaj z największej na świecie otwartej bazy kosztów budowlanych: ponad 120 000 pozycji kosztów w ponad 40 regionach. Globalna baza CWICR wnosi ponad 55 000 pozycji z opisami w maksymalnie 9 językach, uporządkowanych według branż (roboty ziemne, beton, murarka, stal, dachy, fasady, HVAC, elektryka, hydraulika, wykończenie, zagospodarowanie terenu). Każda pozycja zawiera jednostkę miary, cenę bazową dla wskazanego regionu, kody klasyfikacji (DIN 276, NRM, MasterFormat) oraz, gdy są dostępne, rozbicie na materiały, robociznę i sprzęt.


| Region | Waluta | Standard | Pozycje |
|---|---|---|---|
| Niemcy (DACH) | EUR | DIN 276 | 55,719 |
| Wielka Brytania | GBP | NRM 1/2 | 55,719 |
| Stany Zjednoczone | USD | MasterFormat | 55,719 |
| Francja | EUR | DPGF | 55,719 |
| Rosja | RUB | GESN | 55,719 |
| ZEA | AED | Lokalny | 55,719 |
| Chiny | CNY | GB/T | 55,719 |
| Indie | INR | CPWD | 55,719 |
Baza kosztów została zaprojektowana z myślą o dwóch głównych przepływach pracy:
Każda pozycja kosztowa zawiera:
Włącz wyszukiwanie semantyczne, aby znajdować pozycje kosztowe według znaczenia, a nie tylko dokładnego dopasowania słów kluczowych. Gdy wyszukujesz "ściana betonowa", system znajdzie również pozycje takie jak "żelbetowa ścianka działowa C30/37, 24 cm z szalunkiem" - mimo że dokładne słowa się nie pojawiają. Działa to dzięki osadzeniom (embeddings) typu sentence-transformer, które przekształcają opisy w wektory liczbowe i znajdują najbliższe dopasowania w przestrzeni wielowymiarowej. Obsługiwane są dwa silniki bazy wektorowej: LanceDB (wbudowany, działa w procesie jak SQLite, osadzenia 384-wymiarowe) oraz Qdrant (serwer produkcyjny z gotowymi 3072-wymiarowymi migawkami do pobrania z GitHub).
Pozyskuj ilości bezpośrednio z rysunków i modeli projektowych - bez ręcznego liczenia. Prześlij pliki RVT, IFC, DWG lub DGN, a system wyodrębni każdy element budowlany wraz z objętościami, powierzchniami i długościami. Rysunki PDF otwierasz bezpośrednio w przeglądarce i za pomocą skalibrowanych narzędzi pomiarowych przedmiarujesz odległości, powierzchnie i liczby elementów. Wszystkie pozyskane ilości można przenieść do BOQ w celu wyceny.
🎬 Obejrzyj rozdziały o masowym wiązaniu BIM → BOQ, przedmiarze warstw DWG i pomiarach PDF na YouTube.





| Format | Oprogramowanie | Konwerter |
|---|---|---|
| .rvt / .rfa | BIM | DDC RvtExporter |
| .ifc | IFC (dowolny BIM) | DDC IfcExporter |
| .dwg / .dxf | CAD | DDC DwgExporter |
| .dgn | CAD | DDC DgnExporter |
Podłącz dowolnego dostawcę LLM, aby generować kosztorysy budowlane z prostych opisów tekstowych, zdjęć obiektów, zeskanowanych plików PDF, arkuszy Excel lub modeli CAD/BIM. System AI tworzy kompletne pozycje BOQ z ilościami i wyceną rynkową. Po wygenerowaniu możesz dopasować każdą pozycję do bazy kosztów CWICR, aby zastąpić stawki oszacowane przez AI zweryfikowanymi regionalnymi cenami rynkowymi. Funkcje AI są w pełni opcjonalne - platforma działa w pełni bez nich.
🎬 Zobacz "Kosztorys AI ze zdjęcia" na YouTube - prześlij zdjęcie z budowy i otrzymaj BOQ z zakresem w kilka sekund.


| Dostawca | Modele | Funkcje |
|---|---|---|
| Anthropic | Claude Sonnet / Opus | Tekst, obraz, dokumenty |
| OpenAI | GPT-4o | Tekst, obraz, dokumenty |
| Gemini Pro | Tekst, obraz | |
| Mistral / Groq / DeepSeek | Różne | Tekst |
Opisz swój projekt prostym tekstem, a AI wygeneruje 15-30 pozycji BOQ z ilościami i stawkami rynkowymi.
Dopasuj kosztorysy AI do bazy CWICR, aby zastąpić szacowane stawki rzeczywistymi cenami rynkowymi.
Rozmawiaj z AI o kosztach, materiałach i wycenie, wykorzystując swoją bazę kosztów jako kontekst.

Planuj harmonogram swojego projektu budowlanego i śledź koszty w czasie dzięki zintegrowanym narzędziom do harmonogramowania i modelowania finansowego.
Moduł harmonogramowania zapewnia profesjonalny wykres Gantta do zarządzania harmonogramem budowy. Twórz czynności, ustalaj czasy trwania, definiuj zależności, a system automatycznie wylicza ścieżkę krytyczną, pokazując, które czynności nie mogą zostać opóźnione.
Model kosztów łączy dane BOQ z harmonogramem projektu, dając Ci rozłożony w czasie obraz kosztów budowy wraz ze wskaźnikami zarządzania wartością wypracowaną (EVM).
Zarządzaj całym przepływem zaopatrzenia, od tworzenia pakietów przetargowych po porównywanie ofert i udzielanie zamówień podwykonawcom.
Przejdź do Zaopatrzenia, wybierz projekt i kliknij "Utwórz pakiet". Określ nazwę pakietu, opis zakresu, termin składania ofert i wybierz, które pozycje BOQ mają zostać uwzględnione. Możesz utworzyć wiele pakietów na projekt (np. roboty konstrukcyjne, instalacje MEP, wykończenia).
Dodawaj oferty od podwykonawców wraz z nazwą firmy, danymi kontaktowymi i wycenionymi cenami dla każdej pozycji BOQ. System obsługuje wiele ofert na pakiet w celu porównania obok siebie.
Lustro cenowe pokazuje wszystkie oferty w tabeli porównawczej z cenami jednostkowymi i sumami dla każdej pozycji. Wskaźniki wizualne wyróżniają najniższe i najwyższe oferty. Wyeksportuj porównanie do CSV do przeglądu przez interesariuszy.
Oznacz zwycięską ofertę przyciskiem Udziel i dodaj notatki uzasadniające. Status pakietu przechodzi przez etapy: Wersja robocza, Wydany, Zbieranie, Ocena, Udzielony, Zamknięty.
Identyfikuj, oceniaj i zarządzaj ryzykami projektu za pomocą macierzy prawdopodobieństwo-wpływ. Określaj ilościowo ekspozycję na ryzyko i planuj strategie ograniczania dla każdego zidentyfikowanego ryzyka.
Macierz wyświetla wszystkie ryzyka na siatce prawdopodobieństwo (0,1-0,9) vs wpływ (niski/średni/wysoki/krytyczny) z oznaczeniem kolorystycznym. Każde ryzyko pokazuje wyliczony wskaźnik ekspozycji (prawdopodobieństwo pomnożone przez koszt wpływu).
Dla każdego ryzyka udokumentuj: unikalny kod (R-001), tytuł, kategorię (techniczne, finansowe, harmonogramowe, regulacyjne, środowiskowe, bezpieczeństwa), strategię ograniczania, plan awaryjny, właściciela ryzyka, wpływ kosztowy oraz wpływ na harmonogram w dniach. Śledź status w etapach: Zidentyfikowane, Ocenione, Ograniczane, Zamknięte lub Wystąpiło.
Śledź zmiany zakresu i ich wpływ na koszt oraz harmonogram projektu. Zlecenia zmian zapewniają ścieżkę audytu wszystkich modyfikacji wprowadzonych po początkowym kosztorysie.
Utwórz zlecenie zmiany z kodem (CO-001), tytułem i kategorią przyczyny (żądanie klienta, zmiana projektowa, nieprzewidziane warunki, regulacyjna). Dodaj pozycje określające dotknięte pozycje BOQ z pierwotnymi i nowymi ilościami/stawkami. System automatycznie wylicza różnice kosztów. Status przechodzi przez etapy: Wersja robocza, Złożone, W trakcie przeglądu, Zatwierdzone/Odrzucone.

Uruchamiaj automatyczne kontrole jakości swoich przedmiarów BOQ, aby wychwycić błędy, zanim staną się problemem. Silnik walidacji stosuje 42 konfigurowalne reguły wobec danych Twojego kosztorysu.
Każda walidacja generuje wskaźnik jakości (0-100%) z oznaczonymi kolorystycznie wynikami: Błędy (czerwone, do obowiązkowej poprawy), Ostrzeżenia (żółte, do przeglądu), Informacje (niebieskie, sugestie). Kliknij dowolny wynik, aby przejść bezpośrednio do dotkniętej pozycji BOQ.



Generuj profesjonalne dokumenty z danych projektu dla interesariuszy, klientów i potrzeb zgodności regulacyjnej.

Scentralizuj wszystkie dokumenty projektu. Przesyłaj rysunki, umowy, specyfikacje i zdjęcia z automatyczną kategoryzacją i wyszukiwaniem.


Przeglądaj wyniki budżetowe w wielu projektach. Pulpit agreguje dane finansowe ze wszystkich projektów, aby identyfikować trendy, odchylenia i zagrożone budżety.
Zarządzaj wszystkimi interesariuszami projektu w scentralizowanym katalogu. Śledź klientów, podwykonawców, dostawców, architektów i konsultantów z pełnymi danymi kontaktowymi, powiązaniami firmowymi i kategoryzacją według ról. Powiązuj kontakty z projektami, przetargami, zamówieniami zakupu i korespondencją, aby zapewnić pełną identyfikowalność.
| Metoda | Punkt końcowy | Opis |
|---|---|---|
| GET | /api/v1/contacts/ | Wyświetl wszystkie kontakty |
| POST | /api/v1/contacts/ | Utwórz kontakt |
| GET | /api/v1/contacts/{id} | Pobierz szczegóły kontaktu |
| PUT | /api/v1/contacts/{id} | Zaktualizuj kontakt |
| POST | /api/v1/contacts/import | Import zbiorczy kontaktów |
Organizuj pracę nad projektem za pomocą taksonomii 5 typów zadań i wizualnej tablicy Kanban. Zadania można przypisywać członkom zespołu, powiązywać z konkretnymi pozycjami BOQ, dokumentami lub RFI oraz śledzić przez konfigurowalne etapy przepływu pracy. Każdy typ zadania ma własne oznaczenie kolorystyczne i domyślne pola.

| Metoda | Punkt końcowy | Opis |
|---|---|---|
| GET | /api/v1/tasks/ | Wyświetl zadania (filtrowanie wg projektu, przypisanego, statusu) |
| POST | /api/v1/tasks/ | Utwórz zadanie |
| PATCH | /api/v1/tasks/{id} | Zaktualizuj zadanie (status, przypisany, priorytet) |
| GET | /api/v1/tasks/board/{project_id} | Pobierz dane tablicy Kanban |
Śledź formalne zapytania o informacje między stronami projektu z przypisaniem odpowiedzialności (ball-in-court). RFI przechodzą przez ustrukturyzowany cykl życia od wersji roboczej do zamknięcia, zapewniając, że każde pytanie otrzyma udokumentowaną odpowiedź. Śledzenie ball-in-court pokazuje, kto w danym momencie odpowiada za podjęcie działania.
| Metoda | Punkt końcowy | Opis |
|---|---|---|
| GET | /api/v1/rfis/ | Lista RFI |
| POST | /api/v1/rfis/ | Utwórz RFI |
| POST | /api/v1/rfis/{id}/respond | Prześlij odpowiedź |
| PATCH | /api/v1/rfis/{id}/status | Aktualizuj status / ball-in-court |
Pełne zarządzanie finansami projektu obejmujące faktury, budżety, płatności oraz zarządzanie wartością wypracowaną (EVM). Śledź koszty planowane względem rzeczywistych, generuj wnioski o płatność i monitoruj kondycję budżetu dzięki analizie odchyleń w czasie rzeczywistym. Integruje się z danymi BOQ w celu automatycznego generowania bazowego planu kosztów.
| Metoda | Punkt końcowy | Opis |
|---|---|---|
| GET | /api/v1/finance/invoices/ | Lista faktur |
| POST | /api/v1/finance/invoices/ | Utwórz fakturę |
| GET | /api/v1/finance/budgets/ | Lista budżetów |
| POST | /api/v1/finance/budgets/import | Importuj budżet z Excela |
| GET | /api/v1/finance/evm/{project_id} | Pobierz wskaźniki EVM |
| GET | /api/v1/finance/payments/ | Lista płatności |
Zarządzaj zamówieniami zakupu i przyjęciami towarów dla materiałów i usług budowlanych. Twórz zamówienia powiązane z pozycjami BOQ, śledź status dostaw i rejestruj przyjęcia towarów z weryfikacją ilości. Integruje się z modułem Kontaktów w celu zarządzania dostawcami.
| Metoda | Punkt końcowy | Opis |
|---|---|---|
| GET | /api/v1/procurement/orders/ | Lista zamówień zakupu |
| POST | /api/v1/procurement/orders/ | Utwórz zamówienie zakupu |
| POST | /api/v1/procurement/orders/{id}/receive | Zarejestruj przyjęcie towarów |
| GET | /api/v1/procurement/receipts/ | Lista przyjęć towarów |
Rejestruj zdarzenia związane z bezpieczeństwem, sytuacje potencjalnie wypadkowe oraz obserwacje behawioralne z systemem oceny ryzyka. Śledź wskaźniki bezpieczeństwa w projektach, identyfikuj trendy i zapewniaj zgodność z przepisami BHP.
| Metoda | Punkt końcowy | Opis |
|---|---|---|
| GET | /api/v1/safety/incidents/ | Lista zdarzeń |
| POST | /api/v1/safety/incidents/ | Zgłoś zdarzenie |
| GET | /api/v1/safety/observations/ | Lista obserwacji |
| POST | /api/v1/safety/observations/ | Zarejestruj obserwację |
| GET | /api/v1/safety/dashboard/{project_id} | Pobierz wskaźniki KPI bezpieczeństwa |
Zarządzaj protokołami spotkań z ustrukturyzowanymi agendami i śledzonymi zadaniami do realizacji. Twórz cykliczne serie spotkań (np. cotygodniowe spotkania na budowie), rejestruj uczestników, zapisuj punkty dyskusji i automatycznie generuj zadania, które integrują się z modułem Zadań.
| Metoda | Punkt końcowy | Opis |
|---|---|---|
| GET | /api/v1/meetings/ | Lista spotkań |
| POST | /api/v1/meetings/ | Utwórz spotkanie |
| GET | /api/v1/meetings/{id}/minutes | Pobierz protokół spotkania |
| POST | /api/v1/meetings/{id}/actions | Dodaj zadanie do realizacji |
Przeprowadzaj inspekcje jakości przy użyciu konfigurowalnych list kontrolnych. Definiuj szablony inspekcji dla danej branży lub rodzaju czynności, wypełniaj je na budowie, załączaj zdjęcia i śledź usuwanie usterek. Wyniki inspekcji zasilają wskaźnik jakości projektu oraz proces NCR.
| Metoda | Punkt końcowy | Opis |
|---|---|---|
| GET | /api/v1/inspections/ | Lista inspekcji |
| POST | /api/v1/inspections/ | Utwórz inspekcję z szablonu |
| GET | /api/v1/inspections/templates/ | Lista szablonów list kontrolnych |
| PATCH | /api/v1/inspections/{id}/items | Aktualizuj wyniki pozycji listy kontrolnej |
Dokumentuj i śledź niezgodności jakościowe, gdy prace nie spełniają specyfikacji. NCR przechodzą przez formalny cykl życia od identyfikacji, przez analizę przyczyn źródłowych, aż po weryfikację działań korygujących, zapewniając, że wszystkie odstępstwa jakościowe zostaną właściwie rozwiązane i udokumentowane.
| Metoda | Punkt końcowy | Opis |
|---|---|---|
| GET | /api/v1/ncr/ | Lista NCR |
| POST | /api/v1/ncr/ | Utwórz NCR |
| PATCH | /api/v1/ncr/{id}/status | Aktualizuj status NCR |
| POST | /api/v1/ncr/{id}/actions | Dodaj działanie korygujące |
Zarządzaj procesem przeglądu dokumentów zatwierdzających dla materiałów budowlanych, rysunków warsztatowych i danych produktowych. Śledź wieloetapowe procesy przeglądu, w których dokumenty przechodzą przez wielu recenzentów przed ostatecznym zatwierdzeniem. Utrzymuj pełną ścieżkę audytu wszystkich cykli przeglądu i historii rewizji.
| Metoda | Punkt końcowy | Opis |
|---|---|---|
| GET | /api/v1/submittals/ | Lista dokumentów zatwierdzających |
| POST | /api/v1/submittals/ | Utwórz dokument zatwierdzający |
| POST | /api/v1/submittals/{id}/review | Prześlij decyzję przeglądu |
| POST | /api/v1/submittals/{id}/revise | Prześlij nową rewizję |
Prowadź formalny rejestr komunikacji dla całej korespondencji projektowej. Śledź pisma, e-maile, zawiadomienia i polecenia między stronami projektu z unikalnymi numerami referencyjnymi, śledzeniem odpowiedzi i wyszukiwaniem pełnotekstowym. Zapewnia właściwe udokumentowanie i możliwość prześledzenia komunikacji kontraktowej.
| Metoda | Punkt końcowy | Opis |
|---|---|---|
| GET | /api/v1/correspondence/ | Lista korespondencji |
| POST | /api/v1/correspondence/ | Utwórz wpis korespondencji |
| GET | /api/v1/correspondence/{id} | Pobierz szczegóły z załącznikami |
| GET | /api/v1/correspondence/{id}/thread | Pobierz powiązany ciąg korespondencji |
Zgodne z ISO 19650 wspólne środowisko danych do zarządzania informacjami projektowymi z kontrolowanymi przejściami statusów. Dokumenty przechodzą przez stany Praca w toku (WIP), Udostępnione, Opublikowane i Zarchiwizowane z bramkami zatwierdzania. Zapewnia, że zarządzanie informacjami przebiega zgodnie ze standardami BIM dla współpracy.
| Metoda | Punkt końcowy | Opis |
|---|---|---|
| GET | /api/v1/cde/documents/ | Lista dokumentów CDE (z filtrowaniem po statusie, przydatności) |
| POST | /api/v1/cde/documents/ | Prześlij dokument do CDE |
| PATCH | /api/v1/cde/documents/{id}/status | Zmień status dokumentu |
| GET | /api/v1/cde/documents/{id}/history | Pobierz historię rewizji |
Formalnie dystrybuuj dokumenty do stron zewnętrznych ze śledzeniem doręczenia i potwierdzenia odbioru. Twórz pakiety pism przewodnich zawierające wiele dokumentów, określaj odbiorców i śledź, czy każdy odbiorca otrzymał i potwierdził dokumenty. Stanowi kontraktowy zapis wymiany informacji.
| Metoda | Punkt końcowy | Opis |
|---|---|---|
| GET | /api/v1/transmittals/ | Lista pism przewodnich |
| POST | /api/v1/transmittals/ | Utwórz pismo przewodnie |
| POST | /api/v1/transmittals/{id}/send | Wyślij pismo przewodnie do odbiorców |
| PATCH | /api/v1/transmittals/{id}/acknowledge | Zarejestruj potwierdzenie odbioru przez odbiorcę |
Centralne miejsce zarządzania modelami BIM z dostępem do danych na poziomie elementu i bezpośrednim powiązaniem z BOQ. Przesyłaj modele IFC/RVT, przeglądaj elementy budowlane wraz z ich właściwościami i ilościami oraz wiąż elementy z pozycjami BOQ w celu integracji kosztów 5D. Stanowi pomost między danymi projektowymi a kosztorysowaniem.
🎬 Demo masowego łączenia BIM na YouTube - 100 ścian BIM → jedna linia BOQ z zagregowaną powierzchnią, objętością i długością.
| Metoda | Punkt końcowy | Opis |
|---|---|---|
| GET | /api/v1/bim/models/ | Lista modeli BIM |
| POST | /api/v1/bim/models/ | Prześlij model BIM |
| GET | /api/v1/bim/models/{id}/elements | Lista elementów modelu |
| POST | /api/v1/bim/elements/{id}/link-boq | Powiąż element z pozycją BOQ |
Kompleksowy silnik raportowania z pulpitem KPI, konfigurowalnymi szablonami raportów i harmonogramowanym generowaniem raportów. Agreguj dane z wielu projektów dla wglądu na poziomie portfela. Twórz własne szablony raportów łączące dane z dowolnego modułu (BOQ, Finanse, Harmonogram, Bezpieczeństwo, Jakość).
| Metoda | Punkt końcowy | Opis |
|---|---|---|
| GET | /api/v1/reporting/kpi/{project_id} | Pobierz wskaźniki KPI projektu |
| GET | /api/v1/reporting/templates/ | Lista szablonów raportów |
| POST | /api/v1/reporting/generate | Wygeneruj raport z szablonu |
| GET | /api/v1/reporting/portfolio/ | Pobierz dane pulpitu portfela |
Wbudowany system powiadomień, który informuje użytkowników o istotnych dla nich zdarzeniach. Powiadomienia są wyzwalane przez akcje we wszystkich modułach - przypisania zadań, odpowiedzi na RFI, przeglądy dokumentów zatwierdzających, prośby o zatwierdzenie, zaległe pozycje i więcej. Użytkownicy kontrolują swoje preferencje powiadomień dla każdej kategorii.
| Metoda | Punkt końcowy | Opis |
|---|---|---|
| GET | /api/v1/notifications/ | Lista powiadomień (najpierw nieprzeczytane) |
| PATCH | /api/v1/notifications/{id}/read | Oznacz powiadomienie jako przeczytane |
| POST | /api/v1/notifications/read-all | Oznacz wszystkie jako przeczytane |
| GET | /api/v1/notifications/preferences | Pobierz preferencje powiadomień |
Wykres Gantta oparty wyłącznie na SVG do wizualizacji harmonogramu budowy. Renderuje osie czasu, zależności, kamienie milowe i ścieżkę krytyczną bezpośrednio w przeglądarce, bez zewnętrznych bibliotek. Obsługuje powiększanie od widoku dziennego do rocznego oraz eksport do PDF/PNG na potrzeby raportowania.
| Metoda | Punkt końcowy | Opis |
|---|---|---|
| GET | /api/v1/schedule/gantt/{project_id} | Pobierz dane wykresu Gantta (czynności, zależności) |
| PATCH | /api/v1/schedule/activities/{id} | Aktualizuj daty/postęp czynności |
| POST | /api/v1/schedule/dependencies/ | Utwórz zależność |
Konfiguruj strefę czasową, walutę, format liczb i format daty dla każdego użytkownika i każdego projektu. Ustawienia regionalne kaskadują od ustawień domyślnych systemu, przez nadpisania na poziomie projektu, aż po preferencje na poziomie użytkownika, zapewniając, że każdy członek zespołu widzi dane sformatowane zgodnie ze swoimi ustawieniami lokalnymi.
| Metoda | Punkt końcowy | Opis |
|---|---|---|
| GET | /api/v1/settings/regional/ | Pobierz bieżące ustawienia regionalne |
| PUT | /api/v1/settings/regional/ | Aktualizuj ustawienia regionalne |
| GET | /api/v1/settings/regional/timezones | Lista dostępnych stref czasowych |
| GET | /api/v1/settings/regional/currencies | Lista obsługiwanych walut |
Włączaj lub wyłączaj moduły platformy, aby dostosować OpenConstructionERP do swojego procesu pracy. Każdy moduł można przełączać niezależnie, bez wpływu na pozostałe moduły. Wyłączone moduły są ukrywane w interfejsie, ich punkty końcowe API zwracają 404, a ich tabele bazy danych pozostają nienaruszone na potrzeby ponownej aktywacji.
| Metoda | Punkt końcowy | Opis |
|---|---|---|
| GET | /api/v1/modules/ | Lista wszystkich modułów ze statusem |
| PATCH | /api/v1/modules/{name}/toggle | Włącz lub wyłącz moduł |
| GET | /api/v1/modules/{name}/dependencies | Sprawdź zależności modułu |
Wstępnie skonfigurowane pakiety regionalne, które ustawiają standardy klasyfikacji, reguły podatkowe, domyślne bazy danych kosztów, szablony raportów i reguły zgodności regulacyjnej dla konkretnych rynków. Zainstaluj pakiet regionalny, aby natychmiast skonfigurować platformę dla swojego kraju lub regionu.
| Pakiet | Region | Standardy | Waluta |
|---|---|---|---|
| US | Stany Zjednoczone | MasterFormat, UniFormat, CSI | USD |
| DACH | Niemcy, Austria, Szwajcaria | DIN 276, GAEB, VOB, HOAI | EUR/CHF |
| UK | Wielka Brytania | NRM 1/2, RICS, JCT | GBP |
| Russia | Rosja, WNP | GESN, FER, TER, SNIP | RUB |
| Bliski Wschód | ZEA, Arabia Saudyjska, Katar | RICS, CESMM, FIDIC | AED/SAR/QAR |
| Asia-Pacific | Chiny, Japonia, Australia | GB/T, AS 4000, JASS | CNY/AUD/JPY |
| India | Indie | CPWD, IS standards, DSR | INR |
| LatAm | Brazylia, Meksyk, Kolumbia | SINAPI, CMIC, local norms | BRL/MXN/COP |
| Metoda | Punkt końcowy | Opis |
|---|---|---|
| GET | /api/v1/regional-packs/ | Lista dostępnych pakietów regionalnych |
| POST | /api/v1/regional-packs/{name}/install | Zainstaluj pakiet regionalny |
| GET | /api/v1/regional-packs/{name}/details | Pobierz zawartość i konfigurację pakietu |
Kompleksowe możliwości importu i eksportu danych we wszystkich modułach. Importuj kontakty, budżety, BOQ i bazy danych kosztów z plików Excel i CSV dzięki inteligentnemu mapowaniu kolumn. Eksportuj dane projektu do Excela, PDF i CSV z konfigurowalnymi szablonami. Wszystkie eksporty zachowują formatowanie i zawierają nagłówki metadanych.
| Metoda | Punkt końcowy | Opis |
|---|---|---|
| POST | /api/v1/import/contacts | Importuj kontakty z pliku |
| POST | /api/v1/import/budget | Importuj budżet z Excela |
| POST | /api/v1/export/boq/{id} | Eksportuj BOQ (format: excel, pdf, gaeb, csv) |
| POST | /api/v1/export/report | Wygeneruj i wyeksportuj raport |



| Zmienna | Domyślnie | Opis |
|---|---|---|
DATABASE_URL | (nieustawione = wbudowany PostgreSQL) | Baza danych (domyślnie wbudowany PostgreSQL; ustaw dla zewnętrznego PostgreSQL). Zostaw nieustawione, aby używać wbudowanego PostgreSQL, albo wskaż zewnętrzną bazę, na przykład postgresql+asyncpg://oe:oe@localhost:5432/openestimate. |
JWT_SECRET | dev-key | Sekret JWT (zmień w środowisku produkcyjnym!) |
SEED_DEMO | true | Utwórz konta demonstracyjne |
VECTOR_BACKEND | lancedb | Zaplecze wyszukiwania wektorowego |
OpenConstructionERP udostępnia kompleksowe API REST, które obsługuje frontend i może być wykorzystywane do integracji, automatyzacji oraz niestandardowych przepływów pracy. Każde działanie dostępne w interfejsie - tworzenie projektów, edycja BOQ, uruchamianie kosztorysów AI, wyszukiwanie kosztów - jest dostępne jako punkt końcowy API. Interaktywna dokumentacja Swagger z przyciskami do wypróbowania jest dostępna pod adresem /api/docs podczas uruchomienia backendu.
| Metoda | Punkt końcowy | Opis |
|---|---|---|
| POST | /api/v1/users/auth/login | Logowanie |
| GET | /api/v1/projects/ | Lista projektów |
| GET | /api/v1/boq/boqs/?project_id=... | Lista BOQ |
| GET | /api/v1/costs/?q=concrete | Wyszukiwanie kosztów |
| POST | /api/v1/ai/quick-estimate | Kosztorysowanie AI |
| POST | /api/v1/takeoff/cad-extract | Ekstrakcja CAD |
| GET | /api/health | Kontrola stanu |
| Moduł | Prefiks | Opis |
|---|---|---|
| Contacts | /api/v1/contacts/ | Katalog kontaktów CRUD, import |
| Tasks | /api/v1/tasks/ | Zarządzanie zadaniami, tablica Kanban |
| RFI | /api/v1/rfis/ | Zapytania o informacje |
| Finance | /api/v1/finance/ | Faktury, budżety, płatności, EVM |
| Procurement | /api/v1/procurement/ | Zamówienia zakupu, przyjęcia towarów |
| Safety | /api/v1/safety/ | Zdarzenia, obserwacje, ocena ryzyka |
| Meetings | /api/v1/meetings/ | Protokoły, agenda, zadania do realizacji |
| Inspections | /api/v1/inspections/ | Inspekcje jakości, listy kontrolne |
| NCR | /api/v1/ncr/ | Raporty niezgodności |
| Submittals | /api/v1/submittals/ | Wieloetapowy przegląd dokumentów zatwierdzających |
| Correspondence | /api/v1/correspondence/ | Rejestr komunikacji |
| CDE | /api/v1/cde/ | Środowisko dokumentów ISO 19650 |
| Transmittals | /api/v1/transmittals/ | Dystrybucja dokumentów |
| BIM Hub | /api/v1/bim/ | Modele BIM, elementy, powiązanie z BOQ |
| Reporting | /api/v1/reporting/ | Pulpit KPI, szablony raportów |
| Notifications | /api/v1/notifications/ | Wbudowany system powiadomień |
| Comments | /api/v1/comments/ | Komentarze wątkowe dla dowolnego obiektu |
| Gantt | /api/v1/schedule/gantt/ | Wizualizacja harmonogramu SVG |
| Regional | /api/v1/settings/regional/ | Strefa czasowa, waluta, preferencje formatu |
| Modules | /api/v1/modules/ | Włączanie/wyłączanie modułów |
| Regional Packs | /api/v1/regional-packs/ | Instalacja konfiguracji regionalnych |
| Import/Export | /api/v1/import/ / /api/v1/export/ | Masowy import i eksport danych |
Zobacz każdą sekcję modułu powyżej, aby uzyskać szczegółową dokumentację punktów końcowych z parametrami i opisami.
Analiza projektu oparta na AI, która ocenia Twój projekt w 9 ważonych domenach i generuje wskaźnik kompletności od 0 do 100 (oceny od A do F).
API: GET /api/v1/project_intelligence/score/?project_id=X - zwraca ogólny wynik, wyniki domen, luki krytyczne i osiągnięcia.
Zarządzaj członkami zespołu, rolami oraz kontrolą dostępu dla poszczególnych modułów.
Administratorzy mogą konfigurować widoczność modułów i poziomy dostępu dla każdego użytkownika (Brak, Podgląd, Edycja, Pełny) za pośrednictwem strony /users. Można przypisywać niestandardowe nazwy ról (np. "Inżynier budowy", "Menedżer kosztów").
Oznacz repozytorium gwiazdką, aby pomóc innym odkryć projekt.
Zasubskrybuj, aby otrzymywać omówienia wydań i samouczki. Zacznij od 12-minutowego omówienia produktu.
Zgłoś problem na GitHub.
Dołącz do społeczności Telegram, aby zadawać pytania.
Skontaktuj się z nami w sprawie wdrożenia i szkoleń.
Licencja: AGPL-3.0. Licencjonowanie komercyjne: info@datadrivenconstruction.io
OpenConstructionERP
Stworzone przez zespół DataDrivenConstruction
2026 Data Driven Construction. AGPL-3.0
Komentarze
System komentarzy wątkowych, który można dołączyć do dowolnego obiektu na platformie - pozycji BOQ, zadań, RFI, dokumentów zatwierdzających, dokumentów, inspekcji i więcej. Obsługuje wzmianki @mentions powiadamiające członków zespołu, załączniki plików oraz śledzenie rozwiązania dla dyskusji zorientowanych na działanie.
Kluczowe funkcje
Punkty końcowe API
/api/v1/comments/?entity_type=task&entity_id=.../api/v1/comments//api/v1/comments/{id}/reply/api/v1/comments/{id}/resolve