Документація Kumquat

Інструментарій креативної команди.

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

Mongo-схема

Колекції products → tasks → creatives, дзеркало users із Clerk.

Воркфлоу задач

Статуси, переходи, автоматичне створення креативів і неймінг.

Node-граф

Типізований DAG-executor і canvas-редактор.

Архітектура frontend

Роути, модулі, сутності та сервіси Kumquat Client.

Довідник API

Усі ендпоінти, згенеровані з backend/openapi.json.

Агент-аналітик

Чат, який відповідає на аналітичні питання по креативах.

Як це зібрано

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

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

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