Instrukcja Obsługi

HUBAL v3.0

Kompletny przewodnik po systemie zarządzania projektami z wizualizacją 3D, narzędziami szkicowania, harmonogramami i funkcjami współpracy zespołowej.

1. Wprowadzenie

Witaj w HUBAL v3.0 - zaawansowanym systemie zarządzania projektami z wizualizacją 3D, który rewolucjonizuje sposób pracy nad projektami. HUBAL łączy w sobie funkcjonalności zarządzania projektami, narzędzia szkicowania, obsługę dokumentów technicznych oraz współpracę zespołową w jednej platformie.

Kluczowe funkcjonalności

  • 🎨 Płótno 3D z narzędziami szkicowania: Interaktywne środowisko do wizualizacji projektów z obsługą plików DXF, PDF, dokumentów Office
  • 📅 Harmonogramy Gantt: Zaawansowane planowanie zadań z zależnościami, wyzwalaczami i opcjami decyzyjnymi
  • 🤖 AI Assistant: Inteligentny asystent wykorzystujący Gemini do analizy projektów i automatyzacji
  • 👥 Współpraca zespołowa: Udostępnianie ramek, system komentarzy, zarządzanie użytkownikami
  • 📝 System notatek: Elastyczne zarządzanie notatkami z katalogami i udostępnianiem
  • 🔒 Bezpieczeństwo: Obszary poufne, kontrola dostępu, zgodność z RODO

Dla kogo jest HUBAL?

HUBAL został zaprojektowany dla zespołów projektowych, architektów, inżynierów oraz menedżerów projektów, którzy potrzebują zaawansowanych narzędzi do wizualizacji, planowania i współpracy nad złożonymi projektami.

2. Pierwsze kroki

Logowanie do systemu

HUBAL wykorzystuje system autoryzacji Firebase. Po przejściu na stronę aplikacji zostaniesz przekierowany do formularza logowania, gdzie należy podać swój adres email i hasło.

Funkcje logowania:

  • Pokazywanie/ukrywanie hasła: Kliknij ikonę oka obok pola hasła
  • Zapomniałem hasła: Link do resetowania hasła
  • Automatyczne przekierowanie: Po zalogowaniu zostaniesz przekierowany do głównej aplikacji

Wybór języka

HUBAL obsługuje wielojęzyczność. W prawym górnym rogu interfejsu znajdziesz selektor języka, który umożliwia przełączanie między polskim a angielskim.

Tryb jasny/ciemny

Aplikacja automatycznie dostosowuje się do preferencji systemowych dotyczących motywu. Możesz również ręcznie przełączać między trybem jasnym a ciemnym za pomocą przycisku w górnym pasku.

3. Interfejs główny

Główna aplikacja HUBAL składa się z dwóch głównych widoków: panelu zarządzania projektami oraz płótna projektowego. Każdy projekt może mieć przypisane płótno 3D z obiektami wizualnymi.

Panel zarządzania projektami (index.html)

  • Pasek narzędzi (górny prawy róg): Dostęp do urlopów, zmiany hasła, analiz Gemini, zarządzania użytkownikami, generowania raportów
  • Zadania na dziś: Lista zadań przeterminowanych i zaplanowanych na bieżący dzień z możliwością szybkiego oznaczania jako wykonane
  • Punkty gotowe do aktywacji: Wyzwalacze w okresie aktywacji z przyciskami do natychmiastowego uruchomienia
  • Obszar roboczy notatek: Centrum zarządzania notatkami z funkcją przeciągania i upuszczania
  • Wykres Gantta: Interaktywna wizualizacja harmonogramów z funkcjami filtrowania i nawigacji

Ikona płótna projektowego

Przy każdym projekcie znajduje się ikona płótna. Pomarańczowa ikona oznacza, że projekt ma obiekty na płótnie 3D. Szara ikona oznacza puste płótno. Kliknięcie ikony otwiera płótno projektowe w nowej karcie.

4. Płótno projektowe

Płótno projektowe to zaawansowane środowisko 3D wykorzystujące bibliotekę Three.js. Umożliwia wizualizację projektów, szkicowanie, umieszczanie dokumentów i planowanie harmonogramów.

4.1 Nawigacja 3D

Kontrola kamery (OrbitControls)

  • Obrót: Lewy przycisk myszy + przeciąganie
  • Panoramowanie: Prawy przycisk myszy + przeciąganie
  • Powiększanie/pomniejszanie: Kółko myszy lub środkowy przycisk + przeciąganie
  • Automatyczne obracanie: Włączane/wyłączane w ustawieniach

Zapisywanie widoków

Możesz zapisywać ulubione pozycje kamery jako "Zapisane widoki". W prawym panelu kliknij "Zapisz widok", podaj nazwę, a pozycja kamery zostanie zapamiętana do przyszłego użytku.

