Repozytoria
Organizuj źródła w repozytoria i kontroluj dostęp.
Repozytorium to nadrzędny pojemnik na powiązane kolekcje i źródła. Pozwala oddzielić dane różnych działów lub klientów i precyzyjnie zarządzać tym, kto ma do nich dostęp.
Czym jest repozytorium
Repozytorium grupuje powiązane materiały w jedną, odrębną przestrzeń wiedzy. Wewnątrz repozytorium tworzysz kolekcje, a do kolekcji dodajesz źródła — dokumenty, strony i dane, które raggy indeksuje.
Najczęściej tworzysz osobne repozytorium dla każdego działu, projektu lub klienta. Dzięki temu dane nie mieszają się ze sobą, a uprawnienia ustawiasz raz — na poziomie całego repozytorium.
W skrócie: Repozytorium to granica izolacji danych i dostępu. Wszystko, co znajdzie się w jednym repozytorium, dzieli te same reguły uprawnień.
Struktura
Dane w raggy układają się w prostą, trzypoziomową hierarchię. Każdy poziom ma jasną odpowiedzialność:
| Poziom | Zawiera | Rola |
|---|---|---|
| Repozytorium | Kolekcje | Izolacja danych i granica dostępu |
| Kolekcja | Źródła | Tematyczne grupowanie materiałów |
| Źródło | Treść | Pojedynczy dokument, strona lub dane |
W praktyce: jedno repozytorium może zawierać wiele kolekcji (np. Dokumentacja i FAQ), a każda kolekcja — wiele źródeł. Repozytorium nigdy nie przechowuje źródeł bezpośrednio; źródła zawsze należą do kolekcji.
Kontrola dostępu
Dostęp do repozytorium nadajesz na poziomie roli. Rola decyduje o tym, czy użytkownik może czytać dane, edytować je, czy zarządzać samym repozytorium.
| Rola | Odczyt | Zapis | Zarządzanie |
|---|---|---|---|
| Menedżer | Tak | Tak | Tak |
| Członek | Tak | Nie | Nie |
| Bez dostępu | Nie | Nie | Nie |
- Odczyt — przeglądanie kolekcji i źródeł oraz korzystanie z nich w rozmowach.
- Zapis — dodawanie, edycja i usuwanie źródeł oraz kolekcji.
- Zarządzanie — zmiana ustawień repozytorium oraz nadawanie dostępu innym.
Dziedziczenie: Uprawnienia ustawione na repozytorium obowiązują we wszystkich jego kolekcjach i źródłach. Nie musisz konfigurować dostępu osobno dla każdej kolekcji.
Dobre praktyki
- Twórz osobne repozytorium dla każdego klienta lub działu — ułatwia to izolację danych i audyt.
- Nadawaj rolę Członek użytkownikom, którzy mają tylko czytać i rozmawiać; rolę Menedżer — osobom odpowiedzialnym za treść.
- Nazywaj repozytoria jednoznacznie, np. wg klienta lub obszaru, aby uniknąć pomyłek przy dodawaniu źródeł.
- Nie mieszaj danych poufnych różnych klientów w jednym repozytorium.
Zasada minimalnego dostępu: Nadawaj najwęższy zakres uprawnień, który wystarcza do pracy. Łatwiej później rozszerzyć dostęp niż cofnąć zbyt szeroki.