Współpraca zespołowa

Plan TEAM w Notifer umożliwia wielu użytkownikom współpracę nad wspólnymi tematami powiadomień, co czyni go idealnym dla zespołów programistycznych, grup DevOps i działów biznesowych.

Przegląd

Z planem TEAM możesz:

• Tworzyć zespoły z wieloma członkami
• Udostępniać tematy powiadomień w całym zespole
• Przypisywać role z różnymi poziomami uprawnień
• Wykorzystywać subskrypcję właściciela zespołu dla wszystkich członków zespołu
• Publikować wspólnie używając wspólnej puli limitów szybkości

Ekonomiczna współpraca

Tylko właściciel zespołu potrzebuje subskrypcji TEAM. Wszyscy członkowie zespołu mogą używać kont FREE tier i nadal publikować do tematów zespołowych z hojnymi limitami właściciela.

Kluczowe pojęcia

Zespoły

Zespół to grupa użytkowników, którzy współpracują nad wspólnymi tematami powiadomień. Każdy zespół ma:

• Jednego właściciela (wymaga subskrypcji TEAM)
• Wielu członków (mogą mieć konta FREE tier)
• Wspólne tematy, do których wszyscy członkowie mogą publikować
• Scentralizowane limity szybkości oparte na subskrypcji właściciela

Tematy zespołowe

Tematy zespołowe to kanały powiadomień należące do zespołu:

• Tworzone przez właściciela zespołu lub administratorów
• Wszyscy członkowie zespołu mogą do nich publikować
• Używają limitów szybkości i retencji właściciela zespołu
• Mogą być publiczne lub prywatne
• Prywatne tematy zespołowe mogą być ustawione jako odkrywalne (publiczny dostęp tylko do odczytu)

Role

Zespoły mają trzy poziomy ról:

Rola	Opis	Wymagana subskrypcja
OWNER	Pełna kontrola nad zespołem i płatnościami	Subskrypcja TEAM
ADMIN	Zarządzaj członkami i tematami	FREE+ (dowolny poziom)
MEMBER	Publikuj do tematów zespołowych	FREE+ (dowolny poziom)

Tworzenie zespołu

Wymagania wstępne

• Aktywna subskrypcja TEAM (zobacz Cennik dla aktualnych stawek)
• Zweryfikowany adres e-mail

Kroki

1. Przejdź do strony Zespoły w swoim panelu
2. Kliknij przycisk "Utwórz zespół"
3. Wprowadź szczegóły zespołu:
   • Nazwa zespołu: Wybierz opisową nazwę (np. "Engineering", "DevOps")
   • Opis: Opcjonalny opis celu zespołu
4. Kliknij "Utwórz"

Twój zespół jest teraz utworzony i automatycznie jesteś ustawiony jako OWNER.

Zapraszanie członków zespołu

Kto może zapraszać

• Właściciel zespołu
• Administrator zespołu

Proces zapraszania

1. Przejdź do strony szczegółów zespołu
2. Kliknij "Zaproś członka"
3. Wprowadź adres e-mail członka
4. Wybierz ich rolę:
   • ADMIN: Może zarządzać członkami i tematami
   • MEMBER: Może tylko publikować do tematów
5. Kliknij "Wyślij zaproszenie"

E-mail z zaproszeniem

Zaproszony otrzymuje e-mail z:

• Nazwą zespołu i informacją kto zaprosił
• Przypisaną rolą
• Linkiem zaproszenia (ważnym przez 7 dni)
• Instrukcjami akceptacji

Akceptowanie zaproszeń

Jeśli zaproszony ma konto:

1. Kliknij link zaproszenia
2. Zaloguj się do swojego konta
3. Zaproszenie jest automatycznie zaakceptowane
4. Zostaje przekierowany na stronę zespołu

Jeśli zaproszony nie ma konta:

1. Kliknij link zaproszenia
2. Zobacz szczegóły zaproszenia
3. Utwórz konto FREE (nie wymaga płatności)
4. Zaproszenie jest automatycznie zaakceptowane
5. Zostaje przekierowany na stronę zespołu

Witamy konta FREE

Członkowie zespołu nie muszą aktualizować z poziomu FREE. Mogą publikować do tematów zespołowych używając limitów poziomu TEAM właściciela.

