# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17

COOKBOOK — инструмент кулинарной книги для создания документации БД 
====================================================

ОПИСАНИЕ
------------
Обработчик кулинарной книги генерирует необработанные версии документов из таблиц базы данных.
используя заранее заданные рецепты. Каждый рецепт описывает SQL-запрос,
шаблон вывода и путь вывода. Использует таблицу «cookbook_recipes».
в bach.db для постоянного управления.

Поддерживаемые шаблоны:
  - markdown_table: таблица Markdown со структурой столбцов.
  - markdown_list: структурированный список Markdown с иерархией.
  - json_export: экспорт JSON с метаданными 

ОПЕРАЦИИ
-----------
  bach cookbook list                    Показать все рецепты (имя, заголовок, тип)

  bach cookbook generate <rezept>       Создать необработанную версию из рецепта
                                        Читает определение рецепта, выполняет SQL,
                                        применяет шаблон, записывает выходные данные 

  bach cookbook delete <name>           Удалить рецепт (с предупреждением для CORE)
                                        Флаги: --force (принудительное удаление)

  bach cookbook help                    Показать эту справку

ПРИМЕРЫ
---------
  1. Перечислите все доступные рецепты:
     bach cookbook list

  2. Создать необработанную версию существующего рецепта:
     bach cookbook generate tools_overview

  3. Удалить рецепт (подтверждение для БОЛЬШИХ рецептов):
     bach cookbook delete my_recipe
     bach cookbook delete core_recipe --force

ВЫПУСК
-------
  Выходной каталог: data/generated/

  Имя файла определяется из рецепта:
  - Поле вывода в рецепте_json, если оно присутствует.
  - Резервный вариант: <имя рецепта>.md

  Сгенерированные файлы содержат маркеры автоматического создания с отметкой времени.

FILES
-------
  Обработчик:hub/cookbook.py
  База данных: data/bach.db (таблица: Cookbook_recipes)
  Вывод: data/generated/*.md

TABLE-SCHEMA
---------------
  кулинарная_рецепты:
    - имя (ТЕКСТ): уникальный идентификатор рецепта.
    - название (ТЕКСТ): Название документального фильма
    - описание (ТЕКСТ): Необязательное описание.
    - рецепт_json (ТЕКСТ): определение JSON (sql_query, template_type, выходной_файл)
    - dist_type (INT): 0=ПОЛЬЗОВАТЕЛЬ, 1=ШАБЛОН, 2=ЯДРО
    - Created_at (TIMESTAMP): время создания

СМОТРИ ТАКЖЕ
----------
  BACH_Dev/docs/SQ069_REZEPTBUCH_KONZEPT.md Концепция книги рецептов (SQ069)
  классhub/base.py BaseHandler
