Development Workflow

Skrót codziennego workflow developerskiego dla Vista: setup, start, testy i bramki jakości.

Development Workflow Stable

Na tej stronie

Setup (skrót)
Start pracy
Testy
Jakość i manifesty
Hooki i pre-push
DB i dane
Częste problemy
AI Playground
Następne kroki

Setup (skrót)

Wymaganie	Wersja
Node	20+ (zalecany 22)
pnpm	10.14+
Rust	via rustup

pnpm install
cp src-tauri/.env.example src-tauri/.env && pnpm env:verify

Start pracy

Tryb	Komenda	Opis
FE only	`pnpm dev`	Vite
Pełna aplikacja	`pnpm tauri:dev`	Tauri + Vite
Playground AI	`pnpm ai:playground`	Bez Tauri
Playground AI + Tauri	`pnpm ai:playground:with-tauri`	Z Tauri
Reset DB	`node scripts/reset-vista-db.mjs reset`	Szybki reset

Testy

Unit testy

pnpm test           # Run
pnpm test:watch     # Watch mode

E2E (Playwright)

pnpm test:playwright         # Preview
pnpm test:playwright:headed  # Headed
pnpm test:playwright:ui      # UI mode

Specjalizowane

Komenda	Opis
`pnpm test:translations`	Tłumaczenia (lub `:structure`)
`pnpm test:ai`	Testy AI
`pnpm test:auth`	Testy auth
`pnpm test:patients`	Testy patients

Jakość i manifesty

pnpm ci:pr-quality:local    # Lint/format/tsc/semgrep
pnpm manifest:ensure        # Manifesty (+ warianty :tauri, :docs)

Hooki i pre-push

Husky (pre-commit)

Manifest guards
lint:filelimits/linebudget
Semgrep (staged)
Prettier check
ESLint fix (czasem)

Pre-push gate

Clippy
TSC
Loctree (circular/contract)
Cargo checks

DB i dane

Operacja	Komenda
Reset	`node scripts/reset-vista-db.mjs reset`
Backup	`node scripts/reset-vista-db.mjs backup`
Restore	`node scripts/reset-vista-db.mjs restore`
Info	`node scripts/reset-vista-db.mjs info`

Lokalizacja DB

Platform	Ścieżka
macOS	`~/Library/Application Support/Vista/vista.db`
Windows	`%APPDATA%/Vista/vista.db`
Linux	`~/.local/share/Vista/vista.db`

Częste problemy

Problem	Rozwiązanie
Brak zależności Playwright	`pnpm exec playwright install --with-deps`
Nieprawidłowa wersja Node	`pnpm env:verify` / `pnpm run preflight:node`
Manifest diff po rebazie	`pnpm manifest:ensure` i dodaj do stage

AI Playground

AI Playground to izolowane środowisko symulacyjne działające w przeglądarce (bez Tauri backend), do testowania interfejsu Vista Assistant i pipeline’ów audio.

Uruchomienie

pnpm ai:playground

Otwiera Vite dev server na porcie 4300: http://localhost:4300

Architektura

Playground działa w trybie “Browser Sandbox” ale łączy się z prawdziwym AI API (Libraxis Gateway).

Komponent	Rola
tauriMocks.ts	Przechwytuje `invoke`, wykonuje HTTP do API przez proxy
eventBridge.ts	In-memory event bus dla streaming tokenów
llmAdapter.ts	HTTP/SSE transport, endpointy z `.env`

Konfiguracja

Playground używa zmiennych z src-tauri/.env:

LIBRAXIS_API_KEY=your-key
AI_CHAT_PRIMARY_ENDPOINT=https://api.libraxis.cloud/llm/v1/responses
AI_CHAT_PRIMARY_MODEL=chat

Troubleshooting

Problem	Rozwiązanie
401 Unauthorized	Sprawdź `LIBRAXIS_API_KEY`
400 Bad Request	Upewnij się że endpoint wspiera format “Responses”
No Streaming	Sprawdź console dla “Stream request failed”

Następne kroki

Deployment - budowanie i release
Troubleshooting - rozwiązywanie problemów