# Zrcadlení Jiry (https://docs.vitrinka.ai/cs/pm/mirror)



## Vedle trackeru, když o to stojíte [#why]

Projekt můžete vést samostatně ve vitrince nebo jeho úkoly propojit s Jirou. Synchronizaci nastavujete pro každý projekt zvlášť.

## Který systém má přednost [#truth]

Nastavení určuje konektor, zdroj pravdy — `local` (vitrinka) nebo `remote` (Jira) — a mapování stavů. Při synchronizaci se změny přenesou ze zvoleného zdroje. Pokud se stejný úkol změnil na obou stranách, přednost má zvolený zdroj a přepsání se zaznamená jako událost `mirrored`.

| Nastavení         | Význam                                                                                                                 |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------- |
| `connector`       | `jira` — použije připojení workspace k Jiře z Nastavení → Trackers (bez něj server odpoví 409); prázdné zrcadlo zruší. |
| `truth`           | `local`, nebo `remote` — která strana vyhraje konflikt.                                                                |
| `config.stateMap` | Klíč stavu projektu → status v Jiře.                                                                                   |

```json
{"connector":"jira","truth":"local","config":{"stateMap":{"in_review":"In Review"}}}
```

## Navázání a synchronizace [#admin]

Správce nastaví propojení přes `PUT /api/v1/projects/{project}/mirror` a spustí synchronizaci přes `POST /api/v1/projects/{project}/mirror/sync`. Obě operace používají uložené přihlašovací údaje workspace k trackeru. Synchronizace přenese změny od předchozího běhu a zapíše `syncedAt`. Propojení úkolů se nastavuje přes API; nastavení Trackers v prohlížeči slouží k převodu hlášení na tikety.

## Co se zrcadlí [#scope]

Ven: název, tělo (s odkazem zpět na úkol), štítky při založení tiketu a stav přes mapu. Dovnitř: název tiketu, jeho status a řešitel. Priorita, komentáře, sprinty, milníky, pořadí a drafty příjmu zůstávají lokální — jsou to vlastní slovník vitrínky.

<Callout type="info">
  Plane jako zrcadlo záměrně zapojený není. Integrace s Plane, kterou instalace může nastavit, přidá na odkazovaný issue jeden komentář na publikovanou sadu; úkoly nezrcadlí.
</Callout>