4.2 Narzędzia szkicowania

Lewy toolbar zawiera kompletny zestaw narzędzi do szkicowania i rysowania bezpośrednio na płótnie 3D.

Podstawowe narzędzia

  • 🎯 Wybierz (V): Zaznaczanie i przesuwanie obiektów
  • 🗑️ Delete: Usuwanie zaznaczonych obiektów
  • 📁 Add file: Upload plików (obrazy, PDF, DXF, dokumenty Office)

Narzędzia rysowania

  • ✏️ Pencil: Rysowanie odręczne liniami
  • 🧽 Eraser: Gumka do usuwania narysowanych elementów
  • 📝 Text: Dodawanie etykiet tekstowych
  • ▭ Rectangle: Rysowanie prostokątów
  • 💭 Annotation: Dodawanie adnotacji z wskazówkami

Kontrola rysowania

Po wybraniu narzędzia rysowania pojawia się panel kontroli z opcjami:

  • Color: Selektor kolorów (obsługa hex, RGB, HSL)
  • Thickness: Grubość linii (1-10 pikseli)
  • Eraser Size: Rozmiar gumki (10-100 pikseli)
  • Font Size: Rozmiar tekstu (12-48 pikseli)

4.3 Planer harmonogramów

Unikalną funkcją HUBAL jest możliwość tworzenia harmonogramów bezpośrednio na płótnie 3D, a następnie eksportowania ich do systemu zarządzania projektami.

Elementy planera

  • 📋 Project: Główny kontener projektu
  • 🎯 Phase: Faza projektu grupująca zadania
  • ✅ Task: Podstawowe zadanie
  • 📝 Subtask: Podzadanie
  • ⏸️ Delay: Opóźnienie w harmonogramie
  • 🎬 Trigger: Wyzwalacz uruchamiający inne zadania
  • 🔀 Decision Point: Punkt decyzyjny z opcjami

Tworzenie harmonogramów

  1. Rozwiń sekcję "Planner" w lewym toolbarze
  2. Przeciągnij wybrane elementy na płótno
  3. Połącz elementy liniami zależności
  4. Kliknij prawym przyciskiem na strukturę, aby wyeksportować do harmonogramu
  5. Wybierz opcje importu i datę rozpoczęcia

Opcje eksportu

  • Zastąp istniejące wydarzenie: Podmiana konkretnego zadania
  • Dodaj po istniejącym wydarzeniu: Wstawienie po wybranym zadaniu
  • Dodaj jako pierwsze wydarzenie: Na początku projektu
  • Zapisz jako szablon: Do ponownego użycia
  • Zastąp cały harmonogram: Całkowita podmiana (uwaga na utratę danych!)

4.4 Udostępnianie

HUBAL umożliwia współpracę zespołową poprzez system udostępniania ramek płótna.

Ramki współpracy

Kliknij przycisk "Share" w sekcji Sharing, aby utworzyć ramkę współpracy. Ramka może być udostępniona konkretnym użytkownikom lub zespołom, umożliwiając im dostęp do określonej części płótna.

Możliwości udostępniania:

  • Wybór konkretnych użytkowników
  • Udostępnianie całym zespołom
  • Kontrola uprawnień (tylko odczyt / edycja)
  • Czasowe ograniczenia dostępu

5. Zarządzanie plikami

HUBAL obsługuje szeroką gamę formatów plików i oferuje zaawansowane możliwości ich przetwarzania.

5.1 Upload plików

Obsługiwane formaty:

  • Obrazy: PNG, JPG, JPEG, GIF, WebP
  • Dokumenty PDF: Z możliwością wyboru konkretnych stron
  • Pliki CAD: DXF z pełnym parserem geometrii
  • Dokumenty Office: DOC, DOCX, XLS, XLSX, PPT, PPTX

Sposoby dodawania plików

  1. Przycisk "Add file": W lewym toolbarze
  2. Przeciągnij i upuść: Bezpośrednio na płótno
  3. Biblioteka obiektów: W prawym panelu

Przechowywanie plików

HUBAL oferuje dwa systemy przechowywania plików:

  • Firebase Storage: Domyślne przechowywanie w chmurze Google
  • Google Drive: Integracja z Google Drive organizacji (wymaga konfiguracji OAuth)

5.2 Pliki DXF/CAD

HUBAL posiada zaawansowany parser plików DXF, który pozwala na import i wyświetlanie rysunków technicznych bezpośrednio na płótnie 3D.

Obsługiwane elementy DXF

  • Linie i polilinie
  • Łuki i okręgi
  • Teksty i wymiary
  • Warstwy (layers)
  • Bloki i wstawki
  • Hatching (kreskowanie)

Manipulacja obiektów DXF

