# Все файлы rag-stack: зачем созданы и что оставить Ревизия `dee68c4872a26f15ac8ec495950ba625074935a3`. Здесь все 30 tracked-файлов. Назначение установлено по текущему содержимому и caller; первая дата/commit — по `git log --follow --diff-filter=A`. История объясняет происхождение, но сама по себе не подтверждает сегодняшнюю необходимость. «Не нужен обычному workflow» не означает «можно сейчас удалить работающий service». Ни один файл в проекте не удалён. Подтверждённые выводы и ограничения — в [основном отчёте](). | Файл | Первая версия в Git | Назначение | Использование сейчас | Предложение | Основание | |---|---|---|---|---|---| | [.gitattributes]() | [2026-01-23 · 40259e9a]() | Метаданные Git и правила представления файлов | Профильный файл | **Оставить** | Не является runtime-кодом; нормальный артефакт stack repo | | [.gitignore]() | [2026-02-09 · f646ac14]() | Исключение локальных/временных результатов | Разработка | **Оставить** | Не удалять вместе с временными файлами | | [.gitlab-ci.yml]() | [2026-01-23 · 40259e9a]() | Проверки и ручные release/deploy jobs | Обычная поставка + maintenance смешаны | **Сократить** | R04/R05/R11/R21: один способ обычного выпуска; отдельные maintenance-команды | | [README.md]() | [2026-03-31 · 8e9f80ac]() | Начинался как инструкция настройки pyannote token; вырос в runbook GPU/стеков | Документация | **Актуализировать** | Утверждение о вызове подготовки CDI из общего deploy устарело | | [docs/STREAMING_ASR_DELIVERY.md]() | [2026-10-02 · 137fd3ff]() | Описание выделенного GPU worker и поставки ASR | Документация поставки | **Переписать актуальный вход; историю архивировать** | Сохранить действующий endpoint/owner-контракт; убрать объяснение удалённого streaming | | [observability/webrtc-streaming-asr.json]() | [2026-10-02 · 137fd3ff]() | Grafana dashboard задержек streaming ASR | Ручной observability artifact | **Убрать старые панели либо архивировать** | R15: старые partial/endpoint/queue метрики не записываются нынешним batch worker | | [stack/DELIVERY_OPTIMIZATION.md]() | [2026-10-27 · 3774a484]() | Фиксация code-only/pull/deadline правил выпуска | Текущая документация | **Оставить и сверить с обычным workflow** | Объясняет ранее согласованную оптимизацию; не runtime-зависимость | | [stack/Dockerfile.deploy]() | [2026-01-23 · 40259e9a]() | Общий Dry Stack deploy RAG/LLM/diarization/ComfyUI | Обычная широкая поставка | **Разделить выбор целей, сохранить профиль** | R04: четыре --prune в одном запуске; декларации могут вернуть прежний image/config | | [stack/Dockerfile.vllm-deploy]() | [2026-10-02 · 137fd3ff]() | Изолированное окружение для vLLM metrics upgrade | Специализированный maintenance | **Убрать из обычного пути после завершения миграции** | Пока CI ссылается на него, удаление сломает соответствующие jobs | | [stack/Dockerfile.webrtc-asr-deploy]() | [2026-10-02 · 137fd3ff]() | Окружение адресной поставки GPU ASR без соседей | Текущая адресная поставка | **Сохранить нужные гарантии; затем объединить дубли рецепта** | Не просто мусор: pull exact digest/drain/verify нужны модели | | [stack/asr_context_probe.py]() | [2026-10-11 · c06161d9]() | Проверка acoustic context русского decoder | Ручной диагностический сценарий | **В maintenance** | Не нужен каждой нормальной поставке; текущий caller asr_release probe-context | | [stack/asr_known_hosts]() | [2026-10-08 · 0c4740c0]() | Закреплённые SSH host keys адресных helpers | Поставка и проверка host identity | **Оставить** | Это публичные host keys, не приватный credential и не мусор | | [stack/asr_quality_preflight.py]() | [2026-10-13 · e5e8cad5]() | Проверка diagnostic transport без вызова модели | Ручная диагностика | **В maintenance** | Не runtime-сервис; вызывается quality-preflight | | [stack/asr_release.rb]() | [2026-10-08 · 0c4740c0]() | Адресное обновление GPU worker, preflight/warm/verify; позднее добавлены probe-режимы | Обычный выпуск + диагностика | **Сократить до обычного release и необходимых гарантий** | Старые diagnose-neighbor/context вынести из обычного интерфейса; не терять ограничение времени | | [stack/check-source.sh]() | [2026-10-27 · 3774a484]() | Адресная проверка исходников delivery helper | CI-проверка | **Оставить** | Не создавать повторную полную тестовую цепочку в deployment | | [stack/ci-scope.sh]() | [2026-10-27 · 3774a484]() | Выбор нужных проверок по diff/target | CI-проверка | **Оставить один список реальных входов** | Не заменять успехом непроверенный suite; unknown должен включать полный применимый набор | | [stack/comfyui.drs]() | [2026-03-12 · 030ccea5]() | Самостоятельный ComfyUI stack | Независимый от Chat Agent сервис | **Оставить отдельно** | Не нужен в каждом Chat Agent release; это не доказательство, что он никому не нужен | | [stack/delivery_command.rb]() | [2026-10-27 · 3774a484]() | Ограничение времени и вывода Docker/subprocess | Текущий release helper | **Оставить до упрощения release-контракта** | 69 строк, точная копия в трёх repos; не вводить новый общий сервис ради этого | | [stack/deploy-vllm.sh]() | [2026-10-02 · 137fd3ff]() | Shell entrypoint специального vLLM release | Maintenance | **Убрать вместе с завершённым workflow, не отдельно** | Связан с Dockerfile.vllm-deploy и vllm_release.rb | | [stack/deploy-webrtc-asr.sh]() | [2026-10-02 · 137fd3ff]() | Shell entrypoint адресного ASR release | Текущая поставка | **Сократить вместе с единой точкой запуска** | Не удалять, пока Dockerfile использует как entrypoint | | [stack/diarization-models.drs]() | [2026-04-21 · 8235a4d0]() | Отдельный владелец shared/isolated pyannote, sherpa, Sortformer | Независимая файловая транскрипция | **Оставить** | Не удалять из-за перехода Chat Agent на batch | | [stack/llm-models.drs]() | [2026-01-29 · 7d3d2674]() | H100 модели, NATS receivers, старый STT | Рабочие модели + legacy | **Существенно очистить декларацию** | R01/R03/R04/R13/R19: секреты, старые config/tag, commented services, inline lifecycle | | [stack/otlp.drs]() | [2026-01-23 · 40259e9a]() | Корпоративный общий overlay сетей/logs/env | Профиль поставки | **Оставить** | Применять первым; включить как реальный вход выбора deploy; наличие не доказывает приход OTLP | | [stack/prepare-h100-nvidia-cdi.sh]() | [2026-05-07 · 5e11356a]() | Майский ремонт/подготовка MIG, CDI и systemd на H100 | Host maintenance; штатного caller больше нет | **Убрать из обычного репозитория/workflow или явно архивировать** | R22: 305 строк инфраструктурной операции; не запускать при сервисном release | | [stack/rag-stack.drs]() | [2026-01-23 · 40259e9a]() | RAG БД, ingestion/retrieval, gateway NATS/model proxies, WebUI | Самостоятельный рабочий RAG stack | **Оставить, исправить состав/секреты/ingress** | Удалять весь stack ради пустого embedder нельзя | | [stack/test_asr_release.rb]() | [2026-10-08 · 0c4740c0]() | Регрессия области изменений, digest и release ASR | Проверки работающего helper | **Оставить** | Удалять только вместе с заменёнными ветками, не снимать гарантии | | [stack/test_delivery_command.rb]() | [2026-10-27 · 3774a484]() | Проверка deadlines, output cap, timeout | Проверки helper | **Оставить** | Это полезные контрактные тесты, не случайные повторные benchmarks | | [stack/test_vllm_release.rb]() | [2026-10-11 · 2bfd3fb3]() | Проверки специальной vLLM metrics migration | Maintenance-проверки | **Архивировать/удалить вместе с workflow после вывода** | Сейчас нужен соответствующим CI jobs; не доказывает bounded Docker calls | | [stack/vllm_release.rb]() | [2026-10-11 · 2bfd3fb3]() | Одноцелевой переход vLLM к per-request metrics | Maintenance с закреплённым candidate image | **Убрать из обычного выпуска; R07 до дальнейшего использования** | Нет deadline для Docker; restart соседа трактуется как изменение release scope | | [stack/webrtc-asr.drs]() | [2026-10-02 · 137fd3ff]() | Отдельный GPU ASR stack без перестройки MIG и соседей | Нынешний batch worker | **Оставить** | Ключ streaming исторический, исполняемый код batch; удаление по имени сломает Chat Agent | ## Сводка удаления - Из обычного пути: неиспользуемая подготовка MIG/CDI, законченные одноцелевые vLLM-операции, старые streaming dashboard panels и закомментированные конфигурации. - Сократить: параллельные release entrypoints, legacy-фазы и повторяющиеся параметры. Удаление должно идти вместе с caller и тестами соответствующей ветки. - Сохранить: желаемые декларации независимых стеков, профильный overlay, known_hosts, нужные проверочные скрипты и работающий batch worker. - Не переносить все helper-файлы в новый сервис или общий framework: это увеличит число сущностей вместо сокращения.