Export podkladů

BriefGate umí vše, co klient odevzdá, poslat rovnou do vašeho vlastního Google Drive nebo Dropboxu — žádné stahování souborů a jejich ruční přehazování jinam. Poskytovatele stačí připojit jednou a každý další sběr podkladů se pak umí exportovat sám, jakmile skončí.

Co získáte

Stažení všeho v ZIPu

Místo trvalého připojení na Drive nebo Dropbox si celý obsah sběru podkladů stáhněte jednorázově jako jeden ZIP — ze stránky detailu sběru podkladů v dashboardu, nebo přes GET /v1/intakes/:id/download.

podklady-bella-napoli-website-in_8f3kQmR2.zip
├── podklady.pdf
├── podklady.md
├── Logo/
│   └── bella-napoli-logo.png
└── Food and interior photos/
    ├── photo-1.jpg
    ├── photo-2.jpg
    └── photo-3.jpg

podklady.pdf je čitelný přehled každé položky — štítek, typ, stav, odevzdaná hodnota, rozhodnutí i prominuté položky s důvodem — pro člověka, který chce jeden dokument místo otevírání dashboardu. podklady.md nese stejný obsah v Markdownu, pro skript nebo dalšího agenta ke zpracování. Každý nahraný soubor je ve své vlastní podsložce podle položky, přesně tak, jak ho klient odevzdal — žádné převzorkování, žádná změna formátu.

Soubor, který ještě prochází antivirovou kontrolou, se do ZIPu nedostane a uvede se jako čekající v podklady.pdf i podklady.md, stejně jako výše u summary.md — po vyčištění kontroly stáhněte znovu.

Zahrnutí přístupů je volitelné u každého stažení. Ve výchozím stavu se položky typu secret vynechají úplně, stejně jako u exportu do Disku/Dropboxu, takže zůstávají dostupné pro jednorázové odhalení v dashboardu. Zahrnutím do podklady.pdf — nikdy ne do podklady.md, který hodnoty secret nikdy nenese — se odhalí každá dosud neodhalená položka typu secret, a to odhalení je konečné: spotřebuje stejné jednorázové odhalení jako get_intake_results nebo tlačítko Zobrazit v dashboardu, a další stažení bez přístupů ho nevrátí zpět. Položka odhalená už dřív se zobrazí jako already revealed on <datum> bez ohledu na to, co zvolíte tentokrát. Samotné jednorázové odhalení popisuje Trezor na přístupy. Zahrnout přístupy smí jen vlastní session vlastníka účtu, nebo API klíč se scopem secrets:read nebo admin — kdokoli jiný dostane 403 forbidden (reason secrets_owner_only).

Limit velikosti. Sběr podkladů nad 500 MB se pro stažení ZIPu odmítne (413 download_too_large). Použijte místo toho export do Google Drive nebo Dropboxu — ten žádný limit velikosti nemá.

Připojení Google Drive

V Nastavení → Export podkladů klikněte na Připojit Google Drive, přihlaste se a schvalte souhlasovou obrazovku. BriefGate žádá jen o rozsah Google drive.file: vidí a zapisuje jen soubory a složky, které si sám vytvořil, nic jiného ve vašem Disku. Automatický export se zapne hned po úspěšném připojení.

Připojení Dropboxu

V Nastavení → Export podkladů klikněte na Připojit Dropbox, přihlaste se a schvalte přístup. BriefGate žádá oprávnění omezená na vlastní složku aplikace (files.content.write, files.metadata.write, files.metadata.read, account_info.read) — zapisuje jen do své vlastní složky ve vašem Dropboxu, ne do celého účtu. Stejně jako u Google Drive je automatický export ve výchozím stavu zapnutý a dá se nezávisle vypnout.

Odpojení kteréhokoli poskytovatele (ze stejné obrazovky, nebo přes DELETE /v1/account/exports/:provider) okamžitě zruší OAuth token a smaže ho z BriefGate. Dosavadní exporty ve vašem Disku nebo Dropboxu zůstávají — odpojení zastaví jen ty budoucí.

Automatický vs. ruční export

Se zapnutým Export automaticky po dokončení sběru podkladů spustí BriefGate export ve chvíli, kdy dorazí všechny povinné položky — ve stejném okamžiku, kdy se spouští webhook intake.completed. S vypnutou volbou neodejde nic, dokud export nespustíte sami. Automatický cíl může být jen jeden: zapnutí přepínače u druhého poskytovatele se odmítne, dokud ho nevypnete u prvního. Ruční export si poskytovatele vybere vždy.

Ruční export funguje ze stránky detailu sběru podkladů, nebo přes POST /v1/intakes/:id/export, a není omezen na dokončené sběry podkladů — exportujte, co zatím dorazilo, a zbytek doexportujte později.

Co je ve složce

Nejvyšší složka se jmenuje BriefGate / <název projektu> (<id sběru podkladů>), například:

BriefGate / Bella Napoli — Website (in_8f3kQmR2)
├── Logo/
│   └── bella-napoli-logo.png
├── Food and interior photos/
│   ├── photo-1.jpg
│   ├── photo-2.jpg
│   └── photo-3.jpg
└── summary.md

Podsložku dostanou jen položky se soubory. Vše ostatní — text, strukturované odpovědi, rozhodnutí — je jen v summary.md:

markdown
# Bella Napoli — Website
Intake in_8f3kQmR2 · exportováno 2026-09-05T10:22:00Z

## Logo (image) — approved
Soubor(y) ve ./Logo/

## Hero section tagline (longtext) — approved
Real Napoli-style pizza, right in your neighbourhood.

## Opening hours (structured) — approved
mon_fri: 12:00-22:00
sat: 12:00-23:00
sun: 13:00-21:00

