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


TUEV-HANDLER
------------

 Обеспечение качества рабочих процессов и управление тестовыми примерами для рабочих процессов BACH.
Обработчик TUeV управляет показателями статуса, достоверности и качества.
рабочих процессов на протяжении их жизненного цикла.


ИМЯ ОБРАБОТЧИКА
------------

bach tuev     - Рабочий процесс TUeV и достоверность
bach usecase  - Определение и выполнение тестового примера


ОПИСАНИЕ
------------

Обработчик TUeV (тестирование, проверка, валидация) управляет:

  * Регистрация рабочих процессов в базе данных Баха
  * Отслеживание срока действия TUeV (стандарт: 90 дней)
  * Обзор истекших/скоро истекших рабочих процессов.
  * Управление тест-кейсами (вариантами использования) для каждого рабочего процесса
  * Статус и показатель качества для каждого тестового примера

Обработчик работает с:
  * База данных: data/bach.db (workflow_tuev, таблицы вариантов использования)
  * Рабочие процессы: навыки/рабочие процессы/ (файлы *.md)
  * Тестирование ввода/вывода в формате JSON в БД


OPERATIONS
-----------

TUeV-OPERATIONS:

  bach tuev
  bach tuev status        - Показать состояние всех рабочих процессов
  bach tuev check WFNAME  - Проверить отдельный рабочий процесс и варианты его использования
  bach tuev run           - Список всех истекших рабочих процессов
  bach tuev renew WFNAME  - Обновить TUeV (срок действия 90 дней)
  bach tuev init          - Рабочие процессы из навыков/рабочих процессов/регистрации

USECASE OPERATIONS:

  bach usecase list [WF]       - Все или показать отфильтрованные тестовые примеры
  bach usecase add WFNAME      - Добавить новый тестовый пример (шаблон SQL)
  bach usecase show ID         - Подробности тестового примера с вводом/выводом
  bach usecase run ID          - Выполнить и проверить тестовый пример
  bach usecase run-all WFNAME  - Выполнить все тестовые примеры рабочего процесса


ПРИМЕРЫ
---------

1. Добавьте новые рабочие процессы в БД:
   $ бах туев инициализация
   [TUeV] Рабочие процессы инициализированы
     Добавлено: 5
     Пропущено: 0

2. Обзор статуса (отсортировано по дате истечения срока действия):
   $ бах туев статус
   [WORKFLOW-TUeV] Обзор состояния

   Срок действия истек (проверьте немедленно!):
     [!] журнал исправлений Оценка: 75% | Статус: на рассмотрении

   СРОКИ СКОРО (< 14 дней):
     [~] конвейер данных Оценка: 88% | 5д

   ОК:
     [ОК] основной рабочий процесс Оценка: 92% | 30д

3. Проверка рабочего процесса с примерами использования:
   $ bach tuev проверить журнал исправлений ошибок
   [TUeV] Тест: протокол исправления ошибок
   Путь: навыки/рабочие процессы/bugfix-protocol.md
   Статус: в ожидании
   Оценка: 75%

   Варианты использования: 2
     [?] Простой тестовый пример (?)
     [OK] Пограничный случай с ошибкой (пройден)

4. Продлите TUeV после успешного теста:
   $ bach tuev обновить протокол исправления ошибок
   [TUeV] Обновлен протокол исправления ошибок
     Действительно до: 2026-06-02

5. Добавьте новый тестовый пример:
   Вариант использования $bach для добавления конвейера данных
   SQL для вставки:
   ---------------------
   INSERT INTO варианты использования (название, описание, имя_рабочего_процесса, ...)

   Или через графический интерфейс: /usecases

   Пример:
   $ bach db query «INSERT INTO usecases (...) VALUES (...)»

6. Выполните тестовый пример:
   $bach вариант использования 5
   [USECASE] Тест №5: Простой тест
   [ИНФО] Требуется ручная проверка.

   Введите результат:
   $ bach db query "UPDATE usecases SET test_result='pass', test_score=90 WHERE id=5"


ФАЙЛЫ
-------

Относительно системы/:

  data/bach.db — база данных SQLite с таблицами TUeV/Usecase
  навыки/workflows/*.md - файлы рабочих процессов (инициализируются)
  Hub/tuev.py — классы TuevHandler и UsecaseHandler


СМОТРИТЕ ТАКЖЕ
----------

  bach db          – Прямые запросы к базе данных
  hub/base.py — базовый класс BaseHandler
  навыки/рабочие процессы/ — доступные файлы рабочих процессов.
