tech/5_мерж_анализа_и_тегов/README.md

Мерж анализа и тегов (шаг 5)

Объединение выхода 2b (финальная валидация согласованности) и выхода 4 (валидация тегов) в один JSON. Этапы 2b и 4 разнесены по времени; шаг 5 выполняется после того, как оба результата готовы.

Вход

Источник	Файл	Содержимое
2b	merge.json	framework, insights, application, limitations
4	выход_valid_tag.json	tags по категориям, removed
1 (опционально)	вход_главы.json	book_id, chapter_id, chapter_number, chapter_title, book_title, author — для шага 7

Выход

Один JSON: все поля анализа + tags, removed. Если задан --input-chapter, в выход добавляются метаданные главы/книги (book_id, chapter_id, chapter_number, chapter_title, book_title, author). Этот документ передаётся в шаг 6 (генерация эмбеддингов) и в шаг 7 (payload Qdrant).

Использование

python3 merge_analysis_tags.py <merge.json> <выход_valid_tag.json> [--input-chapter вход_главы.json] [-o выход.json]

Пример (с метаданными для шага 7):

python3 merge_analysis_tags.py ../2b_финальная_валидация_согласованности/merge.json ../4_валидация_тегов/выход_valid_tag.json --input-chapter ../1_анализ_главы/вход_главы.example.json -o merged_with_tags.json

Без -o результат выводится в stdout.