Feature/multi hosted config

.env.docker

@@ -5,7 +5,17 @@ STATIC_ROOT=/staticroot
 DEBUG=true
 
 # DJANGO_BPP_DB_PASSWORD=""
+
+# Hostname (single-host deployment, backward compat).
+# Dla multi-hosted użyj DJANGO_BPP_HOSTNAMES (poniżej) i pomiń tę zmienną.
 DJANGO_BPP_HOSTNAME="bpp.localnet"
+
+# Multi-hosted: comma-separated lista nazw hostów (jedna instalacja BPP
+# obsługuje wiele uczelni/domen). Pierwsza pozycja jest używana jako
+# canonical hostname (m.in. identyfikacja deployment'u w Rollbarze).
+# Jeśli ustawisz DJANGO_BPP_HOSTNAMES, DJANGO_BPP_HOSTNAME jest ignorowany.
+# Przykład:
+# DJANGO_BPP_HOSTNAMES="bpp.uczelnia1.pl,bpp.uczelnia2.pl"
 DJANGO_BPP_SECRET_KEY="ZMIEN_KONIECZNIE_PRZED_URUCHOMIENIEM_PRODUKCJI"
 
 DJANGO_BPP_DB_NAME="bpp"

.env.example

@@ -1,6 +1,19 @@
 # Moduł ustawień Django (w docker-compose devowym używamy settings.local).
 # DJANGO_SETTINGS_MODULE="django_bpp.settings.local"
 
+#
+# Konfiguracja hostów
+#
+
+# Single-host (backward compat). Pojedyncza nazwa hosta serwowanego przez BPP.
+# DJANGO_BPP_HOSTNAME="bpp.example.org"
+
+# Multi-hosted: comma-separated lista nazw hostów (jedna instalacja BPP
+# obsługuje wiele uczelni/domen). Pierwsza pozycja jest używana jako
+# canonical hostname (m.in. identyfikacja deployment'u w Rollbarze).
+# Jeśli ustawisz DJANGO_BPP_HOSTNAMES, DJANGO_BPP_HOSTNAME jest ignorowany.
+# DJANGO_BPP_HOSTNAMES="bpp.uczelnia1.pl,bpp.uczelnia2.pl"
+
 # Jeżeli w pliku konfiguracyjnym podany zostanie URI do serwera LDAP,
 # włączona zostanie autoryzacja LDAP. Będzie ona miała pierwszeństwo
 # wobec autoryzacji z serwera bazowego tzn z bazy danych.

.github/workflows/build-docker-images.yml

@@ -108,6 +108,11 @@ jobs:
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           REF_NAME: ${{ github.ref_name }}
+          # head_ref jest ustawione tylko dla pull_request eventów — to nazwa
+          # branchu zrodlowego PR-a (ref_name na PR to "<PR>/merge" ktorego
+          # workflow_dispatch nie akceptuje). Uzywane do hintu w komunikacie
+          # "jak wymusic build".
+          HEAD_REF: ${{ github.head_ref }}
           EVENT_NAME: ${{ github.event_name }}
           REPO: ${{ github.repository }}
           ACTOR: ${{ github.actor }}

.github/workflows/docs.yml

@@ -43,6 +43,8 @@ jobs:
 
     steps:
       - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+        with:
+          persist-credentials: false
 
       - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
         with:

.gitignore

@@ -45,6 +45,7 @@ htmlcov/
 nosetests.xml
 coverage.xml
 coverage.json
+coverage-*.json
 cov_html/
 *,cover
 

.pre-commit-config.yaml

@@ -28,7 +28,23 @@ repos:
           # diff-y indentacji na pre-commit, blokujac niezmienione pliki).
           args: ["--lint"]
           files: \.html$