Zarządzanie oczekującymi zaproszeniami

Oczekujące zaproszenia pojawiają się na liście członków zespołu z żółtym tłem.

Dostępne akcje:

• Wyślij ponownie: Wyślij e-mail z zaproszeniem ponownie
• Anuluj: Odwołaj zaproszenie

Zaproszenia automatycznie wygasają po 7 dniach.

Dodawanie członków do wielu zespołów

Polityka rozliczeniowa członków

Liczenie unikalnych członków: Jeśli posiadasz wiele zespołów i dodasz tę samą osobę do więcej niż jednego zespołu, liczą się jako jedno miejsce członka w Twoim rozliczeniu, a nie wiele.

Przykład:

Masz plan TEAM S (do 5 członków) i tworzysz dwa zespoły:

• Zespół Engineering: Alice, Bob, Charlie
• Zespół DevOps: Alice, Bob, David

Mimo że Alice i Bob są w obu zespołach (4 członkostwa razem), zajmują tylko 2 miejsca członków, ponieważ rozliczenia liczą unikalnych użytkowników.

Całkowita liczba unikalnych członków: Alice, Bob, Charlie, David = 4 członków

Twoje rozliczenie:

• Plan TEAM S (do 5 członków)
• 4 unikalnych członków ≤ 5 miejsc ✅
• Razem: cena planu TEAM S ✅

Proces zapraszania:

Gdy zapraszasz kogoś, kto jest już w innym Twoim zespole:

1. System zezwala na zaproszenie (nie duplikat)
2. Otrzymują nowy e-mail z zaproszeniem do drugiego zespołu
3. Muszą zaakceptować zaproszenie, aby dołączyć do drugiego zespołu
4. Brak dodatkowej opłaty rozliczeniowej (ta sama osoba liczona raz)

Ten projekt pozwala elastycznie organizować członków w zespołach bez kar rozliczeniowych.

Role i uprawnienia zespołu

OWNER

Pełna kontrola nad zespołem

✅ Może:

• Edytować szczegóły zespołu (nazwa, opis)
• Usunąć zespół
• Zapraszać i usuwać wszystkich członków
• Zmieniać role członków (w tym administratorów)
• Tworzyć, edytować i usuwać tematy zespołowe
• Zarządzać tokenami dostępu do tematów
• Publikować do wszystkich tematów zespołowych

❌ Nie może:

• Opuścić zespołu (musi usunąć zespół lub przekazać własność)
• Usunąć siebie jako właściciela

Wymagana subskrypcja

Właściciel zespołu musi utrzymywać aktywną subskrypcję TEAM. Jeśli obniży poziom, zespół staje się nieaktywny i członkowie nie mogą publikować do tematów zespołowych.

ADMIN

Uprawnienia zarządzania codziennego

✅ Może:

• Zapraszać i usuwać zwykłych członków
• Zmieniać role tylko dla zwykłych członków
• Tworzyć, edytować i usuwać tematy zespołowe
• Zarządzać tokenami dostępu do tematów
• Publikować do wszystkich tematów zespołowych
• Wyświetlać wszystkie szczegóły zespołu

❌ Nie może:

• Edytować ustawień zespołu (nazwa, opis)
• Usuwać zespołu
• Usuwać lub degradować innych administratorów
• Usuwać lub degradować właściciela
• Zmieniać swojej roli

Nie wymaga subskrypcji

Administratorzy mogą używać kont FREE tier. Korzystają z limitów poziomu TEAM właściciela zespołu podczas publikowania do tematów zespołowych.

MEMBER

Rola skoncentrowana na publikowaniu

✅ Może:

• Publikować do wszystkich tematów zespołowych
• Wyświetlać tematy zespołowe
• Subskrybować tematy zespołowe
• Generować osobiste klucze API
• Wysyłać testowe powiadomienia

❌ Nie może:

• Tworzyć ani zarządzać tematami
• Zapraszać ani zarządzać innymi członkami
• Edytować ustawień zespołu
• Zarządzać tokenami dostępu do tematów
• Usuwać czegokolwiek

Idealne dla programistów

