Ponk je v aktivním vývoji. Stabilní release plánujeme brzy — některé funkce mohou být ještě v přípravě.

Přeskočit na obsah
Ponk
Zpět na docs

Propojení tří produktů — datové modely

Vlastník dat

CRM je primární zdroj. Web a Chat čerpají z veřejného API CRM. Web má fallback snapshoty (legal stránky), Chat má vlastní databázi pro RAG knowledge base a session state.

Tok dat

ZdrojCílCo
Web (formulář)CRMNová poptávka (FormSubmission) — operátor ji potvrdí a převede na zakázku
Web (e-shop)CRMNová objednávka (ShopOrder), sklad se rezervuje
CRMWeb (cache 5 min)Ceník, pobočky, blog, ohlášky
Chat botCRM (read)Bot čte z veřejných endpointů (ceník, pobočky, ohlášky)
Chat → WebrezervaceBot dovede k webovému formuláři pro rezervaci
CRMMCP klientStdio MCP server pro Claude Desktop / vlastní agenty (read + draft + write tools)

Identifikátory

CRM používá cuid() pro primární klíče (např. clxk2y7m...). Veřejně se objekty referují přes code (např. zakázka P-260042) nebo public token (např. e-shop produkty).

Co se neukládá v duplikátu

Zakázky, sklad, faktury, zákazníci žijí jen v CRM. Web a Chat je nedrží.

Co se ukládá samostatně

  • Weblegal-snapshots/ fallback obsahu pro případ výpadku CRM.
  • Chat má vlastní PostgreSQL s pgvector pro RAG knowledge base a bot_conversation_sessions pro stav konverzace.