TKBK Studio
TKBK Studio
Форма → КП или договор по шаблону компании: текст пишет нейросеть, цены считает код, экспорт в DOCX и PDF
Менеджер заполняет короткую форму: клиент, услуги с ценами, сроки, пожелания. Через полминуты готово коммерческое предложение или договор в фирменном стиле — с реквизитами, таблицей услуг, итогом и НДС. Остаётся проверить, поправить и отправить клиенту в Word или PDF.
Документы собираются по вашим шаблонам в Markdown: в templates/ лежат КП и договор оказания услуг с плейсхолдерами, а разделы, которые пишет нейросеть (вступление, решение, выгоды), описаны прямо в шаблоне. Цены, суммы, НДС и реквизиты подставляет код — нейросеть их не выдумает.
Текст пишет Claude через TKBK API. Перед экспортом черновик можно отредактировать с живым предпросмотром, затем скачать DOCX или открыть печатную версию и сохранить в PDF.
Для кого: Агентства, студии, подрядчики, B2B-продажи, фрилансеры
Ключи и токены не вводятся на сайте — их кладут в файл .env на своём сервере.
TKBK_API_KEYКлюч TKBK API — Получите ключ на https://tkbk.onlineACCESS_PASSWORDПароль для входа — Обязателен, если сервер доступен из интернета; логин — любой# Генератор КП и договоров — {{COMPANY_NAME}}
Веб-форма, которая за полминуты собирает коммерческое предложение или договор по шаблону
вашей компании. Текст пишет нейросеть Claude через TKBK API, цены, итоги, НДС и реквизиты
подставляет код. Черновик можно поправить и выгрузить в Word (DOCX) или PDF.
## Что умеет
- Форма: клиент, услуги (количество, единица, цена), сроки, условия оплаты, пожелания клиента.
- Шаблоны документов — обычные файлы Markdown в `templates/`: КП и договор оказания услуг уже есть.
- Нейросеть пишет только разделы, описанные в шаблоне (вступление, решение, выгоды и т. п.).
- Таблица услуг, итог, НДС «в том числе» (0, 5, 7 или 22 %), реквизиты и подписант — из настроек и формы.
- Редактор черновика с живым предпросмотром, экспорт в DOCX и печатную версию (из неё — «Сохранить как PDF»).
- Доступ по паролю (`ACCESS_PASSWORD`) и лимит запросов к нейросети.
## Как устроено
```
templates/ шаблоны документов (.md с плейсхолдерами)
public/ форма, редактор и предпросмотр (без сборщика)
src/config.js реквизиты, подписант, город, НДС, цвет — меняйте здесь
src/proposal.js расчёт сумм и НДС, подстановка в шаблон (покрыто тестами)
src/ai.js запрос к TKBK API: тексты разделов в JSON
src/markdown.js разбор Markdown и печатный HTML
src/docx.js выгрузка в Word
src/server.js API: /api/generate, /api/export/docx, /api/export/html
```
## Запуск за 5 минут (Docker)
1. Получите ключ TKBK API на [tkbk.online](https://tkbk.online).
2. Скопируйте `.env.example` в `.env`, впишите `TKBK_API_KEY` и `ACCESS_PASSWORD`.
3. Запустите:
```bash
docker compose up -d --build
```
4. Откройте http://localhost:3000 (логин — любой, пароль — `ACCESS_PASSWORD`).
## Запуск без Docker
Нужен Node.js 20.16 или новее (рекомендуем 22 LTS).
```bash
npm install
cp .env.example .env # впишите TKBK_API_KEY
npm start
```
Тесты: `npm test`.
## Свой шаблон
Создайте файл в `templates/`, например `kp-short.md`. В начале — служебный блок:
```
---
title: Короткое КП
ai.intro: Вступление в 2 предложения: обращение к клиенту и суть предложения
ai.benefits: 3–4 пункта списка «- …» — чем выгодно для клиента
---
```
`title` — название в списке шаблонов, строки `ai.ключ: описание` — разделы, которые напишет нейросеть
(описание — это задание для неё). В тексте шаблона используйте плейсхолдеры в двойных фигурных скобках
с пробелами, например `{{ client.name }}`:
| Плейсхолдер | Что подставится |
|---|---|
| `doc.number`, `doc.date`, `doc.city` | номер, дата («10 октября 2026 г.»), город |
| `client.name`, `client.contact`, `client.details` | клиент, контактное лицо, реквизиты клиента |
| `project.title`, `project.deadline`, `project.payment_terms` | название проекта, сроки, условия оплаты |
| `services.table`, `services.total`, `services.vat` | таблица услуг, итог, строка НДС |
| `company.name`, `company.details`, `company.contacts` | ваша компания |
| `company.signer_title`, `company.signer_name`, `company.signer_short` | подписант («Иванов И. И.») |
| `ai.ключ` | текст, который написала нейросеть |
Шаблоны перечитываются при каждой генерации — перезапуск не нужен.
## Где взять ключ
**TKBK_API_KEY** — личный кабинет на [tkbk.online](https://tkbk.online). По умолчанию используется
`claude-sonnet-5` — лучше пишет деловые тексты; для экономии можно указать `TKBK_MODEL=claude-haiku-4-5`.
## FAQ
**Нейросеть ошиблась в цене?** Не может: таблицу, итог и НДС формирует код из формы,
нейросеть видит цены только как контекст и пишет обычный текст.
**Как получить PDF?** Нажмите «Печатная версия» и в окне печати выберите «Сохранить как PDF».
**Договор юридически проверен?** Нет — это типовой шаблон для примера. Покажите его юристу
и сохраните проверенную версию в `templates/`.
**Как поменять реквизиты?** В `src/config.js` (объект `SETTINGS`). Ставку НДС там же.
Чат-виджет одной строкой: отвечает по вашей базе знаний, а сложные вопросы передаёт человеку в Telegram
Отвечает клиентам по вашим документам через Claude, а сложные вопросы передаёт операторам в Telegram
Новая сделка → нейросеть оценивает лид → примечание, тег «горячий/тёплый/холодный» и задача менеджеру