Członkowie mogą używać kont FREE tier i publikować nieograniczoną liczbę wiadomości do tematów zespołowych (w ramach limitów właściciela zespołu).

Tworzenie tematów zespołowych

Kto może tworzyć

• Właściciel zespołu
• Administrator zespołu

Kroki

1. Kliknij "Utwórz temat" w panelu
2. Wprowadź szczegóły tematu:
   • Nazwa tematu: Użyj opisowej nazwy (np. "deployment-prod")
   • Poziom dostępu:
     • Publiczny: Każdy może subskrybować i publikować
     • Prywatny: Tylko członkowie zespołu mogą publikować
   • Odkrywalność:
     • Tematy publiczne: Pokaż w publicznym katalogu
     • Tematy prywatne: Zezwól na publiczne subskrypcje tylko do odczytu (subskrybenci mogą przeglądać, ale nie mogą publikować)
3. Wybierz swój zespół z listy rozwijanej
4. Kliknij "Utwórz"

Odkrywalne prywatne tematy zespołowe

Ustaw prywatny temat zespołowy jako odkrywalny, gdy chcesz, aby użytkownicy zewnętrzni mogli otrzymywać powiadomienia bez dawania im dostępu do publikowania.

Temat jest teraz utworzony i:

• Widoczny dla wszystkich członków zespołu
• Możliwy do publikowania przez wszystkich członków zespołu
• Używa retencji właściciela zespołu (45 dni)
• Liczony w użyciu właściciela zespołu

Najlepsze praktyki nazewnictwa tematów

Używaj spójnych konwencji nazewnictwa:

✅ Dobre przykłady:
deployment-production
deployment-staging
errors-backend
alerts-critical
metrics-cpu

❌ Złe przykłady:
prod-deploy
staging_deployment
backend_errors
CriticalAlerts
cpu_metrics

Zalecane wzorce:

• {cel}-{środowisko}: deployment-prod, deployment-staging
• {typ}-{komponent}: errors-backend, errors-frontend
• {kategoria}-{poziom}: alerts-critical, alerts-warning

Publikowanie do tematów zespołowych

Wszyscy członkowie zespołu (Owner, Admin, Member) mogą publikować do tematów zespołowych.

Interfejs webowy

1. Przejdź do strony tematu
2. Wprowadź swoją wiadomość
3. Opcjonalnie ustaw:
   • Tytuł: Nagłówek wiadomości
   • Priorytet: 1 (krytyczny) do 5 (informacyjny)
   • Tagi: Tagi kategoryzacji
4. Kliknij "Publikuj"

HTTP/cURL

Z osobistym kluczem API (zalecane)

curl -d "Deployment completed successfully" \
  -H "X-API-Key: your_personal_api_key" \
  -H "X-Title: Deployment" \
  -H "X-Priority: 3" \
  https://app.notifer.io/deployment-prod

Osobiste klucze API

Wszyscy członkowie zespołu (w tym FREE tier) mogą generować osobiste klucze API w Ustawienia → Klucze API. Są one bezpieczniejsze niż wspólne tokeny.

Z tokenem JWT

curl -d "Deployment completed successfully" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "X-Title: Deployment" \
  -H "X-Priority: 3" \
  https://app.notifer.io/deployment-prod

Z tokenem dostępu do tematu

curl -d "Deployment completed successfully" \
  -H "X-Topic-Token: tk_team_topic_token" \
  -H "X-Title: Deployment" \
  -H "X-Priority: 3" \
  https://app.notifer.io/deployment-prod

Bezpieczeństwo tokenów

Tokeny dostępu do tematów są udostępniane między członkami zespołu i systemami zewnętrznymi. Używaj osobistych kluczy API, gdy to możliwe, dla lepszego bezpieczeństwa i śladów audytu.

Limity szybkości i użycie

Jak działają limity szybkości zespołu

Notifer używa limitowania szybkości świadomego zespołu:

Dla tematów zespołowych:

• Limity szybkości oparte na poziomie subskrypcji właściciela zespołu
• Wszyscy członkowie zespołu dzielą tę samą pulę
• Użycie liczone względem konta właściciela zespołu

Dla tematów osobistych:

