Konfiguracja środowiska deweloperskiego

Monorepozytorium Speedwave łączy backend w języku Rust, interfejs graficzny Angular osadzony w środowisku Tauri, serwery MCP w Node.js oraz pomocnicze biblioteki w języku Swift. Wszystkie procedury inżynieryjne są zunifikowane w pliku Makefile. Szczegółowy opis architektury znajdziesz na stronie Stos technologiczny.

Wymagania wstępne

Przed rozpoczęciem upewnij się, że stacja robocza posiada zainstalowane następujące pakiety:

Rust: Stabilny toolchain zarządzany przez rustup (rustup update stable).
Node.js: Wersja LTS (v20 lub nowsza) wraz z menedżerem npm.
Kompilatory platformowe:
- macOS: Narzędzia Xcode Command Line Tools (xcode-select --install).
- Windows: Visual Studio C++ Build Tools wraz z pakietem Windows SDK.

Zainicjalizuj środowisko i pobierz wymagane zależności poleceniem:

make setup-dev

Podstawowe cele pliku Makefile

Zaleca się wywoływanie wszystkich poleceń przez make, co gwarantuje poprawne ustawienie katalogów roboczych i flag kompilatorów:

make setup-dev      # Weryfikacja wymagań i instalacja zależności
make test           # Uruchomienie testów jednostkowych (Rust, Angular, MCP, Tauri)
make check          # Statyczna analiza kodu: lintery, Clippy, sprawdzanie typów
make check-all       # Pełna bramka jakości CI: check + test + coverage + audit
make coverage-html   # Generowanie raportów pokrycia kodu i otwarcie w przeglądarce
make audit           # Audyt bezpieczeństwa zależności w repozytorium
make dev             # Uruchomienie aplikacji Tauri w trybie live-reload
make build           # Kompilacja wersji produkcyjnej wszystkich podsystemów
make fmt             # Formatowanie plików źródłowych (Rust, TypeScript, Markdown)
make status          # Diagnostyka stanu środowiska i wersji zależności

Dostępne są także cele cząstkowe: test-rust, test-angular, test-mcp, test-swift, build-cli, build-desktop oraz build-angular. Progi pokrycia kodu opisano w sekcji Testowanie i weryfikacja.

Warianty kompilacji CLI

make build-cli: Tworzy nieoptymalizowany plik wykonywalny debug w target/debug/speedwave wykorzystywany przez make dev.
make build-cli-release: Kompiluje zoptymalizowaną binarkę produkcyjną w target/release/speedwave, usuwając deweloperskie flagi omijania podpisów.

Uruchamianie w trybie deweloperskim

Polecenie make dev automatycznie kompiluje wersję debug pliku CLI, kopiuje plik wykonywalny do desktop/src-tauri/cli/ i uruchamia demona Tauri wraz z lokalnym serwerem Angulara.

Szczegółowe wytyczne dla systemu Windows opisano na stronie Konfiguracja środowiska na Windows.