Szybki start

Najszybszy sposób, aby zobaczyć BeanGuard w akcji: trzy kontenery Docker — serwer, panel admina i sklep — plus baza PostgreSQL.

Docker Compose

Utwórz plik docker-compose.yml:

services:
  postgres:
    image: postgres:16
    environment:
      POSTGRES_DB: beanguard
      POSTGRES_USER: beanguard
      POSTGRES_PASSWORD: beanguard
    volumes:
      - beanguard-db:/var/lib/postgresql/data

  server:
    image: mszajner/beanguard-server:0.1.3
    depends_on:
      - postgres
    environment:
      SPRING_DATASOURCE_URL: jdbc:postgresql://postgres/beanguard
      SPRING_DATASOURCE_USERNAME: beanguard
      SPRING_DATASOURCE_PASSWORD: beanguard
      BEANGUARD_ADMIN_URL: http://localhost:8002
      BEANGUARD_SHOP_URL: http://localhost:8001
    ports:
      - '8000:80'

  admin:
    image: mszajner/beanguard-admin:0.1.3
    depends_on:
      - server
    environment:
      BEANGUARD_SERVER_URL: http://localhost:8000
    ports:
      - '8002:80'

  shop:
    image: mszajner/beanguard-shop:0.1.3
    depends_on:
      - server
    environment:
      BEANGUARD_SERVER_URL: http://localhost:8000
    ports:
      - '8001:80'

volumes:
  beanguard-db:

Uruchom całość:

docker compose up -d

Serwer nasłuchuje na localhost:8000, panel admina na localhost:8002, sklep na localhost:8001.

Pierwsze uruchomienie

Przy starcie serwer sam nakłada migracje bazy (Liquibase), tworzy domyślne parametry konfiguracyjne i od razu generuje klucze RSA/AES do podpisywania licencji oraz sesji administratorów — nie trzeba tego robić ręcznie. Wejdź na http://localhost:8002 i zaloguj się do panelu admina.

Zobacz Panel admina po przegląd całego menu.

Klucze licencji

Klucz publiczny i sekret AES, które podasz w konfiguracji klienta, już czekają na Ciebie — serwer wygenerował je automatycznie przy pierwszym starcie:

1. W panelu admina otwórz Klucze kryptograficzne, zakładka Licencje.
2. Przyciskiem Kopiuj skopiuj klucz publiczny i klucz szyfrowania (AES).
3. Wklej je do ServerConfig w implementacji BeanGuardConfiguration swojej aplikacji.

Co dalej

• Skonfiguruj Branding i Ustawienia, żeby maile, panel i certyfikaty pokazywały Twoje dane zamiast domyślnych.
• Dodaj pierwszy produkt do sprzedaży albo od razu ręczną licencję dla klienta testowego.
• Zintegruj beanguard-client z własną aplikacją.
• Skonfiguruj sklep, żeby klienci mogli kupować licencje samodzielnie.