• Limity szybkości oparte na własnym poziomie subskrypcji użytkownika
• Użycie liczone względem własnego konta użytkownika

Poziomy limitów szybkości

Przykładowe scenariusze

Scenariusz 1: Członek publikujący do tematu zespołowego

Zespół: "Engineering"
Właściciel: alice@company.com (poziom TEAM)
Członek: bob@company.com (poziom FREE)
Temat zespołowy: "deployment-prod"

Gdy bob publikuje do "deployment-prod":
✅ Używa limitów TEAM Alice (100/min, 5 000/godz, 25k/dzień)
✅ NIE używa limitów FREE Boba
✅ Liczone w panelu użycia Alice

Scenariusz 2: Członek publikujący do tematu osobistego

Członek: bob@company.com (poziom FREE)
Temat osobisty: "bob-personal"

Gdy bob publikuje do "bob-personal":
✅ Używa limitów FREE Boba (10/min, 100/godz, 1k/dzień)
✅ NIE wpływa na limity zespołu
✅ Liczone w panelu użycia Boba

Panel użycia

Widok właściciela zespołu:

Właściciel zespołu widzi kompleksowe statystyki użycia, w tym:

• Całkowite użycie z tematów osobistych + zespołowych łącznie
• Liczba członków zespołu (unikalni członkowie vs limit - ta sama osoba w wielu zespołach liczona raz)
• Podział na członka - zobacz kto publikuje najwięcej
• Podział na temat - zidentyfikuj tematy o dużym ruchu

Dostęp do panelu użycia w Ustawienia → Użycie lub przez API na /api/usage.

Przykładowy panel właściciela zespołu:

{
  "usage": {
    "daily_messages": {
      "used": 1234,
      "remaining": 23766,
      "limit": 25000
    },
    "team_breakdown": {
      "teams": [
        {
          "team_name": "Engineering",
          "total_messages_today": 1234,
          "per_member": [
            {
              "email": "alice@team.com",
              "role": "ADMIN",
              "messages_published": 789
            },
            {
              "email": "bob@team.com",
              "role": "MEMBER",
              "messages_published": 345
            }
          ],
          "per_topic": [
            {
              "topic_name": "deployment-prod",
              "messages_today": 456
            },
            {
              "topic_name": "errors-backend",
              "messages_today": 778
            }
          ]
        }
      ]
    }
  }
}

Czego możesz się dowiedzieć z podziału:

• Najbardziej aktywni członkowie: Zidentyfikuj głównych użytkowników
• Tematy o dużym ruchu: Które tematy zużywają większość limitów
• Nieaktywni członkowie: Członkowie z 0 wiadomości (kandydaci do usunięcia)
• Wzorce użycia: Planuj pojemność i optymalizuj strukturę tematów

Widok członka zespołu:

• Pokazuje tylko użycie tematów osobistych
• Publikacje do tematów zespołowych nie pojawiają się w użyciu członka
• Członkowie nie mogą zobaczyć podziału zespołu (tylko właściciel)

Błędy limitów szybkości

Gdy limity są przekroczone:

Limit tematu zespołowego:

429 Too Many Requests
Team rate limit exceeded. The team owner's TEAM plan allows
100 messages per minute. Try again in 42 seconds.

Limit tematu osobistego:

429 Too Many Requests
Rate limit exceeded. Your FREE plan allows 10 messages per
minute. Try again in 38 seconds.

Zarządzanie członkami zespołu

Wyświetlanie członków

Przejdź do strony zespołu, aby zobaczyć:

• Aktywnych członków z ich rolami
• Oczekujące zaproszenia (żółte tło)
• Daty dołączenia członków

Zmiana ról

Kto może zmieniać role:

• Właściciel: Może zmieniać rolę dowolnego członka
• Administrator: Może zmieniać tylko role zwykłych członków (nie innych administratorów)

Kroki:

1. Znajdź członka na liście członków zespołu
2. Kliknij ich aktualną odznakę roli
3. Wybierz nową rolę z listy rozwijanej
4. Potwierdź zmianę

Usuwanie członków

Kto może usuwać:

• Właściciel: Może usunąć każdego oprócz siebie
• Administrator: Może usuwać tylko zwykłych członków

Kroki:

