Obmiarowanie projektów budowlanych AI

SPECYFIKACJA ZLECENIA

1) Cel i zakres projektu

Cel: Zbudowanie aplikacji webowej opartej na AI, która automatycznie wykonuje obmiar z dokumentacji projektowej (architektura, konstrukcja, instalacje/branże, pzt), łączy rysunki w całość, identyfikuje elementy (np. ściany, okna, drzwi, tynki, elementy konstrukcyjne i instalacyjne), a następnie prezentuje kompletny obmiar w tabelach z możliwością wizualnej weryfikacji (2D/3D) i wyceną.

Na start:

• Obsługa plików wektorowych: *.dwg, *.pdf (wektorowy)
• Zakres branż: architektura, konstrukcja, instalacje (HVAC, wod-kan, elektryka), pzt
• Funkcje: automatyczne łączenie dokumentacji – na potrzeby aplikacji, rozpoznanie elementów i obmiar, wizualizacja, możliwość ręcznej korekty, dodawanie cen i tworzenie kosztorysu wstępnego

2) Główne założenia produktowe 

1. Wgrywanie: użytkownik wrzuca paczkę plików DWG/PDF – pliki wektorowe (rzuty, przekroje, elewacje, opisy, legendy; możliwe podkłady i XREFy).
2. Automatyczne przetwarzanie: system parsuje pliki, normalizuje warstwy, jednostki i skale, łączenie i fuzja rysunków w spójny model referencyjny.
3. AI rozpoznaje elementy: rozpoznaje wszystkie elmenty na projektach
4. Obmiar: wylicza ilości wg reguł pomiarowych (długości, powierzchnie, objętości, sztuki); uwzględnia otwory, grubości, warstwy – obmiary według reguł globalnych
5. Weryfikacja: tabelaryczny wynik + podgląd 2D/3D z podświetleniem policzonych elementów; tryb "porównaj/wyjaśnij" niejasności (konflikty między arkuszami, brak wymiarów, niespójne skale).
6. Korekta ręczna: edytowalne klasyfikacje i geometrii (rysowanie/edycja polilinii/otworów), akceptacja/odrzucanie elementów.
7. Ceny i kosztorys: przypinanie pozycji cenowych i stawek (cena jednostkowa, narzuty, VAT), eksport CSV/XLSX/BC3/PDF.
8. Audyt i wersjonowanie: historia zmian, porównanie obmiarów, różnice między wersjami dokumentacji

3) Przepływ użytkownika 

1. Nowy projekt → nazwa, inwestor, lokalizacja, domyślne jednostki i waluty
2. Wgrywanie plików → drag&drop, kontrola spójności
3. Przetwarzanie → parsing, normalizacja, fuzja, AI klasyfikacja, obmiar.
4. Przegląd → tabele + widok 2D/3D; panel niejasności; filtry (branża, kondygnacja, warstwa, typ).
5. Korekta → edytor geometrii, zmiana klasy, łączenie/dzielenie elementów, akceptacja.
6. Ceny → przypisanie pozycji, stawki, narzuty.
7. Eksport/raport → XLSX/CSV/BC3, PDF zestawienia, raport niejasności.

5) Wymagania funkcjonalne (szczegółowe)

5.1 Import i walidacja plików

• Obsługa: pliki wektorowe: DWG, DXF (opcjonalnie), wektorowy PDF
• Automatyczne wykrycie skali: z viewportów (DWG), z tytułowej ramki (OCR), z oznaczeń (np. 1:100), z wymiarów (DIMSTYLE / rozpoznanie tekstu wymiarowego).
• Normalizacja jednostek (mm/m) i układu odniesienia (przesunięcia, rotacje, układy lokalne, UCS).
• Wykrycie braków i błędów

5.2 Fuzja dokumentacji (łączenie w całość)