## Testimonial video (file) — waived
Prominuto vlastníkem: "Client doesn't have one yet."

## Delivery zone map (image) — pending virus scan
Zatím neexportováno — soubor ještě prochází antivirovou kontrolou.

## WordPress admin credentials (secret) — approved
Tajná položka — neexportuje se. Viz dashboard nebo `get_intake_results`.

Prominuté položky jsou uvedené i s důvodem prominutí. Soubor, který ještě prochází antivirovou kontrolou, se přeskočí a poznamená, místo aby export čekal — po vyčištění kontroly stačí sběr podkladů exportovat znovu.

Tajné položky se neexportují nikdy. summary.md položku pojmenuje, aby nic nechybělo v přehledu, ale hodnotu ani žádnou její stopu — dokonce ani to, jestli byla vyplněná — přes tuhle funkci BriefGate neopouští. Hodnotu tajné položky přečtete obvyklou cestou: jednorázovým odhalením v dashboardu, nebo přes get_intake_results se scope secrets:read.

Opakovaný export a přepisování

Export sběru podkladů, který už byl exportovaný, zapisuje do stejné složky a přepíše soubory aktuální verzí — nevytváří druhou kopii. Tak se doexportují položky, které dorazily po prvním exportu, nebo se obnoví summary.md po vyčištění čekající kontroly.

Pokud po neúspěšném exportu zůstala rozdělaná složka, opakovaný export ji dokončí, místo aby začínal znovu od nuly.

Bezpečnost a soukromí

API

Spuštění exportu

bash
curl -X POST https://api.briefgate.dev/v1/intakes/in_8f3kQmR2/export \
  -H "Authorization: Bearer bg_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{"provider": "google_drive"}'

provider je volitelný — bez něj se exportuje ke každému připojenému poskytovateli se zapnutým automatickým exportem. Vrací 202 okamžitě, export běží asynchronně:

json
{ "intake_id": "in_8f3kQmR2", "export": { "status": "pending", "provider": "google_drive" } }

Průběh sledujte na GET /v1/intakes/:id — nese aktuální stav v poli export:

json
"export": {
  "status": "completed",
  "provider": "google_drive",
  "url": "https://drive.google.com/drive/folders/1AbCdEfGhIjKlMnOpQrSt",
  "exported_at": "2026-09-05T10:22:03Z",
  "error": null
}

status je pending, completed, nebo failed. U failed nese error zprávu od poskytovatele.

Nastavení exportu na účtu

bash
curl https://api.briefgate.dev/v1/account/exports \
  -H "Authorization: Bearer bg_live_xxxxx"
json
{
  "providers": [
    {
      "provider": "google_drive",
      "connected": true,
      "account_email": "[email protected]",
      "auto_export": true,
      "connected_at": "2026-08-20T09:00:00Z"
    },
    { "provider": "dropbox", "connected": false }
  ]
}

Přepnutí automatického exportu:

bash
curl -X PATCH https://api.briefgate.dev/v1/account/exports/google_drive \
  -H "Authorization: Bearer bg_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{"auto_export": false}'

Odpojení poskytovatele, se zrušením a smazáním tokenu:

bash
curl -X DELETE https://api.briefgate.dev/v1/account/exports/dropbox \
  -H "Authorization: Bearer bg_live_xxxxx"

Vrací 204. Připojení poskytovatele poprvé vyžaduje OAuth přesměrování a jde udělat jen z dashboardu — REST endpoint pro to není.

Kontrola před stažením ZIPu

bash
curl https://api.briefgate.dev/v1/intakes/in_8f3kQmR2/download/preflight \
  -H "Authorization: Bearer bg_live_xxxxx"
json
{
  "files": 6,
  "bytes": 18420531,
  "skipped_files": 1,
  "secrets": { "total": 2, "unrevealed": 1, "already_revealed": 1 },
  "too_large": false,
  "max_bytes": 524288000,
  "filename": "podklady-bella-napoli-website-in_8f3kQmR2.zip"
}

skipped_files je počet nahraných souborů, které ještě čekají na antivirovou kontrolu a do ZIPu se nedostanou. secrets.unrevealed udává, kolik přístupů zůstane dostupných pro jednorázové odhalení, pokud necháte include_secrets vypnuté; secrets.already_revealed se v obou případech zobrazí jako text o dřívějším odhalení. too_large odpovídá tomu, jestli by volání stažení níže vrátilo 413.

Stažení ZIPu

bash
curl "https://api.briefgate.dev/v1/intakes/in_8f3kQmR2/download?include_secrets=false" \
  -H "Authorization: Bearer bg_live_xxxxx" \
  -o podklady.zip

Vrací application/zip s hlavičkou Content-Disposition: attachment; filename="podklady-bella-napoli-website-in_8f3kQmR2.zip". include_secrets je ve výchozím stavu false; nastavením na true se odhalí a do podklady.pdf zahrnou hodnoty přístupů — jen session vlastníka nebo klíč se scopem secrets:read/admin, viz Stažení všeho v ZIPu výše. V obou případech se zaznamená audit event intake.downloaded.

Řešení potíží

Časté dotazy

Nahrazuje to get_intake_results? Ne. Agent volající get_intake_results už dostává signed URL a typovaná data přímo; export existuje pro člověka, který žije v Disku nebo Dropboxu a chce tytéž podklady tam, aniž by o ně musel žádat agenta.

Můžu exportovat do sdíleného Disku nebo týmové složky místo osobního účtu? Zatím ne — export jde na účet, kterým jste se přihlásili.

Smaže odpojení i to, co už bylo exportované? Ne. Odpojení jen ruší přístup do budoucna; soubory už umístěné ve vašem Disku nebo Dropboxu zůstávají, kde jsou.