Все файлы 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: это увеличит число сущностей вместо сокращения.