-          exclude: ^(node_modules/|.*/migrations/|.*/staticroot/|src/django_bpp/static/500\.html$|src/bpp/static/500\.html$)
+          # Tech-debt z dev (dochodzi w merge'u origin/dev): templaty
+          # z wzorcem `{% if %}<a>{% else %}<a>{% endif %}content</a>`
+          # ktorego djlint nie potrafi sparsowac (H025 orphan tags) +
+          # pojedyncze H020 empty-tag. Pre-existing na dev, follow-up
+          # PR rozwiaze refactorem href-y do jednego wezla
+          # `<a href="?{% if x %}{{x}}&{% endif %}sort=...">`.
+          exclude: |
+            (?x)^(
+              node_modules/
+              | .*/migrations/
+              | .*/staticroot/
+              | src/django_bpp/static/500\.html$
+              | src/bpp/static/500\.html$
+              | src/rozbieznosci_if/templates/rozbieznosci_if/index\.html$
+              | src/rozbieznosci_pk/templates/rozbieznosci_pk/index\.html$
+              | src/snapshot_odpiec/templates/snapshot_odpiec/snapshotodpiec_list\.html$
+            )
 
     - repo: https://github.com/pre-commit/pre-commit-hooks
       rev: 'v6.0.0'
@@ -39,6 +55,7 @@ repos:
             # base file. PyYAML's safe loader doesn't know
             # Compose-specific tags, so check-yaml chokes on a file
             # that `docker compose config` parses fine.
+            #
             # mkdocs.yml uses `!!python/object/apply:pymdownx.slugs.slugify`
             # (Python-object tag) — SafeLoader odmawia jego budowy, choć
             # `mkdocs build --strict` parsuje plik bez problemu.

CLAUDE.md

@@ -398,6 +398,27 @@ usuwajacy tagi starsze niz N dni.
 - Fixtures in `src/conftest.py` and subdirectories
 - Full suite timeout: at least 600000ms (10 minutes)
 
+### Uruchamiaj testy LOKALNIE — nie spychaj wszystkiego na CI
+
+**Domyślnie odpalaj testy na swojej maszynie.** „Środowiskowo-ciężkie",
+„zostawmy to CI", „Playwright wymaga setupu" to NIE są powody, żeby pominąć
+lokalny przebieg — to najwyżej powód, żeby najpierw zrobić warunki wstępne
+(`make assets`, `make playwright-install`). Brak warunku wstępnego = wykonaj go,
+nie pomijaj testu.
+
+- **Praca nad zdalnym branchem / w PR:** odpalenie lokalnego `make tests`
+  **równolegle** z czekaniem na CI jest OK i **zalecane** — szybszy feedback,
+  łapiesz regresje zanim CI je zwróci, nie marnujesz rundy CI. Te dwa kanały się
+  nie wykluczają; rób oba.
+- Pełne `make tests` przerywa się na pierwszym błędnym kroku (`make` zwraca na
+  Error 1), więc gdy `tests-without-playwright` padnie, kroki
+  `tests-only-playwright` i `js-tests` się NIE wykonają. Po naprawie Pythona
+  **dokończ** pozostałe kroki (albo ponów całe `make tests`), zamiast uznać je
+  za „pominięte".
+- Jedyny akceptowalny powód, by czegoś nie odpalić lokalnie: fizyczny brak
+  możliwości (np. brak działającego Dockera dla testcontainers) — wtedy powiedz
+  to wprost, a nie „jest ciężkie".
+
 ### Testy Playwright (`src/integration_tests/`) lokalnie
 
 Testy przeglądarkowe (np. `test_global_search.py`) **da się** odpalić

Makefile

@@ -29,7 +29,7 @@
 
 BRANCH=`git branch | sed -n '/\* /s///p'`
 
