Files
knur-app/README.md

42 lines
1.6 KiB
Markdown
Raw Normal View History

2026-06-16 09:43:48 +02:00
# Knur
2026-06-15 13:04:53 +02:00
2026-06-16 09:43:48 +02:00
Aplikacja do analizy treningów biegowych (Garmin Connect) i siłowych (import ze Strong), z analizą AI (Claude).
2026-06-15 13:04:53 +02:00
2026-06-16 09:43:48 +02:00
## Wymagania
2026-06-15 13:04:53 +02:00
2026-06-16 09:43:48 +02:00
- Node 22 (`nvm use 22`)
- pnpm
- MongoDB (lokalnie lub Atlas)
2026-06-15 13:04:53 +02:00
2026-06-16 09:43:48 +02:00
## Konfiguracja
2026-06-15 13:04:53 +02:00
2026-06-16 09:43:48 +02:00
Skopiuj `.env.local.example` do `.env.local` i wypełnij wartości:
2026-06-15 13:04:53 +02:00
2026-06-16 09:43:48 +02:00
```bash
cp .env.local.example .env.local
```
2026-06-15 13:04:53 +02:00
2026-06-16 09:43:48 +02:00
- `MONGODB_URI`, `MONGODB_DB` — połączenie z MongoDB (domyślnie `mongodb://localhost:27017`, baza `knur`).
- `GARMIN_EMAIL`, `GARMIN_PASSWORD` — dane logowania do Garmin Connect, używane do synchronizacji biegów (nieoficjalne API).
- `ANTHROPIC_API_KEY`, `ANTHROPIC_MODEL` — klucz API Claude i model używany do generowania analiz potreningowych (domyślnie `claude-sonnet-4-6`).
2026-06-15 13:04:53 +02:00
2026-06-16 09:43:48 +02:00
Status konfiguracji widoczny jest na stronie `/settings`.
2026-06-15 13:04:53 +02:00
2026-06-16 09:43:48 +02:00
## Uruchomienie
2026-06-15 13:04:53 +02:00
2026-06-16 09:43:48 +02:00
```bash
nvm use 22
pnpm install
pnpm dev
```
2026-06-15 13:04:53 +02:00
2026-06-16 09:43:48 +02:00
Otwórz [http://localhost:3000](http://localhost:3000).
2026-06-15 13:04:53 +02:00
2026-06-16 09:43:48 +02:00
## Funkcje
2026-06-15 13:04:53 +02:00
2026-06-16 09:43:48 +02:00
- **Panel** (`/`) — statystyki tygodniowe, ostatni bieg, ostatni trening siłowy, ostatnia analiza AI.
- **Bieganie** (`/running`) — lista biegów zsynchronizowanych z Garmin Connect (przycisk „Synchronizuj z Garmin”), szczegóły aktywności.
- **Siłownia** (`/strength`) — lista treningów, import (`/strength/import`) przez wklejenie tekstu z funkcji „Share workout” w aplikacji Strong, szczegóły treningu.
- **Analiza AI** — na stronach szczegółów biegu i treningu siłowego, przycisk „Generuj analizę” wywołuje Claude i zapisuje podsumowanie ze wskazówkami.
- **Ustawienia** (`/settings`) — status konfiguracji (MongoDB, Garmin, Claude) i ostatnia synchronizacja Garmin.