1. Znajdź członka na liście członków zespołu
2. Kliknij menu trzech kropek (⋮)
3. Wybierz "Usuń z zespołu"
4. Potwierdź usunięcie

Natychmiastowy efekt

Usunięci członkowie tracą dostęp do tematów zespołowych natychmiast. Nie mogą już publikować ani subskrybować tematów zespołowych.

Tokeny dostępu do tematów

Czym są?

Tokeny dostępu do tematów to wspólne tokeny uwierzytelniające, które pozwalają:

• Systemom zewnętrznym (CI/CD, monitorowanie) publikować
• Wspólnym usługom wysyłać powiadomienia
• Publikowaniu tylko przez API bez kont użytkowników

Kto może zarządzać

• Właściciel zespołu
• Administrator zespołu

Tworzenie tokenów

1. Przejdź do tematu zespołowego
2. Kliknij "Zarządzaj tokenami dostępu"
3. Kliknij "Utwórz token"
4. Ustaw uprawnienia:
   • Odczyt: Może subskrybować i czytać wiadomości
   • Zapis: Może publikować wiadomości
   • Odczyt+Zapis: Oba uprawnienia
5. Skopiuj token (pokazywany tylko raz)

Bezpieczeństwo tokenu

Tokeny dostępu do tematów są pokazywane tylko raz podczas tworzenia. Przechowuj je bezpiecznie (np. GitHub Secrets, zmienne środowiskowe).

Używanie tokenów

# W pipeline CI/CD
curl -d "Build #$BUILD_NUMBER deployed" \
  -H "X-Topic-Token: tk_your_token_here" \
  -H "X-Title: CI/CD" \
  https://app.notifer.io/deployment-prod

Odwoływanie tokenów

1. Przejdź do "Zarządzaj tokenami dostępu"
2. Znajdź token do odwołania
3. Kliknij "Odwołaj"
4. Potwierdź

Token jest natychmiast unieważniony.

Osobiste klucze API vs tokeny tematów

Osobiste klucze API

Zalecane dla:

• Indywidualnych programistów
• Lokalnego rozwoju
• Osobistych skryptów i automatyzacji

Zalety:

• Powiązane z kontem użytkownika (ślad audytu)
• Dostęp do wszystkich tematów, do których użytkownik może publikować
• Można rotować bez wpływu na zespół
• Bardziej bezpieczne (nie udostępniane)

Jak utworzyć:

Ustawienia → Klucze API → Wygeneruj nowy klucz

Tokeny dostępu do tematów

Zalecane dla:

• Pipeline CI/CD
• Wspólnych narzędzi monitorujących
• Usług zewnętrznych
• Automatyzacji na poziomie zespołu

Zalety:

• Nie powiązane z indywidualnymi użytkownikami
• Można bezpiecznie udostępniać w zespole
• Uprawnienia specyficzne dla tematu
• Zarządzane przez właściciela/administratora

Jak utworzyć:

Strona tematu → Zarządzaj tokenami dostępu → Utwórz token

Najlepsza praktyka

Używaj osobistych kluczy API, gdy to możliwe, dla lepszego bezpieczeństwa i odpowiedzialności. Używaj tokenów dostępu do tematów tylko dla naprawdę wspólnych usług.

Ustawienia zespołu

Edycja szczegółów zespołu

Kto może edytować: Tylko właściciel

Kroki:

1. Przejdź do strony zespołu
2. Kliknij "Edytuj zespół"
3. Zaktualizuj:
   • Nazwa zespołu
   • Opis
4. Kliknij "Zapisz"

Usuwanie zespołu

Kto może usunąć: Tylko właściciel

Akcja nieodwracalna

Usunięcie zespołu jest nieodwracalne i nie może zostać cofnięte.

Co zostaje usunięte:

• Zespół i wszystkie tematy zespołowe
• Wszystkie wiadomości w tematach zespołowych
• Powiązania członków zespołu
• Tokeny dostępu do tematów

Co NIE jest usuwane:

• Konta członków zespołu
• Osobiste tematy członków
• Subskrypcje członków

Kroki:

1. Przejdź do strony zespołu
2. Kliknij "Usuń zespół"
3. Wpisz nazwę zespołu, aby potwierdzić
4. Kliknij "Usuń na stałe"