• Grupowanie arkuszy: kondygnacje, przekroje, elewacje, branże.
• Rejestrowanie i wyrównanie rzutów/sekcji (dopasowanie znaczników osi, siatki, poziomów; łączna transformacja 2D/3D).
• Łączenie architektury z konstrukcją

5.3 Rozpoznanie elementów (AI + reguły)

Wymóg: Rozpoznanie elementów nie może opierać się wyłącznie na nazwach warstw. Nazwy warstw traktujemy wyłącznie jako sygnał pomocniczy o niskiej wadze.

Zasady implementacyjne:

• Decyzje klasyfikacyjne bazują przede wszystkim na geometrii i topologii – na podstawie uczenia maszynowego
• W przypadku sprzeczności informacji: priorytet: DIM/wymiary > jednoznaczny opis tekstowy > legenda/schemat > cechy geometryczne > nazwa warstwy.
• System musi działać przy dowolnym/niestandardowym nazewnictwie warstw (różne języki, skróty, brak standardu). Dla testów możliwa jest całkowita anonimizacja nazw warstw.
• Komponent AI/reguł powinien umożliwiać wyłączenie wpływu warstw (feature flag) – wynik nadal musi być poprawny.

5.4 Obmiar  - obmiar na podstawie przyjętych reguł i rozpoznania elementów

5.5 Weryfikacja i edycja

• Widok 2D (rzut, przekrój) i 3D (prosty ekstrudowany model) z podświetleniem policzonych elementów.
• Tryb sprawdzania: kliknięcie elementu → szczegóły obmiaru + źródła (arkusze, opisy), tolerancja/niepewność.
• Narzędzia edycji: rysowanie/edycja polilinii, przesuwanie/skalowanie, zmiana klasy, łączenie/dzielenie.
• Lista niejasności: pytania do użytkownika, proponowane rozwiązania, akceptacja/odrzucenie.

5.6 Ceny i kosztorys

• Słowniki cen/pozycje: baza pozycji- globalna ( dla systemu i lokalna dla użytkownika – użytkownik może zmienić lokalną cenę)
• Mapowanie: typ elementu → formuła → pozycja cenowa.
• Formuły: cena = ilość × stawka ± narzuty (robocizna, materiał, sprzęt, zysk, koszty ogólne, VAT).
• Wersjonowanie cenników, waluty, indeksacja cen (inflacja).
• Eksport: XLSX/ (Kosztorys), PDF zestawienia.

5.7 Eksporty i integracje

• XLSX/CSV/BC3, PDF raporty (zrzuty ekranu wizualizacji + tabele).

6) Wymagania niefunkcjonalne

• Dokładność obmiaru: błąd geometryczny ≤ ±2 mm przy poprawnych skalach;
• Wydajność: projekt do 200 arkuszy/2 GB – pełne przetwarzanie ≤ 20 min; rzut do podglądu ≤ 3 s.
• Skalowalność: pozioma (kolejki zadań), storage na pliki do 10 GB/projekt.
• Bezpieczeństwo: RODO/GDPR, szyfrowanie at-rest i in-transit, IAM, audit log, WAF, backupy.
• Niezawodność: SLO przetwarzania 99.5%/msc; retry/kompensacje, wersjonowanie modeli.

8) Pipeline przetwarzania (kroki techniczne)

1. Upload & walidacja → AV scan, ekstrakcja metadanych, wykrycie XREF.
2. Parsing:
   • DWG/DXF: odczyt warstw, block references, geometrii, DIMSTYLE, viewport scale, Model/Paper Space.
   • PDF (wektor): ścieżki, polilinie, teksty (TrueType), warstwy; OCR tylko dla tekstów wektorowych jako fallback.
