> ## Documentation Index
> Fetch the complete documentation index at: https://www.twicecommerce.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Viditelné oblasti

> Viditelné oblasti a skrývání jednotlivých karet určují, které sekce a karty se zobrazují v administraci, nezávisle na oprávněních k přístupu k datům.

**Viditelné oblasti** určují, které sekce nejvyšší úrovně se zobrazují v bočním panelu administrace pro danou roli. **Skryté karty** tento princip rozšiřují na jednotlivé karty uvnitř stránky: role může skrýt konkrétní karty v rámci sekce, aniž by odstranila samotnou sekci. Obojí je nezávislé na oprávněních k přístupu k datům.

## Jak to funguje

Každá role, systémová nebo vlastní, nese dvě oddělená pole:

* **Oprávnění** – přístup k datům vynucovaný serverem. Řídí, co API vrátí danému uživateli. Příklad: oprávnění `customers:view` umožní uživateli číst data zákazníků.
* **Viditelné oblasti** – přítomnost v UI na straně klienta. Řídí, které sekce se zobrazují v bočním panelu administrace a jsou dostupné přes URL. Příklad: `customers` ve `visibleAreas` zobrazí kartu Zákazníci.

Tyto dvě osy jsou nezávislé. Uživatel může mít oprávnění `customers:view` (kvůli podpoře mezizdrojových postupů, jako je výběr zákazníka u objednávky), aniž by se sekce Zákazníci zobrazovala v bočním panelu.

### Asymetrické pravidlo

Viditelné oblasti se řídí jedním směrovým omezením:

* **Zobrazení oblasti vynutí přístup k datům.** Pokud je `customers` ve `visibleAreas`, role musí mít i oprávnění `customers:view`. Matice oprávnění to vynucuje automaticky: zapnutí viditelnosti oblasti doplní chybějící oprávnění `:view`.
* **Přístup k datům nevynutí viditelnost.** Udělení `customers:view` automaticky nepřidá `customers` do `visibleAreas`. Boční panel zůstane beze změny.

Díky tomu můžeš sestavit role jako „Správce objednávek s přístupem k datům zákazníků, ale bez karty Zákazníci“: uživatel může vybírat zákazníky přímo v toku objednávky, aniž by v bočním panelu viděl vyhrazenou sekci Zákazníci.

### Řešení napříč rolemi

Efektivní viditelné oblasti uživatele jsou **sjednocením** všech přiřazených rolí: systémové role plus libovolných vlastních rolí. Pokud kterákoli role oblast obsahuje, oblast se v bočním panelu zobrazí.

```json Příklad výsledného řešení theme={null}
{
  "system_role": "member",
  "system_role_visible_areas": [
    "tasks", "inventory", "catalog",
    "orders", "customers", "online_store"
  ],
  "custom_roles": [
    {
      "name": "Finance Viewer",
      "visible_areas": ["finance"]
    }
  ],
  "effective_visible_areas": [
    "tasks", "inventory", "catalog",
    "orders", "customers", "online_store",
    "finance"
  ]
}
```

Systémová role Člen ve výchozím stavu neobsahuje `finance`, ale vlastní role „Finance Viewer“ ji přidá. Uživatel vidí všech sedm sekcí.

### Dostupné oblasti

Viditelné oblasti se mapují jedna ku jedné na zdroje administrace nejvyšší úrovně:

| Oblast | Sekce bočního panelu |
| :- | :- |
| `tasks` | Úkoly |
| `inventory` | Inventář |
| `catalog` | Katalog |
| `orders` | Objednávky |
| `customers` | Zákazníci |
| `online_store` | Internetový obchod (a další prodejní kanály) |
| `reports` | Reporty |
| `location_settings` | Nastavení polohy |
| `account_settings` | Nastavení účtu |
| `finance` | Finance |

### Viditelnost jednotlivých karet

Kromě skrývání celých sekcí bočního panelu mohou role skrýt jednotlivé **karty** uvnitř sekce. Každá role nese seznam `hiddenTabs`: pole klíčů `resource:subResource`, které určuje, jaké karty se potlačí.

Karty se řídí sémantikou **průniku** (AND), opakem viditelných oblastí:

* **Viditelné oblasti** používají sjednocení: vyhrává jakákoli role, která oblast zobrazuje.
* **Skryté karty** používají průnik: karta je skrytá, jen když ji skrývá **každá** role přiřazená uživateli. Pokud ji kterákoli role nechá viditelnou, zobrazí se.

To znamená, že vždy vyhrává role s většími právy: přidání role nikdy neskryje kartu, kterou ukazuje jiná role.

```json Příklad průniku theme={null}
{
  "roles": [
    { "name": "Warehouse Lead", "hiddenTabs": ["orders:order_payments", "orders:order_documents"] },
    { "name": "Returns Handler", "hiddenTabs": ["orders:order_payments"] }
  ],
  "effective_hidden_tabs": ["orders:order_payments"]
}
```

Obě role skrývají `orders:order_payments`, takže zůstává skrytá. Jen jedna role skrývá `orders:order_documents`, takže karta Dokumenty se zobrazí.

### Karty, které lze skrýt

Každá karta v administraci je identifikovaná klíčem `resource:subResource`. Celá sada pokrývá všechny hlavní oblasti:

