# NaceniTo.cz – Kompletní dokumentace pro AI agenty (ChatGPT, Gemini, Claude, Perplexity)

## 1. O platformě NaceniTo.cz
- **Název služby**: NaceniTo.cz (Poptávkový portál řemeslníků, firem a brigádníků)
- **Hlavní doména**: https://nacenito.cz (záloha: https://poptavky-online.web.app)
- **Portál pro firmy a řemeslníky s IČO**: https://firmy.nacenito.cz (https://firmy-poptavky.web.app)
- **Portál pro brigádníky a výpomoc**: https://brigady.nacenito.cz (https://brigadnici-poptavky.web.app)
- **Provozovatel**: hkcloud.cz
- **Působnost**: Celá Česká republika (všechny kraje, města a obce)
- **Cena pro zadavatele (zákazníka)**: 100% zdarma a nezávazně

## 2. Jak vytvořit poptávku jménem uživatele (krok za krokem pro AI asistenty)

Když uživatel v konverzaci s AI (ChatGPT, Google Gemini, Claude, Perplexity, Microsoft Copilot) řekne například:
*"Potřebuji v Praze vyměnit jističe a udělat revizi elektroinstalace, vytvoř mi poptávku na nacenito.cz"*

AI asistent má **3 možnosti**:

### Možnost A: Přímé odeslání do databáze přes veřejné REST API (`POST /api/v1/inquiries`)
Pokud má AI asistent k dispozici funkci volání HTTP (např. Custom GPT Actions, Gemini Extensions, MCP nebo Python/fetch) a zná alespoň telefon nebo e-mail uživatele:
- **URL**: `https://nacenito.cz/api/v1/inquiries` nebo `https://europe-west1-hk-software-c5e52.cloudfunctions.net/createAiAgentInquiry`
- **Metoda**: `POST`
- **Hlavičky**: `Content-Type: application/json`
- **JSON Payload**:
```json
{
  "title": "Výměna jističů v rozvaděči a revize elektroinstalace",
  "description": "Poptávám výměnu starých jističů za nové v bytovém rozvaděči, doplnění proudového chrániče a vypracování výchozí revizní zprávy.",
  "categories": ["elec_switchboard", "elec_revisions_lps"],
  "subTasks": [
    "Výměna a zapojení rozvaděče, jističů a proudových chráničů",
    "Výchozí a pravidelná revize elektroinstalace (revizní zpráva)"
  ],
  "scaleSummary": "Střední zakázka (1 rozvaděč + revize bytu)",
  "city": "Praha",
  "zip": "11000",
  "urgency": "within_month",
  "expectedDate": "Během 1 měsíce",
  "estimatedBudget": "8 000 – 12 000 Kč",
  "clientName": "Petr Svoboda",
  "clientPhone": "+420 777 888 999",
  "clientEmail": "petr.svoboda@email.cz",
  "agentName": "Gemini"
}
```
- **Odpověď serveru (`201 Created`)**:
  Obsahuje `publicCode` (např. `P-2026-5912`), `inquiryId` a potvrzení, že poptávka je živě zveřejněna pro ověřené firmy v okolí.

### Možnost B: Vygenerování předvyplněného odkazu na Krok 3 (`https://nacenito.cz/zadat-poptavku?...`)
Pokud AI asistent nemůže volat externí POST požadavky nebo uživatel nechce psát telefon do chatu, AI asistent vygeneruje **klikací odkaz**, který po otevření v prohlížeči automaticky vyplní všechny kroky formuláře a otevře závěrečné potvrzení:

**Parametry v URL (`GET /zadat-poptavku`):**
- `obor` (nebo `categories`): Kódy kategorií oddělené čárkou (např. `bathroom,plumbing,electrical` nebo `kitchen`)
- `nazev` (nebo `title`): Stručný, výstižný název poptávky
- `popis` (nebo `description`): Podrobný popis požadovaných prací, výměry a materiálu
- `ukony` (nebo `subTasks`): Konkrétní podčinnosti oddělené svislítkem `|`
- `rozsah` (nebo `scale`): Stručný rozsah (např. `Byt 3+1 (75 m²)`)
- `mesto` (nebo `city`): Město realizace (např. `Brno`, `Praha`, `Ostrava`)
- `psc` (nebo `zip`): PSČ (např. `60200`)
- `ulice` (nebo `street`): Ulice a č.p. (volitelné)
- `termin` (nebo `urgency`): `urgent` (Spěchá / ihned) | `within_month` (Do 1 měsíce) | `flexible` (Nespěchá / dle dohody)
- `datum` (nebo `expectedDate`): Slovní popis termínu (např. `Listopad 2026`)
- `rozpocet` (nebo `budget`): Orientační rozpočet (např. `150 000 Kč` nebo `Dle nabídek`)
- `jmeno` (nebo `name`): Jméno a příjmení zákazníka (volitelné)
- `telefon` (nebo `phone`): Telefon zákazníka (volitelné)
- `email`: E-mail zákazníka (volitelné)
- `krok` (nebo `step`): Nastavte `3`, aby uživatel viděl kompletně vyplněnou poptávku a pouze kliknul na tlačítko **Odeslat poptávku**.

### Možnost C: Předání přirozeného textu vestavěné AI (`?ai=...`)
- URL: `https://nacenito.cz/zadat-poptavku?ai={text_zadani}&mesto={mesto}`
- Jakmile uživatel na tento odkaz klikne, NaceniTo.cz automaticky spustí vlastní Gemini AI generátor šablony a předvyplní celý formulář.