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
- Wgrywanie: użytkownik wrzuca paczkę plików DWG/PDF – pliki wektorowe (rzuty, przekroje, elewacje, opisy, legendy; możliwe podkłady i XREFy).
- Automatyczne przetwarzanie: system parsuje pliki, normalizuje warstwy, jednostki i skale, łączenie i fuzja rysunków w spójny model referencyjny.
- AI rozpoznaje elementy: rozpoznaje wszystkie elmenty na projektach
- 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
- 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).
- Korekta ręczna: edytowalne klasyfikacje i geometrii (rysowanie/edycja polilinii/otworów), akceptacja/odrzucanie elementów.
- Ceny i kosztorys: przypinanie pozycji cenowych i stawek (cena jednostkowa, narzuty, VAT), eksport CSV/XLSX/BC3/PDF.
- Audyt i wersjonowanie: historia zmian, porównanie obmiarów, różnice między wersjami dokumentacji
3) Przepływ użytkownika
- Nowy projekt → nazwa, inwestor, lokalizacja, domyślne jednostki i waluty
- Wgrywanie plików → drag&drop, kontrola spójności
- Przetwarzanie → parsing, normalizacja, fuzja, AI klasyfikacja, obmiar.
- Przegląd → tabele + widok 2D/3D; panel niejasności; filtry (branża, kondygnacja, warstwa, typ).
- Korekta → edytor geometrii, zmiana klasy, łączenie/dzielenie elementów, akceptacja.
- Ceny → przypisanie pozycji, stawki, narzuty.
- 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)
- Upload & walidacja → AV scan, ekstrakcja metadanych, wykrycie XREF.
- 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.
- Normalizacja skali i jednostek: z viewportów i tytułów; automatyczne dopasowanie; flagi w razie konfliktów.
- Rejestracja arkuszy: dopasowanie osi/siatek/znaczników (ICP/feature matching na wektorach), transformacje 2D/3D.
- 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ń).
- Fuzja: konflikt resolution (arch vs const), hierarchia wiarygodności (DIM > opis > legenda > warstwa), śledzenie pochodzenia danych (provenance).
- Obmiar: reguły, jednostki, odjęcia otworów, agregacje po kondygnacjach/pomieszczeniach.
- Detekcja niejasności: brakujące parametry, niespójne skale, sprzeczne grubości – generowanie pytań.
- Wizualizacja: generacja podkładów, overlay obiektów, uproszczony 3D (ekstruzja wg wysokości kondygnacji).
- 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.