| Zdroj | Příklady karet |
| :- | :- |
| **orders** | `order_summary`, `order_line_items`, `order_customers`, `order_stock_items`, `order_fulfillment`, `order_payments`, `order_comments`, `order_documents`, `order_activity_log` |
| **catalog** | `listing_general`, `listing_attributes`, `listing_variants`, `listing_price`, `listing_limits`, `listing_fulfilment`, `listing_checkout`, `listing_seo`, `listing_documents`, `listing_orders_log`, `listing_activity_log`, `collection`, `collection_listings`, `collection_seo`, `price_table`, `discount` |
| **inventory** | `stock_item_general`, `stock_item_attributes`, `stock_item_cost`, `stock_item_fulfilment`, `stock_item_documents`, `stock_item_events`, `sku_general`, `sku_attributes`, `sku_stock_items`, `sku_documents` |
| **customers** | `customer_general`, `customer_attributes`, `customer_documents`, `customer_orders`, `customer_listings`, `customer_stock_items` |
| **online\_store** | `editor`, `default_content`, `settings` |
| **location\_settings** | `contact_info`, `opening_hours`, `sales_channels`, `document` |
| **account\_settings** | `business_details`, `general`, `brand`, `payment`, `policies`, `taxes`, `users_and_roles`, `notifications`, `languages`, `translations`, `integrations`, `domain`, `checkout`, `documents`, `file_manager`, `security` |
| **reports** | `sales_report`, `tax_report` |
| **finance** | `subscription_plan`, `billing` |

Každý klíč má prefix svého zdroje v API (např. `orders:order_payments`). Matice oprávnění v administraci je zobrazuje seskupené podle zdroje s jejich čitelnými názvy.

![Matice oprávnění se zaškrtávátky Zobrazit v UI pro jednotlivé karty](https://mintcdn.com/twicecommerce/5ARkyCTk5wMAizBn/images/settings-roles-permissions-tabs.webp?fit=max\&auto=format\&n=5ARkyCTk5wMAizBn\&q=85\&s=661daf9484677c2a99d98884844a4135)

### Výchozí hodnoty systémových rolí

Každá systémová role přichází s předdefinovanou sadou viditelných oblastí:

| Systémová role | Viditelné oblasti |
| :- | :- |
| **Majitel** | Všech 10 oblastí |
| **Správce** | Vše kromě `finance` |
| **Manažer** | Vše kromě `account_settings` a `finance` |
| **Člen** | `tasks`, `inventory`, `catalog`, `orders`, `customers`, `online_store` |

Vlastní role mohou tyto výchozí hodnoty rozšířit o oblasti, které systémová role neobsahuje.

Systémové role ve výchozím stavu neskrývají žádné karty: všechny karty jsou viditelné. Skrývání jednotlivých karet se konfiguruje jen přes vlastní role.

## Použití

### Konfigurace viditelnosti v matici oprávnění

Když vytváříš nebo upravuješ vlastní roli, matice oprávnění zobrazuje sloupec **Zobrazit v UI** vedle sloupců přístupu k datům (Spravovat, Vytvořit, Vymazat, Zobrazit data). Sloupec má dvě úrovně zaškrtávátek:

* **Řádek nejvyšší úrovně** – řídí sekci bočního panelu (viditelnou oblast). Přepnutím ji celou zobrazíš, nebo skryješ.
* **Řádky podzdrojů** – řídí jednotlivé karty uvnitř dané sekce. Rozbalením řádku nejvyšší úrovně se zobrazí zaškrtávátka pro jednotlivé karty.

Matice vynucuje asymetrické pravidlo na obou úrovních: zapnutí Zobrazit v UI automaticky zapne Zobrazit data pro daný zdroj nebo kartu. Vypnutí Zobrazit data automaticky vypne Zobrazit v UI.

### Když je viditelnost skrytá, ale přístup k datům zůstává

Skrytá oblast nebo karta neblokuje mezizdrojové postupy. Časté scénáře:

* **Výběr zákazníka v objednávkách** – role s oprávněním `customers:view`, ale bez `customers` ve viditelných oblastech, může při vytváření objednávky stále vyhledávat a vybírat zákazníky. Sekce Zákazníci je skrytá, ale výběr funguje.
* **Skrytá karta, viditelná data** – skrytí `orders:order_payments` odstraní kartu Platby z detailu objednávky, ale platební data dál proudí přes další zobrazení (např. souhrny na kartě Souhrn objednávky, reporty).
* **Přímé odkazy** – odkaz přímo na URL uvnitř skryté oblasti zobrazí stránku s omezeným přístupem. Oprávnění k datům dál platí na straně serveru, ale administrace stránku nevykreslí.

> [!WARNING]
>
> Viditelné oblasti a skryté karty jsou pohodlí na straně UI, ne bezpečnostní hranice. Řídí, co se zobrazuje v bočním panelu a na detailních stránkách. Neomezují přístup k API: přístup k datům řídí výhradně oprávnění.

## Související články

> **[Uživatelé a role](https://www.twicecommerce.com/docs/cs/settings/users-roles.md)**
>
> Spravuj členy týmu, přiřazuj role a konfiguruj oprávnění.

> **[Boční panel](https://www.twicecommerce.com/docs/cs/global-navigation/sidebar.md)**
>
> Jak je organizovaný boční panel administrace a co obsahuje každá sekce.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.