-.PHONY: help clean distclean tests test-durations release tests-without-playwright tests-only-playwright docker destroy-test-databases cache-delete buildx-cache-stats buildx-cache-prune buildx-cache-prune-aggressive buildx-cache-prune-registry buildx-cache-export buildx-cache-import buildx-cache-list bump-dev bump-release bump-and-start-dev migrate new-worktree clean-worktree generate-500-page build build-force build-base build-app-services build-appserver-base build-appserver build-workerserver build-beatserver build-authserver build-denorm-queue build-servers check-clean-tree prepare-claude prepare-developer-machine prepare-developer-machine-linux prepare-developer-machine-macos playwright-install
+.PHONY: help clean distclean tests test-durations release tests-without-playwright tests-only-playwright docker destroy-test-databases cache-delete buildx-cache-stats buildx-cache-prune buildx-cache-prune-aggressive buildx-cache-prune-registry buildx-cache-export buildx-cache-import buildx-cache-list bump-dev bump-release bump-and-start-dev migrate new-worktree clean-worktree generate-500-page build build-force build-base build-app-services build-appserver-base build-appserver build-workerserver build-beatserver build-authserver build-denorm-queue build-servers docker-images-on-ci check-clean-tree prepare-claude prepare-developer-machine prepare-developer-machine-linux prepare-developer-machine-macos playwright-install
 
 .DEFAULT_GOAL := help
 
@@ -530,6 +530,34 @@ gh-run-watch-docker-images: ## Obserwuj najnowszy run workflow "Docker - oficjal
 gh-run-watch-docker-images-alt: ## Alternatywna wersja gh-run-watch-docker-images (pipe)
 	gh run list --workflow="Docker - oficjalne obrazy" --limit=1 --json databaseId --jq '.[0].databaseId' | xargs gh run watch
 
+docker-images-on-ci: ## Wyślij build "Docker - oficjalne obrazy" na CI i obserwuj go
+	@BRANCH=$$(git rev-parse --abbrev-ref HEAD); \
+	UPSTREAM=$$(git rev-parse --abbrev-ref --symbolic-full-name "@{u}" 2>/dev/null || true); \
+	if [ -z "$$UPSTREAM" ]; then \
+		echo "BŁĄD: Gałąź $$BRANCH nie ma upstreamu. Wypchnij ją najpierw na remote."; \
+		exit 1; \
+	fi; \
+	if [ -n "$$(git status --porcelain)" ]; then \
+		echo "BŁĄD: Working tree zawiera niezcommitowane zmiany. Zcommituj lub stashuj je przed wysłaniem buildu na CI."; \
+		exit 1; \
+	fi; \
+	if [ "$$(git rev-parse HEAD)" != "$$(git rev-parse "$$UPSTREAM")" ]; then \
+		echo "BŁĄD: Lokalna gałąź $$BRANCH nie jest zsynchronizowana z $$UPSTREAM."; \
+		echo "      Wypchnij zmiany przed wysłaniem buildu na CI."; \
+		exit 1; \
+	fi; \
+	echo "Wysyłam build Docker - oficjalne obrazy na CI dla gałęzi: $$BRANCH"; \
+	gh workflow run build-docker-images.yml --ref "$$BRANCH"; \
+	echo "Czekam na pojawienie się runu..."; \
+	sleep 3; \
+	RUN_ID=$$(gh run list --workflow="Docker - oficjalne obrazy" --branch="$$BRANCH" --limit=1 --json databaseId --jq '.[0].databaseId'); \
+	if [ -z "$$RUN_ID" ]; then \
+		echo "BŁĄD: Nie udało się znaleźć nowego runu workflow."; \
+		exit 1; \
+	fi; \
+	echo "Obserwuję run ID: $$RUN_ID"; \
+	gh run watch "$$RUN_ID"
+
 ##@ Wersjonowanie i release
 
 sleep-3: ## `sleep 3` (helper używany w pipeline release)

conftest.py

