# THECR3W-DEV — PRZEWODNIK ROZWIĄZYWANIA PROBLEMÓW (TROUBLESHOOTING)
## Wersja: 1.0.0 | Data: 2026-10-31

---

## 1. Problemy z Połączeniem i Caddy Reverse Proxy

### Objaw: Błąd 502 Bad Gateway pod `app.thecr3wnet.com` lub `download.thecr3wnet.com`
- **Przyczyna:** Kontener `thecr3w-backend` lub `thecr3w-download-center` nie jest uruchomiony albo nie jest podłączony do sieci Docker `proxy`.
- **Diagnostyka:**
  ```bash
  docker ps -a --filter "name=thecr3w"
  docker network inspect proxy --format '{{range $k, $v := .Containers}}{{$v.Name}} {{end}}'
  ```
- **Rozwiązanie:** Upewnij się, że usługa działa i jest w sieci `proxy`:
  ```bash
  docker network connect proxy thecr3w-backend
  ```

---

## 2. Błędy Weryfikacji Podpisu Ed25519 w Aplikacjach Klienckich

### Objaw: SDK wyrzuca wyjątek `CryptographicException: Błąd integralności pliku`
- **Przyczyna:** Pobrany plik z R2 ma inny hash SHA256 niż zarejestrowany w bazie lub klucz publiczny w aplikacji nie zgadza się z kluczem prywatnym serwera.
- **Diagnostyka:**
  1. Pobierz plik ręcznie i wylicz SHA256:
     ```bash
     sha256sum plik.apk
     ```
  2. Sprawdź zarejestrowany hash w API:
     ```bash
     curl https://app.thecr3wnet.com/api/v1/apps/{app_id}/releases/{release_id}
     ```
  3. Odpytaj endpoint klucza publicznego:
     ```bash
     curl https://app.thecr3wnet.com/api/v1/keys/signing-public-key
     ```

---

## 3. Błędy Wygasania Adresów Pobierania Cloudflare R2

### Objaw: Błąd HTTP 403 Forbidden lub Expired przy pobieraniu artefaktu
- **Przyczyna:** Pre-signed S3 URL wygasł (standardowy czas ważności wynosi 15 minut) lub zegar systemowy serwera/klienta ma desynchronizację czasową.
- **Rozwiązanie:**
  - Ponowne wywołanie endpointu pobierania w celu wygenerowania świeżego URL.
  - Weryfikacja synchronizacji NTP na serwerze: `timedatectl status`.