init

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

@@ -0,0 +1,29 @@
+# Мерж анализа и тегов (шаг 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).
+
+## Использование
+
+```bash
+python3 merge_analysis_tags.py <merge.json> <выход_valid_tag.json> [--input-chapter вход_главы.json] [-o выход.json]
+```
+
+Пример (с метаданными для шага 7):
+
+```bash
+python3 merge_analysis_tags.py ../2b_финальная_валидация_согласованности/merge.json ../4_валидация_тегов/выход_valid_tag.json --input-chapter ../1_анализ_главы/вход_главы.example.json -o merged_with_tags.json
+```
+
+Без `-o` результат выводится в stdout.