Po zaimportowaniu pliku DXF, jego elementy stają się pełnoprawnymi obiektami 3D, które można skalować, obracać i przemieszczać w przestrzeni.

5.3 PDF i dokumenty Office

Dokumenty PDF i Office są automatycznie konwertowane na podglądy graficzne i mogą być wyświetlane jako warstwy na płótnie.

Import stron PDF

Przy importowaniu PDF pojawia się modal z opcjami:

  • Importuj wszystkie strony: Wszystkie strony jako oddzielne obiekty
  • Importuj zakres: Wybrane strony (np. "1-3, 5, 7")
  • Nawigacja stron: Kontrolki do przeglądania stron w podglądzie

Dokumenty Office

Dokumenty Word, Excel i PowerPoint są automatycznie konwertowane na podglądy graficzne. System wykorzystuje biblioteki Mammoth.js i inne parsery do ekstrakcji treści.

OCR i ekstrakcja tekstu

HUBAL posiada zintegrowany system OCR (Tesseract.js), który automatycznie rozpoznaje tekst w obrazach i dokumentach, umożliwiając AI Assistantowi analizę zawartości.

6. Harmonogramy i Gantt

System harmonogramów w HUBAL oferuje zaawansowane funkcjonalności planowania projektów z interaktywnym wykresem Gantta.

Tworzenie i edycja projektów

  1. Kliknij przycisk "+ Nowy projekt"
  2. Podaj nazwę projektu
  3. Dodaj kamienie milowe (opcjonalnie)
  4. Skonfiguruj obszar poufny (jeśli potrzebny)

Typy zadań

  • 📋 Standardowe zadanie: Z datą początkową, końcową i przypisaną osobą
  • 🎬 Wyzwalacz (Trigger): Bez czasu trwania, uruchamia inne zadania
  • 📊 Zadanie szacunkowe: Z rejestracją historii zmian dat
  • ⏸️ Opóźnienie: Buffer czasowy w harmonogramie
  • 🔀 Punkt decyzyjny: Rozgałęzienie harmonogramu

Zależności między zadaniami

Zadania mogą być powiązane zależnościami, które automatycznie aktualizują daty:

  • Po zakończeniu: Zadanie rozpoczyna się X dni po zakończeniu zadania nadrzędnego
  • Przed rozpoczęciem: Zadanie rozpoczyna się X dni przed rozpoczęciem zadania nadrzędnego
  • Przesunięcie: Liczba dni roboczych przerwy między zadaniami

Wykres Gantta

Nawigacja:

  • Przewijanie: Pasek na dole lub kółko myszy
  • Zoom: Ctrl + kółko myszy
  • Filtry: Wyświetlanie zadań konkretnych użytkowników
  • Historia: Widok poprzednich wersji harmonogramu

Elementy wykresu

  • Paski zadań: Kolor odpowiada przypisanej osobie
  • Strzałki zależności: Liniami ciągłymi lub przerywanymi
  • Kamienie milowe: Romby, kwadraty lub koła
  • Paski podsumowania: Kolorowe segmenty dla zadań złożonych

7. System notatek

HUBAL oferuje elastyczny system zarządzania notatkami działający jak wirtualna tablica korkowa.

Tworzenie i interakcja

  • Tworzenie: "+ Utwórz notatkę"
  • Przesuwanie: Kliknij i przeciągnij (nie na krawędzi)
  • Zmiana rozmiaru: Przeciągnij prawy dolny róg
  • Edycja: Podwójne kliknięcie na tekst
  • Usuwanie: Ikona kosza po najechaniu

Organizacja w katalogi

Notatki można organizować w katalogi dla lepszego porządku:

  1. Najedź na notatkę i kliknij ikonę "Przenieś do katalogu"
  2. Wybierz istniejący katalog lub utwórz nowy
  3. Notatka zostanie przeniesiona do katalogu
  4. Dostęp do katalogów przez górny pasek nawigacji
  5. Przywracanie do "otwartych" przez ikonę domku

Udostępnianie notatek

Notatki można udostępniać innym użytkownikom lub całym grupom. Kliknij ikonę udostępniania i wybierz adresatów.

8. AI Assistant

HUBAL zintegrowany jest z AI Assistant wykorzystującym Google Gemini do analizy projektów i automatyzacji zadań.

Funkcje AI Assistant

  • 🔍 Analiza projektów: Odpowiada na pytania o stan projektów, obłożenie zadaniami, opóźnienia
  • 📊 Raporty automatyczne: Generuje raporty dzienne i przekształca je w wiadomości email
  • 📄 Analiza dokumentów: Rozpoznaje tekst w obrazach i dokumentach (OCR)
  • 🎯 Manipulacja płótna: Może tworzyć i modyfikować obiekty na płótnie na podstawie poleceń
  • 💡 Optymalizacja harmonogramów: Sugeruje poprawki i ulepszenia