Monitorowanie użycia zespołu

Dostęp do statystyk użycia

Właściciele zespołów mogą monitorować szczegółowe statystyki użycia, aby optymalizować wydajność zespołu i identyfikować problemy.

Metody dostępu:

1. Panel internetowy: Ustawienia → Użycie
2. Endpoint API: GET /api/usage (wymaga uwierzytelniania)

Zrozumienie podziału

Statystyki na członka

Zobacz dokładnie, ile wiadomości opublikował każdy członek zespołu dzisiaj:

Przypadki użycia:

• Zidentyfikuj głównych użytkowników: Członkowie publikujący najwięcej wiadomości
• Wykryj nieaktywnych członków: Członkowie z 0 wiadomości w czasie
• Zbalansuj obciążenie: Rozłóż publikowanie między członków zespołu
• Rozwiązywanie problemów: Jeśli limity są osiągnięte, zobacz kto publikuje najwięcej

Przykład:

alice@team.com (ADMIN): 789 wiadomości
bob@team.com (MEMBER): 345 wiadomości
charlie@team.com (MEMBER): 0 wiadomości  ← Nieaktywny?

Akcje, które możesz podjąć:

• Usuń nieaktywnych członków, aby zwolnić miejsca w zespole
• Skontaktuj się z wydawcami o dużej objętości, aby zoptymalizować ich integracje
• Rozważ wyższy wariant TEAM, jeśli konsekwentnie osiągasz limity

Statystyki na temat

Zobacz, które tematy generują najwięcej ruchu:

Przypadki użycia:

• Optymalizuj tematy o dużym ruchu: Zmniejsz gadatliwe logi lub grupuj wiadomości
• Zidentyfikuj nieużywane tematy: Tematy z 0 wiadomości (kandydaci do usunięcia)
• Planowanie pojemności: Wiedz, które tematy optymalizować, jeśli zbliżasz się do limitów
• Organizacja tematów: Restrukturyzuj tematy na podstawie rzeczywistego użycia

Przykład:

errors-backend: 778 wiadomości   ← Duży ruch - optymalizować?
deployment-prod: 456 wiadomości
metrics-cpu: 0 wiadomości        ← Nieużywany - usunąć?

Akcje, które możesz podjąć:

• Filtruj gadatliwe tematy u źródła
• Archiwizuj lub usuwaj nieużywane tematy
• Podziel tematy o dużym ruchu na podtematy
• Grupuj wiadomości, gdy to możliwe

Codzienny przepływ monitorowania

Zalecane dla właścicieli zespołów:

1. Cotygodniowy sprawdzian: Przeglądaj panel użycia każdy poniedziałek
2. Szukaj anomalii:
   • Nagłe skoki w określonych tematach
   • Członkowie z nieoczekiwanymi 0 wiadomościami
   • Tematy zużywające >30% dziennego limitu
3. Podejmij działanie:
   • Skontaktuj się z członkami w sprawie nietypowych wzorców
   • Optymalizuj tematy o dużym ruchu
   • Usuń nieaktywnych członków

Dostęp do API dla automatyzacji

Zintegruj monitorowanie użycia z przepływem pracy ops:

# Pobierz statystyki użycia
curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://app.notifer.io/api/usage

# Parsuj z jq
curl -s -H "Authorization: Bearer YOUR_TOKEN" \
  https://app.notifer.io/api/usage | \
  jq '.usage.team_breakdown.teams[0].per_topic[] |
      select(.messages_today > 1000)'

Przykład alertowania:

#!/bin/bash
# Alertuj, jeśli jakikolwiek temat przekracza 10k wiadomości/dzień

