Матрица трассировки (RTM)
docs/rtm.md — таблица «TC → flow → глубина проверки», по строке на каждый из 94 TC+инвариантов. Отвечает на вопрос: насколько глубоко автотест проверяет сценарий?
Глубина (depth)
| Значение | Что значит |
|---|---|
deep | проверяется поведение и валидация, не только навигация |
shallow | навигация и видимость элементов, без полного бизнес-исхода |
shell | только факт открытия экрана |
none | теста нет |
Статус (rtm_status)
Производное от depth и последнего прогона: covered (deep + зелёный прогон) · partial (shallow/shell) · blocked (упёрлись в backend/фичу) · missing · stale (раньше проходил, сейчас падает).
Валидатор целостности
bun run rtm:check12 автоматических проверок: сводка совпадает с данными, число flow = числу TC, маркеры каталога синхронны с матрицей, нет мёртвых ссылок на переименованные файлы во всей документации, каждый flow матрицы входит в глобы config.yaml (иначе Maestro молча его не запустит). Запускается после любой правки матрицы или переименования флоу — до зелёного.
Как добавить новый тест (чеклист)
- Убедиться, что TC есть в каталоге
docs/test-cases/(или сначала написать карточку TC). - Создать
<домен>-<сценарий>.yamlв папке домена; шапка:appId+ минимум один feature-тег (+backend/smokeпо необходимости). - Сетап вынести в
flows/*.yaml, подключить черезrunFlow. Assertions — только своего TC (правило 1 TC = 1 flow). - Добавить/обновить строку в
docs/rtm.md, прогнатьbun run rtm:checkдо зелёного. - Два живых зелёных прогона нового флоу подряд — только потом коммит.
- Если элемент без
testID— запись вdocs/testid-todo.mdс приоритетом; тест до добавления живёт на fallback-селекторе сTODO.
Роли
| Роль | Что получает из процесса |
|---|---|
| QA / автоматизатор | RTM и Карта покрытия приложения — что уже покрыто, что дописать |
| Разработчик | список защищённых регрессией фич + очередь testid-todo.md для приоритизации выдачи testID |
| PM / руководитель | зрелость автоматизации по доменам и приоритетам P0–P2 |
Жизненный цикл статуса
- Прогон упал → в матрице
rtm_status: stale, разбор причины вdocs/rtm-journal.md. - На stage нет данных для сценария → тег
stage-seed, flow выводится изconfig.yaml, статусblocked; после появления сидов — вернуть. - Поведение изменилось осознанно → сначала обновить TC в каталоге, потом тест.
Обновление этого раздела базы знаний
Заметки раздела «Vibeapp - Автотестирование» — снимок с ветки develop репозитория vibe-mobile. Регламент: после мержа значимых изменений (новые домены, изменение сводки RTM, эволюция карты покрытия) — обновить снимок одним коммитом: цифры в обзоре раздела, карту и, если менялись правила, соответствующую заметку.