# Simtech Component Price Agent

Aplikacja serwerowa do ręcznego sprawdzania cen i dostępności komponentów w sklepach internetowych oraz eksportu wyników do Excela.

## Zakres wersji 1.0

- 52 unikalne sklepy z listy Simtech,
- import komponentów z pliku CSV lub XLSX,
- rozpoznawanie numerów katalogowych zapisanych w kolumnie modelu,
- wyszukiwanie publiczne albo po zalogowaniu na konto firmowe,
- szyfrowanie danych dostępowych AES-256-GCM,
- ręczne uruchamianie sprawdzenia,
- bieżący podgląd postępu i historia zadań,
- eksport XLSX z arkuszami: `Porównanie`, `Wyniki`, `Komponenty`, `Sklepy`,
- zachowanie linku i daty sprawdzenia dla każdego wyniku,
- brak automatycznego składania zamówień.

## Ważne ograniczenie

Portale B2B nie mają jednolitego interfejsu. Agent automatycznie wykrywa typowe formularze logowania, pola wyszukiwania, dane strukturalne produktu i ceny widoczne na stronie. Sklepy z logowaniem dwuetapowym, CAPTCHA, kodem SMS albo niestandardowym formularzem mogą zwrócić status `Wymagane działanie ręczne` lub `Wymagana konfiguracja`.

Pierwsze uruchomienie należy zweryfikować na rzeczywistych kontach Simtech. Układ strony zmieniony przez sklep może wymagać aktualizacji jego konfiguracji. Wynik zawsze należy oceniać razem z typem ceny, walutą, jednostką opakowania oraz terminem dostawy.

## Wymagania VPS

- Linux x86-64,
- Docker Engine 24 lub nowszy,
- Docker Compose v2,
- 2 vCPU, minimum 4 GB RAM, 15 GB wolnego miejsca,
- domena lub subdomena z HTTPS,
- dostęp wychodzący do stron sklepów.

Typowy współdzielony hosting WWW nie wystarczy, ponieważ aplikacja uruchamia przeglądarkę Chromium. Potrzebny jest VPS albo serwer z Dockerem.

## Instalacja

1. Skopiuj katalog aplikacji na serwer.
2. Utwórz konfigurację:

   ```bash
   cp .env.example .env
   openssl rand -base64 32
   openssl rand -hex 32
   ```

3. W pliku `.env` ustaw:

   - `ADMIN_PASSWORD` – silne hasło do panelu,
   - `MASTER_KEY_BASE64` – wynik pierwszego polecenia,
   - `SESSION_SECRET` – wynik drugiego polecenia,
   - `COOKIE_SECURE=true` po uruchomieniu panelu przez HTTPS.

4. Uruchom aplikację:

   ```bash
   docker compose up -d --build
   docker compose logs -f price-agent
   ```

5. Skonfiguruj reverse proxy Nginx lub panel OVH tak, aby kierował HTTPS na `127.0.0.1:8080`.

Przykładowy fragment Nginx:

```nginx
location / {
    proxy_pass http://127.0.0.1:8080;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
```

## Pierwsze użycie

1. Zaloguj się hasłem administratora.
2. W zakładce `Sklepy i konta` dodaj dane tylko do sklepów, w których Simtech ma konto.
3. Zaimportuj BOM w CSV lub XLSX. Kolumna z modelem, symbolem lub numerem katalogowym jest obowiązkowa.
4. Wybierz komponenty i sklepy.
5. Kliknij `Uruchom wyszukiwanie`.
6. Po zakończeniu pobierz Excel.

Wbudowana przykładowa lista zawiera czujniki Balluff `BOS02F0`, `BOS 6K-UI-LK10-S75`, `BES0027`, `BES M08MH1-PSC15B-S04G` oraz akcesoria.

## Bezpieczeństwo

- Nie wpisuj loginów i haseł do kodu, pliku Excel ani `stores.json`.
- Dane sklepowe są szyfrowane kluczem z `MASTER_KEY_BASE64`.
- Utrata tego klucza oznacza brak możliwości odszyfrowania zapisanych kont.
- Katalog `data` powinien być dostępny wyłącznie dla administratora serwera.
- Zalecane są osobne konta sklepowe przeznaczone do odczytu cen, bez prawa składania zamówień.
- Panel powinien być udostępniony wyłącznie przez HTTPS, najlepiej dodatkowo ograniczony VPN-em albo listą adresów IP.
- Aplikacja nie omija CAPTCHA, MFA ani innych zabezpieczeń sklepu.

## Aktualizacja listy sklepów

Lista znajduje się w `config/stores.json`. Każdy sklep ma stały identyfikator, nazwę, stronę główną i opcjonalny adres logowania. Można dodać `searchUrlTemplate`, np.:

```json
{
  "id": "przyklad",
  "name": "Sklep Przykład",
  "url": "https://example.com/",
  "loginUrl": "https://example.com/login",
  "searchUrlTemplate": "https://example.com/search?q={query}"
}
```

## Kopia zapasowa

Wszystkie ustawienia, zaszyfrowane konta, zadania i wyniki są w katalogu `data`. Kopię wykonuj łącznie z bezpiecznie przechowywanym kluczem `MASTER_KEY_BASE64`. Klucza nie należy zapisywać w tym samym archiwum co dane aplikacji.
