243 lines
7.5 KiB
Markdown
243 lines
7.5 KiB
Markdown
# CLAUDE-REFERENCE.md — Szczegóły operacyjne (czytane na żądanie)
|
|
|
|
Przeniesione z CLAUDE.md w celu optymalizacji kontekstu. Claude Code czyta ten plik gdy potrzebuje szczegółów.
|
|
|
|
## Auto Claude - Rozwiązywanie problemów
|
|
|
|
### Pliki stanu (NIE COMMITOWAĆ!)
|
|
- `.auto-claude-security.json`, `.auto-claude-status`, `.auto-claude/`
|
|
- Są w `.gitignore` + pre-commit hook automatycznie je usuwa ze staging
|
|
|
|
### Konflikty merge z Auto Claude
|
|
|
|
```bash
|
|
# 1. Sprawdź konflikt
|
|
git status
|
|
|
|
# 2. Usuń pliki Auto Claude z merge
|
|
git rm .auto-claude-security.json .auto-claude-status
|
|
|
|
# 3. Dokończ merge
|
|
git commit -m "Merge branch 'feature' - resolve Auto Claude file conflicts"
|
|
```
|
|
|
|
### Worktrees
|
|
|
|
```bash
|
|
git worktree list # Lista aktywnych
|
|
git worktree remove .auto-claude/worktrees/tasks/<task-id> # Usuń nieaktualny
|
|
git branch -d auto-claude/<task-id> # Usuń branch
|
|
```
|
|
|
|
## Disaster Recovery — Szczegóły
|
|
|
|
**Pełna dokumentacja:** `docs/DR-PLAYBOOK.md`
|
|
|
|
### Metryki SLA
|
|
|
|
| Metryka | Wartość |
|
|
|---------|---------|
|
|
| **RTO** | 30-60 min |
|
|
| **RPO** | 1 godzina |
|
|
|
|
### Lokalizacje backupów
|
|
|
|
| Lokalizacja | Ścieżka | Retencja |
|
|
|-------------|---------|----------|
|
|
| Hourly (lokalnie) | `/var/backups/nordabiz/hourly/` | 24h |
|
|
| Daily (lokalnie) | `/var/backups/nordabiz/daily/` | 30 dni |
|
|
| Offsite (PBS) | `10.22.68.127:/backup/nordabiz/` | 30 dni |
|
|
| VM Snapshots | Proxmox | 3 snapshoty |
|
|
|
|
### Szybkie przywracanie
|
|
|
|
```bash
|
|
# Lista dostępnych backupów
|
|
ssh maciejpi@10.22.68.249 "ls -lt /var/backups/nordabiz/hourly/ | head -5"
|
|
|
|
# Restore z backupu
|
|
ssh maciejpi@10.22.68.249 "sudo /var/www/nordabiznes/scripts/dr-restore.sh /var/backups/nordabiz/hourly/nordabiz_YYYYMMDD_HH.dump"
|
|
|
|
# Weryfikacja
|
|
curl -I https://nordabiznes.pl/health
|
|
```
|
|
|
|
### Cron backupy (automatyczne)
|
|
|
|
```bash
|
|
# Backup co godzinę
|
|
0 * * * * postgres pg_dump -Fc nordabiz > /var/backups/nordabiz/hourly/nordabiz_$(date +\%Y\%m\%d_\%H).dump
|
|
|
|
# Backup dzienny
|
|
0 2 * * * postgres pg_dump -Fc nordabiz > /var/backups/nordabiz/daily/nordabiz_$(date +\%Y\%m\%d).dump
|
|
|
|
# Sync do PBS
|
|
0 4 * * * root rsync -avz /var/backups/nordabiz/daily/ maciejpi@10.22.68.127:/backup/nordabiz/daily/
|
|
```
|
|
|
|
## Szablon profilu firmy
|
|
|
|
### Docelowa struktura (po optymalizacji)
|
|
|
|
```
|
|
1. Header (nazwa, kategoria, badge, krótki opis)
|
|
2. Pasek kontaktowy (www, email, telefon, lokalizacja)
|
|
3. O firmie (połączone opisy)
|
|
4. Usługi i kompetencje (połączone tagi)
|
|
5. Wyróżniki (połączone z wartościami)
|
|
6. Dane kontaktowe (pełne karty)
|
|
7. Informacje prawne i biznesowe
|
|
8. Social Media (wszystkie 6 platform)
|
|
9. Strona WWW (analiza techniczna)
|
|
```
|
|
|
|
**Szablon:** `templates/company_detail.html`
|
|
|
|
## ZOP Kaszubia News (ZOPK) — Szczegóły
|
|
|
|
System monitoringu newsów projektu **Zielony Okręg Przemysłowy Kaszubia**.
|
|
Panel: `/admin/zopk/news`
|
|
|
|
### Tematy istotne
|
|
- Zielony Okręg Przemysłowy Kaszubia
|
|
- Elektrownia jądrowa (Lubiatowo-Kopalino)
|
|
- Offshore wind Bałtyk (Baltic Power, Baltica)
|
|
- Via Pomerania, Droga Czerwona
|
|
- Kongsberg (inwestycje w Rumi)
|
|
- Izba Przedsiębiorców NORDA
|
|
|
|
### Tematy do odrzucenia
|
|
- Turystyka na Kaszubach
|
|
- Polityka ogólnopolska
|
|
- Inne regiony Polski
|
|
- Wypadki, clickbait
|
|
|
|
### Reguły auto-approve (WAŻNE!)
|
|
|
|
**Próg: score >= 3**
|
|
|
|
| Score | Status |
|
|
|-------|--------|
|
|
| 1-2 | `pending` |
|
|
| 3-5 | `auto_approved` |
|
|
|
|
**Plik:** `zopk_news_service.py` (linie 890, 1124, 1145)
|
|
|
|
## Cykliczna aktualizacja danych ze stron www firm
|
|
|
|
### Mechanizm
|
|
|
|
Skrypt `scripts/website_content_updater.py` automatycznie:
|
|
1. Pobiera treść strony www każdej firmy członkowskiej
|
|
2. Używa **Gemini 3 Flash** (darmowy plan) do ekstrakcji:
|
|
- `services_extracted` - lista usług oferowanych przez firmę
|
|
- `main_keywords` - główne słowa kluczowe
|
|
- `content_summary` - krótkie podsumowanie działalności
|
|
3. Zapisuje do tabeli `company_website_analysis`
|
|
|
|
### Uruchamianie ręczne
|
|
|
|
```bash
|
|
# Wszystkie firmy
|
|
cd /var/www/nordabiznes
|
|
/var/www/nordabiznes/venv/bin/python3 scripts/website_content_updater.py
|
|
|
|
# Konkretna firma
|
|
/var/www/nordabiznes/venv/bin/python3 scripts/website_content_updater.py --company-id 26
|
|
|
|
# Tylko firmy nieaktualizowane 30+ dni
|
|
/var/www/nordabiznes/venv/bin/python3 scripts/website_content_updater.py --stale-days 30
|
|
|
|
# Podgląd bez zapisywania (dry-run)
|
|
/var/www/nordabiznes/venv/bin/python3 scripts/website_content_updater.py --dry-run
|
|
```
|
|
|
|
### Cron (automatyczne uruchamianie)
|
|
|
|
Uruchamiany **1-ego każdego miesiąca o 3:00** dla firm nieaktualizowanych 30+ dni:
|
|
|
|
```bash
|
|
0 3 1 * * cd /var/www/nordabiznes && /var/www/nordabiznes/venv/bin/python3 scripts/website_content_updater.py --stale-days 30 >> /var/log/nordabiznes/website_updater.log 2>&1
|
|
```
|
|
|
|
Logi: `/var/log/nordabiznes/website_updater.log`
|
|
Rate limiting: 2s między firmami, ~150 firm = ~5 min
|
|
|
|
## NordaGPT — Dostępne modele w `gemini_service.py`
|
|
|
|
| Alias | Model ID | Opis |
|
|
|-------|----------|------|
|
|
| `flash` | `gemini-2.5-flash` | Ogólnego przeznaczenia |
|
|
| `flash-lite` | `gemini-2.5-flash-lite` | Ultra tani ($0.10/$0.40 per 1M) |
|
|
| `pro` | `gemini-2.5-pro` | Najlepszy reasoning |
|
|
| `flash-2.0` | `gemini-2.0-flash` | Poprzednia generacja (wycofywany 31.03.2026) |
|
|
| `3-flash` | `gemini-3-flash-preview` | **AKTUALNY** - 7x lepszy reasoning, thinking mode |
|
|
| `3-pro` | `gemini-3-pro-preview` | Premium - 2M context |
|
|
|
|
### Thinking Mode
|
|
|
|
Użytkownicy mogą wybierać poziom rozumowania AI w UI chatu (dropdown obok badge "Gemini 3").
|
|
|
|
| Poziom | Opis | Zastosowanie |
|
|
|--------|------|--------------|
|
|
| **Błyskawiczny** (minimal) | Najszybsze odpowiedzi | Proste pytania: "kto?", "gdzie?" |
|
|
| **Szybki** (low) | Zrównoważony | Większość pytań o firmy i usługi |
|
|
| **Głęboki** (high) | Maksymalna analiza | Złożone pytania, rekomendacje, strategia |
|
|
|
|
**Zmiana poziomu:**
|
|
- UI: Dropdown w headerze chatu
|
|
- API: `POST /api/chat/settings` z `{"thinking_level": "high"}`
|
|
- Zapisywane w sesji użytkownika
|
|
|
|
### UI Badge
|
|
W `templates/chat.html` badge w headerze: `<span class="chat-header-badge">Gemini 3</span>`
|
|
|
|
## Prezentacja dla członków Izby
|
|
|
|
### Cel projektu
|
|
Stworzenie materiałów wideo prezentujących portal NordaBiz dla członków Izby NORDA.
|
|
|
|
### Produkty końcowe
|
|
1. **Podcast NotebookLM** (2-3 min) - rozmowa AI o portalu
|
|
2. **Zajawka Remotion** (30s) - scenariusz "Problem → Rozwiązanie"
|
|
3. **Tutorial wideo** (2-3 min) - nagrania portalu + dialogi Zofia/Marek
|
|
4. **Integracja z portalem** - Akademia + widget na dashboardzie
|
|
|
|
### Dokument źródłowy dla NotebookLM
|
|
`docs/notebooklm-source.md` - markdown do wgrania do notebooklm.google.com
|
|
|
|
### Scenariusz zajawki 30s (Remotion)
|
|
```
|
|
[0-8s] "Szukasz partnera do projektu?"
|
|
[8-16s] "Nie wiesz, kto w Izbie ma potrzebne kompetencje?"
|
|
[16-24s] "NordaGPT zna 150 firm i pomoże Ci znaleźć"
|
|
[24-30s] "nordabiznes.pl - Twoja sieć kontaktów"
|
|
```
|
|
|
|
### Głosy edge-tts
|
|
- Marek: `pl-PL-MarekNeural` (męski)
|
|
- Zofia: `pl-PL-ZofiaNeural` (żeński)
|
|
|
|
### GIFy do nagrania (Chrome MCP)
|
|
1. Strona główna zalogowanego
|
|
2. Katalog firm + filtrowanie
|
|
3. Profil firmy
|
|
4. Chat NordaGPT - pytanie
|
|
5. Chat NordaGPT - odpowiedź
|
|
6. Forum
|
|
7. Kalendarz
|
|
8. Tablica B2B
|
|
|
|
### Pliki Remotion
|
|
- Lokalizacja: `/Users/maciejpi/claude/projects/active/remotion/my-video/`
|
|
- Komponenty: `NordaBizZajawka.tsx`, `NordaBizTutorial.tsx`
|
|
- Audio: `public/audio/`, `public/voice/tutorial/`
|
|
- Nagrania: `public/recordings/*.gif`
|
|
|
|
## Dodatkowe rejestry (TODO — przyszłe integracje)
|
|
|
|
| Rejestr | Opis | API |
|
|
|---------|------|-----|
|
|
| **CRBR** | Centralny Rejestr Beneficjentów Rzeczywistych | https://crbr.podatki.gov.pl |
|
|
| **SUDOP** | System Udostępniania Danych o Pomocy Publicznej | https://sudop.uokik.gov.pl |
|