3. Normalizacja skali i jednostek: z viewportów i tytułów; automatyczne dopasowanie; flagi w razie konfliktów.
4. Rejestracja arkuszy: dopasowanie osi/siatek/znaczników (ICP/feature matching na wektorach), transformacje 2D/3D.
5. Ekstrakcja obiektów semantycznych:
   • Reguły warstw (np. A-WALL, K-…); szablony nazw; klasyfikacja słownikowa.
   • AI na grafie wektorowym: polilinie → ściany (równoległe linie), hatch → wypełnienia/posadzki, bloki → wyposażenie.
   • Teksty i legendy → parsowanie parametrów (grubości, materiały, typy, numery pomieszczeń).
6. Fuzja: konflikt resolution (arch vs const), hierarchia wiarygodności (DIM > opis > legenda > warstwa), śledzenie pochodzenia danych (provenance).
7. Obmiar: reguły, jednostki, odjęcia otworów, agregacje po kondygnacjach/pomieszczeniach.
8. Detekcja niejasności: brakujące parametry, niespójne skale, sprzeczne grubości – generowanie pytań.
9. Wizualizacja: generacja podkładów, overlay obiektów, uproszczony 3D (ekstruzja wg wysokości kondygnacji).
10. Kosztorys: mapowanie element→pozycja, formuły, narzuty, eksport.

9) Model AI i uczenie

• Reprezentacja: graf wektorowy (węzły: wierzchołki geometrii i bloki; krawędzie: segmenty/polilinie; atrybuty: layer, typ, styl linii, teksty pobliskie), dodatkowo rasteryzacja poglądowa dla cech kontekstowych.
• Architektura: Graph Neural Network (GAT/GraphSAGE) + Transformer na sekwencjach wektorów; late fusion z regułami i heurystykami CAD.
• Dane treningowe: zakotwiczenie w rzeczywistych DWG (anotacja półautomatyczna) + syntetyczne generatory rysunków; aktywne uczenie z interakcji użytkownika (feedback w UI).
• OCR/NLP: rozpoznanie opisów, tabel, legend; normalizacja jednostek (mm/m), parsowanie wyrażeń (np. „ściana 24 cm, tynk gipsowy 1,5 cm”).
• Metryki: mAP/F1 dla klas, MAE/SMAPE dla ilości, czas przetwarzania.
• MLOps: rejestr modeli, wersjonowanie datasetów, walidacje, A/B w tle per projekt.

10) Reguły obmiaru – szczegół (przykłady konfigurowalne)

• Ściany:
  • Długość z osi ściany; Wysokość: z przekrojów / domyślna z kondygnacji; Grubość: z opisu/warstwy.
  • Pow. tynku = 2 × (dł. × wys.) – odjęcia otworów > t_odjęcia; reguły progów (np. nie odejmujemy < 0,5 m²).
• Otwory: Szer., wys. z wymiarów/oznaczeń; liczba szt.; pow. w świetle.
• Stropy/płyty: Pow. z konturu; objętość = pow. × grubość; obwód (deskowanie).
• Schody: Ilość biegu, pow. stopni (antypoślizgi), policzki (mb), balustrady (mb).
• Posadzki/okładziny: Pow. netto po odjęciach; cokoły (mb wzdłuż ścian).
• Instalacje: Długości tras po osi; fitingi – reguły detekcji z bloków/słownika symboli.

Każda reguła ma: definicję ilości, źródła danych, formułę, tolerancję i priorytet.

11) UI/UX – kluczowe ekrany

• Dashboard projektów: statusy przetwarzania, ostatnie obmiary.
• Przegląd dokumentacji: lista arkuszy (miniatury), warstwy, filtry.
• Widok weryfikacji: płótno 2D/3D z nakładką; legendy kolorów dla klas; panel szczegółów elementu.
• Tabela obmiaru: grupowanie po branży/kondygnacji/pomieszczeniu/typie; in-line edit; śledzenie zmian.
• Panel niejasności: pytania, propozycje rozwiązań, akceptacja.
• Cenniki i mapowanie: przegląd pozycji, formuły, podgląd wpływu na koszt.
• Eksporty: kreator wyboru zakresu i formatu.