USAGE=$(curl -s -H "Authorization: Bearer $TOKEN" \
  https://app.notifer.io/api/usage)

HIGH_TRAFFIC=$(echo $USAGE | jq -r \
  '.usage.team_breakdown.teams[0].per_topic[] |
   select(.messages_today > 10000) | .topic_name')

if [ -n "$HIGH_TRAFFIC" ]; then
  echo "High traffic topics: $HIGH_TRAFFIC"
  # Wyślij alert przez e-mail/Slack/itp.
fi

Najlepsze praktyki

Organizacja zespołu

1. Definiuj jasne role

   • Użyj Owner dla rozliczeń i krytycznych decyzji
   • Użyj Admins dla codziennego zarządzania (zalecane 1-2 administratorów)
   • Użyj Members dla programistów, którzy tylko muszą publikować

2. Regularne audyty

   • Przeglądaj członków zespołu kwartalnie
   • Usuwaj nieaktywnych członków
   • Anuluj osierocone zaproszenia

3. Konwencje nazewnictwa

   • Używaj spójnych wzorców nazw tematów w zespole
   • Dokumentuj wzorce nazewnictwa w wiki/dokumentacji zespołu
   • Użyj prefiksów dla środowisk (prod-, staging-, dev-)

Bezpieczeństwo

1. Regularnie rotuj tokeny dostępu

   • Minimum co 90 dni
   • Po odejściu członka zespołu
   • Po podejrzeniu kompromitacji

2. Używaj odpowiednich typów tokenów

   • Osobiste klucze API dla indywidualnych osób
   • Tokeny dostępu do tematów dla wspólnych systemów
   • Minimalne wymagane uprawnienia

3. Tematy prywatne dla wrażliwych danych

   • Logi błędów ze śladami stosu
   • Powiadomienia o wdrożeniach ze szczegółami serwera
   • Alerty specyficzne dla klienta

Zarządzanie limitami szybkości

1. Monitoruj użycie

   • Sprawdzaj panel cotygodniowo
   • Ustaw alerty przy progu 80%
   • Planuj aktualizacje przed osiągnięciem limitów

2. Optymalizuj tematy o dużej objętości

   • Grupuj wiadomości, gdy to możliwe
   • Używaj odpowiednich poziomów priorytetów
   • Filtruj gadatliwe logi przed publikowaniem

3. Rozdziel zagadnienia

   • Różne tematy dla różnych środowisk
   • Oddziel logi debugowania od krytycznych alertów
   • Używaj tagów do kategoryzacji

Typowe scenariusze

Konfiguracja zespołu programistów

Cel: Utwórz zespół dla 5 programistów do udostępniania powiadomień o wdrożeniach

Kroki:

1. Właściciel (alice@company.com) subskrybuje plan TEAM S
2. Alice tworzy zespół "Engineering"
3. Alice zaprasza 4 programistów jako Members (wszyscy mogą używać FREE tier)
4. Alice tworzy tematy:
   • deployment-production (prywatny)
   • deployment-staging (prywatny)
   • errors-backend (prywatny)
   • alerts-critical (publiczny)
5. Wszyscy programiści mogą teraz publikować do tych tematów używając limitów poziomu TEAM Alice

Wynik:

• ✅ Jedna subskrypcja pokrywa cały zespół
• ✅ 25 000 wiadomości/dzień dzielonych w zespole
• ✅ Retencja wiadomości przez 45 dni
• ✅ Wszyscy programiści mogą swobodnie publikować

Integracja CI/CD

Cel: GitHub Actions publikuje powiadomienia o wdrożeniach

Kroki:

1. Administrator tworzy token dostępu do tematu dla deployment-prod
2. Token przechowywany w GitHub Secrets jako NOTIFER_TOKEN
3. Przepływ pracy GitHub Actions:

   - name: Notify deployment
     run: |
       curl -d "Deployed to production" \
         -H "X-Topic-Token: ${{ secrets.NOTIFER_TOKEN }}" \
         https://app.notifer.io/deployment-prod

Wynik:

• ✅ Automatyczne powiadomienia o wdrożeniach
• ✅ Brak danych uwierzytelniających użytkownika w pipeline
• ✅ Token może być rotowany przez dowolnego administratora

Rozwiązywanie problemów

Nie można utworzyć zespołu

Błąd: "Wymagana aktualizacja do planu TEAM"

Rozwiązanie:

1. Przejdź do Ustawienia → Subskrypcja
2. Kliknij "Uaktualnij do TEAM"
3. Dokończ płatność
4. Spróbuj ponownie utworzyć zespół

Zaproszenie nie otrzymane

Możliwe przyczyny:

• E-mail w folderze spam
• Literówka w adresie e-mail
• Opóźnienie doręczenia e-maila

Rozwiązania:

1. Sprawdź folder spam
2. Wyślij ponownie zaproszenie ze strony zespołu
3. Anuluj i utwórz nowe zaproszenie z poprawnym e-mailem

Członek nie może publikować

Możliwe przyczyny:

• Wyczerpane limity szybkości właściciela zespołu
• Właściciel zespołu obniżył subskrypcję
• Temat jest osobisty, nie zespołowy

Debugowanie:

1. Sprawdź typ tematu:

   • Przejdź do strony tematu
   • Szukaj odznaki "Zespół: [nazwa]"

2. Sprawdź użycie właściciela zespołu:

   • Właściciel powinien sprawdzić panel
   • Szukaj ostrzeżeń o dziennym/godzinnym limicie

3. Sprawdź status zespołu:

   • Zweryfikuj, że właściciel ma aktywną subskrypcję TEAM
   • Sprawdź, że zespół nie jest oznaczony jako nieaktywny

Limity szybkości za niskie

Scenariusz: Zespół często osiąga limit 25k/dzień

Rozwiązania:

1. Natychmiastowe:

   • Zmniejsz częstotliwość odpytywania
   • Filtruj wiadomości o niskim priorytecie
   • Grupuj, gdy to możliwe

2. Długoterminowe:

   • Rozważ wyższy wariant TEAM lub skontaktuj się z obsługą
   • Optymalizuj wyzwalacze powiadomień
   • Przejrzyj architekturę tematów

FAQ

Czy wszyscy członkowie zespołu potrzebują subskrypcji TEAM?

Nie! Tylko właściciel zespołu potrzebuje subskrypcji TEAM. Wszyscy inni członkowie mogą używać kont FREE tier i nadal publikować do tematów zespołowych z limitami poziomu TEAM właściciela.

Co się stanie, jeśli właściciel obniży poziom?

Zespół staje się nieaktywny. Tematy zespołowe pozostają, ale członkowie nie mogą do nich publikować. Zespół może być reaktywowany przez aktualizację z powrotem do poziomu TEAM.

Czy członkowie mogą tworzyć tematy?

Nie. Tylko właściciel zespołu i administratorzy mogą tworzyć tematy zespołowe. Zwykli członkowie mogą tylko publikować do istniejących tematów.

Jak różnią się tematy osobiste od zespołowych?

Tematy zespołowe używają limitów szybkości i retencji właściciela. Tematy osobiste używają limitów własnego poziomu użytkownika. Członkowie korzystają z poziomu TEAM właściciela tylko dla tematów zespołowych.

Czy mogę przenieść własność zespołu?

Obecnie transfer własności nie jest dostępny przez interfejs. Skontaktuj się z support@notifer.io w sprawie pomocy z transferami własności.

Jaka jest różnica między Administratorami a Członkami?

Administratorzy mogą zarządzać członkami zespołu, tworzyć/edytować tematy i zarządzać tokenami dostępu. Członkowie mogą tylko publikować do tematów - idealni dla programistów, którzy nie potrzebują dostępu do zarządzania.

Ile zespołów mogę utworzyć?

Nie ma twardego limitu na zespoły, ale potrzebujesz subskrypcji TEAM dla każdego zespołu, którego jesteś właścicielem. Możesz być członkiem nieograniczonej liczby zespołów bez żadnej subskrypcji.

Czy mogę zobaczyć, który członek zespołu opublikował wiadomość?

Jeśli członkowie używają osobistych kluczy API, tak - metadane wiadomości zawierają wydawcę. Z tokenami dostępu do tematów, nie - są one wspólne i nie śledzą indywidualnych wydawców.

Kolejne kroki

• Tworzenie tematów - Dowiedz się o tworzeniu tematów
• Klucze API - Generuj osobiste klucze API
• Tokeny dostępu do tematów - Zarządzaj wspólnymi tokenami
• Ustawienia użytkownika - Skonfiguruj swoje konto

---

Potrzebujesz pomocy?

• Sprawdź FAQ po częste pytania
• Zobacz Rozwiązywanie problemów po rozwiązywanie problemów
• Skontaktuj się z obsługą: support@notifer.io