Jak dostat od klienta použitelné soubory, ne jen soubory

Klientovo „logo" bývá screenshot vizitky ve formátu JPEG, nebo PNG exportované na 150 pixelů šířky, protože to se vešlo do starého e-mailového podpisu. Vektorový soubor, pokud vůbec existoval, leží na notebooku grafika ze staré zakázky. Požádáte znovu, dostanete stejný soubor, a musíte znovu vysvětlit, co znamená „vektor".

Fotky přicházejí stejně: přeposlané přes WhatsApp, který všechno rekompresuje, takže fotka, co na klientově telefonu vypadala v pořádku, je nepoužitelná, jakmile má vyplnit banner na homepage. PDF jako menu nebo ceník přijdou jako fotka vytištěného papíru z mobilu, nakřivo, s palcem v rohu.

Nic z toho není klientova nedbalost. Neví, co znamená „minimálně 512px" nebo „vektorový formát", a nemá jak si to před odesláním ověřit. Než chybu zjistíte, už jste vyčerpali kredit jednoho „můžeš to poslat znovu" — a někdy jich je potřeba i třikrát.

Agent definuje přesně to, co potřebuje, s kontrolami zabudovanými přímo do položky — žádné samostatné instrukce typu „ujistěte se, že...", které si má klient pamatovat:

{
  "project_name": "Bella Cucina — Brand Assets",
  "client": {
    "name": "Marco Esposito",
    "email": "marco@bellacucina.cz"
  },
  "items": [
    {
      "key": "logo",
      "type": "image",
      "label": "Restaurant logo",
      "help": "SVG preferred, or PNG with a transparent background, at least 512px on the shortest side.",
      "required": true,
      "constraints": {
        "formats": ["svg", "png"],
        "min_width": 512,
        "transparent_background": true
      }
    },
    {
      "key": "favicon_source",
      "type": "image",
      "label": "Favicon source image",
      "help": "A square version of the logo, at least 512x512px, used to generate the site icon.",
      "required": true,
      "constraints": {
        "formats": ["png"],
        "min_width": 512,
        "min_height": 512
      }
    },
    {
      "key": "brand_colors",
      "type": "color_list",
      "label": "Brand colors",
      "required": true
    },
    {
      "key": "photos",
      "type": "file_list",
      "label": "Food and interior photos",
      "help": "5 to 15 photos, straight from your phone camera is fine.",
      "required": true,
      "constraints": {
        "formats": ["jpg", "png", "heic"],
        "min_count": 5,
        "max_count": 15
      }
    },
    {
      "key": "menu_and_price_list",
      "type": "file_list",
      "label": "Menu and price list (PDF)",
      "required": true,
      "constraints": {
        "formats": ["pdf"],
        "max_bytes": 10485760,
        "max_count": 3
      }
    }
  ],
  "chase_schedule": "default"
}

get_intake_results vrátí každý přijatý soubor jako signovaný odkaz platný 24 hodin, spolu s názvem souboru, MIME typem, rozměry a checksumem — stačí ho stáhnout a rovnou umístit. HEIC fotky z iPhonu jsou v tu chvíli už převedené na JPEG.

Přestanete dostávat soubory, které nejde použít, a pak vysvětlovat proč. Každý upload už při odeslání splňoval formát a velikost, které jste požadovali, protože je zkontroloval portál a klient hned viděl důvod, když ne. Co se vrátí, je připravené vložit do buildu: logo je vektor nebo správně velké PNG, fotky mají potřebnou šířku, PDF se otevírají čistě. Kolo tam-a-zpět, které bývalo běžné, většinou zmizí.