docs(env): udokumentuj DJANGO_BPP_ROLLBAR_IGNORE_SMTP_AUTH_ERRORS

.env.sample

@@ -33,3 +33,36 @@ BPP_CONFIGS_DIR=
 #    Opcjonalny pin wersji obrazu: HTML2DOCX_VERSION=<tag> (domyslnie latest).
 #
 # COMPOSE_PROFILES=
+
+# ── Wyciszenie bledow uwierzytelniania SMTP w Rollbarze ──────────────────
+#
+# Ustawiane PER INSTALACJA i domyslnie WYLACZONE. Wlaczaj tylko tam, gdzie
+# administratorzy poczty po stronie klienta maja ZNANA i ZGLOSZONA awarie
+# (serwer SMTP odrzuca poswiadczenia, `535 5.7.3 Authentication
+# unsuccessful`), ktorej nie da sie naprawic po naszej stronie. Bez tego
+# kazda nieudana wysylka powiadomienia zasila w Rollbarze ten sam item
+# w nieskonczonosc.
+#
+# Zmienna nalezy do konfiguracji APLIKACJI, wiec wpisz ja w
+# ${BPP_CONFIGS_DIR}/.env (NIE w tym pliku):
+#
+#   DJANGO_BPP_ROLLBAR_IGNORE_SMTP_AUTH_ERRORS=1
+#
+# Trafi wtedy automatycznie do appservera I workera Celery - oba serwisy
+# ladują ten plik przez `env_file`. Worker jest tu istotny: wyjatek leci
+# z `djcelery_email`, a nie z requestu, wiec ustawienie samego appservera
+# NIC by nie dalo.
+#
+# UWAGA - zakres jest waski i celowo taki zostal:
+#   - wycisza WYLACZNIE smtplib.SMTPAuthenticationError,
+#   - NIE wycisza SMTPRecipientsRefused (zly adres w NASZEJ bazie) ani
+#     SMTPSenderRefused (nasza konfiguracja DEFAULT_FROM_EMAIL) - jedno
+#     i drugie jest do naprawienia po naszej stronie.
+#
+# UWAGA - to NIE naprawia poczty. Dopoki klient nie odblokuje SMTP-a,
+# powiadomienia o zgloszeniach publikacji nie docieraja do redakcji,
+# a zgloszenia leza w bazie niezauwazone. Po naprawie po stronie klienta
+# USUN te zmienna, zeby odzyskac sygnal o awariach poczty.
+#
+# Przy konfiguracji wielotenantowej (DJANGO_BPP_HOSTNAMES) ustawienie
+# dziala na WSZYSTKIE uczelnie obslugiwane przez dany proces.