---
title: Документація Kumquat
description: Інструментарій креативної команди.
---

Тут зібрана вся документація по бекенду й фронтенду, а також
довідник API, згенерований зі схеми самого застосунку.

<CardGroup cols={2}>
  <Card title="Mongo-схема" icon="database" href="/backend/db-schema">
    Колекції products → tasks → creatives, дзеркало users із Clerk.
  </Card>
  <Card title="Воркфлоу задач" icon="workflow" href="/backend/workflow">
    Статуси, переходи, автоматичне створення креативів і неймінг.
  </Card>
  <Card title="Node-граф" icon="network" href="/backend/node-graphs">
    Типізований DAG-executor і canvas-редактор.
  </Card>
  <Card title="Архітектура frontend" icon="layout-dashboard" href="/frontend/frontend-architecture">
    Роути, модулі, сутності та сервіси Kumquat Client.
  </Card>
  <Card title="Довідник API" icon="code" href="/api">
    Усі ендпоінти, згенеровані з `backend/openapi.json`.
  </Card>
  <Card title="Агент-аналітик" icon="bot" href="/guide/analyst-agent-overview">
    Чат, який відповідає на аналітичні питання по креативах.
  </Card>
</CardGroup>

## Як це зібрано

Сайт будує [Blume](https://useblume.dev) із markdown-файлів у `docs/`. Сторінки,
навігація й пошук виводяться зі структури папок — щоб додати сторінку, достатньо
покласти `.md` файл у потрібну теку й прописати `title` та `description` у
frontmatter.

```bash
npm run docs:dev        # локальний сервер із hot-reload
npm run docs:build      # продакшн-збірка в dist/
npm run docs:validate   # перевірка внутрішніх посилань
```

Довідник API читається напряму з `backend/openapi.json`, який комітиться в репо
й перевіряється воркфлоу `api-contract`, тож він не може розійтися з бекендом.