@@ -61,6 +61,7 @@ def pytest_configure(config):
 # Load fixtures from submodules - must be at top-level conftest per pytest requirements
 pytest_plugins = [
     "fixtures.conftest_models",
+    "fixtures.conftest_multisite",
     "fixtures.conftest_publications",
     "fixtures.conftest_system",
     "fixtures.conftest_browser",

docker/bpp_base/Dockerfile

@@ -94,6 +94,11 @@ COPY src/bpp/static/scss/ src/bpp/static/scss/
 COPY src/bpp/static/bpp/scss/ src/bpp/static/bpp/scss/
 # JS for esbuild bundle
 COPY src/bpp/static/bpp/js/ src/bpp/static/bpp/js/
+# Notifications JS jest teraz dostarczane przez pakiet django-channels-broadcast
+# (zainstalowany przez uv) — collectstatic w runtime stage zaciągnie pliki
+# z venv-a. Stara apka src/notifications/ usunięta na dev w commicie
+# 048c2cfa2 (refactor: usun src/notifications/ — dostarczane przez
+# django-channels-broadcast).
 # JS for esbuild bundle eksploratora powiązań (cytoscape-entry + moduły ES)
 COPY src/powiazania_autorow/static/powiazania_autorow/js/ \
      src/powiazania_autorow/static/powiazania_autorow/js/

docs/administrator/konfiguracja-pbn.md

@@ -30,56 +30,56 @@ W formularzu edycji uczelni/instytucji znajdziesz następujące pola związane z
 
 ### Podstawowe ustawienia API
 
-**Adres API w PBN**  
+**Adres API w PBN**
 - **Pole:** `pbn_api_root`
 - **Domyślna wartość:** `https://pbn-micro-alpha.opi.org.pl`
 - **Opis:** Adres serwera testowego API PBN. W wersji produkcyjnej należy ustawić `https://pbn.nauka.gov.pl/`
 - **Format:** Pełny adres URL (np. `https://pbn-micro-alpha.opi.org.pl`)
 
-**Nazwa aplikacji w PBN**  
+**Nazwa aplikacji w PBN**
 - **Pole:** `pbn_app_name`
 - **Wymagane:** Tak
 - **Opis:** Identyfikator aplikacji otrzymany przy rejestracji w PBN
 - **Maksymalna długość:** 128 znaków
 
-**Token aplikacji w PBN**  
+**Token aplikacji w PBN**
 - **Pole:** `pbn_app_token`
 - **Wymagane:** Tak
 - **Opis:** Token bezpieczeństwa aplikacji otrzymany z PBN
 - **Maksymalna długość:** 128 znaków
 - **Uwaga:** Pole to zawiera dane poufne
 
-**Odpowiednik w PBN**  
+**Odpowiednik w PBN**
 - **Pole:** `pbn_uid`
 - **Opis:** Instytucja w bazie PBN odpowiadająca Twojej uczelni
 - **Uwaga:** Pole to zostanie automatycznie wypełnione po zaimportowaniu danych instytucji z PBN
 
 Opcje eksportu danych
 --------------------
 
-**Kasuj oświadczenia rekordu przed wysłaniem do PBN**  
+**Kasuj oświadczenia rekordu przed wysłaniem do PBN**
 - **Pole:** `pbn_api_kasuj_przed_wysylka`
 - **Domyślnie:** Nie zaznaczone
 - **Opis:** Gdy zaznaczone, system usunie wszystkie istniejące oświadczenia publikacji w PBN przed przesłaniem nowych danych
 
-**Nie wysyłaj do PBN prac z punktami MNISW = 0**  
+**Nie wysyłaj do PBN prac z punktami MNISW = 0**
 - **Pole:** `pbn_api_nie_wysylaj_prac_bez_pk`
 - **Domyślnie:** Nie zaznaczone
 - **Opis:** Blokuje wysyłanie do PBN publikacji bez punktów MNiSW
 
-**Wysyłaj prace bez oświadczeń**  
+**Wysyłaj prace bez oświadczeń**
 - **Pole:** `pbn_wysylaj_bez_oswiadczen`
 - **Domyślnie:** Nie zaznaczone
 - **Opis:** Umożliwia wysyłanie do PBN publikacji bez oświadczeń dyscyplinowych. Takie publikacje trafiają do repozytorium PBN zamiast do systemu ewaluacyjnego i nie zawierają informacji o dyscyplinach naukowych autorów
 
-**Wysyłaj zawsze PBN UID uczelni jako afiliację**  
+**Wysyłaj zawsze PBN UID uczelni jako afiliację**
 - **Pole:** `pbn_api_afiliacja_zawsze_na_uczelnie`
 - **Domyślnie:** Zaznaczone
 - **Opis:** Gdy zaznaczone, wszystkie publikacje będą afiliowane do uczelni, a nie do konkretnych jednostek organizacyjnych;
   zachowanie to jest obecnie domyślne - pole używane było w czasach, gdy publikacja mogła być afiliowana na konkretną
   jednostkę uczelni/instytucji w PBN (na Klinikę, Dział, Katedrę itp...).
 
-**Użytkownik BPP dla PBN API**  
+**Użytkownik BPP dla PBN API**
 - **Pole:** `pbn_api_user`
 - **Opis:** Użytkownik systemu BPP odpowiedzialny za automatyczne operacje z PBN wykonywane przez procesy systemowe
 - **Uwaga:** Ten użytkownik musi wykonać autoryzację w PBN, aby umożliwić automatyczne operacje (w tle)
@@ -123,35 +123,35 @@ Po skonfigurowaniu integracji zaleca się import podstawowych danych słownikowy
 
 ## Typowe problemy i rozwiązania
 
-**Problem:** Komunikat "Brak nazwy aplikacji dla API PBN"  
+**Problem:** Komunikat "Brak nazwy aplikacji dla API PBN"
 - **Rozwiązanie:** Wypełnij pole "Nazwa aplikacji w PBN" w ustawieniach uczelni
 
-**Problem:** Komunikat "Brak tokena aplikacji dla API PBN"  
+**Problem:** Komunikat "Brak tokena aplikacji dla API PBN"
 - **Rozwiązanie:** Wypełnij pole "Token aplikacji w PBN" w ustawieniach uczelni
 
-**Problem:** Komunikat "Token aplikacji PBN nieprawidłowy"  
+**Problem:** Komunikat "Token aplikacji PBN nieprawidłowy"
 - **Rozwiązanie:** Sprawdź poprawność skopiowanego tokena w PBN, upewnij się że nie ma dodatkowych spacji
 
-**Problem:** Komunikat "Najpierw wykonaj autoryzację w PBN API"  
+**Problem:** Komunikat "Najpierw wykonaj autoryzację w PBN API"
 - **Rozwiązanie:** Wykonaj proces autoryzacji opisany w sekcji "Autoryzacja w systemie PBN"
 
-**Problem:** Brak możliwości wysyłania publikacji do PBN  
+**Problem:** Brak możliwości wysyłania publikacji do PBN
 - **Rozwiązanie:** Upewnij się, że pole "Odpowiednik w PBN" jest wypełnione i że wykonano autoryzację użytkownika
 
 ## Operacje na publikacjach
 
 Po skonfigurowaniu integracji możesz:
 
-**Wysyłać pojedyncze publikacje do PBN:**  
+**Wysyłać pojedyncze publikacje do PBN:**
 1.  Otwórz publikację w panelu administracyjnym
 2.  Użyj przycisku **Wyślij do PBN** (jeśli dostępny)
 3.  System automatycznie wyśle publikację i pobierze z powrotem dane wraz z PBN UID
 
-**Importować dane publikacji z PBN:**  
+**Importować dane publikacji z PBN:**
 - System może automatycznie pobierać informacje o publikacjach już istniejących w PBN
 - Możliwe jest też pobieranie abstraktów i innych metadanych
 
-**Zarządzać oświadczeniami dyscyplin:**  
+**Zarządzać oświadczeniami dyscyplin:**
 - System automatycznie wysyła oświadczenia dotyczące dyscyplin naukowych autorów
 - Możliwa jest również wysyłka samych oświadczeń bez całej publikacji
 

docs/administrator/ogolna.md

@@ -110,7 +110,7 @@ formularza, następnie zaznacz lub odznacz opcję "Publiczny" i zapisz rekord
     powiązań autor + rekord dla danego roku, dla danego autora - we wszystkich rekordach, które
     mają „starą” subdyscyplinę - na pustą.
 
-4.  **usunięcie przypisania** autora do dyscypliny (rekord `Autor_Dyscyplina`) powoduje ustawienie  
+4.  **usunięcie przypisania** autora do dyscypliny (rekord `Autor_Dyscyplina`) powoduje ustawienie
     wartości pustej (`NULL`) dla danego roku, dla danego autora - we wszystkich rekordach, do
     których przypisany jest dany autor.