Aktywacja AI Assistant

AI Assistant można aktywować na dwa sposoby:

  • Przycisk "AI": W górnym pasku aplikacji
  • Kontekstowo: Automatycznie pojawia się przy analizie dokumentów i raportach

Przykłady zastosowań

  • "Kto ma najwięcej zadań w tym tygodniu?"
  • "Które zadania są opóźnione i o ile?"
  • "Wygeneruj raport postępów dla projektu X"
  • "Zaproponuj optymalizację harmonogramu"
  • "Przeanalizuj ten dokument i wyciągnij kluczowe informacje"

Prywatność i bezpieczeństwo

AI Assistant respektuje ustawienia prywatności i nie przetwarza danych z obszarów poufnych bez odpowiednich uprawnień. Wszystkie interakcje są szyfrowane i zgodne z polityką RODO.

9. Współpraca zespołowa

HUBAL został zaprojektowany z myślą o pracy zespołowej i oferuje zaawansowane narzędzia współpracy.

Zarządzanie użytkownikami i grupami

  • Grupy robocze: Organizacja użytkowników w zespoły
  • Kolory użytkowników: Wizualne rozróżnianie na wykresach
  • Uprawnienia granularne: Szczegółowa kontrola dostępu
  • Obszary poufne: Projekty widoczne tylko dla wybranych osób

Udostępnianie i komentowanie

Wszystkie elementy systemu (projekty, notatki, ramki płótna) można udostępniać z kontrolą uprawnień odczytu i edycji.

Powiadomienia

System powiadomień informuje o:

  • Przypisanych nowych zadaniach
  • Zbliżających się deadline'ach
  • Zmianach w udostępnionych projektach
  • Komentarzach i aktualizacjach

Integracje zewnętrzne

  • Google Drive: Synchronizacja plików
  • Telegram: Powiadomienia na komunikator
  • Email: Automatyczne raporty i powiadomienia

10. Administracja

Panel administratora dostępny dla użytkowników z odpowiednimi uprawnieniami.

Zarządzanie użytkownikami

  • Dodawanie użytkowników: Tworzenie nowych kont
  • Edycja profili: Zmiana nazw, kolorów, grup
  • Zarządzanie uprawnieniami: Szczegółowa kontrola dostępu
  • Grupy poufne: Tworzenie grup o ograniczonym dostępie

Zarządzanie urlopami

Administratorzy i managerowie mogą przeglądać, akceptować i odrzucać wnioski urlopowe członków swoich zespołów.

Monitoring systemu

  • Logi aktywności użytkowników
  • Statystyki wykorzystania
  • Monitoring wydajności
  • Kopie zapasowe danych

11. Wersja mobilna

HUBAL jest w pełni responsywny i dostosowuje interfejs do urządzeń mobilnych.

Adaptacje mobilne

  • Uproszczony interfejs: Zoptymalizowany pod dotyk
  • Składane menu: Oszczędzność miejsca na ekranie
  • Listy zamiast wykresów: Alternatywa dla Gantta
  • Dotykowe gesty: Przeciąganie, powiększanie, przewijanie

Ograniczenia mobilne

Ze względu na ograniczenia przestrzeni ekranu, niektóre funkcje są niedostępne lub ograniczone na urządzeniach mobilnych:

  • Płótno 3D (wymaga klawiatury i myszy)
  • Zaawansowane narzędzia szkicowania
  • Kompleksowy widok Gantta
  • Przeciąganie i upuszczanie notatek

12. Funkcje zaawansowane

Import/Export danych

  • Export harmonogramów: PDF, Excel, JSON
  • Import z zewnętrznych systemów: MS Project, CSV
  • Szablony projektów: Zapisywanie i ponowne użycie struktur
  • Synchronizacja: Automatyczne kopie zapasowe

Integracja z API

HUBAL oferuje REST API do integracji z zewnętrznymi systemami:

  • Endpoints dla projektów i zadań
  • Webhooks dla powiadomień
  • OAuth 2.0 dla autoryzacji
  • Rate limiting i throttling

Konfiguracja zaawansowana

  • Zmienne środowiskowe: Konfiguracja Firebase, Google API
  • Ustawienia organizacji: Domyślne storage, integracje
  • Polityki bezpieczeństwa: Firewall rules, CORS
  • Optymalizacje wydajności: Cache'owanie, CDN

Wskazówki optymalizacji

  • Używaj zależności zadań: Automatyczne aktualizacje harmonogramów
  • Organizuj notatki w katalogi: Lepszy porządek i szybszy dostęp
  • Wykorzystuj AI Assistant: Automatyzacja raportów i analiz
  • Regularne kopie zapasowe: Eksport danych i szablonów
  • Optymalizacja plików: Kompresja obrazów, segmentacja PDF